ghostrail 0.0.0 → 0.2.0

package/dist/claude-profile/classify.js

@@ -0,0 +1,103 @@
+/**
+ * Pure classification + composition for the ghostrail Claude profile: split a
+ * CLAUDE.md into sections, judge which belong in a headless factory run, flag
+ * interactive-only settings, and compose the factory CLAUDE.md + settings.
+ */
+/** Substrings (case-insensitive) that mark a CLAUDE.md section as interactive-only. */
+const INTERACTIVE_SIGNALS = [
+    "statusline",
+    "status line",
+    "keybinding",
+    "keyboard shortcut",
+    "slash command",
+    "/config",
+    "/fast",
+    " theme",
+    "type `!`",
+    "type !",
+    "interactive session",
+    "vs code",
+    "vscode",
+    "jetbrains",
+    "ide extension",
+];
+/** settings.json keys that are interactive-only and are not carried into the profile. */
+const INTERACTIVE_SETTINGS_KEYS = new Set([
+    "statusLine",
+    "theme",
+    "keybindings",
+    "spinnerTipsEnabled",
+    "autoUpdates",
+    "editorMode",
+    "verbose",
+    "preferredNotifChannel",
+    "messageIdleNotifThresholdMs",
+]);
+/**
+ * Split a CLAUDE.md into sections at top-level (`#`/`##`) headings. Text before
+ * the first heading becomes a `(preamble)` section. Each section's `body`
+ * includes its heading line.
+ */
+export function splitSections(content) {
+    const sections = [];
+    let heading;
+    let lines = [];
+    const flush = () => {
+        if (heading !== undefined) {
+            sections.push({ heading, body: lines.join("\n") });
+        }
+        else if (lines.join("\n").trim().length > 0) {
+            sections.push({ heading: "(preamble)", body: lines.join("\n") });
+        }
+    };
+    for (const line of content.split("\n")) {
+        if (/^#{1,2}\s/.test(line)) {
+            flush();
+            heading = line.replace(/^#{1,2}\s+/, "").trim();
+            lines = [line];
+        }
+        else {
+            lines.push(line);
+        }
+    }
+    flush();
+    return sections;
+}
+/** Judge each section keep/drop; a section is dropped if it names an interactive-only concern. */
+export function classifyClaudeMdSections(sections) {
+    return sections.map((section) => {
+        const hay = `${section.heading}\n${section.body}`.toLowerCase();
+        const signal = INTERACTIVE_SIGNALS.find((s) => hay.includes(s));
+        return signal === undefined
+            ? { ...section, verdict: "keep" }
+            : { ...section, verdict: "drop", reason: `mentions "${signal.trim()}" (interactive-only)` };
+    });
+}
+/** Report which top-level settings keys are carried into the factory profile. */
+export function classifySettingsKeys(settings) {
+    return Object.keys(settings).map((key) => INTERACTIVE_SETTINGS_KEYS.has(key)
+        ? { key, carried: false, reason: "interactive-only" }
+        : { key, carried: true });
+}
+const FACTORY_HEADER = `# Ghostrail factory profile
+
+This CLAUDE.md is composed by ghostrail for headless factory runs. It is not your
+interactive CLAUDE.md: it carries a curated subset of your global rules plus the
+target repo's own project CLAUDE.md at run time. Regenerate it with
+\`ghostrail claude-setup --write\`.`;
+/**
+ * Compose the factory CLAUDE.md: a fixed header followed by the bodies of the
+ * kept sections, collapsing blank runs.
+ */
+export function composeFactoryClaudeMd(sections, header = FACTORY_HEADER) {
+    const kept = sections.filter((s) => s.verdict === "keep").map((s) => s.body.trim());
+    return `${[header, ...kept]
+        .join("\n\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim()}\n`;
+}
+/** The minimal, headless-safe factory settings.json (hooks land via the declarative block later). */
+export function composeFactorySettings() {
+    return { hooks: {} };
+}
+//# sourceMappingURL=classify.js.map

package/dist/claude-profile/classify.js.map

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

package/dist/claude-profile/index.d.ts

@@ -0,0 +1,3 @@
+export { type ClaudeMdSection, classifyClaudeMdSections, classifySettingsKeys, composeFactoryClaudeMd, composeFactorySettings, type Section, type SettingsKeyReport, splitSections, type Verdict, } from "./classify.js";
+export { buildProposal, type SetupProposal, type SkillReport, writeProfile } from "./setup.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/claude-profile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/claude-profile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACtB,aAAa,EACb,KAAK,OAAO,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/claude-profile/index.js

@@ -0,0 +1,3 @@
+export { classifyClaudeMdSections, classifySettingsKeys, composeFactoryClaudeMd, composeFactorySettings, splitSections, } from "./classify.js";
+export { buildProposal, writeProfile } from "./setup.js";
+//# sourceMappingURL=index.js.map

package/dist/claude-profile/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/claude-profile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EAGtB,aAAa,GAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAwC,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/claude-profile/setup.d.ts

@@ -0,0 +1,33 @@
+import { type ClaudeMdSection, type SettingsKeyReport } from "./classify.js";
+export interface SkillReport {
+    name: string;
+    pin: boolean;
+}
+/** A proposal for the factory Claude profile, derived from an existing ~/.claude. */
+export interface SetupProposal {
+    sourceHome: string;
+    profileDir: string;
+    claudeMd: {
+        present: boolean;
+        sections: ClaudeMdSection[];
+    };
+    settings: {
+        present: boolean;
+        keys: SettingsKeyReport[];
+    };
+    skills: SkillReport[];
+    /** Skills requested via --pin that are not installed in the source ~/.claude/skills. */
+    missingPins: string[];
+}
+/**
+ * Inspect the source `~/.claude` and propose a factory profile: which CLAUDE.md
+ * sections to keep vs drop (interactive-only), which settings carry over, and
+ * which installed skills to pin. Pure inspection; writes nothing.
+ */
+export declare function buildProposal(sourceHome: string, profileDir: string, pin: readonly string[]): Promise<SetupProposal>;
+/**
+ * Write the profile the proposal describes: the composed factory CLAUDE.md (kept
+ * sections only), a minimal settings.json, and a copy of each pinned skill.
+ */
+export declare function writeProfile(proposal: SetupProposal): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/claude-profile/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/claude-profile/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAMvB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAC5D,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;IAC1D,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,wFAAwF;IACxF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAqBD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,SAAS,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,CAAC,CAgCxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBzE"}

package/dist/claude-profile/setup.js

@@ -0,0 +1,81 @@
+import { cp, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { classifyClaudeMdSections, classifySettingsKeys, composeFactoryClaudeMd, composeFactorySettings, splitSections, } from "./classify.js";
+async function readIfPresent(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+async function listDirs(path) {
+    try {
+        return (await readdir(path, { withFileTypes: true }))
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Inspect the source `~/.claude` and propose a factory profile: which CLAUDE.md
+ * sections to keep vs drop (interactive-only), which settings carry over, and
+ * which installed skills to pin. Pure inspection; writes nothing.
+ */
+export async function buildProposal(sourceHome, profileDir, pin) {
+    const claudeDir = join(sourceHome, ".claude");
+    const mdRaw = await readIfPresent(join(claudeDir, "CLAUDE.md"));
+    const sections = mdRaw === undefined ? [] : classifyClaudeMdSections(splitSections(mdRaw));
+    const settingsRaw = await readIfPresent(join(claudeDir, "settings.json"));
+    let settingsKeys = [];
+    if (settingsRaw !== undefined) {
+        try {
+            const parsed = JSON.parse(settingsRaw);
+            if (parsed !== null && typeof parsed === "object") {
+                settingsKeys = classifySettingsKeys(parsed);
+            }
+        }
+        catch {
+            // malformed settings: report nothing
+        }
+    }
+    const installed = await listDirs(join(claudeDir, "skills"));
+    const pinSet = new Set(pin);
+    const skills = installed.map((name) => ({ name, pin: pinSet.has(name) }));
+    const missingPins = pin.filter((name) => !installed.includes(name));
+    return {
+        sourceHome,
+        profileDir,
+        claudeMd: { present: mdRaw !== undefined, sections },
+        settings: { present: settingsRaw !== undefined, keys: settingsKeys },
+        skills,
+        missingPins,
+    };
+}
+/**
+ * Write the profile the proposal describes: the composed factory CLAUDE.md (kept
+ * sections only), a minimal settings.json, and a copy of each pinned skill.
+ */
+export async function writeProfile(proposal) {
+    const claudeDir = join(proposal.profileDir, ".claude");
+    await mkdir(claudeDir, { recursive: true });
+    await writeFile(join(claudeDir, "CLAUDE.md"), composeFactoryClaudeMd(proposal.claudeMd.sections), "utf8");
+    await writeFile(join(claudeDir, "settings.json"), `${JSON.stringify(composeFactorySettings(), null, 2)}\n`, "utf8");
+    const skillsDir = join(claudeDir, "skills");
+    await mkdir(skillsDir, { recursive: true });
+    for (const skill of proposal.skills) {
+        if (!skill.pin)
+            continue;
+        const source = join(proposal.sourceHome, ".claude", "skills", skill.name);
+        try {
+            await cp(source, join(skillsDir, skill.name), { recursive: true, force: true });
+        }
+        catch {
+            // a pinned-but-uncopyable skill is reported via missingPins; skip
+        }
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/claude-profile/setup.js.map

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

package/dist/cli/commands.d.ts

@@ -1,3 +1,4 @@
+import type { Scope } from "../vendor/skilltend/paths.js";
 export interface CommandStreams {
     out: (text: string) => void;
     err: (text: string) => void;
@@ -17,6 +18,20 @@ interface CommandEnv {
 }
 /** `ghostrail run`: drain eligible work once. */
 export declare function cmdRun(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
+interface WatchFlags {
+    intervalMs: number;
+    intervalLabel: string;
+    maxTicks?: number;
+}
+/**
+ * Parse `ghostrail watch` options: `--interval`/`-i <duration>` (default `60s`)
+ * and an optional `--max-ticks <n>`. Returns undefined for a malformed interval.
+ */
+export declare function parseWatchFlags(argv: readonly string[]): WatchFlags | undefined;
+/** `ghostrail watch`: run ticks on an interval until interrupted (no cron needed). */
+export declare function cmdWatch(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
+/** `ghostrail triage`: decompose large issues in the triage queue into sub-issues. */
+export declare function cmdTriage(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
 /** `ghostrail respond`: fold new human PR comments back into their branches. */
 export declare function cmdRespond(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
 interface BoardFlags {
@@ -32,8 +47,58 @@ export declare function cmdBoard(argv: readonly string[], streams: CommandStream
 /** `ghostrail artifacts`: list the shared artifacts available in the global store. */
 export declare function cmdArtifacts(argv: readonly string[], streams: CommandStreams, env?: CommandEnv): Promise<number>;
 /** The quickstart templates bundled with the package. */
-export declare const TEMPLATES: readonly ["fix-bugs-local", "content-loop"];
-/** `ghostrail init <template>`: scaffold a repo from a quickstart template. */
+export declare const TEMPLATES: readonly ["code-local", "content-loop"];
+/**
+ * `ghostrail init <template> [--repo <path>] [--force]`: 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.
+ */
 export declare function cmdInit(argv: readonly string[], streams: CommandStreams, cwd?: string): Promise<number>;
+interface SkillFlags {
+    scope: Scope;
+    agents: string[];
+    link: boolean;
+    force: boolean;
+    check: boolean;
+    uninstall: boolean;
+    yes: boolean;
+}
+/**
+ * Parse `ghostrail skill` options. Default scope is `global` (the user's own
+ * agent config), because the skill drives ghostrail wherever you are; `--project`
+ * commits it alongside a repo so collaborators share it.
+ */
+export declare function parseSkillFlags(argv: readonly string[]): SkillFlags;
+/**
+ * `ghostrail skill [uninstall] [--project] [--agent a,b] [--link] [--check] [--force] [--yes]`:
+ * install or update the `/ghostrail` agent skill for the coding agents configured
+ * on this machine. Idempotent — re-running when nothing changed is a no-op.
+ */
+export declare function cmdSkill(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
+/**
+ * `ghostrail install`: put the CLI permanently on PATH, then install the skill.
+ * The two steps are independent — a failed global install still leaves you with a
+ * working skill, but the command exits non-zero so the failure is visible.
+ *
+ * Pins to the running version rather than `latest`, so `npx ghostrail@x.y.z
+ * install` gives you exactly x.y.z.
+ */
+export declare function cmdInstall(argv: readonly string[], streams: CommandStreams, env?: CommandEnv, cwd?: string): Promise<number>;
+/**
+ * `ghostrail self-update`: upgrade the CLI to the latest published version, then
+ * install that version's skill.
+ *
+ * The skill step is delegated to the NEWLY installed binary on purpose. This
+ * process still holds the old bundled SKILL.md, so doing it in-process would
+ * upgrade the CLI and then write the previous skill back over it.
+ */
+export declare function cmdSelfUpdate(argv: readonly string[], streams: CommandStreams): Promise<number>;
+/**
+ * `ghostrail claude-setup`: inspect the user's ~/.claude and propose the factory
+ * Claude profile (which CLAUDE.md sections to keep vs drop, which settings are
+ * interactive-only, which skills to pin). Prints the proposal; `--write` composes
+ * the profile.
+ */
+export declare function cmdClaudeSetup(argv: readonly string[], streams: CommandStreams, env?: CommandEnv): Promise<number>;
 export {};
 //# sourceMappingURL=commands.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,CAc/F;AAED,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAkDD,iDAAiD;AACjD,wBAAsB,MAAM,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,GAAE,UAAwB,EAC7B,GAAG,SAAgB,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,gFAAgF;AAChF,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,GAAE,UAAwB,EAC7B,GAAG,SAAgB,GAClB,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAqBzF;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,GAAE,UAAwB,EAC7B,GAAG,SAAgB,GAClB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED,sFAAsF;AACtF,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,GAAE,UAAwB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,yDAAyD;AACzD,eAAO,MAAM,SAAS,6CAA8C,CAAC;AAMrE,+EAA+E;AAC/E,wBAAsB,OAAO,CAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,SAAgB,GAClB,OAAO,CAAC,MAAM,CAAC,CAiCjB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}