@jinn-network/client 0.1.8 → 0.1.9-canary.023faefb

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@jinn-network/client",
-  "version": "0.1.8",
+  "version": "0.1.9-canary.023faefb",
   "description": "Jinn protocol client — headless daemon for the restoration training loop",
   "type": "module",
   "packageManager": "yarn@4.13.0",
   "workspaces": [
-    "src/dashboard/spa"
+    "src/dashboard/spa",
+    "packages/*"
   ],
   "license": "MIT",
   "repository": {
@@ -19,6 +20,8 @@
   "bin": {
     "client": "./dist/bin/jinn.js",
     "jinn": "./dist/bin/jinn.js",
+    "jinn-distil-mcp": "./dist/bin/jinn-distil-mcp.js",
+    "jinn-layer": "./dist/bin/jinn-layer.js",
     "jinn-stop-hook": "./dist/bin/jinn-stop-hook.js"
   },
   "main": "./dist/index.js",
@@ -41,15 +44,21 @@
   "scripts": {
     "postinstall": "node dist/scripts/fix-node-pty.mjs 2>/dev/null || node scripts/fix-node-pty.mjs 2>/dev/null || true",
     "e2e:cold-start-builder": "vitest run --config vitest.acceptance.config.ts",
-    "e2e:full-cycle": "tsx test/e2e/learner-full-cycle.ts",
-    "e2e:full-cycle-swe-rebench-v2": "tsx test/e2e/learner-full-cycle-swe-rebench-v2.ts",
+    "e2e:full-cycle": "yarn build:sdk && tsx test/e2e/learner-full-cycle.ts",
+    "e2e:full-cycle-swe-rebench-v2": "yarn build:sdk && tsx test/e2e/learner-full-cycle-swe-rebench-v2.ts",
+    "e2e:train-arm-slope": "tsx test/e2e/train-arm-slope-swe-rebench-v2.ts",
+    "e2e:train-arm-efficacy": "tsx test/e2e/train-arm-efficacy-swe-rebench-v2.ts",
     "jinn": "tsx src/bin/jinn.ts",
+    "jinn-layer": "tsx packages/harness-layer/src/bin/jinn-layer.ts",
+    "typecheck:harness-layer": "tsc --noEmit -p packages/harness-layer/tsconfig.json",
     "dev": "yarn build && node dist/bin/jinn.js",
     "build:sdk": "yarn --cwd ../packages/sdk install --immutable && yarn --cwd ../packages/sdk build",
-    "build": "yarn build:sdk && yarn build:spa && tsc && chmod +x dist/bin/jinn.js && rm -rf dist/dashboard && mkdir -p dist/dashboard && cp -R src/dashboard/spa/dist/. dist/dashboard/ && rm -rf dist/templates && cp -R templates dist/templates && rm -rf dist/plugins/learner && mkdir -p dist/plugins && cp -R plugins/learner dist/plugins/learner && mkdir -p dist/scripts && cp scripts/fix-node-pty.mjs scripts/swe-rebench-v2-seed-pool.json scripts/swe-rebench-v2-known-bad.json scripts/swe-rebench-v2-pytest-missing.json dist/scripts/ && node scripts/vendor-sdk.mjs && node scripts/write-dist-build-meta.mjs",
-    "typecheck": "yarn build:sdk && tsc --noEmit",
-    "test": "yarn build:sdk && vitest run",
+    "build": "yarn build:sdk && yarn build:spa && tsc && chmod +x dist/bin/jinn.js && node scripts/bundle-jinn-layer.mjs && rm -rf dist/dashboard && mkdir -p dist/dashboard && cp -R src/dashboard/spa/dist/. dist/dashboard/ && rm -rf dist/templates && cp -R templates dist/templates && rm -rf dist/plugins/learner dist/plugins/local-trace-distiller && mkdir -p dist/plugins && cp -R plugins/learner dist/plugins/learner && cp -R plugins/local-trace-distiller dist/plugins/local-trace-distiller && mkdir -p dist/scripts && cp scripts/fix-node-pty.mjs scripts/swe-rebench-v2-seed-pool.json scripts/swe-rebench-v2-known-bad.json scripts/swe-rebench-v2-pytest-missing.json dist/scripts/ && mkdir -p dist/solver-types/slates && cp src/solver-types/slates/*.json dist/solver-types/slates/ && node scripts/vendor-sdk.mjs && node scripts/write-dist-build-meta.mjs && yarn typecheck:harness-layer",
+    "typecheck": "yarn build:sdk && tsc --noEmit && yarn typecheck:harness-layer",
     "lint:no-late-mount": "node scripts/check-no-late-route-mount.mjs",
+    "test": "yarn build:sdk && vitest run",
+    "test:hermetic": "yarn build:sdk && vitest run --config vitest.hermetic.config.ts",
+    "smoke:build-anvil-snapshot": "vitest run test/scripts/build-anvil-snapshot-entrypoint.test.ts",
     "test:watch": "vitest",
     "test:claude-prediction": "yarn build && JINN_TEST_CLAUDE_PREDICTION=1 vitest run test/harnesses/impls/claude-mcp-prediction/isolation.test.ts",
     "test:claude-prediction-apy": "yarn build && JINN_TEST_CLAUDE_PREDICTION_APY=1 vitest run test/harnesses/impls/claude-mcp-prediction-apy/isolation.test.ts",
@@ -62,15 +71,12 @@
     "release:tier-1": "tsx scripts/release/run-tier-1.ts",
     "release:tier-1:T1.1": "vitest run --config vitest.release-tier-1.config.ts test/release/tier-1/T1.1-bootstrap-fresh-anvil.test.ts",
     "release:tier-1:T1.2": "vitest run --config vitest.release-tier-1.config.ts test/release/tier-1/T1.2-harness-readiness-contract.test.ts",
-    "release:tier-1:T1.3": "vitest run test/release/tier-1/T1.3-indexer-round-trip.test.ts",
     "release:tier-1:T1.4": "playwright test --config=playwright.config.ts test/dashboard/release-prep/spa-route-smoke.e2e.test.ts",
     "release:tier-2": "tsx scripts/release/run-tier-2.ts",
-    "release:tier-2:T2.1": "vitest run test/release/tier-2/T2.1-cross-op-donation.test.ts",
     "release:tier-2:T2.2": "vitest run test/release/tier-2/T2.2-producer-evaluator.test.ts",
-    "release:tier-2:T2.3": "playwright test --config=playwright.config.ts test/dashboard/multi-op/launcher-join-flow.e2e.test.ts",
     "release:tier-3": "tsx scripts/release/run-tier-3.ts",
     "release:tier-3:T3.1": "JINN_T31_REAL=1 vitest run test/release/tier-3/T3.1-producer-evaluator-real.test.ts",
-    "release:donation-consumption": "node dist/scripts/donation-consumption-acceptance.js",
+    "release:olas-rails-smoke": "tsx scripts/release/olas-rails-smoke.ts",
     "setup:testnet-acceptance-operator": "node scripts/setup-testnet-acceptance-operator-docker.mjs",
     "setup:testnet-acceptance-operator:docker": "node scripts/setup-testnet-acceptance-operator-docker.mjs",
     "setup:testnet-acceptance-operator:host": "node scripts/setup-testnet-acceptance-operator.mjs",
@@ -78,12 +84,13 @@
     "release:testnet-acceptance:docker": "node scripts/testnet-acceptance-docker.mjs",
     "release:testnet-acceptance:host": "node scripts/testnet-acceptance.mjs",
     "status": "tsx scripts/status.ts",
+    "audit:failures": "tsx scripts/audit-task-run-failures.ts",
+    "net-liveness": "tsx scripts/net-liveness-probe.ts",
     "cleanup:engine-work": "tsx scripts/cleanup-engine-work.ts",
     "e2e": "tsx test/e2e/validate.ts",
     "e2e:task-first-local": "tsx test/e2e/task-first-local.ts",
     "e2e:claude-code-learner": "tsx test/e2e/claude-code-learner-portfolio-v0.ts",
     "e2e:prediction": "tsx test/e2e/prediction-v1.ts",
-    "e2e:corpus": "yarn build:sdk && tsx test/e2e/corpus-x402.ts",
     "e2e:freeze-mode": "tsx test/e2e/freeze-mode.test.ts",
     "e2e:checkpoint-flow": "tsx test/e2e/checkpoint-flow.test.ts",
     "e2e:swe-rebench-v2": "tsx test/e2e/swe-rebench-v2.test.ts",
@@ -103,6 +110,8 @@
     "dev:spa": "yarn workspace @jinn-network/operator-spa dev",
     "e2e:spa": "yarn build && playwright test --config=playwright.config.ts test/dashboard/spa.e2e.test.ts",
     "e2e:solvernet-flow": "yarn build && playwright test --config=playwright.config.ts test/dashboard/solvernet-flow.e2e.test.ts",
+    "e2e:join": "yarn build && playwright test --config=playwright.config.ts test/dashboard/join.e2e.test.ts",
+    "e2e:app-flow": "yarn build && playwright test --config=playwright.config.ts test/dashboard/solvernet-flow.e2e.test.ts test/dashboard/join.e2e.test.ts",
     "e2e:funding-sequence": "yarn build && playwright test --config=playwright.config.ts test/dashboard/funding-sequence.e2e.test.ts",
     "e2e:dashboard": "yarn build && playwright test --config=playwright.config.ts",
     "e2e:donation": "vitest run test/smoke/donation-mode-smoke.test.ts test/smoke/donation-ipfs-http-smoke.test.ts"
@@ -115,43 +124,48 @@
   "dependencies": {
     "@ethereumjs/wallet": "^10.0.0",
     "@grpc/grpc-js": "^1.14.3",
-    "@hono/node-server": "^1.19.12",
+    "@hono/node-server": "^2.0.5",
+    "@huggingface/transformers": "^4.2.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@msgpack/msgpack": "^3.0.0",
     "@noble/ed25519": "^3.1.0",
     "@noble/hashes": "^2.2.0",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/core": "^2.7.1",
-    "@opentelemetry/exporter-trace-otlp-grpc": "^0.218.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.217.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.219.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.220.0",
     "@opentelemetry/resources": "^2.7.1",
-    "@opentelemetry/sdk-node": "^0.217.0",
+    "@opentelemetry/sdk-node": "^0.219.0",
     "@opentelemetry/sdk-trace-base": "^2.7.1",
-    "@safe-global/protocol-kit": "^6.1.2",
+    "@safe-global/protocol-kit": "^7.2.0",
+    "@safe-global/safe-deployments": "^1.37.56",
     "@safe-global/types-kit": "^3.0.0",
-    "@scure/bip32": "^1.7.0",
+    "@scure/bip32": "^2.2.0",
     "@scure/bip39": "^1.4.0",
+    "@secretlint/core": "^13.0.2",
+    "@secretlint/secretlint-rule-preset-recommend": "^13.0.2",
     "@slicekit/erc8128": "^0.3.3",
-    "@x402/core": "^2.9.0",
-    "@x402/evm": "^2.9.0",
-    "@x402/fetch": "^2.9.0",
-    "@x402/hono": "^2.9.0",
+    "@x402/core": "^2.14.0",
+    "@x402/evm": "^2.14.0",
+    "@x402/fetch": "^2.14.0",
+    "@x402/hono": "^2.14.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
-    "better-sqlite3": "^11.0.0",
+    "better-sqlite3": "^12.10.0",
     "bs58": "^6.0.0",
-    "canonicalize": "^2.0.0",
+    "canonicalize": "^3.0.0",
     "chokidar": "^5.0.0",
     "dotenv": "^17.4.1",
     "hono": "^4.12.10",
     "node-pty": "^1.1.0",
+    "openredaction": "^1.1.2",
     "protobufjs": "^8.0.3",
     "semver": "^7.7.4",
     "tokenlens": "^1.3.1",
     "viem": "^2.0.0",
     "ws": "^8.20.0",
     "yaml": "^2.8.4",
-    "zod": "^3.22.0"
+    "zod": "^4.4.3"
   },
   "optionalDependencies": {
     "@coinbase/cdp-sdk": "^1.48.2"
@@ -160,11 +174,12 @@
     "@jinn-network/sdk": "portal:../packages/sdk",
     "@playwright/test": "^1.59.1",
     "@types/better-sqlite3": "^7.6.0",
-    "@types/node": "^20.0.0",
+    "@types/node": "^25.9.1",
     "@types/semver": "^7.7.1",
     "@types/ws": "^8.18.1",
+    "esbuild": "^0.28.0",
     "tsx": "^4.0.0",
-    "typescript": "^5.5.0",
-    "vitest": "^2.0.0"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   }
 }

package/plugins/jinn-repo-runtime/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "jinn-repo-runtime",
+  "version": "0.1.0",
+  "description": "Runtime plugin for the jinn-repo.v1 SolverNet — provides domain reference for jinn-repo.v1 task shape, repo handling (checkout of Jinn-Network/mono at base_commit), and the solution payload schema."
+}

package/plugins/jinn-repo-runtime/.codex-plugin/plugin.json

@@ -0,0 +1,39 @@
+{
+  "name": "jinn-repo-runtime",
+  "version": "0.1.0",
+  "description": "Runtime plugin for the jinn-repo.v1 SolverNet — provides domain reference for task shape, repo handling (checkout of Jinn-Network/mono at base_commit), and the solution payload schema.",
+  "author": {
+    "name": "Jinn Network",
+    "url": "https://github.com/Jinn-Network/mono"
+  },
+  "homepage": "https://github.com/Jinn-Network/mono",
+  "repository": "https://github.com/Jinn-Network/mono",
+  "license": "MIT",
+  "keywords": [
+    "jinn",
+    "jinn-repo",
+    "codex",
+    "skills"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Jinn-repo Runtime",
+    "shortDescription": "jinn-repo task domain reference",
+    "longDescription": "Provides Solver-side domain reference for jinn-repo code-issue tasks — task input shape, repo handling (checkout of Jinn-Network/mono at base_commit), and the jinn-repo-solution.v1 payload schema.",
+    "developerName": "Jinn Network",
+    "category": "Coding",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/Jinn-Network/mono",
+    "privacyPolicyURL": "https://github.com/Jinn-Network/mono",
+    "termsOfServiceURL": "https://github.com/Jinn-Network/mono",
+    "defaultPrompt": [
+      "Solve this jinn-repo task."
+    ],
+    "brandColor": "#0F766E",
+    "screenshots": []
+  }
+}

package/plugins/jinn-repo-runtime/README.md

@@ -0,0 +1,27 @@
+# jinn-repo runtime plugin
+
+Provides a Solver-side domain reference skill for the `jinn-repo.v1` SolverNet.
+
+This plugin bundles one skill:
+- `jinn-repo-task` — task input shape, repo handling (checkout of
+  `Jinn-Network/mono` at `base_commit`), and the `jinn-repo-solution.v1`
+  output schema.
+
+It also ships a `SessionStart` hook (`hooks/session-start`) that
+deterministically materialises the task repository at `$WORKING_DIR/repo` at
+`base_commit` before the solver agent runs, so a direct-solving model never has
+to improvise the checkout.
+
+The plugin is loaded automatically when an operator's daemon has the
+`jinn-repo.v1` SolverNet enabled, per the registry's
+`defaultRuntimePluginsForSolverType('jinn-repo.v1') === ['bundled:jinn-repo-runtime']`.
+
+License: MIT.
+
+## See also
+
+- `client/plugins/swe-rebench-v2-runtime/` — the sibling runtime plugin for the
+  `swe-rebench-v2.v1` SolverNet. jinn-repo mirrors its task contract and repo
+  handling exactly; the difference is that jinn-repo instances are real merged
+  `Jinn-Network/mono` PRs (repo is always `Jinn-Network/mono`) and the solverView
+  is leak-controlled (no test files / no gold tests).

package/plugins/jinn-repo-runtime/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start\"",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/jinn-repo-runtime/hooks/session-start

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# jinn-repo-runtime session-start hook.
+#
+# Deterministically materialises the task repository at `$WORKING_DIR/repo` at
+# `base_commit` BEFORE the solver agent runs, so the agent never has to set it
+# up itself. The jinn-repo repo is always `Jinn-Network/mono`; `base_commit` is
+# frequently off the default branch (the commit the merged PR branched from), so
+# a `git clone` + `git checkout <SHA>` fails. This hook does what the task SKILL
+# documents — fetch the exact SHA — deterministically.
+#
+# Inputs (env, set by the harness adapter):
+#   WORKING_DIR / JINN_WORKING_DIR — the episode working dir (holds task.json)
+# Reads `spec.repo` + `spec.base_commit` from `$WORKING_DIR/task.json`
+# (written by the harness's provisionWorkingDir).
+#
+# Contract: idempotent (provisions only when `$WORKING_DIR/repo/.git` is absent —
+# never clobbers an existing checkout or agent edits); best-effort (logs to
+# STDERR and exits 0 even on failure, so the agent can fall back to the task
+# SKILL); emits NOTHING on STDOUT (Claude Code parses a SessionStart hook's
+# stdout as hookSpecificOutput JSON — stray output would break that parse).
+set -uo pipefail
+
+WD="${WORKING_DIR:-${JINN_WORKING_DIR:-$PWD}}"
+TASK_JSON="$WD/task.json"
+log() { echo "jinn-repo-runtime session-start: $*" >&2; }
+
+[[ -f "$TASK_JSON" ]] || { log "no task.json at $WD — skip (not a harness episode)"; exit 0; }
+
+# Extract spec.repo + spec.base_commit. shlex.quote keeps the eval injection-safe.
+REPO=""
+BASE=""
+eval "$(python3 - "$TASK_JSON" <<'PY' 2>/dev/null || true
+import json, sys, shlex
+try:
+    spec = (json.load(open(sys.argv[1])) or {}).get("spec") or {}
+except Exception:
+    sys.exit(0)
+print("REPO=" + shlex.quote(spec.get("repo") or ""))
+print("BASE=" + shlex.quote(spec.get("base_commit") or ""))
+PY
+)"
+
+[[ -n "$REPO" && -n "$BASE" ]] || { log "task.json has no spec.repo/base_commit — skip (not a jinn-repo task)"; exit 0; }
+
+REPO_DIR="$WD/repo"
+if [[ -d "$REPO_DIR/.git" ]]; then
+  log "repo already present at $REPO_DIR — skip (idempotent)"
+  exit 0
+fi
+
+log "materialising $REPO @ $BASE into $REPO_DIR"
+rm -rf "$REPO_DIR"
+mkdir -p "$REPO_DIR"
+# Fetch the exact SHA (base_commit is frequently off the default branch, so a
+# plain clone+checkout fails). git serves any commit by id via fetch.
+if ! (
+  cd "$REPO_DIR" &&
+  git init --quiet --initial-branch=main &&
+  git remote add origin "https://github.com/${REPO}.git" &&
+  git fetch --depth 1 --quiet origin "$BASE" &&
+  git checkout --quiet FETCH_HEAD
+); then
+  log "WARNING: provisioning failed for $REPO @ $BASE — agent will fall back to the task SKILL"
+  exit 0
+fi
+
+HEAD_SHA="$(git -C "$REPO_DIR" rev-parse HEAD 2>/dev/null || echo unknown)"
+if [[ "$HEAD_SHA" == "$BASE" ]]; then
+  log "repo ready at $BASE"
+else
+  log "WARNING: HEAD=$HEAD_SHA != base_commit=$BASE"
+fi
+exit 0

package/plugins/jinn-repo-runtime/jinn.plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "jinn-repo-runtime",
+  "version": "0.1.0",
+  "jinn": {
+    "supports": ["jinn-repo.v1"],
+    "skills": [
+      "skills/task/SKILL.md"
+    ],
+    "description": "Provides domain reference for jinn-repo.v1 code-issue tasks — task shape, repo handling (checkout of Jinn-Network/mono at base_commit), and the solution payload schema."
+  }
+}

package/plugins/jinn-repo-runtime/skills/task/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: jinn-repo-task
+description: Reference for jinn-repo.v1 task structure — input fields, repo setup (checkout of Jinn-Network/mono at base_commit), the jinn-repo-solution.v1 output schema, and how the daemon harvests your diff. Consult this skill when orienting on a task or constructing a solution.
+---
+
+# jinn-repo task reference
+
+Domain reference for `jinn-repo.v1` restoration tasks. A jinn-repo instance is a
+real merged Jinn-Network/mono pull request, replayed as a coding task: you are
+given the problem the PR fixed and the repo state immediately before it, and
+must reproduce the fix. Describes the task shape, the repo layout the runtime
+expects, and the schema your solution must satisfy.
+
+## Task input shape
+
+The task body (the solverView) carries the following fields under `goal.spec`:
+
+- `goal.spec.instance_id` — e.g. `Jinn-Network__mono-1042`
+- `goal.spec.repo` — always `Jinn-Network/mono`
+- `goal.spec.base_commit` — git SHA: the commit the merged PR branched from
+- `goal.spec.problem_statement` — the issue / PR description: what to fix
+
+This is leak-controlled: the solverView deliberately carries **no test files and
+no gold tests**. The PR's own test files are the held-out FAIL_TO_PASS gold the
+evaluator runs against your patch. You do not see them, and you must not try to
+reconstruct or satisfy them by editing test files — see Repository handling.
+
+## Repository handling
+
+Treat `$workingDir/repo` as the only task repository checkout. Do not reuse a
+repo from another `workingDir` or from `implStateDir`. All in-tree edits must
+live in `$workingDir/repo` — that's where the daemon's harvester reads a
+`git diff` from to assemble your solution.
+
+If `$workingDir/repo/.git` is missing, materialise the repo at
+`<goal.spec.base_commit>` by fetching that exact SHA — **do not** `git clone`
+and then `git checkout`. Run these commands verbatim (substituting the
+base_commit; the repo is always `Jinn-Network/mono`):
+
+```bash
+mkdir -p "$workingDir/repo" && cd "$workingDir/repo"
+git init
+git remote add origin https://github.com/Jinn-Network/mono.git
+git fetch --depth 1 origin <goal.spec.base_commit>
+git checkout FETCH_HEAD
+```
+
+Why this exact sequence, and not a clone: `<goal.spec.base_commit>` is the point
+the merged PR branched from — frequently **off the current default branch tip**.
+A `git clone` only brings down the default branch, so `git checkout
+<goal.spec.base_commit>` then fails with `fatal: reference is not a tree`, and a
+plain `git fetch origin` without the SHA won't help (it only pulls branch refs).
+GitHub serves any SHA by id, so `git fetch --depth 1 origin
+<goal.spec.base_commit>` retrieves exactly that one commit — fast, shallow, and
+robust whether or not the SHA is on a branch. After `git checkout FETCH_HEAD`,
+confirm you are on the base commit with `git rev-parse HEAD` (it must equal
+`<goal.spec.base_commit>`) before editing.
+
+## What to change, and what not to
+
+- Read `<goal.spec.problem_statement>` and implement the fix **in
+  `$workingDir/repo`**.
+- **Do not write or edit tests.** The gold tests are held out; the harvester
+  strips any test-file hunks from your diff before submission, so test edits are
+  wasted effort at best and cannot satisfy the held-out gold tests.
+- **Do not commit.** Leave your changes in the working tree (uncommitted) so
+  `git diff` captures them. The harvester reads `git diff` over the checkout.
+
+## Solution payload schema and submission
+
+The solution is a **typed structured payload** handed back to the daemon. The
+required shape for `jinn-repo.v1` restoration is:
+
+```json
+{
+  "schemaVersion": "jinn-repo-solution.v1",
+  "patch": "<unified diff, git-format>"
+}
+```
+
+You do **not** need to assemble this payload by hand. After execution the daemon
+harvests `git diff --binary` over `$workingDir/repo` automatically, strips
+test-file hunks, and materialises the `jinn-repo-solution.v1` payload from the
+result. Leaving your source fix uncommitted in the working tree is sufficient;
+the diff is the solution.
+
+If the active harness exposes a "submit typed payload" tool, you may submit the
+payload above explicitly for immediate schema validation — but the auto-harvest
+of the working-tree diff is authoritative and takes precedence over a stale
+hand-written `<workingDir>/.execute/solution-payload.json`. Do **not** include
+daemon-derived fields (e.g. trajectory CIDs) — the daemon attaches trajectory
+provenance to the envelope automatically.

package/plugins/learner/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-learner",
   "description": "Generic learning agent plugin — runs a goal through a seven-phase pipeline (Orient → Strategize → Plan → Execute → Debrief → Improve → Memory consolidation) and self-improves between runs by mutating its own state directory.",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": {
     "name": "Jinn Network",
     "url": "https://github.com/Jinn-Network/mono"

package/plugins/learner/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-learner",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Generic learning agent plugin - runs a goal through a seven-phase pipeline and self-improves between runs by mutating its own state directory.",
   "author": {
     "name": "Jinn Network",

package/plugins/learner/hooks/session-start

@@ -35,4 +35,33 @@ fi
 git config user.name "claude-code-learner"
 git config user.email "claude-code-learner@local"
 
-echo "session-start: implStateDir ready at $(pwd) (HEAD=$(git rev-parse HEAD))"
+# Operational readiness goes to STDERR. Claude Code parses a SessionStart hook's
+# STDOUT as JSON for `hookSpecificOutput`; any stray stdout would break that parse,
+# so stdout below carries nothing but the additionalContext payload.
+echo "session-start: implStateDir ready at $(pwd) (HEAD=$(git rev-parse HEAD))" >&2
+
+# Steer skill-selection toward this plugin's OWN learn loop. This is the agnostic,
+# plugin-owned mechanism: the learner plugin asserts its own behaviour from its own
+# SessionStart hook, without any other plugin or the harness prompt knowing it exists.
+#
+# It is delivered via the documented `hookSpecificOutput.additionalContext` contract,
+# which is injected into the model's context at session start. The previous plain
+# `echo` was logged as a hook event (visible to the harness via --include-hook-events)
+# but NEVER entered the model context — which is why, despite the learn skill being
+# projected and available, the model kept selecting a direct-solve skill and the loop
+# ran 0% of the time. (Verified: additionalContext reaches the model in headless
+# `-p` / stream-json mode on claude 2.1.x.)
+#
+# MODE-AWARE (extends the original train-only steer for the held-out exam): in
+# `frozen` mode the harness freeze-fences implStateDir, so running the learn loop's
+# Improve/Memory phases would WRITE implStateDir and trip the fence → the eval
+# aborts with a violation. The frozen steer therefore tells the model to CONSULT
+# the accumulated knowledge (read-only) and solve directly — which is exactly how
+# prior learning should raise the frozen score — and to NOT run the loop or modify
+# implStateDir. `JINN_HARNESS_MODE` is set by the harness adapter (default train).
+if [[ "${JINN_HARNESS_MODE:-train}" == "frozen" ]]; then
+  STEER="This is a FROZEN evaluation run. Before solving, CONSULT the accumulated learner knowledge under implStateDir (notes/, skills/, strategies/, patterns/, tests/) and apply any relevant strategy or pattern to this task. Then solve the task and call submit_typed_payload. Do NOT run the learn loop (no Orient/Improve/Memory phases) and do NOT create, edit, or commit anything under implStateDir — the harness verifies implStateDir is unchanged and will discard this run if it is modified."
+else
+  STEER="A seven-phase self-improvement loop is available as the learn skill (claude-code-learner:learn): Orient, Strategize, Plan, Execute, Debrief, Improve, then Memory consolidation. For this session your FIRST action MUST be to invoke the learn skill (via the Skill tool) and run the full loop end-to-end, instead of solving the task directly or selecting another skill first. The Execute phase still performs the actual task work and still calls submit_typed_payload; the surrounding phases capture reusable strategy and persist it to implStateDir so future runs improve. Do not skip the loop."
+fi
+printf '{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"%s"}}\n' "$STEER"

package/plugins/learner/skills/learn/consolidator-prompt.md

@@ -18,6 +18,10 @@ Anything that writes to `implStateDir` happens here, including:
 - **Unused skills / hooks / tools** — anything not invoked in the last N runs (default 20; check policy override). Move to `implStateDir/.archive/<ts>/` or delete per policy.
 - **Regressed promotions** — revert an Improve commit only when it actually made things worse. There are two triggers; act on either:
   1. **Qualitative trigger** — if the trend in `analysisPath` (the Debrief signal) indicates a recent change made things worse, `git revert <commit-sha>` it. Be specific: revert the exact commit identified, not a bulk rollback. The target sha is `improvePromotionsDir/<n>.json`'s `implStateDirShaAfter`.
+  > The graded score (Tier 2) lowers the variance of the keep/revert decision only.
+  > It never overrules the binary verdict, and it MUST NOT be used to size on-chain
+  > reward — that path is gated on the withheld-test challenge (#1019, design §5.5).
+
   2. **Quantitative trigger (#764)** — for each candidate Improve commit on recent `implStateDir` git history (the commits since `implStateDirShaBefore`, identified from each `improvePromotionsDir/<n>.json` `implStateDirShaAfter`), ask the network-truth indexer whether the commit's per-codeDigest pass rate is significantly worse than its parent's. **Do not hand-roll the codeDigest hash or the statistics — shell out to the CLI**, which exports each commit's tree (`git archive`, no `.git`) and hashes it the way production stamps codeDigest, then runs the documented test:
 
      ```bash

package/plugins/local-trace-distiller/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "local-trace-distiller",
+  "description": "Local trace distillation tools and workflow for deriving experimental skills from private session traces.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Jinn Network",
+    "url": "https://github.com/Jinn-Network/mono"
+  }
+}

package/plugins/local-trace-distiller/.codex-plugin/plugin.json

@@ -0,0 +1,41 @@
+{
+  "name": "local-trace-distiller",
+  "version": "0.1.0",
+  "description": "Local trace distillation tools and skill workflow for deriving experimental skills from private session traces.",
+  "author": {
+    "name": "Jinn Network",
+    "url": "https://github.com/Jinn-Network/mono"
+  },
+  "homepage": "https://github.com/Jinn-Network/mono",
+  "repository": "https://github.com/Jinn-Network/mono",
+  "license": "MIT",
+  "keywords": [
+    "jinn",
+    "distill",
+    "traces",
+    "skills",
+    "mcp"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Local Trace Distiller",
+    "shortDescription": "Derive experimental skills from local traces",
+    "longDescription": "Searches local captured session traces, clusters recurring patterns, and runs the existing Jinn distillation flow using the user's selected LLM provider.",
+    "developerName": "Jinn Network",
+    "category": "Coding",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/Jinn-Network/mono",
+    "privacyPolicyURL": "https://github.com/Jinn-Network/mono",
+    "termsOfServiceURL": "https://github.com/Jinn-Network/mono",
+    "defaultPrompt": [
+      "Use /distill to derive an experimental skill from local traces."
+    ],
+    "brandColor": "#2563EB",
+    "screenshots": []
+  }
+}

package/plugins/local-trace-distiller/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "jinn-local-distil": {
+      "command": "jinn-distil-mcp",
+      "args": []
+    }
+  }
+}

package/plugins/local-trace-distiller/README.md

@@ -0,0 +1,27 @@
+# local-trace-distiller
+
+Local trace distillation plugin for deriving experimental skills from private session traces.
+
+## Components
+
+- `skills/distill/SKILL.md` — `/distill` workflow. No argument defaults to `this`; `all` runs a capped cluster-first scan.
+- `.mcp.json` — launches `jinn-distil-mcp`.
+- `jinn-distil-mcp` tools:
+  - `distill_trace_search` — compact local trace cards.
+  - `distill_trace_read` — scoped trace reads with full-transcript gating.
+  - `distill_trace_cluster` — cheap repeated-signal candidate discovery.
+  - `distill_local` — confirmed local run through `jinn-layer distil`.
+
+## Local Capture Source
+
+Stop-hook captures are exported as `CapturedTask` JSON under:
+
+```text
+~/.jinn-client/harness-layer/captures
+```
+
+Set `JINN_LAYER_CAPTURES_DIR` to override the directory. The MCP server and `jinn-layer distil` use the same directory, so agents can search traces and then invoke the existing distillation flow without a second data path.
+
+## Status
+
+Generated skills are marked experimental and should be improved through user feedback before they are treated as stable. Public marketplace listing is intentionally out of scope for this version.

package/plugins/local-trace-distiller/jinn.plugin.json

@@ -0,0 +1,36 @@
+{
+  "name": "@jinn-network/local-trace-distiller",
+  "version": "0.1.0",
+  "description": "Local trace distillation plugin. Searches private captures, clusters candidate skill opportunities, and invokes the existing Jinn skill distiller locally.",
+  "jinn": {
+    "supports": [
+      "jinn.local-distil"
+    ],
+    "capabilities": {
+      "tools": {
+        "jinn-local-distil": [
+          "distill_trace_search",
+          "distill_trace_read",
+          "distill_trace_cluster",
+          "distill_local",
+          "distill_feedback_record"
+        ]
+      }
+    },
+    "mcpServers": {
+      "jinn-local-distil": {
+        "command": "jinn-distil-mcp",
+        "tools": [
+          "distill_trace_search",
+          "distill_trace_read",
+          "distill_trace_cluster",
+          "distill_local",
+          "distill_feedback_record"
+        ]
+      }
+    },
+    "skills": [
+      "skills/distill/SKILL.md"
+    ]
+  }
+}