harness-everything 0.12.3 → 0.14.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "harness-everything",
       "source": "./",
       "description": "Harness OS: an orchestrated agent operating system — tier routing, circuit breaker guardrails, verification gates, WAL session memory, and self-evolving workspace rules.",
-      "version": "0.12.3",
+      "version": "0.14.0",
       "author": {
         "name": "Miya Daniel"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "harness-everything",
   "description": "Harness OS: an orchestrated agent operating system — tier routing, circuit breaker guardrails, verification gates, WAL session memory, and self-evolving workspace rules.",
-  "version": "0.12.3",
+  "version": "0.14.0",
   "author": {
     "name": "Miya Daniel"
   },

package/.github/workflows/ci.yml

@@ -82,6 +82,8 @@ jobs:
           chmod +x "$HOME/bin/waza"
           echo "$HOME/bin" >> "$GITHUB_PATH"
           "$HOME/bin/waza" --version
+      - name: Run Harness Waza adapter against canonical skills
+        run: npm run waza:check
       - name: Check every canonical SKILL.md passes waza readiness gates
         run: |
           fail=0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.14.0](https://github.com/dyphn1/Harness-everything/compare/v0.13.0...v0.14.0) (2026-09-20)
+
+### Features
+
+* **contract:** add node npm probe adapter ([02f4044](https://github.com/dyphn1/Harness-everything/commit/02f4044c82a6cb082d4b8e4fe810071afe064c21))
+* **contract:** add packaged node probe adapter ([de72904](https://github.com/dyphn1/Harness-everything/commit/de7290434346cdc358ea119845c72ddca3ea0090))
+* **contract:** package node probe adapter runtime ([783dc8f](https://github.com/dyphn1/Harness-everything/commit/783dc8f891a3244461f3dfe154542bad15125f15))
+
+### Bug Fixes
+
+* **contract:** close linked-workspace isolation gap ([574ea2f](https://github.com/dyphn1/Harness-everything/commit/574ea2f299ae02aa93785cca7aa5b4a829e9f961))
+* **contract:** launch npm probes cross-platform ([b39b2c0](https://github.com/dyphn1/Harness-everything/commit/b39b2c09a223c64d3665d383852a6313fff888fc))
+* **contract:** launch npm probes cross-platform ([723bae1](https://github.com/dyphn1/Harness-everything/commit/723bae19ac4a05bfefe44ad0d61bd5dfb8b0ba50))
+* **contract:** reject symlink probe escapes ([bf577a5](https://github.com/dyphn1/Harness-everything/commit/bf577a5b58dec2a4779709402146073f0fd0ce29))
+* **contract:** reject symlink probe escapes ([5e3c569](https://github.com/dyphn1/Harness-everything/commit/5e3c569b1b7b883490e40fd66a64385f2d24d717))
+
+## [0.13.0](https://github.com/dyphn1/Harness-everything/compare/v0.12.3...v0.13.0) (2026-09-19)
+
+### Features
+
+* **waza:** expose non-link readiness failures ([f9c7d24](https://github.com/dyphn1/Harness-everything/commit/f9c7d242eece2af76fd68a6686eaa9521dcce443))
+
+### Bug Fixes
+
+* **waza:** add Harness reference adapter ([5223690](https://github.com/dyphn1/Harness-everything/commit/52236905be8a3660b89bf43396ea3d7bca984126))
+* **waza:** align reference adapter with main ([87b634d](https://github.com/dyphn1/Harness-everything/commit/87b634df1d5d7de57b1c5ca45e8505423764e240))
+* **waza:** normalize template and repo-scope links ([25558ca](https://github.com/dyphn1/Harness-everything/commit/25558caaa39b8bafb4a825c1299ff746ffbae91b))
+* **waza:** preserve Harness placeholder delimiters ([f697ae8](https://github.com/dyphn1/Harness-everything/commit/f697ae83b6de54718b2e969041adfaa20b5e8efc))
+* **waza:** scope checks to canonical skills ([de7b78b](https://github.com/dyphn1/Harness-everything/commit/de7b78b1702b412466337a1ea84ec524cf864e60))
+
 ## [0.12.3](https://github.com/dyphn1/Harness-everything/compare/v0.12.2...v0.12.3) (2026-09-19)
 
 ### Bug Fixes

package/ci/mechanism-2aj-waza-reference-adapter.test.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+'use strict';
+
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const { discoverSkills, extractCandidates } = require('./reference-check');
+const {
+  harnessReachableReferenceFiles,
+  classifyReportedLink,
+  normalizeSkillReport,
+  normalizeReport,
+  runCanonicalWazaChecks,
+} = require('../scripts/waza-harness-check');
+
+let passed = 0;
+function check(value, message) {
+  assert.ok(value, message);
+  passed++;
+  console.log('PASS ' + message);
+}
+
+const skills = discoverSkills(ROOT);
+check(skills.length >= 20, 'discovers the canonical Harness skill set');
+
+const invoked = [];
+const fakeSpawn = (command, args, options) => {
+  invoked.push({ command, args, cwd: options.cwd });
+  const skillPath = args[1];
+  const name = path.basename(skillPath);
+  return {
+    status: 0,
+    stdout: JSON.stringify({
+      timestamp: new Date(0).toISOString(),
+      skills: [{
+        name,
+        path: path.join(skillPath, 'SKILL.md'),
+        ready: true,
+        compliance: { level: 'High' },
+        tokenBudget: { exceeded: false },
+        specCompliance: [],
+        links: { passed: true },
+      }],
+    }),
+    stderr: '',
+  };
+};
+const scoped = runCanonicalWazaChecks(ROOT, 'waza', fakeSpawn);
+check(scoped.skills.length === skills.length && invoked.length === skills.length,
+  'adapter invokes Waza exactly once per canonical top-level skill');
+check(invoked.every((call, index) =>
+  call.command === 'waza' &&
+  call.args[0] === 'check' &&
+  call.args[1] === path.join(ROOT, skills[index]) &&
+  call.args[2] === '--format' &&
+  call.args[3] === 'json' &&
+  call.cwd === ROOT),
+  'Waza receives explicit canonical skill paths instead of recursive workspace discovery');
+
+let skillsWithPlaceholderReferences = 0;
+let totalResolved = 0;
+for (const skill of skills) {
+  const skillFile = path.join(ROOT, skill, 'SKILL.md');
+  const text = fs.readFileSync(skillFile, 'utf8');
+  const directReferenceTargets = extractCandidates(text)
+    .filter(value => /^<this-skill-dir>\/references\//.test(value))
+    .map(value => value.replace(/^<this-skill-dir>\//, ''));
+  if (!directReferenceTargets.length) continue;
+
+  skillsWithPlaceholderReferences++;
+  const reachable = harnessReachableReferenceFiles(ROOT, skill);
+  for (const target of directReferenceTargets) {
+    check(reachable.has(target), skill + ' placeholder reference is reachable: ' + target);
+  }
+
+  const simulated = {
+    name: skill,
+    path: path.join(ROOT, skill),
+    ready: false,
+    compliance: { level: 'High' },
+    tokenBudget: { exceeded: false },
+    specCompliance: [{ name: 'spec-frontmatter', passed: true }],
+    schema: { valid: true },
+    links: {
+      passed: false,
+      orphanedFiles: [...new Set(directReferenceTargets)],
+    },
+  };
+  const normalized = normalizeSkillReport(ROOT, simulated);
+  check(normalized.harnessCompatibility.remainingOrphanedFiles.length === 0,
+    skill + ' removes Waza orphan advisories for Harness-reachable references');
+  check(normalized.harnessCompatibility.resolvedPlaceholderOrphans.length === new Set(directReferenceTargets).size,
+    skill + ' reports the suppressed advisories explicitly');
+  check(normalized.harnessCompatibility.harnessReady === true,
+    skill + ' recomputes readiness without false local-orphan failures');
+  totalResolved += normalized.harnessCompatibility.resolvedPlaceholderOrphans.length;
+}
+
+check(skillsWithPlaceholderReferences > 0, 'at least one canonical skill uses the Harness placeholder reference contract');
+check(totalResolved > 0, 'adapter resolves canonical placeholder-orphan advisories');
+
+const nestedReferenceContract = {
+  'fable-mode': ['references/execution-phases.md'],
+  'harness-everything': ['references/router-workflow-plan.md', 'references/skill-registry.md'],
+  'multi-agent-workspace': ['references/agency-agents.md'],
+  'skill-creator': [
+    'references/authoring-workflow.md',
+    'references/testing-workflow.md',
+    'references/quality-principles.md',
+    'references/dynamic-generation-contract.md',
+  ],
+  tdd: ['references/quality-model.md', 'references/unit-testing.md', 'references/integration-testing.md'],
+};
+for (const [skill, expected] of Object.entries(nestedReferenceContract)) {
+  const reachable = harnessReachableReferenceFiles(ROOT, skill);
+  for (const reference of expected) {
+    check(reachable.has(reference), skill + ' nested reference remains reachable: ' + reference);
+  }
+  const normalized = normalizeSkillReport(ROOT, {
+    name: skill,
+    path: path.join(ROOT, skill),
+    ready: false,
+    compliance: { level: 'High' },
+    tokenBudget: { exceeded: false },
+    specCompliance: [],
+    links: { passed: false, orphanedFiles: expected },
+  });
+  check(normalized.harnessCompatibility.remainingOrphanedFiles.length === 0,
+    skill + ' nested reference advisories are resolved through the reachable reference graph');
+}
+
+const fableContract = classifyReportedLink(ROOT, 'fable-mode', {
+  source: 'SKILL.md',
+  target: '<skills-repo-root>/harness-everything/scripts/verify-gate.js',
+  reason: 'link escapes skill directory',
+});
+check(fableContract.category === 'resolved-contract',
+  '<skills-repo-root> existing target is a resolved Harness contract link');
+
+const genericTemplate = classifyReportedLink(ROOT, 'repo-docs', {
+  source: 'SKILL.md',
+  target: '<workspace>/docs/generated.md',
+  reason: 'target does not exist',
+});
+check(genericTemplate.category === 'template',
+  'generic runtime placeholder is classified as a template advisory');
+
+const badPlaceholder = classifyReportedLink(ROOT, 'repo-docs', {
+  source: 'SKILL.md',
+  target: '<this-folder>/references/missing.md',
+  reason: 'target does not exist',
+});
+check(badPlaceholder.category === 'local',
+  'unknown placeholder remains a real local-link problem');
+
+const repoScopeLink = classifyReportedLink(ROOT, 'multi-agent-workspace', {
+  source: 'workflows/01-init.md',
+  target: '../../README.md#supported-ai-ides--tools',
+  reason: 'link escapes skill directory',
+});
+check(repoScopeLink.category === 'resolved-contract' && repoScopeLink.issue.resolved === 'README.md',
+  'existing repo-scope relative link is resolved by the Harness repository contract');
+
+const missingRepoScopeLink = classifyReportedLink(ROOT, 'multi-agent-workspace', {
+  source: 'workflows/01-init.md',
+  target: '../../definitely-missing.md',
+  reason: 'link escapes skill directory',
+});
+check(missingRepoScopeLink.category === 'local',
+  'missing repo-scope relative link remains a hard local-link problem');
+
+const templateLink = classifyReportedLink(ROOT, 'repo-docs', {
+  source: 'templates/multi-skills-readme-template.md',
+  target: './skills/category/{skill-name}/SKILL.md',
+  reason: 'target does not exist',
+});
+check(templateLink.category === 'template',
+  'links inside generated-document templates remain visible template advisories');
+
+const synthetic = normalizeReport(ROOT, {
+  timestamp: new Date(0).toISOString(),
+  skills: [{
+    name: 'harness-everything',
+    path: path.join(ROOT, 'harness-everything'),
+    ready: false,
+    compliance: { level: 'High' },
+    tokenBudget: { exceeded: false },
+    specCompliance: [{ name: 'spec-frontmatter', passed: true }],
+    links: {
+      passed: false,
+      orphanedFiles: ['references/triage-and-tiers.md'],
+      deadURLs: [{ source: 'SKILL.md', target: 'https://example.invalid', reason: 'DNS lookup failed' }],
+      brokenLinks: [{ source: 'SKILL.md', target: '<workspace>/generated.md', reason: 'target does not exist' }],
+    },
+  }],
+});
+const compatibility = synthetic.skills[0].harnessCompatibility;
+check(compatibility.localLinksPassed === true,
+  'network and generic-template findings do not masquerade as broken local links');
+check(compatibility.networkAdvisories.length === 1 && compatibility.templateAdvisories.length === 1,
+  'network and template findings are retained in separate advisory categories');
+check(compatibility.harnessReady === true,
+  'normalized readiness remains green when only false-orphan/network/template advisories remain');
+
+const nonLinkFailure = normalizeSkillReport(ROOT, {
+  name: 'repo-docs',
+  path: path.join(ROOT, 'repo-docs'),
+  ready: false,
+  compliance: { level: 'Medium' },
+  tokenBudget: { exceeded: true },
+  specCompliance: [{ name: 'frontmatter', passed: false }],
+  schema: { valid: false },
+  links: { passed: true },
+});
+check(nonLinkFailure.harnessCompatibility.harnessReady === false &&
+  nonLinkFailure.harnessCompatibility.nonLinkFailures.includes('compliance:Medium') &&
+  nonLinkFailure.harnessCompatibility.nonLinkFailures.includes('token-budget-exceeded') &&
+  nonLinkFailure.harnessCompatibility.nonLinkFailures.includes('spec:frontmatter') &&
+  nonLinkFailure.harnessCompatibility.nonLinkFailures.includes('schema-invalid'),
+  'non-link readiness failures remain explicit machine-readable blockers');
+
+console.log('PASS: Waza/Harness reference adapter (' + passed + ' assertions across ' + skills.length + ' skills)');

package/ci/mechanism-2ak-contract-probe-adapter.test.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+'use strict';
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const FIXTURE = path.join(ROOT, 'contract-integrity', 'fixtures', 'node-probe-project');
+const ADAPTER = path.join(ROOT, 'contract-integrity', 'scripts', 'node-probe-adapter.js');
+const { applyProbe, executePlan, validatePlan } = require(ADAPTER);
+const { evaluateTrace } = require(path.join(ROOT, 'contract-integrity', 'scripts', 'audit.js'));
+
+let failed = 0;
+function check(condition, message, detail = '') {
+  if (condition) console.log('  PASS ' + message);
+  else {
+    console.error('  FAIL ' + message + (detail ? ' — ' + detail : ''));
+    failed++;
+  }
+}
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function json(file) {
+  return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+function digest(file) {
+  return require('crypto').createHash('sha256').update(fs.readFileSync(file)).digest('hex');
+}
+
+console.log('=== Contract Integrity Phase 3 Node Probe Adapter (#84) ===');
+
+const plan = json(path.join(FIXTURE, 'probe-plan.json'));
+check(validatePlan(plan).length === 0, 'declared node-npm-v1 probe plan validates');
+
+const beforeSource = digest(path.join(FIXTURE, 'src', 'limit.js'));
+const beforeTest = digest(path.join(FIXTURE, 'test', 'contract.test.js'));
+const protectedReport = executePlan(FIXTURE, plan);
+check(protectedReport.result === 'PROTECTED', 'green baseline plus both explicit probes produces PROTECTED evidence');
+check(protectedReport.probes.length === 2 && protectedReport.probes.every(probe =>
+  probe.status === 'KILLED' && probe.failureClass === 'contract' && probe.workspaceIsolation === 'isolated'),
+  'env and exact-replace probes are killed only by expected contract failures');
+check(digest(path.join(FIXTURE, 'src', 'limit.js')) === beforeSource &&
+  digest(path.join(FIXTURE, 'test', 'contract.test.js')) === beforeTest,
+  'adapter never mutates the source workspace');
+check(!JSON.stringify(protectedReport).includes('out-of-range input must be rejected'),
+  'probe report retains output hashes/evidence refs instead of project test output');
+
+const trace = json(path.join(ROOT, 'contract-integrity', 'fixtures', 'consistent-trace.json'));
+trace.probes = protectedReport.probes.filter(probe => probe.probeId === 'PROBE-001').map(probe => ({
+  probeId: probe.probeId,
+  requirementId: probe.requirementId,
+  status: probe.status,
+  sourceSection: probe.sourceSection,
+  evidenceRef: probe.evidenceRef,
+  workspaceIsolation: probe.workspaceIsolation,
+  failureClass: probe.failureClass,
+}));
+const tdd = json(path.join(ROOT, 'tdd', 'fixtures', 'pass-evidence.json'));
+tdd.requirements[0].source.path = 'docs/specs/api.md';
+tdd.requirements[0].source.section = 'REQ-001';
+const integrated = evaluateTrace(trace, { tddEvidence: tdd });
+check(integrated.result === 'PASS' && integrated.scores.protectionScore === 100,
+  'derived adapter evidence feeds the existing #84/#58 strict integrity gate');
+
+const survivingPlan = clone(plan);
+survivingPlan.probes = [clone(plan.probes[0])];
+survivingPlan.probes[0].env.HARNESS_CONTRACT_PROBE = 'noop';
+const surviving = executePlan(FIXTURE, survivingPlan);
+check(surviving.result === 'SURVIVED' && surviving.probes[0].status === 'SURVIVED',
+  'green test run under a required probe is explicitly SURVIVED, never PASS');
+const weakTrace = clone(trace);
+weakTrace.probes[0] = {
+  probeId: surviving.probes[0].probeId,
+  requirementId: surviving.probes[0].requirementId,
+  status: surviving.probes[0].status,
+  sourceSection: surviving.probes[0].sourceSection,
+  evidenceRef: surviving.probes[0].evidenceRef,
+  workspaceIsolation: surviving.probes[0].workspaceIsolation,
+  failureClass: surviving.probes[0].failureClass,
+};
+const weakAudit = evaluateTrace(weakTrace, { tddEvidence: tdd });
+check(weakAudit.result === 'FAIL' && weakAudit.scores.completenessScore === 100 &&
+  weakAudit.scores.protectionScore === 0,
+  'green but weak suite cannot compensate 100 completeness with a surviving contract probe');
+
+const unrelatedPlan = clone(plan);
+unrelatedPlan.probes = [clone(plan.probes[0])];
+unrelatedPlan.probes[0].expectedFailureContains = 'THIS-MARKER-DOES-NOT-EXIST';
+const unrelated = executePlan(FIXTURE, unrelatedPlan);
+check(unrelated.probes[0].status === 'INVALID' && unrelated.probes[0].failureClass === 'unknown',
+  'unrelated failing test output is INVALID and cannot be credited as a kill');
+
+const ambiguousReplace = clone(plan);
+ambiguousReplace.probes = [clone(plan.probes[1])];
+ambiguousReplace.probes[0].find = 'return';
+const ambiguous = executePlan(FIXTURE, ambiguousReplace);
+check(ambiguous.probes[0].status === 'NOT_EVALUATED' &&
+  /exactly once/.test(ambiguous.probes[0].adapterReason),
+  'ambiguous exact-replace fallback fails closed without mutating source');
+
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'harness-contract-adapter-test-'));
+try {
+  const symlinkWorkspace = path.join(temp, 'symlink-workspace');
+  fs.mkdirSync(symlinkWorkspace, { recursive: true });
+  const outsideDir = path.join(temp, 'outside-dir');
+  fs.mkdirSync(outsideDir, { recursive: true });
+  const outsideTarget = path.join(outsideDir, 'outside.txt');
+  fs.writeFileSync(outsideTarget, 'SAFE', 'utf8');
+  fs.symlinkSync(outsideDir, path.join(symlinkWorkspace, 'linked-dir'),
+    process.platform === 'win32' ? 'junction' : 'dir');
+  let symlinkRejected = false;
+  try {
+    applyProbe(symlinkWorkspace, {
+      strategy: 'replace',
+      target: path.join('linked-dir', 'outside.txt'),
+      find: 'SAFE',
+      replace: 'MUTATED',
+    });
+  } catch (error) {
+    symlinkRejected = /symbolic link|reparse-point|outside isolated workspace/.test(String(error.message || error));
+  }
+  check(symlinkRejected && fs.readFileSync(outsideTarget, 'utf8') === 'SAFE',
+    'replace probe rejects symlink/junction escape without mutating outside the isolated workspace');
+
+  const linkedProject = path.join(temp, 'linked-project');
+  fs.mkdirSync(linkedProject, { recursive: true });
+  fs.writeFileSync(path.join(linkedProject, 'package.json'), JSON.stringify({
+    name: 'linked-project',
+    scripts: { contract: 'node test.js' },
+  }), 'utf8');
+  fs.writeFileSync(path.join(linkedProject, 'test.js'), [
+    "const fs = require('fs');",
+    "const path = require('path');",
+    "fs.writeFileSync(path.join(__dirname, 'linked-dir', 'outside.txt'), 'MUTATED', 'utf8');",
+  ].join('\n'), 'utf8');
+  fs.symlinkSync(outsideDir, path.join(linkedProject, 'linked-dir'),
+    process.platform === 'win32' ? 'junction' : 'dir');
+  const linkedPlan = {
+    schemaVersion: '1.0.0',
+    adapter: 'node-npm-v1',
+    script: 'contract',
+    probes: [{
+      probeId: 'PROBE-LINK',
+      requirementId: 'REQ-LINK',
+      sourceSection: 'Linked workspace',
+      strategy: 'env',
+      expectedFailureContains: 'unused',
+      env: { HARNESS_CONTRACT_PROBE: 'link' },
+    }],
+  };
+  const linkedReport = executePlan(linkedProject, linkedPlan);
+  check(linkedReport.result === 'NOT_EVALUATED' &&
+    linkedReport.baseline.workspaceIsolation === 'not-isolated' &&
+    linkedReport.probes.every(probe => probe.workspaceIsolation === 'not-isolated') &&
+    fs.readFileSync(outsideTarget, 'utf8') === 'SAFE',
+    'workspace copy rejects source symlinks/junctions before project code can mutate an outside target');
+
+  const dependent = path.join(temp, 'dependent');
+  fs.cpSync(FIXTURE, dependent, { recursive: true });
+  const pkg = json(path.join(dependent, 'package.json'));
+  pkg.dependencies = { leftpad: '1.0.0' };
+  fs.writeFileSync(path.join(dependent, 'package.json'), JSON.stringify(pkg, null, 2), 'utf8');
+  const dependencyReport = executePlan(dependent, plan);
+  check(dependencyReport.result === 'NOT_EVALUATED' &&
+    dependencyReport.discovery.reason === 'external-dependencies-not-supported-v1',
+    'v1 adapter refuses to infer/install external dependencies');
+
+  const broken = path.join(temp, 'broken');
+  fs.cpSync(FIXTURE, broken, { recursive: true });
+  fs.appendFileSync(path.join(broken, 'test', 'contract.test.js'), "\nthrow new Error('baseline fixture failure');\n", 'utf8');
+  const baselineFailure = executePlan(broken, plan);
+  check(baselineFailure.result === 'NOT_EVALUATED' &&
+    baselineFailure.baseline.status === 'FAIL' &&
+    baselineFailure.probes.every(probe => probe.status === 'NOT_EVALUATED'),
+    'non-green baseline blocks all protection claims');
+} finally {
+  fs.rmSync(temp, { recursive: true, force: true });
+}
+
+const invalidPlan = clone(plan);
+invalidPlan.probes[0].target = '../escape.js';
+invalidPlan.probes[0].strategy = 'replace';
+invalidPlan.probes[0].find = 'x';
+invalidPlan.probes[0].replace = 'y';
+delete invalidPlan.probes[0].env;
+check(validatePlan(invalidPlan).some(error => /repo-relative/.test(error)),
+  'probe plan rejects replace targets that escape the isolated workspace');
+
+const protectedCli = spawnSync(process.execPath, [
+  ADAPTER, '--workspace', FIXTURE, '--plan', path.join(FIXTURE, 'probe-plan.json'),
+], { encoding: 'utf8' });
+check(protectedCli.status === 0 && /"result": "PROTECTED"/.test(protectedCli.stdout),
+  'CLI returns exit 0 only for fully killed declared probes', protectedCli.stderr);
+
+const docs = fs.readFileSync(path.join(ROOT, 'contract-integrity', 'ADAPTERS.md'), 'utf8');
+check(/does \*\*not\*\* claim generic mutation-testing support/.test(docs) &&
+  /zero external npm dependencies/.test(docs) &&
+  /Not yet supported/.test(docs),
+  'adapter documentation states exact supported scope and explicit non-support');
+
+console.log('\n' + (failed === 0 ? 'PASS' : 'FAIL') +
+  ': #84 contract protection node adapter (' + failed + ' failure' + (failed === 1 ? '' : 's') + ')');
+process.exit(failed === 0 ? 0 : 1);

package/ci/openai-plugin-package.test.js

@@ -120,6 +120,16 @@ assert.doesNotMatch(packagedAuditSource, /\.\.\/\.\.\/tdd\/scripts\/quality-gate
 const packagedAudit = require(packagedContractAudit);
 assert.strictEqual(typeof packagedAudit.runCli, 'function', 'packaged contract audit runtime must load and export runCli');
 
+const packagedProbeAdapter = path.join(PLUGIN, 'contract-integrity', 'scripts', 'node-probe-adapter.js');
+const packagedAdapterDocs = path.join(PLUGIN, 'contract-integrity', 'ADAPTERS.md');
+assert.ok(fs.existsSync(packagedProbeAdapter) && fs.existsSync(packagedAdapterDocs),
+  'OpenAI package must include shared contract-probe adapter runtime and support boundary docs');
+const packagedAdapter = require(packagedProbeAdapter);
+assert.strictEqual(packagedAdapter.ADAPTER, 'node-npm-v1',
+  'packaged contract-probe adapter must load without becoming a routed skill');
+assert.match(fs.readFileSync(packagedAdapterDocs, 'utf8'), /does \*\*not\*\* claim generic mutation-testing support/,
+  'packaged adapter docs must preserve the narrow support boundary');
+
 const verificationContractWrapper = path.join(PLUGIN, 'skills', 'verification-loop', 'scripts', 'contract-integrity-audit.js');
 assert.ok(fs.existsSync(verificationContractWrapper), 'verification-loop must package its contract audit wrapper');
 const verificationWrapper = require(verificationContractWrapper);

package/contract-integrity/ADAPTERS.md

@@ -0,0 +1,37 @@
+# Contract Protection Adapters
+
+This directory does **not** claim generic mutation-testing support.
+
+## Supported in Phase 3
+
+### `node-npm-v1`
+
+Supported project shape:
+
+- Node.js project with a `package.json`;
+- one explicitly selected npm script used as the contract-test command;
+- **zero external npm dependencies** for this first adapter revision;
+- probes are predeclared in a local JSON plan and tied to stable `REQ-*` IDs and authoritative source sections;
+- every baseline and probe run executes in a fresh temporary copy; the source workspace is never mutated.
+
+Source workspaces containing symbolic-link or junction entries are rejected before project code runs. The v1 adapter does not claim isolation when a copied path could retain an external filesystem target.
+
+Supported probe strategies:
+
+1. **`env`** — explicit project-owned fault injection via environment variables.
+2. **`replace`** — exact one-occurrence text replacement in the isolated copy only. This is the fallback when the project has no built-in fault-injection seam.
+
+A probe is `KILLED` only when the selected npm script fails **and** its output contains the predeclared requirement-specific observable marker. A green run is `SURVIVED`. Timeout/spawn failures, baseline failures, unsafe/ambiguous replacement, missing dependencies, or unrelated failures are `NOT_EVALUATED` / `INVALID`; none of those earn protection credit.
+
+The adapter does not install dependencies, access the network, infer mutation locations, rewrite source documents, or commit generated probes.
+
+## Not yet supported
+
+- arbitrary Jest/Vitest/Mocha/Pytest/Go/Rust/.NET adapter discovery;
+- projects that require dependency installation inside the isolated copy;
+- automatic source-derived mutation synthesis;
+- compiler-failure-as-kill;
+- flaky-test attribution;
+- dirty-worktree mutation or in-place production changes.
+
+Those remain future adapters/slices. Phase 3 intentionally proves one narrow real runner plus an explicit isolated fault-injection fallback.

package/contract-integrity/fixtures/node-probe-project/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "contract-probe-fixture",
+  "private": true,
+  "version": "1.0.0",
+  "scripts": {
+    "test:contract": "node --test test/contract.test.js"
+  }
+}

package/contract-integrity/fixtures/node-probe-project/probe-plan.json

@@ -0,0 +1,27 @@
+{
+  "schemaVersion": "1.0.0",
+  "adapter": "node-npm-v1",
+  "script": "test:contract",
+  "probes": [
+    {
+      "probeId": "PROBE-001",
+      "requirementId": "REQ-001",
+      "sourceSection": "docs/specs/api.md#REQ-001",
+      "strategy": "env",
+      "env": {
+        "HARNESS_CONTRACT_PROBE": "accept-invalid"
+      },
+      "expectedFailureContains": "[REQ-001]"
+    },
+    {
+      "probeId": "PROBE-REPLACE",
+      "requirementId": "REQ-001",
+      "sourceSection": "docs/specs/api.md#REQ-001",
+      "strategy": "replace",
+      "target": "src/limit.js",
+      "find": "return Number.isInteger(value) && value >= 1 && value <= 10;",
+      "replace": "return true;",
+      "expectedFailureContains": "[REQ-001]"
+    }
+  ]
+}

package/contract-integrity/fixtures/node-probe-project/src/limit.js

@@ -0,0 +1,8 @@
+'use strict';
+
+function acceptsLimit(value) {
+  if (process.env.HARNESS_CONTRACT_PROBE === 'accept-invalid') return true;
+  return Number.isInteger(value) && value >= 1 && value <= 10;
+}
+
+module.exports = { acceptsLimit };

package/contract-integrity/fixtures/node-probe-project/test/contract.test.js

@@ -0,0 +1,14 @@
+'use strict';
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const { acceptsLimit } = require('../src/limit');
+
+test('[REQ-001] accepts supported boundary', () => {
+  assert.equal(acceptsLimit(1), true);
+  assert.equal(acceptsLimit(10), true);
+});
+
+test('[REQ-001] rejects out-of-range input', () => {
+  assert.equal(acceptsLimit(0), false, '[REQ-001] out-of-range input must be rejected');
+});