@nyxa/nyx-agent 0.3.3 → 0.3.5

package/dist/cli.js

@@ -17,7 +17,7 @@ program
     .option("--missing", "only add missing template files")
     .option("--harness <preset>", "harness preset: codex, claude, or custom")
     .option("--model <name>", "model name")
-    .option("--reasoning-level <level>", "harness-neutral reasoning level")
+    .option("--reasoning-level <level>", "default harness-neutral reasoning level")
     .option("--max-iterations <count>", "maximum work items per run")
     .option("--work-items-source <source>", "work item source template: local or github")
     .option("--work-items-path <path>", "local markdown work item directory")

package/dist/commands/init.js

@@ -6,6 +6,8 @@ import pc from "picocolors";
 import { ensureDir, pathExists, readText, writeText } from "../runtime/files.js";
 import { getNyxDir, relativeToProject } from "../runtime/paths.js";
 const DEFAULT_OPENAI_MODEL = "gpt-5.5";
+const GITIGNORE_MARKER = "# NyxAgent runtime artifacts";
+const GITIGNORE_ENTRIES = [".nyxagent/runs/", ".nyxagent/state.json"];
 export async function initCommand(options, projectRoot = process.cwd()) {
     const root = path.resolve(projectRoot);
     const nyxDir = getNyxDir(root);
@@ -21,6 +23,7 @@ export async function initCommand(options, projectRoot = process.cwd()) {
     await ensureDir(nyxDir);
     const templatesDir = getTemplatesDir();
     await copyTemplateTree(templatesDir, nyxDir, Boolean(options.missing));
+    await ensureGitignoreEntries(root);
     if (resolved) {
         await writeText(configPath, buildConfigToml(resolved));
     }
@@ -47,7 +50,7 @@ async function resolveInitOptions(options, root) {
         }));
     const reasoningLevel = options.reasoningLevel ??
         (await input({
-            message: "Reasoning level",
+            message: "Default reasoning level",
             default: "medium"
         }));
     const parsedMaxIterations = options.maxIterations
@@ -146,6 +149,45 @@ async function ensureWorkItemsDirectory(root, taskPath) {
         throw new Error(`Work item path is not a directory: ${taskPath}`);
     }
 }
+async function ensureGitignoreEntries(root) {
+    const gitignorePath = path.join(root, ".gitignore");
+    const current = (await pathExists(gitignorePath))
+        ? await readText(gitignorePath)
+        : "";
+    const lines = current.split(/\r?\n/);
+    const existingEntries = new Set(lines.map((line) => line.trim()));
+    const missingEntries = GITIGNORE_ENTRIES.filter((entry) => !existingEntries.has(entry));
+    if (missingEntries.length === 0) {
+        return;
+    }
+    const markerIndex = lines.findIndex((line) => line.trim() === GITIGNORE_MARKER);
+    let updated;
+    if (markerIndex >= 0) {
+        const nextLines = [...lines];
+        nextLines.splice(markerIndex + 1, 0, ...missingEntries);
+        updated = normalizeGitignoreContent(nextLines.join("\n"));
+    }
+    else {
+        const prefix = getGitignoreAppendPrefix(current);
+        updated = `${current}${prefix}${GITIGNORE_MARKER}\n${missingEntries.join("\n")}\n`;
+    }
+    await writeText(gitignorePath, updated);
+}
+function getGitignoreAppendPrefix(current) {
+    if (current.length === 0) {
+        return "";
+    }
+    if (current.endsWith("\n\n")) {
+        return "";
+    }
+    if (current.endsWith("\n")) {
+        return "\n";
+    }
+    return "\n\n";
+}
+function normalizeGitignoreContent(value) {
+    return `${value.replace(/\n*$/, "")}\n`;
+}
 function buildConfigToml(options) {
     const harness = buildHarnessToml(options.harness);
     const workItems = buildWorkItemsToml(options);
@@ -185,9 +227,6 @@ prompt = "prompts/execution.md"
 next = "review"
 max_visits_per_iteration = 3
 
-[phases.model]
-reasoning_level = "high"
-
 [[phases]]
 id = "review"
 prompt = "prompts/review.md"
@@ -195,9 +234,6 @@ output_schema = "schemas/review.schema.json"
 required_output = true
 max_visits_per_iteration = 3
 
-[phases.model]
-reasoning_level = "high"
-
 [phases.harness]
 args = ${formatTomlArray(buildReadOnlyArgs(options.harness))}
 

package/docs/nyxagent-v0-spec.md

@@ -137,9 +137,6 @@ prompt = "prompts/execution.md"
 next = "review"
 max_visits_per_iteration = 3
 
-[phases.model]
-reasoning_level = "high"
-
 [[phases]]
 id = "review"
 prompt = "prompts/review.md"
@@ -147,9 +144,6 @@ output_schema = "schemas/review.schema.json"
 required_output = true
 max_visits_per_iteration = 3
 
-[phases.model]
-reasoning_level = "high"
-
 [phases.harness]
 args = [
   "exec",
@@ -178,7 +172,11 @@ max_visits_per_iteration = 1
   item.
 - `model.reasoning_level` is a harness-neutral string.
 - Harness args are declarative and may interpolate config/runtime variables.
-- Per-phase `model` and `harness` blocks override global values.
+- Per-phase `model` and `harness` blocks override global values when explicitly
+  declared.
+- The initial selection phase is declared in `[[phases]]`, but the runtime treats
+  `workflow.entry_phase` as the selection step and expects the selection result
+  contract.
 - `work_items` supports only `local` and `github` in v0.
 - `work_items.max_candidates` defaults to `50` and caps the inventory sent to
   the initial selection prompt.

package/package.json

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