arggon-harness 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/dist/plugin/hooks/context-injection.d.ts.map +1 -1
  2. package/dist/plugin/hooks/context-injection.js +7 -1
  3. package/dist/plugin/hooks/context-injection.js.map +1 -1
  4. package/package.json +1 -1
  5. package/src/agents/orchestrator.md +9 -7
  6. package/src/agents/spec-verify.md +12 -7
package/dist/plugin/hooks/context-injection.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"context-injection.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/context-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,MAAM,CAkD7E;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CA4BzD;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,EAC5B,aAAa,EAAE,UAAU,EAAE,GAC1B,MAAM,EAAE,CAWV"}
1
+ {"version":3,"file":"context-injection.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/context-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,MAAM,CAkD7E;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CAkCzD;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,EAC5B,aAAa,EAAE,UAAU,EAAE,GAC1B,MAAM,EAAE,CAWV"}
package/dist/plugin/hooks/context-injection.js CHANGED
@@ -66,6 +66,12 @@ export function buildOrchestratorDelegationBlock() {
66
66
  lines.push("3. REMIND ABOUT TOOLS — Remind the subagent that all spec_* tools are");
67
67
  lines.push(" available for their use (spec_change_status, spec_task_progress, etc.).");
68
68
  lines.push("");
69
+ lines.push("4. DO NOT CALL SPEC TOOLS DIRECTLY — You do NOT have direct access to tools like");
70
+ lines.push(" spec_change_new, spec_artifact_instr, spec_schema_list, or spec_design_wireframe.");
71
+ lines.push(" Those tools are only available to subagents. If you need a spec operation done,");
72
+ lines.push(" delegate it to the appropriate subagent. The only spec tools you can call directly");
73
+ lines.push(" are: spec_change_list, spec_change_status, spec_task_progress, and spec_validate.");
74
+ lines.push("");
69
75
  lines.push("Phase-to-agent mapping:");
70
76
  lines.push(" explore → YOU handle directly (read files, ask questions, investigate)");
71
77
  lines.push(" propose → spec-propose");
@@ -76,7 +82,7 @@ export function buildOrchestratorDelegationBlock() {
76
82
  }
77
83
  export function contextInjectionTransform(input, activeChanges) {
78
84
  const blocks = [];
79
- if (input.agent === "orchestrator") {
85
+ if (!input.agent || input.agent === "orchestrator") {
80
86
  blocks.push("\n\n## ORCHESTRATOR MODE\nYou handle the explore phase directly (read files, investigate, ask questions).\nFor all other phases, delegate to subagents via the task tool.\nAllowed tools: task, question, skill, read, glob, grep, spec_change_list, spec_change_status, spec_task_progress.\nAll other tools are disabled for this agent.");
81
87
  blocks.push("\n\n" + buildOrchestratorDelegationBlock());
82
88
  }
package/dist/plugin/hooks/context-injection.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"context-injection.js","sourceRoot":"","sources":["../../../src/plugin/hooks/context-injection.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CAAC,aAA2B;IACnE,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAC5C,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;IACpE,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;IACpE,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAA;IAC3D,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAA;IACnE,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAA;IACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;IACxC,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAA;IAC9E,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAA;IAC5F,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAA;IAC9D,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAA;IACpF,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAA;IACrE,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAA;IAC/E,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;IACpE,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;IACjE,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAA;IACrE,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC3E,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAA;IAC5E,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAA;IAChF,KAAK,CAAC,IAAI,CAAC,sFAAsF,CAAC,CAAA;IAClG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IACrC,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAA;IACtF,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAA;IACpF,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAA;IAC9E,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;IAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;IACvC,KAAK,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAA;IAC1F,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAA;IACvF,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAA;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEd,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IACrC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;IACnE,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,QAAQ,YAAY,CAAC,CAAA;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAA;IAC5E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAA;IACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAA;IAC1F,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAA;IACpF,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAA;IACrE,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAA;IACzF,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAA;IAC3F,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAA;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAA;IAC3F,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;IAClF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAA;IACnF,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAA;IACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IACrC,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAA;IACtF,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IACtC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IACpC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IACrC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IAEtC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAUD,MAAM,UAAU,yBAAyB,CACvC,KAA4B,EAC5B,aAA2B;IAE3B,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,KAAK,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,4UAA4U,CAAC,CAAA;QACzV,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,gCAAgC,EAAE,CAAC,CAAA;IAC1D,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}
1
+ {"version":3,"file":"context-injection.js","sourceRoot":"","sources":["../../../src/plugin/hooks/context-injection.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "arggon-harness",
3
- "version": "0.2.0",
3
+ "version": "0.2.2",
4
4
  "description": "Spec-driven SDLC workflow for OpenCode — plugin, skills, commands, and init system",
5
5
  "type": "module",
6
6
  "main": "dist/plugin/index.js",
package/src/agents/orchestrator.md CHANGED
@@ -69,10 +69,10 @@ You manage the Harness workflow: explore → propose → apply → verify → ar
69
69
 
70
70
  ### Phase Handling
71
71
  - **Explore phase** → YOU handle directly (interactive thinking partner)
72
- - **Propose phase** → delegate to `spec-propose` subagent
73
- - **Apply phase** → delegate to `spec-apply` subagent (ONE TASK AT A TIME)
74
- - **Verify phase** → delegate to `spec-verify` subagent
75
- - **Archive phase** → delegate to `spec-archive` subagent
72
+ - **Propose phase** → delegate to `spec-propose` subagent (you do NOT create changes or generate artifacts directly)
73
+ - **Apply phase** → delegate to `spec-apply` subagent, ONE TASK AT A TIME (you do NOT implement code directly)
74
+ - **Verify phase** → delegate to `spec-verify` subagent (you do NOT run verification directly)
75
+ - **Archive phase** → delegate to `spec-archive` subagent (you do NOT archive or apply specs directly)
76
76
 
77
77
  ### Schema with Design Artifacts (Staged Propose Workflow)
78
78
 
@@ -168,10 +168,12 @@ When exploration reaches a natural conclusion:
168
168
  - Do question assumptions
169
169
 
170
170
  ### Workflow State Tracking
171
- Use these read-only tools to track workflow state:
171
+ Use these tools to track workflow state (these are the ONLY spec tools you have
172
+ direct access to — delegate all other spec operations to subagents):
172
173
  - `spec_change_list` — list all active changes
173
- - `spec_change_status` — check artifact completion and phase for a change
174
- - `spec_task_progress` — check task completion status
174
+ - `spec_change_status` — check artifact completion, phase, and artifact list for a change
175
+ - `spec_task_progress` — check or update task completion status
176
+ - `spec_validate` — validate a change or specific artifact
175
177
 
176
178
  ### Apply Phase: Single-Task Delegation
177
179
  During the apply phase, you MUST:
package/src/agents/spec-verify.md CHANGED
@@ -7,6 +7,7 @@ permission:
7
7
  glob: allow
8
8
  grep: allow
9
9
  spec_change_list: allow
10
+ spec_change_status: allow
10
11
  spec_verify: allow
11
12
  spec_integrity_check: allow
12
13
  write: deny
@@ -59,7 +60,8 @@ Run 5-dimension verification on a spec change.
59
60
  - Read spec/config.yaml for project context
60
61
 
61
62
  2. **Run verification**
62
- - Call `spec_verify` with change name
63
+ - Call the `spec_verify` tool with the change name (this runs all 5 dimensions server-side)
64
+ - Do NOT attempt to run tests or commands via bash — the tool handles test execution
63
65
  - Optionally specify dimensions (default: all)
64
66
 
65
67
  3. **Show report**
@@ -76,7 +78,7 @@ Run 5-dimension verification on a spec change.
76
78
  - For CRITICAL issues: must fix before archive
77
79
  - For WARNINGs: should fix, but not blocking
78
80
  - For SUGGESTIONs: nice to fix
79
- - Offer to help fix issues
81
+ - Offer to help fix issues (use read/grep to investigate — not bash)
80
82
 
81
83
  5. **Re-verify**
82
84
  - After fixes, run verification again
@@ -88,11 +90,11 @@ Run 5-dimension verification on a spec change.
88
90
 
89
91
  ## Verification Heuristics
90
92
 
91
- - **Integrity**: Hash comparison, field validation
92
- - **Compliance**: Grep for requirement IDs in code, check test files
93
- - **Tasks**: Parse task status, check git diff for changes
94
- - **Coherence**: Extract design decisions, search for patterns
95
- - **Regression**: Compare delta specs with main specs
93
+ - **Integrity**: Call `spec_integrity_check` tool — it handles hash comparison and field validation server-side
94
+ - **Compliance**: Use `grep` tool to find requirement IDs in source files; use `read` to check test files
95
+ - **Tasks**: Call `spec_task_progress` to get task completion status; use `read` to verify affected files exist
96
+ - **Coherence**: Use `read` to extract design decisions from design-tech.yaml; use `grep` to search for implementation patterns
97
+ - **Regression**: Use `read` to compare delta specs with main specs; no command execution needed
96
98
 
97
99
  ## Guardrails
98
100
 
@@ -101,3 +103,6 @@ Run 5-dimension verification on a spec change.
101
103
  - Every issue must have actionable recommendation
102
104
  - Include file/line references
103
105
  - Note which checks were skipped and why
106
+ - Do NOT attempt to run tests, commands, or git operations via bash — use read/grep/glob for file checks
107
+ - The spec_verify tool handles all verification server-side (integrity, test execution, compliance)
108
+ - If you need to check something not covered by the tool, use read/grep/glob — never bash