carrick 0.3.53

package/dist/hook/session-start.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/hook/session-start.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// SessionStart hook: one orientation line about the index this workspace has.
+//
+// `carrick status --json` is the read that answers for a workspace: `check` and
+// `touch` each take exactly one file. It carries, per service, what the index
+// holds, the commit it was taken at, how far that repo has moved since, and the
+// boundary. Claude Code adds a SessionStart hook's stdout to the session on
+// exit 0, so a plain print is the whole mechanism.
+//
+// This is not a verdict channel. `status` states what is indexed and what each
+// service could not classify, and nothing about whether a contract holds, so
+// the line cannot be confused with the hook or LSP delivery of a verdict.
+// `CARRICK_CHANNEL=off` silences it along with everything else.
+import { status } from "../cli.js";
+import { resolveChannel } from "../channel.js";
+import { createLogger } from "../log.js";
+import { renderSessionStart } from "../render.js";
+import { resolveRoot, rootNote } from "../root.js";
+const log = createLogger("carrick-session");
+async function main() {
+    if (resolveChannel({ hooksInstalled: true }).channel === "off") {
+        log("CARRICK_CHANNEL=off; printing nothing");
+        return;
+    }
+    const choice = resolveRoot({
+        clientRoot: process.cwd(),
+        projectDir: process.env["CLAUDE_PROJECT_DIR"] ?? null,
+        filePath: process.cwd(),
+    });
+    const note = rootNote(choice);
+    if (note)
+        log(note);
+    const outcome = await status({ cwd: choice.root, workspace: choice.markerFound ? choice.root : null });
+    if (!outcome.result) {
+        log("no answer", outcome.failure ?? "");
+        return;
+    }
+    // Ends with a newline: this is a line a developer also runs by hand and
+    // compares against `carrick status`, and that one ends its output properly.
+    process.stdout.write(`${renderSessionStart(outcome.result)}\n`);
+}
+await main();
+process.exit(0);
+//# sourceMappingURL=session-start.js.map

package/dist/hook/session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hook/session-start.ts"],"names":[],"mappings":";AACA,8EAA8E;AAC9E,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,mDAAmD;AACnD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,gEAAgE;AAEhE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,IAAI,cAAc,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC/D,GAAG,CAAC,uCAAuC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE;QACzB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI;QACrD,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAEpB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,wEAAwE;IACxE,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,IAAI,EAAE,CAAC;AACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/init/identity.d.ts

@@ -0,0 +1,20 @@
+export type Identity = {
+    /** The GitHub login, when the source could name one. */
+    login: string | null;
+    source: "gh" | "token";
+};
+export type IdentityLookup = {
+    identity: Identity | null;
+    /** What to do about it, ready to print. Null when there is an identity. */
+    problem: string | null;
+};
+export type IdentityOptions = {
+    env?: NodeJS.ProcessEnv;
+    /** Injectable for tests: runs `gh auth status` and returns its output. */
+    ghStatus?: () => string;
+};
+/** The login out of `gh auth status`, whatever wording it used. */
+export declare function loginFromGhStatus(output: string): string | null;
+export declare function githubIdentity(options?: IdentityOptions): IdentityLookup;
+/** One line for the summary. */
+export declare function describeIdentity(identity: Identity): string;

package/dist/init/identity.js

@@ -0,0 +1,60 @@
+// The GitHub identity `carrick init` requires.
+//
+// There is no anonymous tier (carrick#729, ruled 2026-09-08): the local index
+// is built from the identified free tier's allowance, so setup asks who you are
+// before it writes anything. The check is offline and reuses whatever the
+// machine already has — the GitHub CLI's login, or a token in the environment —
+// rather than opening a browser flow of its own.
+//
+// This states the identity. Spending an allowance against it is the cloud's
+// side (carrick-cloud#601) and is not wired here.
+import { spawnSync } from "node:child_process";
+function defaultGhStatus() {
+    // Both streams: `gh auth status` writes to stderr on older versions and to
+    // stdout on newer ones, and a run that reads one of them finds nothing on
+    // half the machines it runs on.
+    const run = spawnSync("gh", ["auth", "status"], { encoding: "utf8" });
+    if (run.error)
+        throw run.error;
+    return `${run.stdout ?? ""}\n${run.stderr ?? ""}`;
+}
+/** The login out of `gh auth status`, whatever wording it used. */
+export function loginFromGhStatus(output) {
+    const match = /Logged in to \S+ account (\S+)/.exec(output) ?? /Logged in to \S+ as (\S+)/.exec(output);
+    return match?.[1] ?? null;
+}
+export function githubIdentity(options = {}) {
+    const env = options.env ?? process.env;
+    const ghStatus = options.ghStatus ?? defaultGhStatus;
+    try {
+        const login = loginFromGhStatus(ghStatus());
+        if (login)
+            return { identity: { login, source: "gh" }, problem: null };
+    }
+    catch {
+        // No gh, or gh is not logged in. The token below is the other way in.
+    }
+    const token = env["GITHUB_TOKEN"] || env["GH_TOKEN"];
+    if (token)
+        return { identity: { login: null, source: "token" }, problem: null };
+    return {
+        identity: null,
+        problem: [
+            "carrick init needs your GitHub identity, and this machine has none it can use.",
+            "",
+            "Either:",
+            "  gh auth login                 (the GitHub CLI: https://cli.github.com)",
+            "  export GITHUB_TOKEN=<token>   (any token that identifies you)",
+            "",
+            "Carrick indexes what you already have access to, and the free tier's",
+            "allowance is counted against the account that asks for it.",
+        ].join("\n"),
+    };
+}
+/** One line for the summary. */
+export function describeIdentity(identity) {
+    return identity.login
+        ? `GitHub identity: ${identity.login} (from the GitHub CLI)`
+        : "GitHub identity: the token in this environment";
+}
+//# sourceMappingURL=identity.js.map

package/dist/init/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/init/identity.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,0EAA0E;AAC1E,gFAAgF;AAChF,iDAAiD;AACjD,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAoB/C,SAAS,eAAe;IACtB,2EAA2E;IAC3E,0EAA0E;IAC1E,gCAAgC;IAChC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,IAAI,GAAG,CAAC,KAAK;QAAE,MAAM,GAAG,CAAC,KAAK,CAAC;IAC/B,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACpD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,KAAK,GACT,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5F,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA2B,EAAE;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEhF,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE;YACP,gFAAgF;YAChF,EAAE;YACF,SAAS;YACT,0EAA0E;YAC1E,iEAAiE;YACjE,EAAE;YACF,sEAAsE;YACtE,4DAA4D;SAC7D,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,OAAO,QAAQ,CAAC,KAAK;QACnB,CAAC,CAAC,oBAAoB,QAAQ,CAAC,KAAK,wBAAwB;QAC5D,CAAC,CAAC,gDAAgD,CAAC;AACvD,CAAC"}

package/dist/init/repos.d.ts

@@ -0,0 +1,19 @@
+export type FindOptions = {
+    readdir?: (dir: string) => Array<{
+        name: string;
+        isDirectory: () => boolean;
+    }>;
+    exists?: (target: string) => boolean;
+};
+export declare function findRepos(workspace: string, options?: FindOptions): string[];
+/**
+ * The workspace file to write: the repos already listed, in the order they were
+ * listed, plus the ones found since. Re-running init updates rather than
+ * duplicates, and never reorders or drops a path a user put there by hand —
+ * including one pointing outside this folder.
+ */
+export declare function mergeWorkspace(existing: string | null, found: string[]): {
+    body: string;
+    repos: string[];
+    added: string[];
+};

package/dist/init/repos.js

@@ -0,0 +1,46 @@
+// Which directories in this folder are repos to index.
+//
+// A proposal, not a decision: the list goes into `carrick-workspace.json`,
+// which the scanner reads literally and a user can edit. There is no walk
+// deeper than one level and no search order to reason about (E20) — a repo is
+// a directory here with a `package.json` in it.
+import fs from "node:fs";
+import path from "node:path";
+/** Directories that are never a repo, whatever they hold. */
+const NEVER = new Set(["node_modules", "dist", "build", "out", "coverage", "target"]);
+export function findRepos(workspace, options = {}) {
+    const readdir = options.readdir ?? ((dir) => fs.readdirSync(dir, { withFileTypes: true }));
+    const exists = options.exists ?? ((target) => fs.existsSync(target));
+    const found = [];
+    for (const entry of readdir(workspace)) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name.startsWith(".") || NEVER.has(entry.name))
+            continue;
+        if (!exists(path.join(workspace, entry.name, "package.json")))
+            continue;
+        found.push(`./${entry.name}`);
+    }
+    return found.sort();
+}
+/**
+ * The workspace file to write: the repos already listed, in the order they were
+ * listed, plus the ones found since. Re-running init updates rather than
+ * duplicates, and never reorders or drops a path a user put there by hand —
+ * including one pointing outside this folder.
+ */
+export function mergeWorkspace(existing, found) {
+    let listed = [];
+    if (existing) {
+        const parsed = JSON.parse(existing);
+        if (Array.isArray(parsed.repos)) {
+            listed = parsed.repos.filter((entry) => typeof entry === "string");
+        }
+    }
+    const normal = (entry) => entry.replace(/^\.\//, "").replace(/\/$/, "");
+    const known = new Set(listed.map(normal));
+    const added = found.filter((entry) => !known.has(normal(entry)));
+    const repos = [...listed, ...added];
+    return { body: `${JSON.stringify({ repos }, null, 2)}\n`, repos, added };
+}
+//# sourceMappingURL=repos.js.map

package/dist/init/repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.js","sourceRoot":"","sources":["../../src/init/repos.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,8EAA8E;AAC9E,gDAAgD;AAEhD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,6DAA6D;AAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAOtF,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,UAAuB,EAAE;IACpE,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAAE,SAAS;QACxE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAuB,EAAE,KAAe;IAKrE,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAwB,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC3E,CAAC"}

package/dist/init/run.d.ts

@@ -0,0 +1,11 @@
+export type InitOptions = {
+    workspace: string;
+    /** Answer yes to the repo list rather than asking. */
+    assumeYes: boolean;
+    /** Write the files, print the lines, and do not build the index. */
+    skipIndex: boolean;
+};
+export declare function parseArgs(argv: string[], cwd?: string): InitOptions | string;
+export declare function init(argv: string[]): Promise<number>;
+/** `carrick templates <name>`, so the workflow above is one command. */
+export declare function templates(argv: string[]): number;

package/dist/init/run.js

@@ -0,0 +1,228 @@
+// `carrick init`: the one command, run in the folder that holds the repos.
+//
+// It does the four things that are otherwise four installs — the repo list,
+// the first index, the agent hooks, and the editor line — and prints the two
+// it cannot do for you. Everything it writes is a file you can read and edit
+// afterwards; nothing here is state only Carrick understands.
+//
+// Re-running it updates rather than duplicates: the repo list keeps the order
+// and the hand-written entries it already had, and the hook entries are merged
+// by command rather than replacing the settings file's `hooks` key.
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { spawnSync } from "node:child_process";
+import { describeIdentity, githubIdentity } from "./identity.js";
+import { findRepos, mergeWorkspace } from "./repos.js";
+import { hookCommand, mergeCarrickHooks } from "./settings.js";
+import { renderTemplate } from "../templates.js";
+import { resolveNativeBinary, nativeEnv, packageRoot } from "../native.js";
+const WORKSPACE_FILE = "carrick-workspace.json";
+const SETTINGS_FILE = path.join(".claude", "settings.json");
+const MCP_LINE = "claude mcp add --scope user --transport http carrick https://api.carrick.tools/mcp";
+export function parseArgs(argv, cwd = process.cwd()) {
+    const options = { workspace: cwd, assumeYes: false, skipIndex: false };
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        switch (argument) {
+            case "--yes":
+            case "-y":
+                options.assumeYes = true;
+                break;
+            case "--skip-index":
+                options.skipIndex = true;
+                break;
+            case "--workspace":
+            case "-w": {
+                const value = argv[index + 1];
+                if (!value)
+                    return "--workspace needs a directory";
+                options.workspace = path.resolve(cwd, value);
+                index += 1;
+                break;
+            }
+            case "--help":
+            case "-h":
+                return help();
+            default:
+                if (argument?.startsWith("-"))
+                    return `unknown option for \`carrick init\`: ${argument}`;
+                options.workspace = path.resolve(cwd, argument ?? ".");
+        }
+    }
+    return options;
+}
+function help() {
+    return [
+        "carrick init [DIRECTORY]",
+        "",
+        "Set up the folder that holds your repos: the list to index, the first index,",
+        "and the wiring that puts its answers where you work.",
+        "",
+        "    -w, --workspace DIR  The folder holding the repos (default: this one)",
+        "    -y, --yes            Take the repo list as proposed",
+        "        --skip-index     Write the files and print the lines, index later",
+    ].join("\n");
+}
+function say(line = "") {
+    process.stdout.write(`${line}\n`);
+}
+async function confirm(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await rl.question(`${question} [Y/n] `);
+        return answer.trim() === "" || /^y(es)?$/i.test(answer.trim());
+    }
+    finally {
+        rl.close();
+    }
+}
+function writeIfChanged(target, body) {
+    const existing = fs.existsSync(target) ? fs.readFileSync(target, "utf8") : null;
+    if (existing === body)
+        return "unchanged";
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, body);
+    return "written";
+}
+/** Whether a command answers on this machine, for a line we should not print. */
+function onPath(command) {
+    const probe = spawnSync(process.platform === "win32" ? "where" : "which", [command], {
+        stdio: "ignore",
+    });
+    return probe.status === 0;
+}
+export async function init(argv) {
+    const parsed = parseArgs(argv);
+    if (typeof parsed === "string") {
+        process.stdout.write(`${parsed}\n`);
+        return parsed.startsWith("carrick init") ? 0 : 2;
+    }
+    const { workspace } = parsed;
+    if (!fs.existsSync(workspace)) {
+        process.stderr.write(`carrick init: ${workspace} is not a directory on this machine\n`);
+        return 1;
+    }
+    // 1. Who is asking. There is no anonymous tier: the local index draws on the
+    //    identified free tier's allowance, so this is the first question and not
+    //    a thing to discover halfway through a scan.
+    const lookup = githubIdentity();
+    if (!lookup.identity) {
+        process.stderr.write(`${lookup.problem}\n`);
+        return 1;
+    }
+    say(describeIdentity(lookup.identity));
+    say();
+    // 2. The repos, proposed and confirmed.
+    const workspaceFile = path.join(workspace, WORKSPACE_FILE);
+    const existing = fs.existsSync(workspaceFile) ? fs.readFileSync(workspaceFile, "utf8") : null;
+    const found = findRepos(workspace);
+    const merged = mergeWorkspace(existing, found);
+    if (merged.repos.length === 0) {
+        process.stderr.write(`carrick init: no repos in ${workspace}. Carrick indexes the directories beside each other, so run it in the folder that holds them, or pass one: carrick init ~/code\n`);
+        return 1;
+    }
+    say(`Repos to index, in ${workspace}:`);
+    for (const repo of merged.repos) {
+        say(`  ${repo}${merged.added.includes(repo) ? "  (new)" : ""}`);
+    }
+    say();
+    if (!parsed.assumeYes && merged.added.length > 0) {
+        const ok = await confirm("Index these?");
+        if (!ok) {
+            say(`Nothing written. Edit ${WORKSPACE_FILE} yourself and run carrick index.`);
+            return 0;
+        }
+    }
+    const wrote = writeIfChanged(workspaceFile, merged.body);
+    say(`${wrote === "written" ? "wrote" : "unchanged"}  ${WORKSPACE_FILE}`);
+    // 3. The agent hooks. Merged by command: this file may already hold a user's
+    //    own hooks, or the hook pack the hosted index installs.
+    const settingsFile = path.join(workspace, SETTINGS_FILE);
+    const settings = fs.existsSync(settingsFile) ? fs.readFileSync(settingsFile, "utf8") : null;
+    const command = hookCommand({ onPath });
+    try {
+        const hooks = mergeCarrickHooks(settings, command.command);
+        const wroteHooks = writeIfChanged(settingsFile, hooks.body);
+        say(`${wroteHooks === "written" ? "wrote" : "unchanged"}  ${SETTINGS_FILE}`);
+        if (!command.bare) {
+            say(`         \`carrick\` is not on PATH here, so those hooks name this install: ${command.command}.`);
+            say("         An npx run leaves nothing on PATH afterwards, and a hook that cannot find carrick");
+            say("         says nothing rather than failing your edit. `npm install -g carrick` and run init");
+            say("         again to write the short command instead.");
+        }
+    }
+    catch (error) {
+        say(`skipped  ${SETTINGS_FILE}: it is not valid JSON (${error.message}). Fix it and run carrick init again; nothing was overwritten.`);
+    }
+    // 4. The index itself.
+    if (parsed.skipIndex) {
+        say();
+        say("Skipped the index. Build it with: carrick index");
+    }
+    else {
+        say();
+        const binary = resolveNativeBinary();
+        if (!binary.binary) {
+            process.stderr.write(`carrick init: ${binary.problem}\n`);
+            return 1;
+        }
+        const scan = spawnSync(binary.binary, ["index", "--workspace", workspace], {
+            stdio: "inherit",
+            env: nativeEnv(),
+        });
+        if (scan.status !== 0) {
+            process.stderr.write(`carrick init: the first index did not finish. The files above are written, so fix what it reported and run: carrick index\n`);
+            return scan.status ?? 1;
+        }
+    }
+    // 5. The lines it cannot run for you.
+    say();
+    say("Next, and neither of these is done for you:");
+    say();
+    say("  The org index, for work that crosses repos you do not have on disk:");
+    say(`    ${MCP_LINE}`);
+    say();
+    say("  The CI check, once per repo (it needs no secret):");
+    say("    carrick templates workflow > .github/workflows/carrick.yml");
+    say();
+    if (onPath("code")) {
+        say("  VS Code, for diagnostics in the Problems panel:");
+        say("    code --install-extension carrick-tools.carrick");
+        say();
+    }
+    say(`Start Claude Code in this folder — the hooks above are ${SETTINGS_FILE} here, and`);
+    say("the index covers every repo in it. The hooks need no plugin; the language server does:");
+    const plugin = path.join(packageRoot(), "plugin");
+    say(`    claude --plugin-dir ${fs.existsSync(plugin) ? plugin : "<carrick checkout>/plugin"}`);
+    if (!command.bare) {
+        say("    That plugin's language server is started as `carrick`, which this machine cannot resolve;");
+        say("    install it globally first, or the hooks above are the channel.");
+    }
+    say();
+    say("Then: edit a file with a route or a call in it, and Carrick answers on the edit.");
+    return 0;
+}
+/** `carrick templates <name>`, so the workflow above is one command. */
+export function templates(argv) {
+    const [name, ...rest] = argv;
+    const variables = {};
+    for (let index = 0; index < rest.length; index += 2) {
+        const key = rest[index];
+        const value = rest[index + 1];
+        if (!key?.startsWith("--") || value === undefined) {
+            process.stderr.write("carrick templates: expected --name value pairs\n");
+            return 2;
+        }
+        variables[key.slice(2).toUpperCase().replace(/-/g, "_")] = value;
+    }
+    try {
+        process.stdout.write(renderTemplate(name, variables));
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(`carrick templates: ${error.message}\n`);
+        return 2;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/init/run.js.map

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

package/dist/init/settings.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The entry point in this package, for a settings file that must name a path.
+ *
+ * A hook command is a line handed to a shell, so this file has to be runnable
+ * on its own: it carries a `#!/usr/bin/env node` shebang, it is executable in
+ * the repository, and npm sets the mode on a `bin` target at install time
+ * (verified 2026-09-09 against a packed tarball installed with
+ * `--ignore-scripts`: 644 in the archive, 755 once installed).
+ */
+export declare function ownEntryPoint(root?: string): string;
+export type HookCommandChoice = {
+    /** What a hook entry runs, quoted if it has to be. */
+    command: string;
+    /** True when the bare name resolved and the settings file stays portable. */
+    bare: boolean;
+};
+/**
+ * The command to write into a settings file.
+ *
+ * `onPath` is injected so a test can state both machines; in `carrick init` it
+ * is `which carrick`.
+ */
+export declare function hookCommand(options: {
+    onPath: (command: string) => boolean;
+    root?: string;
+}): HookCommandChoice;
+export type HookEntry = {
+    type: "command";
+    command: string;
+    timeout?: number;
+};
+export type HookGroup = {
+    matcher?: string;
+    hooks: HookEntry[];
+};
+/** What this package registers, and the only entries it will ever remove. */
+export declare function carrickHooks(command?: string): Record<string, HookGroup[]>;
+export type MergeResult = {
+    /** The file body to write. */
+    body: string;
+    /** True when it differs from what was there. */
+    changed: boolean;
+};
+/**
+ * Merge this package's hooks into a settings file, or produce one.
+ *
+ * Throws when the existing file is not JSON: a settings file a user has hand
+ * edited into invalid JSON is a thing to report, never a thing to overwrite.
+ */
+export declare function mergeCarrickHooks(existing: string | null, command?: string): MergeResult;

package/dist/init/settings.js

@@ -0,0 +1,138 @@
+// The hook entries `carrick init` writes into a project's `.claude/settings.json`.
+//
+// Merged entry by entry, never wholesale. Two things already write to that
+// file: a user's own hooks, and the MCP hook pack the cloud's `scaffold` tool
+// installs for the hosted index. Replacing the `hooks` key would silently
+// uninstall either of them, so this only ever touches entries whose command is
+// this CLI, and leaves the rest of the file — keys, order and formatting of
+// what it does not own — as it found it.
+//
+// The command it writes is `carrick` when `carrick` resolves on PATH, and this
+// install's own entry point when it does not: `npx carrick init` puts the shim
+// on PATH for the length of that one command, so a bare `carrick` in a settings
+// file it wrote would fail on every edit afterwards, silently, because the hook
+// is built never to fail an edit (#837).
+import path from "node:path";
+import { packageRoot } from "../native.js";
+/**
+ * The entry point in this package, for a settings file that must name a path.
+ *
+ * A hook command is a line handed to a shell, so this file has to be runnable
+ * on its own: it carries a `#!/usr/bin/env node` shebang, it is executable in
+ * the repository, and npm sets the mode on a `bin` target at install time
+ * (verified 2026-09-09 against a packed tarball installed with
+ * `--ignore-scripts`: 644 in the archive, 755 once installed).
+ */
+export function ownEntryPoint(root = packageRoot()) {
+    return path.join(root, "bin", "carrick.mjs");
+}
+/**
+ * The command to write into a settings file.
+ *
+ * `onPath` is injected so a test can state both machines; in `carrick init` it
+ * is `which carrick`.
+ */
+export function hookCommand(options) {
+    if (options.onPath("carrick"))
+        return { command: "carrick", bare: true };
+    const entry = ownEntryPoint(options.root);
+    return { command: /\s/.test(entry) ? `"${entry}"` : entry, bare: false };
+}
+/** What this package registers, and the only entries it will ever remove. */
+export function carrickHooks(command = "carrick") {
+    return {
+        // Attached to the tool result, so the verdicts arrive in the same turn as
+        // the edit rather than the turn after it.
+        PostToolUse: [
+            {
+                matcher: "Write|Edit|MultiEdit",
+                hooks: [{ type: "command", command: `${command} hook post-edit`, timeout: 15 }],
+            },
+        ],
+        // No matcher: a resumed, cleared or compacted session has lost the map and
+        // re-orients for one read of the index.
+        SessionStart: [
+            {
+                hooks: [{ type: "command", command: `${command} hook session-start`, timeout: 30 }],
+            },
+        ],
+    };
+}
+/**
+ * Whether a settings entry is one of ours, whatever it names us by.
+ *
+ * An entry written on a machine with no `carrick` on PATH holds an absolute
+ * path, so the test is the file it runs and the `hook` subcommand, not a fixed
+ * prefix: otherwise re-running init on such a machine would leave the old entry
+ * behind and add a second one.
+ */
+const HOOK_CALL = /^"?(.*?)"?\s+hook\s/;
+function isOurs(entry) {
+    if (typeof entry !== "object" || entry === null)
+        return false;
+    const command = entry.command;
+    if (typeof command !== "string")
+        return false;
+    const match = HOOK_CALL.exec(command.trim());
+    if (!match?.[1])
+        return false;
+    const name = path.basename(match[1]);
+    return name === "carrick" || name === "carrick.mjs";
+}
+/** Strip our entries from one event's groups, keeping everyone else's. */
+function withoutOurs(groups) {
+    if (!Array.isArray(groups))
+        return [];
+    const kept = [];
+    for (const group of groups) {
+        if (typeof group !== "object" || group === null) {
+            kept.push(group);
+            continue;
+        }
+        const hooks = group.hooks;
+        if (!Array.isArray(hooks)) {
+            kept.push(group);
+            continue;
+        }
+        const others = hooks.filter((entry) => !isOurs(entry));
+        // A group that held only our entry goes with it; one that held a mix keeps
+        // the rest of its entries and its matcher.
+        if (others.length > 0)
+            kept.push({ ...group, hooks: others });
+    }
+    return kept;
+}
+/**
+ * Merge this package's hooks into a settings file, or produce one.
+ *
+ * Throws when the existing file is not JSON: a settings file a user has hand
+ * edited into invalid JSON is a thing to report, never a thing to overwrite.
+ */
+export function mergeCarrickHooks(existing, command = "carrick") {
+    const base = existing == null || existing.trim() === ""
+        ? {}
+        : JSON.parse(existing);
+    const hooksBefore = (base["hooks"] ?? {});
+    const hooks = {};
+    for (const [event, groups] of Object.entries(hooksBefore)) {
+        hooks[event] = withoutOurs(groups);
+    }
+    for (const [event, groups] of Object.entries(carrickHooks(command))) {
+        hooks[event] = [...(hooks[event] ?? []), ...groups];
+    }
+    // An event that only ever held our entry, and no longer does, leaves no
+    // empty array behind to puzzle over.
+    for (const [event, groups] of Object.entries(hooks)) {
+        if (Array.isArray(groups) && groups.length === 0)
+            delete hooks[event];
+    }
+    const merged = {};
+    for (const [key, value] of Object.entries(base)) {
+        merged[key] = key === "hooks" ? hooks : value;
+    }
+    if (!("hooks" in merged))
+        merged["hooks"] = hooks;
+    const body = `${JSON.stringify(merged, null, 2)}\n`;
+    return { body, changed: body !== existing };
+}
+//# sourceMappingURL=settings.js.map