agent-dir 1.0.0 → 1.1.0

package/dist/bin/agent-dir.js

@@ -5,6 +5,7 @@ import { createRequire } from "node:module";
 import { resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { parseArgs } from "node:util";
+import { CodeGraphIntegration } from "../src/codegraph.js";
 import { configPath, loadConfig, mergeProfile, saveConfig } from "../src/config.js";
 import { printBanner, printHelp, printRequestHeader } from "../src/logging.js";
 import { startServer } from "../src/server.js";
@@ -445,6 +446,10 @@ if (allowedCommands)
 if (commandConfig.blacklistedCommands?.length) {
     bannerOptions.blacklistedCommands = commandConfig.blacklistedCommands;
 }
+const codeGraph = new CodeGraphIntegration(directory);
+const codeGraphCapability = await codeGraph.prepare();
+if (codeGraphCapability.tool)
+    bannerOptions.codeGraph = true;
 printBanner(bannerOptions);
 const telemetrySessionId = randomUUID();
 const server = await startServer({
@@ -452,12 +457,16 @@ const server = await startServer({
     port,
     token,
     commandConfig,
+    codeGraph,
     telemetry: {
         ...(config.telemetry ?? { level: "none" }),
         ...(telemetryConfigId ? { configId: telemetryConfigId } : {}),
         sessionId: telemetrySessionId,
         persist: true,
     },
+}).catch(async (error) => {
+    await codeGraph.close();
+    throw error;
 });
 let tunnelResult;
 console.log("  ✓ SERVER ONLINE");

package/dist/src/codegraph.d.ts

@@ -18,6 +18,7 @@ export declare class CodeGraphIntegration {
     private readonly pending;
     constructor(root: string);
     capability(): Promise<CodeGraphCapability>;
+    prepare(): Promise<CodeGraphCapability>;
     explore(query: string, maxFiles?: number): Promise<Record<string, unknown>>;
     close(): Promise<void>;
     private detect;

package/dist/src/codegraph.js

@@ -27,6 +27,18 @@ export class CodeGraphIntegration {
             this.capabilityPromise = this.detect();
         return this.capabilityPromise;
     }
+    async prepare() {
+        const capability = await this.capability();
+        if (capability.status === "available") {
+            try {
+                await this.ensureStarted();
+            }
+            catch {
+                // Keep Agent Dir startup available even if CodeGraph fails to start.
+            }
+        }
+        return this.capability();
+    }
     async explore(query, maxFiles) {
         const capability = await this.capability();
         if (capability.status === "not_installed")

package/dist/src/logging.d.ts

@@ -11,6 +11,7 @@ export declare function printBanner(options: {
     npmScripts?: string[];
     commands?: string[];
     blacklistedCommands?: string[];
+    codeGraph?: boolean;
 }): void;
 export declare function printRequestLog(entry: RequestLog): void;
 export declare function logRequest(entry: RequestLog): void;

package/dist/src/logging.js

@@ -149,6 +149,9 @@ export function printBanner(options) {
     writeLine(`    ${color(toolLabel("run_npm_batch"), BRIGHT_BLUE)}`);
     writeLine(`    ${color(toolLabel("run_command_batch"), BRIGHT_CYAN)}`);
     writeLine(`    ${color(toolLabel("file_info"), YELLOW)}`);
+    if (options.codeGraph) {
+        writeLine(`    ${color(toolLabel("codegraph_explore"), BRIGHT_MAGENTA)}`);
+    }
     writeLine("");
     if (options.npmScripts?.length) {
         writeLine("  NPM COMMANDS");

package/dist/src/mcp.d.ts

@@ -1,3 +1,4 @@
+import { CodeGraphIntegration } from "./codegraph.js";
 import { TelemetryRecorder } from "./telemetry/recorder.js";
 import type { TelemetryConfig } from "./telemetry/types.js";
 import type { CommandConfig } from "./types.js";
@@ -6,6 +7,6 @@ interface McpHandler {
     closeSubscriptions: () => void;
     telemetrySnapshot: () => ReturnType<TelemetryRecorder["snapshot"]>;
 }
-export declare function createMcpHandler(root: string, commandConfig?: CommandConfig, telemetry?: TelemetryConfig): McpHandler;
+export declare function createMcpHandler(root: string, commandConfig?: CommandConfig, telemetry?: TelemetryConfig, codeGraphIntegration?: CodeGraphIntegration): McpHandler;
 export declare function validateMcpParamHeaders(inputSchema: Record<string, unknown>, args: Record<string, unknown>, headers: Headers): string | undefined;
 export {};

package/dist/src/mcp.js

@@ -162,8 +162,8 @@ function tool(name, description, properties, outputSchema, required = []) {
         outputSchema,
     };
 }
-export function createMcpHandler(root, commandConfig = {}, telemetry = { level: "none" }) {
-    const codeGraph = new CodeGraphIntegration(root);
+export function createMcpHandler(root, commandConfig = {}, telemetry = { level: "none" }, codeGraphIntegration) {
+    const codeGraph = codeGraphIntegration ?? new CodeGraphIntegration(root);
     const telemetryRecorder = new TelemetryRecorder({
         level: telemetry.level,
         persist: telemetry.persist ?? false,

package/dist/src/server.d.ts

@@ -2,7 +2,7 @@ import type { ServerOptions } from "./types.js";
 export interface ServerHandle {
     close: () => Promise<void>;
 }
-export declare function startServer({ root, port, token, commandConfig, telemetry, }: ServerOptions): Promise<ServerHandle>;
+export declare function startServer({ root, port, token, commandConfig, telemetry, codeGraph, }: ServerOptions): Promise<ServerHandle>;
 export declare function validateMcpHeaders(request: Request, message: Record<string, unknown> | null): Response | undefined;
 export declare function getMcpLog(body: Buffer, responseBody?: unknown): {
     name: string;

package/dist/src/server.js

@@ -9,8 +9,8 @@ const REQUEST_TIMEOUT_MS = 120_000;
 const HEADERS_TIMEOUT_MS = 30_000;
 const KEEP_ALIVE_TIMEOUT_MS = 5_000;
 const HEALTH_PATH = "/__health";
-export function startServer({ root, port, token, commandConfig = {}, telemetry = { level: "none" }, }) {
-    const mcp = createMcpHandler(root, commandConfig, telemetry);
+export function startServer({ root, port, token, commandConfig = {}, telemetry = { level: "none" }, codeGraph, }) {
+    const mcp = createMcpHandler(root, commandConfig, telemetry, codeGraph);
     const httpTelemetry = new TelemetryRecorder({
         level: telemetry.level,
         persist: telemetry.persist ?? false,
@@ -138,10 +138,15 @@ export function startServer({ root, port, token, commandConfig = {}, telemetry =
     return new Promise((resolve, reject) => {
         server.once("error", reject);
         server.listen(port, "127.0.0.1", () => resolve({
-            close: () => new Promise((done) => {
+            close: async () => {
                 mcp.closeSubscriptions();
-                server.close(() => done());
-            }),
+                try {
+                    await new Promise((done) => server.close(() => done()));
+                }
+                finally {
+                    await codeGraph?.close();
+                }
+            },
         }));
     });
 }

package/dist/src/types.d.ts

@@ -41,6 +41,7 @@ export interface ServerOptions {
     token: string;
     commandConfig?: CommandConfig;
     telemetry?: TelemetryConfig;
+    codeGraph?: import("./codegraph.js").CodeGraphIntegration;
 }
 export interface RequestLog {
     method: string;

package/docs/RELEASING.md

@@ -6,10 +6,7 @@ This document is the authoritative maintainer/agent procedure for publishing `ag
 
     feature/*
         │
-        ├── PR → staging
-        │        └── CI
-        │
-        └── promotion PR → main
+        └── PR → main
                  └── CI
                       │
                       ▼
@@ -28,7 +25,7 @@ This document is the authoritative maintainer/agent procedure for publishing `ag
                                   ├── create GitHub Release
                                   └── publish npm package
 
-`main` and `staging` are protected. Normal human and agent changes reach them through pull requests.
+`main` is the single protected release branch. Normal human and agent changes reach it through pull requests. There is no permanent `staging` branch.
 
 ## Release source of truth
 
@@ -61,21 +58,15 @@ Do not manually edit the package version.
 
 `npm pack --dry-run` is important: inspect the file list and make sure the package does not contain credentials, local configuration, development-only files, or other unintended content.
 
-### 3. Merge through staging
+### 3. Open and merge a pull request
 
-Push the feature branch and open a PR targeting `staging`.
+Push the branch and open a PR targeting `main`.
 
 The required CI check is `Check`. It runs `npm ci`, `npm run check`, `npm test`, and `npm pack --dry-run`.
 
-Do not bypass a failing check. After checks pass, merge the PR into `staging`.
-
-### 4. Promote staging to main
-
-Create a promotion PR: `staging → main`.
-
-CI runs again because `main` is also a pull-request target. Merge only after the required `Check` status is green.
+Do not bypass a failing check. Merge only after the required `Check` status is green and the required review is approved.
 
-### 5. Let GitHub Actions publish
+### 4. Let GitHub Actions publish
 
 The merge to `main` creates a push to `main`, which starts `.github/workflows/publish.yml`.
 
@@ -179,7 +170,7 @@ If a release was partially created, reconcile the actual Git/npm/GitHub state be
 
 ## CI workflow constraints
 
-`.github/workflows/ci.yml` runs for pull requests targeting `staging` and `main`.
+`.github/workflows/ci.yml` runs on pushes to `main` and pull requests targeting `main`.
 
 Its concurrency key must remain safe for both PR events and any diagnostic/manual event that may temporarily be introduced:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dir",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Expose a local project to an AI agent through authenticated MCP, filesystem tools, and allowlisted development commands",
   "repository": {
     "type": "git",