@specship/specship-win32-arm64 0.25.0 → 0.29.0

package/lib/dist/activation/search-intercept.js

@@ -1,24 +1,32 @@
 "use strict";
 /**
- * Point-of-use search interceptor (STEER-HOOK-DOC, REQ-STEER-004/005).
+ * Point-of-use search interceptor (STEER-HOOK-DOC, REQ-STEER-004/005,
+ * REQ-GEMINI-011).
  *
  * The prompt-level nudge (steering.ts) fires once, at prompt submit, and its
  * pull decays across a long turn — the observed failure is a search-shaped
  * tool call made many tool-calls after the nudge. This module is the decision
- * logic for the `PreToolUse` hook the installer writes on search tools
- * (`specship search-intercept`): deliver the same guidance at the moment of
- * the wrong choice.
+ * logic for the hook the installer writes on each host's search tools
+ * (Claude: PreToolUse on Grep/Glob; Gemini: BeforeTool on grep_search / glob /
+ * run_shell_command): deliver the same guidance at the moment of the wrong
+ * choice.
  *
- * Two properties are non-negotiable:
+ * Two modes exist:
  *
- *   - ADVISORY (REQ-STEER-004): the emitted text is `additionalContext`,
- *     never a permission decision. A search the index cannot answer is a
- *     legitimate search; a wrong denial costs the agent a turn — the very
- *     failure this feature exists to reduce.
- *   - SELF-SILENCING (REQ-STEER-005): at most one line per session, and only
- *     when the session has made zero specship tool calls. Firing on every
- *     search would make the hook noise, and noise is what taught the agent to
- *     ignore the prompt-level nudge.
+ *   - ADVISORY (default, both hosts, REQ-STEER-004/005): emit a one-line
+ *     `additionalContext` redirect. At most once per session, silent once the
+ *     session has used specship. The search still runs.
+ *   - STRICT (Gemini-only opt-in, REQ-GEMINI-011): for a built-in search tool
+ *     (`grep_search`, `glob`) in an indexed project, emit a top-level
+ *     `{decision:'deny'}` with a reason naming `specship_explore`. A
+ *     search-shaped `run_shell_command` NEVER denies — Gemini's hook runs
+ *     after the user's shell confirmation, so denying it would make the user
+ *     approve a command and then see it blocked. Parse-failure / unindexed
+ *     project / already-using-specship → ALLOW.
+ *
+ * Shared code stays agent-agnostic: this file never sniffs `hook_event_name`
+ * or tool-name prefixes. The caller (bin/specship) hands in host traits
+ * derived in the hook I/O adapter (`activation/hook-output.ts`).
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -56,16 +64,18 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SEARCH_INTERCEPT_TEXT = void 0;
 exports.interceptStatePath = interceptStatePath;
+exports.classifyShellCommand = classifyShellCommand;
 exports.buildSearchIntercept = buildSearchIntercept;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_settings_1 = require("../config/runtime-settings");
+const hook_output_1 = require("./hook-output");
 /**
  * The one redirect line. Explicitly advisory ("your search still runs") so
  * the model doesn't treat it as a rejection of the call it just made.
  */
 exports.SEARCH_INTERCEPT_TEXT = 'SpecShip: this project has an indexed code graph. For finding or understanding code, ' +
-    'mcp__specship__specship_explore with the relevant symbol/file names usually answers in ' +
+    'specship_explore with the relevant symbol/file names usually answers in ' +
     'ONE call and returns the verbatim source. Your search still runs — reach for explore ' +
     'on the next lookup.';
 /** Per-session tracking file, kept inside the project's own `.specship/`. */
@@ -91,7 +101,6 @@ function readState(file) {
         return {};
     }
 }
-/** Best-effort write with TTL pruning; a failed write must never fail the hook. */
 function writeState(file, state, now) {
     try {
         const pruned = {};
@@ -106,18 +115,7 @@ function writeState(file, state, now) {
         /* state is an optimization; losing it only risks one extra advisory line */
     }
 }
-/**
- * Whether the session's transcript shows any specship tool USE. A transcript
- * record must be an actual `tool_use` naming a specship tool — a bare
- * mention of a tool name is NOT use: transcripts routinely carry the full
- * tool listing (`deferred_tools_delta` attachments, skill listings), so a
- * substring test alone silences the hook in every session where specship is
- * merely INSTALLED (found live in the REQ-STEER-006 A/B — the interceptor
- * never fired). Reads at most the trailing 4 MB — usage anywhere counts, but
- * a huge transcript must not blow the hook's latency budget, and a false
- * negative costs one harmless advisory line.
- */
-function transcriptUsedSpecship(transcriptPath) {
+function scanTranscript(transcriptPath, markers, format) {
     const MAX_SCAN_BYTES = 4 * 1024 * 1024;
     let text;
     try {
@@ -125,7 +123,7 @@ function transcriptUsedSpecship(transcriptPath) {
         if (stat.size <= MAX_SCAN_BYTES) {
             text = fs.readFileSync(transcriptPath, 'utf-8');
         }
-        else {
+        else if (format === 'jsonl') {
             const fd = fs.openSync(transcriptPath, 'r');
             try {
                 const buf = Buffer.alloc(MAX_SCAN_BYTES);
@@ -136,38 +134,120 @@ function transcriptUsedSpecship(transcriptPath) {
                 fs.closeSync(fd);
             }
         }
+        else {
+            // single-json needs a full read to parse; a huge transcript can't be
+            // reliably scanned → treat as parse-failure (ALLOW in strict).
+            return 'parse-failure';
+        }
     }
     catch {
-        return false;
+        return format === 'single-json' ? 'parse-failure' : 'not-used';
     }
-    // One JSONL record per line; a specship tool_use block puts both markers on
-    // the same record. Cheap two-substring test — no JSON.parse per line.
-    for (const line of text.split('\n')) {
-        if (line.includes('"type":"tool_use"') && line.includes('"name":"mcp__specship__')) {
-            return true;
+    if (format === 'jsonl') {
+        for (const line of text.split('\n')) {
+            if (line.includes('"type":"tool_use"') && markers.some((m) => line.includes(m))) {
+                return 'used';
+            }
         }
+        return 'not-used';
+    }
+    // single-json: Gemini CLI's ChatRecordingService writes one pretty-printed
+    // JSON doc with `messages[].toolCalls[].name`. Parse once, iterate names.
+    let doc;
+    try {
+        doc = JSON.parse(text);
     }
-    return false;
+    catch {
+        return 'parse-failure';
+    }
+    const messages = doc?.messages;
+    if (!Array.isArray(messages))
+        return 'not-used';
+    for (const m of messages) {
+        const calls = m?.toolCalls;
+        if (!Array.isArray(calls))
+            continue;
+        for (const c of calls) {
+            const name = c?.name;
+            if (typeof name === 'string') {
+                // Gemini records the function name the model called, which for an
+                // MCP tool is its bare name (`specship_explore`); the composite
+                // `specship__<tool>` form appears only when a name collision forces
+                // qualification (verified in 0.28.0 DiscoveredMCPTool). `specship_`
+                // covers both; tolerate the Claude form if a transcript carries it.
+                if (name.startsWith('specship_') || name.startsWith(hook_output_1.CLAUDE_CODE_TRAITS.toolPrefix)) {
+                    return 'used';
+                }
+            }
+        }
+    }
+    return 'not-used';
 }
 /**
- * Decide whether to emit the redirect line for one intercepted search call.
- *
- * Silence gates, in order (all REQ-STEER-004.A3 / REQ-STEER-005):
- *   1. `SPECSHIP_NO_STEERING=1` (env > project > install settings) — same
- *      opt-out as the prompt nudge.
- *   2. No `.specship/` directory at cwd — uninitialized projects get zero
- *      noise.
- *   3. No session id — nothing to key the once-per-session guarantee on, so
- *      silence beats repeat-firing.
- *   4. The session is already recorded — it fired before, or was seen using
- *      specship.
- *   5. The transcript shows specship use — the agent doesn't need redirecting;
- *      record the session so later calls skip the scan.
+ * Classify a shell command string for intercept purposes. We ONLY look at the
+ * first pipeline segment: `npm test | grep FAIL` uses grep as a FILTER on
+ * another command's output and must not be nudged, while `rg "renderScene"
+ * src/` is the lookup we care about. Read-shaped programs (`cat`, `head`,
+ * `tail`, `sed -n`, …) are never classified `search` — reading a config or
+ * log is legitimate.
+ */
+function classifyShellCommand(cmd) {
+    const first = firstPipelineSegment(cmd).trim();
+    if (!first)
+        return 'other';
+    const tokens = first.split(/\s+/);
+    const t0 = tokens[0] ?? '';
+    const t1 = tokens[1] ?? '';
+    const SEARCH_TOOLS = new Set(['grep', 'rg', 'ag', 'ack', 'fd', 'find']);
+    if (SEARCH_TOOLS.has(t0))
+        return 'search';
+    if (t0 === 'git' && t1 === 'grep')
+        return 'search';
+    return 'other';
+}
+/** Return the first `|`/`&&`/`;` separated segment, respecting simple quotes. */
+function firstPipelineSegment(cmd) {
+    let quote = null;
+    for (let i = 0; i < cmd.length; i++) {
+        const c = cmd[i];
+        if (quote) {
+            if (c === quote && cmd[i - 1] !== '\\')
+                quote = null;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            quote = c;
+            continue;
+        }
+        if (c === '|' || c === ';')
+            return cmd.slice(0, i);
+        if (c === '&' && cmd[i + 1] === '&')
+            return cmd.slice(0, i);
+    }
+    return cmd;
+}
+function denyReason(pattern) {
+    const trimmed = pattern ? pattern.trim() : '';
+    const named = trimmed ? ` naming ${JSON.stringify(trimmed.slice(0, 80))}` : '';
+    return (`SpecShip: this project has an indexed code graph. Call specship_explore${named} ` +
+        'instead — it returns the verbatim source in one call. If the index cannot ' +
+        'answer the question, ask the user and retry.');
+}
+/**
+ * Decide what to emit for one intercepted search call.
  *
- * Otherwise: record the session and return the line (fires exactly once).
+ * Order:
+ *   1. `SPECSHIP_NO_STEERING=1` → ALLOW (silent).
+ *   2. No `.specship/` at cwd → ALLOW.
+ *   3. Shell runner: classify; `other` → ALLOW; `search` → advisory path
+ *      only (never deny, REQ-GEMINI-011.A3).
+ *   4. Strict + denyEligible: parse transcript; `used` or `parse-failure` or
+ *      no transcript path → ALLOW; `not-used` → DENY with reason.
+ *   5. Otherwise advisory: once-per-session, silent in sessions already using
+ *      specship (REQ-STEER-005).
  */
 function buildSearchIntercept(input) {
-    const { cwd, sessionId, transcriptPath, env = process.env, homedir, now = new Date() } = input;
+    const { cwd, sessionId, transcriptPath, env = process.env, homedir, now = new Date(), specshipToolMarkers = hook_output_1.CLAUDE_CODE_TRAITS.specshipToolMarkers, transcriptFormat = 'jsonl', strict = false, denyEligible = false, shellCommand = null, searchPattern = null, } = input;
     if ((0, runtime_settings_1.resolveSetting)('SPECSHIP_NO_STEERING', cwd, env, homedir) === '1')
         return null;
     try {
@@ -177,6 +257,22 @@ function buildSearchIntercept(input) {
     catch {
         return null;
     }
+    // Shell runner — strict is NEVER applied here. Non-search shell commands
+    // pass through silently; search-shaped ones fall into the advisory path.
+    if (shellCommand !== null) {
+        if (classifyShellCommand(shellCommand) !== 'search')
+            return null;
+    }
+    // Strict deny path: built-in search tools only, never shell.
+    if (strict && denyEligible && shellCommand === null) {
+        if (!transcriptPath)
+            return null;
+        const scan = scanTranscript(transcriptPath, specshipToolMarkers, transcriptFormat);
+        if (scan !== 'not-used')
+            return null;
+        return { decision: 'deny', reason: denyReason(searchPattern) };
+    }
+    // Advisory path.
     if (!sessionId)
         return null;
     const stateFile = interceptStatePath(cwd);
@@ -184,12 +280,20 @@ function buildSearchIntercept(input) {
     if (state[sessionId])
         return null;
     state[sessionId] = { at: now.toISOString() };
-    if (transcriptPath && transcriptUsedSpecship(transcriptPath)) {
-        // Already an index user — silence, but remember so we don't rescan.
-        writeState(stateFile, state, now);
-        return null;
+    if (transcriptPath) {
+        const scan = scanTranscript(transcriptPath, specshipToolMarkers, transcriptFormat);
+        if (scan === 'used') {
+            writeState(stateFile, state, now);
+            return null;
+        }
+        // Gemini parse-failure fails toward silence in advisory mode (spec
+        // REQ-GEMINI-011); Claude JSONL never returns parse-failure.
+        if (scan === 'parse-failure' && transcriptFormat === 'single-json') {
+            writeState(stateFile, state, now);
+            return null;
+        }
     }
     writeState(stateFile, state, now);
-    return exports.SEARCH_INTERCEPT_TEXT;
+    return { additionalContext: exports.SEARCH_INTERCEPT_TEXT };
 }
 //# sourceMappingURL=search-intercept.js.map

package/lib/dist/activation/search-intercept.js.map

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

package/lib/dist/activation/steering.d.ts

@@ -11,17 +11,15 @@
  * hook (REQ-STEER-001) whose command is `specship steer-nudge`.
  */
 /**
- * The one steering line injected per prompt. Kept short (~40 tokens) — it is
- * added to EVERY prompt in an initialized project, so brevity is the cost
- * ceiling. Wording is A/B-gated before default-on release (REQ-STEER-003).
+ * Render a steering template with the calling host's tool-name form
+ * (AGENTADAPT-DOC, REQ-AGENTADAPT-001): Claude Code calls the tool
+ * `mcp__specship__specship_explore`, Gemini CLI calls it `specship_explore`.
+ * The prefix comes from the hook adapter — this module never names a host.
  */
+export declare function renderSteering(template: string, toolPrefix: string): string;
+/** The standard line as Claude Code (the legacy default host) receives it. */
 export declare const STEERING_TEXT: string;
-/**
- * The lite-tier template (LOWMODEL-DOC, REQ-LOWMODEL-002): small models
- * follow prescriptive templates far better than principles, and fan-out
- * (subagents) multiplies their cost and confusion. Kept under ~80 tokens
- * (REQ-LOWMODEL-002.A2).
- */
+/** The lite line as Claude Code (the legacy default host) receives it. */
 export declare const STEERING_TEXT_LITE: string;
 /**
  * Decide whether to emit the steering line (REQ-STEER-002): silent unless the
@@ -31,5 +29,5 @@ export declare const STEERING_TEXT_LITE: string;
  * lite-tier sessions get the prescriptive template; standard and frontier keep
  * the standard line.
  */
-export declare function buildSteeringNudge(cwd: string, env?: NodeJS.ProcessEnv, homedir?: string): string | null;
+export declare function buildSteeringNudge(cwd: string, env?: NodeJS.ProcessEnv, homedir?: string, toolPrefix?: string): string | null;
 //# sourceMappingURL=steering.d.ts.map

package/lib/dist/activation/steering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAKJ,CAAC;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAIsC,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAUf"}
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,8EAA8E;AAC9E,eAAO,MAAM,aAAa,QAAmE,CAAC;AAc9F,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,QAAwE,CAAC;AAExG;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,GAAE,MAAsC,GACjD,MAAM,GAAG,IAAI,CAaf"}

package/lib/dist/activation/steering.js

@@ -46,31 +46,46 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.STEERING_TEXT_LITE = exports.STEERING_TEXT = void 0;
+exports.renderSteering = renderSteering;
 exports.buildSteeringNudge = buildSteeringNudge;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const model_context_1 = require("../mcp/model-context");
 const runtime_settings_1 = require("../config/runtime-settings");
+const hook_output_1 = require("./hook-output");
 /**
  * The one steering line injected per prompt. Kept short (~40 tokens) — it is
  * added to EVERY prompt in an initialized project, so brevity is the cost
  * ceiling. Wording is A/B-gated before default-on release (REQ-STEER-003).
  */
-exports.STEERING_TEXT = 'This project has a SpecShip code-graph index. Before reading or editing ANY ' +
+const STEERING_TEMPLATE = 'This project has a SpecShip code-graph index. Before reading or editing ANY ' +
     'code for a task — understanding, implementing, fixing, refactoring — call ' +
-    'mcp__specship__specship_explore with the relevant symbol/file names FIRST. ' +
+    '{explore} with the relevant symbol/file names FIRST. ' +
     'Treat the source it returns as already read; use Read/Grep only for content ' +
     'it did not return.';
+/**
+ * Render a steering template with the calling host's tool-name form
+ * (AGENTADAPT-DOC, REQ-AGENTADAPT-001): Claude Code calls the tool
+ * `mcp__specship__specship_explore`, Gemini CLI calls it `specship_explore`.
+ * The prefix comes from the hook adapter — this module never names a host.
+ */
+function renderSteering(template, toolPrefix) {
+    return template.replace('{explore}', `${toolPrefix}specship_explore`);
+}
+/** The standard line as Claude Code (the legacy default host) receives it. */
+exports.STEERING_TEXT = renderSteering(STEERING_TEMPLATE, hook_output_1.CLAUDE_CODE_TRAITS.toolPrefix);
 /**
  * The lite-tier template (LOWMODEL-DOC, REQ-LOWMODEL-002): small models
  * follow prescriptive templates far better than principles, and fan-out
  * (subagents) multiplies their cost and confusion. Kept under ~80 tokens
  * (REQ-LOWMODEL-002.A2).
  */
-exports.STEERING_TEXT_LITE = 'This project has a SpecShip index. For any code question, call exactly: ' +
-    'mcp__specship__specship_explore with the symbol/file names from the question. ' +
+const STEERING_TEMPLATE_LITE = 'This project has a SpecShip index. For any code question, call exactly: ' +
+    '{explore} with the symbol/file names from the question. ' +
     'ONE call, then answer from its output — the source it returns is already read. ' +
     'Do not spawn subagents. Do not Read/Grep files the tool returned.';
+/** The lite line as Claude Code (the legacy default host) receives it. */
+exports.STEERING_TEXT_LITE = renderSteering(STEERING_TEMPLATE_LITE, hook_output_1.CLAUDE_CODE_TRAITS.toolPrefix);
 /**
  * Decide whether to emit the steering line (REQ-STEER-002): silent unless the
  * project is initialized (`.specship/` exists at cwd), and silent when the
@@ -79,7 +94,7 @@ exports.STEERING_TEXT_LITE = 'This project has a SpecShip index. For any code qu
  * lite-tier sessions get the prescriptive template; standard and frontier keep
  * the standard line.
  */
-function buildSteeringNudge(cwd, env = process.env, homedir) {
+function buildSteeringNudge(cwd, env = process.env, homedir, toolPrefix = hook_output_1.CLAUDE_CODE_TRAITS.toolPrefix) {
     // RUNSET-DOC: the opt-out resolves env > project .specship/settings.json >
     // ~/.specship/settings.json, so a repo can silence steering durably.
     if ((0, runtime_settings_1.resolveSetting)('SPECSHIP_NO_STEERING', cwd, env, homedir) === '1')
@@ -91,6 +106,6 @@ function buildSteeringNudge(cwd, env = process.env, homedir) {
     catch {
         return null;
     }
-    return (0, model_context_1.detectModelTier)(cwd, env, homedir) === 'lite' ? exports.STEERING_TEXT_LITE : exports.STEERING_TEXT;
+    return renderSteering((0, model_context_1.detectModelTier)(cwd, env, homedir) === 'lite' ? STEERING_TEMPLATE_LITE : STEERING_TEMPLATE, toolPrefix);
 }
 //# sourceMappingURL=steering.js.map

package/lib/dist/activation/steering.js.map

@@ -1 +1 @@
-{"version":3,"file":"steering.js","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCH,gDAcC;AAnDD,uCAAyB;AACzB,2CAA6B;AAC7B,wDAAuD;AACvD,iEAA4D;AAE5D;;;;GAIG;AACU,QAAA,aAAa,GACxB,8EAA8E;IAC9E,4EAA4E;IAC5E,6EAA6E;IAC7E,8EAA8E;IAC9E,oBAAoB,CAAC;AAEvB;;;;;GAKG;AACU,QAAA,kBAAkB,GAC7B,0EAA0E;IAC1E,gFAAgF;IAChF,iFAAiF;IACjF,mEAAmE,CAAC;AAEtE;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG,EACpC,OAAgB;IAEhB,2EAA2E;IAC3E,qEAAqE;IACrE,IAAI,IAAA,iCAAc,EAAC,sBAAsB,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnF,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAA,+BAAe,EAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,0BAAkB,CAAC,CAAC,CAAC,qBAAa,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"steering.js","sourceRoot":"","sources":["../../src/activation/steering.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BH,wCAEC;AA4BD,gDAkBC;AAxED,uCAAyB;AACzB,2CAA6B;AAC7B,wDAAuD;AACvD,iEAA4D;AAC5D,+CAAmD;AAEnD;;;;GAIG;AACH,MAAM,iBAAiB,GACrB,8EAA8E;IAC9E,4EAA4E;IAC5E,uDAAuD;IACvD,8EAA8E;IAC9E,oBAAoB,CAAC;AAEvB;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,QAAgB,EAAE,UAAkB;IACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,UAAU,kBAAkB,CAAC,CAAC;AACxE,CAAC;AAED,8EAA8E;AACjE,QAAA,aAAa,GAAG,cAAc,CAAC,iBAAiB,EAAE,gCAAkB,CAAC,UAAU,CAAC,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,sBAAsB,GAC1B,0EAA0E;IAC1E,0DAA0D;IAC1D,iFAAiF;IACjF,mEAAmE,CAAC;AAEtE,0EAA0E;AAC7D,QAAA,kBAAkB,GAAG,cAAc,CAAC,sBAAsB,EAAE,gCAAkB,CAAC,UAAU,CAAC,CAAC;AAExG;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG,EACpC,OAAgB,EAChB,aAAqB,gCAAkB,CAAC,UAAU;IAElD,2EAA2E;IAC3E,qEAAqE;IACrE,IAAI,IAAA,iCAAc,EAAC,sBAAsB,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnF,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,CACnB,IAAA,+BAAe,EAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,iBAAiB,EAC1F,UAAU,CACX,CAAC;AACJ,CAAC"}

package/lib/dist/behaviour/behaviour-surface.d.ts

@@ -25,6 +25,13 @@ export interface BehaviourFlowElement {
     /** True when the requirement links to this node directly (vs a neighbour). */
     linkedDirectly: boolean;
 }
+/** How an acceptance criterion is best tested (REQ-QGATE-001). */
+export type CriterionTestShape = 'example' | 'invariant';
+export interface ClassifiedCriterion {
+    id: string;
+    text: string;
+    testShape: CriterionTestShape;
+}
 export interface BehaviourSurface {
     requirementId: string;
     /** False when the requirement id resolves to no spec (REQ-BEHAVIOUR-001.A4). */
@@ -33,6 +40,18 @@ export interface BehaviourSurface {
     ui: BehaviourFlowElement[];
     /** Backend / batch flows — API / job test targets. */
     backend: BehaviourFlowElement[];
+    /** Acceptance criteria classified example|invariant (REQ-QGATE-001.A1). */
+    criteria: ClassifiedCriterion[];
+    /**
+     * Contract-fuzz eligibility (REQ-QGATE-003.A1): a spec whose DIRECT links
+     * include `route`-kind nodes describes an API contract and can be fuzzed
+     * from the OpenAPI schema. Neighbour routes don't qualify — the fuzz run
+     * must target only what the requirement actually links to (A2).
+     */
+    contractFuzz: {
+        eligible: boolean;
+        routes: BehaviourFlowElement[];
+    };
 }
 export interface BehaviourSurfaceDeps {
     requirementId: string;
@@ -42,7 +61,28 @@ export interface BehaviourSurfaceDeps {
     linkedNodes: Node[];
     /** 1-hop caller/callee neighbours of the linked nodes. */
     neighbourNodes: Node[];
+    /** Acceptance criteria (id + bullet text) for shape classification. */
+    criteria?: Array<{
+        id: string;
+        text: string;
+    }>;
 }
+/**
+ * Classify a criterion's test shape (REQ-QGATE-001.A1) — deterministic
+ * keyword/shape heuristic, no LLM. Invariant cues are universal quantifiers
+ * and negative universals ("for all", "every", "never", "always", "MUST
+ * NOT"), plus the classic property shapes (round-trip, idempotence,
+ * input-independence). Everything else is an example: a concrete
+ * stimulus→response pair.
+ */
+export declare function classifyCriterionShape(text: string): CriterionTestShape;
+/**
+ * The property-testing framework the generated skeleton should use
+ * (REQ-QGATE-001.A2), picked from the linked implementation's file types:
+ * Python → Hypothesis, everything else (this tool's world is JS/TS) →
+ * fast-check.
+ */
+export declare function propertyFramework(linkedNodes: Node[]): string;
 /** A node is UI when it's a component or lives in a front-end file. */
 export declare function isUiNode(node: Node): boolean;
 /**
@@ -54,6 +94,13 @@ export declare function isUiNode(node: Node): boolean;
  * tier rather than an error (A3).
  */
 export declare function computeBehaviourSurface(deps: BehaviourSurfaceDeps): BehaviourSurface;
+/**
+ * The reviewable Schemathesis invocation for a route-backed spec
+ * (REQ-QGATE-003.A2) — scoped to the linked routes via a path regex, never
+ * the whole API. Emitted as text for a human/agent to review and run; this
+ * module executes nothing.
+ */
+export declare function renderContractFuzzCommand(routes: BehaviourFlowElement[], schemaRef: string): string;
 /** Render a behaviour surface as markdown for the `specship_spec` response. */
 export declare function renderBehaviourSurface(surface: BehaviourSurface): string;
 //# sourceMappingURL=behaviour-surface.d.ts.map

package/lib/dist/behaviour/behaviour-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behaviour-surface.d.ts","sourceRoot":"","sources":["../../src/behaviour/behaviour-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAa1C,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,EAAE,EAAE,oBAAoB,EAAE,CAAC;IAC3B,sDAAsD;IACtD,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,0DAA0D;IAC1D,cAAc,EAAE,IAAI,EAAE,CAAC;CACxB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAYD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAgCpF;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA+BxE"}
+{"version":3,"file":"behaviour-surface.d.ts","sourceRoot":"","sources":["../../src/behaviour/behaviour-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAa1C,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,EAAE,EAAE,oBAAoB,EAAE,CAAC;IAC3B,sDAAsD;IACtD,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC;;;;;OAKG;IACH,YAAY,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;CACrE;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,0DAA0D;IAC1D,cAAc,EAAE,IAAI,EAAE,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAevE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,MAAM,CAG7D;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE5C;AAYD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CA6CpF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAanG;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA0ExE"}