@moreih29/nexus-core 0.12.0 → 0.14.0

package/conformance/state-schemas/agent-tracker.schema.json

@@ -1,63 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "conformance/state-schemas/agent-tracker.schema.json",
-  "title": "Nexus Agent Tracker",
-  "description": "Schema for .nexus/state/agent-tracker.json — registry of spawned agent instances tracked across a session. No schema_version field: this file is session-scoped and deleted on session end — migration anchor not required.",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "additionalProperties": false,
-    "required": ["harness_id", "started_at"],
-    "properties": {
-      "harness_id": {
-        "type": "string",
-        "pattern": "^[a-z][a-z0-9-]*$",
-        "description": "Identifier of the harness that spawned this agent."
-      },
-      "agent_name": {
-        "type": "string",
-        "pattern": "^[a-z][a-z0-9-]*$",
-        "description": "Neutral agent id as defined in nexus-core agents/{id}/meta.yml (e.g. 'architect', 'engineer')."
-      },
-      "agent_id": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Harness-specific opaque agent instance identifier. Format is defined by the writing harness (UUID, composite string, etc.). Consumers MUST treat the value as opaque — do not parse or infer agent identity across harness namespaces."
-      },
-      "started_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "ISO 8601 timestamp when this agent instance was first started"
-      },
-      "last_resumed_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "ISO 8601 timestamp of the most recent resume, if the agent has been resumed"
-      },
-      "resume_count": {
-        "type": "number",
-        "minimum": 0,
-        "description": "Number of times this agent instance has been resumed"
-      },
-      "status": {
-        "type": "string",
-        "enum": ["running", "completed"],
-        "description": "Current lifecycle status of the agent instance"
-      },
-      "stopped_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "ISO 8601 timestamp when the agent completed or was stopped"
-      },
-      "last_message": {
-        "type": "string",
-        "description": "Last recorded output or status message from the agent"
-      },
-      "files_touched": {
-        "type": "array",
-        "items": { "type": "string" },
-        "description": "Paths of files created or modified by this agent instance"
-      }
-    }
-  }
-}

package/conformance/state-schemas/history.schema.json

@@ -1,134 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "conformance/state-schemas/history.schema.json",
-  "title": "Nexus History",
-  "description": "Schema for .nexus/history.json — append-only log of completed plan/execution cycles",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["cycles"],
-  "properties": {
-    "schema_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+$",
-      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
-    },
-    "cycles": {
-      "type": "array",
-      "description": "Chronologically ordered list of completed execution cycles",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["completed_at", "branch", "plan", "tasks", "schema_version"],
-        "properties": {
-          "schema_version": {
-            "type": "string",
-            "pattern": "^\\d+\\.\\d+$",
-            "description": "Version tag recorded at the time this cycle was archived. Required for every cycle as history.json accumulates across nexus-core versions."
-          },
-          "completed_at": {
-            "type": "string",
-            "format": "date-time",
-            "description": "ISO 8601 timestamp when this cycle was closed"
-          },
-          "branch": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Git branch active during this cycle"
-          },
-          "plan": {
-            "oneOf": [
-              { "$ref": "#/$defs/planFile" },
-              { "type": "null" }
-            ],
-            "description": "Snapshot of the plan at cycle completion, or null if no plan was active"
-          },
-          "tasks": {
-            "type": "array",
-            "description": "Snapshot of all tasks at cycle completion",
-            "items": { "$ref": "#/$defs/task" }
-          }
-        }
-      }
-    }
-  },
-  "$defs": {
-    "planFile": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "topic", "issues", "created_at"],
-      "properties": {
-        "id": {
-          "type": "number",
-          "minimum": 1
-        },
-        "topic": {
-          "type": "string",
-          "minLength": 1
-        },
-        "issues": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["id", "title", "status"],
-            "properties": {
-              "id": { "type": "number", "minimum": 1 },
-              "title": { "type": "string", "minLength": 1 },
-              "status": { "type": "string", "enum": ["pending", "decided"] },
-              "decision": { "type": "string" },
-              "how_agents": {
-                "type": "array",
-                "items": { "type": "string" }
-              },
-              "how_summary": {
-                "type": "object",
-                "additionalProperties": { "type": "string" }
-              },
-              "how_agent_ids": {
-                "type": "object",
-                "additionalProperties": { "type": "string" }
-              }
-            }
-          }
-        },
-        "research_summary": { "type": "string" },
-        "created_at": {
-          "type": "string",
-          "format": "date-time"
-        }
-      }
-    },
-    "task": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "title", "context", "status", "deps"],
-      "properties": {
-        "id": { "type": "number", "minimum": 1 },
-        "title": { "type": "string", "minLength": 1 },
-        "context": { "type": "string", "minLength": 1 },
-        "approach": { "type": "string" },
-        "acceptance": { "type": "string" },
-        "risk": { "type": "string" },
-        "status": {
-          "type": "string",
-          "enum": ["pending", "in_progress", "completed"]
-        },
-        "deps": {
-          "type": "array",
-          "items": { "type": "number" }
-        },
-        "plan_issue": { "type": "number" },
-        "owner": { "type": "string" },
-        "owner_agent_id": { "type": "string" },
-        "owner_reuse_policy": {
-          "type": "string",
-          "enum": ["fresh", "resume_if_same_artifact", "resume"]
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date-time"
-        }
-      }
-    }
-  }
-}

package/conformance/state-schemas/memory-access.schema.json

@@ -1,36 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://moreih29/nexus-core/conformance/state-schemas/memory-access.schema.json",
-  "title": "Memory Access Record",
-  "description": "Schema for a single line in .nexus/state/{harness_id}/memory-access.jsonl — each JSONL line is a JSON object satisfying this schema. Upsert key is `path`.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["path", "last_accessed_ts", "access_count", "last_agent"],
-  "properties": {
-    "path": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Absolute path to the memory file that was read. Typically resolved under .nexus/memory/."
-    },
-    "last_accessed_ts": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp of the most recent read event for this file."
-    },
-    "access_count": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Cumulative count of read events observed for this file since tracking began in this harness."
-    },
-    "last_agent": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Opaque harness-specific identifier for the agent (or equivalent subject) that performed the most recent read."
-    },
-    "schema_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+$",
-      "description": "Optional migration anchor, aligned with other state schemas introduced in v0.5.0."
-    }
-  }
-}

package/conformance/state-schemas/plan.schema.json

@@ -1,77 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "conformance/state-schemas/plan.schema.json",
-  "title": "Nexus Plan State",
-  "description": "Schema for .nexus/state/plan.json — the active plan produced by nx-plan and consumed by MCP tools",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["id", "topic", "issues", "created_at"],
-  "properties": {
-    "schema_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+$",
-      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
-    },
-    "id": {
-      "type": "number",
-      "minimum": 1,
-      "description": "Monotonically increasing plan identifier"
-    },
-    "topic": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Human-readable topic or goal of this plan"
-    },
-    "issues": {
-      "type": "array",
-      "description": "Ordered list of issues analyzed during planning",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["id", "title", "status"],
-        "properties": {
-          "id": {
-            "type": "number",
-            "minimum": 1
-          },
-          "title": {
-            "type": "string",
-            "minLength": 1
-          },
-          "status": {
-            "type": "string",
-            "enum": ["pending", "decided"]
-          },
-          "decision": {
-            "type": "string",
-            "description": "The recorded decision; present when status is 'decided'"
-          },
-          "how_agents": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Agent types consulted for this issue"
-          },
-          "how_summary": {
-            "type": "object",
-            "additionalProperties": { "type": "string" },
-            "description": "Key/value map of per-agent analysis summaries"
-          },
-          "how_agent_ids": {
-            "type": "object",
-            "additionalProperties": { "type": "string" },
-            "description": "Key/value map of agent type to agent instance ID"
-          }
-        }
-      }
-    },
-    "research_summary": {
-      "type": "string",
-      "description": "Optional background research summary compiled during planning"
-    },
-    "created_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when this plan was created"
-    }
-  }
-}

package/conformance/state-schemas/tasks.schema.json

@@ -1,98 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "conformance/state-schemas/tasks.schema.json",
-  "title": "Nexus Tasks State",
-  "description": "Schema for .nexus/state/tasks.json — the task list produced by nx-plan and mutated by MCP tools during nx-run",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["goal", "decisions", "tasks"],
-  "properties": {
-    "schema_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+$",
-      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
-    },
-    "goal": {
-      "type": "string",
-      "minLength": 1,
-      "description": "High-level goal statement for the current execution cycle"
-    },
-    "decisions": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Key decisions carried forward from planning that constrain execution"
-    },
-    "tasks": {
-      "type": "array",
-      "description": "Ordered list of tasks to be executed",
-      "items": {
-        "$ref": "#/$defs/task"
-      }
-    }
-  },
-  "$defs": {
-    "task": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "title", "context", "status", "deps"],
-      "properties": {
-        "id": {
-          "type": "number",
-          "minimum": 1
-        },
-        "title": {
-          "type": "string",
-          "minLength": 1
-        },
-        "context": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Background context and motivation for this task"
-        },
-        "approach": {
-          "type": "string",
-          "description": "Implementation approach guidance"
-        },
-        "acceptance": {
-          "type": "string",
-          "description": "Acceptance criteria for task completion"
-        },
-        "risk": {
-          "type": "string",
-          "description": "Known risks or concerns"
-        },
-        "status": {
-          "type": "string",
-          "enum": ["pending", "in_progress", "completed"]
-        },
-        "deps": {
-          "type": "array",
-          "items": { "type": "number" },
-          "description": "Task IDs that must complete before this task can start"
-        },
-        "plan_issue": {
-          "type": "number",
-          "description": "ID of the plan issue that originated this task"
-        },
-        "owner": {
-          "type": "string",
-          "description": "Agent type assigned to own this task (e.g. 'engineer')"
-        },
-        "owner_agent_id": {
-          "type": "string",
-          "description": "Specific agent instance ID assigned to this task"
-        },
-        "owner_reuse_policy": {
-          "type": "string",
-          "enum": ["fresh", "resume_if_same_artifact", "resume"],
-          "description": "Policy controlling agent instance reuse across task executions"
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp when this task was created"
-        }
-      }
-    }
-  }
-}

package/conformance/tools/artifact-write.json

@@ -1,97 +0,0 @@
-[
-  {
-    "test_id": "artifact_write_first",
-    "description": "artifact_write creates the artifacts directory and writes the file when no artifacts directory exists, returning success:true and a path ending in the filename",
-    "covers": {
-      "return_value": {
-        "artifact_write": ["success", "path"]
-      }
-    },
-    "uncovered_params": ["filename", "content"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/artifacts/findings.md": null
-      }
-    },
-    "action": {
-      "tool": "artifact_write",
-      "params": {
-        "filename": "findings.md",
-        "content": "# Findings\n\nInitial research findings for the conformance test suite."
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.success": true,
-        "$.path": { "type": "string", "pattern": "findings\\.md$" }
-      },
-      "state_files": {
-        ".nexus/state/artifacts/findings.md": {}
-      }
-    }
-  },
-  {
-    "test_id": "artifact_write_overwrite",
-    "description": "artifact_write overwrites an existing artifact file and returns success:true without error",
-    "covers": {
-      "return_value": {
-        "artifact_write": ["success", "path"]
-      }
-    },
-    "uncovered_params": ["filename", "content"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/artifacts/existing.md": {
-          "content": "old content"
-        }
-      }
-    },
-    "action": {
-      "tool": "artifact_write",
-      "params": {
-        "filename": "existing.md",
-        "content": "new content"
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.success": true,
-        "$.path": { "type": "string", "pattern": "existing\\.md$" }
-      },
-      "state_files": {
-        ".nexus/state/artifacts/existing.md": {}
-      }
-    }
-  },
-  {
-    "test_id": "artifact_write_creates_directory",
-    "description": "artifact_write auto-creates the .nexus/state/artifacts/ directory when it does not exist and then writes the file successfully",
-    "covers": {
-      "return_value": {
-        "artifact_write": ["success", "path"]
-      }
-    },
-    "uncovered_params": ["filename", "content"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/artifacts/synthesis.md": null
-      }
-    },
-    "action": {
-      "tool": "artifact_write",
-      "params": {
-        "filename": "synthesis.md",
-        "content": "# Synthesis\n\nCross-cycle pattern analysis."
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.success": true,
-        "$.path": { "type": "string", "pattern": "synthesis\\.md$" }
-      },
-      "state_files": {
-        ".nexus/state/artifacts/synthesis.md": {}
-      }
-    }
-  }
-]

package/conformance/tools/context.json

@@ -1,172 +0,0 @@
-[
-  {
-    "test_id": "context_no_tasks",
-    "description": "context returns activeMode:null and an empty decisions array with a valid branch string when tasks.json does not exist",
-    "covers": {
-      "return_value": {
-        "context": ["activeMode", "branch", "decisions"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/tasks.json": null
-      }
-    },
-    "action": {
-      "tool": "context",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.activeMode": null,
-        "$.branch": { "type": "string", "minLength": 1 },
-        "$.decisions.length": 0
-      }
-    }
-  },
-  {
-    "test_id": "context_with_tasks",
-    "description": "context returns activeMode:team, the goal, and a tasksSummary with the correct total when tasks.json exists with a goal and 2 tasks",
-    "covers": {
-      "state_schemas": {
-        "tasks.schema.json": ["goal", "tasks[].id", "tasks[].status"]
-      },
-      "return_value": {
-        "context": ["activeMode", "goal", "tasksSummary.total", "tasksSummary.completed", "tasksSummary.pending"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/tasks.json": {
-          "goal": "Deliver conformance fixture suite",
-          "decisions": [],
-          "tasks": [
-            {
-              "id": 1,
-              "title": "Write fixture schema",
-              "context": "Define the JSON Schema",
-              "status": "completed",
-              "deps": [],
-              "created_at": "2026-04-13T00:00:00.000Z"
-            },
-            {
-              "id": 2,
-              "title": "Write tool fixtures",
-              "context": "Create per-tool fixture files",
-              "status": "pending",
-              "deps": [1],
-              "created_at": "2026-04-13T00:00:00.000Z"
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "context",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.activeMode": "team",
-        "$.goal": "Deliver conformance fixture suite",
-        "$.tasksSummary.total": 2
-      }
-    }
-  },
-  {
-    "test_id": "context_with_decisions",
-    "description": "context returns a decisions array with length 2 when decisions.json contains 2 entries alongside an active tasks.json",
-    "covers": {
-      "return_value": {
-        "context": ["decisions"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/tasks.json": {
-          "goal": "Deliver conformance fixture suite",
-          "decisions": [
-            "Use declarative JSONPath assertions for harness neutrality.",
-            "One tool per fixture file to keep scope bounded."
-          ],
-          "tasks": [
-            {
-              "id": 1,
-              "title": "Write fixture schema",
-              "context": "Define the JSON Schema",
-              "status": "completed",
-              "deps": [],
-              "created_at": "2026-04-13T00:00:00.000Z"
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "context",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.decisions.length": 2
-      }
-    }
-  },
-  {
-    "test_id": "context_tasks_summary_breakdown",
-    "description": "context computes tasksSummary correctly when the task list contains 1 completed, 1 pending, and 1 in_progress task",
-    "covers": {
-      "state_schemas": {
-        "tasks.schema.json": ["tasks[].status"]
-      },
-      "return_value": {
-        "context": ["tasksSummary.total", "tasksSummary.completed", "tasksSummary.pending"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/tasks.json": {
-          "goal": "Summary breakdown validation",
-          "decisions": [],
-          "tasks": [
-            {
-              "id": 1,
-              "title": "Done task",
-              "context": "Already finished",
-              "status": "completed",
-              "deps": [],
-              "created_at": "2026-04-13T00:00:00.000Z"
-            },
-            {
-              "id": 2,
-              "title": "Pending task",
-              "context": "Not yet started",
-              "status": "pending",
-              "deps": [],
-              "created_at": "2026-04-13T00:00:00.000Z"
-            },
-            {
-              "id": 3,
-              "title": "Active task",
-              "context": "Currently being worked on",
-              "status": "in_progress",
-              "deps": [],
-              "created_at": "2026-04-13T00:00:00.000Z"
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "context",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.tasksSummary.total": 3,
-        "$.tasksSummary.completed": 1,
-        "$.tasksSummary.pending": 1
-      }
-    }
-  }
-]