@jterrats/open-orchestra 1.0.17 → 1.1.0

package/dist/chat-storage-local.js

@@ -0,0 +1,114 @@
+import path from "node:path";
+import { assertMatchingScope, assertThreadMessageScope, assertValidChatMessage, assertValidChatThread, CHAT_SCHEMA_VERSION, ChatStorageError, safeStorageIssue, } from "./chat-storage.js";
+export { encodeStorageIdentifier } from "./chat-storage-local-paths.js";
+import { LocalChatStorageFiles } from "./chat-storage-local-files.js";
+import { applyLimit, isExactScope, notFound, } from "./chat-storage-local-records.js";
+import { redactedMessage, threadExportRecord, tombstonedMessage, tombstonedThread, } from "./chat-storage-local-projection.js";
+export function createLocalChatStorage(options) {
+    return new LocalChatStorage(options.workspaceRoot);
+}
+class LocalChatStorage {
+    workspaceRoot;
+    files;
+    constructor(workspaceRoot) {
+        this.workspaceRoot = path.resolve(workspaceRoot);
+        this.files = new LocalChatStorageFiles(this.workspaceRoot);
+    }
+    async initializeChatStorage(scope) {
+        await this.files.ensureScope(scope);
+        await this.files.readManifest(scope);
+        const threads = await this.files.projectThreads(scope);
+        const messages = await this.files.projectMessages(scope);
+        return {
+            schemaVersion: CHAT_SCHEMA_VERSION,
+            scope,
+            threads: threads.filter((thread) => isExactScope(scope, thread.scope))
+                .length,
+            messages: messages.filter((message) => isExactScope(scope, message.scope))
+                .length,
+        };
+    }
+    async createThread(scope, thread) {
+        assertMatchingScope(scope, thread.scope, "thread.scope");
+        assertValidChatThread(thread);
+        await this.files.ensureScope(scope);
+        const threads = await this.files.projectThreads(scope);
+        if (threads.some((entry) => entry.id === thread.id)) {
+            throw new ChatStorageError(safeStorageIssue("duplicate_record", "thread.id", "Chat thread already exists."));
+        }
+        await this.files.appendThread(scope, thread);
+        return thread;
+    }
+    async appendMessage(scope, message) {
+        assertMatchingScope(scope, message.scope, "message.scope");
+        assertValidChatMessage(message);
+        const thread = await this.getThread(scope, message.threadId);
+        if (!thread) {
+            throw new ChatStorageError(safeStorageIssue("not_found", "message.threadId", "Chat thread was not found."));
+        }
+        assertThreadMessageScope(thread, message);
+        const messages = await this.files.projectMessages(scope);
+        if (messages.some((entry) => entry.id === message.id)) {
+            throw new ChatStorageError(safeStorageIssue("duplicate_record", "message.id", "Chat message already exists."));
+        }
+        if (messages.some((entry) => entry.threadId === message.threadId &&
+            entry.sequence === message.sequence)) {
+            throw new ChatStorageError(safeStorageIssue("duplicate_record", "message.sequence", "Chat message sequence already exists in this thread."));
+        }
+        await this.files.appendMessage(scope, message);
+        return message;
+    }
+    async listThreads(scope, options = {}) {
+        await this.initializeChatStorage(scope);
+        const threads = applyLimit((await this.files.projectThreads(scope)).filter((thread) => isExactScope(scope, thread.scope)), options, scope);
+        return {
+            threads: threads.items,
+            ...(threads.nextCursor ? { nextCursor: threads.nextCursor } : {}),
+        };
+    }
+    async getThread(scope, threadId) {
+        await this.initializeChatStorage(scope);
+        return ((await this.files.projectThreads(scope)).find((thread) => thread.id === threadId && isExactScope(scope, thread.scope)) ?? null);
+    }
+    async listMessages(scope, threadId, options = {}) {
+        await this.initializeChatStorage(scope);
+        const messages = applyLimit((await this.files.projectMessages(scope)).filter((message) => message.threadId === threadId && isExactScope(scope, message.scope)), options, scope, threadId);
+        return {
+            messages: messages.items,
+            ...(messages.nextCursor ? { nextCursor: messages.nextCursor } : {}),
+        };
+    }
+    async redactMessage(scope, messageId, redaction) {
+        const message = await this.files.findMessage(scope, messageId);
+        const redacted = redactedMessage(message, redaction);
+        assertValidChatMessage(redacted);
+        await this.files.appendMessage(scope, redacted);
+        return redacted;
+    }
+    async tombstoneThread(scope, threadId, deletion) {
+        const thread = await this.getThread(scope, threadId);
+        if (!thread) {
+            throw notFound("thread.id", "Chat thread was not found.");
+        }
+        const tombstoned = tombstonedThread(thread, deletion);
+        assertValidChatThread(tombstoned);
+        await this.files.appendThread(scope, tombstoned);
+        return tombstoned;
+    }
+    async tombstoneMessage(scope, messageId, deletion) {
+        const message = await this.files.findMessage(scope, messageId);
+        const tombstoned = tombstonedMessage(message, deletion);
+        assertValidChatMessage(tombstoned);
+        await this.files.appendMessage(scope, tombstoned);
+        return tombstoned;
+    }
+    async exportThread(scope, threadId, options) {
+        const thread = await this.getThread(scope, threadId);
+        if (!thread) {
+            throw notFound("thread.id", "Chat thread was not found.");
+        }
+        const messages = (await this.listMessages(scope, threadId)).messages.filter((message) => options.includeTombstoned || message.contentState !== "tombstoned");
+        return threadExportRecord({ scope, thread, messages, options });
+    }
+}
+//# sourceMappingURL=chat-storage-local.js.map

package/dist/chat-storage-local.js.map

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

package/dist/chat-storage-validation.d.ts

@@ -0,0 +1,10 @@
+import { type ChatValidationResult } from "./chat-storage-errors.js";
+import type { ChatMessage, ChatScope, ChatThread } from "./types/chat.js";
+export declare const CHAT_SCHEMA_VERSION = 1;
+export declare function validateChatThread(thread: ChatThread): ChatValidationResult<ChatThread>;
+export declare function validateChatMessage(message: ChatMessage): ChatValidationResult<ChatMessage>;
+export declare function assertValidChatThread(thread: ChatThread): void;
+export declare function assertValidChatMessage(message: ChatMessage): void;
+export declare function assertMatchingScope(expected: ChatScope, actual: ChatScope, field?: string): void;
+export declare function assertThreadMessageScope(thread: ChatThread, message: ChatMessage): void;
+export declare function isSameScope(left: ChatScope, right: ChatScope): boolean;

package/dist/chat-storage-validation.js

@@ -0,0 +1,100 @@
+import { genericInvalidIssue, safeStorageIssue, ChatStorageError, } from "./chat-storage-errors.js";
+import { validateActor } from "./chat-storage-actor-validation.js";
+import { validateContentPolicy, validateDeletion, validateExport, validateRetention, } from "./chat-storage-content-policy.js";
+export const CHAT_SCHEMA_VERSION = 1;
+export function validateChatThread(thread) {
+    const issues = baseRecordIssues("thread", thread);
+    issues.push(...validateContentPolicy("thread", thread));
+    return issues.length > 0
+        ? { ok: false, issues }
+        : { ok: true, value: thread };
+}
+export function validateChatMessage(message) {
+    const issues = baseRecordIssues("message", message);
+    if (!message.threadId) {
+        issues.push(safeStorageIssue("invalid_scope", "message.threadId", "Thread id is required."));
+    }
+    if (!Number.isSafeInteger(message.sequence) || message.sequence < 1) {
+        issues.push(safeStorageIssue("invalid_scope", "message.sequence", "Message sequence must be a positive safe integer."));
+    }
+    issues.push(...validateContentPolicy("message", message));
+    return issues.length > 0
+        ? { ok: false, issues }
+        : { ok: true, value: message };
+}
+export function assertValidChatThread(thread) {
+    const result = validateChatThread(thread);
+    if (!result.ok) {
+        throw new ChatStorageError(result.issues[0] ?? genericInvalidIssue());
+    }
+}
+export function assertValidChatMessage(message) {
+    const result = validateChatMessage(message);
+    if (!result.ok) {
+        throw new ChatStorageError(result.issues[0] ?? genericInvalidIssue());
+    }
+}
+export function assertMatchingScope(expected, actual, field = "scope") {
+    const missing = validateScope(expected, "request.scope");
+    if (missing.length > 0) {
+        throw new ChatStorageError(missing[0] ?? genericInvalidIssue());
+    }
+    if (!isSameScope(expected, actual)) {
+        throw new ChatStorageError(safeStorageIssue("scope_mismatch", field, "Chat record scope must match request scope."));
+    }
+}
+export function assertThreadMessageScope(thread, message) {
+    if (thread.id !== message.threadId ||
+        !isSameScope(thread.scope, message.scope)) {
+        throw new ChatStorageError(safeStorageIssue("scope_mismatch", "message.scope", "Chat message scope must match its thread scope."));
+    }
+}
+export function isSameScope(left, right) {
+    return (left.tenantId === right.tenantId &&
+        left.workspaceId === right.workspaceId &&
+        left.taskId === right.taskId &&
+        left.runId === right.runId &&
+        left.phase === right.phase &&
+        left.sessionId === right.sessionId);
+}
+function baseRecordIssues(recordName, record) {
+    const issues = [];
+    if (record.schemaVersion !== CHAT_SCHEMA_VERSION) {
+        issues.push(safeStorageIssue("unsupported_schema_version", `${recordName}.schemaVersion`, "Chat record schema version is not supported."));
+    }
+    if (!record.id) {
+        issues.push(safeStorageIssue("invalid_scope", `${recordName}.id`, "Chat record id is required."));
+    }
+    issues.push(...validateScope(record.scope, `${recordName}.scope`));
+    issues.push(...validateActor(record.actor, `${recordName}.actor`));
+    if (!record.provenance) {
+        issues.push(safeStorageIssue("invalid_provenance", `${recordName}.provenance`, "Chat provenance is required."));
+    }
+    else {
+        for (const field of [
+            "sourceKind",
+            "sourceId",
+            "createdAt",
+            "observedAt",
+        ]) {
+            if (!record.provenance[field]) {
+                issues.push(safeStorageIssue("invalid_provenance", `${recordName}.provenance.${field}`, "Chat provenance field is required."));
+            }
+        }
+    }
+    issues.push(...validateRetention(record.retention, `${recordName}.retention`));
+    issues.push(...validateExport(record.export, `${recordName}.export`));
+    issues.push(...validateDeletion(record.delete, `${recordName}.delete`));
+    return issues;
+}
+function validateScope(scope, field) {
+    if (!scope) {
+        return [
+            safeStorageIssue("invalid_scope", field, "Chat scope is required."),
+        ];
+    }
+    return ["tenantId", "workspaceId", "taskId", "runId", "phase", "sessionId"]
+        .filter((key) => !scope[key])
+        .map((key) => safeStorageIssue("invalid_scope", `${field}.${key}`, "Chat scope field is required."));
+}
+//# sourceMappingURL=chat-storage-validation.js.map

package/dist/chat-storage-validation.js.map

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

package/dist/chat-storage.d.ts

@@ -0,0 +1,16 @@
+export { ChatStorageError, genericInvalidIssue, safeStorageIssue, type ChatStorageErrorCode, type ChatValidationIssue, type ChatValidationResult, } from "./chat-storage-errors.js";
+export { isKnownChatActorKind, validateActor, } from "./chat-storage-actor-validation.js";
+export { CHAT_SCHEMA_VERSION, assertMatchingScope, assertThreadMessageScope, assertValidChatMessage, assertValidChatThread, isSameScope, validateChatMessage, validateChatThread, } from "./chat-storage-validation.js";
+import type { ChatDeleteMetadata, ChatExportOptions, ChatExportRecord, ChatListOptions, ChatMessage, ChatMessageListResult, ChatRedactionMetadata, ChatScope, ChatStorageState, ChatThread, ChatThreadListResult } from "./types/chat.js";
+export interface ChatStorage {
+    initializeChatStorage(scope: ChatScope): Promise<ChatStorageState>;
+    createThread(scope: ChatScope, thread: ChatThread): Promise<ChatThread>;
+    appendMessage(scope: ChatScope, message: ChatMessage): Promise<ChatMessage>;
+    listThreads(scope: ChatScope, options?: ChatListOptions): Promise<ChatThreadListResult>;
+    getThread(scope: ChatScope, threadId: string): Promise<ChatThread | null>;
+    listMessages(scope: ChatScope, threadId: string, options?: ChatListOptions): Promise<ChatMessageListResult>;
+    redactMessage(scope: ChatScope, messageId: string, redaction: ChatRedactionMetadata): Promise<ChatMessage>;
+    tombstoneThread(scope: ChatScope, threadId: string, deletion: ChatDeleteMetadata): Promise<ChatThread>;
+    tombstoneMessage(scope: ChatScope, messageId: string, deletion: ChatDeleteMetadata): Promise<ChatMessage>;
+    exportThread(scope: ChatScope, threadId: string, options: ChatExportOptions): Promise<ChatExportRecord>;
+}

package/dist/chat-storage.js

@@ -0,0 +1,4 @@
+export { ChatStorageError, genericInvalidIssue, safeStorageIssue, } from "./chat-storage-errors.js";
+export { isKnownChatActorKind, validateActor, } from "./chat-storage-actor-validation.js";
+export { CHAT_SCHEMA_VERSION, assertMatchingScope, assertThreadMessageScope, assertValidChatMessage, assertValidChatThread, isSameScope, validateChatMessage, validateChatThread, } from "./chat-storage-validation.js";
+//# sourceMappingURL=chat-storage.js.map

package/dist/chat-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-storage.js","sourceRoot":"","sources":["../src/chat-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC"}

package/dist/chat-workflow-timeline.d.ts

@@ -0,0 +1,17 @@
+import type { ChatMessage, ChatScope } from "./types/chat.js";
+export declare function listWorkflowTimelineMessages({ root, scope, threadId, }: {
+    root: string;
+    scope: ChatScope;
+    threadId: string;
+}): Promise<ChatMessage[]>;
+export declare function mergeTimelineMessages({ storedMessages, workflowMessages, scope, threadId, limit, cursor, }: {
+    storedMessages: ChatMessage[];
+    workflowMessages: ChatMessage[];
+    scope: ChatScope;
+    threadId: string;
+    limit?: number;
+    cursor?: string;
+}): {
+    messages: ChatMessage[];
+    nextCursor?: string;
+};

package/dist/chat-workflow-timeline.js

@@ -0,0 +1,210 @@
+import { exportPolicy, retention } from "./chat-api-records.js";
+import { paginateChatRecords } from "./chat-pagination.js";
+import { readEvents } from "./workspace.js";
+const TIMELINE_EVENT_TYPES = new Set([
+    "EVIDENCE_ADDED",
+    "REVIEW_RECORDED",
+    "GATE_APPROVED",
+    "GATE_BLOCKED",
+    "RUNTIME_DELEGATION_SESSION_PLANNED",
+    "RUNTIME_SPAWN_REQUEST_RENDERED",
+    "RUNTIME_DELEGATION_SESSION_QUEUED",
+    "RUNTIME_DELEGATION_SESSION_SPAWNED",
+    "RUNTIME_DELEGATION_SESSION_ACTIVE",
+    "RUNTIME_DELEGATION_SESSION_COMPLETED",
+    "RUNTIME_DELEGATION_SESSION_FAILED",
+    "RUNTIME_DELEGATION_SESSION_TIMED_OUT",
+    "RUNTIME_DELEGATION_SESSION_CANCELED",
+    "RUNTIME_DELEGATION_SESSION_CLOSED",
+]);
+export async function listWorkflowTimelineMessages({ root, scope, threadId, }) {
+    const events = await readEvents(root);
+    return events
+        .filter((event) => isTimelineEvent(event))
+        .filter((event) => event.taskId === scope.taskId)
+        .filter((event) => matchesRun(event, scope.runId))
+        .sort(compareTimelineEvents)
+        .map((event, index) => projectTimelineMessage(event, scope, threadId, index));
+}
+export function mergeTimelineMessages({ storedMessages, workflowMessages, scope, threadId, limit, cursor, }) {
+    const merged = [...storedMessages, ...workflowMessages]
+        .sort(compareTimelineMessages)
+        .map((message, index) => ({
+        ...message,
+        sequence: index + 1,
+    }));
+    const page = paginateChatRecords(merged, {
+        ...(limit !== undefined ? { limit } : {}),
+        ...(cursor ? { cursor } : {}),
+    }, scope, threadId);
+    return {
+        messages: page.items,
+        ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),
+    };
+}
+function isTimelineEvent(event) {
+    return (event.type.startsWith("AUTONOMOUS_") || TIMELINE_EVENT_TYPES.has(event.type));
+}
+function matchesRun(event, expectedRunId) {
+    const runId = timelineRunId(event);
+    return !runId || runId === expectedRunId;
+}
+function compareTimelineEvents(left, right) {
+    return (left.timestamp.localeCompare(right.timestamp) ||
+        left.id.localeCompare(right.id));
+}
+function compareTimelineMessages(left, right) {
+    return (left.createdAt.localeCompare(right.createdAt) ||
+        left.id.localeCompare(right.id));
+}
+function projectTimelineMessage(event, scope, threadId, index) {
+    const runtime = runtimeSource(event);
+    const sessionId = stringMetadata(event, "sessionId");
+    const role = stringMetadata(event, "role");
+    const timelineEvent = {
+        sourceEventId: event.id,
+        eventType: event.type,
+        actor: event.actor,
+        summary: event.summary,
+        taskId: event.taskId ?? scope.taskId,
+        artifacts: event.artifacts ?? [],
+    };
+    const runId = timelineRunId(event);
+    const phase = stringMetadata(event, "phase");
+    const gateId = stringMetadata(event, "gateId");
+    const result = stringMetadata(event, "result");
+    const rationale = stringMetadata(event, "rationale");
+    const actionKind = stringMetadata(event, "actionKind");
+    if (runId)
+        timelineEvent.runId = runId;
+    if (phase)
+        timelineEvent.phase = phase;
+    if (gateId)
+        timelineEvent.gateId = gateId;
+    if (result)
+        timelineEvent.result = result;
+    if (rationale)
+        timelineEvent.rationale = rationale;
+    if (sessionId)
+        timelineEvent.sessionId = sessionId;
+    if (runtime)
+        timelineEvent.runtime = runtime;
+    if (actionKind)
+        timelineEvent.actionKind = actionKind;
+    return {
+        schemaVersion: 1,
+        id: `timeline-${event.id}`,
+        threadId,
+        scope,
+        actor: actorForTimelineEvent(event, scope, runtime, role, sessionId),
+        provenance: {
+            sourceKind: event.type === "REVIEW_RECORDED" ? "review" : "workflow_event",
+            sourceId: event.id,
+            createdAt: event.timestamp,
+            observedAt: event.timestamp,
+            ...(runtime ? { runtime } : {}),
+        },
+        createdAt: event.timestamp,
+        sequence: index + 1,
+        content: {
+            format: "workflow_event",
+            text: event.summary,
+        },
+        contentState: "redacted",
+        retention: retention(event.timestamp),
+        export: exportPolicy(event.timestamp),
+        delete: { status: "active", policyId: "chat-delete-logical" },
+        references: timelineReferences(event, scope),
+        timelineEvent,
+    };
+}
+function actorForTimelineEvent(event, scope, runtime, role, sessionId) {
+    if (event.type === "REVIEW_RECORDED") {
+        return {
+            kind: "reviewer",
+            actorId: event.actor,
+            role: event.actor,
+            reviewId: event.id,
+        };
+    }
+    if (event.type.startsWith("RUNTIME_DELEGATION_SESSION_") &&
+        runtime &&
+        role &&
+        sessionId) {
+        return {
+            kind: "subagent",
+            actorId: stringMetadata(event, "spawnedAgentId") ?? event.actor,
+            runtime,
+            role,
+            sessionId,
+            parentSessionId: scope.sessionId,
+        };
+    }
+    if ((event.type === "RUNTIME_SPAWN_REQUEST_RENDERED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_QUEUED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_PLANNED") &&
+        runtime &&
+        sessionId) {
+        return {
+            kind: "parent_agent",
+            actorId: event.actor,
+            runtime,
+            sessionId,
+        };
+    }
+    return {
+        kind: "workflow_event",
+        actorId: `workflow:${event.id}`,
+        sourceEventId: event.id,
+        eventType: event.type,
+    };
+}
+function timelineReferences(event, scope) {
+    const references = [
+        { kind: "task", id: scope.taskId },
+        { kind: "workflow_run", id: scope.runId },
+    ];
+    if (event.type === "REVIEW_RECORDED") {
+        references.push({ kind: "review", id: event.id, label: event.summary });
+    }
+    if (event.type === "EVIDENCE_ADDED") {
+        references.push({ kind: "evidence", id: event.id, label: event.summary });
+    }
+    if (event.type.startsWith("GATE_")) {
+        references.push({ kind: "decision", id: event.id, label: event.summary });
+    }
+    if (event.type === "RUNTIME_SPAWN_REQUEST_RENDERED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_QUEUED") {
+        references.push({
+            kind: "provider_request",
+            id: event.id,
+            label: event.summary,
+        });
+    }
+    return references;
+}
+function timelineRunId(event) {
+    const explicit = stringMetadata(event, "runId");
+    if (explicit)
+        return explicit;
+    const sessionId = stringMetadata(event, "sessionId");
+    if (!sessionId)
+        return undefined;
+    const parts = sessionId.split(":");
+    return parts.length >= 4 ? parts[1] : undefined;
+}
+function runtimeSource(event) {
+    const value = stringMetadata(event, "runtime");
+    if (value === "codex-cli" ||
+        value === "claude-cli" ||
+        value === "cursor-cli" ||
+        value === "generic-runtime") {
+        return value;
+    }
+    return undefined;
+}
+function stringMetadata(event, key) {
+    const value = event.metadata[key];
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+//# sourceMappingURL=chat-workflow-timeline.js.map

package/dist/chat-workflow-timeline.js.map

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

package/dist/{workspace-claude-settings.d.ts → claude-settings.d.ts}

@@ -6,13 +6,32 @@ type HookEntry = {
     matcher: string;
     hooks: HookCommand[];
 };
-type ClaudeSettingsJson = {
+export type ClaudeSettingsJson = {
     [key: string]: unknown;
     hooks?: {
         [key: string]: HookEntry[] | undefined;
         UserPromptSubmit?: HookEntry[];
     };
 };
+export interface ClaudeSettingsWriteResult {
+    written: boolean;
+    settingsPath: string;
+    diagnostic?: {
+        code: "corrupted-json" | "write-error";
+        message: string;
+    };
+}
+/**
+ * Pure function: parses raw JSON string into Claude settings.
+ * Returns empty settings with a diagnostic when the JSON is corrupted.
+ */
+export declare function parseClaudeSettingsJson(raw: string): {
+    settings: ClaudeSettingsJson;
+    diagnostic?: {
+        code: "corrupted-json";
+        message: string;
+    };
+};
 /**
  * Pure function: upserts the orchestra UserPromptSubmit hook into an existing
  * settings object. Preserves all other hooks and settings.
@@ -21,7 +40,7 @@ export declare function mergeOrchestraHook(existing: ClaudeSettingsJson): Claude
 /**
  * Generates or updates `.claude/settings.json` with the UserPromptSubmit hook
  * that injects task/workflow state into Claude Code sessions at prompt start.
- * Returns true if the file was written.
+ * Fails open: corrupted existing settings are recovered and a diagnostic is returned.
  */
-export declare function initClaudeSettings(root: string): Promise<boolean>;
+export declare function initClaudeSettings(root: string): Promise<ClaudeSettingsWriteResult>;
 export {};

package/dist/{workspace-claude-settings.js → claude-settings.js}

@@ -6,10 +6,28 @@ const ORCHESTRA_HOOK = {
     hooks: [
         {
             type: "command",
-            command: "(command -v orchestra >/dev/null 2>&1 && orchestra health --json && orchestra task list --json --status in_progress,pending) || true",
+            command: "(command -v orchestra >/dev/null 2>&1 && orchestra health --runtime claude-cli --json && orchestra task list --json --status in_progress,pending) || true",
         },
     ],
 };
+/**
+ * Pure function: parses raw JSON string into Claude settings.
+ * Returns empty settings with a diagnostic when the JSON is corrupted.
+ */
+export function parseClaudeSettingsJson(raw) {
+    try {
+        return { settings: JSON.parse(raw) };
+    }
+    catch (err) {
+        return {
+            settings: {},
+            diagnostic: {
+                code: "corrupted-json",
+                message: err instanceof Error ? err.message : String(err),
+            },
+        };
+    }
+}
 /**
  * Pure function: upserts the orchestra UserPromptSubmit hook into an existing
  * settings object. Preserves all other hooks and settings.
@@ -32,23 +50,24 @@ export function mergeOrchestraHook(existing) {
 /**
  * Generates or updates `.claude/settings.json` with the UserPromptSubmit hook
  * that injects task/workflow state into Claude Code sessions at prompt start.
- * Returns true if the file was written.
+ * Fails open: corrupted existing settings are recovered and a diagnostic is returned.
  */
 export async function initClaudeSettings(root) {
     const claudeDir = path.join(root, ".claude");
     const settingsPath = path.join(claudeDir, "settings.json");
     let existing = {};
+    let diagnostic;
     if (await exists(settingsPath)) {
-        try {
-            existing = JSON.parse(await readFile(settingsPath, "utf8"));
-        }
-        catch {
-            existing = {};
+        const raw = await readFile(settingsPath, "utf8");
+        const parsed = parseClaudeSettingsJson(raw);
+        existing = parsed.settings;
+        if (parsed.diagnostic) {
+            diagnostic = parsed.diagnostic;
         }
     }
     const merged = mergeOrchestraHook(existing);
     await ensureDir(claudeDir);
     await writeFile(settingsPath, `${JSON.stringify(merged, null, 2)}\n`, "utf8");
-    return true;
+    return { written: true, settingsPath, ...(diagnostic ? { diagnostic } : {}) };
 }
-//# sourceMappingURL=workspace-claude-settings.js.map
+//# sourceMappingURL=claude-settings.js.map

package/dist/claude-settings.js.map

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

package/dist/command-init.d.ts

@@ -0,0 +1,2 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function initCommand(options: CliOptions, io: CliIo): Promise<void>;