@vibgrate/cli 2026.729.2 → 2026.729.3

package/DOCS.md

@@ -1306,6 +1306,8 @@ Most developers never need this directly — Vibgrate for VS Code and `vg code`
 vg daemon status
 vg daemon ensure
 vg daemon start
+vg daemon stop
+vg daemon restart
 vg daemon register
 vg daemon list
 vg daemon federation
@@ -1320,10 +1322,12 @@ vg daemon graphs
 | `status` | Whether the daemon is running and how many workspaces it tracks |
 | `start` | Run in the foreground (Ctrl-C to stop) |
 | `ensure` | Start in the background if not already running (idempotent; for hosts and agents) |
+| `stop` | Stop the running daemon (idempotent — succeeds if none is running) |
+| `restart` | Stop the daemon if running, then start it in the background (`vg update` does this automatically after installing a new version) |
 | `register [root]` | Register the current (or given) repository with a running daemon |
 | `list` | List registered workspaces |
 | `federation [root]` | Register a multi-root federation from `.vibgrate/federation.json` (or primary cwd) |
-| `publish [root]` | Load the workspace code map into the daemon active graph (run `vg build` first) |
+| `publish [root]` | Load the workspace code map into the daemon active graph (run `vg build` first). The daemon reads the map from disk itself, binary snapshot first — nothing heavy crosses the socket |
 | `query <query...>` | Lexical/structural query against the active graph |
 | `impact <symbol>` | Blast radius for a symbol in the active graph |
 | `graphs` | List multi-branch graph slots currently resident |

package/dist/agent-Z4Z66IGM.js

@@ -0,0 +1,22 @@
+export { CONTEXT_POLICY_VERSION, DISCOVERY_TOOLS, MUTATION_TOOLS, compact, runAgent } from './chunk-42RDYQFF.js';
+import './chunk-543E6WDJ.js';
+import './chunk-MYM5VIJ4.js';
+import './chunk-REIGWTTH.js';
+import './chunk-RGEVBSLK.js';
+import './chunk-RBIRXQR6.js';
+import './chunk-5HYCB55P.js';
+import './chunk-IPICO2RV.js';
+import './chunk-G4HTI4ZM.js';
+export { summarizeCapsule } from './chunk-US2DAKCM.js';
+import './chunk-3LSG7Z4I.js';
+import './chunk-J7LKEB2R.js';
+import './chunk-EETK7S43.js';
+import './chunk-UTNNGKKX.js';
+import './chunk-RXP66R2E.js';
+import './chunk-ZKNB4YH4.js';
+import './chunk-BWPBB45M.js';
+import './chunk-JFGYT6BI.js';
+import './chunk-BPF3YX2U.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=agent-Z4Z66IGM.js.map
+//# sourceMappingURL=agent-Z4Z66IGM.js.map

package/dist/agent-Z4Z66IGM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-Z4Z66IGM.js"}

package/dist/baseline-Q3QQF5QF.js

@@ -0,0 +1,9 @@
+export { baselineCommand, runBaseline } from './chunk-YMSXP6AO.js';
+import './chunk-4BOWWYSE.js';
+import './chunk-CRAMOEBE.js';
+import './chunk-RXP66R2E.js';
+import './chunk-N3HCPBFY.js';
+import './chunk-GI6W53LM.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=baseline-Q3QQF5QF.js.map
+//# sourceMappingURL=baseline-Q3QQF5QF.js.map

package/dist/{baseline-UOTGTJYT.js.map → baseline-Q3QQF5QF.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-UOTGTJYT.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-Q3QQF5QF.js"}

package/dist/checkpoint-4WFZMKEO.js

@@ -0,0 +1,56 @@
+import './chunk-Z6ZWNWWR.js';
+
+// src/code/checkpoint.ts
+function checkpointRef(sessionId, seq) {
+  const safe = sessionId.replace(/[^A-Za-z0-9_-]/g, "") || "session";
+  return `refs/vibgrate/checkpoints/${safe}/${seq}`;
+}
+function isGitRepo(git) {
+  return git(["rev-parse", "--is-inside-work-tree"]).exitCode === 0;
+}
+function createCheckpoint(git, opts) {
+  if (!isGitRepo(git)) return null;
+  const env = { GIT_INDEX_FILE: opts.indexFile };
+  if (git(["add", "-A"], env).exitCode !== 0) return null;
+  const tree = git(["write-tree"], env);
+  if (tree.exitCode !== 0) return null;
+  const treeId = tree.stdout.trim();
+  if (!treeId) return null;
+  const head = git(["rev-parse", "HEAD"]);
+  const parent = head.exitCode === 0 && head.stdout.trim() ? ["-p", head.stdout.trim()] : [];
+  const message = opts.message ?? `vg code checkpoint ${opts.seq}`;
+  const commit = git(["commit-tree", treeId, ...parent, "-m", message], env);
+  if (commit.exitCode !== 0) return null;
+  const commitId = commit.stdout.trim();
+  if (!commitId) return null;
+  const ref = checkpointRef(opts.sessionId, opts.seq);
+  if (git(["update-ref", ref, commitId]).exitCode !== 0) return null;
+  return { ref, commit: commitId, seq: opts.seq, files: [...opts.files] };
+}
+function restoreCheckpoint(git, opts) {
+  const restored = [];
+  const removed = [];
+  const failed = [];
+  for (const file of opts.files) {
+    const probe = git(["cat-file", "-e", `${opts.commit}:${file}`]);
+    if (probe.exitCode === 0) {
+      const res = git(["checkout", opts.commit, "--", file]);
+      if (res.exitCode === 0) restored.push(file);
+      else failed.push(file);
+      continue;
+    }
+    const rm = git(["rm", "-f", "--ignore-unmatch", "--", file]);
+    if (rm.exitCode === 0) removed.push(file);
+    else failed.push(file);
+  }
+  return { restored, removed, failed };
+}
+function deleteCheckpoints(git, sessionId, upTo) {
+  for (let seq = 1; seq <= upTo; seq++) {
+    git(["update-ref", "-d", checkpointRef(sessionId, seq)]);
+  }
+}
+
+export { checkpointRef, createCheckpoint, deleteCheckpoints, isGitRepo, restoreCheckpoint };
+//# sourceMappingURL=checkpoint-4WFZMKEO.js.map
+//# sourceMappingURL=checkpoint-4WFZMKEO.js.map

package/dist/checkpoint-4WFZMKEO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/code/checkpoint.ts"],"names":[],"mappings":"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","file":"checkpoint-4WFZMKEO.js","sourcesContent":["/**\n * Checkpoints for VG Code (VG-CLI-CODE §18.4).\n *\n * A checkpoint is a snapshot of the working tree taken when the user approves a\n * change, so an approved edit can be undone after the fact. Two design choices\n * matter:\n *\n *  - **Per approval, not per tool call.** A snapshot costs a tree write; taking\n *    one for every read or search makes large repositories crawl. Approvals are\n *    the points a user would actually want to return to.\n *  - **Out of the way.** Snapshots are commits under `refs/vibgrate/checkpoints/`,\n *    written with a private index file. The user's own index, staged changes,\n *    branch, and HEAD are never touched, and nothing appears in `git log`.\n *    Ignored files stay ignored — a checkpoint captures the project, not\n *    `node_modules`.\n *\n * A checkpoint id is also recorded in run provenance, so the audit record of a\n * run points at the exact tree the agent produced: an auditor can check out\n * what happened rather than take the record's word for it.\n *\n * Pure over an injected git runner, so every path is unit-tested without a\n * repository.\n */\n\n/** Result of running a git command. */\nexport interface GitResult {\n  stdout: string;\n  exitCode: number;\n}\n\n/** Runs a git command with an optional private index file. */\nexport type GitRunner = (args: string[], env?: Record<string, string>) => GitResult;\n\nexport interface Checkpoint {\n  /** Full ref name, e.g. `refs/vibgrate/checkpoints/s7a/2`. */\n  ref: string;\n  /** Commit id the ref points at. */\n  commit: string;\n  /** Sequence within the session, starting at 1. */\n  seq: number;\n  /** Repo-relative files the approved change touched. */\n  files: string[];\n}\n\nexport function checkpointRef(sessionId: string, seq: number): string {\n  // Session ids are engine-generated (`s<base36>`); keep the ref path safe anyway.\n  const safe = sessionId.replace(/[^A-Za-z0-9_-]/g, '') || 'session';\n  return `refs/vibgrate/checkpoints/${safe}/${seq}`;\n}\n\n/** True when the root is inside a git work tree. */\nexport function isGitRepo(git: GitRunner): boolean {\n  return git(['rev-parse', '--is-inside-work-tree']).exitCode === 0;\n}\n\n/**\n * Snapshot the current working tree.\n *\n * Returns null when the repository isn't usable for snapshots (no git, or a\n * fresh repo with no objects yet) — a checkpoint is a convenience, and failing\n * to take one must never block an approved change from being applied.\n */\nexport function createCheckpoint(\n  git: GitRunner,\n  opts: { sessionId: string; seq: number; files: string[]; indexFile: string; message?: string },\n): Checkpoint | null {\n  if (!isGitRepo(git)) return null;\n  const env = { GIT_INDEX_FILE: opts.indexFile };\n\n  // Stage everything into a *private* index: the user's staged work is untouched.\n  if (git(['add', '-A'], env).exitCode !== 0) return null;\n  const tree = git(['write-tree'], env);\n  if (tree.exitCode !== 0) return null;\n  const treeId = tree.stdout.trim();\n  if (!treeId) return null;\n\n  // Parent the snapshot on HEAD when there is one, so the commit is inspectable\n  // with ordinary git tooling. A repo with no commits yet simply has no parent.\n  const head = git(['rev-parse', 'HEAD']);\n  const parent = head.exitCode === 0 && head.stdout.trim() ? ['-p', head.stdout.trim()] : [];\n  const message = opts.message ?? `vg code checkpoint ${opts.seq}`;\n  const commit = git(['commit-tree', treeId, ...parent, '-m', message], env);\n  if (commit.exitCode !== 0) return null;\n  const commitId = commit.stdout.trim();\n  if (!commitId) return null;\n\n  const ref = checkpointRef(opts.sessionId, opts.seq);\n  if (git(['update-ref', ref, commitId]).exitCode !== 0) return null;\n  return { ref, commit: commitId, seq: opts.seq, files: [...opts.files] };\n}\n\nexport interface RestoreOutcome {\n  restored: string[];\n  /** Files that did not exist in the checkpoint and were removed. */\n  removed: string[];\n  failed: string[];\n}\n\n/**\n * Restore files from a checkpoint.\n *\n * Scoped deliberately: only the paths given are touched, never the whole tree.\n * A checkpoint records which files a change wrote, so restoring undoes that\n * change without reverting unrelated work the user did in the meantime — the\n * behaviour someone expects from \"undo this edit\", and the safe default when\n * the alternative is silently discarding their own edits.\n *\n * A file that the checkpoint does not contain was created after it, so undoing\n * means deleting it.\n */\nexport function restoreCheckpoint(\n  git: GitRunner,\n  opts: { commit: string; files: string[] },\n): RestoreOutcome {\n  const restored: string[] = [];\n  const removed: string[] = [];\n  const failed: string[] = [];\n\n  for (const file of opts.files) {\n    // Did this path exist in the snapshot?\n    const probe = git(['cat-file', '-e', `${opts.commit}:${file}`]);\n    if (probe.exitCode === 0) {\n      const res = git(['checkout', opts.commit, '--', file]);\n      if (res.exitCode === 0) restored.push(file);\n      else failed.push(file);\n      continue;\n    }\n    // Absent from the snapshot → it was created after; undo means removing it.\n    const rm = git(['rm', '-f', '--ignore-unmatch', '--', file]);\n    if (rm.exitCode === 0) removed.push(file);\n    else failed.push(file);\n  }\n  return { restored, removed, failed };\n}\n\n/** Delete a session's checkpoint refs (e.g. when the session is discarded). */\nexport function deleteCheckpoints(git: GitRunner, sessionId: string, upTo: number): void {\n  for (let seq = 1; seq <= upTo; seq++) {\n    git(['update-ref', '-d', checkpointRef(sessionId, seq)]);\n  }\n}\n"]}

package/dist/{chunk-CYC3ZI32.js → chunk-3FQSBVQD.js}

@@ -1,11 +1,11 @@
-import { FREE_PACK, navigationToolsetConfig, deferredToolNames, HOT_TOOLS } from './chunk-67YG3R5F.js';
+import { FREE_PACK, navigationToolsetConfig, deferredToolNames, HOT_TOOLS } from './chunk-RIEUPFXO.js';
 import { edgeId, buildModuleResolver, resolve, applyStaticTestLinkage, nodeId } from './chunk-IPICO2RV.js';
-import { acquireLock, releaseLock, indexFor } from './chunk-EETK7S43.js';
 import { init_cli_invocation, whichOnPath, isInstalledOwnBinary } from './chunk-3LSG7Z4I.js';
+import { acquireLock, releaseLock, indexFor } from './chunk-EETK7S43.js';
 import { langById, grammarSetVersion, langForExtension, setGrammarsOverride, parseSource } from './chunk-UTNNGKKX.js';
 import { redactSecrets } from './chunk-RXP66R2E.js';
-import { writeGraphIndex, SCHEMA_VERSION, loadGraph, ensureVibgrateGitignore, vibgrateDir, writeArtifacts } from './chunk-P3QIO4ZU.js';
-import { VERSION } from './chunk-WQE4OIZS.js';
+import { writeGraphIndex, SCHEMA_VERSION, loadGraph, ensureVibgrateGitignore, vibgrateDir, writeArtifacts } from './chunk-JXMZCTVZ.js';
+import { VERSION } from './chunk-N3HCPBFY.js';
 import { loadCache, serializeGraph, cacheDir, stableStringify } from './chunk-ZKNB4YH4.js';
 import { shortId, canonicalize, hashString, hashBytes } from './chunk-JFGYT6BI.js';
 import * as fs10 from 'fs';
@@ -3055,5 +3055,5 @@ async function refreshIfStale(root, opts = {}) {
 }
 
 export { ASSISTANTS, CliError, ExitCode, ResourceLimitError, SKIP_DIRS, SKIP_FILES, SMALL_REPO_FILES, UsageError, analyze, applyCoverage, assistantById, buildFacts, buildGraph, decodeScipIndex, detectAssistants, detectServeLaunch, discover, driftCount, epistemicBreakdown, groundGraph, hasDrift, installAssistant, loadCoverage, loadSnapshot, probeFreshness, refreshIfStale, refreshInstalledInstructions, resolveLimits, scipEdges, uninstallAssistant, usageError, verifyDeterminism, writeNavigationConfig, writeSnapshot };
-//# sourceMappingURL=chunk-CYC3ZI32.js.map
-//# sourceMappingURL=chunk-CYC3ZI32.js.map
+//# sourceMappingURL=chunk-3FQSBVQD.js.map
+//# sourceMappingURL=chunk-3FQSBVQD.js.map