@nodetool-ai/cli 0.7.0-rc.23 → 0.8.1

package/dist/commands/sketch-validation-output.js

@@ -0,0 +1,5 @@
+import { issueLocation, renderValidation } from "./validation-output.js";
+export function renderSketchValidation(validation) {
+    return renderValidation(validation, (issue) => issue.layerId != null ? ` [layer ${issue.layerId}]` : issueLocation(issue));
+}
+//# sourceMappingURL=sketch-validation-output.js.map

package/dist/commands/sketch-validation-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketch-validation-output.js","sourceRoot":"","sources":["../../src/commands/sketch-validation-output.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CAAC,UAA4B;IACjE,OAAO,gBAAgB,CAAC,UAAU,EAAE,CAAC,KAAuB,EAAE,EAAE,CAC9D,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAC3E,CAAC;AACJ,CAAC"}

package/dist/commands/sketch-versions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `nodetool sketch versions` — the version-history half of the sketch
+ * commands. The commands themselves live in `version-commands.ts`; this file
+ * is the image document's row shapes, database seam, columns and messages.
+ *
+ * Image documents keep immutable snapshots: manual saves, autosaves the server
+ * writes at most every five minutes, and the pre-restore snapshot that makes a
+ * restore undoable. The history is read and written directly against the local
+ * database, so an agent can work without a server.
+ */
+import type { Command } from "commander";
+import type { SketchValidation } from "@nodetool-ai/execution/sketch-debug";
+import { type JsonValue, type VersionCommandDeps, type VersionStore } from "./version-commands.js";
+export { parseVersionDocument, parseVersionNumber } from "./version-commands.js";
+/** An `image_documents` row as these commands need it. */
+export interface ImageDocumentRow {
+    id: string;
+    user_id: string;
+    name?: string | null;
+    width: number;
+    height: number;
+    background_color: string;
+    updated_at: string;
+    document: string;
+}
+/** An `image_document_versions` row. */
+export interface SketchVersionRow {
+    id: string;
+    image_document_id: string;
+    version: number;
+    name: string | null;
+    save_type: string;
+    width: number;
+    height: number;
+    background_color: string;
+    created_at: string;
+    document: string;
+}
+export type SketchVersionStore = VersionStore<ImageDocumentRow, SketchVersionRow>;
+/** The list-item shape, matching the tRPC router's `sketchVersionListItem`. */
+export interface SketchVersionListItem {
+    id: string;
+    version: number;
+    name: string | null;
+    saveType: string;
+    width: number;
+    height: number;
+    backgroundColor: string;
+    createdAt: string;
+}
+export declare function toVersionListItem(row: SketchVersionRow): SketchVersionListItem;
+/** One table row per version: what it is, when it was taken, what it holds. */
+export declare function versionTableRows(items: SketchVersionListItem[]): Record<string, unknown>[];
+/** Layer and binding counts of whatever a version stored. */
+export declare function documentCounts(document: JsonValue | undefined): {
+    layers: number;
+    bindings: number;
+};
+interface SketchValidateMeta {
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+}
+export type SketchVersionsDeps = VersionCommandDeps<ImageDocumentRow, SketchVersionRow, SketchValidation, SketchValidateMeta>;
+export declare function registerSketchVersionsCommands(sketch: Command, deps?: SketchVersionsDeps): void;
+//# sourceMappingURL=sketch-versions.d.ts.map

package/dist/commands/sketch-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketch-versions.d.ts","sourceRoot":"","sources":["../../src/commands/sketch-versions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAC3C,gBAAgB,EAChB,gBAAgB,CACjB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,GACpB,qBAAqB,CAWvB;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE3B;AAaD,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS;IAI1D,MAAM;IACN,QAAQ;EAEX;AAED,UAAU,kBAAkB;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4FD,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CACjD,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,kBAAuB,GAC5B,IAAI,CAKN"}

package/dist/commands/sketch-versions.js

@@ -0,0 +1,108 @@
+import { renderSketchValidation } from "./sketch-validation-output.js";
+import { countArray, registerVersionCommands } from "./version-commands.js";
+export { parseVersionDocument, parseVersionNumber } from "./version-commands.js";
+export function toVersionListItem(row) {
+    return {
+        id: row.id,
+        version: row.version,
+        name: row.name ?? null,
+        saveType: row.save_type,
+        width: row.width,
+        height: row.height,
+        backgroundColor: row.background_color,
+        createdAt: row.created_at
+    };
+}
+/** One table row per version: what it is, when it was taken, what it holds. */
+export function versionTableRows(items) {
+    return items.map(tableRow);
+}
+function tableRow(v) {
+    return {
+        version: v.version,
+        saveType: v.saveType,
+        name: v.name ?? "",
+        createdAt: v.createdAt,
+        resolution: `${v.width}x${v.height}`,
+        background: v.backgroundColor
+    };
+}
+/** Layer and binding counts of whatever a version stored. */
+export function documentCounts(document) {
+    const doc = (document ?? {});
+    const sketch = (doc.sketch ?? {});
+    return {
+        layers: countArray(sketch.layers),
+        bindings: countArray(doc.layerBindings)
+    };
+}
+async function defaultValidate(document, meta) {
+    const { validateSketchDocument } = await import("@nodetool-ai/execution/sketch-debug");
+    return validateSketchDocument(document, meta);
+}
+async function defaultStore() {
+    const { initDb, ImageDocument, ImageDocumentVersion } = await import("@nodetool-ai/models");
+    const { getDefaultDbPath } = await import("@nodetool-ai/config");
+    initDb(getDefaultDbPath());
+    return {
+        load: async (id) => await ImageDocument.findById(id),
+        listVersions: async (imageDocumentId, opts) => await ImageDocumentVersion.listForDocument(imageDocumentId, opts),
+        findVersion: async (imageDocumentId, version) => await ImageDocumentVersion.findByVersion(imageDocumentId, version),
+        snapshot: async (doc, opts) => await ImageDocumentVersion.snapshot(doc, opts),
+        restore: async (doc, version) => await ImageDocument.updateFieldsIfUnchanged(doc.id, doc.updated_at, {
+            document: version.document,
+            width: version.width,
+            height: version.height,
+            background_color: version.background_color
+        }),
+        deleteVersion: async (imageDocumentId, version) => {
+            const row = await ImageDocumentVersion.findByVersion(imageDocumentId, version);
+            if (row)
+                await row.delete();
+        }
+    };
+}
+const spec = {
+    idArg: "image_document_id",
+    idKey: "imageDocumentId",
+    descriptions: {
+        group: "Inspect and restore the snapshot history of an image document (manual saves, autosaves, pre-restore snapshots)",
+        list: "List a sketch's versions, newest first",
+        show: "Print one version's metadata and the document it stored",
+        create: "Snapshot the sketch as it stands now (a manual save)",
+        restore: "Restore a version onto the sketch. The pre-restore state is snapshotted first, and the restored document is validated against the current schema — a restore whose document no longer validates exits non-zero",
+        delete: "Delete one version from a sketch's history",
+        restoreJson: "Print the restore result as JSON"
+    },
+    notFoundDocument: (id) => `Image document not found: ${id}`,
+    notFoundVersion: (id, version) => `Sketch version not found: ${id} v${version}`,
+    conflict: "Document was modified since last read",
+    confirmDelete: (id, version) => `Delete v${version} of sketch ${id}?`,
+    deleted: (id, version) => `✅ Deleted v${version} of sketch ${id}`,
+    toItem: toVersionListItem,
+    tableRow,
+    counts: documentCounts,
+    showSummary: (counts) => `\n  ${counts.layers} layer(s), ${counts.bindings} binding(s)`,
+    restoreSummary: (id, version, counts, row) => `✅ Restored v${version} onto ${id}: ${counts.layers} layer(s), ${counts.bindings} binding(s), ${row.width}x${row.height} on ${row.background_color}`,
+    restoreJsonExtra: (doc) => ({
+        document: {
+            id: doc.id,
+            width: doc.width,
+            height: doc.height,
+            backgroundColor: doc.background_color
+        }
+    }),
+    validateMeta: (row) => ({
+        width: row.width,
+        height: row.height,
+        backgroundColor: row.background_color
+    }),
+    renderValidation: renderSketchValidation
+};
+export function registerSketchVersionsCommands(sketch, deps = {}) {
+    registerVersionCommands(sketch, spec, deps, {
+        store: defaultStore,
+        validate: defaultValidate
+    });
+}
+//# sourceMappingURL=sketch-versions.js.map

package/dist/commands/sketch-versions.js.map

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

package/dist/commands/sketch.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `nodetool sketch validate`, `debug` and `versions` — the sketch harness
+ * commands.
+ *
+ * `validate` checks an image document statically: layers a binding points at,
+ * fields a round trip through the schema would strip, canvas and layer values
+ * nothing can composite. `debug` additionally replays a scripted `--interact`
+ * edit session against the headless `ui_sketch_*` bridge and writes a bundle.
+ * Both take an image-document JSON file or an `image_documents` row id.
+ * `versions` (sketch-versions.ts) reads and restores a document's snapshot
+ * history.
+ *
+ * Heavy dependencies (the database, the validator core, the bridge) are
+ * imported lazily inside each action, so command registration stays light and
+ * unit-testable.
+ */
+import type { Command } from "commander";
+import { renderSketchValidation } from "./sketch-validation-output.js";
+export { renderSketchValidation };
+export declare function registerSketchCommands(program: Command): void;
+//# sourceMappingURL=sketch.d.ts.map

package/dist/commands/sketch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketch.d.ts","sourceRoot":"","sources":["../../src/commands/sketch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAuClC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqF7D"}

package/dist/commands/sketch.js

@@ -0,0 +1,117 @@
+import { printCommandError } from "../command-errors.js";
+import { renderSketchValidation } from "./sketch-validation-output.js";
+import { registerSketchVersionsCommands } from "./sketch-versions.js";
+export { renderSketchValidation };
+/** Read an image document row through the local database. */
+async function documentLoader() {
+    const { initDb, ImageDocument } = await import("@nodetool-ai/models");
+    const { getDefaultDbPath } = await import("@nodetool-ai/config");
+    let ready = false;
+    return async (id) => {
+        if (!ready) {
+            initDb(getDefaultDbPath());
+            ready = true;
+        }
+        const row = await ImageDocument.findById(id);
+        return row
+            ? {
+                id: row.id,
+                name: row.name,
+                width: row.width,
+                height: row.height,
+                background_color: row.background_color,
+                document: row.document
+            }
+            : null;
+    };
+}
+export function registerSketchCommands(program) {
+    const sketch = program
+        .command("sketch")
+        .description("Work with sketches (image documents)");
+    sketch
+        .command("validate <sketch_id_or_file>")
+        .description("Validate an image document without rendering it: bindings on missing layers, fields a schema round trip would strip, canvas and layer values nothing can composite. Takes an image-document JSON file or an image_documents row id")
+        .option("--json", "Print the full SketchValidation as JSON")
+        .option("--warnings-as-errors", "Exit non-zero when there are warnings (not just errors)")
+        .action(async (ref, opts) => {
+        try {
+            const { runSketchValidate } = await import("../sketch-debug/index.js");
+            const { target, validation } = await runSketchValidate(ref, {
+                loadDocument: await documentLoader()
+            });
+            if (opts.json) {
+                console.log(JSON.stringify({ target, validation }, null, 2));
+            }
+            else {
+                console.log(renderSketchValidation(validation).join("\n"));
+            }
+            const failed = !validation.ok ||
+                (opts.warningsAsErrors === true && validation.warnings.length > 0);
+            process.exit(failed ? 1 : 0);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    sketch
+        .command("debug <sketch_id_or_file>")
+        .description("Replay a scripted edit session against a sketch headlessly and collect a debug bundle (the document, the report, every step's result)")
+        .option("--interact <json>", 'Scripted steps: [{"tool":"add_layer","input":{"name":"Glow"}}] — the ui_sketch_ prefix is optional')
+        .option("--out <dir>", "Bundle output directory (default: nodetool-debug/sketch-<id>-<timestamp>)")
+        .option("--json", "Print the full SketchDebugReport as JSON to stdout")
+        .action(async (ref, opts) => {
+        try {
+            const { parseInteractionScript, runSketchDebug } = await import("../sketch-debug/index.js");
+            const interact = opts.interact
+                ? parseInteractionScript(opts.interact)
+                : undefined;
+            const debugOptions = {};
+            if (interact) {
+                debugOptions.interact = interact;
+            }
+            if (opts.out) {
+                debugOptions.outDir = opts.out;
+            }
+            const { report, bundleDir } = await runSketchDebug(ref, debugOptions, {
+                loadDocument: await documentLoader(),
+                onLog: (line) => console.error(line)
+            });
+            if (opts.json) {
+                console.log(JSON.stringify(report, null, 2));
+            }
+            else {
+                printSketchSummary(report, bundleDir);
+            }
+            process.exit(report.verdict.ok ? 0 : 1);
+        }
+        catch (e) {
+            printCommandError(e, opts.json);
+            process.exit(1);
+        }
+    });
+    registerSketchVersionsCommands(sketch);
+}
+function printSketchSummary(report, bundleDir) {
+    const mark = report.verdict.ok ? "✅" : "❌";
+    console.log(`\n${mark} ${report.verdict.headline}`);
+    console.log(`  sketch:  ${report.meta.layerCount} layer(s), ${report.meta.bindingCount} binding(s), ${report.meta.width}x${report.meta.height}`);
+    const failed = report.interactions.filter((i) => !i.ok).length;
+    if (report.interactions.length > 0) {
+        console.log(`  session: ${report.interactions.length} step(s), ${failed} failed`);
+    }
+    if (report.verdict.issues.length > 0) {
+        console.log("\nIssues:");
+        for (const issue of report.verdict.issues)
+            console.log(`  - ${issue}`);
+    }
+    if (report.verdict.warnings && report.verdict.warnings.length > 0) {
+        console.log("\nWarnings:");
+        for (const warning of report.verdict.warnings)
+            console.log(`  - ${warning}`);
+    }
+    console.log(`\nDebug bundle: ${bundleDir}`);
+    console.log("  report.md / report.json · sketch.json");
+}
+//# sourceMappingURL=sketch.js.map

package/dist/commands/sketch.js.map

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

package/dist/commands/storage.d.ts

@@ -0,0 +1,24 @@
+interface MigrateKeysOptions {
+    dryRun?: boolean;
+    /** Migrate only this user's objects. */
+    userId?: string;
+    json?: boolean;
+}
+interface MigrateKeysReport {
+    scanned: number;
+    moved: number;
+    alreadyMigrated: number;
+    missing: number;
+    failed: number;
+    entries: Array<{
+        assetId: string;
+        from: string;
+        to: string;
+        status: "moved" | "already" | "missing" | "failed";
+        error?: string;
+    }>;
+}
+export declare function migrateStorageKeys(opts?: MigrateKeysOptions): Promise<MigrateKeysReport>;
+export declare function formatMigrateKeysReport(report: MigrateKeysReport, dryRun: boolean): string;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/commands/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/commands/storage.ts"],"names":[],"mappings":"AAsBA,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;QACnD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AA4BD,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAkD5B;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,OAAO,GACd,MAAM,CAoBR"}

package/dist/commands/storage.js

@@ -0,0 +1,112 @@
+/**
+ * `nodetool storage migrate-keys` — move asset objects from the flat
+ * `<assetId>.<ext>` layout under their owner's prefix, `<userId>/<assetId>.<ext>`.
+ *
+ * The owner prefix is what makes the tenant boundary enforceable outside the
+ * server process (a Supabase Storage RLS policy or an S3 bucket policy can
+ * match on it), so a deployment on a cloud backend needs this to have run.
+ * The local file backend keeps working without it — `/api/storage` falls back
+ * to the legacy path — but should be migrated too so the layouts agree.
+ *
+ * Safe to re-run: an object already at its prefixed key is left alone, and
+ * the legacy object is only removed once the new one reads back.
+ */
+import { Asset } from "@nodetool-ai/models";
+import { loadAssetStorageConfig } from "@nodetool-ai/config";
+import { assetObjectKey, createStorageAdapter } from "@nodetool-ai/storage";
+import { getAssetFileName } from "@nodetool-ai/websocket";
+/** Every object belonging to an asset: the bytes plus its thumbnail. */
+function fileNamesFor(assetId, contentType) {
+    return [getAssetFileName(assetId, contentType), `${assetId}_thumb.jpg`];
+}
+async function migrateOne(adapter, userId, fileName, dryRun) {
+    const target = assetObjectKey(userId, fileName);
+    if (await adapter.exists(adapter.uriForKey(target)))
+        return "already";
+    if (!(await adapter.exists(adapter.uriForKey(fileName))))
+        return "missing";
+    if (dryRun)
+        return "moved";
+    const bytes = await adapter.retrieve(adapter.uriForKey(fileName));
+    if (!bytes)
+        return "missing";
+    await adapter.store(target, bytes);
+    // Only drop the original once the copy reads back, so an interrupted run
+    // leaves the asset readable at one key or the other, never neither.
+    if (!(await adapter.exists(adapter.uriForKey(target))))
+        return "failed";
+    await adapter.delete(adapter.uriForKey(fileName));
+    return "moved";
+}
+export async function migrateStorageKeys(opts = {}) {
+    const adapter = createStorageAdapter(loadAssetStorageConfig());
+    const dryRun = opts.dryRun ?? false;
+    const report = {
+        scanned: 0,
+        moved: 0,
+        alreadyMigrated: 0,
+        missing: 0,
+        failed: 0,
+        entries: []
+    };
+    const assets = await Asset.allForMigration(opts.userId);
+    for (const asset of assets) {
+        if (asset.content_type === "folder")
+            continue;
+        for (const fileName of fileNamesFor(asset.id, asset.content_type)) {
+            report.scanned += 1;
+            const to = assetObjectKey(asset.user_id, fileName);
+            let status;
+            let error;
+            try {
+                status = await migrateOne(adapter, asset.user_id, fileName, dryRun);
+            }
+            catch (err) {
+                status = "failed";
+                error = err instanceof Error ? err.message : String(err);
+            }
+            if (status === "moved")
+                report.moved += 1;
+            else if (status === "already")
+                report.alreadyMigrated += 1;
+            else if (status === "missing")
+                report.missing += 1;
+            else
+                report.failed += 1;
+            // A thumbnail that was never generated is the common "missing" case and
+            // is not worth a line of output.
+            if (status !== "missing") {
+                const entry = {
+                    assetId: asset.id,
+                    from: fileName,
+                    to,
+                    status
+                };
+                if (error) {
+                    entry.error = error;
+                }
+                report.entries.push(entry);
+            }
+        }
+    }
+    return report;
+}
+export function formatMigrateKeysReport(report, dryRun) {
+    const lines = [];
+    for (const entry of report.entries) {
+        if (entry.status === "failed") {
+            lines.push(`FAILED  ${entry.from} -> ${entry.to}: ${entry.error ?? ""}`);
+        }
+        else if (entry.status === "moved") {
+            lines.push(`${dryRun ? "would move" : "moved"}  ${entry.from} -> ${entry.to}`);
+        }
+    }
+    lines.push("");
+    lines.push(`scanned ${report.scanned}, ${dryRun ? "would move" : "moved"} ${report.moved}, ` +
+        `already migrated ${report.alreadyMigrated}, absent ${report.missing}, failed ${report.failed}`);
+    if (dryRun) {
+        lines.push("Dry run — nothing was written. Re-run without --dry-run.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=storage.js.map

package/dist/commands/storage.js.map

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

package/dist/commands/telegram.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `nodetool telegram` — run the Telegram bridge, and publish its command list.
+ *
+ * Thin wrappers over `@nodetool-ai/telegram`, imported dynamically so the CLI
+ * pays nothing for the bridge (and its `ws` dependency) on every other
+ * command. Registration is deliberately its own subcommand: `setMyCommands` is
+ * a deploy step, not a boot step (design §12).
+ */
+import type { Command } from "commander";
+export declare function registerTelegramCommands(program: Command): void;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/commands/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/commands/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C/D"}

package/dist/commands/telegram.js

@@ -0,0 +1,66 @@
+/**
+ * `nodetool telegram` — run the Telegram bridge, and publish its command list.
+ *
+ * Thin wrappers over `@nodetool-ai/telegram`, imported dynamically so the CLI
+ * pays nothing for the bridge (and its `ws` dependency) on every other
+ * command. Registration is deliberately its own subcommand: `setMyCommands` is
+ * a deploy step, not a boot step (design §12).
+ */
+/** Config problems are the likely failure here; print them, not a stack. */
+function fail(e) {
+    console.error(String(e instanceof Error ? e.message : e));
+    process.exit(1);
+}
+/** `loadConfig` takes the default path when `--config` is absent. */
+function configOptions(path) {
+    const options = {};
+    if (path !== undefined) {
+        options.configPath = path;
+    }
+    return options;
+}
+export function registerTelegramCommands(program) {
+    const telegram = program
+        .command("telegram")
+        .description("Telegram bridge — private-chat turns onto the agent loop");
+    telegram
+        .command("serve")
+        .description("Long-poll the Bot API and run turns on each linked user's account")
+        .option("--config <path>", "Path to telegram-bot.json")
+        .action(async (opts) => {
+        try {
+            const { loadConfig, startTelegramBot } = await import("@nodetool-ai/telegram");
+            const config = loadConfig(configOptions(opts.config));
+            const handle = startTelegramBot(config);
+            const shutdown = () => {
+                void handle.stop();
+            };
+            process.on("SIGINT", shutdown);
+            process.on("SIGTERM", shutdown);
+            console.log(`Telegram bridge polling against ${config.apiUrl}`);
+            const reason = await handle.finished;
+            if (reason !== "stopped") {
+                process.exitCode = 1;
+            }
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    telegram
+        .command("register-commands")
+        .description("Publish the bot's command list to Telegram (setMyCommands)")
+        .option("--config <path>", "Path to telegram-bot.json")
+        .action(async (opts) => {
+        try {
+            const { loadConfig, registerCommands } = await import("@nodetool-ai/telegram");
+            const config = loadConfig(configOptions(opts.config));
+            const commands = await registerCommands(config.botToken);
+            console.log(`Registered ${commands.length} bot commands.`);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+}
+//# sourceMappingURL=telegram.js.map

package/dist/commands/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/commands/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,4EAA4E;AAC5E,SAAS,IAAI,CAAC,CAAU;IACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,SAAS,aAAa,CAAC,IAAwB;IAC7C,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,0DAA0D,CAAC,CAAC;IAE3E,QAAQ;SACL,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mEAAmE,CAAC;SAChF,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAyB,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,GAAS,EAAE;gBAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,mCAAmC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAyB,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,MAAM,gBAAgB,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}