@tekmidian/pai 1.0.5 → 1.0.7

package/dist/worker-config-CfV2dgSb.mjs

@@ -0,0 +1,42 @@
+import "./utils-J2b9y8PC.mjs";
+import "./config-DGV64YJa.mjs";
+import "./config-SlZ-Z52i.mjs";
+import "./paths-BwfwHOvN.mjs";
+import "./worktree-7ZS3RBf8.mjs";
+import "./status-DTMT5lyn.mjs";
+import "./pool-CFeHGX7q.mjs";
+import "./helpers-CRuBUas3.mjs";
+import "./scope-BRcaPw5D.mjs";
+import "./routing-CF0wlR-_.mjs";
+import "./tool-errors-BOW2n882.mjs";
+import "./wait-BindDA5w.mjs";
+import "./local-tiers-CqwGUcEn.mjs";
+import "./caller-identity-DPDSrZE2.mjs";
+import "./capacity-CThSydrd.mjs";
+import "./local-instances-DhF4_sV2.mjs";
+import "./local-candidate-C2FGhf54.mjs";
+import "./factory-CYwa0jYj.mjs";
+import "./postgres-BL5oBBgY.mjs";
+import "./embedding-gate-iq0oQEkF.mjs";
+import "./embeddings-BVq3esBF.mjs";
+import "./router-D2476pOp.mjs";
+import "./launch-CV6oPHI2.mjs";
+import "./health-Bb2U4PNK.mjs";
+import "./run-CAjfKBQV.mjs";
+import "./controls-ByrcupcA.mjs";
+import "./endreason-BjPom527.mjs";
+import "./render-CbifCwTb.mjs";
+import "./operator-lRGvYr3D.mjs";
+import "./kill-tree-DTmiEb3T.mjs";
+import "./pool-cli-DOLgPgOM.mjs";
+import "./pane-audit-DUuilP1V.mjs";
+import "./providers-BC2Myo_O.mjs";
+import { A as workerMcpCommand, C as workerBenchCommand, D as workerFallbackCommand, E as workerControlsCommand, F as workerProvidersCommand, I as workerProxyCommand, L as workerRolesCommand, M as workerOnCommand, N as workerPolicyCommand, O as workerInstallCommand, P as workerPoolCommand, R as workerRouteCommand, S as stopInstance, T as workerConfigCommand, _ as portOpen, a as collectEnv, b as startTier, c as currentInstances, d as isUp, f as killInstance, g as portListeners, h as parseCostTier, i as cliInflight, j as workerOffCommand, k as workerLocalCommand, l as fail, m as listServers, n as WORKER_CONFIG_COMMANDS, o as collectTags, p as launchDetached, r as buildClassTarget, s as controlsArgv, t as PROVIDER_EDIT_COMMANDS, u as healthOk, v as serverLine, w as workerClassesCommand, x as stopAll, y as startInstance } from "./worker-config-CdPmb4_2.mjs";
+import "./main-config-ops-C_fkINDv.mjs";
+import "./cockpit-actions-BgdKB9G3.mjs";
+import "./ipc-client-CmagIFLh.mjs";
+import "./embed-pass-DdTMn4DH.mjs";
+import "./session-usage-BRIWFYPS.mjs";
+import "./fallback-CQ8_CuVu.mjs";
+
+export { currentInstances, startInstance, startTier, stopAll, stopInstance };

package/dist/{workers-config-BhZBrR-Q.mjs → workers-config-2VipVOYk.mjs}

@@ -1,4 +1,4 @@
-import { $ as readWorkersYaml, G as effectiveWorkersYamlData, H as WORKERS_YAML_FILENAME, J as migrateWorkersToYaml, K as initWorkersYaml, Q as readMergeVerify, U as buildWorkersYamlText, W as defaultWorkersYamlPath, X as parseBuiltinAnthropic, Y as needsWorkersYamlRelocation, Z as parseWorkersYamlDocument, at as writeWorkersYamlText, et as relocateWorkersYaml, it as writeWorkersYaml, nt as workersYamlLegacyNotice, ot as yamlProviderToRaw, q as inlineWorkersYamlKeys, rt as workersYamlPath, tt as starterWorkersYamlText } from "./config-CST2uq1v.mjs";
-import "./config-DYbyEe4-.mjs";
+import { $ as readWorkersYaml, G as effectiveWorkersYamlData, H as WORKERS_YAML_FILENAME, J as migrateWorkersToYaml, K as initWorkersYaml, Q as readMergeVerify, U as buildWorkersYamlText, W as defaultWorkersYamlPath, X as parseBuiltinAnthropic, Y as needsWorkersYamlRelocation, Z as parseWorkersYamlDocument, at as writeWorkersYamlText, et as relocateWorkersYaml, it as writeWorkersYaml, nt as workersYamlLegacyNotice, ot as yamlProviderToRaw, q as inlineWorkersYamlKeys, rt as workersYamlPath, tt as starterWorkersYamlText } from "./config-DGV64YJa.mjs";
+import "./config-SlZ-Z52i.mjs";
 
 export { workersYamlPath };

package/dist/{worktree-BY--Rgmy.mjs → worktree-7ZS3RBf8.mjs}

@@ -1,9 +1,10 @@
 import { t as writeFileAtomic } from "./atomic-file-BorMa4T3.mjs";
-import { Et as appendLedger } from "./config-CST2uq1v.mjs";
-import { i as ledgerPath, l as statusPath } from "./paths-DS5VQKoR.mjs";
-import { a as UNLABELED, g as isLive, k as saveStatus, v as loadStatus, y as loadStatuses } from "./status-COtzewKV.mjs";
+import { Et as appendLedger } from "./config-DGV64YJa.mjs";
+import { c as loadConfig } from "./config-SlZ-Z52i.mjs";
+import { i as ledgerPath, l as statusPath } from "./paths-BwfwHOvN.mjs";
+import { a as UNLABELED, g as isLive, k as saveStatus, v as loadStatus, y as loadStatuses } from "./status-DTMT5lyn.mjs";
 import { t as fmtAge } from "./fmt-age-ByDkvkoU.mjs";
-import { v as readPoolState } from "./pool-BZ94nFuq.mjs";
+import { v as readPoolState } from "./pool-CFeHGX7q.mjs";
 import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
 import { platform, tmpdir } from "node:os";
@@ -1320,6 +1321,151 @@ function adoptDetachedHead(dir, branch) {
 		return null;
 	}
 }
+function mergeSettings() {
+	const m = loadConfig().workers?.merge;
+	return {
+		generated: m?.generated ?? [],
+		regenerate: m?.regenerate ?? "",
+		union: m?.union ?? []
+	};
+}
+/** Glob to RegExp: `**` crosses directories, `*` and `?` stay inside one. */
+function globToRegExp(glob) {
+	let re = "";
+	for (let i = 0; i < glob.length; i++) {
+		const c = glob[i];
+		if (c === "*" && glob[i + 1] === "*") {
+			re += ".*";
+			i++;
+			if (glob[i + 1] === "/") i++;
+		} else if (c === "*") re += "[^/]*";
+		else if (c === "?") re += "[^/]";
+		else re += c.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+	}
+	return new RegExp(`^${re}$`);
+}
+/** Does the diff from `base` to `side` only add lines (nothing removed or changed)? */
+function onlyAdds(dir, base, side) {
+	const r = spawnSync("git", [
+		"diff",
+		"--no-index",
+		"--numstat",
+		"--",
+		base,
+		side
+	], {
+		cwd: dir,
+		encoding: "utf8"
+	});
+	const m = /^(\d+)\t(\d+)\t/.exec(r.stdout ?? "");
+	return !!m && m[2] === "0";
+}
+/**
+* Resolve the conflicts of a merge in progress when every one is either in a
+* generated path (take ours, regenerate, add) or a pure-addition clash (both
+* sides only added lines: union, ours then theirs). Returns a note on success,
+* null when anything else conflicts (merge left in progress for the caller to
+* abort); throws after aborting when regeneration fails.
+*/
+function autoResolveMerge(cwd, files, cfg) {
+	const res = cfg.generated.map(globToRegExp);
+	const isGen = (f) => res.some((r) => r.test(f));
+	const gen = files.filter(isGen);
+	const rest = files.filter((f) => !isGen(f));
+	const unionRes = cfg.union.map(globToRegExp);
+	if (rest.some((f) => !unionRes.some((r) => r.test(f)))) return null;
+	const tmp = mkdtempSync(join(tmpdir(), "pai-union-"));
+	const unions = [];
+	try {
+		for (const f of rest) {
+			const stage = (n, name) => {
+				const r = spawnSync("git", ["show", `:${n}:${f}`], {
+					cwd,
+					encoding: "buffer"
+				});
+				if (r.status !== 0) return null;
+				writeFileSync(join(tmp, name), r.stdout);
+				return join(tmp, name);
+			};
+			const base = stage(1, "base");
+			const ours = stage(2, "ours");
+			const theirs = stage(3, "theirs");
+			if (!base || !ours || !theirs || !onlyAdds(cwd, base, ours) || !onlyAdds(cwd, base, theirs)) return null;
+			const m = spawnSync("git", [
+				"merge-file",
+				"-p",
+				"--union",
+				ours,
+				base,
+				theirs
+			], {
+				cwd,
+				encoding: "buffer"
+			});
+			if (m.status !== 0) return null;
+			unions.push({
+				file: f,
+				content: m.stdout.toString("utf8")
+			});
+		}
+	} finally {
+		rmSync(tmp, {
+			recursive: true,
+			force: true
+		});
+	}
+	const notes = [];
+	if (gen.length) for (const f of gen) try {
+		git(cwd, [
+			"checkout",
+			"--ours",
+			"--",
+			f
+		]);
+	} catch {
+		git(cwd, [
+			"rm",
+			"-q",
+			"--cached",
+			"--ignore-unmatch",
+			"--",
+			f
+		]);
+	}
+	for (const u of unions) {
+		writeFileSync(join(cwd, u.file), u.content, "utf8");
+		git(cwd, [
+			"add",
+			"--",
+			u.file
+		]);
+	}
+	if (gen.length) {
+		const r = spawnSync("sh", ["-c", cfg.regenerate], {
+			cwd,
+			encoding: "utf8"
+		});
+		if (!cfg.regenerate || r.status !== 0) {
+			git(cwd, ["merge", "--abort"]);
+			throw new Error(`git refused the merge: conflicts in generated paths (${gen.join(", ")}) and regeneration ` + (cfg.regenerate ? `\`${cfg.regenerate}\` failed (exit ${r.status}): ${(r.stderr || r.stdout || "").trim().slice(-400)}` : "is not configured (workers.merge.regenerate)") + "; the merge was aborted");
+		}
+		const specs = cfg.generated.map((g) => `:(glob)${g}`);
+		git(cwd, [
+			"add",
+			"-A",
+			"--",
+			...specs
+		]);
+		const count = git(cwd, [
+			"ls-files",
+			"--",
+			...specs
+		]).split("\n").filter(Boolean).length;
+		notes.push(`regenerated ${cfg.generated.filter((g) => gen.some((f) => globToRegExp(g).test(f))).map((g) => g.replace(/\/?\*\*$/, "")).join(", ")} (${count} files)`);
+	}
+	for (const u of unions) notes.push(`union-merged ${u.file}`);
+	return notes.join("; ");
+}
 function mergeWorker(logDir, id, opts = {}) {
 	const st = mustHaveBranch(logDir, id);
 	if (st.merged) return `worker ${id}: branch ${st.branch} already merged`;
@@ -1355,6 +1501,7 @@ function mergeWorker(logDir, id, opts = {}) {
 	const [scanFrom, scanTo] = reapply ? [`${reapply.merge}^1`, reapply.merge] : [mergeBase, st.branch];
 	assertStaticScans(st.cwd, scanFrom, scanTo);
 	const oldHead = git(st.cwd, ["rev-parse", "HEAD"]);
+	let autoNote = null;
 	try {
 		if (reapply) git(st.cwd, [
 			"revert",
@@ -1383,16 +1530,34 @@ function mergeWorker(logDir, id, opts = {}) {
 				"--diff-filter=U"
 			]).split("\n").filter(Boolean);
 		} catch {}
-		if (inProgress) {
-			git(st.cwd, ["merge", "--abort"]);
+		let autoErr = null;
+		if (inProgress && files.length) try {
+			autoNote = autoResolveMerge(st.cwd, files, opts.merge ?? mergeSettings());
+			if (autoNote !== null) git(st.cwd, [
+				"commit",
+				"-q",
+				"-m",
+				`merge worker ${id} (${st.label}); auto-resolved: ${autoNote}`
+			]);
+		} catch (err) {
+			autoErr = err;
+			autoNote = null;
+		}
+		if (inProgress && autoNote === null) {
+			try {
+				git(st.cwd, ["merge", "--abort"]);
+			} catch {}
 			if (git(st.cwd, ["rev-parse", "HEAD"]) !== oldHead || git(st.cwd, [
 				"status",
 				"--porcelain",
 				"--untracked-files=no"
 			])) throw new Error(`worker ${id}: git merge --abort left ${st.cwd} not at ${oldHead}; inspect it before retrying`);
 		}
-		const msg = `worker ${id}: git refused the merge of ${st.branch}` + (files.length ? ` — conflict in ${files.join(", ")}: merge main into the worker branch in its kept worktree (${st.worktreeDir}), resolve, then re-run pai worker merge ${id}` : ` — ${e.message}. The worktree ${st.worktreeDir} was kept: resolve the problem, then re-run pai worker merge ${id}`);
-		throw files.length ? new MergeConflictError(msg, files) : new Error(msg);
+		if (autoErr && /the merge was aborted$/.test(autoErr.message)) throw autoErr;
+		if (autoNote === null) {
+			const msg = `worker ${id}: git refused the merge of ${st.branch}` + (files.length ? ` — conflict in ${files.join(", ")}${autoErr ? ` (auto-resolution failed: ${autoErr.message.split("\n")[0].slice(0, 200)})` : ""}: merge main into the worker branch in its kept worktree (${st.worktreeDir}), resolve, then re-run pai worker merge ${id}` : ` — ${e.message}. The worktree ${st.worktreeDir} was kept: resolve the problem, then re-run pai worker merge ${id}`);
+			throw files.length ? new MergeConflictError(msg, files) : new Error(msg);
+		}
 	}
 	const verifyLine = gateLines(st.cwd, opts.verify, () => revertMerge(st.cwd, oldHead), () => null);
 	if (existsSync(st.worktreeDir) && !slot) assertWorktreeClean(st.worktreeDir, id);
@@ -1434,6 +1599,7 @@ function mergeWorker(logDir, id, opts = {}) {
 	const notes = [];
 	if (salvage.committed.length) notes.push(`salvaged ${salvage.committed.length} uncommitted change(s): ${salvage.committed.join(", ")}`);
 	if (salvage.skipped.length) notes.push(`skipped ${salvage.skipped.join(", ")}`);
+	if (autoNote) notes.unshift(`auto-resolved conflicts: ${autoNote}`);
 	return withGate(verifyLine, notes.length ? `${base}; ${notes.join("; ")}` : base);
 }
 /** Stub and test-loss scans over `from..to`; throws before any merge exists, so the advised re-run works. */
@@ -2710,4 +2876,4 @@ function gcWorktreesThrottled(logDir, everyMin = 60, now = Date.now(), opts = {}
 
 //#endregion
 export { applyScratchEnv as A, worktreeWanted as C, formatPending as D, worktreesStatsCached as E, pendingGate as O, worktreeSystemPrompt as S, worktreesStats as T, ownedTree as _, archiveEmptyResult as a, verifyWorker as b, formatKnowledge as c, gcWorktrees as d, gcWorktreesThrottled as f, mergeWorker as g, markResumed as h, adoptTree as i, scratchPromptLine as j, pendingResults as k, formatWorktreesStats as l, leftoverWorktrees as m, MergeConflictError as n, commitLines as o, inPlaceSystemPrompt as p, addWorktree as r, discardWorker as s, GATE_MARK as t, gcPoolWorktrees as u, recordWorktree as v, worktreesDir as w, worktreeRefusesStart as x, salvageOnExit as y };
-//# sourceMappingURL=worktree-BY--Rgmy.mjs.map
+//# sourceMappingURL=worktree-7ZS3RBf8.mjs.map

package/dist/{zettelkasten-BHVx5zj-.mjs → zettelkasten-BH8AdNh8.mjs}

@@ -1,7 +1,7 @@
-import "./config-DYbyEe4-.mjs";
-import "./embedding-gate-CTAk8STe.mjs";
+import "./config-SlZ-Z52i.mjs";
+import "./embedding-gate-iq0oQEkF.mjs";
 import "./embeddings-BVq3esBF.mjs";
-import { r as saveQueryResult } from "./query-feedback-DN52N9C5.mjs";
-import { a as zettelThemes, c as zettelExplore, i as zettelHealth, n as zettelGodNotes, o as zettelConverse, r as zettelSuggest, s as zettelSurprise, t as zettelCommunities } from "./zettelkasten-LoH9RBiN.mjs";
+import { r as saveQueryResult } from "./query-feedback-BWl2HRwN.mjs";
+import { a as zettelThemes, c as zettelExplore, i as zettelHealth, n as zettelGodNotes, o as zettelConverse, r as zettelSuggest, s as zettelSurprise, t as zettelCommunities } from "./zettelkasten-FFhQFESJ.mjs";
 
 export { zettelConverse, zettelExplore, zettelHealth, zettelSuggest, zettelSurprise, zettelThemes };

package/dist/{zettelkasten-LoH9RBiN.mjs → zettelkasten-FFhQFESJ.mjs}

@@ -1,5 +1,5 @@
 import { t as STOP_WORDS$1 } from "./stop-words-DSEYQdNe.mjs";
-import { a as requireQueryEmbedding } from "./embedding-gate-CTAk8STe.mjs";
+import { a as requireQueryEmbedding } from "./embedding-gate-iq0oQEkF.mjs";
 import { i as deserializeEmbedding, r as cosineSimilarity } from "./embeddings-BVq3esBF.mjs";
 import { basename, dirname } from "node:path";
 
@@ -1213,4 +1213,4 @@ async function zettelCommunities(backend, opts) {
 
 //#endregion
 export { zettelThemes as a, zettelExplore as c, zettelHealth as i, zettelGodNotes as n, zettelConverse as o, zettelSuggest as r, zettelSurprise as s, zettelCommunities as t };
-//# sourceMappingURL=zettelkasten-LoH9RBiN.mjs.map
+//# sourceMappingURL=zettelkasten-FFhQFESJ.mjs.map

package/docs/commands/README.md

@@ -20,6 +20,9 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | [`pai doc`](doc.md) | Write the Markdown command reference |
 | [`pai end`](end.md) | Finish the current session |
 | [`pai find`](find.md) | Search your prompt history for sessions |
+| [`pai git`](git.md) | Link commits to the session that wrote them |
+| [`pai handoff`](handoff.md) | Carry a session's work to a new one |
+| [`pai harness`](harness.md) | Sessions PAI can read from agent harnesses (Claude Code, Codex, ...) |
 | [`pai help`](help.md) | Explain a command (same as `pai <command> --help`) |
 | [`pai home`](home.md) | Where PAI keeps its files; move them out of ~/.claude |
 | [`pai hooks-db`](hooks-db.md) | Registry updates for the stop and pre-compact hooks |
@@ -28,6 +31,7 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | [`pai issue`](issue.md) | Claim and release forge issues for this project |
 | [`pai kg`](kg.md) | Facts extracted from your notes, with the time they were true |
 | [`pai launch`](launch.md) | Start Claude Code on a chosen provider (for scripts) |
+| [`pai lessons`](lessons.md) | Review-gated lessons for agents |
 | [`pai list`](list.md) | List the markdown session notes |
 | [`pai ls`](ls.md) | List sessions, newest first |
 | [`pai mcp`](mcp.md) | Install the PAI tools for Claude Code |
@@ -53,6 +57,7 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | [`pai restore`](restore.md) | Restore PAI data from a backup |
 | [`pai resume`](resume.md) | Open a session by name or id (same as `pai open`) |
 | [`pai router`](router.md) | Local model router: start, stop, restart, status, run, stats |
+| [`pai rules`](rules.md) | Security rules: list them, lint their fixtures |
 | [`pai session`](session.md) | Work with sessions: list, open, new, rename |
 | [`pai sessions`](sessions.md) | Old plural session commands (use `ls` and `session`) |
 | [`pai setup`](setup.md) | First-time setup: storage, search, hooks, daemon, router |
@@ -71,11 +76,12 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | Command | Description |
 |---|---|
 | `pai audit` | Find out where tokens are being spent |
+| `pai audit scan` | After-the-fact security scan of a session or worker transcript |
 | `pai audit tokens` | Token-waste report (all checks, or pick one below) |
 | `pai audit tokens daemon` | What the background service spent |
 | `pai audit tokens env` | Model and endpoint overrides on running sessions |
 | `pai audit tokens files` | Token count per memory file |
-| `pai audit tokens hooks` | Token cost of every start-up and prompt hook |
+| `pai audit tokens hooks` | Token cost and observed state of every start-up and prompt hook |
 | `pai audit tokens ladder` | LIVE: first-turn context per configuration step |
 | `pai audit tokens mcp` | MCP servers: configured, pinned, loaded, used |
 | `pai audit tokens schedule` | Scheduled jobs that beat the cache lifetime |
@@ -86,7 +92,7 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | `pai audit tokens usage` | Exact token totals per model for one session transcript |
 | `pai backup` | Back up the registry, config and Postgres database |
 | `pai build` | One machine-wide build queue: run, lock, queue, next, doctor |
-| `pai build doctor` | Check the project's registered build doors |
+| `pai build doctor` | Check the project's registered build doors and hook events |
 | `pai build lock` | Same lock as `run`, for a project's door script to call |
 | `pai build next` | Give a waiting build the next free slot |
 | `pai build queue` | Show the running and waiting builds and tests |
@@ -126,6 +132,18 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | `pai doc` | Write the Markdown command reference |
 | `pai end` | Finish the current session |
 | `pai find` | Search your prompt history for sessions |
+| `pai git` | Link commits to the session that wrote them |
+| `pai git hook` | Git hook entry points (called by git) |
+| `pai git hook post-commit` | Record the sessions that edited the last commit's files |
+| `pai git notes` | Show the PAI note of a commit |
+| `pai git remove` | Remove the hook and restore the previous one |
+| `pai git setup` | Install the post-commit hook in the current repository |
+| `pai handoff` | Carry a session's work to a new one |
+| `pai handoff export` | Write the brief for a session (default: newest here) |
+| `pai handoff show` | Print a handoff brief |
+| `pai harness` | Sessions PAI can read from agent harnesses (Claude Code, Codex, ...) |
+| `pai harness list` | Each adapter: detected, enabled, session count |
+| `pai harness sessions` | List sessions, newest first |
 | `pai help` | Explain a command (same as `pai <command> --help`) |
 | `pai home` | Where PAI keeps its files; move them out of ~/.claude |
 | `pai home migrate` | Move PAI's home from ~/.claude/pai to ~/.pai |
@@ -150,6 +168,15 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | `pai kg query` | Look up facts by subject, predicate, object or date |
 | `pai kg stats` | How many facts and contradictions the graph holds |
 | `pai launch` | Start Claude Code on a chosen provider (for scripts) |
+| `pai lessons` | Review-gated lessons for agents |
+| `pai lessons add` | Add a candidate lesson |
+| `pai lessons approve` | Approve a candidate |
+| `pai lessons list` | List lessons |
+| `pai lessons promote` | Promote an approved lesson to a project skill |
+| `pai lessons propose` | Add candidates from a transcript |
+| `pai lessons reject` | Reject a candidate |
+| `pai lessons show` | Show one lesson |
+| `pai lessons supersede` | Replace an approved lesson by another approved one |
 | `pai list` | List the markdown session notes |
 | `pai ls` | List sessions, newest first |
 | `pai mcp` | Install the PAI tools for Claude Code |
@@ -292,6 +319,9 @@ Generated reference for every `pai` command. Read any page in the terminal with
 | `pai router stats` | Token and cache totals per provider and model |
 | `pai router status` | Show whether the router is running |
 | `pai router stop` | Stop the router |
+| `pai rules` | Security rules: list them, lint their fixtures |
+| `pai rules lint` | Run every rule's fixtures; exit 1 on a failure or load error |
+| `pai rules list` | Every rule with severity, source and enabled state |
 | `pai session` | Work with sessions: list, open, new, rename |
 | `pai session active` | Sessions that were active in the last hour |
 | `pai session auto-route` | Find out which project the current directory belongs to |

package/docs/commands/audit.md

@@ -68,22 +68,24 @@ See also: `pai audit tokens`
 
 #### pai audit tokens hooks
 
-Token cost of every start-up and prompt hook
+Token cost and observed state of every start-up and prompt hook
 
 ```
 pai audit tokens hooks [options]
 ```
 
-Lists each SessionStart and UserPromptSubmit hook. With --run it executes them and measures what each adds to the context; without it nothing is executed.
+Lists each SessionStart and UserPromptSubmit hook with its state: observed (a capture for that event exists in the window), configured (never observed — the hook may silently not be running), or missing-script. With --run it executes them and measures what each adds to the context; without it nothing is executed.
 
 | Flag | Type | Default | Description |
 |---|---|---|---|
 | `--run` | flag | — | Execute the hooks to measure their output (runs the repository's own hook commands; trusted repositories only) |
+| `--since HOURS` | number | — | Observation window for the state column (default 24h) |
 | `--json` | flag | — | Print JSON instead of a table |
 
 ```sh
 pai audit tokens hooks
 pai audit tokens hooks --run
+pai audit tokens hooks --since 48
 ```
 
 See also: `pai audit tokens`
@@ -323,15 +325,44 @@ pai audit tokens ladder --live --model haiku
 
 See also: `pai audit tokens`
 
+### pai audit scan
+
+After-the-fact security scan of a session or worker transcript
+
+```
+pai audit scan [PATH] [options]
+```
+
+Runs the rule set (the same rules the PreToolUse hook enforces, plus two-step sequence rules that only make sense after the fact) over a transcript: single-step rules against every tool call, sequence rules correlated across the run — credential read followed by an outbound call, download followed by execute, injected text followed by a shell call. Findings are grouped by severity; evidence is masked. Exit 1 when a block-severity finding hit.
+
+| Argument | Required | Description |
+|---|---|---|
+| `PATH` | no | Transcript .jsonl (default: newest session under ~/.claude/projects) |
+
+| Flag | Type | Default | Description |
+|---|---|---|---|
+| `--session ID` | string | — | Scan this Claude Code session's transcript |
+| `--worker ID` | string | — | Scan a worker's transcript (its Claude session, else its event log) |
+| `--json` | flag | — | Print JSON instead of a table |
+
+```sh
+pai audit scan
+pai audit scan --worker w-20260101-abc
+pai audit scan ./session.jsonl --json
+```
+
+See also: `pai rules list`, `pai audit tokens session`
+
 ## Subcommands
 
 | Command | Description |
 |---|---|
 | `pai audit tokens` | Token-waste report (all checks, or pick one below) |
+| `pai audit scan` | After-the-fact security scan of a session or worker transcript |
 
 ## See also
 
-[`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/backup.md

@@ -25,7 +25,7 @@ See also: `pai restore`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/build.md

@@ -101,13 +101,13 @@ See also: `pai build queue`
 
 ### pai build doctor
 
-Check the project's registered build doors
+Check the project's registered build doors and hook events
 
 ```
 pai build doctor
 ```
 
-Reads .pai/builds.yaml above the current directory and flags every door that is missing or never calls `pai build lock`, which would bypass the queue.
+Reads .pai/builds.yaml above the current directory and flags every door that is missing or never calls `pai build lock`, which would bypass the queue. Also prints one line per hook event: observed (a capture proves it ran) or configured-but-never-observed (warning — the hook may silently not be running).
 
 ```sh
 pai build doctor
@@ -140,12 +140,12 @@ pai build watch DIR ID
 | `pai build lock` | Same lock as `run`, for a project's door script to call |
 | `pai build queue` | Show the running and waiting builds and tests |
 | `pai build next` | Give a waiting build the next free slot |
-| `pai build doctor` | Check the project's registered build doors |
+| `pai build doctor` | Check the project's registered build doors and hook events |
 | `pai build watch` | Internal: kill a build tree when its gate process dies |
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/cd.md

@@ -23,7 +23,7 @@ See also: `pai shell-init`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/clear-names.md

@@ -23,7 +23,7 @@ See also: `pai sessions pause-all`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/cockpit.md

@@ -58,7 +58,7 @@ See also: `pai router status`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/config.md

@@ -242,7 +242,7 @@ See also: `pai config unset`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/daemon.md

@@ -257,7 +257,7 @@ See also: `pai daemon status`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai db`](db.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.
 

package/docs/commands/db.md

@@ -129,7 +129,7 @@ See also: `pai db schema`
 
 ## See also
 
-[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
+[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai build`](build.md) · [`pai cd`](cd.md) · [`pai clear-names`](clear-names.md) · [`pai cockpit`](cockpit.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai doc`](doc.md) · [`pai end`](end.md) · [`pai find`](find.md) · [`pai git`](git.md) · [`pai handoff`](handoff.md) · [`pai harness`](harness.md) · [`pai help`](help.md) · [`pai home`](home.md) · [`pai hooks-db`](hooks-db.md) · [`pai identity`](identity.md) · [`pai install`](install.md) · [`pai issue`](issue.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai lessons`](lessons.md) · [`pai list`](list.md) · [`pai ls`](ls.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai models`](models.md) · [`pai more`](more.md) · [`pai new`](new.md) · [`pai notes`](notes.md) · [`pai notify`](notify.md) · [`pai observation`](observation.md) · [`pai obsidian`](obsidian.md) · [`pai open`](open.md) · [`pai pane`](pane.md) · [`pai pause`](pause.md) · [`pai plan`](plan.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai providers`](providers.md) · [`pai queue`](queue.md) · [`pai registry`](registry.md) · [`pai reload`](reload.md) · [`pai rename`](rename.md) · [`pai restore`](restore.md) · [`pai resume`](resume.md) · [`pai router`](router.md) · [`pai rules`](rules.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai setups`](setups.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai tasks`](tasks.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)
 
 Run `pai help <command>` to read any of these in the terminal.