harness-everything 0.18.0 → 0.18.1
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.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +7 -0
- package/README.md +1 -1
- package/ci/invariant-routing.test.js +8 -5
- package/docs/architecture.md +12 -9
- package/docs/routing.md +11 -8
- package/docs/workflow-runtime.md +11 -8
- package/harness-everything/SKILL.md +3 -3
- package/harness-everything/references/triage-and-tiers.md +14 -9
- package/harness-everything/scripts/kernel-router-core.js +12 -8
- package/opencode-plugin/plugin.json +1 -1
- package/package.json +1 -1
- package/plugins/harness-everything/.codex-plugin/plugin.json +1 -1
- package/plugins/harness-everything/plugin.json +1 -1
- package/plugins/harness-everything/scripts/lib/advisory-text.js +9 -8
- package/plugins/harness-everything/skills/harness-everything/SKILL.md +3 -3
- package/plugins/harness-everything/skills/harness-everything/references/triage-and-tiers.md +14 -9
- package/plugins/harness-everything/skills/harness-everything/scripts/kernel-router-core.js +12 -8
- package/scripts/lib/advisory-text.js +9 -8
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"name": "harness-everything",
|
|
11
11
|
"source": "./",
|
|
12
12
|
"description": "Harness OS: an orchestrated agent operating system — tier routing, circuit breaker guardrails, verification gates, WAL session memory, and self-evolving workspace rules.",
|
|
13
|
-
"version": "0.18.
|
|
13
|
+
"version": "0.18.1",
|
|
14
14
|
"author": {
|
|
15
15
|
"name": "Miya Daniel"
|
|
16
16
|
},
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "harness-everything",
|
|
3
3
|
"description": "Harness OS: an orchestrated agent operating system — tier routing, circuit breaker guardrails, verification gates, WAL session memory, and self-evolving workspace rules.",
|
|
4
|
-
"version": "0.18.
|
|
4
|
+
"version": "0.18.1",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Miya Daniel"
|
|
7
7
|
},
|
package/AGENTS.md
CHANGED
|
@@ -41,7 +41,7 @@ The retained [OpenCode evidence](benchmarks/results/live-host/opencode-2026-09-1
|
|
|
41
41
|
8. **CHANGELOG.md keeps pending human-authored notes under `[Unreleased]`.** Semantic-release owns stable headings/tags/release notes.
|
|
42
42
|
9. **Conventional Commit type is release input.** Breaking→major; `feat`→minor; `fix`/`perf`/`refactor`/`build`/`revert`→patch; docs/test/ci/style/chore do not release by themselves.
|
|
43
43
|
10. **Selected workflow is planning guidance; reasoning and execution stay flexible.** Before omitting a suggested skill, read/evaluate its complete `SKILL.md` flow. Do not turn routing into a universal TODO/TDD/Fable sequence. Missing workflow evidence should produce a reminder, not a persistent Harness lock.
|
|
44
|
-
11. **User-visible Harness Status is mandatory for non-trivial work.**
|
|
44
|
+
11. **User-visible Harness Status is mandatory for non-trivial work.** Render one readable Markdown block headed `### 🚦 Harness Status`, with bullet-aligned bold `Current`, `Read / Evidence`, `Next`, plus optional `Risk / Blocked`; use nested evidence bullets when useful. Emit it before substantive execution, after major phases, on direction changes, during long work at meaningful boundaries, and before final completion. The routing checkpoint is internal source state, not a second user-facing block. This semantic MUST does not create a hard lock.
|
|
45
45
|
12. **Prefer Git worktree isolation for major mutation.** Read-only discovery may stay in the bound repository. Tier 3 / Fable source and artifact changes should use a verified linked worktree when practical; failure to create one is a prominent risk reminder, not a Harness-owned deadlock. See [workflow-runtime.md](docs/workflow-runtime.md).
|
|
46
46
|
|
|
47
47
|
## Verification Before You Claim Done
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project are documented in this file.
|
|
4
4
|
|
|
5
|
+
## [0.18.1](https://github.com/dyphn1/Harness-everything/compare/v0.18.0...v0.18.1) (2026-09-21)
|
|
6
|
+
|
|
7
|
+
### Bug Fixes
|
|
8
|
+
|
|
9
|
+
* **status:** keep presentation contract compact ([942c2a3](https://github.com/dyphn1/Harness-everything/commit/942c2a30a4281d6f07e83bca91977991e53d04ea))
|
|
10
|
+
* **status:** restore readable visual hierarchy ([63223b2](https://github.com/dyphn1/Harness-everything/commit/63223b2eac86926b154b5a90072216fd9e761342))
|
|
11
|
+
|
|
5
12
|
## [0.18.0](https://github.com/dyphn1/Harness-everything/compare/v0.17.0...v0.18.0) (2026-09-21)
|
|
6
13
|
|
|
7
14
|
### Features
|
package/README.md
CHANGED
|
@@ -69,7 +69,7 @@ npx github:dyphn1/Harness-everything install
|
|
|
69
69
|
2. **Preflight / session context where packaged:** Hook-capable surfaces can inject environment/session context automatically; advisory-only surfaces must not be described as if they do.
|
|
70
70
|
3. **Verification boundary:** Completion claims require objective evidence; whether that boundary is mechanically invoked or explicitly called depends on the host surface.
|
|
71
71
|
4. **Mandatory applicable workflow:** Evaluate each suggested skill's complete `SKILL.md` before omission, then resolve the selected topology with objective evidence. Reasoning and implementation remain flexible; escape applies only to a declared uncovered stage with evidence. Tier 3 / Fable mutation requires a verified Git worktree. See the [workflow runtime contract](docs/workflow-runtime.md) for entry, completion, and host limits. Harness does not impose one universal TODO/TDD/Fable sequence.
|
|
72
|
-
5. **Unified user-visible status:** For non-trivial software/project work, the agent MUST
|
|
72
|
+
5. **Unified user-visible status:** For non-trivial software/project work, the agent MUST render one scannable Markdown `### 🚦 Harness Status` block with bold bullet labels for `Current`, `Read / Evidence`, `Next`, plus optional `Risk / Blocked`; multiple evidence items may use nested bullets. Use it at major phase/direction boundaries and before final completion. The routing checkpoint remains internal source state. This is a communication contract, not a hard runtime lock.
|
|
73
73
|
|
|
74
74
|
### What Gets Installed (and How to Remove It)
|
|
75
75
|
|
|
@@ -20,9 +20,12 @@ check(!tier2.stdout.includes('unavailable isolation means BLOCKED'),'old worktre
|
|
|
20
20
|
check(tier2.stdout.includes('evaluate-suggestions-before-skip'),'skill suggestions still require evaluation before omission');
|
|
21
21
|
check(tier2.stdout.includes('visible-status-updates'),'workflow plan carries mandatory user-visible status invariant');
|
|
22
22
|
check(tier2.stdout.includes('USER-VISIBLE HARNESS STATUS CONTRACT (MUST)'),'kernel emits the mandatory unified status contract');
|
|
23
|
-
for(const field of ['Harness Status','Current
|
|
24
|
-
check(tier2.stdout.includes(field),'kernel status contract includes '+field);
|
|
23
|
+
for(const field of ['### 🚦 Harness Status','- **Current:**','- **Read / Evidence:**','- **Next:**','- **Risk / Blocked:**']){
|
|
24
|
+
check(tier2.stdout.includes(field),'kernel status contract includes readable Markdown field '+field);
|
|
25
25
|
}
|
|
26
|
+
check(tier2.stdout.includes('HARNESS ROUTING CHECKPOINT (INTERNAL SOURCE STATE — DO NOT RENDER SEPARATELY)'),'routing checkpoint is marked internal rather than user-facing');
|
|
27
|
+
check(!tier2.stdout.includes('HARNESS ROUTING CHECKPOINT (REQUIRED VISIBLE STATE)'),'legacy duplicate-visible checkpoint label is absent');
|
|
28
|
+
check(tier2.stdout.includes('nested bullets when there are multiple items'),'kernel tells agents to split dense evidence into nested bullets');
|
|
26
29
|
check(tier2.stdout.includes('semantic communication MUST, not a hard execution lock'),'kernel separates semantic MUST from mechanical blocking');
|
|
27
30
|
|
|
28
31
|
const tier3=spawnSync(process.execPath,[kernel,'audit the entire repository architecture and coordinate multiple modules'],{cwd:ROOT,encoding:'utf8'});
|
|
@@ -34,7 +37,7 @@ check(tier3.stdout.includes('WORKFLOW GUIDANCE (ADVISORY WHEN SELECTED)'),'Tier
|
|
|
34
37
|
const hs=read('harness-everything/SKILL.md');
|
|
35
38
|
check(/workflow state and numeric limits guide; they do not hard-stop execution/i.test(hs),'Harness skill states non-blocking workflow contract');
|
|
36
39
|
check(/only Rule-of-3 reflection and explicit user\/host permission boundaries may block/i.test(hs),'Harness skill names the only intentional blocking boundaries');
|
|
37
|
-
check(/Surface status.*MUST
|
|
40
|
+
check(/Surface status.*MUST render.*Harness Status/i.test(hs)&&/bold bullets/i.test(hs)&&/Read \/ Evidence/i.test(hs),'Harness skill requires the readable unified user-visible status');
|
|
38
41
|
check(read('plugins/harness-everything/skills/harness-everything/SKILL.md')===hs,'Harness skill mirror matches');
|
|
39
42
|
|
|
40
43
|
const wt=read('using-git-worktrees/SKILL.md');
|
|
@@ -55,13 +58,13 @@ for(const p of ['docs/routing.md','docs/architecture.md','docs/workflow-runtime.
|
|
|
55
58
|
}
|
|
56
59
|
const advisory=read('scripts/lib/advisory-text.js');
|
|
57
60
|
check(/selected workflow topology.*planning guidance/i.test(advisory),'installer advisory text keeps workflow non-blocking');
|
|
58
|
-
check(/USER-VISIBLE STATUS \(MUST\)/i.test(advisory)
|
|
61
|
+
check(/USER-VISIBLE STATUS \(MUST\)/i.test(advisory)&&/### 🚦 Harness Status/i.test(advisory)&&/\*\*Read \/ Evidence:\*\*/i.test(advisory),'instruction-only installers carry the readable mandatory status contract');
|
|
59
62
|
check(/Rule of 3/i.test(advisory)&&/Permission boundaries are separate/i.test(advisory),'installer text preserves Rule-of-3 and permission boundaries');
|
|
60
63
|
check(read('plugins/harness-everything/scripts/lib/advisory-text.js')===advisory,'OpenAI advisory mirror matches');
|
|
61
64
|
|
|
62
65
|
const agents=read('AGENTS.md');
|
|
63
66
|
check(/Selected workflow is planning guidance/i.test(agents),'repository agent contract is guidance-first');
|
|
64
|
-
check(/User-visible Harness Status is mandatory/i.test(agents),'repository agent contract requires unified user-visible status');
|
|
67
|
+
check(/User-visible Harness Status is mandatory/i.test(agents)&&/### 🚦 Harness Status/i.test(agents)&&/nested evidence bullets/i.test(agents),'repository agent contract requires readable unified user-visible status');
|
|
65
68
|
check(/Prefer Git worktree isolation/i.test(agents),'repository worktree rule is a recommendation');
|
|
66
69
|
|
|
67
70
|
const hooks=JSON.parse(read('hooks/hooks.json'));
|
package/docs/architecture.md
CHANGED
|
@@ -57,17 +57,20 @@ The router does not tell the model *how* to solve each stage. It decides what li
|
|
|
57
57
|
|
|
58
58
|
### User-visible status protocol
|
|
59
59
|
|
|
60
|
-
Non-trivial work MUST expose one stable progress shape to the user:
|
|
61
|
-
|
|
62
|
-
```
|
|
63
|
-
Harness Status
|
|
64
|
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
60
|
+
Non-trivial work MUST expose one stable, scannable Markdown progress shape to the user:
|
|
61
|
+
|
|
62
|
+
```md
|
|
63
|
+
### 🚦 Harness Status
|
|
64
|
+
|
|
65
|
+
- **Current:** <what is being done now>
|
|
66
|
+
- **Read / Evidence:**
|
|
67
|
+
- <important file/source/evidence read or confirmed>
|
|
68
|
+
- <another item when multiple evidence items improve scanability>
|
|
69
|
+
- **Next:** <next intended action>
|
|
70
|
+
- **Risk / Blocked:** <only when materially applicable; omit otherwise>
|
|
68
71
|
```
|
|
69
72
|
|
|
70
|
-
The agent emits
|
|
73
|
+
Use nested evidence bullets when multiple items would otherwise become one dense sentence. The agent emits the status before substantive execution, after major phases, on material direction changes, at meaningful long-running phase boundaries, and before final completion. The router checkpoint feeds this status as internal source state but is not a second user-facing template.
|
|
71
74
|
|
|
72
75
|
This is a semantic contract, not another cognitive lock. Hook-capable hosts may observe or remind about compliance; instruction-only hosts still receive the MUST contract without pretending they can mechanically enforce it.
|
|
73
76
|
|
package/docs/routing.md
CHANGED
|
@@ -47,17 +47,20 @@ On a host where `UserPromptSubmit` is wired, reuse that hook output instead of r
|
|
|
47
47
|
|
|
48
48
|
## User-visible status contract
|
|
49
49
|
|
|
50
|
-
For non-trivial software/project work, the user-facing progress protocol is a semantic **MUST** and
|
|
50
|
+
For non-trivial software/project work, the user-facing progress protocol is a semantic **MUST** and uses the same readable Markdown presentation across execution topologies:
|
|
51
51
|
|
|
52
|
-
```
|
|
53
|
-
Harness Status
|
|
54
|
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
52
|
+
```md
|
|
53
|
+
### 🚦 Harness Status
|
|
54
|
+
|
|
55
|
+
- **Current:** <what is being done now>
|
|
56
|
+
- **Read / Evidence:**
|
|
57
|
+
- <important file/source/evidence read or confirmed>
|
|
58
|
+
- <another item when multiple evidence items improve scanability>
|
|
59
|
+
- **Next:** <next intended action>
|
|
60
|
+
- **Risk / Blocked:** <only when materially applicable; omit otherwise>
|
|
58
61
|
```
|
|
59
62
|
|
|
60
|
-
Emit
|
|
63
|
+
Keep one short evidence item inline when that reads better; use nested bullets for multiple evidence items. Emit the status before substantive execution, after a major phase, when direction materially changes, at meaningful long-running phase boundaries, and before final completion. The final response may fold the last status into its completion summary. The routing checkpoint is internal source state for this protocol, not a second user-facing progress template.
|
|
61
64
|
|
|
62
65
|
This MUST is semantic rather than a hard runtime lock: hosts may observe/remind with different strength, but lack of a blocking hook does not downgrade the contract to optional advice.
|
|
63
66
|
|
package/docs/workflow-runtime.md
CHANGED
|
@@ -17,17 +17,20 @@ None of those cognitive workflow conditions should trap a session or require a r
|
|
|
17
17
|
|
|
18
18
|
A semantic MUST is not the same thing as a hard runtime lock. User-visible status, routing/applicability obligations, and verification-before-claim can remain mandatory agent contracts while host hooks observe or remind on a best-effort basis. Do not downgrade a semantic obligation to optional advice merely because the host cannot block it.
|
|
19
19
|
|
|
20
|
-
The unified status shape
|
|
20
|
+
The unified status shape uses a visible Markdown hierarchy:
|
|
21
21
|
|
|
22
|
-
```
|
|
23
|
-
Harness Status
|
|
24
|
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
22
|
+
```md
|
|
23
|
+
### 🚦 Harness Status
|
|
24
|
+
|
|
25
|
+
- **Current:** <what is being done now>
|
|
26
|
+
- **Read / Evidence:**
|
|
27
|
+
- <important file/source/evidence read or confirmed>
|
|
28
|
+
- <another item when multiple evidence items improve scanability>
|
|
29
|
+
- **Next:** <next intended action>
|
|
30
|
+
- **Risk / Blocked:** <only when materially applicable; omit otherwise>
|
|
28
31
|
```
|
|
29
32
|
|
|
30
|
-
Emit it before substantive execution, after major phases, on material direction changes, at meaningful long-running phase boundaries, and before final completion.
|
|
33
|
+
Keep one short evidence item inline; use nested evidence bullets when multiple items improve scanability. Emit it before substantive execution, after major phases, on material direction changes, at meaningful long-running phase boundaries, and before final completion.
|
|
31
34
|
|
|
32
35
|
The two intentionally separate hard boundaries are:
|
|
33
36
|
|
|
@@ -4,7 +4,7 @@ description: "Route software/project work through the Harness kernel: classify T
|
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
6
|
author: Miya Daniel
|
|
7
|
-
version: 0.18.
|
|
7
|
+
version: 0.18.1
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# Harness Everything
|
|
@@ -23,12 +23,12 @@ Kernel routing entry.
|
|
|
23
23
|
2. **Verify before claim** — seek objective evidence before saying work is done.
|
|
24
24
|
3. **Zoom out on repetition** — after 3 same-signature failures, use `zoom-out`.
|
|
25
25
|
4. **Evaluate before omission** — read each suggested skill's `SKILL.md` before deciding applicability.
|
|
26
|
-
5. **Surface status** — non-trivial work MUST
|
|
26
|
+
5. **Surface status** — non-trivial work MUST render `### 🚦 Harness Status` with bold bullets: `Current`, `Read / Evidence`, `Next`; optional `Risk / Blocked`.
|
|
27
27
|
6. **Keep agency** — workflow state and numeric limits guide; they do not hard-stop execution.
|
|
28
28
|
|
|
29
29
|
## Workflow
|
|
30
30
|
1. Reuse kernel output, or run `node "<this-skill-dir>/scripts/kernel-router.js" "<prompt summary>"`.
|
|
31
|
-
2.
|
|
31
|
+
2. Keep the **Harness Routing Checkpoint** internal; never render it separately.
|
|
32
32
|
3. Read each suggested `SKILL.md`; evaluate `USE FOR`, `DO NOT USE FOR`, workflow/basic flow, and hard rules.
|
|
33
33
|
4. Use the selected topology as planning guidance. Choose, combine, reorder, or skip steps when evidence supports doing so.
|
|
34
34
|
5. Prefer worktree isolation for broad/Tier-3 mutation and objective verification before completion.
|
|
@@ -151,23 +151,28 @@ Never turn mechanism/package evidence into a cross-host live-enforcement claim.
|
|
|
151
151
|
|
|
152
152
|
## 6. User-visible status contract
|
|
153
153
|
|
|
154
|
-
For non-trivial software/project work, user-facing progress **MUST** use one stable shape across direct, iterative, Fable, and multi-agent execution:
|
|
155
|
-
|
|
156
|
-
```
|
|
157
|
-
Harness Status
|
|
158
|
-
|
|
159
|
-
-
|
|
160
|
-
-
|
|
161
|
-
-
|
|
154
|
+
For non-trivial software/project work, user-facing progress **MUST** use one stable Markdown shape across direct, iterative, Fable, and multi-agent execution:
|
|
155
|
+
|
|
156
|
+
```md
|
|
157
|
+
### 🚦 Harness Status
|
|
158
|
+
|
|
159
|
+
- **Current:** <what is being done now>
|
|
160
|
+
- **Read / Evidence:**
|
|
161
|
+
- <important file/source/evidence read or confirmed>
|
|
162
|
+
- <another item when multiple evidence items improve scanability>
|
|
163
|
+
- **Next:** <next intended action>
|
|
164
|
+
- **Risk / Blocked:** <only when materially applicable; omit otherwise>
|
|
162
165
|
```
|
|
163
166
|
|
|
167
|
+
When there is only one short evidence item, keep it inline on the **Read / Evidence** bullet. Use nested bullets when multiple items would otherwise become one dense sentence.
|
|
168
|
+
|
|
164
169
|
Emit it before substantive execution, after a major phase completes, when the plan/assumption/direction materially changes, at meaningful phase boundaries during long-running work, and before final completion. The final response may merge the last status naturally.
|
|
165
170
|
|
|
166
171
|
This is a semantic communication MUST. It does **not** create a runtime lock, counter, reset requirement, or permission boundary. The routing checkpoint below is source state for this format, not a second competing progress template.
|
|
167
172
|
|
|
168
173
|
## 7. Routing Checkpoint
|
|
169
174
|
|
|
170
|
-
For software/project work, consume this runtime state when producing the first Harness Status:
|
|
175
|
+
For software/project work, consume this internal runtime state when producing the first Harness Status; do not render the checkpoint as a separate user-facing block:
|
|
171
176
|
|
|
172
177
|
```markdown
|
|
173
178
|
## 🚦 Harness Routing Checkpoint
|
|
@@ -24,7 +24,7 @@ const { applyEnsemblePolicy } = require('./ensemble-policy');
|
|
|
24
24
|
const INVARIANT_TEXT = {
|
|
25
25
|
'scope-lock': 'Route before execution: stay inside the authorized task/repository scope.',
|
|
26
26
|
'verify-before-claim': 'Verify before claim: completion claims require objective evidence appropriate to the change.',
|
|
27
|
-
'visible-status-updates': 'User-visible status is mandatory:
|
|
27
|
+
'visible-status-updates': 'User-visible status is mandatory: render the single Markdown Harness Status with a visible heading, bullet-aligned bold labels, Current, Read / Evidence, and Next; add Risk / Blocked only when materially applicable.',
|
|
28
28
|
'replan-after-repeated-failure': 'Re-plan on repetition: after 3 same-signature failures, stop micro-retrying and zoom out/re-diagnose.',
|
|
29
29
|
'evaluate-suggestions-before-skip': 'Evaluate before skip: read each suggested skill\'s complete SKILL.md entry/basic flow before omitting it.',
|
|
30
30
|
'loop-awareness': 'When iterative work runs long, remind the agent to verify assumptions or re-plan; never hard-stop on a count.',
|
|
@@ -149,7 +149,7 @@ function printRoutingCheckpoint(plan) {
|
|
|
149
149
|
const invariants = Array.isArray(plan.requiredInvariants) ? plan.requiredInvariants : [];
|
|
150
150
|
const suggestions = uniqueSuggestedSkills(plan);
|
|
151
151
|
|
|
152
|
-
console.log('\n=> HARNESS ROUTING CHECKPOINT (
|
|
152
|
+
console.log('\n=> HARNESS ROUTING CHECKPOINT (INTERNAL SOURCE STATE — DO NOT RENDER SEPARATELY):');
|
|
153
153
|
console.log(` - Tier: ${displayTier(plan.tier)}`);
|
|
154
154
|
console.log(` - Strategy: ${plan.strategy || 'deferred'}`);
|
|
155
155
|
console.log(` - Required invariants: ${invariants.length ? invariants.join(', ') : 'none'}`);
|
|
@@ -169,12 +169,16 @@ function printKernelContract(plan) {
|
|
|
169
169
|
}
|
|
170
170
|
|
|
171
171
|
console.log('\n=> USER-VISIBLE HARNESS STATUS CONTRACT (MUST):');
|
|
172
|
-
console.log(' - For non-trivial software/project work, the agent MUST
|
|
173
|
-
console.log(' Harness Status');
|
|
174
|
-
console.log('
|
|
175
|
-
console.log(' -
|
|
176
|
-
console.log(' -
|
|
177
|
-
console.log('
|
|
172
|
+
console.log(' - For non-trivial software/project work, the agent MUST render this single Markdown status shape:');
|
|
173
|
+
console.log(' ### 🚦 Harness Status');
|
|
174
|
+
console.log('');
|
|
175
|
+
console.log(' - **Current:** <what is being done now>');
|
|
176
|
+
console.log(' - **Read / Evidence:**');
|
|
177
|
+
console.log(' - <important file/source/evidence read or confirmed>');
|
|
178
|
+
console.log(' - <another item when multiple evidence items improve scanability>');
|
|
179
|
+
console.log(' - **Next:** <next intended action>');
|
|
180
|
+
console.log(' - **Risk / Blocked:** <only when materially applicable; omit otherwise>');
|
|
181
|
+
console.log(' - Keep evidence inline when there is only one short item; use nested bullets when there are multiple items.');
|
|
178
182
|
console.log(' - Emit it before substantive execution, after a major phase, when direction materially changes, at meaningful long-running phase boundaries, and before final completion (the final response may merge it naturally).');
|
|
179
183
|
console.log(' - This is a semantic communication MUST, not a hard execution lock, counter, or reset condition.');
|
|
180
184
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "harness-everything",
|
|
4
|
-
"version": "0.18.
|
|
4
|
+
"version": "0.18.1",
|
|
5
5
|
"description": "Invariant-first engineering harness for routing, verification, and failure recovery while preserving agent autonomy.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Miya Daniel",
|
|
@@ -15,15 +15,16 @@ const advisoryInstructions = [
|
|
|
15
15
|
`2. For EVERY suggested skill, read its complete \`SKILL.md\` entry and evaluate applicability from \`USE FOR\`, \`DO NOT USE FOR\`, and its basic flow.`,
|
|
16
16
|
`3. Treat the selected workflow topology and numeric limits as planning guidance, not a lock. Choose, combine, reorder, or skip steps when evidence supports it.`,
|
|
17
17
|
`4. Prefer objective verification before declaring done and worktree isolation for broad/Tier-3 mutation.`,
|
|
18
|
-
`5. Use the routing checkpoint as source state for the first Harness Status; do not
|
|
18
|
+
`5. Use the routing checkpoint only as internal source state for the first Harness Status; do not render a competing progress block.`,
|
|
19
19
|
``,
|
|
20
20
|
`## 📣 USER-VISIBLE STATUS (MUST)`,
|
|
21
|
-
`For non-trivial software/project work, this semantic communication contract is mandatory even when the host integration itself is instruction-only:`,
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
`-
|
|
25
|
-
`-
|
|
26
|
-
`-
|
|
21
|
+
`For non-trivial software/project work, this semantic communication contract is mandatory even when the host integration itself is instruction-only. Render this Markdown shape:`,
|
|
22
|
+
`### 🚦 Harness Status`,
|
|
23
|
+
``,
|
|
24
|
+
`- **Current:** <what is being done now>`,
|
|
25
|
+
`- **Read / Evidence:** <one short item inline, or nested bullets when there are multiple items>`,
|
|
26
|
+
`- **Next:** <next intended action>`,
|
|
27
|
+
`- **Risk / Blocked:** <only when materially applicable; omit otherwise>`,
|
|
27
28
|
`Emit it before substantive execution, after a major phase, when direction materially changes, at meaningful long-running phase boundaries, and before final completion. This MUST does not imply a hard runtime lock.`,
|
|
28
29
|
``,
|
|
29
30
|
`## 🤖 COGNITIVE COMPLIANCE`,
|
|
@@ -145,7 +146,7 @@ function buildCodexGlobalContent() {
|
|
|
145
146
|
``,
|
|
146
147
|
`- Discover the environment and host capabilities before relying on them.`,
|
|
147
148
|
`- For software/project work, run \`npx github:dyphn1/Harness-everything next "<summary>"\` before mutation and use the routing checkpoint as source state for the first Harness Status.`,
|
|
148
|
-
`- For non-trivial work, MUST
|
|
149
|
+
`- For non-trivial work, MUST render one Markdown \`### 🚦 Harness Status\` with bullet-aligned bold \`Current\`, \`Read / Evidence\`, \`Next\`, and optional \`Risk / Blocked\`; repeat it at major phase/direction boundaries and before final completion.`,
|
|
149
150
|
`- Read every suggested skill's complete \`SKILL.md\` entry before resolving applicability; do not omit it from metadata or confidence alone.`,
|
|
150
151
|
`- Use the selected workflow topology as planning guidance; the model may adapt or skip steps with an explicit evidence-based reason.`,
|
|
151
152
|
`- Do not impose a universal TODO/TDD/Fable sequence; use the smallest useful topology plus applicable skills.`,
|
|
@@ -4,7 +4,7 @@ description: "Route software/project work through the Harness kernel: classify T
|
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
6
|
author: Miya Daniel
|
|
7
|
-
version: 0.18.
|
|
7
|
+
version: 0.18.1
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# Harness Everything
|
|
@@ -23,12 +23,12 @@ Kernel routing entry.
|
|
|
23
23
|
2. **Verify before claim** — seek objective evidence before saying work is done.
|
|
24
24
|
3. **Zoom out on repetition** — after 3 same-signature failures, use `zoom-out`.
|
|
25
25
|
4. **Evaluate before omission** — read each suggested skill's `SKILL.md` before deciding applicability.
|
|
26
|
-
5. **Surface status** — non-trivial work MUST
|
|
26
|
+
5. **Surface status** — non-trivial work MUST render `### 🚦 Harness Status` with bold bullets: `Current`, `Read / Evidence`, `Next`; optional `Risk / Blocked`.
|
|
27
27
|
6. **Keep agency** — workflow state and numeric limits guide; they do not hard-stop execution.
|
|
28
28
|
|
|
29
29
|
## Workflow
|
|
30
30
|
1. Reuse kernel output, or run `node "<this-skill-dir>/scripts/kernel-router.js" "<prompt summary>"`.
|
|
31
|
-
2.
|
|
31
|
+
2. Keep the **Harness Routing Checkpoint** internal; never render it separately.
|
|
32
32
|
3. Read each suggested `SKILL.md`; evaluate `USE FOR`, `DO NOT USE FOR`, workflow/basic flow, and hard rules.
|
|
33
33
|
4. Use the selected topology as planning guidance. Choose, combine, reorder, or skip steps when evidence supports doing so.
|
|
34
34
|
5. Prefer worktree isolation for broad/Tier-3 mutation and objective verification before completion.
|
|
@@ -151,23 +151,28 @@ Never turn mechanism/package evidence into a cross-host live-enforcement claim.
|
|
|
151
151
|
|
|
152
152
|
## 6. User-visible status contract
|
|
153
153
|
|
|
154
|
-
For non-trivial software/project work, user-facing progress **MUST** use one stable shape across direct, iterative, Fable, and multi-agent execution:
|
|
155
|
-
|
|
156
|
-
```
|
|
157
|
-
Harness Status
|
|
158
|
-
|
|
159
|
-
-
|
|
160
|
-
-
|
|
161
|
-
-
|
|
154
|
+
For non-trivial software/project work, user-facing progress **MUST** use one stable Markdown shape across direct, iterative, Fable, and multi-agent execution:
|
|
155
|
+
|
|
156
|
+
```md
|
|
157
|
+
### 🚦 Harness Status
|
|
158
|
+
|
|
159
|
+
- **Current:** <what is being done now>
|
|
160
|
+
- **Read / Evidence:**
|
|
161
|
+
- <important file/source/evidence read or confirmed>
|
|
162
|
+
- <another item when multiple evidence items improve scanability>
|
|
163
|
+
- **Next:** <next intended action>
|
|
164
|
+
- **Risk / Blocked:** <only when materially applicable; omit otherwise>
|
|
162
165
|
```
|
|
163
166
|
|
|
167
|
+
When there is only one short evidence item, keep it inline on the **Read / Evidence** bullet. Use nested bullets when multiple items would otherwise become one dense sentence.
|
|
168
|
+
|
|
164
169
|
Emit it before substantive execution, after a major phase completes, when the plan/assumption/direction materially changes, at meaningful phase boundaries during long-running work, and before final completion. The final response may merge the last status naturally.
|
|
165
170
|
|
|
166
171
|
This is a semantic communication MUST. It does **not** create a runtime lock, counter, reset requirement, or permission boundary. The routing checkpoint below is source state for this format, not a second competing progress template.
|
|
167
172
|
|
|
168
173
|
## 7. Routing Checkpoint
|
|
169
174
|
|
|
170
|
-
For software/project work, consume this runtime state when producing the first Harness Status:
|
|
175
|
+
For software/project work, consume this internal runtime state when producing the first Harness Status; do not render the checkpoint as a separate user-facing block:
|
|
171
176
|
|
|
172
177
|
```markdown
|
|
173
178
|
## 🚦 Harness Routing Checkpoint
|
|
@@ -24,7 +24,7 @@ const { applyEnsemblePolicy } = require('./ensemble-policy');
|
|
|
24
24
|
const INVARIANT_TEXT = {
|
|
25
25
|
'scope-lock': 'Route before execution: stay inside the authorized task/repository scope.',
|
|
26
26
|
'verify-before-claim': 'Verify before claim: completion claims require objective evidence appropriate to the change.',
|
|
27
|
-
'visible-status-updates': 'User-visible status is mandatory:
|
|
27
|
+
'visible-status-updates': 'User-visible status is mandatory: render the single Markdown Harness Status with a visible heading, bullet-aligned bold labels, Current, Read / Evidence, and Next; add Risk / Blocked only when materially applicable.',
|
|
28
28
|
'replan-after-repeated-failure': 'Re-plan on repetition: after 3 same-signature failures, stop micro-retrying and zoom out/re-diagnose.',
|
|
29
29
|
'evaluate-suggestions-before-skip': 'Evaluate before skip: read each suggested skill\'s complete SKILL.md entry/basic flow before omitting it.',
|
|
30
30
|
'loop-awareness': 'When iterative work runs long, remind the agent to verify assumptions or re-plan; never hard-stop on a count.',
|
|
@@ -149,7 +149,7 @@ function printRoutingCheckpoint(plan) {
|
|
|
149
149
|
const invariants = Array.isArray(plan.requiredInvariants) ? plan.requiredInvariants : [];
|
|
150
150
|
const suggestions = uniqueSuggestedSkills(plan);
|
|
151
151
|
|
|
152
|
-
console.log('\n=> HARNESS ROUTING CHECKPOINT (
|
|
152
|
+
console.log('\n=> HARNESS ROUTING CHECKPOINT (INTERNAL SOURCE STATE — DO NOT RENDER SEPARATELY):');
|
|
153
153
|
console.log(` - Tier: ${displayTier(plan.tier)}`);
|
|
154
154
|
console.log(` - Strategy: ${plan.strategy || 'deferred'}`);
|
|
155
155
|
console.log(` - Required invariants: ${invariants.length ? invariants.join(', ') : 'none'}`);
|
|
@@ -169,12 +169,16 @@ function printKernelContract(plan) {
|
|
|
169
169
|
}
|
|
170
170
|
|
|
171
171
|
console.log('\n=> USER-VISIBLE HARNESS STATUS CONTRACT (MUST):');
|
|
172
|
-
console.log(' - For non-trivial software/project work, the agent MUST
|
|
173
|
-
console.log(' Harness Status');
|
|
174
|
-
console.log('
|
|
175
|
-
console.log(' -
|
|
176
|
-
console.log(' -
|
|
177
|
-
console.log('
|
|
172
|
+
console.log(' - For non-trivial software/project work, the agent MUST render this single Markdown status shape:');
|
|
173
|
+
console.log(' ### 🚦 Harness Status');
|
|
174
|
+
console.log('');
|
|
175
|
+
console.log(' - **Current:** <what is being done now>');
|
|
176
|
+
console.log(' - **Read / Evidence:**');
|
|
177
|
+
console.log(' - <important file/source/evidence read or confirmed>');
|
|
178
|
+
console.log(' - <another item when multiple evidence items improve scanability>');
|
|
179
|
+
console.log(' - **Next:** <next intended action>');
|
|
180
|
+
console.log(' - **Risk / Blocked:** <only when materially applicable; omit otherwise>');
|
|
181
|
+
console.log(' - Keep evidence inline when there is only one short item; use nested bullets when there are multiple items.');
|
|
178
182
|
console.log(' - Emit it before substantive execution, after a major phase, when direction materially changes, at meaningful long-running phase boundaries, and before final completion (the final response may merge it naturally).');
|
|
179
183
|
console.log(' - This is a semantic communication MUST, not a hard execution lock, counter, or reset condition.');
|
|
180
184
|
|
|
@@ -15,15 +15,16 @@ const advisoryInstructions = [
|
|
|
15
15
|
`2. For EVERY suggested skill, read its complete \`SKILL.md\` entry and evaluate applicability from \`USE FOR\`, \`DO NOT USE FOR\`, and its basic flow.`,
|
|
16
16
|
`3. Treat the selected workflow topology and numeric limits as planning guidance, not a lock. Choose, combine, reorder, or skip steps when evidence supports it.`,
|
|
17
17
|
`4. Prefer objective verification before declaring done and worktree isolation for broad/Tier-3 mutation.`,
|
|
18
|
-
`5. Use the routing checkpoint as source state for the first Harness Status; do not
|
|
18
|
+
`5. Use the routing checkpoint only as internal source state for the first Harness Status; do not render a competing progress block.`,
|
|
19
19
|
``,
|
|
20
20
|
`## 📣 USER-VISIBLE STATUS (MUST)`,
|
|
21
|
-
`For non-trivial software/project work, this semantic communication contract is mandatory even when the host integration itself is instruction-only:`,
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
`-
|
|
25
|
-
`-
|
|
26
|
-
`-
|
|
21
|
+
`For non-trivial software/project work, this semantic communication contract is mandatory even when the host integration itself is instruction-only. Render this Markdown shape:`,
|
|
22
|
+
`### 🚦 Harness Status`,
|
|
23
|
+
``,
|
|
24
|
+
`- **Current:** <what is being done now>`,
|
|
25
|
+
`- **Read / Evidence:** <one short item inline, or nested bullets when there are multiple items>`,
|
|
26
|
+
`- **Next:** <next intended action>`,
|
|
27
|
+
`- **Risk / Blocked:** <only when materially applicable; omit otherwise>`,
|
|
27
28
|
`Emit it before substantive execution, after a major phase, when direction materially changes, at meaningful long-running phase boundaries, and before final completion. This MUST does not imply a hard runtime lock.`,
|
|
28
29
|
``,
|
|
29
30
|
`## 🤖 COGNITIVE COMPLIANCE`,
|
|
@@ -145,7 +146,7 @@ function buildCodexGlobalContent() {
|
|
|
145
146
|
``,
|
|
146
147
|
`- Discover the environment and host capabilities before relying on them.`,
|
|
147
148
|
`- For software/project work, run \`npx github:dyphn1/Harness-everything next "<summary>"\` before mutation and use the routing checkpoint as source state for the first Harness Status.`,
|
|
148
|
-
`- For non-trivial work, MUST
|
|
149
|
+
`- For non-trivial work, MUST render one Markdown \`### 🚦 Harness Status\` with bullet-aligned bold \`Current\`, \`Read / Evidence\`, \`Next\`, and optional \`Risk / Blocked\`; repeat it at major phase/direction boundaries and before final completion.`,
|
|
149
150
|
`- Read every suggested skill's complete \`SKILL.md\` entry before resolving applicability; do not omit it from metadata or confidence alone.`,
|
|
150
151
|
`- Use the selected workflow topology as planning guidance; the model may adapt or skip steps with an explicit evidence-based reason.`,
|
|
151
152
|
`- Do not impose a universal TODO/TDD/Fable sequence; use the smallest useful topology plus applicable skills.`,
|