cclaw-cli 7.7.0 → 8.1.0

package/dist/content/track-render-context.d.ts

@@ -1,18 +0,0 @@
-import type { FlowTrack } from "../types.js";
-export interface TrackRenderContext {
-    track: FlowTrack;
-    usesPlanTerminology: boolean;
-    traceabilitySourceNoun: string;
-    traceabilityIdNoun: string;
-    traceabilitySliceNoun: string;
-    safetySummary: string;
-    upstreamArtifactLabel: string;
-    upstreamArtifactPath: string;
-}
-export declare function trackRenderContext(track: FlowTrack): TrackRenderContext;
-/**
- * Render track-aware terminology for text that defaults to standard-track plan
- * wording. Keep this centralized so quick-track rewrites do not drift across
- * stage content generators.
- */
-export declare function renderTrackTerminology(value: string, context: TrackRenderContext): string;

package/dist/content/track-render-context.js

@@ -1,53 +0,0 @@
-function artifactFileName(path) {
-    return path.split("/").pop() ?? path;
-}
-export function trackRenderContext(track) {
-    if (track === "quick") {
-        return {
-            track,
-            usesPlanTerminology: false,
-            traceabilitySourceNoun: "acceptance criterion",
-            traceabilityIdNoun: "acceptance criterion ID",
-            traceabilitySliceNoun: "acceptance slice",
-            safetySummary: "quick skips ceremony, not safety: spec approval, TDD, review, and ship gates remain mandatory",
-            upstreamArtifactLabel: "spec artifact",
-            upstreamArtifactPath: ".cclaw/artifacts/04-spec.md"
-        };
-    }
-    return {
-        track,
-        usesPlanTerminology: true,
-        traceabilitySourceNoun: "plan task",
-        traceabilityIdNoun: "plan task ID",
-        traceabilitySliceNoun: "plan slice",
-        safetySummary: "full upstream planning safety remains in the active track",
-        upstreamArtifactLabel: "plan artifact",
-        upstreamArtifactPath: ".cclaw/artifacts/05-plan.md"
-    };
-}
-/**
- * Render track-aware terminology for text that defaults to standard-track plan
- * wording. Keep this centralized so quick-track rewrites do not drift across
- * stage content generators.
- */
-export function renderTrackTerminology(value, context) {
-    if (context.usesPlanTerminology) {
-        return value;
-    }
-    return value
-        .replace(/\btask from the plan\b/giu, `${context.traceabilitySourceNoun} from the spec`)
-        .replace(/\bplan confirmation\b/giu, "spec approval")
-        .replace(/\bplan approval\b/giu, "spec approval")
-        .replace(/\bapproved plan slice\b/giu, `approved ${context.traceabilitySliceNoun}`)
-        .replace(/\bplanned slice\b/giu, context.traceabilitySliceNoun)
-        .replace(/\bplan task ID\b/giu, context.traceabilityIdNoun)
-        .replace(/\bplan task\b/giu, context.traceabilitySourceNoun)
-        .replace(/\bplan-task\b/giu, "acceptance-criterion")
-        .replace(/\btask coverage\b/giu, "source item coverage")
-        .replace(/\borphaned tasks\b/giu, "orphaned source items")
-        .replace(/\bplan row\b/giu, "acceptance row")
-        .replace(/\btraceable to plan slice\b/giu, `traceable to ${context.traceabilitySliceNoun}`)
-        .replace(/\bplan slice\b/giu, context.traceabilitySliceNoun)
-        .replace(/\bplan artifact\b/giu, context.upstreamArtifactLabel)
-        .replace(/05-plan\.md/gu, artifactFileName(context.upstreamArtifactPath));
-}

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

@@ -1 +0,0 @@
-export declare function treeSubcommandMarkdown(): string;

package/dist/content/tree-command.js

@@ -1,64 +0,0 @@
-import { RUNTIME_ROOT } from "../constants.js";
-function flowStatePath() {
-    return `${RUNTIME_ROOT}/state/flow-state.json`;
-}
-function delegationLogPath() {
-    return `${RUNTIME_ROOT}/state/delegation-log.json`;
-}
-function delegationEventsPath() {
-    return `${RUNTIME_ROOT}/state/delegation-events.jsonl`;
-}
-function subagentsPath() {
-    return `${RUNTIME_ROOT}/state/subagents.json`;
-}
-function artifactsPath() {
-    return `${RUNTIME_ROOT}/artifacts`;
-}
-function rewindLogPath() {
-    return `${RUNTIME_ROOT}/state/rewind-log.jsonl`;
-}
-export function treeSubcommandMarkdown() {
-    return `# /cc-view tree
-
-## HARD-GATE
-
-Do not modify state in this command. It is a pure read/render operation.
-
-## Protocol
-
-1. Read \`${flowStatePath()}\` as source of truth (including \`closeout\`).
-2. Read \`${delegationLogPath()}\` for current-stage delegation status plus
-   \`fulfillmentMode\` / \`evidenceRefs\`.
-3. Inspect \`${artifactsPath()}\` for per-stage artifact presence and stale copies,
-   and for the retro artifact \`09-retro.md\`.
-4. Use \`npx cclaw-cli sync\` for harness capability status when needed.
-5. Render one compact tree:
-   - stage marker: passed/current/pending/skipped/stale,
-   - gates summary,
-   - artifact summary,
-   - delegation branch for current stage with fulfillmentMode, dispatchSurface, proof status, and active tracker labels,
-6. When \`closeout.shipSubstate !== "idle"\` or \`currentStage === "ship"\`, add
-   a closeout sub-tree:
-   - \`retro:\` line derived from \`closeout.retroDraftedAt\` /
-     \`closeout.retroAcceptedAt\` / \`closeout.retroSkipped\` and artifact presence,
-   - \`compound:\` line derived from \`closeout.compoundPromoted\` /
-     \`closeout.compoundSkipped\` / \`closeout.compoundCompletedAt\`,
-   - \`archive:\` line — \`pending\` until \`shipSubstate === "ready_to_archive"\`,
-     then \`next\`; the transient \`archived\` substate surfaces only if the
-     archive step failed mid-run.
-7. Append a \`harnesses:\` branch. For each installed harness derive the tier
-   and fallback from cclaw capability metadata; use \`npx cclaw-cli sync\`
-   for remediation details when needed.
-8. If rewind records exist in \`${rewindLogPath()}\`, include latest rewind note in footer.
-
-## Validation
-
-- Output must mention the active \`track\` and \`currentStage\`.
-- Exactly one stage is marked current.
-- Missing files are reported explicitly; never guessed as complete.
-- Delegation rows always carry a fulfillmentMode label (or \`mode=?\` when the
-  ledger entry is legacy and the mode is inferred).
-- Closeout sub-tree is present iff ship is reached; it cannot be omitted while
-  \`shipSubstate !== "idle"\`.
-`;
-}

package/dist/content/utility-skills.d.ts

@@ -1,30 +0,0 @@
-/**
- * Opt-in language rule packs for stage hooks and the meta-skill router.
- * These are generated under `.cclaw/rules/lang`, not as default skills.
- */
-export declare function languageTypescriptSkill(): string;
-export declare function languagePythonSkill(): string;
-export declare function languageGoSkill(): string;
-/**
- * Language rule packs live under `.cclaw/rules/lang/<pack>.md`. They are NOT
- * skills (no folder, no `SKILL.md`) — they are opt-in **rule files** that the
- * meta-skill router and stage hooks consult when the corresponding language
- * appears in a diff. The pack id doubles as the on-disk filename stem.
- */
-export declare const LANGUAGE_RULE_PACK_FILES: {
-    readonly typescript: "typescript.md";
-    readonly python: "python.md";
-    readonly go: "go.md";
-};
-/**
- * Folder (relative to runtime root) that holds every enabled language rule
- * pack. A single folder keeps discovery trivial for hooks and for `sync`.
- */
-export declare const LANGUAGE_RULE_PACK_DIR: readonly ["rules", "lang"];
-export declare const LANGUAGE_RULE_PACK_GENERATORS: Record<string, () => string>;
-/**
- * Older per-language folders under `.cclaw/skills/`. Listed
- * here so `cclaw sync` and `sync` can surface drift and the installer can
- * clean them up after the move to `.cclaw/rules/lang/`.
- */
-export declare const LEGACY_LANGUAGE_RULE_PACK_FOLDERS: readonly ["language-typescript", "language-python", "language-go"];

package/dist/content/utility-skills.js

@@ -1,160 +0,0 @@
-/**
- * Opt-in language rule packs for stage hooks and the meta-skill router.
- * These are generated under `.cclaw/rules/lang`, not as default skills.
- */
-export function languageTypescriptSkill() {
-    return `---
-name: language-typescript
-description: "TypeScript rule pack. Compact opt-in lens for tdd/review when diffs touch TS/JS files."
----
-
-# TypeScript Rule Pack
-
-Use this only when a diff includes \`.ts\`, \`.tsx\`, \`.mts\`, \`.cts\`, or \`.js\`.
-
-## Blocking rules
-
-1. **No silent \`any\` or blanket \`@ts-ignore\`.** Unknown input starts as \`unknown\` and gets narrowed.
-2. **Validate trust boundaries at runtime.** HTTP/env/file/IPC payloads require schema parse before typed use.
-3. **No floating promises.** Await promises or explicitly document fire-and-forget behavior.
-4. **Exhaustive union handling.** Discriminated-union switches must fail loudly on missing branches.
-
-## Follow-up rules
-
-- Prefer immutable/readonly data by default.
-- Keep types local and explicit at module boundaries.
-- Add/adjust tests when changing inferred public behavior.
-
-## Output format
-
-\`file:line — rule id — concise remediation\`
-`;
-}
-export function languagePythonSkill() {
-    return `---
-name: language-python
-description: "Python rule pack. Compact opt-in lens for tdd/review when diffs touch Python files."
----
-
-# Python Rule Pack
-
-Use this only when a diff includes \`.py\` / \`.pyi\`.
-
-## Blocking rules
-
-1. **No broad silent catches.** Avoid bare \`except\` / \`except Exception\` unless re-raised or justified.
-2. **No mutable defaults.** Use \`None\` + local initialization.
-3. **Type exported surfaces.** Public functions/classes include clear type hints.
-4. **Resource safety by default.** File/DB/network handles use context managers.
-
-## Follow-up rules
-
-- Prefer explicit, narrow exceptions.
-- Keep async and sync I/O models separated.
-- Add/adjust tests with behavior changes.
-
-## Output format
-
-\`file:line — rule id — concise remediation\`
-`;
-}
-export function languageGoSkill() {
-    return `---
-name: language-go
-description: "Go rule pack. Opt-in language lens. Use when reviewing or writing Go diffs during tdd or review — enforces error handling discipline, concurrency safety, and idiomatic patterns."
----
-
-# Go Rule Pack
-
-## Quick Start
-
-> 1. Activate during tdd or review whenever the diff touches \`.go\` files.
-> 2. Walk the rule tiers in order. Tier-1 violations block merge. Tier-2 need a named follow-up.
-> 3. Cite each finding as \`file:line — <rule id> — <one-line remediation>\`.
-
-## HARD-GATE
-
-Do not approve a Go change that discards an \`error\` return value with \`_ = ...\`
-in production code *without* a comment explaining why the error is provably
-irrelevant. Discarded errors are Go's #1 source of silent data loss.
-
-## Tier 1 — blocking rules
-
-1. **Every \`error\` is checked or explicitly wrapped with \`fmt.Errorf("%w", err)\`.**
-2. **No goroutine leaks.** Every \`go func()\` must have a stop condition visible in
-   the diff: a \`context.Context\` cancellation, a \`done\` channel, or a bounded
-   input channel that will close.
-3. **Context propagation.** Any function that does I/O, RPC, or long work must take
-   \`ctx context.Context\` as the first parameter.
-4. **No mutex by value.** Fields of type \`sync.Mutex\` / \`sync.RWMutex\` must be
-   pointers *or* the containing struct must be used only via pointer receivers.
-5. **Defer placement.** \`defer file.Close()\` must immediately follow a successful
-   open, before any code path that can return early.
-6. **\`for range\` capture hygiene** (pre-Go 1.22): copy loop variables before
-   capturing in goroutines or deferred functions. From Go 1.22+ the language fixes
-   this, but confirm the repo's \`go\` directive in \`go.mod\`.
-
-## Tier 2 — follow-up rules
-
-7. Prefer small interfaces defined at the consumer site, not upstream.
-8. Prefer \`errors.Is\` / \`errors.As\` over string matching.
-9. Avoid \`init()\` except for registering with a framework.
-10. Use \`t.Helper()\` inside test helpers so failure lines point at the caller.
-11. Use \`//go:build\` tags for OS-specific code, not runtime \`runtime.GOOS\` checks.
-
-## Concurrency-specific
-
-- Buffered channels are a performance hint, not a correctness fix. Unbuffered first.
-- \`sync.WaitGroup\` \`Add\` must happen **before** \`go\`, not inside the goroutine.
-- \`atomic\` operations must be paired on the same variable — do not mix \`atomic.Load\`
-  with plain reads of the same field.
-- Shared maps require a mutex or \`sync.Map\`; Go's race detector in CI is non-negotiable.
-
-## Anti-patterns
-
-- Returning \`interface{}\` / \`any\` to "keep options open" — narrow it now.
-- Building "smart" error types that lose the wrapped chain.
-- Using \`panic\` for control flow in library code (allowed only for unrecoverable invariants).
-- Ignoring \`go vet\` warnings because "the code works".
-
-## Review output shape
-
-\`\`\`
-- **Rule:** G1-2 (no goroutine leaks)
-- **File:line:** internal/worker/pool.go:57
-- **Finding:** \`go w.loop()\` has no stop condition; context is not threaded through.
-- **Remediation:** Accept \`ctx\` in \`Start\` and select on \`ctx.Done()\` inside \`loop\`.
-\`\`\`
-`;
-}
-/**
- * Language rule packs live under `.cclaw/rules/lang/<pack>.md`. They are NOT
- * skills (no folder, no `SKILL.md`) — they are opt-in **rule files** that the
- * meta-skill router and stage hooks consult when the corresponding language
- * appears in a diff. The pack id doubles as the on-disk filename stem.
- */
-export const LANGUAGE_RULE_PACK_FILES = {
-    typescript: "typescript.md",
-    python: "python.md",
-    go: "go.md"
-};
-/**
- * Folder (relative to runtime root) that holds every enabled language rule
- * pack. A single folder keeps discovery trivial for hooks and for `sync`.
- */
-export const LANGUAGE_RULE_PACK_DIR = ["rules", "lang"];
-export const LANGUAGE_RULE_PACK_GENERATORS = {
-    typescript: languageTypescriptSkill,
-    python: languagePythonSkill,
-    go: languageGoSkill
-};
-/**
- * Older per-language folders under `.cclaw/skills/`. Listed
- * here so `cclaw sync` and `sync` can surface drift and the installer can
- * clean them up after the move to `.cclaw/rules/lang/`.
- */
-export const LEGACY_LANGUAGE_RULE_PACK_FOLDERS = [
-    "language-typescript",
-    "language-python",
-    "language-go"
-];

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

@@ -1,2 +0,0 @@
-export declare function viewCommandContract(): string;
-export declare function viewCommandSkillMarkdown(): string;

package/dist/content/view-command.js

@@ -1,92 +0,0 @@
-import { RUNTIME_ROOT } from "../constants.js";
-import { diffSubcommandMarkdown } from "./diff-command.js";
-import { statusSubcommandMarkdown } from "./status-command.js";
-import { treeSubcommandMarkdown } from "./tree-command.js";
-import { conversationLanguagePolicyMarkdown } from "./language-policy.js";
-const VIEW_SKILL_FOLDER = "flow-view";
-const VIEW_SKILL_NAME = "flow-view";
-export function viewCommandContract() {
-    return `# /cc-view
-
-## Purpose
-
-Unified read-only command surface for flow visibility.
-
-Subcommands:
-- \`/cc-view\` or \`/cc-view status\` -> status snapshot
-- \`/cc-view tree\` -> structural flow tree
-- \`/cc-view diff\` -> read-only git delta map
-
-## HARD-GATE
-
-${conversationLanguagePolicyMarkdown()}
-- \`/cc-view\` is strictly read-only at wrapper level.
-- Do not mutate flow-state or derived state from any subcommand.
-
-## Routing
-
-1. Parse subcommand (default \`status\`).
-2. Route:
-   - \`status\` -> use the **Status Subcommand** section in \`${RUNTIME_ROOT}/skills/${VIEW_SKILL_FOLDER}/SKILL.md\`
-   - \`tree\` -> use the **Tree Subcommand** section in \`${RUNTIME_ROOT}/skills/${VIEW_SKILL_FOLDER}/SKILL.md\`
-   - \`diff\` -> use the **Diff Subcommand** section in \`${RUNTIME_ROOT}/skills/${VIEW_SKILL_FOLDER}/SKILL.md\`
-3. Unknown subcommand -> print supported values and stop.
-
-## Headless mode (CI/automation only)
-
-Headless envelopes are a machine-mode exception for CI/automation orchestration.
-In normal interactive runs, respond with concise read-only prose instead.
-For machine orchestration, emit one JSON envelope:
-
-\`\`\`json
-{"version":"1","kind":"stage-output","stage":"non-flow","payload":{"command":"/cc-view <status|tree|diff>","subcommand":"<status|tree|diff>","summary":"<short>"},"emittedAt":"<ISO-8601>"}
-\`\`\`
-
-Use the parsed/defaulted subcommand in both \`payload.command\` and \`payload.subcommand\`; do not collapse \`tree\` or \`diff\` responses to \`status\`.
-
-Validate envelopes with:
-\`npx cclaw-cli internal envelope-validate --stdin\`
-
-## Primary skill
-
-**${RUNTIME_ROOT}/skills/${VIEW_SKILL_FOLDER}/SKILL.md**
-`;
-}
-export function viewCommandSkillMarkdown() {
-    const status = statusSubcommandMarkdown();
-    const tree = treeSubcommandMarkdown();
-    const diff = diffSubcommandMarkdown();
-    return `---
-name: ${VIEW_SKILL_NAME}
-description: "Unified read-only view skill for status/tree/diff flow visibility commands."
----
-
-# /cc-view
-
-## HARD-GATE
-
-Wrapper is read-only and dispatch-only. It must not mutate flow state directly.
-
-## Protocol
-
-1. Parse optional subcommand token:
-   - missing -> \`status\`
-   - \`status\` -> run **Status Subcommand** below
-   - \`tree\` -> run **Tree Subcommand** below
-   - \`diff\` -> run **Diff Subcommand** below
-2. Execute only the chosen subcommand section.
-3. Return concise output and suggest \`/cc-view <subcommand>\` variants for navigation.
-
-## Status Subcommand
-
-${status}
-
-## Tree Subcommand
-
-${tree}
-
-## Diff Subcommand
-
-${diff}
-`;
-}