@tracecart/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabor Tatar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# tracecart
+
+[![npm](https://img.shields.io/npm/v/@tracecart/cli)](https://npmjs.com/package/@tracecart/cli)
+[![license](https://img.shields.io/npm/l/@tracecart/cli)](LICENSE)
+
+[Documentation](docs/) · [npm](https://www.npmjs.com/package/@tracecart/cli)
+
+**Claim traceability tool** — extract atomic traces from source documents, verify coverage against targets, detect unsupported claims via reverse tracing.
+
+**The problem:** You have input documents (client specs, meeting notes, emails) and generated implementation specs. How do you know the specs cover everything? Manual review misses implicit requirements, compound sentences, and cross-document overrides.
+
+**tracecart** extracts atomic requirements, verifies each against your target documents, and optionally reverse-traces to catch hallucinations. Output: `trace-map.json` for editor visualization.
+
+## How it works
+
+```
+SOURCE DOCUMENTS (specs, meetings, emails)
+  │
+  ├─ Split into clauses (deterministic)
+  ├─ Extract traces (LLM, max 3 iterations)
+  ├─ Match traces against target (LLM)
+  ├─ [--reverse] Reverse trace: target → source (LLM)
+  │
+  ▼
+trace-map.json → LSP → Editor annotations (Zed, VS Code)
+```
+
+Two layers:
+- **Control layer** (deterministic TypeScript): clause splitting, validation, remainder tracking, finalization
+- **Semantic layer** (LLM via Claude Code subagents): extraction, coverage matching, reverse tracing
+
+## Install
+
+```bash
+npm install -g @tracecart/cli
+```
+
+## Quick start
+
+### As a Claude Code skill
+
+```bash
+# Install commands into your project
+tracecart init
+
+# Run forward pipeline
+/tracecart source.md target.md
+
+# Forward + reverse (detect unsupported claims in target)
+/tracecart source.md target.md --reverse
+
+# Custom preset
+/tracecart source.md target.md --preset contract-compliance
+```
+
+### CLI commands
+
+```bash
+tracecart split source.md                          # Split into clauses
+tracecart extract-prompt clauses.json --source source.md --preset spec-coverage
+tracecart extract-validate output.txt clauses.json --source source.md --preset spec-coverage
+tracecart remainder clauses.json traces.json       # Check uncovered clauses
+tracecart match-prompt traces.json target.md --preset spec-coverage
+tracecart match-validate output.txt traces.json --preset spec-coverage
+tracecart finalize traces.json matches.json --source source.md --target target.md -o trace-map.json
+tracecart presets                                  # List available presets
+```
+
+## Presets
+
+Presets define domain vocabulary (trace types, coverage statuses) and prompt templates. Switch presets for different comparison types without code changes.
+
+| Preset | Description |
+|--------|-------------|
+| `spec-coverage` (default) | Source requirements → target spec coverage |
+
+Custom presets: place `./presets/<name>.json` in your project.
+
+See [docs/presets.md](docs/presets.md) for format and examples.
+
+## Output
+
+`trace-map.json` — consumed by the LSP server for inline editor annotations.
+
+Coverage markers per trace:
+- **COVERED** — target fully addresses the requirement
+- **PARTIAL** — partially addressed, something missing
+- **MISSING** — not addressed at all
+- **DEFERRED** — explicitly out of scope
+- **N/A** — meta-statement, doesn't need coverage
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Presets](docs/presets.md) | Preset format, customization, discovery |
+| [Benchmarks](docs/benchmarks.md) | Extraction method comparison and scoring |
+| [Testing](docs/testing.md) | Test fixtures, running tests, adding ground truth |
+
+## Development
+
+```bash
+git clone https://github.com/tatargabor/tracecart.git
+cd tracecart
+npm install
+npm run build
+npm test
+```
+
+| Command | What it does |
+|---------|-------------|
+| `npm run build` | Compile TypeScript |
+| `npm run dev` | Watch mode |
+| `npm test` | Run tests (vitest) |
+| `npm run lint` | Type-check without emit |
+| `npm run clean` | Remove dist/ |
+
+### Publishing
+
+```bash
+./scripts/publish.sh patch   # bump → build → test → npm publish → git tag → GH release
+./scripts/publish.sh minor
+./scripts/publish.sh major
+./scripts/publish.sh --dry-run patch  # preview without changes
+```
+
+Requires clean working tree, `gh` CLI, and npm auth.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadPreset } from './preset.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PKG_ROOT = resolve(__dirname, '..');
+const DEFAULT_PRESET = 'spec-coverage';
+function loadJson(path) {
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+function getVersion() {
+    const pkg = loadJson(resolve(PKG_ROOT, 'package.json'));
+    return pkg.version;
+}
+function printUsage() {
+    const cmds = [
+        'split', 'extract-prompt', 'extract-validate', 'remainder',
+        'match-prompt', 'match-validate',
+        'reverse-extract-validate', 'reverse-match-prompt', 'reverse-match-validate',
+        'finalize', 'status', 'delta',
+        'presets', 'init', 'update',
+    ];
+    process.stderr.write(`tracecart v${getVersion()} — claim traceability tool\n\n`);
+    process.stderr.write(`Usage: tracecart <command> [--preset <name>] [args...]\n\n`);
+    process.stderr.write(`Commands:\n`);
+    for (const c of cmds) {
+        process.stderr.write(`  ${c}\n`);
+    }
+    process.exit(1);
+}
+function extractPresetArg(args) {
+    const remaining = [];
+    let presetName = DEFAULT_PRESET;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--preset' && args[i + 1]) {
+            presetName = args[++i];
+        }
+        else {
+            remaining.push(args[i]);
+        }
+    }
+    return { presetName, remaining };
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        printUsage();
+    }
+    if (args[0] === '--version' || args[0] === '-V') {
+        process.stdout.write(getVersion() + '\n');
+        return;
+    }
+    const cmd = args[0];
+    const cmdArgs = args.slice(1);
+    const { presetName, remaining } = extractPresetArg(cmdArgs);
+    let preset;
+    function getPreset() {
+        if (!preset)
+            preset = loadPreset(presetName, PKG_ROOT);
+        return preset;
+    }
+    switch (cmd) {
+        case 'split': {
+            const { cmdSplit } = await import('./commands/split.js');
+            await cmdSplit(remaining);
+            break;
+        }
+        case 'extract-prompt': {
+            const { cmdExtractPrompt } = await import('./commands/extract-prompt.js');
+            await cmdExtractPrompt(remaining, PKG_ROOT, getPreset());
+            break;
+        }
+        case 'extract-validate': {
+            const { cmdExtractValidate } = await import('./commands/extract-validate.js');
+            await cmdExtractValidate(remaining, getPreset());
+            break;
+        }
+        case 'remainder': {
+            const { cmdRemainder } = await import('./commands/remainder.js');
+            await cmdRemainder(remaining);
+            break;
+        }
+        case 'match-prompt': {
+            const { cmdMatchPrompt } = await import('./commands/match-prompt.js');
+            await cmdMatchPrompt(remaining, PKG_ROOT, getPreset());
+            break;
+        }
+        case 'match-validate': {
+            const { cmdMatchValidate } = await import('./commands/match-validate.js');
+            await cmdMatchValidate(remaining, getPreset());
+            break;
+        }
+        case 'reverse-extract-validate': {
+            const { cmdReverseExtractValidate } = await import('./commands/reverse-extract-validate.js');
+            await cmdReverseExtractValidate(remaining);
+            break;
+        }
+        case 'reverse-match-prompt': {
+            const { cmdReverseMatchPrompt } = await import('./commands/reverse-match-prompt.js');
+            await cmdReverseMatchPrompt(remaining, PKG_ROOT, getPreset());
+            break;
+        }
+        case 'reverse-match-validate': {
+            const { cmdReverseMatchValidate } = await import('./commands/reverse-match-validate.js');
+            await cmdReverseMatchValidate(remaining);
+            break;
+        }
+        case 'finalize': {
+            const { cmdFinalize } = await import('./commands/finalize.js');
+            await cmdFinalize(remaining);
+            break;
+        }
+        case 'status': {
+            const { cmdStatus } = await import('./commands/status.js');
+            await cmdStatus(remaining);
+            break;
+        }
+        case 'delta': {
+            const { cmdDelta } = await import('./commands/delta.js');
+            await cmdDelta(remaining);
+            break;
+        }
+        case 'presets': {
+            const { cmdPresets } = await import('./commands/presets.js');
+            await cmdPresets(PKG_ROOT);
+            break;
+        }
+        case 'init': {
+            const { cmdInit } = await import('./commands/init.js');
+            await cmdInit(remaining, PKG_ROOT);
+            break;
+        }
+        case 'update': {
+            const { cmdUpdate } = await import('./commands/update.js');
+            await cmdUpdate(remaining, PKG_ROOT);
+            break;
+        }
+        default:
+            process.stderr.write(`Unknown command: ${cmd}\n`);
+            printUsage();
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAGtD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAE1C,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAwB,CAAC;IAC/E,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW;QAC1D,cAAc,EAAE,gBAAgB;QAChC,0BAA0B,EAAE,sBAAsB,EAAE,wBAAwB;QAC5E,UAAU,EAAE,QAAQ,EAAE,OAAO;QAC7B,SAAS,EAAE,MAAM,EAAE,QAAQ;KAC5B,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,UAAU,EAAE,gCAAgC,CAAC,CAAC;IACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAc;IACtC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,UAAU,GAAG,cAAc,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1C,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClE,UAAU,EAAE,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE5D,IAAI,MAA0B,CAAC;IAC/B,SAAS,SAAS;QAChB,IAAI,CAAC,MAAM;YAAE,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACzD,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC1B,MAAM;QACR,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YAC1E,MAAM,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YACzD,MAAM;QACR,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAC9E,MAAM,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YACjD,MAAM;QACR,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACjE,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;YAC9B,MAAM;QACR,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACtE,MAAM,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YACvD,MAAM;QACR,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YAC1E,MAAM,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;YAC/C,MAAM;QACR,CAAC;QACD,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;YAC7F,MAAM,yBAAyB,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM;QACR,CAAC;QACD,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;YACrF,MAAM,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9D,MAAM;QACR,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,sCAAsC,CAAC,CAAC;YACzF,MAAM,uBAAuB,CAAC,SAAS,CAAC,CAAC;YACzC,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAC/D,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC3D,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;YAC3B,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACzD,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC1B,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAC7D,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC3B,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnC,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC3D,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAClD,UAAU,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/delta.d.ts

@@ -0,0 +1 @@
+export declare function cmdDelta(args: string[]): Promise<void>;

package/dist/commands/delta.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'node:fs';
+import { compare, formatText } from '../output/delta.js';
+export async function cmdDelta(args) {
+    if (args.length < 2) {
+        process.stderr.write('Usage: tracecart delta <old.json> <new.json> [--json]\n');
+        process.exit(1);
+    }
+    const oldMap = JSON.parse(readFileSync(args[0], 'utf-8'));
+    const newMap = JSON.parse(readFileSync(args[1], 'utf-8'));
+    const useJson = args.includes('--json');
+    const delta = compare(oldMap, newMap);
+    if (useJson) {
+        process.stdout.write(JSON.stringify(delta, null, 2));
+    }
+    else {
+        process.stdout.write(formatText(delta) + '\n');
+    }
+}
+//# sourceMappingURL=delta.js.map

package/dist/commands/delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../src/commands/delta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAc;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/commands/extract-prompt.d.ts

@@ -0,0 +1,2 @@
+import type { Preset } from '../preset.js';
+export declare function cmdExtractPrompt(args: string[], pkgRoot: string, preset: Preset): Promise<void>;

package/dist/commands/extract-prompt.js

@@ -0,0 +1,35 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+function parseArgs(args) {
+    let sourceFile = '';
+    const clausesPath = args[0];
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--source' && args[i + 1]) {
+            sourceFile = args[++i];
+        }
+    }
+    return { clausesPath, sourceFile };
+}
+export async function cmdExtractPrompt(args, pkgRoot, preset) {
+    if (!args[0]) {
+        process.stderr.write('Usage: tracecart extract-prompt <clauses.json> [--source <file>] [--preset <name>]\n');
+        process.exit(1);
+    }
+    const { clausesPath, sourceFile } = parseArgs(args);
+    const data = JSON.parse(readFileSync(clausesPath, 'utf-8'));
+    const clauses = data.clauses ?? (Array.isArray(data) ? data : []);
+    const templateFile = preset.prompts.extract ?? 'extract.txt';
+    const templatePath = resolve(pkgRoot, 'prompts', templateFile);
+    const template = readFileSync(templatePath, 'utf-8');
+    const clauseLines = [];
+    for (const c of clauses) {
+        if (c.is_header || c.is_meta)
+            continue;
+        clauseLines.push(`[${c.clause_id}] ${c.text}`);
+    }
+    let prompt = template.replace('{clauses}', clauseLines.join('\n'));
+    prompt = prompt.replace('{trace_types}', preset.trace_types.join(' | '));
+    prompt = prompt.replace('{coverage_statuses}', preset.coverage_statuses.join(' | '));
+    process.stdout.write(prompt);
+}
+//# sourceMappingURL=extract-prompt.js.map

package/dist/commands/extract-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-prompt.js","sourceRoot":"","sources":["../../src/commands/extract-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc,EAAE,OAAe,EAAE,MAAc;IACpF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC7G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAa,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE5E,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC;IAC7D,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO;YAAE,SAAS;QACvC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAErF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/commands/extract-validate.d.ts

@@ -0,0 +1,2 @@
+import type { Preset } from '../preset.js';
+export declare function cmdExtractValidate(args: string[], preset: Preset): Promise<void>;

package/dist/commands/extract-validate.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs';
+import { validateTraces } from '../extract/extract.js';
+export async function cmdExtractValidate(args, preset) {
+    if (args.length < 2) {
+        process.stderr.write('Usage: tracecart extract-validate <llm_output.txt> <clauses.json> [--source <file>] [--preset <name>]\n');
+        process.exit(1);
+    }
+    const rawOutput = readFileSync(args[0], 'utf-8');
+    const data = JSON.parse(readFileSync(args[1], 'utf-8'));
+    const clauses = data.clauses ?? (Array.isArray(data) ? data : []);
+    let sourceFile = '';
+    for (let i = 2; i < args.length; i++) {
+        if (args[i] === '--source' && args[i + 1]) {
+            sourceFile = args[++i];
+        }
+    }
+    const validTypes = new Set(preset.trace_types.map(t => t.toUpperCase()));
+    const result = validateTraces(rawOutput, clauses, sourceFile, 'T', validTypes);
+    process.stdout.write(JSON.stringify(result, null, 2));
+}
+//# sourceMappingURL=extract-validate.js.map

package/dist/commands/extract-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-validate.js","sourceRoot":"","sources":["../../src/commands/extract-validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAc,EAAE,MAAc;IACrE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yGAAyG,CAAC,CAAC;QAChI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAa,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE5E,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;IACxE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/commands/finalize.d.ts

@@ -0,0 +1 @@
+export declare function cmdFinalize(args: string[]): Promise<void>;

package/dist/commands/finalize.js

@@ -0,0 +1,64 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { applyMatches, resolveRefs } from '../match/coverage.js';
+import { buildTraceMap } from '../output/trace-map.js';
+export async function cmdFinalize(args) {
+    if (args.length < 2) {
+        process.stderr.write('Usage: tracecart finalize <traces.json> <matches.json> --source <file> --target <file> [--output trace-map.json]\n');
+        process.exit(1);
+    }
+    const tracesData = JSON.parse(readFileSync(args[0], 'utf-8'));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const traces = tracesData.traces ?? (Array.isArray(tracesData) ? tracesData : []);
+    const matchesData = JSON.parse(readFileSync(args[1], 'utf-8'));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const matches = matchesData.matches ?? (Array.isArray(matchesData) ? matchesData : []);
+    const sourceFiles = [];
+    const targetFiles = [];
+    let outputPath = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let untraced = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let reverseTraces = null;
+    let i = 2;
+    while (i < args.length) {
+        if (args[i] === '--source' && args[i + 1]) {
+            sourceFiles.push(args[++i]);
+        }
+        else if (args[i] === '--target' && args[i + 1]) {
+            targetFiles.push(args[++i]);
+        }
+        else if (args[i] === '--output' && args[i + 1]) {
+            outputPath = args[++i];
+        }
+        else if (args[i] === '--untraced' && args[i + 1]) {
+            const ud = JSON.parse(readFileSync(args[++i], 'utf-8'));
+            untraced = ud.remainder ?? (Array.isArray(ud) ? ud : []);
+        }
+        else if (args[i] === '--reverse-traces' && args[i + 1]) {
+            const rd = JSON.parse(readFileSync(args[++i], 'utf-8'));
+            reverseTraces = rd.traces ?? (Array.isArray(rd) ? rd : []);
+        }
+        i++;
+    }
+    const matchedTraces = applyMatches(traces, matches);
+    const resolvedTraces = resolveRefs(matchedTraces, targetFiles);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const traceMap = buildTraceMap(resolvedTraces, sourceFiles, targetFiles, untraced, undefined, (reverseTraces ?? undefined));
+    const outputJson = JSON.stringify(traceMap, null, 2);
+    if (outputPath) {
+        writeFileSync(outputPath, outputJson, 'utf-8');
+        process.stderr.write(`Written to ${outputPath}\n`);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const summary = traceMap.summary;
+        process.stderr.write(`Forward coverage: ${summary.coverage_score_pct}% ` +
+            `(${summary.covered}C/${summary.partial}P/${summary.missing}M/${summary.deferred}D)\n`);
+        if ('reverse_total' in summary) {
+            process.stderr.write(`Reverse coverage: ${summary.reverse_coverage_pct}% ` +
+                `(${summary.reverse_traced}T/${summary.reverse_partial_source ?? 0}P/${summary.reverse_untraced}U)\n`);
+        }
+    }
+    else {
+        process.stdout.write(outputJson);
+    }
+}
+//# sourceMappingURL=finalize.js.map

package/dist/commands/finalize.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function cmdInit(args: string[], pkgRoot: string): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+const TEMPLATE_REL = 'templates/claude/commands/tracecart.md';
+const TARGET_REL = '.claude/commands/tracecart.md';
+function extractVersion(content) {
+    const m = content.match(/<!--\s*tracecart\s+v([\d.]+)\s*-->/);
+    return m ? m[1] : null;
+}
+export async function cmdInit(args, pkgRoot) {
+    const projectDir = args[0] || process.cwd();
+    const templatePath = resolve(pkgRoot, TEMPLATE_REL);
+    const targetPath = resolve(projectDir, TARGET_REL);
+    if (!existsSync(templatePath)) {
+        process.stderr.write(`Error: template not found at ${templatePath}\n`);
+        process.exit(1);
+    }
+    const template = readFileSync(templatePath, 'utf-8');
+    const templateVersion = extractVersion(template);
+    if (existsSync(targetPath)) {
+        const existing = readFileSync(targetPath, 'utf-8');
+        const existingVersion = extractVersion(existing);
+        if (existingVersion === templateVersion) {
+            process.stderr.write(`Already up to date (v${templateVersion})\n`);
+            return;
+        }
+        process.stderr.write(`Updating ${TARGET_REL}: v${existingVersion ?? '?'} → v${templateVersion}\n`);
+    }
+    const targetDir = resolve(projectDir, '.claude/commands');
+    mkdirSync(targetDir, { recursive: true });
+    writeFileSync(targetPath, template, 'utf-8');
+    process.stderr.write(`Created ${TARGET_REL}\n`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,YAAY,GAAG,wCAAwC,CAAC;AAC9D,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAEnD,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc,EAAE,OAAe;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,YAAY,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEjD,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,eAAe,KAAK,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,UAAU,MAAM,eAAe,IAAI,GAAG,OAAO,eAAe,IAAI,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAC1D,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,UAAU,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/match-prompt.d.ts

@@ -0,0 +1,2 @@
+import type { Preset } from '../preset.js';
+export declare function cmdMatchPrompt(args: string[], pkgRoot: string, preset: Preset): Promise<void>;

package/dist/commands/match-prompt.js

@@ -0,0 +1,51 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { batchTraces } from '../match/coverage.js';
+export async function cmdMatchPrompt(args, pkgRoot, preset) {
+    if (args.length < 2) {
+        process.stderr.write('Usage: tracecart match-prompt <traces.json> <target.md> [--exclusions <text>] [--preset <name>]\n');
+        process.exit(1);
+    }
+    const tracesData = JSON.parse(readFileSync(args[0], 'utf-8'));
+    const traces = tracesData.traces ?? (Array.isArray(tracesData) ? tracesData : []);
+    const targetText = readFileSync(args[1], 'utf-8');
+    let exclusions = '';
+    for (let i = 2; i < args.length; i++) {
+        if (args[i] === '--exclusions' && args[i + 1]) {
+            exclusions = args[++i];
+        }
+    }
+    const templateFile = preset.prompts.coverage_check ?? 'coverage_check.txt';
+    const templatePath = resolve(pkgRoot, 'prompts', templateFile);
+    const template = readFileSync(templatePath, 'utf-8');
+    function formatPromptFromPreset(batch) {
+        const reqLines = [];
+        for (const t of batch) {
+            const tid = (t.id ?? t.sentence_id ?? '');
+            const text = (t.text ?? '');
+            const ttype = (t.type ?? 'REQUIREMENT');
+            const implicit = t.implicit ? ' [implicit]' : '';
+            reqLines.push(`[${tid}] (${ttype}${implicit}) ${text}`);
+        }
+        let prompt = template.replace('{requirements}', reqLines.join('\n'));
+        prompt = prompt.replace('{specs}', targetText);
+        prompt = prompt.replace('{exclusions}', exclusions || '(none specified)');
+        prompt = prompt.replace('{trace_types}', preset.trace_types.join(' | '));
+        prompt = prompt.replace('{coverage_statuses}', preset.coverage_statuses.join(' | '));
+        return prompt;
+    }
+    const batches = batchTraces(traces);
+    if (batches.length === 1) {
+        process.stdout.write(formatPromptFromPreset(traces));
+    }
+    else {
+        for (let bi = 0; bi < batches.length; bi++) {
+            process.stderr.write(`--- BATCH ${bi + 1}/${batches.length} ---\n`);
+            process.stdout.write(formatPromptFromPreset(batches[bi]));
+            if (bi < batches.length - 1) {
+                process.stdout.write('\n---BATCH_SEPARATOR---\n');
+            }
+        }
+    }
+}
+//# sourceMappingURL=match-prompt.js.map

package/dist/commands/match-prompt.js.map

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

package/dist/commands/match-validate.d.ts

@@ -0,0 +1,2 @@
+import type { Preset } from '../preset.js';
+export declare function cmdMatchValidate(args: string[], preset: Preset): Promise<void>;

package/dist/commands/match-validate.js

@@ -0,0 +1,15 @@
+import { readFileSync } from 'node:fs';
+import { validateMatches } from '../match/coverage.js';
+export async function cmdMatchValidate(args, preset) {
+    if (args.length < 2) {
+        process.stderr.write('Usage: tracecart match-validate <llm_output.txt> <traces.json> [--preset <name>]\n');
+        process.exit(1);
+    }
+    const rawOutput = readFileSync(args[0], 'utf-8');
+    const tracesData = JSON.parse(readFileSync(args[1], 'utf-8'));
+    const traces = tracesData.traces ?? (Array.isArray(tracesData) ? tracesData : []);
+    const validStatuses = new Set(preset.coverage_statuses.map(s => s.toUpperCase()));
+    const result = validateMatches(rawOutput, traces, validStatuses);
+    process.stdout.write(JSON.stringify(result, null, 2));
+}
+//# sourceMappingURL=match-validate.js.map

package/dist/commands/match-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-validate.js","sourceRoot":"","sources":["../../src/commands/match-validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc,EAAE,MAAc;IACnE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oFAAoF,CAAC,CAAC;QAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAElF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/commands/presets.d.ts

@@ -0,0 +1 @@
+export declare function cmdPresets(pkgRoot: string): Promise<void>;