@tenonhq/dovetail-core 0.0.121 → 0.0.122

package/README.md

@@ -24,7 +24,7 @@ The full command surface is documented in the [root CLAUDE.md](../../CLAUDE.md#e
 Quick reference:
 
 ```bash
-npx dove watch         # multi-scope watch + dashboard
+npx dove watch         # HUMAN-ONLY local dev: multi-scope watch + dashboard (hidden from --help; stop before git checkout — see #155)
 npx dove push          # build + push current files
 npx dove refresh       # pull manifest + new files (aliases: pull, r)
 npx dove build         # local build only

package/dist/allScopesCommands.js

@@ -47,6 +47,7 @@ const AppUtils = __importStar(require("./appUtils"));
 const wizard_1 = require("./wizard");
 const snClient_1 = require("./snClient");
 const commands_1 = require("./commands");
+const claudeSession_1 = require("./claudeSession");
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const child_process_1 = require("child_process");
@@ -371,6 +372,13 @@ async function initScopesCommand(args) {
 }
 async function watchAllScopesCommand(args) {
     (0, commands_1.setLogLevel)(args);
+    // Soft guard, not a hard fail: `watch` is a human-only local-dev tool and a
+    // branch switch mid-watch overwrites instance records. Warn an agent off it
+    // but leave the human path untouched. See TenonHQ/Dovetail#155.
+    if ((0, claudeSession_1.isClaudeCodeSession)()) {
+        Logger_1.logger.warn(claudeSession_1.WATCH_HUMAN_ONLY_WARNING);
+        FileLogger_1.fileLogger.warn("dove watch started inside a Claude Code session (TenonHQ/Dovetail#155)");
+    }
     var dashboardProcess = null;
     try {
         // First check if we have environment variables set. SN_USER stays

package/dist/claudeSession.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Claude Code session detection for human-only CLI surfaces.
+ *
+ * `dove watch` auto-syncs the working tree to the instance, and a git branch
+ * switch mid-watch pushes the post-switch file state over live records. An
+ * agent can't guarantee it stops the watcher before every branch operation, so
+ * the command is hidden from `--help` and warns when it detects it is running
+ * inside a Claude Code session. See TenonHQ/Dovetail#155.
+ *
+ * Pure functions — no I/O — so the detection is unit-testable without touching
+ * `process.env` directly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WATCH_HUMAN_ONLY_WARNING = void 0;
+exports.isClaudeCodeSession = isClaudeCodeSession;
+// Claude Code exports `CLAUDECODE=1` into every tool shell, plus a family of
+// `CLAUDE_CODE_*` variables (e.g. `CLAUDE_CODE_SESSION_ID`, which claude-plans
+// already keys on). Any one of them set to a non-empty value is a session.
+var CLAUDE_SESSION_FLAG = "CLAUDECODE";
+var CLAUDE_SESSION_PREFIX = "CLAUDE_CODE_";
+/**
+ * @description Human-only warning printed when `dove watch` starts inside a
+ * Claude Code session. Non-blocking by design (TenonHQ/Dovetail#155).
+ */
+exports.WATCH_HUMAN_ONLY_WARNING = "⚠ `dove watch` is a human-only local-dev tool — it auto-syncs to the " +
+    "instance and a branch switch mid-watch overwrites records. Don't run this " +
+    "inside Claude Code. Use `npx dove push --diff <branch>` / `npx dove refresh` / " +
+    "`npx dove status` instead. See TenonHQ/Dovetail#155.";
+/**
+ * @description Reports whether the given environment looks like a Claude Code
+ * session: `CLAUDECODE` is set, or any `CLAUDE_CODE_*` variable is set, to a
+ * non-empty value. Empty strings do not count — an unset-but-declared variable
+ * is not a session.
+ * @param {NodeJS.ProcessEnv} env - Environment to inspect (defaults to `process.env`).
+ * @returns {boolean} True when a Claude Code session is detected.
+ */
+function isClaudeCodeSession(env = process.env) {
+    if (!env || typeof env !== "object")
+        return false;
+    if (hasValue(env[CLAUDE_SESSION_FLAG]))
+        return true;
+    var keys = Object.keys(env);
+    for (var i = 0; i < keys.length; i++) {
+        var key = keys[i];
+        if (key.indexOf(CLAUDE_SESSION_PREFIX) === 0 && hasValue(env[key]))
+            return true;
+    }
+    return false;
+}
+/**
+ * @description True when an env value is a non-empty string.
+ * @param {string|undefined} value - Raw env value.
+ * @returns {boolean} Whether the value counts as "set".
+ */
+function hasValue(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}

package/dist/commander.js

@@ -49,7 +49,17 @@ function configureCli(cli) {
         describe: "Write a dovetail-debug-*.log file for this command (off by default; also enabled by DOVETAIL_DEBUG=1).",
     })
         .global("debug")
-        .command(["watch", "w", "watchAllScopes"], "Watch all scopes for file changes and sync to ServiceNow", (cmdArgs) => {
+        // INTENTIONAL: 'watch' is hidden from help + Claude-facing docs. It
+        // auto-syncs to the instance and a branch switch mid-watch silently
+        // overwrites records. Human-only local-dev tool. Do not re-document for
+        // Claude. See TenonHQ/Dovetail#155.
+        //
+        // A `false` description is yargs' hidden-command pattern: the command stays
+        // fully wired (a human typing `dove watch` / `w` / `watchAllScopes` still
+        // gets it, and `dove watch --help` still prints its flags) but it is omitted
+        // from the `dove --help` command index. The handler itself prints a
+        // human-only warning when it detects a Claude Code session (claudeSession.ts).
+        .command(["watch", "w", "watchAllScopes"], false, (cmdArgs) => {
         cmdArgs.options({
             ...sharedOptions,
             noDashboard: {

package/dist/tests/claudeSession.test.js

@@ -0,0 +1,42 @@
+"use strict";
+// Tests for the Claude Code session detector behind the `dove watch` soft
+// guard (claudeSession.ts, TenonHQ/Dovetail#155). Pure-function tests — an
+// explicit env object is passed so the real process.env never leaks in.
+Object.defineProperty(exports, "__esModule", { value: true });
+const claudeSession_1 = require("../claudeSession");
+describe("isClaudeCodeSession", function () {
+    it("returns false for an empty environment", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)({})).toBe(false);
+    });
+    it("returns false when only unrelated variables are set", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)({ HOME: "/tmp", SN_INSTANCE: "x.service-now.com" })).toBe(false);
+    });
+    it("returns true when CLAUDECODE is set", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)({ CLAUDECODE: "1" })).toBe(true);
+    });
+    it("returns true when any CLAUDE_CODE_* variable is set", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)({ CLAUDE_CODE_SESSION_ID: "abc123" })).toBe(true);
+        expect((0, claudeSession_1.isClaudeCodeSession)({ CLAUDE_CODE_ENTRYPOINT: "cli" })).toBe(true);
+    });
+    it("treats empty or whitespace-only values as unset", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)({ CLAUDECODE: "" })).toBe(false);
+        expect((0, claudeSession_1.isClaudeCodeSession)({ CLAUDE_CODE_SESSION_ID: "   " })).toBe(false);
+    });
+    it("does not match look-alike prefixes", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)({ CLAUDE: "1", CLAUDECODEX: "1", MY_CLAUDE_CODE_X: "1" })).toBe(false);
+    });
+    it("defaults to process.env and agrees with an explicit copy of it", function () {
+        expect((0, claudeSession_1.isClaudeCodeSession)()).toBe((0, claudeSession_1.isClaudeCodeSession)({ ...process.env }));
+    });
+});
+describe("WATCH_HUMAN_ONLY_WARNING", function () {
+    it("names the hazard, the safe headless verbs, and the tracking issue", function () {
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("human-only");
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("branch switch");
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("Claude Code");
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("dove push");
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("dove refresh");
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("dove status");
+        expect(claudeSession_1.WATCH_HUMAN_ONLY_WARNING).toContain("TenonHQ/Dovetail#155");
+    });
+});

package/dist/tests/watchHidden.test.js

@@ -0,0 +1,146 @@
+"use strict";
+// `dove watch` is hidden from the `--help` command index but stays wired for
+// humans (TenonHQ/Dovetail#155). These tests pin both halves: the help text
+// never lists `watch` / `w` / `watchAllScopes`, and all three spellings still
+// route to the watch handler. Mocks mirror commanderStrict.test.ts — the parser
+// is under test, not the commands, which would hit ServiceNow.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock("../commands", () => ({
+    refreshCommand: jest.fn(),
+    pushCommand: jest.fn(),
+    downloadCommand: jest.fn(),
+    initCommand: jest.fn(),
+    buildCommand: jest.fn(),
+    deployCommand: jest.fn(),
+    statusCommand: jest.fn(),
+    taskClearCommand: jest.fn(),
+}));
+jest.mock("../allScopesCommands", () => ({
+    initScopesCommand: jest.fn(),
+    watchAllScopesCommand: jest.fn(),
+}));
+jest.mock("../updateSetCommands", () => ({
+    createUpdateSetCommand: jest.fn(),
+    switchUpdateSetCommand: jest.fn(),
+    listUpdateSetsCommand: jest.fn(),
+    showCurrentUpdateSetCommand: jest.fn(),
+    changeScopeCommand: jest.fn(),
+    showCurrentScopeCommand: jest.fn(),
+}));
+jest.mock("../dashboardCommand", () => ({ dashboardCommand: jest.fn() }));
+jest.mock("../schemaCommand", () => ({
+    schemaPullCommand: jest.fn(),
+    schemaDiffCommand: jest.fn(),
+    schemaSnapshotsCommand: jest.fn(),
+}));
+jest.mock("../claudeCommand", () => ({ initClaudeCommand: jest.fn() }));
+jest.mock("../createRecordCommand", () => ({ createRecordCommand: jest.fn() }));
+jest.mock("../deleteRecordCommand", () => ({ deleteRecordCommand: jest.fn() }));
+jest.mock("../reconcileCommand", () => ({ reconcileCommand: jest.fn() }));
+jest.mock("../migrateCommand", () => ({ migrateCommand: jest.fn() }));
+jest.mock("../loginCommand", () => ({ loginCommand: jest.fn() }));
+jest.mock("../knowledgeDiffCommand", () => ({ knowledgeDiffCommand: jest.fn() }));
+jest.mock("../clickupCommands", () => ({
+    clickupTasksCommand: jest.fn(),
+    clickupTaskCommand: jest.fn(),
+    clickupCreateCommand: jest.fn(),
+    clickupUpdateCommand: jest.fn(),
+    clickupCommentCommand: jest.fn(),
+    clickupSetupCommand: jest.fn(),
+    clickupTeamsCommand: jest.fn(),
+    clickupSpacesCommand: jest.fn(),
+    clickupListsCommand: jest.fn(),
+}));
+// --- Imports (after mocks) ---
+const yargs_1 = __importDefault(require("yargs/yargs"));
+const commander_1 = require("../commander");
+const allScopesCommands_1 = require("../allScopesCommands");
+/**
+ * @description Runs a fake `dove` invocation through a fresh, non-exiting parser.
+ * @param {string[]} args - Argv as the user would type it, minus the binary name.
+ * @returns {Promise<ParseResult>} The parse error (if any) and yargs' captured output.
+ */
+async function run(args) {
+    const cli = (0, commander_1.configureCli)((0, yargs_1.default)([])).exitProcess(false);
+    const result = await new Promise(function (resolve) {
+        cli.parse(args, {}, function (error, _argv, output) {
+            resolve({
+                error: error === null ? undefined : error,
+                output: output || "",
+            });
+        });
+    });
+    await new Promise(function (resolve) {
+        setImmediate(resolve);
+    });
+    return result;
+}
+/**
+ * @description Extracts the `dove <cmd>` command names listed in a yargs help
+ * body (the "Commands:" index), so assertions target the index rather than
+ * incidental prose in option descriptions.
+ * @param {string} help - Captured `--help` output.
+ * @returns {string[]} Command tokens exactly as the index prints them.
+ */
+function listedCommands(help) {
+    const names = [];
+    const lines = help.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const match = /^\s*dove\s+(\S+)/.exec(lines[i]);
+        if (match)
+            names.push(match[1]);
+    }
+    return names;
+}
+beforeEach(function () {
+    jest.clearAllMocks();
+});
+describe("dove --help hides watch", function () {
+    it("does not list watch, w, or watchAllScopes in the command index", async function () {
+        const { output } = await run(["--help"]);
+        const commands = listedCommands(output);
+        expect(commands.length).toBeGreaterThan(0);
+        expect(commands).not.toContain("watch");
+        expect(commands).not.toContain("w");
+        expect(commands).not.toContain("watchAllScopes");
+        expect(output).not.toMatch(/\bwatchAllScopes\b/);
+        expect(output).not.toMatch(/\bdove\s+w(atch)?\b/);
+    });
+    it("still lists the safe headless verbs", async function () {
+        const { output } = await run(["--help"]);
+        const commands = listedCommands(output);
+        expect(commands).toContain("refresh");
+        expect(commands).toContain("push");
+        expect(commands).toContain("status");
+    });
+    it("does not surface watch in the bare-invocation help either", async function () {
+        const { output, error } = await run([]);
+        expect(error).toBeDefined();
+        expect(output + String(error)).not.toMatch(/\bwatchAllScopes\b/);
+        expect(listedCommands(output)).not.toContain("watch");
+    });
+});
+describe("dove watch stays wired for humans", function () {
+    it("routes `watch` to the watch handler", async function () {
+        const { error } = await run(["watch"]);
+        expect(error).toBeUndefined();
+        expect(allScopesCommands_1.watchAllScopesCommand).toHaveBeenCalledTimes(1);
+    });
+    it("routes the `w` and `watchAllScopes` aliases too", async function () {
+        await run(["w"]);
+        expect(allScopesCommands_1.watchAllScopesCommand).toHaveBeenCalledTimes(1);
+        await run(["watchAllScopes"]);
+        expect(allScopesCommands_1.watchAllScopesCommand).toHaveBeenCalledTimes(2);
+    });
+    it("passes watch flags through", async function () {
+        await run(["watch", "--noDashboard", "--port", "4000"]);
+        expect(allScopesCommands_1.watchAllScopesCommand).toHaveBeenCalledTimes(1);
+        const mock = allScopesCommands_1.watchAllScopesCommand;
+        const args = mock.mock.calls[0][0];
+        expect(args.noDashboard).toBe(true);
+        expect(args.port).toBe(4000);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenonhq/dovetail-core",
-  "version": "0.0.121",
+  "version": "0.0.122",
   "description": "Next-gen file syncer",
   "license": "GPL-3.0",
   "main": "./dist/index.js",

package/release-manifest.json

@@ -1,7 +1,252 @@
 {
   "$schema": "dovetail-manifest/v1",
-  "generated_at": "2026-10-02T17:40:24.896Z",
+  "generated_at": "2026-10-05T19:26:26.993Z",
   "events": [
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-types@0.0.22",
+      "package": "@tenonhq/dovetail-types",
+      "version": "0.0.22",
+      "prev_version": "0.0.21",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-types@0.0.22"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "7e59c1a9e",
+          "subject": "feat(sync): scopeQuery + nameTemplate table options — sync sys_choice/sys_dictionary per scope (#295)",
+          "pr": 295
+        },
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-babel-plugin@0.0.14",
+      "package": "@tenonhq/dovetail-babel-plugin",
+      "version": "0.0.14",
+      "prev_version": "0.0.13",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-babel-plugin@0.0.14"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-babel-plugin-remove-modules@0.0.14",
+      "package": "@tenonhq/dovetail-babel-plugin-remove-modules",
+      "version": "0.0.14",
+      "prev_version": "0.0.13",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-babel-plugin-remove-modules@0.0.14"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-babel-preset-servicenow@0.0.14",
+      "package": "@tenonhq/dovetail-babel-preset-servicenow",
+      "version": "0.0.14",
+      "prev_version": "0.0.13",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-babel-preset-servicenow@0.0.14"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-schema@0.0.15",
+      "package": "@tenonhq/dovetail-schema",
+      "version": "0.0.15",
+      "prev_version": "0.0.14",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-schema@0.0.15"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "b46e30a86",
+          "subject": "chore(release): publish 7 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-core@0.0.121",
+      "package": "@tenonhq/dovetail-core",
+      "version": "0.0.121",
+      "prev_version": "0.0.120",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-core@0.0.121"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "7e59c1a9e",
+          "subject": "feat(sync): scopeQuery + nameTemplate table options — sync sys_choice/sys_dictionary per scope (#295)",
+          "pr": 295
+        },
+        {
+          "sha": "3c380428b",
+          "subject": "chore(release): publish 2 packages [skip ci]"
+        },
+        {
+          "sha": "b46e30a86",
+          "subject": "chore(release): publish 7 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-eslint-plugin@0.0.16",
+      "package": "@tenonhq/dovetail-eslint-plugin",
+      "version": "0.0.16",
+      "prev_version": "0.0.15",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-eslint-plugin@0.0.16"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-prettier-plugin@0.0.14",
+      "package": "@tenonhq/dovetail-prettier-plugin",
+      "version": "0.0.14",
+      "prev_version": "0.0.13",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-prettier-plugin@0.0.14"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-sass-plugin@0.0.14",
+      "package": "@tenonhq/dovetail-sass-plugin",
+      "version": "0.0.14",
+      "prev_version": "0.0.13",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-sass-plugin@0.0.14"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-typescript-plugin@0.0.14",
+      "package": "@tenonhq/dovetail-typescript-plugin",
+      "version": "0.0.14",
+      "prev_version": "0.0.13",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-typescript-plugin@0.0.14"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
+    {
+      "$schema": "dovetail-release-event/v1",
+      "event_id": "dovetail-webpack-plugin@0.0.13",
+      "package": "@tenonhq/dovetail-webpack-plugin",
+      "version": "0.0.13",
+      "prev_version": "0.0.12",
+      "published_at": "2026-10-05T19:26:26.940Z",
+      "git": {
+        "sha": "7e59c1a9e074a0e2cb73bc68ff2ddfd423be2c90",
+        "tag": "dovetail-webpack-plugin@0.0.13"
+      },
+      "semver_bump": "patch",
+      "commits": [
+        {
+          "sha": "4576c072f",
+          "subject": "chore(release): publish 15 packages [skip ci]"
+        }
+      ],
+      "exports_delta": null,
+      "narrative": null
+    },
     {
       "$schema": "dovetail-release-event/v1",
       "event_id": "dovetail-gmail@0.0.13",
@@ -1044,297 +1289,6 @@
       ],
       "exports_delta": null,
       "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-prettier-plugin@0.0.13",
-      "package": "@tenonhq/dovetail-prettier-plugin",
-      "version": "0.0.13",
-      "prev_version": "0.0.12",
-      "published_at": "2026-08-31T21:34:20.896Z",
-      "git": {
-        "sha": "81ab50a4e0fc105445ffc6d6983bc93a1483859d",
-        "tag": "dovetail-prettier-plugin@0.0.13"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "17624b238",
-          "subject": "chore(release): publish 11 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-sass-plugin@0.0.13",
-      "package": "@tenonhq/dovetail-sass-plugin",
-      "version": "0.0.13",
-      "prev_version": "0.0.12",
-      "published_at": "2026-08-31T21:34:20.896Z",
-      "git": {
-        "sha": "81ab50a4e0fc105445ffc6d6983bc93a1483859d",
-        "tag": "dovetail-sass-plugin@0.0.13"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "17624b238",
-          "subject": "chore(release): publish 11 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-sawmill@0.0.9",
-      "package": "@tenonhq/dovetail-sawmill",
-      "version": "0.0.9",
-      "prev_version": "0.0.8",
-      "published_at": "2026-08-31T21:34:20.896Z",
-      "git": {
-        "sha": "81ab50a4e0fc105445ffc6d6983bc93a1483859d",
-        "tag": "dovetail-sawmill@0.0.9"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "81ab50a4e",
-          "subject": "feat: SN_API_KEY inbound API-key auth mode across all ServiceNow clients (#264)",
-          "pr": 264
-        },
-        {
-          "sha": "4bc78bc61",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        },
-        {
-          "sha": "c82439b30",
-          "subject": "chore(deps): bump js-yaml, jest and ts-jest (#183)",
-          "pr": 183
-        },
-        {
-          "sha": "958f4fcd7",
-          "subject": "chore(release): publish 3 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-typescript-plugin@0.0.13",
-      "package": "@tenonhq/dovetail-typescript-plugin",
-      "version": "0.0.13",
-      "prev_version": "0.0.12",
-      "published_at": "2026-08-31T21:34:20.896Z",
-      "git": {
-        "sha": "81ab50a4e0fc105445ffc6d6983bc93a1483859d",
-        "tag": "dovetail-typescript-plugin@0.0.13"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "17624b238",
-          "subject": "chore(release): publish 11 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-webpack-plugin@0.0.12",
-      "package": "@tenonhq/dovetail-webpack-plugin",
-      "version": "0.0.12",
-      "prev_version": "0.0.11",
-      "published_at": "2026-08-31T21:34:20.896Z",
-      "git": {
-        "sha": "81ab50a4e0fc105445ffc6d6983bc93a1483859d",
-        "tag": "dovetail-webpack-plugin@0.0.12"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "17624b238",
-          "subject": "chore(release): publish 11 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-servicenow@0.0.35",
-      "package": "@tenonhq/dovetail-servicenow",
-      "version": "0.0.35",
-      "prev_version": "0.0.34",
-      "published_at": "2026-07-28T22:07:08.734Z",
-      "git": {
-        "sha": "44c5d85d6b3232119e47397da43344b4185f94ff",
-        "tag": "dovetail-servicenow@0.0.35"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "44c5d85d6",
-          "subject": "feat(servicenow): remove-choices verb — soft-delete choice values (DEV-511) (#237)",
-          "pr": 237
-        },
-        {
-          "sha": "c80d5cc24",
-          "subject": "feat(servicenow): S1 execution-context gate + WRITE_DESTRUCTIVE tier (DEV-507) (#239)",
-          "pr": 239
-        },
-        {
-          "sha": "1749ba4f0",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-mcp@0.0.32",
-      "package": "@tenonhq/dovetail-mcp",
-      "version": "0.0.32",
-      "prev_version": "0.0.31",
-      "published_at": "2026-07-28T22:07:08.734Z",
-      "git": {
-        "sha": "44c5d85d6b3232119e47397da43344b4185f94ff",
-        "tag": "dovetail-mcp@0.0.32"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "1749ba4f0",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-core@0.0.118",
-      "package": "@tenonhq/dovetail-core",
-      "version": "0.0.118",
-      "prev_version": "0.0.117",
-      "published_at": "2026-07-28T07:09:33.080Z",
-      "git": {
-        "sha": "e4193968a18d54df70f599a15e2b7b940fa491b9",
-        "tag": "dovetail-core@0.0.118"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "e4193968a",
-          "subject": "fix(core): close review findings from the metaData work (#251)",
-          "pr": 251
-        },
-        {
-          "sha": "f245dd850",
-          "subject": "chore(release): @tenonhq/dovetail-core@0.0.117 [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-core@0.0.117",
-      "package": "@tenonhq/dovetail-core",
-      "version": "0.0.117",
-      "prev_version": "0.0.116",
-      "published_at": "2026-07-28T06:44:03.528Z",
-      "git": {
-        "sha": "47199bcf436db3be5b8fd6728265444e72a96bc0",
-        "tag": "dovetail-core@0.0.117"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "47199bcf4",
-          "subject": "fix(core): keep informative display_value, drop only the churning kinds (#250)",
-          "pr": 250
-        },
-        {
-          "sha": "afd387889",
-          "subject": "chore(release): @tenonhq/dovetail-core@0.0.116 [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-core@0.0.116",
-      "package": "@tenonhq/dovetail-core",
-      "version": "0.0.116",
-      "prev_version": "0.0.115",
-      "published_at": "2026-07-28T06:17:01.130Z",
-      "git": {
-        "sha": "ab33183076fdb0eb18a8fc1c8e79b607af3893c4",
-        "tag": "dovetail-core@0.0.116"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "ab3318307",
-          "subject": "fix(core): --metadata-only must not write the scope manifest (#249)",
-          "pr": 249
-        },
-        {
-          "sha": "f77cab2e5",
-          "subject": "chore(release): @tenonhq/dovetail-core@0.0.115 [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
-    },
-    {
-      "$schema": "dovetail-release-event/v1",
-      "event_id": "dovetail-core@0.0.115",
-      "package": "@tenonhq/dovetail-core",
-      "version": "0.0.115",
-      "prev_version": "0.0.114",
-      "published_at": "2026-07-28T03:15:38.018Z",
-      "git": {
-        "sha": "4a8d2cc328b7fd09f56d2ab6cd66203d28e5b1ae",
-        "tag": "dovetail-core@0.0.115"
-      },
-      "semver_bump": "patch",
-      "commits": [
-        {
-          "sha": "4a8d2cc32",
-          "subject": "fix(core): make metaData.json deterministic on every write path (#246)",
-          "pr": 246
-        },
-        {
-          "sha": "1749ba4f0",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        },
-        {
-          "sha": "8d886d43d",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        },
-        {
-          "sha": "b79555b25",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        },
-        {
-          "sha": "02f562c32",
-          "subject": "chore(release): publish 2 packages [skip ci]"
-        },
-        {
-          "sha": "05e406b06",
-          "subject": "chore(release): @tenonhq/dovetail-core@0.0.114 [skip ci]"
-        }
-      ],
-      "exports_delta": null,
-      "narrative": null
     }
   ]
 }

package/skills/dove-manage-update-sets.md

@@ -68,9 +68,9 @@ The dashboard reads scopes from `dove.config.js` and stores selections in `.dove
 
 `createUpdateSet`, `switchUpdateSet`, and `push --updateSet` now write the affected scope's entry into `.dove-update-sets.json` as part of activating the set, so the routing file, the active set, and the push destination stay consistent. Each prints the resolved destination, e.g. `Push routing updated: x_cadso_core -> FEAT-123 (sys_id)`, and every push prints `Update set routing (from .dove-update-sets.json): <scope> -> <name> (<sys_id>)` so you can see exactly where captures land. If you edit `.dove-update-sets.json` by hand, that entry wins until you switch sets again.
 
-### Multi-Scope Update Set Monitoring
+### Multi-Scope Update Set Check
 
-When using `npx dove watchAllScopes`, update set status is automatically checked every 2 minutes. It warns if any scope is using the DEFAULT update set (a common mistake that puts changes in the wrong place).
+Before every push, run `npx dove currentUpdateSet` for each scope you are about to touch (or open the dashboard with `npx dove dashboard`). A scope still on its DEFAULT update set is a common mistake that puts changes in the wrong place — `push` also prints the resolved routing per scope so you can catch it in the output.
 
 ### Recommended Workflow
 
@@ -79,7 +79,7 @@ When using `npx dove watchAllScopes`, update set status is automatically checked
    npx dove createUpdateSet --name "FEAT-123 Add User Dashboard" --scope x_cadso_core
    ```
 
-2. **During development:** Use `npx dove dev` or `npx dove watchAllScopes`. Changes go into the active update set.
+2. **During development:** Edit locally, then `npx dove push --diff <branch>`. Changes go into the active update set for each file's scope.
 
 3. **Check status:** `npx dove currentUpdateSet` to verify you are in the right update set.
 
@@ -90,5 +90,5 @@ When using `npx dove watchAllScopes`, update set status is automatically checked
 ### Common Issues
 
 - **"No update set selected"** -- You are using the Default update set. Create or switch to a named one.
-- **Changes going to wrong scope** -- In multi-scope mode, use `npx dove watchAllScopes` which auto-switches scopes. Single-scope `npx dove dev` only works for one scope.
+- **Changes going to wrong scope** -- `npx dove push` routes each record by its scope's entry in `.dove-update-sets.json`; a scope with no entry falls back to the session's current scope/set. Map every scope you touch (`createUpdateSet` / `switchUpdateSet --scope <scope>`) before a multi-scope push, and check the file sits under the right scope's `sourceDirectory` and in that scope's `dove.manifest.<scope>.json`.
 - **Update set not found** -- Check the scope filter. Update sets are scope-specific.

package/skills/dove-setup-project.md

@@ -69,8 +69,12 @@ dovetail-debug-*.log
 
 #### Start development
 ```bash
-npx dove dev
+npx dove status              # confirm instance, scope, user
+npx dove refresh             # pull the manifest + files
+# ...edit files...
+npx dove push --diff main    # push only what changed vs the branch
 ```
+Sync is headless and explicit: `refresh` before you start, `push` when you are done. There is no always-on sync step in this flow.
 
 ### Scenario 2: Add a New Scope (Multi-Scope Setup)
 
@@ -102,11 +106,13 @@ If hitting rate limits:
 npx dove initScopes --delay 1000
 ```
 
-#### Watch all scopes simultaneously
+#### Sync across all scopes
 ```bash
-npx dove watchAllScopes
+npx dove refresh                 # all declared scopes
+npx dove refresh -s x_cadso_work # one scope
+npx dove push --diff main        # one command for a multi-scope change
 ```
-Watches all scope directories, auto-switches ServiceNow scope context per file, monitors update set status every 2 minutes.
+`push` reads each file's scope from its manifest and, when `.dove-update-sets.json` maps that scope to an update set (`createUpdateSet` / `switchUpdateSet` write the mapping), routes the record into that scope's set server-side. Map every scope you are about to touch first — the server session scope is only swapped once, to the first file's scope, so an unmapped second scope is the thing to avoid. Confirm with `npx dove currentUpdateSet --scope <scope>` before pushing.
 
 #### Download a single scope
 ```bash
@@ -150,6 +156,6 @@ project/
 | `npx dove initScopes` | Download all configured scopes |
 | `npx dove download <scope>` | Download a specific scope (destructive) |
 | `npx dove refresh` | Refresh manifest, download new files only |
-| `npx dove dev` | Start single-scope watch mode |
-| `npx dove watchAllScopes` | Start multi-scope watch mode |
+| `npx dove push --diff <branch>` | Push only the files changed vs a branch (all scopes) |
+| `npx dove push` | Push every local file (all scopes) |
 | `npx dove status` | Show connected instance, scope, user |

package/skills/dove-troubleshoot-sync.md

@@ -32,11 +32,11 @@ Ask the user which symptom they are experiencing (if not already clear):
 
 ### Diagnostic A: Files Not Pushing
 
-1. **Check dev mode is running:** `npx dove dev` or `npx dove watchAllScopes`
+1. **Push explicitly:** saving a file does not sync it on its own. Run `npx dove push --diff <branch>` (or `npx dove push` for everything) and read the per-file output.
 2. **Check the file is in the manifest:** Look in `dove.manifest.json` or `dove.manifest.<scope>.json` for the table/record/field entry. If missing, run `npx dove refresh`.
 3. **Check file extension matches a rule:** The file extension must match a `match` regex in `dove.config.js` rules. If no rule matches, the file content is pushed as-is (no build).
 4. **Check debug logs:** Re-run the command with `--debug` (or `DOVETAIL_DEBUG=1`) to write a `dovetail-debug-*.log` file in the project root, then inspect it. Debug logs are opt-in — without the flag no log file is produced.
-5. **Try manual push:** `npx dove push` to push all files and see errors.
+5. **Confirm on the instance:** `npx dove status` for the connection, then verify the record changed on the instance — never infer success from the push exit code alone.
 
 ### Diagnostic B: Authentication/Connection Failure
 
@@ -63,7 +63,7 @@ Dovetail checks that your local manifest scope matches the active scope on the S
 
 1. **Check current scope:** `npx dove currentScope`
 2. **Change scope:** `npx dove changeScope --scope x_cadso_core`
-3. **For multi-scope watch:** `npx dove watchAllScopes` handles scope switching automatically per file.
+3. **For multi-scope pushes:** `npx dove push` swaps the server session scope once (to the first file's scope) and routes each record through its scope's update set from `.dove-update-sets.json`. Make sure every scope in the push has a mapping (`npx dove switchUpdateSet --scope <scope> ...`), or push one scope at a time with a path target (`npx dove push src/x_cadso_core`).
 4. **Force scope swap on push:** `npx dove push --scopeSwap`
 
 ### Diagnostic D: Build/Transform Errors