npm - @tenonhq/dovetail-core - Versions diffs - 0.0.94 → 0.0.95 - Mend

@tenonhq/dovetail-core 0.0.94 → 0.0.95

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/commander.js CHANGED Viewed

@@ -334,10 +334,10 @@ async function initCommands() {
     }, async (args) => {
         await (0, dashboardCommand_1.dashboardCommand)(args);
     })
-        .command("schema <subcommand>", "Manage ServiceNow table schemas (subcommands: pull)", (cmdArgs) => {
+        .command("schema <subcommand>", "Manage ServiceNow table schemas (subcommands: pull, diff, snapshots)", (cmdArgs) => {
         cmdArgs.positional("subcommand", {
             describe: "Schema subcommand to run",
-            choices: ["pull"],
+            choices: ["pull", "diff", "snapshots"],
         });
         cmdArgs.options({
             ...sharedOptions,
@@ -349,7 +349,24 @@ async function initCommands() {
             scope: {
                 alias: "s",
                 type: "string",
-                describe: "Pull schema for a single scope (default: all scopes from dove.config.js)",
+                describe: "Single scope (default: all scopes from dove.config.js)",
+            },
+            snapshot: {
+                type: "string",
+                describe: "pull: also save an immutable snapshot with this label (timestamp-only if no label)",
+            },
+            from: {
+                type: "string",
+                describe: "diff: baseline ref — a snapshot label, snapshot dir name, or directory path (default: newest snapshot)",
+            },
+            to: {
+                type: "string",
+                describe: 'diff: comparison ref — "live" for a fresh pull, or a snapshot ref (default: live)',
+            },
+            format: {
+                type: "string",
+                choices: ["text", "json"],
+                describe: "diff: output format (default: text)",
             },
         });
         return cmdArgs;
@@ -357,6 +374,12 @@ async function initCommands() {
         if (args.subcommand === "pull") {
             await (0, schemaCommand_1.schemaPullCommand)(args);
         }
+        else if (args.subcommand === "diff") {
+            await (0, schemaCommand_1.schemaDiffCommand)(args);
+        }
+        else if (args.subcommand === "snapshots") {
+            await (0, schemaCommand_1.schemaSnapshotsCommand)(args);
+        }
     })
         .command("init-claude", "Install Dovetail Claude Code skills to .claude/commands/", (cmdArgs) => {
         cmdArgs.options({

package/dist/schemaCommand.js CHANGED Viewed

@@ -37,32 +37,46 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.schemaPullCommand = schemaPullCommand;
+exports.schemaDiffCommand = schemaDiffCommand;
+exports.schemaSnapshotsCommand = schemaSnapshotsCommand;
 const dovetail_schema_1 = require("@tenonhq/dovetail-schema");
 const Logger_1 = require("./Logger");
 const ConfigManager = __importStar(require("./config"));
 const path_1 = __importDefault(require("path"));
-async function schemaPullCommand(args) {
+const os_1 = __importDefault(require("os"));
+const fs_1 = require("fs");
+function requireCreds() {
     const { SN_USER = "", SN_PASSWORD = "", SN_INSTANCE = "" } = process.env;
     if (!SN_USER || !SN_PASSWORD || !SN_INSTANCE) {
         throw new Error("Missing ServiceNow credentials. Ensure SN_INSTANCE, SN_USER, and SN_PASSWORD are set in your .env file or environment.");
     }
+    return { SN_USER, SN_PASSWORD, SN_INSTANCE };
+}
+function normalizeInstance(instance) {
+    return instance.replace(/^https?:\/\//, "").replace(/\/$/, "");
+}
+function resolveScopes(args) {
     const config = ConfigManager.getConfig();
     const configScopes = config.scopes ? Object.keys(config.scopes) : [];
     if (configScopes.length === 0) {
         throw new Error("No scopes configured in dove.config.js. Add scopes to the 'scopes' object in your configuration.");
     }
-    // If --scope flag is provided, filter to that single scope
-    let scopes = configScopes;
     if (args.scope) {
         if (!configScopes.includes(args.scope)) {
             throw new Error(`Scope "${args.scope}" is not configured in dove.config.js. Available scopes: ${configScopes.join(", ")}`);
         }
-        scopes = [args.scope];
+        return [args.scope];
     }
+    return configScopes;
+}
+function outputDirFor(args) {
     const rootDir = ConfigManager.getRootDir();
-    const outputDir = args.output
-        ? path_1.default.resolve(args.output)
-        : path_1.default.join(rootDir, "schema");
+    return args.output ? path_1.default.resolve(args.output) : path_1.default.join(rootDir, "schema");
+}
+async function schemaPullCommand(args) {
+    const { SN_USER, SN_PASSWORD, SN_INSTANCE } = requireCreds();
+    const scopes = resolveScopes(args);
+    const outputDir = outputDirFor(args);
     try {
         const index = await (0, dovetail_schema_1.pullSchema)({
             instance: SN_INSTANCE,
@@ -72,6 +86,18 @@ async function schemaPullCommand(args) {
             scopes,
         });
         Logger_1.logger.success(`Schema pull complete! ${index.total_tables} tables across ${index.applications.length} applications written to ${outputDir}`);
+        if (args.snapshot !== undefined && args.snapshot !== false) {
+            const label = typeof args.snapshot === "string" && args.snapshot.length > 0
+                ? args.snapshot
+                : null;
+            const info = await (0, dovetail_schema_1.writeSnapshot)({
+                outputDir,
+                index,
+                label,
+                now: new Date().toISOString(),
+            });
+            Logger_1.logger.success("Snapshot saved" + (label ? ` (${label})` : "") + ": " + info.dir);
+        }
     }
     catch (e) {
         let message;
@@ -83,3 +109,71 @@ async function schemaPullCommand(args) {
         throw e;
     }
 }
+// Resolve a diff ref to a directory of schema files. `live` triggers a fresh
+// pull into a temp dir; everything else resolves to a snapshot/baseline dir.
+async function resolveRefDir(options) {
+    const { ref, outputDir, instance, scopes, creds } = options;
+    if (ref === "live") {
+        const tmpDir = await fs_1.promises.mkdtemp(path_1.default.join(os_1.default.tmpdir(), "dove-schema-live-"));
+        await (0, dovetail_schema_1.pullSchema)({
+            instance: creds.SN_INSTANCE,
+            username: creds.SN_USER,
+            password: creds.SN_PASSWORD,
+            outputDir: tmpDir,
+            scopes,
+        });
+        return tmpDir;
+    }
+    return (0, dovetail_schema_1.resolveSnapshotDir)({ ref, outputDir, instance });
+}
+async function schemaDiffCommand(args) {
+    const creds = requireCreds();
+    const instance = normalizeInstance(creds.SN_INSTANCE);
+    const outputDir = outputDirFor(args);
+    const scopes = resolveScopes(args);
+    const scope = args.scope || null;
+    const format = args.format === "json" ? "json" : "text";
+    // Default `from` = newest snapshot for this instance; default `to` = live.
+    let fromRef = args.from;
+    if (!fromRef) {
+        const snapshots = await (0, dovetail_schema_1.listSnapshots)({ outputDir, instance });
+        if (snapshots.length === 0) {
+            throw new Error("No --from given and no snapshots found for " +
+                instance +
+                ". Create one with `dove schema pull --snapshot <label>`, or pass --from <path>.");
+        }
+        fromRef = path_1.default.basename(snapshots[0].dir);
+    }
+    const toRef = args.to || "live";
+    const fromDir = await resolveRefDir({ ref: fromRef, outputDir, instance, scopes, creds });
+    const toDir = await resolveRefDir({ ref: toRef, outputDir, instance, scopes, creds });
+    const from = await (0, dovetail_schema_1.readSchemaTree)({ dir: fromDir, scope });
+    const to = await (0, dovetail_schema_1.readSchemaTree)({ dir: toDir, scope });
+    const diff = (0, dovetail_schema_1.diffSchemas)({ from, to, fromRef, toRef, scope });
+    // Print with console.log so formatDiff's own severity colors survive (the
+    // winston logger re-wraps every line in a single color).
+    console.log((0, dovetail_schema_1.formatDiff)(diff, { format }));
+    // Non-zero exit on breaking drift, for CI gating.
+    process.exitCode = diff.exit_code;
+}
+async function schemaSnapshotsCommand(args) {
+    const creds = requireCreds();
+    const instance = normalizeInstance(creds.SN_INSTANCE);
+    const outputDir = outputDirFor(args);
+    const snapshots = await (0, dovetail_schema_1.listSnapshots)({ outputDir, instance });
+    if (snapshots.length === 0) {
+        Logger_1.logger.info("No snapshots for " +
+            instance +
+            ". Create one with `dove schema pull --snapshot <label>`.");
+        return;
+    }
+    Logger_1.logger.info("Snapshots for " + instance + ":");
+    for (const snap of snapshots) {
+        console.log("  " +
+            path_1.default.basename(snap.dir) +
+            "  " +
+            snap.total_tables +
+            " tables" +
+            (snap.label ? "  [" + snap.label + "]" : ""));
+    }
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@tenonhq/dovetail-core",
-  "version": "0.0.94",
+  "version": "0.0.95",
   "description": "Next-gen file syncer",
   "license": "GPL-3.0",
   "main": "./dist/index.js",
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@tenonhq/dovetail-clickup": "^0.0.10",
-    "@tenonhq/dovetail-schema": "^0.0.5",
+    "@tenonhq/dovetail-schema": "^0.0.9",
     "axios": "^1.5.1",
     "axios-cookiejar-support": "^4.0.7",
     "axios-rate-limit": "^1.3.0",

package/release-manifest.json CHANGED Viewed

@@ -1,7 +1,115 @@
 {
   "$schema": "dovetail-manifest/v1",
-  "generated_at": "2026-05-28T15:54:22.498Z",
+  "generated_at": "2026-05-29T16:55:37.736Z",
   "events": [
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-dashboard@0.0.33",
+      "package": "@tenonhq/dovetail-dashboard",
+      "version": "0.0.33",
+      "prev_version": "0.0.32",
+      "published_at": "2026-05-29T16:55:37.729Z",
+      "git": {
+        "sha": "3aaef1ba92364c119ece69369c5cc3379da0ed73",
+        "tag": "dovetail-dashboard@0.0.33"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "3aaef1ba9",
+          "subject": "fix: legible inline code in Claude Plans dark mode (#120)",
+          "pr": 120
+        },
+        {
+          "sha": "92213e1f8",
+          "subject": "chore(release): publish 2 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-claude-plans@0.0.20",
+      "package": "@tenonhq/dovetail-claude-plans",
+      "version": "0.0.20",
+      "prev_version": "0.0.19",
+      "published_at": "2026-05-29T02:18:11.229Z",
+      "git": {
+        "sha": "6a12c10733b64732855a8125c84f0d4846ced256",
+        "tag": "dovetail-claude-plans@0.0.20"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "6a12c1073",
+          "subject": "feat: claude-plans version history, feature score, selected-state + deep-link hardening (#118)",
+          "pr": 118
+        },
+        {
+          "sha": "578d6fb2a",
+          "subject": "chore(release): publish 2 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-dashboard@0.0.32",
+      "package": "@tenonhq/dovetail-dashboard",
+      "version": "0.0.32",
+      "prev_version": "0.0.31",
+      "published_at": "2026-05-29T02:18:11.229Z",
+      "git": {
+        "sha": "6a12c10733b64732855a8125c84f0d4846ced256",
+        "tag": "dovetail-dashboard@0.0.32"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "6a12c1073",
+          "subject": "feat: claude-plans version history, feature score, selected-state + deep-link hardening (#118)",
+          "pr": 118
+        },
+        {
+          "sha": "578d6fb2a",
+          "subject": "chore(release): publish 2 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-core@0.0.94",
+      "package": "@tenonhq/dovetail-core",
+      "version": "0.0.94",
+      "prev_version": "0.0.93",
+      "published_at": "2026-05-28T23:46:03.175Z",
+      "git": {
+        "sha": "8a76deffc38892321c92ae538fee3bc6b8f90d76",
+        "tag": "dovetail-core@0.0.94"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "8a76deffc",
+          "subject": "fix: filesystem-safe record folder names (sys_id fallback for Windows) (#117)",
+          "pr": 117
+        },
+        {
+          "sha": "578d6fb2a",
+          "subject": "chore(release): publish 2 packages [skip ci]"
+        },
+        {
+          "sha": "3faeec43f",
+          "subject": "chore(release): @tenonhq/dovetail-core@0.0.93 [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
     {
       "$schema": "dovetail-release-event/v1",
       "event_id": "dovetail-claude-plans@0.0.19",