@specship/specship-win32-arm64 0.24.0 → 0.28.0

package/lib/dist/behaviour/behaviour-surface.js

@@ -17,8 +17,11 @@
  * extension; everything else flow-relevant (routes, handlers) is backend/batch.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyCriterionShape = classifyCriterionShape;
+exports.propertyFramework = propertyFramework;
 exports.isUiNode = isUiNode;
 exports.computeBehaviourSurface = computeBehaviourSurface;
+exports.renderContractFuzzCommand = renderContractFuzzCommand;
 exports.renderBehaviourSurface = renderBehaviourSurface;
 /** Node kinds that are flow-relevant for a behaviour test (others are noise). */
 const FLOW_KINDS = new Set([
@@ -29,6 +32,40 @@ const FLOW_KINDS = new Set([
 ]);
 /** File extensions that are unambiguously front-end / UI. */
 const UI_FILE = /\.(tsx|jsx|vue|svelte|astro)$/i;
+/**
+ * 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.
+ */
+function classifyCriterionShape(text) {
+    const t = text.toLowerCase();
+    const cues = [
+        /\bfor (all|every|any)\b/,
+        /\b(every|any) (input|request|value|call|x)\b/,
+        /\bnever\b/,
+        /\balways\b/,
+        /\bmust not\b/,
+        /\bround-?trip\b/,
+        /\bidempotent\b/,
+        /\bregardless of\b/,
+        /\bno matter\b/,
+        /\barbitrary\b/,
+    ];
+    return cues.some((re) => re.test(t)) ? 'invariant' : 'example';
+}
+/**
+ * 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.
+ */
+function propertyFramework(linkedNodes) {
+    const py = linkedNodes.some((n) => /\.pyi?$/i.test(n.filePath));
+    return py ? 'Hypothesis (@given)' : 'fast-check';
+}
 /** A node is UI when it's a component or lives in a front-end file. */
 function isUiNode(node) {
     return node.kind === 'component' || UI_FILE.test(node.filePath);
@@ -52,7 +89,10 @@ function toElement(node, linkedDirectly) {
  */
 function computeBehaviourSurface(deps) {
     if (!deps.requirementExists) {
-        return { requirementId: deps.requirementId, found: false, ui: [], backend: [] };
+        return {
+            requirementId: deps.requirementId, found: false, ui: [], backend: [], criteria: [],
+            contractFuzz: { eligible: false, routes: [] },
+        };
     }
     const seen = new Set();
     const ui = [];
@@ -78,7 +118,36 @@ function computeBehaviourSurface(deps) {
         a.startLine - b.startLine;
     ui.sort(order);
     backend.sort(order);
-    return { requirementId: deps.requirementId, found: true, ui, backend };
+    const criteria = (deps.criteria ?? []).map((c) => ({
+        id: c.id,
+        text: c.text,
+        testShape: classifyCriterionShape(c.text),
+    }));
+    const routes = [...ui, ...backend].filter((e) => e.kind === 'route' && e.linkedDirectly);
+    return {
+        requirementId: deps.requirementId, found: true, ui, backend, criteria,
+        contractFuzz: { eligible: routes.length > 0, routes },
+    };
+}
+/**
+ * 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.
+ */
+function renderContractFuzzCommand(routes, schemaRef) {
+    const paths = routes.map((r) => {
+        // Route names carry an optional method prefix ("GET /api/users") —
+        // extract the path and normalize `{id}`/`:id` params to a wildcard
+        // BEFORE regex-escaping the literal segments.
+        const path = (r.name.match(/\/\S*/) ?? [r.name])[0];
+        return path
+            .split(/\{[^}]+\}|:\w+/)
+            .map((seg) => seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+            .join('[^/]+');
+    });
+    const regex = `^(${[...new Set(paths)].join('|')})$`;
+    return `st run ${schemaRef} --include-path-regex '${regex}' --checks all`;
 }
 /** Render a behaviour surface as markdown for the `specship_spec` response. */
 function renderBehaviourSurface(surface) {
@@ -107,6 +176,43 @@ function renderBehaviourSurface(surface) {
     };
     section('UI tier (Playwright)', surface.ui, 'No UI surface — author backend/batch tests only.');
     section('Backend / batch tier', surface.backend, 'No backend surface found.');
+    // Property lane (REQ-QGATE-001): classified criteria with the directive for
+    // invariant-shaped ones. Rendered only when criteria were supplied, so the
+    // pre-existing surface output is unchanged for callers that don't pass them.
+    if (surface.criteria.length > 0) {
+        const fw = propertyFramework([...surface.backend, ...surface.ui].filter((e) => e.linkedDirectly)
+            .map((e) => ({ filePath: e.filePath })));
+        lines.push('## Acceptance criteria — test shape');
+        for (const c of surface.criteria) {
+            lines.push(`- ${c.id} [${c.testShape}] — ${c.text}`);
+        }
+        if (surface.criteria.some((c) => c.testShape === 'invariant')) {
+            lines.push('');
+            lines.push(`_Author each **invariant** criterion as a property-based test with ${fw} — ` +
+                'generate inputs, assert the stated property; do not hard-code a single example. ' +
+                'Example-shaped criteria stay concrete example tests._');
+        }
+        lines.push('');
+    }
+    // Contract-fuzz leg (REQ-QGATE-003): emitted as a reviewable command for the
+    // linked routes — review the schema ref and run it yourself; nothing here
+    // executes it.
+    if (surface.contractFuzz.eligible) {
+        lines.push('## Contract-fuzz leg (Schemathesis)');
+        lines.push('This requirement links to API route(s) — its input space is fuzzable from the OpenAPI schema:');
+        for (const r of surface.contractFuzz.routes) {
+            lines.push(`- [route] \`${r.name}\` — ${r.filePath}:${r.startLine}`);
+        }
+        lines.push('');
+        lines.push('```bash');
+        lines.push(renderContractFuzzCommand(surface.contractFuzz.routes, '<openapi-schema (path or URL)>'));
+        lines.push('```');
+        lines.push('');
+        lines.push('_Review before running (staging only). Record the outcome through link verification: ' +
+            'a failing run → result "fail" with the failing case as reason; a passing run is ' +
+            'evidence under the existing rules — it does not mint tests-kind links._');
+        lines.push('');
+    }
     return lines.join('\n').trimEnd();
 }
 //# sourceMappingURL=behaviour-surface.js.map

package/lib/dist/behaviour/behaviour-surface.js.map

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

package/lib/dist/bin/node-version-check.d.ts

@@ -18,16 +18,31 @@
  */
 export declare function buildNode25BlockBanner(nodeVersion: string): string;
 /**
- * Lowest supported Node.js major version. Matches the `engines` floor in
- * package.json. Below this, SpecShip relies on language features / native APIs
- * that aren't present, and the combination is untested. `engines` alone only
+ * Lowest supported Node.js version (major.minor). Matches the `engines` floor
+ * (`>=22.5.0 <25.0.0`) in package.json, npm-shim/package.json, and every
+ * package `scripts/pack-npm.sh` publishes. 22.5 is the first release with the
+ * built-in `node:sqlite` the SQLite adapter falls back to. `engines` alone only
  * *warns* on install (unless the user set `engine-strict`), so the CLI bootstrap
- * also hard-blocks here to actually enforce the floor.
+ * also hard-blocks here to actually enforce the floor (REQ-AUDFIX-007).
  */
-export declare const MIN_NODE_MAJOR = 20;
+export declare const MIN_NODE_MAJOR = 22;
+export declare const MIN_NODE_MINOR = 5;
+/** Human-readable floor, e.g. "22.5". */
+export declare const MIN_NODE_VERSION = "22.5";
 /**
- * Build the bordered banner shown when SpecShip detects a Node.js major below
- * {@link MIN_NODE_MAJOR}. Pinned via unit test so the recovery commands and the
+ * True when `nodeVersion` (e.g. "22.4.1", "v20.0.0") is below the supported
+ * floor. Compares major, then minor; an unparseable version counts as too old.
+ */
+export declare function isNodeTooOld(nodeVersion: string): boolean;
+/**
+ * Startup decision for the Node floor: `ok` (supported), `block` (too old, exit
+ * 1), or `warn` (too old, but `SPECSHIP_ALLOW_UNSAFE_NODE` is set — show the
+ * banner and continue). Pure so the bootstrap and tests share one rule.
+ */
+export declare function nodeFloorDecision(nodeVersion: string, env?: Record<string, string | undefined>): 'ok' | 'block' | 'warn';
+/**
+ * Build the bordered banner shown when SpecShip detects a Node.js version below
+ * {@link MIN_NODE_VERSION}. Pinned via unit test so the recovery commands and the
  * override env var can't be silently stripped by future edits.
  *
  * Uses ASCII glyphs to stay readable on Windows OEM-codepage consoles

package/lib/dist/bin/node-version-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-version-check.d.ts","sourceRoot":"","sources":["../../src/bin/node-version-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAmBlE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkBjE"}
+{"version":3,"file":"node-version-check.d.ts","sourceRoot":"","sources":["../../src/bin/node-version-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAmBlE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,SAAwC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,IAAI,GAAG,OAAO,GAAG,MAAM,CAGzB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkBjE"}

package/lib/dist/bin/node-version-check.js

@@ -9,8 +9,10 @@
  * safe to import from tests without triggering CLI bootstrap.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MIN_NODE_MAJOR = void 0;
+exports.MIN_NODE_VERSION = exports.MIN_NODE_MINOR = exports.MIN_NODE_MAJOR = void 0;
 exports.buildNode25BlockBanner = buildNode25BlockBanner;
+exports.isNodeTooOld = isNodeTooOld;
+exports.nodeFloorDecision = nodeFloorDecision;
 exports.buildNodeTooOldBanner = buildNodeTooOldBanner;
 /**
  * Build the bordered banner shown when SpecShip detects an
@@ -42,16 +44,44 @@ function buildNode25BlockBanner(nodeVersion) {
     ].join('\n');
 }
 /**
- * Lowest supported Node.js major version. Matches the `engines` floor in
- * package.json. Below this, SpecShip relies on language features / native APIs
- * that aren't present, and the combination is untested. `engines` alone only
+ * Lowest supported Node.js version (major.minor). Matches the `engines` floor
+ * (`>=22.5.0 <25.0.0`) in package.json, npm-shim/package.json, and every
+ * package `scripts/pack-npm.sh` publishes. 22.5 is the first release with the
+ * built-in `node:sqlite` the SQLite adapter falls back to. `engines` alone only
  * *warns* on install (unless the user set `engine-strict`), so the CLI bootstrap
- * also hard-blocks here to actually enforce the floor.
+ * also hard-blocks here to actually enforce the floor (REQ-AUDFIX-007).
  */
-exports.MIN_NODE_MAJOR = 20;
+exports.MIN_NODE_MAJOR = 22;
+exports.MIN_NODE_MINOR = 5;
+/** Human-readable floor, e.g. "22.5". */
+exports.MIN_NODE_VERSION = `${exports.MIN_NODE_MAJOR}.${exports.MIN_NODE_MINOR}`;
 /**
- * Build the bordered banner shown when SpecShip detects a Node.js major below
- * {@link MIN_NODE_MAJOR}. Pinned via unit test so the recovery commands and the
+ * True when `nodeVersion` (e.g. "22.4.1", "v20.0.0") is below the supported
+ * floor. Compares major, then minor; an unparseable version counts as too old.
+ */
+function isNodeTooOld(nodeVersion) {
+    const [majStr, minStr] = nodeVersion.replace(/^v/, '').split('.');
+    const major = parseInt(majStr ?? '', 10);
+    const minor = parseInt(minStr ?? '0', 10);
+    if (!Number.isFinite(major))
+        return true;
+    if (major !== exports.MIN_NODE_MAJOR)
+        return major < exports.MIN_NODE_MAJOR;
+    return (Number.isFinite(minor) ? minor : 0) < exports.MIN_NODE_MINOR;
+}
+/**
+ * Startup decision for the Node floor: `ok` (supported), `block` (too old, exit
+ * 1), or `warn` (too old, but `SPECSHIP_ALLOW_UNSAFE_NODE` is set — show the
+ * banner and continue). Pure so the bootstrap and tests share one rule.
+ */
+function nodeFloorDecision(nodeVersion, env = process.env) {
+    if (!isNodeTooOld(nodeVersion))
+        return 'ok';
+    return env.SPECSHIP_ALLOW_UNSAFE_NODE ? 'warn' : 'block';
+}
+/**
+ * Build the bordered banner shown when SpecShip detects a Node.js version below
+ * {@link MIN_NODE_VERSION}. Pinned via unit test so the recovery commands and the
  * override env var can't be silently stripped by future edits.
  *
  * Uses ASCII glyphs to stay readable on Windows OEM-codepage consoles
@@ -63,7 +93,7 @@ function buildNodeTooOldBanner(nodeVersion) {
         sep,
         `[SpecShip] Unsupported Node.js version: ${nodeVersion}`,
         sep,
-        `SpecShip requires Node.js ${exports.MIN_NODE_MAJOR} or newer. Older versions lack`,
+        `SpecShip requires Node.js ${exports.MIN_NODE_VERSION} or newer. Older versions lack`,
         'language features and native APIs SpecShip depends on, and are not',
         'tested or supported.',
         '',

package/lib/dist/bin/node-version-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-version-check.js","sourceRoot":"","sources":["../../src/bin/node-version-check.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAWH,wDAmBC;AAmBD,sDAkBC;AAjED;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG;QACH,2CAA2C,WAAW,EAAE;QACxD,GAAG;QACH,qEAAqE;QACrE,gEAAgE;QAChE,iEAAiE;QACjE,gFAAgF;QAChF,EAAE;QACF,8BAA8B;QAC9B,+DAA+D;QAC/D,6EAA6E;QAC7E,EAAE;QACF,sDAAsD;QACtD,6CAA6C;QAC7C,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACU,QAAA,cAAc,GAAG,EAAE,CAAC;AAEjC;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CAAC,WAAmB;IACvD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG;QACH,2CAA2C,WAAW,EAAE;QACxD,GAAG;QACH,6BAA6B,sBAAc,gCAAgC;QAC3E,oEAAoE;QACpE,sBAAsB;QACtB,EAAE;QACF,8BAA8B;QAC9B,+DAA+D;QAC/D,6EAA6E;QAC7E,EAAE;QACF,8CAA8C;QAC9C,6CAA6C;QAC7C,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"node-version-check.js","sourceRoot":"","sources":["../../src/bin/node-version-check.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAWH,wDAmBC;AAmBD,oCAOC;AAOD,8CAMC;AAUD,sDAkBC;AA/FD;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG;QACH,2CAA2C,WAAW,EAAE;QACxD,GAAG;QACH,qEAAqE;QACrE,gEAAgE;QAChE,iEAAiE;QACjE,gFAAgF;QAChF,EAAE;QACF,8BAA8B;QAC9B,+DAA+D;QAC/D,6EAA6E;QAC7E,EAAE;QACF,sDAAsD;QACtD,6CAA6C;QAC7C,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACU,QAAA,cAAc,GAAG,EAAE,CAAC;AACpB,QAAA,cAAc,GAAG,CAAC,CAAC;AAChC,yCAAyC;AAC5B,QAAA,gBAAgB,GAAG,GAAG,sBAAc,IAAI,sBAAc,EAAE,CAAC;AAEtE;;;GAGG;AACH,SAAgB,YAAY,CAAC,WAAmB;IAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,KAAK,KAAK,sBAAc;QAAE,OAAO,KAAK,GAAG,sBAAc,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,sBAAc,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,WAAmB,EACnB,MAA0C,OAAO,CAAC,GAAG;IAErD,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CAAC,WAAmB;IACvD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG;QACH,2CAA2C,WAAW,EAAE;QACxD,GAAG;QACH,6BAA6B,wBAAgB,gCAAgC;QAC7E,oEAAoE;QACpE,sBAAsB;QACtB,EAAE;QACF,8BAA8B;QAC9B,+DAA+D;QAC/D,6EAA6E;QAC7E,EAAE;QACF,8CAA8C;QAC9C,6CAA6C;QAC7C,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}