homegraph 1.5.10 → 1.6.0

package/dist/mcp/session.js

@@ -54,6 +54,7 @@ const tools_1 = require("./tools");
 const server_instructions_1 = require("./server-instructions");
 const version_1 = require("./version");
 const directory_1 = require("../directory");
+const runtime_log_1 = require("../runtime-log");
 const update_check_1 = require("../upgrade/update-check");
 const explore_session_state_1 = require("./explore-session-state");
 /**
@@ -249,6 +250,10 @@ class MCPSession {
             serverInfo: exports.SERVER_INFO,
             instructions: initializeInstructions(indexed ? server_instructions_1.SERVER_INSTRUCTIONS : server_instructions_1.SERVER_INSTRUCTIONS_NO_ROOT_INDEX),
         });
+        (0, runtime_log_1.logLifecycle)('mcp.initialize', {
+            projectRoot: explicitPath ?? undefined,
+            indexed,
+        });
         if (explicitPath) {
             // Kick off engine init in the background. If another session in the
             // same daemon already opened the project, `ensureInitialized` is a
@@ -317,6 +322,16 @@ class MCPSession {
         }
         if (this.engine.hasDefaultHomeGraph())
             return;
+        // Spec 0049: empty-root defer — re-probe and start auto-init as soon as
+        // sources appear (do not wait for the next timer tick).
+        if (this.engine.isAutoInitDeferred()) {
+            try {
+                await this.engine.kickDeferredAutoInit();
+            }
+            catch { /* fall through */ }
+            if (this.engine.hasDefaultHomeGraph())
+                return;
+        }
         const hint = this.explicitProjectPath ?? this.engine.getProjectPath();
         if (!hint && !this.rootsAttempted) {
             this.rootsAttempted = true;

package/dist/mcp/tools.d.ts

@@ -119,6 +119,32 @@ export declare function tightenExploreBudgetForQuery(budget: ExploreOutputBudget
  * Set `HOMEGRAPH_EXPLORE_FULL_SOURCE=1` to restore the previous fatter Source.
  */
 export declare function exploreLocatorDigestEnabled(): boolean;
+/**
+ * Spec 0039 — short Registration sources table from indexed Harmony profile routes.
+ * Returns null when nothing to show.
+ */
+export declare function formatHarmonyRegistrationSources(cg: Pick<HomeGraph, 'getNodesByKind'>, maxRows?: number): string | null;
+/**
+ * Spec 0041 / 0048 §3 — short Resource hits table for element/string.json constants.
+ * Spec 0048: append up to 2 in-repo `.ets` binding anchors when signature/docstring
+ * mention `app.string.<key>`.
+ */
+export declare function formatHarmonyResourceHits(cg: Pick<HomeGraph, 'getNodesByKind' | 'getProjectRoot' | 'getFiles'>, query: string, maxRows?: number): string | null;
+/**
+ * Spec 0048 §1–2 — Capability profiles table, or form negative evidence.
+ */
+export declare function formatHarmonyCapabilityProfiles(cg: Pick<HomeGraph, 'getNodesByKind'>, query: string, maxRows?: number): string | null;
+/** Spec 0048 §5 — detect empty / log-only method bodies. */
+export declare function isHarmonyStubBody(source: string): boolean;
+/**
+ * Spec 0048 §5 — seam notes for located explore anchors.
+ */
+export declare function formatHarmonySeamNotes(cg: Pick<HomeGraph, 'getNodesByKind' | 'getNode'>, projectRoot: string, located: Array<{
+    id?: string;
+    name: string;
+    filePath: string;
+    startLine: number;
+}>, maxAnchors?: number): string | null;
 /**
  * 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.
@@ -256,6 +282,7 @@ export declare class ToolHandler {
     private cg;
     private projectCache;
     private defaultProjectHint;
+    private boundProjectPathPinNotice;
     private worktreeMismatchCache;
     private catchUpGate;
     private queryPool;
@@ -342,6 +369,11 @@ export declare class ToolHandler {
      *
      * Walks up parent directories to find the nearest .homegraph/ folder,
      * similar to how git finds .git/ directories.
+     *
+     * Spec 0043: when a default project is already bound, a `projectPath` whose
+     * resolved index root differs from that bound root is soft-pinned back to
+     * the default (no DB switch) and a success-shaped English notice is stashed
+     * for the reply preamble.
      */
     private getHomeGraph;
     /**
@@ -419,8 +451,9 @@ export declare class ToolHandler {
     private isFileStaleOnDisk;
     private withStalenessNotice;
     /**
-     * Append a one-line product index status footer (Spec 0035).
-     * Guidance-only replies that already start with `HomeGraph status=` are left alone.
+     * Decorate successful tool text (Spec 0035 status footer + Spec 0038 project-root hint
+     * + Spec 0043 bound projectPath pin notice).
+     * Prepends absolute project root + join guidance when known; appends status when missing.
      */
     private withProductStatusFooter;
     /**
@@ -430,6 +463,9 @@ export declare class ToolHandler {
      * it (the CLI does) and explore behaves exactly as before, untracked.
      */
     execute(toolName: string, args: Record<string, unknown>, sessionState?: ExploreSessionState): Promise<ToolResult>;
+    /** Spec 0046: HOMEGRAPH_DEBUG tool summary → stderr + daemon.log. */
+    private traceToolCall;
+    private executeCore;
     /**
      * Attach the caller's session view to an explore call's args (CG-17), on a
      * COPY so the caller's object is never mutated. Nothing else sees it: a
@@ -779,6 +815,17 @@ export declare class ToolHandler {
     private handleExplore;
     /** Render literal witnesses before graph-heavy sections, including unindexed UI. */
     private renderLiteralSource;
+    /**
+     * Spec 0039: when the query names Harmony route profiles, lead with a short
+     * Registration sources table so agents see JSON was indexed (avoid re-Read).
+     */
+    private prependHarmonyRegistrationSources;
+    /** Spec 0041: lead with Resource hits when string.json is named or matched. */
+    private prependHarmonyResourceHits;
+    /** Spec 0048 §1–2: Capability profiles or form negative evidence. */
+    private prependHarmonyCapabilityProfiles;
+    /** Spec 0048 §5: seam notes for located anchors. */
+    private prependHarmonySeamNotes;
     /**
      * An explore response plus the record of what it emitted (CG-17). The record
      * rides the result only as far as {@link execute}, which files it into the