cclaw-cli 0.15.0 → 0.18.0

package/dist/content/protocols.js

@@ -90,42 +90,14 @@ Before adding new code/templates/rules:
 - Evidence beats volume.
 - Keep stage output concrete and testable.
 
-## Preamble budget
+## Turn announce discipline
 
-This section is the single source of truth for preamble behavior.
-Do not duplicate preamble rules in AGENTS.md, harness adapters, or stage-local docs.
+Keep orchestration visible without maintaining a dedicated preamble runtime log.
 
-### Emit when
-
-| Trigger | Machine-verifiable condition |
-|---|---|
-| Stage transition | \`flow-state.currentStage\` changes in this turn |
-| Non-trivial implementation turn | agent is about to run source-editing tools outside \`.cclaw/\` |
-| Multi-step risky operation | planned sequence contains 2+ commands with rollback/risk potential |
-
-### Skip when
-
-| Skip reason | Condition |
-|---|---|
-| Pure Q&A | no filesystem or runtime mutation planned |
-| Trivial change | single low-risk edit with no stage or plan drift |
-| Subagent dispatch payload | prompt is for spawned agent/tool call only |
-| Cooldown hit | same stage + same trigger emitted within cooldown window |
-
-### Form contract (max 4 lines)
-
-1. \`Stage:\` current stage id  
-2. \`Goal:\` concrete objective for this turn  
-3. \`Plan:\` next 1-3 actions  
-4. \`Guardrails:\` key constraints / non-goals
-
-### Cooldown
-
-- Record each emitted preamble in \`.cclaw/state/preamble-log.jsonl\` as JSON line:
-  \`{"ts","stage","runId","trigger","hash"}\`.
-- Default cooldown: 15 minutes for identical \`stage + trigger + hash\`.
-- TDD wave mode uses stricter dedupe: one preamble per wave unless scope changes.
-- If the plan changes materially, a new preamble is allowed inside cooldown.
+- Start substantial turns with a 1-2 sentence announce: current stage, intent, next action.
+- Skip announce for trivial single-command actions.
+- Never repeat boilerplate announces when the intent did not change.
+- If plan or risk changes materially, post a fresh announce before executing.
 
 ## Operational learning
 

package/dist/content/rewind-command.d.ts

@@ -1,3 +1,2 @@
 export declare function rewindCommandContract(): string;
-export declare function rewindAcknowledgeCommandContract(): string;
 export declare function rewindCommandSkillMarkdown(): string;

package/dist/content/rewind-command.js

@@ -15,7 +15,8 @@ export function rewindCommandContract() {
 
 ## Purpose
 
-Rewind active flow to an earlier stage and atomically invalidate downstream work.
+Rewind active flow to an earlier stage, or acknowledge stale markers after
+intentional rework.
 
 ## HARD-GATE
 
@@ -26,9 +27,12 @@ Rewind active flow to an earlier stage and atomically invalidate downstream work
 ## Inputs
 
 \`/cc-ops rewind <target-stage> [reason]\`
+or
+\`/cc-ops rewind --ack <stage>\`
 
 ## Algorithm
 
+### rewind mode
 1. Read \`${flowStatePath()}\` and current track.
 2. Validate \`target-stage\` belongs to the active track and is not ahead of current stage.
 3. Compute downstream stages to invalidate (all stages after target that were completed or current).
@@ -42,42 +46,24 @@ Rewind active flow to an earlier stage and atomically invalidate downstream work
    - append \`rewinds[]\` record
 7. Append JSON line to \`${rewindLogPath()}\`.
 
-## Output
-
-- Rewind id
-- from -> to stage
-- Invalidated stages list
-- Number of stale artifacts
-
-## Primary skill
-
-**${RUNTIME_ROOT}/skills/${REWIND_SKILL_FOLDER}/SKILL.md**
-`;
-}
-export function rewindAcknowledgeCommandContract() {
-    return `# /cc-ops rewind-ack
-
-## Purpose
-
-Acknowledge and clear stale-stage markers after downstream work is intentionally redone.
-
-## Input
-
-\`/cc-ops rewind-ack <stage>\`
-
-## HARD-GATE
-
-- Only clear stale marker for the requested stage.
-- Never modify completedStages from this command.
-
-## Algorithm
-
+### acknowledge mode (\`--ack\`)
 1. Read \`${flowStatePath()}\`.
 2. If \`staleStages.<stage>\` is missing, report no-op.
 3. Remove \`staleStages.<stage>\`.
 4. Write updated flow-state.
 5. Print remaining stale stages (if any).
 
+## Output
+
+- In rewind mode:
+  - rewind id
+  - from -> to stage
+  - invalidated stages list
+  - number of stale artifacts
+- In acknowledge mode:
+  - acknowledged stage
+  - remaining stale stages
+
 ## Primary skill
 
 **${RUNTIME_ROOT}/skills/${REWIND_SKILL_FOLDER}/SKILL.md**
@@ -89,7 +75,7 @@ name: ${REWIND_SKILL_NAME}
 description: "Rewind active flow stage safely and acknowledge stale invalidations."
 ---
 
-# /cc-ops rewind + /cc-ops rewind-ack
+# /cc-ops rewind
 
 ## HARD-GATE
 
@@ -105,7 +91,7 @@ Rewind is an atomic state transition. Never leave flow-state half-updated (for e
 5. Record \`rewinds[]\` and \`staleStages\` in flow-state.
 6. Append rewind entry into \`${rewindLogPath()}\`.
 
-### rewind-ack
+### rewind --ack <stage>
 1. Load flow-state stale map.
 2. Remove exactly one stale stage marker.
 3. Report remaining stale stages.

package/dist/content/skills.js

@@ -108,9 +108,8 @@ function waveExecutionModeBlock(stage) {
 
 Execute the current dependency wave task-by-task (RED -> GREEN -> REFACTOR).
 Stop on BLOCKED status or when user input is required.
-Apply preamble budget discipline: one preamble per wave, then continue without
-repeating it for each task. Re-emit only when the wave boundary changes or the
-plan changes materially.
+Apply concise turn announces: one announce per wave boundary (or when risk/plan
+changes materially), then execute tasks without repetitive boilerplate.
 
 Detailed walkthrough:
 \`.cclaw/${STAGE_EXAMPLES_REFERENCE_DIR}/tdd-wave-walkthrough.md\`

package/dist/content/stage-schema.d.ts

@@ -1,96 +1,6 @@
 import type { FlowStage, TransitionRule } from "../types.js";
-export interface StageGate {
-    id: string;
-    description: string;
-    tier?: "required" | "recommended" | "conditional";
-    /** Used when tier=conditional. Predicate syntax mirrors conditional delegation rules. */
-    condition?: string;
-}
-export interface ReviewSection {
-    title: string;
-    evaluationPoints: string[];
-    stopGate: boolean;
-}
-export interface CrossStageTrace {
-    readsFrom: string[];
-    writesTo: string[];
-    traceabilityRule: string;
-}
-export interface ArtifactValidation {
-    section: string;
-    required: boolean;
-    tier?: "required" | "recommended" | "conditional";
-    /** Optional predicate for conditional validations. */
-    condition?: string;
-    validationRule: string;
-}
-export interface StageAutoSubagentDispatch {
-    agent: "planner" | "reviewer" | "security-reviewer" | "test-author" | "doc-updater";
-    /**
-     * - `mandatory` — must be dispatched (or explicitly waived) before stage transition.
-     * - `proactive` — should be dispatched automatically when context matches `when`.
-     * - `conditional` — dispatched only when `condition` evaluates true at runtime; counted as
-     *   mandatory **only when the condition holds**.
-     */
-    mode: "mandatory" | "proactive" | "conditional";
-    when: string;
-    purpose: string;
-    requiresUserGate: boolean;
-    /**
-     * Optional machine-friendly trigger expression for `conditional` rows.
-     * Supported predicates: `diff_lines_gt:<N>`, `files_touched_gt:<N>`,
-     * `trust_boundary_changed`, `release_blast_radius_high`.
-     * Multiple predicates joined by `||` mean ANY trigger satisfies the condition.
-     */
-    condition?: string;
-    /** Optional skill folder the dispatched agent should load as additional context. */
-    skill?: string;
-}
-export interface StageSchema {
-    stage: FlowStage;
-    skillFolder: string;
-    skillName: string;
-    skillDescription: string;
-    hardGate: string;
-    /**
-     * One-line "Iron Law" punchcard — the single rule that, if broken,
-     * invalidates the stage outright. Rendered in ALL-CAPS wrapped in
-     * <EXTREMELY-IMPORTANT> XML markers at the very top of the skill body.
-     * Reference: Superpowers (obra) "NO PRODUCTION CODE WITHOUT A FAILING
-     * TEST FIRST".
-     */
-    ironLaw: string;
-    purpose: string;
-    whenToUse: string[];
-    whenNotToUse: string[];
-    interactionProtocol: string[];
-    process: string[];
-    requiredGates: StageGate[];
-    requiredEvidence: string[];
-    inputs: string[];
-    requiredContext: string[];
-    /** In-thread research procedures for this stage (`.cclaw/skills/research/*.md`). */
-    researchPlaybooks?: string[];
-    outputs: string[];
-    blockers: string[];
-    exitCriteria: string[];
-    antiPatterns: string[];
-    redFlags: string[];
-    policyNeedles: string[];
-    artifactFile: string;
-    next: FlowStage | "done";
-    checklist: string[];
-    reviewSections: ReviewSection[];
-    completionStatus: string[];
-    crossStageTrace: CrossStageTrace;
-    artifactValidation: ArtifactValidation[];
-    /** When true, stage skill includes wave auto-execute guidance (tdd). */
-    waveExecutionAllowed?: boolean;
-    /** Sections that remain required even when the trivial-change escape hatch is active (design only). */
-    trivialOverrideSections?: string[];
-    /** Agent names that MUST be dispatched (or waived) before stage transition — derived from mandatory auto-subagent rows. */
-    mandatoryDelegations: string[];
-}
+import type { StageAutoSubagentDispatch, StageSchema } from "./stages/schema-types.js";
+export type { ArtifactValidation, CrossStageTrace, ReviewSection, StageAutoSubagentDispatch, StageGate, StageSchema, StageSchemaInput } from "./stages/schema-types.js";
 /** Transition guard: agents with `mode: "mandatory"` in auto-subagent dispatch for this stage. */
 export declare function mandatoryDelegationsForStage(stage: FlowStage): string[];
 /** Conditional dispatches that become mandatory only when their `condition` predicate evaluates true. */