@tracecart/cli 0.1.0

package/dist/parse/parse-document.js

@@ -0,0 +1,141 @@
+import * as fs from "node:fs";
+export function findChapterBoundaries(lines) {
+    const pattern = /^(\d+)\\?\.\s+(.+)$/;
+    const allHeaders = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = pattern.exec(lines[i].trim());
+        if (m) {
+            allHeaders.push({
+                number: parseInt(m[1], 10),
+                title: m[2].trim(),
+                line: i,
+            });
+        }
+    }
+    if (allHeaders.length === 0)
+        return [];
+    const blocks = [];
+    let currentBlock = [allHeaders[0]];
+    for (let i = 1; i < allHeaders.length; i++) {
+        const h = allHeaders[i];
+        const prev = currentBlock[currentBlock.length - 1];
+        if (h.number <= 1 && prev.number > 5) {
+            blocks.push(currentBlock);
+            currentBlock = [h];
+        }
+        else {
+            currentBlock.push(h);
+        }
+    }
+    blocks.push(currentBlock);
+    let mainBlock = null;
+    for (const block of blocks) {
+        if (block.length < 3)
+            continue;
+        const avgGap = (block[block.length - 1].line - block[0].line) / block.length;
+        if (avgGap > 10) {
+            mainBlock = block;
+            break;
+        }
+    }
+    if (mainBlock === null) {
+        mainBlock = blocks.reduce((best, b) => b[b.length - 1].line - b[0].line > best[best.length - 1].line - best[0].line
+            ? b
+            : best);
+    }
+    const chapters = [];
+    for (let i = 0; i < mainBlock.length; i++) {
+        const h = mainBlock[i];
+        let endLine;
+        if (i + 1 < mainBlock.length) {
+            endLine = mainBlock[i + 1].line;
+        }
+        else {
+            endLine = lines.length;
+            for (const block of blocks) {
+                if (block[0].line > h.line && block !== mainBlock) {
+                    endLine = block[0].line;
+                    break;
+                }
+            }
+        }
+        chapters.push({
+            number: h.number,
+            title: h.title,
+            start_line: h.line,
+            end_line: endLine,
+        });
+    }
+    return chapters;
+}
+export function extractChapterText(lines, chapter) {
+    return lines.slice(chapter.start_line, chapter.end_line).join("\n");
+}
+export function countContentLines(text) {
+    let count = 0;
+    for (const line of text.split("\n")) {
+        const stripped = line.trim();
+        if (stripped && !stripped.startsWith("#") && !/^\d+\.\d+/.test(stripped)) {
+            count++;
+        }
+    }
+    return count;
+}
+export function parseSections(text, chapterNum) {
+    const pattern = new RegExp(`^${chapterNum}\\.(\\d+)\\s+(.+)$`);
+    const sections = [];
+    for (const line of text.split("\n")) {
+        const m = pattern.exec(line.trim());
+        if (m) {
+            sections.push({
+                number: `${chapterNum}.${m[1]}`,
+                title: m[2].trim(),
+            });
+        }
+    }
+    return sections;
+}
+function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        process.stderr.write("Usage: parse-document.ts <document_file> [chapter_number]\n");
+        process.exit(1);
+    }
+    const specPath = args[0];
+    const targetChapter = args.length > 1 ? parseInt(args[1], 10) : null;
+    if (!fs.existsSync(specPath)) {
+        process.stderr.write(`Error: ${specPath} not found\n`);
+        process.exit(1);
+    }
+    const lines = fs.readFileSync(specPath, "utf-8").split("\n");
+    let chapters = findChapterBoundaries(lines);
+    if (targetChapter !== null) {
+        chapters = chapters.filter((c) => c.number === targetChapter);
+        if (chapters.length === 0) {
+            process.stderr.write(`Error: chapter ${targetChapter} not found\n`);
+            process.exit(1);
+        }
+    }
+    const result = [];
+    for (const ch of chapters) {
+        const text = extractChapterText(lines, ch);
+        const sections = parseSections(text, ch.number);
+        const contentLines = countContentLines(text);
+        result.push({
+            number: ch.number,
+            title: ch.title,
+            start_line: ch.start_line + 1,
+            end_line: ch.end_line,
+            sections,
+            content_lines: contentLines,
+            text,
+        });
+    }
+    process.stdout.write(JSON.stringify(result, null, 2));
+}
+const isMain = process.argv[1] &&
+    fs.realpathSync(process.argv[1]) === fs.realpathSync(import.meta.url.replace("file://", ""));
+if (isMain) {
+    main();
+}
+//# sourceMappingURL=parse-document.js.map

package/dist/parse/parse-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-document.js","sourceRoot":"","sources":["../../src/parse/parse-document.ts"],"names":[],"mappings":"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"}

package/dist/preset.d.ts

@@ -0,0 +1,18 @@
+export interface Preset {
+    name: string;
+    description?: string;
+    version?: string;
+    trace_types: string[];
+    coverage_statuses: string[];
+    prompts: Record<string, string>;
+    defaults?: Record<string, string>;
+}
+export declare function validatePreset(data: unknown): Preset;
+export declare function resolvePreset(name: string, pkgRoot: string): string | null;
+export declare function loadPreset(name: string, pkgRoot: string): Preset;
+export interface PresetInfo {
+    name: string;
+    description: string;
+    source: 'built-in' | 'project-local';
+}
+export declare function listPresets(pkgRoot: string): PresetInfo[];

package/dist/preset.js

@@ -0,0 +1,85 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+const REQUIRED_FIELDS = ['name', 'trace_types', 'coverage_statuses', 'prompts'];
+export function validatePreset(data) {
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        throw new Error('Preset must be a JSON object');
+    }
+    const obj = data;
+    for (const field of REQUIRED_FIELDS) {
+        if (!(field in obj)) {
+            throw new Error(`Preset missing required field: ${field}`);
+        }
+    }
+    if (typeof obj.name !== 'string') {
+        throw new Error('Preset "name" must be a string');
+    }
+    if (!Array.isArray(obj.trace_types) || obj.trace_types.some((t) => typeof t !== 'string')) {
+        throw new Error('Preset "trace_types" must be a string array');
+    }
+    if (!Array.isArray(obj.coverage_statuses) || obj.coverage_statuses.some((s) => typeof s !== 'string')) {
+        throw new Error('Preset "coverage_statuses" must be a string array');
+    }
+    if (typeof obj.prompts !== 'object' || obj.prompts === null || Array.isArray(obj.prompts)) {
+        throw new Error('Preset "prompts" must be an object');
+    }
+    return obj;
+}
+export function resolvePreset(name, pkgRoot) {
+    const localPath = resolve(process.cwd(), 'presets', `${name}.json`);
+    if (existsSync(localPath))
+        return localPath;
+    const builtinPath = resolve(pkgRoot, 'presets', `${name}.json`);
+    if (existsSync(builtinPath))
+        return builtinPath;
+    return null;
+}
+export function loadPreset(name, pkgRoot) {
+    const path = resolvePreset(name, pkgRoot);
+    if (!path) {
+        const available = listPresets(pkgRoot);
+        const names = available.map(p => p.name).join(', ');
+        throw new Error(`Preset "${name}" not found. Available: ${names}`);
+    }
+    const raw = JSON.parse(readFileSync(path, 'utf-8'));
+    return validatePreset(raw);
+}
+export function listPresets(pkgRoot) {
+    const presets = new Map();
+    const builtinDir = resolve(pkgRoot, 'presets');
+    if (existsSync(builtinDir)) {
+        for (const file of readdirSync(builtinDir)) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const data = JSON.parse(readFileSync(resolve(builtinDir, file), 'utf-8'));
+                const preset = validatePreset(data);
+                presets.set(preset.name, {
+                    name: preset.name,
+                    description: preset.description ?? '',
+                    source: 'built-in',
+                });
+            }
+            catch { /* skip invalid */ }
+        }
+    }
+    const localDir = resolve(process.cwd(), 'presets');
+    if (existsSync(localDir)) {
+        for (const file of readdirSync(localDir)) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const data = JSON.parse(readFileSync(resolve(localDir, file), 'utf-8'));
+                const preset = validatePreset(data);
+                presets.set(preset.name, {
+                    name: preset.name,
+                    description: preset.description ?? '',
+                    source: 'project-local',
+                });
+            }
+            catch { /* skip invalid */ }
+        }
+    }
+    return [...presets.values()];
+}
+//# sourceMappingURL=preset.js.map

package/dist/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@tracecart/cli",
+  "version": "0.1.0",
+  "description": "Claim traceability tool — extract traces from source documents, verify coverage against targets",
+  "keywords": [
+    "traceability",
+    "requirements",
+    "coverage",
+    "specification",
+    "verification",
+    "llm",
+    "claude-code",
+    "reverse-trace"
+  ],
+  "homepage": "https://github.com/tatargabor/tracecart",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tatargabor/tracecart"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/preset.d.ts",
+      "import": "./dist/preset.js"
+    },
+    "./preset": {
+      "types": "./dist/preset.d.ts",
+      "import": "./dist/preset.js"
+    }
+  },
+  "bin": {
+    "tracecart": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "presets",
+    "prompts",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "tsc"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/presets/spec-coverage.json

@@ -0,0 +1,15 @@
+{
+  "name": "spec-coverage",
+  "description": "Source requirements → target spec coverage verification",
+  "version": "1.0",
+  "trace_types": ["REQUIREMENT", "DECISION", "WISH", "OPEN_QUESTION", "EXCLUSION"],
+  "coverage_statuses": ["COVERED", "PARTIAL", "MISSING", "DEFERRED", "N/A"],
+  "prompts": {
+    "extract": "extract.txt",
+    "coverage_check": "coverage_check.txt",
+    "reverse_check": "reverse_check.txt"
+  },
+  "defaults": {
+    "language": "en"
+  }
+}

package/prompts/coverage_check.txt

@@ -0,0 +1,38 @@
+You are verifying specification coverage.
+
+For EACH requirement below, check if the spec sections address it:
+
+Status options:
+{coverage_statuses}
+
+Status descriptions:
+- COVERED: the spec FULLY addresses this specific point. Cite spec file + section.
+- PARTIAL: the spec addresses part but misses something. Explain what's missing.
+- MISSING: not addressed in the specs AND not in the scope exclusions.
+- DEFERRED: the topic is explicitly in the scope exclusions list (M2+).
+- N/A: meta-statement or framing decision that doesn't need implementable spec coverage.
+
+STRICT RULES:
+- COVERED requires the spec to address the SPECIFIC point, not just mention the topic area
+- Check modal verbs: if requirement says "may send" but spec says "sends" → PARTIAL
+- EXCLUSION-type requirements are scope boundaries — check if specs ALSO state this boundary
+- For [implicit] requirements: if the implicit claim is about HOW to implement (data model, real-time vs batch, configurability) rather than WHAT the system must do, mark N/A — specs are not required to mirror implementation assumptions
+
+SCOPE EXCLUSIONS (M2+):
+{exclusions}
+
+REQUIREMENTS TO CHECK:
+{requirements}
+
+SPEC SECTIONS:
+{specs}
+
+OUTPUT — JSON array only:
+[
+  {
+    "sentence_id": "CS-9-001",
+    "status": "COVERED",
+    "spec_ref": "01-order-intake.md §2.1",
+    "notes": ""
+  }
+]

package/prompts/extract.txt

@@ -0,0 +1,40 @@
+You are extracting atomic requirements from a specification document.
+The text has been pre-split into numbered clauses. Each clause has a clause_id (e.g., L27-C3).
+
+RULES:
+- Every clause that carries meaning must produce at least one requirement entry
+- If a clause contains multiple independent facts joined by "or", split them
+- IMPLICIT requirements — extract ONLY when the source text LINGUISTICALLY implies them:
+  - Modal verbs: "may send" ≠ "sends" → note optionality
+  - Scope markers: "exclusively" → hard boundary that needs enforcement
+  - Negation scope: "does not apply to X" → exclusion boundary needs category logic
+  - Domain terms: "B2B" → implies not end-consumer
+  DO NOT extract implicit requirements based on logical inference or implementation guessing:
+  - BAD: "considers warehouse stock" → "needs real-time stock data" (implementation guess)
+  - BAD: "minimum order quantity" → "must be configurable" (logical inference)
+  - GOOD: "exclusively from FSC suppliers" → "system must block non-FSC orders" (linguistic: "exclusively" = enforcement)
+  The test: could a reader DISAGREE with the implicit requirement while agreeing with the source text? If yes, don't extract it.
+- NEGATIVE requirements: "will not", "not needed", "not a goal" → type: EXCLUSION
+- Tag each entry:
+  - type: {trace_types}
+  - tags (one or more): orders, email, ai, materials, manufacturing, logistics, communication, crm, partners, billing, products, finishing, capacity, shipping, documents, design, portal, pricing
+
+OUTPUT FORMAT — JSON array only, no other text:
+[
+  {
+    "id": "CS-{chapter}-{NNN}",
+    "clause_id": "L27-C3",
+    "type": "REQUIREMENT",
+    "tags": ["orders", "manufacturing"],
+    "text": "Confirmation must consider CNC capacity",
+    "triple": {"subject": "confirmation", "attribute": "must consider", "object": "CNC capacity"},
+    "implicit": false
+  }
+]
+
+For implicit requirements, set "implicit": true and add "signal" field explaining what word/phrase triggered it.
+
+CLAUSE LIST:
+{clauses}
+
+AFTER extraction, CHECK: list any clause_ids from the input that are NOT cited by any requirement. These are potential gaps — extract requirements from them too.

package/prompts/reverse_check.txt

@@ -0,0 +1,36 @@
+You are verifying reverse traceability — checking whether target claims can be traced back to source documents.
+
+For EACH target claim below, check if the source traces support it:
+
+Status options:
+- TRACED: a source trace FULLY supports this specific claim. Cite the source trace ID.
+- PARTIAL_SOURCE: the source mentions the topic but the claim adds unsupported specifics. Explain what's unsupported.
+- UNTRACED_IN_SOURCE: no source trace supports this claim — it may be hallucinated, creative addition, or from an unknown source.
+
+STRICT RULES:
+- TRACED requires a source trace that supports the SPECIFIC claim, not just the topic area
+- Check modal verbs: if target says "sends" but source says "may send" → PARTIAL_SOURCE
+- If untraced or partial, identify the NEAREST source trace (most semantically similar) and explain the gap
+
+TARGET CLAIMS TO CHECK:
+{claims}
+
+SOURCE TRACES:
+{evidence}
+
+OUTPUT — JSON array only:
+[
+  {
+    "claim_id": "RT-a3f2c1-012-0",
+    "status": "TRACED",
+    "source_trace_id": "T-b2d4e7-047-0",
+    "nearest_source_trace": null,
+    "similarity_note": "",
+    "notes": ""
+  }
+]
+
+IMPORTANT for UNTRACED_IN_SOURCE and PARTIAL_SOURCE:
+- Set "source_trace_id" to null
+- Set "nearest_source_trace" to the ID of the most similar source trace (or null if none is even remotely related)
+- Set "similarity_note" to explain why it's close but not sufficient (or "no related source trace found" if no match)

package/templates/claude/commands/tracecart.md

@@ -0,0 +1,217 @@
+<!-- tracecart v0.2.1 -->
+---
+name: "Tracecart"
+description: "Run the full trace pipeline: source → target → trace-map.json. Deterministic CLI steps + LLM subagent extraction and matching."
+---
+
+# Trace Pipeline
+
+Run the complete tracecart pipeline to extract traces from source documents and verify coverage against target documents.
+
+**Input**: `/tracecart <source> <target> [--preset <name>] [--reverse]`
+
+- `<source>`: path to the source document (authoritative input, e.g., meeting notes)
+- `<target>`: path to the target document (verified for completeness, e.g., spec)
+- `--preset`: preset name, defaults to `spec-coverage`. Run `tracecart presets` to list available presets.
+- `--reverse`: also run reverse tracing (target → source) to detect unsupported claims in the target
+
+Parse `$ARGUMENTS` to extract these. If arguments are missing, ask the user.
+
+## Presets
+
+Presets define the domain vocabulary (trace types, coverage statuses) and prompt templates used by the pipeline. The same pipeline structure works for different use cases by switching presets.
+
+**Built-in presets:**
+- `spec-coverage` — Source requirements → target spec coverage verification (default)
+
+**Custom presets:** Place a JSON file in `./presets/<name>.json` in your project. Project-local presets override built-in ones by name.
+
+**Preset format:**
+```json
+{
+  "name": "my-preset",
+  "description": "What this preset checks",
+  "version": "1.0",
+  "trace_types": ["TYPE_A", "TYPE_B"],
+  "coverage_statuses": ["STATUS_A", "STATUS_B"],
+  "prompts": {
+    "extract": "extract.txt",
+    "coverage_check": "coverage_check.txt",
+    "reverse_check": "reverse_check.txt"
+  }
+}
+```
+
+## Pipeline Steps
+
+Execute these steps in order. Each step is explicit — follow exactly as written.
+
+### Step 1: Split source into clauses
+
+```bash
+tracecart split <source> > /tmp/tracecart-clauses.json
+```
+
+Report: "Split complete: N content clauses from M lines."
+
+### Step 2: Extract traces (LLM loop — max 3 iterations)
+
+Set `iteration = 1` and `previous_remaining = Infinity`.
+
+**Loop:**
+
+#### 2a. Generate extraction prompt
+
+```bash
+tracecart extract-prompt /tmp/tracecart-clauses.json --source <source> --preset <preset> > /tmp/tracecart-extract-prompt.txt
+```
+
+#### 2b. Send to subagent
+
+Use the **Agent tool** to spawn a subagent with the content of `/tmp/tracecart-extract-prompt.txt` as the prompt. The subagent should return a JSON array of extracted traces.
+
+Save the subagent's full response to `/tmp/tracecart-extract-raw.txt`.
+
+#### 2c. Validate extraction
+
+```bash
+tracecart extract-validate /tmp/tracecart-extract-raw.txt /tmp/tracecart-clauses.json --source <source> --preset <preset> > /tmp/tracecart-traces.json
+```
+
+Report any validation errors from the output.
+
+#### 2d. Check remainder
+
+```bash
+tracecart remainder /tmp/tracecart-clauses.json /tmp/tracecart-traces.json > /tmp/tracecart-remainder.json
+```
+
+Read the output and check:
+- `stats.clauses_remaining`: number of uncovered clauses
+- `stats.coverage_pct`: coverage percentage
+
+**Decision:**
+- If `clauses_remaining == 0`: extraction complete, go to Step 3
+- If `clauses_remaining < previous_remaining` AND `iteration < 3`:
+  set `previous_remaining = clauses_remaining`, increment `iteration`, go back to 2a
+- Otherwise (stalled or max iterations): report remainder count, go to Step 3
+
+Report: "Extraction iteration N: coverage_pct% (remaining clauses)."
+
+### Step 3: Match traces against target (LLM)
+
+#### 3a. Generate matching prompt
+
+```bash
+tracecart match-prompt /tmp/tracecart-traces.json <target> --preset <preset> > /tmp/tracecart-match-prompt.txt
+```
+
+#### 3b. Send to subagent
+
+Use the **Agent tool** to spawn a subagent with the content of `/tmp/tracecart-match-prompt.txt` as the prompt. The subagent should return a JSON array of coverage assessments.
+
+Save the subagent's full response to `/tmp/tracecart-match-raw.txt`.
+
+#### 3c. Validate matching
+
+```bash
+tracecart match-validate /tmp/tracecart-match-raw.txt /tmp/tracecart-traces.json --preset <preset> > /tmp/tracecart-matches.json
+```
+
+Report any validation errors.
+
+### Step 4: Finalize
+
+```bash
+tracecart finalize /tmp/tracecart-traces.json /tmp/tracecart-matches.json --source <source> --target <target> --output trace-map.json
+```
+
+### Step 5: Report
+
+Read `trace-map.json` and report the coverage summary:
+- Total traces
+- COVERED / PARTIAL / MISSING / DEFERRED / N/A counts
+- Coverage score percentage
+
+If there are MISSING traces, list the top 5 with their text.
+
+## Reverse Tracing (only if `--reverse` is set)
+
+If `--reverse` was NOT specified, stop here. Otherwise continue with steps R1–R5.
+
+Reverse tracing checks whether target claims can be traced BACK to the source — catching hallucinations, creative additions, or unsupported specifics in the target document.
+
+### Step R1: Split target into clauses
+
+```bash
+tracecart split <target> > /tmp/tracecart-target-clauses.json
+```
+
+Report: "Target split: N content clauses."
+
+### Step R2: Extract target claims (LLM)
+
+#### R2a. Generate extraction prompt
+
+```bash
+tracecart extract-prompt /tmp/tracecart-target-clauses.json --source <target> --preset <preset> > /tmp/tracecart-reverse-extract-prompt.txt
+```
+
+#### R2b. Send to subagent
+
+Use the **Agent tool** to spawn a subagent with the content of `/tmp/tracecart-reverse-extract-prompt.txt` as the prompt. The subagent should return a JSON array of extracted claims.
+
+Save the subagent's full response to `/tmp/tracecart-reverse-extract-raw.txt`.
+
+#### R2c. Validate extraction (RT- prefix)
+
+```bash
+tracecart reverse-extract-validate /tmp/tracecart-reverse-extract-raw.txt /tmp/tracecart-target-clauses.json --target <target> --preset <preset> > /tmp/tracecart-reverse-traces.json
+```
+
+Report any validation errors.
+
+### Step R3: Match target claims against source traces (LLM)
+
+#### R3a. Generate reverse matching prompt
+
+```bash
+tracecart reverse-match-prompt /tmp/tracecart-reverse-traces.json /tmp/tracecart-traces.json --preset <preset> > /tmp/tracecart-reverse-match-prompt.txt
+```
+
+#### R3b. Send to subagent
+
+Use the **Agent tool** to spawn a subagent with the content of `/tmp/tracecart-reverse-match-prompt.txt` as the prompt. The subagent should return a JSON array of reverse traceability assessments.
+
+Save the subagent's full response to `/tmp/tracecart-reverse-match-raw.txt`.
+
+#### R3c. Validate reverse matching
+
+```bash
+tracecart reverse-match-validate /tmp/tracecart-reverse-match-raw.txt /tmp/tracecart-reverse-traces.json > /tmp/tracecart-reverse-matches.json
+```
+
+Report any validation errors.
+
+### Step R4: Finalize with reverse traces
+
+```bash
+tracecart finalize /tmp/tracecart-traces.json /tmp/tracecart-matches.json --source <source> --target <target> --reverse-traces /tmp/tracecart-reverse-matches.json --output trace-map.json
+```
+
+### Step R5: Reverse report
+
+Read `trace-map.json` and report the reverse traceability summary:
+- Total target claims
+- TRACED / PARTIAL_SOURCE / UNTRACED_IN_SOURCE counts
+- Reverse coverage percentage
+
+If there are UNTRACED_IN_SOURCE claims, list the top 5 with their text and the nearest source trace (if any).
+
+## Notes
+
+- All intermediate files go to `/tmp/tracecart-*` to avoid polluting the project directory
+- The extraction loop (Step 2) runs max 3 iterations and stops early if remainder doesn't shrink
+- Each subagent call is independent — the prompt contains all context the subagent needs
+- If any step fails, report the error and stop — don't continue with partial data
+- Reverse tracing (Steps R1–R5) only runs when `--reverse` is specified