@nonameolsson/nightjar 0.0.0-stage → 0.2.0

package/dist/fakes/code-host.js

@@ -0,0 +1,42 @@
+export class FakeCodeHost {
+    pushes = [];
+    pulls = [];
+    change(id, over) {
+        const known = this.pulls.some((p) => p.id === id);
+        if (!known)
+            throw new Error(`the fake Code host has no pull request ${String(id)}`);
+        this.pulls = this.pulls.map((p) => (p.id === id ? { ...p, ...over(p) } : p));
+    }
+    push = (folder, branch) => {
+        this.pushes.push({ folder, branch });
+        return Promise.resolve();
+    };
+    openPull = (branch) => {
+        const found = this.pulls.find((p) => p.head === branch);
+        return Promise.resolve(found ? { id: found.id, url: found.url } : null);
+    };
+    createDraft = (request) => {
+        const id = 100 + this.pulls.length;
+        const url = `https://code.example/pull/${String(id)}`;
+        this.pulls.push({ ...request, id, url, draft: true, references: [], comments: [] });
+        return Promise.resolve({ id, url });
+    };
+    editBody = (pull, body) => {
+        this.change(pull.id, () => ({ body }));
+        return Promise.resolve();
+    };
+    placeReferences = (pull, references) => {
+        this.change(pull.id, (p) => ({
+            references: [
+                ...p.references,
+                ...references.filter((r) => !p.references.some((q) => q.id === r.id))
+            ]
+        }));
+        return Promise.resolve();
+    };
+    comment = (pull, body) => {
+        this.change(pull.id, (p) => ({ comments: [...p.comments, body] }));
+        return Promise.resolve();
+    };
+}
+//# sourceMappingURL=code-host.js.map

package/dist/fakes/code-host.js.map

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

package/dist/fakes/harness.d.ts

@@ -0,0 +1,7 @@
+import type { CodeHostHarness, CodeHostSubject } from '../contract/code-host.js';
+import type { TrackerHarness } from '../contract/tracker.js';
+import { FakeCodeHost } from './code-host.js';
+export declare const fakeCodeHostHarness: CodeHostHarness;
+export declare function fakeCodeHostSubject(codeHost: FakeCodeHost): CodeHostSubject;
+export declare const fakeTrackerHarness: TrackerHarness;
+export declare const keyedTrackerHarness: (prefix: string) => TrackerHarness;

package/dist/fakes/harness.js

@@ -0,0 +1,68 @@
+import { FakeCodeHost } from './code-host.js';
+import { FakeTracker } from './tracker.js';
+export const fakeCodeHostHarness = () => Promise.resolve(fakeCodeHostSubject(new FakeCodeHost()));
+// The fake keeps no commits, so each commit gets a folder of its own that names it.
+export function fakeCodeHostSubject(codeHost) {
+    const commits = new Map();
+    return {
+        codeHost,
+        base: 'main',
+        commit: () => {
+            const n = String(commits.size + 1);
+            const made = { folder: `/work/${n}`, commit: `c${n}` };
+            commits.set(made.folder, made.commit);
+            return Promise.resolve(made);
+        },
+        branch: (name) => {
+            const last = codeHost.pushes.findLast((p) => p.branch === name);
+            return Promise.resolve(last ? (commits.get(last.folder) ?? null) : null);
+        },
+        pull: (pull) => {
+            const found = codeHost.pulls.find((p) => p.id === pull.id);
+            if (found === undefined)
+                throw new Error(`the fake Code host has no pull ${String(pull.id)}`);
+            return Promise.resolve({
+                title: found.title,
+                head: found.head,
+                base: found.base,
+                body: found.body,
+                draft: found.draft,
+                references: found.references.map((r) => r.text),
+                comments: found.comments
+            });
+        }
+    };
+}
+export const fakeTrackerHarness = (world) => keyedTrackerHarness('')(world);
+// The fake Tracker keyed as `prefix` says, so `PROJ-` gives PROJ-1, PROJ-2 and on.
+export const keyedTrackerHarness = (prefix) => (world) => {
+    const tracker = new FakeTracker(world.person, () => new Date(), prefix);
+    const ids = new Map(world.items.map((item, i) => [item.key, `${prefix}${String(i + 1)}`]));
+    const id = (key) => {
+        const found = ids.get(key);
+        if (found === undefined)
+            throw new Error(`the world has no item ${key}`);
+        return found;
+    };
+    for (const item of world.items) {
+        tracker.add({
+            id: id(item.key),
+            title: item.title,
+            body: item.body ?? '',
+            open: item.open ?? true,
+            assignees: item.assignees ?? [],
+            signals: item.signals ?? [],
+            children: (item.children ?? []).map(id),
+            blockedBy: (item.blockedBy ?? []).map(id)
+        });
+        for (const c of item.comments ?? []) {
+            tracker.say(id(item.key), {
+                author: c.author,
+                body: c.body,
+                trusted: world.trusted.includes(c.author)
+            });
+        }
+    }
+    return Promise.resolve({ tracker, id });
+};
+//# sourceMappingURL=harness.js.map

package/dist/fakes/harness.js.map

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

package/dist/fakes/machine.d.ts

@@ -0,0 +1,11 @@
+export type Tool = 'gh' | 'az' | 'claude';
+export declare const STAND_INS: Record<Tool, string>;
+export interface Machine {
+    readonly root: string;
+    readonly env: Record<string, string>;
+    calls(tool: Tool): string;
+    writeConfig(config: Record<string, unknown>): void;
+    readConfig(): unknown;
+    remove(): void;
+}
+export declare function machine(without?: readonly Tool[]): Machine;

package/dist/fakes/machine.js

@@ -0,0 +1,101 @@
+// Stand-ins for gh, az and claude on a PATH that holds nothing else, so no spec reaches the real ones.
+// A stand-in may use shell builtins only: sed, grep, awk and the rest are not on that PATH.
+import { spawnSync } from 'node:child_process';
+import { chmodSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+// gh as ann with Feature #1 on o/r; FAKE_GH_EXISTING (comma separated) labels exist; FAKE_GH_SIGNED_OUT fails every call
+const GH = String.raw `#!/bin/bash
+echo "$*" >> "$FAKE_GH_CALLS"
+if [ -n "$FAKE_GH_SIGNED_OUT" ]; then
+  echo "To get started with GitHub CLI, please run:  gh auth login" >&2; exit 4
+fi
+issue='{"number":1,"title":"One escape","body":"","state":"open","labels":[{"name":"factory-go"}],"assignees":[{"login":"ann"}],"user":{"login":"ann"},"sub_issues_summary":{"total":1}}'
+case "$*" in
+  "api user") echo '{"login":"ann"}' ;;
+  "api repos/o/r/issues?"*) echo "[$issue]" ;;
+  "api -X POST repos/"*"/labels "*)
+    all="$*"; name="@{all#*-f name=}"; name="@{name%% -f*}"
+    if [[ ",$FAKE_GH_EXISTING," == *",$name,"* ]]; then
+      echo '{"message":"Validation Failed","errors":[{"code":"already_exists"}]}'
+      echo "gh: Validation Failed (HTTP 422)" >&2; exit 1
+    fi
+    if [ -n "$FAKE_GH_NO_LABELS" ]; then echo "gh: Resource not accessible by integration (HTTP 403)" >&2; exit 1; fi
+    echo '{}' ;;
+  "api repos/"*"/labels/"*)
+    all="$*"; name="@{all#api repos/*/labels/}"; name="@{name//%20/ }"
+    if [[ ",$FAKE_GH_EXISTING," == *",$name,"* ]]; then echo '{}'; else echo "gh: Not Found (HTTP 404)" >&2; exit 1; fi ;;
+  *) echo "gh: Not Found (HTTP 404)" >&2; exit 1 ;;
+esac`;
+// az: FAKE_AZ_SIGNED_OUT makes it refuse a token as a signed-out az does
+const AZ = String.raw `#!/bin/bash
+echo "$*" >> "$FAKE_AZ_CALLS"
+if [ -n "$FAKE_AZ_SIGNED_OUT" ]; then
+  echo "ERROR: Please run 'az login' to setup account." >&2; exit 1
+fi
+echo '{"accessToken":"fake-azure-devops"}'`;
+// claude: FAKE_CLAUDE_SIGNED_OUT makes `claude auth status --json` exit 1 as a signed-out claude does, and each
+// call notes the CLAUDE_CONFIG_DIR and CLAUDE_CODE_OAUTH_TOKEN it ran with;
+// a headless session prints its init line with the skills of FAKE_CLAUDE_SKILLS (comma separated)
+const CLAUDE = String.raw `#!/bin/bash
+echo "$* [dir=$CLAUDE_CONFIG_DIR token=$CLAUDE_CODE_OAUTH_TOKEN]" >> "$FAKE_CLAUDE_CALLS"
+case "$*" in
+  "--version") echo "2.1.314 (Claude Code)" ;;
+  "auth status --json")
+    if [ -n "$FAKE_CLAUDE_SIGNED_OUT" ]; then echo '{"loggedIn": false}'; exit 1; fi
+    echo "{\"loggedIn\":true,\"email\":\"ann@x.io\",\"orgName\":\"Acme\",\"subscriptionType\":\"max\",\"authMethod\":\"claude.ai\",\"configDirectory\":\"@{CLAUDE_CONFIG_DIR:-$HOME/.claude}\"}" ;;
+  "-p "*)
+    skills=""
+    if [ -n "$FAKE_CLAUDE_SKILLS" ]; then skills="\"@{FAKE_CLAUDE_SKILLS//,/\",\"}\""; fi
+    echo "{\"type\":\"system\",\"subtype\":\"init\",\"apiKeySource\":\"none\",\"skills\":[$skills]}" ;;
+esac`;
+export const STAND_INS = { gh: GH, az: AZ, claude: CLAUDE };
+// `@{` stands for a shell's own brace expansion, which a template literal cannot hold
+function script(dir, name, body) {
+    const path = join(dir, name);
+    writeFileSync(path, `${body.replaceAll('@{', '$' + '{')}\n`);
+    chmodSync(path, 0o755);
+}
+// `without` leaves a tool off the PATH altogether, as a machine that never installed it.
+export function machine(without = []) {
+    const base = realpathSync(mkdtempSync(join(tmpdir(), 'nightjar-machine-')));
+    const bin = join(base, 'bin');
+    mkdirSync(bin);
+    const git = spawnSync('which', ['git'], { encoding: 'utf8' }).stdout.trim();
+    symlinkSync(realpathSync(git), join(bin, 'git'));
+    for (const tool of Object.keys(STAND_INS)) {
+        if (!without.includes(tool))
+            script(bin, tool, STAND_INS[tool]);
+    }
+    const gitconfig = join(base, 'gitconfig');
+    writeFileSync(gitconfig, '');
+    const root = join(base, 'app');
+    mkdirSync(root);
+    const env = {
+        PATH: bin,
+        HOME: join(base, 'home'),
+        TMPDIR: base,
+        GIT_CONFIG_GLOBAL: gitconfig,
+        GIT_CONFIG_NOSYSTEM: '1',
+        GIT_TERMINAL_PROMPT: '0',
+        FAKE_GH_CALLS: join(base, 'gh-calls.txt'),
+        FAKE_AZ_CALLS: join(base, 'az-calls.txt'),
+        FAKE_CLAUDE_CALLS: join(base, 'claude-calls.txt')
+    };
+    for (const calls of [env.FAKE_GH_CALLS, env.FAKE_AZ_CALLS, env.FAKE_CLAUDE_CALLS]) {
+        writeFileSync(calls ?? '', '');
+    }
+    const inRoot = (...args) => spawnSync('git', args, { cwd: root, env, encoding: 'utf8' });
+    inRoot('init', '-q', '-b', 'main');
+    inRoot('remote', 'add', 'origin', 'git@github.com:o/r.git');
+    const file = join(root, 'factory.json');
+    return {
+        root,
+        env,
+        calls: (tool) => readFileSync(env[`FAKE_${tool.toUpperCase()}_CALLS`] ?? '', 'utf8'),
+        writeConfig: (config) => writeFileSync(file, JSON.stringify(config, null, '\t')),
+        readConfig: () => JSON.parse(readFileSync(file, 'utf8')),
+        remove: () => rmSync(base, { recursive: true, force: true })
+    };
+}
+//# sourceMappingURL=machine.js.map

package/dist/fakes/machine.js.map

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

package/dist/fakes/tracker.d.ts

@@ -0,0 +1,40 @@
+import type { Signal } from '../signals.js';
+import type { Comment, Feature, FeatureWriter, ItemId, ItemText, Standing, Ticket, TicketReference, Tracker } from '../tracker.js';
+export interface FakeItem {
+    readonly id: ItemId;
+    readonly title: string;
+    readonly body: string;
+    readonly open: boolean;
+    readonly assignees: readonly string[];
+    readonly signals: readonly Signal[];
+    readonly children: readonly ItemId[];
+    readonly blockedBy: readonly ItemId[];
+    readonly comments: readonly Comment[];
+}
+export type NewItem = Pick<FakeItem, 'id' | 'title'> & Partial<FakeItem>;
+export declare class FakeTracker implements Tracker, FeatureWriter {
+    readonly person: string;
+    private readonly now;
+    private readonly prefix;
+    readonly items: Map<string, FakeItem>;
+    constructor(person?: string, now?: () => Date, prefix?: string);
+    add(item: NewItem): this;
+    say(id: ItemId, comment: Omit<Comment, 'at'> & Partial<Pick<Comment, 'at'>>): this;
+    close(id: ItemId): this;
+    signalsOf: (id: ItemId) => readonly Signal[];
+    said: (id: ItemId) => string[];
+    private get;
+    me: () => Promise<string>;
+    assignedFeatures: (person: string) => Promise<Feature[]>;
+    feature: (id: ItemId) => Promise<Feature>;
+    standing: (id: ItemId) => Promise<Standing>;
+    tickets: (featureId: ItemId) => Promise<Ticket[]>;
+    comments: (id: ItemId) => Promise<Comment[]>;
+    addSignal: (id: ItemId, signal: Signal) => Promise<void>;
+    removeSignal: (id: ItemId, signal: Signal) => Promise<void>;
+    comment: (id: ItemId, body: string) => Promise<void>;
+    reference: (id: ItemId) => TicketReference;
+    createFeature: ({ title, body }: ItemText) => Promise<ItemId>;
+    createTicket: (featureId: ItemId, ticket: ItemText) => Promise<ItemId>;
+    block: (id: ItemId, blocker: ItemId) => Promise<void>;
+}

package/dist/fakes/tracker.js

@@ -0,0 +1,116 @@
+export class FakeTracker {
+    person;
+    now;
+    prefix;
+    items = new Map();
+    constructor(
+    // the signed-in person, whose comments are trusted
+    person = 'ann', now = () => new Date(), 
+    // what the ids it makes start with, such as PROJ- for keys as Jira spells them
+    prefix = '') {
+        this.person = person;
+        this.now = now;
+        this.prefix = prefix;
+    }
+    add(item) {
+        this.items.set(item.id, {
+            body: `The body of ${item.title}.`,
+            open: true,
+            assignees: [],
+            signals: [],
+            children: [],
+            blockedBy: [],
+            comments: [],
+            ...item
+        });
+        return this;
+    }
+    // A comment by anyone, trusted or not.
+    say(id, comment) {
+        const item = this.get(id);
+        const at = comment.at ?? this.now().toISOString();
+        this.items.set(id, { ...item, comments: [...item.comments, { ...comment, at }] });
+        return this;
+    }
+    close(id) {
+        this.items.set(id, { ...this.get(id), open: false });
+        return this;
+    }
+    signalsOf = (id) => this.get(id).signals;
+    said = (id) => this.get(id).comments.map((c) => c.body);
+    get(id) {
+        const item = this.items.get(id);
+        if (item === undefined)
+            throw new Error(`the fake Tracker has no item #${id}`);
+        return item;
+    }
+    me = () => Promise.resolve(this.person);
+    assignedFeatures = (person) => Promise.resolve([...this.items.values()]
+        .filter((i) => i.open &&
+        i.children.length > 0 &&
+        i.assignees.includes(person) &&
+        i.signals.includes('go'))
+        // the fake counts a lower id as older, PROJ-2 before PROJ-10
+        .sort((a, b) => a.id.localeCompare(b.id, 'en', { numeric: true }))
+        .map(({ id, title, body }) => ({ id, title, body })));
+    feature = (id) => {
+        const { title, body } = this.get(id);
+        return Promise.resolve({ id, title, body });
+    };
+    standing = (id) => {
+        const { assignees, signals } = this.get(id);
+        return Promise.resolve({ assignees, signals });
+    };
+    tickets = (featureId) => Promise.resolve(this.get(featureId).children.map((child) => {
+        const t = this.get(child);
+        return {
+            id: t.id,
+            title: t.title,
+            body: t.body,
+            open: t.open,
+            signals: t.signals,
+            blockedBy: t.blockedBy.map((b) => ({ id: b, open: this.items.get(b)?.open ?? true }))
+        };
+    }));
+    comments = (id) => Promise.resolve([...this.get(id).comments]);
+    addSignal = (id, signal) => {
+        const item = this.get(id);
+        if (!item.signals.includes(signal)) {
+            this.items.set(id, { ...item, signals: [...item.signals, signal] });
+        }
+        return Promise.resolve();
+    };
+    removeSignal = (id, signal) => {
+        const item = this.get(id);
+        this.items.set(id, { ...item, signals: item.signals.filter((s) => s !== signal) });
+        return Promise.resolve();
+    };
+    comment = (id, body) => {
+        this.say(id, { author: this.person, body, trusted: true });
+        return Promise.resolve();
+    };
+    reference = (id) => ({ id, text: `#${id}` });
+    createFeature = ({ title, body }) => {
+        let n = this.items.size + 1;
+        while (this.items.has(`${this.prefix}${String(n)}`))
+            n += 1;
+        const id = `${this.prefix}${String(n)}`;
+        this.add({ id, title, body });
+        return Promise.resolve(id);
+    };
+    createTicket = async (featureId, ticket) => {
+        const feature = this.get(featureId);
+        const id = await this.createFeature(ticket);
+        this.items.set(featureId, { ...feature, children: [...feature.children, id] });
+        return id;
+    };
+    block = (id, blocker) => {
+        const item = this.get(id);
+        this.get(blocker);
+        if (!item.blockedBy.includes(blocker)) {
+            this.items.set(id, { ...item, blockedBy: [...item.blockedBy, blocker] });
+        }
+        return Promise.resolve();
+    };
+}
+//# sourceMappingURL=tracker.js.map

package/dist/fakes/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../src/fakes/tracker.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,WAAW;IAKb;IACQ;IAEA;IAPT,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C;IACC,mDAAmD;IAC1C,SAAS,KAAK,EACN,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IACnD,+EAA+E;IAC9D,SAAS,EAAE;QAHnB,WAAM,GAAN,MAAM,CAAQ;QACN,QAAG,GAAH,GAAG,CAA+B;QAElC,WAAM,GAAN,MAAM,CAAK;IAC1B,CAAC;IAEJ,GAAG,CAAC,IAAa;QAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;YACvB,IAAI,EAAE,eAAe,IAAI,CAAC,KAAK,GAAG;YAClC,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,QAAQ,EAAE,EAAE;YACZ,GAAG,IAAI;SACP,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;IAED,uCAAuC;IACvC,GAAG,CAAC,EAAU,EAAE,OAA2D;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,EAAU;QACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,SAAS,GAAG,CAAC,EAAU,EAAqB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IAEpE,IAAI,GAAG,CAAC,EAAU,EAAY,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAElE,GAAG,CAAC,EAAU;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC;IACb,CAAC;IAED,EAAE,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExC,gBAAgB,GAAG,CAAC,MAAc,EAAsB,EAAE,CACzD,OAAO,CAAC,OAAO,CACd,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;SACtB,MAAM,CACN,CAAC,CAAC,EAAE,EAAE,CACL,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5B,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CACzB;QACD,6DAA6D;SAC5D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SACjE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CACrD,CAAC;IAEH,OAAO,GAAG,CAAC,EAAU,EAAoB,EAAE;QAC1C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,QAAQ,GAAG,CAAC,EAAU,EAAqB,EAAE;QAC5C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC;IAEF,OAAO,GAAG,CAAC,SAAiB,EAAqB,EAAE,CAClD,OAAO,CAAC,OAAO,CACd,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO;YACN,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;SACrF,CAAC;IACH,CAAC,CAAC,CACF,CAAC;IAEH,QAAQ,GAAG,CAAC,EAAU,EAAsB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3F,SAAS,GAAG,CAAC,EAAU,EAAE,MAAc,EAAiB,EAAE;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,YAAY,GAAG,CAAC,EAAU,EAAE,MAAc,EAAiB,EAAE;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;QACnF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,OAAO,GAAG,CAAC,EAAU,EAAE,IAAY,EAAiB,EAAE;QACrD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,SAAS,GAAG,CAAC,EAAU,EAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEtE,aAAa,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAY,EAAmB,EAAE;QAC9D,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,YAAY,GAAG,KAAK,EAAE,SAAiB,EAAE,MAAgB,EAAmB,EAAE;QAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,KAAK,GAAG,CAAC,EAAU,EAAE,OAAe,EAAiB,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC;CACF"}

package/dist/feature-file.d.ts

@@ -0,0 +1,12 @@
+import type { ItemText } from './tracker.js';
+export declare class FeatureFileError extends Error {
+}
+export interface PlannedTicket extends ItemText {
+    readonly number: number;
+    readonly blockedBy: readonly number[];
+}
+export interface FeaturePlan {
+    readonly feature: ItemText;
+    readonly tickets: readonly PlannedTicket[];
+}
+export declare function readFeatureFile(text: string): FeaturePlan;

package/dist/feature-file.js

@@ -0,0 +1,84 @@
+export class FeatureFileError extends Error {
+}
+const TITLE = /^#\s+(.*\S)\s*$/;
+const TICKET = /^##\s+Ticket\s+(\S+?):\s*(.*?)\s*$/i;
+const BLOCKED_BY = /^(?:\*\*)?Blocked by:(?:\*\*)?(.*)$/i;
+// the lines the build reads a Ticket's model and effort from (ticketLine in build.ts)
+const SETTING = /^(?:\*\*)?(Model|Effort):(?:\*\*)?(.*)$/i;
+const CRITERIA = /^#{1,6}\s+Acceptance criteria\s*$/i;
+const CHECKBOX = /^\s*[-*]\s+\[[ xX]\]\s+\S/;
+const FENCE = /^\s*(```|~~~)/;
+const tidy = (lines) => lines.join('\n').trim();
+// The Feature and its Tickets, or a FeatureFileError that names every fault with its line.
+export function readFeatureFile(text) {
+    const lines = text.replace(/\r\n/g, '\n').split('\n');
+    const faults = [];
+    const first = lines.findIndex((l) => l.trim() !== '');
+    const title = TITLE.exec(lines[first] ?? '')?.[1];
+    if (title === undefined) {
+        faults.push(`line ${String(first + 1)}: the file starts with the Feature's title, as "# Title"`);
+    }
+    const featureLines = [];
+    const sections = [];
+    let fenced = false;
+    lines.forEach((line, i) => {
+        if (i <= first)
+            return;
+        if (FENCE.test(line))
+            fenced = !fenced;
+        const heading = fenced ? null : TICKET.exec(line);
+        if (heading) {
+            sections.push({ number: heading[1] ?? '', title: heading[2] ?? '', line: i + 1, lines: [] });
+        }
+        else
+            (sections.at(-1)?.lines ?? featureLines).push(line);
+    });
+    if (sections.length === 0)
+        faults.push('the file holds no Ticket; start each with "## Ticket 1: Title"');
+    const tickets = [];
+    sections.forEach((section, i) => {
+        const number = i + 1;
+        const name = `Ticket ${section.number}`;
+        const at = `line ${String(section.line)}`;
+        if (section.number !== String(number)) {
+            faults.push(`${at}: ${name} is the Ticket numbered ${String(number)}; number them 1, 2, 3 in order`);
+        }
+        if (section.title === '')
+            faults.push(`${at}: ${name} has no title`);
+        const blockedBy = [];
+        const body = [];
+        for (const line of section.lines) {
+            const blockers = BLOCKED_BY.exec(line.trim());
+            if (blockers === null) {
+                body.push(line);
+                continue;
+            }
+            const listed = (blockers[1] ?? '').trim();
+            if (/^none$/i.test(listed))
+                continue;
+            for (const part of listed.split(',').map((p) => p.trim())) {
+                const blocker = /^\d+$/.test(part) ? Number(part) : NaN;
+                if (!(blocker >= 1 && blocker < number)) {
+                    faults.push(`${at}: ${name} is blocked by "${part}"; name the numbers of Tickets above it, as "**Blocked by:** 1, 2"`);
+                }
+                else if (!blockedBy.includes(blocker))
+                    blockedBy.push(blocker);
+            }
+        }
+        for (const line of body) {
+            const setting = SETTING.exec(line.trim());
+            if (setting !== null && (setting[2] ?? '').trim() === '') {
+                faults.push(`${at}: ${name} has an empty ${setting[1] ?? ''} line; give it a value or leave it out`);
+            }
+        }
+        const criteria = body.findIndex((l) => CRITERIA.test(l));
+        if (criteria === -1 || !body.slice(criteria).some((l) => CHECKBOX.test(l))) {
+            faults.push(`${at}: ${name} has no acceptance criteria; add an "Acceptance criteria" heading with "- [ ]" items`);
+        }
+        tickets.push({ number, title: section.title, body: tidy(body), blockedBy });
+    });
+    if (faults.length > 0)
+        throw new FeatureFileError(faults.join('\n'));
+    return { feature: { title: title ?? '', body: tidy(featureLines) }, tickets };
+}
+//# sourceMappingURL=feature-file.js.map

package/dist/feature-file.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,9 @@
+export type Env = Readonly<Record<string, string | undefined>>;
+export interface Run {
+    readonly ok: boolean;
+    readonly out: string;
+    readonly err: string;
+    readonly missing: boolean;
+}
+export declare function run(command: string, args: readonly string[], cwd: string, env: Env): Promise<Run>;
+export declare const firstLine: (text: string) => string;

package/dist/git.js

@@ -0,0 +1,12 @@
+// Never through a shell, so no title or branch name is ever parsed as shell text.
+import { execFile } from 'node:child_process';
+export function run(command, args, cwd, env) {
+    return new Promise((done) => {
+        execFile(command, args, { cwd, env, maxBuffer: 16 * 1024 * 1024 }, (fault, out, err) => {
+            const missing = fault?.code === 'ENOENT';
+            done({ ok: fault === null, out, err, missing });
+        });
+    });
+}
+export const firstLine = (text) => text.trim().split('\n')[0] ?? '';
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAY9C,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,IAAuB,EAAE,GAAW,EAAE,GAAQ;IAClF,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YACtF,MAAM,OAAO,GAAI,KAAsC,EAAE,IAAI,KAAK,QAAQ,CAAC;YAC3E,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC"}

package/dist/github/api.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { type Env, type Run } from '../git.js';
+export declare class GitHubFailure extends Error {
+}
+export type GhRunner = (args: readonly string[]) => Promise<Run>;
+export declare const ghRunner: (cwd: string, env: Env) => GhRunner;
+export declare const IssueSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodInt>;
+    number: z.ZodInt;
+    title: z.ZodString;
+    body: z.ZodNullable<z.ZodString>;
+    state: z.ZodString;
+    labels: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$loose>>;
+    assignees: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$loose>>>>;
+    user: z.ZodNullable<z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$loose>>;
+    sub_issues_summary: z.ZodOptional<z.ZodObject<{
+        total: z.ZodInt;
+    }, z.core.$loose>>;
+    pull_request: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>;
+export type RawIssue = z.infer<typeof IssueSchema>;
+export declare const PAGE = "per_page=100";
+export declare class GitHubApi {
+    readonly repo: string;
+    private readonly gh;
+    constructor(repo: string, gh: GhRunner);
+    raw(args: readonly string[]): Promise<Run>;
+    call(what: string, args: readonly string[]): Promise<unknown>;
+    parse<T>(what: string, args: readonly string[], schema: z.ZodType<T>): Promise<T>;
+}
+export declare function repoFromRemote(url: string): string | null;