@younndai/lyt 0.20.14 → 0.20.16

package/dist/commands/backfill.js

@@ -14,103 +14,173 @@
  * limitations under the License.
  */
 import { Command } from "commander";
-import { reconcileVaultScan } from "@younndai/lyt-vault";
 import { runAutomator } from "../automator-run.js";
+import { createMutationPreview, prepareMutationApply, } from "./mutation-preview-receipt.js";
 function asOutcome(body) {
-    const o = (body ?? {});
+    const value = (body ?? {});
     return {
-        filesScanned: typeof o.filesScanned === "number" ? o.filesScanned : 0,
-        filesMutated: typeof o.filesMutated === "number" ? o.filesMutated : 0,
-        fieldsFilledTotal: typeof o.fieldsFilledTotal === "number" ? o.fieldsFilledTotal : 0,
-        filesWritten: Array.isArray(o.filesWritten) ? o.filesWritten : [],
+        filesScanned: typeof value.filesScanned === "number" ? value.filesScanned : 0,
+        filesMutated: typeof value.filesMutated === "number" ? value.filesMutated : 0,
+        fieldsFilledTotal: typeof value.fieldsFilledTotal === "number" ? value.fieldsFilledTotal : 0,
+        filesWritten: Array.isArray(value.filesWritten) ? value.filesWritten : [],
+    };
+}
+function isInteractive() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+function emitPreviewCompatibilityWarnings(opts) {
+    if (opts.dryRun === true) {
+        console.error("warning: --dry-run is deprecated; preview is now the default and remains read-only");
+    }
+    if (opts.push === true) {
+        console.error("warning: preview only; --push binds the receipt but nothing changes until --apply");
+    }
+}
+function receiptSummary(receipt) {
+    return {
+        receipt_id: receipt.plan.id,
+        lifecycle: receipt.lifecycle.state,
+        created_at: receipt.plan.createdAt,
+        expires_at: receipt.plan.expiresAt,
+        vault: receipt.plan.vault,
+        scope: receipt.plan.scope,
+        push: receipt.plan.push,
+        candidate_count: receipt.plan.candidateCount,
+        exclusion_count: receipt.plan.exclusionCount,
+        exclusion_counts: receipt.plan.exclusionCounts,
+        pending_removal_count: receipt.plan.pendingRemovalCount,
+        candidates: receipt.plan.candidates,
     };
 }
 export function buildBackfillCommand() {
     return new Command("backfill")
-        .description("Backfill missing frontmatter across a vault's figments (deterministic: real git/fs dates, purpose/topic left blank + flagged, provenance-stamped). Never overwrites existing values. Writes locally; use --push to also commit + push. NOT `lyt repair`.")
-        .argument("<name>", "Vault name to backfill (must be registered)")
-        .option("--dry-run", "Preview which figments WOULD be filled — read-only, writes nothing")
-        .option("--push", "Also git-commit + push the fills (default: write locally, run `lyt sync` to publish)")
-        .option("--json", "Emit a JSON result instead of the human-readable summary")
+        .description("Preview missing-frontmatter additions for one registered vault. Mutation requires --apply with the exact sealed --receipt; non-interactive apply also requires --yes.")
+        .argument("<name>", "Registered vault name to inspect or backfill")
+        .option("--path <subtree>", "Restrict preview/apply to one vault-relative subtree")
+        .option("--dry-run", "One-release compatibility alias for the default sealed preview")
+        .option("--apply", "Apply the exact sealed preview")
+        .option("--receipt <uuidv7>", "Exact preview receipt identifier required by --apply")
+        .option("--yes", "Required confirmation for non-interactive --apply")
+        .option("--push", "Bind the preview/apply to commit-and-push rather than local commit only")
+        .option("--json", "Emit structured JSON")
         .action(async (name, opts) => {
-        if (opts.dryRun === true) {
-            let scan;
-            try {
-                scan = await reconcileVaultScan(name);
-            }
-            catch (err) {
-                reportError(opts, name, err);
-                process.exit(1);
+        if (opts.apply === true && opts.dryRun === true) {
+            return reportError(opts, name, new Error("--apply and --dry-run are mutually exclusive"));
+        }
+        if (opts.apply !== true) {
+            if (opts.receipt !== undefined) {
+                return reportError(opts, name, new Error("--receipt is consumed only with --apply"));
             }
-            const wouldFill = scan.missingFrontmatter;
-            if (opts.json === true) {
-                console.log(JSON.stringify({
-                    dry_run: true,
-                    vault: { name: scan.vaultName, path: scan.vaultPath },
-                    scanned: scan.scanned,
-                    would_fill: wouldFill.length,
-                    figments: wouldFill,
-                }, null, 2));
+            try {
+                emitPreviewCompatibilityWarnings(opts);
+                const receipt = await createMutationPreview({
+                    operation: "backfill",
+                    vault: name,
+                    ...(opts.path !== undefined ? { subtree: opts.path } : {}),
+                    push: opts.push === true,
+                });
+                emitPreview(opts, receipt);
             }
-            else {
-                console.log(`backfill --dry-run ${scan.vaultName}: ${wouldFill.length}/${scan.scanned} figment(s) would be filled (nothing written).`);
-                for (const f of wouldFill.slice(0, 20)) {
-                    console.log(`  ${f.relPath} — missing: ${f.missing.join(", ")}`);
-                }
-                if (wouldFill.length > 20) {
-                    console.log(`  … and ${wouldFill.length - 20} more`);
-                }
+            catch (error) {
+                reportError(opts, name, error);
             }
             return;
         }
-        let result;
+        if (opts.receipt === undefined) {
+            return reportError(opts, name, new Error("--apply requires --receipt <uuidv7>"));
+        }
+        if (!isInteractive() && opts.yes !== true) {
+            return reportError(opts, name, new Error("non-interactive --apply requires --yes"));
+        }
+        let session;
         try {
-            result = await runAutomator({
-                automator: "metadata-filler",
+            session = await prepareMutationApply({
+                operation: "backfill",
                 vault: name,
+                ...(opts.path !== undefined ? { subtree: opts.path } : {}),
+                push: opts.push === true,
+                receiptId: opts.receipt,
+            });
+            if (session.getReceipt().plan.candidateCount > 0)
+                session.markMutationStarted();
+            const result = await runAutomator({
+                automator: "metadata-filler",
+                vault: session.inventory.vault.name,
+                skipSync: true,
                 ...(opts.push !== true ? { noPush: true } : {}),
+                metadataFillerScope: {
+                    candidates: session.getReceipt().plan.candidates,
+                    validateBeforeMutation: session.revalidateBeforeMutation,
+                    onCandidateCompleted: session.markCandidateCompleted,
+                    missingOnly: true,
+                },
             });
+            if (!result.ok) {
+                throw new Error(result.errorSummary ?? `metadata-filler ended in ${result.status}`);
+            }
+            const outcome = asOutcome(result.body);
+            if (outcome.filesMutated !== session.getReceipt().plan.candidateCount) {
+                throw new Error(`sealed apply wrote ${outcome.filesMutated} candidate(s), expected ${session.getReceipt().plan.candidateCount}`);
+            }
+            session.complete();
+            emitApplied(opts, session.getReceipt(), outcome);
         }
-        catch (err) {
-            reportError(opts, name, err);
-            process.exit(1);
-        }
-        const outcome = asOutcome(result.body);
-        const payload = {
-            ok: result.ok,
-            vault: { name: result.plan.vaultName, path: result.plan.vaultPath },
-            automator_version: result.automatorVersion,
-            status: result.status,
-            error_summary: result.errorSummary,
-            pushed: opts.push === true,
-            files_scanned: outcome.filesScanned,
-            files_mutated: outcome.filesMutated,
-            fields_filled_total: outcome.fieldsFilledTotal,
-            files_written: outcome.filesWritten,
-        };
-        if (opts.json === true) {
-            console.log(JSON.stringify(payload, null, 2));
-        }
-        else {
-            console.log(`${result.ok ? "✓" : "✗"} backfill ${payload.vault.name}: ` +
-                `${outcome.filesMutated}/${outcome.filesScanned} figment(s) filled ` +
-                `(${outcome.fieldsFilledTotal} field(s))${opts.push === true ? " [pushed]" : " [local — run `lyt sync` to publish]"}` +
-                `${payload.error_summary !== null ? ` — ${payload.error_summary}` : ""}`);
-            if (outcome.filesMutated === 0 && result.ok) {
-                console.log("  all figments already carry contract-valid frontmatter (nothing to fill).");
+        catch (error) {
+            if (session !== undefined) {
+                try {
+                    session.fail(error);
+                }
+                catch {
+                }
             }
+            reportError(opts, name, error);
         }
-        if (!result.ok)
-            process.exit(1);
     });
 }
-function reportError(opts, name, err) {
-    const msg = err instanceof Error ? err.message : String(err);
+function emitPreview(opts, receipt) {
+    const payload = { ok: true, operation: "backfill", applied: false, ...receiptSummary(receipt) };
+    if (opts.json === true) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    console.log(`backfill preview ${receipt.plan.vault.name} [${receipt.plan.scope}]: ` +
+        `${receipt.plan.candidateCount} candidate(s), ${receipt.plan.exclusionCount} excluded.`);
+    console.log(`  receipt: ${receipt.plan.id} (expires ${receipt.plan.expiresAt})`);
+    for (const candidate of receipt.plan.candidates.slice(0, 20)) {
+        console.log(`  ${candidate.path} — add: ${candidate.plannedMutations.join(", ")}`);
+    }
+    if (receipt.plan.candidates.length > 20) {
+        console.log(`  … and ${receipt.plan.candidates.length - 20} more`);
+    }
+    console.log(`  apply: lyt vault backfill '${receipt.plan.vault.name}' --apply --receipt ${receipt.plan.id}` +
+        `${opts.push === true ? " --push" : ""}`);
+}
+function emitApplied(opts, receipt, outcome) {
+    const payload = {
+        ok: true,
+        operation: "backfill",
+        applied: true,
+        ...receiptSummary(receipt),
+        files_mutated: outcome.filesMutated,
+        fields_filled_total: outcome.fieldsFilledTotal,
+        files_written: outcome.filesWritten,
+    };
+    if (opts.json === true) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    console.log(`backfill applied ${receipt.plan.vault.name} [${receipt.plan.scope}]: ` +
+        `${outcome.filesMutated}/${receipt.plan.candidateCount} candidate(s), ` +
+        `${outcome.fieldsFilledTotal} field(s); receipt ${receipt.plan.id} completed.`);
+}
+function reportError(opts, name, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.exitCode = 1;
     if (opts.json === true) {
-        console.log(JSON.stringify({ ok: false, vault: name, error: msg }, null, 2));
+        console.log(JSON.stringify({ ok: false, operation: "backfill", vault: name, error: message }, null, 2));
     }
     else {
-        console.error(`✗ backfill ${name}: ${msg}`);
+        console.error(`backfill refused ${name}: ${message}`);
     }
 }
 //# sourceMappingURL=backfill.js.map

package/dist/commands/backfill.js.map

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

package/dist/commands/mutation-preview-receipt.d.ts

@@ -0,0 +1,77 @@
+import { type VaultFileClassification, type VaultFilesInventory } from "@younndai/lyt-vault";
+export type MutationPreviewOperation = "backfill" | "reconcile";
+export type MutationReceiptLifecycle = "previewed" | "applying" | "completed" | "refused-before-write" | "partial";
+export interface MutationPreviewCandidate {
+    path: string;
+    preimageSha256: string;
+    plannedMutations: string[];
+}
+export interface MutationPreviewPlan {
+    schema: "lyt.mutation-preview";
+    version: 1;
+    id: string;
+    operation: MutationPreviewOperation;
+    createdAt: string;
+    expiresAt: string;
+    vault: {
+        rid: string;
+        name: string;
+    };
+    scope: string;
+    push: boolean;
+    ignorePolicy: {
+        exists: boolean;
+        sha256: string;
+        bytesBase64: string;
+    };
+    inventoryDigest: string;
+    candidateCount: number;
+    exclusionCount: number;
+    exclusionCounts: Partial<Record<VaultFileClassification, number>>;
+    pendingRemovalCount: number;
+    unindexedCount: number;
+    reindexRequired: boolean;
+    reindexScope: "vault" | null;
+    candidates: MutationPreviewCandidate[];
+}
+export interface MutationPreviewReceipt {
+    plan: MutationPreviewPlan;
+    seal: {
+        algorithm: "sha256";
+        digest: string;
+    };
+    lifecycle: {
+        state: MutationReceiptLifecycle;
+        startedAt: string | null;
+        finishedAt: string | null;
+        completedCandidates: string[];
+        untouchedCandidates: string[];
+        error: string | null;
+    };
+}
+export interface MutationApplySession {
+    getReceipt(): MutationPreviewReceipt;
+    inventory: VaultFilesInventory;
+    completed: string[];
+    revalidateBeforeMutation(): Promise<void>;
+    markCandidateCompleted(path: string): void;
+    markMutationStarted(): void;
+    complete(): void;
+    fail(error: unknown): void;
+}
+export declare function createMutationPreview(args: {
+    operation: MutationPreviewOperation;
+    vault: string;
+    subtree?: string;
+    push: boolean;
+    now?: Date;
+}): Promise<MutationPreviewReceipt>;
+export declare function prepareMutationApply(args: {
+    operation: MutationPreviewOperation;
+    vault: string;
+    subtree?: string;
+    push: boolean;
+    receiptId: string;
+    now?: Date;
+}): Promise<MutationApplySession>;
+//# sourceMappingURL=mutation-preview-receipt.d.ts.map

package/dist/commands/mutation-preview-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-preview-receipt.d.ts","sourceRoot":"","sources":["../../src/commands/mutation-preview-receipt.ts"],"names":[],"mappings":"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"}