harness-everything 0.18.0 → 0.19.0
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 +13 -0
- package/README.md +8 -1
- package/bin/cli.js +16 -0
- package/ci/invariant-routing.test.js +8 -5
- package/ci/mechanism-2ao-plugin-sync.test.js +163 -0
- package/docs/architecture.md +12 -9
- package/docs/platform-capabilities.md +22 -2
- package/docs/platform-compatibility.json +4 -4
- package/docs/routing.md +11 -8
- package/docs/troubleshooting.md +8 -0
- 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 +4 -2
- 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
- package/scripts/plugin-sync.js +465 -0
- package/scripts/plugin-sync.ps1 +5 -0
- package/scripts/plugin-sync.sh +5 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "harness-everything",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.19.0",
|
|
4
4
|
"description": "Harness OS: An Orchestrated Agent Operating System for AI-driven Development",
|
|
5
5
|
"main": "harness-everything/scripts/bootstrap.js",
|
|
6
6
|
"bin": {
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"repo:contract": "node scripts/repository-contract.js",
|
|
18
18
|
"docs:sync": "node scripts/sync-current-docs.js",
|
|
19
19
|
"test:repo-contract": "node ci/repository-contract.test.js",
|
|
20
|
-
"test:consistency": "node ci/consistency-check.js && node ci/doc-capability-consistency.test.js && node ci/repository-contract.test.js",
|
|
20
|
+
"test:consistency": "node ci/consistency-check.js && node ci/doc-capability-consistency.test.js && node ci/repository-contract.test.js && node ci/mechanism-2ao-plugin-sync.test.js",
|
|
21
21
|
"test:docs:capabilities": "node ci/doc-capability-consistency.test.js",
|
|
22
22
|
"test:references": "node ci/reference-check.js",
|
|
23
23
|
"test:release": "node ci/release-consistency-check.js && node ci/mechanism-2x-release-automation.test.js && node ci/mechanism-2x-release-commit-message.test.js",
|
|
@@ -28,10 +28,12 @@
|
|
|
28
28
|
"test:routing": "node ci/routing-check.js",
|
|
29
29
|
"test:routing:invariants": "node ci/invariant-routing.test.js && node ci/router-workflow-plan.test.js && node ci/workflow-execution-contract.test.js",
|
|
30
30
|
"plugin:sync": "node scripts/sync-openai-plugin.js",
|
|
31
|
+
"plugin:hosts": "node scripts/plugin-sync.js",
|
|
31
32
|
"test:plugin:claude": "node ci/mechanism-2z-claude-plugin-manifest.test.js",
|
|
32
33
|
"plugin:claude:stage": "node scripts/stage-claude-plugin.js",
|
|
33
34
|
"plugin:claude:validate": "node scripts/validate-claude-plugin.js",
|
|
34
35
|
"test:plugin:openai": "node ci/openai-plugin-package.test.js && node ci/openai-plugin-runtime.test.js",
|
|
36
|
+
"test:plugin:hosts": "node ci/mechanism-2ao-plugin-sync.test.js",
|
|
35
37
|
"plugin:submission:build": "node scripts/build-openai-submission.js",
|
|
36
38
|
"test:plugin:submission": "node ci/openai-plugin-submission.test.js",
|
|
37
39
|
"test:platform:compatibility": "node ci/mechanism-2w-platform-compatibility.test.js",
|
|
@@ -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.
|
|
4
|
+
"version": "0.19.0",
|
|
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.`,
|