@specship/specship-win32-arm64 0.24.0 → 0.28.0

package/lib/dist/knowledge/stale.d.ts

@@ -0,0 +1,64 @@
+/**
+ * External-fact staleness (KNOWLEDGE-DOC, REQ-KNOW-002 / REQ-KNOW-006.A1).
+ *
+ * An external domain fact (`type: external`) records the `version` of its
+ * `dependency` it was verified against. When the installed version differs,
+ * the fact is stale: what it says may no longer be true. A dependency that
+ * cannot be found is unverifiable — reported, never counted as fresh, but not
+ * by itself a failure.
+ *
+ * Version comparison is deliberately exact-string: a fact verified against
+ * 0.28.0 is not known to hold for 0.28.1, and semver ranges would hide that.
+ *
+ * Read-only: reads `specs/domain/` and `package.json` files, writes nothing.
+ */
+export interface ResolveVersionOptions {
+    /**
+     * Returns the global npm root (what `npm root -g` prints), or null. Injected
+     * by tests; the default shells out to npm once per process and caches it.
+     */
+    globalRoot?: () => string | null;
+}
+export type StaleCheckOptions = ResolveVersionOptions;
+export interface FreshFact {
+    id: string;
+    dependency: string;
+    version: string;
+}
+export interface StaleFact {
+    id: string;
+    dependency: string;
+    /** The version the fact was verified against. */
+    verified: string;
+    /** The version installed now. */
+    installed: string;
+    /** `path:Symbol` fixture tests to re-check (REQ-KNOW-006.A1). */
+    fixtures: string[];
+}
+export interface UnverifiableFact {
+    id: string;
+    dependency: string;
+}
+export interface StaleCheckResult {
+    fresh: FreshFact[];
+    stale: StaleFact[];
+    unverifiable: UnverifiableFact[];
+}
+/** `npm root -g`, run at most once per process. Null when npm is unavailable. */
+export declare function defaultGlobalNpmRoot(): string | null;
+/**
+ * The installed version of `dependency`: the project's `node_modules` first,
+ * then the global npm root; null when neither has it.
+ */
+export declare function resolveInstalledVersion(dependency: string, projectRoot: string, opts?: ResolveVersionOptions): string | null;
+/**
+ * Compare every external fact under `<projectRoot>/specs/domain/` with the
+ * installed version of its dependency. Facts missing `dependency` or `version`
+ * are skipped (the lint reports them as errors).
+ */
+export declare function findStaleExternalFacts(projectRoot: string, opts?: StaleCheckOptions): StaleCheckResult;
+/** Exit code for `knowledge stale`: non-zero when any fact is stale. Unverifiable alone passes. */
+export declare function exitCodeForStale(result: StaleCheckResult): number;
+/** Human-readable report for `knowledge stale`. */
+export declare function formatStaleReport(result: StaleCheckResult): string;
+//# sourceMappingURL=stale.d.ts.map

package/lib/dist/knowledge/stale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale.d.ts","sourceRoot":"","sources":["../../src/knowledge/stale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAID,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAcpD;AAaD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,qBAA0B,GAC/B,MAAM,GAAG,IAAI,CAQf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,iBAAsB,GAC3B,gBAAgB,CA+BlB;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAEjE;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoBlE"}

package/lib/dist/knowledge/stale.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * External-fact staleness (KNOWLEDGE-DOC, REQ-KNOW-002 / REQ-KNOW-006.A1).
+ *
+ * An external domain fact (`type: external`) records the `version` of its
+ * `dependency` it was verified against. When the installed version differs,
+ * the fact is stale: what it says may no longer be true. A dependency that
+ * cannot be found is unverifiable — reported, never counted as fresh, but not
+ * by itself a failure.
+ *
+ * Version comparison is deliberately exact-string: a fact verified against
+ * 0.28.0 is not known to hold for 0.28.1, and semver ranges would hide that.
+ *
+ * Read-only: reads `specs/domain/` and `package.json` files, writes nothing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultGlobalNpmRoot = defaultGlobalNpmRoot;
+exports.resolveInstalledVersion = resolveInstalledVersion;
+exports.findStaleExternalFacts = findStaleExternalFacts;
+exports.exitCodeForStale = exitCodeForStale;
+exports.formatStaleReport = formatStaleReport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const facts_1 = require("./facts");
+let cachedGlobalRoot;
+/** `npm root -g`, run at most once per process. Null when npm is unavailable. */
+function defaultGlobalNpmRoot() {
+    if (cachedGlobalRoot !== undefined)
+        return cachedGlobalRoot;
+    try {
+        const out = (0, child_process_1.execFileSync)(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['root', '-g'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 10_000,
+            shell: process.platform === 'win32',
+        }).trim();
+        cachedGlobalRoot = out.length > 0 ? out : null;
+    }
+    catch {
+        cachedGlobalRoot = null;
+    }
+    return cachedGlobalRoot;
+}
+function readPackageVersion(modulesDir, dependency) {
+    // `@scope/name` maps onto nested directories; path.join handles the slash.
+    const pkgPath = path.join(modulesDir, ...dependency.split('/'), 'package.json');
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        return typeof pkg.version === 'string' && pkg.version.length > 0 ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The installed version of `dependency`: the project's `node_modules` first,
+ * then the global npm root; null when neither has it.
+ */
+function resolveInstalledVersion(dependency, projectRoot, opts = {}) {
+    const dep = dependency.trim();
+    if (dep.length === 0 || dep.includes('..'))
+        return null;
+    const local = readPackageVersion(path.join(projectRoot, 'node_modules'), dep);
+    if (local)
+        return local;
+    const globalRoot = (opts.globalRoot ?? defaultGlobalNpmRoot)();
+    if (!globalRoot)
+        return null;
+    return readPackageVersion(globalRoot, dep);
+}
+/**
+ * Compare every external fact under `<projectRoot>/specs/domain/` with the
+ * installed version of its dependency. Facts missing `dependency` or `version`
+ * are skipped (the lint reports them as errors).
+ */
+function findStaleExternalFacts(projectRoot, opts = {}) {
+    const result = { fresh: [], stale: [], unverifiable: [] };
+    // Resolve the global root lazily and at most once for the whole run.
+    let globalRoot;
+    const memoGlobal = () => {
+        if (globalRoot === undefined)
+            globalRoot = (opts.globalRoot ?? defaultGlobalNpmRoot)();
+        return globalRoot;
+    };
+    for (const fact of (0, facts_1.loadDomainFacts)(projectRoot)) {
+        if (fact.type !== 'external')
+            continue;
+        const dependency = typeof fact.metadata.dependency === 'string' ? fact.metadata.dependency.trim() : '';
+        const rawVersion = fact.metadata.version;
+        const verified = typeof rawVersion === 'string' || typeof rawVersion === 'number' ? String(rawVersion).trim() : '';
+        if (!dependency || !verified)
+            continue;
+        const installed = resolveInstalledVersion(dependency, projectRoot, { globalRoot: memoGlobal });
+        if (installed === null) {
+            result.unverifiable.push({ id: fact.id, dependency });
+        }
+        else if (installed === verified) {
+            result.fresh.push({ id: fact.id, dependency, version: verified });
+        }
+        else {
+            result.stale.push({
+                id: fact.id,
+                dependency,
+                verified,
+                installed,
+                fixtures: (0, facts_1.parseFixtureList)(fact.metadata.fixture),
+            });
+        }
+    }
+    return result;
+}
+/** Exit code for `knowledge stale`: non-zero when any fact is stale. Unverifiable alone passes. */
+function exitCodeForStale(result) {
+    return result.stale.length > 0 ? 1 : 0;
+}
+/** Human-readable report for `knowledge stale`. */
+function formatStaleReport(result) {
+    const total = result.fresh.length + result.stale.length + result.unverifiable.length;
+    if (total === 0)
+        return 'Knowledge stale: no external facts in specs/domain/.';
+    const out = [
+        `Knowledge stale: ${result.stale.length} stale, ${result.unverifiable.length} unverifiable, ${result.fresh.length} fresh (of ${total} external fact${total === 1 ? '' : 's'}).`,
+    ];
+    if (result.stale.length > 0) {
+        out.push('', 'Stale:');
+        for (const s of result.stale) {
+            out.push(`  ${s.id}  ${s.dependency}: verified ${s.verified}, installed ${s.installed}`);
+            if (s.fixtures.length > 0) {
+                out.push(`    re-check fixtures: ${s.fixtures.join(', ')}`);
+            }
+        }
+    }
+    if (result.unverifiable.length > 0) {
+        out.push('', 'Unverifiable (dependency not installed locally or globally):');
+        for (const u of result.unverifiable)
+            out.push(`  ${u.id}  ${u.dependency}`);
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=stale.js.map

package/lib/dist/knowledge/stale.js.map

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

package/lib/dist/mcp/fitness-tool.d.ts

@@ -1,12 +1,11 @@
 /**
- * MCP tool: specship_fitness (REQ-FITNESS-003.A3).
+ * Architecture-fitness report handler (REQ-FITNESS-003.A3).
  *
- * Returns the architecture-fitness evaluation to the agent — violations of the
- * declared rules plus any config errors — so it can check conformance before
- * committing. Type-only imports keep this free of a runtime cycle with tools.ts.
+ * The menu slot moved to the merged `specship_health` (REQ-SURF-007); this
+ * handler stays so `execute()` keeps answering clients holding a cached
+ * `specship_fitness` tool list.
  */
 import type { SpecShip } from '../index';
-import type { ToolDefinition, ToolResult } from './tools';
-export declare const fitnessToolDefinitions: ToolDefinition[];
+import type { ToolResult } from './tools';
 export declare function handleSpecshipFitness(cg: SpecShip, _args: Record<string, unknown>): Promise<ToolResult>;
 //# sourceMappingURL=fitness-tool.d.ts.map

package/lib/dist/mcp/fitness-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fitness-tool.d.ts","sourceRoot":"","sources":["../../src/mcp/fitness-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAelD,CAAC;AAMF,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CAqBrB"}
+{"version":3,"file":"fitness-tool.d.ts","sourceRoot":"","sources":["../../src/mcp/fitness-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CAqBrB"}

package/lib/dist/mcp/fitness-tool.js

@@ -1,22 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fitnessToolDefinitions = void 0;
 exports.handleSpecshipFitness = handleSpecshipFitness;
-exports.fitnessToolDefinitions = [
-    {
-        name: 'specship_fitness',
-        description: 'Evaluate the project\'s architecture-fitness rules (specship.config.json `fitness.rules`) against the code graph: forbidden dependencies, layering allow-lists, module isolation. Returns concrete violations (source → target, file:line) plus config errors (a rule whose selector matches nothing). Use to check architecture conformance before committing.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                projectPath: {
-                    type: 'string',
-                    description: 'Path to a different project with .specship/ initialized. Omit for the current project.',
-                },
-            },
-        },
-    },
-];
 const text = (body) => ({ content: [{ type: 'text', text: body }] });
 const CAP = 30;
 async function handleSpecshipFitness(cg, _args) {

package/lib/dist/mcp/fitness-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"fitness-tool.js","sourceRoot":"","sources":["../../src/mcp/fitness-tool.ts"],"names":[],"mappings":";;;AA+BA,sDAwBC;AA7CY,QAAA,sBAAsB,GAAqB;IACtD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iWAAiW;QACnW,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wFAAwF;iBACtG;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAEzF,MAAM,GAAG,GAAG,EAAE,CAAC;AAER,KAAK,UAAU,qBAAqB,CACzC,EAAY,EACZ,KAA8B;IAE9B,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,2IAA2I,CAAC,CAAC;IAC3J,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,mCAAmC,CAAC,CAAC,SAAS,gBAAgB,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"fitness-tool.js","sourceRoot":"","sources":["../../src/mcp/fitness-tool.ts"],"names":[],"mappings":";;AAcA,sDAwBC;AA5BD,MAAM,IAAI,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAEzF,MAAM,GAAG,GAAG,EAAE,CAAC;AAER,KAAK,UAAU,qBAAqB,CACzC,EAAY,EACZ,KAA8B;IAE9B,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,2IAA2I,CAAC,CAAC;IAC3J,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,mCAAmC,CAAC,CAAC,SAAS,gBAAgB,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAa,CAAC,wBAAwB,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/lib/dist/mcp/gemini-session.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Gemini CLI session model detection (LOWEND-DOC, REQ-LOWEND-001).
+ *
+ * All three existing tier-detection channels — the status-line marker, the
+ * SessionStart hook seed, and the transcript tail — are Claude Code plumbing.
+ * The Gemini target is MCP-entry-only (no hooks, no status line), so a Gemini
+ * CLI session has to be read **in-server** from Gemini CLI's own configuration
+ * surface:
+ *
+ *   GEMINI_MODEL (Gemini CLI's own env knob)
+ *   <cwd>/.gemini/settings.json        — project, wins over global
+ *   <homedir>/.gemini/settings.json    — global
+ *
+ * Gemini CLI has shipped both `"model": "gemini-3.5-flash"` and
+ * `"model": { "name": "gemini-3.5-flash" }`, so both shapes are accepted.
+ * Every read is best-effort: a missing file, malformed JSON, or a non-string
+ * model yields `null` and the caller falls back to `full` — detection must
+ * never error a tool call (REQ-LOWEND-001.A4).
+ *
+ * This module deliberately does NOT import the Gemini installer target: the
+ * MCP read path must not depend on installer code. The paths mirror what that
+ * target documents (Storage.getWorkspaceSettingsPath / getGlobalSettingsPath).
+ */
+/**
+ * Gemini CLI's settings files for a workspace, project first (project settings
+ * override global ones, same as Gemini CLI's own precedence).
+ */
+export declare function geminiSettingsPaths(cwd: string, homedir?: string): string[];
+/** Test seam — drops the parse cache. */
+export declare function __resetGeminiCache(): void;
+/**
+ * Host gate: the Gemini leg may only run inside a server that Gemini CLI
+ * launched. The Gemini installer target stamps `SPECSHIP_HOST=gemini` into
+ * the `mcpServers.specship` entry (written AND printed snippet), so the env
+ * is present exactly in Gemini-launched server processes. Without this gate
+ * a **Claude Code** session in a repo that happens to contain
+ * `.gemini/settings.json` (or a shell exporting `GEMINI_MODEL`) would be
+ * silently compacted during the first-prompt window before the Claude marker
+ * exists — the exact crossover REQ-MODCTX-001.A6 closes on the Claude side.
+ */
+export declare function isGeminiHost(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Resolve the Gemini CLI session's model id, or null when nothing names one
+ * (REQ-LOWEND-001). Host-gated: returns null outright unless
+ * `SPECSHIP_HOST=gemini` (see `isGeminiHost`). Then env first, then project
+ * settings, then global settings — first hit wins. The returned id is
+ * verbatim; mapping it to a tier is `modelTier`'s job.
+ */
+export declare function readGeminiSessionModel(cwd: string, env?: NodeJS.ProcessEnv, homedir?: string): string | null;
+//# sourceMappingURL=gemini-session.d.ts.map

package/lib/dist/mcp/gemini-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-session.d.ts","sourceRoot":"","sources":["../../src/mcp/gemini-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,EAAE,CAKzF;AAiBD,yCAAyC;AACzC,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAmCD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE,MAAqB,GAC7B,MAAM,GAAG,IAAI,CASf"}

package/lib/dist/mcp/gemini-session.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Gemini CLI session model detection (LOWEND-DOC, REQ-LOWEND-001).
+ *
+ * All three existing tier-detection channels — the status-line marker, the
+ * SessionStart hook seed, and the transcript tail — are Claude Code plumbing.
+ * The Gemini target is MCP-entry-only (no hooks, no status line), so a Gemini
+ * CLI session has to be read **in-server** from Gemini CLI's own configuration
+ * surface:
+ *
+ *   GEMINI_MODEL (Gemini CLI's own env knob)
+ *   <cwd>/.gemini/settings.json        — project, wins over global
+ *   <homedir>/.gemini/settings.json    — global
+ *
+ * Gemini CLI has shipped both `"model": "gemini-3.5-flash"` and
+ * `"model": { "name": "gemini-3.5-flash" }`, so both shapes are accepted.
+ * Every read is best-effort: a missing file, malformed JSON, or a non-string
+ * model yields `null` and the caller falls back to `full` — detection must
+ * never error a tool call (REQ-LOWEND-001.A4).
+ *
+ * This module deliberately does NOT import the Gemini installer target: the
+ * MCP read path must not depend on installer code. The paths mirror what that
+ * target documents (Storage.getWorkspaceSettingsPath / getGlobalSettingsPath).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geminiSettingsPaths = geminiSettingsPaths;
+exports.__resetGeminiCache = __resetGeminiCache;
+exports.isGeminiHost = isGeminiHost;
+exports.readGeminiSessionModel = readGeminiSessionModel;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * Gemini CLI's settings files for a workspace, project first (project settings
+ * override global ones, same as Gemini CLI's own precedence).
+ */
+function geminiSettingsPaths(cwd, homedir = os.homedir()) {
+    return [
+        path.join(cwd, '.gemini', 'settings.json'),
+        path.join(homedir, '.gemini', 'settings.json'),
+    ];
+}
+/**
+ * Per-file parse cache keyed on path, invalidated by (mtimeMs, size).
+ * Resolution runs per tool call; one `statSync` per settings file is the whole
+ * cost on the warm path — JSON is re-parsed only when the file actually
+ * changed (REQ-LOWEND-001: "cached with invalidation, never adding
+ * perceptible latency").
+ */
+const cache = new Map();
+/** Test seam — drops the parse cache. */
+function __resetGeminiCache() {
+    cache.clear();
+}
+/** Pull a model id out of a parsed settings object, accepting both shapes. */
+function modelFromSettings(parsed) {
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const model = parsed.model;
+    if (typeof model === 'string' && model)
+        return model;
+    if (model && typeof model === 'object') {
+        const name = model.name;
+        if (typeof name === 'string' && name)
+            return name;
+    }
+    return null;
+}
+/** Read one settings file through the cache. Never throws. */
+function readSettingsModel(filePath) {
+    try {
+        const stat = fs.statSync(filePath);
+        if (!stat.isFile())
+            return null;
+        const hit = cache.get(filePath);
+        if (hit && hit.mtimeMs === stat.mtimeMs && hit.size === stat.size)
+            return hit.model;
+        let model = null;
+        try {
+            model = modelFromSettings(JSON.parse(fs.readFileSync(filePath, 'utf-8')));
+        }
+        catch {
+            model = null; // malformed JSON — degrade silently
+        }
+        cache.set(filePath, { mtimeMs: stat.mtimeMs, size: stat.size, model });
+        return model;
+    }
+    catch {
+        cache.delete(filePath);
+        return null; // ENOENT, EACCES, a directory in the way — all just "unknown"
+    }
+}
+/**
+ * Host gate: the Gemini leg may only run inside a server that Gemini CLI
+ * launched. The Gemini installer target stamps `SPECSHIP_HOST=gemini` into
+ * the `mcpServers.specship` entry (written AND printed snippet), so the env
+ * is present exactly in Gemini-launched server processes. Without this gate
+ * a **Claude Code** session in a repo that happens to contain
+ * `.gemini/settings.json` (or a shell exporting `GEMINI_MODEL`) would be
+ * silently compacted during the first-prompt window before the Claude marker
+ * exists — the exact crossover REQ-MODCTX-001.A6 closes on the Claude side.
+ */
+function isGeminiHost(env = process.env) {
+    return env.SPECSHIP_HOST === 'gemini';
+}
+/**
+ * Resolve the Gemini CLI session's model id, or null when nothing names one
+ * (REQ-LOWEND-001). Host-gated: returns null outright unless
+ * `SPECSHIP_HOST=gemini` (see `isGeminiHost`). Then env first, then project
+ * settings, then global settings — first hit wins. The returned id is
+ * verbatim; mapping it to a tier is `modelTier`'s job.
+ */
+function readGeminiSessionModel(cwd, env = process.env, homedir = os.homedir()) {
+    if (!isGeminiHost(env))
+        return null;
+    const fromEnv = env.GEMINI_MODEL;
+    if (typeof fromEnv === 'string' && fromEnv.trim())
+        return fromEnv;
+    for (const p of geminiSettingsPaths(cwd, homedir)) {
+        const model = readSettingsModel(p);
+        if (model)
+            return model;
+    }
+    return null;
+}
+//# sourceMappingURL=gemini-session.js.map

package/lib/dist/mcp/gemini-session.js.map

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

package/lib/dist/mcp/health-tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP tool: specship_health (REQ-SURF-007).
+ *
+ * One code-health door. Folds the former `specship_maintainability`
+ * (MAINT-DOC) and `specship_fitness` (FITNESS-DOC) tools into a single surface
+ * with a `checks` filter — two tools answering "is this codebase healthy?" made
+ * the agent pick between them, and it under-picked both. The two renderers stay
+ * where they are; this composes them.
+ *
+ * Config is untouched: both reports still read `specship.config.json`
+ * (`maintainability.thresholds`, `fitness.rules`), and the CLI enforce/check
+ * paths call the library directly, not this tool.
+ */
+import type { SpecShip } from '../index';
+import type { ToolDefinition, ToolResult } from './tools';
+export declare const HEALTH_CHECKS: readonly ["maintainability", "fitness"];
+export type HealthCheck = (typeof HEALTH_CHECKS)[number];
+export declare const healthToolDefinitions: ToolDefinition[];
+/**
+ * Normalize the `checks` filter. Anything unrecognized (or absent) falls back
+ * to both reports — a filter typo must not silently return an empty health
+ * report.
+ */
+export declare function resolveHealthChecks(raw: unknown): HealthCheck[];
+export declare function handleSpecshipHealth(cg: SpecShip, args: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=health-tool.d.ts.map

package/lib/dist/mcp/health-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-tool.d.ts","sourceRoot":"","sources":["../../src/mcp/health-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1D,eAAO,MAAM,aAAa,yCAA0C,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAoBjD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,EAAE,CAM/D;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/lib/dist/mcp/health-tool.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healthToolDefinitions = exports.HEALTH_CHECKS = void 0;
+exports.resolveHealthChecks = resolveHealthChecks;
+exports.handleSpecshipHealth = handleSpecshipHealth;
+const maintainability_tool_1 = require("./maintainability-tool");
+const fitness_tool_1 = require("./fitness-tool");
+exports.HEALTH_CHECKS = ['maintainability', 'fitness'];
+exports.healthToolDefinitions = [
+    {
+        name: 'specship_health',
+        description: 'Report code health from the graph: maintainability signals (coupling hotspots by fan-in/out, oversized symbols + god-files, dependency cycles, dead-code candidates) and architecture-fitness violations (forbidden dependencies, layering allow-lists, module isolation) with file:line. Deterministic, no new parse. Returns both by default; pass `checks` to narrow. Thresholds and rules come from specship.config.json (maintainability.thresholds, fitness.rules).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                checks: {
+                    type: 'array',
+                    description: 'Which reports to include: "maintainability", "fitness". Omit for both.',
+                    items: { type: 'string' },
+                },
+                projectPath: {
+                    type: 'string',
+                    description: 'Path to a different project with .specship/ initialized. Omit for the current project.',
+                },
+            },
+        },
+    },
+];
+/**
+ * Normalize the `checks` filter. Anything unrecognized (or absent) falls back
+ * to both reports — a filter typo must not silently return an empty health
+ * report.
+ */
+function resolveHealthChecks(raw) {
+    const requested = Array.isArray(raw) ? raw : typeof raw === 'string' ? [raw] : [];
+    const picked = exports.HEALTH_CHECKS.filter((c) => requested.some((r) => typeof r === 'string' && r.trim().toLowerCase() === c));
+    return picked.length > 0 ? picked : [...exports.HEALTH_CHECKS];
+}
+async function handleSpecshipHealth(cg, args) {
+    const checks = resolveHealthChecks(args.checks);
+    const sections = [];
+    for (const check of checks) {
+        const r = check === 'maintainability'
+            ? await (0, maintainability_tool_1.handleSpecshipMaintainability)(cg, args)
+            : await (0, fitness_tool_1.handleSpecshipFitness)(cg, args);
+        sections.push(r.content.map((c) => c.text).join('\n'));
+    }
+    return { content: [{ type: 'text', text: sections.join('\n\n') }] };
+}
+//# sourceMappingURL=health-tool.js.map

package/lib/dist/mcp/health-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-tool.js","sourceRoot":"","sources":["../../src/mcp/health-tool.ts"],"names":[],"mappings":";;;AAgDA,kDAMC;AAED,oDAcC;AAvDD,iEAAuE;AACvE,iDAAuD;AAE1C,QAAA,aAAa,GAAG,CAAC,iBAAiB,EAAE,SAAS,CAAU,CAAC;AAGxD,QAAA,qBAAqB,GAAqB;IACrD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,2cAA2c;QAC7c,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,wEAAwE;oBACrF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wFAAwF;iBACtG;aACF;SACF;KACF;CACF,CAAC;AAEF;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,GAAY;IAC9C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,MAAM,GAAG,qBAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACxC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAC7E,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,qBAAa,CAAC,CAAC;AACzD,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,EAAY,EACZ,IAA6B;IAE7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GACL,KAAK,KAAK,iBAAiB;YACzB,CAAC,CAAC,MAAM,IAAA,oDAA6B,EAAC,EAAE,EAAE,IAAI,CAAC;YAC/C,CAAC,CAAC,MAAM,IAAA,oCAAqB,EAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AACtE,CAAC"}