@moreih29/nexus-core 0.11.0 → 0.13.0

package/conformance/tools/history-search.json

@@ -1,219 +0,0 @@
-[
-  {
-    "test_id": "history_search_no_history_file",
-    "description": "history_search returns empty results with total:0 and showing:0 when history.json does not exist",
-    "covers": {
-      "return_value": {
-        "history_search": ["total", "showing", "cycles"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/history.json": null
-      }
-    },
-    "action": {
-      "tool": "history_search",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.total": 0,
-        "$.showing": 0,
-        "$.cycles.length": 0
-      }
-    }
-  },
-  {
-    "test_id": "history_search_no_query",
-    "description": "history_search with no query or last_n returns all cycles when history.json contains 3 cycles",
-    "covers": {
-      "return_value": {
-        "history_search": ["total", "showing", "cycles", "cycles[].completed_at", "cycles[].branch", "cycles[].topic", "cycles[].task_count"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/history.json": {
-          "cycles": [
-            {
-              "completed_at": "2026-04-10T10:00:00.000Z",
-              "branch": "main",
-              "plan": { "id": 1, "topic": "Initial setup", "issues": [], "created_at": "2026-04-10T09:00:00.000Z" },
-              "tasks": [
-                { "id": 1, "title": "Bootstrap project", "context": "Setup", "status": "completed", "deps": [] }
-              ]
-            },
-            {
-              "completed_at": "2026-04-11T10:00:00.000Z",
-              "branch": "feature/state",
-              "plan": { "id": 2, "topic": "Refactor state layer", "issues": [], "created_at": "2026-04-11T09:00:00.000Z" },
-              "tasks": [
-                { "id": 1, "title": "Decouple state access", "context": "Refactor", "status": "completed", "deps": [] },
-                { "id": 2, "title": "Add state schema", "context": "Schema", "status": "completed", "deps": [] }
-              ]
-            },
-            {
-              "completed_at": "2026-04-12T10:00:00.000Z",
-              "branch": "feature/conformance",
-              "plan": { "id": 3, "topic": "Conformance fixtures", "issues": [], "created_at": "2026-04-12T09:00:00.000Z" },
-              "tasks": [
-                { "id": 1, "title": "Write fixture schema", "context": "Schema", "status": "completed", "deps": [] }
-              ]
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "history_search",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.total": 3,
-        "$.showing": 3,
-        "$.cycles.length": 3
-      }
-    }
-  },
-  {
-    "test_id": "history_search_query_match",
-    "description": "history_search matches cycles case-insensitively when the query term appears in the cycle JSON, returning at least one result for query 'STATE'",
-    "covers": {
-      "return_value": {
-        "history_search": ["total", "showing", "cycles", "cycles[].topic"]
-      }
-    },
-    "uncovered_params": ["query"],
-    "precondition": {
-      "state_files": {
-        ".nexus/history.json": {
-          "cycles": [
-            {
-              "completed_at": "2026-04-11T10:00:00.000Z",
-              "branch": "feature/state",
-              "plan": { "id": 2, "topic": "Refactor state layer", "issues": [], "created_at": "2026-04-11T09:00:00.000Z" },
-              "tasks": []
-            },
-            {
-              "completed_at": "2026-04-12T10:00:00.000Z",
-              "branch": "feature/conformance",
-              "plan": { "id": 3, "topic": "Conformance fixtures", "issues": [], "created_at": "2026-04-12T09:00:00.000Z" },
-              "tasks": []
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "history_search",
-      "params": {
-        "query": "STATE"
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.total": { "type": "number", "min": 1 },
-        "$.cycles.length": { "type": "number", "min": 1 }
-      }
-    }
-  },
-  {
-    "test_id": "history_search_query_no_match",
-    "description": "history_search returns total:0 and an empty cycles array when the query term matches no cycles in history.json",
-    "covers": {
-      "return_value": {
-        "history_search": ["total", "showing", "cycles"]
-      }
-    },
-    "uncovered_params": ["query"],
-    "precondition": {
-      "state_files": {
-        ".nexus/history.json": {
-          "cycles": [
-            {
-              "completed_at": "2026-04-11T10:00:00.000Z",
-              "branch": "feature/state",
-              "plan": { "id": 2, "topic": "Refactor state layer", "issues": [], "created_at": "2026-04-11T09:00:00.000Z" },
-              "tasks": []
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "history_search",
-      "params": {
-        "query": "nonexistent-xyz"
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.total": 0,
-        "$.cycles.length": 0
-      }
-    }
-  },
-  {
-    "test_id": "history_search_last_n_limit",
-    "description": "history_search with last_n:2 returns only the 2 most recent cycles while reporting the full total of matching cycles",
-    "covers": {
-      "return_value": {
-        "history_search": ["total", "showing", "cycles"]
-      }
-    },
-    "uncovered_params": ["last_n"],
-    "precondition": {
-      "state_files": {
-        ".nexus/history.json": {
-          "cycles": [
-            {
-              "completed_at": "2026-04-08T10:00:00.000Z",
-              "branch": "main",
-              "plan": { "id": 1, "topic": "Cycle 1", "issues": [], "created_at": "2026-04-08T09:00:00.000Z" },
-              "tasks": []
-            },
-            {
-              "completed_at": "2026-04-09T10:00:00.000Z",
-              "branch": "main",
-              "plan": { "id": 2, "topic": "Cycle 2", "issues": [], "created_at": "2026-04-09T09:00:00.000Z" },
-              "tasks": []
-            },
-            {
-              "completed_at": "2026-04-10T10:00:00.000Z",
-              "branch": "main",
-              "plan": { "id": 3, "topic": "Cycle 3", "issues": [], "created_at": "2026-04-10T09:00:00.000Z" },
-              "tasks": []
-            },
-            {
-              "completed_at": "2026-04-11T10:00:00.000Z",
-              "branch": "main",
-              "plan": { "id": 4, "topic": "Cycle 4", "issues": [], "created_at": "2026-04-11T09:00:00.000Z" },
-              "tasks": []
-            },
-            {
-              "completed_at": "2026-04-12T10:00:00.000Z",
-              "branch": "main",
-              "plan": { "id": 5, "topic": "Cycle 5", "issues": [], "created_at": "2026-04-12T09:00:00.000Z" },
-              "tasks": []
-            }
-          ]
-        }
-      }
-    },
-    "action": {
-      "tool": "history_search",
-      "params": {
-        "last_n": 2
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.total": 5,
-        "$.showing": 2,
-        "$.cycles.length": 2
-      }
-    }
-  }
-]

package/conformance/tools/plan-decide.json

@@ -1,139 +0,0 @@
-[
-  {
-    "test_id": "plan_decide_happy_path",
-    "description": "plan_decide marks an issue as decided and records the decision text on the issue object",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": ["issues[].status", "issues[].decision"]
-      },
-      "return_value": {
-        "plan_decide": ["decided", "allComplete", "remaining"]
-      }
-    },
-    "uncovered_params": ["issue_id", "decision"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "id": 1,
-          "topic": "Introduce conformance test fixtures",
-          "issues": [
-            {
-              "id": 1,
-              "title": "What fixture format best supports harness-neutral assertions?",
-              "status": "pending"
-            },
-            {
-              "id": 2,
-              "title": "Which tools should be covered in the MVP?",
-              "status": "pending"
-            }
-          ],
-          "research_summary": "Reviewed state-schemas and tool implementations.",
-          "created_at": "2026-04-12T00:00:00.000Z"
-        }
-      }
-    },
-    "action": {
-      "tool": "plan_decide",
-      "params": {
-        "issue_id": 1,
-        "decision": "Use declarative JSON with JSONPath assertions. Harness-neutral tool names only."
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.decided": true,
-        "$.allComplete": false,
-        "$.remaining.length": 1
-      },
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "$.issues[0].status": "decided",
-          "$.issues[0].decision": "Use declarative JSON with JSONPath assertions. Harness-neutral tool names only.",
-          "$.issues[1].status": "pending"
-        }
-      }
-    }
-  },
-  {
-    "test_id": "plan_decide_no_active_plan_error",
-    "description": "plan_decide returns an error when no plan.json exists, because there is no active plan session to record decisions against",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": []
-      }
-    },
-    "uncovered_params": ["issue_id", "decision"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": null
-      }
-    },
-    "action": {
-      "tool": "plan_decide",
-      "params": {
-        "issue_id": 1,
-        "decision": "Some decision"
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.error": "No active plan session"
-      }
-    }
-  },
-  {
-    "test_id": "plan_decide_with_how_agents",
-    "description": "plan_decide persists how_agents, how_summary, and how_agent_ids on the issue when those optional params are provided",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": ["issues[].how_agents", "issues[].how_agents[]", "issues[].how_summary", "issues[].how_agent_ids"]
-      }
-    },
-    "uncovered_params": ["issue_id", "decision"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "id": 1,
-          "topic": "Introduce conformance test fixtures",
-          "issues": [
-            {
-              "id": 1,
-              "title": "What fixture format best supports harness-neutral assertions?",
-              "status": "pending"
-            }
-          ],
-          "research_summary": "Reviewed state-schemas and tool implementations.",
-          "created_at": "2026-04-12T00:00:00.000Z"
-        }
-      }
-    },
-    "action": {
-      "tool": "plan_decide",
-      "params": {
-        "issue_id": 1,
-        "decision": "Declarative JSON with JSONPath assertions, harness-neutral.",
-        "how_agents": ["architect", "postdoc"],
-        "how_summary": {
-          "architect": "JSONPath assertions provide harness-agnostic verifiability.",
-          "postdoc": "Prior art in contract-testing frameworks confirms this approach."
-        },
-        "how_agent_ids": {
-          "architect": "uuid-ac01",
-          "postdoc": "uuid-pd02"
-        }
-      }
-    },
-    "postcondition": {
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "$.issues[0].status": "decided",
-          "$.issues[0].how_agents.length": 2,
-          "$.issues[0].how_agents[0]": "architect",
-          "$.issues[0].how_summary.architect": "JSONPath assertions provide harness-agnostic verifiability.",
-          "$.issues[0].how_agent_ids.architect": "uuid-ac01"
-        }
-      }
-    }
-  }
-]

package/conformance/tools/plan-start.json

@@ -1,81 +0,0 @@
-[
-  {
-    "test_id": "plan_start_happy_path",
-    "description": "plan_start creates plan.json with correct structure when given a topic, issues, and research_summary",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": ["schema_version", "id", "topic", "issues[].id", "issues[].title", "issues[].status", "research_summary", "created_at"]
-      },
-      "return_value": {
-        "plan_start": ["created", "plan_id", "topic", "issueCount"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": null
-      }
-    },
-    "action": {
-      "tool": "plan_start",
-      "params": {
-        "topic": "Introduce conformance test fixtures",
-        "issues": [
-          "What fixture format best supports harness-neutral assertions?",
-          "Which tools should be covered in the MVP?"
-        ],
-        "research_summary": "Reviewed existing state-schemas and claude-nexus MCP tool implementations. Conformance fixtures should be declarative JSON with JSONPath assertions."
-      }
-    },
-    "postcondition": {
-      "return_value": {
-        "$.created": true,
-        "$.plan_id": { "type": "number", "min": 1 },
-        "$.topic": "Introduce conformance test fixtures",
-        "$.issueCount": 2
-      },
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "$.id": { "type": "number", "min": 1 },
-          "$.topic": "Introduce conformance test fixtures",
-          "$.issues.length": 2,
-          "$.issues[0].id": 1,
-          "$.issues[0].title": "What fixture format best supports harness-neutral assertions?",
-          "$.issues[0].status": "pending",
-          "$.issues[1].id": 2,
-          "$.issues[1].title": "Which tools should be covered in the MVP?",
-          "$.issues[1].status": "pending",
-          "$.research_summary": { "type": "string", "minLength": 10 },
-          "$.created_at": { "type": "iso8601" }
-        }
-      }
-    }
-  },
-  {
-    "test_id": "plan_start_missing_research_summary_error",
-    "description": "plan_start rejects the invocation when research_summary is omitted — the field is required to enforce that research happened before planning",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": []
-      }
-    },
-    "uncovered_params": ["topic", "issues"],
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": null
-      }
-    },
-    "action": {
-      "tool": "plan_start",
-      "params": {
-        "topic": "Some topic",
-        "issues": ["Issue A"]
-      }
-    },
-    "postcondition": {
-      "error": true,
-      "state_files": {
-        ".nexus/state/plan.json": null
-      }
-    }
-  }
-]

package/conformance/tools/plan-status.json

@@ -1,127 +0,0 @@
-[
-  {
-    "test_id": "plan_status_inactive",
-    "description": "plan_status returns active:false when no plan.json exists, indicating no active planning session",
-    "covers": {
-      "return_value": {
-        "plan_status": ["active"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": null
-      }
-    },
-    "action": {
-      "tool": "plan_status",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.active": false
-      }
-    }
-  },
-  {
-    "test_id": "plan_status_active_full",
-    "description": "plan_status returns the full session snapshot including research_summary, decided issues with how_agents and how_summary, and a correct summary breakdown when a plan is active",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": ["id", "topic", "issues[].id", "issues[].status", "issues[].decision", "issues[].how_agents", "issues[].how_summary", "research_summary"]
-      },
-      "return_value": {
-        "plan_status": ["active", "plan_id", "topic", "issues", "research_summary", "summary.total", "summary.pending", "summary.decided", "issues[].how_agents", "issues[].how_summary"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "id": 10,
-          "topic": "Migrate storage to event-sourced model",
-          "issues": [
-            {
-              "id": 1,
-              "title": "Define event schema",
-              "status": "decided",
-              "decision": "Use typed discriminated unions per aggregate.",
-              "how_agents": ["architect"],
-              "how_summary": {
-                "architect": "Recommends sealed event types with version field for forward compatibility."
-              }
-            },
-            {
-              "id": 2,
-              "title": "Plan migration rollout strategy",
-              "status": "pending"
-            }
-          ],
-          "research_summary": "Reviewed CQRS literature and existing state-schema patterns in conformance/.",
-          "created_at": "2026-04-13T00:00:00.000Z"
-        }
-      }
-    },
-    "action": {
-      "tool": "plan_status",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.active": true,
-        "$.plan_id": 10,
-        "$.topic": "Migrate storage to event-sourced model",
-        "$.research_summary": "Reviewed CQRS literature and existing state-schema patterns in conformance/.",
-        "$.summary.total": 2,
-        "$.summary.pending": 1,
-        "$.summary.decided": 1,
-        "$.issues.length": 2,
-        "$.issues[0].how_agents[0]": "architect",
-        "$.issues[0].how_summary.architect": "Recommends sealed event types with version field for forward compatibility."
-      }
-    }
-  },
-  {
-    "test_id": "plan_status_active_minimal",
-    "description": "plan_status returns a valid active snapshot when the plan has no research_summary and all issues are still pending",
-    "covers": {
-      "state_schemas": {
-        "plan.schema.json": ["id", "topic", "issues[].status"]
-      },
-      "return_value": {
-        "plan_status": ["active", "plan_id", "topic", "summary.total", "summary.pending", "summary.decided"]
-      }
-    },
-    "precondition": {
-      "state_files": {
-        ".nexus/state/plan.json": {
-          "id": 11,
-          "topic": "Minimal plan with no research",
-          "issues": [
-            {
-              "id": 1,
-              "title": "First issue",
-              "status": "pending"
-            },
-            {
-              "id": 2,
-              "title": "Second issue",
-              "status": "pending"
-            }
-          ],
-          "created_at": "2026-04-13T00:00:00.000Z"
-        }
-      }
-    },
-    "action": {
-      "tool": "plan_status",
-      "params": {}
-    },
-    "postcondition": {
-      "return_value": {
-        "$.active": true,
-        "$.summary.total": 2,
-        "$.summary.pending": 2,
-        "$.summary.decided": 0
-      }
-    }
-  }
-]