@voidlabs.gg/voidshift-agents 0.4.5 → 0.5.0

package/README.md

@@ -127,9 +127,18 @@ vsf memory status          # the vault and where recall is on
 vsf memory search WORDS    # notes recall would bring up
 vsf memory try "a prompt"  # exactly what recall would add to that prompt
 vsf memory check           # notes missing from INDEX.md, broken links
+vsf memory sync            # pull and push the vault through its git remote
 vsf memory on | off        # turn recall on or off
 ```
 
+To share the vault between machines, make it a git repository with a remote
+named `origin` (any host; a private repository). `vsf memory sync` commits new
+notes, rebases onto the remote and pushes. It also runs in the background from
+the recall hook when the last sync is over ten minutes old, and the agents
+runner syncs before and after every run. When a note changed on both sides,
+the remote's version stays and this machine's copy is saved beside it as
+`note.conflict-<machine>-<time>.md`, so nothing is lost.
+
 Setup creates a vault at `~/memory` or uses one you already have. Codex asks you
 to trust the recall hook once: run `/hooks` in Codex.
 
@@ -180,8 +189,12 @@ pnpm test
 node packages/cli/src/main.ts
 ```
 
-Node 22.18 or newer runs the TypeScript sources directly. Releases are cut by
-pushing a `v*` tag; CI publishes every package at that version.
+Node 22.18 or newer runs the TypeScript sources directly. Each package
+releases on its own: bump its `package.json` and push `agents-v0.5.0` (or
+`cli-v`, `memory-v`, `awake-v`), and CI publishes only that package. A plain
+`v*` tag publishes all four at one version. Tools declare the CLI contract
+they were built for; a CLI that is too old refuses to load them and says to
+run `vsf update`.
 
 ## License
 

package/dist/index.js

@@ -1042,6 +1042,7 @@ const homeCommands = {
 const sameModels = (a, b) => a.dev === b.dev && a.review === b.review;
 const agents = {
     name: 'agents',
+    contract: 1,
     summary: 'Agents for Claude Code and Codex that plan, build and QA Linear cards',
     config: {
         read: (dir) => readAgentsConfig(dir),

package/dist/memory.d.ts

@@ -1,2 +1,3 @@
 export declare function vaultPath(configDir: string): string | undefined;
 export declare function recall(selfCommand: string[], configDir: string, text: string): string;
+export declare function syncMemory(selfCommand: string[], configDir: string): string;

package/dist/memory.js

@@ -35,3 +35,15 @@ export function recall(selfCommand, configDir, text) {
         return '';
     }
 }
+// Brings the vault up to date through its git remote, or shares the notes
+// agents wrote. Never fails a run: returns a line worth logging, or ''.
+export function syncMemory(selfCommand, configDir) {
+    if (!vaultPath(configDir) || !selfCommand.length)
+        return '';
+    const [cmd, ...args] = selfCommand;
+    const r = spawnSync(cmd, [...args, 'memory', 'sync', '--quiet'], { encoding: 'utf8', timeout: 90_000 });
+    const out = `${r.stdout ?? ''}${r.stderr ?? ''}`.trim();
+    if (r.error)
+        return `memory sync did not run (${r.error.message})`;
+    return r.status === 0 ? out : out || 'memory sync failed';
+}

package/dist/runner.js

@@ -6,7 +6,7 @@ import { lastDue, parseCron } from "./cron.js";
 import { runAgent, stopAgents } from "./engine.js";
 import { commitsAhead, enforceCommitPolicy, defaultBranch, ensureDraftPr, ensureWorktree, headSha, markReady, push, resetWorktree, waitForChecks, waitForPrHead } from "./git.js";
 import { noTracker } from "./tracker.js";
-import { recall, vaultPath } from "./memory.js";
+import { recall, syncMemory, vaultPath } from "./memory.js";
 import { claudeSettingsFile, readRules, rulesSection } from "./profile.js";
 import { bootTime, clearCurrent, isPaused, ours, readCurrent, readPending, writeCurrent, writePending, writeRun, readCronState, writeCronState } from "./state.js";
 const stamp = () => new Date().toISOString().replace(/[:.]/g, '-');
@@ -156,6 +156,10 @@ export async function runCard(card, trigger, workflowName, workflow, project, rc
             throw new Park(`Your agent profile's Claude settings are broken: ${err.message}`);
         }
         const rules = rulesSection(readRules(rc.configDir));
+        // Latest notes from every machine before recall reads them.
+        const pulled = syncMemory(rc.selfCommand, rc.configDir);
+        if (pulled)
+            say(pulled);
         const known = [recall(rc.selfCommand, rc.configDir, `${workflow.project} ${card.title}\n${card.description ?? ''}`), vault ? memoryNote(vault) : '', rules].filter(Boolean).join('\n\n');
         const worktree = join(agentsDir(rc.configDir), 'worktrees', card.identifier);
         ensureWorktree(project.path, worktree, card.branchName, base);
@@ -336,6 +340,10 @@ export async function runCard(card, trigger, workflowName, workflow, project, rc
     }
     finally {
         active = null;
+        // Share whatever notes the agents wrote, whatever the outcome.
+        const shared = syncMemory(rc.selfCommand, rc.configDir);
+        if (shared)
+            say(shared);
     }
 }
 // A scheduled run's stand-in for a card: the task, on a branch of its own.

package/dist/types.d.ts

@@ -40,6 +40,7 @@ export type ToolCommand = (args: string[], ctx: ToolContext) => Promise<number>;
 export interface Tool {
     name: string;
     summary: string;
+    contract?: number;
     install(ctx: ToolContext): Promise<void>;
     uninstall(ctx: ToolContext): Promise<void>;
     checks(ctx: ToolContext): Promise<Check[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidlabs.gg/voidshift-agents",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "description": "Agents for Claude Code and Codex that plan, build and QA Linear cards, chained and run in the background.",
   "license": "Apache-2.0",
   "repository": {