@nonameolsson/nightjar 0.0.0-stage → 0.2.0

package/dist/adapters.js

@@ -0,0 +1,160 @@
+// Builds the Tracker and Code host factory.json names, paired so each Ticket reference is one the Code host can place.
+import { codeHostFromModule, trackerFromModule } from './adapter-module.js';
+import { AzureBoardsTracker, AzureReposCodeHost, azRunner, azureDevOpsSignIn, fetchRequest, openAzureDevOps } from './azure-devops/index.js';
+import { CONFIG_FILE, ConfigError } from './config.js';
+import { run } from './git.js';
+import { GitHubApi, ghRunner, repoFromRemote } from './github/api.js';
+import { GitHubCodeHost } from './github/code-host.js';
+import { createSignalLabels } from './github/labels.js';
+import { GitHubTracker } from './github/tracker.js';
+import { canCreate, FEATURE_WRITER_METHODS } from './tracker.js';
+const WRITER_LIST = `${FEATURE_WRITER_METHODS.slice(0, -1).join(', ')} and ${FEATURE_WRITER_METHODS.at(-1) ?? ''}`;
+// The Tracker with its references rewritten for the Code host; every other call goes to it as it is.
+function referencing(tracker, fit) {
+    return {
+        me: () => tracker.me(),
+        assignedFeatures: (person) => tracker.assignedFeatures(person),
+        feature: (id) => tracker.feature(id),
+        standing: (id) => tracker.standing(id),
+        tickets: (featureId) => tracker.tickets(featureId),
+        comments: (id) => tracker.comments(id),
+        addSignal: (id, signal) => tracker.addSignal(id, signal),
+        removeSignal: (id, signal) => tracker.removeSignal(id, signal),
+        comment: (id, body) => tracker.comment(id, body),
+        reference: (id) => fit(tracker.reference(id))
+    };
+}
+const sameName = (a, b) => a.toLowerCase() === b.toLowerCase();
+const TRACKERS = {
+    module: async (spec, m) => {
+        const tracker = await trackerFromModule(spec, m.context);
+        return {
+            tracker,
+            checked: (person) => `${spec.path} as ${person}`,
+            prepareSignals: () => Promise.resolve([
+                `${spec.path} shows Signals its own way: Nightjar creates nothing for it.`
+            ]),
+            cannotCreate: canCreate(tracker)
+                ? null
+                : `${CONFIG_FILE}: tracker: ${spec.path} makes no Features; its Tracker needs ${WRITER_LIST}`
+        };
+    },
+    'azure-devops': (spec, m) => {
+        const { organization, project } = spec;
+        const api = m.azureDevOps(organization);
+        const items = `https://dev.azure.com/${encodeURIComponent(organization)}/${encodeURIComponent(project)}/_workitems/edit/`;
+        return Promise.resolve({
+            tracker: new AzureBoardsTracker(api, spec, m.config.signals, m.config.trusted),
+            checked: (person) => `Azure DevOps as ${person} on ${organization}/${project}`,
+            prepareSignals: () => Promise.resolve([
+                'Azure DevOps shows Signals as tags, which appear on first use: there is nothing to create.'
+            ]),
+            cannotCreate: spec.ticketType === undefined
+                ? `${CONFIG_FILE}: tracker.ticketType: name the work item type each Ticket is made as, such as User Story`
+                : null,
+            organization,
+            page: (id) => `[work item ${id}](${items}${id})`
+        });
+    },
+    github: async (spec, m) => {
+        const named = spec.repo ?? (await m.fromOrigin('tracker.repo'));
+        return {
+            tracker: new GitHubTracker(named, m.gh, m.config.signals, m.config.trusted),
+            checked: (person) => `gh as ${person} on ${named}`,
+            prepareSignals: () => createSignalLabels(m.gh, named, m.config.signals),
+            cannotCreate: null,
+            page: (id) => `[issue ${id}](https://github.com/${named}/issues/${id})`
+        };
+    }
+};
+const CODE_HOSTS = {
+    module: async (spec, m) => ({
+        codeHost: await codeHostFromModule(spec, m.context),
+        repo: spec.path,
+        reachCodeHost: () => Promise.resolve(),
+        checkedTail: '',
+        fit: null
+    }),
+    github: async (spec, m) => {
+        const repo = spec.repo ?? (await m.fromOrigin('codeHost.repo'));
+        return {
+            codeHost: new GitHubCodeHost(repo, m.gh, (args, cwd) => run('git', args, cwd, m.env)),
+            repo,
+            // the branch is pushed and the pull request opened as the person gh is signed in as
+            reachCodeHost: async () => {
+                await new GitHubApi(repo, m.gh).call('read the signed-in user', ['user']);
+            },
+            checkedTail: '',
+            fit: null
+        };
+    },
+    'azure-devops': (spec, m, t) => {
+        const { organization, project, repo } = spec;
+        const linked = t.organization !== undefined && sameName(t.organization, organization);
+        const referencesAs = linked ? 'work items' : 'text';
+        const codeHost = new AzureReposCodeHost(m.azureDevOps(organization), { project, repo, referencesAs }, (args, cwd, extra) => run('git', args, cwd, { ...m.env, ...extra }));
+        // Azure Repos reads #N as a work item of its own organization, so any other Ticket is named by its page
+        const page = t.page;
+        const fit = linked
+            ? (r) => ({ ...r, text: `#${r.id}` })
+            : page === undefined
+                ? null
+                : (r) => ({ ...r, text: page(r.id) });
+        return Promise.resolve({
+            codeHost,
+            repo: `${organization}/${project}/${repo}`,
+            reachCodeHost: () => codeHost.check(),
+            checkedTail: `, Azure Repos ${organization}/${project}/${repo}`,
+            fit
+        });
+    }
+};
+// Calls the bundle maker of `spec`'s own kind; TypeScript cannot pair a union's member with its key.
+const trackerFor = (spec, m) => TRACKERS[spec.type](spec, m);
+const codeHostFor = (spec, m, t) => CODE_HOSTS[spec.type](spec, m, t);
+// `request` answers every Azure DevOps call; a spec passes a fake Azure DevOps.
+export async function makeAdapters(config, root, env, request = fetchRequest) {
+    let origin;
+    // one sign-in for every Azure DevOps Adapter, made when the first needs it
+    let signIn;
+    const machine = {
+        config,
+        env,
+        gh: ghRunner(root, env),
+        context: {
+            root,
+            signals: config.signals,
+            ...(config.trusted === undefined ? {} : { trusted: config.trusted })
+        },
+        fromOrigin: async (field) => {
+            if (origin === undefined) {
+                const got = await run('git', ['remote', 'get-url', 'origin'], root, env);
+                origin = got.ok ? repoFromRemote(got.out) : null;
+            }
+            if (origin === null) {
+                throw new ConfigError(`origin is not a GitHub repo; set ${field} to owner/name in factory.json`);
+            }
+            return origin;
+        },
+        azureDevOps: (organization) => {
+            signIn ??= azureDevOpsSignIn(azRunner(root, env), env);
+            return openAzureDevOps(organization, root, env, signIn, request);
+        }
+    };
+    const t = await trackerFor(config.tracker, machine);
+    // taken before any wrapping for the Code host, which keeps only the Tracker's own methods
+    const writer = t.cannotCreate === null && canCreate(t.tracker)
+        ? t.tracker
+        : (t.cannotCreate ?? `${CONFIG_FILE}: tracker: this Tracker makes no Features`);
+    const host = await codeHostFor(config.codeHost, machine, t);
+    return {
+        tracker: host.fit === null ? t.tracker : referencing(t.tracker, host.fit),
+        codeHost: host.codeHost,
+        repo: host.repo,
+        checked: (person) => `${t.checked(person)}${host.checkedTail}`,
+        reachCodeHost: host.reachCodeHost,
+        prepareSignals: t.prepareSignals,
+        writer
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/args.d.ts

@@ -0,0 +1,13 @@
+import type { Env } from './git.js';
+export declare const USAGE = "usage: nightjar <--watch | --once | FEATURE | doctor> [--use-api-key] [--profile NAME] [--model M] [--effort LEVEL]\n\n  --watch        build the Features assigned to you with the Go, oldest first, and look again every 2 minutes\n  --once         build the oldest Feature assigned to you with the Go, then exit\n  FEATURE        build that Feature, by its id (42, #42, PROJ-123), now\n  doctor         check this machine and list the Features it would build, building nothing (--dry-run is the old name)\n  --use-api-key  let the sessions bill ANTHROPIC_API_KEY instead of your Claude plan\n  --profile NAME run the sessions as the Claude login in ~/.claude-NAME (a path is the folder itself, default is ~/.claude); over config.json's profile\n  --model M      the model of every session, over a Ticket's own line and factory.json\n  --effort LEVEL the effort of every session, over a Ticket's own line and factory.json\n\n       nightjar init              ask for the Tracker and Code host, write factory.json, create the Signal labels, check the logins\n       nightjar create [--dry-run] FILE   make a Feature and its Tickets on the Tracker from a Feature file\n       nightjar contract MODULE   check a module's own Tracker or Code host against the contract suites";
+export interface Args {
+    readonly mode: 'watch' | 'once' | 'feature' | 'doctor';
+    readonly feature?: string;
+    readonly useApiKey: boolean;
+    readonly profile?: string;
+    readonly model?: string;
+    readonly effort?: string;
+}
+export declare function parseArgs(argv: readonly string[]): Args | string;
+export declare function apiKeyProblem(env: Env, useApiKey: boolean): string | null;
+export declare function platformProblem(platform: NodeJS.Platform): string | null;

package/dist/args.js

@@ -0,0 +1,84 @@
+export const USAGE = `usage: nightjar <--watch | --once | FEATURE | doctor> [--use-api-key] [--profile NAME] [--model M] [--effort LEVEL]
+
+  --watch        build the Features assigned to you with the Go, oldest first, and look again every 2 minutes
+  --once         build the oldest Feature assigned to you with the Go, then exit
+  FEATURE        build that Feature, by its id (42, #42, PROJ-123), now
+  doctor         check this machine and list the Features it would build, building nothing (--dry-run is the old name)
+  --use-api-key  let the sessions bill ANTHROPIC_API_KEY instead of your Claude plan
+  --profile NAME run the sessions as the Claude login in ~/.claude-NAME (a path is the folder itself, default is ~/.claude); over config.json's profile
+  --model M      the model of every session, over a Ticket's own line and factory.json
+  --effort LEVEL the effort of every session, over a Ticket's own line and factory.json
+
+       nightjar init              ask for the Tracker and Code host, write factory.json, create the Signal labels, check the logins
+       nightjar create [--dry-run] FILE   make a Feature and its Tickets on the Tracker from a Feature file
+       nightjar contract MODULE   check a module's own Tracker or Code host against the contract suites`;
+// The arguments, or the line that says what is wrong with them.
+export function parseArgs(argv) {
+    const chosen = { mode: null };
+    let feature;
+    let useApiKey = false;
+    let profile;
+    let model;
+    let effort;
+    const pick = (m) => {
+        if (chosen.mode !== null && chosen.mode !== m)
+            return 'choose one of --watch, --once, a Feature and doctor';
+        chosen.mode = m;
+        return null;
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const a = argv[i] ?? '';
+        let fault = null;
+        if (a === '--watch')
+            fault = pick('watch');
+        else if (a === '--once')
+            fault = pick('once');
+        else if (a === 'doctor' || a === '--dry-run')
+            fault = pick('doctor');
+        else if (a === '--use-api-key')
+            useApiKey = true;
+        else if (a === '--model' || a === '--effort' || a === '--profile') {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith('--'))
+                return `${a} needs a value`;
+            if (a === '--model')
+                model = value;
+            else if (a === '--profile')
+                profile = value;
+            else
+                effort = value;
+            i += 1;
+        }
+        else if (/^#?[A-Za-z0-9][\w.-]*$/.test(a)) {
+            fault = pick('feature');
+            feature = a.replace(/^#/, '');
+        }
+        else
+            return `unknown argument ${a}`;
+        if (fault)
+            return fault;
+    }
+    const { mode } = chosen;
+    if (mode === null)
+        return 'say what to build';
+    return {
+        mode,
+        useApiKey,
+        ...(feature === undefined ? {} : { feature }),
+        ...(profile === undefined ? {} : { profile }),
+        ...(model === undefined ? {} : { model }),
+        ...(effort === undefined ? {} : { effort })
+    };
+}
+export function apiKeyProblem(env, useApiKey) {
+    if (useApiKey || !env.ANTHROPIC_API_KEY)
+        return null;
+    return 'ANTHROPIC_API_KEY is set, so every session would bill it per token instead of your Claude plan. Unset it, or pass --use-api-key if that is what you want.';
+}
+// WSL2 reports linux, so only a native Windows process is stopped.
+export function platformProblem(platform) {
+    return platform === 'win32'
+        ? 'native Windows is not supported; Nightjar runs on macOS, Linux and WSL2.'
+        : null;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/ask.d.ts

@@ -0,0 +1,6 @@
+export type Ask = (question: string) => Promise<string | null>;
+export interface Asker {
+    readonly ask: Ask;
+    readonly close: () => void;
+}
+export declare function askOnStdin(): Asker;

package/dist/ask.js

@@ -0,0 +1,27 @@
+// Questions put to a person on a terminal, or to a script that pipes its answers in, one per line.
+import { createInterface } from 'node:readline';
+export function askOnStdin() {
+    const tty = process.stdin.isTTY;
+    // on a terminal readline echoes what is typed; a pipe has no echo, so the answer is written out
+    const lines = createInterface({
+        input: process.stdin,
+        ...(tty ? { output: process.stdout } : {}),
+        terminal: tty
+    });
+    const iterator = lines[Symbol.asyncIterator]();
+    return {
+        ask: async (question) => {
+            process.stdout.write(question);
+            const next = await iterator.next();
+            if (next.done) {
+                process.stdout.write('\n');
+                return null;
+            }
+            if (!tty)
+                process.stdout.write(`${next.value}\n`);
+            return next.value;
+        },
+        close: () => lines.close()
+    };
+}
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAUhD,MAAM,UAAU,UAAU;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAChC,gGAAgG;IAChG,MAAM,KAAK,GAAG,eAAe,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,QAAQ,EAAE,GAAG;KACb,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAC/C,OAAO;QACN,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC;YACb,CAAC;YACD,IAAI,CAAC,GAAG;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,KAAK,CAAC;QACnB,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAC1B,CAAC;AACH,CAAC"}

package/dist/azure-devops/api.d.ts

@@ -0,0 +1,34 @@
+import type { z } from 'zod';
+import type { AzureDevOpsSignIn } from './sign-in.js';
+export declare class AzureDevOpsFailure extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export interface AzureDevOpsCall {
+    readonly method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: string;
+}
+export interface AzureDevOpsReply {
+    readonly status: number;
+    readonly text: string;
+}
+export type AzureDevOpsRequest = (url: string, call: AzureDevOpsCall) => Promise<AzureDevOpsReply>;
+export declare const fetchRequest: AzureDevOpsRequest;
+export interface Sending {
+    readonly method: AzureDevOpsCall['method'];
+    readonly url: string;
+    readonly body?: unknown;
+    readonly contentType?: string;
+}
+export declare class AzureDevOpsApi {
+    readonly organization: string;
+    readonly signIn: AzureDevOpsSignIn;
+    private readonly request;
+    constructor(organization: string, signIn: AzureDevOpsSignIn, request?: AzureDevOpsRequest);
+    at(path: string): string;
+    identities(path: string): string;
+    call(what: string, sending: Sending): Promise<unknown>;
+    parse<T>(what: string, sending: Sending, schema: z.ZodType<T>): Promise<T>;
+    private send;
+}

package/dist/azure-devops/api.js

@@ -0,0 +1,98 @@
+import { why } from '../say.js';
+// An Azure DevOps call Nightjar cannot do without; its message names the call and the reason.
+export class AzureDevOpsFailure extends Error {
+    status;
+    constructor(message, 
+    // the HTTP status Azure DevOps answered, when it answered one
+    status) {
+        super(message);
+        this.status = status;
+    }
+}
+const WAIT_MS = 60_000;
+export const fetchRequest = async (url, call) => {
+    const reply = await fetch(url, { ...call, signal: AbortSignal.timeout(WAIT_MS) });
+    return { status: reply.status, text: await reply.text() };
+};
+// what Azure DevOps answers a call it refuses with, as far as a message goes
+const said = (text) => {
+    try {
+        const value = JSON.parse(text);
+        if (typeof value?.message === 'string')
+            return value.message;
+    }
+    catch {
+        // not JSON: its first line says as much as anything
+    }
+    return text.trim().split('\n')[0] ?? '';
+};
+export class AzureDevOpsApi {
+    organization;
+    signIn;
+    request;
+    constructor(organization, signIn, request = fetchRequest) {
+        this.organization = organization;
+        this.signIn = signIn;
+        this.request = request;
+    }
+    // An address on the organization's own host: `path` comes after dev.azure.com/<organization>/.
+    at(path) {
+        return `https://dev.azure.com/${encodeURIComponent(this.organization)}/${path}`;
+    }
+    // An address on the organization's identity host, which answers who people are and their groups.
+    identities(path) {
+        return `https://vssps.dev.azure.com/${encodeURIComponent(this.organization)}/${path}`;
+    }
+    // The JSON Azure DevOps answers, or null for an empty answer.
+    async call(what, sending) {
+        let reply = await this.send(what, sending);
+        if (reply.status === 401) {
+            await this.signIn.refresh();
+            reply = await this.send(what, sending);
+        }
+        // 203 is the sign-in page Azure DevOps answers a token it does not take with
+        if (reply.status === 401 || reply.status === 403 || reply.status === 203) {
+            throw new AzureDevOpsFailure(`Azure DevOps refused ${await this.signIn.via()} when asked to ${what}: HTTP ${String(reply.status)}`, reply.status);
+        }
+        if (reply.status >= 400) {
+            const reason = said(reply.text);
+            throw new AzureDevOpsFailure(`Azure DevOps could not ${what}: HTTP ${String(reply.status)}${reason ? `: ${reason}` : ''}`, reply.status);
+        }
+        if (reply.text.trim() === '')
+            return null;
+        try {
+            return JSON.parse(reply.text);
+        }
+        catch {
+            throw new AzureDevOpsFailure(`Azure DevOps answered no JSON when asked to ${what}.`);
+        }
+    }
+    async parse(what, sending, schema) {
+        const parsed = schema.safeParse(await this.call(what, sending));
+        if (!parsed.success) {
+            throw new AzureDevOpsFailure(`Azure DevOps answered ${what} in a shape not known.`);
+        }
+        return parsed.data;
+    }
+    async send(what, sending) {
+        const headers = {
+            Authorization: await this.signIn.authorization(),
+            Accept: 'application/json'
+        };
+        if (sending.body !== undefined) {
+            headers['Content-Type'] = sending.contentType ?? 'application/json';
+        }
+        try {
+            return await this.request(sending.url, {
+                method: sending.method,
+                headers,
+                ...(sending.body === undefined ? {} : { body: JSON.stringify(sending.body) })
+            });
+        }
+        catch (fault) {
+            const reason = why(fault);
+            throw new AzureDevOpsFailure(`Azure DevOps could not ${what}: ${reason}`);
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/azure-devops/api.js.map

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

package/dist/azure-devops/code-host.d.ts

@@ -0,0 +1,36 @@
+import type { CodeHost, DraftRequest, Pull } from '../code-host.js';
+import { type Env, type Run } from '../git.js';
+import type { TicketReference } from '../tracker.js';
+import { type AzureDevOpsApi } from './api.js';
+export type AzureGitRunner = (args: readonly string[], cwd: string, extra: Env) => Promise<Run>;
+export type ReferencesAs = 'work items' | 'text';
+export interface AzureReposSettings {
+    readonly project: string;
+    readonly repo: string;
+    readonly referencesAs: ReferencesAs;
+}
+export declare const DESCRIPTION_LIMIT = 4000;
+export declare const REFERENCES_MARK = "<!-- nightjar:references -->";
+export declare class AzureReposCodeHost implements CodeHost {
+    private readonly api;
+    private readonly settings;
+    private readonly git;
+    private readonly project;
+    private readonly repo;
+    private readonly remote;
+    constructor(api: AzureDevOpsApi, settings: AzureReposSettings, git: AzureGitRunner, remote?: string);
+    private at;
+    private pullUrl;
+    private toPull;
+    check(): Promise<void>;
+    private signedIn;
+    push(folder: string, branch: string): Promise<void>;
+    openPull(branch: string): Promise<Pull | null>;
+    createDraft(request: DraftRequest): Promise<Pull>;
+    private read;
+    private setBody;
+    editBody(pull: Pull, body: string): Promise<void>;
+    placeReferences(pull: Pull, references: readonly TicketReference[]): Promise<void>;
+    private linkWorkItems;
+    comment(pull: Pull, body: string): Promise<void>;
+}