@sun-asterisk/sungen 3.2.34-beta.1 → 3.3.0-alpha.1

package/dist/cli/commands/next.js

@@ -37,6 +37,9 @@ exports.registerNextCommand = registerNextCommand;
 exports.printHandBack = printHandBack;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const contract_git_1 = require("../../contract/contract-git");
+const test_case_satisfied_1 = require("../../graph/test-case-satisfied");
+const test_case_states_1 = require("../../graph/test-case-states");
 const next_step_1 = require("../../harness/next-step");
 const resolve_unit_1 = require("../resolve-unit");
 /** Every unit the project holds, so `sungen next` with no argument still answers. */
@@ -54,6 +57,13 @@ function allUnits(cwd) {
     }
     return out;
 }
+function renderSteps(steps) {
+    for (const st of steps) {
+        const mark = st.kind === 'blocked' ? '⛔' : st.kind === 'optional' ? '○' : st.kind === 'decide' ? '⚖' : '→';
+        console.log(`  ${mark} ${st.command}${st.kind === 'decide' ? '   (a QA decision — ask, do not run)' : ''}`);
+        console.log(`     ${st.because}`);
+    }
+}
 function render(s) {
     const L = console.log;
     L('');
@@ -69,22 +79,65 @@ function render(s) {
     L(`  state: ${held.length ? held.join(' · ') : '(nothing yet)'}`);
     if (s.audit)
         L(`  audit: ${s.audit.overall}/10 [${s.audit.gateStatus}] · ${s.audit.findings.length} finding(s)`);
+    else if (s.auditNotCounted)
+        L(`  audit: ${s.auditNotCounted.state === 'stale' ? 'stale' : 'not trusted'} — ${s.auditNotCounted.reason}`);
     L('');
-    for (const st of s.steps) {
-        const mark = st.kind === 'blocked' ? '⛔' : st.kind === 'optional' ? '○' : st.kind === 'decide' ? '⚖' : '→';
-        L(`  ${mark} ${st.command}${st.kind === 'decide' ? '   (a QA decision — ask, do not run)' : ''}`);
-        L(`     ${st.because}`);
+    renderSteps(s.steps);
+    L('');
+}
+/** `--case <id>`: the case's state and its frontier. Exits 1 when the case cannot be found. */
+function caseView(s, cwd, unitDir, id, json) {
+    let cases = s.testCases;
+    if (!cases) {
+        try {
+            cases = (0, test_case_states_1.testCaseStates)(cwd, s.unit, { unitDir });
+        }
+        catch (e) {
+            throw new Error(`the test cases of ${s.unit} could not be read: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    const tc = cases.find((c) => c.id === id);
+    if (!tc) {
+        const known = cases.slice(0, 8).map((c) => c.id).join(', ');
+        throw new Error(`no test case "${id}" in ${s.unit}${known ? ` — known: ${known}${cases.length > 8 ? ', …' : ''}` : ' (it holds no scenario)'}`);
     }
+    const steps = (0, next_step_1.deriveSteps)({ ...s, testCases: cases }, { testCase: id });
+    if (json) {
+        console.log(JSON.stringify({ unit: s.unit, kind: s.kind, testCase: tc, steps }, null, 2));
+        return;
+    }
+    const L = console.log;
+    L('');
+    L(`━━━ Next steps: ${s.unit} › ${tc.id} (${s.kind}) ━━━`);
+    L('');
+    L(`  test case: ${tc.title}${tc.unstableId ? '   (no VP-id — this id changes when the title does)' : ''}`);
+    L(`  where:     ${tc.file}#L${tc.lines[0]}-L${tc.lines[1]}`);
+    L(`  status:    ${(0, test_case_satisfied_1.testCaseStatusLabel)(tc)} · result ${tc.result}${tc.mocked && tc.result === 'passed' ? ' (mocked)' : ''}${tc.stale ? ` · stale: ${tc.stale}` : ''}${tc.triage ? ` · triage ${tc.triage.class}` : ''}`);
+    if (tc.contract)
+        L(`  contract:  ${tc.contract.class}${tc.contract.uncommitted ? ' · lock entry not committed' : ''}${tc.contract.lowIdentity ? ' · low target identity' : ''}`);
+    if (tc.anchors.length)
+        L(`  anchors:   ${tc.anchors.map((a) => `${a.anchor} (${a.change})`).join(', ')}`);
+    for (const f of tc.findings)
+        L(`  finding:   ${f.code} [${f.confidence.label} ${f.confidence.score}] ${f.citation}`);
+    L('');
+    if (steps.length)
+        renderSteps(steps);
+    else
+        L(`  ✓ nothing to do for this test case — ${(0, test_case_satisfied_1.testCaseStatusLabel)(tc)}`);
     L('');
 }
 function registerNextCommand(program) {
     program
         .command('next [unit]')
         .description('What to do next for a unit (or every unit), derived from the project state')
+        .option('--case <id>', 'One test case of the unit (its VP-id): its state and its next steps')
         .option('--json', 'Machine-readable output')
         .action((unit, o) => {
         try {
             const cwd = process.cwd();
+            if (o.case && !unit)
+                throw new Error('--case needs a unit: sungen next <unit> --case <id>');
+            const gitSnapshot = (0, contract_git_1.headSnapshot)(cwd, contract_git_1.CLI_GIT_TIMEOUT_MS);
             let states;
             if (unit) {
                 const resolved = (0, resolve_unit_1.resolveUnit)(unit, cwd);
@@ -92,7 +145,12 @@ function registerNextCommand(program) {
                     console.error(`Error: no unit named "${unit}" under qa/screens, qa/flows or qa/api.`);
                     process.exit(1);
                 }
-                states = [(0, next_step_1.readUnitState)(cwd, resolved.dir, unit, resolved.kind)];
+                const state = (0, next_step_1.readUnitState)(cwd, resolved.dir, unit, resolved.kind, { gitSnapshot });
+                if (o.case) {
+                    caseView(state, cwd, resolved.dir, o.case, Boolean(o.json));
+                    return;
+                }
+                states = [state];
             }
             else {
                 const units = allUnits(cwd);
@@ -104,7 +162,7 @@ function registerNextCommand(program) {
                 states = units.map((u) => {
                     if ((0, resolve_unit_1.resolveUnitCandidates)(u.name, cwd).length > 1)
                         throw new resolve_unit_1.AmbiguousUnitError(u.name, (0, resolve_unit_1.resolveUnitCandidates)(u.name, cwd));
-                    return (0, next_step_1.readUnitState)(cwd, u.dir, u.name, u.kind);
+                    return (0, next_step_1.readUnitState)(cwd, u.dir, u.name, u.kind, { gitSnapshot });
                 });
             }
             if (o.json) {

package/dist/cli/commands/next.js.map

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

package/dist/cli/commands/update.d.ts

@@ -1,3 +1,14 @@
 import { Command } from 'commander';
 export declare function registerUpdateCommand(program: Command): void;
+/**
+ * The npm dist-tag `sungen update` installs. `latest` = official/stable (the default, and how a
+ * plain `sungen update` switches back); `--beta` / `--alpha` pick a prerelease channel (each branch
+ * auto-publishes to the dist-tag of its name); `--tag` names any dist-tag and wins over both.
+ * `--beta` with `--alpha` never reaches here — the option definition refuses the pair.
+ */
+export declare function resolveUpdateChannel(o: {
+    tag?: string;
+    beta?: boolean;
+    alpha?: boolean;
+}): string;
 //# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E5D"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAuC5C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyF5D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAIjG"}

package/dist/cli/commands/update.js

@@ -34,6 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerUpdateCommand = registerUpdateCommand;
+exports.resolveUpdateChannel = resolveUpdateChannel;
+const commander_1 = require("commander");
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -71,21 +73,24 @@ const SKIP_PROJECT_ENV = 'SUNGEN_UPDATE_SKIP_PROJECT';
 function registerUpdateCommand(program) {
     program
         .command('update')
-        .description('Reinstall @sun-asterisk/sungen (stable by default, --beta for prerelease) + refresh AI rules, commands, skills')
+        .description('Reinstall @sun-asterisk/sungen (stable by default, --beta / --alpha for prerelease) + refresh AI rules, commands, skills')
         .option('--dry-run', 'Show what would be updated without making changes')
         .option('--assistant <name>', 'AI assistant to install for: claude | copilot | codex | all (repeatable). Default: claude', (val, acc) => { acc.push(val); return acc; }, [])
         .option('--force', 'Overwrite user config files (CLAUDE.md, AGENTS.md, copilot-instructions.md)', false)
         .option('--beta', 'Switch to the BETA channel (installs @beta — prerelease builds for testing)', false)
-        .option('--tag <dist-tag>', 'Install a specific npm dist-tag (e.g. latest, beta, next). Overrides --beta.')
+        // `--beta --alpha` is ambiguous: commander refuses it while parsing — one usage-error line, exit 1,
+        // before the action (and any npm install) runs — rather than settling it by flag order.
+        .addOption(new commander_1.Option('--alpha', 'Switch to the ALPHA channel (installs @alpha — early builds of the next big update, ahead of beta)')
+        .default(false)
+        .conflicts('beta'))
+        .option('--tag <dist-tag>', 'Install a specific npm dist-tag (e.g. latest, beta, alpha, next). Overrides --beta / --alpha.')
         .option('--skip-npm-install', 'Skip the global npm install step (refresh project AI assets only)', false)
         .option('--skip-project', 'Skip reinstalling the project-local sungen packages (AI assets only — leaves node_modules stale)', false)
         .action(async (options) => {
         try {
             const skipNpm = Boolean(options.skipNpmInstall) || process.env[SKIP_NPM_ENV] === '1';
             const skipProject = Boolean(options.skipProject) || process.env[SKIP_PROJECT_ENV] === '1';
-            // Channel resolution via npm dist-tags. Default `latest` = official/stable.
-            // `--beta` → beta channel; running plain `sungen update` later switches back to stable.
-            const channel = options.tag || (options.beta ? 'beta' : 'latest');
+            const channel = resolveUpdateChannel(options);
             if (!skipNpm) {
                 reinstallSungen(channel);
                 printCurrentVersion(channel);
@@ -110,6 +115,13 @@ function registerUpdateCommand(program) {
             // …and move the old `trace: 'on-first-retry'` default, which never records a trace off CI.
             const { installTraceMode } = require('../../orchestrator/trace-mode-install');
             installTraceMode(process.cwd(), options.dryRun ?? false);
+            // Claude Code hooks: re-merged into .claude/settings.json (user hooks kept); sungen entries a
+            // newer version dropped, or qa/sungen.config.yaml turned off, are removed.
+            if (resolveAssistants(options.assistant).includes('claude')) {
+                const { installClaudeHooks, describeHooksInstall } = require('../../orchestrator/claude-hooks-install');
+                const hooks = installClaudeHooks(process.cwd(), { dryRun: options.dryRun ?? false });
+                console.log(`${hooks.settings === 'unreadable' ? '⚠️ ' : '🪝'} ${options.dryRun ? '[dry-run] ' : ''}${describeHooksInstall(hooks)}\n`);
+            }
         }
         catch (error) {
             console.error('❌ Update failed:', error);
@@ -117,6 +129,19 @@ function registerUpdateCommand(program) {
         }
     });
 }
+/**
+ * The npm dist-tag `sungen update` installs. `latest` = official/stable (the default, and how a
+ * plain `sungen update` switches back); `--beta` / `--alpha` pick a prerelease channel (each branch
+ * auto-publishes to the dist-tag of its name); `--tag` names any dist-tag and wins over both.
+ * `--beta` with `--alpha` never reaches here — the option definition refuses the pair.
+ */
+function resolveUpdateChannel(o) {
+    if (o.tag)
+        return o.tag;
+    if (o.alpha)
+        return 'alpha';
+    return o.beta ? 'beta' : 'latest';
+}
 function reinstallSungen(channel) {
     const spec = `@sun-asterisk/sungen@${channel}`;
     const label = channel === 'latest' ? 'stable (latest)' : `${channel} channel`;
@@ -141,7 +166,7 @@ function printCurrentVersion(channel) {
         (0, child_process_1.spawnSync)('sungen', ['--version'], { stdio: 'inherit', shell: true });
     }
     if (channel === 'latest') {
-        console.log('   Channel: stable. To try prereleases:  sungen update --beta');
+        console.log('   Channel: stable. To try prereleases:  sungen update --beta  (or --alpha for the next big update)');
     }
     else {
         console.log(`   Channel: ${channel} (prerelease). To return to stable:  sungen update`);

package/dist/cli/commands/update.js.map

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

package/dist/cli/index.js

@@ -42,13 +42,22 @@ const triage_1 = require("./commands/triage");
 const defect_1 = require("./commands/defect");
 const results_merge_1 = require("./commands/results-merge");
 const login_1 = require("./commands/login");
-const viewpoint_1 = require("./commands/viewpoint");
 const registry_1 = require("../capabilities/registry");
 const discover_1 = require("../capabilities/discover");
 const assets_drift_1 = require("../orchestrator/assets-drift");
+const hand_back_core_1 = require("../hooks/hand-back-core");
+const hook_cli_command_1 = require("../hooks/hook-cli-command");
 // Read version from package.json so `--version` never drifts from the released version.
 const { version } = require('../../package.json');
 async function main() {
+    // #597 + P0.1 — the hand-back, once, for EVERY command, and from the moment parsing starts: a
+    // usage error never reaches an action, and `main().catch` exits from outside one. It hangs off
+    // process exit (not postAction) because several commands exit with a MEANINGFUL code that skips
+    // commander's hooks (`depth-lint` → 2). It points at `sungen next` instead of restating a step,
+    // so it cannot drift from the project state. A failure prints it on stderr after the error;
+    // `--json`/`--grep` keep it off stdout (#836); `next` and `hook` never print one. The line and
+    // those rules live in the hook core (src/hooks/hand-back-core.ts) — this file only wires it.
+    const handBack = (0, hand_back_core_1.attachCliHandBack)(process.argv, process.cwd());
     const program = new commander_1.Command();
     program
         .name('sungen')
@@ -94,7 +103,10 @@ async function main() {
     (0, ingest_1.registerIngestCommand)(program);
     (0, eval_1.registerEvalCommand)(program);
     (0, login_1.registerLoginCommand)(program);
-    (0, viewpoint_1.registerViewpointCommand)(program);
+    // Test Contract (DOS-14). Registered inline (typed require, still loaded eagerly like every command)
+    // so the phase that added it touches ONE line of this file — no import-block edit to merge-conflict.
+    require('./commands/contract').registerContractCommand(program);
+    (0, hook_cli_command_1.registerHookCommand)(program); // hidden: Claude Code hooks, JSON on stdout
     // Capability-contributed CLI commands (Capability SPI): drivers own their authoring commands
     // (e.g. @sungen/driver-api → `sungen api import`). Discover, then register each.
     (0, discover_1.discoverAndRegisterCapabilities)();
@@ -105,41 +117,14 @@ async function main() {
     // Every command warns once when the project's AI assets came from a different
     // build — `update` is the only thing that refreshes them, and nothing used to
     // say so (stderr, so `--json` output stays parseable).
-    program.hook('preAction', () => { (0, assets_drift_1.warnAssetsDrift)(process.cwd()); });
-    // #597 — the hand-back, once, for EVERY command. It used to be hardcoded per command and only
-    // two of twenty-nine printed one, so a run that finished anywhere else finished in silence:
-    // `capability add` ended with a blank line and the session stopped mid-workflow. Adding a
-    // footer to the other twenty-seven would repeat the mistake in bulk.
-    //
-    // It hangs off `process.on('exit')` rather than a postAction hook because several commands
-    // exit with a MEANINGFUL code (`depth-lint` returns 2 when there are deepen candidates) and
-    // `process.exit` skips commander's hooks entirely — a postAction version printed for `audit`
-    // and silently not for `depth-lint`, which is the same class of gap all over again.
-    //
-    // It points at `sungen next` instead of restating a step, so it can never drift from the real
-    // project state. Skipped on a hard error (code 1): there the error message is the actionable
-    // thing, and burying it under a footer helps nobody. `--json` keeps stdout parseable.
-    let handBack = null;
+    // `hook` speaks only JSON to Claude Code — no drift warning there.
     program.hook('preAction', (_thisCommand, actionCommand) => {
-        if (actionCommand.name() === 'next')
-            return; // `next` IS the answer
-        const opts = actionCommand.opts();
-        const unit = [opts.screen, opts.flow, opts.area].find((v) => typeof v === 'string' && v)
-            ?? (typeof actionCommand.args?.[0] === 'string' ? actionCommand.args[0] : undefined);
-        // `--grep` is machine output too: callers capture it with `$(…)`, and a footer on stdout
-        // became part of the regex — the last alternative of `changed --grep` silently matched
-        // nothing, so `--change-only` skipped its last scenario (#836).
-        handBack = { unit: unit, json: opts.json === true || opts.grep === true };
+        if (actionCommand.name() !== 'hook')
+            (0, assets_drift_1.warnAssetsDrift)(process.cwd());
     });
-    process.on('exit', (code) => {
-        if (!handBack || code === 1)
-            return;
-        const line = `\nNext: sungen next${handBack.unit ? ` ${handBack.unit}` : ''}`;
-        // stderr under --json / --grep so the hand-back never lands in the captured payload.
-        if (handBack.json)
-            process.stderr.write(`${line}\n`);
-        else
-            process.stdout.write(`${line}\n`);
+    // The action knows its unit and output mode; the hand-back default above is refined here.
+    program.hook('preAction', (_thisCommand, actionCommand) => {
+        handBack.onAction(actionCommand.name(), actionCommand.opts(), actionCommand.args);
     });
     await program.parseAsync(process.argv);
 }

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;GAGG;;AAEH,yCAAoC;AACpC,0CAAsD;AACtD,wCAAoD;AACpD,kDAA8D;AAC9D,kDAA8D;AAC9D,kEAA4E;AAC5E,8CAA0D;AAC1D,kDAA8D;AAC9D,4CAAwD;AACxD,kDAA6D;AAC7D,oDAAgE;AAChE,4CAAwD;AACxD,gDAA4D;AAC5D,sDAAiE;AACjE,gDAA4D;AAC5D,0CAAsD;AACtD,8CAA0D;AAC1D,0CAAsD;AACtD,kDAA8D;AAC9D,gDAA4D;AAC5D,8CAA0D;AAC1D,8CAA0D;AAC1D,kDAA8D;AAC9D,wDAAmE;AACnE,0DAAqE;AACrE,4CAAwD;AACxD,0CAAsD;AACtD,oDAAgE;AAChE,oDAAgE;AAChE,sDAAkE;AAClE,sDAAiE;AACjE,gDAA4D;AAC5D,8CAA0D;AAC1D,8CAA0D;AAC1D,8CAA0D;AAC1D,4DAAkE;AAClE,4CAAwD;AACxD,uDAA8D;AAC9D,uDAA2E;AAC3E,+DAA+D;AAC/D,4DAA4D;AAC5D,gEAAgE;AAEhE,wFAAwF;AACxF,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEzE,KAAK,UAAU,IAAI;IACjB,8FAA8F;IAC9F,+FAA+F;IAC/F,gGAAgG;IAChG,gGAAgG;IAChG,4FAA4F;IAC5F,+FAA+F;IAC/F,6FAA6F;IAC7F,MAAM,QAAQ,GAAG,IAAA,kCAAiB,EAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,oEAAoE,CAAC;SACjF,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,iBAAiB;IACjB,OAAO;SACJ,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAErD,oBAAoB;IACpB,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,gDAA6B,EAAC,OAAO,CAAC,CAAC;IACrC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,iCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,uCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,yCAA0B,EAAC,OAAO,CAAC,CAAC;IACpC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,sCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,sCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,qGAAqG;IACrG,qGAAqG;IACpG,OAAO,CAAC,qBAAqB,CAA0C,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC1G,IAAA,sCAAmB,EAAC,OAAO,CAAC,CAAC,CAAC,4CAA4C;IAE1E,6FAA6F;IAC7F,iFAAiF;IACjF,IAAA,0CAA+B,GAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,6BAAkB,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,eAAe,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE;YAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,uDAAuD;IACvD,mEAAmE;IACnE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE;QACxD,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,MAAM;YAAE,IAAA,8BAAe,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,0FAA0F;IAC1F,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE;QACxD,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,IAAI,EAA6B,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/contract/approve-contract.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `sungen contract approve --screen <u> [--scenario <id>]` — the human act that locks a contract
+ * (DOS-14.4, DOS-13.4, takumi T5). In order, so a human never confirms something then rejected:
+ *
+ *   1. resolve the unit, read the current scenarios and the lock (an unreadable lock refuses)
+ *   2. pick what changes: new, changed or tampered scenarios, and — when approving the whole unit —
+ *      the entries of scenarios that left the feature; nothing changed → nothing to approve, no prompt
+ *   3. refuse a duplicated id or a Scenario Outline, and run the secret guard
+ *   4. show each change with its ladder class (a weakening is named before it is confirmed) and
+ *      require the typed phrase on a TTY — without one: refuse and print the exact command
+ *   5. read everything AGAIN: if the feature or the lock moved while the human was reading, what
+ *      they confirmed is not what would be written — refuse (L5)
+ *   6. record the decision and the lock (record-contract-approval.ts)
+ */
+import { ConfirmationIO } from '../decisions/human-confirmation';
+export interface ApproveInput {
+    projectRoot: string;
+    unit: string;
+    scenario?: string;
+    reason?: string;
+    io: ConfirmationIO;
+}
+export interface ApproveResult {
+    status: 'approved' | 'nothing-to-approve';
+    lockPath: string;
+    decisionId?: string;
+    approved: string[];
+    removed: string[];
+}
+export declare function approveContract(i: ApproveInput): Promise<ApproveResult>;
+//# sourceMappingURL=approve-contract.d.ts.map

package/dist/contract/approve-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve-contract.d.ts","sourceRoot":"","sources":["../../src/contract/approve-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,cAAc,EAA2C,MAAM,iCAAiC,CAAC;AAW1G,MAAM,WAAW,YAAY;IAAG,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,cAAc,CAAA;CAAE;AAC3H,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,GAAG,oBAAoB,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA+BD,wBAAsB,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA8B7E"}

package/dist/contract/approve-contract.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.approveContract = approveContract;
+/**
+ * `sungen contract approve --screen <u> [--scenario <id>]` — the human act that locks a contract
+ * (DOS-14.4, DOS-13.4, takumi T5). In order, so a human never confirms something then rejected:
+ *
+ *   1. resolve the unit, read the current scenarios and the lock (an unreadable lock refuses)
+ *   2. pick what changes: new, changed or tampered scenarios, and — when approving the whole unit —
+ *      the entries of scenarios that left the feature; nothing changed → nothing to approve, no prompt
+ *   3. refuse a duplicated id or a Scenario Outline, and run the secret guard
+ *   4. show each change with its ladder class (a weakening is named before it is confirmed) and
+ *      require the typed phrase on a TTY — without one: refuse and print the exact command
+ *   5. read everything AGAIN: if the feature or the lock moved while the human was reading, what
+ *      they confirmed is not what would be written — refuse (L5)
+ *   6. record the decision and the lock (record-contract-approval.ts)
+ */
+const human_confirmation_1 = require("../decisions/human-confirmation");
+const decision_source_1 = require("../decisions/decision-source");
+const classify_contract_change_1 = require("./classify-contract-change");
+const contract_hash_1 = require("./contract-hash");
+const contract_schema_1 = require("./contract-schema");
+const contract_units_1 = require("./contract-units");
+const contracts_lock_file_1 = require("./contracts-lock-file");
+const free_feature_blocks_1 = require("./free-feature-blocks");
+const normalize_feature_steps_1 = require("./normalize-feature-steps");
+const record_contract_approval_1 = require("./record-contract-approval");
+function plan(i) {
+    const unit = (0, contract_units_1.resolveContractUnit)(i.projectRoot, i.unit);
+    const lock = (0, contracts_lock_file_1.readLockFile)((0, contracts_lock_file_1.lockPathFor)(unit.dir));
+    const current = (0, normalize_feature_steps_1.loadContractScenarios)(unit.dir, unit.name);
+    const ids = new Set(current.map((s) => s.id));
+    if (i.scenario && !ids.has(i.scenario) && !lock?.scenarios[i.scenario]) {
+        throw new Error(`--scenario ${i.scenario} names no scenario of ${i.unit} (current: ${[...ids].join(', ') || 'none'})`);
+    }
+    const chosen = current.filter((s) => !i.scenario || s.id === i.scenario);
+    const dup = [...new Set(chosen.map((s) => s.id))].find((id) => current.filter((s) => s.id === id).length > 1);
+    if (dup)
+        throw new Error(`Refused: scenario id ${dup} is used by ${current.filter((s) => s.id === dup).length} scenarios — a lock entry must name exactly one. Give each its own ID.`);
+    const outlines = chosen.filter((s) => s.source.outline).map((s) => s.id);
+    if (outlines.length)
+        throw new Error(`Refused: ${outlines.join(', ')} ${outlines.length > 1 ? 'are' : 'is a'} Scenario Outline — the compiler does not support it, so it cannot be locked. Rewrite it as @cases data.`);
+    const tampered = new Set(lock?.tampered ?? []);
+    const approve = chosen.filter((s) => { const e = lock?.scenarios[s.id]; return !(0, contract_schema_1.isHumanApproved)(e) || e.hash !== s.hash || tampered.has(s.id); });
+    const removed = Object.keys(lock?.scenarios ?? {}).filter((id) => !ids.has(id) && (!i.scenario || id === i.scenario));
+    const write = { projectRoot: i.projectRoot, unitDir: unit.dir, unit: unit.name, approve, removed, reason: i.reason, lock };
+    return { write, lock, fingerprint: (0, contract_hash_1.canonicalJson)({ lock, approve: approve.map((s) => [s.id, s.hash]), removed }) };
+}
+function describe(sc, lock) {
+    const entry = lock?.scenarios[sc.id];
+    if (!(0, contract_schema_1.isHumanApproved)(entry) || lock?.tampered.includes(sc.id))
+        return `+ ${sc.id}  new (${sc.steps.length} steps, ${sc.implementation})`;
+    const r = (0, classify_contract_change_1.classifyScenario)(sc.id, entry, sc);
+    return `~ ${sc.id}  ${r.class}${r.findings.length ? ` — ${r.findings.map((f) => f.detail).join('; ')}` : ''}`;
+}
+async function approveContract(i) {
+    const before = plan(i);
+    const { approve, removed } = before.write;
+    const lockPath = (0, contracts_lock_file_1.lockPathFor)(before.write.unitDir);
+    if (!approve.length && !removed.length)
+        return { status: 'nothing-to-approve', lockPath, approved: [], removed: [] };
+    (0, record_contract_approval_1.checkApprovalSecrets)(before.write);
+    const unnamed = approve.filter((s) => !s.source.hasId).length;
+    await (0, human_confirmation_1.requireTypedConfirmation)({
+        what: `approve the Test Contract of ${i.unit} (${approve.length} scenario(s)${removed.length ? `, ${removed.length} removed` : ''})`,
+        phrase: i.unit,
+        command: (0, human_confirmation_1.formatCommand)(['sungen', 'contract', 'approve', '--screen', i.unit, ...(i.scenario ? ['--scenario', i.scenario] : []), ...(i.reason ? ['--reason', i.reason] : [])]),
+        summary: [
+            ...approve.map((s) => describe(s, before.lock)),
+            ...removed.map((id) => `- ${id}  removed from the feature — its approved checks leave the contract`),
+            ...(unnamed ? [`note: ${unnamed} scenario(s) have no ID and are locked by name — renaming one will read as removing it`] : []),
+            `recorded by: ${(0, decision_source_1.gitUserName)(i.projectRoot)}`,
+        ],
+        io: i.io,
+    });
+    const after = plan(i);
+    if (after.fingerprint !== before.fingerprint) {
+        throw new Error('Refused: the feature or the lock changed while you were confirming — nothing was written. Run the command again and review the new summary.');
+    }
+    const { decisionId } = (0, record_contract_approval_1.recordContractApproval)(after.write);
+    // A derived `@free @proposed` scenario stops being a proposal once QA locks it (DOS-14.8).
+    const approvedIds = new Set(approve.map((s) => s.id));
+    for (const f of (0, normalize_feature_steps_1.contractFeatureFiles)(after.write.unitDir, after.write.unit))
+        (0, free_feature_blocks_1.dropProposedTags)(f, approvedIds);
+    return { status: 'approved', lockPath, decisionId, approved: approve.map((s) => s.id), removed };
+}
+//# sourceMappingURL=approve-contract.js.map

package/dist/contract/approve-contract.js.map

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

package/dist/contract/assertion-matcher-vocabulary.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What an assertion checks — the CLOSED vocabulary of the strength ladder (DOS-14.1, DOS-14.4).
+ *
+ * Read off the normalized sentence the QA wrote (the documented `see` / `is on` / `expect` forms of
+ * sungen-gherkin-syntax), not off the compiler's pattern registry: that registry is assembled from
+ * whichever drivers a machine has installed, so a hash built on it would differ between two
+ * checkouts of the same `.feature`, and the hook would judge differently from the CLI. A sentence
+ * outside the vocabulary is `unknown`, and an unknown check that changed is `review`, never `match`.
+ *
+ *   strength 1  visible · exists                                  (something is there)
+ *   strength 2  page · state · contains · matches · range · key-matching · child · url-/title-contains|matches
+ *   strength 3  equals · count · table-data · tab-order · schema · url · title
+ *   `all:` (every item) adds one. A negation (`not see`, `is not <state>`, `is hidden`) is a flag.
+ */
+import type { StateClause } from '../generators/test-generator/patterns/types';
+export interface AssertShape {
+    matcher: string;
+    negated: boolean;
+}
+/** What an assertion sentence (the normalized `verb`) checks. `state` is the parser's trailing clause. */
+export declare function assertShapeOf(verb: string, parsedState?: StateClause): AssertShape;
+/** The ordinal strength of a matcher, or null when the ladder cannot judge it. */
+export declare function matcherStrength(matcher: string | undefined): number | null;
+//# sourceMappingURL=assertion-matcher-vocabulary.d.ts.map

package/dist/contract/assertion-matcher-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-matcher-vocabulary.d.ts","sourceRoot":"","sources":["../../src/contract/assertion-matcher-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAE/E,MAAM,WAAW,WAAW;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AAmDlE,0GAA0G;AAC1G,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,WAAW,CAQlF;AASD,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM1E"}