harnery 0.30.0 → 0.31.0

package/dist/commands/init.d.ts

@@ -5,11 +5,11 @@
  * if skipped):
  *   1. Create the `.harnery/` coord root; without it `findCoordRoot` returns
  *      null and every hook no-ops forever.
- *   2. Register the agent-hook entries in the harness settings file.
+ *   2. Register the agent-hook entries in the adapter settings file.
  *
- * Wires whichever harness `--harness` names (Claude Code `.claude/settings.json`,
- * Cursor `.cursor/hooks.json`, or Codex `.codex/hooks.json`): the per-harness
- * file path, event list, and hook-entry shape all come from HARNESS_SPECS.
+ * Wires whichever adapter `--adapter` names (Claude Code `.claude/settings.json`,
+ * Cursor `.cursor/hooks.json`, or Codex `.codex/hooks.json`): the per-adapter
+ * file path, event list, and hook-entry shape all come from ADAPTER_SPECS.
  *
  * `harn init` does both, non-destructively: it merges hook entries into an
  * existing settings file (preserving any other hooks) and skips entries that are
@@ -17,23 +17,23 @@
  */
 import type { Command } from "commander";
 import type { EmitContext } from "../commander.js";
-import { type HarnessId, type HarnessSpec } from "../core/hooks/harness/events.js";
-import { type HookGroup, type SettingsFile } from "../core/hooks/harness/wiring.js";
+import { type AdapterId, type AdapterSpec } from "../core/hooks/adapter/events.js";
+import { type HookGroup, type SettingsFile } from "../core/hooks/adapter/wiring.js";
 export type { HookGroup, SettingsFile };
 export declare function registerInitCommand(program: Command, emit: EmitContext, binName?: string): void;
 /**
- * Merge agent-hook entries into a harness settings object in place, idempotently.
+ * Merge agent-hook entries into a adapter settings object in place, idempotently.
  * Preserves every existing hook; rewrites events already wired to
  * `agent-hook <subcommand>` when their command string is stale (e.g. an older
- * harnery wired a bare relative path). Honors the harness's entry shape
+ * harnery wired a bare relative path). Honors the adapter's entry shape
  * (Claude/Codex nest under an inner `hooks` array; Cursor uses a flat
- * `{ command }`) and ensures the root `version` key when the harness requires
+ * `{ command }`) and ensures the root `version` key when the adapter requires
  * one. Pure (no fs/git) so it's unit-testable.
  *
  * The trailing space in the match (`agent-hook ${subcommand} `) is load-bearing:
  * it keeps `stop` from matching `stop-failure`.
  */
-export declare function wireHooks(settings: SettingsFile, spec: HarnessSpec, agentHookPath: string, harness: HarnessId): {
+export declare function wireHooks(settings: SettingsFile, spec: AdapterSpec, agentHookPath: string, adapter: AdapterId): {
     wired: number;
     already: number;
     removed: number;
@@ -45,8 +45,8 @@ export declare function wireHooks(settings: SettingsFile, spec: HarnessSpec, age
  * contains `agent-hook ` (the trailing space matches `agent-hook <subcommand>`),
  * so any non-harnery hook the consumer added is preserved. Emptied
  * `hooks[settingsKey]` arrays are dropped; an emptied `hooks` object is dropped
- * entirely. Harness-agnostic (scans every key) so it removes entries left by any
- * harness. Pure (no fs) so it's unit-testable. Returns the count removed and the
+ * entirely. Adapter-agnostic (scans every key) so it removes entries left by any
+ * adapter. Pure (no fs) so it's unit-testable. Returns the count removed and the
  * count of non-harnery hooks left behind.
  */
 export declare function unwireHooks(settings: SettingsFile): {

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAKzC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAYxC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAiI/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAqCvE;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmB1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmDhG;AASD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkCxF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AAUzC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAYxC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CA4I/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAqCvE;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmB1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmDhG;AASD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkCxF"}

package/dist/commands/init.js

@@ -5,11 +5,11 @@
  * if skipped):
  *   1. Create the `.harnery/` coord root; without it `findCoordRoot` returns
  *      null and every hook no-ops forever.
- *   2. Register the agent-hook entries in the harness settings file.
+ *   2. Register the agent-hook entries in the adapter settings file.
  *
- * Wires whichever harness `--harness` names (Claude Code `.claude/settings.json`,
- * Cursor `.cursor/hooks.json`, or Codex `.codex/hooks.json`): the per-harness
- * file path, event list, and hook-entry shape all come from HARNESS_SPECS.
+ * Wires whichever adapter `--adapter` names (Claude Code `.claude/settings.json`,
+ * Cursor `.cursor/hooks.json`, or Codex `.codex/hooks.json`): the per-adapter
+ * file path, event list, and hook-entry shape all come from ADAPTER_SPECS.
  *
  * `harn init` does both, non-destructively: it merges hook entries into an
  * existing settings file (preserving any other hooks) and skips entries that are
@@ -20,27 +20,28 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { DEFAULT_BIN_NAME, pinnedBinName, stripJsonComments } from "../core/config.js";
-import { HARNESS_SPECS } from "../core/hooks/harness/events.js";
-import { commandWiresSubcommand, groupCommands, makeEntry, } from "../core/hooks/harness/wiring.js";
-import { applyInstructions, checkInstructions } from "../lib/instructions/apply.js";
+import { ADAPTER_SPECS } from "../core/hooks/adapter/events.js";
+import { commandWiresSubcommand, groupCommands, makeEntry, } from "../core/hooks/adapter/wiring.js";
+import { applyInstructions, checkInstructions, } from "../lib/instructions/apply.js";
+import { HostAddendumError } from "../lib/instructions/host-addendum.js";
 // This file is src/commands/init.ts → harnery package root is two levels up.
 const HARNERY_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
 export function registerInitCommand(program, emit, binName) {
     program
         .command("init")
-        .description("Bootstrap harnery in this project: create .harnery/, wire the harness " +
+        .description("Bootstrap harnery in this project: create .harnery/, wire the adapter " +
         "hooks, and inject the agent-facing instructions block + skills " +
         "(idempotent; safe to re-run). Use --dry-run to preview, --check to " +
         "report drift without writing (exit 0 fresh / 2 drift / 1 error).")
-        .option("--harness <id>", "claude-code | cursor | codex", "claude-code")
+        .option("--adapter <id>", "claude-code | cursor | codex", "claude-code")
         .option("--dry-run", "Show what would change without writing")
         .option("--check", "Report instructions/skills drift without writing; exit 0/2/1")
         .option("--project-root <path>", "Project root (default: git toplevel, else cwd)")
         .action((opts) => {
-        const harness = opts.harness;
-        const spec = HARNESS_SPECS[harness];
+        const adapter = opts.adapter;
+        const spec = ADAPTER_SPECS[adapter];
         if (!spec) {
-            emit.text(`Unknown harness '${opts.harness}'. Expected: claude-code | cursor | codex.`);
+            emit.text(`Unknown adapter '${opts.adapter}'. Expected: claude-code | cursor | codex.`);
             emit.setExitCode(1);
             return;
         }
@@ -53,7 +54,7 @@ export function registerInitCommand(program, emit, binName) {
         const bin = pinnedBinName(projectRoot) ?? (binName?.trim() ? binName : DEFAULT_BIN_NAME);
         // ── --check: read-only drift report on the block + skills ──────────────
         if (opts.check === true) {
-            const { status, issues } = checkInstructions(projectRoot, { binName: bin, harness });
+            const { status, issues } = checkInstructions(projectRoot, { binName: bin, adapter });
             const head = status === "fresh"
                 ? "harn init --check: instructions + skills are current"
                 : status === "drift"
@@ -94,7 +95,7 @@ export function registerInitCommand(program, emit, binName) {
         }
         // ── 1c. workflow billing default ───────────────────────────────────────
         // Every init'd project gets `workflow.subscriptionOnly: true`: workflow
-        // children ride the logged-in (subscription) harness auth, and the pin
+        // children ride the logged-in (subscription) adapter auth, and the pin
         // makes per-token API billing structurally impossible unless the project
         // deliberately flips it. A committed `workflow` key of any shape is a
         // deliberate choice and is never touched.
@@ -103,7 +104,7 @@ export function registerInitCommand(program, emit, binName) {
             if (stamp)
                 actions.push(stamp);
         }
-        // ── 2. harness hooks ───────────────────────────────────────────────────
+        // ── 2. adapter hooks ───────────────────────────────────────────────────
         const settingsPath = resolve(projectRoot, spec.settingsFile);
         const agentHook = relative(projectRoot, resolve(HARNERY_ROOT, "bin", "agent-hook"));
         let settings;
@@ -121,9 +122,9 @@ export function registerInitCommand(program, emit, binName) {
         else {
             settings = {};
         }
-        const { wired, already, removed, upgraded } = wireHooks(settings, spec, agentHook, harness);
+        const { wired, already, removed, upgraded } = wireHooks(settings, spec, agentHook, adapter);
         if (wired === 0 && removed === 0 && upgraded === 0) {
-            actions.push(`· all ${spec.events.length} ${harness} hooks already wired in ${rel(projectRoot, settingsPath)}`);
+            actions.push(`· all ${spec.events.length} ${adapter} hooks already wired in ${rel(projectRoot, settingsPath)}`);
         }
         else if (dryRun) {
             actions.push(`+ would wire ${wired} hook(s), upgrade ${upgraded} stale command(s), and remove ` +
@@ -136,24 +137,37 @@ export function registerInitCommand(program, emit, binName) {
                 `${removed} legacy hook(s) in ${rel(projectRoot, settingsPath)} (${already} already present)`);
         }
         // ── 3. agent-facing instructions block + skills ────────────────────────
-        const applied = applyInstructions(projectRoot, { binName: bin, harness, dryRun });
+        // A misconfigured host addendum aborts here rather than half-writing: the
+        // apply step validates the configured source before it touches a file, so
+        // a bad path leaves the repo exactly as it found it.
+        let applied;
+        try {
+            applied = applyInstructions(projectRoot, { binName: bin, adapter, dryRun });
+        }
+        catch (err) {
+            if (!(err instanceof HostAddendumError))
+                throw err;
+            emit.text(`${bin} init: ${err.message}`);
+            emit.setExitCode(1);
+            return;
+        }
         actions.push(...applied.actions);
         emit.text(render(projectRoot, dryRun, actions, applied.warnings));
     });
 }
 /**
- * Merge agent-hook entries into a harness settings object in place, idempotently.
+ * Merge agent-hook entries into a adapter settings object in place, idempotently.
  * Preserves every existing hook; rewrites events already wired to
  * `agent-hook <subcommand>` when their command string is stale (e.g. an older
- * harnery wired a bare relative path). Honors the harness's entry shape
+ * harnery wired a bare relative path). Honors the adapter's entry shape
  * (Claude/Codex nest under an inner `hooks` array; Cursor uses a flat
- * `{ command }`) and ensures the root `version` key when the harness requires
+ * `{ command }`) and ensures the root `version` key when the adapter requires
  * one. Pure (no fs/git) so it's unit-testable.
  *
  * The trailing space in the match (`agent-hook ${subcommand} `) is load-bearing:
  * it keeps `stop` from matching `stop-failure`.
  */
-export function wireHooks(settings, spec, agentHookPath, harness) {
+export function wireHooks(settings, spec, agentHookPath, adapter) {
     if (spec.rootVersion !== undefined && settings.version === undefined) {
         settings.version = spec.rootVersion;
     }
@@ -173,7 +187,7 @@ export function wireHooks(settings, spec, agentHookPath, harness) {
             settings.hooks[settingsKey] = kept;
     }
     for (const { settingsKey, subcommand } of spec.events) {
-        const command = hookCommand(spec, agentHookPath, subcommand, harness);
+        const command = hookCommand(spec, agentHookPath, subcommand, adapter);
         const groups = settings.hooks[settingsKey] ?? [];
         let present = false;
         for (const group of groups) {
@@ -192,18 +206,18 @@ export function wireHooks(settings, spec, agentHookPath, harness) {
     return { wired, already, removed, upgraded };
 }
 /**
- * The canonical hook command for one event. When the harness exports a
+ * The canonical hook command for one event. When the adapter exports a
  * project-dir env var to hook processes (Claude Code's CLAUDE_PROJECT_DIR),
  * anchor the agent-hook path on it: hook processes inherit the session
  * shell's cwd, which follows `cd` away from the project root — a bare
  * relative path silently fails to spawn from there (no events, no image
- * capture, no guards). `:-.` keeps the command working on harness versions
+ * capture, no guards). `:-.` keeps the command working on adapter versions
  * that don't set the var. Only the env expansion is quoted so the
  * `agent-hook <subcommand> ` wiring match stays byte-identical.
  */
-function hookCommand(spec, agentHookPath, subcommand, harness) {
+function hookCommand(spec, agentHookPath, subcommand, adapter) {
     const anchor = spec.projectDirEnv ? `"\${${spec.projectDirEnv}:-.}"/` : "";
-    return `bash ${anchor}${agentHookPath} ${subcommand} --harness ${harness}`;
+    return `bash ${anchor}${agentHookPath} ${subcommand} --adapter ${adapter}`;
 }
 /**
  * Rewrite any harnery-owned command for `subcommand` inside one hook group to
@@ -242,8 +256,8 @@ function rewriteStaleCommands(group, subcommand, canonical, onPresent) {
  * contains `agent-hook ` (the trailing space matches `agent-hook <subcommand>`),
  * so any non-harnery hook the consumer added is preserved. Emptied
  * `hooks[settingsKey]` arrays are dropped; an emptied `hooks` object is dropped
- * entirely. Harness-agnostic (scans every key) so it removes entries left by any
- * harness. Pure (no fs) so it's unit-testable. Returns the count removed and the
+ * entirely. Adapter-agnostic (scans every key) so it removes entries left by any
+ * adapter. Pure (no fs) so it's unit-testable. Returns the count removed and the
  * count of non-harnery hooks left behind.
  */
 export function unwireHooks(settings) {
@@ -334,7 +348,7 @@ export function stampBinName(configPath, binName, dryRun) {
     return `+ added binName "${binName}" to ${rel(configPath)}`;
 }
 /** The commented workflow-billing default block init stamps into config.jsonc. */
-const WORKFLOW_DEFAULT_BLOCK = `  // Workflow children ride the logged-in (subscription) harness auth; this pin\n` +
+const WORKFLOW_DEFAULT_BLOCK = `  // Workflow children ride the logged-in (subscription) adapter auth; this pin\n` +
     `  // scrubs API-key vars from child envs so runs can never bill per-token rates.\n` +
     `  // Key-only hosts (CI): set false, or HARNERY_WORKFLOW_SUBSCRIPTION_ONLY=0.\n` +
     `  "workflow": { "subscriptionOnly": true }`;

package/dist/commands/{session.d.ts → journal.d.ts}

@@ -1,4 +1,4 @@
 import type { Command } from "commander";
 import type { EmitContext } from "../commander.js";
-export declare function registerSessionCommand(program: Command, emitParam: EmitContext): void;
-//# sourceMappingURL=session.d.ts.map
+export declare function registerJournalCommand(program: Command, emitParam: EmitContext): void;
+//# sourceMappingURL=journal.d.ts.map

package/dist/commands/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/commands/journal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA6BnD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CA2RrF"}

package/dist/commands/{scratch.js → journal.js}

@@ -1,30 +1,30 @@
 import { existsSync, readdirSync, readFileSync, statSync, unlinkSync, watch } from "node:fs";
 import { resolve as resolvePath } from "node:path";
-import { emitCanonical, normalizeHarness, readHeartbeat } from "../core/agents/index.js";
+import { emitCanonical, normalizeAdapter, readHeartbeat } from "../core/agents/index.js";
 import { resolveBinName } from "../core/config.js";
-import { appendEntry, archiveScratch, currentOwnerOrThrow, lintScratch, listArchives, loadScratch, parseScratch, pruneArchives, resolveOwnerByName, SCRATCH_CATEGORIES, scratchDir, scratchPath, sweepOrphanScratchpads, } from "../core/scratch/index.js";
+import { appendEntry, archiveJournal, currentOwnerOrThrow, JOURNAL_CATEGORIES, journalDir, journalPath, lintJournal, listArchives, loadJournal, parseJournal, pruneArchives, resolveOwnerByName, sweepOrphanJournals, } from "../core/journal/index.js";
 /**
- * `harn scratch`: per-agent markdown journal at `.harnery/scratch/<instance_id>.md`.
+ * `harn journal`: per-agent markdown journal at `.harnery/journal/<instance_id>.md`.
  * Used both for self-notes (surviving compaction) and peer coordination (other
  * agents pull-read it on demand). SessionEnd hook archives; SessionStart
  * janitor surfaces the most-recent archive as a recovery cue.
  */
 let emit;
-export function registerScratchCommand(program, emitParam) {
+export function registerJournalCommand(program, emitParam) {
     emit = emitParam;
     const root = program
-        .command("scratch")
+        .command("journal")
         .description("Per-agent markdown journal: append-only timestamped entries. " +
         "Survives in-session compaction, archived at session end, pruned after 7 days.");
     // ── add ───────────────────────────────────────────────────────────────
     root
         .command("add <category> <text...>")
-        .description(`Append an entry to my scratchpad. Category: ${SCRATCH_CATEGORIES.join(" | ")}`)
+        .description(`Append an entry to my journal. Category: ${JOURNAL_CATEGORIES.join(" | ")}`)
         .action((category, text) => {
         const cat = validateCategory(category);
         const body = text.join(" ");
         if (!body.trim()) {
-            emit.error({ code: "empty_body", message: "scratch add: body is empty" });
+            emit.error({ code: "empty_body", message: "journal add: body is empty" });
             process.exit(1);
         }
         try {
@@ -32,10 +32,10 @@ export function registerScratchCommand(program, emitParam) {
             const doc = appendEntry(owner, cat, body);
             const hb = readHeartbeat(owner);
             emitCanonical({
-                type: "state.scratch_append",
+                type: "state.journal_append",
                 owner,
                 session: hb?.session_id ?? owner,
-                harness: normalizeHarness(hb?.platform),
+                adapter: normalizeAdapter(hb?.platform),
                 data: {
                     category: cat,
                     body_summary: body.length > 1000 ? `${body.slice(0, 997)}...` : body,
@@ -58,8 +58,8 @@ export function registerScratchCommand(program, emitParam) {
     // ── read ──────────────────────────────────────────────────────────────
     root
         .command("read")
-        .description("Render a scratchpad to stdout. No --name: my own. With --name: a peer's.")
-        .option("--name <name>", "Read the named peer's scratchpad (case-insensitive)")
+        .description("Render a journal to stdout. No --name: my own. With --name: a peer's.")
+        .option("--name <name>", "Read the named peer's journal (case-insensitive)")
         .option("--owner <id>", "Read by instance_id directly")
         .option("--archive <basename>", "Read an archive file (e.g. <owner>-<ts>.md)")
         .option("--limit <n>", "Cap entries rendered (newest first)", "50")
@@ -75,8 +75,8 @@ export function registerScratchCommand(program, emitParam) {
     // ── list ──────────────────────────────────────────────────────────────
     root
         .command("list")
-        .description("Summarize all active scratchpads + archive count")
-        .option("--archives", "List archive files instead of active scratchpads")
+        .description("Summarize all active journals + archive count")
+        .option("--archives", "List archive files instead of active journals")
         .action((opts) => {
         try {
             if (opts.archives) {
@@ -97,13 +97,13 @@ export function registerScratchCommand(program, emitParam) {
                 emit.data({ rows: items });
                 return;
             }
-            const dir = scratchDir();
+            const dir = journalDir();
             const rows = [];
             for (const f of readdirSync(dir)) {
                 if (!f.endsWith(".md"))
                     continue;
                 const instanceId = f.replace(/\.md$/, "");
-                const doc = loadScratch(instanceId);
+                const doc = loadJournal(instanceId);
                 if (!doc)
                     continue;
                 rows.push({
@@ -126,28 +126,28 @@ export function registerScratchCommand(program, emitParam) {
     // ── tail ──────────────────────────────────────────────────────────────
     root
         .command("tail")
-        .description("Follow my scratchpad (or a peer's) for new entries.")
-        .option("--name <name>", "Tail the named peer's scratchpad")
+        .description("Follow my journal (or a peer's) for new entries.")
+        .option("--name <name>", "Tail the named peer's journal")
         .option("--owner <id>", "Tail by instance_id directly")
         .action(async (opts) => {
         try {
             const owner = resolveTargetOwner(opts);
-            const path = scratchPath(owner);
+            const path = journalPath(owner);
             if (!existsSync(path)) {
-                emit.error({ code: "no_scratchpad", message: `no scratchpad at ${path} yet` });
+                emit.error({ code: "no_journal", message: `no journal at ${path} yet` });
                 process.exit(1);
             }
             process.stderr.write(`tailing ${path}\n`); // lint-ok-emission: tail banner, immediate stderr flush before streaming
             let lastSize = statSync(path).size;
             // Print initial render
-            process.stdout.write(`${renderScratch(loadScratch(owner), 10)}\n`); // lint-ok-emission: streaming tail body
+            process.stdout.write(`${renderJournal(loadJournal(owner), 10)}\n`); // lint-ok-emission: streaming tail body
             const w = watch(path, { persistent: true }, () => {
                 try {
                     const curr = statSync(path).size;
                     if (curr === lastSize)
                         return;
                     lastSize = curr;
-                    const doc = loadScratch(owner);
+                    const doc = loadJournal(owner);
                     if (!doc)
                         return;
                     const newest = doc.entries[0];
@@ -177,7 +177,7 @@ export function registerScratchCommand(program, emitParam) {
     // ── clear ─────────────────────────────────────────────────────────────
     root
         .command("clear")
-        .description("Delete my scratchpad (rare; mainly for testing)")
+        .description("Delete my journal (rare; mainly for testing)")
         .option("--yes", "Confirm deletion")
         .action((opts) => {
         if (!opts.yes) {
@@ -186,7 +186,7 @@ export function registerScratchCommand(program, emitParam) {
         }
         try {
             const owner = currentOwnerOrThrow();
-            const path = scratchPath(owner);
+            const path = journalPath(owner);
             if (existsSync(path)) {
                 unlinkSync(path);
                 emit.data({ cleared: true, path });
@@ -203,9 +203,9 @@ export function registerScratchCommand(program, emitParam) {
     // ── lint ──────────────────────────────────────────────────────────────
     root
         .command("lint")
-        .description("Validate scratchpad format + size")
-        .option("--all", "Lint every scratchpad in .harnery/scratch/")
-        .option("--owner <id>", "Lint a specific owner's scratchpad")
+        .description("Validate journal format + size")
+        .option("--all", "Lint every journal in .harnery/journal/")
+        .option("--owner <id>", "Lint a specific owner's journal")
         .action((opts) => {
         try {
             runLint(opts);
@@ -218,12 +218,12 @@ export function registerScratchCommand(program, emitParam) {
     // ── archive (manual / hook helper) ────────────────────────────────────
     root
         .command("archive")
-        .description("Archive my scratchpad now (idempotent; fired by SessionEnd hook)")
-        .option("--owner <id>", "Archive a specific owner's scratchpad")
+        .description("Archive my journal now (idempotent; fired by SessionEnd hook)")
+        .option("--owner <id>", "Archive a specific owner's journal")
         .action((opts) => {
         try {
             const owner = opts.owner ?? currentOwnerOrThrow();
-            const dest = archiveScratch(owner);
+            const dest = archiveJournal(owner);
             emit.data({ instance_id: owner, archived: !!dest, path: dest });
         }
         catch (err) {
@@ -256,9 +256,9 @@ export function registerScratchCommand(program, emitParam) {
             const ageStr = ageMin < 60 ? `${ageMin}m` : `${Math.floor(ageMin / 60)}h ${ageMin % 60}m`;
             const bodyOneLine = last.body.replace(/\s+/g, " ").trim();
             const bodyTrunc = bodyOneLine.length > 100 ? `${bodyOneLine.slice(0, 99)}…` : bodyOneLine;
-            const cue = `Recent scratchpad archive (${ageStr} ago): agent-${doc.header.name}: ` +
+            const cue = `Recent journal archive (${ageStr} ago): agent-${doc.header.name}: ` +
                 `last entry [${last.category}] "${bodyTrunc}". ` +
-                `Read full: \`${resolveBinName()} scratch read --archive ${newest.basename}\`.`;
+                `Read full: \`${resolveBinName()} journal read --archive ${newest.basename}\`.`;
             process.stdout.write(`${cue}\n`); // lint-ok-emission: bash hook reads stdout to compose SessionStart additionalContext
         }
         catch (_err) {
@@ -268,13 +268,13 @@ export function registerScratchCommand(program, emitParam) {
     // ── janitor (SessionStart hook) ───────────────────────────────────────
     root
         .command("janitor")
-        .description("Prune old archives + sweep orphan scratchpads (heartbeat gone). Fired by SessionStart hook.")
+        .description("Prune old archives + sweep orphan journals (heartbeat gone). Fired by SessionStart hook.")
         .option("--days <n>", "Archive retention in days", "7")
         .option("--quiet", "Suppress stdout output")
         .action((opts) => {
         try {
             const days = Number.parseInt(opts.days, 10);
-            const swept = sweepOrphanScratchpads();
+            const swept = sweepOrphanJournals();
             const pruned = pruneArchives(days);
             if (!opts.quiet) {
                 emit.data({
@@ -294,7 +294,7 @@ export function registerScratchCommand(program, emitParam) {
 function runRead(opts) {
     const limit = Number.parseInt(opts.limit, 10);
     if (opts.archive) {
-        const dir = scratchDir();
+        const dir = journalDir();
         const path = resolvePath(dir, "archived", opts.archive);
         if (!existsSync(path)) {
             emit.error({ code: "no_archive", message: `archive not found: ${opts.archive}` });
@@ -305,23 +305,23 @@ function runRead(opts) {
         return;
     }
     const owner = resolveTargetOwner(opts);
-    const doc = loadScratch(owner);
+    const doc = loadJournal(owner);
     if (!doc) {
         emit.error({
-            code: "no_scratchpad",
-            message: `no scratchpad for owner=${owner.slice(0, 8)}… (file not created yet)`,
+            code: "no_journal",
+            message: `no journal for owner=${owner.slice(0, 8)}… (file not created yet)`,
         });
         process.exit(1);
     }
     const hb = readHeartbeat(owner);
     const staleBanner = renderStaleBannerIfNeeded(hb?.last_heartbeat);
-    process.stdout.write(`${staleBanner + renderScratch(doc, limit)}\n`); // lint-ok-emission: pretty render, multi-line markdown for direct TTY/pipe consumption
+    process.stdout.write(`${staleBanner + renderJournal(doc, limit)}\n`); // lint-ok-emission: pretty render, multi-line markdown for direct TTY/pipe consumption
 }
 function runLint(opts) {
-    const dir = scratchDir();
+    const dir = journalDir();
     const files = [];
     if (opts.owner) {
-        files.push(scratchPath(opts.owner));
+        files.push(journalPath(opts.owner));
     }
     else if (opts.all) {
         for (const f of readdirSync(dir)) {
@@ -331,7 +331,7 @@ function runLint(opts) {
     }
     else {
         const owner = currentOwnerOrThrow();
-        files.push(scratchPath(owner));
+        files.push(journalPath(owner));
     }
     let totalIssues = 0;
     const reports = [];
@@ -341,7 +341,7 @@ function runLint(opts) {
             continue;
         }
         const content = readFileSync(path, "utf8");
-        const issues = lintScratch(content);
+        const issues = lintJournal(content);
         if (issues.length > 0)
             totalIssues += issues.length;
         reports.push({ path, issues });
@@ -352,10 +352,10 @@ function runLint(opts) {
 }
 // ─── Helpers ──────────────────────────────────────────────────────────────
 function validateCategory(c) {
-    if (!SCRATCH_CATEGORIES.includes(c)) {
+    if (!JOURNAL_CATEGORIES.includes(c)) {
         emit.error({
             code: "bad_category",
-            message: `category must be one of: ${SCRATCH_CATEGORIES.join(", ")}`,
+            message: `category must be one of: ${JOURNAL_CATEGORIES.join(", ")}`,
         });
         process.exit(1);
     }
@@ -377,9 +377,9 @@ function resolveTargetOwner(opts) {
     }
     return currentOwnerOrThrow();
 }
-function renderScratch(doc, limit) {
+function renderJournal(doc, limit) {
     const lines = [];
-    lines.push(`# Scratchpad: agent-${doc.header.name}`);
+    lines.push(`# Journal: agent-${doc.header.name}`);
     if (doc.header.session_id)
         lines.push(`session_id: ${doc.header.session_id}`);
     if (doc.header.machine)
@@ -418,7 +418,7 @@ function parseSafe(path) {
         if (!existsSync(path))
             return null;
         const content = readFileSync(path, "utf8");
-        return parseScratch(path, content);
+        return parseJournal(path, content);
     }
     catch {
         return null;

package/dist/commands/policy.js

@@ -33,7 +33,7 @@ export function renderPolicy(policy, digest) {
         `unknown cost: ${policy.unknown_cost}`,
         `network: ${policy.network}`,
         `external actions: ${policy.external_actions}`,
-        `harnesses: ${policy.allowed_harnesses?.join(", ") ?? "any"}`,
+        `adapters: ${policy.allowed_adapters?.join(", ") ?? "any"}`,
         `models: ${policy.allowed_models?.join(", ") ?? "any"}`,
         `paths: ${policy.allowed_paths?.join(", ") ?? "any"}`,
         `isolation: ${policy.allowed_isolation?.join(", ") ?? "any"}`,

package/dist/commands/presence.js

@@ -1,5 +1,5 @@
 import { monorepoRoot } from "../core/agents/coord-client.js";
-import { emitCanonical, normalizeHarness, readHeartbeat, resolveOwner, } from "../core/agents/index.js";
+import { emitCanonical, normalizeAdapter, readHeartbeat, resolveOwner, } from "../core/agents/index.js";
 import { fetchPresence, publishPresence, readRemoteMachines, relayDaemonStatus, runRelayDaemon, } from "../core/presence/index.js";
 import { ageSeconds, applyDetection, clearPresence, formatAge, presenceFilePath, readPresence, writePresence, } from "../lib/presence.js";
 /**
@@ -200,7 +200,7 @@ function emitPresenceChange(from, to, source) {
         type: "state.presence_change",
         owner,
         session: hb?.session_id ?? owner,
-        harness: normalizeHarness(hb?.platform),
+        adapter: normalizeAdapter(hb?.platform),
         data: { from, to, source },
     });
 }

package/dist/commands/sync.d.ts

@@ -3,7 +3,7 @@
  * via rclone (typically a Google Drive remote, but any rclone remote works).
  *
  * Scope: a deliberately small set of file types: durable identities,
- * archived scratchpads, council manifests. The high-churn machine-local
+ * archived journals, council manifests. The high-churn machine-local
  * stuff (events.ndjson, .pid-map/, active/, .last-intent.*) stays put.
  *
  * Subcommands:

package/dist/commands/sync.js

@@ -3,7 +3,7 @@
  * via rclone (typically a Google Drive remote, but any rclone remote works).
  *
  * Scope: a deliberately small set of file types: durable identities,
- * archived scratchpads, council manifests. The high-churn machine-local
+ * archived journals, council manifests. The high-churn machine-local
  * stuff (events.ndjson, .pid-map/, active/, .last-intent.*) stays put.
  *
  * Subcommands:
@@ -25,7 +25,7 @@ import path from "node:path";
 import { syncJsoncConfig } from "../core/config.js";
 // What we sync. Anything matching one of these (relative to .harnery/) is
 // considered part of the sync set. Everything else stays local-only.
-const SYNC_PATHS = ["identities/", "scratch/archived/", "councils/"];
+const SYNC_PATHS = ["identities/", "journal/archived/", "councils/"];
 function configPath() {
     return path.join(os.homedir(), ".config", "harnery", "sync.json");
 }
@@ -119,7 +119,7 @@ export function registerSyncCommand(program, emit) {
     const sync = program
         .command("sync")
         .description("Cross-machine sync of curated .harnery/ subset (identities, archived " +
-        "scratchpads, council manifests) via rclone. Google Drive is the " +
+        "journals, council manifests) via rclone. Google Drive is the " +
         "expected remote; any rclone backend works.");
     sync
         .command("init")

package/dist/commands/tunnel.d.ts

@@ -1,4 +1,20 @@
 import type { Command } from "commander";
 import type { EmitContext, HarneryProgramContext } from "../commander.js";
+import { type TunnelState } from "../lib/tunnel/state.js";
+/**
+ * Restart ONE instance's gate in place, deliberately leaving the provider
+ * process running.
+ *
+ * That asymmetry is the whole point. A Cloudflare quick tunnel's hostname is
+ * minted by cloudflared at startup, so a full `down`/`up` hands back a NEW
+ * random *.trycloudflare.com URL and breaks every link already shared — a
+ * miserable trade for adding one IP. cloudflared only ever forwards to
+ * `localhost:<gate_port>`, so the gate beneath it can be swapped out and the
+ * edge reconnects without noticing.
+ */
+export declare function reloadOne(state: TunnelState): Promise<{
+    ok: boolean;
+    message: string;
+}>;
 export declare function registerTunnelCommand(program: Command, emitParam: EmitContext, contextParam?: HarneryProgramContext): void;
 //# sourceMappingURL=tunnel.d.ts.map