@jinn-network/client 0.1.6 → 0.1.7-canary.0a586ca9

package/dist/operator-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"operator-errors.js","sourceRoot":"","sources":["../src/operator-errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operator-errors.js","sourceRoot":"","sources":["../src/operator-errors.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+{
+  "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",
+  "author": {
+    "name": "Jinn Network",
+    "url": "https://github.com/Jinn-Network/mono"
+  }
+}

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

@@ -0,0 +1,39 @@
+{
+  "name": "claude-code-learner",
+  "version": "0.1.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",
+    "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",
+    "learner",
+    "codex",
+    "skills"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Claude Code Learner",
+    "shortDescription": "Seven-phase learning loop for harness-driven goals",
+    "longDescription": "Runs a generic goal through orient, strategize, plan, execute, debrief, improve, and memory consolidation phases.",
+    "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": [
+      "Run the learning loop for this goal."
+    ],
+    "brandColor": "#111111",
+    "screenshots": []
+  }
+}

package/dist/plugins/learner/AGENTS.md

@@ -0,0 +1,40 @@
+# claude-code-learner plugin (generic / Codex loader)
+
+This plugin provides a generic learning-agent loop for any harness that supports skills + subagent dispatch + hooks.
+
+## Tool name mapping
+
+> Names below are best-effort guidance; harness tool surfaces evolve. The canonical contract is the **capability** described in the Generic column — confirm against your harness's docs before wiring.
+
+The `learn` skill and the sibling prompt files use Claude Code tool names by default. On other harnesses, substitute equivalents:
+
+| Claude Code | Codex | Pi.dev | Generic |
+|---|---|---|---|
+| `Skill` | `skill` | (extension load) | "load named instructions into current session" |
+| `Task` (general-purpose) | `spawn_agent` | (subprocess) | "spawn fresh-context subagent with an inline prompt body" |
+| `Bash` | `shell` | `bash` | shell tool |
+| `Read`/`Write`/`Edit` | `file_read`/`file_write` | `fs` tools | filesystem |
+| `Glob`/`Grep` | `glob`/`grep` | `fs` search | "filesystem search by pattern / content" |
+| `Monitor` (wait) | (bespoke) | (built-in) | "block until duration/deadline/condition" |
+
+## Subagent dispatch contract
+
+The learner workflow is written against generic harness capabilities, not a specific subagent API. The harness projects these operations onto its native tools:
+
+- Dispatch a fresh-context subagent with an inline role prompt body plus explicit inputs.
+- Wait on returned subagent handles until every required phase artifact exists.
+- Release/close completed subagents after their outputs are verified and their summaries are captured.
+- Pass absolute filesystem paths in subagent inputs; subagents should not rely on inheriting the coordinator's current working directory.
+
+## Entry point
+
+The harness adapter provides the task payload and paths at session start. The harness/plugin projection makes this skill available to the model; this skill drives the full seven-phase pipeline when selected by the runtime.
+
+## Components
+
+See `CLAUDE.md` for the same component listing — both loaders cover the same plugin contents; this file just notes the cross-harness tool mapping.
+
+## Spec
+
+- Pipeline + artifacts: `docs/superpowers/specs/2026-04-23-default-learning-restorer-design.md` v1.1.
+- Plugin layout + decoupling: `docs/superpowers/specs/2026-05-06-claude-code-learner-plugin-simplification-design.md` v1.1.

package/dist/plugins/learner/CLAUDE.md

@@ -0,0 +1,33 @@
+# claude-code-learner plugin (Claude Code loader)
+
+This plugin provides a generic learning-agent loop.
+
+## Entry point
+
+When a session starts, the harness adapter provides the task payload and paths. The harness/plugin projection makes this skill available to the model; this skill drives the full seven-phase pipeline when selected by the runtime.
+
+## Components
+
+**Skill:**
+- `skills/learn/SKILL.md` — single orchestrator. Sequences Orient → Strategize → Plan → Execute → Debrief → Improve → Memory consolidation. Each phase dispatches a fresh-context subagent using the prompt body from the matching sibling file.
+
+**Subagent prompt files (siblings of SKILL.md):**
+- `explorer-prompt.md` — info gatherer (used by Orient and Debrief, parallel-dispatched)
+- `strategist-prompt.md`, `planner-prompt.md`, `step-worker-prompt.md`, `analyst-prompt.md`, `promoter-prompt.md`, `consolidator-prompt.md` — one per specialized role
+
+**Hook:**
+- `hooks/session-start` — runs once at session start; ensures `implStateDir` is a git repo and sets `claude-code-learner` author identity.
+
+## Conventions
+
+- All durable self-modification lives in `implStateDir/**` (git-backed).
+- Episode artifacts live under `workingDir/**`; the harness harvests `workingDir` once the orchestrator returns.
+- Subagents are one level deep only — they do not spawn further agents.
+- Strategize-frozen success criteria + timing posture must not change during the run.
+- Subagent dispatch is by inlined prompt body (read from a sibling `*-prompt.md`), not by named-subagent registry. This keeps the plugin portable across harnesses.
+- The plugin does not interpret `goal.kind` semantically. Domain-specific knowledge belongs in other plugins or in the harness layer.
+
+## Spec
+
+- Pipeline + artifacts: `docs/superpowers/specs/2026-04-23-default-learning-restorer-design.md` v1.1.
+- Plugin layout + decoupling: `docs/superpowers/specs/2026-05-06-claude-code-learner-plugin-simplification-design.md` v1.1.

package/dist/plugins/learner/README.md

@@ -0,0 +1,59 @@
+# claude-code-learner — generic learning agent plugin
+
+A drop-in plugin for any agent harness that supports skills + subagent dispatch + hooks. Runs a goal through a seven-phase learning loop (Orient → Strategize → Plan → Execute → Debrief → Improve → Memory consolidation) and self-improves between runs by mutating its own state directory.
+
+## What it provides
+
+- **1 orchestrator skill** — `skills/learn/SKILL.md`. Drives the seven-phase pipeline end-to-end inside one harness session.
+- **7 sibling subagent prompts** — `skills/learn/<role>-prompt.md` for `explorer`, `strategist`, `planner`, `step-worker`, `analyst`, `promoter`, `consolidator`. Each is the prompt body the orchestrator passes to a fresh-context subagent dispatch.
+- **1 hook** — `hooks/session-start` initializes `implStateDir` as a git repo and sets author identity.
+
+## Installing
+
+The plugin is consumed by harnesses that load skills from a plugin directory.
+
+**Claude Code (local development — recommended for first install):**
+
+```bash
+# Point a Claude Code session at the plugin directory:
+claude --plugin-dir /path/to/claude-code-learner [other args]
+```
+
+For a permanent install via the Claude Code marketplace, use `claude plugin install <plugin>@<marketplace>` once a marketplace listing is published. Until then, `--plugin-dir` is the supported path.
+
+**Codex / OpenCode / other harnesses:** consult your harness's documentation for how to point it at a local plugin directory. The plugin layout (`.claude-plugin/plugin.json` + `skills/` + `hooks/` + `hooks/hooks.json`) is Claude-Code-shaped; harnesses with a different convention may need an adapter.
+
+## What the harness must provide
+
+These are the runtime primitives the plugin assumes the harness exposes (Claude Code names; substitute equivalents on other harnesses):
+
+- `Skill` — load a named skill into the current session.
+- `Task` (general-purpose) — spawn a fresh-context subagent with an inline prompt body.
+- `Bash` — for git commands and other shell calls.
+- `Read`, `Write`, `Edit`, `Glob`, `Grep` — filesystem.
+- A wait primitive — block until duration / deadline / condition (Claude Code: `Monitor`).
+
+The harness adapter is responsible for projecting the generic subagent lifecycle onto its own tool surface: dispatch a fresh-context role worker, wait for required artifacts, and release completed workers. Subagent inputs should use absolute paths so workers do not depend on inheriting the coordinator's current working directory.
+
+If the harness lacks `Skill`, generic `Task`-style subagent dispatch, `Bash`, or filesystem read/write/edit, the plugin will not run. The wait primitive gates time-anchored plans only — the plugin can run for `early-return` postures without it.
+
+## Inputs the harness adapter passes
+
+The orchestrator skill expects these as session inputs (typically via the harness adapter's initial prompt or environment):
+
+- `goal` — `{ id, description, kind?, deadline?, spec? }`. Free-form payload describing what to achieve.
+- `workingDir` — ephemeral path for this run's artifacts.
+- `implStateDir` — the agent's persistent self-state (git-backed).
+- `msUntilDeadline` — function returning remaining time.
+- An abort signal that fires at the goal's deadline.
+
+The plugin does not interpret `goal.kind` semantically. Domain-specific behavior (e.g. how to forecast a prediction market, how to rebalance a portfolio) belongs in domain-specific plugins loaded alongside this one, OR in the harness adapter / harvester layer.
+
+## Optional environment
+
+- `LEARNER_PHASE_RANGE=pre-execute|post-execute|full` — limits which phases run. Used by harnesses that wrap a domain-specialist Execute path between meta-pre and meta-post passes.
+
+## Spec
+
+- Pipeline + artifacts: `docs/superpowers/specs/2026-04-23-default-learning-restorer-design.md` v1.1.
+- Plugin layout + decoupling: `docs/superpowers/specs/2026-05-06-claude-code-learner-plugin-simplification-design.md` v1.1.

package/dist/plugins/learner/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/dist/plugins/learner/hooks/session-start

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# claude-code-learner session-start hook.
+#
+# Runs once at the start of every claude-code-learner session. Ensures
+# implStateDir is a git repo and sets the author identity so any
+# subsequent `git commit` from inside the plugin's agents uses the
+# claude-code-learner identity automatically.
+#
+# Inputs (from environment):
+#   IMPL_STATE_DIR — path to the operator's implStateDir
+#
+# Idempotent: safe to re-run. No remote, no signing — implStateDir
+# history is operator-private.
+
+set -euo pipefail
+
+# Derive PLUGIN_ROOT from this script's location, then export so
+# subsequent skills/agents can find the plugin without a hardcoded path.
+PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+export PLUGIN_ROOT
+
+if [[ -z "${IMPL_STATE_DIR:-}" ]]; then
+  echo "session-start: IMPL_STATE_DIR not set" >&2
+  exit 1
+fi
+
+mkdir -p "$IMPL_STATE_DIR"
+cd "$IMPL_STATE_DIR"
+
+if [[ ! -d .git ]]; then
+  git init --initial-branch=main --quiet
+  git commit --allow-empty -m "init implStateDir" --quiet
+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))"