@flyingrobots/graft 0.4.0 → 0.6.0

package/dist/mcp/workspace-read-observation.d.ts

@@ -0,0 +1,19 @@
+import type { JsonObject } from "../contracts/json-object.js";
+import type { WorkspaceExecutionContext } from "./workspace-router-model.js";
+export type AttributedReadToolName = "safe_read" | "file_outline" | "read_range";
+export declare function buildWorkspaceReadObservation(execution: WorkspaceExecutionContext, toolName: AttributedReadToolName, args: JsonObject, result: JsonObject): {
+    readonly surface: string;
+    readonly projection: string;
+    readonly sourceLayer: "canonical_structural_truth" | "workspace_overlay";
+    readonly reason: string;
+    readonly footprint: {
+        readonly paths: string[];
+        readonly symbols: string[];
+        readonly regions: {
+            readonly path: string;
+            readonly startLine: number;
+            readonly endLine: number;
+        }[];
+    };
+} | null;
+//# sourceMappingURL=workspace-read-observation.d.ts.map

package/dist/mcp/workspace-read-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-read-observation.d.ts","sourceRoot":"","sources":["../../src/mcp/workspace-read-observation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAQ7E,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;AAEjF,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,yBAAyB,EACpC,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GACjB;IACD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,4BAA4B,GAAG,mBAAmB,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE;YAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;SAC1B,EAAE,CAAC;KACL,CAAC;CACH,GAAG,IAAI,CAuEP"}

package/dist/mcp/workspace-read-observation.js

@@ -0,0 +1,71 @@
+import * as path from "node:path";
+import { parseAttributedReadArgs, parseFileOutlineObservationResult, parseReadRangeObservationResult, parseSafeReadObservationResult, } from "./workspace-read-observation-model.js";
+export function buildWorkspaceReadObservation(execution, toolName, args, result) {
+    const parsedArgs = parseAttributedReadArgs(args);
+    if (parsedArgs === null) {
+        return null;
+    }
+    const absolutePath = execution.resolvePath(parsedArgs.path);
+    const relativePath = path.relative(execution.worktreeRoot, absolutePath);
+    const footprintPath = relativePath.startsWith("..") ? absolutePath : relativePath;
+    const sourceLayer = execution.repoState.getState().workspaceOverlayId === null
+        ? "canonical_structural_truth"
+        : "workspace_overlay";
+    if (toolName === "safe_read") {
+        const parsedResult = parseSafeReadObservationResult(result);
+        if (parsedResult === null) {
+            return null;
+        }
+        return {
+            surface: "safe_read",
+            projection: parsedResult.projection,
+            sourceLayer,
+            reason: parsedResult.reason ?? "SAFE_READ",
+            footprint: {
+                paths: [footprintPath],
+                symbols: [],
+                regions: [],
+            },
+        };
+    }
+    if (toolName === "file_outline") {
+        const parsedResult = parseFileOutlineObservationResult(result);
+        if (parsedResult === null) {
+            return null;
+        }
+        if (typeof parsedResult.error === "string" || parsedResult.reason === "UNSUPPORTED_LANGUAGE") {
+            return null;
+        }
+        return {
+            surface: "file_outline",
+            projection: "outline",
+            sourceLayer,
+            reason: parsedResult.reason ?? "FILE_OUTLINE",
+            footprint: {
+                paths: [footprintPath],
+                symbols: [],
+                regions: [],
+            },
+        };
+    }
+    const parsedResult = parseReadRangeObservationResult(result);
+    if (parsedResult === null) {
+        return null;
+    }
+    return {
+        surface: "read_range",
+        projection: "content",
+        sourceLayer,
+        reason: parsedResult.reason ?? "READ_RANGE",
+        footprint: {
+            paths: [footprintPath],
+            symbols: [],
+            regions: [{
+                    path: footprintPath,
+                    startLine: parsedResult.startLine,
+                    endLine: parsedResult.endLine,
+                }],
+        },
+    };
+}
+//# sourceMappingURL=workspace-read-observation.js.map

package/dist/mcp/workspace-read-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-read-observation.js","sourceRoot":"","sources":["../../src/mcp/workspace-read-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAI/C,MAAM,UAAU,6BAA6B,CAC3C,SAAoC,EACpC,QAAgC,EAChC,IAAgB,EAChB,MAAkB;IAgBlB,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;IAClF,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,kBAAkB,KAAK,IAAI;QAC5E,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,mBAAmB,CAAC;IAExB,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,WAAW;YACX,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,WAAW;YAC1C,SAAS,EAAE;gBACT,KAAK,EAAE,CAAC,aAAa,CAAC;gBACtB,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE;aACZ;SACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,OAAO,YAAY,CAAC,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,sBAAsB,EAAE,CAAC;YAC7F,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,OAAO,EAAE,cAAc;YACvB,UAAU,EAAE,SAAS;YACrB,WAAW;YACX,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,cAAc;YAC7C,SAAS,EAAE;gBACT,KAAK,EAAE,CAAC,aAAa,CAAC;gBACtB,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE;aACZ;SACF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,UAAU,EAAE,SAAS;QACrB,WAAW;QACX,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,YAAY;QAC3C,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,aAAa,CAAC;YACtB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,aAAa;oBACnB,SAAS,EAAE,YAAY,CAAC,SAAS;oBACjC,OAAO,EAAE,YAAY,CAAC,OAAO;iBAC9B,CAAC;SACH;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/workspace-router-capability.d.ts

@@ -0,0 +1,14 @@
+import { type ResolvedWorkspace, type WorkspaceAuthorizationPolicy, type WorkspaceCapabilityProfile, type WorkspaceMode } from "./workspace-router-model.js";
+/**
+ * Resolve the capability profile for a workspace binding attempt.
+ *
+ * In `repo_local` mode the default local profile is always returned.
+ * In `daemon` mode the authorization policy is consulted; `null` means
+ * the workspace is not authorized.
+ */
+export declare function resolveCapabilityProfile(input: {
+    readonly mode: WorkspaceMode;
+    readonly resolved: ResolvedWorkspace;
+    readonly authorizationPolicy?: WorkspaceAuthorizationPolicy | undefined;
+}): Promise<WorkspaceCapabilityProfile | null>;
+//# sourceMappingURL=workspace-router-capability.d.ts.map

package/dist/mcp/workspace-router-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-router-capability.d.ts","sourceRoot":"","sources":["../../src/mcp/workspace-router-capability.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;CACzE,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAK7C"}

package/dist/mcp/workspace-router-capability.js

@@ -0,0 +1,22 @@
+// ---------------------------------------------------------------------------
+// workspace-router-capability — capability profile resolution for binding
+//
+// Determines which capability profile applies when a workspace is bound,
+// whether in repo_local mode (always the local profile) or daemon mode
+// (delegated to the authorization policy).
+// ---------------------------------------------------------------------------
+import { DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE, } from "./workspace-router-model.js";
+/**
+ * Resolve the capability profile for a workspace binding attempt.
+ *
+ * In `repo_local` mode the default local profile is always returned.
+ * In `daemon` mode the authorization policy is consulted; `null` means
+ * the workspace is not authorized.
+ */
+export async function resolveCapabilityProfile(input) {
+    if (input.mode === "repo_local") {
+        return DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE;
+    }
+    return (await input.authorizationPolicy?.getCapabilityProfile(input.resolved)) ?? null;
+}
+//# sourceMappingURL=workspace-router-capability.js.map

package/dist/mcp/workspace-router-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-router-capability.js","sourceRoot":"","sources":["../../src/mcp/workspace-router-capability.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,2CAA2C;AAC3C,8EAA8E;AAC9E,OAAO,EACL,qCAAqC,GAKtC,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAI9C;IACC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,MAAM,KAAK,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;AACzF,CAAC"}

package/dist/mcp/workspace-router-history.d.ts

@@ -0,0 +1,65 @@
+import { type AttributedReadToolName } from "./workspace-read-observation.js";
+import type { PersistedLocalActivityWindow, PersistedLocalHistoryStore, RepoConcurrencySummary, PersistedLocalHistorySummary, PersistedLocalHistoryContext } from "./persisted-local-history.js";
+import type { PersistedLocalHistoryGraphContext } from "./persisted-local-history-graph.js";
+import type { RepoObservation } from "./repo-state.js";
+import type { RuntimeCausalContext } from "./runtime-causal-context.js";
+import type { WorkspaceExecutionContext, WorkspaceStatus } from "./workspace-router-model.js";
+import type { JsonObject } from "../contracts/json-object.js";
+import type { BoundWorkspace } from "./workspace-router-runtime.js";
+export declare const UNBOUND_PERSISTED_LOCAL_HISTORY_SUMMARY: PersistedLocalHistorySummary;
+export declare const UNBOUND_PERSISTED_LOCAL_ACTIVITY_WINDOW: Readonly<{
+    historyPath: null;
+    totalMatchingItems: 0;
+    truncated: false;
+    items: readonly never[];
+}>;
+/**
+ * Retrieve the persisted local history summary for a bound workspace,
+ * including side-effect observations for semantic transitions and staged targets.
+ */
+export declare function queryPersistedLocalHistorySummary(input: {
+    readonly persistedLocalHistory: PersistedLocalHistoryStore;
+    readonly binding: BoundWorkspace;
+    readonly status: WorkspaceStatus;
+    readonly buildCausalContext: (binding: BoundWorkspace, observation: {
+        readonly checkoutEpoch: number;
+    }) => RuntimeCausalContext;
+    readonly buildHistoryContext: (binding: BoundWorkspace, observation: RepoObservation) => PersistedLocalHistoryContext;
+    readonly buildGraphContext: (binding: BoundWorkspace) => Promise<PersistedLocalHistoryGraphContext | null>;
+}): Promise<PersistedLocalHistorySummary>;
+/**
+ * Retrieve the repo concurrency summary for a bound workspace.
+ */
+export declare function queryRepoConcurrencySummary(input: {
+    readonly persistedLocalHistory: PersistedLocalHistoryStore;
+    readonly status: WorkspaceStatus;
+    readonly buildGraphContext: (binding: BoundWorkspace) => Promise<PersistedLocalHistoryGraphContext | null>;
+    readonly binding: BoundWorkspace;
+}): Promise<RepoConcurrencySummary | null>;
+/**
+ * Retrieve the persisted local activity window for a bound workspace.
+ */
+export declare function queryPersistedLocalActivityWindow(input: {
+    readonly persistedLocalHistory: PersistedLocalHistoryStore;
+    readonly binding: BoundWorkspace;
+    readonly status: WorkspaceStatus;
+    readonly limit: number;
+    readonly buildCausalContext: (binding: BoundWorkspace, observation: {
+        readonly checkoutEpoch: number;
+    }) => RuntimeCausalContext;
+    readonly buildGraphContext: (binding: BoundWorkspace) => Promise<PersistedLocalHistoryGraphContext | null>;
+    readonly refreshSummary: () => Promise<void>;
+}): Promise<PersistedLocalActivityWindow>;
+/**
+ * Record a read observation against persisted local history.
+ */
+export declare function noteReadObservation(input: {
+    readonly persistedLocalHistory: PersistedLocalHistoryStore;
+    readonly execution: WorkspaceExecutionContext;
+    readonly toolName: AttributedReadToolName;
+    readonly args: JsonObject;
+    readonly result: JsonObject;
+    readonly buildHistoryContextFromExecution: (execution: WorkspaceExecutionContext, observation: RepoObservation) => PersistedLocalHistoryContext;
+    readonly buildGraphContextFromExecution: (execution: WorkspaceExecutionContext) => Promise<PersistedLocalHistoryGraphContext | null>;
+}): Promise<void>;
+//# sourceMappingURL=workspace-router-history.d.ts.map

package/dist/mcp/workspace-router-history.d.ts.map

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

package/dist/mcp/workspace-router-history.js

@@ -0,0 +1,142 @@
+// ---------------------------------------------------------------------------
+// workspace-router-history — persisted local history query operations
+//
+// Pure functions that query and observe persisted local history state.
+// Extracted from WorkspaceRouter to separate history concerns from
+// workspace lifecycle orchestration.
+// ---------------------------------------------------------------------------
+import { buildRuntimeStagedTarget } from "./runtime-staged-target.js";
+import { buildWorkspaceReadObservation, } from "./workspace-read-observation.js";
+// ---------------------------------------------------------------------------
+// Unbound fallback — returned when no workspace is bound
+// ---------------------------------------------------------------------------
+export const UNBOUND_PERSISTED_LOCAL_HISTORY_SUMMARY = Object.freeze({
+    availability: "none",
+    persistence: "persisted_local_history",
+    historyPath: null,
+    totalContinuityRecords: 0,
+    active: false,
+    lastOperation: null,
+    lastObservedAt: null,
+    continuityKey: null,
+    causalSessionId: null,
+    strandId: null,
+    checkoutEpochId: null,
+    continuedFromCausalSessionId: null,
+    continuityConfidence: "unknown",
+    continuityEvidence: [],
+    attribution: Object.freeze({
+        actor: Object.freeze({
+            actorId: "unknown",
+            actorKind: "unknown",
+            displayName: "Unknown",
+            source: "persisted_local_history.fallback",
+            authorityScope: "inferred",
+        }),
+        confidence: "unknown",
+        basis: "unknown_fallback",
+        evidence: [],
+    }),
+    latestReadEvent: null,
+    latestStageEvent: null,
+    latestTransitionEvent: null,
+    preserves: Object.freeze([
+        "continuity_operations",
+        "read_events",
+        "stage_events",
+        "transition_events",
+        "runtime_context_ids",
+        "workspace_overlay_snapshots",
+    ]),
+    excludes: Object.freeze([
+        "raw_chat_transcripts",
+        "queue_bookkeeping",
+        "canonical_provenance",
+        "canonical_structural_truth",
+    ]),
+    nextAction: "bind_workspace_to_begin_local_history",
+});
+export const UNBOUND_PERSISTED_LOCAL_ACTIVITY_WINDOW = Object.freeze({
+    historyPath: null,
+    totalMatchingItems: 0,
+    truncated: false,
+    items: Object.freeze([]),
+});
+// ---------------------------------------------------------------------------
+// History query functions
+// ---------------------------------------------------------------------------
+/**
+ * Retrieve the persisted local history summary for a bound workspace,
+ * including side-effect observations for semantic transitions and staged targets.
+ */
+export async function queryPersistedLocalHistorySummary(input) {
+    const { persistedLocalHistory, binding, status, buildCausalContext, buildHistoryContext, buildGraphContext } = input;
+    const repoState = binding.slice.repoState;
+    if (repoState === null) {
+        return UNBOUND_PERSISTED_LOCAL_HISTORY_SUMMARY;
+    }
+    const observation = repoState.getState();
+    const causalContext = buildCausalContext(binding, observation);
+    const graph = await buildGraphContext(binding);
+    let summary = await persistedLocalHistory.summarize(status, causalContext, graph);
+    if (observation.semanticTransition !== null) {
+        await persistedLocalHistory.noteSemanticTransitionObservation({
+            current: buildHistoryContext(binding, observation),
+            semanticTransition: observation.semanticTransition,
+            transition: observation.lastTransition,
+            attribution: summary.attribution,
+            graph,
+        });
+        summary = await persistedLocalHistory.summarize(status, causalContext, graph);
+    }
+    const stagedTarget = buildRuntimeStagedTarget(status, causalContext, observation, summary.attribution);
+    if (stagedTarget.availability === "full_file") {
+        await persistedLocalHistory.noteStageObservation({
+            current: buildHistoryContext(binding, observation),
+            stagedTarget,
+            attribution: summary.attribution,
+            graph,
+        });
+        return persistedLocalHistory.summarize(status, causalContext, graph);
+    }
+    return summary;
+}
+/**
+ * Retrieve the repo concurrency summary for a bound workspace.
+ */
+export async function queryRepoConcurrencySummary(input) {
+    return input.persistedLocalHistory.summarizeRepoConcurrency(input.status, await input.buildGraphContext(input.binding));
+}
+/**
+ * Retrieve the persisted local activity window for a bound workspace.
+ */
+export async function queryPersistedLocalActivityWindow(input) {
+    const { persistedLocalHistory, binding, status, limit, buildCausalContext, buildGraphContext, refreshSummary } = input;
+    const repoState = binding.slice.repoState;
+    if (repoState === null) {
+        return { ...UNBOUND_PERSISTED_LOCAL_ACTIVITY_WINDOW, limit };
+    }
+    await refreshSummary();
+    const observation = repoState.getState();
+    const causalContext = buildCausalContext(binding, observation);
+    const graph = await buildGraphContext(binding);
+    return persistedLocalHistory.listRecentActivity(status, causalContext, limit, graph);
+}
+/**
+ * Record a read observation against persisted local history.
+ */
+export async function noteReadObservation(input) {
+    const { persistedLocalHistory, execution, toolName, args, result, buildHistoryContextFromExecution, buildGraphContextFromExecution, } = input;
+    const readObservation = buildWorkspaceReadObservation(execution, toolName, args, result);
+    if (readObservation === null) {
+        return;
+    }
+    const summary = await persistedLocalHistory.summarize(execution.status, execution.getCausalContext(), await buildGraphContextFromExecution(execution));
+    await persistedLocalHistory.noteReadObservation({
+        current: buildHistoryContextFromExecution(execution, execution.repoState.getState()),
+        attribution: summary.attribution,
+        graph: await buildGraphContextFromExecution(execution),
+        ...readObservation,
+    });
+}
+//# sourceMappingURL=workspace-router-history.js.map

package/dist/mcp/workspace-router-history.js.map

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

package/dist/mcp/workspace-router-model.d.ts

@@ -0,0 +1,96 @@
+import type { ObservationCache } from "./cache.js";
+import type { Metrics } from "./metrics.js";
+import type { RepoStateTracker } from "./repo-state.js";
+import type { RuntimeCausalContext } from "./runtime-causal-context.js";
+import type { PersistedLocalHistorySummary } from "./persisted-local-history.js";
+import type { GovernorTracker } from "../session/tracker.js";
+import type { WarpHandle } from "../ports/warp.js";
+export type WorkspaceMode = "repo_local" | "daemon";
+export type WorkspaceBindState = "bound" | "unbound";
+export type WorkspaceBindAction = "bind" | "rebind";
+export interface WorkspaceCapabilityProfile {
+    readonly boundedReads: boolean;
+    readonly structuralTools: boolean;
+    readonly precisionTools: boolean;
+    readonly stateBookmarks: boolean;
+    readonly runtimeLogs: "session_local_only";
+    readonly runCapture: boolean;
+}
+export interface WorkspaceStatus {
+    readonly sessionMode: WorkspaceMode;
+    readonly bindState: WorkspaceBindState;
+    readonly repoId: string | null;
+    readonly worktreeId: string | null;
+    readonly worktreeRoot: string | null;
+    readonly gitCommonDir: string | null;
+    readonly graftDir: string | null;
+    readonly capabilityProfile: WorkspaceCapabilityProfile | null;
+}
+export interface WorkspaceActionResult extends WorkspaceStatus {
+    readonly ok: boolean;
+    readonly action: WorkspaceBindAction;
+    readonly freshSessionSlice: boolean;
+    readonly errorCode?: string;
+    readonly error?: string;
+}
+export interface CausalAttachResult extends WorkspaceStatus {
+    readonly ok: boolean;
+    readonly action: "attach";
+    readonly persistedLocalHistory: PersistedLocalHistorySummary;
+    readonly errorCode?: string;
+    readonly error?: string;
+}
+export interface WorkspaceBindRequest {
+    readonly cwd: string;
+    readonly worktreeRoot?: string | undefined;
+    readonly gitCommonDir?: string | undefined;
+    readonly repoId?: string | undefined;
+}
+export declare class WorkspaceBindingRequiredError extends Error {
+    readonly code = "UNBOUND_WORKSPACE";
+    constructor(toolName: string);
+}
+export declare class WorkspaceCapabilityDeniedError extends Error {
+    readonly code = "CAPABILITY_DENIED";
+    constructor(toolName: string);
+}
+export interface WorkspaceExecutionContext {
+    readonly sliceId: string;
+    readonly repoId: string;
+    readonly worktreeId: string;
+    readonly projectRoot: string;
+    readonly worktreeRoot: string;
+    readonly gitCommonDir: string;
+    readonly graftignorePatterns: readonly string[];
+    readonly resolvePath: (input: string) => string;
+    readonly capabilityProfile: WorkspaceCapabilityProfile;
+    readonly warpWriterId: string;
+    getCausalContext(): RuntimeCausalContext;
+    readonly status: WorkspaceStatus;
+    readonly governor: GovernorTracker;
+    readonly cache: ObservationCache;
+    readonly metrics: Metrics;
+    readonly graftDir: string;
+    readonly repoState: RepoStateTracker;
+    readonly getWarp: () => Promise<WarpHandle>;
+}
+export interface ResolvedWorkspace {
+    readonly repoId: string;
+    readonly worktreeId: string;
+    readonly worktreeRoot: string;
+    readonly gitCommonDir: string;
+}
+export interface WorkspaceAuthorizationPolicy {
+    getCapabilityProfile(resolved: ResolvedWorkspace): Promise<WorkspaceCapabilityProfile | null>;
+    noteBound(resolved: ResolvedWorkspace): Promise<void>;
+}
+export interface WorkspaceSharedAttachPolicy {
+    resolveSharedAttachSource(input: {
+        readonly sessionId: string;
+        readonly repoId: string;
+        readonly worktreeId: string;
+    }): import("./persisted-local-history.js").PersistedLocalHistorySharedAttachSource | null;
+}
+export declare const DEFAULT_DAEMON_CAPABILITY_PROFILE: WorkspaceCapabilityProfile;
+export declare const DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE: WorkspaceCapabilityProfile;
+//# sourceMappingURL=workspace-router-model.d.ts.map

package/dist/mcp/workspace-router-model.d.ts.map

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

package/dist/mcp/workspace-router-model.js

@@ -0,0 +1,31 @@
+export class WorkspaceBindingRequiredError extends Error {
+    code = "UNBOUND_WORKSPACE";
+    constructor(toolName) {
+        super(`Tool ${toolName} requires an active workspace binding. Call workspace_bind first.`);
+        this.name = "WorkspaceBindingRequiredError";
+    }
+}
+export class WorkspaceCapabilityDeniedError extends Error {
+    code = "CAPABILITY_DENIED";
+    constructor(toolName) {
+        super(`Tool ${toolName} is not enabled in the daemon default capability profile.`);
+        this.name = "WorkspaceCapabilityDeniedError";
+    }
+}
+export const DEFAULT_DAEMON_CAPABILITY_PROFILE = Object.freeze({
+    boundedReads: true,
+    structuralTools: true,
+    precisionTools: true,
+    stateBookmarks: true,
+    runtimeLogs: "session_local_only",
+    runCapture: false,
+});
+export const DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE = Object.freeze({
+    boundedReads: true,
+    structuralTools: true,
+    precisionTools: true,
+    stateBookmarks: true,
+    runtimeLogs: "session_local_only",
+    runCapture: true,
+});
+//# sourceMappingURL=workspace-router-model.js.map

package/dist/mcp/workspace-router-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-router-model.js","sourceRoot":"","sources":["../../src/mcp/workspace-router-model.ts"],"names":[],"mappings":"AAuDA,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC7C,IAAI,GAAG,mBAAmB,CAAC;IAEpC,YAAY,QAAgB;QAC1B,KAAK,CAAC,QAAQ,QAAQ,mEAAmE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAC9C,IAAI,GAAG,mBAAmB,CAAC;IAEpC,YAAY,QAAgB;QAC1B,KAAK,CAAC,QAAQ,QAAQ,2DAA2D,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AA2CD,MAAM,CAAC,MAAM,iCAAiC,GAA+B,MAAM,CAAC,MAAM,CAAC;IACzF,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,oBAAoB;IACjC,UAAU,EAAE,KAAK;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qCAAqC,GAA+B,MAAM,CAAC,MAAM,CAAC;IAC7F,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,oBAAoB;IACjC,UAAU,EAAE,IAAI;CACjB,CAAC,CAAC"}

package/dist/mcp/workspace-router-resolution.d.ts

@@ -0,0 +1,10 @@
+import type { GitClient } from "../ports/git.js";
+import type { ResolvedWorkspace, WorkspaceBindRequest } from "./workspace-router-model.js";
+interface WorkspaceBindError {
+    readonly code: string;
+    readonly message: string;
+}
+export declare function stableWorkspaceId(prefix: string, input: string): string;
+export declare function resolveWorkspaceRequest(git: GitClient, request: WorkspaceBindRequest): Promise<ResolvedWorkspace | WorkspaceBindError>;
+export {};
+//# sourceMappingURL=workspace-router-resolution.d.ts.map

package/dist/mcp/workspace-router-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-router-resolution.d.ts","sourceRoot":"","sources":["../../src/mcp/workspace-router-resolution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAE3F,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvE;AA4BD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CA0BjD"}

package/dist/mcp/workspace-router-resolution.js

@@ -0,0 +1,56 @@
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function stableWorkspaceId(prefix, input) {
+    return `${prefix}:${crypto.createHash("sha256").update(input).digest("hex").slice(0, 16)}`;
+}
+async function readGitValue(git, cwd, args) {
+    const result = await git.run({ args, cwd });
+    if (result.error !== undefined || result.status !== 0) {
+        return null;
+    }
+    const trimmed = result.stdout.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function toAbsolutePath(base, value) {
+    return path.isAbsolute(value) ? value : path.resolve(base, value);
+}
+/**
+ * Resolve symlinks to get the canonical filesystem path.
+ * Prevents identity drift from path aliases (e.g. /tmp vs /private/tmp on macOS).
+ * Falls back to the input path if realpath fails (e.g. path does not exist yet).
+ */
+function canonicalize(inputPath) {
+    try {
+        return fs.realpathSync(inputPath);
+    }
+    catch {
+        return inputPath;
+    }
+}
+export async function resolveWorkspaceRequest(git, request) {
+    const cwd = path.resolve(request.cwd);
+    const worktreeRoot = await readGitValue(git, cwd, ["rev-parse", "--path-format=absolute", "--show-toplevel"]);
+    if (worktreeRoot === null) {
+        return {
+            code: "NOT_A_GIT_REPO",
+            message: `cwd is not inside a git worktree: ${cwd}`,
+        };
+    }
+    const rawGitCommonDir = await readGitValue(git, cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
+    if (rawGitCommonDir === null) {
+        return {
+            code: "WORKSPACE_RESOLUTION_FAILED",
+            message: `Unable to resolve git common dir from ${cwd}`,
+        };
+    }
+    const gitCommonDir = canonicalize(toAbsolutePath(worktreeRoot, rawGitCommonDir));
+    const canonicalWorktreeRoot = canonicalize(worktreeRoot);
+    return {
+        repoId: stableWorkspaceId("repo", gitCommonDir),
+        worktreeId: stableWorkspaceId("worktree", canonicalWorktreeRoot),
+        worktreeRoot: canonicalWorktreeRoot,
+        gitCommonDir,
+    };
+}
+//# sourceMappingURL=workspace-router-resolution.js.map

package/dist/mcp/workspace-router-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-router-resolution.js","sourceRoot":"","sources":["../../src/mcp/workspace-router-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,KAAa;IAC7D,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,GAAW,EAAE,IAAuB;IAC9E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,SAAiB;IACrC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAc,EACd,OAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,wBAAwB,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC9G,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,qCAAqC,GAAG,EAAE;SACpD,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,wBAAwB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAClH,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,yCAAyC,GAAG,EAAE;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,cAAc,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;IACjF,MAAM,qBAAqB,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACzD,OAAO;QACL,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC;QAC/C,UAAU,EAAE,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,CAAC;QAChE,YAAY,EAAE,qBAAqB;QACnC,YAAY;KACb,CAAC;AACJ,CAAC"}