cclaw-cli 0.55.2 → 2.0.0

package/dist/content/idea-command.js

@@ -1,322 +0,0 @@
-import { RUNTIME_ROOT } from "../constants.js";
-import { resolveIdeaFrames } from "./idea-frames.js";
-import { ideaStructuredAskToolsWithFallback } from "./decision-protocol.js";
-import { conversationLanguagePolicyMarkdown } from "./language-policy.js";
-const IDEA_SKILL_FOLDER = "flow-idea";
-const IDEA_SKILL_NAME = "flow-idea";
-/**
- * Directory + filename convention for idea artifacts. These are separate
- * from stage artifacts (00-..08-*.md) because `/cc-idea` runs outside the
- * critical-path flow state machine and must not collide with stage numbering.
- */
-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" ? 4 : 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\`.
-   Do not assume repo-grounded by default. Repo-grounded scans keep the
-   broadest frame minimum; narrow and non-repo modes use the smaller minimum
-   shown below.
-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 = 4, 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 impact/effort/confidence** using
-   \`(impact points / effort cost) * confidence multiplier\` and recommend
-   the top survivor.
-8. **Write the artifact** at
-   \`${IDEA_ARTIFACT_PATTERN}\` using the schema in the skill.
-8.5 **Seed shelf (optional).** For critiqued-out or deferred ideas that still
-   show upside, write seed notes to
-   \`${RUNTIME_ROOT}/seeds/SEED-<YYYY-MM-DD>-<slug>.md\` with
-   \`trigger_when\`, hypothesis, and suggested action.
-9. **Present the handoff prompt** with four concrete options — not A/B/C
-   letters. Default = "Start /cc on the top recommendation".
-
-## 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\`/\`find\`).
-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** — read the most-recent
-     idea-*.md and work from its candidate list; skip re-scanning.
-   - **Start a fresh scan** — proceed to Phase 1; the old artifact stays
-     on disk for history.
-   - **Cancel** — stop; do not scan or write anything.
-4. If no recent artifact exists, proceed to Phase 1 silently.
-5. Classify the ideation mode before grounding:
-   - \`repo-grounded\` — explicitly tied to this repository.
-   - \`elsewhere-software\` — software problem not tied to this repository.
-   - \`elsewhere-non-software\` — process/business/non-software problem.
-   - \`narrow\` — a focused prompt where broad frame coverage would be performative.
-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 (\`wc -l\` or \`du\`) with weak direct test coverage.
-  - Docs drift: check that \`README.md\` / \`docs/\` reference files that still
-    exist and flags/APIs that still match \`src/\`.
-  - \`${RUNTIME_ROOT}/knowledge.jsonl\` entries with recurring \`type\` in \`rule | pattern | lesson | compound\` and repeated \`trigger/action\` pairs; prefer clusters that already show stable \`origin_run\` history.
-- 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 4 distinct frames;
-narrow, elsewhere-software, and elsewhere-non-software runs require 2; all modes
-are capped by the configured frame count. Avoid frame-collapse (same idea
-rewritten many times). Keep raw outputs for auditability.
-
-### 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 \`critiqued-out\`.
-
-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** — one short imperative phrase
-   - **Impact** — High / Medium / Low
-   - **Effort** — S / M / L
-   - **Confidence** — High / Medium / Low
-   - **Evidence** — path(s) or command output, inline if short
-   - **Why now** — timing signal from repo evidence, user friction, repeated knowledge, or blocked flow
-   - **Expected impact** — concrete user-facing benefit if this lands
-   - **Risk** — main implementation/product risk to manage
-   - **Counter-argument** — strongest concern that survived
-   - **Next /cc prompt** — exact \`/cc <phrase>\` that starts the work
-3. Sort by score \`(impact points / effort cost) * confidence multiplier\`
-   and break ties with rationale strength.
-4. Compute the artifact filename:
-   - \`slug\` = first 3–5 words of the top recommendation, lowercase,
-     non-alphanumeric collapsed to \`-\`, trimmed. When idea mode is
-     focus-hinted (user passed an argument), use the focus hint instead.
-   - \`date\` = today in \`YYYY-MM-DD\` (local time).
-   - Path = \`.cclaw/artifacts/idea-<date>-<slug>.md\`.
-5. Use the harness's write-file tool (\`Write\`, \`apply_patch\`, or shell
-   \`cat <<EOF > path\`) to create the artifact with this schema:
-
-   \`\`\`markdown
-   # Ideation — <date>
-
-   **Focus:** <user-supplied focus or "open-ended scan">
-   **Mode:** <repo-grounded | elsewhere-software | elsewhere-non-software | narrow>
-   **Generated:** <ISO-8601 timestamp>
-   **Frames used:** <comma-separated list>
-   **Raw candidates:** <N>
-   **Critiqued out:** <M>
-   **Recommendation:** I-1
-
-   ## Grounding evidence
-
-   - <signal and evidence>
-   - ...
-
-   ## Critiqued out
-
-   | Idea | Why it was rejected |
-   |---|---|
-   | ... | ... |
-
-   ## Ranked survivors
-
-   | ID | Improvement | Why now | Expected impact | Risk | Impact | Effort | Confidence | Evidence | Next /cc prompt |
-   |---|---|---|---|---|---|---|---|---|---|
-| I-1 | Simplify a confusing generated prompt surface | Repeated blocker in generated UX | Faster operator recovery | Might over-trim context | High | S | High | <path-to-generated-surface> | \`/cc Simplify the confusing generated prompt surface while preserving behavior\` |
-   | …   | …                                  | …    | … | …    | …                                     |
-
-   ## Candidate detail
-
-### I-1 — Simplify a confusing generated prompt surface
-- **Evidence:** \`<path>\` contains repeated or stale guidance that a user would see.
-- **Why now:** The prompt is on the daily /cc path, so confusion compounds quickly.
-- **Expected impact:** Operators get a clearer next action without changing gates.
-- **Risk:** Trimming too hard can remove useful orientation for new users.
-- **Next /cc prompt:** \`/cc Simplify the confusing generated prompt surface while preserving behavior\`
-
-   ### I-2 — …
-   \`\`\`
-
-6. Optional: for promising non-selected ideas, write
-   \`${RUNTIME_ROOT}/seeds/SEED-<YYYY-MM-DD>-<slug>.md\` entries with:
-   \`title\`, \`trigger_when\`, \`hypothesis\`, \`action\`, and
-   \`source_artifact\` = idea artifact path.
-7. Confirm in chat: "Wrote <path>."
-
-### Phase 5 — Handoff prompt
-
-Present **one** structured ask using the harness's native tool
-(${STRUCTURED_ASK_TOOLS}). Each option must name the concrete follow-up —
-no bare A/B/C.
-
-Required options, in this order:
-
-1. **Start /cc on the top recommendation** — the agent immediately loads
-   \`${RUNTIME_ROOT}/skills/using-cclaw/SKILL.md\` and invokes
-   \`/cc <I-1 handoff phrase>\` in the same turn. Default choice.
-2. **Pick a different candidate** — the agent asks which ID (I-2, I-3, …)
-   and then invokes \`/cc <that candidate's handoff phrase>\`.
-3. **Save and close** — leave the artifact on disk, do nothing else.
-   Next session: \`/cc-idea\` will offer to resume it.
-4. **Discard** — delete the just-written artifact. Use only when the
-   scan produced nothing actionable.
-
-When the structured-ask tool is unavailable, fall back to a plain-text
-lettered list with the same four labels. Do not invent extra options.
-
-### Phase 6 — Execute the choice
-
-- **Start /cc on I-1** or **different candidate:** announce
-  "Handing off to /cc <phrase>" and load the \`using-cclaw\` router
-  skill. From there, the normal \`/cc\` classification and stage flow
-  takes over. Do not produce a second artifact; the idea file is
-  preserved as the origin document for this run.
-- **Save and close:** reply with the artifact path and stop.
-- **Discard:** delete the artifact file, confirm deletion, stop.
-
-## Do not
-
-- Do not write into \`.cclaw/artifacts/0X-*.md\` (stage artifacts).
-- Do not mutate \`.cclaw/state/flow-state.json\` at any phase.
-- Do not end the turn with an ungrounded "pick one" question — every
-  option in the handoff prompt must reference a concrete command.
-- Do not collapse all ideas into one frame; distribute across:
-  ${frameNames}.
-`;
-}

package/dist/content/idea-frames.d.ts

@@ -1,31 +0,0 @@
-export type IdeaFrameId = "pain-friction" | "inversion" | "assumption-break" | "leverage" | "cross-domain-analogy" | "constraint-flip";
-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[];

package/dist/content/idea-frames.js

@@ -1,140 +0,0 @@
-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"
-        ]
-    },
-    inversion: {
-        id: "inversion",
-        label: "inversion",
-        prompt: "Invert a dominant assumption in the current implementation (e.g., push vs pull, synchronous vs queued, implicit vs explicit) and evaluate upside.",
-        examplePatterns: [
-            "Replace optimistic assumptions with fail-closed defaults",
-            "Switch from post-facto checks to pre-flight validation",
-            "Move from global policy to module-local contracts"
-        ]
-    },
-    "assumption-break": {
-        id: "assumption-break",
-        label: "assumption-break",
-        prompt: "List assumptions that might be false in production. Generate ideas that remain correct even when those assumptions fail.",
-        examplePatterns: [
-            "Edge paths currently treated as impossible",
-            "Implicit coupling between modules with no explicit contract",
-            "Latency, scale, or environment assumptions baked into logic"
-        ]
-    },
-    leverage: {
-        id: "leverage",
-        label: "leverage",
-        prompt: "Target interventions with asymmetric payoff: one change that improves multiple stages, teams, or failure classes at once.",
-        examplePatterns: [
-            "A shared helper replacing duplicated logic in many files",
-            "One lint/gate that blocks an entire class of regressions",
-            "A protocol update that improves multiple stage outputs"
-        ]
-    },
-    "cross-domain-analogy": {
-        id: "cross-domain-analogy",
-        label: "cross-domain analogy",
-        prompt: "Borrow a proven pattern from another domain and adapt it to this repo. Keep it concrete and grounded in local constraints.",
-        examplePatterns: [
-            "Apply SRE-style error budgets to planning artifacts",
-            "Use security threat-model thinking for reliability design",
-            "Import CI release-train discipline into stage completion gates"
-        ]
-    },
-    "constraint-flip": {
-        id: "constraint-flip",
-        label: "constraint-flip",
-        prompt: "Flip one assumed constraint (time, team size, risk tolerance, compatibility) and derive better options under the new boundary.",
-        examplePatterns: [
-            "Assume near-zero migration window and redesign rollout",
-            "Assume one maintainer and optimize for low operational burden",
-            "Assume strict auditability and remove ambiguous behaviors"
-        ]
-    }
-};
-export const DEFAULT_IDEA_FRAME_IDS = Object.freeze([
-    "pain-friction",
-    "inversion",
-    "assumption-break",
-    "leverage",
-    "cross-domain-analogy",
-    "constraint-flip"
-]);
-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()];
-}

package/dist/content/idea-ranking.d.ts

@@ -1,25 +0,0 @@
-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;
-    rationaleStrength: number;
-    counterArgumentStrength: number;
-}
-export interface IdeaCandidateEvaluation extends IdeaCandidateEvaluationInput {
-    disposition: "survivor" | "critiqued-out";
-    rankingScore: number;
-}
-export interface IdeaRankingResult {
-    survivors: IdeaCandidateEvaluation[];
-    critiquedOut: IdeaCandidateEvaluation[];
-    recommendationId: string | null;
-}
-export declare function isCritiquedOut(rationaleStrength: number, counterArgumentStrength: number): boolean;
-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;

package/dist/content/idea-ranking.js

@@ -1,65 +0,0 @@
-const IMPACT_POINTS = {
-    high: 9,
-    medium: 6,
-    low: 3
-};
-const EFFORT_COST = {
-    s: 1,
-    m: 2,
-    l: 3
-};
-const CONFIDENCE_MULTIPLIER = {
-    high: 1,
-    medium: 0.75,
-    low: 0.5
-};
-function clampStrength(value) {
-    if (!Number.isFinite(value))
-        return 0;
-    if (value < 0)
-        return 0;
-    if (value > 1)
-        return 1;
-    return value;
-}
-export function isCritiquedOut(rationaleStrength, counterArgumentStrength) {
-    return clampStrength(counterArgumentStrength) > clampStrength(rationaleStrength);
-}
-export function scoreIdeaCandidate(impact, effort, confidence) {
-    const raw = (IMPACT_POINTS[impact] / EFFORT_COST[effort]) * CONFIDENCE_MULTIPLIER[confidence];
-    return Number(raw.toFixed(3));
-}
-export function evaluateIdeaCandidate(input) {
-    const disposition = isCritiquedOut(input.rationaleStrength, input.counterArgumentStrength)
-        ? "critiqued-out"
-        : "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) => {
-        if (right.rankingScore !== left.rankingScore) {
-            return right.rankingScore - left.rankingScore;
-        }
-        if (right.rationaleStrength !== left.rationaleStrength) {
-            return right.rationaleStrength - left.rationaleStrength;
-        }
-        return left.id.localeCompare(right.id);
-    })
-        .slice(0, Math.max(0, maxSurvivors));
-    const survivorIds = new Set(survivors.map((candidate) => candidate.id));
-    const critiquedOut = evaluated
-        .filter((candidate) => candidate.disposition === "critiqued-out" || !survivorIds.has(candidate.id))
-        .sort((left, right) => left.id.localeCompare(right.id));
-    return {
-        survivors,
-        critiquedOut,
-        recommendationId: survivors[0]?.id ?? null
-    };
-}

package/dist/trace-matrix.d.ts

@@ -1,27 +0,0 @@
-export interface TraceEntry {
-    criterionId: string;
-    taskIds: string[];
-    testSlices: string[];
-    reviewFindings: string[];
-}
-export interface ReviewLoopTraceEntry {
-    stage: "scope" | "design";
-    artifactPath: string;
-    targetScore: number;
-    maxIterations: number;
-    stopReason: "quality_threshold_met" | "max_iterations_reached" | "user_opt_out";
-    finalScore: number;
-    iterations: Array<{
-        iteration: number;
-        qualityScore: number;
-        findingsCount: number;
-    }>;
-}
-export interface TraceMatrix {
-    entries: TraceEntry[];
-    orphanedCriteria: string[];
-    orphanedTasks: string[];
-    orphanedTests: string[];
-    reviewLoops: ReviewLoopTraceEntry[];
-}
-export declare function buildTraceMatrix(projectRoot: string): Promise<TraceMatrix>;