@flyingrobots/graft 0.4.0 → 0.6.0

package/dist/mcp/server.js

@@ -0,0 +1,215 @@
+import * as crypto from "node:crypto";
+import * as path from "node:path";
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { nodeFs } from "../adapters/node-fs.js";
+import { CanonicalJsonCodec } from "../adapters/canonical-json.js";
+import { nodeProcessRunner } from "../adapters/node-process-runner.js";
+import { nodeGit } from "../adapters/node-git.js";
+import { openWarp } from "../warp/open.js";
+import { resolveRunCaptureConfig } from "./run-capture-config.js";
+import { WorkspaceRouter, } from "./workspace-router.js";
+import { DaemonControlPlane } from "./daemon-control-plane.js";
+import { DaemonRepoOverview } from "./daemon-repos.js";
+import { DaemonJobScheduler } from "./daemon-job-scheduler.js";
+import { InlineDaemonWorkerPool } from "./daemon-worker-pool.js";
+import { PersistentMonitorRuntime } from "./persistent-monitor-runtime.js";
+import { RuntimeEventLogger, ensureGraftDirExcluded, resolveRuntimeObservabilityState, } from "./runtime-observability.js";
+import { InMemoryWarpPool } from "./warp-pool.js";
+import { buildSessionWarpWriterId } from "../warp/writer-id.js";
+import { PersistedLocalHistoryStore } from "./persisted-local-history.js";
+import { GRAFT_VERSION } from "../version.js";
+import { ALL_TOOL_REGISTRY, TOOL_REGISTRY } from "./tool-registry.js";
+import { wrapWithPolicyCheck } from "./server-tool-access.js";
+import { buildToolContext } from "./server-context.js";
+import { createInvocationEngine, recordFootprint } from "./server-invocation.js";
+export { ALL_TOOL_REGISTRY, TOOL_REGISTRY } from "./tool-registry.js";
+export function createGraftServer(options = {}) {
+    const mcpServer = new McpServer({ name: "graft", version: GRAFT_VERSION });
+    const sessionId = options.sessionId ?? crypto.randomUUID();
+    const mode = options.mode ?? "repo_local";
+    const sessionWarpWriterId = mode === "daemon" ? buildSessionWarpWriterId(sessionId) : undefined;
+    const env = options.env ?? process.env;
+    const projectRoot = mode === "repo_local" ? (options.projectRoot ?? env["GRAFT_PROJECT_ROOT"]?.trim() ?? process.cwd()) : options.projectRoot;
+    const graftDir = options.graftDir
+        ?? (mode === "repo_local" && projectRoot !== undefined ? path.join(projectRoot, ".graft") : undefined);
+    if (graftDir === undefined) {
+        throw new Error("daemon mode requires an explicit graftDir");
+    }
+    const codec = new CanonicalJsonCodec();
+    const runCapture = resolveRunCaptureConfig({
+        ...(options.env !== undefined ? { env: options.env } : {}),
+        ...(options.runCapture !== undefined ? { overrides: options.runCapture } : {}),
+    });
+    const observability = resolveRuntimeObservabilityState({
+        graftDir,
+        ...(options.env !== undefined ? { env: options.env } : {}),
+        ...(options.runtimeObservability !== undefined ? { overrides: options.runtimeObservability } : {}),
+    });
+    const runtimeLogger = new RuntimeEventLogger({
+        fs: nodeFs,
+        codec,
+        logPath: observability.logPath,
+        maxBytes: observability.maxBytes,
+    });
+    const warpPool = options.warpPool ?? new InMemoryWarpPool((cwd, writerId) => openWarp({ cwd, writerId }));
+    const processRunner = options.processRunner ?? nodeProcessRunner;
+    const persistedLocalHistory = new PersistedLocalHistoryStore({
+        fs: nodeFs,
+        codec,
+        graftDir,
+    });
+    const daemonScheduler = mode === "daemon" ? (options.daemonScheduler ?? new DaemonJobScheduler()) : null;
+    const daemonWorkerPool = mode === "daemon" ? (options.daemonWorkerPool ?? new InlineDaemonWorkerPool()) : null;
+    const daemonControlPlane = mode === "daemon"
+        ? (options.daemonControlPlane ?? new DaemonControlPlane({
+            fs: nodeFs,
+            codec,
+            git: nodeGit,
+            graftDir,
+        }))
+        : null;
+    const monitorRuntime = mode !== "daemon" || daemonControlPlane === null || daemonScheduler === null || daemonWorkerPool === null
+        ? null
+        : (options.monitorRuntime ?? new PersistentMonitorRuntime({
+            fs: nodeFs,
+            codec,
+            git: nodeGit,
+            graftDir,
+            controlPlane: daemonControlPlane,
+            scheduler: daemonScheduler,
+            workerPool: daemonWorkerPool,
+        }));
+    const daemonStartedAt = new Date().toISOString();
+    const daemonRuntime = options.daemonRuntime ?? (() => {
+        return {
+            transport: "unix_socket",
+            sameUserOnly: true,
+            socketPath: graftDir,
+            mcpPath: "/mcp",
+            healthPath: "/healthz",
+            activeWarpRepos: warpPool.size(),
+            startedAt: daemonStartedAt,
+        };
+    });
+    const handlers = new Map();
+    const schemas = new Map();
+    const workspaceRouter = new WorkspaceRouter({
+        mode,
+        fs: nodeFs,
+        git: nodeGit,
+        graftDir,
+        ...(projectRoot !== undefined ? { projectRoot } : {}),
+        warpPool,
+        transportSessionId: sessionId,
+        ...(sessionWarpWriterId !== undefined ? { warpWriterId: sessionWarpWriterId } : {}),
+        ...(daemonControlPlane !== null ? { authorizationPolicy: daemonControlPlane } : {}),
+        ...(daemonControlPlane !== null ? { sharedAttachPolicy: daemonControlPlane } : {}),
+        persistedLocalHistory,
+    });
+    const daemonRepoOverview = daemonControlPlane !== null && monitorRuntime !== null
+        ? new DaemonRepoOverview({
+            controlPlane: daemonControlPlane,
+            monitorRuntime,
+        })
+        : null;
+    const runtimeReady = (async () => {
+        if (mode === "repo_local" && projectRoot !== undefined) {
+            await ensureGraftDirExcluded(projectRoot, graftDir, nodeFs);
+        }
+        await workspaceRouter.initialize();
+        await Promise.all([
+            daemonControlPlane?.initialize() ?? Promise.resolve(),
+            monitorRuntime?.initialize() ?? Promise.resolve(),
+        ]);
+    })().then(() => undefined);
+    // --- Invocation engine: AsyncLocalStorage, respond(), invokeTool() ---
+    const engine = createInvocationEngine({
+        sessionId,
+        mode,
+        codec,
+        observability,
+        runtimeLogger,
+        workspaceRouter,
+        daemonScheduler,
+        daemonWorkerPool,
+        runtimeReady,
+    });
+    // --- ToolContext: lazy-getter facade over workspace router + execution context ---
+    const ctx = buildToolContext({
+        workspaceRouter,
+        fs: nodeFs,
+        codec,
+        processRunner,
+        git: nodeGit,
+        runCapture,
+        observability,
+        daemonControlPlane,
+        daemonRepoOverview,
+        daemonScheduler,
+        daemonWorkerPool,
+        monitorRuntime,
+        daemonRuntime,
+        getActiveExecutionContext: engine.getActiveExecutionContext,
+        respond: engine.respond,
+        recordFootprint: (entry) => { recordFootprint(engine.invocationStorage, entry); },
+    });
+    // --- Tool registration ---
+    const activeToolRegistry = mode === "daemon" ? ALL_TOOL_REGISTRY : TOOL_REGISTRY;
+    for (const def of activeToolRegistry) {
+        const rawHandler = def.createHandler();
+        const handler = def.policyCheck === true ? wrapWithPolicyCheck(def.name, rawHandler) : rawHandler;
+        handlers.set(def.name, handler);
+        if (def.schema !== undefined) {
+            const zodSchema = z.object(def.schema).strict();
+            schemas.set(def.name, zodSchema);
+            mcpServer.registerTool(def.name, { description: def.description, inputSchema: def.schema }, async (args) => {
+                return engine.invokeTool(def.name, handler, args, ctx, zodSchema);
+            });
+        }
+        else {
+            mcpServer.registerTool(def.name, { description: def.description }, async () => {
+                return engine.invokeTool(def.name, handler, {}, ctx);
+            });
+        }
+    }
+    if (observability.enabled) {
+        void engine.emitRuntimeEvent({
+            event: "session_started",
+            sessionId,
+            logPath: observability.logPath,
+            logPolicy: observability.logPolicy,
+        });
+    }
+    return {
+        getRegisteredTools() {
+            return [...handlers.keys()];
+        },
+        async callTool(name, args) {
+            const handler = handlers.get(name);
+            if (handler === undefined) {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            const schema = schemas.get(name);
+            return engine.invokeTool(name, handler, args, ctx, schema);
+        },
+        injectSessionMessages(count) {
+            for (let i = 0; i < count; i++) {
+                workspaceRouter.governor.recordMessage();
+            }
+        },
+        getWorkspaceStatus() {
+            return workspaceRouter.getStatus();
+        },
+        getRuntimeCausalContext() {
+            if (workspaceRouter.getStatus().bindState !== "bound") {
+                return null;
+            }
+            return workspaceRouter.captureExecutionContext().getCausalContext();
+        },
+        getMcpServer() {
+            return mcpServer;
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/stdio-server.d.ts

@@ -0,0 +1,6 @@
+export interface StartStdioServerOptions {
+    readonly runtime: "stdio" | "daemon";
+    readonly socketPath?: string;
+}
+export declare function startStdioServer(cwd?: string): Promise<void>;
+//# sourceMappingURL=stdio-server.d.ts.map

package/dist/mcp/stdio-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio-server.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAUD,wBAAsB,gBAAgB,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/dist/mcp/stdio-server.js

@@ -0,0 +1,20 @@
+import * as path from "node:path";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createGraftServer } from "./server.js";
+function resolveProjectRoot(cwd) {
+    const fromEnv = process.env["GRAFT_PROJECT_ROOT"]?.trim();
+    if (fromEnv !== undefined && fromEnv.length > 0) {
+        return path.resolve(fromEnv);
+    }
+    return cwd;
+}
+export async function startStdioServer(cwd = process.cwd()) {
+    const projectRoot = resolveProjectRoot(cwd);
+    const graft = createGraftServer({
+        projectRoot,
+        graftDir: path.join(projectRoot, ".graft"),
+    });
+    const transport = new StdioServerTransport();
+    await graft.getMcpServer().connect(transport);
+}
+//# sourceMappingURL=stdio-server.js.map

package/dist/mcp/stdio-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.js","sourceRoot":"","sources":["../../src/mcp/stdio-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOhD,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACxD,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,iBAAiB,CAAC;QAC9B,WAAW;QACX,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;KAC3C,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC"}

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/mcp/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":""}

package/dist/mcp/stdio.js

@@ -0,0 +1,3 @@
+import { startStdioServer } from "./stdio-server.js";
+await startStdioServer();
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,gBAAgB,EAAE,CAAC"}

package/dist/mcp/tool-registry.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDefinition } from "./context.js";
+export declare const TOOL_REGISTRY: readonly ToolDefinition[];
+export declare const DAEMON_TOOL_REGISTRY: readonly ToolDefinition[];
+export declare const ALL_TOOL_REGISTRY: readonly ToolDefinition[];
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/mcp/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoCnD,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAqBlD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS,cAAc,EAezD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAGtD,CAAC"}

package/dist/mcp/tool-registry.js

@@ -0,0 +1,76 @@
+import { safeReadTool } from "./tools/safe-read.js";
+import { fileOutlineTool } from "./tools/file-outline.js";
+import { readRangeTool } from "./tools/read-range.js";
+import { changedSinceTool } from "./tools/changed-since.js";
+import { graftDiffTool } from "./tools/graft-diff.js";
+import { runCaptureTool } from "./tools/run-capture.js";
+import { stateSaveTool, stateLoadTool } from "./tools/state.js";
+import { doctorTool } from "./tools/doctor.js";
+import { statsTool } from "./tools/stats.js";
+import { explainTool } from "./tools/explain.js";
+import { setBudgetTool } from "./tools/budget.js";
+import { sinceTool } from "./tools/since.js";
+import { mapTool } from "./tools/map.js";
+import { codeShowTool } from "./tools/code-show.js";
+import { codeFindTool } from "./tools/code-find.js";
+import { codeRefsTool } from "./tools/code-refs.js";
+import { daemonMonitorsTool } from "./tools/daemon-monitors.js";
+import { daemonReposTool } from "./tools/daemon-repos.js";
+import { daemonSessionsTool } from "./tools/daemon-sessions.js";
+import { daemonStatusTool } from "./tools/daemon-status.js";
+import { monitorPauseTool } from "./tools/monitor-pause.js";
+import { monitorResumeTool } from "./tools/monitor-resume.js";
+import { monitorStartTool } from "./tools/monitor-start.js";
+import { monitorStopTool } from "./tools/monitor-stop.js";
+import { activityViewTool } from "./tools/activity-view.js";
+import { causalStatusTool } from "./tools/causal-status.js";
+import { causalAttachTool } from "./tools/causal-attach.js";
+import { workspaceAuthorizeTool } from "./tools/workspace-authorize.js";
+import { workspaceAuthorizationsTool } from "./tools/workspace-authorizations.js";
+import { workspaceBindTool } from "./tools/workspace-bind.js";
+import { workspaceRevokeTool } from "./tools/workspace-revoke.js";
+import { workspaceStatusTool } from "./tools/workspace-status.js";
+import { workspaceRebindTool } from "./tools/workspace-rebind.js";
+export const TOOL_REGISTRY = [
+    safeReadTool,
+    fileOutlineTool,
+    readRangeTool,
+    changedSinceTool,
+    graftDiffTool,
+    runCaptureTool,
+    stateSaveTool,
+    stateLoadTool,
+    doctorTool,
+    activityViewTool,
+    causalStatusTool,
+    causalAttachTool,
+    statsTool,
+    explainTool,
+    setBudgetTool,
+    sinceTool,
+    mapTool,
+    codeShowTool,
+    codeFindTool,
+    codeRefsTool,
+];
+export const DAEMON_TOOL_REGISTRY = [
+    daemonReposTool,
+    daemonStatusTool,
+    daemonSessionsTool,
+    daemonMonitorsTool,
+    monitorStartTool,
+    monitorPauseTool,
+    monitorResumeTool,
+    monitorStopTool,
+    workspaceAuthorizeTool,
+    workspaceAuthorizationsTool,
+    workspaceRevokeTool,
+    workspaceBindTool,
+    workspaceStatusTool,
+    workspaceRebindTool,
+];
+export const ALL_TOOL_REGISTRY = [
+    ...TOOL_REGISTRY,
+    ...DAEMON_TOOL_REGISTRY,
+];
+//# sourceMappingURL=tool-registry.js.map

package/dist/mcp/tool-registry.js.map

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

package/dist/mcp/tools/activity-view.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../context.js";
+export declare const activityViewTool: ToolDefinition;
+//# sourceMappingURL=activity-view.d.ts.map

package/dist/mcp/tools/activity-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-view.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/activity-view.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAqMjE,eAAO,MAAM,gBAAgB,EAAE,cA2H9B,CAAC"}

package/dist/mcp/tools/activity-view.js

@@ -0,0 +1,259 @@
+import { z } from "zod";
+import { buildRuntimeStagedTarget } from "../runtime-staged-target.js";
+import { deriveCausalSurfaceNextAction } from "../semantic-transition-guidance.js";
+const limitSchema = z.number().int().positive().max(50).optional();
+const GROUP_ORDER = [
+    "transition",
+    "stage",
+    "continuity",
+    "read",
+];
+function classifyActivityItem(item) {
+    if ("itemKind" in item) {
+        return "continuity";
+    }
+    if (item.eventKind === "transition") {
+        return "transition";
+    }
+    if (item.eventKind === "stage") {
+        return "stage";
+    }
+    return "read";
+}
+function groupLabel(kind) {
+    switch (kind) {
+        case "transition":
+            return "semantic transitions";
+        case "stage":
+            return "staged activity";
+        case "continuity":
+            return "workspace continuity";
+        case "read":
+            return "read activity";
+    }
+}
+function buildAnchor(workspaceBound, headRef, headSha) {
+    if (!workspaceBound) {
+        return {
+            posture: "unknown",
+            headRef: null,
+            headSha: null,
+            reason: "workspace_unbound",
+        };
+    }
+    if (headSha === null) {
+        return {
+            posture: "unknown",
+            headRef,
+            headSha: null,
+            reason: "missing_head_commit",
+        };
+    }
+    return {
+        posture: "head_commit",
+        headRef,
+        headSha,
+    };
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+function pluralize(count, singular, plural = `${singular}s`) {
+    return count === 1 ? singular : plural;
+}
+function countText(count) {
+    return String(count);
+}
+function shortSha(sha) {
+    return sha === null ? "unknown" : sha.slice(0, 7);
+}
+function describeAnchor(anchor) {
+    if (anchor.posture === "unknown") {
+        return anchor.reason === "workspace_unbound"
+            ? "Anchor to the current Git commit is unavailable because no workspace is bound."
+            : "Anchor to the current Git commit is unavailable because HEAD could not be resolved.";
+    }
+    const refLabel = anchor.headRef ?? "HEAD";
+    return `Current commit anchor is ${refLabel} @ ${shortSha(anchor.headSha)}. This view summarizes recent bounded local artifact history for the active checkout epoch, not a complete since-commit ledger.`;
+}
+function describeStagedTarget(stagedTarget) {
+    switch (stagedTarget.availability) {
+        case "none":
+            return "No staged target is active.";
+        case "full_file":
+            return `Staged target is a full-file selection across ${countText(stagedTarget.target.selectionEntries.length)} ${pluralize(stagedTarget.target.selectionEntries.length, "path")}.`;
+        case "ambiguous":
+            return `Staged target is ambiguous across ${countText(stagedTarget.observedStagedPaths)} staged ${pluralize(stagedTarget.observedStagedPaths, "path")}.`;
+    }
+}
+function describeWorkspace(repoConcurrency, semanticTransitionSummary, stagedTarget) {
+    return [
+        repoConcurrency === null
+            ? "Repo concurrency posture is unknown."
+            : `Repo concurrency posture is ${repoConcurrency.posture}. ${repoConcurrency.summary}`,
+        semanticTransitionSummary ?? "No active semantic transition is recorded.",
+        describeStagedTarget(stagedTarget),
+    ].join(" ");
+}
+function summarizeTransitionGroup(items) {
+    const transitionItems = items.filter((item) => "eventKind" in item && item.eventKind === "transition");
+    const latest = transitionItems[0];
+    if (latest === undefined) {
+        return "No semantic transitions are recorded.";
+    }
+    if (transitionItems.length === 1) {
+        return `1 semantic transition recorded: ${latest.payload.summary}.`;
+    }
+    return `${countText(transitionItems.length)} semantic transitions recorded, latest: ${latest.payload.summary}.`;
+}
+function summarizeStageGroup(items) {
+    const stageItems = items.filter((item) => "eventKind" in item && item.eventKind === "stage");
+    const uniquePaths = new Set();
+    for (const item of stageItems) {
+        for (const path of item.footprint.paths) {
+            uniquePaths.add(path);
+        }
+    }
+    return `${countText(stageItems.length)} staging ${pluralize(stageItems.length, "event")} across ${countText(uniquePaths.size)} ${pluralize(uniquePaths.size, "path")}.`;
+}
+function summarizeContinuityGroup(items) {
+    const continuityItems = items.filter((item) => "itemKind" in item);
+    const operations = unique(continuityItems.map((item) => item.operation));
+    return `${countText(continuityItems.length)} continuity ${pluralize(continuityItems.length, "change")} (${operations.join(", ")}).`;
+}
+function summarizeReadGroup(items) {
+    const readItems = items.filter((item) => "eventKind" in item && item.eventKind === "read");
+    const uniquePaths = new Set();
+    for (const item of readItems) {
+        for (const path of item.footprint.paths) {
+            uniquePaths.add(path);
+        }
+    }
+    const latest = readItems[0];
+    if (latest === undefined) {
+        return "No read activity is recorded.";
+    }
+    return `${countText(readItems.length)} reads across ${countText(uniquePaths.size)} ${pluralize(uniquePaths.size, "path")}, latest via ${latest.payload.surface}.`;
+}
+function summarizeGroup(kind, items) {
+    switch (kind) {
+        case "transition":
+            return summarizeTransitionGroup(items);
+        case "stage":
+            return summarizeStageGroup(items);
+        case "continuity":
+            return summarizeContinuityGroup(items);
+        case "read":
+            return summarizeReadGroup(items);
+    }
+}
+function buildHeadline(returned, truncated) {
+    const headline = `Showing ${countText(returned)} recent ${pluralize(returned, "activity item")} from bounded local artifact history for the active line of work.`;
+    return truncated ? `${headline} Results are truncated to the requested window.` : headline;
+}
+export const activityViewTool = {
+    name: "activity_view",
+    description: "Inspect recent bounded local artifact history for the active workspace, anchored to the current commit when possible.",
+    schema: {
+        limit: limitSchema,
+    },
+    createHandler() {
+        return async (args, ctx) => {
+            const limit = limitSchema.parse(args["limit"]) ?? 20;
+            const workspaceStatus = ctx.getWorkspaceStatus();
+            if (workspaceStatus.bindState === "unbound") {
+                return ctx.respond("activity_view", {
+                    ...workspaceStatus,
+                    truthClass: "artifact_history",
+                    anchor: buildAnchor(false, null, null),
+                    summary: {
+                        headline: buildHeadline(0, false),
+                        anchor: "Anchor to the current Git commit is unavailable because no workspace is bound.",
+                        workspace: "No active causal workspace is available until a workspace is bound.",
+                        groups: [],
+                    },
+                    activeCausalWorkspace: null,
+                    activityWindow: {
+                        historyPath: null,
+                        limit,
+                        returned: 0,
+                        totalMatchingItems: 0,
+                        truncated: false,
+                        missingSignalKinds: ["write_events_not_captured"],
+                        groups: [],
+                    },
+                    degradedReasons: ["workspace_unbound", "anchor_unknown"],
+                    nextAction: "bind_workspace_to_begin_local_history",
+                });
+            }
+            const repoState = ctx.getRepoState();
+            const causalContext = ctx.getCausalContext();
+            const persistedLocalHistory = await ctx.getPersistedLocalHistorySummary();
+            const activityWindow = await ctx.getPersistedLocalActivityWindow(limit);
+            const workspaceOverlayFooting = await ctx.getWorkspaceOverlayFooting();
+            const repoConcurrency = await ctx.getRepoConcurrencySummary();
+            const nextAction = deriveCausalSurfaceNextAction(persistedLocalHistory.nextAction, repoState.semanticTransition, repoConcurrency);
+            const stagedTarget = buildRuntimeStagedTarget(workspaceStatus, causalContext, repoState, persistedLocalHistory.attribution);
+            const anchor = buildAnchor(true, repoState.headRef, repoState.headSha);
+            const workspaceOverlayDegradedReason = workspaceOverlayFooting?.degradedReason ?? null;
+            const groups = GROUP_ORDER.map((groupKind) => {
+                const items = activityWindow.items.filter((item) => classifyActivityItem(item) === groupKind);
+                if (items.length === 0) {
+                    return null;
+                }
+                return {
+                    groupKind,
+                    label: groupLabel(groupKind),
+                    summary: summarizeGroup(groupKind, items),
+                    count: items.length,
+                    items,
+                };
+            }).filter((group) => group !== null);
+            const degradedReasons = unique([
+                ...(anchor.posture === "unknown" ? ["anchor_unknown"] : []),
+                ...(workspaceOverlayDegradedReason === null ? [] : [workspaceOverlayDegradedReason]),
+                ...(stagedTarget.availability === "ambiguous" ? ["staged_target_ambiguous"] : []),
+                ...(repoConcurrency !== null && repoConcurrency.posture !== "exclusive"
+                    ? [repoConcurrency.posture]
+                    : []),
+            ]);
+            return ctx.respond("activity_view", {
+                ...workspaceStatus,
+                truthClass: "artifact_history",
+                anchor,
+                summary: {
+                    headline: buildHeadline(activityWindow.items.length, activityWindow.truncated),
+                    anchor: describeAnchor(anchor),
+                    workspace: describeWorkspace(repoConcurrency === null
+                        ? null
+                        : { posture: repoConcurrency.posture, summary: repoConcurrency.summary }, repoState.semanticTransition?.summary ?? null, stagedTarget),
+                    groups: groups.map((group) => group.summary),
+                },
+                activeCausalWorkspace: {
+                    causalContext,
+                    attribution: persistedLocalHistory.attribution,
+                    repoConcurrency,
+                    checkoutEpoch: repoState.checkoutEpoch,
+                    lastTransition: repoState.lastTransition,
+                    semanticTransition: repoState.semanticTransition,
+                    workspaceOverlayId: repoState.workspaceOverlayId,
+                    workspaceOverlay: repoState.workspaceOverlay,
+                    workspaceOverlayFooting,
+                    stagedTarget,
+                },
+                activityWindow: {
+                    historyPath: activityWindow.historyPath,
+                    limit: activityWindow.limit,
+                    returned: activityWindow.items.length,
+                    totalMatchingItems: activityWindow.totalMatchingItems,
+                    truncated: activityWindow.truncated,
+                    missingSignalKinds: ["write_events_not_captured"],
+                    groups,
+                },
+                degradedReasons,
+                nextAction,
+            });
+        };
+    },
+};
+//# sourceMappingURL=activity-view.js.map