carrick 0.3.80 → 0.3.82

package/dist/scan.js

@@ -0,0 +1,415 @@
+// What a build of the index looks like from the outside (carrick#1315).
+//
+// `carrick index`, `resume` and `refresh` are the Rust binary, and the binary
+// writes for two readers at once: a person, and a log file. Run under this
+// package with the two streams inherited, a first run opened on a tracing
+// banner with eleven `<unset>` fields, then a pair of indicatif spinners
+// rewriting a pipe — which arrive as padded fragments sharing one line — and
+// closed on the boundary block, which is a per-package census of what the
+// deterministic passes could not classify. All three are diagnostics.
+//
+// So the binary is spawned as a child whose streams this process holds, and
+// what it states as a marker is rendered here, through the renderer `carrick
+// init` already uses: clack in a terminal, the same lines plain in a pipe.
+// Nothing else is drawn. The unparsed text is kept for exactly two readers:
+// a run that failed, which prints it, and `--verbose`, which does not come
+// through here at all — it inherits the streams and gets the binary's own
+// output, banner included.
+//
+// Two rules decide what a line is, and neither reads its words:
+//
+//   - A marker (`@carrick-…`) is rendered. `src/progress.rs` is the other
+//     half of each of these shapes.
+//   - Everything else is buffered. A stdout line that arrives BEFORE the
+//     first phase is the command's own answer — what `resume` collected, what
+//     it is still waiting for — and is shown. After the first phase, stdout
+//     is the map, and the summary marker carries what a person needs of it.
+//
+// A child that states no phase and no summary was not building anything: a
+// refusal, a `resume` with nothing to collect, a help text. Its output is
+// written through untouched, because the alternative is swallowing the answer.
+import { spawn } from "node:child_process";
+import { createOutput, } from "./init/output.js";
+const PREFIXES = {
+    phase: "@carrick-phase ",
+    progress: "@carrick-progress ",
+    summary: "@carrick-summary ",
+    notice: "@carrick-notice ",
+};
+/**
+ * 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 function parseMarker(line) {
+    const text = line.trimStart();
+    for (const [kind, prefix] of Object.entries(PREFIXES)) {
+        if (!text.startsWith(prefix))
+            continue;
+        let payload;
+        try {
+            payload = JSON.parse(text.slice(prefix.length));
+        }
+        catch {
+            return null;
+        }
+        if (payload === null || typeof payload !== "object")
+            return null;
+        if (kind === "phase") {
+            const phase = payload;
+            if (typeof phase.label !== "string")
+                return null;
+            return { kind: "phase", phase };
+        }
+        if (kind === "progress") {
+            const update = payload;
+            if (typeof update.total !== "number")
+                return null;
+            return { kind: "progress", update };
+        }
+        if (kind === "summary") {
+            const summary = payload;
+            if (!Array.isArray(summary.services))
+                return null;
+            return { kind: "summary", summary };
+        }
+        const notice = payload;
+        if (typeof notice.text !== "string")
+            return null;
+        return { kind: "notice", text: notice.text };
+    }
+    return null;
+}
+/** The commands this renders. Everything else runs with its streams inherited. */
+export const RENDERED = new Set(["index", "resume", "refresh"]);
+/**
+ * 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 function isRendered(command, args) {
+    if (!command || !RENDERED.has(command))
+        return false;
+    return !args.some((arg) => arg === "--verbose" ||
+        arg === "-v" ||
+        arg === "--detach" ||
+        arg === "--help" ||
+        arg === "-h");
+}
+/** `169.4` as `2m49s`, `32.7` as `32.7s`. Under a minute keeps its tenth. */
+export function elapsed(seconds) {
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return "0.0s";
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    return `${minutes}m${Math.round(seconds - minutes * 60)}s`;
+}
+function plural(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+/**
+ * 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 function summaryLine(summary) {
+    const total = (pick) => summary.services.reduce((sum, service) => sum + (pick(service) ?? 0), 0);
+    const untyped = total((service) => service.routes_without_response_type);
+    const functions = total((service) => service.functions);
+    const types = total((service) => service.types);
+    const parts = [plural(total((service) => service.routes), "route")];
+    if (functions > 0)
+        parts.push(plural(functions, "function"));
+    if (types > 0)
+        parts.push(plural(types, "type"));
+    // Named for what it is. Every call in the index crosses a service boundary,
+    // and "1 call" beside 363 functions reads as one function call.
+    parts.push(plural(total((service) => service.calls), "external call"));
+    if (untyped > 0)
+        parts.push(`${plural(untyped, "route")} without a response type`);
+    return parts.join(" · ");
+}
+/** What a rendered run closes on: the next step, and nothing about cost. */
+export function outroLine(summary) {
+    const next = summary.next ?? [];
+    if (next.length > 0)
+        return next.join(" ");
+    return "Your agents can query it now. `carrick index --verbose` shows the full report.";
+}
+/**
+ * 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 class ScanRender {
+    output;
+    version;
+    /** Renders run in order, whichever event scheduled them. */
+    chain = Promise.resolve();
+    /**
+     * 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.
+     */
+    stepDone = Promise.resolve();
+    open = null;
+    /** The fraction the open phase last stated, for its spinner only. */
+    running = null;
+    /** A finished phase whose line is not drawn yet: the summary may replace it. */
+    held = null;
+    opened = false;
+    summarised = false;
+    /** Lines nobody rendered, for a failure and for nothing else. */
+    buffered = [];
+    /** The command's own answer, said before any phase began. */
+    answered = [];
+    constructor(output, version) {
+        this.output = output;
+        this.version = version;
+    }
+    /** Whether anything at all was rendered. */
+    get rendered() {
+        return this.opened;
+    }
+    /** What was not rendered, in the order it arrived. */
+    get unrendered() {
+        return [...this.answered, ...this.buffered];
+    }
+    /** One line of the child's stdout. */
+    stdout(line) {
+        if (this.consume(line))
+            return;
+        // Before the first phase this is the command answering — what `resume`
+        // collected, what it is still waiting on. After it, it is the map.
+        if (!this.opened && line.trim().length > 0) {
+            this.answered.push(line);
+            return;
+        }
+        this.buffered.push(line);
+    }
+    /** One line of the child's stderr. */
+    stderr(line) {
+        if (this.consume(line))
+            return;
+        this.buffered.push(line);
+    }
+    consume(line) {
+        const marker = parseMarker(line);
+        if (!marker)
+            return false;
+        if (marker.kind === "phase")
+            this.phase(marker.phase);
+        else if (marker.kind === "progress")
+            this.progress(marker.update);
+        else if (marker.kind === "notice")
+            this.notice(marker.text);
+        else
+            this.summary(marker.summary);
+        return true;
+    }
+    begin() {
+        if (this.opened)
+            return;
+        this.opened = true;
+        this.schedule(() => {
+            this.output.intro(`carrick ${this.version}`);
+            for (const line of this.answered)
+                this.output.say(line);
+            this.answered.length = 0;
+        });
+    }
+    phase(update) {
+        if (update.state === "started") {
+            this.begin();
+            this.close();
+            const label = update.label;
+            const startedAt = Date.now();
+            let resolve = () => { };
+            const finished = new Promise((settle) => {
+                resolve = settle;
+            });
+            const phase = {
+                label,
+                startedAt,
+                resolve,
+                say: () => { },
+                counted: null,
+                notice: null,
+            };
+            this.open = phase;
+            this.schedule(() => {
+                this.stepDone = this.output.step(label, (say) => {
+                    phase.say = say;
+                    return finished;
+                }, (report) => report);
+            });
+            return;
+        }
+        // Finished, but not drawn: a summary arriving next is this phase's real
+        // outcome, and the join phase has no line of its own.
+        this.held = {
+            kind: update.state === "warned" ? "warn" : "done",
+            text: this.phaseText(),
+        };
+    }
+    phaseText() {
+        if (!this.open)
+            return "";
+        const spent = elapsed((Date.now() - this.open.startedAt) / 1000);
+        return this.open.counted
+            ? `${this.open.label}  ${this.open.counted}, ${spent}`
+            : `${this.open.label}  ${spent}`;
+    }
+    /** Draw the held line, if there is one, and free the phase it belongs to. */
+    close(report) {
+        const open = this.open;
+        if (!open)
+            return;
+        const outcome = report ?? this.held ?? { kind: "done", text: this.phaseText() };
+        this.open = null;
+        this.held = null;
+        this.running = null;
+        // Settling the step's promise is not a render, so it does not queue behind
+        // one: it is what lets the render already in the chain finish.
+        open.resolve(outcome);
+    }
+    progress(update) {
+        if (!this.open)
+            return;
+        // The spinner says how far through; the line it stops on says how much
+        // there was. A fraction is the answer to "is this moving", and the wrong
+        // answer to "what did it cover".
+        this.open.counted = `${update.total} ${update.phase}`;
+        this.running = `${update.done} of ${update.total} ${update.phase}`;
+        this.redraw();
+    }
+    notice(text) {
+        if (!this.open) {
+            this.buffered.push(text);
+            return;
+        }
+        this.open.notice = text;
+        this.redraw();
+    }
+    /** Say where an open phase is while it runs, without ending it. */
+    redraw() {
+        const open = this.open;
+        if (!open)
+            return;
+        const counted = this.running ? `: ${this.running}` : "";
+        const notice = open.notice ? ` (${open.notice})` : "";
+        open.say(`${open.label}${counted}${notice}`);
+    }
+    summary(summary) {
+        this.summarised = true;
+        this.begin();
+        // The counts ARE the closing phase's outcome, so they take its line
+        // rather than adding one under it.
+        if (summary.services.length > 0) {
+            this.close({ kind: "done", text: summaryLine(summary) });
+        }
+        else {
+            this.close();
+        }
+        this.schedule(() => this.output.outro(outroLine(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.
+     */
+    async finish(failed) {
+        if (this.open) {
+            this.close(failed
+                ? { kind: "refuse", text: `${this.open.label} — the scan stopped` }
+                : undefined);
+            if (failed)
+                this.summarised = false;
+        }
+        // One last link, so the chain waits on whatever step is still open.
+        this.schedule(() => { });
+        await this.chain;
+        return this.opened && this.summarised;
+    }
+    schedule(work) {
+        this.chain = this.chain
+            .then(() => this.stepDone)
+            .then(work)
+            .then(() => { }, () => { });
+    }
+}
+/** Where a rendered run writes the lines it did not draw. */
+function writeThrough(lines) {
+    if (lines.length === 0)
+        return;
+    process.stderr.write(`${lines.join("\n")}\n`);
+}
+/**
+ * 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 async function renderScan(options) {
+    const render = new ScanRender(options.output ?? createOutput(), options.version);
+    const child = spawn(options.binary, options.args, {
+        stdio: ["inherit", "pipe", "pipe"],
+        // The markers are written only when a parent asks for them, so a run
+        // nobody is rendering — a CI scan, a direct `carrick index` — is unchanged.
+        env: { ...options.env, CARRICK_PROGRESS: "1" },
+    });
+    const read = (stream, take) => new Promise((resolve) => {
+        let rest = "";
+        stream.setEncoding("utf8");
+        stream.on("data", (chunk) => {
+            const lines = (rest + chunk).split("\n");
+            rest = lines.pop() ?? "";
+            for (const line of lines)
+                take(line);
+        });
+        stream.on("end", () => {
+            if (rest.length > 0)
+                take(rest);
+            resolve();
+        });
+        stream.on("error", () => resolve());
+    });
+    const ended = new Promise((resolve, reject) => {
+        child.on("error", reject);
+        child.on("exit", (code, signal) => resolve({ code: code ?? 1, signal }));
+    });
+    const [, , outcome] = await Promise.all([
+        read(child.stdout, (line) => render.stdout(line)),
+        read(child.stderr, (line) => render.stderr(line)),
+        ended,
+    ]);
+    const failed = outcome.code !== 0 || outcome.signal !== null;
+    const drew = await render.finish(failed);
+    // A run that drew nothing was not a build: a refusal, a `resume` with
+    // nothing to collect, a help text. Its output IS the answer.
+    if (!drew)
+        writeThrough(render.unrendered);
+    else if (failed)
+        writeThrough(render.unrendered);
+    return outcome;
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/templates.d.ts

@@ -3,6 +3,15 @@ export declare const TEMPLATE_NAMES: TemplateName[];
 /** Where a repo puts each one. */
 export declare const TEMPLATE_PATHS: Record<TemplateName, string>;
 export declare const DEFAULTS: Record<string, string>;
+/**
+ * The directory the shipped template files sit in.
+ *
+ * Resolved from this module rather than from the process, because the same
+ * resolution has to hold in the checkout (`src/../templates`) and in the
+ * published emit (`dist/../templates`). `init/task-skills.ts` reads the skill
+ * bodies from a subdirectory of it.
+ */
+export declare function templatesDir(): string;
 export declare function templateSource(name: TemplateName): string;
 /**
  * Render one template.

package/dist/templates.js

@@ -27,7 +27,15 @@ export const DEFAULTS = {
     ACTION_REF: "carrick-tools/carrick@v1",
     DEFAULT_BRANCH: "main",
 };
-function templatesDir() {
+/**
+ * The directory the shipped template files sit in.
+ *
+ * Resolved from this module rather than from the process, because the same
+ * resolution has to hold in the checkout (`src/../templates`) and in the
+ * published emit (`dist/../templates`). `init/task-skills.ts` reads the skill
+ * bodies from a subdirectory of it.
+ */
+export function templatesDir() {
     return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "templates");
 }
 export function templateSource(name) {

package/dist/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,kEAAkE;AAClE,EAAE;AACF,sEAAsE;AACtE,uDAAuD;AAEvD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,SAAS,GAAmC;IAChD,4CAA4C;IAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,EAAE;IAC9E,+DAA+D;IAC/D,cAAc,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,EAAE;CACxD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAmB,CAAC;AAEvE,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,QAAQ,EAAE,+BAA+B;IACzC,cAAc,EAAE,cAAc;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,UAAU,EAAE,0BAA0B;IACtC,cAAc,EAAE,MAAM;CACvB,CAAC;AAEF,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,YAAoC,EAAE;IAEtC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC;IAC7C,IAAI,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC7E,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gBAAgB,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAC3B,YAAoC,EAAE;IAEtC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC;KAC1C,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,kEAAkE;AAClE,EAAE;AACF,sEAAsE;AACtE,uDAAuD;AAEvD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,SAAS,GAAmC;IAChD,4CAA4C;IAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,EAAE;IAC9E,+DAA+D;IAC/D,cAAc,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,EAAE;CACxD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAmB,CAAC;AAEvE,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,QAAQ,EAAE,+BAA+B;IACzC,cAAc,EAAE,cAAc;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,UAAU,EAAE,0BAA0B;IACtC,cAAc,EAAE,MAAM;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,YAAoC,EAAE;IAEtC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC;IAC7C,IAAI,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC7E,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gBAAgB,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAC3B,YAAoC,EAAE;IAEtC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC;KAC1C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carrick",
-  "version": "0.3.80",
+  "version": "0.3.82",
   "description": "The API contract index for a TypeScript workspace: what the other services do with the routes and calls in the file you are editing, in your editor and in your agent's context",
   "keywords": [
     "typescript",
@@ -57,11 +57,11 @@
     "zod": "^3.23.0"
   },
   "optionalDependencies": {
-    "@carrick-tools/cli-darwin-arm64": "0.3.80",
-    "@carrick-tools/cli-darwin-x64": "0.3.80",
-    "@carrick-tools/cli-linux-arm64": "0.3.80",
-    "@carrick-tools/cli-linux-x64": "0.3.80",
-    "@carrick-tools/cli-win32-x64": "0.3.80"
+    "@carrick-tools/cli-darwin-arm64": "0.3.82",
+    "@carrick-tools/cli-darwin-x64": "0.3.82",
+    "@carrick-tools/cli-linux-arm64": "0.3.82",
+    "@carrick-tools/cli-linux-x64": "0.3.82",
+    "@carrick-tools/cli-win32-x64": "0.3.82"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",

package/templates/skills/carrick-census.md

@@ -0,0 +1,80 @@
+---
+name: carrick-census
+description: Use for every place that does X questions, such as every service that reads this environment variable, every handler that checks a permission, or every client of this queue. Pages the Carrick intent index under two wordings and reports what it read and what it could not see.
+---
+
+# Every place that does X
+
+{{SCOPE_NOTE}}
+
+The index produces the list. Your work is to open each row and confirm what it
+does.
+
+## 1. Two wordings
+
+Search twice. One query says what the code is for, the other says how it does
+it. A purpose wording misses a helper whose description names only its
+mechanism, and a mechanism wording misses one described only by its job.
+
+```
+search_by_intent({{SCOPE}}, query: "<what it is for>", compact: true, top_k: 20)
+search_by_intent({{SCOPE}}, query: "<how it does it>", compact: true, top_k: 20)
+```
+
+`compact: true` returns locator-only rows, which is the shape a census needs.
+Page each query while `has_more` is true:
+
+```
+search_by_intent({{SCOPE}}, query: "<the same query>", compact: true, top_k: 20, offset: <next_offset>)
+```
+
+Stop when `has_more` is false. Lower `similarity_threshold` where the tail of a
+page is still on topic.
+
+## 2. Union
+
+Join the two result sets on `file_path` and `line_number`. A row both wordings
+found is one row. Keep `retrieved_by` and `similarity` on each row, and keep
+which wording found it: a row only one wording reached is the row a single
+search would have lost.
+
+## 3. Receipt
+
+Report these numbers before the list, per query where the field is per query:
+
+- rows read, which is the count you paged to;
+- `total_candidates`, the exact size of the ranked list for that query;
+- `total_without_intent`, which is index-wide: functions carrying no intent
+  text, which no search looked at;
+- `total_intent_carried_forward` where the response states it, which are intents
+  describing the code as of an earlier scan.
+
+Then say what the index does not hold for this question. It covers each repo's
+main branch, so a change on a branch is outside it. It indexes functions that
+carry an intent, so a match inside a config file, a template or generated output
+is outside it as well.
+
+## 4. Confirm
+
+Read each row at `file_path`, from `line_number` to `end_line`. Keep the rows
+that do the thing, and drop the rest with one line each saying what they turned
+out to be. `role` on a row says what the scan joined it to, such as a route
+handler or a client, and a route handler for a different operation is not a hit.
+
+## 5. Report
+
+| file:line | function | what it does | found by |
+|---|---|---|---|
+| src/billing/charge.ts:88 | chargeCard | reads the billing key | purpose, mechanism |
+
+Close with the receipt from step 3, so the list is read against what was
+searched.
+
+## 6. Act
+
+Change nothing unless you were asked to. Offer one issue per finding that needs
+work, and file the ones accepted:
+
+```
+gh issue create --title "<concept>: <n> places, <m> need changing" --body "<the table, and the receipt>"
+```