@younndai/lyt 0.13.4 → 0.20.0

package/dist/commands/init.js

@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 import { Command } from "commander";
+import { createHash } from "node:crypto";
 import { createInterface } from "node:readline/promises";
-import { checkCurrency, closeRegistry, embeddingsOfferGate, formatCurrencyLine, getHandleFromIdentity, markAsked, materializePodLocal, openRegistry, readIdentityCache, reconcilePublishFlow, reconstructionExitCode, ReadlinePromptHandler, renderNextSteps, renderPodCard, resolveAskedState, runWizard, startSpinner, validateMeshName, } from "@younndai/lyt-vault";
+import { checkCurrency, closeRegistry, creationCheckpointPathDigest, creationLocalMutationCount, embeddingsOfferGate, formatCurrencyLine, getHandleFromIdentity, markAsked, openRegistry, readIdentityCache, newUuidv7Bytes, parseReceiptV1ForEmission, recoverVaultsFromPodManifest, reconstructionExitCode, ReadlinePromptHandler, renderNextSteps, renderPodCard, resolveAskedState, runWizard, startSpinner, syncPodLedgerFlow, validateMeshName, uuid7BytesToDashedString, } from "@younndai/lyt-vault";
 import { initBootstrapFlow, probeFreshState, resolveLocalFirst, } from "../flows/init-bootstrap.js";
 import { healPod, summarizeHeal } from "../flows/heal.js";
 export function buildLytInitCommand() {
@@ -24,204 +25,285 @@ export function buildLytInitCommand() {
         .option("--auto", "Force non-interactive bootstrap (skips first-init wizard auto-route)")
         .option("--custom", "Three-prompt walkthrough; conflicts with --auto; requires a TTY")
         .option("--discover", "Read-only GH delta; surface accessible lyt-* repos not in local registry")
-        .option("--wizard", "Force the 12-phase setup wizard (detect/install Node + gh + agent runtime, gh auth login, install Lyt skills, install agent manual, cross-machine adopt-detect, create personal mesh + first vault + federation repo, pod-map vault, first-use demo). Conflicts with --auto/--custom/--discover/--json.")
-        .option("--dry-run", "Only valid with --wizard. Walks all 12 wizard phases without spawn invocations or filesystem writes.")
+        .option("--wizard", "Force guided setup: verify prerequisites and authentication, install agent integrations, detect/adopt another machine, then create one local pod/mesh/main-vault checkpoint. It never publishes, generates a pod-map, or creates demo content. Conflicts with --auto/--custom/--discover/--json.")
+        .option("--dry-run", "Only valid with --wizard. Plans setup without spawn invocations or filesystem writes.")
         .option("--json", "Emit deterministic JSON")
         .action(async (opts) => {
-        const noMode = opts.auto !== true &&
-            opts.custom !== true &&
-            opts.discover !== true &&
-            opts.wizard !== true &&
-            opts.json !== true &&
-            opts.dryRun !== true;
-        if (noMode) {
-            let isFresh;
-            try {
-                isFresh = await probeFreshState();
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                emitError(false, { error: "first-init-probe-failed", message: msg });
-                process.exitCode = 1;
-                return;
+        const startedAt = new Date().toISOString();
+        const operationId = uuid7BytesToDashedString(newUuidv7Bytes());
+        const attemptId = uuid7BytesToDashedString(newUuidv7Bytes());
+        const originalLog = console.log;
+        console.log = (...args) => console.error(...args);
+        try {
+            const noMode = opts.auto !== true &&
+                opts.custom !== true &&
+                opts.discover !== true &&
+                opts.wizard !== true &&
+                opts.json !== true &&
+                opts.dryRun !== true;
+            if (noMode) {
+                let isFresh;
+                try {
+                    isFresh = await probeFreshState();
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    emitError(false, { error: "first-init-probe-failed", message: msg }, { operationId, attemptId, startedAt });
+                    process.exitCode = 1;
+                    return;
+                }
+                if (isFresh) {
+                    if (process.stdin.isTTY !== true) {
+                        emitError(false, {
+                            error: "first-init-requires-tty",
+                            message: "lyt init: interactive required for first-init; use --auto for non-interactive bootstrap.",
+                        }, { operationId, attemptId, startedAt });
+                        process.exitCode = 3;
+                        return;
+                    }
+                    opts.wizard = true;
+                }
             }
-            if (isFresh) {
-                if (process.stdin.isTTY !== true) {
+            if (opts.wizard === true) {
+                if (opts.auto === true ||
+                    opts.custom === true ||
+                    opts.discover === true ||
+                    opts.json === true) {
                     emitError(false, {
-                        error: "first-init-requires-tty",
-                        message: "lyt init: interactive required for first-init; use --auto for non-interactive bootstrap.",
-                    });
+                        error: "flag-conflict",
+                        message: "lyt init --wizard is mutually exclusive with --auto, --custom, --discover, and --json.",
+                    }, { operationId, attemptId, startedAt });
+                    process.exitCode = 2;
+                    return;
+                }
+                if (opts.dryRun !== true && process.stdin.isTTY !== true) {
+                    emitError(false, {
+                        error: "wizard-requires-tty",
+                        message: "lyt init --wizard requires an interactive terminal (or pass --dry-run for a non-TTY phase walk).",
+                    }, { operationId, attemptId, startedAt });
                     process.exitCode = 3;
                     return;
                 }
-                opts.wizard = true;
+                const handler = opts.dryRun === true ? makeDryRunDefaultsHandler() : new ReadlinePromptHandler();
+                try {
+                    const result = await runWizard({
+                        promptHandler: handler,
+                        dryRun: opts.dryRun === true,
+                    });
+                    const summaryLines = [
+                        "",
+                        "── Setup summary ──────────────────────────────────",
+                        ...result.phases.map((ph) => {
+                            const glyph = ph.skipped === true ? "⊘" : ph.ok ? "✓" : "✗";
+                            const num = String(ph.phase).padStart(2, " ");
+                            return `  ${glyph} Phase ${num}  ${ph.name} — ${ph.message}`;
+                        }),
+                        "───────────────────────────────────────────────────",
+                    ];
+                    console.error(summaryLines.join("\n"));
+                    if (result.status !== "completed") {
+                        const adoptPhase = result.phases.find((ph) => ph.name === "adopt-pod");
+                        process.exitCode = adoptPhase?.data?.reconstructExitCode ?? 1;
+                    }
+                    emitRootInitReceipt(makeRootInitReceipt({
+                        operationId: result.creation === undefined
+                            ? operationId
+                            : uuid7BytesToDashedString(Buffer.from(result.creation.plan.intended_effects.operation_id, "hex")),
+                        attemptId: result.creation?.plan.attempt.attempt_id ?? attemptId,
+                        startedAt,
+                        logicalKey: result.creation?.plan.logical_replay_key ?? {
+                            mode: "wizard",
+                            dryRun: opts.dryRun === true,
+                        },
+                        status: result.status === "completed"
+                            ? result.creation === undefined ||
+                                creationLocalMutationCount(result.creation.mutations) === 0
+                                ? "no-op"
+                                : "success"
+                            : result.creation !== undefined &&
+                                creationLocalMutationCount(result.creation.mutations) > 0
+                                ? "partial"
+                                : "failed",
+                        local: result.creation === undefined
+                            ? 0
+                            : creationLocalMutationCount(result.creation.mutations),
+                        ...(result.creation === undefined
+                            ? {}
+                            : {
+                                creation: result.creation,
+                            }),
+                        ...(result.status === "completed"
+                            ? {}
+                            : {
+                                error: {
+                                    code: "wizard-incomplete",
+                                    summary: "Lyt setup did not complete.",
+                                    retryable: true,
+                                },
+                                next: {
+                                    code: "resume-lyt-init",
+                                    summary: "Correct the reported phase and rerun lyt init.",
+                                },
+                                exitCode: Number(process.exitCode ?? 1),
+                            }),
+                    }));
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    emitError(false, { error: "wizard-error", message: msg }, { operationId, attemptId, startedAt });
+                    process.exitCode = 1;
+                }
+                finally {
+                    handler.close?.();
+                }
+                return;
             }
-        }
-        if (opts.wizard === true) {
-            if (opts.auto === true ||
-                opts.custom === true ||
-                opts.discover === true ||
-                opts.json === true) {
-                emitError(false, {
+            if (opts.dryRun === true) {
+                emitError(opts.json === true, {
                     error: "flag-conflict",
-                    message: "lyt init --wizard is mutually exclusive with --auto, --custom, --discover, and --json.",
-                });
+                    message: "lyt init: --dry-run is only valid in combination with --wizard.",
+                }, { operationId, attemptId, startedAt });
                 process.exitCode = 2;
                 return;
             }
-            if (opts.dryRun !== true && process.stdin.isTTY !== true) {
-                emitError(false, {
-                    error: "wizard-requires-tty",
-                    message: "lyt init --wizard requires an interactive terminal (or pass --dry-run for a non-TTY phase walk).",
-                });
-                process.exitCode = 3;
+            if (opts.auto === true && opts.custom === true) {
+                emitError(opts.json === true, {
+                    error: "flag-conflict",
+                    message: "lyt init: --auto and --custom are mutually exclusive. Omit both (defaults to --auto), or pick one.",
+                }, { operationId, attemptId, startedAt });
+                process.exitCode = 2;
                 return;
             }
-            const handler = opts.dryRun === true ? makeDryRunDefaultsHandler() : new ReadlinePromptHandler();
-            try {
-                const result = await runWizard({
-                    promptHandler: handler,
-                    dryRun: opts.dryRun === true,
-                });
-                const summaryLines = [
-                    "",
-                    "── Setup summary ──────────────────────────────────",
-                    ...result.phases.map((ph) => {
-                        const glyph = ph.skipped === true ? "⊘" : ph.ok ? "✓" : "✗";
-                        const num = String(ph.phase).padStart(2, " ");
-                        return `  ${glyph} Phase ${num}  ${ph.name} — ${ph.message}`;
-                    }),
-                    "───────────────────────────────────────────────────",
-                ];
-                console.log(summaryLines.join("\n"));
-                if (result.status !== "completed") {
-                    const adoptPhase = result.phases.find((ph) => ph.name === "adopt-pod");
-                    process.exitCode = adoptPhase?.data?.reconstructExitCode ?? 1;
-                }
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                emitError(false, { error: "wizard-error", message: msg });
-                process.exitCode = 1;
-            }
-            finally {
-                handler.close?.();
-            }
-            return;
-        }
-        if (opts.dryRun === true) {
-            emitError(opts.json === true, {
-                error: "flag-conflict",
-                message: "lyt init: --dry-run is only valid in combination with --wizard.",
-            });
-            process.exitCode = 2;
-            return;
-        }
-        if (opts.auto === true && opts.custom === true) {
-            emitError(opts.json === true, {
-                error: "flag-conflict",
-                message: "lyt init: --auto and --custom are mutually exclusive. Omit both (defaults to --auto), or pick one.",
-            });
-            process.exitCode = 2;
-            return;
-        }
-        if (opts.discover === true && opts.custom === true) {
-            emitError(opts.json === true, {
-                error: "flag-conflict",
-                message: "lyt init: --discover and --custom are mutually exclusive (--discover is read-only).",
-            });
-            process.exitCode = 2;
-            return;
-        }
-        if (opts.custom === true && (process.stdin.isTTY !== true || opts.json === true)) {
-            emitError(opts.json === true, {
-                error: "custom-requires-tty",
-                message: "lyt init --custom requires an interactive terminal and cannot be combined with --json.",
-            });
-            process.exitCode = 3;
-            return;
-        }
-        const mode = opts.discover === true ? "discover" : opts.custom === true ? "custom" : "auto";
-        let customOverrides;
-        if (mode === "custom") {
-            try {
-                customOverrides = await runCustomPrompts();
+            if (opts.discover === true && opts.custom === true) {
+                emitError(opts.json === true, {
+                    error: "flag-conflict",
+                    message: "lyt init: --discover and --custom are mutually exclusive (--discover is read-only).",
+                }, { operationId, attemptId, startedAt });
+                process.exitCode = 2;
+                return;
             }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
+            if (opts.custom === true && (process.stdin.isTTY !== true || opts.json === true)) {
                 emitError(opts.json === true, {
-                    error: "custom-prompt-error",
-                    message: msg,
-                });
-                process.exitCode = 1;
+                    error: "custom-requires-tty",
+                    message: "lyt init --custom requires an interactive terminal and cannot be combined with --json.",
+                }, { operationId, attemptId, startedAt });
+                process.exitCode = 3;
                 return;
             }
-        }
-        const useSpinner = opts.json !== true && mode !== "discover";
-        const spinner = useSpinner ? startSpinner() : undefined;
-        const flowArgs = {
-            mode,
-            heal: () => healPod(),
-            materializePublish: (db) => materializePodLocal(db, { push: false, setRemote: !isLocalFirstContext() }),
-            ...(customOverrides !== undefined ? { customOverrides } : {}),
-            ...(spinner !== undefined
-                ? {
-                    onPhase: async (op, label) => {
-                        spinner.phase(op, label);
-                        await new Promise((r) => setImmediate(r));
-                    },
+            const mode = opts.discover === true ? "discover" : opts.custom === true ? "custom" : "auto";
+            let customOverrides;
+            if (mode === "custom") {
+                try {
+                    customOverrides = await runCustomPrompts();
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    emitError(opts.json === true, {
+                        error: "custom-prompt-error",
+                        message: msg,
+                    }, { operationId, attemptId, startedAt });
+                    process.exitCode = 1;
+                    return;
                 }
-                : {}),
-        };
-        try {
-            const result = await initBootstrapFlow(flowArgs);
-            spinner?.stop();
-            if (opts.json === true) {
-                emitJsonResult(result);
             }
-            else {
-                emitHumanResult(result);
-                if (result.heal !== undefined) {
-                    console.log(summarizeHeal(result.heal));
+            const useSpinner = opts.json !== true && mode !== "discover";
+            const spinner = useSpinner ? startSpinner() : undefined;
+            const flowArgs = {
+                mode,
+                heal: () => healPod(),
+                refreshExistingPod: async (db) => {
+                    const refreshed = await syncPodLedgerFlow({
+                        registryDb: db,
+                        push: false,
+                        refreshOnly: true,
+                    });
+                    if (refreshed.status === "conflict" || refreshed.status === "error") {
+                        throw new Error(`existing pod refresh failed: ${refreshed.reason ?? refreshed.status}`);
+                    }
+                    if (refreshed.status === "skipped")
+                        return;
+                    const recovered = await recoverVaultsFromPodManifest({
+                        handle: getHandleFromIdentity(),
+                        registryDb: db,
+                    });
+                    const exitCode = reconstructionExitCode(recovered);
+                    if (exitCode !== 0) {
+                        throw new Error(recovered.refusedReason ??
+                            recovered.drops[0]?.reason ??
+                            "pod manifest recovery was incomplete");
+                    }
+                },
+                ...(customOverrides !== undefined ? { customOverrides } : {}),
+                ...(spinner !== undefined
+                    ? {
+                        onPhase: async (op, label) => {
+                            spinner.phase(op, label);
+                            await new Promise((r) => setImmediate(r));
+                        },
+                    }
+                    : {}),
+            };
+            try {
+                const result = await initBootstrapFlow(flowArgs);
+                spinner?.stop();
+                if (opts.json === true) {
+                    emitJsonResult(result);
                 }
-                if (result.branch === "fresh") {
-                    emitAutoPodCard(result);
+                else {
+                    emitHumanResult(result);
+                    if (result.heal !== undefined) {
+                        console.log(summarizeHeal(result.heal));
+                    }
+                    if (result.branch === "fresh") {
+                        emitAutoPodCard(result);
+                    }
+                    else if (result.branch === "adopt" && result.adopt !== undefined) {
+                        emitAdoptPodCard(result);
+                    }
+                    console.error("Not published. Run `lyt sync` when you want to publish scoped vault changes.");
+                    if (mode === "custom") {
+                        await maybeOfferEmbeddings(false);
+                    }
+                    const currency = await checkCurrency({ cacheOnly: true });
+                    if (currency.stale) {
+                        console.log(`\nHeads up: ${formatCurrencyLine(currency)}`);
+                    }
                 }
-                else if (result.branch === "adopt" && result.adopt !== undefined) {
-                    emitAdoptPodCard(result);
+                if (result.branch === "re-init" &&
+                    result.integrityIssues !== undefined &&
+                    result.integrityIssues.length > 0 &&
+                    result.integrityIssues.every((i) => i.status !== "ok")) {
+                    process.exitCode = 1;
                 }
-                await maybePromptAndPublish(result);
-                if (mode === "custom") {
-                    await maybeOfferEmbeddings(false);
+                if (result.branch === "adopt" && result.adoptError !== undefined) {
+                    process.exitCode = 1;
                 }
-                const currency = await checkCurrency({ cacheOnly: true });
-                if (currency.stale) {
-                    console.log(`\nHeads up: ${formatCurrencyLine(currency)}`);
+                if (result.branch === "adopt" && result.adopt !== undefined) {
+                    const exitCode = initBootstrapSemanticExitCode(result);
+                    if (exitCode !== 0)
+                        process.exitCode = exitCode;
                 }
+                emitRootInitReceipt(receiptForBootstrapResult({
+                    result,
+                    operationId,
+                    attemptId,
+                    startedAt,
+                    mode,
+                    exitCode: Number(process.exitCode ?? 0),
+                }));
             }
-            if (result.branch === "re-init" &&
-                result.integrityIssues !== undefined &&
-                result.integrityIssues.length > 0 &&
-                result.integrityIssues.every((i) => i.status !== "ok")) {
-                process.exitCode = 1;
-            }
-            if (result.branch === "adopt" && result.adoptError !== undefined) {
-                process.exitCode = 1;
-            }
-            if (result.branch === "adopt" && result.adopt !== undefined) {
-                const exitCode = initBootstrapSemanticExitCode(result);
-                if (exitCode !== 0)
-                    process.exitCode = exitCode;
+            catch (err) {
+                spinner?.stop();
+                const message = err instanceof Error ? err.message : String(err);
+                emitError(opts.json === true, {
+                    error: "init-bootstrap-error",
+                    message,
+                }, { operationId, attemptId, startedAt });
+                process.exitCode = 2;
             }
         }
-        catch (err) {
-            spinner?.stop();
-            const message = err instanceof Error ? err.message : String(err);
-            emitError(opts.json === true, {
-                error: "init-bootstrap-error",
-                message,
-            });
-            process.exitCode = 2;
+        finally {
+            console.log = originalLog;
         }
     });
 }
@@ -478,53 +560,6 @@ function emitAdoptPodCard(res) {
     console.log(renderNextSteps({ unpublished: true }));
     console.log("");
 }
-async function maybePromptAndPublish(res) {
-    const pub = res.publish;
-    if (pub === undefined || pub.skipped)
-        return;
-    if (isLocalFirstContext()) {
-        console.log("\nYour pod is local-only (not connected to GitHub). Run `lyt sync` to connect + back it up.");
-        return;
-    }
-    const vaultCount = pub.vaults.filter((v) => !v.skipped).length;
-    if (process.stdin.isTTY !== true) {
-        console.log("\nYour pod is staged locally (not published). Run `lyt sync` to publish it to GitHub.");
-        return;
-    }
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    let yes;
-    try {
-        const ans = (await rl.question(`\nPublish your pod to GitHub now? (pushes your pod + ${vaultCount} vault repo(s)) [Y/n]: `))
-            .trim()
-            .toLowerCase();
-        yes = ans === "" || ans === "y" || ans === "yes";
-    }
-    finally {
-        rl.close();
-    }
-    if (!yes) {
-        console.log("Staged. Run `lyt sync` when you're ready to publish to GitHub.");
-        return;
-    }
-    console.log("Publishing your pod to GitHub…");
-    const result = await reconcilePublishFlow({ push: true });
-    if (result.skipped) {
-        console.log(`Publish skipped — ${result.reason ?? "no pod"}.`);
-        return;
-    }
-    const pushed = result.vaultOutcomes.filter((o) => o.pushed).length;
-    if (result.ok) {
-        console.log(`✓ Published to GitHub — ${pushed} vault repo(s) + your pod.`);
-    }
-    else {
-        console.log(`⚠ Partial publish — ${pushed} vault(s) pushed; ${result.outboxRemaining} op(s) pending. Re-run \`lyt sync\` to finish (resumable, no data lost).`);
-        for (const o of result.vaultOutcomes) {
-            if (o.status === "conflict" || o.status === "failed") {
-                console.log(`  ${o.status}: ${o.vaultName} — ${o.message}`);
-            }
-        }
-    }
-}
 async function maybeOfferEmbeddings(json) {
     try {
         let askedState;
@@ -555,7 +590,9 @@ async function maybeOfferEmbeddings(json) {
                 },
                 ...(askedState !== undefined ? { askedState } : {}),
                 ...(registryDb !== undefined
-                    ? { onSurfaced: async () => void (await markAsked(registryDb, new Date().toISOString())) }
+                    ? {
+                        onSurfaced: async () => void (await markAsked(registryDb, new Date().toISOString())),
+                    }
                     : {}),
             });
         }
@@ -592,12 +629,157 @@ function isLocalFirstContext() {
         return true;
     }
 }
-function emitError(json, body) {
-    if (json) {
-        console.error(JSON.stringify(body, null, 2));
+function receiptForBootstrapResult(args) {
+    const creation = args.result.creation;
+    const publish = args.result.publish;
+    const materialized = publish?.vaults.filter((vault) => !vault.skipped).length ?? 0;
+    const local = creation === undefined
+        ? (publish?.podCommitted === true ? 1 : 0) +
+            materialized +
+            (args.result.reconciledVaultPaths?.length ?? 0)
+        : creationLocalMutationCount(creation.mutations);
+    const failed = args.exitCode !== 0;
+    const status = failed ? (local > 0 ? "partial" : "failed") : local > 0 ? "success" : "no-op";
+    return makeRootInitReceipt({
+        operationId: creation === undefined
+            ? args.operationId
+            : uuid7BytesToDashedString(Buffer.from(creation.plan.intended_effects.operation_id, "hex")),
+        attemptId: creation?.plan.attempt.attempt_id ?? args.attemptId,
+        startedAt: args.startedAt,
+        logicalKey: creation?.plan.logical_replay_key ?? {
+            mode: args.mode,
+            branch: args.result.branch,
+        },
+        status,
+        local,
+        branch: args.result.branch,
+        vaultCount: creation?.plan.intended_effects.vaults.length ?? materialized,
+        ...(creation === undefined ? {} : { creation }),
+        ...(failed
+            ? {
+                error: {
+                    code: "init-incomplete",
+                    summary: "Lyt initialization did not complete.",
+                    retryable: true,
+                },
+                next: {
+                    code: "resume-lyt-init",
+                    summary: "Inspect the reported state and rerun lyt init.",
+                },
+                exitCode: args.exitCode,
+            }
+            : {}),
+    });
+}
+function makeRootInitReceipt(args) {
+    const refused = args.status === "refused";
+    const after = [];
+    if (args.branch)
+        after.push({ kind: "init-branch", subject: args.branch });
+    if ((args.vaultCount ?? 0) > 0) {
+        after.push({
+            kind: "creation-scope",
+            subject: "locally materialized creation scope",
+            count: args.vaultCount,
+        });
     }
-    else {
-        console.error(`lyt init: ${String(body["message"] ?? body["error"])}`);
+    if (args.creation !== undefined) {
+        after.push({
+            kind: "creation-plan",
+            subject: args.creation.plan.logical_replay_key,
+        });
+        after.push({
+            kind: "creation-checkpoints",
+            subject: "repository-qualified creation checkpoint evidence",
+            digest: creationCheckpointPathDigest(args.creation.mutations),
+            count: args.creation.mutations.checkpointRepositories.length,
+        });
+        if (args.creation.plan.children.length > 0) {
+            after.push({
+                kind: "creation-children",
+                subject: "bound child creation plans",
+                digest: createHash("sha256")
+                    .update(JSON.stringify(args.creation.plan.children.map((child) => child.logical_replay_key).sort()))
+                    .digest("hex"),
+                count: args.creation.plan.children.length,
+            });
+        }
     }
+    after.push({ kind: "publication", subject: "not-published" });
+    after.push({ kind: "next-sync", subject: "lyt sync" });
+    return parseReceiptV1ForEmission({
+        schema_id: "lyt.receipt",
+        schema_version: { major: 1, minor: 0 },
+        operation_id: args.operationId,
+        attempt_id: args.attemptId,
+        operation: args.operation ?? "lyt-init",
+        scope: { kind: "system" },
+        timestamps: { started_at: args.startedAt, finished_at: new Date().toISOString() },
+        replay: {
+            disposition: refused ? "rejected" : "new",
+            key_digest: typeof args.logicalKey === "string" && /^sha256:[a-f0-9]{64}$/i.test(args.logicalKey)
+                ? args.logicalKey.slice("sha256:".length).toLowerCase()
+                : createHash("sha256").update(JSON.stringify(args.logicalKey)).digest("hex"),
+        },
+        status: args.status,
+        exit_code: args.exitCode ?? (args.status === "success" || args.status === "no-op" ? 0 : 2),
+        mutations: { local: args.local, remote: 0 },
+        evidence: { before: [], after },
+        next_action: args.next ?? null,
+        error: args.error ?? null,
+    });
+}
+export function makeRootCliParseReceipt() {
+    const operationId = uuid7BytesToDashedString(newUuidv7Bytes());
+    const attemptId = uuid7BytesToDashedString(newUuidv7Bytes());
+    return makeRootInitReceipt({
+        operation: "cli-parse",
+        operationId,
+        attemptId,
+        startedAt: new Date().toISOString(),
+        logicalKey: { command: "lyt", outcome: "parser-refusal" },
+        status: "refused",
+        local: 0,
+        error: {
+            code: "invalid-cli-arguments",
+            summary: "Lyt command arguments were refused.",
+            retryable: false,
+        },
+        next: {
+            code: "correct-cli-arguments",
+            summary: "Correct the command arguments and retry.",
+        },
+        exitCode: 2,
+    });
+}
+function emitRootInitReceipt(receipt) {
+    process.stdout.write(`${JSON.stringify(receipt)}\n`);
+}
+function emitError(json, body, identity) {
+    const message = String(body["message"] ?? body["error"] ?? "Lyt initialization failed.");
+    console.error(json ? JSON.stringify(body) : `lyt init: ${message}`);
+    const operationId = identity?.operationId ?? uuid7BytesToDashedString(newUuidv7Bytes());
+    const attemptId = identity?.attemptId ?? uuid7BytesToDashedString(newUuidv7Bytes());
+    const code = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(String(body["error"]))
+        ? String(body["error"])
+        : "lyt-init-refused";
+    emitRootInitReceipt(makeRootInitReceipt({
+        operationId,
+        attemptId,
+        startedAt: identity?.startedAt ?? new Date().toISOString(),
+        logicalKey: { error: code },
+        status: "refused",
+        local: 0,
+        error: {
+            code,
+            summary: "Lyt initialization request was refused.",
+            retryable: false,
+        },
+        next: {
+            code: "correct-lyt-init",
+            summary: "Correct the reported init arguments and retry.",
+        },
+        exitCode: Number(process.exitCode ?? 2) || 2,
+    }));
 }
 //# sourceMappingURL=init.js.map