@flyingrobots/graft 0.4.0 → 0.6.0

package/dist/mcp/receipt.d.ts

@@ -0,0 +1,64 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { MetricsSnapshot } from "./metrics.js";
+import type { Tripwire } from "../session/types.js";
+import type { JsonCodec } from "../ports/codec.js";
+import { type McpToolName } from "../contracts/output-schemas.js";
+import { type BurdenByKind, type BurdenKind } from "./burden.js";
+export type McpToolResult = CallToolResult;
+export interface ReceiptBudget {
+    readonly total: number;
+    readonly consumed: number;
+    readonly remaining: number;
+    readonly fraction: number;
+}
+export interface ReceiptCumulative {
+    readonly reads: number;
+    readonly outlines: number;
+    readonly refusals: number;
+    readonly cacheHits: number;
+    readonly bytesReturned: number;
+    readonly bytesAvoided: number;
+    readonly nonReadBytesReturned: number;
+    readonly burdenByKind: Readonly<BurdenByKind>;
+}
+export interface ReceiptBurden {
+    readonly kind: BurdenKind;
+    readonly nonRead: boolean;
+}
+export interface McpToolReceipt {
+    readonly sessionId: string;
+    readonly traceId: string;
+    readonly seq: number;
+    readonly ts: string;
+    readonly tool: McpToolName;
+    readonly projection: string;
+    readonly reason: string;
+    readonly latencyMs: number;
+    readonly fileBytes: number | null;
+    readonly returnedBytes: number;
+    readonly burden: ReceiptBurden;
+    readonly cumulative: ReceiptCumulative;
+    readonly budget?: ReceiptBudget;
+    readonly compressionRatio?: number | null;
+}
+export interface ReceiptDeps {
+    readonly sessionId: string;
+    readonly traceId: string;
+    readonly seq: number;
+    readonly latencyMs: number;
+    readonly metrics: MetricsSnapshot;
+    readonly tripwires: Tripwire[];
+    readonly codec: JsonCodec;
+    readonly budget?: ReceiptBudget | null;
+}
+/**
+ * Build a tool response with an attached receipt.
+ * Returns the finalized MCP result and the byte count of the serialized text
+ * so the caller can feed it back into cumulative metrics.
+ */
+export declare function buildReceiptResult(tool: McpToolName, data: Record<string, unknown>, deps: ReceiptDeps): {
+    result: McpToolResult;
+    textBytes: number;
+    receipt: McpToolReceipt;
+};
+//# sourceMappingURL=receipt.d.ts.map

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

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

package/dist/mcp/receipt.js

@@ -0,0 +1,99 @@
+// ---------------------------------------------------------------------------
+// Receipt builder — attaches decision metadata to every tool response
+// ---------------------------------------------------------------------------
+import { attachMcpSchemaMeta } from "../contracts/output-schemas.js";
+import { burdenKindForTool, isNonReadBurdenKind, projectBurdenByKind, totalNonReadBytesReturned, } from "./burden.js";
+function extractProjection(data) {
+    if (typeof data["projection"] === "string")
+        return data["projection"];
+    return "none";
+}
+function extractReason(data) {
+    if (typeof data["reason"] === "string")
+        return data["reason"];
+    return "none";
+}
+function extractFileBytes(data) {
+    const actual = data["actual"];
+    if (actual !== null && typeof actual === "object" && "bytes" in actual) {
+        const bytes = actual.bytes;
+        if (typeof bytes === "number")
+            return bytes;
+    }
+    return null;
+}
+function freezeReceipt(draft) {
+    Object.freeze(draft.burden);
+    Object.freeze(draft.cumulative);
+    Object.freeze(draft);
+    return draft;
+}
+/**
+ * Build a tool response with an attached receipt.
+ * Returns the finalized MCP result and the byte count of the serialized text
+ * so the caller can feed it back into cumulative metrics.
+ */
+export function buildReceiptResult(tool, data, deps) {
+    const burdenKind = burdenKindForTool(tool);
+    const draft = {
+        sessionId: deps.sessionId,
+        traceId: deps.traceId,
+        seq: deps.seq,
+        ts: new Date().toISOString(),
+        tool,
+        projection: extractProjection(data),
+        reason: extractReason(data),
+        latencyMs: deps.latencyMs,
+        fileBytes: extractFileBytes(data),
+        returnedBytes: 0,
+        burden: {
+            kind: burdenKind,
+            nonRead: isNonReadBurdenKind(burdenKind),
+        },
+        cumulative: {
+            reads: deps.metrics.reads,
+            outlines: deps.metrics.outlines,
+            refusals: deps.metrics.refusals,
+            cacheHits: deps.metrics.cacheHits,
+            bytesReturned: 0,
+            bytesAvoided: deps.metrics.bytesAvoided,
+            nonReadBytesReturned: totalNonReadBytesReturned(deps.metrics.burdenByKind),
+            burdenByKind: deps.metrics.burdenByKind,
+        },
+    };
+    if (deps.budget != null) {
+        draft.budget = deps.budget;
+    }
+    const fullData = attachMcpSchemaMeta(tool, {
+        ...data,
+        _receipt: draft,
+    });
+    if (deps.tripwires.length > 0) {
+        fullData.tripwire = deps.tripwires;
+    }
+    // Stabilize self-referential size fields (use UTF-8 byte length, not char count)
+    let prev = 0;
+    let text = "";
+    for (let i = 0; i < 5; i++) {
+        text = deps.codec.encode(fullData);
+        const byteLen = Buffer.byteLength(text, "utf8");
+        if (byteLen === prev)
+            break;
+        prev = byteLen;
+        draft.returnedBytes = byteLen;
+        const burdenByKind = projectBurdenByKind(deps.metrics.burdenByKind, tool, byteLen);
+        draft.compressionRatio = draft.fileBytes !== null && draft.fileBytes > 0
+            ? Math.round((byteLen / draft.fileBytes) * 1000) / 1000
+            : null;
+        draft.cumulative.bytesReturned = deps.metrics.bytesReturned + byteLen;
+        draft.cumulative.nonReadBytesReturned = totalNonReadBytesReturned(burdenByKind);
+        draft.cumulative.burdenByKind = burdenByKind;
+    }
+    const receipt = freezeReceipt(draft);
+    return {
+        result: { content: [{ type: "text", text }] },
+        textBytes: Buffer.byteLength(text, "utf8"),
+        receipt,
+    };
+}
+//# sourceMappingURL=receipt.js.map

package/dist/mcp/receipt.js.map

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

package/dist/mcp/repo-concurrency.d.ts

@@ -0,0 +1,62 @@
+import type { AttributionSummary, CausalEvent, RepoConcurrencyAuthority, RepoConcurrencyPosture } from "../contracts/causal-ontology.js";
+export interface RepoConcurrencyTouch {
+    readonly contributorKey: string;
+    readonly path: string;
+}
+export interface RepoConcurrencyWorktreeHistory {
+    readonly worktreeId: string;
+    readonly active: boolean;
+    readonly checkoutEpochId: string | null;
+    readonly causalSessionIds: readonly string[];
+    readonly actorIds: readonly string[];
+    readonly contributorKeys: readonly string[];
+    readonly explicitHandoff: boolean;
+    readonly touches: readonly RepoConcurrencyTouch[];
+}
+export interface RepoConcurrencySummary {
+    readonly posture: RepoConcurrencyPosture;
+    readonly authority: RepoConcurrencyAuthority;
+    readonly observedWorktreeCount: number;
+    readonly observedCausalSessionCount: number;
+    readonly observedActorCount: number;
+    readonly overlappingPathCount: number;
+    readonly summary: string;
+    readonly daemonSessionLiveness?: RepoConcurrencyDaemonSessionLiveness;
+}
+export interface RepoConcurrencyDaemonSessionLiveness {
+    readonly idleTimeoutMs: number;
+    readonly liveSessionCount: number;
+    readonly staleSessionCount: number;
+}
+interface RepoConcurrencyInput {
+    readonly currentWorktreeId: string;
+    readonly histories: readonly RepoConcurrencyWorktreeHistory[];
+}
+export interface RepoConcurrencyLiveSession {
+    readonly bindState: "bound" | "unbound";
+    readonly repoId: string | null;
+    readonly worktreeId: string | null;
+    readonly causalSessionId: string | null;
+    readonly checkoutEpochId: string | null;
+    readonly lastActivityAt: string;
+}
+export declare const DEFAULT_DAEMON_SESSION_IDLE_TIMEOUT_MS: number;
+export declare function deriveRepoConcurrencySummary(input: RepoConcurrencyInput): RepoConcurrencySummary;
+export declare function mergeRepoConcurrencySummaryWithLiveSessions(input: {
+    readonly currentSummary: RepoConcurrencySummary;
+    readonly currentRepoId: string;
+    readonly currentWorktreeId: string;
+    readonly currentCheckoutEpochId: string | null;
+    readonly sessions: readonly RepoConcurrencyLiveSession[];
+    readonly nowMs?: number;
+    readonly sessionIdleTimeoutMs?: number;
+}): RepoConcurrencySummary;
+export declare function buildRepoConcurrencyContributorKey(input: {
+    readonly actorId: string | null;
+    readonly attribution: AttributionSummary;
+    readonly causalSessionId: string | null;
+    readonly transportSessionId: string | null;
+}): string | null;
+export declare function buildRepoConcurrencyTouches(events: readonly CausalEvent[]): RepoConcurrencyTouch[];
+export {};
+//# sourceMappingURL=repo-concurrency.d.ts.map

package/dist/mcp/repo-concurrency.d.ts.map

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

package/dist/mcp/repo-concurrency.js

@@ -0,0 +1,195 @@
+export const DEFAULT_DAEMON_SESSION_IDLE_TIMEOUT_MS = 5 * 60 * 1000;
+function countOverlapPaths(touches) {
+    const contributorsByPath = new Map();
+    for (const touch of touches) {
+        const existing = contributorsByPath.get(touch.path) ?? new Set();
+        existing.add(touch.contributorKey);
+        contributorsByPath.set(touch.path, existing);
+    }
+    let count = 0;
+    for (const contributors of contributorsByPath.values()) {
+        if (contributors.size > 1) {
+            count += 1;
+        }
+    }
+    return count;
+}
+function buildSummary(posture, authority, observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, summary) {
+    return {
+        posture,
+        authority,
+        observedWorktreeCount,
+        observedCausalSessionCount,
+        observedActorCount,
+        overlappingPathCount,
+        summary,
+    };
+}
+function withObservedCounts(summary, input) {
+    return {
+        ...summary,
+        observedWorktreeCount: Math.max(summary.observedWorktreeCount, input.observedWorktreeCount),
+        observedCausalSessionCount: Math.max(summary.observedCausalSessionCount, input.observedCausalSessionCount),
+        observedActorCount: Math.max(summary.observedActorCount, input.observedActorCount),
+    };
+}
+function formatDurationMs(durationMs) {
+    if (durationMs % 60000 === 0) {
+        const minutes = durationMs / 60000;
+        return `${String(minutes)} minute${minutes === 1 ? "" : "s"}`;
+    }
+    if (durationMs % 1000 === 0) {
+        const seconds = durationMs / 1000;
+        return `${String(seconds)} second${seconds === 1 ? "" : "s"}`;
+    }
+    return `${String(durationMs)} ms`;
+}
+function appendStaleDaemonSessionSummary(summary, liveness) {
+    if (liveness.staleSessionCount === 0) {
+        return summary;
+    }
+    const noun = liveness.staleSessionCount === 1 ? "session" : "sessions";
+    return `${summary} Excluded ${String(liveness.staleSessionCount)} stale daemon ${noun} idle for longer than ${formatDurationMs(liveness.idleTimeoutMs)}.`;
+}
+function withDaemonSessionLiveness(summary, liveness) {
+    return {
+        ...summary,
+        summary: appendStaleDaemonSessionSummary(summary.summary, liveness),
+        daemonSessionLiveness: liveness,
+    };
+}
+function isStaleDaemonSession(session, nowMs, idleTimeoutMs) {
+    const lastActivityMs = Date.parse(session.lastActivityAt);
+    if (!Number.isFinite(lastActivityMs)) {
+        return true;
+    }
+    return nowMs - lastActivityMs > idleTimeoutMs;
+}
+export function deriveRepoConcurrencySummary(input) {
+    const activeHistories = input.histories.filter((history) => history.active);
+    const current = activeHistories.find((history) => history.worktreeId === input.currentWorktreeId)
+        ?? input.histories.find((history) => history.worktreeId === input.currentWorktreeId)
+        ?? null;
+    if (current === null) {
+        return buildSummary("unknown", "unknown", 0, 0, 0, 0, "No lawful same-repo concurrency evidence is available for the current worktree.");
+    }
+    const observedWorktreeCount = Math.max(1, new Set(activeHistories.map((history) => history.worktreeId)).size);
+    const observedCausalSessionCount = new Set(activeHistories.flatMap((history) => history.causalSessionIds)).size;
+    const observedActorCount = new Set(activeHistories.flatMap((history) => history.actorIds)).size;
+    const overlappingPathCount = countOverlapPaths(current.touches);
+    const otherActiveWorktrees = activeHistories.filter((history) => history.worktreeId !== current.worktreeId);
+    if (otherActiveWorktrees.some((history) => history.checkoutEpochId !== null &&
+        current.checkoutEpochId !== null &&
+        history.checkoutEpochId !== current.checkoutEpochId)) {
+        return buildSummary("divergent_checkout", "active_history_scan", observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, "Active same-repo work appears to be split across different checkout epochs or branches.");
+    }
+    if (current.contributorKeys.length > 1 && overlappingPathCount > 0 && !current.explicitHandoff) {
+        return buildSummary("overlapping_actors", "footprint_overlap", observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, "Multiple contributors appear to touch overlapping paths in the same live worktree without explicit handoff evidence.");
+    }
+    if (current.explicitHandoff && current.contributorKeys.length > 1 && otherActiveWorktrees.length === 0) {
+        return buildSummary("exclusive", "explicit_handoff", observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, "Explicit attach or handoff evidence keeps the current live worktree on one lawful line of work.");
+    }
+    if (current.contributorKeys.length > 1) {
+        return buildSummary("shared_worktree", "active_history_scan", observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, "Multiple contributors have been observed on the current live worktree, so ownership stays shared rather than exclusive.");
+    }
+    if (otherActiveWorktrees.length > 0) {
+        return buildSummary("shared_repo_only", "repo_identity_only", observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, "Other active worktrees share the same canonical repo identity, but not this live worktree footing.");
+    }
+    return buildSummary("exclusive", "active_history_scan", observedWorktreeCount, observedCausalSessionCount, observedActorCount, overlappingPathCount, "No other active same-repo worktree or overlapping actor evidence is currently visible.");
+}
+export function mergeRepoConcurrencySummaryWithLiveSessions(input) {
+    const repoSessions = input.sessions.filter((session) => session.bindState === "bound" &&
+        session.repoId === input.currentRepoId &&
+        session.worktreeId !== null);
+    if (repoSessions.length === 0) {
+        return input.currentSummary;
+    }
+    const nowMs = input.nowMs ?? Date.now();
+    const idleTimeoutMs = input.sessionIdleTimeoutMs ?? DEFAULT_DAEMON_SESSION_IDLE_TIMEOUT_MS;
+    const liveRepoSessions = repoSessions.filter((session) => !isStaleDaemonSession(session, nowMs, idleTimeoutMs));
+    const liveness = {
+        idleTimeoutMs,
+        liveSessionCount: liveRepoSessions.length,
+        staleSessionCount: repoSessions.length - liveRepoSessions.length,
+    };
+    if (liveRepoSessions.length === 0) {
+        return withDaemonSessionLiveness(input.currentSummary, liveness);
+    }
+    const observedWorktreeCount = new Set(liveRepoSessions.map((session) => session.worktreeId)).size;
+    const observedCausalSessionCount = new Set(liveRepoSessions
+        .map((session) => session.causalSessionId)
+        .filter((sessionId) => sessionId !== null)).size;
+    const summaryWithCounts = withDaemonSessionLiveness(withObservedCounts(input.currentSummary, {
+        observedWorktreeCount: Math.max(1, observedWorktreeCount),
+        observedCausalSessionCount,
+        observedActorCount: input.currentSummary.observedActorCount,
+    }), liveness);
+    const currentWorktreeSessions = liveRepoSessions.filter((session) => session.worktreeId === input.currentWorktreeId);
+    const otherWorktreeSessions = liveRepoSessions.filter((session) => session.worktreeId !== input.currentWorktreeId);
+    if (otherWorktreeSessions.some((session) => session.checkoutEpochId !== null &&
+        input.currentCheckoutEpochId !== null &&
+        session.checkoutEpochId !== input.currentCheckoutEpochId)) {
+        return {
+            ...summaryWithCounts,
+            posture: "divergent_checkout",
+            authority: "daemon_live_sessions",
+            summary: "Active same-repo daemon sessions are split across different checkout epochs or branches.",
+        };
+    }
+    if (summaryWithCounts.posture === "overlapping_actors") {
+        return summaryWithCounts;
+    }
+    if (currentWorktreeSessions.length > 1) {
+        if (summaryWithCounts.posture === "exclusive" &&
+            summaryWithCounts.authority === "explicit_handoff" &&
+            otherWorktreeSessions.length === 0) {
+            return summaryWithCounts;
+        }
+        return {
+            ...summaryWithCounts,
+            posture: "shared_worktree",
+            authority: "daemon_live_sessions",
+            summary: "Multiple active daemon sessions share the current live worktree, so ownership stays shared rather than exclusive.",
+        };
+    }
+    if (otherWorktreeSessions.length > 0) {
+        return {
+            ...summaryWithCounts,
+            posture: "shared_repo_only",
+            authority: "daemon_live_sessions",
+            summary: "Other active daemon sessions share the same canonical repo identity, but not this live worktree footing.",
+        };
+    }
+    return summaryWithCounts;
+}
+export function buildRepoConcurrencyContributorKey(input) {
+    if (input.actorId !== null && input.attribution.actor.actorKind !== "unknown") {
+        return `actor:${input.actorId}`;
+    }
+    if (input.causalSessionId !== null) {
+        return `causal:${input.causalSessionId}`;
+    }
+    if (input.transportSessionId !== null) {
+        return `transport:${input.transportSessionId}`;
+    }
+    return null;
+}
+export function buildRepoConcurrencyTouches(events) {
+    const touches = [];
+    for (const event of events) {
+        const contributorKey = buildRepoConcurrencyContributorKey({
+            actorId: event.actorId,
+            attribution: event.attribution,
+            causalSessionId: event.causalSessionId,
+            transportSessionId: event.transportSessionId,
+        });
+        if (contributorKey === null) {
+            continue;
+        }
+        for (const path of event.footprint.paths) {
+            touches.push({ contributorKey, path });
+        }
+    }
+    return touches;
+}
+//# sourceMappingURL=repo-concurrency.js.map

package/dist/mcp/repo-concurrency.js.map

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

package/dist/mcp/repo-overview/filter.d.ts

@@ -0,0 +1,6 @@
+import type { AuthorizedWorkspaceRecord } from "../daemon-control-plane.js";
+import type { DaemonRepoFilter, DaemonRepoListView, DaemonRepoView } from "./types.js";
+export declare function normalizeFilter(filter: DaemonRepoFilter): DaemonRepoFilter;
+export declare function sortAuthorizedWorkspaces(records: readonly AuthorizedWorkspaceRecord[]): readonly AuthorizedWorkspaceRecord[];
+export declare function buildResult(filter: DaemonRepoFilter, repos: readonly DaemonRepoView[]): DaemonRepoListView;
+//# sourceMappingURL=filter.d.ts.map

package/dist/mcp/repo-overview/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/mcp/repo-overview/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMvF,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAS1E;AAMD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAC5C,SAAS,yBAAyB,EAAE,CAEtC;AAMD,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,kBAAkB,CAQpB"}

package/dist/mcp/repo-overview/filter.js

@@ -0,0 +1,32 @@
+// ---------------------------------------------------------------------------
+// Filter normalization
+// ---------------------------------------------------------------------------
+export function normalizeFilter(filter) {
+    const next = {};
+    if (typeof filter.repoId === "string" && filter.repoId.trim().length > 0) {
+        next.repoId = filter.repoId.trim();
+    }
+    if (typeof filter.cwd === "string" && filter.cwd.trim().length > 0) {
+        next.cwd = filter.cwd.trim();
+    }
+    return next;
+}
+// ---------------------------------------------------------------------------
+// Workspace sorting
+// ---------------------------------------------------------------------------
+export function sortAuthorizedWorkspaces(records) {
+    return [...records].sort((left, right) => left.worktreeRoot.localeCompare(right.worktreeRoot));
+}
+// ---------------------------------------------------------------------------
+// Result builders
+// ---------------------------------------------------------------------------
+export function buildResult(filter, repos) {
+    if (Object.keys(filter).length === 0) {
+        return { repos };
+    }
+    return {
+        repos,
+        filter,
+    };
+}
+//# sourceMappingURL=filter.js.map

package/dist/mcp/repo-overview/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/mcp/repo-overview/filter.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,MAAM,IAAI,GAAsC,EAAE,CAAC;IACnD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,UAAU,wBAAwB,CACtC,OAA6C;IAE7C,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CACzB,MAAwB,EACxB,KAAgC;IAEhC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,OAAO;QACL,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/mcp/repo-overview/types.d.ts

@@ -0,0 +1,41 @@
+import type { DaemonControlPlane } from "../daemon-control-plane.js";
+import type { MonitorHealth, MonitorLifecycleState, MonitorWorkerKind, PersistentMonitorRuntime } from "../persistent-monitor-runtime.js";
+export interface DaemonRepoFilter {
+    readonly repoId?: string | undefined;
+    readonly cwd?: string | undefined;
+}
+export interface DaemonRepoWorktreeView {
+    readonly worktreeId: string;
+    readonly worktreeRoot: string;
+    readonly activeSessions: number;
+    readonly lastBoundAt: string | null;
+}
+export interface DaemonRepoMonitorView {
+    readonly workerKind: MonitorWorkerKind;
+    readonly lifecycleState: MonitorLifecycleState;
+    readonly health: MonitorHealth;
+    readonly lastTickAt: string | null;
+    readonly lastSuccessAt: string | null;
+    readonly lastError: string | null;
+}
+export interface DaemonRepoView {
+    readonly repoId: string;
+    readonly gitCommonDir: string;
+    readonly authorizedWorkspaces: number;
+    readonly boundSessions: number;
+    readonly activeWorktrees: number;
+    readonly backlogCommits: number;
+    readonly lastBoundAt: string | null;
+    readonly lastActivityAt: string | null;
+    readonly monitor: DaemonRepoMonitorView | null;
+    readonly worktrees: readonly DaemonRepoWorktreeView[];
+}
+export interface DaemonRepoListView {
+    readonly repos: readonly DaemonRepoView[];
+    readonly filter?: DaemonRepoFilter | undefined;
+}
+export interface DaemonRepoOverviewOptions {
+    readonly controlPlane: DaemonControlPlane;
+    readonly monitorRuntime: PersistentMonitorRuntime;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/repo-overview/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp/repo-overview/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,kCAAkC,CAAC;AAM1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAMD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAChD;AAMD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;CACnD"}

package/dist/mcp/repo-overview/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/repo-overview/types.js.map

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

package/dist/mcp/repo-overview/view-projection.d.ts

@@ -0,0 +1,8 @@
+import type { AuthorizedWorkspaceRecord, DaemonSessionView } from "../daemon-control-plane.js";
+import type { MonitorStatusView } from "../persistent-monitor-runtime.js";
+import type { DaemonRepoMonitorView, DaemonRepoView, DaemonRepoWorktreeView } from "./types.js";
+export declare function maxIsoTimestamp(values: readonly (string | null | undefined)[]): string | null;
+export declare function toWorktreeView(workspace: AuthorizedWorkspaceRecord, repoSessions: readonly DaemonSessionView[]): DaemonRepoWorktreeView;
+export declare function toMonitorView(monitor: MonitorStatusView): DaemonRepoMonitorView;
+export declare function toRepoView(repoId: string, sortedWorkspaces: readonly AuthorizedWorkspaceRecord[], repoSessions: readonly DaemonSessionView[], monitor: MonitorStatusView | null): DaemonRepoView;
+//# sourceMappingURL=view-projection.d.ts.map

package/dist/mcp/repo-overview/view-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-projection.d.ts","sourceRoot":"","sources":["../../../src/mcp/repo-overview/view-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMhG,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,IAAI,CAS7F;AAMD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,yBAAyB,EACpC,YAAY,EAAE,SAAS,iBAAiB,EAAE,GACzC,sBAAsB,CASxB;AAMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,qBAAqB,CAS/E;AAMD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,SAAS,yBAAyB,EAAE,EACtD,YAAY,EAAE,SAAS,iBAAiB,EAAE,EAC1C,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAChC,cAAc,CA4BhB"}