specpi 0.10.0

package/scripts/verify-artifact.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+const [artifactPath, checksumPath] = process.argv.slice(2);
+if (!artifactPath || !checksumPath || process.argv.length !== 4) {
+    throw new Error("Usage: verify-artifact.mjs <tarball> <sha512-file>");
+}
+
+const checksum = fs
+    .readFileSync(checksumPath, "utf8")
+    .trim()
+    .match(/^([0-9a-fA-F]{128})\s+[*]?(.+)$/);
+assert.ok(checksum, "SHA-512 checksum file is malformed");
+assert.equal(path.basename(artifactPath), path.basename(checksum[2]), "checksum names a different artifact");
+const actual = createHash("sha512").update(fs.readFileSync(artifactPath)).digest("hex");
+assert.equal(actual, checksum[1].toLowerCase(), "artifact SHA-512 checksum differs");
+console.log(`Verified SHA-512 for ${path.basename(artifactPath)}`);

package/shell/pi-profiles.sh

@@ -0,0 +1,14 @@
+# shellcheck shell=bash
+# SpecPi capability profiles.
+
+pi-core() {
+  command pi --tools read,bash,edit,write,ask_user_question "$@"
+}
+
+pi-plan() {
+  command pi --tools read,grep,find,ls,web_search,source_check,fetch_content,get_search_content,ask_user_question "$@"
+}
+
+pi-full() {
+  command pi "$@"
+}

package/site/logo.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-labelledby="title desc">
+  <title id="title">SpecPi</title>
+  <desc id="desc">A blueprint-blue Pi mark inside a precise technical frame</desc>
+  <rect width="128" height="128" fill="#121519"/>
+  <rect x="15" y="15" width="98" height="98" fill="#181c22" stroke="#39424f" stroke-width="2"/>
+  <path d="M15 37V15h22M91 15h22v22M113 91v22H91M37 113H15V91" fill="none" stroke="#8fb6d9" stroke-width="3"/>
+  <path d="M29 36h70v14h-9v26c0 11 4 16 13 16v14c-18 0-27-11-27-30V50H53v47H39V50H29z" fill="#8fb6d9"/>
+  <path d="M29 103h36" stroke="#5d6876" stroke-width="2"/>
+</svg>

package/site/self-improvement-loop-v2.svg

@@ -0,0 +1,108 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 420" role="img" aria-labelledby="loop-title loop-desc">
+  <title id="loop-title">SpecPi human-directed improvement loop</title>
+  <desc id="loop-desc">Seven stages move local friction through evidence, human choice, a bounded change, verification, retirement, and review. Verification failure returns to the change while later evidence returns retired work to human review.</desc>
+  <defs>
+    <pattern id="grid" width="24" height="24" patternUnits="userSpaceOnUse">
+      <path d="M24 0H0V24" fill="none" stroke="#20262e" stroke-width="1"/>
+    </pattern>
+    <marker id="arrow-progress" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M0 0 10 5 0 10z" fill="#5d6876"/>
+    </marker>
+    <marker id="arrow-blueprint" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M0 0 10 5 0 10z" fill="#8fb6d9"/>
+    </marker>
+    <marker id="arrow-pass" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M0 0 10 5 0 10z" fill="#7fb08a"/>
+    </marker>
+  </defs>
+
+  <rect x="1" y="1" width="998" height="418" fill="#121519" stroke="#2a313b" stroke-width="2"/>
+  <rect x="1" y="1" width="998" height="418" fill="url(#grid)" opacity="0.42"/>
+
+  <g font-family="'IBM Plex Mono', Consolas, 'Liberation Mono', monospace">
+    <rect x="28" y="22" width="36" height="36" fill="#181c22" stroke="#39424f" stroke-width="2"/>
+    <text x="46" y="48" fill="#8fb6d9" font-size="24" font-weight="600" text-anchor="middle">π</text>
+    <text x="78" y="38" fill="#f7f9fc" font-size="18" font-weight="600" letter-spacing="2">SPECPI / IMPROVEMENT LOOP</text>
+    <text x="78" y="58" fill="#78838f" font-size="16">Evidence proposes. A person chooses. Proof closes.</text>
+    <text x="972" y="44" fill="#78838f" font-size="16" letter-spacing="1" text-anchor="end">7 STAGES · 2 GATES</text>
+  </g>
+  <path d="M28 82H972" stroke="#39424f" stroke-width="1"/>
+  <path d="M28 82H154" stroke="#8fb6d9" stroke-width="2"/>
+
+  <g fill="none" stroke-width="2" marker-end="url(#arrow-progress)">
+    <path d="M146 181h9" stroke="#5d6876"/>
+    <path d="M277 181h9" stroke="#8fb6d9" marker-end="url(#arrow-blueprint)"/>
+    <path d="M408 181h9" stroke="#5d6876"/>
+    <path d="M539 181h9" stroke="#7fb08a" marker-end="url(#arrow-pass)"/>
+    <path d="M670 181h9" stroke="#7fb08a" marker-end="url(#arrow-pass)"/>
+    <path d="M801 181h9" stroke="#5d6876"/>
+  </g>
+
+  <g font-family="'IBM Plex Mono', Consolas, 'Liberation Mono', monospace">
+    <g>
+      <rect x="28" y="114" width="118" height="134" fill="#181c22" stroke="#2a313b" stroke-width="2"/>
+      <text x="42" y="140" fill="#78838f" font-size="16">01</text>
+      <text x="42" y="166" fill="#a3adbc" font-size="16" letter-spacing="1">SIGNAL</text>
+      <text x="42" y="205" fill="#e9edf4" font-size="18">Friction</text>
+      <text x="42" y="232" fill="#78838f" font-size="16">local</text>
+    </g>
+    <g>
+      <rect x="159" y="114" width="118" height="134" fill="#181c22" stroke="#2a313b" stroke-width="2"/>
+      <text x="173" y="140" fill="#78838f" font-size="16">02</text>
+      <text x="173" y="166" fill="#a3adbc" font-size="16" letter-spacing="1">EVIDENCE</text>
+      <text x="173" y="205" fill="#e9edf4" font-size="18">Qualify</text>
+      <text x="173" y="232" fill="#78838f" font-size="16">recurrent</text>
+    </g>
+    <g>
+      <rect x="290" y="114" width="118" height="134" fill="#20252d" stroke="#8fb6d9" stroke-width="2"/>
+      <path d="M290 114h118" stroke="#8fb6d9" stroke-width="5"/>
+      <rect x="380" y="130" width="12" height="12" fill="#8fb6d9"/>
+      <text x="304" y="140" fill="#8fb6d9" font-size="16">03</text>
+      <text x="304" y="166" fill="#b8d4ec" font-size="16" letter-spacing="1">HUMAN</text>
+      <text x="304" y="205" fill="#f7f9fc" font-size="18">Choose</text>
+      <text x="304" y="232" fill="#8fb6d9" font-size="16">explicit</text>
+    </g>
+    <g>
+      <rect x="421" y="114" width="118" height="134" fill="#181c22" stroke="#2a313b" stroke-width="2"/>
+      <text x="435" y="140" fill="#78838f" font-size="16">04</text>
+      <text x="435" y="166" fill="#a3adbc" font-size="16" letter-spacing="1">CHANGE</text>
+      <text x="435" y="205" fill="#e9edf4" font-size="18">Build</text>
+      <text x="435" y="232" fill="#78838f" font-size="16">bounded</text>
+    </g>
+    <g>
+      <rect x="552" y="114" width="118" height="134" fill="#20252d" stroke="#7fb08a" stroke-width="2"/>
+      <path d="M552 114h118" stroke="#7fb08a" stroke-width="5"/>
+      <rect x="642" y="130" width="12" height="12" fill="#7fb08a"/>
+      <text x="566" y="140" fill="#7fb08a" font-size="16">05</text>
+      <text x="566" y="166" fill="#7fb08a" font-size="16" letter-spacing="1">PROOF</text>
+      <text x="566" y="205" fill="#f7f9fc" font-size="18">Verify</text>
+      <text x="566" y="232" fill="#7fb08a" font-size="16">closed</text>
+    </g>
+    <g>
+      <rect x="683" y="114" width="118" height="134" fill="#192027" stroke="#39424f" stroke-width="2"/>
+      <text x="697" y="140" fill="#7fb08a" font-size="16">06</text>
+      <text x="697" y="166" fill="#7fb08a" font-size="16" letter-spacing="1">OUTCOME</text>
+      <text x="697" y="205" fill="#e9edf4" font-size="18">Retire</text>
+      <text x="697" y="232" fill="#7fb08a" font-size="16">passed</text>
+    </g>
+    <g>
+      <rect x="814" y="114" width="118" height="134" fill="#181c22" stroke="#8fb6d9" stroke-width="2" stroke-dasharray="5 4"/>
+      <text x="828" y="140" fill="#8fb6d9" font-size="16">07</text>
+      <text x="828" y="166" fill="#b8d4ec" font-size="16" letter-spacing="1">RETURN</text>
+      <text x="828" y="205" fill="#e9edf4" font-size="18">Review</text>
+      <text x="828" y="232" fill="#8fb6d9" font-size="16">later</text>
+    </g>
+  </g>
+
+  <path id="verification-failure-return" d="M611 248v41H480v-33" fill="none" stroke="#78838f" stroke-width="2" stroke-dasharray="5 5" marker-end="url(#arrow-progress)"/>
+  <rect x="506" y="276" width="192" height="25" fill="#121519"/>
+  <text x="602" y="294" fill="#a3adbc" font-family="'IBM Plex Mono', Consolas, 'Liberation Mono', monospace" font-size="16" text-anchor="middle">FAIL / STAYS SELECTED</text>
+
+  <path id="later-evidence-review-return" d="M873 248v101H349v-93" fill="none" stroke="#8fb6d9" stroke-width="2" stroke-dasharray="5 5" marker-end="url(#arrow-blueprint)"/>
+  <rect x="497" y="336" width="278" height="25" fill="#121519"/>
+  <text x="636" y="354" fill="#8fb6d9" font-family="'IBM Plex Mono', Consolas, 'Liberation Mono', monospace" font-size="16" text-anchor="middle">LATER EVIDENCE / HUMAN REVIEW</text>
+
+  <path d="M28 382H972" stroke="#2a313b"/>
+  <text x="28" y="405" fill="#78838f" font-family="'IBM Plex Mono', Consolas, 'Liberation Mono', monospace" font-size="16" letter-spacing="1">LOCAL SIGNAL → EXPLICIT AUTHORITY → VERIFIED CHANGE</text>
+  <text x="972" y="405" fill="#5d6876" font-family="'IBM Plex Mono', Consolas, 'Liberation Mono', monospace" font-size="16" text-anchor="end">PRIVATE · LOCAL · REVERSIBLE</text>
+</svg>

package/skills/donsetch/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: donsetch
+license: AGPL-3.0-only
+description: Uses the DonSeTch CLI for multi-page site crawling, bot-wall or JavaScript-heavy page extraction, focused low-token URL reads, change checks, and keyless search. Use when ordinary pi-web-access fetching is insufficient or when a whole documentation site must be mapped or crawled.
+compatibility: Requires the donsetch executable on PATH.
+---
+
+# DonSeTch CLI
+
+Prefer Pi's `web_search`, `source_check`, and `fetch_content` tools for ordinary web research. Use DonSeTch through `bash` when you need site crawling, bot-wall escalation, browser actions, focused extraction, or cheap change/probe checks.
+
+## Inspect available options
+
+```bash
+donsetch --help
+donsetch fetch --help
+donsetch search --help
+donsetch crawl --help
+```
+
+## Search
+
+```bash
+donsetch search "query"
+donsetch search "query" --intent code --max-results 10
+donsetch search "query" --json
+```
+
+Search finds candidate URLs; fetch the best result afterward. Treat `weak=true` or low-consensus results cautiously.
+
+## Fetch one or several pages
+
+```bash
+donsetch fetch 'https://example.com'
+donsetch fetch 'https://example.com/long-doc' --focus 'error handling'
+donsetch fetch 'https://example.com/long-doc' --toc
+donsetch fetch 'https://example.com/long-doc' --section 'Authentication'
+donsetch fetch 'https://example.com' --must-contain 'required phrase'
+donsetch fetch 'https://example.com' --since-last
+donsetch fetch 'https://a.example/x' 'https://b.example/y' --budget-tokens 2000
+```
+
+Choose the cheapest useful mode:
+
+- Verification only: `--must-contain`.
+- Unknown long-page structure: `--toc`, then `--section`.
+- Known topic: `--focus`.
+- Changed since last read: `--since-last`.
+- Full article pagination: `--stitch`.
+- Structured parsing: `--json` and process with `jq`.
+
+For JavaScript-only pages, pass deterministic browser actions:
+
+```bash
+donsetch fetch 'https://example.com/search' \
+  --actions '[{"do":"type","selector":"input[q]","text":"query"},{"do":"press","key":"Enter"},{"do":"wait_text","text":"results"}]'
+```
+
+## Crawl a site
+
+```bash
+donsetch crawl 'https://docs.example.com' --mode map
+donsetch crawl 'https://docs.example.com' --topic 'authentication' --max-pages 20
+donsetch crawl 'https://docs.example.com' --topic 'API reference' --max-pages 30 --deadline 300
+donsetch crawl 'https://docs.example.com' --resume '<resume-token>'
+```
+
+Always set `--topic` for a focused crawl. Start with `--mode map` when site structure is unknown. Bound work with `--max-pages`, `--max-chars`, and `--deadline`. Resume partial crawls instead of restarting.
+
+## Operational rules
+
+- Quote URLs and user-provided arguments.
+- Use `--json` when downstream code must parse results.
+- Redirect large output to a temporary file and inspect bounded slices rather than flooding model context.
+- Respect robots.txt; do not use `--no-robots` unless the user explicitly authorizes it.
+- Exit code 2 is transient and may be retried; exit code 3 indicates a wall and usually requires another source or fetch strategy.

package/skills/specpi-improve/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: specpi-improve
+description: Turns a selected SpecPi capability-gap wishlist item into a minimal, evidence-backed, reversible improvement. Use when the user asks to improve SpecPi from its wishlist, act on a selected gap, or complete the notice-to-retire loop.
+---
+
+# SpecPi Improve
+
+Improve the harness through an explicit experiment, never through quiet self-modification.
+
+## Preconditions
+
+1. Begin through `/harness-improvement`. Its menu exposes qualified and review-needed items, records the chosen item as selected, and starts this workflow.
+2. Treat that exact menu choice as approval for the smallest sufficient implementation of that item. Ask again only if scope expands or external/remote state would change.
+3. Treat wishlist summaries as leads, not proof. Inspect the current repository, tools, docs, tests, and runtime behavior before designing a change.
+4. Do not inspect Pi credentials, trust decisions, sessions, history, missions, or unrelated private state.
+
+## Improvement card
+
+Before editing, present one compact card:
+
+- **Gap ID and evidence:** occurrences, reach, impact, and representative sanitized needs.
+- **Smallest intervention:** choose among bug fix, config, prompt, skill, or tool; prefer the least powerful sufficient option.
+- **Hypothesis:** what friction the change should remove.
+- **Acceptance check:** direct behavior that proves the capability works.
+- **Rollback:** how the change can be removed or reverted cleanly.
+- **Privacy/security:** state what new data, permissions, dependencies, or external state would be introduced; prefer none.
+- **Non-goals:** reject adjacent feature accumulation.
+
+The `/harness-improvement` selection authorizes this exact smallest-sufficient card. Do not add another approval step unless the proposed work exceeds it.
+
+## Implementation
+
+1. Preserve a single writer for the active worktree.
+2. Implement the smallest coherent intervention.
+3. Add focused tests that reproduce the gap and prove the new behavior.
+4. Update the reviewed capability registry only when the capability is actually shipped. Use exact aliases; do not hide adjacent unsupported cases.
+5. Link deterministic capabilities to an existing or new `specpi doctor` check.
+6. Update README, security documentation, changelog, third-party notices, and installer source lists only where the change requires it.
+7. Keep installation explicit, reversible, backed up, atomic, and checksum-tracked.
+8. If the user chooses to commit the improvement, include a `SpecPi-Gap: <gap-id>` trailer so the commit can be linked to its retirement in the journal. SpecPi itself never commits.
+
+## Verification and retirement
+
+1. Run the narrowest focused checks, then `npm run check`.
+2. For installer changes, exercise plan/install/doctor/update/uninstall with a temporary `PI_CODING_AGENT_DIR`; never use the live Pi directory.
+3. Inspect the final diff and obtain fresh read-only review when risk warrants it.
+4. At the end, call `finish_harness_improvement` with the exact gap ID, concise direct acceptance evidence, and a sanitized validation note. The tool independently requires source-registry integration, runs `npm run check`, executes every capability validator through the closed validators catalog, persists that proof into the local improvement journal, and retires only if every gate passes.
+5. If validation fails, fix or revert. Do not retire on plausibility; leave the item selected and report the blocker.
+6. A later regression returns the retired item to the `/harness-improvement` menu. Choosing it there explicitly reopens and selects it for review.
+7. When a retired item reopens, start from `/wishlist history <gap-id>`: the journal supplies the original proof and the changed-file set of the original change. Propose an explicit revert plan for human approval; never revert autonomously.
+
+## Handoff
+
+Report the gap ID, changed files, acceptance evidence, commands and exit codes, lifecycle action, rollback path, and residual risks. Never claim that silence or the absence of later reports proves success.

package/specpi

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+set -eu
+SCRIPT_DIR=$(CDPATH='' cd -- "$(dirname -- "$0")" && pwd)
+exec node "$SCRIPT_DIR/scripts/specpi.mjs" "$@"

package/specpi.cmd

@@ -0,0 +1,4 @@
+@echo off
+setlocal
+node "%~dp0scripts\specpi.mjs" %*
+exit /b %ERRORLEVEL%

package/templates/AGENTS.md

@@ -0,0 +1,23 @@
+## SpecPi Working Agreement
+
+- Prefer direct execution for small, well-scoped tasks; do not add workflow ceremony without a concrete benefit.
+- Ask concise, decision-oriented questions when material requirements are ambiguous instead of guessing.
+- Inspect existing code and repository guidance before editing. Keep changes surgical and avoid unrelated cleanup.
+- Use project-native commands and dependencies. Do not introduce global tooling when a local script or dependency already exists.
+- Treat plans and model output as context rather than proof. Files, diffs, command output, tests, and runtime behavior are authoritative.
+- Use visible `PLAN.md`, `TODO.md`, `DECISIONS.md`, or `HANDOFF.md` artifacts only when they improve continuity.
+- Delegate only when fresh context, parallel independent investigation, specialist judgment, or review justifies the overhead.
+- Keep one writer per shared working directory. Use `/experiment` or another isolated worktree for intentional parallel writers, and open the separate session yourself.
+- When `/scope` is active, treat outside-scope findings as pending until the human allows once, acknowledges them with `/scope accept`, expands the declared scope with `/scope add`, or clears it; never describe observed drift as accepted scope, and never assume an acknowledged path was added to the contract.
+- Use `/challenge` for material completion review when its adversarial checklist provides concrete value; its readiness card supports human review but is not independent proof.
+- Never launch `codex-exec` or `codex-exec-writer`; SpecPi disables these external subscription runners.
+- Treat command-guard denials as hard runtime constraints: use the stated safer alternative or ask the user; never obfuscate, split, encode, or reroute a denied operation to evade protection.
+- When Command Guard is active, prefer direct tool calls and simple, explicit commands. Avoid unnecessary command substitution, process substitution, stdin-driven `xargs`, compound shell programs, inline interpreter code, and executable heredocs because opaque forms require approval. When complexity is genuinely required, keep it transparent and request approval rather than restructuring it to bypass protection.
+- For material changes, run the narrowest relevant checks, inspect the final diff, and use fresh read-only review when risk warrants it.
+- Never claim completion from plausibility alone. Report commands run, validation results, and residual risks.
+- Treat wishlist observations as leads, not permission to edit. Start only from an exact `/harness-improvement` menu choice, use the `specpi-improve` skill, and retire through its verification gate only after direct evidence passes.
+- Do not commit, push, publish, deploy, or alter remote state unless the user explicitly requests it.
+- Prefer Pi web tools for ordinary research. Use the DonSeTch skill for whole-site crawling, bot walls, JavaScript-heavy extraction, or focused probes.
+- Use SpecPi browser tools to validate rendered web interfaces at relevant desktop, tablet, and mobile viewports; source review and HTTP checks are not proof of visual correctness.
+- Create or replace visual baselines only when explicitly requested, and report current, baseline, and diff artifact paths for regression comparisons.
+- Keep final responses concise and identify changed files clearly.

package/templates/settings.json

@@ -0,0 +1,10 @@
+{
+  "theme": "specpi-spec",
+  "packages": [
+    "npm:pi-web-access@0.25.0",
+    "npm:@juicesharp/rpiv-ask-user-question@2.7.1",
+    "npm:@llblab/pi-codex-usage@0.9.3",
+    "npm:@tunnckocore/pi-gpt-fast-mode@0.4.0",
+    "npm:@narumitw/pi-goal@0.54.3"
+  ]
+}

package/themes/specpi-spec.json

@@ -0,0 +1,96 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "specpi-spec",
+	"vars": {
+		"blueprint": "#8FB6D9",
+		"blueprintBright": "#B8D4EC",
+		"blueprintDeep": "#6F93B3",
+		"paper": "#E9EDF4",
+		"paperBright": "#F7F9FC",
+		"paperSoft": "#D6DCE6",
+		"slate": "#A3ADBC",
+		"quiet": "#78838F",
+		"faint": "#5D6876",
+		"rule": "#2A313B",
+		"ruleStrong": "#39424F",
+		"success": "#7FB08A",
+		"warning": "#D7B36A",
+		"error": "#E07A7A",
+
+		"selectedBg": "#202A35",
+		"searchBg": "#8FB6D9",
+		"userMsgBg": "#181C22",
+		"customMsgBg": "#20252D",
+		"toolPendingBg": "#171E26",
+		"toolSuccessBg": "#192027",
+		"toolErrorBg": "#2A1B20"
+	},
+	"colors": {
+		"accent": "blueprint",
+		"border": "ruleStrong",
+		"borderAccent": "blueprint",
+		"borderMuted": "rule",
+		"success": "success",
+		"error": "error",
+		"warning": "warning",
+		"muted": "slate",
+		"dim": "quiet",
+		"text": "paper",
+		"thinkingText": "slate",
+
+		"selectedBg": "selectedBg",
+		"scrollbarThumb": "ruleStrong",
+		"searchMatchBg": "searchBg",
+		"searchMatchText": "#121519",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "paperBright",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "paperSoft",
+		"customMessageLabel": "blueprint",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "paperBright",
+		"toolOutput": "slate",
+
+		"mdHeading": "paperBright",
+		"mdLink": "blueprintBright",
+		"mdLinkUrl": "quiet",
+		"mdCode": "blueprint",
+		"mdCodeBlock": "paperSoft",
+		"mdCodeBlockBorder": "ruleStrong",
+		"mdQuote": "slate",
+		"mdQuoteBorder": "blueprintDeep",
+		"mdHr": "ruleStrong",
+		"mdListBullet": "blueprint",
+
+		"toolDiffAdded": "success",
+		"toolDiffRemoved": "error",
+		"toolDiffContext": "quiet",
+
+		"syntaxComment": "faint",
+		"syntaxKeyword": "blueprint",
+		"syntaxFunction": "blueprintBright",
+		"syntaxVariable": "paperSoft",
+		"syntaxString": "success",
+		"syntaxNumber": "warning",
+		"syntaxType": "#9FC4DF",
+		"syntaxOperator": "slate",
+		"syntaxPunctuation": "quiet",
+
+		"thinkingOff": "ruleStrong",
+		"thinkingMinimal": "faint",
+		"thinkingLow": "#6B7688",
+		"thinkingMedium": "blueprintDeep",
+		"thinkingHigh": "blueprint",
+		"thinkingXhigh": "blueprintBright",
+		"thinkingMax": "paperBright",
+
+		"bashMode": "success"
+	},
+	"export": {
+		"pageBg": "#121519",
+		"cardBg": "#181C22",
+		"infoBg": "#20252D"
+	}
+}

package/themes/tea-house.json

@@ -0,0 +1,89 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "tea-house",
+	"vars": {
+		"rice": "#d6cec0",
+		"tea": "#c4a06a",
+		"tatami": "#857a6a",
+		"shadow": "#5c554a",
+		"dusk": "#4a4438",
+		"matcha": "#a3af7d",
+		"persimmon": "#bf8a70",
+		"kindling": "#d1694e",
+
+		"selectedBg": "#241f19",
+		"userMsgBg": "#221d17",
+		"toolPendingBg": "#1d1813",
+		"toolSuccessBg": "#1b2016",
+		"toolErrorBg": "#261915",
+		"customMsgBg": "#211b14"
+	},
+	"colors": {
+		"accent": "tea",
+		"border": "shadow",
+		"borderAccent": "tea",
+		"borderMuted": "dusk",
+		"success": "matcha",
+		"error": "persimmon",
+		"warning": "#cba97e",
+		"muted": "tatami",
+		"dim": "shadow",
+		"text": "rice",
+		"thinkingText": "tatami",
+
+		"selectedBg": "selectedBg",
+		"scrollbarThumb": "selectedBg",
+		"searchMatchBg": "selectedBg",
+		"searchMatchText": "rice",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "rice",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "rice",
+		"customMessageLabel": "tea",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "#dbb886",
+		"toolOutput": "tatami",
+
+		"mdHeading": "#e0c191",
+		"mdLink": "#bdab84",
+		"mdLinkUrl": "shadow",
+		"mdCode": "#d4b583",
+		"mdCodeBlock": "#c9c2b2",
+		"mdCodeBlockBorder": "dusk",
+		"mdQuote": "tatami",
+		"mdQuoteBorder": "dusk",
+		"mdHr": "dusk",
+		"mdListBullet": "tea",
+
+		"toolDiffAdded": "matcha",
+		"toolDiffRemoved": "persimmon",
+		"toolDiffContext": "tatami",
+
+		"syntaxComment": "#6e6757",
+		"syntaxKeyword": "#c9a97a",
+		"syntaxFunction": "#d6b98c",
+		"syntaxVariable": "#b3aa96",
+		"syntaxString": "#a3af7d",
+		"syntaxNumber": "#c49a6e",
+		"syntaxType": "#93a68f",
+		"syntaxOperator": "#8f887a",
+		"syntaxPunctuation": "#8f887a",
+
+		"thinkingOff": "dusk",
+		"thinkingMinimal": "tatami",
+		"thinkingLow": "#a08d64",
+		"thinkingMedium": "tea",
+		"thinkingHigh": "#cf8f66",
+		"thinkingXhigh": "#bf7a5e",
+		"thinkingMax": "kindling",
+
+		"bashMode": "matcha"
+	},
+	"export": {
+		"pageBg": "#171310",
+		"cardBg": "#1e1914",
+		"infoBg": "#453a28"
+	}
+}