@specship/specship-win32-arm64 0.24.0 → 0.28.0

package/lib/dist/mcp/tools.d.ts

@@ -111,7 +111,36 @@ export declare const MAX_PINNED_FILES = 4;
  * query order (earliest-named pins first) and are capped.
  */
 export declare function resolveNamedFilePaths(tokens: readonly string[], filePaths: readonly string[], cap?: number): string[];
-export declare function getExploreOutputBudget(fileCount: number): ExploreOutputBudget;
+/**
+ * Lite-tier overlay on a size-tier budget (REQ-LOWEND-004).
+ *
+ * A low-end model abandons a tool chain the instant an answer looks partial,
+ * so it needs the top cluster COMPLETE far more than it needs a wide survey.
+ * The overlay therefore concentrates the tier's existing budget rather than
+ * enlarging it: `maxOutputChars` is untouched (it is the ~24K inline
+ * tool-result ceiling — exceeding it makes the host externalize the payload
+ * to a file the agent Reads back, re-introducing the very read this exists to
+ * prevent), while `maxCharsPerFile` rises and `defaultMaxFiles` falls so the
+ * same bytes land as fuller bodies on fewer files. `maxCharsPerFile` is a
+ * `max()` and `defaultMaxFiles` a `min()`, so the overlay can never shrink a
+ * body below what its size tier already returns (the monotonicity invariant
+ * in `src/mcp/CLAUDE.md`).
+ *
+ * The meta-text flags are the INVERSE of the small-repo tiers, hence explicit
+ * overrides rather than reuse: the trailing lists (additional files, budget
+ * note) are breadth pointers a lite model won't productively follow, but the
+ * completeness signal — "this source is complete, do NOT re-read" — is the one
+ * line that stops the Read fallback, so it is always on regardless of size.
+ */
+export declare function applyLiteExploreBudget(base: ExploreOutputBudget): ExploreOutputBudget;
+/**
+ * Output budget for one `specship_explore` call: the project-size tier,
+ * optionally overlaid by the session's model tier.
+ *
+ * `tier` defaults to `full`, and `standard` is a pass-through, so full- and
+ * standard-tier output stays byte-identical to today (REQ-LOWEND-004.A3).
+ */
+export declare function getExploreOutputBudget(fileCount: number, tier?: ModelTier): ExploreOutputBudget;
 /**
  * Per-file staleness banner emitted at the top of a tool response when the
  * file watcher has pending events for files referenced by the response.
@@ -171,13 +200,16 @@ export declare function integrationEnabled(name: IntegrationName, env?: NodeJS.P
 export declare function toolIntegration(toolName: string): IntegrationName | null;
 /** Drop tools whose integration isn't enabled (REQ-INTEG-001.A1/A2). */
 export declare function filterIntegrationTools(list: ToolDefinition[], env?: NodeJS.ProcessEnv): ToolDefinition[];
+export declare function applyLiteTierTrim(list: ToolDefinition[], hint: string | null): ToolDefinition[];
 /**
  * Allowlist-filtered tool definitions WITHOUT an engine — the static surface the
  * proxy answers `tools/list` with before any project is open. Mirrors
  * `ToolHandler.getTools()` in the no-SpecShip case (the dynamic per-repo budget
  * note in a description only adds once `cg` is loaded; the schemas are static).
+ * When a project-root hint is given, the lite-tier trim applies here too
+ * (REQ-LOWMODEL-004.A4) — the marker file needs no DB open.
  */
-export declare function getStaticTools(): ToolDefinition[];
+export declare function getStaticTools(projectRootHint?: string | null): ToolDefinition[];
 /**
  * Tool handler that executes tools against a SpecShip instance
  *
@@ -223,6 +255,13 @@ export declare class ToolHandler {
     private toolAllowlist;
     /** Whether a tool name passes the SPECSHIP_MCP_TOOLS allowlist (if any). */
     private isToolAllowed;
+    /**
+     * Whether the default project has at least one indexed spec. One
+     * `LIMIT 1` probe on the `specs` primary key — cheap enough for every
+     * ListTools call. Any failure (pre-spec schema, closed DB) reads as "no
+     * specs", which keeps the tiny-repo list unchanged.
+     */
+    private hasIndexedSpecs;
     /**
      * Get tool definitions with dynamic descriptions based on project size.
      * The specship_explore tool description includes a budget recommendation
@@ -294,11 +333,11 @@ export declare class ToolHandler {
     /**
      * Model-aware compaction (MODCTX-DOC, REQ-MODCTX-002/003). Resolves the
      * session's model tier (status-line marker / SPECSHIP_MODEL; SPECSHIP_COMPACT=0
-     * disables) and, on haiku/sonnet, compresses the response's prose
+     * disables) and, on the lite/standard tiers, compresses the response's prose
      * scaffolding — fenced code stays byte-verbatim. Full tier is identity.
      */
     /**
-     * Tier-change listeners (LOWMODEL-DOC, REQ-LOWMODEL-004.A3): the haiku
+     * Tier-change listeners (LOWMODEL-DOC, REQ-LOWMODEL-004.A3): the lite-tier
      * menu trim changes `tools/list`, so a mid-session /model switch must ride
      * an MCP `notifications/tools/list_changed`. Sessions subscribe here; the
      * change is detected on the next code-graph call (the same funnel that
@@ -450,12 +489,13 @@ export declare class ToolHandler {
      */
     private formatTrail;
     /**
-     * Handle specship_version (REQ-MCPVER-001). Identifies the running MCP
-     * server process — the version an agent's tools are being served by,
-     * how it was installed, node version, and (if bound) the project root.
-     * Zero-arg, synchronous, never touches the DB, safe with no project.
+     * Server identity (REQ-MCPVER-001, folded into specship_status by
+     * REQ-SURF-006). Identifies the running MCP server process — the version an
+     * agent's tools are being served by, how it was installed, node version, and
+     * (if bound) the project root. Synchronous, never touches the DB, safe with
+     * no project open.
      */
-    private handleVersion;
+    private identityBlock;
     /**
      * Handle specship_status
      */

package/lib/dist/mcp/tools.d.ts.map

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

package/lib/dist/mcp/tools.js

@@ -9,12 +9,14 @@ exports.ToolHandler = exports.tools = exports.MAX_PINNED_FILES = exports.SEEDABL
 exports.getExploreBudget = getExploreBudget;
 exports.extractNamedTokens = extractNamedTokens;
 exports.resolveNamedFilePaths = resolveNamedFilePaths;
+exports.applyLiteExploreBudget = applyLiteExploreBudget;
 exports.getExploreOutputBudget = getExploreOutputBudget;
 exports.formatStaleBanner = formatStaleBanner;
 exports.formatStaleFooter = formatStaleFooter;
 exports.integrationEnabled = integrationEnabled;
 exports.toolIntegration = toolIntegration;
 exports.filterIntegrationTools = filterIntegrationTools;
+exports.applyLiteTierTrim = applyLiteTierTrim;
 exports.getStaticTools = getStaticTools;
 const directory_1 = require("../directory");
 const statusline_1 = require("../statusline");
@@ -212,7 +214,66 @@ function resolveNamedFilePaths(tokens, filePaths, cap = exports.MAX_PINNED_FILES
     }
     return out;
 }
-function getExploreOutputBudget(fileCount) {
+/** Breadth ceiling on the lite tier — depth over breadth (REQ-LOWEND-004). */
+const LITE_MAX_FILES = 3;
+/**
+ * Floor on the lite tier's per-file body cap. Sized so the top-ranked file's
+ * relevant clusters come back whole (~200 lines) instead of tail-trimmed,
+ * which is what sends a low-end model to Read (REQ-LOWEND-004.A1).
+ */
+const LITE_MIN_CHARS_PER_FILE = 8000;
+/**
+ * Lite-tier overlay on a size-tier budget (REQ-LOWEND-004).
+ *
+ * A low-end model abandons a tool chain the instant an answer looks partial,
+ * so it needs the top cluster COMPLETE far more than it needs a wide survey.
+ * The overlay therefore concentrates the tier's existing budget rather than
+ * enlarging it: `maxOutputChars` is untouched (it is the ~24K inline
+ * tool-result ceiling — exceeding it makes the host externalize the payload
+ * to a file the agent Reads back, re-introducing the very read this exists to
+ * prevent), while `maxCharsPerFile` rises and `defaultMaxFiles` falls so the
+ * same bytes land as fuller bodies on fewer files. `maxCharsPerFile` is a
+ * `max()` and `defaultMaxFiles` a `min()`, so the overlay can never shrink a
+ * body below what its size tier already returns (the monotonicity invariant
+ * in `src/mcp/CLAUDE.md`).
+ *
+ * The meta-text flags are the INVERSE of the small-repo tiers, hence explicit
+ * overrides rather than reuse: the trailing lists (additional files, budget
+ * note) are breadth pointers a lite model won't productively follow, but the
+ * completeness signal — "this source is complete, do NOT re-read" — is the one
+ * line that stops the Read fallback, so it is always on regardless of size.
+ */
+function applyLiteExploreBudget(base) {
+    return {
+        ...base,
+        // Breadth down, depth up — same byte ceiling, concentrated.
+        defaultMaxFiles: Math.max(1, Math.min(base.defaultMaxFiles, LITE_MAX_FILES)),
+        maxCharsPerFile: Math.max(base.maxCharsPerFile, LITE_MIN_CHARS_PER_FILE),
+        maxOutputChars: base.maxOutputChars,
+        gapThreshold: base.gapThreshold,
+        // Breadth pointers off, stop-reading signal on. Relationships stay AT
+        // THE BASE VALUE: the section is the cheapest structural signal (see the
+        // explore doctrine test) and is not one of the trailing meta-sections
+        // REQ-LOWEND-004.A2 suppresses.
+        includeRelationships: base.includeRelationships,
+        includeAdditionalFiles: false,
+        includeBudgetNote: false,
+        includeCompletenessSignal: true,
+        excludeLowValueFiles: true,
+    };
+}
+/**
+ * Output budget for one `specship_explore` call: the project-size tier,
+ * optionally overlaid by the session's model tier.
+ *
+ * `tier` defaults to `full`, and `standard` is a pass-through, so full- and
+ * standard-tier output stays byte-identical to today (REQ-LOWEND-004.A3).
+ */
+function getExploreOutputBudget(fileCount, tier = 'full') {
+    const base = baseExploreOutputBudget(fileCount);
+    return tier === 'lite' ? applyLiteExploreBudget(base) : base;
+}
+function baseExploreOutputBudget(fileCount) {
     // Tiered budget, scaled to project size. The budget is a CEILING (relevance
     // still gates WHAT is included), and it MUST stay under the agent's INLINE
     // tool-result cap (~25K chars). Above that, the host externalizes the result
@@ -411,6 +472,7 @@ const projectPathProperty = {
 const spec_tools_1 = require("./spec-tools");
 const maintainability_tool_1 = require("./maintainability-tool");
 const fitness_tool_1 = require("./fitness-tool");
+const health_tool_1 = require("./health-tool");
 const designer_tools_1 = require("./designer-tools");
 const jira_tools_1 = require("./jira-tools");
 exports.tools = [
@@ -549,7 +611,7 @@ exports.tools = [
     },
     {
         name: 'specship_status',
-        description: 'Index health check (files / nodes / edges). Skip unless debugging.',
+        description: 'Index health check (files / nodes / edges) AND server identity — package version, install method (bundle/npm/unknown), the install serving this session, and node version. Works with no project open (identity only). Skip unless debugging or asked which SpecShip is running.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -557,14 +619,6 @@ exports.tools = [
             },
         },
     },
-    {
-        name: 'specship_version',
-        description: 'Identify the running SpecShip MCP server: package version, install method (bundle/npm/unknown), install dir, node version, and project root (if bound). Zero-arg, no index required — safe to call before any project is open.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
     {
         name: 'specship_files',
         description: 'Indexed file tree with language + symbol counts. Faster than Glob for project layout.',
@@ -600,8 +654,10 @@ exports.tools = [
     },
     // Spec-layer tools (v5): see ./spec-tools.ts for handlers.
     ...spec_tools_1.specToolDefinitions,
-    ...maintainability_tool_1.maintainabilityToolDefinitions,
-    ...fitness_tool_1.fitnessToolDefinitions,
+    // Code health: one tool for maintainability + architecture fitness
+    // (REQ-SURF-007). The two former tools still execute for clients holding a
+    // cached list, but they are off the menu.
+    ...health_tool_1.healthToolDefinitions,
     // Designer tools: claude.ai/design driving, vendored from @pro-vi/designer.
     // See ./designer-tools.ts for handlers. Drives a debug Chrome over CDP.
     ...designer_tools_1.designerToolDefinitions,
@@ -629,19 +685,62 @@ function filterIntegrationTools(list, env = process.env) {
         return integ === null || integrationEnabled(integ, env);
     });
 }
+/**
+ * Lite-tier menu trim (LOWMODEL-DOC, REQ-LOWMODEL-004): small-model tool
+ * choice degrades with menu size, so the code-graph group trims to the core
+ * three; spec/link tools and enabled integrations are untouched. Composes
+ * with the tiny-repo gate and SPECSHIP_MCP_TOOLS as an intersection.
+ * Schemas never vary — only the list; `execute()` still answers a
+ * trimmed-away tool for clients that cached the full list (A2).
+ *
+ * Needs only a project-root hint, NOT an open DB — tier detection reads the
+ * session model marker file. That is what lets the proxy's connect-time
+ * static list trim too (A4); `hint` may be any path at or under the project
+ * (the nearest `.specship/` root wins).
+ */
+const LITE_CORE_TOOLS = new Set(['specship_explore', 'specship_search', 'specship_node']);
+// `specship_status` is deliberately NOT in this group (REQ-SURF-006.A2): it
+// carries the server-identity answer, so the lite tier must keep it.
+const CODE_GRAPH_GROUP = new Set([
+    'specship_explore', 'specship_search', 'specship_node',
+    'specship_callers', 'specship_callees', 'specship_impact',
+    'specship_files',
+    'specship_health',
+]);
+/**
+ * Spec-layer tools that survive the tiny-repo trim when the project has ≥1
+ * indexed spec (REQ-AUDFIX-009). `specship_jira_*` tools join them by prefix,
+ * but only when the JIRA integration is enabled.
+ */
+const SPEC_LAYER_TOOLS = new Set([
+    'specship_spec', 'specship_link_assert', 'specship_link_verify', 'specship_drifted',
+]);
+function applyLiteTierTrim(list, hint) {
+    if (!hint)
+        return list;
+    const root = (0, directory_1.findNearestSpecShipRoot)(hint);
+    if (!root || (0, model_context_1.detectModelTier)(root) !== 'lite')
+        return list;
+    return list.filter(t => !CODE_GRAPH_GROUP.has(t.name) || LITE_CORE_TOOLS.has(t.name));
+}
 /**
  * Allowlist-filtered tool definitions WITHOUT an engine — the static surface the
  * proxy answers `tools/list` with before any project is open. Mirrors
  * `ToolHandler.getTools()` in the no-SpecShip case (the dynamic per-repo budget
  * note in a description only adds once `cg` is loaded; the schemas are static).
+ * When a project-root hint is given, the lite-tier trim applies here too
+ * (REQ-LOWMODEL-004.A4) — the marker file needs no DB open.
  */
-function getStaticTools() {
+function getStaticTools(projectRootHint) {
     const base = filterIntegrationTools(exports.tools);
     const raw = process.env.SPECSHIP_MCP_TOOLS;
-    if (!raw || !raw.trim())
-        return base;
-    const allow = new Set(raw.split(',').map(s => s.trim().replace(/^specship_/, '')).filter(Boolean));
-    return allow.size ? base.filter(t => allow.has(t.name.replace(/^specship_/, ''))) : base;
+    let visible = base;
+    if (raw && raw.trim()) {
+        const allow = new Set(raw.split(',').map(s => s.trim().replace(/^specship_/, '')).filter(Boolean));
+        if (allow.size)
+            visible = base.filter(t => allow.has(t.name.replace(/^specship_/, '')));
+    }
+    return applyLiteTierTrim(visible, projectRootHint ?? null);
 }
 /**
  * Tool handler that executes tools against a SpecShip instance
@@ -726,6 +825,23 @@ class ToolHandler {
         const allow = this.toolAllowlist();
         return !allow || allow.has(name.replace(/^specship_/, ''));
     }
+    /**
+     * Whether the default project has at least one indexed spec. One
+     * `LIMIT 1` probe on the `specs` primary key — cheap enough for every
+     * ListTools call. Any failure (pre-spec schema, closed DB) reads as "no
+     * specs", which keeps the tiny-repo list unchanged.
+     */
+    hasIndexedSpecs() {
+        if (!this.cg)
+            return false;
+        try {
+            return this.cg.getSpecQueries().getRawDb()
+                .prepare('SELECT 1 FROM specs LIMIT 1').get() != null;
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * Get tool definitions with dynamic descriptions based on project size.
      * The specship_explore tool description includes a budget recommendation
@@ -772,29 +888,25 @@ class ToolHandler {
                 'specship_explore',
                 'specship_search',
                 'specship_node',
-                'specship_version',
+                // Identity probe — folded into status (REQ-SURF-006), which therefore
+                // survives the tiny-repo trim the way specship_version used to.
+                'specship_status',
             ]);
             if (stats.fileCount < TINY_REPO_FILE_THRESHOLD) {
                 // Designer tools are not code-graph tools — the tiny-repo flow-question
                 // economics that justify trimming don't apply, so they always survive.
-                visible = visible.filter(t => TINY_REPO_CORE_TOOLS.has(t.name) || t.name.startsWith('designer_'));
-            }
-            // Haiku-tier menu trim (LOWMODEL-DOC, REQ-LOWMODEL-004): small-model
-            // tool choice degrades with menu size, so the code-graph group trims
-            // to the core three; spec/link tools and enabled integrations are
-            // untouched. Composes with the tiny-repo gate as an intersection.
-            // Schemas never vary — only the list; `execute()` still answers a
-            // trimmed-away tool for clients that cached the full list (A2).
-            if ((0, model_context_1.detectModelTier)(this.cg.getProjectRoot()) === 'haiku') {
-                const HAIKU_CORE = new Set(['specship_explore', 'specship_search', 'specship_node']);
-                const CODE_GRAPH_GROUP = new Set([
-                    'specship_explore', 'specship_search', 'specship_node',
-                    'specship_callers', 'specship_callees', 'specship_impact',
-                    'specship_files', 'specship_status',
-                    'specship_maintainability', 'specship_fitness',
-                ]);
-                visible = visible.filter(t => !CODE_GRAPH_GROUP.has(t.name) || HAIKU_CORE.has(t.name));
-            }
+                // Neither is the spec layer: when the project has ≥1 indexed spec, the
+                // spec/link/drift tools (and JIRA tools, only if already enabled —
+                // `visible` is post-integration-filter) survive too (REQ-AUDFIX-009).
+                // With no specs the list is exactly today's trim (A2).
+                const keepSpecLayer = this.hasIndexedSpecs();
+                visible = visible.filter(t => TINY_REPO_CORE_TOOLS.has(t.name)
+                    || t.name.startsWith('designer_')
+                    || (keepSpecLayer && (SPEC_LAYER_TOOLS.has(t.name) || t.name.startsWith('specship_jira_'))));
+            }
+            // Lite-tier menu trim — shared with the proxy's static list (A4);
+            // see applyLiteTierTrim above for the full contract.
+            visible = applyLiteTierTrim(visible, this.cg.getProjectRoot());
             return visible.map(tool => {
                 if (tool.name === 'specship_explore') {
                     return {
@@ -982,11 +1094,11 @@ class ToolHandler {
     /**
      * Model-aware compaction (MODCTX-DOC, REQ-MODCTX-002/003). Resolves the
      * session's model tier (status-line marker / SPECSHIP_MODEL; SPECSHIP_COMPACT=0
-     * disables) and, on haiku/sonnet, compresses the response's prose
+     * disables) and, on the lite/standard tiers, compresses the response's prose
      * scaffolding — fenced code stays byte-verbatim. Full tier is identity.
      */
     /**
-     * Tier-change listeners (LOWMODEL-DOC, REQ-LOWMODEL-004.A3): the haiku
+     * Tier-change listeners (LOWMODEL-DOC, REQ-LOWMODEL-004.A3): the lite-tier
      * menu trim changes `tools/list`, so a mid-session /model switch must ride
      * an MCP `notifications/tools/list_changed`. Sessions subscribe here; the
      * change is detected on the next code-graph call (the same funnel that
@@ -1166,11 +1278,13 @@ class ToolHandler {
             // its own verbose worktree warning but still flows through the
             // staleness wrapper so its pending-files section stays consistent
             // with what the read tools surface.
-            // specship_version (REQ-MCPVER-001): zero-arg identity probe. Answered
-            // before the worktree/staleness/compaction wrappers so it works with no
-            // project open and never touches the DB.
+            // specship_version (REQ-MCPVER-001): zero-arg identity probe, folded into
+            // specship_status (REQ-SURF-006) and off the menu. Still answered here for
+            // clients holding a cached tool list. Runs before the
+            // worktree/staleness/compaction wrappers so it works with no project open
+            // and never touches the DB.
             if (toolName === 'specship_version') {
-                return this.handleVersion();
+                return this.textResult(this.identityBlock());
             }
             let result;
             switch (toolName) {
@@ -1212,6 +1326,11 @@ class ToolHandler {
                 case 'specship_drifted':
                     result = await (0, spec_tools_1.handleSpecshipDrifted)(this.getSpecShip(args.projectPath), args);
                     break;
+                case 'specship_health':
+                    result = await (0, health_tool_1.handleSpecshipHealth)(this.getSpecShip(args.projectPath), args);
+                    break;
+                // Folded into specship_health (REQ-SURF-007) and off the menu; still
+                // answered for clients holding a cached tool list.
                 case 'specship_maintainability':
                     result = await (0, maintainability_tool_1.handleSpecshipMaintainability)(this.getSpecShip(args.projectPath), args);
                     break;
@@ -1336,7 +1455,7 @@ class ToolHandler {
             }
             const withWorktree = this.withWorktreeNotice(result, args.projectPath);
             const withStaleness = this.withStalenessNotice(withWorktree, args.projectPath);
-            // Model-aware compaction (MODCTX-DOC): on haiku/sonnet sessions the
+            // Model-aware compaction (MODCTX-DOC): on lite/standard sessions the
             // prose scaffolding compresses; code stays byte-verbatim. Only the
             // code-graph tools reach this funnel — designer/jira returned above
             // (REQ-MODCTX-004).
@@ -1765,7 +1884,7 @@ class ToolHandler {
                 out.push('## Flow (call path among the symbols you queried)', '');
                 for (let i = 0; i < best.length; i++) {
                     const step = best[i];
-                    if (tier === 'haiku') {
+                    if (tier === 'lite') {
                         // LOWMODEL-DOC REQ-LOWMODEL-003: small models don't synthesize
                         // the flow from evidence — render each hop as ONE explicit line
                         // with its mechanism inline. Additive formatting only; the code
@@ -2046,17 +2165,28 @@ class ToolHandler {
             return query;
         const cg = this.getSpecShip(args.projectPath);
         const projectRoot = cg.getProjectRoot();
-        // Resolve adaptive output budget from project size. Falls back to the
+        // Resolve the session's model tier ONCE and reuse it for both the output
+        // budget and the flow spine below — detection is a couple of cheap file
+        // reads, but calling it twice would add latency for nothing
+        // (REQ-LOWEND-004.A4).
+        const modelTier = (0, model_context_1.detectModelTier)(projectRoot);
+        // Resolve adaptive output budget from project size, overlaid by the model
+        // tier (lite trades breadth for depth — REQ-LOWEND-004). Falls back to the
         // largest-tier defaults if stats aren't available, which preserves
         // pre-#185 behavior for callers that hit the rare stats failure.
         let budget;
         try {
-            budget = getExploreOutputBudget(cg.getStats().fileCount);
+            budget = getExploreOutputBudget(cg.getStats().fileCount, modelTier);
         }
         catch {
-            budget = getExploreOutputBudget(Infinity);
-        }
-        const maxFiles = (0, utils_1.clamp)(args.maxFiles || budget.defaultMaxFiles, 1, 20);
+            budget = getExploreOutputBudget(Infinity, modelTier);
+        }
+        // On lite tier a caller-supplied maxFiles may narrow but never widen the
+        // overlay's breadth cut — otherwise the schema's advertised default (12)
+        // hands the weakest model MORE output than full tier gets, inverting
+        // REQ-LOWEND-004 (adversarial-review finding).
+        const maxFilesCeiling = modelTier === 'lite' ? budget.defaultMaxFiles : 20;
+        const maxFiles = (0, utils_1.clamp)(args.maxFiles || budget.defaultMaxFiles, 1, maxFilesCeiling);
         // Step 1: Find relevant context with generous parameters.
         // Use a large maxNodes budget — explore has its own 35k char output limit
         // that prevents context bloat, so more nodes just means better coverage
@@ -2485,7 +2615,7 @@ class ToolHandler {
         // Compute the flow spine once — used both to prepend the Flow section (below)
         // and to gate adaptive source sizing: files on the spine get full source,
         // off-spine peers skeletonize.
-        const flow = this.buildFlowFromNamedSymbols(cg, query, (0, model_context_1.detectModelTier)(cg.getProjectRoot()));
+        const flow = this.buildFlowFromNamedSymbols(cg, query, modelTier);
         // Polymorphic-sibling detector for adaptive sizing. A class that implements/
         // extends a supertype shared by >= MIN_SIBLINGS classes is one of many
         // INTERCHANGEABLE implementations (OkHttp's 14 `: Interceptor` classes —
@@ -3032,7 +3162,15 @@ class ToolHandler {
         if (budget.includeCompletenessSignal) {
             lines.push('');
             lines.push('---');
-            lines.push(`> **Complete source for ${filesIncluded} files is included above — do NOT re-read them.** If your question also needs files/symbols listed under "Not shown above" (or any area this call didn't cover), make ANOTHER specship_explore targeting those names — it returns the same source with line numbers and is cheaper and more complete than reading. Reserve Read for a single specific line range explore can't surface.`);
+            if (budget.includeAdditionalFiles) {
+                lines.push(`> **Complete source for ${filesIncluded} files is included above — do NOT re-read them.** If your question also needs files/symbols listed under "Not shown above" (or any area this call didn't cover), make ANOTHER specship_explore targeting those names — it returns the same source with line numbers and is cheaper and more complete than reading. Reserve Read for a single specific line range explore can't surface.`);
+            }
+            else {
+                // Lite tier keeps the signal but renders no "Not shown above" list
+                // (REQ-LOWEND-004.A2), so the clause pointing at it would name a
+                // section that isn't there. Same one-line shape, no dangling reference.
+                lines.push(`> **Complete source for ${filesIncluded} files is included above — do NOT re-read them.** If your question needs an area this call didn't cover, make ANOTHER specship_explore naming those symbols or files — it returns the same source with line numbers and is cheaper and more complete than reading. Reserve Read for a single specific line range explore can't surface.`);
+            }
         }
         else if (anyFileTrimmed) {
             lines.push('');
@@ -3232,12 +3370,13 @@ class ToolHandler {
         return lines.join('\n');
     }
     /**
-     * Handle specship_version (REQ-MCPVER-001). Identifies the running MCP
-     * server process — the version an agent's tools are being served by,
-     * how it was installed, node version, and (if bound) the project root.
-     * Zero-arg, synchronous, never touches the DB, safe with no project.
+     * Server identity (REQ-MCPVER-001, folded into specship_status by
+     * REQ-SURF-006). Identifies the running MCP server process — the version an
+     * agent's tools are being served by, how it was installed, node version, and
+     * (if bound) the project root. Synchronous, never touches the DB, safe with
+     * no project open.
      */
-    handleVersion() {
+    identityBlock() {
         const binDirname = (0, path_1.dirname)(__filename);
         const installDir = (0, updater_1.resolveInstallDir)();
         const installMethod = (0, updater_1.detectInstallMethod)(binDirname, installDir);
@@ -3265,13 +3404,24 @@ class ToolHandler {
             `**node:** ${process.version}`,
             `**projectRoot:** ${projectRoot ?? 'null'}`,
         ];
-        return this.textResult(lines.join('\n'));
+        return lines.join('\n');
     }
     /**
      * Handle specship_status
      */
     async handleStatus(args) {
-        let cg = this.getSpecShip(args.projectPath);
+        // Server identity leads the response (REQ-SURF-006.A1) and is answerable
+        // with no project open, so a status call on an unindexed directory still
+        // tells the agent which SpecShip is serving it.
+        const identity = this.identityBlock();
+        let cg;
+        try {
+            cg = this.getSpecShip(args.projectPath);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            return this.textResult(`${identity}\n\n## SpecShip Status\n\n${detail}`);
+        }
         // Same trick as withStalenessNotice — when an explicit projectPath
         // resolves to the same project as the default session cg, prefer the
         // default so getPendingFiles() (only populated by the default's watcher)
@@ -3292,6 +3442,8 @@ class ToolHandler {
         // one-liner via withWorktreeNotice. Both share the cached detection.
         const mismatch = this.worktreeMismatchFor(args.projectPath);
         const lines = [
+            identity,
+            '',
             '## SpecShip Status',
             '',
         ];