thoth-agents 0.3.5 → 0.3.7

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "thoth-agents",
       "description": "Adaptive root orchestration, six specialist subagents, and a runtime-autonomous Spec Kit-compatible SDD bundle.",
-      "version": "0.3.5",
+      "version": "0.3.7",
       "author": {
         "name": "thoth-agents maintainers"
       },

package/README.md

@@ -48,7 +48,8 @@ and permission semantics.
 
 ### OpenCode
 
-Install the plugin configuration, external skills, and thoth-mem companion:
+Install the plugin configuration, five thoth-owned skills, four external
+skills, and the thoth-mem companion globally:
 
 ```bash
 npx thoth-agents@latest install --agent=opencode --dry-run
@@ -61,12 +62,14 @@ Restart OpenCode and initialize the current repository:
 /thoth-init
 ```
 
-This copies the five thoth-owned workflow skills into `.agents/skills/` and
-creates missing `openspec/` governance files. The external skills are already in
-one of the OpenCode global discovery roots managed here,
-`~/.config/opencode/skills/` or `~/.agents/skills/`, and thoth-mem has completed
-its own provider setup from the CLI step. Existing project-owned files are
-preserved.
+The installer materializes the five packaged thoth-owned workflow skills under
+`~/.config/opencode/skills/`; external skills are installed globally from their
+canonical repositories, and thoth-mem completes its own provider setup. The
+`/thoth-init` command only initializes or synchronizes the minimum `openspec/`
+governance structure. It never installs skills, agents, plugins, harness
+configuration, dependencies, or workflow templates. SDD phases read templates
+directly from the globally installed `thoth-sdd` skill; any legacy project
+`openspec/templates/` tree remains untouched.
 
 ### Codex
 
@@ -88,8 +91,10 @@ Restart Codex, then initialize each target repository's SDD governance:
 $thoth-init
 ```
 
-The plugin contributes skills and MCP configuration. `$thoth-init` creates only
-missing `openspec/` governance files; it does not pretend to install agents.
+The plugin contributes skills, their workflow templates, and MCP configuration.
+`$thoth-init` creates only missing `openspec/` governance files; SDD phases read
+templates from the plugin's installed `thoth-sdd` skill instead of copying them
+into the repository.
 
 Review `/plugins` and `/hooks` after installation. Codex trust and
 higher-precedence instructions remain in force.
@@ -122,7 +127,7 @@ Claude discovers the packaged orchestrator, six namespaced subagents, and five
 thoth-owned skills from the plugin. The CLI installs the external skills into
 Claude's global skill root and requires thoth-mem's own setup result to be
 complete. Init creates only the missing project governance files; it never edits
-Claude's manager-owned plugin cache.
+Claude's manager-owned plugin cache or copies workflow templates out of it.
 
 See [Installation](docs/installation.md), [Codex Install](docs/codex-install.md),
 and [Claude Code Install](docs/claude-code-install.md) for scopes, verification,
@@ -319,7 +324,7 @@ Every harness package includes the workflow contracts owned by thoth-agents:
 
 | Skill | Purpose |
 | --- | --- |
-| `thoth-init` | Offline, idempotent project initialization. |
+| `thoth-init` | Offline, idempotent initialization and synchronization of minimum `openspec/` governance only. |
 | `thoth-sdd` | Route rules, phase contracts, templates, and structural validator. |
 | `thoth-constitution` | Explicit governance SemVer lifecycle; routine plans only read principles. |
 | `thoth-archive` | Passing closeout, transactional durable-spec sync, audit report, and dated move. |
@@ -348,7 +353,7 @@ diagnostics, manual actions, and receipt paths remain visible for recovery.
 
 | Harness | Important limitation |
 | --- | --- |
-| OpenCode | Strongest integrated path. The CLI installs the npm plugin configuration, external skills, and provider-owned thoth-mem setup; `/thoth-init` materializes thoth-owned project skills/governance. Only the OpenAI built-in preset ships. |
+| OpenCode | Strongest integrated path. The CLI installs the npm plugin configuration, global thoth-owned and external skills, and provider-owned thoth-mem setup; `/thoth-init` only initializes per-repository `openspec/` governance. Only the OpenAI built-in preset ships. |
 | Codex | The CLI installs the native plugin and manages global `AGENTS.md`, six agent TOMLs, config, external skills, and thoth-mem setup; `$thoth-init` only initializes per-repository SDD governance. Runtime role matching and some permissions remain instruction-level. |
 | Claude Code | Run both native marketplace commands before the CLI installs external skills and requests thoth-mem setup. The native manager owns cache files; fine-grained path restrictions remain instruction-level. |
 
@@ -359,9 +364,11 @@ version lifecycle commands keep that shared bundle synchronized.
 
 ## Models and provider boundaries
 
-OpenCode ships only an `openai` preset. Kimi, GitHub Copilot, ZAI/GLM, and
-mixed-provider mappings are not built in. Explicit per-role model overrides
-remain available.
+OpenCode install and sync ship and select only the `openai` preset. Kimi,
+GitHub Copilot, ZAI/GLM, and mixed-provider mappings are not built in. Explicit
+per-role model overrides remain available. Applying model configuration creates
+a complete seven-role `agents` preset from the effective values and activates
+it with `preset: agents`; unrelated presets and configuration remain intact.
 
 thoth-mem is an independent plugin/provider. `thoth-agents install` orchestrates
 its public setup command, but thoth-mem owns the resulting hooks, MCP, skill,
@@ -391,7 +398,9 @@ npx thoth-agents@latest model --harness=codex --role=deep --model=gpt-5.6-sol
 
 In the interactive `Configure models` flow, `Apply` is always available. When
 no role is dirty, it reapplies every currently displayed role value; after an
-edit, preview and apply remain limited to the dirty roles.
+edit, preview and apply remain limited to the dirty roles. In OpenCode, both
+`Apply` and `Apply changes` materialize the complete effective roster and
+activate the named `agents` preset.
 
 It does not bypass native marketplace trust or edit manager-owned caches
 directly; Codex and Claude own their native manager mutations.