cclaw-cli 0.51.29 → 0.55.2

package/dist/content/stage-common-guidance.js

@@ -1,106 +0,0 @@
-import { conversationLanguagePolicyMarkdown } from "./language-policy.js";
-export function stageCommonGuidanceMarkdown() {
-    return `# Common Stage Guidance
-
-Shared guidance loaded by every stage skill. Keep this file concise and stable so
-per-stage skills can stay focused on stage-specific work.
-
-${conversationLanguagePolicyMarkdown()}
-## Shared completion protocol
-
-- Stage-specific skills expose **Completion Parameters** plus the gates that
-  matter for that stage.
-- Generic execution stays inline: verify required gates, update the artifact,
-  harvest learnings, then use \`/cc-next\` for progression.
-- Do not create separate protocol files.
-
-## Context readiness
-
-- Before drafting, know the upstream artifact freshness, required template shape, relevant code/reference patterns, and unresolved blockers.
-- If any item is missing, load it or stop with a blocker instead of inventing content.
-
-## Shared decision protocol
-
-- Ask only decision-changing questions.
-- Prefer one focused question over broad questionnaires.
-- When choices are equivalent, recommend one path and state the trade-off.
-- If a blocker remains after a short retry, stop and ask the user.
-
-## Shared handoff menu
-
-Use this same closeout menu for every stage:
-
-- **A) Advance** — run \`/cc-next\` and continue the critical path; after \`ship\`, the same command drives \`retro -> compound -> archive\`.
-- **B) Revise this stage** — stay on current stage and apply feedback.
-- **C) Pause / park** — run \`/cc-view status\`, then stop and resume later.
-- **D) Rewind** — run \`npx cclaw-cli internal rewind <target-stage> "<reason>"\` as the managed support/runtime repair action; after redoing the target stage, run \`npx cclaw-cli internal rewind --ack <target-stage>\` to clear the stale marker.
-- **E) Abandon** — only when the user explicitly wants to end a non-ship active run early, archive with \`npx cclaw-cli archive --skip-retro --retro-reason="<reason>"\`. Once in post-ship closeout, continue \`/cc-next\` through retro/compound/archive instead.
-
-Recommendation defaults:
-
-- Completion status \`DONE\` -> recommend **A**.
-- Completion status \`DONE_WITH_CONCERNS\` -> recommend **B**.
-- Completion status \`BLOCKED\` -> recommend **B** or **C**.
-
-## Iterate / Victory Detector
-
-- Iterate while a required gate, artifact section, or fresh evidence item is missing.
-- Stop only when the stage-specific Victory Detector passes or a named blocker is recorded.
-- Do not use vague closeout wording such as \`looks good\`, \`done enough\`, or \`all set\` without the detector evidence.
-
-## Completion status vocabulary
-
-- \`DONE\` — all required gates and checks satisfied.
-- \`DONE_WITH_CONCERNS\` — required gates pass, but recommended items remain.
-- \`BLOCKED\` — one or more required/triggered conditions fail.
-
-## Decision record template
-
-Use when a stage makes a non-trivial architecture/scope/testing decision.
-
-\`\`\`
-Decision: <one-line title>
-Context: <what forced this decision>
-Options considered:
-- A: ...
-- B: ...
-Chosen option: <A/B/...>
-Why: <short rationale>
-Risk: <main downside>
-Rollback / fallback: <if decision proves wrong>
-\`\`\`
-
-## Self-improvement reminder
-
-Before closeout, fill the artifact \`## Learnings\` section (do not write
-\`.cclaw/knowledge.jsonl\` by hand):
-- \`- None this stage.\` only when nothing reusable emerged.
-- Or 1-3 JSON bullets with required keys \`type\`, \`trigger\`, \`action\`,
-  \`confidence\` (optional fields may mirror knowledge.jsonl schema keys).
-- For meaningful \`design\`, \`tdd\`, or \`review\` work, prefer a small JSON
-  learning over \`None\` when you made a reusable decision, found a testing
-  pattern, or caught a review/security issue.
-During \`node .cclaw/hooks/stage-complete.mjs <stage>\`, cclaw validates those
-bullets, appends unique entries to \`.cclaw/knowledge.jsonl\`, and stamps a
-harvest marker in the artifact.
-
-Prefer \`type=rule|pattern|lesson\` (\`compound\` stays retro-focused).
-
-Track policy:
-- \`standard\` / \`medium\`: required for \`design\`, \`tdd\`, and \`review\`;
-  recommended for other stages.
-- \`quick\`: recommended only.
-
-\`- None this stage.\` is acceptable only when the stage produced no reusable
-insight (for example, purely mechanical edits with no new decisions). If unsure,
-record a concise \`lesson\` with \`confidence":"medium"\` instead of dropping
-operator knowledge.
-
-## Progressive disclosure baseline
-
-- Start with the current stage skill.
-- Load deeper skills or docs only when required by a blocker or gate.
-- Keep examples as short shape cues inside the current skill instead of
-  materializing separate reference files.
-`;
-}

package/dist/doctor-registry.d.ts

@@ -1,10 +0,0 @@
-export type DoctorSeverity = "error" | "warning" | "info";
-export type DoctorActionGroup = "sync" | "user-action" | "stage-work" | "informational";
-export interface DoctorCheckMetadata {
-    severity: DoctorSeverity;
-    summary: string;
-    fix: string;
-    actionGroup: DoctorActionGroup;
-    docRef?: string;
-}
-export declare function doctorCheckMetadata(checkName: string): DoctorCheckMetadata;

package/dist/doctor-registry.js

@@ -1,186 +0,0 @@
-function ref(fileName) {
-    const anchor = fileName.replace(/\.md$/u, "").replace(/[^a-z0-9]+/giu, "-").toLowerCase();
-    return `README.md#${anchor}`;
-}
-const RULES = [
-    {
-        test: /^gates:reconcile:writeback$/,
-        metadata: {
-            severity: "info",
-            summary: "Gate reconciliation status update.",
-            fix: "No action required unless subsequent gate checks fail.",
-            actionGroup: "informational",
-            docRef: ref("config.md")
-        }
-    },
-    {
-        test: /^warning:/,
-        metadata: {
-            severity: "warning",
-            summary: "Advisory signal; runtime can continue with caution.",
-            fix: "Address when possible to prevent future drift or degraded behavior.",
-            actionGroup: "informational",
-            docRef: "README.md"
-        }
-    },
-    {
-        test: /^skill:.*:(max_lines|min_lines|canonical_sections)$/,
-        metadata: {
-            severity: "warning",
-            summary: "Stage skill quality guardrail check.",
-            fix: "Tune generated stage skill content and re-run `cclaw sync`.",
-            actionGroup: "sync",
-            docRef: "README.md"
-        }
-    },
-    {
-        test: /^capability:required:/,
-        metadata: {
-            severity: "error",
-            summary: "Required runtime tooling availability check.",
-            fix: "Install the missing required tool and re-run `cclaw doctor`.",
-            actionGroup: "user-action",
-            docRef: "README.md"
-        }
-    },
-    {
-        test: /^(dir:|command:|utility_command:|stage_command:|skill:|utility_skill:|agent:|harness_tool_ref:|harness_ref:|stage_examples_ref:|doctor_ref:)/,
-        metadata: {
-            severity: "error",
-            summary: "Generated runtime surface presence check.",
-            fix: "Run `cclaw sync` to safely regenerate generated runtime files, then re-run doctor.",
-            actionGroup: "sync",
-            docRef: "README.md"
-        }
-    },
-    {
-        test: /^managed_resources:/,
-        metadata: {
-            severity: "error",
-            summary: "Managed generated resource manifest integrity check.",
-            fix: "Run `cclaw sync` to refresh managed generated files; inspect upgrade backup paths before discarding local edits.",
-            actionGroup: "sync",
-            docRef: ref("config.md")
-        }
-    },
-    {
-        test: /^(hook:|hooks:|lifecycle:|git_hooks:)/,
-        metadata: {
-            severity: "error",
-            summary: "Hook wiring and lifecycle integration check.",
-            fix: "Run `cclaw sync` to regenerate hook/plugin wiring; if the check still fails, validate harness config and permissions.",
-            actionGroup: "sync",
-            docRef: ref("harnesses.md")
-        }
-    },
-    {
-        test: /^(shim:|agents:cclaw_block|rules:cursor:)/,
-        metadata: {
-            severity: "error",
-            summary: "Harness shim and routing file consistency check.",
-            fix: "Run `cclaw sync` to regenerate harness adapters; confirm enabled harness list if it remains failing.",
-            actionGroup: "sync",
-            docRef: ref("harnesses.md")
-        }
-    },
-    {
-        test: /^(flow_state:|state:|gates:)/,
-        metadata: {
-            severity: "error",
-            summary: "Flow state and gate evidence consistency check.",
-            fix: "Repair the named stage artifacts/gate evidence, then run `cclaw doctor --reconcile-gates --explain` to refresh derived gate status only.",
-            actionGroup: "stage-work",
-            docRef: ref("config.md")
-        }
-    },
-    {
-        test: /^(knowledge:|artifacts:|runs:)/,
-        metadata: {
-            severity: "error",
-            summary: "Knowledge and artifact runtime integrity check.",
-            fix: "Restore the missing `.cclaw/` runtime file or run `cclaw sync` when it is generated surface drift.",
-            actionGroup: "sync",
-            docRef: "README.md"
-        }
-    },
-    {
-        test: /^(meta_skill:|protocol:|stage_skill:)/,
-        metadata: {
-            severity: "error",
-            summary: "Routing skill and protocol integrity check.",
-            fix: "Run `cclaw sync` to regenerate runtime skills, then re-run doctor.",
-            actionGroup: "sync",
-            docRef: ref("harnesses.md")
-        }
-    },
-    {
-        // `reference:*` checks (flow-map.md and similar overview documents)
-        // are useful to detect drift from the generated baseline, but they
-        // document the surface rather than gate it. A missing section here
-        // means the map is out of date, not that a runtime contract is
-        // broken — so they report as a warning instead of hard-failing
-        // doctor / CI. `cclaw sync` rewrites the file.
-        test: /^reference:/,
-        metadata: {
-            severity: "warning",
-            summary: "Reference/overview doc integrity (non-blocking).",
-            fix: "Run `cclaw sync` to regenerate the reference surface from the canonical source.",
-            actionGroup: "sync",
-            docRef: ref("harnesses.md")
-        }
-    },
-    {
-        test: /^harness:reality:/,
-        metadata: {
-            severity: "info",
-            summary: "Harness reality label for dispatch/proof support.",
-            fix: "No action required; use this label to interpret native/generic/role-switch proof requirements.",
-            actionGroup: "informational",
-            docRef: ref("harnesses.md")
-        }
-    },
-    {
-        test: /^delegation:/,
-        metadata: {
-            severity: "error",
-            summary: "Mandatory delegation completion check.",
-            fix: "Run the named mandatory agent, record dispatch proof/evidenceRefs, or explicitly waive it with a user-visible rationale.",
-            actionGroup: "user-action",
-            docRef: ref("harnesses.md")
-        }
-    },
-    {
-        test: /^trace:/,
-        metadata: {
-            severity: "error",
-            summary: "Cross-artifact traceability integrity check.",
-            fix: "Repair criterion/task/test ID mappings across spec, plan, and TDD artifacts, then re-run doctor.",
-            actionGroup: "stage-work",
-            docRef: "README.md"
-        }
-    },
-    {
-        test: /^(config:|rules:policy_schema|language_rule_pack:|gitignore:|git:)/,
-        metadata: {
-            severity: "error",
-            summary: "Config or policy schema consistency check.",
-            fix: "Fix config/rules drift, then run `cclaw sync` and re-run doctor.",
-            actionGroup: "user-action",
-            docRef: ref("config.md")
-        }
-    }
-];
-export function doctorCheckMetadata(checkName) {
-    for (const rule of RULES) {
-        if (rule.test.test(checkName)) {
-            return { ...rule.metadata };
-        }
-    }
-    return {
-        severity: "warning",
-        summary: "Unclassified doctor check.",
-        fix: "Report this check name to cclaw maintainers so doctor-registry can classify it explicitly.",
-        actionGroup: "informational",
-        docRef: "README.md"
-    };
-}

package/dist/doctor.d.ts

@@ -1,17 +0,0 @@
-import type { DoctorActionGroup, DoctorSeverity } from "./doctor-registry.js";
-export interface DoctorCheck {
-    name: string;
-    ok: boolean;
-    details: string;
-    severity: DoctorSeverity;
-    summary: string;
-    fix: string;
-    actionGroup: DoctorActionGroup;
-    docRef?: string;
-}
-export interface DoctorOptions {
-    /** When true, normalize current-stage gate catalog and persist reconciliation before checks. */
-    reconcileCurrentStageGates?: boolean;
-}
-export declare function doctorChecks(projectRoot: string, options?: DoctorOptions): Promise<DoctorCheck[]>;
-export declare function doctorSucceeded(checks: DoctorCheck[]): boolean;