carrick 0.3.80 → 0.3.82

package/dist/init/task-skills.js

@@ -0,0 +1,204 @@
+// The four task skills `carrick init` installs beside the hooks.
+//
+// A skill is the body a hook or an agent's own judgement points at, and these
+// four perform a task rather than remind: each one is a sequence of Carrick
+// tool calls, and the agent's work is to confirm what came back in source,
+// classify it, decide and act.
+//
+// `docs/reference/task-skills.md` is what each one covers, when it fires and
+// how the stamp below decides who owns a file. The bodies themselves are the
+// markdown in `templates/skills/`, so they can be read and reviewed as files.
+//
+// Two copies of the same bytes go in, one per harness: `.claude/skills/` for
+// Claude Code and `.agents/skills/` for Codex, which is the scaffold parity
+// rule of 2026-09-05.
+//
+// Every file this writes ends in a stamp: a marker and a digest of the body
+// above it. The digest is what separates the three states a path can be in on
+// a re-run — ours and untouched, ours and since edited, or somebody else's —
+// and it stays right across an upgrade, where the shipped body changes and a
+// version number would not. `carrick remove` deletes the untouched ones and
+// nothing else, so a file a user has made their own is never destroyed by a
+// command undoing an install.
+//
+// The reminder skill at `.claude/skills/carrick/SKILL.md` belongs to the cloud
+// scaffold and carries no stamp, so nothing here reads or writes it.
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { templatesDir } from "../templates.js";
+import { writeIfChanged } from "./files.js";
+/** The skills, in the order `carrick init` reports them. */
+export const TASK_SKILLS = [
+    "carrick-impact",
+    "carrick-reuse",
+    "carrick-drift",
+    "carrick-census",
+];
+/** One directory per harness. Both hold identical bytes. */
+export const SKILL_ROOTS = [
+    path.join(".claude", "skills"),
+    path.join(".agents", "skills"),
+];
+/** Where one skill lands under one root, relative to the workspace. */
+export function skillFile(root, name) {
+    return path.join(root, name, "SKILL.md");
+}
+/** Every path these skills occupy, relative to the workspace. */
+export function taskSkillPaths() {
+    return SKILL_ROOTS.flatMap((root) => TASK_SKILLS.map((name) => skillFile(root, name)));
+}
+const STAMP = /^<!-- carrick:skill sha256:([0-9a-f]{12}) -->$/;
+/** The digest of a body, as the stamp spells it. */
+function digest(body) {
+    return createHash("sha256").update(body, "utf8").digest("hex").slice(0, 12);
+}
+/** A rendered body with its stamp on the last line. */
+export function stamped(body) {
+    const text = body.endsWith("\n") ? body : `${body}\n`;
+    return `${text}\n<!-- carrick:skill sha256:${digest(text)} -->\n`;
+}
+export function skillState(existing) {
+    if (existing === null)
+        return "absent";
+    // Line endings are normalised before anything is compared. A checkout with
+    // `core.autocrlf` set rewrites every one of these files to CRLF on the way
+    // to disk, and a digest taken over those bytes would read all eight as
+    // somebody else's work and warn about them on every run.
+    const lines = existing.replace(/\r\n/g, "\n").split("\n");
+    // The marker is looked for anywhere rather than on the last line, because
+    // appending a step under it is as ordinary an edit as changing one above it,
+    // and a file that still carries our marker is still one of ours.
+    const marker = lines.findIndex((line) => STAMP.test(line));
+    if (marker === -1)
+        return "theirs";
+    // The blank line `stamped` puts before the marker is the join's last
+    // separator, so rejoining everything above it reproduces the exact bytes
+    // that were digested.
+    const body = lines.slice(0, marker).join("\n");
+    const after = lines.slice(marker + 1).join("").trim();
+    const claimed = STAMP.exec(lines[marker])?.[1];
+    return digest(body) === claimed && after === "" ? "ours" : "edited";
+}
+function scopeArgument(scope) {
+    return scope.slug === null ? 'repo: "<owner/repo>"' : `project: "${scope.slug}"`;
+}
+function scopeNote(scope) {
+    return scope.slug === null
+        ? "Every Carrick call below needs a scope. Read this repository's once with `git remote get-url origin` and pass it as `repo: \"<owner/repo>\"` wherever the commands below write it."
+        : `Every Carrick call below carries \`project: "${scope.slug}"\`, which is this workspace's Carrick project and is already written into the commands.`;
+}
+/** One skill body, scoped and stamped, ready to write. */
+export function renderTaskSkill(name, scope) {
+    const source = fs.readFileSync(path.join(templatesDir(), "skills", `${name}.md`), "utf8");
+    const rendered = source
+        .split("{{SCOPE_NOTE}}")
+        .join(scopeNote(scope))
+        .split("{{SCOPE}}")
+        .join(scopeArgument(scope));
+    // A body that still holds a placeholder is a file that looks written and
+    // tells an agent to call a tool with a literal `{{SCOPE}}` in it.
+    const left = /\{\{([A-Z_]+)\}\}/.exec(rendered);
+    if (left)
+        throw new Error(`${name} still holds ${left[0]} after rendering`);
+    return stamped(rendered);
+}
+/**
+ * Write every skill under both roots, leaving alone anything that is not ours.
+ *
+ * Idempotent twice over: a second run renders the same bytes, and
+ * `writeIfChanged` does not touch a file that already holds them.
+ */
+export function writeTaskSkills(workspace, scope) {
+    const outcomes = [];
+    for (const root of SKILL_ROOTS) {
+        for (const name of TASK_SKILLS) {
+            const relative = skillFile(root, name);
+            const target = path.join(workspace, relative);
+            const existing = fs.existsSync(target) ? fs.readFileSync(target, "utf8") : null;
+            const state = skillState(existing);
+            if (state === "edited" || state === "theirs") {
+                outcomes.push({ path: relative, state, wrote: false });
+                continue;
+            }
+            const result = writeIfChanged(target, renderTaskSkill(name, scope));
+            outcomes.push({ path: relative, state, wrote: result === "written" });
+        }
+    }
+    return outcomes;
+}
+/** The lines `carrick init` prints about what it just did with them. */
+export function taskSkillLines(outcomes) {
+    const done = [];
+    const warn = [];
+    const installed = outcomes.filter((row) => row.state === "absent" || row.state === "ours");
+    if (installed.length > 0) {
+        done.push(`Task skills installed in ${SKILL_ROOTS.join(" and ")}: ${TASK_SKILLS.join(", ")}`);
+    }
+    for (const row of outcomes) {
+        if (row.state === "edited") {
+            warn.push(`${row.path} has been edited here, so it was left as it is. Delete it and run carrick init again for the current version.`);
+        }
+        else if (row.state === "theirs") {
+            warn.push(`${row.path} was not written by Carrick, so it was left as it is.`);
+        }
+    }
+    return { done, warn };
+}
+/**
+ * Delete the skill files this package wrote, and only those.
+ *
+ * An edited body and a file of somebody else's are returned as `kept` for the
+ * caller to name, exactly as the write path leaves them. A skill directory
+ * emptied by the deletion goes with it; a root holding anything else stays.
+ */
+export function removeTaskSkills(workspace) {
+    const deleted = [];
+    const kept = [];
+    for (const root of SKILL_ROOTS) {
+        for (const name of TASK_SKILLS) {
+            const relative = skillFile(root, name);
+            const target = path.join(workspace, relative);
+            if (!fs.existsSync(target))
+                continue;
+            const state = skillState(fs.readFileSync(target, "utf8"));
+            if (state !== "ours") {
+                kept.push({ path: relative, state, wrote: false });
+                continue;
+            }
+            fs.rmSync(target);
+            deleted.push(relative);
+            for (const directory of [path.dirname(target), path.join(workspace, root)]) {
+                try {
+                    fs.rmdirSync(directory);
+                }
+                catch {
+                    // Holds something else. That is the answer, not a failure.
+                }
+            }
+        }
+    }
+    return { deleted, kept };
+}
+/**
+ * The skill roots this repository ignores.
+ *
+ * An ignored skill works on the machine that ran `carrick init` and reaches
+ * nobody else on the team, which is a thing to say once rather than a thing to
+ * change: what a repository ignores is its own decision.
+ *
+ * `git check-ignore` answers for a path that does not exist yet. Exit 0 is
+ * ignored and 1 is not; anything else (128 outside a repository) is git
+ * declining to answer, and this says nothing then.
+ */
+export function ignoredSkillRoots(workspace) {
+    return SKILL_ROOTS.filter((root) => {
+        const probe = spawnSync("git", ["check-ignore", "-q", "--", root], {
+            cwd: workspace,
+            stdio: "ignore",
+        });
+        return probe.status === 0;
+    });
+}
+//# sourceMappingURL=task-skills.js.map

package/dist/init/task-skills.js.map

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

package/dist/scan.d.ts

@@ -0,0 +1,160 @@
+import { type InitOutput } from "./init/output.ts";
+/** How far a build's phase has got. Mirrors `progress::PhaseState`. */
+export type PhaseState = "started" | "done" | "warned";
+/** Mirrors `progress::PhaseUpdate`. */
+export type PhaseUpdate = {
+    label: string;
+    state: PhaseState;
+};
+/** Mirrors `progress::Update`: how far through a service's files a scan is. */
+export type ProgressUpdate = {
+    service: string;
+    service_index: number;
+    service_total: number;
+    phase: "files" | "intents";
+    done: number;
+    total: number;
+};
+/** Mirrors `progress::ServiceSummary`. */
+export type ServiceSummary = {
+    name: string;
+    routes: number;
+    calls: number;
+    /** Absent on a summary from a binary older than carrick#1321. */
+    functions?: number;
+    types?: number;
+    routes_without_response_type: number;
+};
+/** Mirrors `progress::Summary`: what a finished build amounts to. */
+export type Summary = {
+    services: ServiceSummary[];
+    elapsed_secs: number;
+    next?: string[];
+};
+/** One line of a build's output, once it has been read. */
+export type Marker = {
+    kind: "phase";
+    phase: PhaseUpdate;
+} | {
+    kind: "progress";
+    update: ProgressUpdate;
+} | {
+    kind: "summary";
+    summary: Summary;
+} | {
+    kind: "notice";
+    text: string;
+};
+/**
+ * Read one line of a build's output as a marker, or answer null.
+ *
+ * Longest prefix wins, so a family whose names share a word cannot be read as
+ * one another — the same property `src/progress.rs` holds itself to. A marker
+ * whose payload is not the JSON this version expects is not a marker: the
+ * renderer draws nothing rather than drawing a guess.
+ */
+export declare function parseMarker(line: string): Marker | null;
+/** The commands this renders. Everything else runs with its streams inherited. */
+export declare const RENDERED: Set<string>;
+/**
+ * Whether this invocation is rendered, or run as the binary writes it.
+ *
+ * `--verbose` is the escape hatch the closing line names, so it must hand the
+ * terminal straight to the binary. `--detach` answers with an id and leaves a
+ * log file behind — there is no run here to draw. `--help` is text.
+ */
+export declare function isRendered(command: string | undefined, args: string[]): boolean;
+/** `169.4` as `2m49s`, `32.7` as `32.7s`. Under a minute keeps its tenth. */
+export declare function elapsed(seconds: number): string;
+/**
+ * The one line a finished build is worth: what the index holds, then the one
+ * shortfall in it.
+ *
+ * Routes and calls alone were the whole line, and a service of 111 routes,
+ * 363 functions and 175 types read as `111 routes · 1 call` — which to a
+ * developer, and to an agent, is a nearly empty index (carrick#1321). The two
+ * largest things it holds are named before the shortfall, because the line's
+ * subject is what was built.
+ *
+ * The shortfall is dropped when it is zero. A line states how many, of which
+ * thing, and what to do about it; nothing to do is nothing to say
+ * (carrick#1284).
+ */
+export declare function summaryLine(summary: Summary): string;
+/** What a rendered run closes on: the next step, and nothing about cost. */
+export declare function outroLine(summary: Summary): string;
+/**
+ * The renderer, as a state machine over the child's lines.
+ *
+ * Separated from the spawn so a test drives it with a written stream and reads
+ * the interactive markers back — a terminal's own bytes are not capturable,
+ * and the plain rendering is a different renderer with different lines
+ * (carrick#1032).
+ */
+export declare class ScanRender {
+    private readonly output;
+    private readonly version;
+    /** Renders run in order, whichever event scheduled them. */
+    private chain;
+    /**
+     * The open step's own promise.
+     *
+     * Awaited at the head of every scheduled render and never inside the chain
+     * that starts it: a step ends when its phase ends, and a chain that waited
+     * on the step before running the line that ends it would wait forever.
+     */
+    private stepDone;
+    private open;
+    /** The fraction the open phase last stated, for its spinner only. */
+    private running;
+    /** A finished phase whose line is not drawn yet: the summary may replace it. */
+    private held;
+    private opened;
+    private summarised;
+    /** Lines nobody rendered, for a failure and for nothing else. */
+    private readonly buffered;
+    /** The command's own answer, said before any phase began. */
+    private readonly answered;
+    constructor(output: InitOutput, version: string);
+    /** Whether anything at all was rendered. */
+    get rendered(): boolean;
+    /** What was not rendered, in the order it arrived. */
+    get unrendered(): string[];
+    /** One line of the child's stdout. */
+    stdout(line: string): void;
+    /** One line of the child's stderr. */
+    stderr(line: string): void;
+    private consume;
+    private begin;
+    private phase;
+    private phaseText;
+    /** Draw the held line, if there is one, and free the phase it belongs to. */
+    private close;
+    private progress;
+    private notice;
+    /** Say where an open phase is while it runs, without ending it. */
+    private redraw;
+    private summary;
+    /**
+     * The child is over. Answer whether anything was rendered, so a caller that
+     * rendered nothing can write the output through instead of eating it.
+     */
+    finish(failed: boolean): Promise<boolean>;
+    private schedule;
+}
+/**
+ * Run the binary and render it.
+ *
+ * stdin stays inherited: a build asks nothing, but a child holding no stdin
+ * would break the moment one of them does.
+ */
+export declare function renderScan(options: {
+    binary: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    version: string;
+    output?: InitOutput;
+}): Promise<{
+    code: number;
+    signal: NodeJS.Signals | null;
+}>;