@nonameolsson/nightjar 0.0.0-stage → 0.2.0

package/dist/config.js

@@ -0,0 +1,294 @@
+// factory.json; schema/factory.schema.json is generated from the same definition.
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { DEFAULT_SIGNAL_NAMES, RESERVED_NAMES } from './signals.js';
+import { why } from './say.js';
+export class ConfigError extends Error {
+}
+export const CONFIG_FILE = 'factory.json';
+const repo = z
+    .string()
+    .regex(/^[^/\s]+\/[^/\s]+$/, 'must be owner/name')
+    .optional()
+    .meta({ description: 'owner/name on GitHub; when left out, read from the origin remote' });
+const GitHubTracker = z
+    .strictObject({ type: z.literal('github'), repo })
+    .meta({ description: 'GitHub Issues: a Feature is an issue with sub-issues, its Tickets' });
+const missingOr = (what) => (issue) => issue.input === undefined ? `missing: ${what}` : undefined;
+const named = (what) => z.string({ error: missingOr(what) }).regex(/\S/, what);
+const organization = named('name the organization')
+    .regex(/^[^/\s:]+$/, 'the organization name alone, as in dev.azure.com/<organization>')
+    .meta({ description: 'The organization, as in dev.azure.com/<organization>' });
+const AzureDevOpsTracker = z
+    .strictObject({
+    type: z.literal('azure-devops'),
+    organization,
+    project: named('name the project').meta({ description: 'The project that holds the Features' }),
+    featureType: named('name the work item type that plays the Feature').meta({
+        description: 'The work item type that plays the Feature, such as Feature, Epic or Product Backlog Item'
+    }),
+    ticketType: z
+        .string()
+        .regex(/\S/, 'name the work item type of a Ticket, or leave ticketType out')
+        .optional()
+        .meta({
+        description: 'The work item type nightjar create makes each Ticket as, such as User Story, Product Backlog Item or Issue. Left out, nightjar create makes no Tickets.'
+    })
+})
+    .meta({
+    description: 'Azure DevOps Boards: a Feature is a work item of featureType, its child work items its Tickets'
+});
+const GitHubCodeHost = z
+    .strictObject({ type: z.literal('github'), repo })
+    .meta({ description: 'GitHub: the branch is pushed to origin and a draft pull request opened' });
+const AzureReposCodeHost = z
+    .strictObject({
+    type: z.literal('azure-devops'),
+    organization,
+    project: named('name the project').meta({ description: 'The project that holds the repo' }),
+    repo: named('name the repo').meta({ description: 'The Git repo on Azure Repos, by name' })
+})
+    .meta({
+    description: 'Azure Repos: the branch is pushed to the repo and a draft pull request opened, signed in as for Azure DevOps Boards'
+});
+// An Adapter the repo brings itself: a module (docs/custom-adapters.md) that builds the Tracker or Code host.
+const adapterModule = (what) => z
+    .strictObject({
+    type: z.literal('module'),
+    path: z
+        .string({ error: missingOr('name the module') })
+        .regex(/\S/, 'name the module')
+        .meta({
+        description: `The module that builds the ${what}, as a path from the repo's root`
+    }),
+    options: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .meta({ description: 'Handed to the module as it is, for its own settings' })
+})
+    .meta({ description: `A ${what} of the repo's own, built by a module` });
+const modelField = z.string().regex(/\S/, 'a model is empty').optional();
+const effortField = z.string().regex(/\S/, 'an effort is empty').optional();
+const oneLine = (what) => z.string().regex(/^[^\r\n]*\S[^\r\n]*$/, `${what} is one line`);
+// How many rounds a Step with an `until` runs when it names no maxRounds.
+export const DEFAULT_ROUNDS = 3;
+const Step = z
+    .strictObject({
+    name: oneLine('a Step name').meta({
+        description: 'The name of the Step; its commit and the pull request body name it'
+    }),
+    prompt: z
+        .string({ error: missingOr('give the Step a prompt') })
+        .regex(/\S/, 'give the Step a prompt')
+        .meta({
+        description: 'What the agent is told to do, such as "/some-skill critique"; it may name any skill. Nightjar adds the rule that nobody is at the keyboard.'
+    }),
+    point: z
+        .enum(['afterEachTicket', 'afterAllTickets'], {
+        error: missingOr('say when the Step runs: afterEachTicket or afterAllTickets')
+    })
+        .meta({
+        description: 'afterEachTicket runs after each Ticket is built; afterAllTickets runs once, after every Ticket, before the review'
+    }),
+    model: modelField.meta({ description: "The Step's own model; else the default model" }),
+    effort: effortField.meta({ description: "The Step's own effort; else the default effort" }),
+    budgetUsd: z.number().positive().optional().meta({
+        description: "The most one run of the Step may cost in dollars; else a Ticket's budget"
+    }),
+    until: z.string().regex(/\S/, 'until is empty').optional().meta({
+        description: 'A condition in plain words. After each round the agent reports whether it holds, and Nightjar runs the Step again until it does or maxRounds is reached'
+    }),
+    maxRounds: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .meta({
+        description: `The most rounds of a Step with an until; ${String(DEFAULT_ROUNDS)} when left out`
+    })
+})
+    .refine((step) => step.maxRounds === undefined || step.until !== undefined, {
+    path: ['maxRounds'],
+    error: 'maxRounds needs an until'
+});
+const Workflow = z
+    .strictObject({
+    steps: z
+        .array(Step, { error: missingOr('list the Steps') })
+        .min(1, 'a Workflow needs at least one Step')
+        .refine((steps) => new Set(steps.map((s) => s.name)).size === steps.length, {
+        error: 'a Step name is used twice'
+    }),
+    serve: z.string().regex(/\S/, 'serve is empty').optional().meta({
+        description: "A command started in the background in the worktree before the Workflow's Steps and stopped after them, such as a dev server. It reads its port from the variables of ports.env, so it needs ports."
+    }),
+    allowedCommands: z
+        .array(z.string().regex(/\S/, 'an allowed command is empty'))
+        .optional()
+        .meta({
+        description: "Commands the Workflow's Steps may run besides the top-level allowedCommands, as Bash permission patterns without Bash( )"
+    }),
+    allowedTools: z.array(z.string().regex(/\S/, 'an allowed tool is empty')).optional().meta({
+        description: "Tools the Workflow's Steps may use besides the usual ones, as Claude Code permission rules. Committing, pushing, switching branches, the outside network and gh stay denied."
+    }),
+    localNetwork: z.boolean().optional().meta({
+        description: "true lets the Workflow's Steps reach localhost, and nothing else on the network"
+    })
+})
+    .meta({ description: 'A named list of Steps that a Feature picks with a **Workflow:** line' });
+const signalName = (fallback, what) => z
+    .string()
+    .regex(/\S/, 'a Signal name is empty')
+    .refine((name) => !RESERVED_NAMES.includes(name.trim().toLowerCase()), {
+    error: 'this is a triage role; Nightjar never reads or sets it'
+})
+    .default(fallback)
+    .meta({ description: what });
+const Signals = z
+    .strictObject({
+    go: signalName(DEFAULT_SIGNAL_NAMES.go, 'The Go: put on a Feature assigned to you to have it built. Give it the name of ready to use one mark for both'),
+    ready: signalName(DEFAULT_SIGNAL_NAMES.ready, 'A Ticket that is ready to be built'),
+    working: signalName(DEFAULT_SIGNAL_NAMES.working, 'Nightjar is working on it'),
+    needsInfo: signalName(DEFAULT_SIGNAL_NAMES.needsInfo, 'Nightjar needs an answer to go on'),
+    human: signalName(DEFAULT_SIGNAL_NAMES.human, 'A person has to take it from here')
+})
+    .prefault({})
+    .meta({
+    description: 'The name each Signal has on a Tracker: a label on GitHub, a tag on Azure DevOps. Leave out the ones you do not rename. needs-triage and wontfix are refused.'
+});
+export const ConfigSchema = z
+    .strictObject({
+    $schema: z.string().optional(),
+    tracker: z
+        .discriminatedUnion('type', [GitHubTracker, AzureDevOpsTracker, adapterModule('Tracker')], {
+        error: missingOr('name the Tracker')
+    })
+        .meta({ description: 'Where the Features and Tickets live' }),
+    codeHost: z
+        .discriminatedUnion('type', [GitHubCodeHost, AzureReposCodeHost, adapterModule('Code host')], {
+        error: missingOr('name the Code host')
+    })
+        .meta({ description: 'Where the branch is pushed and the draft pull request opened' }),
+    check: z
+        .string({ error: missingOr('name the command that checks the work') })
+        .regex(/\S/, 'name the command that checks the work')
+        .meta({
+        description: 'The shell command that checks the work in the worktree, run after each Ticket; it fails with a non-zero exit'
+    }),
+    allowedCommands: z
+        .array(z.string().regex(/\S/, 'an allowed command is empty'), {
+        error: missingOr('list the commands the agent may run')
+    })
+        .meta({
+        description: 'The commands the agent may run, as Claude Code Bash permission patterns without Bash( ), such as "make test" or "make lint *". Committing, pushing, switching branches, the network and gh stay denied.'
+    }),
+    rules: z.string().regex(/\S/, 'a rules file path is empty').optional().meta({
+        description: 'A text file, relative to the repo root, whose text is added to the agent prompt. Conventions normally live in CLAUDE.md or AGENTS.md.'
+    }),
+    model: modelField.meta({
+        description: "The default model of every session; a Ticket's **Model:** line overrides it and --model overrides both"
+    }),
+    effort: effortField.meta({
+        description: "The default effort of every session; a Ticket's **Effort:** line overrides it and --effort overrides both"
+    }),
+    review: z
+        .strictObject({
+        enabled: z
+            .boolean()
+            .optional()
+            .meta({ description: 'false switches the review off; on by default' }),
+        model: modelField.meta({
+            description: "The review session's own model; else the default model"
+        }),
+        effort: effortField.meta({
+            description: "The review session's own effort; else the default effort"
+        })
+    })
+        .optional()
+        .meta({
+        description: 'The read-only review of the whole diff, run before the draft pull request opens'
+    }),
+    signals: Signals,
+    workflows: z.record(oneLine('a Workflow name'), Workflow).optional().meta({
+        description: 'Work a repo adds to the build loop, by name. A Feature picks one with a **Workflow:** line; Nightjar still keeps the branch, the commits, the Signals and the pull request.'
+    }),
+    defaultWorkflow: z.string().regex(/\S/, 'defaultWorkflow is empty').optional().meta({
+        description: 'The Workflow of a Feature without a **Workflow:** line; none when left out'
+    }),
+    trusted: z.array(z.string().regex(/\S/, 'a trusted login is empty')).optional().meta({
+        description: "The logins whose comments reach the agent (on Azure DevOps, sign-in names such as ann@contoso.com). When set, it replaces the Tracker default (GitHub: write access; Azure DevOps: the project's Contributors group); leave it out to keep the default."
+    }),
+    // worktree setup and reserved ports (N5)
+    setup: z.string().regex(/\S/, 'name the setup command, or leave setup out').optional().meta({
+        description: 'The shell command run once in each new worktree, before the first session, such as one that installs dependencies. When it fails, the Feature stops with a comment saying why. Left out, nothing is run.'
+    }),
+    ports: z
+        .strictObject({
+        count: z.number().int().min(1).max(100).meta({ description: 'How many ports to reserve' }),
+        env: z
+            .array(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/, 'not a valid variable name'), {
+            error: missingOr('name the environment variables that carry the ports')
+        })
+            .min(1, 'name at least one environment variable')
+            .refine((names) => new Set(names).size === names.length, 'a name is used twice')
+            .meta({
+            description: 'The environment variables that carry the ports to every session, the check and the setup command: the first name gets the first reserved port, the next name the next port, and so on'
+        })
+    })
+        .refine((p) => p.env.length <= p.count, {
+        path: ['env'],
+        error: 'more names than reserved ports'
+    })
+        .optional()
+        .meta({
+        description: 'Ports reserved for each run and held for its whole life, so that two runs on one machine never share a port. Left out, no port is held.'
+    })
+})
+    .refine((c) => c.defaultWorkflow === undefined || c.workflows?.[c.defaultWorkflow] !== undefined, {
+    path: ['defaultWorkflow'],
+    error: 'names no Workflow of workflows'
+})
+    .refine((c) => c.ports !== undefined || Object.values(c.workflows ?? {}).every((w) => w.serve === undefined), { path: ['workflows'], error: 'a Workflow with serve needs ports, to reserve its port' })
+    .meta({ title: 'Nightjar factory.json' });
+export function configJsonSchema() {
+    return z.toJSONSchema(ConfigSchema, { io: 'input' });
+}
+// The text of the rules file factory.json names, or null when it names none.
+export function loadRules(root, config) {
+    if (config.rules === undefined)
+        return null;
+    try {
+        return readFileSync(join(root, config.rules), 'utf8').trim();
+    }
+    catch {
+        throw new ConfigError(`${CONFIG_FILE}: rules: cannot read ${config.rules} in ${root}`);
+    }
+}
+export const where = (path) => path.length === 0 ? '' : `${path.map(String).join('.')}: `;
+// The repo's factory.json, or a ConfigError naming each field that is wrong.
+export function loadConfig(root) {
+    let text;
+    try {
+        text = readFileSync(join(root, CONFIG_FILE), 'utf8');
+    }
+    catch {
+        throw new ConfigError(`no ${CONFIG_FILE} in ${root}; run \`nightjar init\` to write one`);
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (fault) {
+        throw new ConfigError(`${CONFIG_FILE} is not JSON: ${why(fault)}`);
+    }
+    const parsed = ConfigSchema.safeParse(value);
+    if (!parsed.success) {
+        const lines = parsed.error.issues.map((i) => `${CONFIG_FILE}: ${where(i.path)}${i.message}`);
+        throw new ConfigError(lines.join('\n'));
+    }
+    const { $schema: _schema, ...config } = parsed.data;
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/contract/case.d.ts

@@ -0,0 +1,4 @@
+export interface ContractCase<Harness> {
+    readonly name: string;
+    readonly run: (harness: Harness) => Promise<void>;
+}

package/dist/contract/case.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=case.js.map

package/dist/contract/case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.js","sourceRoot":"","sources":["../../src/contract/case.ts"],"names":[],"mappings":""}

package/dist/contract/code-host.d.ts

@@ -0,0 +1,24 @@
+import type { CodeHost, Pull } from '../code-host.js';
+import type { ContractCase } from './case.js';
+export interface PullView {
+    readonly title: string;
+    readonly head: string;
+    readonly base: string;
+    readonly body: string;
+    readonly draft: boolean;
+    readonly references: readonly string[];
+    readonly comments: readonly string[];
+}
+export interface CodeHostSubject {
+    readonly codeHost: CodeHost;
+    readonly base: string;
+    readonly commit: () => Promise<{
+        readonly folder: string;
+        readonly commit: string;
+    }>;
+    readonly branch: (name: string) => Promise<string | null>;
+    readonly pull: (pull: Pull) => Promise<PullView>;
+    readonly close?: () => Promise<void>;
+}
+export type CodeHostHarness = () => Promise<CodeHostSubject>;
+export declare const codeHostContract: readonly ContractCase<CodeHostHarness>[];

package/dist/contract/code-host.js

@@ -0,0 +1,108 @@
+// The Code host contract (docs/adr/0001): what every Code host Adapter must do, fake, built in or a repo's own.
+import assert from 'node:assert/strict';
+function codeHostCase(name, check) {
+    return {
+        name,
+        run: async (harness) => {
+            const subject = await harness();
+            try {
+                await check(subject);
+            }
+            finally {
+                await subject.close?.();
+            }
+        }
+    };
+}
+export const codeHostContract = [
+    codeHostCase("pushes a worktree's HEAD to a branch, and moves it on with a later push", async ({ codeHost, commit, branch }) => {
+        const first = await commit();
+        await codeHost.push(first.folder, 'factory/1-a');
+        assert.equal(await branch('factory/1-a'), first.commit);
+        assert.equal(await branch('factory/2-b'), null);
+        const second = await commit();
+        await codeHost.push(second.folder, 'factory/1-a');
+        assert.equal(await branch('factory/1-a'), second.commit);
+    }),
+    codeHostCase('opens a draft pull request with the title, branch, base and body it is given', async ({ codeHost, commit, base, pull }) => {
+        await codeHost.push((await commit()).folder, 'factory/1-a');
+        const body = 'Nightjar built all of it.\n\n## Built\n\n- `$(x)` "quoted" & <b>more</b>';
+        const opened = await codeHost.createDraft({
+            title: 'One $(escape)',
+            head: 'factory/1-a',
+            base,
+            body
+        });
+        assert.ok(opened.url !== '', 'the pull request has a URL');
+        const shown = await pull(opened);
+        assert.deepEqual({ title: shown.title, head: shown.head, base: shown.base, draft: shown.draft }, { title: 'One $(escape)', head: 'factory/1-a', base, draft: true });
+        assert.ok(shown.body.includes(body), `the body holds what it was given:\n${shown.body}`);
+        assert.deepEqual(shown.references, []);
+        assert.deepEqual(shown.comments, []);
+    }),
+    codeHostCase('finds the open pull request of a branch, and none for a branch without one', async ({ codeHost, commit, base }) => {
+        const { folder } = await commit();
+        assert.equal(await codeHost.openPull('factory/1-a'), null);
+        await codeHost.push(folder, 'factory/1-a');
+        await codeHost.push(folder, 'factory/2-b');
+        await codeHost.push(folder, 'factory/3-c');
+        const one = await codeHost.createDraft({ title: 'A', head: 'factory/1-a', base, body: 'a' });
+        const two = await codeHost.createDraft({ title: 'B', head: 'factory/2-b', base, body: 'b' });
+        assert.notEqual(one.id, two.id);
+        assert.deepEqual(await codeHost.openPull('factory/1-a'), one);
+        assert.deepEqual(await codeHost.openPull('factory/2-b'), two);
+        assert.equal(await codeHost.openPull('factory/3-c'), null);
+    }),
+    codeHostCase('replaces the body of a pull request', async ({ codeHost, commit, base, pull }) => {
+        await codeHost.push((await commit()).folder, 'factory/1-a');
+        const opened = await codeHost.createDraft({
+            title: 'A',
+            head: 'factory/1-a',
+            base,
+            body: 'First body'
+        });
+        await codeHost.editBody(opened, 'Second body, with `$(x)` & "quotes"');
+        const { body } = await pull(opened);
+        assert.ok(body.includes('Second body, with `$(x)` & "quotes"'), `the new body:\n${body}`);
+        assert.ok(!body.includes('First body'), `the old body is gone:\n${body}`);
+    }),
+    codeHostCase('places each Ticket reference once, and keeps them all when the body is replaced', async ({ codeHost, commit, base, pull }) => {
+        await codeHost.push((await commit()).folder, 'factory/1-a');
+        const opened = await codeHost.createDraft({
+            title: 'A',
+            head: 'factory/1-a',
+            base,
+            body: 'First body'
+        });
+        const sorted = async () => [...(await pull(opened)).references].sort();
+        await codeHost.placeReferences(opened, [
+            { id: '2', text: '#2' },
+            { id: '3', text: '#3' }
+        ]);
+        assert.deepEqual(await sorted(), ['#2', '#3']);
+        await codeHost.placeReferences(opened, [
+            { id: '1', text: '#1' },
+            { id: '3', text: '#3' }
+        ]);
+        assert.deepEqual(await sorted(), ['#1', '#2', '#3']);
+        await codeHost.editBody(opened, 'Second body');
+        assert.deepEqual(await sorted(), ['#1', '#2', '#3']);
+        await codeHost.placeReferences(opened, []);
+        assert.deepEqual(await sorted(), ['#1', '#2', '#3']);
+        assert.ok((await pull(opened)).body.includes('Second body'));
+    }),
+    codeHostCase('comments on a pull request, oldest first, with the body unchanged', async ({ codeHost, commit, base, pull }) => {
+        await codeHost.push((await commit()).folder, 'factory/1-a');
+        const opened = await codeHost.createDraft({
+            title: 'A',
+            head: 'factory/1-a',
+            base,
+            body: 'a'
+        });
+        const review = '**Nightjar review: changes**\n\n- `src/a.ts:3`: $(x) & "y"';
+        await codeHost.comment(opened, review);
+        await codeHost.comment(opened, 'Second');
+        assert.deepEqual((await pull(opened)).comments, [review, 'Second']);
+    })
+];
+//# sourceMappingURL=code-host.js.map

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

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

package/dist/contract/command.d.ts

@@ -0,0 +1,2 @@
+export declare const CONTRACT_USAGE = "usage: nightjar contract MODULE\n\n  MODULE  a module, as a path from here, that exports trackerHarness and/or codeHostHarness;\n          runs the Tracker and Code host contract suites over them and names each behaviour that fails";
+export declare function runContractCommand(argv: readonly string[]): Promise<number>;

package/dist/contract/command.js

@@ -0,0 +1,36 @@
+// `nightjar contract MODULE`: checks a module's Adapters against the contract suites.
+import { importModule } from '../adapter-module.js';
+import { ContractRefusal, formatReport, runContract } from './run.js';
+import { why } from '../say.js';
+export const CONTRACT_USAGE = `usage: nightjar contract MODULE
+
+  MODULE  a module, as a path from here, that exports trackerHarness and/or codeHostHarness;
+          runs the Tracker and Code host contract suites over them and names each behaviour that fails`;
+// 0 when every behaviour holds, 1 when one fails, 2 when the module could not be checked.
+export async function runContractCommand(argv) {
+    const [path, ...rest] = argv;
+    if (path === undefined || rest.length > 0) {
+        console.error(`nightjar: ${path === undefined ? 'say which module' : 'one module at a time'}\n\n${CONTRACT_USAGE}`);
+        return 2;
+    }
+    let exports;
+    try {
+        exports = await importModule(path, process.cwd());
+    }
+    catch (fault) {
+        console.error(`nightjar: contract: cannot load ${path}: ${why(fault)}`);
+        return 2;
+    }
+    try {
+        const report = await runContract(exports);
+        console.log(formatReport(report));
+        return report.failed === 0 ? 0 : 1;
+    }
+    catch (fault) {
+        if (!(fault instanceof ContractRefusal))
+            throw fault;
+        console.error(`nightjar: contract: ${path} ${fault.message}`);
+        return 2;
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/contract/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/contract/command.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG;;;uGAGyE,CAAC;AAExG,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAuB;IAC/D,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CACZ,aAAa,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,sBAAsB,OAAO,cAAc,EAAE,CACpG,CAAC;QACF,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,mCAAmC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC;YAAE,MAAM,KAAK,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,uBAAuB,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACV,CAAC;AACF,CAAC"}

package/dist/contract/feature-writer.d.ts

@@ -0,0 +1,3 @@
+import type { ContractCase } from './case.js';
+import type { TrackerHarness } from './tracker.js';
+export declare const featureWriterContract: readonly ContractCase<TrackerHarness>[];

package/dist/contract/feature-writer.js

@@ -0,0 +1,101 @@
+// The creation contract (docs/ticket-contract.md): what it makes is read back through the Tracker's own methods.
+import assert from 'node:assert/strict';
+import { canCreate } from '../tracker.js';
+const ANN = 'ann';
+function writerCase(name, items, check) {
+    return {
+        name,
+        run: async (harness) => {
+            const subject = await harness({ person: ANN, trusted: [ANN], items });
+            try {
+                const { tracker } = subject;
+                assert.ok(canCreate(tracker), 'the Tracker has createFeature, createTicket and block');
+                await check({ ...subject, tracker });
+            }
+            finally {
+                await subject.close?.();
+            }
+        }
+    };
+}
+// A Ticket in the contract's shape, with what a person might type in it.
+const TICKET_BODY = [
+    '**Model:** opus',
+    '**Effort:** high',
+    '',
+    'Share the escape with `escapeHtml(text)` & keep <b>bold</b> as text.',
+    '',
+    '## Acceptance criteria',
+    '',
+    '- [ ] one escape for both',
+    '- [ ] a "quoted" value stays quoted'
+].join('\n');
+export const featureWriterContract = [
+    writerCase('makes a Feature with its title and body, and each Ticket its last child, in the order made', [
+        { key: 'other', title: 'Another Feature', children: ['old'] },
+        { key: 'old', title: 'An older Ticket' }
+    ], async ({ tracker, id }) => {
+        const feature = await tracker.createFeature({
+            title: 'Share the escape',
+            body: 'The spec.\n\n## Solution\n\nOne escape.'
+        });
+        const made = [];
+        for (const title of ['First', 'Second', 'Third']) {
+            made.push(await tracker.createTicket(feature, { title, body: `Build ${title}.` }));
+        }
+        assert.equal(new Set([feature, ...made, id('other'), id('old')]).size, 6, 'each id is new');
+        assert.deepEqual(await tracker.feature(feature), {
+            id: feature,
+            title: 'Share the escape',
+            body: 'The spec.\n\n## Solution\n\nOne escape.'
+        });
+        assert.deepEqual(await tracker.tickets(feature), ['First', 'Second', 'Third'].map((title, i) => ({
+            id: made[i],
+            title,
+            body: `Build ${title}.`,
+            open: true,
+            signals: [],
+            blockedBy: []
+        })));
+        assert.deepEqual((await tracker.tickets(id('other'))).map((t) => t.id), [id('old')]);
+    }),
+    writerCase("keeps a Ticket's body as written, so its Model and Effort lines and acceptance criteria read back", [], async ({ tracker }) => {
+        const feature = await tracker.createFeature({ title: 'Feature', body: 'The spec.' });
+        await tracker.createTicket(feature, { title: 'Ticket', body: TICKET_BODY });
+        assert.deepEqual((await tracker.tickets(feature)).map((t) => t.body), [TICKET_BODY]);
+    }),
+    writerCase('links a Ticket as blocked by another it made, or by an item already there', [
+        { key: 'other', title: 'Another Feature', children: ['done'] },
+        { key: 'done', title: 'A closed Ticket', open: false }
+    ], async ({ tracker, id }) => {
+        const feature = await tracker.createFeature({ title: 'Feature', body: '' });
+        const a = await tracker.createTicket(feature, { title: 'a', body: 'Build a.' });
+        const b = await tracker.createTicket(feature, { title: 'b', body: 'Build b.' });
+        const c = await tracker.createTicket(feature, { title: 'c', body: 'Build c.' });
+        await tracker.block(b, a);
+        await tracker.block(c, a);
+        await tracker.block(c, id('done'));
+        const byId = (x, y) => x.id.localeCompare(y.id);
+        assert.deepEqual((await tracker.tickets(feature)).map((t) => ({
+            id: t.id,
+            blockedBy: [...t.blockedBy].sort(byId)
+        })), [
+            { id: a, blockedBy: [] },
+            { id: b, blockedBy: [{ id: a, open: true }] },
+            {
+                id: c,
+                blockedBy: [
+                    { id: a, open: true },
+                    { id: id('done'), open: false }
+                ].sort(byId)
+            }
+        ]);
+    }),
+    writerCase('takes a Signal on a Ticket it made', [], async ({ tracker }) => {
+        const feature = await tracker.createFeature({ title: 'Feature', body: 'The spec.' });
+        const ticket = await tracker.createTicket(feature, { title: 'Ticket', body: 'Build it.' });
+        await tracker.addSignal(ticket, 'ready');
+        assert.deepEqual((await tracker.tickets(feature)).map((t) => t.signals), [['ready']]);
+    })
+];
+//# sourceMappingURL=feature-writer.js.map

package/dist/contract/feature-writer.js.map

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