harnery 0.8.0 → 0.10.0

package/dist/lib/identities/index.js

@@ -24,22 +24,22 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFile
 import { resolve } from "node:path";
 import { monorepoRoot } from "../../core/agents/index.js";
 export const IDENTITY_SCHEMA_VERSION = 1;
-function identitiesDir() {
-    const root = monorepoRoot();
+function identitiesDir(coordRoot) {
+    const root = coordRoot ?? monorepoRoot();
     if (!root)
         return null;
     return resolve(root, ".harnery", "identities");
 }
-function ensureDir() {
-    const dir = identitiesDir();
+function ensureDir(coordRoot) {
+    const dir = identitiesDir(coordRoot);
     if (!dir)
         throw new Error("not in an agent session; no monorepo root");
     if (!existsSync(dir))
         mkdirSync(dir, { recursive: true });
     return dir;
 }
-function identityPath(agentId) {
-    return resolve(ensureDir(), `${agentId}.json`);
+function identityPath(agentId, coordRoot) {
+    return resolve(ensureDir(coordRoot), `${agentId}.json`);
 }
 function nowIso() {
     return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -66,8 +66,8 @@ export function displayName(name) {
     return name.startsWith("agent-") ? name : `agent-${name}`;
 }
 /** Read one identity by id. Null if missing. */
-export function lookupById(agentId) {
-    const dir = identitiesDir();
+export function lookupById(agentId, coordRoot) {
+    const dir = identitiesDir(coordRoot);
     if (!dir)
         return null;
     const fp = resolve(dir, `${agentId}.json`);
@@ -77,8 +77,8 @@ export function lookupById(agentId) {
 }
 /** Read one identity by display name (case-insensitive on bare name).
  * Scans the directory; O(N) on identity count. */
-export function lookupByName(name) {
-    const dir = identitiesDir();
+export function lookupByName(name, coordRoot) {
+    const dir = identitiesDir(coordRoot);
     if (!dir || !existsSync(dir))
         return null;
     const wanted = bareName(name).toLowerCase();
@@ -98,8 +98,8 @@ export function lookupByName(name) {
     return null;
 }
 /** All known identities, sorted by created_at ascending. */
-export function listIdentities() {
-    const dir = identitiesDir();
+export function listIdentities(coordRoot) {
+    const dir = identitiesDir(coordRoot);
     if (!dir || !existsSync(dir))
         return [];
     const out = [];
@@ -123,8 +123,8 @@ export function listIdentities() {
  * surface whichever happened to be read first; the second is orphaned.
  * For agent personas (added at human cadence) this race is theoretical.
  */
-export function ensureIdentity(name) {
-    const existing = lookupByName(name);
+export function ensureIdentity(name, coordRoot) {
+    const existing = lookupByName(name, coordRoot);
     if (existing)
         return existing;
     const id = {
@@ -134,13 +134,13 @@ export function ensureIdentity(name) {
         aliases: [],
         created_at: nowIso(),
     };
-    writeIdentity(id);
+    writeIdentity(id, coordRoot);
     return id;
 }
 /** Persist an identity (tmp + rename). Creates the dir if missing. */
-export function writeIdentity(id) {
-    ensureDir();
-    const fp = identityPath(id.agent_id);
+export function writeIdentity(id, coordRoot) {
+    ensureDir(coordRoot);
+    const fp = identityPath(id.agent_id, coordRoot);
     const tmp = `${fp}.tmp.${process.pid}`;
     writeFileSync(tmp, `${JSON.stringify(id, null, 2)}\n`, "utf8");
     renameSync(tmp, fp);
@@ -150,8 +150,8 @@ export function writeIdentity(id) {
  * lookup still resolves correctly. The agent_id is stable across renames,
  * which is the whole point of the registry.
  */
-export function renameIdentity(agentId, newName) {
-    const existing = lookupById(agentId);
+export function renameIdentity(agentId, newName, coordRoot) {
+    const existing = lookupById(agentId, coordRoot);
     if (!existing) {
         throw new Error(`renameIdentity: no identity matching '${agentId}'`);
     }
@@ -163,7 +163,7 @@ export function renameIdentity(agentId, newName) {
         name: bare,
         aliases: [...existing.aliases, { name: existing.name, retired_at: nowIso() }],
     };
-    writeIdentity(next);
+    writeIdentity(next, coordRoot);
     return next;
 }
 /**
@@ -175,16 +175,16 @@ export function renameIdentity(agentId, newName) {
  * Does NOT mint. Callers that want mint-on-miss should call ensureIdentity()
  * with a name, then use the returned agent_id.
  */
-export function resolveAgentId(input) {
+export function resolveAgentId(input, coordRoot) {
     const trimmed = input.trim();
     if (!trimmed)
         return null;
     // UUID shape check, relaxed; we only need the lookupById to confirm.
     if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(trimmed)) {
-        const byId = lookupById(trimmed);
+        const byId = lookupById(trimmed, coordRoot);
         if (byId)
             return byId.agent_id;
     }
-    const byName = lookupByName(trimmed);
+    const byName = lookupByName(trimmed, coordRoot);
     return byName ? byName.agent_id : null;
 }

package/dist/lib/instructions/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/lib/instructions/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,sEAAsE;AACtE,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAA6C,GACpD,MAAM,CA+CR;AAID,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAsKD,eAAO,MAAM,MAAM,EAAE,aAAa,EA4BjC,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/lib/instructions/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,sEAAsE;AACtE,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAA6C,GACpD,MAAM,CA4DR;AAID,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAsKD,eAAO,MAAM,MAAM,EAAE,aAAa,EA4BjC,CAAC"}

package/dist/lib/instructions/templates.js

@@ -10,6 +10,7 @@
  * files), so they compile into `dist/` and resolve identically under Bun and
  * Node — no `files`-field copy or package-path guesswork.
  */
+import { SCRATCH_CATEGORIES } from "../../core/scratch/index.js";
 import { buildOwnedSkill } from "./splice.js";
 /** Managed-region name for the AGENTS.md orientation block. */
 export const INSTRUCTIONS_REGION = "instructions";
@@ -39,6 +40,12 @@ export function renderInstructionsBlock(binName, skills = { decide: true, counci
     const councilPointer = skills.council
         ? "The `harn-council` skill has the steward and member flow."
         : `See \`${b} council --help\` for the steward and member flow.`;
+    // Render the scratch categories from the canonical enum so this prose can
+    // never drift from what `scratch add` actually accepts (the "note, plan…" list
+    // silently lagged the tool by two categories before this).
+    const scratchCats = SCRATCH_CATEGORIES.length > 1
+        ? `${SCRATCH_CATEGORIES.slice(0, -1).join(", ")}, or ${SCRATCH_CATEGORIES.at(-1)}`
+        : SCRATCH_CATEGORIES[0];
     return `## harnery coordination
 
 This project runs [harnery](https://harnery.com) for multi-agent coordination.
@@ -52,13 +59,19 @@ active peers and the files they've claimed; \`${b} agents set-task "<focus>"\`
 declares your current focus so peers can see it. Check for peers before editing
 widely-shared files.
 
+**Durable role handoff.** When you are replacing a prior session in the same
+named role, run \`${b} agents identity assume <name>\` before declaring your task.
+It reclaims an abandoned namesake (no live process) and refuses only when another
+live process still holds the name; never hand-edit Harnery's history, heartbeat,
+or derived identity cache.
+
 **Declare intent on shell commands.** Every command you run is captured to the
 coordination ledger. Lead a shell command with a \`# intent: <why>\` comment (or set
 the tool's description) so the recorded event carries a reason instead of
 \`(no intent)\`.
 
-**Scratch journal.** \`${b} scratch add <category> "<text>"\` (category = note, plan,
-decision, blocker, or handoff) leaves breadcrumbs that survive context compaction;
+**Scratch journal.** \`${b} scratch add <category> "<text>"\` (category = ${scratchCats})
+leaves breadcrumbs that survive context compaction;
 \`${b} scratch read\` reads yours, \`${b} scratch read --name <peer>\` reads a peer's.
 Use it for anything future-you or a peer will need to pick up your thread.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnery",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Multi-agent coordination for AI coding agents - Claude Code, Cursor, and Codex.",
   "license": "MIT",
   "author": "Ryan Kelly",
@@ -52,6 +52,16 @@
       "types": "./dist/core/hooks/index.d.ts",
       "import": "./dist/core/hooks/index.js"
     },
+    "./core/harnesses": {
+      "bun": "./src/core/harnesses/index.ts",
+      "types": "./dist/core/harnesses/index.d.ts",
+      "import": "./dist/core/harnesses/index.js"
+    },
+    "./core/context": {
+      "bun": "./src/core/context/index.ts",
+      "types": "./dist/core/context/index.d.ts",
+      "import": "./dist/core/context/index.js"
+    },
     "./lib/agent-browser": {
       "bun": "./src/lib/agent-browser/index.ts",
       "types": "./dist/lib/agent-browser/index.d.ts",
@@ -129,6 +139,7 @@
     "typecheck": "bun x tsc --noEmit",
     "lint": "bun x @biomejs/biome check src",
     "check:portability": "bun run scripts/check-portability.ts",
+    "check:public-surface": "bun run scripts/check-public-surface.ts",
     "check:layering": "bun run scripts/check-layering.ts",
     "lint:fix": "bun x @biomejs/biome check --write src",
     "format": "bun x @biomejs/biome format --write src",

package/schemas/config.schema.json

@@ -31,12 +31,7 @@
           "type": "integer",
           "minimum": 30,
           "default": 600,
-          "description": "How stale a peer heartbeat can get before the sweeper prunes it."
-        },
-        "name_pool": {
-          "type": "string",
-          "default": "default",
-          "description": "Which agent-name pool to draw from. 'default' / 'hurricane' / a custom pool id."
+          "description": "How stale a peer heartbeat can get before the sweeper prunes it. Env override: HARNERY_AGENT_COORD_FRESHNESS."
         }
       }
     },
@@ -48,7 +43,7 @@
           "type": "integer",
           "minimum": 1024,
           "maximum": 65535,
-          "default": 7777,
+          "default": 9000,
           "description": "Port that `harn web up` binds to."
         },
         "bind": {
@@ -77,35 +72,109 @@
         }
       }
     },
+    "tools": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Managed-tool provisioning consent.",
+      "properties": {
+        "ripgrep": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "autoInstall": {
+              "type": "boolean",
+              "default": false,
+              "description": "Allow `grep` to download the pinned, checksum-verified ripgrep into the harnery tools dir on first miss. Env override: HARNERY_TOOLS_AUTOINSTALL=1|0."
+            }
+          }
+        }
+      }
+    },
+    "workflow": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "subscriptionOnly": {
+          "type": "boolean",
+          "default": false,
+          "description": "Pin `workflow run` to subscription billing: API-key vars are scrubbed from every child env. Stamped true by `harn init` when the key is absent. Env override: HARNERY_WORKFLOW_SUBSCRIPTION_ONLY=1|0."
+        }
+      }
+    },
+    "skills": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "exclude": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": [],
+          "description": "Shipped harnery skills this repo suppresses (e.g. because it maintains richer host-specific versions)."
+        }
+      }
+    },
+    "presence": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Cross-machine session presence (decision record 0016).",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Presence over git refs (refs/harnery/presence/<machine> on origin). On by default when an origin remote exists; fail-silent everywhere. Env override: HARNERY_PRESENCE=1|0."
+        },
+        "relay": {
+          "type": "string",
+          "description": "Optional live-socket upgrade: a wss:// relay URL (public reference: wss://relay.harnery.com; self-host via `harn relay serve` or relay/worker/). Hooks keep a per-machine daemon connected; git refs stay on as the floor. Env override: HARNERY_PRESENCE_RELAY=<url|0>."
+        }
+      }
+    },
     "backup": {
       "type": "object",
       "additionalProperties": false,
+      "description": "`harn backup` (restic) defaults. Env overrides: HARNERY_RESTIC_REPO, HARNERY_RESTIC_PASSWORD_FILE. `harn backup` is manual (init/snapshot/prune/...); there is no auto-snapshot scheduler.",
       "properties": {
         "repo": {
           "type": "string",
-          "description": "restic repository URL. Common: 'rclone:gdrive:harnery-backup/<project>' for Google Drive."
+          "description": "restic repository path or URL. Default: ~/.cache/harnery/restic-repo. Common remote form: 'rclone:gdrive:harnery-backup/<project>'."
         },
-        "schedule": {
+        "password_file": {
           "type": "string",
-          "enum": ["off", "daily", "hourly"],
-          "default": "off",
-          "description": "Auto-snapshot cadence. 'off' = manual only."
+          "description": "File holding the restic repo password. Default: ~/.config/harnery/restic-password (autogenerated on `harn backup init`)."
+        },
+        "keep_daily": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 7,
+          "description": "Daily snapshots to keep on `harn backup prune` (overridable per run with --keep-daily)."
+        },
+        "keep_weekly": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 4,
+          "description": "Weekly snapshots to keep on `harn backup prune` (overridable with --keep-weekly)."
+        },
+        "keep_monthly": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 6,
+          "description": "Monthly snapshots to keep on `harn backup prune` (overridable with --keep-monthly)."
         }
       }
     },
     "sync": {
       "type": "object",
       "additionalProperties": false,
+      "description": "`harn sync` (rclone) defaults for the curated cross-machine subset (identities/, scratch/archived/, councils/). Env overrides: HARNERY_SYNC_REMOTE, HARNERY_SYNC_PREFIX. `harn sync init` also records these in ~/.config/harnery/sync.json (a lower-precedence fallback than this section).",
       "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false,
-          "description": "Enable cross-machine sync via Google Drive."
+        "remote": {
+          "type": "string",
+          "description": "rclone remote name (e.g. 'gdrive'). Set up the remote with `rclone config`; harnery doesn't wrap the OAuth flow."
         },
-        "drive_folder": {
+        "prefix": {
           "type": "string",
-          "default": "harnery-sync",
-          "description": "Folder name in Google Drive that holds the synced subset."
+          "default": "harnery",
+          "description": "Subpath under the rclone remote root that holds the synced subset."
         }
       }
     }

package/src/commander.ts

@@ -23,6 +23,7 @@ import { registerBackupCommand } from "./commands/backup.ts";
 import { registerBrowseCommand } from "./commands/browse.ts";
 import { registerBrowseAiCommand } from "./commands/browse-ai.ts";
 import { registerCallersCommand } from "./commands/callers.ts";
+import { registerClaudeDesktopCommand } from "./commands/claude-desktop.ts";
 import { registerCompletionCommand } from "./commands/completion.ts";
 import { registerConfigGetCommand } from "./commands/config-get.ts";
 import { registerContextCommand } from "./commands/context.ts";
@@ -38,10 +39,12 @@ import { registerEnvCommand } from "./commands/env.ts";
 import { registerFetchCommand } from "./commands/fetch.ts";
 import { registerFileHistoryCommand } from "./commands/file-history.ts";
 import { registerGrepCommand } from "./commands/grep.ts";
+import { registerHarnessCommand } from "./commands/harness.ts";
 import { registerInitCommand } from "./commands/init.ts";
 import { registerOutlineCommand } from "./commands/outline.ts";
 import { registerPresenceCommand } from "./commands/presence.ts";
 import { registerReadCommand } from "./commands/read.ts";
+import { registerRelayCommand } from "./commands/relay.ts";
 import { registerScratchCommand } from "./commands/scratch.ts";
 import { registerSessionCommand } from "./commands/session.ts";
 import { registerSyncCommand } from "./commands/sync.ts";
@@ -49,6 +52,7 @@ import { registerSectionCommand, registerTocCommand } from "./commands/toc.ts";
 import { registerTokensCommand } from "./commands/tokens.ts";
 import { registerTunnelCommand } from "./commands/tunnel.ts";
 import { registerWebCommand } from "./commands/web.ts";
+import { registerWorkflowCommand } from "./commands/workflow.ts";
 
 export interface HarneryContextOpts {
   /**
@@ -250,6 +254,7 @@ export function createHarneryProgram(opts: HarneryContextOpts = {}): Command {
   registerEmlCommand(program, emit);
   registerEnvCommand(program, emit, opts.context);
   registerPresenceCommand(program, emit);
+  registerRelayCommand(program, emit);
   registerConfigGetCommand(program, emit);
   registerFileHistoryCommand(program, emit);
   registerOutlineCommand(program, emit);
@@ -258,6 +263,7 @@ export function createHarneryProgram(opts: HarneryContextOpts = {}): Command {
   registerCallersCommand(program, emit, opts.context);
   registerEditBatchCommand(program, emit);
   registerGrepCommand(program, emit, opts.context);
+  registerHarnessCommand(program, emit);
   registerCookiesCommand(program, emit);
   registerFetchCommand(program, emit, opts.context);
   registerReadCommand(program, emit);
@@ -276,7 +282,9 @@ export function createHarneryProgram(opts: HarneryContextOpts = {}): Command {
   registerInitCommand(program, emit, opts.binName);
   registerDeinitCommand(program, emit, opts.binName);
   registerBackupCommand(program, emit);
+  registerClaudeDesktopCommand(program, emit);
   registerSyncCommand(program, emit);
+  registerWorkflowCommand(program, emit);
   if (include("web")) registerWebCommand(program, emit);
 
   return program;