@fabric-harness/cli 0.5.0 → 0.6.0

package/dist/bin/fabric-harness.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { spawn } from 'node:child_process';
-import { randomUUID } from 'node:crypto';
-import { promises as fs, watch } from 'node:fs';
-import path from 'node:path';
-import { parseEnv } from 'node:util';
-import { applyEnvModelProvider, buildWorkspace, compactSessionInStore, createConfiguredSessionStore, findWorkspaceRoot, inspectReplayFromStore, inspectSessionFromStore, describeAgentFile, getRequiredAgentDefinition, listAgentSummaries, listBuilds, listSessionSummariesFromStore, listApprovalStatesFromStore, listApprovalsFromStore, listCheckpointsFromStore, listTasksFromStore, loadAgentModule, loadFabricHarnessConfig, resolveAgentPath, resolveApprovalInStore, resolveSessionApproval, runAgent, startDevServer, cancelTaskInStore, getMetricsFromStore, getTaskFromStore, verifyAttestation, verifyProvenance, } from '@fabric-harness/node';
-import { FileSessionStore } from '@fabric-harness/node';
-import { EmptySandboxEnv, SchemaValidationError, createBuiltinTools, resolveModelProvider, toolsToModelSchemas } from '@fabric-harness/sdk';
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { promises as fs, watch } from "node:fs";
+import path from "node:path";
+import { parseEnv } from "node:util";
+import { applyEnvModelProvider, buildWorkspace, cancelTaskInStore, compactSessionInStore, createConfiguredSessionStore, describeAgentFile, findWorkspaceRoot, getMetricsFromStore, getRequiredAgentDefinition, getTaskFromStore, inspectReplayFromStore, inspectSessionFromStore, listAgentSummaries, listApprovalStatesFromStore, listApprovalsFromStore, listBuilds, listCheckpointsFromStore, listSessionSummariesFromStore, listTasksFromStore, loadAgentModule, loadFabricHarnessConfig, resolveAgentPath, resolveApprovalInStore, runAgent, startDevServer, verifyAttestation, verifyProvenance, } from "@fabric-harness/node";
+import { FileSessionStore } from "@fabric-harness/node";
+import { EmptySandboxEnv, SchemaValidationError, createBuiltinTools, resolveModelProvider, toolsToModelSchemas, } from "@fabric-harness/sdk";
 const ORIGINAL_ENV = { ...process.env };
-import { createLocalTemporalActivities, createTemporalClient, startTemporalWorker } from '@fabric-harness/temporal';
+import { createLocalTemporalActivities, createTemporalClient, startTemporalWorker, } from "@fabric-harness/temporal";
 const HELP = `Fabric Harness
 
 Usage:
@@ -19,7 +19,7 @@ Usage:
   fabric-harness run <agent> [--target temporal-worker] [--model provider/model] [--id <id>] --prompt <text>
   fabric-harness agents [--json]
   fabric-harness describe <agent> [--json]
-  fabric-harness build [--target node|temporal-worker|docker|foundry-hosted-agent|cloudflare] [--out <dir>] [--sbom] [--sbom-required] [--provenance] [--attestation] [--sign-provenance] [--signing-key <path|env://VAR>] [--docker-build] [--docker-push] [--docker-tag <tag>] [--image-sbom] [--image-sbom-required]
+  fabric-harness build [--target node|temporal-worker|docker|foundry-hosted-agent|cloudflare|aks|aca] [--out <dir>] [--sbom] [--sbom-required] [--provenance] [--attestation] [--sign-provenance] [--signing-key <path|env://VAR>] [--docker-build] [--docker-push] [--docker-tag <tag>] [--image-sbom] [--image-sbom-required]
   fabric-harness sessions
   fabric-harness builds
   fabric-harness verify-attestation <build-dir-or-attestation>
@@ -42,6 +42,7 @@ Usage:
   fabric-harness reject <session-id> <approval-id> [--actor <id>] [--reason <text>]
   fabric-harness dev [--target node|cloudflare] [--env <file>] [--host <host>] [--port <port>] [--auth-token-env <var>] [--max-body-bytes <n>] [--rate-limit-window-ms <n>] [--rate-limit-max <n>]
   fabric-harness temporal-worker [--task-queue <name>] [--address <host:port>] [--env <file>]
+  fabric-harness init [--dir <path>] [--model <provider/model>] [--force]
 
 Commands:
   run <agent>          Run a local .fabricharness agent handler
@@ -60,12 +61,13 @@ Commands:
   task <id> <task-id>  Show durable task status and checkpoints
   cancel-task <id>     Append a cancellation marker for a running task
   compact <id>         Add a compaction entry to a persisted session
-  replay <id>          Show read-only active path and model context
+  replay <id>          Show read-only active path and model context (--from <step-id>, --limit <n>)
   approvals <id>       List approval requests for a persisted session
   approve <id> <app>   Mark an approval request approved
   reject <id> <app>    Mark an approval request denied
   dev                  Start local HTTP/SSE dev server
   temporal-worker      Start a local Temporal worker with Fabric activities
+  init                 Scaffold a .fabricharness/ workspace in the current dir
   add                  List or print connector implementation recipes
 
 Options:
@@ -111,126 +113,127 @@ function parseJsonPayload(value) {
 }
 function parsePayloadValue(value) {
     const trimmed = value.trim();
-    if (trimmed === 'true')
+    if (trimmed === "true")
         return true;
-    if (trimmed === 'false')
+    if (trimmed === "false")
         return false;
-    if (trimmed === 'null')
+    if (trimmed === "null")
         return null;
     if (/^-?\d+(\.\d+)?$/.test(trimmed))
         return Number(trimmed);
-    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) || (trimmed.startsWith('[') && trimmed.endsWith(']')))
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) ||
+        (trimmed.startsWith("[") && trimmed.endsWith("]")))
         return parseJsonPayload(trimmed);
     return value;
 }
 function applyPayloadField(fields, assignment) {
-    const equals = assignment.indexOf('=');
+    const equals = assignment.indexOf("=");
     if (equals <= 0)
         throw new Error(`Expected payload assignment key=value, got: ${assignment}`);
     fields[assignment.slice(0, equals)] = parsePayloadValue(assignment.slice(equals + 1));
 }
 function parseRunArgs(args) {
     const [agent, ...rest] = args;
-    if (!agent || agent.startsWith('-'))
-        throw new Error('Missing required <agent> argument for run.');
+    if (!agent || agent.startsWith("-"))
+        throw new Error("Missing required <agent> argument for run.");
     const parsed = { agent };
     for (let index = 0; index < rest.length; index += 1) {
         const arg = rest[index];
         if (arg === undefined)
             continue;
-        if (arg === '--id') {
+        if (arg === "--id") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --id.');
+                throw new Error("Missing value for --id.");
             parsed.id = value;
             continue;
         }
-        if (arg === '--payload') {
+        if (arg === "--payload") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --payload.');
+                throw new Error("Missing value for --payload.");
             parsed.payload = parseJsonPayload(value);
             continue;
         }
-        if (arg === '--payload-file') {
+        if (arg === "--payload-file") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --payload-file.');
+                throw new Error("Missing value for --payload-file.");
             parsed.payloadFile = value;
             continue;
         }
-        if (arg === '--stdin') {
+        if (arg === "--stdin") {
             parsed.stdin = true;
             continue;
         }
-        if (arg === '--set') {
+        if (arg === "--set") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --set.');
+                throw new Error("Missing value for --set.");
             parsed.payloadFields ??= {};
             applyPayloadField(parsed.payloadFields, value);
             continue;
         }
-        if (arg === '--runtime') {
+        if (arg === "--runtime") {
             const value = rest[++index];
-            if (value !== 'inline' && value !== 'temporal')
-                throw new Error('--runtime must be inline or temporal.');
+            if (value !== "inline" && value !== "temporal")
+                throw new Error("--runtime must be inline or temporal.");
             parsed.runtime = value;
             continue;
         }
-        if (arg === '--target') {
+        if (arg === "--target") {
             const value = rest[++index];
-            if (value !== 'node' && value !== 'temporal-worker')
-                throw new Error('--target for run must be node or temporal-worker.');
+            if (value !== "node" && value !== "temporal-worker")
+                throw new Error("--target for run must be node or temporal-worker.");
             parsed.target = value;
-            parsed.runtime = value === 'temporal-worker' ? 'temporal' : 'inline';
+            parsed.runtime = value === "temporal-worker" ? "temporal" : "inline";
             continue;
         }
-        if (arg === '--prompt') {
+        if (arg === "--prompt") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --prompt.');
+                throw new Error("Missing value for --prompt.");
             parsed.prompt = value;
             continue;
         }
-        if (arg === '--model') {
+        if (arg === "--model") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --model.');
+                throw new Error("Missing value for --model.");
             parsed.model = value;
             continue;
         }
-        if (arg === '--cwd') {
+        if (arg === "--cwd") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --cwd.');
+                throw new Error("Missing value for --cwd.");
             parsed.cwd = value;
             continue;
         }
-        if (arg === '--env') {
+        if (arg === "--env") {
             const value = rest[++index];
             if (!value)
-                throw new Error('Missing value for --env.');
+                throw new Error("Missing value for --env.");
             parsed.envFiles ??= [];
             parsed.envFiles.push(value);
             continue;
         }
-        if (arg === '--help' || arg === '-h') {
+        if (arg === "--help" || arg === "-h") {
             console.log(HELP);
             process.exit(0);
         }
-        if (arg.startsWith('--')) {
+        if (arg.startsWith("--")) {
             const key = arg.slice(2);
             if (!key)
                 throw new Error(`Unknown argument: ${arg}`);
             const value = rest[++index];
-            if (value === undefined || value.startsWith('--'))
+            if (value === undefined || value.startsWith("--"))
                 throw new Error(`Missing value for --${key}.`);
             parsed.payloadFields ??= {};
             parsed.payloadFields[key] = parsePayloadValue(value);
             continue;
         }
-        if (arg.includes('=')) {
+        if (arg.includes("=")) {
             parsed.payloadFields ??= {};
             applyPayloadField(parsed.payloadFields, arg);
             continue;
@@ -240,7 +243,7 @@ function parseRunArgs(args) {
     return parsed;
 }
 function printResult(result) {
-    if (typeof result === 'string') {
+    if (typeof result === "string") {
         console.log(result);
         return;
     }
@@ -255,10 +258,10 @@ async function loadEnvFiles(envFiles, options = {}) {
         const filePath = path.resolve(process.cwd(), envFile);
         let contents;
         try {
-            contents = await fs.readFile(filePath, 'utf8');
+            contents = await fs.readFile(filePath, "utf8");
         }
         catch (error) {
-            if (options.ignoreMissing && error.code === 'ENOENT')
+            if (options.ignoreMissing && error.code === "ENOENT")
                 continue;
             const message = error instanceof Error ? error.message : String(error);
             throw new Error(`Failed to read --env file ${envFile}: ${message}`);
@@ -276,13 +279,15 @@ async function loadAutoEnvFiles() {
     const cwd = process.cwd();
     const workspaceRoot = await findWorkspaceRoot(cwd).catch(() => undefined);
     const repoRoot = await findRepoRoot(cwd).catch(() => undefined);
-    const roots = [...new Set([repoRoot, workspaceRoot].filter((value) => Boolean(value)))];
+    const roots = [
+        ...new Set([repoRoot, workspaceRoot].filter((value) => Boolean(value))),
+    ];
     const files = [];
     for (const root of roots) {
-        files.push(path.join(root, '.env'), path.join(root, '.env.local'));
+        files.push(path.join(root, ".env"), path.join(root, ".env.local"));
     }
     if (workspaceRoot) {
-        files.push(path.join(workspaceRoot, '.fabricharness', '.env'), path.join(workspaceRoot, '.fabricharness', '.env.local'));
+        files.push(path.join(workspaceRoot, ".fabricharness", ".env"), path.join(workspaceRoot, ".fabricharness", ".env.local"));
     }
     await loadEnvFiles(files, { ignoreMissing: true });
 }
@@ -290,7 +295,7 @@ async function findRepoRoot(start) {
     let current = path.resolve(start);
     for (;;) {
         try {
-            await fs.access(path.join(current, 'pnpm-workspace.yaml'));
+            await fs.access(path.join(current, "pnpm-workspace.yaml"));
             return current;
         }
         catch {
@@ -307,7 +312,7 @@ async function runCommand(args) {
     await loadEnvFiles(parsedArgs.envFiles, { explicit: true });
     const parsed = await resolvePayloadInputs(parsedArgs);
     const resolved = await resolveRunDefaults(parsed);
-    if (resolved.runtime === 'temporal')
+    if (resolved.runtime === "temporal")
         return runTemporalPromptCommand(resolved);
     const { cwd: sessionCwd, ...runOptions } = resolved;
     const { result } = await runAgent({ ...runOptions, ...(sessionCwd ? { sessionCwd } : {}) });
@@ -317,13 +322,15 @@ async function resolvePayloadInputs(parsed) {
     let payload = parsed.payload;
     if (parsed.payloadFile) {
         const filePath = path.resolve(process.cwd(), parsed.payloadFile);
-        payload = parseJsonPayload(await fs.readFile(filePath, 'utf8'));
+        payload = parseJsonPayload(await fs.readFile(filePath, "utf8"));
     }
     if (parsed.stdin) {
         payload = parseJsonPayload(await readStdin());
     }
     if (parsed.payloadFields && Object.keys(parsed.payloadFields).length > 0) {
-        const base = typeof payload === 'object' && payload !== null && !Array.isArray(payload) ? payload : {};
+        const base = typeof payload === "object" && payload !== null && !Array.isArray(payload)
+            ? payload
+            : {};
         payload = { ...base, ...parsed.payloadFields };
     }
     return { ...parsed, ...(payload !== undefined ? { payload } : {}) };
@@ -332,20 +339,24 @@ async function readStdin() {
     const chunks = [];
     for await (const chunk of process.stdin)
         chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-    return Buffer.concat(chunks).toString('utf8');
+    return Buffer.concat(chunks).toString("utf8");
 }
 async function resolveRunDefaults(parsed) {
     const workspaceRoot = await findWorkspaceRoot();
     const config = await loadFabricHarnessConfig({ workspaceRoot });
     const envTarget = process.env.FABRIC_TARGET ?? process.env.FABRIC_HARNESS_TARGET;
-    if (envTarget !== undefined && envTarget !== 'node' && envTarget !== 'temporal-worker')
-        throw new Error('FABRIC_TARGET/FABRIC_HARNESS_TARGET must be node or temporal-worker.');
+    if (envTarget !== undefined && envTarget !== "node" && envTarget !== "temporal-worker")
+        throw new Error("FABRIC_TARGET/FABRIC_HARNESS_TARGET must be node or temporal-worker.");
     const agentDefaults = await readAgentRunDefaults(workspaceRoot, parsed.agent);
     const target = parsed.target ?? envTarget ?? config.run?.target ?? agentDefaults.target;
-    if (target !== undefined && target !== 'node' && target !== 'temporal-worker')
-        throw new Error('Configured run.target must be node or temporal-worker.');
-    const runtime = parsed.runtime ?? (target === 'temporal-worker' ? 'temporal' : 'inline');
-    const model = parsed.model ?? process.env.FABRIC_MODEL ?? config.run?.model ?? agentDefaults.model ?? (typeof config.agent?.model === 'string' ? config.agent.model : undefined);
+    if (target !== undefined && target !== "node" && target !== "temporal-worker")
+        throw new Error("Configured run.target must be node or temporal-worker.");
+    const runtime = parsed.runtime ?? (target === "temporal-worker" ? "temporal" : "inline");
+    const model = parsed.model ??
+        process.env.FABRIC_MODEL ??
+        config.run?.model ??
+        agentDefaults.model ??
+        (typeof config.agent?.model === "string" ? config.agent.model : undefined);
     const id = parsed.id ?? `${config.run?.idPrefix ?? parsed.agent}-${randomUUID()}`;
     const cwd = parsed.cwd ?? config.run?.cwd;
     return {
@@ -372,37 +383,47 @@ async function readAgentRunDefaults(workspaceRoot, agentName) {
 }
 async function runTemporalPromptCommand(parsed) {
     if (!parsed.id)
-        throw new Error('--id is required with --runtime temporal.');
+        throw new Error("--id is required with --runtime temporal.");
     const workspaceRoot = await findWorkspaceRoot();
     const config = await loadFabricHarnessConfig({ workspaceRoot });
-    const taskQueue = process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? 'fabric-harness';
-    const address = process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? 'localhost:7233';
+    const taskQueue = process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? "fabric-harness";
+    const address = process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? "localhost:7233";
     const namespace = process.env.FABRIC_TEMPORAL_NAMESPACE ?? config.temporal?.namespace;
     const client = await createTemporalClient({
-        mode: 'temporal',
+        mode: "temporal",
         address,
         taskQueue,
         ...(namespace ? { namespace } : {}),
         ...(config.temporal?.apiKey ? { apiKey: config.temporal.apiKey } : {}),
         ...(config.temporal?.apiKeyEnv ? { apiKeyEnv: config.temporal.apiKeyEnv } : {}),
         ...(config.temporal?.tls ? { tls: config.temporal.tls } : {}),
-        workflowIdPrefix: config.temporal?.workflowIdPrefix ?? 'fabric-cli',
-        promptWorkflowMode: config.temporal?.promptWorkflowMode ?? 'hybrid',
+        workflowIdPrefix: config.temporal?.workflowIdPrefix ?? "fabric-cli",
+        promptWorkflowMode: config.temporal?.promptWorkflowMode ?? "hybrid",
     });
     try {
         if (parsed.prompt) {
             const runtime = client.createSessionRuntime(parsed.id);
-            const options = { ...(parsed.model ? { model: parsed.model } : {}), ...(parsed.cwd ? { cwd: parsed.cwd } : {}) };
-            printResult(await runtime.prompt({ text: parsed.prompt, ...(Object.keys(options).length > 0 ? { options } : {}) }));
+            const options = {
+                ...(parsed.model ? { model: parsed.model } : {}),
+                ...(parsed.cwd ? { cwd: parsed.cwd } : {}),
+            };
+            printResult(await runtime.prompt({
+                text: parsed.prompt,
+                ...(Object.keys(options).length > 0 ? { options } : {}),
+            }));
             return;
         }
         const agentPath = await resolveAgentPath(workspaceRoot, parsed.agent);
         const module = await loadAgentModule({ workspaceRoot, agentPath });
         getRequiredAgentDefinition(module.default, agentPath);
         const handler = module.default;
-        if (typeof handler !== 'function')
+        if (typeof handler !== "function")
             throw new Error(`Agent module must default-export agent({...}) from @fabric-harness/sdk: ${agentPath}`);
-        const store = await createConfiguredSessionStore({ workspaceRoot, ...(config.store ? { config: config.store } : {}), env: process.env });
+        const store = await createConfiguredSessionStore({
+            workspaceRoot,
+            ...(config.store ? { config: config.store } : {}),
+            env: process.env,
+        });
         const context = createTemporalFabricContext(parsed, client.createSessionRuntime.bind(client), store);
         printResult(await handler(context));
     }
@@ -411,12 +432,14 @@ async function runTemporalPromptCommand(parsed) {
     }
 }
 function createTemporalFabricContext(parsed, runtimeForSession, store) {
-    const payload = (typeof parsed.payload === 'object' && parsed.payload !== null && !Array.isArray(parsed.payload) ? parsed.payload : {});
+    const payload = (typeof parsed.payload === "object" && parsed.payload !== null && !Array.isArray(parsed.payload)
+        ? parsed.payload
+        : {});
     return {
         payload,
         init: async (initOptions = {}) => {
-            const agentId = initOptions.id ?? parsed.id ?? 'temporal-agent';
-            const model = parsed.model ?? (typeof initOptions.model === 'string' ? initOptions.model : undefined);
+            const agentId = initOptions.id ?? parsed.id ?? "temporal-agent";
+            const model = parsed.model ?? (typeof initOptions.model === "string" ? initOptions.model : undefined);
             const defaultCwd = parsed.cwd ?? initOptions.cwd;
             return {
                 id: agentId,
@@ -436,43 +459,154 @@ function createTemporalSession(sessionId, runtimeForSession, model, store, cwd)
     };
     return {
         id: sessionId,
-        agent: { id: sessionId, ...(model ? { model } : {}), session: async (_id, options) => createTemporalSession(sessionId, runtimeForSession, model, store, options?.cwd ?? cwd) },
+        agent: {
+            id: sessionId,
+            ...(model ? { model } : {}),
+            session: async (_id, options) => createTemporalSession(sessionId, runtimeForSession, model, store, options?.cwd ?? cwd),
+        },
         // Do not create a rejected promise here: many agents never access session.sandbox,
         // but Node treats an eagerly rejected promise as unhandled. Direct sandbox effects
         // in Temporal CLI mode should go through session.shell()/tools, which are routed
         // to workflow activities. This placeholder prevents accidental unhandled rejection.
         sandbox: Promise.resolve(new EmptySandboxEnv()),
-        prompt: (text, options) => { const merged = withDefaults(options); return runtime.prompt({ text, ...(merged || model ? { options: { ...(merged ?? {}), ...(model && merged?.model === undefined ? { model } : {}) } } : {}) }); },
-        stream: async function* (text, options) { for (const event of [])
-            yield event; const merged = withDefaults(options); return await runtime.prompt({ text, ...(merged || model ? { options: { ...(merged ?? {}), ...(model && merged?.model === undefined ? { model } : {}) } } : {}) }); },
-        skill: (name, options) => { const merged = withDefaults(options); return runtime.prompt({ text: `Run skill ${name}${options?.args ? ` with args ${JSON.stringify(options.args)}` : ''}`, ...(merged || model ? { options: { ...(merged ?? {}), ...(model && merged?.model === undefined ? { model } : {}) } } : {}) }); },
-        task: (text, options) => { const merged = withDefaults(options); return runtime.task({ text, ...(options?.id ? { taskId: options.id } : {}), ...(merged || model ? { options: { ...(merged ?? {}), ...(model && merged?.model === undefined ? { model } : {}) } } : {}) }); },
+        prompt: (text, options) => {
+            const merged = withDefaults(options);
+            return runtime.prompt({
+                text,
+                ...(merged || model
+                    ? {
+                        options: {
+                            ...(merged ?? {}),
+                            ...(model && merged?.model === undefined ? { model } : {}),
+                        },
+                    }
+                    : {}),
+            });
+        },
+        stream: async function* (text, options) {
+            for (const event of [])
+                yield event;
+            const merged = withDefaults(options);
+            return await runtime.prompt({
+                text,
+                ...(merged || model
+                    ? {
+                        options: {
+                            ...(merged ?? {}),
+                            ...(model && merged?.model === undefined ? { model } : {}),
+                        },
+                    }
+                    : {}),
+            });
+        },
+        skill: (name, options) => {
+            const merged = withDefaults(options);
+            return runtime.prompt({
+                text: `Run skill ${name}${options?.args ? ` with args ${JSON.stringify(options.args)}` : ""}`,
+                ...(merged || model
+                    ? {
+                        options: {
+                            ...(merged ?? {}),
+                            ...(model && merged?.model === undefined ? { model } : {}),
+                        },
+                    }
+                    : {}),
+            });
+        },
+        task: (text, options) => {
+            const merged = withDefaults(options);
+            return runtime.task({
+                text,
+                ...(options?.id ? { taskId: options.id } : {}),
+                ...(merged || model
+                    ? {
+                        options: {
+                            ...(merged ?? {}),
+                            ...(model && merged?.model === undefined ? { model } : {}),
+                        },
+                    }
+                    : {}),
+            });
+        },
         shell: (command, options) => {
             const merged = withDefaults(options);
             return runtime.shell({ command, ...(merged ? { options: merged } : {}) });
         },
-        history: async () => ({ id: sessionId, createdAt: new Date().toISOString(), updatedAt: new Date().toISOString(), entries: [], events: [] }),
+        mount: async (mountAt, source, mountOptions) => {
+            // Temporal CLI session has a placeholder sandbox; mounts here are best-effort
+            // and do not survive across activity boundaries. For durable mounts, mount
+            // inside the agent run() body before delegating to Temporal.
+            const sandbox = new EmptySandboxEnv();
+            let files = 0;
+            let bytes = 0;
+            for await (const entry of source.entries()) {
+                files += 1;
+                bytes +=
+                    typeof entry.content === "string"
+                        ? Buffer.byteLength(entry.content, "utf8")
+                        : entry.content.byteLength;
+                void sandbox;
+            }
+            const mode = mountOptions?.mode ?? "read";
+            return { mountAt, files, bytes, mode, ...(source.name ? { source: source.name } : {}) };
+        },
+        approval: {
+            request: async () => {
+                // Custom approvals through the CLI Temporal shim are not supported; users
+                // should configure capability policy approvals or run with the SDK's
+                // direct API where session.approval.request() is wired through.
+                throw new Error('session.approval.request() is not yet supported in the CLI Temporal session shim. Use init({ runtime: "temporal", sessionRuntime }) directly.');
+            },
+        },
+        history: async () => ({
+            id: sessionId,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            entries: [],
+            events: [],
+        }),
         checkpoint: {
             create: (options) => runtime.checkpointCreate({ options }),
             restore: (options) => runtime.checkpointRestore({ options }),
         },
         artifact: async (name, content, options) => {
             if (!store.putArtifact)
-                throw new Error('Configured session store does not support artifacts.');
+                throw new Error("Configured session store does not support artifacts.");
             const ref = await store.putArtifact(sessionId, name, content, options);
             const timestamp = new Date().toISOString();
-            const entry = { id: randomUUID(), type: 'artifact_created', timestamp, data: { artifact: ref } };
+            const entry = {
+                id: randomUUID(),
+                type: "artifact_created",
+                timestamp,
+                data: { artifact: ref },
+            };
             if (store.appendEntry)
                 await store.appendEntry(sessionId, entry);
             else {
                 const existing = await store.load(sessionId);
-                await store.save({ id: sessionId, createdAt: existing?.createdAt ?? timestamp, updatedAt: timestamp, entries: [...(existing?.entries ?? []), entry], events: existing?.events ?? [] });
+                await store.save({
+                    id: sessionId,
+                    createdAt: existing?.createdAt ?? timestamp,
+                    updatedAt: timestamp,
+                    entries: [...(existing?.entries ?? []), entry],
+                    events: existing?.events ?? [],
+                });
             }
             if (store.appendEvent)
-                await store.appendEvent(sessionId, { id: randomUUID(), type: 'artifact_created', timestamp, sessionId, data: { artifact: ref } });
+                await store.appendEvent(sessionId, {
+                    id: randomUUID(),
+                    type: "artifact_created",
+                    timestamp,
+                    sessionId,
+                    data: { artifact: ref },
+                });
             return ref;
         },
-        compact: async () => ({ entryId: '', summary: 'Compaction is executed by Temporal worker activities.', compactedEntries: 0 }),
+        compact: async () => ({
+            entryId: "",
+            summary: "Compaction is executed by Temporal worker activities.",
+            compactedEntries: 0,
+        }),
     };
 }
 async function temporalWorkerCommand(args) {
@@ -481,24 +615,24 @@ async function temporalWorkerCommand(args) {
     let addressFlag;
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
-        if (arg === '--env') {
+        if (arg === "--env") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --env.');
+                throw new Error("Missing value for --env.");
             envFiles.push(value);
             continue;
         }
-        if (arg === '--task-queue') {
+        if (arg === "--task-queue") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --task-queue.');
+                throw new Error("Missing value for --task-queue.");
             taskQueueFlag = value;
             continue;
         }
-        if (arg === '--address') {
+        if (arg === "--address") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --address.');
+                throw new Error("Missing value for --address.");
             addressFlag = value;
             continue;
         }
@@ -507,8 +641,14 @@ async function temporalWorkerCommand(args) {
     await loadEnvFiles(envFiles, { explicit: true });
     const workspaceRoot = await findWorkspaceRoot();
     const config = await loadFabricHarnessConfig({ workspaceRoot });
-    const taskQueue = taskQueueFlag ?? process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? 'fabric-harness';
-    const address = addressFlag ?? process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? 'localhost:7233';
+    const taskQueue = taskQueueFlag ??
+        process.env.FABRIC_TEMPORAL_TASK_QUEUE ??
+        config.temporal?.taskQueue ??
+        "fabric-harness";
+    const address = addressFlag ??
+        process.env.FABRIC_TEMPORAL_ADDRESS ??
+        config.temporal?.address ??
+        "localhost:7233";
     const namespace = process.env.FABRIC_TEMPORAL_NAMESPACE ?? config.temporal?.namespace;
     const sandbox = new EmptySandboxEnv();
     const store = new FileSessionStore({ workspaceRoot });
@@ -517,13 +657,13 @@ async function temporalWorkerCommand(args) {
         store,
         sandbox,
         tools: createBuiltinTools(sandbox),
-        ...(typeof modelOptions.model === 'string' ? { model: modelOptions.model } : {}),
+        ...(typeof modelOptions.model === "string" ? { model: modelOptions.model } : {}),
         ...(modelOptions.modelProvider ? { modelProvider: modelOptions.modelProvider } : {}),
         ...(modelOptions.policy ? { policy: modelOptions.policy } : {}),
         ...(modelOptions.resolveSecret ? { resolveSecret: modelOptions.resolveSecret } : {}),
     });
     const worker = await startTemporalWorker({
-        mode: 'temporal',
+        mode: "temporal",
         address,
         taskQueue,
         ...(namespace ? { namespace } : {}),
@@ -537,10 +677,192 @@ async function temporalWorkerCommand(args) {
         await worker.close();
         process.exit(0);
     };
-    process.on('SIGINT', () => void shutdown());
-    process.on('SIGTERM', () => void shutdown());
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
     await worker.runPromise;
 }
+async function loadCliVersion() {
+    try {
+        const pkgUrl = new URL("../../package.json", import.meta.url);
+        const pkg = JSON.parse(await fs.readFile(pkgUrl, "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+async function initCommand(args) {
+    let dir = process.cwd();
+    let force = false;
+    let model = "openai/gpt-5.5";
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--dir") {
+            const value = args[++i];
+            if (!value)
+                throw new Error("Missing value for --dir.");
+            dir = path.resolve(value);
+            continue;
+        }
+        if (arg === "--force") {
+            force = true;
+            continue;
+        }
+        if (arg === "--model") {
+            const value = args[++i];
+            if (!value)
+                throw new Error("Missing value for --model.");
+            model = value;
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            console.log("Usage: fabric-harness init [--dir <path>] [--model <provider/model>] [--force]");
+            console.log("");
+            console.log("Scaffolds a .fabricharness/ workspace with a sample agent, role, skill, and config.");
+            return;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    const root = dir;
+    const harness = path.join(root, ".fabricharness");
+    const created = [];
+    const skipped = [];
+    async function writeIf(target, content) {
+        try {
+            await fs.access(target);
+            if (!force) {
+                skipped.push(path.relative(root, target));
+                return;
+            }
+        }
+        catch {
+            /* missing is fine */
+        }
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.writeFile(target, content);
+        created.push(path.relative(root, target));
+    }
+    await fs.mkdir(path.join(harness, "agents"), { recursive: true });
+    await fs.mkdir(path.join(harness, "roles"), { recursive: true });
+    await fs.mkdir(path.join(harness, "skills"), { recursive: true });
+    await writeIf(path.join(harness, "agents", "hello.ts"), [
+        `import { agent, schema } from '@fabric-harness/sdk';`,
+        "",
+        "export default agent({",
+        `  name: 'hello',`,
+        `  description: 'Greet a user.',`,
+        `  input: schema.object({ name: schema.string().default('World') }),`,
+        "  output: schema.string(),",
+        "  triggers: { webhook: true },",
+        `  model: ${JSON.stringify(model)},`,
+        "  async run({ init, input }) {",
+        "    const fabric = await init();",
+        "    const session = await fabric.session();",
+        "    return await session.prompt(`Say hello to ${input.name}.`);",
+        "  },",
+        "});",
+        "",
+    ].join("\n"));
+    await writeIf(path.join(harness, "roles", "engineer.md"), [
+        "---",
+        "description: Senior backend engineer focused on safe, minimal changes.",
+        "---",
+        "",
+        "You are a senior backend engineer.",
+        "Prefer small, well-tested changes. Do not make broad refactors unless required.",
+        "",
+    ].join("\n"));
+    await writeIf(path.join(harness, "skills", "summarize", "SKILL.md"), [
+        "---",
+        "name: summarize",
+        "description: Summarize text concisely.",
+        "---",
+        "",
+        "Summarize the provided text in 2-3 sentences. Capture the main point and any",
+        "critical caveats. Avoid hedging.",
+        "",
+    ].join("\n"));
+    await writeIf(path.join(harness, "config.ts"), [
+        "export default {",
+        "  agent: {",
+        `    model: ${JSON.stringify(model)},`,
+        "  },",
+        "  run: {",
+        "    target: 'node',",
+        `    model: ${JSON.stringify(model)},`,
+        "  },",
+        "  temporal: {",
+        "    address: 'localhost:7233',",
+        "    namespace: 'default',",
+        "    taskQueue: 'fabric-harness',",
+        "  },",
+        "};",
+        "",
+    ].join("\n"));
+    // Only scaffold package.json/tsconfig.json when the directory isn't
+    // already a Node package — many users will run `fh init` inside an
+    // existing repo where these files already live.
+    const pkgDir = path
+        .basename(root)
+        .replace(/[^a-z0-9-]/gi, "-")
+        .toLowerCase() || "fabric-harness-app";
+    const cliVersion = await loadCliVersion();
+    const fabricRange = `^${cliVersion}`;
+    await writeIf(path.join(root, "package.json"), `${JSON.stringify({
+        name: pkgDir,
+        version: "0.0.0",
+        private: true,
+        type: "module",
+        scripts: {
+            build: "tsc -p tsconfig.json",
+            agents: "fabric-harness agents",
+            run: "fabric-harness run hello",
+            dev: "fabric-harness dev",
+        },
+        dependencies: {
+            "@fabric-harness/cli": fabricRange,
+            "@fabric-harness/sdk": fabricRange,
+        },
+    }, null, 2)}\n`);
+    await writeIf(path.join(root, "tsconfig.json"), `${JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            module: "ES2022",
+            moduleResolution: "bundler",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            rootDir: ".",
+            outDir: "dist",
+        },
+        include: [".fabricharness/**/*.ts"],
+    }, null, 2)}\n`);
+    await writeIf(path.join(root, "AGENTS.md"), [
+        "# Agents",
+        "",
+        "This project uses [Fabric Harness](https://github.com/Fabric-Pro/fabric-harness).",
+        "",
+        "## Quickstart",
+        "",
+        "```sh",
+        "npm install",
+        "npx fabric-harness agents",
+        'npx fabric-harness run hello --payload \'{"name":"Ada"}\'',
+        "```",
+        "",
+    ].join("\n"));
+    console.log(`Initialized Fabric Harness workspace at ${harness}`);
+    if (created.length)
+        console.log(`Created:\n${created.map((p) => `  ${p}`).join("\n")}`);
+    if (skipped.length)
+        console.log(`Skipped (already exist; pass --force to overwrite):\n${skipped.map((p) => `  ${p}`).join("\n")}`);
+    console.log("");
+    console.log("Next steps:");
+    console.log("  npm install                              # install fabric-harness");
+    console.log("  npx fabric-harness agents                # list agents");
+    console.log("  npx fabric-harness run hello             # run the sample agent");
+    console.log("  npx fabric-harness build --target node   # build for production");
+}
 async function buildCommand(args) {
     let outDir;
     let target;
@@ -558,75 +880,96 @@ async function buildCommand(args) {
     let signingKey;
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
-        if (arg === '--out') {
+        if (arg === "--out") {
             outDir = args[++index];
             continue;
         }
-        if (arg === '--target') {
+        if (arg === "--target") {
             const value = args[++index];
-            if (value !== 'node' && value !== 'temporal-worker' && value !== 'docker' && value !== 'foundry-hosted-agent' && value !== 'cloudflare')
-                throw new Error('--target must be node, temporal-worker, docker, foundry-hosted-agent, or cloudflare.');
+            if (value !== "node" &&
+                value !== "temporal-worker" &&
+                value !== "docker" &&
+                value !== "foundry-hosted-agent" &&
+                value !== "cloudflare" &&
+                value !== "aks" &&
+                value !== "aca")
+                throw new Error("--target must be node, temporal-worker, docker, foundry-hosted-agent, cloudflare, aks, or aca.");
             target = value;
             continue;
         }
-        if (arg === '--no-clean') {
+        if (arg === "--no-clean") {
             clean = false;
             continue;
         }
-        if (arg === '--sbom') {
+        if (arg === "--sbom") {
             sbom = true;
             continue;
         }
-        if (arg === '--sbom-required') {
+        if (arg === "--sbom-required") {
             sbom = true;
             sbomRequired = true;
             continue;
         }
-        if (arg === '--provenance') {
+        if (arg === "--provenance") {
             provenance = true;
             continue;
         }
-        if (arg === '--attestation') {
+        if (arg === "--attestation") {
             attestation = true;
             continue;
         }
-        if (arg === '--sign-provenance') {
+        if (arg === "--sign-provenance") {
             signProvenance = true;
             provenance = true;
             continue;
         }
-        if (arg === '--signing-key') {
+        if (arg === "--signing-key") {
             signingKey = args[++index];
             if (!signingKey)
-                throw new Error('Missing value for --signing-key.');
+                throw new Error("Missing value for --signing-key.");
             continue;
         }
-        if (arg === '--docker-build') {
+        if (arg === "--docker-build") {
             dockerBuild = true;
             continue;
         }
-        if (arg === '--docker-push') {
+        if (arg === "--docker-push") {
             dockerPush = true;
             continue;
         }
-        if (arg === '--docker-tag') {
+        if (arg === "--docker-tag") {
             dockerTag = args[++index];
             if (!dockerTag)
-                throw new Error('Missing value for --docker-tag.');
+                throw new Error("Missing value for --docker-tag.");
             continue;
         }
-        if (arg === '--image-sbom') {
+        if (arg === "--image-sbom") {
             imageSbom = true;
             continue;
         }
-        if (arg === '--image-sbom-required') {
+        if (arg === "--image-sbom-required") {
             imageSbom = true;
             imageSbomRequired = true;
             continue;
         }
         throw new Error(`Unknown argument: ${arg}`);
     }
-    const result = await buildWorkspace({ ...(outDir ? { outDir } : {}), ...(target ? { target } : {}), clean, sbom, sbomRequired, provenance, attestation, signProvenance, ...(signingKey ? { signingKey } : {}), dockerBuild, dockerPush, ...(dockerTag ? { dockerTag } : {}), imageSbom, imageSbomRequired });
+    const result = await buildWorkspace({
+        ...(outDir ? { outDir } : {}),
+        ...(target ? { target } : {}),
+        clean,
+        sbom,
+        sbomRequired,
+        provenance,
+        attestation,
+        signProvenance,
+        ...(signingKey ? { signingKey } : {}),
+        dockerBuild,
+        dockerPush,
+        ...(dockerTag ? { dockerTag } : {}),
+        imageSbom,
+        imageSbomRequired,
+    });
     console.log(`Built Fabric Harness workspace: ${result.outDir}`);
     console.log(`Manifest: ${result.manifestPath}`);
     if (result.provenancePath)
@@ -643,12 +986,12 @@ async function buildCommand(args) {
         console.log(`Image SBOM: ${result.imageSbomPath}`);
     for (const warning of result.warnings)
         console.warn(`Warning: ${warning}`);
-    console.log(`Agents: ${result.manifest.agents.map((agent) => agent.name).join(', ') || 'none'}`);
+    console.log(`Agents: ${result.manifest.agents.map((agent) => agent.name).join(", ") || "none"}`);
 }
 async function devCommand(args) {
     let host;
     let port;
-    let target = 'node';
+    let target = "node";
     let authTokenEnv;
     let maxBodyBytes;
     let rateLimitWindowMs;
@@ -656,67 +999,67 @@ async function devCommand(args) {
     const envFiles = [];
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
-        if (arg === '--host') {
+        if (arg === "--host") {
             host = args[++index];
             continue;
         }
-        if (arg === '--port') {
+        if (arg === "--port") {
             const value = args[++index];
             port = value ? Number(value) : undefined;
             continue;
         }
-        if (arg === '--target') {
+        if (arg === "--target") {
             const value = args[++index];
-            if (value !== 'node' && value !== 'cloudflare')
-                throw new Error('--target for dev must be node or cloudflare.');
+            if (value !== "node" && value !== "cloudflare")
+                throw new Error("--target for dev must be node or cloudflare.");
             target = value;
             continue;
         }
-        if (arg === '--env') {
+        if (arg === "--env") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --env.');
+                throw new Error("Missing value for --env.");
             envFiles.push(value);
             continue;
         }
-        if (arg === '--auth-token-env') {
+        if (arg === "--auth-token-env") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --auth-token-env.');
+                throw new Error("Missing value for --auth-token-env.");
             authTokenEnv = value;
             continue;
         }
-        if (arg === '--max-body-bytes') {
+        if (arg === "--max-body-bytes") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --max-body-bytes.');
+                throw new Error("Missing value for --max-body-bytes.");
             maxBodyBytes = Number(value);
             if (!Number.isFinite(maxBodyBytes) || maxBodyBytes <= 0)
-                throw new Error('--max-body-bytes must be a positive number.');
+                throw new Error("--max-body-bytes must be a positive number.");
             continue;
         }
-        if (arg === '--rate-limit-window-ms') {
+        if (arg === "--rate-limit-window-ms") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --rate-limit-window-ms.');
+                throw new Error("Missing value for --rate-limit-window-ms.");
             rateLimitWindowMs = Number(value);
             if (!Number.isFinite(rateLimitWindowMs) || rateLimitWindowMs <= 0)
-                throw new Error('--rate-limit-window-ms must be a positive number.');
+                throw new Error("--rate-limit-window-ms must be a positive number.");
             continue;
         }
-        if (arg === '--rate-limit-max') {
+        if (arg === "--rate-limit-max") {
             const value = args[++index];
             if (!value)
-                throw new Error('Missing value for --rate-limit-max.');
+                throw new Error("Missing value for --rate-limit-max.");
             rateLimitMax = Number(value);
             if (!Number.isFinite(rateLimitMax) || rateLimitMax <= 0)
-                throw new Error('--rate-limit-max must be a positive number.');
+                throw new Error("--rate-limit-max must be a positive number.");
             continue;
         }
         throw new Error(`Unknown argument: ${arg}`);
     }
     await loadEnvFiles(envFiles, { explicit: true });
-    if (target === 'cloudflare') {
+    if (target === "cloudflare") {
         const cloudflareOptions = {};
         if (host !== undefined)
             cloudflareOptions.host = host;
@@ -745,27 +1088,27 @@ async function devCommand(args) {
         await server.close();
         process.exit(0);
     };
-    process.on('SIGINT', () => void shutdown());
-    process.on('SIGTERM', () => void shutdown());
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
     console.log(`Fabric Harness dev server listening at ${server.url}`);
-    console.log('POST /agents/:agent/:id, GET /sessions/:id, GET /sessions/:id/events');
-    console.log('Watching .fabricharness for changes; agents/config reload on the next request.');
+    console.log("POST /agents/:agent/:id, GET /sessions/:id, GET /sessions/:id/events");
+    console.log("Watching .fabricharness for changes; agents/config reload on the next request.");
 }
 async function cloudflareDevCommand(options) {
     const workspaceRoot = await findWorkspaceRoot();
-    console.error('[fabric-harness] Building Cloudflare Worker artifact...');
-    const result = await buildWorkspace({ cwd: workspaceRoot, target: 'cloudflare' });
+    console.error("[fabric-harness] Building Cloudflare Worker artifact...");
+    const result = await buildWorkspace({ cwd: workspaceRoot, target: "cloudflare" });
     console.error(`[fabric-harness] Cloudflare artifact: ${result.outDir}`);
-    console.error('[fabric-harness] Starting Wrangler dev. Install wrangler/@cloudflare dependencies in the artifact if prompted.');
-    const args = ['wrangler', 'dev'];
+    console.error("[fabric-harness] Starting Wrangler dev. Install wrangler/@cloudflare dependencies in the artifact if prompted.");
+    const args = ["wrangler", "dev"];
     if (options.port !== undefined)
-        args.push('--port', String(options.port));
+        args.push("--port", String(options.port));
     if (options.host !== undefined)
-        args.push('--ip', options.host);
-    const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+        args.push("--ip", options.host);
+    const npx = process.platform === "win32" ? "npx.cmd" : "npx";
     const child = spawn(npx, args, {
         cwd: result.outDir,
-        stdio: 'inherit',
+        stdio: "inherit",
         shell: false,
         env: process.env,
     });
@@ -776,13 +1119,13 @@ async function cloudflareDevCommand(options) {
     const structuralWatcher = startCloudflareStructuralWatcher(workspaceRoot);
     const shutdown = () => {
         structuralWatcher?.close();
-        child.kill('SIGTERM');
+        child.kill("SIGTERM");
     };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
     const code = await new Promise((resolve, reject) => {
-        child.on('error', reject);
-        child.on('close', resolve);
+        child.on("error", reject);
+        child.on("close", resolve);
     });
     structuralWatcher?.close();
     if (code && code !== 0)
@@ -794,36 +1137,38 @@ async function cloudflareDevCommand(options) {
  * reloads workerd, so we don't need to restart it ourselves.
  */
 function startCloudflareStructuralWatcher(workspaceRoot) {
-    const watchRoot = path.join(workspaceRoot, '.fabricharness', 'agents');
+    const watchRoot = path.join(workspaceRoot, ".fabricharness", "agents");
     let watcher;
     try {
         let timer;
-        let lastAgentSet = '';
+        let lastAgentSet = "";
         const recomputeAndRebuild = async () => {
             const summaries = await listAgentSummaries(workspaceRoot).catch(() => []);
             const fingerprint = summaries
-                .map((a) => `${a.name}|${a.triggers?.webhook ?? false}|${a.triggers?.schedule ?? ''}`)
+                .map((a) => `${a.name}|${a.triggers?.webhook ?? false}|${a.triggers?.schedule ?? ""}`)
                 .sort()
-                .join(',');
+                .join(",");
             if (fingerprint === lastAgentSet)
                 return;
             lastAgentSet = fingerprint;
-            console.error('[fabric-harness] Agent set changed — regenerating Cloudflare entry.');
+            console.error("[fabric-harness] Agent set changed — regenerating Cloudflare entry.");
             try {
-                await buildWorkspace({ cwd: workspaceRoot, target: 'cloudflare' });
-                console.error('[fabric-harness] Entry regenerated. Wrangler will reload.');
+                await buildWorkspace({ cwd: workspaceRoot, target: "cloudflare" });
+                console.error("[fabric-harness] Entry regenerated. Wrangler will reload.");
             }
             catch (err) {
-                console.error('[fabric-harness] Rebuild failed:', err instanceof Error ? err.message : err);
+                console.error("[fabric-harness] Rebuild failed:", err instanceof Error ? err.message : err);
             }
         };
         // Prime the fingerprint without rebuilding (we just built before starting wrangler).
-        void listAgentSummaries(workspaceRoot).then((summaries) => {
+        void listAgentSummaries(workspaceRoot)
+            .then((summaries) => {
             lastAgentSet = summaries
-                .map((a) => `${a.name}|${a.triggers?.webhook ?? false}|${a.triggers?.schedule ?? ''}`)
+                .map((a) => `${a.name}|${a.triggers?.webhook ?? false}|${a.triggers?.schedule ?? ""}`)
                 .sort()
-                .join(',');
-        }).catch(() => undefined);
+                .join(",");
+        })
+            .catch(() => undefined);
         watcher = watch(watchRoot, { recursive: true }, (_eventType, filename) => {
             if (!filename)
                 return;
@@ -840,7 +1185,7 @@ function startCloudflareStructuralWatcher(workspaceRoot) {
     }
 }
 function startNodeDevWatcher(workspaceRoot, envFiles) {
-    const watchRoot = path.join(workspaceRoot, '.fabricharness');
+    const watchRoot = path.join(workspaceRoot, ".fabricharness");
     try {
         const envFileSet = new Set(envFiles.map((file) => path.resolve(process.cwd(), file)));
         let timer;
@@ -848,7 +1193,7 @@ function startNodeDevWatcher(workspaceRoot, envFiles) {
             if (timer)
                 clearTimeout(timer);
             timer = setTimeout(() => {
-                const changed = filename ? path.join('.fabricharness', String(filename)) : '.fabricharness';
+                const changed = filename ? path.join(".fabricharness", String(filename)) : ".fabricharness";
                 console.error(`[fabric-harness] Change detected: ${changed}. Reload will apply on next request.`);
                 for (const envFile of envFileSet) {
                     if (path.resolve(workspaceRoot, changed) === envFile)
@@ -862,19 +1207,43 @@ function startNodeDevWatcher(workspaceRoot, envFiles) {
     }
 }
 const CONNECTOR_RECIPES = {
-    daytona: { file: 'sandbox--daytona.md', category: 'sandbox', description: 'Daytona remote sandbox' },
-    e2b: { file: 'sandbox--e2b.md', category: 'sandbox', description: 'E2B remote sandbox' },
-    modal: { file: 'sandbox--modal.md', category: 'sandbox', description: 'Modal Labs remote sandbox' },
-    vercel: { file: 'sandbox--vercel.md', category: 'sandbox', description: 'Vercel Sandbox' },
-    'github-mcp': { file: 'mcp--github.md', category: 'mcp', description: 'GitHub MCP server' },
-    'mintlify-mcp': { file: 'mcp--mintlify.md', category: 'mcp', description: 'Mintlify hosted docs MCP' },
-    'linear-mcp': { file: 'mcp--linear.md', category: 'mcp', description: 'Linear hosted MCP' },
-    'slack-mcp': { file: 'mcp--slack.md', category: 'mcp', description: 'Slack MCP (hosted or local bridge)' },
-    fumadocs: { file: 'kb--fumadocs.md', category: 'kb', description: 'Mount a Fumadocs content tree as a knowledge base' },
-    postgres: { file: 'data--postgres.md', category: 'data', description: 'Postgres data connector' },
-    notion: { file: 'data--notion.md', category: 'data', description: 'Notion (hosted MCP or REST adapter)' },
+    daytona: {
+        file: "sandbox--daytona.md",
+        category: "sandbox",
+        description: "Daytona remote sandbox",
+    },
+    e2b: { file: "sandbox--e2b.md", category: "sandbox", description: "E2B remote sandbox" },
+    modal: {
+        file: "sandbox--modal.md",
+        category: "sandbox",
+        description: "Modal Labs remote sandbox",
+    },
+    vercel: { file: "sandbox--vercel.md", category: "sandbox", description: "Vercel Sandbox" },
+    "github-mcp": { file: "mcp--github.md", category: "mcp", description: "GitHub MCP server" },
+    "mintlify-mcp": {
+        file: "mcp--mintlify.md",
+        category: "mcp",
+        description: "Mintlify hosted docs MCP",
+    },
+    "linear-mcp": { file: "mcp--linear.md", category: "mcp", description: "Linear hosted MCP" },
+    "slack-mcp": {
+        file: "mcp--slack.md",
+        category: "mcp",
+        description: "Slack MCP (hosted or local bridge)",
+    },
+    fumadocs: {
+        file: "kb--fumadocs.md",
+        category: "kb",
+        description: "Mount a Fumadocs content tree as a knowledge base",
+    },
+    postgres: { file: "data--postgres.md", category: "data", description: "Postgres data connector" },
+    notion: {
+        file: "data--notion.md",
+        category: "data",
+        description: "Notion (hosted MCP or REST adapter)",
+    },
 };
-const RECIPE_REGISTRY_URL = 'https://raw.githubusercontent.com/Fabric-Pro/fabric-harness/main/connectors';
+const RECIPE_REGISTRY_URL = "https://raw.githubusercontent.com/Fabric-Pro/fabric-harness/main/connectors";
 const RECIPE_FREEFORM_TEMPLATE = `# Fabric Harness connector recipe (freeform)
 
 Category: {{CATEGORY}}
@@ -915,18 +1284,18 @@ Return the full TS file content when done.
 function detectCodingAgentForHint() {
     // Common signals (env vars set by these agents when they shell out)
     const env = process.env;
-    if (env.CLAUDE_CODE === '1' || env.CLAUDECODE === '1' || env.CLAUDE_PROJECT_DIR)
-        return { name: 'claude', pipeHint: 'claude' };
-    if (env.CODEX_AGENT === '1' || env.CODEX_HOME)
-        return { name: 'codex', pipeHint: 'codex' };
-    if (env.CURSOR_AGENT === '1' || env.CURSOR_TRACE_ID)
-        return { name: 'cursor-agent', pipeHint: 'cursor-agent' };
+    if (env.CLAUDE_CODE === "1" || env.CLAUDECODE === "1" || env.CLAUDE_PROJECT_DIR)
+        return { name: "claude", pipeHint: "claude" };
+    if (env.CODEX_AGENT === "1" || env.CODEX_HOME)
+        return { name: "codex", pipeHint: "codex" };
+    if (env.CURSOR_AGENT === "1" || env.CURSOR_TRACE_ID)
+        return { name: "cursor-agent", pipeHint: "cursor-agent" };
     if (env.AIDER_RUNNING)
-        return { name: 'aider', pipeHint: 'aider' };
-    if (env.OPENCODE === '1')
-        return { name: 'opencode', pipeHint: 'opencode' };
+        return { name: "aider", pipeHint: "aider" };
+    if (env.OPENCODE === "1")
+        return { name: "opencode", pipeHint: "opencode" };
     // Default hint: most users have one of these installed; pick claude as the canonical example.
-    return { name: 'your coding agent', pipeHint: 'claude' };
+    return { name: "your coding agent", pipeHint: "claude" };
 }
 async function fetchRemoteRecipe(file) {
     try {
@@ -944,7 +1313,7 @@ async function loadRecipeBody(file) {
     // Prefer local copy (developing locally / repo cloned) — falls back to remote.
     try {
         const localPath = await findConnectorRecipe(file);
-        return await fs.readFile(localPath, 'utf8');
+        return await fs.readFile(localPath, "utf8");
     }
     catch {
         const remote = await fetchRemoteRecipe(file);
@@ -959,16 +1328,18 @@ async function addCommand(args) {
     let print = false;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
-        if (arg === '--print') {
+        if (arg === undefined)
+            continue;
+        if (arg === "--print") {
             print = true;
             continue;
         }
-        if (arg === '--category') {
+        if (arg === "--category") {
             category = args[i + 1];
             i += 1;
             continue;
         }
-        if (!connector && !arg.startsWith('-')) {
+        if (!connector && !arg.startsWith("-")) {
             connector = arg;
             continue;
         }
@@ -976,7 +1347,7 @@ async function addCommand(args) {
     }
     // No connector → list available recipes.
     if (!connector) {
-        console.log('Available connector recipes:\n');
+        console.log("Available connector recipes:\n");
         const byCategory = new Map();
         for (const [name, meta] of Object.entries(CONNECTOR_RECIPES)) {
             const list = byCategory.get(meta.category) ?? [];
@@ -994,18 +1365,18 @@ async function addCommand(args) {
         console.log(`Pipe a recipe to ${agent.name}:`);
         console.log(`  fabric-harness add <name> | ${agent.pipeHint}`);
         console.log();
-        console.log('Or build a freeform recipe from a provider URL:');
+        console.log("Or build a freeform recipe from a provider URL:");
         console.log(`  fabric-harness add https://e2b.dev --category sandbox | ${agent.pipeHint}`);
         return;
     }
     // URL-form: build a freeform template instructing the agent to scaffold from docs.
     if (/^https?:\/\//.test(connector)) {
         if (!category)
-            throw new Error('--category is required when passing a URL (sandbox, mcp, kb, or data).');
-        if (!['sandbox', 'mcp', 'kb', 'data'].includes(category)) {
+            throw new Error("--category is required when passing a URL (sandbox, mcp, kb, or data).");
+        if (!["sandbox", "mcp", "kb", "data"].includes(category)) {
             throw new Error(`Unknown category "${category}". Must be one of: sandbox, mcp, kb, data.`);
         }
-        const body = RECIPE_FREEFORM_TEMPLATE.replaceAll('{{URL}}', connector).replaceAll('{{CATEGORY}}', category);
+        const body = RECIPE_FREEFORM_TEMPLATE.replaceAll("{{URL}}", connector).replaceAll("{{CATEGORY}}", category);
         if (!process.stdout.isTTY || print) {
             process.stdout.write(body);
             return;
@@ -1031,13 +1402,13 @@ async function addCommand(args) {
     console.log(`Pipe to ${agent.name}:`);
     console.log(`  fabric-harness add ${connector} | ${agent.pipeHint}`);
     console.log();
-    console.log(`Or print the markdown directly:`);
+    console.log("Or print the markdown directly:");
     console.log(`  fabric-harness add ${connector} --print`);
 }
 async function findConnectorRecipe(file) {
     let current = process.cwd();
     while (true) {
-        const candidate = path.join(current, 'connectors', file);
+        const candidate = path.join(current, "connectors", file);
         try {
             await fs.access(candidate);
             return candidate;
@@ -1050,7 +1421,7 @@ async function findConnectorRecipe(file) {
             break;
         current = parent;
     }
-    const fromCli = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', '..', '..', 'connectors', file);
+    const fromCli = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..", "..", "..", "connectors", file);
     try {
         await fs.access(fromCli);
         return fromCli;
@@ -1061,17 +1432,17 @@ async function findConnectorRecipe(file) {
 }
 async function verifyCommand(args, kind) {
     const [target, ...rest] = args;
-    if (!target || target.startsWith('-'))
+    if (!target || target.startsWith("-"))
         throw new Error(`Missing required <build-dir-or-${kind}> argument.`);
     if (rest.length > 0)
         throw new Error(`Unknown argument: ${rest[0]}`);
-    const result = kind === 'attestation' ? await verifyAttestation(target) : await verifyProvenance(target);
+    const result = kind === "attestation" ? await verifyAttestation(target) : await verifyProvenance(target);
     printResult(result);
 }
 async function inspectCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for inspect.');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for inspect.");
     if (rest.length > 0)
         throw new Error(`Unknown argument: ${rest[0]}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1081,34 +1452,76 @@ async function inspectCommand(args) {
     printResult(data);
 }
 async function replayCommand(args) {
-    const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for replay.');
-    if (rest.length > 0)
-        throw new Error(`Unknown argument: ${rest[0]}`);
+    let sessionId;
+    let fromStep;
+    let limit;
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--from") {
+            const value = args[++i];
+            if (!value)
+                throw new Error("Missing value for --from.");
+            fromStep = value;
+            continue;
+        }
+        if (arg === "--limit") {
+            const value = args[++i];
+            const n = Number(value);
+            if (!value || !Number.isFinite(n) || n <= 0)
+                throw new Error("--limit must be a positive integer.");
+            limit = Math.floor(n);
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            console.log("Usage: fabric-harness replay <session-id> [--from <step-id>] [--limit <n>]");
+            console.log("");
+            console.log("Shows the read-only active path and model context. With --from, starts at the matching step (entry id).");
+            return;
+        }
+        if (!arg)
+            continue;
+        if (arg.startsWith("-"))
+            throw new Error(`Unknown argument: ${arg}`);
+        if (sessionId)
+            throw new Error(`Unknown argument: ${arg}`);
+        sessionId = arg;
+    }
+    if (!sessionId)
+        throw new Error("Missing required <session-id> argument for replay.");
     const { store } = await loadConfiguredStoreForWorkspace();
     const replay = await inspectReplayFromStore(store, sessionId);
     if (!replay)
         throw new Error(`Session not found: ${sessionId}`);
+    let activePath = replay.activePath;
+    if (fromStep) {
+        const idx = activePath.findIndex((entry) => entry.id === fromStep);
+        if (idx === -1)
+            throw new Error(`Step not found in active path: ${fromStep}`);
+        activePath = activePath.slice(idx);
+    }
+    if (limit !== undefined)
+        activePath = activePath.slice(0, limit);
     console.log(`Replay inspection for session ${replay.sessionId}`);
-    console.log('');
-    console.log(`Active path entries: ${replay.activePath.length}`);
-    for (const entry of replay.activePath) {
-        console.log(`${entry.timestamp}  ${entry.type}  ${entry.id}${entry.parentId ? ` <- ${entry.parentId}` : ''}`);
-    }
-    console.log('');
+    if (fromStep)
+        console.log(`Filtered from step: ${fromStep}`);
+    console.log("");
+    console.log(`Active path entries: ${activePath.length}${fromStep || limit !== undefined ? ` (of ${replay.activePath.length} total)` : ""}`);
+    for (const entry of activePath) {
+        console.log(`${entry.timestamp}  ${entry.type}  ${entry.id}${entry.parentId ? ` <- ${entry.parentId}` : ""}`);
+    }
+    console.log("");
     if (replay.latestCompaction) {
         console.log(`Latest compaction: ${replay.latestCompaction.id}`);
         console.log(formatInline(replay.latestCompaction.data ?? {}));
     }
     else {
-        console.log('Latest compaction: none');
+        console.log("Latest compaction: none");
     }
-    console.log('');
+    console.log("");
     console.log(`Model context messages: ${replay.modelMessages.length}`);
     for (const message of replay.modelMessages) {
-        const name = message.name ? ` name=${message.name}` : '';
-        console.log(`${message.role}${name}: ${message.content.replace(/\s+/g, ' ').slice(0, 240)}`);
+        const name = message.name ? ` name=${message.name}` : "";
+        console.log(`${message.role}${name}: ${message.content.replace(/\s+/g, " ").slice(0, 240)}`);
     }
 }
 async function doctorCommand(args) {
@@ -1119,28 +1532,28 @@ async function doctorCommand(args) {
     let jsonOutput = false;
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
-        if (arg === '--target') {
+        if (arg === "--target") {
             const value = args[++index];
-            if (value !== 'node' && value !== 'temporal-worker')
-                throw new Error('--target for doctor must be node or temporal-worker.');
+            if (value !== "node" && value !== "temporal-worker")
+                throw new Error("--target for doctor must be node or temporal-worker.");
             target = value;
             continue;
         }
-        if (arg === '--model') {
+        if (arg === "--model") {
             model = args[++index];
             if (!model)
-                throw new Error('Missing value for --model.');
+                throw new Error("Missing value for --model.");
             continue;
         }
-        if (arg === '--tools') {
+        if (arg === "--tools") {
             checkTools = true;
             continue;
         }
-        if (arg === '--live') {
+        if (arg === "--live") {
             live = true;
             continue;
         }
-        if (arg === '--json') {
+        if (arg === "--json") {
             jsonOutput = true;
             continue;
         }
@@ -1148,33 +1561,72 @@ async function doctorCommand(args) {
     }
     const workspaceRoot = await findWorkspaceRoot();
     const checks = [];
-    checks.push({ name: 'workspace', ok: true, message: workspaceRoot });
+    checks.push({ name: "workspace", ok: true, message: workspaceRoot });
     let config = {};
     try {
         config = await loadFabricHarnessConfig({ workspaceRoot });
-        const configuredTarget = target ?? config.run?.target ?? 'node';
-        checks.push({ name: 'run-target', ok: true, message: configuredTarget });
+        const configuredTarget = target ?? config.run?.target ?? "node";
+        checks.push({ name: "run-target", ok: true, message: configuredTarget });
         const doctorModel = model ?? process.env.FABRIC_MODEL ?? config.run?.model ?? config.agent?.model;
-        const resolved = resolveModelProvider({ ...(doctorModel !== undefined ? { model: doctorModel } : {}), ...(config.agent?.providers !== undefined ? { providers: config.agent.providers } : {}) });
-        checks.push({ name: 'model', ok: Boolean(resolved.provider), message: resolved.provider ? `${resolved.providerName}/${resolved.modelId}` : 'model disabled' });
+        const resolved = resolveModelProvider({
+            ...(doctorModel !== undefined ? { model: doctorModel } : {}),
+            ...(config.agent?.providers !== undefined ? { providers: config.agent.providers } : {}),
+        });
+        checks.push({
+            name: "model",
+            ok: Boolean(resolved.provider),
+            message: resolved.provider
+                ? `${resolved.providerName}/${resolved.modelId}`
+                : "model disabled",
+        });
         for (const warning of resolved.warnings)
-            checks.push({ name: 'model-warning', ok: true, message: warning });
+            checks.push({ name: "model-warning", ok: true, message: warning });
         if (live && resolved.provider) {
-            const response = await resolved.provider.generate({ ...(resolved.model !== undefined ? { model: resolved.model } : {}), messages: [{ role: 'user', content: 'Say exactly: fabric harness doctor ok' }] });
-            checks.push({ name: 'model-live', ok: Boolean(response.message?.content || response.toolCalls?.length), message: response.message?.content?.slice(0, 120) ?? `${response.toolCalls?.length ?? 0} tool calls` });
+            const response = await resolved.provider.generate({
+                ...(resolved.model !== undefined ? { model: resolved.model } : {}),
+                messages: [{ role: "user", content: "Say exactly: fabric harness doctor ok" }],
+            });
+            checks.push({
+                name: "model-live",
+                ok: Boolean(response.message?.content || response.toolCalls?.length),
+                message: response.message?.content?.slice(0, 120) ??
+                    `${response.toolCalls?.length ?? 0} tool calls`,
+            });
         }
     }
     catch (error) {
-        checks.push({ name: 'model', ok: false, message: error instanceof Error ? error.message : String(error) });
+        checks.push({
+            name: "model",
+            ok: false,
+            message: error instanceof Error ? error.message : String(error),
+        });
     }
     try {
-        const store = await createConfiguredSessionStore({ workspaceRoot, ...(config.store ? { config: config.store } : {}), env: process.env });
-        await store.save({ id: 'doctor-write-test', createdAt: new Date().toISOString(), updatedAt: new Date().toISOString(), entries: [], events: [] });
-        const message = config.store?.backend ? config.store.backend : store instanceof FileSessionStore ? store.sessionsDir : 'default';
-        checks.push({ name: 'session-store', ok: true, message });
+        const store = await createConfiguredSessionStore({
+            workspaceRoot,
+            ...(config.store ? { config: config.store } : {}),
+            env: process.env,
+        });
+        await store.save({
+            id: "doctor-write-test",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            entries: [],
+            events: [],
+        });
+        const message = config.store?.backend
+            ? config.store.backend
+            : store instanceof FileSessionStore
+                ? store.sessionsDir
+                : "default";
+        checks.push({ name: "session-store", ok: true, message });
     }
     catch (error) {
-        checks.push({ name: 'session-store', ok: false, message: error instanceof Error ? error.message : String(error) });
+        checks.push({
+            name: "session-store",
+            ok: false,
+            message: error instanceof Error ? error.message : String(error),
+        });
     }
     if (checkTools) {
         try {
@@ -1182,32 +1634,42 @@ async function doctorCommand(args) {
             const schemas = toolsToModelSchemas(createBuiltinTools(sandbox));
             for (const schema of schemas) {
                 const input = schema.inputSchema;
-                if (input?.type !== 'object' || typeof input.properties !== 'object' || input.properties === null)
+                if (input?.type !== "object" ||
+                    typeof input.properties !== "object" ||
+                    input.properties === null)
                     throw new Error(`Invalid schema for tool ${schema.name}`);
             }
-            checks.push({ name: 'tools', ok: true, message: `${schemas.length} tool schemas valid` });
+            checks.push({ name: "tools", ok: true, message: `${schemas.length} tool schemas valid` });
         }
         catch (error) {
-            checks.push({ name: 'tools', ok: false, message: error instanceof Error ? error.message : String(error) });
-        }
-    }
-    if ((target ?? config.run?.target) === 'temporal-worker') {
-        const address = process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? 'localhost:7233';
-        const taskQueue = process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? 'fabric-harness';
-        checks.push({ name: 'temporal', ok: true, message: `configured address ${address}, taskQueue ${taskQueue}; start a worker/server for live validation` });
+            checks.push({
+                name: "tools",
+                ok: false,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    if ((target ?? config.run?.target) === "temporal-worker") {
+        const address = process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? "localhost:7233";
+        const taskQueue = process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? "fabric-harness";
+        checks.push({
+            name: "temporal",
+            ok: true,
+            message: `configured address ${address}, taskQueue ${taskQueue}; start a worker/server for live validation`,
+        });
     }
     if (jsonOutput) {
         printResult({ ok: checks.every((check) => check.ok), checks });
         return;
     }
     for (const check of checks)
-        console.log(`${check.ok ? '✓' : '✗'} ${check.name}: ${check.message}`);
+        console.log(`${check.ok ? "✓" : "✗"} ${check.name}: ${check.message}`);
     if (!checks.every((check) => check.ok))
         process.exitCode = 1;
 }
 async function agentsCommand(args) {
-    const jsonOutput = args.includes('--json');
-    const unknown = args.find((arg) => arg !== '--json');
+    const jsonOutput = args.includes("--json");
+    const unknown = args.find((arg) => arg !== "--json");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const workspaceRoot = await findWorkspaceRoot();
@@ -1217,18 +1679,18 @@ async function agentsCommand(args) {
         return;
     }
     if (agents.length === 0) {
-        console.log('No agents found.');
+        console.log("No agents found.");
         return;
     }
     for (const item of agents)
-        console.log(`${item.name.padEnd(20)} ${item.description ?? ''}`.trimEnd());
+        console.log(`${item.name.padEnd(20)} ${item.description ?? ""}`.trimEnd());
 }
 async function describeCommand(args) {
     const [agentName, ...rest] = args;
-    if (!agentName || agentName.startsWith('-'))
-        throw new Error('Missing required <agent> argument for describe.');
-    const jsonOutput = rest.includes('--json');
-    const unknown = rest.find((arg) => arg !== '--json');
+    if (!agentName || agentName.startsWith("-"))
+        throw new Error("Missing required <agent> argument for describe.");
+    const jsonOutput = rest.includes("--json");
+    const unknown = rest.find((arg) => arg !== "--json");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const workspaceRoot = await findWorkspaceRoot();
@@ -1246,19 +1708,19 @@ async function describeCommand(args) {
         console.log(`Default model: ${description.model}`);
     if (description.target)
         console.log(`Default target: ${description.target}`);
-    console.log('');
-    console.log('Input:');
-    printSchema(description.inputSchema, '  ');
-    console.log('');
-    console.log('Output:');
-    printSchema(description.outputSchema, '  ');
-    console.log('');
-    console.log('Examples:');
+    console.log("");
+    console.log("Input:");
+    printSchema(description.inputSchema, "  ");
+    console.log("");
+    console.log("Output:");
+    printSchema(description.outputSchema, "  ");
+    console.log("");
+    console.log("Examples:");
     const input = description.inputSchema;
-    const firstField = input?.type === 'object' ? Object.keys(input.properties ?? {})[0] : undefined;
+    const firstField = input?.type === "object" ? Object.keys(input.properties ?? {})[0] : undefined;
     if (firstField)
         console.log(`  fabric-harness run ${agentName} --${firstField} "..."`);
-    console.log(`  fabric-harness run ${agentName} --payload '{"${firstField ?? 'input'}":"..."}'`);
+    console.log(`  fabric-harness run ${agentName} --payload '{"${firstField ?? "input"}":"..."}'`);
 }
 function printSchema(value, indent) {
     if (!value) {
@@ -1266,7 +1728,7 @@ function printSchema(value, indent) {
         return;
     }
     const schema = value;
-    if (schema.type === 'object') {
+    if (schema.type === "object") {
         const required = new Set(schema.required ?? []);
         const properties = schema.properties ?? {};
         if (Object.keys(properties).length === 0) {
@@ -1275,38 +1737,46 @@ function printSchema(value, indent) {
         }
         for (const [key, property] of Object.entries(properties)) {
             const field = property;
-            const req = required.has(key) ? 'required' : 'optional';
-            const enumText = field.enum ? ` enum=${field.enum.join('|')}` : '';
-            const desc = field.description ? ` - ${field.description}` : '';
-            console.log(`${indent}${key.padEnd(16)} ${(field.type ?? 'unknown').padEnd(8)} ${req}${enumText}${desc}`);
+            const req = required.has(key) ? "required" : "optional";
+            const enumText = field.enum ? ` enum=${field.enum.join("|")}` : "";
+            const desc = field.description ? ` - ${field.description}` : "";
+            console.log(`${indent}${key.padEnd(16)} ${(field.type ?? "unknown").padEnd(8)} ${req}${enumText}${desc}`);
         }
         return;
     }
-    const enumText = schema.enum ? ` enum=${schema.enum.join('|')}` : '';
-    const desc = schema.description ? ` - ${schema.description}` : '';
-    console.log(`${indent}${schema.type ?? 'unknown'}${enumText}${desc}`);
+    const enumText = schema.enum ? ` enum=${schema.enum.join("|")}` : "";
+    const desc = schema.description ? ` - ${schema.description}` : "";
+    console.log(`${indent}${schema.type ?? "unknown"}${enumText}${desc}`);
 }
 async function sessionsCommand(args) {
     if (args.length > 0)
         throw new Error(`Unknown argument: ${args[0]}`);
     const workspaceRoot = await findWorkspaceRoot();
     const config = await loadFabricHarnessConfig({ workspaceRoot });
-    const store = await createConfiguredSessionStore({ workspaceRoot, ...(config.store ? { config: config.store } : {}), env: process.env });
+    const store = await createConfiguredSessionStore({
+        workspaceRoot,
+        ...(config.store ? { config: config.store } : {}),
+        env: process.env,
+    });
     const sessions = await listSessionSummariesFromStore(store);
     if (sessions.length === 0) {
-        console.log('No sessions found.');
+        console.log("No sessions found.");
         return;
     }
     for (const session of sessions) {
-        const agent = session.agentId ? ` agent=${session.agentId}` : '';
-        const error = session.latestError ? ` error=${session.latestError}` : '';
+        const agent = session.agentId ? ` agent=${session.agentId}` : "";
+        const error = session.latestError ? ` error=${session.latestError}` : "";
         console.log(`${session.updatedAt}  ${session.id}${agent} entries=${session.entries} events=${session.events} approvals=${session.pendingApprovals}/${session.terminalApprovals}${error}`);
     }
 }
 async function loadConfiguredStoreForWorkspace() {
     const workspaceRoot = await findWorkspaceRoot();
     const config = await loadFabricHarnessConfig({ workspaceRoot });
-    const store = await createConfiguredSessionStore({ workspaceRoot, ...(config.store ? { config: config.store } : {}), env: process.env });
+    const store = await createConfiguredSessionStore({
+        workspaceRoot,
+        ...(config.store ? { config: config.store } : {}),
+        env: process.env,
+    });
     return { workspaceRoot, config, store };
 }
 async function buildsCommand(args) {
@@ -1315,66 +1785,70 @@ async function buildsCommand(args) {
     const workspaceRoot = await findWorkspaceRoot();
     const builds = await listBuilds(workspaceRoot);
     if (builds.length === 0) {
-        console.log('No builds found.');
+        console.log("No builds found.");
         return;
     }
     for (const build of builds) {
-        const entrypoint = build.entrypoint ? ` entry=${build.entrypoint}` : '';
+        const entrypoint = build.entrypoint ? ` entry=${build.entrypoint}` : "";
         console.log(`${build.createdAt}  ${build.target}${entrypoint} agents=${build.agents} roles=${build.roles} skills=${build.skills} files=${build.files}`);
     }
 }
 async function approvalsCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for approvals.');
-    const pendingOnly = rest.includes('--pending');
-    const stateView = rest.includes('--state');
-    const unknown = rest.find((arg) => arg !== '--pending' && arg !== '--state');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for approvals.");
+    const pendingOnly = rest.includes("--pending");
+    const stateView = rest.includes("--state");
+    const unknown = rest.find((arg) => arg !== "--pending" && arg !== "--state");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const { store } = await loadConfiguredStoreForWorkspace();
     if (stateView) {
-        const states = (await listApprovalStatesFromStore(store, sessionId)).filter((approval) => !pendingOnly || approval.status === 'pending');
+        const states = (await listApprovalStatesFromStore(store, sessionId)).filter((approval) => !pendingOnly || approval.status === "pending");
         if (states.length === 0) {
             console.log(`No approvals found for session ${sessionId}.`);
             return;
         }
         for (const state of states) {
-            const actors = state.votes.map((vote) => `${typeof vote.actor === 'string' ? vote.actor : vote.actor.id}:${vote.decision}`).join(',') || 'none';
-            const resolved = state.resolvedAt ? ` resolved=${state.resolvedAt}` : '';
+            const actors = state.votes
+                .map((vote) => `${typeof vote.actor === "string" ? vote.actor : vote.actor.id}:${vote.decision}`)
+                .join(",") || "none";
+            const resolved = state.resolvedAt ? ` resolved=${state.resolvedAt}` : "";
             console.log(`${state.status}  ${state.id}  approvals=${state.approvedCount}/${state.requiredApprovals} denials=${state.deniedCount} votes=${actors}${resolved} subject=${state.request.subject}`);
         }
         return;
     }
-    const approvals = (await listApprovalsFromStore(store, sessionId)).filter((approval) => !pendingOnly || approval.status === 'pending');
+    const approvals = (await listApprovalsFromStore(store, sessionId)).filter((approval) => !pendingOnly || approval.status === "pending");
     if (approvals.length === 0) {
         console.log(`No approvals found for session ${sessionId}.`);
         return;
     }
     for (const approval of approvals) {
-        const resolved = approval.resolvedAt ? ` resolved=${approval.resolvedAt}` : '';
-        const risk = approval.risk ? ` risk=${approval.risk}` : '';
-        const pattern = approval.matchedPattern ? ` pattern=${approval.matchedPattern}` : '';
-        const env = approval.envKeys?.length ? ` env=${approval.envKeys.join(',')}` : '';
-        const paths = approval.affectedPaths?.length ? ` paths=${approval.affectedPaths.join(',')}` : '';
+        const resolved = approval.resolvedAt ? ` resolved=${approval.resolvedAt}` : "";
+        const risk = approval.risk ? ` risk=${approval.risk}` : "";
+        const pattern = approval.matchedPattern ? ` pattern=${approval.matchedPattern}` : "";
+        const env = approval.envKeys?.length ? ` env=${approval.envKeys.join(",")}` : "";
+        const paths = approval.affectedPaths?.length
+            ? ` paths=${approval.affectedPaths.join(",")}`
+            : "";
         console.log(`${approval.requestedAt}  ${approval.status}  ${approval.id}  ${approval.kind}:${approval.subject}${risk}${pattern}${env}${paths}${resolved} reason=${approval.reason}`);
     }
 }
 async function resolveApprovalCommand(args, decision) {
     const [sessionId, approvalId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
+    if (!sessionId || sessionId.startsWith("-"))
         throw new Error(`Missing required <session-id> argument for ${decision}.`);
-    if (!approvalId || approvalId.startsWith('-'))
+    if (!approvalId || approvalId.startsWith("-"))
         throw new Error(`Missing required <approval-id> argument for ${decision}.`);
     let reason;
-    let actor = 'cli';
+    let actor = "cli";
     for (let index = 0; index < rest.length; index += 1) {
         const arg = rest[index];
-        if (arg === '--reason') {
+        if (arg === "--reason") {
             reason = rest[++index];
             continue;
         }
-        if (arg === '--actor') {
+        if (arg === "--actor") {
             actor = rest[++index] ?? actor;
             continue;
         }
@@ -1386,22 +1860,28 @@ async function resolveApprovalCommand(args, decision) {
     printResult(resolved);
 }
 async function signalTemporalApprovalIfNeeded(workspaceRoot, sessionId, approval, decision, reason) {
-    if (!approval.workflowId || (approval.status !== 'approved' && approval.status !== 'denied'))
+    if (!approval.workflowId || (approval.status !== "approved" && approval.status !== "denied"))
         return;
     const config = await loadFabricHarnessConfig({ workspaceRoot });
     try {
         const namespace = process.env.FABRIC_TEMPORAL_NAMESPACE ?? config.temporal?.namespace;
         const client = await createTemporalClient({
-            mode: 'temporal',
-            address: process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? 'localhost:7233',
-            taskQueue: process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? 'fabric-harness',
+            mode: "temporal",
+            address: process.env.FABRIC_TEMPORAL_ADDRESS ?? config.temporal?.address ?? "localhost:7233",
+            taskQueue: process.env.FABRIC_TEMPORAL_TASK_QUEUE ?? config.temporal?.taskQueue ?? "fabric-harness",
             ...(namespace ? { namespace } : {}),
             ...(config.temporal?.apiKey ? { apiKey: config.temporal.apiKey } : {}),
             ...(config.temporal?.apiKeyEnv ? { apiKeyEnv: config.temporal.apiKeyEnv } : {}),
             ...(config.temporal?.tls ? { tls: config.temporal.tls } : {}),
         });
         try {
-            await client.signalWorkflowApproval(approval.workflowId, { approvalId: approval.id, decision, ...(reason ?? approval.resolutionReason ? { reason: reason ?? approval.resolutionReason } : {}) });
+            await client.signalWorkflowApproval(approval.workflowId, {
+                approvalId: approval.id,
+                decision,
+                ...((reason ?? approval.resolutionReason)
+                    ? { reason: reason ?? approval.resolutionReason }
+                    : {}),
+            });
             console.error(`Signaled Temporal workflow ${approval.workflowId} for approval ${approval.id}.`);
         }
         finally {
@@ -1414,8 +1894,8 @@ async function signalTemporalApprovalIfNeeded(workspaceRoot, sessionId, approval
 }
 async function checkpointsCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for checkpoints.');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for checkpoints.");
     if (rest.length > 0)
         throw new Error(`Unknown argument: ${rest[0]}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1425,24 +1905,24 @@ async function checkpointsCommand(args) {
         return;
     }
     for (const checkpoint of checkpoints) {
-        const snapshot = checkpoint.snapshotId ? ` snapshot=${checkpoint.snapshotId}` : '';
+        const snapshot = checkpoint.snapshotId ? ` snapshot=${checkpoint.snapshotId}` : "";
         console.log(`${checkpoint.timestamp}  ${checkpoint.label}  entry=${checkpoint.entryId}${snapshot} restored=${checkpoint.restoredCount}`);
     }
 }
 async function compactCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for compact.');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for compact.");
     let keepRecentEntries;
     let summary;
     for (let index = 0; index < rest.length; index += 1) {
         const arg = rest[index];
-        if (arg === '--keep') {
+        if (arg === "--keep") {
             const value = rest[++index];
             keepRecentEntries = value ? Number(value) : undefined;
             continue;
         }
-        if (arg === '--summary') {
+        if (arg === "--summary") {
             summary = rest[++index];
             continue;
         }
@@ -1458,10 +1938,10 @@ async function compactCommand(args) {
 }
 async function logsCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for logs.');
-    const showEvents = rest.includes('--events');
-    const unknown = rest.find((arg) => arg !== '--events');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for logs.");
+    const showEvents = rest.includes("--events");
+    const unknown = rest.find((arg) => arg !== "--events");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1473,25 +1953,25 @@ async function logsCommand(args) {
     console.log(`Updated: ${data.updatedAt}`);
     if (data.agentId)
         console.log(`Agent:   ${data.agentId}`);
-    console.log('');
-    const entries = showEvents ? data.events ?? [] : data.entries ?? [];
+    console.log("");
+    const entries = showEvents ? (data.events ?? []) : (data.entries ?? []);
     if (entries.length === 0) {
-        console.log(showEvents ? 'No events.' : 'No structured entries.');
+        console.log(showEvents ? "No events." : "No structured entries.");
         return;
     }
     for (const item of entries) {
-        const timestamp = 'timestamp' in item ? item.timestamp : '';
-        const type = 'type' in item ? item.type : 'unknown';
-        const dataText = 'data' in item && item.data !== undefined ? ` ${formatInline(item.data)}` : '';
+        const timestamp = "timestamp" in item ? item.timestamp : "";
+        const type = "type" in item ? item.type : "unknown";
+        const dataText = "data" in item && item.data !== undefined ? ` ${formatInline(item.data)}` : "";
         console.log(`${timestamp}  ${type}${dataText}`);
     }
 }
 async function artifactsCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for artifacts.');
-    const json = rest.includes('--json');
-    const unknown = rest.find((arg) => arg !== '--json');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for artifacts.");
+    const json = rest.includes("--json");
+    const unknown = rest.find((arg) => arg !== "--json");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1503,18 +1983,18 @@ async function artifactsCommand(args) {
         return;
     }
     for (const artifact of artifacts)
-        console.log(`${artifact.id}  ${artifact.name}  ${artifact.size} bytes  ${artifact.contentType ?? 'application/octet-stream'}`);
+        console.log(`${artifact.id}  ${artifact.name}  ${artifact.size} bytes  ${artifact.contentType ?? "application/octet-stream"}`);
 }
 async function artifactCommand(args) {
     const [subcommand, sessionId, artifactIdOrName, ...rest] = args;
-    if (subcommand !== 'get')
-        throw new Error('Usage: fabric-harness artifact get <session-id> <artifact-id-or-name> [--out <path>]');
+    if (subcommand !== "get")
+        throw new Error("Usage: fabric-harness artifact get <session-id> <artifact-id-or-name> [--out <path>]");
     if (!sessionId || !artifactIdOrName)
-        throw new Error('Usage: fabric-harness artifact get <session-id> <artifact-id-or-name> [--out <path>]');
+        throw new Error("Usage: fabric-harness artifact get <session-id> <artifact-id-or-name> [--out <path>]");
     let out;
     for (let index = 0; index < rest.length; index += 1) {
         const arg = rest[index];
-        if (arg === '--out') {
+        if (arg === "--out") {
             out = rest[++index];
             continue;
         }
@@ -1535,10 +2015,10 @@ async function artifactCommand(args) {
 }
 async function metricsCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for metrics.');
-    const json = rest.includes('--json');
-    const unknown = rest.find((arg) => arg !== '--json');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for metrics.");
+    const json = rest.includes("--json");
+    const unknown = rest.find((arg) => arg !== "--json");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1555,13 +2035,26 @@ async function metricsCommand(args) {
     console.log(`Tools: calls=${metrics.toolCalls} durationMs=${metrics.toolDurationMs}`);
     console.log(`Shell: commands=${metrics.shellCommands} durationMs=${metrics.shellDurationMs}`);
     console.log(`Artifacts: ${metrics.artifacts}`);
+    console.log(`Mounts: count=${metrics.mounts} files=${metrics.mountFiles} bytes=${metrics.mountBytes}`);
+    if (metrics.perTool) {
+        const top = Object.entries(metrics.perTool)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        console.log(`Top tools: ${top.map(([name, count]) => `${name}=${count}`).join(" ")}`);
+    }
+    if (metrics.perSource) {
+        const top = Object.entries(metrics.perSource)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        console.log(`Top sources by bytes: ${top.map(([name, bytes]) => `${name}=${bytes}`).join(" ")}`);
+    }
 }
 async function tasksCommand(args) {
     const [sessionId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for tasks.');
-    const json = rest.includes('--json');
-    const unknown = rest.find((arg) => arg !== '--json');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for tasks.");
+    const json = rest.includes("--json");
+    const unknown = rest.find((arg) => arg !== "--json");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1573,8 +2066,8 @@ async function tasksCommand(args) {
         return;
     }
     for (const task of tasks) {
-        const checkpointText = task.checkpoints.length ? ` checkpoints=${task.checkpoints.length}` : '';
-        const errorText = task.error ? ` error=${truncateInline(task.error)}` : '';
+        const checkpointText = task.checkpoints.length ? ` checkpoints=${task.checkpoints.length}` : "";
+        const errorText = task.error ? ` error=${truncateInline(task.error)}` : "";
         console.log(`${task.id}  ${task.status}  started=${task.startedAt} updated=${task.updatedAt}${checkpointText}${errorText}`);
         if (task.text)
             console.log(`  ${truncateInline(task.text)}`);
@@ -1582,12 +2075,12 @@ async function tasksCommand(args) {
 }
 async function taskCommand(args) {
     const [sessionId, taskId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for task.');
-    if (!taskId || taskId.startsWith('-'))
-        throw new Error('Missing required <task-id> argument for task.');
-    const json = rest.includes('--json');
-    const unknown = rest.find((arg) => arg !== '--json');
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for task.");
+    if (!taskId || taskId.startsWith("-"))
+        throw new Error("Missing required <task-id> argument for task.");
+    const json = rest.includes("--json");
+    const unknown = rest.find((arg) => arg !== "--json");
     if (unknown)
         throw new Error(`Unknown argument: ${unknown}`);
     const { store } = await loadConfiguredStoreForWorkspace();
@@ -1614,26 +2107,26 @@ async function taskCommand(args) {
     if (task.text)
         console.log(`Text:    ${task.text}`);
     if (task.checkpoints.length) {
-        console.log('Checkpoints:');
+        console.log("Checkpoints:");
         for (const checkpoint of task.checkpoints)
-            console.log(`  ${checkpoint.timestamp} ${checkpoint.phase ?? 'checkpoint'} ${checkpoint.checkpointId ?? checkpoint.entryId}`);
+            console.log(`  ${checkpoint.timestamp} ${checkpoint.phase ?? "checkpoint"} ${checkpoint.checkpointId ?? checkpoint.entryId}`);
     }
 }
 async function cancelTaskCommand(args) {
     const [sessionId, taskId, ...rest] = args;
-    if (!sessionId || sessionId.startsWith('-'))
-        throw new Error('Missing required <session-id> argument for cancel-task.');
-    if (!taskId || taskId.startsWith('-'))
-        throw new Error('Missing required <task-id> argument for cancel-task.');
-    let actor = 'cli';
+    if (!sessionId || sessionId.startsWith("-"))
+        throw new Error("Missing required <session-id> argument for cancel-task.");
+    if (!taskId || taskId.startsWith("-"))
+        throw new Error("Missing required <task-id> argument for cancel-task.");
+    let actor = "cli";
     let reason;
     for (let index = 0; index < rest.length; index += 1) {
         const arg = rest[index];
-        if (arg === '--actor') {
+        if (arg === "--actor") {
             actor = rest[++index] ?? actor;
             continue;
         }
-        if (arg === '--reason') {
+        if (arg === "--reason") {
             reason = rest[++index];
             continue;
         }
@@ -1649,77 +2142,83 @@ function truncateInline(text) {
 function formatInline(value) {
     const text = JSON.stringify(value);
     if (!text)
-        return '';
+        return "";
     return text.length > 240 ? `${text.slice(0, 237)}...` : text;
 }
 async function main(argv) {
     const [command, ...args] = argv;
-    if (!command || command === '--help' || command === '-h') {
+    if (!command || command === "--help" || command === "-h") {
         console.log(HELP);
         return;
     }
     await loadAutoEnvFiles();
-    if (command === 'run')
+    if (command === "run")
         return runCommand(args);
-    if (command === 'agents')
+    if (command === "agents")
         return agentsCommand(args);
-    if (command === 'describe')
+    if (command === "describe")
         return describeCommand(args);
-    if (command === 'build')
+    if (command === "build")
         return buildCommand(args);
-    if (command === 'sessions')
+    if (command === "sessions")
         return sessionsCommand(args);
-    if (command === 'builds')
+    if (command === "builds")
         return buildsCommand(args);
-    if (command === 'verify-attestation')
-        return verifyCommand(args, 'attestation');
-    if (command === 'verify-provenance')
-        return verifyCommand(args, 'provenance');
-    if (command === 'doctor')
+    if (command === "verify-attestation")
+        return verifyCommand(args, "attestation");
+    if (command === "verify-provenance")
+        return verifyCommand(args, "provenance");
+    if (command === "doctor")
         return doctorCommand(args);
-    if (command === 'add')
+    if (command === "add")
         return addCommand(args);
-    if (command === 'inspect')
+    if (command === "inspect")
         return inspectCommand(args);
-    if (command === 'logs')
+    if (command === "logs")
         return logsCommand(args);
-    if (command === 'checkpoints')
+    if (command === "checkpoints")
         return checkpointsCommand(args);
-    if (command === 'artifacts')
+    if (command === "artifacts")
         return artifactsCommand(args);
-    if (command === 'artifact')
+    if (command === "artifact")
         return artifactCommand(args);
-    if (command === 'metrics')
+    if (command === "metrics")
         return metricsCommand(args);
-    if (command === 'tasks')
+    if (command === "tasks")
         return tasksCommand(args);
-    if (command === 'task')
+    if (command === "task")
         return taskCommand(args);
-    if (command === 'cancel-task')
+    if (command === "cancel-task")
         return cancelTaskCommand(args);
-    if (command === 'compact')
+    if (command === "compact")
         return compactCommand(args);
-    if (command === 'replay')
+    if (command === "replay")
         return replayCommand(args);
-    if (command === 'approvals')
+    if (command === "approvals")
         return approvalsCommand(args);
-    if (command === 'approve')
-        return resolveApprovalCommand(args, 'approved');
-    if (command === 'reject')
-        return resolveApprovalCommand(args, 'denied');
-    if (command === 'dev')
+    if (command === "approve")
+        return resolveApprovalCommand(args, "approved");
+    if (command === "reject")
+        return resolveApprovalCommand(args, "denied");
+    if (command === "dev")
         return devCommand(args);
-    if (command === 'temporal-worker')
+    if (command === "temporal-worker")
         return temporalWorkerCommand(args);
+    if (command === "init")
+        return initCommand(args);
     throw new Error(`Unknown command: ${command}`);
 }
 try {
     await main(process.argv.slice(2));
 }
 catch (error) {
-    const message = error instanceof SchemaValidationError ? `Invalid payload or result:\n${error.issues.map((issue) => `- ${issue.path}: ${issue.message}`).join('\n')}` : error instanceof Error ? error.message : String(error);
+    const message = error instanceof SchemaValidationError
+        ? `Invalid payload or result:\n${error.issues.map((issue) => `- ${issue.path}: ${issue.message}`).join("\n")}`
+        : error instanceof Error
+            ? error.message
+            : String(error);
     console.error(`fabric-harness: ${message}`);
-    console.error('Run fabric-harness --help for usage.');
+    console.error("Run fabric-harness --help for usage.");
     process.exit(1);
 }
 //# sourceMappingURL=fabric-harness.js.map