sortie-dogs 0.1.1 → 0.1.2

package/README.md

@@ -2,6 +2,10 @@
 
 **Give OpenCode a task; get a bounded, validated implementation loop instead of an open-ended agent run.**
 
+[![npm](https://img.shields.io/npm/v/sortie-dogs)](https://www.npmjs.com/package/sortie-dogs)
+[![license](https://img.shields.io/npm/l/sortie-dogs)](LICENSE)
+[![Node.js](https://img.shields.io/node/v/sortie-dogs)](https://www.npmjs.com/package/sortie-dogs)
+
 ![Sortie-dogs coordinating a bounded implementation workflow](https://raw.githubusercontent.com/zufall-upon/Sortie-dogs/main/docs/assets/sortie-workflow.gif)
 
 Sortie-dogs is an opt-in OpenCode orchestration plugin. It turns a task into a
@@ -13,6 +17,50 @@ Requirements: Node.js 22.6 or newer, npm, and OpenCode.
 
 Guides: [日本語](docs/guide-ja.md) · [简体中文](docs/guide-zh-CN.md)
 
+## Quick start
+
+Install the public npm package and generate the project-local runtime files:
+
+```sh
+npm install --save-dev sortie-dogs
+npx sortie-dogs init .
+```
+
+`dog-coordinator` and `dog-scout` default to `openai/gpt-5.6-luna`. To use a
+different model for both roles, save this as `.opencode/sortie-dogs.json`:
+
+```json
+{
+  "modelRouting": {
+    "dog-coordinator": {
+      "preferred": { "model": "provider/model" }
+    },
+    "dog-scout": {
+      "preferred": { "model": "provider/model" }
+    }
+  },
+  "modelCatalog": {
+    "project": [{ "model": "provider/model" }]
+  }
+}
+```
+
+Replace `provider/model` with a model available to you. Then create
+`.opencode/plugins/sortie-dogs.ts` as the OpenCode plugin bridge:
+
+```ts
+export { SortieDogsPlugin } from "sortie-dogs/plugin";
+```
+
+OpenCode discovers the bridge automatically; no `plugin` entry in
+`opencode.json` is required. Restart OpenCode, then start a task:
+
+```text
+/sortie <task>
+```
+
+Selecting `dog-coordinator` directly also activates the workflow.
+
 ## Why Sortie-dogs
 
 - **Focused when invited, invisible otherwise.** Activate it with `/sortie` or
@@ -28,6 +76,20 @@ Guides: [日本語](docs/guide-ja.md) · [简体中文](docs/guide-zh-CN.md)
 - **Long work can recover.** Restart recovery and bounded compaction continue
   from retained handoff context rather than silently starting over.
 
+## Example run
+
+An illustrative low-risk run stays bounded and reports its gates:
+
+```text
+You: /sortie Add the requested behavior
+dog-coordinator: manifest confirmed
+dog-scout ×3: investigation complete
+dog-worker: implementation complete
+validation: npm test — PASS
+review: skipped — low risk
+dog-coordinator: completion evidence accepted
+```
+
 ## The workflow
 
 1. **Brief and plan** — `dog-coordinator` turns the request into acceptance
@@ -63,31 +125,6 @@ gets more complex.
 Validation and risk-based review happen before coordinator-owned completion, so
 the result returns with a concise record of what changed and how it was checked.
 
-## Install from npm
-
-Install the public package in the target project, then generate the
-project-local runtime files:
-
-```sh
-npm install --save-dev sortie-dogs
-npx sortie-dogs init .
-```
-
-Create `.opencode/plugins/sortie-dogs.ts` as the OpenCode plugin bridge:
-
-```ts
-export { SortieDogsPlugin } from "sortie-dogs/plugin";
-```
-
-OpenCode discovers the bridge automatically; no `plugin` entry in
-`opencode.json` is required. Restart OpenCode, then start a task:
-
-```text
-/sortie <task>
-```
-
-Selecting `dog-coordinator` directly also activates the workflow.
-
 ## Scope and session guarantees
 
 The plugin is passive by default. It activates a session only when a message
@@ -170,31 +207,7 @@ untouched and initialization stops safely. User-owned configuration—including
 
 ## Safe manual removal
 
-There is no supported Sortie-dogs uninstall command. Removing the npm dependency
-is a separate package-manager operation: run `npm uninstall sortie-dogs` only in
-the directory whose `package.json` declares it. Never delete `package.json` or
-`package-lock.json` to remove the package.
-
-To remove generated runtime files manually, delete only these exact
-Sortie-dogs-owned paths:
-
-```text
-.opencode/agent/dog-coordinator.md
-.opencode/agent/dog-worker.md
-.opencode/agent/dog-scout.md
-.opencode/agent/dog-reviewer.md
-.opencode/agent/dog-advisor.md
-.opencode/command/sortie.md
-.opencode/sortie-dogs.version
-```
-
-Never delete the `.opencode`, `.opencode/agent`, or `.opencode/command`
-directories, and never use a wildcard such as `*.md`. Preserve the standard
-`plan`, `build`, and `builder` agents and every other user-owned file. Do not
-remove `.opencode/sortie-dogs.json`, the plugin bridge, other agents, or OpenCode
-settings as part of runtime-file removal.
-
-The legacy files `.opencode/agent/coordinator-mk2a2.md` and
-`.opencode/agent/sol-worker-mk2a2.md` may be removed only after an old
-Sortie-dogs marker or the content confirms Sortie-dogs ownership. If ownership
-is unclear or a filename is unexpected, stop and inspect instead of deleting.
+There is no supported Sortie-dogs uninstall command. Remove the npm dependency
+separately, then follow the [safe manual removal guide](docs/uninstall.md) to
+delete only Sortie-dogs-owned runtime files without affecting user files or
+standard OpenCode agents.

package/dist/plugin/model-routing.d.ts

@@ -8,7 +8,7 @@ export interface RoleModelRoute {
 }
 export type ModelRoutingConfig = Readonly<Record<string, RoleModelRoute>>;
 export declare const DEDICATED_SOL_MODEL = "openai/gpt-5.6-sol";
-export declare const DEDICATED_SOL_ROLES: readonly ["implementation", "remediation", "blocker-resolution", "sol-worker-mk2a2"];
+export declare const DEDICATED_SOL_ROLES: readonly ["implementation", "remediation", "blocker-resolution", "sol-worker-mk2a2", "dog-worker"];
 /** Fixed Mk2A2 worker routes. These deliberately contain no fallback targets. */
 export declare const DEDICATED_SOL_ROUTING: ModelRoutingConfig;
 export declare const RECOMMENDED_LUNA_MODEL = "openai/gpt-5.6-luna";

package/dist/plugin/model-routing.js

@@ -4,6 +4,7 @@ export const DEDICATED_SOL_ROLES = [
     "remediation",
     "blocker-resolution",
     "sol-worker-mk2a2",
+    "dog-worker",
 ];
 const dedicatedSolRoleSet = new Set(DEDICATED_SOL_ROLES);
 /** Fixed Mk2A2 worker routes. These deliberately contain no fallback targets. */

package/dist/runtime-assets.d.ts

@@ -13,7 +13,7 @@ export declare const runtimeAssets: readonly [{
     readonly name: "dog-worker";
     readonly version: "0.2.0-card05";
     readonly installPath: "agent/dog-worker.md";
-    readonly content: "---\ndescription: Dedicated Sol worker for the canonical Mk2A2 coordinator\nmode: subagent\n---\n# dog-worker\n\nYou are the dedicated implementation worker for dog-coordinator.\n\nAccept implementation, remediation, and blocker-resolution work only from dog-coordinator.\nExecute the supplied manifest within its acceptance criteria, run the requested validation,\nand return concise change and validation evidence only to dog-coordinator. Do not act as the\nuser-facing coordinator.\n";
+    readonly content: "---\ndescription: Dedicated Sol worker for the canonical Mk2A2 coordinator\nmode: subagent\nmodel: openai/gpt-5.6-sol\n---\n# dog-worker\n\nYou are the dedicated implementation worker for dog-coordinator.\n\nAccept implementation, remediation, and blocker-resolution work only from dog-coordinator.\nExecute the supplied manifest within its acceptance criteria, run the requested validation,\nand return concise change and validation evidence only to dog-coordinator. Do not act as the\nuser-facing coordinator.\n";
 }, {
     readonly name: "dog-scout";
     readonly version: "0.2.0-card05";

package/dist/runtime-assets.js

@@ -1,3 +1,4 @@
+const { DEDICATED_SOL_MODEL } = await import(`./plugin/model-routing.${import.meta.url.endsWith(".ts") ? "ts" : "js"}`);
 export const runtimeAssets = [
     {
         name: "dog-coordinator",
@@ -251,6 +252,7 @@ END_TERMINAL_EVIDENCE_FIXTURE
         content: `---
 description: Dedicated Sol worker for the canonical Mk2A2 coordinator
 mode: subagent
+model: ${DEDICATED_SOL_MODEL}
 ---
 # dog-worker
 

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "sortie-dogs",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Bounded, validated orchestration loop plugin for OpenCode",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "ai-orchestration",
+    "multi-agent"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",