@opensip-cli/contracts 0.1.0

package/dist/signal-envelope.test.js

@@ -0,0 +1,168 @@
+import { createSignal, defaultFingerprintStrategy, HOST_VERDICT_POLICY_FALLBACK, } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { buildSignalEnvelope } from './signal-envelope.js';
+function signal(severity) {
+    return createSignal({
+        source: 'test',
+        severity,
+        ruleId: `rule-${severity}`,
+        message: `a ${severity} finding`,
+    });
+}
+function unit(slug, passed) {
+    return { slug, passed, durationMs: 1 };
+}
+const BASE = {
+    tool: 'fit',
+    runId: 'run-1',
+    createdAt: '2026-01-01T00:00:00.000Z',
+    // ADR-0035: verdict is policy-driven. The {1,0} fallback (fail on any error,
+    // warnings informational) reproduces the pre-ADR `errors === 0` behavior these
+    // baseline cases assert. The full policy matrix lives in verdict-envelope.test.ts.
+    policy: HOST_VERDICT_POLICY_FALLBACK,
+    runFaulted: false,
+};
+/** A recognizable non-default strategy for the stamping cases. */
+const toolStrategy = (s) => `tool:${s.ruleId}`;
+describe('buildSignalEnvelope', () => {
+    it('stamps the schema version and identity, and passes units through verbatim', () => {
+        const units = [unit('a', true), unit('b', true)];
+        const signals = [signal('low')];
+        const env = buildSignalEnvelope({
+            ...BASE,
+            recipe: 'example',
+            units,
+            signals,
+            resolutionMode: 'fast',
+        });
+        expect(env.schemaVersion).toBe(2);
+        expect(env.tool).toBe('fit');
+        expect(env.recipe).toBe('example');
+        expect(env.runId).toBe('run-1');
+        expect(env.createdAt).toBe('2026-01-01T00:00:00.000Z');
+        expect(env.resolutionMode).toBe('fast');
+        // units pass through, not copies
+        expect(env.units).toBe(units);
+    });
+    // ADR-0036: fingerprints are an envelope-construction concern — every built
+    // envelope is gate-ready, so the "tool forgot to stamp" class cannot occur.
+    describe('fingerprint stamping (ADR-0036)', () => {
+        it('stamps every signal with the host default strategy when none is passed', () => {
+            const env = buildSignalEnvelope({
+                ...BASE,
+                units: [unit('a', false)],
+                signals: [signal('low')],
+            });
+            const stamped = env.signals[0];
+            expect(stamped.fingerprint).toBe(defaultFingerprintStrategy(stamped));
+        });
+        it('stamps with the tool strategy when one is passed', () => {
+            const env = buildSignalEnvelope({
+                ...BASE,
+                units: [unit('a', false)],
+                signals: [signal('high')],
+                fingerprintStrategy: toolStrategy,
+            });
+            expect(env.signals[0]?.fingerprint).toBe('tool:rule-high');
+        });
+        it('preserves pre-stamped signals byte-for-byte and by array identity', () => {
+            const preStamped = [{ ...signal('low'), fingerprint: 'pre-existing' }];
+            const env = buildSignalEnvelope({
+                ...BASE,
+                units: [unit('a', true)],
+                signals: preStamped,
+                fingerprintStrategy: () => 'would-clobber',
+            });
+            expect(env.signals[0]?.fingerprint).toBe('pre-existing');
+            // fully pre-stamped sets pass through by identity (no re-allocation)
+            expect(env.signals).toBe(preStamped);
+        });
+    });
+    it('derives summary.total/passed/failed from the units (units are what "ran")', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [unit('a', true), unit('b', false), unit('c', true), unit('d', false)],
+            signals: [],
+        });
+        expect(env.verdict.summary.total).toBe(4);
+        expect(env.verdict.summary.passed).toBe(2);
+        expect(env.verdict.summary.failed).toBe(2);
+    });
+    it('counts critical and high signals as errors; medium and low as warnings', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [unit('a', false)],
+            signals: [signal('critical'), signal('high'), signal('medium'), signal('low')],
+        });
+        expect(env.verdict.summary.errors).toBe(2);
+        expect(env.verdict.summary.warnings).toBe(2);
+    });
+    it('passed ⇔ zero error-rung signals: a warnings-only run still passes', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [unit('a', true)],
+            signals: [signal('medium'), signal('low')],
+        });
+        expect(env.verdict.summary.errors).toBe(0);
+        expect(env.verdict.passed).toBe(true);
+    });
+    it('passed is false as soon as a single error-rung signal is present', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            // every unit reported passed, but an error-rung signal still fails the run
+            units: [unit('a', true)],
+            signals: [signal('high')],
+        });
+        expect(env.verdict.summary.errors).toBe(1);
+        expect(env.verdict.passed).toBe(false);
+    });
+    it('score is passRate over the unit summary (rounded passed/total percentage)', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [unit('a', true), unit('b', true), unit('c', false)],
+            signals: [],
+        });
+        // 2 of 3 passed → round(66.67) === 67
+        expect(env.verdict.score).toBe(67);
+    });
+    it('scores 100 for an empty run (no units) and reports it as passed', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [],
+            signals: [],
+        });
+        expect(env.verdict.summary.total).toBe(0);
+        expect(env.verdict.summary.passed).toBe(0);
+        expect(env.verdict.summary.failed).toBe(0);
+        expect(env.verdict.score).toBe(100);
+        expect(env.verdict.passed).toBe(true);
+    });
+    it('expresses "ran, errored, 0 signals": a unit can carry an error with no signals', () => {
+        const errored = {
+            slug: 'boom',
+            passed: false,
+            durationMs: 5,
+            error: 'adapter exploded',
+        };
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [errored],
+            signals: [],
+        });
+        expect(env.units[0]?.error).toBe('adapter exploded');
+        expect(env.verdict.summary.failed).toBe(1);
+        // no signals → no errors counted, but the failed unit drags the score down
+        expect(env.verdict.summary.errors).toBe(0);
+        expect(env.verdict.score).toBe(0);
+    });
+    it('omits optional recipe and resolutionMode when not supplied', () => {
+        const env = buildSignalEnvelope({
+            ...BASE,
+            units: [unit('a', true)],
+            signals: [],
+        });
+        expect(env.recipe).toBeUndefined();
+        expect(env.resolutionMode).toBeUndefined();
+    });
+});
+//# sourceMappingURL=signal-envelope.test.js.map

package/dist/signal-envelope.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-envelope.test.js","sourceRoot":"","sources":["../src/signal-envelope.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,4BAA4B,GAG7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAmB,MAAM,sBAAsB,CAAC;AAE5E,SAAS,MAAM,CAAC,QAAwB;IACtC,OAAO,YAAY,CAAC;QAClB,MAAM,EAAE,MAAM;QACd,QAAQ;QACR,MAAM,EAAE,QAAQ,QAAQ,EAAE;QAC1B,OAAO,EAAE,KAAK,QAAQ,UAAU;KACjC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,MAAe;IACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,KAAc;IACpB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,0BAA0B;IACrC,6EAA6E;IAC7E,+EAA+E;IAC/E,mFAAmF;IACnF,MAAM,EAAE,4BAA4B;IACpC,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,kEAAkE;AAClE,MAAM,YAAY,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;AAE/D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,MAAM,EAAE,SAAS;YACjB,KAAK;YACL,OAAO;YACP,cAAc,EAAE,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,iCAAiC;QACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,4EAA4E;IAC5E,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;YAChF,MAAM,GAAG,GAAG,mBAAmB,CAAC;gBAC9B,GAAG,IAAI;gBACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACzB,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACzB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,GAAG,GAAG,mBAAmB,CAAC;gBAC9B,GAAG,IAAI;gBACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACzB,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACzB,mBAAmB,EAAE,YAAY;aAClC,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;YAC3E,MAAM,UAAU,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;YACvE,MAAM,GAAG,GAAG,mBAAmB,CAAC;gBAC9B,GAAG,IAAI;gBACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACxB,OAAO,EAAE,UAAU;gBACnB,mBAAmB,EAAE,GAAG,EAAE,CAAC,eAAe;aAC3C,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACzD,qEAAqE;YACrE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7E,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,OAAO,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;SAC/E,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;SAC3C,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,2EAA2E;YAC3E,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3D,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAEH,sCAAsC;QACtC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,OAAO,GAAe;YAC1B,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,CAAC;YACb,KAAK,EAAE,kBAAkB;SAC1B,CAAC;QACF,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,2EAA2E;QAC3E,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,aAAa,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/** Options for the `fit` subcommand (derived from Commander flags). */
+export interface FitOptions {
+    recipe?: string;
+    check?: string;
+    /**
+     * Tag filters for ad-hoc check selection. Repeatable and/or
+     * comma-separated: `--tags a --tags b` and `--tags a,b` both accumulate
+     * (the `--tags` OptionSpec declares an array accumulator). Each element
+     * may itself be a comma-separated list; consumers flatten + trim.
+     */
+    tags?: string[];
+    list: boolean;
+    recipes: boolean;
+    json: boolean;
+    verbose: boolean;
+    reportTo?: string;
+    apiKey?: string;
+    exclude: string[];
+    cwd: string;
+    /** Explicit path to opensip-cli.config.yml (overrides package.json pointer and default location). */
+    config?: string;
+    debug: boolean;
+    /** Suppress banner/boxes; show only the pass-fail summary line. */
+    quiet?: boolean;
+    /** Open the HTML report in the default browser after a successful run. */
+    open?: boolean;
+    /** Replay a stored fit session by id, or `latest` for the latest fit session. */
+    show?: string;
+    /** Architecture-gate: save the current run's findings as a baseline. Mutually exclusive with --gate-compare. */
+    gateSave?: boolean;
+    /** Architecture-gate: compare current findings against a saved baseline; exit 1 if regressions found. Mutually exclusive with --gate-save. */
+    gateCompare?: boolean;
+}
+/** Options for the `init` subcommand. */
+export interface InitOptions {
+    cwd: string;
+    json: boolean;
+    debug: boolean;
+    /**
+     * Language list. Repeatable and/or comma-separated: `--language ts
+     * --language rust` and `--language ts,rust` both accumulate (the
+     * `--language` OptionSpec declares an array accumulator). When omitted,
+     * init detects the project's primary language(s) by inspecting filesystem
+     * markers (Cargo.toml, pyproject.toml, etc.) and exits 2 with a prompt if
+     * the result is ambiguous.
+     */
+    language?: string[];
+    /**
+     * Re-scaffold example files. Preserve any custom files in
+     * `opensip-cli/`. Mutually exclusive with `remove`.
+     */
+    keep?: boolean;
+    /**
+     * Delete `opensip-cli/` entirely, then scaffold fresh. Mutually
+     * exclusive with `keep`.
+     */
+    remove?: boolean;
+}
+/** Options for `sim` subcommand. */
+export interface ToolOptions {
+    cwd: string;
+    json: boolean;
+    debug: boolean;
+    /** Recipe name to run. Defaults to the built-in `default` if omitted. */
+    recipe?: string;
+    /**
+     * `--report-to <url>` — POST the run's signals to OpenSIP Cloud or a
+     * compatible receiver. sim gained cloud egress when it began emitting the
+     * signal envelope (ADR-0011, Phase 4); the composition root's
+     * `deliverSignals` owns the actual egress (and exit code 4).
+     */
+    reportTo?: string;
+    /** `--api-key <key>` — auth for `--report-to`. */
+    apiKey?: string;
+    /** Replay a stored tool session by id, or `latest` for the latest session for this tool. */
+    show?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gHAAgH;IAChH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8IAA8I;IAC9I,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// =============================================================================
+// CLI OPTIONS TYPES
+// =============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF"}

package/dist/verbose-detail.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Verbose-detail builders (ADR-0021) — the shared transform from a run's
+ * `Signal[]` + units into the renderer-agnostic `FindingGroup[]` carried on a
+ * `*DoneResult` and rendered by the cli `resultToView` seam.
+ *
+ * Lives in contracts (next to `buildSignalEnvelope`) so fit and sim — peer
+ * packages that cannot import each other — share ONE mapping rather than each
+ * re-deriving it (which would also trip the `graph:duplicated-function-body`
+ * dogfood check). contracts may import `@opensip-cli/core` at runtime (the
+ * layer below it), so `isErrorSignal` is available here.
+ */
+import { type Signal } from '@opensip-cli/core';
+import type { FindingGroup } from './command-results.js';
+/** A unit identity the grouping needs: its slug and (optional) own error. */
+export interface FindingGroupUnit {
+    readonly slug: string;
+    readonly error?: string;
+}
+/**
+ * Group a run's signals by `signal.source` (the emitting unit's slug) into the
+ * verbose `FindingGroup[]` — one block per unit that emitted ≥1 finding or that
+ * errored. `displayName` resolves a unit slug to its pretty title (fitness
+ * passes its display registry; sim passes identity).
+ */
+export declare function buildFindingGroups(units: readonly FindingGroupUnit[], signals: readonly Signal[], displayName?: (slug: string) => string): FindingGroup[];
+//# sourceMappingURL=verbose-detail.d.ts.map

package/dist/verbose-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-detail.d.ts","sourceRoot":"","sources":["../src/verbose-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAC;AAkBtE,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAkCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,WAAW,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuB,GACrD,YAAY,EAAE,CAShB"}

package/dist/verbose-detail.js

@@ -0,0 +1,75 @@
+/**
+ * Verbose-detail builders (ADR-0021) — the shared transform from a run's
+ * `Signal[]` + units into the renderer-agnostic `FindingGroup[]` carried on a
+ * `*DoneResult` and rendered by the cli `resultToView` seam.
+ *
+ * Lives in contracts (next to `buildSignalEnvelope`) so fit and sim — peer
+ * packages that cannot import each other — share ONE mapping rather than each
+ * re-deriving it (which would also trip the `graph:duplicated-function-body`
+ * dogfood check). contracts may import `@opensip-cli/core` at runtime (the
+ * layer below it), so `isErrorSignal` is available here.
+ */
+import { isErrorSignal } from '@opensip-cli/core';
+/** Map one `Signal` to a renderer-agnostic `FindingLine` (display fields only,
+ *  4-level severity collapsed to the 2-level error/warning rung). */
+function toFindingLine(signal) {
+    let location;
+    if (signal.filePath !== '') {
+        location =
+            signal.line === undefined ? signal.filePath : `${signal.filePath}:${String(signal.line)}`;
+    }
+    return {
+        severity: isErrorSignal(signal) ? 'error' : 'warning',
+        message: signal.message,
+        ...(location === undefined ? {} : { location }),
+        ...(signal.suggestion === undefined ? {} : { suggestion: signal.suggestion }),
+    };
+}
+/** Group a run's signals by `signal.source` (the emitting unit's slug). */
+function indexBySource(signals) {
+    const bySource = new Map();
+    for (const signal of signals) {
+        const bucket = bySource.get(signal.source);
+        if (bucket)
+            bucket.push(signal);
+        else
+            bySource.set(signal.source, [signal]);
+    }
+    return bySource;
+}
+/** Build one finding group for a unit + its findings (counts the rungs). */
+function groupForUnit(unit, findings, title) {
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const s of findings) {
+        if (isErrorSignal(s))
+            errorCount += 1;
+        else
+            warningCount += 1;
+    }
+    return {
+        title,
+        ...(unit.error === undefined ? {} : { error: unit.error }),
+        errorCount,
+        warningCount,
+        findings: findings.map(toFindingLine),
+    };
+}
+/**
+ * Group a run's signals by `signal.source` (the emitting unit's slug) into the
+ * verbose `FindingGroup[]` — one block per unit that emitted ≥1 finding or that
+ * errored. `displayName` resolves a unit slug to its pretty title (fitness
+ * passes its display registry; sim passes identity).
+ */
+export function buildFindingGroups(units, signals, displayName = (slug) => slug) {
+    const bySource = indexBySource(signals);
+    const groups = [];
+    for (const unit of units) {
+        const findings = bySource.get(unit.slug) ?? [];
+        if (findings.length === 0 && unit.error === undefined)
+            continue;
+        groups.push(groupForUnit(unit, findings, displayName(unit.slug)));
+    }
+    return groups;
+}
+//# sourceMappingURL=verbose-detail.js.map

package/dist/verbose-detail.js.map

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

package/dist/verbose-detail.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=verbose-detail.test.d.ts.map

package/dist/verbose-detail.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-detail.test.d.ts","sourceRoot":"","sources":["../src/verbose-detail.test.ts"],"names":[],"mappings":""}

package/dist/verbose-detail.test.js

@@ -0,0 +1,53 @@
+import { createSignal } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { buildFindingGroups } from './verbose-detail.js';
+function sig(source, severity, message, file = 'a.ts', line) {
+    return createSignal({
+        source,
+        severity,
+        ruleId: `${source}-rule`,
+        message,
+        code: { file, line },
+    });
+}
+describe('buildFindingGroups', () => {
+    it('groups signals by source, collapses 4→2 severity, and counts each rung', () => {
+        const units = [{ slug: 'check-a' }, { slug: 'check-b' }];
+        const signals = [
+            sig('check-a', 'critical', 'boom', 'x.ts', 10),
+            sig('check-a', 'low', 'meh', 'y.ts'),
+            sig('check-b', 'high', 'bad', 'z.ts', 3),
+        ];
+        const groups = buildFindingGroups(units, signals);
+        expect(groups).toHaveLength(2);
+        const a = groups[0];
+        expect(a.title).toBe('check-a'); // identity display name
+        expect(a.errorCount).toBe(1); // critical → error rung
+        expect(a.warningCount).toBe(1); // low → warning rung
+        expect(a.findings[0]).toEqual({ severity: 'error', message: 'boom', location: 'x.ts:10' });
+        expect(a.findings[1]).toEqual({ severity: 'warning', message: 'meh', location: 'y.ts' });
+        const b = groups[1];
+        expect(b.findings[0]).toEqual({ severity: 'error', message: 'bad', location: 'z.ts:3' });
+    });
+    it('applies the displayName resolver to the group title', () => {
+        const groups = buildFindingGroups([{ slug: 'no-todos' }], [sig('no-todos', 'high', 'x')], (s) => `Pretty ${s}`);
+        expect(groups[0].title).toBe('Pretty no-todos');
+    });
+    it('includes a unit that errored even with no signals; skips clean units', () => {
+        const units = [{ slug: 'errored', error: 'timed out' }, { slug: 'clean' }];
+        const groups = buildFindingGroups(units, []);
+        expect(groups).toHaveLength(1);
+        expect(groups[0]).toMatchObject({
+            title: 'errored',
+            error: 'timed out',
+            errorCount: 0,
+            warningCount: 0,
+        });
+    });
+    it('omits location when the signal has no file path', () => {
+        const s = createSignal({ source: 'u', severity: 'high', ruleId: 'r', message: 'no loc' });
+        const groups = buildFindingGroups([{ slug: 'u' }], [s]);
+        expect(groups[0].findings[0].location).toBeUndefined();
+    });
+});
+//# sourceMappingURL=verbose-detail.test.js.map

package/dist/verbose-detail.test.js.map

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

package/dist/verdict-envelope.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * verdict-envelope — `buildSignalEnvelope`'s verdict computation (ADR-0035).
+ * Pins that `verdict.passed = !runFaulted && !unitErrored && policyPasses(...)`,
+ * and that the per-unit `summary.{passed,failed}` counts are INDEPENDENT of the
+ * run verdict (they feed the table; the verdict feeds the headline + exit code).
+ */
+export {};
+//# sourceMappingURL=verdict-envelope.test.d.ts.map

package/dist/verdict-envelope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-envelope.test.d.ts","sourceRoot":"","sources":["../src/verdict-envelope.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/verdict-envelope.test.js

@@ -0,0 +1,67 @@
+/**
+ * verdict-envelope — `buildSignalEnvelope`'s verdict computation (ADR-0035).
+ * Pins that `verdict.passed = !runFaulted && !unitErrored && policyPasses(...)`,
+ * and that the per-unit `summary.{passed,failed}` counts are INDEPENDENT of the
+ * run verdict (they feed the table; the verdict feeds the headline + exit code).
+ */
+import { createSignal, } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { buildSignalEnvelope } from './signal-envelope.js';
+function sig(severity) {
+    return createSignal({ source: 'u', severity, ruleId: `r-${severity}`, message: 'x' });
+}
+const FALLBACK = { failOnErrors: 1, failOnWarnings: 0 };
+function verdictOf(opts) {
+    return buildSignalEnvelope({
+        tool: 'fit',
+        runId: 'r',
+        createdAt: '2026-01-01T00:00:00.000Z',
+        units: opts.units ?? [{ slug: 'a', passed: true, durationMs: 1 }],
+        signals: opts.signals ?? [],
+        policy: opts.policy ?? FALLBACK,
+        runFaulted: opts.runFaulted ?? false,
+    }).verdict;
+}
+describe('buildSignalEnvelope · verdict.passed (ADR-0035)', () => {
+    it('passes a clean run under the {1,0} fallback', () => {
+        expect(verdictOf({}).passed).toBe(true);
+    });
+    it('fails as soon as one error-rung signal is present', () => {
+        expect(verdictOf({ signals: [sig('high')] }).passed).toBe(false);
+    });
+    it('passes a warning-only run under {1,0} (warnings informational)', () => {
+        expect(verdictOf({ signals: [sig('medium'), sig('low')] }).passed).toBe(true);
+    });
+    it('fails a warning-only run when failOnWarnings is active', () => {
+        expect(verdictOf({ signals: [sig('medium')], policy: { failOnErrors: 1, failOnWarnings: 1 } })
+            .passed).toBe(false);
+    });
+    it('tolerates errors when failOnErrors is 0 (ratchet/warn-only mode)', () => {
+        expect(verdictOf({
+            signals: [sig('high'), sig('critical')],
+            policy: { failOnErrors: 0, failOnWarnings: 0 },
+        }).passed).toBe(true);
+    });
+    it('FAILS on a run-level fault (runFaulted) even with zero findings', () => {
+        expect(verdictOf({ signals: [], runFaulted: true }).passed).toBe(false);
+    });
+    it('FAILS when a unit carries an error, even with zero signals', () => {
+        const errored = { slug: 'boom', passed: false, durationMs: 1, error: 'exploded' };
+        expect(verdictOf({ units: [errored], signals: [] }).passed).toBe(false);
+    });
+    it('keeps summary.{passed,failed} independent of verdict.passed', () => {
+        // 1 failing unit (no error/signal) → summary.failed=1, but with no error
+        // signals and no fault the policy verdict still PASSES under {1,0}.
+        const v = verdictOf({
+            units: [
+                { slug: 'a', passed: true, durationMs: 1 },
+                { slug: 'b', passed: false, durationMs: 1 },
+            ],
+            signals: [],
+        });
+        expect(v.summary.passed).toBe(1);
+        expect(v.summary.failed).toBe(1);
+        expect(v.passed).toBe(true);
+    });
+});
+//# sourceMappingURL=verdict-envelope.test.js.map

package/dist/verdict-envelope.test.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@opensip-cli/contracts",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Shared contract types for OpenSIP CLI — SignalEnvelope / CommandResult shapes, exit codes, session persistence",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality",
+    "types",
+    "contracts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@opensip-cli/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "commander": "^14.0.0 || ^15.0.0"
+  },
+  "peerDependenciesMeta": {
+    "commander": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "commander": "^15.0.0",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}