cclaw-cli 0.55.2 → 1.0.0

package/dist/artifact-linter.d.ts

@@ -1,5 +1,5 @@
 import type { FlowStage, FlowTrack } from "./types.js";
 import { type LintResult } from "./artifact-linter/shared.js";
 export { validateReviewArmy, checkReviewVerdictConsistency, checkReviewSecurityNoChangeAttestation, type ReviewVerdictConsistencyResult, type ReviewSecurityNoChangeAttestationResult } from "./artifact-linter/review-army.js";
-export { type LintFinding, type LintResult, type LearningEntryType, type LearningConfidence, type LearningSeverity, type LearningUniversality, type LearningMaturity, type LearningSource, type LearningSeedEntry, type LearningsParseResult, extractMarkdownSectionBody, parseLearningsSection } from "./artifact-linter/shared.js";
+export { type LintFinding, type LintResult, type LearningEntryType, type LearningConfidence, type LearningSeverity, type LearningSource, type LearningSeedEntry, type LearningsParseResult, extractMarkdownSectionBody, parseLearningsSection } from "./artifact-linter/shared.js";
 export declare function lintArtifact(projectRoot: string, stage: FlowStage, track?: FlowTrack): Promise<LintResult>;

package/dist/constants.d.ts

@@ -10,7 +10,7 @@ export declare const FLOW_VERSION = "1.0.0";
 export declare const SHIP_FINALIZATION_MODES: readonly ["FINALIZE_MERGE_LOCAL", "FINALIZE_OPEN_PR", "FINALIZE_KEEP_BRANCH", "FINALIZE_DISCARD_BRANCH", "FINALIZE_NO_VCS"];
 export type ShipFinalizationMode = (typeof SHIP_FINALIZATION_MODES)[number];
 export declare const DEFAULT_HARNESSES: HarnessId[];
-export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/templates", ".cclaw/templates/state-contracts", ".cclaw/artifacts", ".cclaw/archive", ".cclaw/state", ".cclaw/rules", ".cclaw/agents", ".cclaw/hooks", ".cclaw/skills/review-prompts"];
+export declare const REQUIRED_DIRS: readonly [".cclaw", ".cclaw/commands", ".cclaw/skills", ".cclaw/templates", ".cclaw/templates/state-contracts", ".cclaw/artifacts", ".cclaw/wave-plans", ".cclaw/archive", ".cclaw/state", ".cclaw/rules", ".cclaw/agents", ".cclaw/hooks", ".cclaw/skills/review-prompts"];
 export declare const REQUIRED_GITIGNORE_PATTERNS: readonly ["# cclaw generated artifacts", ".cclaw/", ".claude/commands/cc-*.md", ".claude/commands/cc.md", ".cursor/commands/cc-*.md", ".cursor/commands/cc.md", ".opencode/commands/cc-*.md", ".opencode/commands/cc.md", ".agents/skills/cc/SKILL.md", ".agents/skills/cc-*/SKILL.md", ".claude/hooks/hooks.json", ".cursor/hooks.json", ".codex/hooks.json", ".opencode/plugins/cclaw-plugin.mjs", ".cursor/rules/cclaw-workflow.mdc"];
 /**
  * Canonical stage -> skill folder mapping.

package/dist/constants.js

@@ -59,6 +59,7 @@ export const REQUIRED_DIRS = [
     `${RUNTIME_ROOT}/templates`,
     `${RUNTIME_ROOT}/templates/state-contracts`,
     `${RUNTIME_ROOT}/artifacts`,
+    `${RUNTIME_ROOT}/wave-plans`,
     `${RUNTIME_ROOT}/archive`,
     `${RUNTIME_ROOT}/state`,
     `${RUNTIME_ROOT}/rules`,

package/dist/content/closeout-guidance.d.ts

@@ -4,7 +4,7 @@
  * Keep closeout chain and ship substate language in one place across command
  * contracts, skills, and stage/docs surfaces.
  */
-export declare const CLOSEOUT_CHAIN = "retro -> compound -> archive";
+export declare const CLOSEOUT_CHAIN = "post_ship_review -> archive";
 export declare const CLOSEOUT_SUBSTATE_KEY = "closeout.shipSubstate";
 export declare function closeoutChainInline(): string;
 export declare function closeoutSubstateInline(): string;

package/dist/content/closeout-guidance.js

@@ -4,7 +4,7 @@
  * Keep closeout chain and ship substate language in one place across command
  * contracts, skills, and stage/docs surfaces.
  */
-export const CLOSEOUT_CHAIN = "retro -> compound -> archive";
+export const CLOSEOUT_CHAIN = "post_ship_review -> archive";
 export const CLOSEOUT_SUBSTATE_KEY = "closeout.shipSubstate";
 export function closeoutChainInline() {
     return `\`${CLOSEOUT_CHAIN}\``;
@@ -18,18 +18,17 @@ export function closeoutNextCommandGuidance() {
 export function closeoutSubstateProtocolBullets() {
     return `When \`currentStage === "ship"\`, route by **${closeoutSubstateInline()}**:
   - \`"idle"\` or missing -> outcome: initialize closeout by setting
-    ${closeoutSubstateInline()} = \`"retro_review"\`, then continue \`/cc\`
+    ${closeoutSubstateInline()} = \`"post_ship_review"\`, then continue \`/cc\`
     into the in-stage retro protocol (draft + one structured accept/edit/skip ask).
-  - \`"retro_review"\` -> outcome: finish retro acceptance/edit/skip and advance
-    closeout; the draft already exists, so continue it and do not regenerate it.
-  - \`"compound_review"\` -> outcome: execute the in-stage compound closeout scan
-    (not \`ce:compound\`) and advance toward archive readiness:
+  - \`"post_ship_review"\` -> outcome: execute the unified post-ship closeout leg
+    (retro acceptance/edit/skip + in-stage compound scan, not \`ce:compound\`)
+    and advance toward archive readiness:
     read \`.cclaw/state/compound-readiness.json\` plus the relevant tail of
     \`.cclaw/knowledge.jsonl\`, assess overlap before adding duplicate knowledge,
     separate bug-track learnings (turn into rules/tests/remediation) from
-    knowledge-track learnings (durable project/process guidance), and use
-    lightweight \`supersedes\` / \`superseded_by\` fields when refreshing stale or
-    partially replaced entries. Optionally ask whether to scan Cursor/Claude/Codex
+    knowledge-track learnings (durable project/process guidance), and refresh stale
+    guidance in place instead of introducing extra lineage metadata. Optionally ask
+    whether to scan Cursor/Claude/Codex
     session transcripts for matching historical learnings; only do it after opt-in.
     Ask **one** structured question (apply / skip) per candidate cluster or a
     single accept-all / skip choice, then advance substate.
@@ -38,8 +37,8 @@ export function closeoutSubstateProtocolBullets() {
   - \`"archived"\` (transient) -> outcome: report "run archived" and stop (flow complete).`;
 }
 export function closeoutFlowMapSentence() {
-    return `The first stage names are the critical path. \`retro\`, \`compound\`, and \`archive\` are post-ship closeout substates under ${closeoutSubstateInline()}, not separate stage schemas or commands. Continue them with \`/cc\`; do not route compound closeout through \`ce:compound\`.`;
+    return `The first stage names are the critical path. \`post_ship_review\` and \`archive\` are post-ship closeout substates under ${closeoutSubstateInline()}, not separate stage schemas or commands. Continue them with \`/cc\`; do not route compound closeout through \`ce:compound\`.`;
 }
 export function closeoutProtocolBehaviorSentence() {
-    return `Keep decision, completion, and preamble discipline inline: ask only decision-changing questions, verify gates before advancing, and keep context compact. After \`ship\`, keep using \`/cc\` through ${closeoutChainInline()}; do not route normal closeout through \`ce:compound\` or a separate operations command. In compound closeout, assess overlap before appending knowledge: refresh recurring bug-track learnings as actionable rules/tests, keep knowledge-track learnings as durable process/project guidance, and mark outdated entries with lightweight \`supersedes\` / \`superseded_by\` fields instead of building a new doc system.`;
+    return `Keep decision, completion, and preamble discipline inline: ask only decision-changing questions, verify gates before advancing, and keep context compact. After \`ship\`, keep using \`/cc\` through ${closeoutChainInline()}; do not route normal closeout through \`ce:compound\` or a separate operations command. Inside \`post_ship_review\`, assess overlap before appending knowledge: refresh recurring bug-track learnings as actionable rules/tests and keep knowledge-track learnings as durable process/project guidance without extra lineage metadata.`;
 }

package/dist/content/core-agents.d.ts

@@ -15,6 +15,8 @@ export interface AgentReturnSchema {
     requiredFields: string[];
     /** Fields that must cite artifact anchors, commands, or code locations when applicable. */
     evidenceFields: string[];
+    /** Additional optional fields allowed for specific agent contracts. */
+    optionalFields?: string[];
 }
 export interface AgentDefinition {
     /** Kebab-case identifier, e.g. `"reviewer"`. */
@@ -62,21 +64,21 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "product-manager";
-    readonly description: "PROACTIVE during brainstorm/scope when product value, persona/JTBD, success metric, or why-now framing is unclear. Use for product discovery, not implementation.";
+    readonly name: "product-discovery";
+    readonly description: "MANDATORY during brainstorm and PROACTIVE during scope when value framing or expansion strategy needs product-level discovery pressure.";
     readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "balanced";
-    readonly activation: "proactive";
+    readonly model: "deep";
+    readonly activation: "mandatory";
     readonly relatedStages: ["brainstorm", "scope"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "product-strategist";
-    readonly description: "PROACTIVE during scope. MUST BE USED when selected scope mode is SCOPE EXPANSION or SELECTIVE EXPANSION to pressure-test 10x vision, strategic upside, and long-term trajectory before lock.";
+    readonly name: "divergent-thinker";
+    readonly description: "PROACTIVE before planner/critic convergence when brainstorm or scope needs option-space expansion and alternative framings.";
     readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
-    readonly model: "deep";
+    readonly model: "balanced";
     readonly activation: "proactive";
-    readonly relatedStages: ["scope"];
+    readonly relatedStages: ["brainstorm", "scope"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
@@ -90,11 +92,11 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly body: string;
 }, {
     readonly name: "architect";
-    readonly description: "MANDATORY during design. MUST BE USED to validate architecture boundaries, alternatives, failure modes, rollout, and spec handoff before implementation.";
+    readonly description: "MANDATORY during design and final ship verification. MUST BE USED to validate architecture boundaries, alternatives, failure modes, rollout, and cross-stage cohesion before release.";
     readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
     readonly model: "deep";
     readonly activation: "mandatory";
-    readonly relatedStages: ["design"];
+    readonly relatedStages: ["design", "ship"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
@@ -116,39 +118,39 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "reviewer";
-    readonly description: "MANDATORY during review. MUST BE USED to run a two-pass audit: spec compliance first, then correctness/maintainability/performance/architecture.";
+    readonly name: "coherence-reviewer";
+    readonly description: "PROACTIVE during spec/plan/design when internal consistency must be validated across sections, terminology, references, and dependency narratives.";
     readonly tools: ["Read", "Grep", "Glob"];
     readonly model: "balanced";
-    readonly activation: "mandatory";
-    readonly relatedStages: ["spec", "review", "ship"];
+    readonly activation: "proactive";
+    readonly relatedStages: ["spec", "plan", "design"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "performance-reviewer";
-    readonly description: "PROACTIVE during review for hot paths, IO, data volume, caching, rendering, or algorithmic cost changes. Produces no-impact rationale when clean.";
+    readonly name: "scope-guardian-reviewer";
+    readonly description: "PROACTIVE during scope/plan/design when complexity growth, scope drift, or unnecessary abstraction risk needs a dedicated challenge pass.";
     readonly tools: ["Read", "Grep", "Glob"];
     readonly model: "balanced";
     readonly activation: "proactive";
-    readonly relatedStages: ["review"];
+    readonly relatedStages: ["scope", "plan", "design"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "compatibility-reviewer";
-    readonly description: "PROACTIVE during design/review when public APIs, config, persisted data, CLI behavior, generated clients, or dependency versions may change.";
+    readonly name: "feasibility-reviewer";
+    readonly description: "PROACTIVE during plan/design when resource, runtime, environment, dependency, or rollout assumptions can make the solution non-viable.";
     readonly tools: ["Read", "Grep", "Glob"];
     readonly model: "balanced";
     readonly activation: "proactive";
-    readonly relatedStages: ["design", "review"];
+    readonly relatedStages: ["plan", "design"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
-    readonly name: "observability-reviewer";
-    readonly description: "PROACTIVE during design/review when diagnosis, telemetry, rollout visibility, or supportability could affect safe operation.";
+    readonly name: "reviewer";
+    readonly description: "MANDATORY during review. MUST BE USED to run a two-pass audit with explicit inline lens coverage for performance, compatibility, and observability.";
     readonly tools: ["Read", "Grep", "Glob"];
     readonly model: "balanced";
-    readonly activation: "proactive";
-    readonly relatedStages: ["design", "review"];
+    readonly activation: "mandatory";
+    readonly relatedStages: ["spec", "review", "ship"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
@@ -160,6 +162,15 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly relatedStages: ["design", "review", "ship"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
+}, {
+    readonly name: "integration-overseer";
+    readonly description: "ON-DEMAND after TDD fan-out to verify cross-slice cohesion contract integrity, integration surfaces, and shared invariants before review handoff.";
+    readonly tools: ["Read", "Grep", "Glob"];
+    readonly model: "balanced";
+    readonly activation: "on-demand";
+    readonly relatedStages: ["tdd", "review"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
 }, {
     readonly name: "test-author";
     readonly description: "MANDATORY in TDD stage. MUST BE USED for RED -> GREEN -> REFACTOR with evidence-first discipline.";
@@ -196,15 +207,6 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly relatedStages: ["tdd"];
     readonly returnSchema: AgentReturnSchema;
     readonly body: string;
-}, {
-    readonly name: "implementer";
-    readonly description: "ON-DEMAND worker for one scoped implementation slice. Use only with self-contained task text, explicit file boundaries, and verification expectations.";
-    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
-    readonly model: "balanced";
-    readonly activation: "on-demand";
-    readonly relatedStages: ["tdd"];
-    readonly returnSchema: AgentReturnSchema;
-    readonly body: string;
 }, {
     readonly name: "fixer";
     readonly description: "ON-DEMAND fresh worker after review FAIL/PARTIAL evidence. Must fix only the cited criterion within explicit allowed files.";
@@ -221,9 +223,6 @@ export declare const CCLAW_AGENTS: readonly [{
  * and typos instead of letting them slip into generated artifacts.
  */
 export type AgentName = (typeof CCLAW_AGENTS)[number]["name"];
-/**
- * Render a complete cclaw agent markdown file (YAML frontmatter + body).
- */
 export declare function agentMarkdown(agent: AgentDefinition): string;
 /**
  * Markdown table mapping cclaw stage entry points to specialist agents.