opencode-code-archaeology 2.0.2 → 2.2.1

package/AGENTS.md

@@ -1,27 +1,35 @@
 # Code Archaeology Agent Guide
 
-Code Archaeology is an OpenCode plugin for systematic codebase excavation, cataloging, and restoration.
+Code Archaeology is a multi-runtime plugin for systematic codebase excavation, cataloging, and restoration. It supports both **OpenCode** and **Hermes Agent** runtimes.
 
 ## Runtime Policy
 
-- OpenCode is the only supported worker runtime.
+- **OpenCode** is the primary interactive runtime (slash commands).
+- **Hermes Agent** is the cron-based background runtime (one phase per 15-minute run).
 - The plugin operates entirely within the target repository.
 - All changes are isolated to a configurable branch (`refactor/archaeology` by default).
 
 ## Available Hooks
 
-Core hooks in `hooks/opencode/`:
-- `init.sh` — Initialize `.archaeology/` directory and session state
-- `verify-phase.sh` — Run tests and typecheck between phases
-- `revert-phase.sh` — Revert changes if a phase fails verification
-- `update-expedition.sh` — Update expedition status in session.json
+### OpenCode hooks (`hooks/opencode/`)
+- `init.sh` / `init.ps1` — Initialize `.archaeology/` directory and session state
+- `verify-phase.sh` / `verify-phase.ps1` — Run tests and typecheck between phases
+- `revert-phase.sh` / `revert-phase.ps1` — Revert changes if a phase fails verification
+- `update-expedition.sh` / `update-expedition.ps1` — Update expedition status in session.json
+
+### Hermes hooks (`hooks/hermes/`)
+- `setup.sh` / `setup.ps1` — Detect Hermes capabilities and write `hermes-runtime.json`
+- `runner.sh` / `runner.ps1` — Execute one expedition phase per cron run with test gates
+
+**Platform support:** `.sh` scripts run on macOS/Linux; `.ps1` scripts run on Windows (PowerShell).
 
 ## Safety Hooks
 
-- `verify-phase.sh` — Mandatory test/typecheck gate between expeditions
-- `revert-phase.sh` — Automatic rollback on failure
+- `verify-phase.sh` — Mandatory test/typecheck gate between expeditions (OpenCode)
+- `revert-phase.sh` — Automatic rollback on failure (OpenCode)
+- `runner.sh` — Built-in pre/post verification and auto-revert (Hermes)
 
-## Workflow
+## OpenCode Workflow
 
 1. Run `hooks/opencode/init.sh` to initialize the session
 2. For each expedition:
@@ -31,6 +39,19 @@ Core hooks in `hooks/opencode/`:
    d. Run `hooks/opencode/update-expedition.sh <phase> <status> [findings]`
 3. Final verification runs all checks and generates `FINAL_CATALOG.md`
 
+## Hermes Workflow
+
+1. Run `hooks/hermes/setup.sh` to detect Hermes capabilities
+2. Create a Hermes cronjob (see `skills/hermes/INTEGRATION.md`)
+3. Each cron run executes **exactly ONE** phase:
+   a. Read `.archaeology/session.json` for current phase and mode
+   b. Run the phase (survey, excavate, or restore)
+   c. Run test/typecheck verification
+   d. Keep or revert changes automatically
+   e. Advance to next phase in `session.json`
+   f. **STOP** — next cron run continues
+4. After 10 phases, `FINAL_CATALOG.md` is generated
+
 ## Local State
 
 `.archaeology/` is runtime state and must not be committed.
@@ -42,6 +63,7 @@ Key files:
 - `FINAL_CATALOG.md` — Completed excavation summary
 - `excavation_log.txt` — `git diff --stat`
 - `patches/` — Mock patches (excavate mode)
+- `hermes-runtime.json` — Hermes runtime configuration (Hermes only)
 
 ## Modes
 
@@ -63,6 +85,8 @@ Key files:
 
 ## Verification
 
+### OpenCode
+
 Before claiming work is complete:
 
 ```bash
@@ -70,6 +94,14 @@ bash hooks/opencode/verify-phase.sh final_verify
 bash -n hooks/opencode/*.sh
 ```
 
+### Hermes
+
+Verification is built into `runner.sh`:
+
+```bash
+bash hooks/hermes/runner.sh
+```
+
 ## Language Support
 
 | Language | Dead Code | Dependencies | Types | DRY |

package/CHANGELOG.md

@@ -1,5 +1,71 @@
+## [2.2.1](https://github.com/Maleick/Code-Archaeology/compare/v2.2.0...v2.2.1) (2026-05-07)
+
+
+### Bug Fixes
+
+* opt actions into Node 24 runtime ([#14](https://github.com/Maleick/Code-Archaeology/issues/14)) ([1d2b797](https://github.com/Maleick/Code-Archaeology/commit/1d2b797c629ba0c3a7b9245cb596e3fac2c42cd7))
+
+# [2.2.0](https://github.com/Maleick/Code-Archaeology/compare/v2.1.0...v2.2.0) (2026-05-07)
+
+
+### Bug Fixes
+
+* avoid session-sourced verification commands ([#10](https://github.com/Maleick/Code-Archaeology/issues/10)) ([9d3296d](https://github.com/Maleick/Code-Archaeology/commit/9d3296d1551ed7c97b90aca5c4be932bad5042e6))
+* harden PowerShell verification hooks ([#6](https://github.com/Maleick/Code-Archaeology/issues/6)) ([ae1c1fa](https://github.com/Maleick/Code-Archaeology/commit/ae1c1fab3b1ce84872ad8217959d321e8e42266b))
+* harden trusted publishing safety ([c78ee2e](https://github.com/Maleick/Code-Archaeology/commit/c78ee2e9bc75ff6554e75f848f64a3054a74344e))
+* **hermes:** require operator approval for restore mode ([#8](https://github.com/Maleick/Code-Archaeology/issues/8)) ([772cd67](https://github.com/Maleick/Code-Archaeology/commit/772cd67df32f853c562fe8ed46f6d1528b477fda))
+* only set completed_at when status is completed ([ebf1040](https://github.com/Maleick/Code-Archaeology/commit/ebf1040fb8a4a9ff23a40d6fa6042313e590b363))
+* pass model router args safely ([#11](https://github.com/Maleick/Code-Archaeology/issues/11)) ([a7379fc](https://github.com/Maleick/Code-Archaeology/commit/a7379fcf425eab70f2906de75f0a158e7d418e85))
+* secure Hermes session rewrites ([#7](https://github.com/Maleick/Code-Archaeology/issues/7)) ([55d5694](https://github.com/Maleick/Code-Archaeology/commit/55d5694684158d1ae471fed25b4f8de0706c7810))
+
+
+### Features
+
+* Add Windows/PowerShell support ([a6b74ea](https://github.com/Maleick/Code-Archaeology/commit/a6b74ea75c1eb60263e939df3dc27fa4cc8b7a72)), closes [#4](https://github.com/Maleick/Code-Archaeology/issues/4)
+
+# [2.1.0](https://github.com/Maleick/Code-Archaeology/compare/v2.0.2...v2.1.0) (2026-05-05)
+
+
+### Bug Fixes
+
+* align analysis tool types ([65b19b2](https://github.com/Maleick/Code-Archaeology/commit/65b19b2b581c2e3f196f3d53886fd8dfdab23ea2))
+* block invalid Hermes sessions ([aaafd4f](https://github.com/Maleick/Code-Archaeology/commit/aaafd4f0a0d6652ae92b5513caa13b2fabcab06e))
+* harden Hermes install checks ([bc034cc](https://github.com/Maleick/Code-Archaeology/commit/bc034cca6cb8af88287cc3656cd72adf8a4246c1))
+* remove embedded worktree and ignore .autoship/ ([400b554](https://github.com/Maleick/Code-Archaeology/commit/400b55452f96f604074d73f6eea79cf996a91aad))
+* remove stale PluginServer stub ([#3](https://github.com/Maleick/Code-Archaeology/issues/3)) ([f8b15a3](https://github.com/Maleick/Code-Archaeology/commit/f8b15a306f55cfa6e036cc05e115357ec68df023)), closes [#2](https://github.com/Maleick/Code-Archaeology/issues/2)
+
+
+### Features
+
+* **hermes:** add full Hermes Agent runtime support ([2f4ad41](https://github.com/Maleick/Code-Archaeology/commit/2f4ad41060994802c1fb3c5a480e88728838130b)), closes [#hermes-support](https://github.com/Maleick/Code-Archaeology/issues/hermes-support) [#multi-runtime](https://github.com/Maleick/Code-Archaeology/issues/multi-runtime)
+* prepare v2.1.0 release ([54507d4](https://github.com/Maleick/Code-Archaeology/commit/54507d423b421535116363be86fbcba30b161d9e))
+* **routing:** add intelligent model routing for free-tier priority ([a456556](https://github.com/Maleick/Code-Archaeology/commit/a45655602106933de64a0af5b63e18e6378847d7))
+
 # Changelog
 
+## Unreleased
+
+- Switched release publishing to npm trusted publishing with GitHub Actions OIDC.
+- Hardened Hermes restore mode so it blocks explicitly until implemented instead of reporting a successful no-op restore.
+- Changed OpenCode revert handling to preserve failed phase changes in a named git stash instead of dropping them.
+- Exposed public type definitions through package exports and excluded the repo-local legacy plugin shim from npm package contents.
+
+## v2.1.0
+
+- Changed `/code-archaeology` to run the full 10-phase survey chain by default without per-phase prompts.
+- Kept the default OpenCode flow non-destructive: survey mode writes report artifacts under `.archaeology/` only.
+- Clarified that `/code-archaeology-restore` remains the explicit command for applying source changes.
+- Updated command, CLI, plugin, and release tests for the new default survey-chain behavior.
+
+## v2.0.3
+
+- Hardened Hermes runner startup so clean repositories initialize `.archaeology/session.json` without requiring prior setup.
+- Added clear blocked-state handling for malformed Hermes session phases instead of allowing low-level `jq` failures.
+- Added invalid JSON protection for Hermes session files so corrupted state is reported without being overwritten.
+- Expanded CLI `doctor` checks and tests to verify Hermes hooks and integration docs are packaged alongside OpenCode assets.
+- Aligned the exported analysis-tool type contract with the documented TypeScript, JavaScript, Python, Go, and Rust tool matrix.
+- Updated install documentation to cover Hermes verification and troubleshooting parity with OpenCode.
+
 ## v2.0.2
 
 - Added release-ready repository parity files: CI workflow, issue templates, PR template, security policy, contribution guide, and changelog.

package/CONTRIBUTING.md

@@ -34,6 +34,8 @@ npm pack --json --dry-run
 
 If a restore-mode change modifies behavior, verify it against a disposable repository or fixture and document the result.
 
+Before committing, pushing, or opening a PR, run a polish pass over the changed surface. Check wording, links, visuals, accessibility, package contents, and whether the repository presentation still looks complete.
+
 ## Documentation Expectations
 
 - Update `README.md`, `INSTALL.md`, `docs/`, or `wiki/` when installation, commands, workflow, safety, or release behavior changes.

package/INSTALL.md

@@ -1,21 +1,27 @@
 # Install Code Archaeology
 
-Code Archaeology is an OpenCode plugin for systematic codebase excavation. It is non-destructive by default: `survey` mode writes reports only, while `restore` mode modifies code after review and verification.
+Code Archaeology is a multi-runtime plugin for systematic codebase excavation. It is non-destructive by default: `survey` mode writes reports only, while `restore` mode modifies code after review and verification.
+
+## Runtimes
+
+- **OpenCode** — Interactive slash-command runtime (`/code-archaeology`)
+- **Hermes Agent** — Cron-based background runtime (one phase per 15-minute run)
 
 ## OpenCode Handoff
 
 Paste this into OpenCode if you want the agent to install and verify the plugin for you:
 
 ```text
-Fetch and follow instructions from https://raw.githubusercontent.com/Maleick/Code-Archaeology/refs/heads/main/INSTALL.md
+Run `npm pack opencode-code-archaeology@2.2.0`, extract the resulting tarball, then open and follow `package/INSTALL.md` from that tarball. If you need a concrete command sequence: `npm pack opencode-code-archaeology@2.2.0 && tar -xof opencode-code-archaeology-2.2.0.tgz && cat package/INSTALL.md`.
 ```
 
 ## Prerequisites
 
-- OpenCode installed and available in your shell.
-- Node.js with npm, or Bun if your OpenCode setup uses Bun package resolution.
+- Node.js with npm, or Bun if your setup uses Bun package resolution.
 - Git installed and available in your shell.
 - A target repository with tests or type checks available before you run `restore` mode.
+- For Hermes: Hermes Agent CLI or an active Hermes session.
+- **Windows**: PowerShell 5.1 or later (hooks use `.ps1` scripts on Windows).
 
 ## Recommended OpenCode Plugin Install
 
@@ -24,7 +30,7 @@ Add Code Archaeology to your `opencode.json` plugin array:
 ```json
 {
   "plugin": [
-    "opencode-code-archaeology@git+https://github.com/Maleick/Code-Archaeology.git"
+    "opencode-code-archaeology@2.2.0"
   ]
 }
 ```
@@ -38,12 +44,48 @@ Restart OpenCode after editing the configuration. The command family should then
 /code-archaeology-restore
 ```
 
+`/code-archaeology` runs the full 10-phase survey chain by default without per-phase prompts. It writes reports under `.archaeology/` and makes no source-code changes. Use `/code-archaeology-restore` only after reviewing the reports and deciding to apply changes.
+
+## Hermes Setup
+
+### 1. Install Code Archaeology CLI
+
+```bash
+npm install -g opencode-code-archaeology@2.2.0
+```
+
+### 2. Setup Hermes Runtime
+
+**macOS/Linux:**
+```bash
+cd ~/projects/Code-Archaeology
+bash hooks/hermes/setup.sh
+```
+
+**Windows:**
+```powershell
+cd ~/projects/Code-Archaeology
+.\hooks\hermes\setup.ps1
+```
+
+### 3. Create Hermes Cronjob
+
+```bash
+hermes cronjob create \
+  --name "code-archaeology-expedition" \
+  --schedule "every 15m" \
+  --workdir ~/projects/Code-Archaeology \
+  --prompt "Run one Code Archaeology expedition phase. Read .archaeology/session.json, execute current phase with verification, advance to next phase."
+```
+
+See `skills/hermes/INTEGRATION.md` for full Hermes integration details.
+
 ## npm Global Install
 
 If you prefer a global package install:
 
 ```bash
-npm install -g opencode-code-archaeology
+npm install -g opencode-code-archaeology@2.2.0
 opencode-code-archaeology install
 opencode-code-archaeology doctor
 opencode-code-archaeology version
@@ -52,7 +94,7 @@ opencode-code-archaeology version
 Then restart OpenCode and run:
 
 ```text
-/code-archaeology-survey
+/code-archaeology
 ```
 
 ## One-Time Bun Path
@@ -60,8 +102,8 @@ Then restart OpenCode and run:
 If your environment supports one-time package execution through Bun:
 
 ```bash
-bunx opencode-code-archaeology install
-bunx opencode-code-archaeology doctor
+bunx opencode-code-archaeology@2.2.0 install
+bunx opencode-code-archaeology@2.2.0 doctor
 ```
 
 Use the plugin-array install for normal OpenCode usage.
@@ -83,41 +125,68 @@ npm install
 npm run build
 npm run typecheck
 bash -n hooks/opencode/*.sh
+bash -n hooks/hermes/*.sh
+```
+
+**Windows:**
+```powershell
+npm install
+npm run build
+npm run typecheck
+Get-ChildItem hooks/opencode/*.ps1 | ForEach-Object { Get-Command $_.FullName }
+Get-ChildItem hooks/hermes/*.ps1 | ForEach-Object { Get-Command $_.FullName }
 ```
 
 To verify command availability, restart OpenCode in a Git repository and run:
 
 ```text
-/code-archaeology-survey
+/code-archaeology
 ```
 
-The survey should create `.archaeology/` reports without modifying source files.
+The default survey chain should create `.archaeology/` reports without modifying source files or asking to proceed phase by phase.
 
 ## Updating
 
-For plugin-array installs, update through your OpenCode package manager flow, then restart OpenCode. If your setup caches git plugins, clear the cached plugin package and let OpenCode reinstall it.
+For plugin-array installs, update by changing the package version to a reviewed npm release, then restart OpenCode. Do not point OpenCode at a mutable Git branch such as `main` for automatic updates.
 
 For npm global installs:
 
 ```bash
-npm install -g opencode-code-archaeology@latest
+npm install -g opencode-code-archaeology@2.2.0
 npm list -g opencode-code-archaeology --depth=0
 ```
 
 ## Troubleshooting
 
-### Plugin Not Loading
+### Plugin Not Loading (OpenCode)
 
 - Confirm `opencode.json` is valid JSON.
 - Confirm the plugin entry is in the top-level `plugin` array.
 - Restart OpenCode after changing the config.
-- Check that Git can reach `https://github.com/Maleick/Code-Archaeology.git`.
+- Check that npm can resolve the pinned `opencode-code-archaeology` release.
 
-### Commands Not Found
+### Commands Not Found (OpenCode)
 
 - Restart OpenCode so it reloads plugin commands.
 - Confirm the package installed successfully with `npm list -g opencode-code-archaeology --depth=0` if using the global path.
-- Run `/code-archaeology-survey` from inside a Git repository, not from an empty directory.
+- Run `/code-archaeology` from inside a Git repository, not from an empty directory.
+
+### Cron Not Running (Hermes)
+
+```bash
+hermes cronjob list
+hermes cronjob log code-archaeology-expedition
+```
+
+### Phase Blocked (Hermes)
+
+```bash
+# Check blocker
+cat .archaeology/session.json | jq '.flags.blocked_reason'
+
+# Reset and retry
+jq '.status = "running" | del(.flags.blocked_reason)' .archaeology/session.json > tmp.json && mv tmp.json .archaeology/session.json
+```
 
 ### Stale Cache
 
@@ -127,10 +196,10 @@ npm list -g opencode-code-archaeology --depth=0
 
 ### Restore Safety
 
-- Start with `/code-archaeology-survey`; it writes reports only.
+- Start with `/code-archaeology` (OpenCode) or `mode = "survey"` (Hermes); it writes reports only.
 - Review `.archaeology/site_survey.md` and expedition reports before restore.
-- Use `/code-archaeology-excavate` for mock patches if you want another review gate.
-- Run `/code-archaeology-restore` only when the target repository has tests or type checks available.
+- Use `/code-archaeology-excavate` (OpenCode) or `mode = "excavate"` (Hermes) for mock patches if you want another review gate.
+- Run `/code-archaeology-restore` (OpenCode) or `mode = "restore"` (Hermes) only when the target repository has tests or type checks available.
 - Do not commit `.archaeology/`; it is local runtime state.
 
 ## Links
@@ -139,3 +208,4 @@ npm list -g opencode-code-archaeology --depth=0
 - Wiki: https://github.com/Maleick/Code-Archaeology/wiki
 - Releases: https://github.com/Maleick/Code-Archaeology/releases
 - Issues: https://github.com/Maleick/Code-Archaeology/issues
+- Hermes docs: https://hermes-agent.nousresearch.com/docs

package/README.md

@@ -1,7 +1,7 @@
 <h1 align="center">Code Archaeology</h1>
 
 <p align="center">
-  <img src="assets/code-archaeology-banner.svg" alt="Code Archaeology OpenCode plugin banner" width="900">
+  <img src="assets/code-archaeology-banner.svg" alt="Code Archaeology multi-runtime banner" width="900">
 </p>
 
 <p align="center">
@@ -23,7 +23,9 @@
   <a href="#release-docs">Release</a>
 </p>
 
-Code Archaeology is an OpenCode plugin that surveys, catalogs, and safely restores codebases by removing accumulated technical sediment in a fixed, test-gated expedition order.
+Excavate technical debt. Restore with confidence.
+
+Code Archaeology is a multi-runtime plugin that surveys, catalogs, and safely restores codebases by removing accumulated technical sediment in a fixed, test-gated expedition order. It runs on **OpenCode** (interactive slash commands) and **Hermes Agent** (cron-based background execution).
 
 ```text
 +---------------------------------------------------------------+
@@ -33,7 +35,8 @@ Code Archaeology is an OpenCode plugin that surveys, catalogs, and safely restor
 | Review mode        | excavate: reports plus mock patches       |
 | Restore mode       | applies approved changes with test gates  |
 | Local state        | .archaeology/ runtime artifacts           |
-| Runtime            | OpenCode plugin inside the target repo    |
+| Runtimes           | OpenCode plugin + Hermes Agent cron       |
+| Platforms          | macOS/Linux (bash) + Windows (PowerShell) |
 | Expedition order   | fixed stratigraphy from survey to catalog |
 +-------------------+-------------------------------------------+
 ```
@@ -49,13 +52,16 @@ Code Archaeology runs a systematic excavation of a repository before it changes
 - Hardens weak types without guessing uncertain replacements.
 - Finds semantic duplication and error-handling slop while preserving I/O boundaries.
 - Produces `.archaeology/` reports that stay local to the working repository.
+- Supports both **OpenCode** interactive sessions and **Hermes Agent** cron-based phased execution.
 
 ## Installation
 
-For OpenCode, paste this handoff into your agent:
+### OpenCode
+
+Paste this handoff into your agent:
 
 ```text
-Fetch and follow instructions from https://raw.githubusercontent.com/Maleick/Code-Archaeology/refs/heads/main/INSTALL.md
+Run `npm pack opencode-code-archaeology@2.2.0`, extract the tarball, then open `package/INSTALL.md` from that archive and follow its instructions.
 ```
 
 Recommended plugin install in `opencode.json`:
@@ -63,7 +69,7 @@ Recommended plugin install in `opencode.json`:
 ```json
 {
   "plugin": [
-    "opencode-code-archaeology@git+https://github.com/Maleick/Code-Archaeology.git"
+    "opencode-code-archaeology@2.2.0"
   ]
 }
 ```
@@ -71,30 +77,43 @@ Recommended plugin install in `opencode.json`:
 Global npm install path:
 
 ```bash
-npm install -g opencode-code-archaeology
-opencode-code-archaeology install
-opencode-code-archaeology doctor
-opencode-code-archaeology version
+npm install -g opencode-code-archaeology@2.2.0 && opencode-code-archaeology install && opencode-code-archaeology doctor
 ```
 
 One-time package runner path, if your OpenCode setup supports package execution through Bun:
 
 ```bash
-bunx opencode-code-archaeology install
-bunx opencode-code-archaeology doctor
+bunx opencode-code-archaeology@2.2.0 install
+bunx opencode-code-archaeology@2.2.0 doctor
+```
+
+### Hermes Agent
+
+```bash
+npm install -g opencode-code-archaeology@2.2.0
+cd ~/projects/Code-Archaeology
+bash hooks/hermes/setup.sh
+
+hermes cronjob create \
+  --name "code-archaeology-expedition" \
+  --schedule "every 15m" \
+  --workdir ~/projects/Code-Archaeology \
+  --prompt "Run one Code Archaeology expedition phase. Read .archaeology/session.json, execute current phase with verification, advance to next phase."
 ```
 
 See [`INSTALL.md`](INSTALL.md) for prerequisites, verification, updating, and troubleshooting.
 
 ## Quick Start
 
+### OpenCode
+
 Run the command family from inside the repository you want to inspect:
 
 ```text
 /code-archaeology
 ```
 
-Start non-destructively, review the reports, then choose whether to generate mock patches or apply approved changes:
+`/code-archaeology` runs the full 10-phase survey chain without per-phase prompts. It writes reports under `.archaeology/` and makes no source-code changes. Review the reports, then choose whether to generate mock patches or apply approved changes:
 
 ```text
 /code-archaeology-survey
@@ -102,11 +121,33 @@ Start non-destructively, review the reports, then choose whether to generate moc
 /code-archaeology-restore
 ```
 
+### Hermes Agent
+
+Each cron run executes exactly **one** phase. The runner reads `.archaeology/session.json`, runs the current phase with verification, and advances to the next phase:
+
+```bash
+bash hooks/hermes/runner.sh
+```
+
+Ten phases complete in ~2.5 hours minimum (15-minute intervals).
+
+## Runtime Surfaces
+
+| Feature | OpenCode | Hermes Agent |
+|---------|----------|--------------|
+| Entry | `/code-archaeology` slash command | `cronjob` |
+| Phases | All in one session | One per cron run |
+| Verification | Between expeditions | Between every phase |
+| Revert | Manual or automatic | Automatic on failure |
+| State | `.archaeology/session.json` | Same file |
+| Background | Plugin stays active | Cron resumes automatically |
+| Real-time | Yes | Delayed (15-min intervals) |
+
 ## Expedition Flow
 
 ```mermaid
 flowchart TD
-  A[Start /code-archaeology] --> B[Site Survey and Baseline]
+  A[Start] --> B[Site Survey and Baseline]
   B --> C[Dead Code Excavation]
   C --> D[Legacy Stratum Removal]
   D --> E[Circular Dependency Cartography]
@@ -141,24 +182,35 @@ flowchart LR
 
 ## Commands
 
+### OpenCode
+
 | Command | Purpose | File changes |
 | --- | --- | --- |
-| `/code-archaeology` | Start the full expedition in the configured mode. | Depends on mode; defaults to none. |
+| `/code-archaeology` | Run the full 10-phase survey chain without per-phase prompts. | None outside `.archaeology/`. |
 | `/code-archaeology-survey` | Generate site reports for review. | None outside `.archaeology/`. |
 | `/code-archaeology-excavate` | Generate reports and mock patches. | None outside `.archaeology/patches/`. |
 | `/code-archaeology-restore` | Apply approved high-confidence changes. | Yes, test-gated. |
 
-## Parameters
+### Hermes Agent
 
-| Parameter | Default | Description |
+| OpenCode Equivalent | Hermes Mechanism | File changes |
 | --- | --- | --- |
-| `repo_path` | `.` | Target repository to excavate. |
-| `language` | `typescript` | Primary language for tooling selection. |
-| `mode` | `survey` | `survey`, `excavate`, or `restore`. |
-| `strict_mode` | `false` | When true, restore may also apply medium-confidence findings. |
-| `test_command` | `npm test` | Test command run by verification hooks. |
-| `typecheck_command` | `npx tsc --noEmit` | Type-check command run by verification hooks. |
-| `branch_name` | `refactor/archaeology` | Branch used for isolated restore work. |
+| `/code-archaeology` | `cronjob` runs expedition loop | Depends on mode |
+| `/code-archaeology-survey` | `mode = "survey"` in `session.json` | None outside `.archaeology/` |
+| `/code-archaeology-excavate` | `mode = "excavate"` in `session.json` | None outside `.archaeology/patches/` |
+| `/code-archaeology-restore` | `mode = "restore"` in `session.json` | Yes, test-gated |
+
+## Parameters
+
+| Parameter | Default | Description | Hermes Notes |
+| --- | --- | --- | --- |
+| `repo_path` | `.` | Target repository to excavate. | Set in `session.json` before first cron run. |
+| `language` | `typescript` | Primary language for tooling selection. | Same |
+| `mode` | `survey` | `survey`, `excavate`, or `restore`. | Change in `session.json` to switch modes. |
+| `strict_mode` | `false` | When true, restore may also apply medium-confidence findings. | Same |
+| `test_command` | `npm test` | Recorded session default only; verification hooks do not execute repository-local command values. Use `CODE_ARCHAEOLOGY_TEST_COMMAND` to approve an override for the current process. | Same |
+| `typecheck_command` | `npx tsc --noEmit` | Recorded session default only; verification hooks do not execute repository-local command values. Use `CODE_ARCHAEOLOGY_TYPECHECK_COMMAND` to approve an override for the current process. | Same |
+| `branch_name` | `refactor/archaeology` | Branch used for isolated restore work. | Same |
 
 ## Expedition Order
 
@@ -198,12 +250,15 @@ Code-Archaeology/
 |-- dist/               # Built package output for GitHub-based installs
 |-- docs/               # Public docs and release notes
 |-- hooks/opencode/     # Init, verification, revert, and status hooks
-|-- plugins/            # OpenCode plugin entry point
+|-- hooks/hermes/       # Setup and runner hooks for Hermes Agent
+|-- plugins/            # Repo-local legacy plugin shim
 |-- prompts/            # Expedition prompts by phase
 |-- schema/             # JSON schemas for reports
-|-- skills/             # Code Archaeology skill definition
+|-- skills/             # Code Archaeology skill definitions
+|   |-- code-archaeology/   # OpenCode skill
+|   `-- hermes/             # Hermes Agent skill and integration docs
 |-- src/                # TypeScript source
-|-- INSTALL.md          # OpenCode install handoff
+|-- INSTALL.md          # Multi-runtime install handoff
 |-- README.md           # Public project overview
 `-- AGENTS.md           # Agent runtime guide
 ```
@@ -220,6 +275,7 @@ All expedition state is written to `.archaeology/` inside the target repository:
 | `FINAL_CATALOG.md` | Final excavation summary and recommendations. |
 | `excavation_log.txt` | `git diff --stat` for applied restoration work. |
 | `patches/` | Mock patches generated by `excavate` mode. |
+| `hermes-runtime.json` | Hermes runtime configuration (Hermes only). |
 
 ## Local Testing
 
@@ -231,19 +287,24 @@ npm run build
 npm run typecheck
 npm pack --json --dry-run
 bash -n hooks/opencode/*.sh
+bash -n hooks/hermes/*.sh
 ```
 
-For a restore expedition, run the configured test and type-check commands between phases. The bundled verification hook is:
+For a restore expedition, run the configured test and type-check commands between phases. The bundled verification hooks are:
 
 ```bash
+# OpenCode
 bash hooks/opencode/verify-phase.sh final_verify
+
+# Hermes
+bash hooks/hermes/runner.sh
 ```
 
 ## Release Docs
 
 - [`docs/README.md`](docs/README.md) is the documentation landing page.
 - [`docs/RELEASE.md`](docs/RELEASE.md) covers release preparation and publishing.
-- [`INSTALL.md`](INSTALL.md) is the raw handoff for OpenCode installation.
+- [`INSTALL.md`](INSTALL.md) is the raw handoff for multi-runtime installation.
 - [GitHub Releases](https://github.com/Maleick/Code-Archaeology/releases) lists published versions.
 
 ## License

package/VERSION

@@ -1 +1 @@
-2.0.2
+2.2.0