ghostrail 0.8.0 → 0.10.0

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 {
@@ -50,8 +51,38 @@ interface BoardFlags {
 export declare function parseBoardFlags(argv: readonly string[], defaults: BoardFlags): BoardFlags;
 /** `ghostrail board`: serve the run store as a dashboard. Runs until stopped. */
 export declare function cmdBoard(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
+/** The cross-ghostrail dashboard's default port, one above the board's. */
+export declare const DEFAULT_DASHBOARD_PORT = 5051;
+/**
+ * `ghostrail dashboard`: serve every registered ghostrail.
+ *
+ * This is what the dashboard's service unit invokes, the way `watch` is what a
+ * ghostrail's unit invokes. Running it by hand works, but `ghostrail start` is
+ * how most people will meet it.
+ */
+export declare function cmdDashboard(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, manager?: ServiceManager): 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"];
 /**
@@ -62,7 +93,7 @@ export declare const TEMPLATES: readonly ["code-local", "content-loop"];
  * 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";
@@ -10,7 +10,9 @@ import { createBoardServer, isLoopback } from "../board/server.js";
 import { buildProposal, writeProfile } from "../claude-profile/index.js";
 import { parseDuration } from "../config/duration.js";
 import { parseConfig, parseMergedConfig } from "../config/load.js";
+import { createDashboardServer } from "../dashboard/index.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";
@@ -20,6 +22,7 @@ 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 { DASHBOARD_UNIT, renderDashboardUnit, 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";
@@ -363,6 +366,71 @@ export function cmdBoard(argv, streams, env = process.env, cwd = process.cwd())
         });
     });
 }
+/** The cross-ghostrail dashboard's default port, one above the board's. */
+export const DEFAULT_DASHBOARD_PORT = 5051;
+/** Build the dashboard server's dependencies from the real environment. */
+function dashboardDeps(env, manager) {
+    const store = globalStoreFor(env);
+    return {
+        readRegistry: () => store.readRegistry(),
+        writeRegistry: (entries) => store.writeRegistry(entries),
+        health: ghostrailHealth,
+        states: async (entries) => {
+            if ((await manager.kind()) !== "systemd")
+                return new Map();
+            const units = entries.map((e) => unitName(e.name, e.path));
+            const byUnit = await manager.states(units);
+            // Keyed by path, since that is a ghostrail's identity everywhere else.
+            return new Map(entries.map((e, i) => [e.path, byUnit.get(units[i]) ?? "unknown"]));
+        },
+    };
+}
+/**
+ * `ghostrail dashboard`: serve every registered ghostrail.
+ *
+ * This is what the dashboard's service unit invokes, the way `watch` is what a
+ * ghostrail's unit invokes. Running it by hand works, but `ghostrail start` is
+ * how most people will meet it.
+ */
+export function cmdDashboard(argv, streams, env = process.env, manager = systemdManager(env)) {
+    const flags = parseBoardFlags(argv, {
+        repo: ".",
+        port: DEFAULT_DASHBOARD_PORT,
+        bind: "127.0.0.1",
+        portExplicit: false,
+        noToken: false,
+        ...(env.GHOSTRAIL_BOARD_TOKEN === undefined ? {} : { token: env.GHOSTRAIL_BOARD_TOKEN }),
+    });
+    const unauthenticated = flags.noToken && flags.token === undefined;
+    if (unauthenticated && !isLoopback(flags.bind)) {
+        streams.err(`serving the dashboard unauthenticated on ${flags.bind}: anyone who can reach this host can read your run history and change which ghostrails run\n`);
+    }
+    const server = createDashboardServer(dashboardDeps(env, manager), {
+        bind: flags.bind,
+        ...(flags.token === undefined ? {} : { token: flags.token }),
+    });
+    const candidates = flags.portExplicit
+        ? [flags.port]
+        : portCandidates(flags.port, PORT_FALLBACK_ATTEMPTS);
+    return new Promise((resolve) => {
+        let index = 0;
+        server.on("error", (error) => {
+            const next = candidates[index + 1];
+            if (isAddressInUse(error) && next !== undefined) {
+                index++;
+                server.listen(next, flags.bind);
+                return;
+            }
+            streams.err(`dashboard error: ${error.message}\n`);
+            resolve(1);
+        });
+        const first = candidates[0] ?? flags.port;
+        server.listen(first, flags.bind, () => {
+            const bound = candidates[index] ?? first;
+            streams.out(`ghostrail dashboard on http://${flags.bind}:${bound}/\n`);
+        });
+    });
+}
 /** `ghostrail artifacts`: list the shared artifacts available in the global store. */
 export async function cmdArtifacts(argv, streams, env = process.env) {
     const dir = resolveGlobalDir({ GHOSTRAIL_HOME: env.GHOSTRAIL_HOME, XDG_CONFIG_HOME: env.XDG_CONFIG_HOME }, homedir());
@@ -375,6 +443,293 @@ 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,
+        noDashboard: 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;
+        else if (arg === "--no-dashboard")
+            flags.noDashboard = 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`);
+    }
+    // The dashboard is how you see what any of this is doing, so it comes up with
+    // the ghostrails rather than being a command to remember.
+    if (!flags.noDashboard) {
+        const outcome = await manager.installRaw(DASHBOARD_UNIT, renderDashboardUnit(ghostrailExecPath(), DEFAULT_DASHBOARD_PORT, "127.0.0.1"));
+        if (outcome === "hand-edited") {
+            streams.err("  skipped  dashboard: its unit was edited; remove it to regenerate\n");
+            failed = true;
+        }
+        else {
+            const error = await manager.enable(DASHBOARD_UNIT);
+            if (error === undefined) {
+                streams.out(`  started  dashboard  http://127.0.0.1:${DEFAULT_DASHBOARD_PORT}/\n`);
+            }
+            else {
+                streams.err(`  failed   dashboard: ${error}\n`);
+                failed = true;
+            }
+        }
+    }
+    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`);
+    }
+    // The dashboard came up with them, so it goes down with them. Leaving it
+    // serving a board of things that are not running would be its own confusion.
+    if (!flags.noDashboard) {
+        const error = await manager.disable(DASHBOARD_UNIT);
+        if (error === undefined)
+            streams.out("  stopped  dashboard\n");
+        else {
+            streams.err(`  failed   dashboard: ${error}\n`);
+            failed = true;
+        }
+    }
+    // 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") {
+        // Listed with the ghostrails so "what is running" has one answer, not two.
+        const dash = (await manager.states([DASHBOARD_UNIT])).get(DASHBOARD_UNIT) ?? "unknown";
+        streams.out(`\n        ${dash.padEnd(8)}  dashboard  http://127.0.0.1:${DEFAULT_DASHBOARD_PORT}/\n`);
+    }
+    else {
+        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() {
@@ -478,6 +833,54 @@ 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
@@ -507,7 +910,7 @@ async function promptPathsAt(configPath) {
  * 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) {
+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"))) ?? {};
@@ -570,6 +973,7 @@ async function applyTemplateUpdate(template, srcDir, repo, streams) {
     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`);
@@ -588,7 +992,7 @@ async function applyTemplateUpdate(template, srcDir, repo, streams) {
  * 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;
@@ -631,7 +1035,7 @@ export async function cmdInit(argv, streams, cwd = process.cwd()) {
     const srcDir = join(templatesDir(), template);
     if (update) {
         try {
-            return await applyTemplateUpdate(template, srcDir, repo, streams);
+            return await applyTemplateUpdate(template, srcDir, repo, streams, env);
         }
         catch (error) {
             streams.err(`init --update failed: ${error instanceof Error ? error.message : String(error)}\n`);
@@ -691,7 +1095,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;