breakaway 1.4.0-main.2 → 1.4.0-main.21

package/scripts/tasks.mjs

@@ -42,7 +42,14 @@ import { promptPathOf } from '../src/repos.js';
 import { hookFailure, sessionProxy, routeThroughSessionProxy } from './tasks/proxy.js';
 import { githubFromRemote, inRepo, pickRepo } from './tasks/repo.js';
 import { NO_TERMINAL, ask as askIn } from './tasks/ask.js';
-import { CLI_PACKAGE, PROMPT_SECTIONS, initPlan, machineTaskrc, promptSections } from './tasks/init.js';
+import {
+  CLI_PACKAGE,
+  PROMPT_SECTIONS,
+  initCommitMessage,
+  initPlan,
+  machineTaskrc,
+  promptSections,
+} from './tasks/init.js';
 import {
   chaseRequest,
   chaseSummary,
@@ -54,7 +61,12 @@ import {
   generalAgentRequest,
   generalAgentSummary,
   githubRequest,
+  specLines,
+  specListLines,
+  specRequest,
+  specsRequest,
   ideaTask,
+  packageReleaseRequest,
   pullAgentRequest,
   pullAgentSummary,
   reviewRequest,
@@ -147,6 +159,8 @@ Reading                (list, next, claim, and add work in this checkout's repos
   agents new "<prompt>"  start an agent from a prompt: it makes its own task  [--image <file>]… [--repo <slug>] [--force] (owner)
   agents new --decision <ref> ["<note>"]   start an agent that brings the work waiting for an answered decision in line with its answers; the board writes its prompt  [--force] (owner)
   agents new --next minor|major ["<note>"]   start an agent that sets package.json to the next minor or major release; the board writes its prompt  [--repo <slug>] [--force] (owner)
+  agents new --spec <path> "<what should change>"   start an agent that changes a spec as you ask and brings the tasks that
+                         link it in line; the board writes its prompt  [--repo <slug>] [--force] (owner)
   agents start <ref>     start a Claude cloud agent on a task  [--note <text>] [--force]
   agents refine <ref>    start an agent that improves a task, not builds it  --note <what to look at or change> [--force]
   agents plan [<plan>]   your Claude plan and what it allows; pro, max5, or max20 picks one (owner) and sets the limits to its defaults
@@ -165,6 +179,10 @@ Reading                (list, next, claim, and add work in this checkout's repos
   github review <n>      start an agent that reviews a pull request that can merge as it stands, on the task it closes, as
                          Review with an agent does; on a Dependabot one it tests the update, as Safe to merge? does
                          (owner)  [--note <text>] [--repo <slug>] [--force]
+  github release <pre-release>   release a package's pre-release (1.4.0-main.5) as its stable on latest, as Release on the
+                         GitHub page does: the board starts release.yml's stable job, and npm waits for your 2FA (owner)  [--repo <slug>]
+  specs                  the repository's specs, newest first: each one's status and its tasks  [--repo <slug>]
+  specs show <path>      one spec: its status, last change, Markdown, and the tasks that link it  [--repo <slug>]
   github                 the checkout's repository on GitHub: open pull requests, checks, reviews, CI, deploys, alerts  [--sync] [--repo <slug>]
   hook session|wait      the Claude Code session hooks a repository's .claude/settings.json runs (npx breakaway hook session)
   health                 the server's state
@@ -236,7 +254,9 @@ Working
   repos modify <slug>    change one (owner): --area <project:PREFIX> adds an area, --remove-area <project> drops one with no tasks, --name, --branch, --github,
                          --agents-max <n|none> and --agents-hourly <n|none> cap its agents under the board's shared limits,
                          --prompt <path|none> says where its agent prompt is in its checkout (default tools/tasks/routine-prompt.md)
-                         --pipeline <file.json|none> sets its deploy pipeline ({"workers": {"staging", "production"}, "workflows": {...}, "deployPaths"}) or clears it
+                         --specs <dir|none> says where its specs are (default docs/specs)
+                         --pipeline <file.json|none> sets its deploy pipeline ({"workers": {"staging", "production"}, "package": "<npm name>", "workflows": {...}, "deployPaths"},
+                         with workers, package, or both) or clears it
   features add <slug>    new feature: its tasks join by carrying <slug> as a tag  [--title <text>]
                          [--brief <text> | --brief-file <path>] [--release <x.y.z>] (agents add one without a release)
                          --from <ref> (owner): made from the group <ref> is in on the Dependencies view: its open tasks
@@ -268,6 +288,12 @@ Install repository     (no board needed: the files and steps that deploy a board
                          [--channel stable|main] [--version <release>]
   install resolve|check|config|previous|healthy|update   the steps those workflows run (docs in the install's README)
 
+Deploy and release flows   (no board needed: run in the checkout of the repository that deploys or publishes)
+  pipeline init          render .github/breakaway-pipeline.json into Deploy, Promote, and Roll back (for its workers),
+                         .github/deploy-paths.json, and Release (for its npm package); without the config it prints an
+                         example. Never overwrites a file  [--update] replaces what it rendered before  [--dry-run]
+  pipeline check         say whether the config is sound and the workflows are what it renders now (exits 1 if not)
+
 Repositories
   The checkout's repository is the one its origin remote names (git remote get-url origin), matched
   against repos. --repo <slug> or BREAKAWAY_REPO=<slug> picks another, --all shows every repository
@@ -792,11 +818,13 @@ const commands = {
     if (sub === 'new') {
       const decision = typeof opts.decision === 'string' ? opts.decision : null;
       const next = typeof opts.next === 'string' ? opts.next : null;
+      const spec = typeof opts.spec === 'string' ? opts.spec : null;
       const built = generalAgentRequest(args.slice(1).join(' '), {
         // From a decision, the board runs it in the decision's repository unless --repo says otherwise.
         repo: opts.repo ?? (decision ? null : (await checkoutRepo()).slug),
         decision,
         next,
+        spec,
         force: Boolean(opts.force),
         by: opts.as ?? setting('AGENT'),
       });
@@ -809,7 +837,7 @@ const commands = {
         const image = await upload(ref(answer.task), file);
         if (!opts.json) console.log(`Attached ${image.name} (${Math.ceil(image.size / 1024)} KB).`);
       }
-      print(answer, (d) => generalAgentSummary(d, { next }));
+      print(answer, (d) => generalAgentSummary(d, { next, spec }));
       return;
     }
     if (sub === 'start') {
@@ -935,9 +963,14 @@ const commands = {
     if (sub === 'modify') {
       const slug = need(args[1], 'repository');
       const change = fields();
+      const routineFlags =
+        opts['agents-max'] !== undefined || opts['agents-hourly'] !== undefined || opts.prompt !== undefined;
+      const current =
+        routineFlags || opts.specs !== undefined
+          ? (await call('GET', 'repos')).repos.find((r) => r.slug === slug.toLowerCase())
+          : null;
       // Its caps on agents, under the board's shared limits, and where its agent prompt is (CLD-127): kept with the rest of its routine settings.
-      if (opts['agents-max'] !== undefined || opts['agents-hourly'] !== undefined || opts.prompt !== undefined) {
-        const current = (await call('GET', 'repos')).repos.find((r) => r.slug === slug.toLowerCase());
+      if (routineFlags) {
         const routine = { ...current?.routine };
         for (const [flag, key] of [
           ['agents-max', 'max'],
@@ -948,6 +981,9 @@ const commands = {
         if (opts.prompt !== undefined) routine.prompt = opts.prompt === 'none' ? null : String(opts.prompt);
         change.routine = routine;
       }
+      // Where its specs are (IDEA-31), kept with the rest of its settings; none goes back to docs/specs.
+      if (opts.specs !== undefined)
+        change.settings = { ...current?.settings, specs: opts.specs === 'none' ? null : String(opts.specs) };
       // Its deploy pipeline (BRK-44): a JSON file, or none to clear it; the board refuses one it couldn't use, with the reason.
       if (opts.pipeline !== undefined) {
         if (opts.pipeline === 'none') change.pipeline = null;
@@ -1080,6 +1116,17 @@ const commands = {
       ].join('\n'),
     );
   },
+  async specs() {
+    // A repository's specs (IDEA-31), read from its default branch on GitHub: the checkout's unless --repo names another.
+    const { slug } = await checkoutRepo();
+    if (args[0] === 'show') {
+      const built = specRequest(args.slice(1).join(' ') || undefined, slug);
+      if (built.error || !built.request) fail(built.error ?? 'bad request');
+      print(await call(...built.request), (d) => specLines(d).join('\n'));
+      return;
+    }
+    print(await call(...specsRequest(slug)), (d) => specListLines(d).join('\n'));
+  },
   async features() {
     const sub = args[0];
     const body = () =>
@@ -1381,6 +1428,20 @@ const commands = {
       print(answer, (a) => pullAgentSummary(action, args[1].replace(/^#/u, ''), a));
       return;
     }
+    if (action === 'release') {
+      const built = packageReleaseRequest(args[1], {
+        repo: (await checkoutRepo()).slug,
+        by: opts.as ?? setting('AGENT'),
+      });
+      if (built.error || !built.request) fail(built.error ?? 'bad request');
+      const answer = await call(...built.request);
+      print(
+        answer,
+        () =>
+          `Started ${answer.workflow}'s stable job for ${args[1]}. It stages the stable on npm's latest, where it waits for your approval with 2FA.`,
+      );
+      return;
+    }
     const g = await call(...githubRequest((await checkoutRepo()).slug, { sync: Boolean(opts.sync) }));
     print(g, (d) => {
       if (!d.connected) return "GitHub isn't connected yet: open the GitHub view on the board (docs/tasks.md#github).";
@@ -1742,7 +1803,7 @@ async function refreshMachineTaskrc() {
 
 /**
  * repos init (CLD-191): clone the registered repository `slug` (or use the checkout at --dir), add the files
- * the board's agents need (scripts/tasks/init.js says which; nothing that's there is overwritten), and push
+ * the board's agents need (src/init.js says which; nothing that's there is overwritten), and push
  * them: the first commit on the default branch of an empty repository, or a pull request otherwise.
  */
 async function initRepo(slug) {
@@ -1894,7 +1955,8 @@ async function initRepo(slug) {
       `git add failed in ${dir}: ${String(e.stderr || e.message).trim()}. Nothing was committed. Fix that, then run repos init again (it leaves what's there alone), or use git checkout ${repo.defaultBranch || 'main'} && git branch -D ${work} to start over.`,
     );
   }
-  const title = update ? "Update the task board's agent files" : "Set up the task board's agent files";
+  const first = initCommitMessage(repo.slug);
+  const title = update ? "Update the task board's agent files" : first.title;
   git(
     'commit',
     '-m',
@@ -1902,7 +1964,7 @@ async function initRepo(slug) {
     '-m',
     update
       ? `The board's core, skill, release helpers, and Taskwarrior files as they are in ${board ?? 'breakaway'} now, and the session hooks run through npx, so an old copy of the CLI is removed: run it as npx ${CLI_PACKAGE} (CLI version ${CLI_VERSION}). This repository's own files are unchanged. Updated by npx ${CLI_PACKAGE} repos init ${repo.slug} --update.`
-      : `What a board-started agent needs to claim and work a task here: the agent prompt, the board's core, the session hooks (they run the CLI through npx), the tasks skill, AGENTS.md, and Taskwarrior with direnv. Added by npx breakaway repos init ${repo.slug}.`,
+      : first.body,
   );
   const pushed = spawnSync('git', ['-C', dir, 'push', '-u', 'origin', empty ? `HEAD:refs/heads/${branch}` : work], {
     stdio: 'inherit',
@@ -2122,6 +2184,9 @@ if (opts.help || command === 'help') {
 } else if (command === 'install') {
   // An install repository's own steps (BRK-9): they need no board, so they run before the board's address is checked.
   await (await import('./install/cli.js')).run(args, opts);
+} else if (command === 'pipeline') {
+  // A repository's deploy and release workflows (BRK-90): rendered from its own config, so they need no board either.
+  process.exitCode = (await import('./tasks/pipeline.js')).run(args, opts);
 } else if (!commands[command]) {
   fail(`no command "${command}". npx breakaway help lists them.`);
 } else if (!BASE && command !== 'init-secrets') {

package/src/cli-version.js

@@ -4,5 +4,5 @@
  * and how to update it. scripts/tasks/version.test.js fails when the copied files change and this doesn't:
  * so it lives in the board's package (CLD-135) and the CLI imports it from here.
  */
-export const CLI_VERSION = 63;
-export const CLI_FINGERPRINT = '4e27258ce14d0ac7';
+export const CLI_VERSION = 69;
+export const CLI_FINGERPRINT = 'd7528500bc5e5a4c';