@nyxa/nyx-agent 0.4.1 → 0.5.0

package/templates/default/prompts/closure.md

@@ -1,30 +0,0 @@
-Close the selected work item now that its implementation is complete.
-
-Before committing or closing anything, inspect the current diff and `git status`.
-If a per-task review ran this iteration (`phase_results.review` in the runtime
-state), it already approved the work — the workflow only routes to closure after an
-approval, so there is no need to re-confirm it. If no review phase ran (the workflow
-may use a global end-of-run review, or no review at all), run a lightweight final
-validation yourself when it is cheap and relevant. A missing review phase is expected
-in those modes and is not a reason to block closure.
-
-Commit only the selected work item's changes, using the project's commit message
-conventions.
-
-Then close the work item according to its source (see `work_item` in the runtime
-state):
-
-- GitHub issue (`work_item.source.type` is `"github"`, locator is `owner/repo#<number>`):
-  run `gh issue close <number> --repo <owner/repo>`. Add `--comment "<short note>"`
-  when it helps. This step needs network access; the closure phase is configured for it.
-- Local file (`work_item.source.type` is `"local"`): mark it done following the
-  project's convention for finished work.
-
-Report the outcome in the structured result:
-
-- `closed` when the commit succeeded and the issue/work item was actually closed.
-  Set `committed` and `issue_closed` to reflect what truly happened.
-- `failed` only when something genuinely blocked closure (e.g. `gh issue close`
-  errored, or the diff does not apply). Explain what remains in `summary`. Do not
-  report `failed` merely because no review phase ran. Do not pretend the item is
-  closed when it is not — a `failed` outcome stops the run so the problem is visible.

package/templates/default/prompts/execution.md

@@ -1,11 +0,0 @@
-Implement the selected work item.
-
-Work only on the selected item from the runtime state. Keep changes focused.
-Use a red-green-refactor loop when practical:
-
-1. Reproduce or cover the expected behavior with a focused test.
-2. Implement the smallest coherent change.
-3. Run targeted validation and tidy the result.
-
-Do not commit. Do not close or mark the work item done. Leave clear validation
-evidence in your final response.

package/templates/default/prompts/finalize.md

@@ -1,7 +0,0 @@
-The global review approved the run. Finalize without making any further changes.
-
-Stay read-only. Do not modify project files; all work is already implemented,
-committed, and closed.
-
-Summarize the completed work items (`completed_work_item_keys` and
-`selected_work_item_queue` in the runtime state) and confirm the run is complete.

package/templates/default/prompts/global-review.md

@@ -1,24 +0,0 @@
-Review the entire run (the whole PRD) now that every selected work item has been
-implemented and closed.
-
-Stay read-only. Do not modify project files.
-
-Assess the work as a whole, focusing on cross-cutting concerns a per-task review
-cannot see:
-
-- coherence and integration across all completed work items
-- regressions or conflicts introduced between items
-- overall architecture and design consistency
-- gaps against the original intent of the selected work items
-- security or data-safety concerns spanning the changes
-
-Inspect the combined set of changes. When a run branch is configured, review the
-full diff (e.g. `git diff {{git.base}}...HEAD`). The completed items are in
-`completed_work_item_keys` and `selected_work_item_queue` in the runtime state.
-
-Return one of these outcomes:
-
-- `approved`: the run as a whole is ready to finalize
-- `changes_requested`: include concrete `required_changes` for the correction phase
-
-Keep the review concise and actionable.

package/templates/default/prompts/global-revision.md

@@ -1,9 +0,0 @@
-Apply the changes requested by the global review of the whole run.
-
-Address the required changes recorded under `phase_results.global_review` in the
-current state. Keep changes focused on exactly what the global review asked for,
-across whichever work items are affected.
-
-Commit your corrections using the project's commit message conventions, so they are
-included in the run branch and the pull request. Do not reopen or re-close work
-items; they are already closed by the closure phase.

package/templates/default/prompts/pull-request.md

@@ -1,23 +0,0 @@
-Open a single pull request for all the work completed in this run (the PRD).
-
-You are on the run branch `{{git.branch}}`, based on `{{git.base}}`. When a worktree is
-configured, your working directory is the isolated worktree. All selected work items are
-already implemented, committed, and their GitHub issues are already closed by the
-closure phase. Your job is only to publish the branch and open the PR.
-
-Steps:
-
-1. Confirm the branch has commits ahead of the base: `git log --oneline {{git.base}}..HEAD`.
-2. Push the branch: `git push -u origin {{git.branch}}`.
-3. Open the pull request with gh:
-   `gh pr create --base {{git.base}} --head {{git.branch}} --title "<concise PRD title>" --body "<summary>"`.
-   Derive the title and body from the completed work items in the runtime state
-   (`selected_work_item_queue` / `completed_work_item_keys`). Reference the issues that
-   were addressed (e.g. "#12, #34") in the body so the PR documents the PRD.
-
-This phase needs network access; it is configured for it.
-
-Report the outcome in the structured result:
-
-- `pr_opened` with `pr_url` set to the created pull request URL.
-- `failed` with `summary` describing what blocked the PR (e.g. push rejected, no remote).

package/templates/default/prompts/repair-result.md

@@ -1,29 +0,0 @@
-The previous phase attempt completed, but NyxAgent could not parse or validate
-its structured result.
-
-Validation error:
-
-```text
-{{validation_error}}
-```
-
-Original phase prompt:
-
-```md
-{{original_prompt}}
-```
-
-Original stdout:
-
-```text
-{{original_stdout}}
-```
-
-Original stderr:
-
-```text
-{{original_stderr}}
-```
-
-Reconstruct the intended structured result from the transcript. Return only the
-final `<nyxagent_result>` block. Do not redo the phase work.

package/templates/default/prompts/review.md

@@ -1,18 +0,0 @@
-Review the implementation for the selected work item.
-
-Stay read-only. Do not modify project files.
-
-Focus on:
-
-- alignment with the selected work item
-- correctness and regression risk
-- tests or validation evidence
-- design and architecture fit
-- security or data-safety concerns
-
-Return one of these outcomes:
-
-- `approved`: the work is ready for closure
-- `changes_requested`: include concrete required changes
-
-Keep the review concise and actionable.

package/templates/default/prompts/revision.md

@@ -1,7 +0,0 @@
-Apply the changes requested by the review for the selected work item.
-
-Address the required changes recorded under `phase_results.review` in the current
-state. Keep changes focused on exactly what the review asked for.
-
-Do not commit. Do not close or mark the work item done. Leave clear validation
-evidence in your final response.

package/templates/default/prompts/selection.md

@@ -1,46 +0,0 @@
-Recommend the ordered work item queue for this run.
-
-Use `available_work_items` from the runtime contract as the complete inventory
-for selection. Some candidates may be plans, PRDs, or concrete tasks.
-Recommend the most actionable queue for this run, up to
-`workflow.max_iterations` items. NyxAgent will show the complete inventory to
-the user afterward with your recommendation pre-selected.
-
-If candidates appear to belong together, use `selection_groups` to describe the
-most useful review grouping. Infer grouping from titles, paths, excerpts, and
-declared relationships when available, but do not assume every project uses
-plan/PRD subdirectories. Groups may include any key from `available_work_items`,
-including items that are not part of your recommended `work_items` queue.
-
-When useful, include `work_item_annotations` to label available items for user
-review. Each annotation should include `key` and `kind`. Use `kind` values:
-`task`, `plan`, `prd`, or `work`. Use `work` when you are not sure. You may
-annotate items that are not in the recommended `work_items` queue.
-
-Prefer concrete tasks over their parent plan when both are present and the task
-is ready to execute. Choose the plan itself only when it is the best next work.
-If no candidate is exploitable, return `no_work`.
-
-Do not choose any key listed in `seen_work_item_keys` or
-`completed_work_item_keys`. Every selected work item must be copied from
-`available_work_items`; do not invent keys.
-
-The selected work item identities must match the inventory entries:
-
-- local: `source.type` is `local`, `source.locator` is the project-relative
-  markdown path, and `key` is `local:<source.locator>`.
-- github: `source.type` is `github`, `source.locator` is
-  `owner/repo#number` for the configured repository, and `key` is
-  `github:<source.locator>`.
-
-Return one of these outcomes:
-
-- `selected`: include recommended ordered `work_items`; optionally include
-  `selection_groups` with `title`, optional `kind`, and `work_item_keys`; and
-  optionally include `work_item_annotations` with `key` and `kind`
-- `no_work`: include a short `reason`
-
-For compatibility, `work_item` is still accepted for a single selected item, but
-new results should use `work_items`.
-
-Do not modify project files or task files during selection.

package/templates/default/schemas/closure.schema.json

@@ -1,35 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "required": ["outcome"],
-  "properties": {
-    "outcome": {
-      "type": "string",
-      "enum": ["closed", "failed"]
-    },
-    "committed": {
-      "type": "boolean"
-    },
-    "issue_closed": {
-      "type": "boolean"
-    },
-    "summary": {
-      "type": "string"
-    }
-  },
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "failed"
-          }
-        }
-      },
-      "then": {
-        "required": ["summary"]
-      }
-    }
-  ],
-  "additionalProperties": true
-}

package/templates/default/schemas/global-review.schema.json

@@ -1,60 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "required": ["outcome", "approved", "summary"],
-  "properties": {
-    "outcome": {
-      "type": "string",
-      "enum": ["approved", "changes_requested"]
-    },
-    "approved": {
-      "type": "boolean"
-    },
-    "summary": {
-      "type": "string",
-      "minLength": 1
-    },
-    "required_changes": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    }
-  },
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "approved"
-          }
-        }
-      },
-      "then": {
-        "properties": {
-          "approved": {
-            "const": true
-          }
-        }
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "changes_requested"
-          }
-        }
-      },
-      "then": {
-        "properties": {
-          "approved": {
-            "const": false
-          }
-        },
-        "required": ["required_changes"]
-      }
-    }
-  ],
-  "additionalProperties": true
-}

package/templates/default/schemas/pull-request.schema.json

@@ -1,44 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "required": ["outcome"],
-  "properties": {
-    "outcome": {
-      "type": "string",
-      "enum": ["pr_opened", "failed"]
-    },
-    "pr_url": {
-      "type": "string"
-    },
-    "summary": {
-      "type": "string"
-    }
-  },
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "pr_opened"
-          }
-        }
-      },
-      "then": {
-        "required": ["pr_url"]
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "failed"
-          }
-        }
-      },
-      "then": {
-        "required": ["summary"]
-      }
-    }
-  ],
-  "additionalProperties": true
-}

package/templates/default/schemas/review.schema.json

@@ -1,60 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "required": ["outcome", "approved", "summary"],
-  "properties": {
-    "outcome": {
-      "type": "string",
-      "enum": ["approved", "changes_requested"]
-    },
-    "approved": {
-      "type": "boolean"
-    },
-    "summary": {
-      "type": "string",
-      "minLength": 1
-    },
-    "required_changes": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    }
-  },
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "approved"
-          }
-        }
-      },
-      "then": {
-        "properties": {
-          "approved": {
-            "const": true
-          }
-        }
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "changes_requested"
-          }
-        }
-      },
-      "then": {
-        "properties": {
-          "approved": {
-            "const": false
-          }
-        },
-        "required": ["required_changes"]
-      }
-    }
-  ],
-  "additionalProperties": true
-}

package/templates/default/schemas/selection.schema.json

@@ -1,135 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "required": ["outcome"],
-  "$defs": {
-    "workItem": {
-      "type": "object",
-      "required": ["key", "title", "source"],
-      "properties": {
-        "key": {
-          "type": "string",
-          "minLength": 1
-        },
-        "title": {
-          "type": "string",
-          "minLength": 1
-        },
-        "source": {
-          "type": "object",
-          "required": ["type", "locator"],
-          "properties": {
-            "type": {
-              "type": "string",
-              "enum": ["local", "github"]
-            },
-            "locator": {
-              "type": "string",
-              "minLength": 1
-            }
-          },
-          "additionalProperties": true
-        },
-        "url": {
-          "type": "string"
-        }
-      },
-      "additionalProperties": true
-    }
-  },
-  "properties": {
-    "outcome": {
-      "type": "string",
-      "enum": ["selected", "no_work"]
-    },
-    "work_items": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "$ref": "#/$defs/workItem"
-      }
-    },
-    "work_item": {
-      "$ref": "#/$defs/workItem"
-    },
-    "selection_groups": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["title", "work_item_keys"],
-        "properties": {
-          "title": {
-            "type": "string",
-            "minLength": 1
-          },
-          "kind": {
-            "type": "string"
-          },
-          "work_item_keys": {
-            "type": "array",
-            "minItems": 1,
-            "items": {
-              "type": "string",
-              "minLength": 1
-            }
-          }
-        },
-        "additionalProperties": true
-      }
-    },
-    "work_item_annotations": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["key"],
-        "properties": {
-          "key": {
-            "type": "string",
-            "minLength": 1
-          },
-          "kind": {
-            "type": "string"
-          }
-        },
-        "additionalProperties": true
-      }
-    },
-    "reason": {
-      "type": "string"
-    }
-  },
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "selected"
-          }
-        }
-      },
-      "then": {
-        "anyOf": [
-          {
-            "required": ["work_items"]
-          },
-          {
-            "required": ["work_item"]
-          }
-        ]
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "outcome": {
-            "const": "no_work"
-          }
-        }
-      },
-      "then": {
-        "required": ["reason"]
-      }
-    }
-  ],
-  "additionalProperties": true
-}