@nonameolsson/nightjar 0.0.0-stage → 0.1.0

package/dist/checks.d.ts

@@ -0,0 +1,38 @@
+import { type Adapters } from './adapters.js';
+import type { AzureDevOpsRequest } from './azure-devops/index.js';
+import { type Config } from './config.js';
+import { type PersonConfig } from './person-config.js';
+import { type Env } from './git.js';
+export declare class Refusal extends Error {
+}
+export interface Ready {
+    readonly root: string;
+    readonly config: Config;
+    readonly adapters: Adapters;
+    readonly me: string;
+    readonly baseBranch: string;
+    readonly rules: string | null;
+    readonly person: PersonConfig;
+    readonly assignee: string;
+}
+export interface Line {
+    readonly name: string;
+    readonly status: 'ok' | 'fail' | 'skip';
+    readonly detail: string;
+    readonly summary: string | null;
+}
+export interface Checked {
+    readonly lines: readonly Line[];
+    readonly ready: Ready | null;
+    readonly adapters: Adapters | null;
+    readonly config: Config | null;
+    readonly trackerOk: boolean;
+}
+export interface CheckOptions {
+    readonly useApiKey: boolean;
+    readonly env: Env;
+    readonly cwd: string;
+    readonly request?: AzureDevOpsRequest;
+    readonly failFast: boolean;
+}
+export declare function checkMachine(o: CheckOptions): Promise<Checked>;

package/dist/checks.js

@@ -0,0 +1,179 @@
+// `doctor` and `init` run every check and list each; a build stops at the first that fails. Each failure says how to fix it.
+import { makeAdapters } from './adapters.js';
+import { apiKeyProblem } from './args.js';
+import { loadConfig, loadRules } from './config.js';
+import { loadPersonConfig } from './person-config.js';
+import { firstLine, run } from './git.js';
+import { defaultBranch, signing } from './worktree.js';
+import { why } from './say.js';
+// A reason Nightjar will not start on this machine, said as it is.
+export class Refusal extends Error {
+}
+const GH_INSTALL = 'https://cli.github.com/';
+const CLAUDE_INSTALL = 'https://claude.com/claude-code';
+const ghFix = (message) => message.includes('is not on the PATH')
+    ? `${message} Install it from ${GH_INSTALL}, then run \`gh auth login\`.`
+    : `${message} If gh is not signed in, run \`gh auth login\`.`;
+async function need(command, args, cwd, env, what) {
+    const got = await run(command, args, cwd, env);
+    if (got.missing)
+        throw new Refusal(`${command} is not on the PATH.`);
+    if (!got.ok)
+        throw new Refusal(`${what}: ${firstLine(got.err) || firstLine(got.out)}`);
+    return got.out.trim();
+}
+async function claudeVersion(root, env, useApiKey) {
+    const got = await run('claude', ['--version'], root, env);
+    if (got.missing) {
+        throw new Refusal(`claude is not on the PATH. Install Claude Code from ${CLAUDE_INSTALL}, then sign in with \`claude auth login\`.`);
+    }
+    if (!got.ok)
+        throw new Refusal(`claude does not start: ${firstLine(got.err) || firstLine(got.out)}`);
+    const version = got.out.trim();
+    // a session on the API key needs no login of its own
+    if (useApiKey)
+        return { version, detail: `${version}, billing ANTHROPIC_API_KEY` };
+    const status = await run('claude', ['auth', 'status'], root, env);
+    if (!status.ok) {
+        throw new Refusal('claude is not signed in: run `claude auth login`. (It is also unsigned if this claude is too old for `claude auth status`.)');
+    }
+    return { version, detail: `${version}, signed in` };
+}
+export async function checkMachine(o) {
+    const lines = [];
+    const stopped = () => o.failFast && lines.some((l) => l.status === 'fail');
+    async function step(name, fn, said) {
+        if (stopped())
+            return null;
+        try {
+            const value = await fn();
+            const { detail, summary } = said(value);
+            lines.push({ name, status: 'ok', detail, summary: summary === undefined ? detail : summary });
+            return value;
+        }
+        catch (fault) {
+            // a config fault names its file in every line already
+            const detail = why(fault).replace(/^factory\.json: /gm, '');
+            lines.push({ name, status: 'fail', detail, summary: null });
+            return null;
+        }
+    }
+    const skip = (name, because) => {
+        if (!stopped())
+            lines.push({ name, status: 'skip', detail: because, summary: null });
+    };
+    const keyProblem = apiKeyProblem(o.env, o.useApiKey);
+    const key = await step('API key', () => {
+        if (keyProblem)
+            throw new Refusal(keyProblem);
+        return o.useApiKey;
+    }, (chosen) => ({
+        detail: chosen ? 'ANTHROPIC_API_KEY chosen' : 'none set, so sessions bill your Claude plan',
+        summary: chosen ? 'ANTHROPIC_API_KEY chosen' : 'no ANTHROPIC_API_KEY'
+    }));
+    const node = process.versions.node;
+    await step('Node', () => {
+        if (Number(node.split('.')[0]) < 24) {
+            throw new Refusal(`Node 24 or later is needed, and this is ${node}.`);
+        }
+        return node;
+    }, (version) => ({ detail: version, summary: `Node ${version}` }));
+    const root = await step('git checkout', () => need('git', ['rev-parse', '--show-toplevel'], o.cwd, o.env, 'not inside a git checkout'), (path) => ({ detail: path, summary: null }));
+    const loaded = root === null
+        ? null
+        : await step('factory.json', () => {
+            const config = loadConfig(root);
+            return { config, rules: loadRules(root, config) };
+        }, () => ({ detail: 'read', summary: 'factory.json' }));
+    if (root === null)
+        skip('factory.json', 'needs a git checkout');
+    const person = await step('config.json', () => loadPersonConfig(o.env), (p) => ({
+        detail: `$${String(p.dailyUsd)} a day, building for ${p.assignee ?? 'the signed-in person'}`,
+        summary: null
+    }));
+    let adapters = null;
+    let faulty = false;
+    if (loaded !== null && root !== null) {
+        try {
+            adapters = await makeAdapters(loaded.config, root, o.env, o.request);
+        }
+        catch (fault) {
+            faulty = true;
+            const detail = why(fault).replace(/^factory\.json: /gm, '');
+            if (!stopped()) {
+                lines.push({ name: 'Tracker', status: 'fail', detail, summary: null });
+            }
+        }
+    }
+    let me = null;
+    if (adapters !== null && loaded !== null) {
+        const { tracker, codeHost } = loaded.config;
+        const github = (type, fix) => (type === 'github' ? fix : why);
+        const trackerFix = github(tracker.type, ghFix);
+        const hostFix = github(codeHost.type, ghFix);
+        const found = adapters;
+        me = await step('Tracker', async () => {
+            try {
+                return await found.tracker.me();
+            }
+            catch (fault) {
+                throw new Refusal(trackerFix(why(fault)));
+            }
+        }, (person) => ({ detail: found.checked(person) }));
+        await step('Code host', async () => {
+            try {
+                await found.reachCodeHost();
+            }
+            catch (fault) {
+                throw new Refusal(hostFix(why(fault)));
+            }
+        }, () => ({ detail: found.repo, summary: null }));
+    }
+    else if (!faulty) {
+        skip('Tracker', 'needs a usable factory.json');
+        skip('Code host', 'needs a usable factory.json');
+    }
+    else {
+        skip('Code host', 'needs a usable factory.json');
+    }
+    const claude = root === null
+        ? null
+        : await step('claude', () => claudeVersion(root, o.env, o.useApiKey), ({ version, detail }) => ({ detail, summary: `claude ${version}` }));
+    const signs = root === null
+        ? null
+        : await step('git signing', async () => {
+            const got = await signing(root, o.env);
+            if (got === 'fails') {
+                throw new Refusal('git cannot sign a commit; unlock your signing key and run again.');
+            }
+            return got;
+        }, (got) => {
+            const detail = got === 'signs' ? 'git signs commits' : 'commits unsigned';
+            return { detail, summary: detail };
+        });
+    const trackerOk = me !== null;
+    let ready = null;
+    if (key !== null &&
+        root !== null &&
+        loaded !== null &&
+        adapters !== null &&
+        me !== null &&
+        claude !== null &&
+        signs !== null &&
+        person !== null &&
+        lines.every((l) => l.status === 'ok')) {
+        const baseBranch = (await defaultBranch(root, o.env)) ?? 'main';
+        ready = {
+            root,
+            config: loaded.config,
+            adapters,
+            me,
+            baseBranch,
+            rules: loaded.rules,
+            person,
+            assignee: person.assignee ?? me
+        };
+    }
+    return { lines, ready, adapters, config: loaded?.config ?? null, trackerOk };
+}
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runNightjar } from './main.js';
+import { why } from './say.js';
+try {
+    process.exit(await runNightjar(process.argv.slice(2)));
+}
+catch (fault) {
+    console.error(`nightjar: ${why(fault)}`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,IAAI,CAAC;IACJ,OAAO,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IAChB,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/code-host.d.ts

@@ -0,0 +1,19 @@
+import type { TicketReference } from './tracker.js';
+export interface Pull {
+    readonly id: number;
+    readonly url: string;
+}
+export interface DraftRequest {
+    readonly title: string;
+    readonly head: string;
+    readonly base: string;
+    readonly body: string;
+}
+export interface CodeHost {
+    push(folder: string, branch: string): Promise<void>;
+    openPull(branch: string): Promise<Pull | null>;
+    createDraft(request: DraftRequest): Promise<Pull>;
+    editBody(pull: Pull, body: string): Promise<void>;
+    placeReferences(pull: Pull, references: readonly TicketReference[]): Promise<void>;
+    comment(pull: Pull, body: string): Promise<void>;
+}

package/dist/code-host.js

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

package/dist/code-host.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { type SignalNames } from './signals.js';
+export declare class ConfigError extends Error {
+}
+export declare const CONFIG_FILE = "factory.json";
+export declare const ConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    tracker: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"github">;
+        repo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"azure-devops">;
+        organization: z.ZodString;
+        project: z.ZodString;
+        featureType: z.ZodString;
+        ticketType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"module">;
+        path: z.ZodString;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>], "type">;
+    codeHost: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"github">;
+        repo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"azure-devops">;
+        organization: z.ZodString;
+        project: z.ZodString;
+        repo: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"module">;
+        path: z.ZodString;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>], "type">;
+    check: z.ZodString;
+    allowedCommands: z.ZodArray<z.ZodString>;
+    rules: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
+    review: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    signals: z.ZodPrefault<z.ZodObject<{
+        go: z.ZodDefault<z.ZodString>;
+        ready: z.ZodDefault<z.ZodString>;
+        working: z.ZodDefault<z.ZodString>;
+        needsInfo: z.ZodDefault<z.ZodString>;
+        human: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+    trusted: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    setup: z.ZodOptional<z.ZodString>;
+    ports: z.ZodOptional<z.ZodObject<{
+        count: z.ZodNumber;
+        env: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Config = Omit<z.infer<typeof ConfigSchema>, '$schema'> & {
+    readonly signals: SignalNames;
+};
+export declare function configJsonSchema(): object;
+export declare function loadRules(root: string, config: Config): string | null;
+export declare const where: (path: readonly PropertyKey[]) => string;
+export declare function loadConfig(root: string): Config;

package/dist/config.js

@@ -0,0 +1,215 @@
+// 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 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,
+    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.'
+    })
+})
+    .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>[];