@roackb2/heddle 1.2.0 → 1.3.0

package/dist/src/server/features/control-plane/controllers/chat-turn-review-presenter.js

@@ -0,0 +1,196 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { parseUnifiedDiffFiles } from '../../../../core/review/diff-domain.js';
+import { normalizeCommandText, readBoolean, readNumber, readObject, readString, } from '../helpers/read-values.js';
+export class ControlPlaneChatTurnReviewPresenter {
+    static load(traceFile) {
+        if (!traceFile || !existsSync(traceFile)) {
+            return undefined;
+        }
+        try {
+            const parsed = JSON.parse(readFileSync(traceFile, 'utf8'));
+            if (!Array.isArray(parsed)) {
+                return undefined;
+            }
+            const reviewCommands = [];
+            const verificationCommands = [];
+            const mutationCommands = [];
+            const approvals = [];
+            const files = new Map();
+            let diffExcerpt;
+            let finalSummary;
+            for (const entry of parsed) {
+                const event = readObject(entry);
+                const type = readString(event?.type);
+                if (!event || !type) {
+                    continue;
+                }
+                if (type === 'tool.result') {
+                    const tool = readString(event.tool) ?? 'unknown';
+                    const result = readObject(event.result);
+                    if (tool === 'edit_file' && readBoolean(result?.ok) === true) {
+                        const output = readObject(result?.output);
+                        const file = ControlPlaneChatTurnReviewPresenter.projectEditFileReview(output);
+                        if (file) {
+                            ControlPlaneChatTurnReviewPresenter.addChangedFile(files, file);
+                        }
+                    }
+                    const output = readObject(result?.output);
+                    const evidence = output ? ControlPlaneChatTurnReviewPresenter.projectCommandEvidence(tool, output) : undefined;
+                    if (!evidence) {
+                        continue;
+                    }
+                    if (ControlPlaneChatTurnReviewPresenter.isReviewCommand(evidence.command)) {
+                        reviewCommands.push(evidence);
+                        if (!diffExcerpt && /^git diff(?:\s|$)/.test(evidence.command) && evidence.stdout) {
+                            diffExcerpt = evidence.stdout;
+                        }
+                        if (/^git diff(?:\s|$)/.test(evidence.command) && evidence.stdout) {
+                            for (const file of ControlPlaneChatTurnReviewPresenter.parseGitDiffFiles(evidence.stdout)) {
+                                ControlPlaneChatTurnReviewPresenter.addChangedFile(files, file);
+                            }
+                        }
+                        continue;
+                    }
+                    if (ControlPlaneChatTurnReviewPresenter.isVerificationCommand(evidence.command)) {
+                        verificationCommands.push(evidence);
+                        continue;
+                    }
+                    if (tool === 'run_shell_mutate') {
+                        mutationCommands.push(evidence);
+                    }
+                    continue;
+                }
+                if (type === 'tool.call') {
+                    const call = readObject(event.call);
+                    const tool = readString(call?.tool);
+                    if (tool !== 'edit_file') {
+                        continue;
+                    }
+                    const input = readObject(call?.input);
+                    const path = readString(input?.path);
+                    mutationCommands.push({
+                        tool,
+                        command: path ? `edit_file ${path}` : 'edit_file',
+                    });
+                    continue;
+                }
+                if (type === 'tool.approval_resolved') {
+                    const call = readObject(event.call);
+                    const tool = readString(call?.tool);
+                    if (!tool) {
+                        continue;
+                    }
+                    const input = readObject(call?.input);
+                    approvals.push({
+                        tool,
+                        command: readString(input?.command) ?? readString(input?.path),
+                        approved: readBoolean(event.approved) ?? false,
+                        reason: readString(event.reason),
+                        timestamp: readString(event.timestamp),
+                    });
+                    continue;
+                }
+                if (type === 'run.finished') {
+                    finalSummary = readString(event.summary) ?? finalSummary;
+                }
+            }
+            return {
+                traceFile,
+                diffExcerpt,
+                finalSummary,
+                files: [...files.values()],
+                reviewCommands: ControlPlaneChatTurnReviewPresenter.dedupeEvidence(reviewCommands),
+                verificationCommands: ControlPlaneChatTurnReviewPresenter.dedupeEvidence(verificationCommands),
+                mutationCommands: ControlPlaneChatTurnReviewPresenter.dedupeEvidence(mutationCommands),
+                approvals,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    static projectCommandEvidence(tool, output) {
+        const command = readString(output.command);
+        if (!command) {
+            return undefined;
+        }
+        return {
+            tool,
+            command,
+            exitCode: readNumber(output.exitCode),
+            stdout: normalizeCommandText(readString(output.stdout)),
+            stderr: normalizeCommandText(readString(output.stderr)),
+        };
+    }
+    static dedupeEvidence(evidence) {
+        const seen = new Set();
+        return evidence.filter((entry) => {
+            const key = `${entry.tool}:${entry.command}`;
+            if (seen.has(key)) {
+                return false;
+            }
+            seen.add(key);
+            return true;
+        });
+    }
+    static isReviewCommand(command) {
+        return /^git (?:status\b|diff\b|show\b|branch\b|remote\b)/.test(command);
+    }
+    static isVerificationCommand(command) {
+        return /^(?:yarn|npm|pnpm|bun|vitest|jest|tsx|tsc|go test|cargo test|pytest|ruff|eslint)\b/.test(command);
+    }
+    static projectEditFileReview(output) {
+        if (!output) {
+            return undefined;
+        }
+        const path = readString(output.path);
+        const diff = readObject(output.diff);
+        const patch = normalizeCommandText(readString(diff?.diff));
+        if (!path) {
+            return undefined;
+        }
+        return {
+            path,
+            status: ControlPlaneChatTurnReviewPresenter.statusFromEditAction(readString(output.action)),
+            source: 'edit_file',
+            patch,
+            diff: patch ? parseUnifiedDiffFiles(patch).find((file) => file.path === path || file.oldPath === path) : undefined,
+            truncated: readBoolean(diff?.truncated),
+        };
+    }
+    static statusFromEditAction(action) {
+        switch (action) {
+            case 'created':
+                return 'added';
+            case 'overwritten':
+            case 'replaced':
+                return 'modified';
+            default:
+                return 'unknown';
+        }
+    }
+    static parseGitDiffFiles(diff) {
+        return parseUnifiedDiffFiles(diff).map((file) => ({
+            path: file.path,
+            status: file.status === 'copied' ? 'modified' : file.status,
+            source: 'git_diff',
+            patch: normalizeCommandText(file.patch),
+            diff: file,
+            truncated: file.binary === true,
+        }));
+    }
+    static addChangedFile(files, file) {
+        const existing = files.get(file.path);
+        if (!existing) {
+            files.set(file.path, file);
+            return;
+        }
+        if (existing.source === 'edit_file') {
+            return;
+        }
+        if (file.source === 'edit_file' || (!existing.patch && file.patch)) {
+            files.set(file.path, file);
+        }
+    }
+}
+//# sourceMappingURL=chat-turn-review-presenter.js.map

package/dist/src/server/features/control-plane/controllers/chat-turn-review-presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-turn-review-presenter.js","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/chat-turn-review-presenter.ts"],"names":[],"mappings":"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"}

package/dist/src/server/features/control-plane/controllers/control-plane-state.d.ts

@@ -0,0 +1,7 @@
+import type { HeddleServerContext } from '../../../types.js';
+import type { ControlPlaneState } from '../types.js';
+export declare class ControlPlaneStateController {
+    static load(context: HeddleServerContext): Promise<ControlPlaneState>;
+    private static readKnownWorkspaces;
+}
+//# sourceMappingURL=control-plane-state.d.ts.map

package/dist/src/server/features/control-plane/controllers/control-plane-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-state.d.ts","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/control-plane-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,qBAAa,2BAA2B;WACzB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqC3E,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAoBnC"}

package/dist/src/server/features/control-plane/controllers/control-plane-state.js

@@ -0,0 +1,64 @@
+import { resolve } from 'node:path';
+import { readDaemonRegistry, registerKnownWorkspaces, resolveDaemonRegistryPath } from '../../../../core/runtime/daemon-registry.js';
+import { resolveProviderCredentialSourceForModel } from '../../../../core/runtime/api-keys.js';
+import { controlPlaneChatSessionsController } from './chat-sessions-controller.js';
+import { ControlPlaneHeartbeatController } from './heartbeat.js';
+import { ControlPlaneMemoryController } from './memory.js';
+export class ControlPlaneStateController {
+    static async load(context) {
+        const workspaceRoot = context.activeWorkspace.anchorRoot;
+        const stateRoot = context.activeWorkspace.stateRoot;
+        const [tasks, runs, memory] = await Promise.all([
+            ControlPlaneHeartbeatController.listTasks(stateRoot),
+            ControlPlaneHeartbeatController.listRuns(stateRoot, { limit: 20 }),
+            ControlPlaneMemoryController.readStatus(stateRoot),
+        ]);
+        return {
+            workspaceRoot,
+            stateRoot,
+            auth: {
+                preferApiKey: context.preferApiKey,
+                openai: resolveProviderCredentialSourceForModel('gpt-5.4', { preferApiKey: context.preferApiKey }),
+                anthropic: resolveProviderCredentialSourceForModel('claude-sonnet-4-6', { preferApiKey: context.preferApiKey }),
+            },
+            activeWorkspaceId: context.activeWorkspaceId,
+            workspace: context.activeWorkspace,
+            workspaces: context.workspaces,
+            knownWorkspaces: ControlPlaneStateController.readKnownWorkspaces(context),
+            runtimeHost: context.runtimeHost,
+            sessions: controlPlaneChatSessionsController.readViews({
+                workspaceRoot,
+                stateRoot,
+                sessionStoragePath: resolve(stateRoot, 'chat-sessions.catalog.json'),
+                preferApiKey: context.preferApiKey,
+                workspaceId: context.activeWorkspace.id,
+            }),
+            heartbeat: {
+                tasks,
+                runs,
+            },
+            memory,
+        };
+    }
+    static readKnownWorkspaces(context) {
+        const registryPath = context.runtimeHost?.registryPath ?? resolveDaemonRegistryPath();
+        registerKnownWorkspaces({
+            registryPath,
+            workspaces: context.workspaces,
+        });
+        const current = new Set(context.workspaces.map((workspace) => resolve(workspace.stateRoot)));
+        const known = new Map();
+        for (const record of readDaemonRegistry(registryPath).workspaces) {
+            const stateRoot = resolve(record.workspace.stateRoot);
+            if (current.has(stateRoot)) {
+                continue;
+            }
+            const existing = known.get(stateRoot);
+            if (!existing || (record.workspace.updatedAt ?? '') > (existing.updatedAt ?? '')) {
+                known.set(stateRoot, record.workspace);
+            }
+        }
+        return Array.from(known.values()).sort((left, right) => (right.updatedAt ?? '').localeCompare(left.updatedAt ?? ''));
+    }
+}
+//# sourceMappingURL=control-plane-state.js.map

package/dist/src/server/features/control-plane/controllers/control-plane-state.js.map

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

package/dist/src/server/features/control-plane/controllers/heartbeat.d.ts

@@ -0,0 +1,12 @@
+export declare class ControlPlaneHeartbeatController {
+    static createStore(stateRoot: string): import("../../../../index.js").HeartbeatTaskStore;
+    static listTasks(stateRoot: string): Promise<import("../../../../index.js").HeartbeatTaskView[]>;
+    static listRuns(stateRoot: string, options?: {
+        taskId?: string;
+        limit?: number;
+    }): Promise<import("../../../../index.js").HeartbeatRunView[]>;
+    static setTaskEnabled(stateRoot: string, taskId: string, enabled: boolean): Promise<import("../../../../index.js").HeartbeatTaskView>;
+    static triggerTaskRun(stateRoot: string, taskId: string): Promise<import("../../../../index.js").HeartbeatTaskView>;
+    private static loadTaskById;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/src/server/features/control-plane/controllers/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/heartbeat.ts"],"names":[],"mappings":"AASA,qBAAa,+BAA+B;IAC1C,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM;WAIvB,SAAS,CAAC,SAAS,EAAE,MAAM;WAI3B,QAAQ,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;WAKtC,cAAc,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO;WAoBL,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;mBAuBxC,YAAY;CAWlC"}

package/dist/src/server/features/control-plane/controllers/heartbeat.js

@@ -0,0 +1,59 @@
+import { resolve } from 'node:path';
+import { createFileHeartbeatTaskStore, listHeartbeatRunViews, listHeartbeatTaskViews, projectHeartbeatTaskView, } from '../../../../index.js';
+export class ControlPlaneHeartbeatController {
+    static createStore(stateRoot) {
+        return createFileHeartbeatTaskStore({ dir: resolve(stateRoot, 'heartbeat') });
+    }
+    static async listTasks(stateRoot) {
+        return await listHeartbeatTaskViews(ControlPlaneHeartbeatController.createStore(stateRoot));
+    }
+    static async listRuns(stateRoot, options = {}) {
+        return await listHeartbeatRunViews(ControlPlaneHeartbeatController.createStore(stateRoot), options);
+    }
+    static async setTaskEnabled(stateRoot, taskId, enabled) {
+        const store = ControlPlaneHeartbeatController.createStore(stateRoot);
+        const task = await ControlPlaneHeartbeatController.loadTaskById(store, taskId);
+        const now = new Date();
+        const status = enabled ? (task.status ?? 'waiting') : (task.status === 'running' ? 'running' : 'idle');
+        const nextTask = {
+            ...task,
+            enabled,
+            status,
+            nextRunAt: enabled ?
+                task.nextRunAt ?? new Date(now.getTime() - 1_000).toISOString()
+                : undefined,
+            updatedAt: now.toISOString(),
+        };
+        await store.saveTask(nextTask);
+        return projectHeartbeatTaskView(nextTask);
+    }
+    static async triggerTaskRun(stateRoot, taskId) {
+        const store = ControlPlaneHeartbeatController.createStore(stateRoot);
+        const task = await ControlPlaneHeartbeatController.loadTaskById(store, taskId);
+        if (!task.enabled) {
+            throw new Error(`Heartbeat task ${taskId} is disabled. Enable it before triggering a run.`);
+        }
+        const now = new Date();
+        const status = task.status === 'running' ? 'running' : 'waiting';
+        const nextTask = {
+            ...task,
+            status,
+            lastProgress: task.status === 'running' ?
+                task.lastProgress
+                : 'Task manually triggered from control plane. Waiting for the next heartbeat worker poll.',
+            nextRunAt: new Date(now.getTime() - 1_000).toISOString(),
+            updatedAt: now.toISOString(),
+        };
+        await store.saveTask(nextTask);
+        return projectHeartbeatTaskView(nextTask);
+    }
+    static async loadTaskById(store, taskId) {
+        const tasks = await store.listTasks();
+        const task = tasks.find((candidate) => candidate.id === taskId);
+        if (!task) {
+            throw new Error(`Heartbeat task not found: ${taskId}`);
+        }
+        return task;
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/src/server/features/control-plane/controllers/heartbeat.js.map

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

package/dist/src/server/features/control-plane/controllers/layout-snapshots.d.ts

@@ -0,0 +1,13 @@
+export type SavedLayoutSnapshot = {
+    jsonPath: string;
+    screenshotPath?: string;
+};
+export declare class ControlPlaneLayoutSnapshotsController {
+    static save(stateRoot: string, snapshot: unknown): Promise<SavedLayoutSnapshot>;
+    private static persistScreenshot;
+    private static deriveSnapshotLabel;
+    private static sanitizeFilenamePart;
+    private static cloneJsonRecord;
+    private static isRecord;
+}
+//# sourceMappingURL=layout-snapshots.d.ts.map

package/dist/src/server/features/control-plane/controllers/layout-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-snapshots.d.ts","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/layout-snapshots.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAOF,qBAAa,qCAAqC;WACnC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;mBAqBhE,iBAAiB;IA2BtC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAWlC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IASnC,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B,OAAO,CAAC,MAAM,CAAC,QAAQ;CAGxB"}

package/dist/src/server/features/control-plane/controllers/layout-snapshots.js

@@ -0,0 +1,70 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const SNAPSHOT_DIR = 'debug/dom-snapshots';
+const DATA_URL_PATTERN = /^data:image\/png;base64,([A-Za-z0-9+/=]+)$/;
+export class ControlPlaneLayoutSnapshotsController {
+    static async save(stateRoot, snapshot) {
+        if (!ControlPlaneLayoutSnapshotsController.isRecord(snapshot)) {
+            throw new Error('Layout snapshot payload must be an object.');
+        }
+        const outputDir = join(stateRoot, SNAPSHOT_DIR);
+        await mkdir(outputDir, { recursive: true });
+        const capturedAt = typeof snapshot.capturedAt === 'string' ? snapshot.capturedAt : new Date().toISOString();
+        const timestamp = ControlPlaneLayoutSnapshotsController.sanitizeFilenamePart(capturedAt.replaceAll(':', '-'));
+        const label = ControlPlaneLayoutSnapshotsController.deriveSnapshotLabel(snapshot);
+        const basename = `${timestamp}-${label}`;
+        const jsonPath = join(outputDir, `${basename}.json`);
+        const persistedSnapshot = ControlPlaneLayoutSnapshotsController.cloneJsonRecord(snapshot);
+        const screenshotPath = await ControlPlaneLayoutSnapshotsController.persistScreenshot(outputDir, basename, persistedSnapshot);
+        await writeFile(jsonPath, `${JSON.stringify(persistedSnapshot, null, 2)}\n`, 'utf8');
+        return screenshotPath ? { jsonPath, screenshotPath } : { jsonPath };
+    }
+    static async persistScreenshot(outputDir, basename, snapshot) {
+        const screenshot = snapshot.screenshot;
+        if (!ControlPlaneLayoutSnapshotsController.isRecord(screenshot) || screenshot.status !== 'captured' || typeof screenshot.dataUrl !== 'string') {
+            return undefined;
+        }
+        const match = DATA_URL_PATTERN.exec(screenshot.dataUrl);
+        if (!match?.[1]) {
+            snapshot.screenshot = {
+                ...screenshot,
+                status: 'failed',
+                reason: 'Screenshot data URL was not a PNG image.',
+                dataUrl: undefined,
+            };
+            return undefined;
+        }
+        const screenshotPath = join(outputDir, `${basename}.png`);
+        await writeFile(screenshotPath, Buffer.from(match[1], 'base64'));
+        snapshot.screenshot = {
+            ...screenshot,
+            path: screenshotPath,
+            dataUrl: undefined,
+        };
+        return screenshotPath;
+    }
+    static deriveSnapshotLabel(snapshot) {
+        const appState = ControlPlaneLayoutSnapshotsController.isRecord(snapshot.appState) ? snapshot.appState : {};
+        const parts = [
+            typeof appState.activeTab === 'string' ? appState.activeTab : 'control-plane',
+            typeof appState.selectedSessionId === 'string' ? appState.selectedSessionId : undefined,
+            ControlPlaneLayoutSnapshotsController.isRecord(appState.pendingApproval) && typeof appState.pendingApproval.tool === 'string' ? `approval-${appState.pendingApproval.tool}` : undefined,
+        ].filter((part) => Boolean(part));
+        return ControlPlaneLayoutSnapshotsController.sanitizeFilenamePart(parts.join('-')) || 'snapshot';
+    }
+    static sanitizeFilenamePart(value) {
+        return value
+            .toLowerCase()
+            .replace(/[^a-z0-9._-]+/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 120);
+    }
+    static cloneJsonRecord(value) {
+        return JSON.parse(JSON.stringify(value));
+    }
+    static isRecord(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    }
+}
+//# sourceMappingURL=layout-snapshots.js.map

package/dist/src/server/features/control-plane/controllers/layout-snapshots.js.map

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

package/dist/src/server/features/control-plane/controllers/memory.d.ts

@@ -0,0 +1,25 @@
+export declare class ControlPlaneMemoryController {
+    static readStatus(stateRoot: string): Promise<import("../../../../core/memory/visibility.js").MemoryStatusView>;
+    static listNotes(stateRoot: string, path?: string): Promise<{
+        memoryRoot: string;
+        notes: string[];
+    }>;
+    static readNote(stateRoot: string, path: string, options?: {
+        offset?: number;
+        maxLines?: number;
+    }): Promise<{
+        memoryRoot: string;
+        path: string;
+        content: string;
+    }>;
+    static searchNotes(stateRoot: string, query: string, options?: {
+        path?: string;
+        maxResults?: number;
+    }): Promise<{
+        memoryRoot: string;
+        query: string;
+        matches: string;
+    }>;
+    private static memoryRoot;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/server/features/control-plane/controllers/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/memory.ts"],"names":[],"mappings":"AAQA,qBAAa,4BAA4B;WAC1B,UAAU,CAAC,SAAS,EAAE,MAAM;WAI5B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;;;;WAQ1C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;WAc1F,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;IAc3G,OAAO,CAAC,MAAM,CAAC,UAAU;CAG1B"}

package/dist/src/server/features/control-plane/controllers/memory.js

@@ -0,0 +1,44 @@
+import { resolve } from 'node:path';
+import { listMemoryNotePaths, loadMemoryStatus, readMemoryNote, searchMemoryNotes, } from '../../../../core/memory/visibility.js';
+export class ControlPlaneMemoryController {
+    static async readStatus(stateRoot) {
+        return await loadMemoryStatus({ memoryRoot: ControlPlaneMemoryController.memoryRoot(stateRoot) });
+    }
+    static async listNotes(stateRoot, path) {
+        const memoryRoot = ControlPlaneMemoryController.memoryRoot(stateRoot);
+        return {
+            memoryRoot,
+            notes: await listMemoryNotePaths({ memoryRoot, path }),
+        };
+    }
+    static async readNote(stateRoot, path, options) {
+        const memoryRoot = ControlPlaneMemoryController.memoryRoot(stateRoot);
+        return {
+            memoryRoot,
+            path,
+            content: await readMemoryNote({
+                memoryRoot,
+                path,
+                offset: options?.offset,
+                maxLines: options?.maxLines,
+            }),
+        };
+    }
+    static async searchNotes(stateRoot, query, options) {
+        const memoryRoot = ControlPlaneMemoryController.memoryRoot(stateRoot);
+        return {
+            memoryRoot,
+            query,
+            matches: await searchMemoryNotes({
+                memoryRoot,
+                query,
+                path: options?.path,
+                maxResults: options?.maxResults,
+            }),
+        };
+    }
+    static memoryRoot(stateRoot) {
+        return resolve(stateRoot, 'memory');
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/server/features/control-plane/controllers/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,OAAO,4BAA4B;IACvC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAiB;QACvC,OAAO,MAAM,gBAAgB,CAAC,EAAE,UAAU,EAAE,4BAA4B,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,IAAa;QACrD,MAAM,UAAU,GAAG,4BAA4B,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACtE,OAAO;YACL,UAAU;YACV,KAAK,EAAE,MAAM,mBAAmB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAAY,EAAE,OAAgD;QACrG,MAAM,UAAU,GAAG,4BAA4B,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACtE,OAAO;YACL,UAAU;YACV,IAAI;YACJ,OAAO,EAAE,MAAM,cAAc,CAAC;gBAC5B,UAAU;gBACV,IAAI;gBACJ,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC5B,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,KAAa,EAAE,OAAgD;QACzG,MAAM,UAAU,GAAG,4BAA4B,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACtE,OAAO;YACL,UAAU;YACV,KAAK;YACL,OAAO,EAAE,MAAM,iBAAiB,CAAC;gBAC/B,UAAU;gBACV,KAAK;gBACL,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,UAAU,EAAE,OAAO,EAAE,UAAU;aAChC,CAAC;SACH,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,SAAiB;QACzC,OAAO,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/src/server/features/control-plane/controllers/workspace-diff.d.ts

@@ -0,0 +1,18 @@
+import type { WorkspaceChangesView, WorkspaceFileDiffView } from '../types.js';
+export declare class ControlPlaneWorkspaceDiffController {
+    static readChanges(workspaceRoot: string): Promise<WorkspaceChangesView>;
+    static readFileDiff(workspaceRoot: string, path: string): Promise<WorkspaceFileDiffView>;
+    private static isHeddleStatePath;
+    private static ensureGitWorkspace;
+    private static readDiffStats;
+    private static parsePorcelainStatus;
+    private static statusFromPorcelain;
+    private static normalizeStatusCode;
+    private static resolveWorkspacePath;
+    private static isReadableUntrackedFile;
+    private static rewriteNoIndexPatchPaths;
+    private static truncatePatch;
+    private static normalizeError;
+    private static runGit;
+}
+//# sourceMappingURL=workspace-diff.d.ts.map

package/dist/src/server/features/control-plane/controllers/workspace-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-diff.d.ts","sourceRoot":"","sources":["../../../../../../src/server/features/control-plane/controllers/workspace-diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAiBrB,qBAAa,mCAAmC;WACjC,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;WA4CjE,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoD9F,OAAO,CAAC,MAAM,CAAC,iBAAiB;mBAIX,kBAAkB;mBAWlB,aAAa;IA8BlC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmCnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAsBlC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAenC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAYtC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAYvC,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B,OAAO,CAAC,MAAM,CAAC,MAAM;CAiBtB"}