@jterrats/open-orchestra 1.0.16 → 1.0.18

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>;

package/dist/command-init.js

@@ -0,0 +1,150 @@
+import { initWorkspace, inspectInitWorkspace } from "./workspace.js";
+import { parseRuntimeTarget } from "./runtime-adapters.js";
+import { parseCsv, stringOption, targetRootOption } from "./command-utils.js";
+export async function initCommand(options, io) {
+    if (options.help || options.h) {
+        io.log(renderInitHelp());
+        return;
+    }
+    const root = targetRootOption(options);
+    const input = {
+        root,
+        force: Boolean(options.force),
+        resetState: Boolean(options["reset-state"]),
+        advisory: Boolean(options.advisory),
+        confirmUnknown: Boolean(options["confirm-unknown"]),
+    };
+    const bootstrapTargetFile = stringOption(options["bootstrap-file"]);
+    const runtimeTargets = parseRuntimeTargetOptions(options);
+    const preflight = await inspectInitWorkspace({
+        ...input,
+        ...(bootstrapTargetFile ? { bootstrapTargetFile } : {}),
+        ...(runtimeTargets.length > 0 ? { runtimeTargets } : {}),
+    });
+    if (options.check || options["dry-run"]) {
+        if (options.json) {
+            io.log(JSON.stringify(preflight, null, 2));
+            return;
+        }
+        io.log(renderInitPreflight(preflight));
+        return;
+    }
+    const base = await initWorkspace({
+        ...input,
+        ...(bootstrapTargetFile ? { bootstrapTargetFile } : {}),
+        ...(runtimeTargets.length > 0 ? { runtimeTargets } : {}),
+    });
+    const result = {
+        ...preflight,
+        workflowRoot: base,
+        initialized: true,
+        nextSteps: initNextSteps(preflight.mode, root),
+    };
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    io.log(renderInitSuccess(result));
+}
+function renderInitHelp() {
+    return `orchestra init
+
+Usage:
+  orchestra init [--force] [--reset-state] [--advisory] [--confirm-unknown] [--target-dir <dir>] [--target <csv>] [--bootstrap-file <file>] [--check|--dry-run] [--json]
+
+Examples:
+  orchestra init
+  orchestra init --confirm-unknown
+  orchestra init --target-dir ../my-project
+  orchestra init --target claude,cursor,windsurf
+  orchestra init --advisory
+  orchestra init --check
+  orchestra init --force
+  orchestra init --force --reset-state
+
+State safety:
+  --force refreshes generated artifacts while preserving local workflow state.
+  --reset-state is destructive and requires --force; existing state files are backed up first.
+  If a prior init reset tasks before backup support, recover from git history, filesystem snapshots, terminal logs, or any copied .agent-workflow/tasks.json.
+
+After init:
+  orchestra health --json
+  orchestra task add --id <id> --title <title> --owner <role>
+  orchestra status
+  orchestra web`;
+}
+function renderInitPreflight(report) {
+    const lines = [
+        `Workspace: ${report.root}`,
+        `Mode: ${report.mode}`,
+        `Workflow root: ${report.workflowRoot}`,
+        report.workflowExists
+            ? "Workflow state already exists."
+            : "Workflow state will be created.",
+    ];
+    if (report.existingArtifacts.length > 0) {
+        lines.push("Existing managed artifacts:");
+        for (const artifact of report.existingArtifacts) {
+            lines.push(`  ${artifact}`);
+        }
+    }
+    lines.push(report.force
+        ? "Force: generated files will be refreshed; workflow state is preserved unless --reset-state is set."
+        : "Force: disabled; existing workflow state is preserved.");
+    if (report.resetState) {
+        lines.push("Reset state: enabled; existing workflow state files will be backed up before overwrite.");
+    }
+    lines.push("Generated artifacts:");
+    for (const artifact of report.generatedArtifacts) {
+        lines.push(`  ${artifact}`);
+    }
+    return lines.join("\n");
+}
+function renderInitSuccess(result) {
+    const lines = [
+        `Initialized ${result.workflowRoot}`,
+        result.mode === "advisory"
+            ? "Advisory mode enabled; root instruction files were not written unless explicitly targeted."
+            : "Prompt registry scaffolded in .generated-prompts/",
+        "Source catalog and agent lessons scaffolded in .agent-workflow/",
+    ];
+    if (result.force) {
+        lines.push("Force mode refreshed generated workflow artifacts.");
+    }
+    if (result.resetState) {
+        lines.push("Reset state replaced workflow state after creating timestamped backups in .agent-workflow/backups/.");
+    }
+    lines.push("Generated artifacts:");
+    for (const artifact of result.generatedArtifacts) {
+        lines.push(`  ${artifact}`);
+    }
+    lines.push("Next steps:");
+    for (const [index, step] of result.nextSteps.entries()) {
+        lines.push(`  ${index + 1}. ${step}`);
+    }
+    return lines.join("\n");
+}
+function initNextSteps(mode, root) {
+    const targetSuffix = root === process.cwd() ? "" : ` --target-dir ${root}`;
+    if (mode === "advisory") {
+        return [
+            `Run orchestra health --json${targetSuffix}`,
+            "Review .agent-workflow/advisory/README.md",
+            "Convert .agent-workflow/advisory/project-task.json with orchestra advisory convert when the target repo is confirmed",
+        ];
+    }
+    return [
+        `Run orchestra health --json${targetSuffix}`,
+        "Add a task with orchestra task add --id <id> --title <title> --owner <role>",
+        `Check workflow status with orchestra status${targetSuffix}`,
+        "Open the console with orchestra web",
+    ];
+}
+function parseRuntimeTargetOptions(options) {
+    const targetValues = [
+        ...parseCsv(options.target),
+        ...parseCsv(options.targets),
+    ];
+    return [...new Set(targetValues)].map((target) => parseRuntimeTarget(target));
+}
+//# sourceMappingURL=command-init.js.map

package/dist/command-init.js.map

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