nightralph 0.0.2 → 0.0.4

package/dist/src/progress.d.ts

@@ -0,0 +1,27 @@
+import type { Ticket } from './orchestrator.js';
+export type TicketProgress = {
+    num: number;
+    slug: string;
+    filename: string;
+    done: boolean;
+    branch: string | null;
+    exitCode: number | null;
+    completedAt: string | null;
+};
+export type ProgressData = {
+    feature: string;
+    startedAt: string;
+    tickets: Array<TicketProgress>;
+};
+export declare function generateProgress(feature: string, tickets: ReadonlyArray<Ticket>): ProgressData;
+export declare function readProgress(progressPath: string): ProgressData | null;
+export declare function mergeProgress(fresh: ProgressData, existing: ProgressData | null): ProgressData;
+export declare function renderProgress(data: ProgressData): string;
+export declare function checkTicket(data: ProgressData, ticketNum: number, result: {
+    branch: string;
+    exitCode: number;
+    done?: boolean;
+}): void;
+export declare function writeProgress(progressPath: string, data: ProgressData): void;
+export declare function commitProgress(repoRoot: string, progressPath: string, message: string): Promise<void>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/src/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAM/C,MAAM,MAAM,cAAc,GAAG;IACzB,GAAG,EAAC,MAAM,CAAA;IACV,IAAI,EAAC,MAAM,CAAA;IACX,QAAQ,EAAC,MAAM,CAAA;IACf,IAAI,EAAC,OAAO,CAAA;IACZ,MAAM,EAAC,MAAM,GAAC,IAAI,CAAA;IAClB,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAA;IACpB,WAAW,EAAC,MAAM,GAAC,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAC,MAAM,CAAA;IACd,SAAS,EAAC,MAAM,CAAA;IAChB,OAAO,EAAC,KAAK,CAAC,cAAc,CAAC,CAAA;CAChC,CAAA;AAED,wBAAgB,gBAAgB,CAC5B,OAAO,EAAC,MAAM,EACd,OAAO,EAAC,aAAa,CAAC,MAAM,CAAC,GAC/B,YAAY,CAcb;AAED,wBAAgB,YAAY,CACxB,YAAY,EAAC,MAAM,GACrB,YAAY,GAAC,IAAI,CAwDlB;AAED,wBAAgB,aAAa,CACzB,KAAK,EAAC,YAAY,EAClB,QAAQ,EAAC,YAAY,GAAC,IAAI,GAC5B,YAAY,CAcb;AAED,wBAAgB,cAAc,CAAE,IAAI,EAAC,YAAY,GAAE,MAAM,CAgCxD;AAED,wBAAgB,WAAW,CACvB,IAAI,EAAC,YAAY,EACjB,SAAS,EAAC,MAAM,EAChB,MAAM,EAAC;IAAE,MAAM,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,IAAI,CAAC,EAAC,OAAO,CAAA;CAAE,GAC1D,IAAI,CAYL;AAED,wBAAgB,aAAa,CACzB,YAAY,EAAC,MAAM,EACnB,IAAI,EAAC,YAAY,GACnB,IAAI,CAKL;AAED,wBAAsB,cAAc,CAChC,QAAQ,EAAC,MAAM,EACf,YAAY,EAAC,MAAM,EACnB,OAAO,EAAC,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAYd"}

package/dist/src/resolve.d.ts

@@ -1,9 +1,10 @@
+export declare function getScriptDir(metaUrl: string): string;
 export declare function findFeatureDirs(cwd: string): {
     name: string;
     dir: string;
     spec: string;
 }[];
-export declare function resolveIssuesDir(dirFlag: string | undefined, specFlag: string | undefined, cwd?: string): Promise<{
+export declare function resolveIssuesDir(specName: string | undefined, cwd?: string): Promise<{
     dir: string;
     spec: string;
 }>;

package/dist/src/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/resolve.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAE,GAAG,EAAC,MAAM,GAAE;IACzC,IAAI,EAAC,MAAM,CAAC;IACZ,GAAG,EAAC,MAAM,CAAC;IACX,IAAI,EAAC,MAAM,CAAA;CACd,EAAE,CAwBF;AAED,wBAAsB,gBAAgB,CAClC,OAAO,EAAC,MAAM,GAAC,SAAS,EACxB,QAAQ,EAAC,MAAM,GAAC,SAAS,EACzB,GAAG,GAAC,MAAsB,GAC5B,OAAO,CAAC;IAAE,GAAG,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAM,CAAA;CAAE,CAAC,CAkCrC"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/resolve.ts"],"names":[],"mappings":"AAKA,wBAAgB,YAAY,CAAE,OAAO,EAAC,MAAM,GAAE,MAAM,CAEnD;AAED,wBAAgB,eAAe,CAAE,GAAG,EAAC,MAAM,GAAE;IACzC,IAAI,EAAC,MAAM,CAAC;IACZ,GAAG,EAAC,MAAM,CAAC;IACX,IAAI,EAAC,MAAM,CAAA;CACd,EAAE,CAwBF;AAED,wBAAsB,gBAAgB,CAClC,QAAQ,EAAC,MAAM,GAAC,SAAS,EACzB,GAAG,GAAC,MAAsB,GAC5B,OAAO,CAAC;IAAE,GAAG,EAAC,MAAM,CAAC;IAAC,IAAI,EAAC,MAAM,CAAA;CAAE,CAAC,CAmCrC"}

package/dist/src/setup.d.ts

@@ -1,5 +1,6 @@
 export declare const SKILL_DIRS: readonly ["grill", "grilling", "domain-modeling", "to-spec", "to-tickets", "tdd"];
 export declare const DOC_TEMPLATES: readonly ["triage-labels.md", "domain.md"];
+export declare function writeManagedSection(filePath: string, content: string): void;
 export declare function checkGhAuth(): boolean;
 export type TrackerKind = 'github' | 'local';
 export type SetupOpts = {

package/dist/src/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/setup.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,UAAU,mFAGb,CAAA;AAEV,eAAO,MAAM,aAAa,4CAGhB,CAAA;AAEV,wBAAgB,WAAW,IAAI,OAAO,CAOrC;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAC,OAAO,CAAA;AAE1C,MAAM,MAAM,SAAS,GAAG;IACpB,gBAAgB,EAAC,MAAM,CAAA;IACvB,gBAAgB,EAAC,MAAM,CAAA;IACvB,UAAU,EAAC,MAAM,CAAA;IACjB,MAAM,CAAC,EAAC,OAAO,CAAA;IACf,OAAO,EAAC,WAAW,CAAA;CACtB,CAAA;AAOD,wBAAgB,KAAK,CAAE,IAAI,EAAC,SAAS,GAAE,IAAI,CA8G1C"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/setup.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,UAAU,mFAGb,CAAA;AAEV,eAAO,MAAM,aAAa,4CAGhB,CAAA;AAKV,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAC,MAAM,EACf,OAAO,EAAC,MAAM,GAChB,IAAI,CA0BL;AAED,wBAAgB,WAAW,IAAI,OAAO,CAOrC;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAC,OAAO,CAAA;AAE1C,MAAM,MAAM,SAAS,GAAG;IACpB,gBAAgB,EAAC,MAAM,CAAA;IACvB,gBAAgB,EAAC,MAAM,CAAA;IACvB,UAAU,EAAC,MAAM,CAAA;IACjB,MAAM,CAAC,EAAC,OAAO,CAAA;IACf,OAAO,EAAC,WAAW,CAAA;CACtB,CAAA;AAOD,wBAAgB,KAAK,CAAE,IAAI,EAAC,SAAS,GAAE,IAAI,CA8G1C"}

package/dist/src/worktree.d.ts

@@ -0,0 +1,18 @@
+import type { Ticket } from './orchestrator.js';
+export declare function getRepoRoot(): string;
+export declare function getRepoName(): string;
+export declare function getCurrentBranch(): string;
+export declare function createWorktree(opts: {
+    repoRoot: string;
+    repoName: string;
+    baseBranch: string;
+    ticket: Ticket;
+}): Promise<{
+    worktreePath: string;
+    branchName: string;
+}>;
+export declare function removeWorktree(worktreePath: string): Promise<void>;
+export declare function hasNewCommits(repoRoot: string, base: string, branch: string): boolean;
+export declare function isDirty(cwd: string): boolean;
+export declare function listWorktrees(repoRoot: string): Promise<Array<string>>;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/src/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/worktree.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI/C,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAkBD,wBAAsB,cAAc,CAChC,IAAI,EAAC;IACD,QAAQ,EAAC,MAAM,CAAA;IACf,QAAQ,EAAC,MAAM,CAAA;IACf,UAAU,EAAC,MAAM,CAAA;IACjB,MAAM,EAAC,MAAM,CAAA;CAChB,GACH,OAAO,CAAC;IAAE,YAAY,EAAC,MAAM,CAAC;IAAC,UAAU,EAAC,MAAM,CAAA;CAAE,CAAC,CA2DpD;AAED,wBAAsB,cAAc,CAChC,YAAY,EAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAOd;AAED,wBAAgB,aAAa,CACzB,QAAQ,EAAC,MAAM,EACf,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,MAAM,GACf,OAAO,CAOR;AAED,wBAAgB,OAAO,CAAE,GAAG,EAAC,MAAM,GAAE,OAAO,CAO3C;AAED,wBAAsB,aAAa,CAC/B,QAAQ,EAAC,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAWvB"}

package/dist/worktree.js

@@ -0,0 +1,139 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { execFile, execFileSync } from "node:child_process";
+import { promisify } from "node:util";
+import { basename, join } from "node:path";
+import { existsSync } from "node:fs";
+const execFileAsync = promisify(execFile);
+function getRepoRoot() {
+  const stdout = execFileSync(
+    "git",
+    ["rev-parse", "--show-toplevel"],
+    { encoding: "utf8" }
+  );
+  return stdout.trim();
+}
+__name(getRepoRoot, "getRepoRoot");
+function getRepoName() {
+  return basename(getRepoRoot());
+}
+__name(getRepoName, "getRepoName");
+function getCurrentBranch() {
+  const stdout = execFileSync(
+    "git",
+    ["rev-parse", "--abbrev-ref", "HEAD"],
+    { encoding: "utf8" }
+  );
+  return stdout.trim();
+}
+__name(getCurrentBranch, "getCurrentBranch");
+async function branchExists(repoRoot, branchName) {
+  try {
+    await execFileAsync(
+      "git",
+      ["show-ref", "--verify", "--quiet", `refs/heads/${branchName}`],
+      { cwd: repoRoot }
+    );
+    return true;
+  } catch {
+    return false;
+  }
+}
+__name(branchExists, "branchExists");
+async function createWorktree(opts) {
+  const { repoRoot, repoName, baseBranch, ticket } = opts;
+  const branchName = `${repoName}/${String(
+    ticket.num
+  ).padStart(2, "0")}-${ticket.slug}`;
+  const worktreePath = join(
+    repoRoot,
+    "..",
+    `${repoName}.${String(
+      ticket.num
+    ).padStart(2, "0")}-${ticket.slug}`
+  );
+  if (existsSync(worktreePath)) {
+    try {
+      await execFileAsync(
+        "git",
+        ["worktree", "remove", "--force", worktreePath],
+        { cwd: repoRoot }
+      );
+    } catch {
+    }
+  }
+  try {
+    await execFileAsync(
+      "git",
+      ["worktree", "prune"],
+      { cwd: repoRoot }
+    );
+  } catch {
+  }
+  if (await branchExists(repoRoot, branchName)) {
+    await execFileAsync(
+      "git",
+      ["branch", "-D", branchName],
+      { cwd: repoRoot }
+    );
+  }
+  await execFileAsync(
+    "git",
+    [
+      "worktree",
+      "add",
+      "-b",
+      branchName,
+      worktreePath,
+      baseBranch
+    ],
+    { cwd: repoRoot }
+  );
+  return { worktreePath, branchName };
+}
+__name(createWorktree, "createWorktree");
+async function removeWorktree(worktreePath) {
+  await execFileAsync(
+    "git",
+    ["-C", worktreePath, "worktree", "remove", worktreePath]
+  );
+}
+__name(removeWorktree, "removeWorktree");
+function hasNewCommits(repoRoot, base, branch) {
+  const stdout = execFileSync(
+    "git",
+    ["rev-list", "--count", `${base}..${branch}`],
+    { cwd: repoRoot, encoding: "utf8" }
+  );
+  return Number(stdout.trim()) > 0;
+}
+__name(hasNewCommits, "hasNewCommits");
+function isDirty(cwd) {
+  const stdout = execFileSync(
+    "git",
+    ["status", "--porcelain"],
+    { cwd, encoding: "utf8" }
+  );
+  return stdout.trim().length > 0;
+}
+__name(isDirty, "isDirty");
+async function listWorktrees(repoRoot) {
+  const { stdout } = await execFileAsync(
+    "git",
+    ["worktree", "list", "--porcelain"],
+    { cwd: repoRoot }
+  );
+  return stdout.trim().split("\n").filter((line) => line.startsWith("worktree ")).map((line) => line.substring("worktree ".length));
+}
+__name(listWorktrees, "listWorktrees");
+export {
+  createWorktree,
+  getCurrentBranch,
+  getRepoName,
+  getRepoRoot,
+  hasNewCommits,
+  isDirty,
+  listWorktrees,
+  removeWorktree
+};
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/worktree.ts"],
+  "sourcesContent": ["import { execFile, execFileSync } from 'node:child_process'\nimport { promisify } from 'node:util'\nimport { basename, join } from 'node:path'\nimport { existsSync } from 'node:fs'\nimport type { Ticket } from './orchestrator.js'\n\nconst execFileAsync = promisify(execFile)\n\nexport function getRepoRoot ():string {\n    const stdout = execFileSync(\n        'git',\n        ['rev-parse', '--show-toplevel'],\n        { encoding:'utf8' }\n    )\n    return stdout.trim()\n}\n\nexport function getRepoName ():string {\n    return basename(getRepoRoot())\n}\n\nexport function getCurrentBranch ():string {\n    const stdout = execFileSync(\n        'git',\n        ['rev-parse', '--abbrev-ref', 'HEAD'],\n        { encoding:'utf8' }\n    )\n    return stdout.trim()\n}\n\nasync function branchExists (\n    repoRoot:string,\n    branchName:string\n):Promise<boolean> {\n    try {\n        await execFileAsync(\n            'git',\n            ['show-ref', '--verify', '--quiet', `refs/heads/${branchName}`],\n            { cwd:repoRoot }\n        )\n        return true\n    } catch {\n        return false\n    }\n}\n\nexport async function createWorktree (\n    opts:{\n        repoRoot:string\n        repoName:string\n        baseBranch:string\n        ticket:Ticket\n    }\n):Promise<{ worktreePath:string; branchName:string }> {\n    const { repoRoot, repoName, baseBranch, ticket } = opts\n    const branchName = `${repoName}/${String(\n        ticket.num\n    ).padStart(2, '0')}-${ticket.slug}`\n    const worktreePath = join(\n        repoRoot,\n        '..',\n        `${repoName}.${String(\n            ticket.num\n        ).padStart(2, '0')}-${ticket.slug}`\n    )\n\n    if (existsSync(worktreePath)) {\n        try {\n            await execFileAsync(\n                'git',\n                ['worktree', 'remove', '--force', worktreePath],\n                { cwd:repoRoot }\n            )\n        } catch {\n            // directory may not be a registered worktree anymore;\n            // prune stale entries below and let worktree add fail\n            // loudly if the path is still unusable\n        }\n    }\n\n    try {\n        await execFileAsync(\n            'git',\n            ['worktree', 'prune'],\n            { cwd:repoRoot }\n        )\n    } catch {\n        // best-effort cleanup of stale worktree metadata\n    }\n\n    if (await branchExists(repoRoot, branchName)) {\n        await execFileAsync(\n            'git',\n            ['branch', '-D', branchName],\n            { cwd:repoRoot }\n        )\n    }\n\n    await execFileAsync(\n        'git',\n        [\n            'worktree',\n            'add',\n            '-b',\n            branchName,\n            worktreePath,\n            baseBranch,\n        ],\n        { cwd:repoRoot }\n    )\n\n    return { worktreePath, branchName }\n}\n\nexport async function removeWorktree (\n    worktreePath:string\n):Promise<void> {\n    // Use git -C to run the command from the worktree directory context\n    // so git can resolve the repository\n    await execFileAsync(\n        'git',\n        ['-C', worktreePath, 'worktree', 'remove', worktreePath]\n    )\n}\n\nexport function hasNewCommits (\n    repoRoot:string,\n    base:string,\n    branch:string\n):boolean {\n    const stdout = execFileSync(\n        'git',\n        ['rev-list', '--count', `${base}..${branch}`],\n        { cwd:repoRoot, encoding:'utf8' }\n    )\n    return Number(stdout.trim()) > 0\n}\n\nexport function isDirty (cwd:string):boolean {\n    const stdout = execFileSync(\n        'git',\n        ['status', '--porcelain'],\n        { cwd, encoding:'utf8' }\n    )\n    return stdout.trim().length > 0\n}\n\nexport async function listWorktrees (\n    repoRoot:string\n):Promise<Array<string>> {\n    const { stdout } = await execFileAsync(\n        'git',\n        ['worktree', 'list', '--porcelain'],\n        { cwd:repoRoot }\n    )\n    return stdout\n        .trim()\n        .split('\\n')\n        .filter(line => line.startsWith('worktree '))\n        .map(line => line.substring('worktree '.length))\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,26 +1,30 @@
 {
   "name": "nightralph",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "Orchestrator that runs a single-agent session per issue.",
   "bin": {
     "nightralph": "dist/index.js"
   },
+  "files": [
+    "dist/**",
+    "!dist/test"
+  ],
   "engines": {
-    "node": ">=18"
+    "node": ">=24"
   },
   "scripts": {
     "lint": "eslint \"./**/*.{ts,js}\"",
     "start": "npm run build && node dist/index.js",
     "build": "mkdir -p ./dist && rm -rf ./dist/* && npm run build-esm && npm run copy",
-    "build-esm": "esbuild src/index.ts src/orchestrator.ts src/setup.ts src/resolve.ts --format=esm --metafile=dist/meta.json --keep-names --tsconfig=tsconfig.build.json --outdir=./dist --sourcemap && tsc --emitDeclarationOnly --project tsconfig.build.json",
+    "build-esm": "esbuild src/index.ts src/orchestrator.ts src/setup.ts src/resolve.ts src/worktree.ts src/progress.ts src/merge.ts --format=esm --metafile=dist/meta.json --keep-names --tsconfig=tsconfig.build.json --outdir=./dist --sourcemap && tsc --emitDeclarationOnly --project tsconfig.build.json",
     "copy": "mkdir -p ./dist/skills ./dist/docs-templates && cp -r ./src/skills/* ./dist/skills && cp -r ./src/docs-templates/* ./dist/docs-templates",
     "clone-skills": "bash scripts/clone-skills.sh",
     "toc": "markdown-toc --maxdepth 3 -i README.md",
     "preversion": "npm run lint",
     "version": "npm run toc",
     "postversion": "git push --follow-tags && npm publish",
-    "test": "esbuild test/setup.test.ts test/orchestrator.test.ts test/integration.test.ts --format=esm --bundle --packages=external --outdir=dist/test --sourcemap && node dist/test/setup.test.js && node dist/test/orchestrator.test.js && node dist/test/integration.test.js"
+    "test": "esbuild test/setup.test.ts test/orchestrator.test.ts test/worktree.test.ts test/progress.test.ts test/merge.test.ts test/integration.test.ts --format=esm --bundle --packages=external --outdir=dist/test --sourcemap && node dist/test/setup.test.js && node dist/test/orchestrator.test.js && node dist/test/worktree.test.js && node dist/test/progress.test.js && node dist/test/merge.test.js && node dist/test/integration.test.js"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.7.0",

package/.claude/settings.local.json

@@ -1,5 +0,0 @@
-{
-  "enabledPlugins": {
-    "mattpocock-skills@claude-plugins-official": true
-  }
-}

package/.github/dependabot.yml

@@ -1,28 +0,0 @@
-version: 2
-updates:
-  # Enable version updates for npm
-  - package-ecosystem: "npm"
-    # Look for `package.json` and `lock` files in the `root` directory
-    directory: "/"
-    # Check the npm registry for updates every day (weekdays)
-    schedule:
-      interval: "monthly"
-    groups:
-      # This is the name of your group. It will be used in PR titles and branch names
-      dev-dependencies:
-        patterns:
-          - "*"
-    ignore:
-      - dependency-name: "eslint"
-        update-types: ["version-update:semver-major"]
-      - dependency-name: "eslint*"
-        update-types: ["version-update:semver-major"]
-      - dependency-name: "typescript-eslint"
-        update-types: ["version-update:semver-major"]
-      - dependency-name: "neostandard"
-        update-types: ["version-update:semver-major"]
-  # Enable updates to github actions
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "monthly"

package/.github/workflows/nodejs.yml

@@ -1,30 +0,0 @@
-name: Node CI
-
-on: [push]
-
-jobs:
-  build:
-
-    runs-on: ubuntu-22.04
-    timeout-minutes: 5
-
-    strategy:
-      matrix:
-        node-version: [25.x]
-
-    steps:
-    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
-      with:
-        node-version: ${{ matrix.node-version }}
-    - name: npm install, build
-      run: |
-        npm install
-        npm run build --if-present
-        npm run lint
-      env:
-        CI: true
-    - name: Run tap tests
-      run: |
-        npm test

package/AGENTS.md

@@ -1,60 +0,0 @@
-# nightralph
-
-Last verified: 2026-08-27
-
-Small orchestrator that runs a single-agent session per issue.
-
-## Tech Stack
-- TypeScript, Node >= 18, ESM
-- CLI: yargs + @inquirer/prompts
-- Testing: @substrate-system/tapzero
-
-## Commands
-- `npm run build` -- build to dist/
-- `npm test` -- build and run tests
-- `npm run lint` -- eslint
-
-## Project Structure
-- `src/index.ts` -- CLI entry point (yargs commands)
-- `src/setup.ts` -- project scaffolding module
-- `src/orchestrator.ts` -- ticket scanning and wave execution
-- `src/skills/` -- bundled skill definitions
-- `src/docs-templates/` -- doc templates copied to target projects
-
-## Contracts
-
-### setup module (`src/setup.ts`)
-- **Exposes**: `setup(opts)`, `checkGhAuth()`,
-  `TrackerKind`, `SetupOpts`, `SKILL_DIRS`, `DOC_TEMPLATES`
-- **TrackerKind**: `'github'|'local'`
-- **SetupOpts.tracker**: required -- selects which
-  issue-tracker template is installed and what AGENTS.md
-  content is generated in the target project
-- **checkGhAuth()**: returns true when
-  `gh auth status` succeeds
-- **DOC_TEMPLATES**: `['triage-labels.md', 'domain.md']` --
-  issue-tracker.md is handled separately via tracker selection
-- **Guarantees**: `setup()` always overwrites
-  `issue-tracker.md` (not skip-if-exists like other
-  templates); always writes AGENTS.md to the target project
-
-### CLI (`src/index.ts`)
-- `nightralph setup [--claude]` -- prompts for tracker
-  format, then scaffolds skills and docs
-- `nightralph <provider> [options]` -- executes tickets
-
-## Agent skills
-
-### Issue tracker
-
-Issues are tracked as local markdown files under
-`.scratch/`. See `docs/agents/issue-tracker.md`.
-
-### Triage labels
-
-Default label vocabulary.
-See `docs/agents/triage-labels.md`.
-
-### Domain docs
-
-Single-context layout. See `docs/agents/domain.md`.

package/CLAUDE.md

@@ -1 +0,0 @@
-Read @./AGENTS.md and treat its contents as if they were in CLAUDE.md

package/PROMPT.md

@@ -1,95 +0,0 @@
-# MISSION
-
-Build and maintain nightralph -- a small orchestrator CLI that runs
-single-agent sessions per issue.
-
-# Role
-You are an expert TypeScript/Node.js engineer specializing in CLI tools,
-process orchestration, and test automation.
-
-# Objective
-
-Develop and test a CLI orchestrator using:
-
-- Runtime: Node >= 18, ESM
-- CLI: yargs for command parsing, @inquirer/prompts for interactive input
-- Build: esbuild (ESM output to dist/)
-- Testing: @substrate-system/tapzero
-
-## META INSTRUCTION
-
-Before performing any tool call or code change, emit a short, one-line status
-update in the terminal starting with 'LOG: [Action]'. This helps me track your
-progress in the Ralph Loop.
-
-## EXECUTION RULES
-
-1. READ: At the start of EVERY session, read `specs/prd.json` and `progress.log`.
-2. SCOPE: Pick the highest-priority task where `passes: false` (or missing).
-   Work ONLY on that one task. Do not touch or mark any other story.
-3. WRITE TESTS FIRST: Write failing tests for the feature/bug, then implement
-   until they pass.
-4. TARGETED TESTING WHILE WORKING:
-   - DO NOT run the full suite (`npm test`) for every minor change.
-   - DO run only the tests relevant to the file you are editing
-     (e.g., `npx vitest run path/to/file.spec.ts`).
-5. VERIFY BEFORE COMMIT (and only then run the full suite):
-   - Run `npm run lint`.
-   - Run the FULL suite `npm test` ONCE, when you believe the task is complete.
-   - If lint or the full suite fails, fix it before committing.
-   (Rules 4 and 5 are complementary: targeted tests during the work, one full
-    suite run as the final gate. Never run the full suite after every edit.)
-6. DOCUMENT: Append to `progress.log` what changed and any new patterns or
-   gotchas discovered (these become context for future sessions).
-7. UPDATE PRD: In `specs/prd.json`, set `passes: true` for the completed story
-   ONLY. Leave every other story untouched.
-8. COMMIT: After the full suite passes, commit with a descriptive message like
-   `FEATURE: [TaskID] - [Description]`. ALWAYS COMMIT AFTER COMPLETING A TASK —
-   an uncommitted change does not count as progress.
-9. ATOMICITY: Complete EXACTLY ONE task per session, then STOP.
-
-## CRITICAL: NON-INTERACTIVE MODE
-
-This is an autonomous session. You must NEVER:
-- Ask clarifying questions.
-- Wait for user input.
-- Output questions like 'What would you like me to work on?'
-If a detail is genuinely ambiguous, make the most reasonable assumption,
-record it in `progress.log`, and proceed.
-
-## Strict Constraints
-
-- Do NOT add new dependencies. If you believe one is truly required, do not
-  install it -- document the need in `progress.log` and proceed without it.
-- Prefer standard Node.js APIs over third-party alternatives wherever possible.
-- Stay within the tech stack above. Do not introduce other test runners or
-  build tools.
-
-# Technical Constraints
-
-- CLI entry point: `src/index.ts` (yargs commands)
-- Project scaffolding: `src/setup.ts`
-- Ticket scanning and wave execution: `src/orchestrator.ts`
-- Bundled skills: `src/skills/`
-- Doc templates: `src/docs-templates/`
-- Build: `npm run build` (esbuild to dist/)
-- Test: `npm test` (esbuild + node to run tapzero tests)
-- Lint: `npm run lint` (eslint)
-
-# Error Handling
-
-If you hit a bug you cannot fix this session, document the failure and what you
-tried in `progress.log`, then stop. Do not loop on the same failing approach --
-a future session (with stronger reasoning hints) will pick it up.
-
-## STOP CONDITION
-
-Once ALL tasks in `specs/prd.json` have `passes: true`, output the EXACT string
-on its own line, as your final message, after the work is verified:
-
-<promise>COMPLETE</promise>
-
-Do not emit that string in any other context (e.g., while planning or
-explaining) -- the loop treats it as a completion signal only when the PRD also
-shows zero pending tasks, so emitting it early just wastes a check. Do not
-perform any further work once all tasks are verified.

package/WIP.md

@@ -1,5 +0,0 @@
-# WIP
-
-``sh
-/ed3d-plan-and-execute:execute-implementation-plan /Users/nick/code/nightralph/docs/implementation-plans/2026-08-27-issue-tracker-choice/ /Users/nick/code/nightralph/
-```