@nyxa/nyx-agent 0.6.0 → 0.6.1

package/README.md

@@ -7,7 +7,8 @@ GitHub issue at a time, each phase with fresh context.
 
 For every run NyxAgent:
 
-1. **Selects** open GitHub issues to work on (read-only).
+1. **Selects** open GitHub issues to work on (read-only), then asks the user to
+   confirm the proposed checklist.
 2. For each selected issue, in an isolated git **worktree**:
    - **implements** it (the agent — the only customizable prompt),
    - optionally **reviews** and **revises** it (bounded loop),
@@ -27,7 +28,8 @@ is editable.
 
 ```bash
 nyxagent init                 # create .nyxagent/config.json (interactive)
-nyxagent run                  # run the pipeline
+nyxagent run                  # run the pipeline, confirming selected work items
+nyxagent run --yes            # accept the agent selection without prompting
 nyxagent run --harness claude # override the configured harness for one run
 nyxagent update               # self-update to the latest published version
 ```
@@ -63,3 +65,4 @@ unresolved feedback, so the work is never stranded on an orphaned branch.
 - A git repository with a GitHub remote.
 - The `gh` CLI authenticated for the configured repository.
 - The selected harness CLI (`codex` or `claude`) on `PATH`.
+- An interactive terminal for `nyxagent run`, unless `--yes` is used.

package/dist/cli.js

@@ -33,6 +33,7 @@ program
     .description("Run the NyxAgent pipeline")
     .option("--config <path>", "config path (default: .nyxagent/config.json)")
     .option("--harness <name>", "override the configured harness: codex or claude")
+    .option("-y, --yes", "accept the agent-selected work items without prompting")
     .action(async (options) => {
     await runCommand(options);
 });

package/dist/commands/run.js

@@ -8,7 +8,8 @@ export async function runCommand(options, projectRoot = process.cwd()) {
         configPath: options.config
             ? path.resolve(projectRoot, options.config)
             : undefined,
-        harness: normalizeHarness(options.harness)
+        harness: normalizeHarness(options.harness),
+        autoAcceptSelection: options.yes ?? false
     });
 }
 function normalizeHarness(value) {

package/dist/runtime/runPipeline.js

@@ -9,6 +9,7 @@ import { buildContextBlock, buildPhasePrompt, EXECUTION_PROMPT, GLOBAL_REVIEW_PR
 import { runAgentPhase } from "./runPhase.js";
 import { GLOBAL_REVIEW_SCHEMA, REVIEW_SCHEMA, SELECTION_SCHEMA } from "./schemas.js";
 import { commitAll, commitsAhead, createPullRequest, pushBranch, rangeDiff, stageAllAndDiff } from "./scm.js";
+import { confirmWorkItemSelection } from "./selectionConfirmation.js";
 import { createRunId } from "./time.js";
 import { filterAvailable, listGitHubIssues, resolveSelectedQueue } from "./workItems.js";
 const MAX_CANDIDATES = 50;
@@ -18,7 +19,8 @@ export function defaultPipelineDependencies() {
         listIssues: listGitHubIssues,
         runPhase: runAgentPhase,
         pushBranch,
-        createPullRequest
+        createPullRequest,
+        confirmSelection: confirmWorkItemSelection
     };
 }
 /**
@@ -55,7 +57,7 @@ export async function runPipeline(input = {}, deps = defaultPipelineDependencies
         console.log("No open work items available. Nothing to do.");
         return;
     }
-    const selected = await runSelection({
+    const proposed = await runSelection({
         projectRoot,
         runDir,
         harness,
@@ -63,10 +65,20 @@ export async function runPipeline(input = {}, deps = defaultPipelineDependencies
         candidates,
         runPhase: deps.runPhase
     });
-    if (selected.length === 0) {
+    if (proposed.length === 0) {
         console.log("Selection chose no work items. Nothing to do.");
         return;
     }
+    const selected = await deps.confirmSelection({
+        candidates,
+        proposed,
+        maxItems: config.max_iterations,
+        autoAccept: input.autoAcceptSelection ?? false
+    });
+    if (selected.length === 0) {
+        console.log("No work items selected. Nothing to do.");
+        return;
+    }
     const planned = selected.slice(0, config.max_iterations);
     console.log(`Selected ${planned.length} work item(s):`);
     for (const item of planned) {

package/dist/runtime/selectionConfirmation.js

@@ -0,0 +1,85 @@
+import { checkbox, Separator } from "@inquirer/prompts";
+export async function confirmWorkItemSelection(input) {
+    if (input.autoAccept) {
+        return input.proposed;
+    }
+    const isInteractive = input.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    if (!isInteractive) {
+        throw new Error('Interactive work item selection requires a TTY. Re-run with "nyxagent run --yes" to accept the agent selection.');
+    }
+    const selectedKeys = await checkbox({
+        message: `Select work items to run (max ${input.maxItems})`,
+        choices: buildSelectionChoiceItems(input).map(toInquirerChoice),
+        pageSize: Math.min(Math.max(input.candidates.length, 7), 20),
+        required: false,
+        validate: (selected) => selected.length <= input.maxItems ||
+            `Select at most ${input.maxItems} work item(s).`,
+        shortcuts: {
+            all: null,
+            invert: null
+        }
+    });
+    const selected = new Set(selectedKeys);
+    return input.candidates.filter((candidate) => selected.has(candidate.key));
+}
+export function buildSelectionChoiceItems(input) {
+    const proposedKeys = new Set(input.proposed.map((item) => item.key));
+    const items = [];
+    let currentGroup;
+    for (const candidate of input.candidates) {
+        const group = detectPlanGroup(candidate);
+        if (group && group !== currentGroup) {
+            items.push({ type: "separator", label: group });
+        }
+        currentGroup = group;
+        const proposed = proposedKeys.has(candidate.key);
+        items.push({
+            type: "choice",
+            value: candidate.key,
+            name: `#${candidate.number} ${candidate.title}${proposed ? " (agent)" : ""}`,
+            checked: proposed
+        });
+    }
+    return items;
+}
+function toInquirerChoice(item) {
+    if (item.type === "separator") {
+        return new Separator(item.label);
+    }
+    return {
+        value: item.value,
+        name: item.name,
+        checked: item.checked
+    };
+}
+function detectPlanGroup(candidate) {
+    for (const label of candidate.labels ?? []) {
+        const group = parseGroupLabel(label);
+        if (group) {
+            return group;
+        }
+    }
+    return parseBracketedTitleGroup(candidate.title);
+}
+function parseGroupLabel(label) {
+    const match = /^(plan|prd)\s*[:/=-]\s*(.+)$/i.exec(label.trim());
+    if (!match) {
+        return undefined;
+    }
+    return formatGroupLabel(match[1], match[2]);
+}
+function parseBracketedTitleGroup(title) {
+    const match = /^\[(plan|prd)\s*[:/=-]\s*([^\]]+)\]/i.exec(title.trim());
+    if (!match) {
+        return undefined;
+    }
+    return formatGroupLabel(match[1], match[2]);
+}
+function formatGroupLabel(kind, rawName) {
+    const name = rawName.trim();
+    if (!name) {
+        return undefined;
+    }
+    const prefix = kind.toLowerCase() === "prd" ? "PRD" : "Plan";
+    return `${prefix}: ${name}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyxa/nyx-agent",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "A lightweight phase orchestrator for repeatedly launching coding agents with fresh context.",
   "type": "module",
   "repository": {