ghostrail 0.7.5 → 0.9.0

package/dist/agent/result.d.ts

@@ -3,7 +3,8 @@ import type { AgentOutcome } from "../loop/ports.js";
  * Parse the result document the agent writes at the end of a run into an
  * {@link AgentOutcome}. The document is JSON with a `status` of `done`,
  * `blocked`, `failed`, or `noop`:
- * - `done` requires a string `summary` (missing/empty becomes "").
+ * - `done` requires a string `summary` (missing/empty becomes ""), and may
+ *   carry an optional `testPlan`.
  * - `blocked` requires a string `questions`.
  * - `failed` requires a string `error`.
  * - `noop` needs nothing else, and may carry a `reason` explaining why.

package/dist/agent/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/agent/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CA4D1D"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/agent/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAkE1D"}

package/dist/agent/result.js

@@ -2,7 +2,8 @@
  * Parse the result document the agent writes at the end of a run into an
  * {@link AgentOutcome}. The document is JSON with a `status` of `done`,
  * `blocked`, `failed`, or `noop`:
- * - `done` requires a string `summary` (missing/empty becomes "").
+ * - `done` requires a string `summary` (missing/empty becomes ""), and may
+ *   carry an optional `testPlan`.
  * - `blocked` requires a string `questions`.
  * - `failed` requires a string `error`.
  * - `noop` needs nothing else, and may carry a `reason` explaining why.
@@ -32,10 +33,15 @@ export function parseAgentResult(raw) {
             const type = typeof rawType === "string" && /^[a-z]+$/.test(rawType.trim().toLowerCase())
                 ? rawType.trim().toLowerCase()
                 : undefined;
+            // Optional, and blank counts as absent: the PR body omits the whole
+            // section rather than heading an empty one.
+            const rawPlan = record.testPlan;
+            const testPlan = typeof rawPlan === "string" && rawPlan.trim().length > 0 ? rawPlan.trim() : undefined;
             return {
                 status: "done",
                 summary: asString(record.summary),
                 ...(type === undefined ? {} : { type }),
+                ...(testPlan === undefined ? {} : { testPlan }),
             };
         }
         case "noop": {

package/dist/agent/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/agent/result.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/agent/result.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,2EAA2E;YAC3E,oDAAoD;YACpD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;YAC5B,MAAM,IAAI,GACR,OAAO,OAAO,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC1E,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC9B,CAAC,CAAC,SAAS,CAAC;YAChB,oEAAoE;YACpE,4CAA4C;YAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;YAChC,MAAM,QAAQ,GACZ,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACxF,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;gBACjC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;gBACvC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;aAChD,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,uEAAuE;YACvE,0EAA0E;YAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;oBACxD,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE;oBAC3B,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YACnC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;YACtF,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAC1C,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;YAC1F,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACrC,CAAC;QACD;YACE,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,uCAAuC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACvE,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/cli/commands.d.ts

@@ -1,4 +1,5 @@
 import type { ExecResult } from "../backend/types.js";
+import { type ServiceManager } from "../service/index.js";
 import type { Scope } from "../vendor/skilltend/paths.js";
 import { type Asker } from "./prompt.js";
 export interface CommandStreams {
@@ -52,15 +53,37 @@ export declare function parseBoardFlags(argv: readonly string[], defaults: Board
 export declare function cmdBoard(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
 /** `ghostrail artifacts`: list the shared artifacts available in the global store. */
 export declare function cmdArtifacts(argv: readonly string[], streams: CommandStreams, env?: CommandEnv): Promise<number>;
+/**
+ * How a registered ghostrail stands on disk. A stale entry is reported and
+ * never auto-pruned: an unmounted drive or a moved repo does not mean the
+ * operator stopped wanting that ghostrail, and quietly deleting their config to
+ * tidy a listing would be presumptuous.
+ */
+export type GhostrailHealth = "ok" | "no config" | "missing";
+/** Check one registered path without trusting the registry's own claims. */
+export declare function ghostrailHealth(path: string): Promise<GhostrailHealth>;
+/** `ghostrail ls`: the ghostrails this account knows about. */
+export declare function cmdLs(_argv: readonly string[], streams: CommandStreams, env?: CommandEnv): Promise<number>;
+/**
+ * `ghostrail start`: choose which ghostrails should be running, record that in
+ * the registry, and make the services match.
+ */
+export declare function cmdStart(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, ask?: Asker, isTty?: boolean, manager?: ServiceManager): Promise<number>;
+/** `ghostrail stop`: take ghostrails down without changing what should run. */
+export declare function cmdStop(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, manager?: ServiceManager): Promise<number>;
+/** `ghostrail status`: what each ghostrail is doing, and what it should be doing. */
+export declare function cmdStatus(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, manager?: ServiceManager): Promise<number>;
 /** The quickstart templates bundled with the package. */
 export declare const TEMPLATES: readonly ["code-local", "content-loop"];
 /**
- * `ghostrail init <template> [--repo <path>] [--force|--diff]`: scaffold
+ * `ghostrail init <template> [--repo <path>] [--force|--diff|--update]`: scaffold
  * `ghostrail.toml` and `prompts/` from a quickstart template. Safe for a fresh OR
  * an existing repo: existing files are left untouched (skipped) unless `--force`
- * is given. `--diff` reports drift instead of writing anything.
+ * is given. `--diff` reports drift instead of writing anything, and `--update`
+ * takes the template changes this repo never edited while naming what a
+ * customized file is missing.
  */
-export declare function cmdInit(argv: readonly string[], streams: CommandStreams, cwd?: string): Promise<number>;
+export declare function cmdInit(argv: readonly string[], streams: CommandStreams, cwd?: string, env?: CommandEnv): Promise<number>;
 interface SkillFlags {
     scope: Scope;
     agents: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.js

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process";
 import { access, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname, isAbsolute, join, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
 import { spawnCollect } from "../backend/proc.js";
@@ -9,16 +9,19 @@ import { DEFAULT_BOARD_PORT, PORT_FALLBACK_ATTEMPTS, isAddressInUse, isValidPort
 import { createBoardServer, isLoopback } from "../board/server.js";
 import { buildProposal, writeProfile } from "../claude-profile/index.js";
 import { parseDuration } from "../config/duration.js";
-import { parseMergedConfig } from "../config/load.js";
+import { parseConfig, parseMergedConfig } from "../config/load.js";
 import { STORE_DIR, buildLoopDeps, buildRespondDeps, buildTriageDeps, resolveRepoSlug, } from "../factory/build.js";
+import { findByPath, upsert } from "../global/registry.js";
 import { GlobalStore, resolveGlobalDir } from "../global/store.js";
 import { DEFAULT_FACTORY_IMAGE, dockerBuildArgs, dockerDir, parseImageFlags, } from "../image/build.js";
+import { extractPlaceholders, isClean, missingSignals, repoPathFor, } from "../init/drift.js";
 import { classify, hashContent, mergeManifest, readManifest, writeManifest, } from "../init/template.js";
 import { FileLock } from "../lock/file-lock.js";
 import { runTick } from "../loop/engine.js";
 import { watchLoop } from "../loop/watch.js";
 import { respondTick } from "../respond/respond.js";
 import { GLOBAL_SECRETS_FILE, appendPlaceholders, applyOverrides, launchEditor as defaultLaunchEditor, loadEnvOverrides, missingSecrets, readSecretsFile, redactSecrets, renderFile, resolveEditor, secretValuesOf, writeSecretsFile, } from "../secrets/index.js";
+import { stopTimeoutSeconds, systemdManager, unitName, } from "../service/index.js";
 import { applySkillPlan, describePlan, pathCtx, planSkillInstall, uninstallSkill, } from "../skill/install.js";
 import { FileStore } from "../store/file-store.js";
 import { triageTick } from "../triage/engine.js";
@@ -374,6 +377,250 @@ export async function cmdArtifacts(argv, streams, env = process.env) {
     streams.out(`artifacts:\n${names.map((name) => `  ${name}`).join("\n")}\n`);
     return 0;
 }
+/** Check one registered path without trusting the registry's own claims. */
+export async function ghostrailHealth(path) {
+    if (!(await pathExists(path)))
+        return "missing";
+    return (await pathExists(join(path, "ghostrail.toml"))) ? "ok" : "no config";
+}
+/** `ghostrail ls`: the ghostrails this account knows about. */
+export async function cmdLs(_argv, streams, env = process.env) {
+    const store = globalStoreFor(env);
+    const entries = await store.readRegistry();
+    if (entries === undefined) {
+        streams.err(`cannot parse ${store.registryPath()}\n`);
+        streams.err("fix or remove it; a registry that does not parse is treated as none at all\n");
+        return 1;
+    }
+    if (entries.length === 0) {
+        streams.out("no ghostrails registered yet\n");
+        streams.out("`ghostrail init <template>` registers a new one, and\n");
+        streams.out("`ghostrail init <template> --update` adopts a repo set up before the registry\n");
+        return 0;
+    }
+    const rows = await Promise.all(entries.map(async (entry) => ({ entry, health: await ghostrailHealth(entry.path) })));
+    const width = Math.max(...rows.map((row) => row.entry.name.length));
+    streams.out(`${store.registryPath()}\n\n`);
+    for (const { entry, health } of rows) {
+        const watch = entry.watch ? "watch" : "  off";
+        const note = health === "ok" ? "" : `  (${health})`;
+        streams.out(`  ${watch}  ${entry.name.padEnd(width)}  ${entry.path}${note}\n`);
+    }
+    if (rows.some((row) => row.health !== "ok")) {
+        streams.out("\nsome entries no longer resolve. remove one by deleting its block from\n");
+        streams.out(`${store.registryPath()}\n`);
+    }
+    return 0;
+}
+/** Resolve the absolute path of the running ghostrail binary, for a unit file. */
+function ghostrailExecPath() {
+    return process.argv[1] ?? "ghostrail";
+}
+/** A ghostrail's configured agent timeout, for the unit's stop timeout. */
+async function agentTimeoutMs(repo) {
+    const raw = await readIfPresent(join(repo, "ghostrail.toml"));
+    if (raw !== undefined) {
+        const parsed = parseConfig(raw);
+        if (parsed.ok)
+            return parsed.value.guardrails.timeoutMs;
+    }
+    return 30 * 60_000;
+}
+function parseSelectFlags(argv) {
+    const flags = { all: false, names: [], interval: "5m", yes: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--all" || arg === "-a")
+            flags.all = true;
+        else if ((arg === "--name" || arg === "-n") && next !== undefined) {
+            flags.names.push(next);
+            i++;
+        }
+        else if ((arg === "--interval" || arg === "-i") && next !== undefined) {
+            flags.interval = next;
+            i++;
+        }
+        else if (arg === "--yes" || arg === "-y")
+            flags.yes = true;
+    }
+    return flags;
+}
+/** Load the registry, reporting the two failure shapes distinctly. */
+async function loadRegistry(store, streams) {
+    const entries = await store.readRegistry();
+    if (entries === undefined) {
+        streams.err(`cannot parse ${store.registryPath()}\n`);
+        return undefined;
+    }
+    if (entries.length === 0) {
+        streams.out("no ghostrails registered yet\n");
+        streams.out("`ghostrail init <template>` registers one, and\n");
+        streams.out("`ghostrail init <template> --update` adopts an existing repo\n");
+    }
+    return entries;
+}
+/** Say what platform we are on when there is no service manager to use. */
+function explainNoManager(kind, streams, interval) {
+    if (kind === "launchd") {
+        streams.err("this machine uses launchd, which ghostrail cannot install services for yet\n");
+    }
+    else {
+        streams.err("no user service manager found (looked for systemd)\n");
+    }
+    streams.err(`run a ghostrail by hand instead:\n  cd <repo> && ghostrail watch --interval ${interval}\n`);
+}
+/**
+ * `ghostrail start`: choose which ghostrails should be running, record that in
+ * the registry, and make the services match.
+ */
+export async function cmdStart(argv, streams, env = process.env, ask = askOnTerminal, isTty = process.stdin.isTTY === true, manager = systemdManager(env)) {
+    const flags = parseSelectFlags(argv);
+    const store = globalStoreFor(env);
+    const entries = await loadRegistry(store, streams);
+    if (entries === undefined)
+        return 1;
+    if (entries.length === 0)
+        return 0;
+    // Which ghostrails should be watched after this command.
+    let chosen;
+    if (flags.all) {
+        chosen = [...entries];
+    }
+    else if (flags.names.length > 0) {
+        const wanted = new Set(flags.names);
+        chosen = entries.filter((e) => wanted.has(e.name) || wanted.has(e.path));
+        const missing = flags.names.filter((n) => !entries.some((e) => e.name === n || e.path === n));
+        for (const name of missing)
+            streams.err(`no registered ghostrail named ${name}\n`);
+        if (missing.length > 0)
+            return 1;
+    }
+    else if (isTty && !flags.yes) {
+        streams.out("Which ghostrails do you want to start?\n");
+        chosen = [];
+        for (const entry of entries) {
+            // Pre-answered from `watch`, so the prompt reflects the standing decision
+            // rather than asking it fresh every time.
+            if (await ask(`  ${entry.name}  (${entry.path})`, entry.watch))
+                chosen.push(entry);
+        }
+    }
+    else {
+        chosen = entries.filter((e) => e.watch);
+    }
+    const chosenPaths = new Set(chosen.map((e) => e.path));
+    // The selection IS the watch flag. One piece of state, so the CLI, the
+    // dashboard, and the units cannot disagree about what should be running.
+    const updated = entries.map((e) => ({ ...e, watch: chosenPaths.has(e.path) }));
+    await store.writeRegistry(updated);
+    const kind = await manager.kind();
+    if (kind !== "systemd") {
+        explainNoManager(kind, streams, flags.interval);
+        return 1;
+    }
+    let failed = false;
+    for (const entry of updated) {
+        const unit = unitName(entry.name, entry.path);
+        if (!entry.watch) {
+            const error = await manager.disable(unit);
+            if (error === undefined)
+                streams.out(`  stopped  ${entry.name}\n`);
+            continue;
+        }
+        if ((await ghostrailHealth(entry.path)) !== "ok") {
+            streams.err(`  skipped  ${entry.name}: ${entry.path} has no ghostrail.toml\n`);
+            failed = true;
+            continue;
+        }
+        const spec = {
+            name: entry.name,
+            path: entry.path,
+            exec: ghostrailExecPath(),
+            interval: flags.interval,
+            stopTimeoutSec: stopTimeoutSeconds(await agentTimeoutMs(entry.path)),
+        };
+        const { outcome, file } = await manager.install(spec);
+        if (outcome === "hand-edited") {
+            streams.err(`  skipped  ${entry.name}: ${file} was edited; remove it to regenerate\n`);
+            failed = true;
+            continue;
+        }
+        const error = await manager.enable(unit);
+        if (error !== undefined) {
+            streams.err(`  failed   ${entry.name}: ${error}\n`);
+            failed = true;
+            continue;
+        }
+        streams.out(`  started  ${entry.name}  (${outcome === "written" ? "new unit" : "unit unchanged"})\n`);
+    }
+    streams.out("\n`watch` ticks the fix queue only; `respond` and `triage` still need their own schedule\n");
+    return failed ? 1 : 0;
+}
+/** `ghostrail stop`: take ghostrails down without changing what should run. */
+export async function cmdStop(argv, streams, env = process.env, manager = systemdManager(env)) {
+    const flags = parseSelectFlags(argv);
+    const store = globalStoreFor(env);
+    const entries = await loadRegistry(store, streams);
+    if (entries === undefined)
+        return 1;
+    if (entries.length === 0)
+        return 0;
+    const wanted = new Set(flags.names);
+    const targets = flags.names.length > 0
+        ? entries.filter((e) => wanted.has(e.name) || wanted.has(e.path))
+        : entries.filter((e) => flags.all || e.watch);
+    if (targets.length === 0) {
+        streams.out("nothing to stop\n");
+        return 0;
+    }
+    const kind = await manager.kind();
+    if (kind !== "systemd") {
+        explainNoManager(kind, streams, flags.interval);
+        return 1;
+    }
+    // Say this before the first stop, not after: an in-flight tick is not
+    // interrupted, so this can sit for minutes and look hung.
+    streams.out("stopping; a ghostrail mid-tick finishes its run first, which can take minutes\n");
+    let failed = false;
+    for (const entry of targets) {
+        const error = await manager.disable(unitName(entry.name, entry.path));
+        if (error !== undefined) {
+            streams.err(`  failed   ${entry.name}: ${error}\n`);
+            failed = true;
+            continue;
+        }
+        streams.out(`  stopped  ${entry.name}\n`);
+    }
+    // Deliberately does not touch `watch`: "not running now" and "should not run"
+    // are different statements, and only the operator makes the second one.
+    return failed ? 1 : 0;
+}
+/** `ghostrail status`: what each ghostrail is doing, and what it should be doing. */
+export async function cmdStatus(argv, streams, env = process.env, manager = systemdManager(env)) {
+    const store = globalStoreFor(env);
+    const entries = await loadRegistry(store, streams);
+    if (entries === undefined)
+        return 1;
+    if (entries.length === 0)
+        return 0;
+    const kind = await manager.kind();
+    const units = entries.map((e) => unitName(e.name, e.path));
+    const states = kind === "systemd" ? await manager.states(units) : new Map();
+    const width = Math.max(...entries.map((e) => e.name.length));
+    for (const [i, entry] of entries.entries()) {
+        const unit = units[i];
+        const state = kind === "systemd" ? (states.get(unit) ?? "unknown") : "unknown";
+        const health = await ghostrailHealth(entry.path);
+        const wants = entry.watch ? "watch" : "  off";
+        const note = health === "ok" ? "" : `  (${health})`;
+        streams.out(`  ${wants}  ${state.padEnd(8)}  ${entry.name.padEnd(width)}  ${entry.path}${note}\n`);
+    }
+    if (kind !== "systemd") {
+        streams.out("\nno supported service manager here, so nothing is reported as running\n");
+    }
+    return 0;
+}
 /** The quickstart templates bundled with the package. */
 export const TEMPLATES = ["code-local", "content-loop"];
 function templatesDir() {
@@ -477,17 +724,171 @@ async function reportTemplateDiff(template, srcDir, repo, streams) {
     }
     return 0;
 }
+/** The global store for this environment. */
+function globalStoreFor(env) {
+    return new GlobalStore(resolveGlobalDir({ GHOSTRAIL_HOME: env.GHOSTRAIL_HOME, XDG_CONFIG_HOME: env.XDG_CONFIG_HOME }, homedir()));
+}
+/** A ghostrail's display name: `[factory].name`, else the directory. */
+async function ghostrailName(repo) {
+    const raw = await readIfPresent(join(repo, "ghostrail.toml"));
+    if (raw !== undefined) {
+        const parsed = parseConfig(raw);
+        if (parsed.ok && parsed.value.factory.name.length > 0)
+            return parsed.value.factory.name;
+    }
+    return basename(repo);
+}
+/**
+ * Record this repo in the ghostrails registry, so `start` and the board have
+ * something to list. Adding only: an entry that already exists is left exactly
+ * as it is, because re-running `init --update` must not switch `watch` back on
+ * for a ghostrail the operator deliberately turned off.
+ *
+ * Never fails the command. Scaffolding the repo is the job; registering it is a
+ * convenience, and aborting a good scaffold over an unwritable config dir would
+ * be the worse trade.
+ */
+async function registerGhostrail(repo, env, streams) {
+    const store = globalStoreFor(env);
+    const path = resolve(repo);
+    try {
+        const entries = await store.readRegistry();
+        if (entries === undefined) {
+            streams.err(`note: ${store.registryPath()} could not be parsed, so this ghostrail was not registered\n`);
+            return;
+        }
+        if (findByPath(entries, path) !== undefined)
+            return;
+        const entry = {
+            name: await ghostrailName(repo),
+            path,
+            added: new Date().toISOString().slice(0, 10),
+            watch: true,
+        };
+        await store.writeRegistry(upsert(entries, entry));
+        streams.out(`registered ghostrail "${entry.name}" (${path})\n`);
+    }
+    catch (error) {
+        streams.err(`note: could not register this ghostrail: ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+/**
+ * Prompt paths a config file names, by role. `undefined` when the file cannot
+ * be read or parsed, which is a different thing from a config that names no
+ * prompts, and the two need opposite handling in {@link repoPathFor}.
+ */
+async function promptPathsAt(configPath) {
+    const raw = await readIfPresent(configPath);
+    if (raw === undefined)
+        return undefined;
+    const parsed = parseConfig(raw);
+    if (!parsed.ok)
+        return undefined;
+    const { agent, respond, triage } = parsed.value;
+    return {
+        agent: agent.prompt,
+        ...(respond === undefined ? {} : { respond: respond.prompt }),
+        ...(triage === undefined ? {} : { triage: triage.prompt }),
+    };
+}
+/**
+ * `ghostrail init <template> --update`: take the template changes this repo
+ * never edited, and name what a customized file is missing.
+ *
+ * Two jobs split by whether the answer is mechanical. A file still matching its
+ * recorded baseline was never touched, so a changed template can overwrite it.
+ * A file the repo edited is never written; instead the placeholders and result
+ * fields the template gained are named, because that is what every hand port has
+ * actually consisted of, and the skill places them in the repo's own wording.
+ */
+async function applyTemplateUpdate(template, srcDir, repo, streams, env) {
+    const manifest = await readManifest(repo);
+    const rels = await scaffoldFiles(srcDir);
+    const templatePrompts = (await promptPathsAt(join(srcDir, "ghostrail.toml"))) ?? {};
+    const repoPrompts = await promptPathsAt(join(repo, "ghostrail.toml"));
+    // The installed template is the last PUBLISHED release, so say what was
+    // compared against: a repo can be current with the release and behind main.
+    streams.out(`comparing against ${template} @ ${VERSION}\n\n`);
+    const written = {};
+    let pending = 0;
+    let took = 0;
+    for (const rel of rels) {
+        const key = manifestKey(rel);
+        const repoRel = repoPathFor(key, templatePrompts, repoPrompts);
+        if (repoRel === undefined) {
+            // A stage this repo has not enabled. Nothing to carry into it.
+            streams.out(`  ${key}\n    not configured in this repo, skipped\n`);
+            continue;
+        }
+        const templateContent = await readFile(join(srcDir, rel), "utf8");
+        const current = await readIfPresent(join(repo, repoRel));
+        const status = classify(current === undefined ? undefined : hashContent(current), hashContent(templateContent), manifest?.files[key]);
+        if (status === "up-to-date") {
+            streams.out(`  ${repoRel}\n    up to date\n`);
+            continue;
+        }
+        if (status === "missing") {
+            // Scaffolding an absent file is what plain `init` is for. Doing it here
+            // would make --update write files nobody asked it to carry, and would
+            // break its one safety claim: it only ever writes what it can prove is
+            // untouched.
+            streams.out(`  ${repoRel}\n    absent; \`ghostrail init ${template}\` scaffolds it\n`);
+            continue;
+        }
+        if (status === "upstream-changed") {
+            // Still hashes to its baseline, so the repo never edited it and taking
+            // the template destroys nothing. This is the only case that writes.
+            await mkdir(dirname(join(repo, repoRel)), { recursive: true });
+            await writeFile(join(repo, repoRel), templateContent, "utf8");
+            written[key] = hashContent(templateContent);
+            took++;
+            streams.out(`  ${repoRel}\n    took the template's version (you had not edited it)\n`);
+            continue;
+        }
+        // Customized, or no baseline to prove otherwise. Never written.
+        const signals = missingSignals(current ?? "", templateContent);
+        if (isClean(signals)) {
+            streams.out(`  ${repoRel}\n    customized, nothing to take\n`);
+            continue;
+        }
+        streams.out(`  ${repoRel}\n    customized, and the template gained:\n`);
+        for (const name of signals.placeholders) {
+            streams.out(`      placeholder   {{${name}}}\n`);
+            pending++;
+        }
+        for (const name of signals.fields) {
+            streams.out(`      result field  "${name}"\n`);
+            pending++;
+        }
+    }
+    if (Object.keys(written).length > 0) {
+        await writeManifest(repo, mergeManifest(manifest, template, VERSION, written));
+    }
+    await registerGhostrail(repo, env, streams);
+    streams.out("\n");
+    if (took > 0)
+        streams.out(`took ${took} file(s) you had not edited\n`);
+    if (pending === 0) {
+        streams.out("nothing needs placing by hand\n");
+        return 0;
+    }
+    streams.out(`${pending} signal(s) need placing in prompts you have customized.\nRun \`/ghostrail update\` and the skill will port them into your own wording.\n`);
+    return 0;
+}
 /**
- * `ghostrail init <template> [--repo <path>] [--force|--diff]`: scaffold
+ * `ghostrail init <template> [--repo <path>] [--force|--diff|--update]`: scaffold
  * `ghostrail.toml` and `prompts/` from a quickstart template. Safe for a fresh OR
  * an existing repo: existing files are left untouched (skipped) unless `--force`
- * is given. `--diff` reports drift instead of writing anything.
+ * is given. `--diff` reports drift instead of writing anything, and `--update`
+ * takes the template changes this repo never edited while naming what a
+ * customized file is missing.
  */
-export async function cmdInit(argv, streams, cwd = process.cwd()) {
+export async function cmdInit(argv, streams, cwd = process.cwd(), env = process.env) {
     let template;
     let repo = cwd;
     let force = false;
     let diff = false;
+    let update = false;
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
         const next = argv[i + 1];
@@ -501,19 +902,37 @@ export async function cmdInit(argv, streams, cwd = process.cwd()) {
         else if (arg === "--diff") {
             diff = true;
         }
+        else if (arg === "--update") {
+            update = true;
+        }
         else if (arg !== undefined && !arg.startsWith("-")) {
             template ??= arg;
         }
     }
     if (template === undefined || !TEMPLATES.includes(template)) {
-        streams.err(`usage: ghostrail init <template> [--repo <path>] [--force|--diff]\ntemplates: ${TEMPLATES.join(", ")}\n`);
+        streams.err(`usage: ghostrail init <template> [--repo <path>] [--force|--diff|--update]\ntemplates: ${TEMPLATES.join(", ")}\n`);
         return 1;
     }
     if (diff && force) {
         streams.err("init: --diff is read-only and cannot be combined with --force\n");
         return 1;
     }
+    if (update && (force || diff)) {
+        // --force overwrites customizations and --diff writes nothing, so neither
+        // has a sensible ordering against --update. Refuse rather than pick one.
+        streams.err("init: --update cannot be combined with --force or --diff\n");
+        return 1;
+    }
     const srcDir = join(templatesDir(), template);
+    if (update) {
+        try {
+            return await applyTemplateUpdate(template, srcDir, repo, streams, env);
+        }
+        catch (error) {
+            streams.err(`init --update failed: ${error instanceof Error ? error.message : String(error)}\n`);
+            return 1;
+        }
+    }
     if (diff) {
         try {
             return await reportTemplateDiff(template, srcDir, repo, streams);
@@ -567,7 +986,7 @@ export async function cmdInit(argv, streams, cwd = process.cwd()) {
         streams.out(`, kept ${skipped.length} existing (${skipped.join(", ")}; use --force to overwrite)`);
     }
     streams.out("\n");
-    // A pointer, not an action: init does not write outside the repo's own files.
+    await registerGhostrail(repo, env, streams);
     streams.out("next: `ghostrail skill` installs the /ghostrail skill for your coding agent,\n");
     streams.out("      then run `/ghostrail customize` there to tailor the prompts to this repo\n");
     return 0;