@c4a/context-cli 0.6.1 → 0.6.3

package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile.md

@@ -1,287 +0,0 @@
----
-name: skill-prose-compile
-description: >
-  Internal procedure invoked by the public Context continuation entry; not a user slash command.
-  Uses confirmed Context document structure to create source-bound draft prose
-  candidates through `context.compile-actions.v1`, without reading raw
-  snapshots directly.
-tools:
-  - Bash
----
-
-# skill-prose-compile
-
-Compile confirmed document structure into reviewable draft knowledge.
-
-## TL;DR
-
-- Use this after `context status` reports `structure-ready` or
-  `needs-prose-compile`, or when the user explicitly asks to compile confirmed
-  prose structure into draft pages.
-- The input is already confirmed `context.structure.v1`; do not redesign node
-  ownership, page paths, or relationships here. Return to prose align if those
-  are wrong.
-- Read compile context through CLI views only: `blockers`, `read-plan`,
-  `node-context`, and `schema`. Start with `blockers` for large or recently
-  repaired structures; if it returns section blockers, return to prose align
-  instead of drafting compile actions. Use align evidence views only when the
-  compile view or validation output gives a specific source ref that needs exact
-  text.
-- Emit `context.compile-actions.v1`; the CLI mirrors source spans, derives
-  `content_mode`, writes review candidates, and enforces source-bound evidence.
-- The `summary` field in each action is the Agent-authored behavior half only:
-  compact source-backed recall text for the cited section. The CLI separately
-  renders the reachability half from confirmed typed edges into review metadata;
-  do not invent edge summaries or relation fields in the action payload.
-- Default to omitted `content` so the CLI mirrors the cited source span.
-  Do not write explicit `content`. If the evidence cannot be represented as a
-  faithful mirrored continuous span, split the section or return to prose align
-  for a confirmed structure change.
-- Before semantic judgment, use the CLI `semantic-rules` View to page through
-  only `semantic_rules.required`; selection `reason` explains why each rule is
-  needed for the current node.
-- Do not produce or validate compile actions from this entry file alone. A
-  ruleset already present in the active context may be reused only when both its
-  `handle` and `digest` match. If the context was compacted, the digest changed,
-  or the rule content is no longer present, resume the CLI rule-page sequence.
-
-<reference>
-
-## User-Facing Gates
-
-Use semantic labels, not SDK function names:
-
-| Gate | Say this | Do not say this first |
-|---|---|---|
-| Compile context | "I will inspect the confirmed structure and each node's planned evidence before drafting sections." | `node-context`, `context.compile-actions.v1` |
-| Source-bound draft | "I will mirror supported source spans into reviewable draft pages and attach summary/kind metadata." | `compileProse` |
-| Non-mirror evidence | "This section cannot be compiled as-is because the evidence is not one faithful source mirror; we need to split or revise the structure." | "The agent can rewrite this automatically." |
-| Structure mismatch | "This compile cannot proceed because the confirmed structure no longer matches the evidence; we need to return to structure confirmation." | Editing `knowledge/` or `unapproved/` directly |
-
-## Runtime Discipline
-
-`skill-continue-workflow` owns global state routing; this Skill owns only the
-compile phase selected by that route. Use CLI context/rule/diagnostic Views and
-their exact continuation commands. Hints are subordinate to `next_action`.
-Never inspect CLI-managed state files as a substitute for a View.
-- Compile `read-plan`, `blockers`, `node-context`, and `schema` Views are
-  workspace-read-only and may be fetched in parallel. `--validate`, `--stage`,
-  structure confirmation, Review apply, and close remain serial mutations.
-- One planned Section produces one compile action. When evidence contains
-  independently retrievable units, split them into sibling Sections in align;
-  do not split one planned Section into several compile actions.
-- One write still means one View, not one human Review. Stage every View in the
-  same confirmed structure sequentially, follow `continue_compile_batch`, and
-  open Review only after the CLI reports that the whole batch is prepared.
-- Compile does not get a second, looser rule set. If a rule conflicts with the
-  current CLI schema or diagnostics, follow the CLI and repair the payload.
-- Write digest/hash flags are stale guards. Use values returned by the CLI; do
-  not parse stdout fragments or host tool-result files to reconstruct them.
-- If a payload is too large for a heredoc, stage it under
-  `.tmp/agent-payloads/<run-id>/...` in the workspace root and redirect stdin
-  from that file. Never reuse fixed `/tmp/c4a-*` names, and never place agent
-  scratch payloads under CLI-managed `.tmp/context-cli/`, `sources/`,
-  `unapproved/`, `knowledge/`, `dist/`, review output, or package output
-  directories.
-
-## Compile Views
-
-Recommended read order:
-
-```bash
-context run compile:<type>:<source>:<collection> --view blockers --format json
-context run compile:<type>:<source>:<collection> --view read-plan --format json
-context run compile:<type>:<source>:<collection> --view node-context --source <view-ref> --format json
-context run compile:<type>:<source>:<collection> --view schema --format json
-```
-
-Use CLI-returned `available_view_refs`, `planned_sections`, `local_sources`, and
-`next_action.command`. If `blockers.section_blockers[]` is non-empty, repair the
-structure through align first; do not inspect every node or hand-split compile
-actions. Do not reconstruct the structure by opening `unapproved/structure.yaml`
-or `knowledge/structure.yaml` directly.
-
-## Procedure References
-
-These are current compile rules for source-bound drafting, judgment, semantic
-repair, and close handoff.
-
-| Decision | Reference |
-|---|---|
-| Compile action drafting, section kind, coverage, summaries, content intent | [skill-prose-compile/references/internal-procedures/compile-actions.md](skill-prose-compile/references/internal-procedures/compile-actions.md) |
-| Action/domain compile gates | [skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md](skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md) |
-| Notes, refresh/update, and structural challenges | [skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md](skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md), [skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md](skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md), [skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md](skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md) |
-| Support, duplicate, replacement, conflict, weak evidence, and relation judgment | [skill-prose-compile/references/internal-procedures/compile-judgment.md](skill-prose-compile/references/internal-procedures/compile-judgment.md), [skill-prose-compile/references/internal-procedures/semantic-judgment.md](skill-prose-compile/references/internal-procedures/semantic-judgment.md) |
-| Leakage, ownership, temporal evidence, disposition, omit, and user confirmation | [skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md](skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md), [skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md](skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md), [skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md](skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md), [skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md](skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md), [skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md](skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md) |
-| Close gate and current close output boundaries | [skill-prose-compile/references/internal-procedures/close-gate.md](skill-prose-compile/references/internal-procedures/close-gate.md) |
-
-## Compile Contract
-
-The compile action payload uses `schema_version: context.compile-actions.v1`.
-Compile may:
-
-- mirror source spans as `verbatim`;
-- emit `skip` decisions when no source-backed body should be written. `skip`
-  does not produce a placeholder candidate; generated parent-index pages use
-  the parent-index compile path, not an action payload placeholder.
-
-Relationships and cross references do not go into verbatim body. In current
-output they stay in `structure.yaml` typed edges; this workflow does not render
-relationship reference blocks.
-
-</reference>
-
-<procedures>
-
-### Step 1 — Open Compile Context
-
-Run:
-
-```bash
-context run compile:<type>:<source>:<collection> --view blockers --format json
-context run compile:<type>:<source>:<collection> --view read-plan --format json
-```
-
-Use the returned blockers, node list, source overview, and next action. If the
-blockers view reports section blockers, return to prose align and repair the
-confirmed structure before compile. If the CLI says the structure is missing,
-unconfirmed, stale, frozen against the wrong snapshot, or invalid, return to
-prose align or source capture as indicated.
-
-### Step 2 — Inspect One Node
-
-For each node that should become draft knowledge, run:
-
-```bash
-context run compile:<type>:<source>:<collection> --view node-context --source <view-ref> --format json
-context run compile:<type>:<source>:<collection> --view schema --format json
-context run compile:<type>:<source>:<collection> --view semantic-rules --source <view-ref> --format json
-```
-
-Follow the semantic-rules `next_action.command` pages before classifying section
-kind, summary, support, skip/update, weak evidence, or structure repair. Do not
-load rules outside the returned required set.
-
-Do not treat those references as optional background. They are the current
-compile drafting, judgment, and semantic-repair procedures.
-
-When exact evidence text is needed, use the CLI-returned source ref with the
-current evidence view. Do not open snapshot files directly.
-
-### Step 3 — Draft And Validate Actions
-
-Create a `context.compile-actions.v1` payload for the selected view. Prefer
-omitted `content` with `source_refs[]` so the CLI mirrors source spans.
-If the source evidence is non-contiguous or contains separable examples,
-configuration blocks, lists, or procedures, split the compile actions when the
-confirmed structure supports that split. If the structure is too coarse, return
-to prose align and ask the user to confirm a section split instead of writing
-summarized body text. Explicit `content` / `content_intent` is not part of the
-current compile contract.
-
-For small payloads, use stdin/heredoc. For larger payloads, write a scratch file
-under `.tmp/agent-payloads/<run-id>/` and pass it through `--input`. Scratch
-files are disposable agent working files; they are never compile state and must
-not be read back as a substitute for CLI views.
-
-Validate:
-
-```bash
-context run compile:<type>:<source>:<collection> --validate --input <compile-actions.yaml> --format json
-```
-
-Repair diagnostics by routing them to the right decision:
-
-- source ref or planned-section mismatch -> reread node-context, or return to
-  structure confirmation if ownership is wrong;
-- unsupported kind or op -> use the schema view and current compile references;
-- explicit content -> omit `content` and mirror source, or return to align for
-  a section split;
-- weak evidence, duplicate, conflict, omit, or scope issue -> use the compile
-  judgment / semantic judgment references and ask the user when required;
-- frozen structure mismatch -> rerun status and return to align/capture as
-  directed.
-
-Use typed diagnostics as the repair contract:
-
-- `reason_code`, `path`, and `missing[]` identify what to fix;
-- warnings are not write blockers unless the response marks them blocking or
-  the next action says so;
-- weak evidence, duplicate, conflict, temporal, leakage, ownership, and scope
-  issues are semantic review issues, not formatting problems;
-- raw/source-ref pointer diagnostics are evidence checks, not content-quality
-  judges.
-
-When validation returns a new `next_action.command`, follow that exact command.
-When it returns blocking diagnostics without a write command, repair and
-validate again. Do not stage a compile payload just because the YAML shape looks
-valid.
-
-### Step 4 — Stage Draft Candidates
-
-Stage only after validation has no errors:
-
-```bash
-context run compile:<type>:<source>:<collection> --stage --input <compile-actions.yaml> --format json
-```
-
-After staging, follow `next_action` exactly:
-
-- `continue_compile_batch` with `human_gate=false`: move to the returned next
-  View and repeat **Step 2–4**. Do not open Review yet.
-- `review_candidates` with `human_gate=true`: every planned View in this
-  confirmed structure slot is prepared; return to `context status`. If
-  `pendingStructureTargets` is non-empty, complete those slots first. Delegate
-  one collection-level Review to
-  `skill-review-gate.md` only when status
-  reports the complete multi-slot round ready.
-- Use `status.structureBatch` as the complete slot overview. Its evidence Views
-  are parallel-safe, its structure mutations are serial, and Review opens once
-  after all declared slots are prepared.
-
-The CLI blocks Review and close while confirmed Views remain unprepared. Do not
-turn sequential View writes into sequential user approvals.
-
-### Step 5 — Close Handoff
-
-After the single collection-level batch review apply, return to `context status`. If status says
-`compile-close-needed`, run deterministic close:
-
-```bash
-context close --format json
-```
-
-Close derives `knowledge/structure.yaml` and edge projection from approved
-knowledge, then runs the final verify gate. It must not rewrite approved
-verbatim body. References, changelog, package index, and section fingerprint
-rebuilds are not current close output.
-
-Then route to package output when status reaches `ready-to-build`.
-
-### Step 6 — Self-verify Checklist
-
-- [ ] Compile started from confirmed structure, not a new structure proposal.
-- [ ] Node context and schema came from compile phase views.
-- [ ] Compile references were read before choosing kind/summary/support.
-- [ ] Actions mirror source by default and do not invent body text.
-- [ ] No explicit reader-visible `content` was written by the Agent.
-- [ ] Relationships are expressed as structure edges, not inserted into
-  verbatim text.
-- [ ] No direct edits were made to `sources/`, `.tmp`, `unapproved/`,
-  `knowledge/`, review HTML, or `dist/`.
-- [ ] Every planned View was staged before opening the one batch Review.
-
-### Final Report
-
-Report in the user's language. Include only:
-
-- view refs compiled in this round;
-- candidate ids staged and whether they contain verbatim or empty sections;
-- validation warnings that still matter for review;
-- whether review, close, verify, or build is the next status route.
-
-Do not report internal payload digests, source-ref hashes, internal workspace
-paths, absolute paths, scratch file paths, or raw CLI JSON unless the user asks
-for debug output.
-
-</procedures>

package/plugins/codex/skills/continue/references/internal-procedures/skill-review-gate.md

@@ -1,138 +0,0 @@
----
-name: skill-review-gate
-description: >
-  Internal procedure invoked by the public Context continuation entry; not a user slash command.
-  Opens the review UI, waits for user decisions, applies copied review decision Payloads,
-  and prevents agent-authored approval/rejection decisions unless the user
-  explicitly requests the scoped quick-decision path.
-tools:
-  - Bash
----
-
-# skill-review-gate
-
-Run the human review gate. The user decides approval or rejection.
-
-## TL;DR
-
-- The agent never approves or rejects candidates on the user's behalf.
-- Exception: when the current conversation explicitly authorizes fully managed
-  operation and status routes a managed Review, run the exact
-  `context review approve-all <collection> --managed --format json` (or
-  `--all`) command. Do not open HTML, synthesize a Payload, or persist this
-  authority in project configuration.
-- Enter this skill only when the preceding command returns
-  `next_action.human_gate=true`. A no-delta codegraph run returns false and does
-  not need Review.
-- For prose, enter only after every View in the confirmed compile batch is
-  prepared. For codegraph, enter only after all pending extract phases in the
-  confirmed module round are complete. The CLI blocks partial-batch Review.
-- Use `context review html <collection> --open --format json` for visual review.
-- `<collection>` is an internal production collection such as `architecture`,
-  `sop`, `decision`, or `standards`; it is not an OKF package root such as
-  `wikis`, `guides`, or `rules`.
-- Always surface the CLI-printed `file_url`. If browser opening fails or the
-  host cannot make a path clickable, also provide `absolute_path`.
-- Apply only the review decision Payload copied by the user from the review UI.
-- Do not parse `unapproved/entities.jsonl`, `.tmp`, or HTML internals with
-  scripts to synthesize decisions.
-- If the user explicitly asks for quick or automated approval/rejection, use
-  `context review approve <candidate-id> --collection <collection>` /
-  `context review reject <candidate-id> --collection <collection>` or `--all`;
-  these commands still enforce the current scoped candidate-id gate.
-- `context run <extract-phase-id> --auto-promote` is a separate, explicit
-  codegraph-only CI/CD policy. It may apply code add/update/remove deltas and
-  refresh deterministic close, and verify them without this gate; it never
-  applies to semantic knowledge. Package build remains an explicit later step.
-
-<procedures>
-
-### Step 0 — Resolve Managed Review
-
-If `context status --managed --format json` returns a managed-session Review
-command, execute that atomic `approve-all` command and return to managed status.
-Candidate scope, ids, fingerprints, structure digests, and source refs remain
-fully validated; any mismatch is an error, not permission to bypass the gate.
-Without explicit current-conversation managed authorization, continue with the
-normal HTML workflow below.
-
-### Step 1 — Open Review
-
-For the internal collection reported by status, run:
-
-```bash
-context review html <collection> --open --format json
-```
-
-Inspect the returned `opened` field. When it is `true`, tell the user the page
-was opened. When it is `false`, do not claim it opened; report `open_error` and
-provide `file_url` as the primary clickable link plus `absolute_path` as a
-copyable fallback. Do not drop `--open`, and do not assume a fixed review
-filename; review scope is collection or `--all`.
-Do not substitute OKF package roots (`wikis`, `guides`, `rules`) for this
-argument; review scope is the internal collection namespace.
-
-Explain that this page is the human gate between draft candidates and approved
-knowledge. Approved entries become Markdown under `knowledge/`; rejected entries
-stay in the committed ledger and are not written as knowledge pages. The agent
-must not choose these states.
-
-### Step 2 — Wait For Payload
-
-Ask the user to review candidates in the HTML page, open Payload, copy the
-compact review decision Payload, and paste it into the agent chat. Uniform
-decisions produce one JSON line; exceptions add JSONL lines. The Payload records the
-user's decisions, usually as a default decision plus exceptions, so it should
-not be expanded into pretty JSON unless the user asks.
-
-The user should not need to create a payload file manually. Do not continue
-until the user supplies that payload.
-
-If the user instead explicitly asks the agent to use the quick approval or
-  rejection path, do not synthesize a decision Payload. Run the scoped quick command with the
-candidate id shown by review/list/status and either `--collection <collection>`
-or `--all`.
-
-### Step 3 — Apply Payload
-
-After the user pastes the payload into chat, the agent writes it to a normal
-temporary file under the current workspace `.tmp/` directory and runs:
-
-```bash
-context review apply <payload-file>
-```
-
-Do not accept or emit alternate `{ "decisions": [...] }` JSON. Use only
-`context.review.decisions.v1` JSONL.
-Do not use unsupported scratch, workflow, compile, or `.context/config.yaml`
-commands to store this payload.
-
-### Step 4 — Return To Status
-
-Run `context status` after apply. If it reports package output choice, return to
-`skill-continue-workflow.md`.
-
-If status instead reports `approved-source-ref-ambiguous` for a pre-file-aware
-codegraph ref, explain that the user's decisions remain approved. Rerun its
-declared extraction phase to refresh the symbol index, then run:
-
-```bash
-context review migrate-codegraph-refs
-context verify
-```
-
-Do not reopen Review, synthesize another payload, delete approved pages, or
-filter conflicting symbols. If the ref is already file-aware, report a
-duplicate extract-index defect rather than running the metadata migration.
-
-### Step 5 — Self-verify Checklist
-
-- [ ] Every decision came from the user's copied payload, an explicitly scoped
-  quick command, or the current conversation's managed `approve-all` command.
-  If not, stop and discard the agent-authored decision.
-- [ ] Payload was applied through `context review apply`. If not, return to
-  **Step 3**.
-- [ ] No direct edits were made to `knowledge/` or `unapproved/`. If not, report
-  the protocol error.
-
-</procedures>