cclaw-cli 7.7.1 → 8.1.1

package/dist/content/idea.d.ts

@@ -1,60 +0,0 @@
-export type IdeaFrameId = "pain-friction" | "assumption-break" | "cross-domain-analogy";
-export interface IdeaFrame {
-    id: IdeaFrameId;
-    label: string;
-    prompt: string;
-    examplePatterns: string[];
-}
-export interface IdeaFrameDispatchInput {
-    focus: string;
-    mode: "repo-grounded" | "elsewhere-software" | "elsewhere-non-software";
-    signalSummary: string[];
-}
-export interface IdeaFrameDispatchPlanEntry {
-    frameId: IdeaFrameId;
-    label: string;
-    prompt: string;
-}
-export interface IdeaCandidateDraft {
-    title: string;
-    evidencePath: string;
-    summary: string;
-    frameId: IdeaFrameId;
-}
-export interface IdeaCandidateMerged extends Omit<IdeaCandidateDraft, "frameId"> {
-    frameIds: IdeaFrameId[];
-}
-export declare const DEFAULT_IDEA_FRAME_IDS: readonly IdeaFrameId[];
-export declare const IDEA_FRAMES: readonly IdeaFrame[];
-export declare function resolveIdeaFrames(frameIds?: readonly IdeaFrameId[]): IdeaFrame[];
-export declare function buildIdeaFrameDispatchPlan(input: IdeaFrameDispatchInput, frameIds?: readonly IdeaFrameId[]): IdeaFrameDispatchPlanEntry[];
-export declare function dedupeIdeaCandidates(drafts: readonly IdeaCandidateDraft[]): IdeaCandidateMerged[];
-export type IdeaImpact = "high" | "medium" | "low";
-export type IdeaEffort = "s" | "m" | "l";
-export type IdeaConfidence = "high" | "medium" | "low";
-export interface IdeaCandidateEvaluationInput {
-    id: string;
-    title: string;
-    impact: IdeaImpact;
-    effort: IdeaEffort;
-    confidence: IdeaConfidence;
-}
-export interface IdeaCandidateEvaluation extends IdeaCandidateEvaluationInput {
-    disposition: "survivor" | "rejected";
-    rankingScore: number;
-}
-export interface IdeaRankingResult {
-    survivors: IdeaCandidateEvaluation[];
-    rejected: IdeaCandidateEvaluation[];
-    recommendationId: string | null;
-}
-export declare function scoreIdeaCandidate(impact: IdeaImpact, effort: IdeaEffort, confidence: IdeaConfidence): number;
-export declare function evaluateIdeaCandidate(input: IdeaCandidateEvaluationInput): IdeaCandidateEvaluation;
-export declare function rankIdeaCandidates(inputs: readonly IdeaCandidateEvaluationInput[], maxSurvivors?: number): IdeaRankingResult;
-export interface IdeaCommandOptions {
-    frameIds?: readonly IdeaFrameId[];
-    mode?: "repo-grounded" | "elsewhere-software" | "elsewhere-non-software" | "narrow";
-}
-export declare function minimumDistinctIdeaFrames(frameCount: number, mode?: IdeaCommandOptions["mode"]): number;
-export declare function ideaCommandContract(options?: IdeaCommandOptions): string;
-export declare function ideaCommandSkillMarkdown(options?: IdeaCommandOptions): string;

package/dist/content/idea.js

@@ -1,416 +0,0 @@
-import { RUNTIME_ROOT } from "../constants.js";
-import { ideaStructuredAskToolsWithFallback } from "./decision-protocol.js";
-import { conversationLanguagePolicyMarkdown } from "./language-policy.js";
-const FRAME_REGISTRY = {
-    "pain-friction": {
-        id: "pain-friction",
-        label: "pain/friction",
-        prompt: "Find repeated friction in the repo workflow. Prioritize changes that eliminate recurring toil, fragile handoffs, or repeated manual recovery.",
-        examplePatterns: [
-            "Repeated TODO/FIXME hotspots in one subsystem",
-            "Flows that require manual retries or ad-hoc scripts",
-            "Developer loops slowed by avoidable boilerplate"
-        ]
-    },
-    "assumption-break": {
-        id: "assumption-break",
-        label: "assumption-break",
-        prompt: "List the top assumptions behind the current approach and break one: what if that assumption is wrong, incomplete, or expensive to maintain?",
-        examplePatterns: [
-            "An approval gate currently assumed to be always manual can be automated safely",
-            "A broad required section can be optional with measurable trigger conditions",
-            "A long checklist step can be replaced by a deterministic verifier"
-        ]
-    },
-    "cross-domain-analogy": {
-        id: "cross-domain-analogy",
-        label: "cross-domain-analogy",
-        prompt: "Borrow one proven pattern from an adjacent domain and map it to this repository's constraints.",
-        examplePatterns: [
-            "Treat post-ship closeout like incident-response runbooks with explicit ownership",
-            "Apply API compatibility techniques to artifact schema evolution",
-            "Use observability SLO-style thresholds for process-quality gates"
-        ]
-    }
-};
-export const DEFAULT_IDEA_FRAME_IDS = Object.freeze([
-    "pain-friction",
-    "assumption-break",
-    "cross-domain-analogy"
-]);
-export const IDEA_FRAMES = Object.freeze(DEFAULT_IDEA_FRAME_IDS.map((id) => FRAME_REGISTRY[id]));
-export function resolveIdeaFrames(frameIds) {
-    if (!frameIds || frameIds.length === 0) {
-        return [...IDEA_FRAMES];
-    }
-    const seen = new Set();
-    const resolved = [];
-    for (const rawId of frameIds) {
-        if (!DEFAULT_IDEA_FRAME_IDS.includes(rawId)) {
-            throw new Error(`Unknown idea frame id: ${rawId}`);
-        }
-        if (seen.has(rawId))
-            continue;
-        seen.add(rawId);
-        resolved.push(FRAME_REGISTRY[rawId]);
-    }
-    return resolved;
-}
-export function buildIdeaFrameDispatchPlan(input, frameIds) {
-    const signalBlock = input.signalSummary.length > 0
-        ? input.signalSummary.map((line) => `- ${line}`).join("\n")
-        : "- no pre-scan signals captured yet";
-    return resolveIdeaFrames(frameIds).map((frame) => ({
-        frameId: frame.id,
-        label: frame.label,
-        prompt: [
-            `Frame: ${frame.label} (${frame.id})`,
-            `Mode: ${input.mode}`,
-            `Focus: ${input.focus || "open-ended scan"}`,
-            "",
-            "Signal summary:",
-            signalBlock,
-            "",
-            `Frame prompt: ${frame.prompt}`,
-            "",
-            "Generate 3-5 concrete candidates with repo-grounded evidence."
-        ].join("\n")
-    }));
-}
-function normalizeCandidateKey(title, evidencePath) {
-    const normalizedTitle = title.trim().toLowerCase().replace(/[^a-z0-9]+/gu, " ").trim();
-    const normalizedEvidence = evidencePath
-        .trim()
-        .toLowerCase()
-        .replace(/\\/gu, "/");
-    return `${normalizedTitle}::${normalizedEvidence}`;
-}
-export function dedupeIdeaCandidates(drafts) {
-    const merged = new Map();
-    for (const draft of drafts) {
-        const key = normalizeCandidateKey(draft.title, draft.evidencePath);
-        const existing = merged.get(key);
-        if (!existing) {
-            merged.set(key, {
-                title: draft.title,
-                evidencePath: draft.evidencePath,
-                summary: draft.summary,
-                frameIds: [draft.frameId]
-            });
-            continue;
-        }
-        if (!existing.frameIds.includes(draft.frameId)) {
-            existing.frameIds.push(draft.frameId);
-        }
-        if (draft.summary.length > existing.summary.length) {
-            existing.summary = draft.summary;
-        }
-    }
-    return [...merged.values()];
-}
-const IMPACT_PRIORITY = {
-    high: 3,
-    medium: 2,
-    low: 1
-};
-const EFFORT_PRIORITY = {
-    s: 0,
-    m: 1,
-    l: 2
-};
-const CONFIDENCE_PRIORITY = {
-    high: 2,
-    medium: 1,
-    low: 0
-};
-function isRejectedIdea(input) {
-    if (input.confidence === "low")
-        return true;
-    if (input.impact === "low" && input.effort === "l")
-        return true;
-    return false;
-}
-export function scoreIdeaCandidate(impact, effort, confidence) {
-    // Keep the scoring intentionally simple and monotonic.
-    return IMPACT_PRIORITY[impact] + CONFIDENCE_PRIORITY[confidence] - EFFORT_PRIORITY[effort];
-}
-export function evaluateIdeaCandidate(input) {
-    const disposition = isRejectedIdea(input) ? "rejected" : "survivor";
-    return {
-        ...input,
-        disposition,
-        rankingScore: scoreIdeaCandidate(input.impact, input.effort, input.confidence)
-    };
-}
-export function rankIdeaCandidates(inputs, maxSurvivors = 10) {
-    const evaluated = inputs.map(evaluateIdeaCandidate);
-    const survivors = evaluated
-        .filter((candidate) => candidate.disposition === "survivor")
-        .sort((left, right) => {
-        // Deterministic ordering: impact > effort > confidence > id.
-        const impactDelta = IMPACT_PRIORITY[right.impact] - IMPACT_PRIORITY[left.impact];
-        if (impactDelta !== 0)
-            return impactDelta;
-        const effortDelta = EFFORT_PRIORITY[left.effort] - EFFORT_PRIORITY[right.effort];
-        if (effortDelta !== 0)
-            return effortDelta;
-        const confidenceDelta = CONFIDENCE_PRIORITY[right.confidence] - CONFIDENCE_PRIORITY[left.confidence];
-        if (confidenceDelta !== 0)
-            return confidenceDelta;
-        return left.id.localeCompare(right.id);
-    })
-        .slice(0, Math.max(0, maxSurvivors));
-    const survivorIds = new Set(survivors.map((candidate) => candidate.id));
-    const rejected = evaluated
-        .filter((candidate) => candidate.disposition === "rejected" || !survivorIds.has(candidate.id))
-        .sort((left, right) => left.id.localeCompare(right.id));
-    return {
-        survivors,
-        rejected,
-        recommendationId: survivors[0]?.id ?? null
-    };
-}
-const IDEA_SKILL_FOLDER = "flow-idea";
-const IDEA_SKILL_NAME = "flow-idea";
-const IDEA_ARTIFACT_GLOB = ".cclaw/artifacts/idea-*.md";
-const IDEA_ARTIFACT_PATTERN = ".cclaw/artifacts/idea-<YYYY-MM-DD-slug>.md";
-const IDEA_RESUME_WINDOW_DAYS = 30;
-const STRUCTURED_ASK_TOOLS = ideaStructuredAskToolsWithFallback();
-export function minimumDistinctIdeaFrames(frameCount, mode = "repo-grounded") {
-    if (frameCount <= 0)
-        return 0;
-    const cap = mode === "repo-grounded" ? 3 : 2;
-    return Math.min(cap, frameCount);
-}
-function renderFrameBullets(frameIds) {
-    return resolveIdeaFrames(frameIds)
-        .map((frame) => `   - ${frame.label} (\`${frame.id}\`)`)
-        .join("\n");
-}
-function renderFrameNames(frameIds) {
-    return resolveIdeaFrames(frameIds)
-        .map((frame) => frame.label)
-        .join(", ");
-}
-export function ideaCommandContract(options = {}) {
-    const frames = resolveIdeaFrames(options.frameIds);
-    const frameBullets = renderFrameBullets(options.frameIds);
-    const minimumDistinctFrames = minimumDistinctIdeaFrames(frames.length, options.mode);
-    return `# /cc-idea
-
-## Purpose
-
-Repository-improvement idea mode. Generate a ranked backlog of
-high-value improvements, persist it as an artifact on disk, and end with
-an explicit handoff - either launch \`/cc\` on a chosen candidate in the
-same session, or save/discard the backlog.
-
-## HARD-GATE
-
-${conversationLanguagePolicyMarkdown()}
-- Idea mode only. Never mutate \`.cclaw/state/flow-state.json\`.
-- Every recommendation cites evidence from the current repository
-  (file path, command output, or knowledge-store entry id).
-- Whenever you produce ideation output, persist it to
-  \`${IDEA_ARTIFACT_PATTERN}\`. Chat-only output is not acceptable.
-  The only exception is an explicit user-cancel from the resume prompt -
-  in that case, write nothing and exit silently.
-- Always end with a structured handoff prompt, not an open question
-  (skipped on explicit cancel).
-
-## Algorithm
-
-1. **Resume check.** Glob \`${IDEA_ARTIFACT_GLOB}\`. If any artifact
-   has been modified within the last ${IDEA_RESUME_WINDOW_DAYS} days,
-   offer the user: continue that backlog, start fresh, or cancel.
-2. **Mode classification.** Explicitly classify subject:
-   \`repo-grounded\` / \`elsewhere-software\` / \`elsewhere-non-software\` / \`narrow\`.
-3. **Mode-aware grounding (parallel).**
-   - Repo-grounded: repo signal scan + \`${RUNTIME_ROOT}/knowledge.jsonl\`
-     repetition scan.
-   - Elsewhere-software: docs-first grounding (Context7 and official docs).
-   - Elsewhere-non-software: constraints and objective grounding.
-4. **Divergent ideation frames (parallel).** Generate candidates with
-   configured frames (${frames.length} total):
-${frameBullets}
-   Keep at least ${minimumDistinctFrames} distinct frame outputs in this rendered mode.
-   Deterministic minimum: repo-grounded = 3, narrow/non-repo = 2, always capped
-   by configured frame count.
-5. **Adversarial critique pass.** For each candidate, write the strongest
-   counter-argument, kill weak ideas, and keep survivors only.
-6. **Produce 5-10 survivors** with impact (High/Medium/Low),
-   effort (S/M/L), confidence (High/Medium/Low), **why now**, expected user impact, risk, and one evidence path per
-   survivor.
-7. **Rank by simple triage order**: impact first, then effort, then confidence.
-   Reject low-confidence ideas and obvious low-impact/high-effort outliers.
-   Recommend the top survivor.
-8. **Write the artifact** at
-   \`${IDEA_ARTIFACT_PATTERN}\` using the schema in the skill.
-9. **Present the handoff prompt** with four concrete options - not A/B/C
-   letters. Default = "Start /cc on the top recommendation". When the user
-   picks the start option, plumb the chosen candidate forward via
-   \`start-flow --from-idea-artifact=<path> --from-idea-candidate=I-<n>\`
-   so brainstorm reuses the idea's divergent + critique +
-   rank work via \`interactionHints.brainstorm.fromIdeaArtifact\`; do NOT
-   ask brainstorm to regenerate it.
-
-## Headless mode (CI/automation only)
-
-Headless envelopes are a machine-mode exception for CI/automation orchestration.
-In normal interactive ideation, respond with natural language plus the artifact path.
-For skill-to-skill invocation, emit exactly one JSON envelope:
-
-\`\`\`json
-{"version":"1","kind":"stage-output","stage":"non-flow","payload":{"command":"/cc-idea","artifact":".cclaw/artifacts/idea-<date>-<slug>.md","recommendation":"I-1"},"emittedAt":"<ISO-8601>"}
-\`\`\`
-
-Validate envelopes with:
-\`npx cclaw-cli internal envelope-validate --stdin\`
-
-## Primary skill
-
-   **${RUNTIME_ROOT}/skills/${IDEA_SKILL_FOLDER}/SKILL.md**
-`;
-}
-export function ideaCommandSkillMarkdown(options = {}) {
-    const frames = resolveIdeaFrames(options.frameIds);
-    const frameBullets = renderFrameBullets(options.frameIds);
-    const minimumDistinctFrames = minimumDistinctIdeaFrames(frames.length, options.mode);
-    const frameNames = renderFrameNames(options.frameIds);
-    return `---
-name: ${IDEA_SKILL_NAME}
-description: "Repository idea mode: detect and rank high-leverage improvements, persist a backlog artifact, and hand off to /cc or save/discard."
----
-
-# /cc-idea
-
-## Announce at start
-
-"Using flow-idea to identify highest-leverage improvements in this
-repository. Will persist a ranked backlog to
-\`${IDEA_ARTIFACT_PATTERN}\` and end with an explicit handoff."
-
-## HARD-GATE
-
-${conversationLanguagePolicyMarkdown()}
-- Do not start coding in idea mode.
-- Do not mutate \`.cclaw/state/flow-state.json\` - idea mode sits outside
-  the critical-path flow.
-- Whenever ideation output is produced, persist the artifact file on disk
-  before presenting the handoff. The only exception is an explicit user-cancel
-  from the resume prompt - in that case, write nothing and exit silently.
-- Always end with a structured handoff that names the concrete follow-up
-  command for each option (skipped on explicit cancel). No A/B/C letters
-  without command context.
-
-## Protocol
-
-### Phase 0 - Resume and classify
-
-1. Use the harness's file-glob tool (\`Glob\` pattern
-   \`${IDEA_ARTIFACT_GLOB}\` or equivalent \`ls\`).
-2. Filter to files modified within the last ${IDEA_RESUME_WINDOW_DAYS} days.
-3. If one or more match, present **one** structured ask using the
-   harness's native tool (${STRUCTURED_ASK_TOOLS}) with options:
-   - **Continue the existing backlog**.
-   - **Start a fresh scan**.
-   - **Cancel**.
-4. If no recent artifact exists, proceed to Phase 1 silently.
-5. Classify the ideation mode before grounding:
-   - \`repo-grounded\`
-   - \`elsewhere-software\`
-   - \`elsewhere-non-software\`
-   - \`narrow\`
-6. Record the chosen mode in the artifact.
-
-### Phase 1 - Mode-aware grounding
-
-Run grounding in parallel where available:
-
-- For \`repo-grounded\`:
-  - \`rg -n 'TODO|FIXME|XXX|HACK|TBD'\` grouped by file.
-  - Test-runner output (\`npm test\`, \`pytest\`, \`go test ./...\`) - note
-    failures, timeouts, deprecation warnings.
-  - Module size outliers with weak direct test coverage.
-  - Docs drift checks for stale references.
-  - \`${RUNTIME_ROOT}/knowledge.jsonl\` entries where \`type\` is
-    \`rule | pattern | lesson | compound\`, with repeated \`trigger/action\`
-    pairs and stable high-confidence patterns.
-- For \`elsewhere-software\`:
-  - Gather current framework/library docs first.
-  - Add one comparison scan for established solutions.
-- For \`elsewhere-non-software\`:
-  - Capture objective, constraints, and measured friction before proposing fixes.
-
-Record each finding with exact evidence (path, command, or doc source).
-
-### Phase 2 - Divergent ideation
-
-Generate candidate ideas by frame, in parallel when possible:
-
-${frameBullets}
-
-Require at least ${minimumDistinctFrames} distinct frames in this rendered mode. The
-runtime rule is deterministic: repo-grounded scans require 3 distinct frames;
-narrow, elsewhere-software, and elsewhere-non-software runs require 2; all modes
-are capped by the configured frame count.
-
-### Phase 3 - Critique all, keep survivors
-
-For each raw candidate:
-- Write strongest argument **against** this idea.
-- Identify disqualifiers (duplicate, weak evidence, poor ROI, wrong timing).
-- Mark as \`survivor\` or \`rejected\`.
-
-Only survivors advance to ranking.
-
-### Phase 4 - Rank and write the artifact
-
-1. Keep 5-10 survivors.
-2. For each survivor, include:
-   - **ID** - \`I-1\`, \`I-2\`, ...
-   - **Title**
-   - **Impact** - High / Medium / Low
-   - **Effort** - S / M / L
-   - **Confidence** - High / Medium / Low
-   - **Evidence**
-   - **Why now**
-   - **Expected impact**
-   - **Risk**
-   - **Counter-argument**
-   - **Next /cc prompt**
-3. Sort survivors by impact, then effort, then confidence.
-4. Write \`.cclaw/artifacts/idea-<date>-<slug>.md\`.
-5. Confirm in chat: "Wrote <path>".
-
-### Phase 5 - Handoff prompt
-
-Present one structured ask with exactly these options (no bare A/B/C):
-Required options, in this order:
-1. **Start /cc on the top recommendation** (default)
-2. **Pick a different candidate**
-3. **Save and close**
-4. **Discard**
-
-### Phase 6 - Execute the choice
-
-- Start /cc: load \`${RUNTIME_ROOT}/skills/using-cclaw/SKILL.md\` and run
-  \`/cc <phrase>\`. **Handoff carry-forward (mandatory when starting from /cc-idea):**
-  the harness shim that turns \`/cc <phrase>\` into a \`start-flow\` invocation
-  MUST forward the originating idea artifact and chosen candidate so brainstorm
-  reuses divergent + critique + rank work instead of redoing it. Equivalent CLI
-  call (used by automation; harness handles this transparently in interactive mode):
-  \`npx cclaw-cli internal start-flow --track=<track> --prompt='<phrase>' --from-idea-artifact=${IDEA_ARTIFACT_PATTERN} --from-idea-candidate=I-<n>\`.
-  The hint lands in \`flow-state.interactionHints.brainstorm\` and brainstorm's
-  \`Idea-evidence carry-forward\` checklist row picks it up.
-- Save and close: reply with artifact path and stop.
-- Discard: delete the artifact and stop.
-
-## Do not
-
-- Do not write into \`.cclaw/artifacts/0X-*.md\` (stage artifacts).
-- Do not mutate \`.cclaw/state/flow-state.json\`.
-- Do not collapse all ideas into one frame; distribute across:
-  ${frameNames}.
-`;
-}

package/dist/content/language-policy.d.ts

@@ -1,2 +0,0 @@
-export declare function conversationLanguagePolicyMarkdown(): string;
-export declare function conversationLanguagePolicyBullets(): string;

package/dist/content/language-policy.js

@@ -1,13 +0,0 @@
-export function conversationLanguagePolicyMarkdown() {
-    return `## Conversation Language Policy
-
-- Infer the user-facing language from the latest substantive user message.
-- Write user-facing prose, summaries, recommendations, and structured question text/options in that language unless the user asks otherwise.
-- Do not translate stable machine surfaces: commands, file paths, stage ids, gate ids, JSON keys, enum/status values, artifact headings/frontmatter, logs, code identifiers, and quoted source text.
-- If the request mixes languages, use the language of the actual ask sentence for narrative output.
-`;
-}
-export function conversationLanguagePolicyBullets() {
-    return `- User-facing narrative follows the latest substantive user message language.
-- Do not translate commands, paths, ids, JSON keys/enums, artifact headings, logs, code identifiers, or quoted source.`;
-}

package/dist/content/learnings.d.ts

@@ -1,6 +0,0 @@
-/**
- * Canonical required JSONL field order (matches strict validator keys).
- * Optional keys (`source`, `severity`) may be appended after these required fields.
- */
-export declare const KNOWLEDGE_JSONL_FIELDS: readonly ["type", "trigger", "action", "confidence", "stage", "origin_stage", "frequency", "created", "first_seen_ts", "last_seen_ts", "project"];
-export declare function learnSkillMarkdown(): string;

package/dist/content/learnings.js

@@ -1,141 +0,0 @@
-// ---------------------------------------------------------------------------
-// Knowledge store content for the learnings skill and stage self-improvement prompts.
-//
-// The knowledge store is a single canonical JSONL file. Each line is one
-// self-contained JSON object matching the strict schema in this module.
-// There is no markdown mirror — cclaw is JSONL-native.
-// ---------------------------------------------------------------------------
-const KNOWLEDGE_PATH = ".cclaw/knowledge.jsonl";
-const KNOWLEDGE_ARCHIVE_PATH = ".cclaw/knowledge.archive.jsonl";
-const LEARN_SKILL_NAME = "learnings";
-const LEARN_SKILL_DESCRIPTION = "Project-scoped knowledge store: append and query rule/pattern/lesson/compound entries in the canonical JSONL file at .cclaw/knowledge.jsonl. Strict schema, append-only, machine-queryable.";
-/**
- * Canonical required JSONL field order (matches strict validator keys).
- * Optional keys (`source`, `severity`) may be appended after these required fields.
- */
-export const KNOWLEDGE_JSONL_FIELDS = [
-    "type",
-    "trigger",
-    "action",
-    "confidence",
-    "stage",
-    "origin_stage",
-    "frequency",
-    "created",
-    "first_seen_ts",
-    "last_seen_ts",
-    "project"
-];
-export function learnSkillMarkdown() {
-    return `---
-name: ${LEARN_SKILL_NAME}
-description: "${LEARN_SKILL_DESCRIPTION}"
----
-
-# ${LEARN_SKILL_NAME}
-
-## Overview
-
-The project knowledge store is **one canonical JSONL file**: \`${KNOWLEDGE_PATH}\`.
-Each line is one self-contained JSON object. Append-only. Machine-queryable.
-
-Use the store to keep durable knowledge that should survive sessions:
-- **rule**: hard constraint to follow every time.
-- **pattern**: repeatable way that works well in this project.
-- **lesson**: non-obvious outcome from a failure or trade-off.
-- **compound**: post-ship insight about how to make the *next* run faster (process accelerator, not domain rule).
-
-## Continuous capture (stage closeout path)
-
-Knowledge capture is now stage-native:
-- Each stage artifact has a \`## Learnings\` section.
-- Allowed payloads:
-  - \`- None this stage.\` (explicit no-op)
-  - JSON bullets with required keys \`type\`, \`trigger\`, \`action\`, \`confidence\` (optional keys may mirror the full JSONL schema fields).
-- During \`node .cclaw/hooks/stage-complete.mjs <stage>\`, cclaw:
-  1. validates \`## Learnings\`,
-  2. appends deduped entries to \`${KNOWLEDGE_PATH}\`,
-  3. writes a harvest marker into the artifact.
-
-Manual/query operations (search, backfill, curation) use this skill when the
-user asks for knowledge work. If a stage artifact contains JSON learnings but
-\`${KNOWLEDGE_PATH}\` did not change, the missing step is almost always running
-\`node .cclaw/hooks/stage-complete.mjs <stage>\` successfully.
-
-## HARD-GATE
-
-During manual knowledge operations, only modify \`${KNOWLEDGE_PATH}\`, \`${KNOWLEDGE_ARCHIVE_PATH}\`,
-or an explicitly user-approved summary file. Do not modify application code here.
-Do not invent alternate stores (no markdown mirror, no SQLite, no per-stage files).
-
-## Entry format - strict JSONL schema
-
-Exactly one JSON object per line. Required fields must appear in the order:
-\`type, trigger, action, confidence, stage, origin_stage, frequency, created, first_seen_ts, last_seen_ts, project\`.
-Optional fields \`source\` and \`severity\` may be appended after \`project\`.
-
-\`\`\`json
-{"type":"pattern","trigger":"when reviewing external payloads","action":"parse through zod before touching service layer","confidence":"high","stage":"review","origin_stage":"review","frequency":1,"created":"2026-04-14T12:00:00Z","first_seen_ts":"2026-04-14T12:00:00Z","last_seen_ts":"2026-04-14T12:00:00Z","project":"cclaw"}
-\`\`\`
-
-| field | type | required | notes |
-|---|---|---|---|
-| \`type\` | \`"rule" \\| "pattern" \\| "lesson" \\| "compound"\` | yes | Lowercase. |
-| \`trigger\` | string | yes | The concrete situation that must be recognized. Start with a verb or \`when …\`. |
-| \`action\` | string | yes | The concrete move to take when the trigger fires. One sentence. |
-| \`confidence\` | \`"high" \\| "medium" \\| "low"\` | yes | Write \`medium\` when unsure; do not omit. |
-| \`stage\` | \`FlowStage\` \\| null | yes | One of brainstorm / scope / design / spec / plan / tdd / review / ship, or \`null\` when cross-stage. |
-| \`origin_stage\` | \`FlowStage\` \\| null | yes | Stage where this learning was first observed. |
-| \`frequency\` | integer >= 1 | yes | Number of times this same trigger/action pair has been observed. |
-| \`created\` | ISO 8601 UTC string | yes | \`date -u +%Y-%m-%dT%H:%M:%SZ\`. |
-| \`first_seen_ts\` | ISO 8601 UTC string | yes | First observed timestamp (usually equals \`created\`). |
-| \`last_seen_ts\` | ISO 8601 UTC string | yes | Last re-confirmed timestamp. |
-| \`project\` | string \\| null | yes | Repo or scope name. Use \`null\` when the entry crosses projects. |
-| \`source\` | \`"stage" \\| "retro" \\| "compound" \\| "idea" \\| "manual" \\| null\` | no | Origin channel for the entry when known. |
-| \`severity\` | \`"critical" \\| "important" \\| "suggestion"\` | no | Priority signal for compound lifts; \`critical\` enables single-hit override in compound readiness analysis. |
-
-Rules:
-- No other fields beyond the table above. Extra keys are forbidden and MUST be rejected by any writer.
-- Append-only: never rewrite or delete a historical line.
-- Keep each entry one line. No pretty-printing. No trailing commas.
-
-## Curation policy (target: ≤ 50 active entries)
-
-- The file is append-only — entries are never physically deleted.
-- When the canonical file exceeds 50 lines, a curation pass proposes
-  soft-archiving: the approved lines are **moved** to \`${KNOWLEDGE_ARCHIVE_PATH}\`
-  verbatim (same JSONL shape). The working file stays lean.
-- Use the **Curate** action below for the full read-only audit and
-  user-approved soft-archive plan.
-
-## Manual Actions
-
-### Show recent entries
-- Read \`${KNOWLEDGE_PATH}\`. Stream the last 30 lines; pretty-print each
-  line's \`type\` / \`trigger\` / \`action\` for human review.
-- If file is missing or empty, report that clearly and suggest adding a
-  manual entry through this skill.
-
-### Search \`<query>\`
-- Stream \`${KNOWLEDGE_PATH}\`, JSON.parse each line, filter where any of
-  \`trigger\`, \`action\`, \`project\` contains \`<query>\` (case-insensitive).
-- Return the matched lines pretty-printed (do not mutate the file).
-
-### Add
-- Ask for required user-facing fields in order: \`type\`, \`trigger\`, \`action\`, \`confidence\`, \`stage\`, \`project\`.
-- \`confidence\` must be one of \`high\`, \`medium\`, \`low\`. Default to \`medium\` if the user declines to set it.
-- \`stage\` and \`project\` may be explicitly \`null\`.
-- Prefer stage-native \`## Learnings\` capture for new flow work; use \`add\` mainly for backfilling historical lessons or ad-hoc entries outside a stage closeout.
-- \`origin_stage\` defaults to \`stage\`.
-- \`frequency\` starts at \`1\`.
-- \`created\`, \`first_seen_ts\`, and \`last_seen_ts\` are set automatically to current UTC ISO timestamp.
-- Append exactly one JSON line to \`${KNOWLEDGE_PATH}\` with the field order from the schema table above.
-- Re-read the file tail to confirm the new line is valid JSON and parses back to the same object.
-
-### Curate
-- Produce a read-only audit + soft-archive plan.
-- Never deletes. Soft-archive means **moving** full JSON lines from
-  \`${KNOWLEDGE_PATH}\` to \`${KNOWLEDGE_ARCHIVE_PATH}\` as part of a
-  user-approved curation pass.
-`;
-}

package/dist/content/observe.d.ts

@@ -1,19 +0,0 @@
-import { type HookHandlerId, type HookManifestHarness } from "./hook-manifest.js";
-export declare function claudeHooksJsonWithObservation(): string;
-export declare function cursorHooksJsonWithObservation(): string;
-export declare function codexHooksJsonWithObservation(): string;
-/**
- * Public accessor so diagnostic CLIs and tests can inspect the
- * manifest without importing the private generator helpers.
- */
-export declare function hookManifestSnapshot(): Array<{
-    harness: HookManifestHarness;
-    events: Array<{
-        event: string;
-        entries: Array<{
-            handler: HookHandlerId;
-            matcher?: string;
-            timeout?: number;
-        }>;
-    }>;
-}>;