SpecsCLIIP-322 Operator-Skill State
IP-322 Delivery and Docs-Ingest Handoff
IP-322 Delivery and Docs-Ingest Handoff
- Phase: manual convergence port complete
- Status: IP-322 and child stories IP-340, IP-341, and IP-342 are implemented and reconciled onto the current Effect v4 architecture.
- Source: approved
SPEC.md, source-branch historical evidence inPLAN.mdandIMPLEMENTATION-NOTES.md, and current convergence validation. - Current architecture: domain policy lives under
apps/cli/src/features/operator-skill; Skills CLI mechanics live inapps/cli/src/integrations/skills-cli.ts; application composition usesapplication.ts,port.ts,apps/cli/src/platform/feature-application-operations.ts, andapps/cli/src/runtime/config.ts; executable maintenance stays separate inapps/cli/src/integrations/cli-maintenance.ts. - Domain boundaries: project context is derived from
.gitonly, and canonical path containment is owned by the purecanonical-path.tsdomain helper. - Validation: focused operator, integration, and command suites passed 133/133; public-output and brand suites passed 15/15, for 148/148 focused tests. Mutation and migration passed 66/66. CLI build and typecheck passed; the build emitted 526 modules. Effect architecture validators passed 93/93 with 1,352 expectations. Full CLI passed 626/626 across 56 files. The corrected diff plus untracked set passed lint across 48 TypeScript files.
- Final review repair: generic initial global inspection failure blocks install, produces a
Failedinspection action with a guarded inspection retry, performs zero writes, and leaves reloadNotRequired; typed identity or binding evidence may still select repair. - Final P1 repairs: project-scope Skills CLI list/install/remove use detected project root while global scope retains invocation cwd, including nested-monorepo coverage. Mutation retries reauthorize current scope: generic unknown is no-write/
NotRequired, absent update is typed invalid, observed identity/binding update and known global install remain repairable, and project install retry is rejected. - Final P2 binding repair: live Skills CLI preserves
dp-clibound only to an unrelated agent for domain filtering, while active-agent binding failure remains enforced forhi-cli. - Docs: command, concept, writer artifacts, runbooks, spec artifacts, navigation, and ingest bookkeeping are reconciled to current paths and behavior.
- Historical evidence: RED descriptions remain useful as source-branch history; their old file locations and terminal branch evidence are not current convergence authority.
- Integration ownership: this slice is a manual convergence port. Branch publication and coordinated integration state are parent-owned and were not rerun or asserted here.
- Blockers: none within the IP-322 documentation and convergence slice.