@garygentry/system1-core 0.1.0

package/dist/spec/spec.js

@@ -0,0 +1,252 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { basename, extname, isAbsolute, join, relative, resolve } from "node:path";
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+import { parse } from "yaml";
+import { DecisionsError } from "../errors.js";
+import { assertQuestionSet } from "../model/validate.js";
+import { parseFilter, parseSort } from "../project/project.js";
+import { parseFileRef } from "../sources/read.js";
+import { parseSplit } from "../split/split.js";
+import { parseExpect } from "./expect.js";
+/**
+ * The question spec: the plugin's one durable file format. It holds a question
+ * set together with the policy that reads its answers, so thresholds live in a
+ * versioned, testable file rather than in anyone's head (charter principle 3).
+ */
+const Threshold = Type.Object({ value: Type.Number(), why: Type.String({ minLength: 1 }) });
+export const SPEC_FORMAT = 1;
+export const SpecSchema = Type.Object({
+    /** Spec file format. Absent means 1; a newer one is refused, not guessed. */
+    version: Type.Optional(Type.Integer({ minimum: 1 })),
+    description: Type.String({ minLength: 1 }),
+    questions: Type.Record(Type.String(), Type.Unknown()),
+    keep: Type.Optional(Type.Array(Type.String())),
+    sort: Type.Optional(Type.String()),
+    policy: Type.Optional(Type.Object({ thresholds: Type.Optional(Type.Record(Type.String(), Threshold)) })),
+    source: Type.Optional(Type.Object({
+        glob: Type.Optional(Type.Array(Type.String())),
+        file: Type.Optional(Type.String()),
+        jsonl: Type.Optional(Type.String()),
+        diff: Type.Optional(Type.String()),
+        split: Type.Optional(Type.String()),
+    })),
+    examples: Type.Optional(Type.Array(Type.Object({
+        id: Type.String({ minLength: 1 }),
+        /** The text (or a JSON value, sent as its JSON text) to judge. Give this or `file`. */
+        state: Type.Optional(Type.Unknown()),
+        /** A repo file to judge, `path` or `path:START-END`. Give this or `state`. */
+        file: Type.Optional(Type.String()),
+        expect: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    }))),
+    provenance: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    /** Anything else a team wants to carry, ignored by the engine. */
+    meta: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+}, 
+// A misspelled key (`kepe:`, `exepct:`) must fail rather than silently
+// becoming no policy at all.
+{ additionalProperties: false });
+const NAME = /^[a-z0-9][a-z0-9._-]*$/;
+/** Parse and validate spec text. Collects every problem before failing. */
+export function parseSpec(text, file, origin) {
+    let raw;
+    try {
+        raw = parse(text);
+    }
+    catch (error) {
+        throw new DecisionsError("invalid-request", `${file}: not valid YAML: ${String(error)}`, {
+            file,
+        });
+    }
+    const problems = [...Value.Errors(SpecSchema, raw)].map((e) => `${e.instancePath || "/"} ${e.message}`);
+    if (problems.length > 0) {
+        throw new DecisionsError("invalid-request", `${file}: invalid spec:\n  ${problems.join("\n  ")}`, { file, problems });
+    }
+    const spec = raw;
+    if ((spec.version ?? SPEC_FORMAT) > SPEC_FORMAT) {
+        throw new DecisionsError("invalid-request", `${file}: spec format version ${spec.version} is newer than this CLI understands (${SPEC_FORMAT}). Upgrade @garygentry/system1.`, { file, version: spec.version });
+    }
+    try {
+        assertQuestionSet(spec.questions);
+    }
+    catch (error) {
+        throw new DecisionsError("invalid-request", `${file}: ${error.message}`, { file });
+    }
+    const questions = spec.questions;
+    for (const text of spec.keep ?? [])
+        wrap(file, () => parseFilter(text, questions));
+    if (spec.sort)
+        wrap(file, () => parseSort(spec.sort, questions));
+    if (spec.source?.split)
+        wrap(file, () => parseSplit(spec.source?.split));
+    const name = basename(file, extname(file));
+    if (!NAME.test(name)) {
+        throw new DecisionsError("invalid-request", `${file}: spec names must be lowercase letters, digits, . _ -`, { file });
+    }
+    return { ...spec, questions, name, file, origin };
+}
+/**
+ * Problems with a spec's examples. Checked by `spec validate` and `spec check`
+ * only, so a bad example never stops `ask` or `many` from using the spec.
+ * With `repoRoot`, each example `file` must also exist inside the repo.
+ */
+export function exampleProblems(spec, repoRoot) {
+    const problems = [];
+    const ids = new Set();
+    for (const [i, example] of (spec.examples ?? []).entries()) {
+        const where = `examples[${i}] (${example.id})`;
+        if (ids.has(example.id))
+            problems.push(`${where}: duplicate id`);
+        ids.add(example.id);
+        if ((example.state === undefined) === (example.file === undefined)) {
+            problems.push(`${where}: give exactly one of state or file`);
+        }
+        if (example.expect) {
+            try {
+                parseExpect(example.expect, spec.questions, where);
+            }
+            catch (error) {
+                problems.push(error.message);
+            }
+        }
+        if (example.file !== undefined && repoRoot) {
+            const why = exampleFileProblem(example.file, repoRoot);
+            if (why)
+                problems.push(`${where}: file ${example.file} ${why}`);
+        }
+    }
+    return problems;
+}
+/**
+ * Why an example's `file` can't be used, or undefined. Only files inside the
+ * repo: a committed spec must not be able to read (and send) anything else.
+ */
+export function exampleFileProblem(ref, repoRoot) {
+    const { path } = parseFileRef(ref);
+    const full = resolve(repoRoot, path);
+    const rel = relative(repoRoot, full);
+    if (isAbsolute(path) || rel.startsWith("..") || isAbsolute(rel))
+        return "is outside the repo";
+    if (!existsSync(full))
+        return "does not exist";
+    return undefined;
+}
+/** @throws DecisionsError `invalid-request` listing every example problem. */
+export function assertExamples(spec, repoRoot) {
+    const problems = exampleProblems(spec, repoRoot);
+    if (problems.length > 0) {
+        throw new DecisionsError("invalid-request", `${spec.file}: invalid examples:\n  ${problems.join("\n  ")}`, { file: spec.file, problems });
+    }
+}
+/**
+ * Parse a question set given on its own (`--questions`): YAML or JSON, in the
+ * same shape as a spec's `questions:`.
+ */
+export function parseQuestionSet(text, from) {
+    let raw;
+    try {
+        raw = parse(text);
+    }
+    catch (error) {
+        throw new DecisionsError("invalid-request", `${from}: not valid YAML or JSON: ${String(error)}`);
+    }
+    // Accept a whole spec-shaped document too, so a spec's file can be reused as-is.
+    const questions = raw &&
+        typeof raw === "object" &&
+        "questions" in raw &&
+        !isQuestion(raw.questions)
+        ? raw.questions
+        : raw;
+    try {
+        assertQuestionSet(questions);
+    }
+    catch (error) {
+        throw new DecisionsError("invalid-request", `${from}: ${error.message}`);
+    }
+    return questions;
+}
+function isQuestion(value) {
+    return !!value && typeof value === "object" && "type" in value && "instructions" in value;
+}
+/** The default spec directories for a repo. */
+export function specDirs(repoRoot, userConfigDir, bundled) {
+    return {
+        repo: join(repoRoot, ".system1", "specs"),
+        user: join(userConfigDir, "specs"),
+        ...(bundled ? { bundled } : {}),
+    };
+}
+/**
+ * Resolve a spec by name (repo → user → bundled) or by path.
+ *
+ * @throws DecisionsError `invalid-request` when nothing matches, listing what exists.
+ */
+export function loadSpec(ref, dirs, cwd) {
+    if (ref.includes("/") || ref.endsWith(".yaml") || ref.endsWith(".yml") || ref.endsWith(".json")) {
+        const file = isAbsolute(ref) ? ref : resolve(cwd, ref);
+        if (!existsSync(file))
+            throw new DecisionsError("invalid-request", `No spec file at ${ref}`);
+        return parseSpec(readFileSync(file, "utf8"), file, "path");
+    }
+    for (const [origin, dir] of layers(dirs)) {
+        for (const ext of [".yaml", ".yml", ".json"]) {
+            const file = join(dir, `${ref}${ext}`);
+            if (existsSync(file))
+                return parseSpec(readFileSync(file, "utf8"), file, origin);
+        }
+    }
+    const known = listSpecs(dirs).map((s) => s.name);
+    throw new DecisionsError("invalid-request", `No spec named "${ref}". ${known.length ? `Available: ${known.join(", ")}.` : "No specs found."}`, { known });
+}
+export function listSpecs(dirs) {
+    const seen = new Set();
+    const out = [];
+    for (const [origin, dir] of layers(dirs)) {
+        if (!existsSync(dir))
+            continue;
+        for (const entry of readdirSync(dir).sort()) {
+            if (!/\.(ya?ml|json)$/.test(entry))
+                continue;
+            const file = join(dir, entry);
+            const name = basename(entry, extname(entry));
+            const shadowed = seen.has(name);
+            seen.add(name);
+            try {
+                const spec = parseSpec(readFileSync(file, "utf8"), file, origin);
+                out.push({
+                    name,
+                    origin,
+                    file,
+                    description: spec.description,
+                    ...(shadowed ? { shadowed } : {}),
+                });
+            }
+            catch (error) {
+                out.push({
+                    name,
+                    origin,
+                    file,
+                    error: error.message,
+                    ...(shadowed ? { shadowed } : {}),
+                });
+            }
+        }
+    }
+    return out;
+}
+function layers(dirs) {
+    return [
+        ["repo", dirs.repo],
+        ["user", dirs.user],
+        ...(dirs.bundled ? [["bundled", dirs.bundled]] : []),
+    ];
+}
+function wrap(file, fn) {
+    try {
+        fn();
+    }
+    catch (error) {
+        throw new DecisionsError("invalid-request", `${file}: ${error.message}`, { file });
+    }
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec/spec.js.map

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

package/dist/split/split.d.ts

@@ -0,0 +1,33 @@
+import type { Document, Item } from "../sources/types.js";
+/**
+ * How documents become items: one item = one state = one decision call.
+ *
+ * - `file`: each document whole.
+ * - `hunk`: each `@@` hunk of a diff document, with its file header for context.
+ * - `lines`: windows of `size` lines, overlapping by `overlap`.
+ * - `row`: JSONL rows as-is; for text, each non-empty line.
+ */
+export type SplitSpec = {
+    kind: "file";
+} | {
+    kind: "hunk";
+} | {
+    kind: "lines";
+    size: number;
+    overlap: number;
+} | {
+    kind: "row";
+}
+/** Every source as one state, joined after excludes (see `prepare`). */
+ | {
+    kind: "join";
+};
+/** Parse `file`, `hunk`, `row`, `join`, `lines:40` or `lines:40/10`. */
+export declare function parseSplit(text: string): SplitSpec;
+export declare function split(documents: readonly Document[], spec: SplitSpec): Item[];
+/**
+ * One item from many, each part headed by its id. Used by `join` after
+ * excludes have run, so a secret-shaped file is never folded in.
+ */
+export declare function joinItems(items: readonly Item[]): Item[];
+//# sourceMappingURL=split.d.ts.map

package/dist/split/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../src/split/split.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE;AACjB,wEAAwE;GACtE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAkBlD;AAED,wBAAgB,KAAK,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,CAI7E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI,EAAE,CAQxD"}

package/dist/split/split.js

@@ -0,0 +1,116 @@
+import { DecisionsError } from "../errors.js";
+/** Parse `file`, `hunk`, `row`, `join`, `lines:40` or `lines:40/10`. */
+export function parseSplit(text) {
+    if (text === "file" || text === "hunk" || text === "row" || text === "join")
+        return { kind: text };
+    const match = /^lines:(\d+)(?:\/(\d+))?$/.exec(text);
+    if (match) {
+        const size = Number(match[1]);
+        const overlap = Number(match[2] ?? 0);
+        if (size < 1 || overlap >= size) {
+            throw new DecisionsError("invalid-request", `Invalid split "${text}": need size ≥ 1 and overlap < size`);
+        }
+        return { kind: "lines", size, overlap };
+    }
+    throw new DecisionsError("invalid-request", `Unknown split "${text}" (file, hunk, row, join, lines:N[/overlap])`);
+}
+export function split(documents, spec) {
+    // `join` splits by file first, so excludes still see each file on its own.
+    const each = spec.kind === "join" ? { kind: "file" } : spec;
+    return documents.flatMap((doc) => splitOne(doc, each));
+}
+/**
+ * One item from many, each part headed by its id. Used by `join` after
+ * excludes have run, so a secret-shaped file is never folded in.
+ */
+export function joinItems(items) {
+    if (items.length <= 1)
+        return [...items];
+    const text = items
+        .map((i) => `--- ${i.id} ---\n${typeof i.state === "string" ? i.state : JSON.stringify(i.state)}`)
+        .join("\n\n");
+    return [{ id: `joined(${items.length})`, state: text }];
+}
+function splitOne(doc, spec) {
+    if (doc.kind === "row")
+        return [rowItem(doc)];
+    const text = doc.text ?? "";
+    const start = doc.startLine ?? 1;
+    switch (spec.kind) {
+        case "file":
+        case "join":
+        case "row":
+            if (spec.kind === "file" || spec.kind === "join")
+                return [base(doc, doc.id, text, doc.kind === "file" ? span(start, text) : undefined)];
+            return text
+                .split("\n")
+                .map((line, i) => ({ line, n: start + i }))
+                .filter(({ line }) => line.trim() !== "")
+                .map(({ line, n }) => base(doc, `${idRoot(doc)}:${n}`, line, { start: n, end: n }));
+        case "lines": {
+            const lines = text.split("\n");
+            const step = spec.size - spec.overlap;
+            const items = [];
+            for (let i = 0; i < lines.length; i += step) {
+                const chunk = lines.slice(i, i + spec.size);
+                const from = start + i;
+                const to = from + chunk.length - 1;
+                items.push(base(doc, `${idRoot(doc)}:${from}-${to}`, chunk.join("\n"), { start: from, end: to }));
+                if (i + spec.size >= lines.length)
+                    break;
+            }
+            return items;
+        }
+        case "hunk":
+            if (doc.kind !== "diff") {
+                throw new DecisionsError("invalid-request", `split "hunk" needs a diff source, but ${doc.id} is not a diff`);
+            }
+            return hunks(doc);
+    }
+}
+function hunks(doc) {
+    const text = doc.text ?? "";
+    const headerEnd = text.search(/^@@ /m);
+    if (headerEnd < 0)
+        return [base(doc, `${doc.path}#h0`, text)]; // binary or mode-only change
+    const header = text
+        .slice(0, headerEnd)
+        .split("\n")
+        .filter((l) => l.startsWith("--- ") || l.startsWith("+++ "))
+        .join("\n");
+    return text
+        .slice(headerEnd)
+        .split(/^(?=@@ )/m)
+        .map((hunk, i) => {
+        const m = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/.exec(hunk);
+        const from = Number(m?.[1] ?? 0);
+        const count = Number(m?.[2] ?? 1);
+        const lines = count > 0 ? { start: from, end: from + count - 1 } : undefined;
+        return base(doc, `${doc.path}#h${i + 1}`, `${header}\n${hunk.replace(/\n$/, "")}`, lines);
+    });
+}
+function rowItem(doc) {
+    return {
+        id: doc.id,
+        state: doc.data,
+        ...(doc.path ? { path: doc.path } : {}),
+        ...(doc.startLine ? { lines: { start: doc.startLine, end: doc.startLine } } : {}),
+    };
+}
+function base(doc, id, text, lines) {
+    return {
+        id,
+        state: text,
+        ...(doc.path ? { path: doc.path } : {}),
+        ...(doc.realPath ? { realPath: doc.realPath } : {}),
+        ...(lines ? { lines } : {}),
+    };
+}
+function span(start, text) {
+    return { start, end: start + text.split("\n").length - 1 };
+}
+/** A document id without any line suffix, so window ids read `path:10-49`. */
+function idRoot(doc) {
+    return doc.path ?? doc.id;
+}
+//# sourceMappingURL=split.js.map

package/dist/split/split.js.map

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

package/dist/testdata/index.d.ts

@@ -0,0 +1,5 @@
+import type { QuestionSet } from "../model/types.js";
+/** A real recorded Jev response and the question set it answered. */
+export declare const guardrailQuestions: () => QuestionSet;
+export declare const guardrailResponse: () => Record<string, unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testdata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testdata/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIpD,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,QAAO,WAAiD,CAAA;AACvF,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAyC,CAAA"}

package/dist/testdata/index.js

@@ -0,0 +1,6 @@
+import { readFileSync } from "node:fs";
+const read = (name) => JSON.parse(readFileSync(new URL(name, import.meta.url), "utf8"));
+/** A real recorded Jev response and the question set it answered. */
+export const guardrailQuestions = () => read("./guardrail.questions.json");
+export const guardrailResponse = () => read("./guardrail-ls.response.json");
+//# sourceMappingURL=index.js.map

package/dist/testdata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testdata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAGtC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;AAE/F,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAgB,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAA4B,EAAE,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA"}

package/dist/testkit/fake-model.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A stand-in decisions endpoint for tool tests: deterministic answers derived
+ * from the state's text, so tests can steer outcomes.
+ *
+ * - a state mentioning "auth" gets noul 0.95 (and the first choice option);
+ * - "maybe" gets noul 0.5 and a flat choice (undecided);
+ * - "explode" makes the endpoint answer HTTP 400;
+ * - anything else gets noul 0.05 (and the last choice option).
+ */
+export declare function fakeDecisionsFetch(): {
+    fetch: typeof fetch;
+    calls: number;
+};
+//# sourceMappingURL=fake-model.d.ts.map

package/dist/testkit/fake-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-model.d.ts","sourceRoot":"","sources":["../../src/testkit/fake-model.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,KAAK,EAAE,OAAO,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA8C3E"}

package/dist/testkit/fake-model.js

@@ -0,0 +1,57 @@
+/**
+ * A stand-in decisions endpoint for tool tests: deterministic answers derived
+ * from the state's text, so tests can steer outcomes.
+ *
+ * - a state mentioning "auth" gets noul 0.95 (and the first choice option);
+ * - "maybe" gets noul 0.5 and a flat choice (undecided);
+ * - "explode" makes the endpoint answer HTTP 400;
+ * - anything else gets noul 0.05 (and the last choice option).
+ */
+export function fakeDecisionsFetch() {
+    const counter = { calls: 0 };
+    const fetchImpl = (async (_url, init) => {
+        counter.calls += 1;
+        const body = JSON.parse(String(init.body));
+        const text = typeof body.state === "string" ? body.state : JSON.stringify(body.state);
+        if (text.includes("explode"))
+            return new Response("bad request", { status: 400 });
+        const answers = {};
+        for (const [name, q] of Object.entries(body.questions)) {
+            const hot = text.includes("auth");
+            const flat = text.includes("maybe");
+            if (q.type === "noul")
+                answers[name] = { type: "noul", noul: flat ? 0.5 : hot ? 0.95 : 0.05 };
+            if (q.type === "choice") {
+                const keys = Object.keys(q.criteria);
+                const pick = (hot ? keys[0] : keys[keys.length - 1]);
+                answers[name] = {
+                    type: "choice",
+                    choice: pick,
+                    probabilities: Object.fromEntries(keys.map((k) => [k, flat ? 1 / keys.length : k === pick ? 1 : 0])),
+                    confidence: flat ? 0 : 1,
+                };
+            }
+            if (q.type === "score") {
+                const top = q.criteria.length - 1;
+                answers[name] = {
+                    type: "score",
+                    score: hot ? top : 0,
+                    probabilities: { "0": 1 },
+                    confidence: flat ? 0.05 : 0.9,
+                };
+            }
+        }
+        return Response.json({
+            model: "typesafe/jev-1.13-20260917",
+            answers,
+            usage: { input_tokens: 100, output_tokens: 10, cost: 0.000004 },
+        });
+    });
+    return {
+        fetch: fetchImpl,
+        get calls() {
+            return counter.calls;
+        },
+    };
+}
+//# sourceMappingURL=fake-model.js.map

package/dist/testkit/fake-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-model.js","sourceRoot":"","sources":["../../src/testkit/fake-model.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;IAC5B,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,IAAY,EAAE,IAAiB,EAAE,EAAE;QAC3D,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAA+C,CAAA;QACxF,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrF,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QACjF,MAAM,OAAO,GAA2B,EAAE,CAAA;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YACnC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YAC7F,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;gBACpC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAW,CAAA;gBAC9D,OAAO,CAAC,IAAI,CAAC,GAAG;oBACd,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,IAAI;oBACZ,aAAa,EAAE,MAAM,CAAC,WAAW,CAC/B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAClE;oBACD,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACzB,CAAA;YACH,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;gBACjC,OAAO,CAAC,IAAI,CAAC,GAAG;oBACd,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBACpB,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;oBACzB,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;iBAC9B,CAAA;YACH,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,4BAA4B;YACnC,OAAO;YACP,KAAK,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAChE,CAAC,CAAA;IACJ,CAAC,CAA4B,CAAA;IAC7B,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,KAAK;YACP,OAAO,OAAO,CAAC,KAAK,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/testkit/tmp.d.ts

@@ -0,0 +1,6 @@
+/** Temp directories removed after each test. Call at module level. */
+export declare function useTempDirs(): (files?: Record<string, string>) => string;
+export declare function writeTree(root: string, files: Record<string, string>): void;
+/** A throwaway git repo with one commit of `files`. */
+export declare function gitRepo(dir: string, files: Record<string, string>): string;
+//# sourceMappingURL=tmp.d.ts.map

package/dist/testkit/tmp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmp.d.ts","sourceRoot":"","sources":["../../src/testkit/tmp.ts"],"names":[],"mappings":"AAQA,sEAAsE;AACtE,wBAAgB,WAAW,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAUxE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAM3E;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAkB1E"}

package/dist/testkit/tmp.js

@@ -0,0 +1,46 @@
+import { execFileSync } from "node:child_process";
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { afterEach } from "vitest";
+const dirs = [];
+/** Temp directories removed after each test. Call at module level. */
+export function useTempDirs() {
+    afterEach(() => {
+        for (const dir of dirs.splice(0))
+            rmSync(dir, { recursive: true, force: true });
+    });
+    return (files = {}) => {
+        const dir = mkdtempSync(join(tmpdir(), "decisions-test-"));
+        dirs.push(dir);
+        writeTree(dir, files);
+        return dir;
+    };
+}
+export function writeTree(root, files) {
+    for (const [path, content] of Object.entries(files)) {
+        const file = join(root, path);
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, content);
+    }
+}
+/** A throwaway git repo with one commit of `files`. */
+export function gitRepo(dir, files) {
+    writeTree(dir, files);
+    const git = (...args) => execFileSync("git", ["-C", dir, ...args], {
+        stdio: "ignore",
+        env: {
+            ...process.env,
+            GIT_AUTHOR_NAME: "t",
+            GIT_AUTHOR_EMAIL: "t@t",
+            GIT_COMMITTER_NAME: "t",
+            GIT_COMMITTER_EMAIL: "t@t",
+            GIT_CONFIG_GLOBAL: "/dev/null",
+        },
+    });
+    git("init", "-q", "-b", "main");
+    git("add", "-A");
+    git("commit", "-q", "-m", "init");
+    return dir;
+}
+//# sourceMappingURL=tmp.js.map

package/dist/testkit/tmp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmp.js","sourceRoot":"","sources":["../../src/testkit/tmp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,MAAM,IAAI,GAAa,EAAE,CAAA;AAEzB,sEAAsE;AACtE,MAAM,UAAU,WAAW;IACzB,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACd,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrB,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAA6B;IACnE,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC7B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,KAA6B;IAChE,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACrB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAc,EAAE,EAAE,CAChC,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE;QACxC,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,eAAe,EAAE,GAAG;YACpB,gBAAgB,EAAE,KAAK;YACvB,kBAAkB,EAAE,GAAG;YACvB,mBAAmB,EAAE,KAAK;YAC1B,iBAAiB,EAAE,WAAW;SAC/B;KACF,CAAC,CAAA;IACJ,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/B,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAChB,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IACjC,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/tools/ask.d.ts

@@ -0,0 +1,32 @@
+import type { Answers, Usage } from "../model/types.js";
+import type { AnswerSource } from "../run/spend.js";
+import type { LineRange } from "../sources/types.js";
+import { type ToolContext } from "./context.js";
+import { type SkippedSummary } from "./many.js";
+export interface AskResult {
+    spec?: string;
+    id: string;
+    path?: string;
+    lines?: LineRange;
+    source: AnswerSource;
+    model: string;
+    servedBy: string;
+    answers: Answers;
+    /** Answers too flat to act on. */
+    undecided: string[];
+    /**
+     * With `keep`: whether this one state passes. Undecided on any question the
+     * filters reference means `undecided`, never a pass or fail.
+     */
+    verdict?: "kept" | "dropped" | "undecided";
+    usage: Usage;
+    latencyMs: number;
+    skipped: SkippedSummary;
+    redactions: {
+        total: number;
+        items: number;
+    };
+}
+/** One state, one question set, one call. The shape hooks and scripts want. */
+export declare function runAsk(ctx: ToolContext, rawInput: unknown): Promise<AskResult>;
+//# sourceMappingURL=ask.d.ts.map

package/dist/tools/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/tools/ask.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AACvF,OAAO,EAAE,KAAK,cAAc,EAAoB,MAAM,WAAW,CAAA;AAGjE,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAA;IAC1C,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7C;AAED,+EAA+E;AAC/E,wBAAsB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA0DpF"}