@nonameolsson/nightjar 0.0.0-stage → 0.1.0

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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"}

package/dist/contract/run.d.ts

@@ -0,0 +1,18 @@
+export declare class ContractRefusal extends Error {
+}
+export interface CaseResult {
+    readonly name: string;
+    readonly ok: boolean;
+    readonly error?: string;
+}
+export interface SuiteResult {
+    readonly title: string;
+    readonly results: readonly CaseResult[];
+}
+export interface Report {
+    readonly suites: readonly SuiteResult[];
+    readonly total: number;
+    readonly failed: number;
+}
+export declare function runContract(exports: Record<string, unknown>): Promise<Report>;
+export declare function formatReport(report: Report): string;

package/dist/contract/run.js

@@ -0,0 +1,89 @@
+import { codeHostContract } from './code-host.js';
+import { canCreate } from '../tracker.js';
+import { featureWriterContract } from './feature-writer.js';
+import { trackerContract } from './tracker.js';
+import { why } from '../say.js';
+// A module exports the harnesses of the Adapters it wants checked.
+export class ContractRefusal extends Error {
+}
+async function runSuite(title, cases, harness) {
+    const results = [];
+    for (const c of cases) {
+        try {
+            await c.run(harness);
+            results.push({ name: c.name, ok: true });
+        }
+        catch (fault) {
+            results.push({
+                name: c.name,
+                ok: false,
+                error: why(fault)
+            });
+        }
+    }
+    return { title, results };
+}
+function harnessOf(exports, name) {
+    const found = exports[name];
+    if (found !== undefined && typeof found !== 'function') {
+        throw new ContractRefusal(`exports ${name}, which is not a function`);
+    }
+    return found;
+}
+// A harness that cannot build a Tracker over an empty world has failed every case already, so it is asked nothing more.
+async function makesFeatures(harness) {
+    let subject;
+    try {
+        subject = await harness({ person: 'ann', trusted: ['ann'], items: [] });
+    }
+    catch {
+        return false;
+    }
+    try {
+        return canCreate(subject.tracker);
+    }
+    finally {
+        await subject.close?.();
+    }
+}
+// The creation suite runs too when the Tracker makes Features.
+export async function runContract(exports) {
+    const tracker = harnessOf(exports, 'trackerHarness');
+    const codeHost = harnessOf(exports, 'codeHostHarness');
+    if (tracker === undefined && codeHost === undefined) {
+        throw new ContractRefusal('exports neither trackerHarness nor codeHostHarness');
+    }
+    const suites = [];
+    if (tracker !== undefined) {
+        suites.push(await runSuite('Tracker', trackerContract, tracker));
+        if (await makesFeatures(tracker)) {
+            suites.push(await runSuite('Tracker creation', featureWriterContract, tracker));
+        }
+    }
+    if (codeHost !== undefined) {
+        suites.push(await runSuite('Code host', codeHostContract, codeHost));
+    }
+    const all = suites.flatMap((s) => s.results);
+    return { suites, total: all.length, failed: all.filter((r) => !r.ok).length };
+}
+const indent = (text, by) => text
+    .split('\n')
+    .map((line) => `${by}${line}`.trimEnd())
+    .join('\n');
+export function formatReport(report) {
+    const lines = [];
+    for (const suite of report.suites) {
+        lines.push(`${suite.title} contract`);
+        for (const r of suite.results) {
+            lines.push(`  ${r.ok ? 'ok  ' : 'FAIL'}  ${r.name}`);
+            if (r.error !== undefined)
+                lines.push(indent(r.error.trim(), '        '));
+        }
+        lines.push('');
+    }
+    lines.push(report.failed === 0
+        ? `All ${String(report.total)} behaviours pass.`
+        : `${String(report.failed)} of ${String(report.total)} behaviours fail.`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=run.js.map

package/dist/contract/run.js.map

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

package/dist/contract/tracker.d.ts

@@ -0,0 +1,30 @@
+import { type Signal } from '../signals.js';
+import type { ItemId, Tracker } from '../tracker.js';
+import type { ContractCase } from './case.js';
+export interface WorldComment {
+    readonly author: string;
+    readonly body: string;
+}
+export interface WorldItem {
+    readonly key: string;
+    readonly title: string;
+    readonly body?: string;
+    readonly open?: boolean;
+    readonly assignees?: readonly string[];
+    readonly signals?: readonly Signal[];
+    readonly children?: readonly string[];
+    readonly blockedBy?: readonly string[];
+    readonly comments?: readonly WorldComment[];
+}
+export interface TrackerWorld {
+    readonly person: string;
+    readonly trusted: readonly string[];
+    readonly items: readonly WorldItem[];
+}
+export interface TrackerSubject {
+    readonly tracker: Tracker;
+    readonly id: (key: string) => ItemId;
+    readonly close?: () => Promise<void>;
+}
+export type TrackerHarness = (world: TrackerWorld) => Promise<TrackerSubject>;
+export declare const trackerContract: readonly ContractCase<TrackerHarness>[];