thoth-agents 0.3.9 → 0.3.11

package/dist/{chunk-XEEYNMPC.js → chunk-ZEAAWBF2.js}

@@ -28,13 +28,14 @@ import {
   isValidPackageVersion,
   loadAgentPrompt,
   parseConfig,
+  renderAgentRoutingDescription,
   renderPromptSection,
   renderRolePrompt,
   resolveExecutingPackageVersion,
   updateOpenCodeMainConfig,
   writeConfig,
   writeLiteConfig
-} from "./chunk-2TLT6WWY.js";
+} from "./chunk-GIUU6FNE.js";
 
 // src/cli/codex-paths.ts
 import { homedir } from "os";
@@ -120,62 +121,6 @@ function renderConfiguredRolePrompt({
 }
 
 // src/harness/core/memory-governance.ts
-function roleRules(role) {
-  const sharedRules = [
-    "thoth-mem remains an external provider; its installed provider guidance is authoritative for memory operations and thoth-agents does not prescribe the mechanism.",
-    "Provider-dependent use requires parent-scoped authorization with the stable root session identity or explicit unavailable state and project supplied by dispatch.",
-    "The MEMORY authorization is none, recall, or observe: none forbids provider work, recall permits bounded reads, and observe additionally permits one bounded durable observation under the delegated scope.",
-    "Only authorized context may be used, and the delegate must report missing, stale, contradictory, or insufficient context instead of guessing.",
-    "Memory authorization never changes workspace permissions or grants control of root lifecycle and real-user-intent ownership.",
-    "A handoff must keep accepted scope, decisions, permissions, and artifacts plus bounded memory context available to the authorized delegate.",
-    "Completion continuity is a provider-confirmed semantic summary outcome owned by the root.",
-    "Missing capability evidence is reported as degraded or unsupported and never as successful persistence or recovery.",
-    "openspec/ is the canonical SDD store; do not mirror spec.md, plan.md, tasks.md, verification reports, or archive reports into provider memory.",
-    "Do not invent a consumer fallback or silently change the selected persistence mode."
-  ];
-  if (role.name === "orchestrator") {
-    return [
-      ...sharedRules,
-      "The root coordinator owns authorization, root lifecycle, real-user-intent handling, and semantic completion outcomes.",
-      "Dispatch task and authorization context without embedding secrets, raw transcripts, or irrelevant context."
-    ];
-  }
-  if (role.mode === "read-only") {
-    return [
-      ...sharedRules,
-      "For a read-only workspace role, observe may authorize a durable provider observation but does not authorize workspace mutation.",
-      "Root lifecycle ownership never transfers to this delegate."
-    ];
-  }
-  return [
-    ...sharedRules,
-    "For a write-capable workspace role, provider observations still require observe authorization and the delegated parent scope.",
-    "Root lifecycle ownership never transfers to this delegate."
-  ];
-}
-function getRoleMemoryGovernance(role) {
-  return {
-    role: role.name,
-    workspaceMode: role.mode,
-    requiresParentContext: role.name !== "orchestrator",
-    availableAuthorizations: ["none", "recall", "observe"],
-    ownsRootLifecycle: role.name === "orchestrator",
-    rules: roleRules(role)
-  };
-}
-function renderMemoryGovernanceInstructions(role, dialect) {
-  const governance = getRoleMemoryGovernance(role);
-  const harnessRules = dialect ? [
-    `- Harness wording: use ${dialect.renderRoleInvocation("orchestrator")} as the memory owner and \`${dialect.tools.userQuestionTool}\` for blocking memory-context questions.`,
-    `- Progress ownership remains with the coordinator; report memory-governance verification for tracking in ${dialect.tools.progressTool}.`
-  ] : [];
-  return [
-    "External thoth-mem provider memory governance:",
-    ...governance.rules.map((rule) => `- ${rule}`),
-    ...harnessRules,
-    `- Runtime enforcement: ${role.name === "orchestrator" ? "root-owned outcomes" : "instruction-level unless the target harness validates per-agent memory controls"}.`
-  ].join("\n");
-}
 function memoryGovernanceDiagnostics(input) {
   const diagnostics = [];
   if (input.permissionControls !== "supported") {
@@ -448,12 +393,13 @@ var CODEX_SURFACES = [
     target: "permission-control",
     status: "unsupported",
     fields: [
-      "named installed-role selection",
+      "conditional agent_type selection",
+      "role-prefixed fallback",
       "per-role permission enforcement",
       "per-agent tool allow/deny equivalent to OpenCode permissions"
     ],
     diagnosticCode: "codex.permission.memory.enforcement_gap",
-    summary: "Named installed-role selection and per-role permission enforcement are instruction-only because collaboration.spawn_agent has no role selector; OpenCode-style per-agent MCP/tool deny maps are not validated.",
+    summary: "Static packages cannot guarantee active-runtime named-role selection: use collaboration.spawn_agent agent_type when exposed, otherwise the bounded role-prefixed fallback is instruction-only; per-role permission enforcement and OpenCode-style MCP/tool deny maps are not validated.",
     evidence: "Codex approvals/security docs cover sandbox and approval policies, not exact OpenCode per-agent permission maps.",
     fallback: "instruction-only"
   },
@@ -1109,7 +1055,7 @@ function codexRuntimeGuidance() {
     "- The ambient Codex session is the adaptive root; no orchestrator child TOML is generated.",
     "- Delegate with `collaboration.spawn_agent` only when the root determines that specialization, context isolation, review, or independent parallel work creates a net gain.",
     "- Collaboration tools are direct tools and must not be called from inside `functions.exec`.",
-    "- Use a role-prefixed `task_name` and a self-contained English `message` with scope, anchors, constraints, verification, and the compact return contract. The current collaboration surface has no hard custom-role selector, so role selection remains instruction-level.",
+    "- When the active `collaboration.spawn_agent` schema exposes `agent_type`, set it to the selected canonical role. When it does not, use a role-prefixed `task_name` plus a self-contained bounded envelope; that fallback is instruction-only.",
     "- Keep maximum depth 1: children do not delegate. Use one writer per mutable surface and parallelize only independent work.",
     "- A `collaboration.wait_agent` timeout is nonterminal; inspect `collaboration.list_agents` for the same task before rerouting or interrupting it.",
     "- Use `request_user_input` only for blocking material choices and always omit `autoResolutionMs` entirely.",
@@ -1121,15 +1067,8 @@ function codexRuntimeGuidance() {
 function codexRoleInstructions(role) {
   return [
     "<role-operational-contract>",
-    `- Role: ${role.name}`,
-    `- Mode: ${role.mode}`,
-    `- Scope: ${role.scope}`,
-    `- Responsibility: ${role.responsibility}`,
-    "- Use request_user_input for local blocking decisions.",
     "- Permissions, memory governance, runtime hooks, and provider-per-agent controls are instruction-level unless the active Codex runtime documents stronger enforcement.",
     `- ${role.name} runs as a Codex custom-agent TOML entry; the orchestrator remains the ambient Codex root session, not a generated role TOML.`,
-    ...role.toolGovernance.map((rule) => `- ${rule}`),
-    ...role.verification.map((rule) => `- ${rule}`),
     "</role-operational-contract>"
   ].join("\n");
 }
@@ -1142,8 +1081,7 @@ function roleInstructions(role, config) {
       config,
       model
     }),
-    codexRoleInstructions(role),
-    renderMemoryGovernanceInstructions(role, CODEX_PROMPT_DIALECT)
+    codexRoleInstructions(role)
   ].join("\n\n");
 }
 function renderCodexRootInstructions(config) {
@@ -1189,7 +1127,7 @@ function renderAgentArtifacts({ config }) {
       surfaceId: "project-agent-toml",
       values: {
         name: role.name,
-        description: role.responsibility,
+        description: renderAgentRoutingDescription(role),
         developer_instructions: roleInstructions(role, config),
         ...model ? { model } : {},
         ...effort ? { model_reasoning_effort: effort } : {},
@@ -2005,6 +1943,15 @@ var CLAUDE_CODE_SUBAGENT_DEFAULT_MODELS = {
   quick: "haiku",
   deep: "sonnet"
 };
+var CLAUDE_CODE_SUBAGENT_DEFAULT_EFFORTS = {
+  explorer: "low",
+  quick: "low",
+  designer: "medium",
+  deep: "medium",
+  librarian: "high",
+  oracle: "high"
+};
+var CLAUDE_CODE_EFFORTS = /* @__PURE__ */ new Set(["low", "medium", "high", "max"]);
 function isClaudeCodeSubagentName(name) {
   return name in CLAUDE_CODE_SUBAGENT_DEFAULT_MODELS;
 }
@@ -2014,20 +1961,18 @@ function getClaudeCodeAgentModel(role, config) {
   if (override && isClaudeCodeModel(override)) return override;
   return CLAUDE_CODE_SUBAGENT_DEFAULT_MODELS[role.name];
 }
+function getClaudeCodeAgentEffort(role, config) {
+  if (!isClaudeCodeSubagentName(role.name)) return void 0;
+  const configured = config?.agents?.[role.name]?.variant;
+  return configured && CLAUDE_CODE_EFFORTS.has(configured) ? configured : CLAUDE_CODE_SUBAGENT_DEFAULT_EFFORTS[role.name];
+}
 function claudeCodeRoleInstructions(role) {
   return [
     "<role-operational-contract>",
-    `- Role: ${role.name}`,
-    `- Mode: ${role.mode}`,
-    `- Scope: ${role.scope}`,
-    `- Responsibility: ${role.responsibility}`,
-    "- Use AskUserQuestion for local blocking decisions.",
     `- ${role.name} runs as an auto-discovered Claude Code plugin subagent invoked via Agent(subagent_type: ${claudeCodeSubagentType(role.name)}); plugin subagents are namespaced with the plugin name. The orchestrator is the main Claude Code session.`,
     ...role.mode === "read-only" ? [
       "- Write and Edit are denied in frontmatter while all other inherited tools, including MCP tools, remain available."
     ] : [],
-    ...role.toolGovernance.map((rule) => `- ${rule}`),
-    ...role.verification.map((rule) => `- ${rule}`),
     "</role-operational-contract>"
   ].join("\n");
 }
@@ -2040,8 +1985,7 @@ function roleInstructions2(role, config) {
       config,
       model
     }),
-    claudeCodeRoleInstructions(role),
-    renderMemoryGovernanceInstructions(role, CLAUDE_CODE_PROMPT_DIALECT)
+    claudeCodeRoleInstructions(role)
   ].join("\n\n");
 }
 function renderClaudeCodeRootInstructions(config) {
@@ -2111,8 +2055,9 @@ function renderSubagentArtifacts(config) {
   )) {
     const content = renderClaudeCodeSubagent({
       name: role.name,
-      description: role.responsibility,
+      description: renderAgentRoutingDescription(role),
       model: getClaudeCodeAgentModel(role, config),
+      effort: getClaudeCodeAgentEffort(role, config),
       ...role.mode === "read-only" ? { disallowedTools: "Write, Edit" } : {},
       instructions: roleInstructions2(role, config)
     });
@@ -6714,7 +6659,7 @@ var CODEX_DOCUMENTED_EFFORTS2 = /* @__PURE__ */ new Set([
   "max",
   "ultra"
 ]);
-var CLAUDE_CODE_EFFORTS = ["low", "medium", "high", "xhigh", "max"];
+var CLAUDE_CODE_EFFORTS2 = ["low", "medium", "high", "xhigh", "max"];
 function parseOpenCodeModels(output) {
   const seen = /* @__PURE__ */ new Set();
   const options = [];
@@ -6747,7 +6692,7 @@ function writableEfforts(harness, option) {
   }
   if (harness === "claude") {
     return option.efforts.filter(
-      (effort) => CLAUDE_CODE_EFFORTS.includes(effort)
+      (effort) => CLAUDE_CODE_EFFORTS2.includes(effort)
     );
   }
   return option.efforts.filter(
@@ -6798,7 +6743,7 @@ var CLAUDE_CODE_MODEL_OPTIONS = [
   }
 ].map((option) => ({
   ...option,
-  efforts: option.id === "inherit" ? [] : [...CLAUDE_CODE_EFFORTS],
+  efforts: option.id === "inherit" ? [] : [...CLAUDE_CODE_EFFORTS2],
   source: "manual"
 }));
 async function getModelOptions(harness) {

package/dist/cli/index.js

@@ -4,7 +4,7 @@ import {
   getOpenCodeVersion,
   isOpenCodeInstalled,
   opencodeAdapter
-} from "../chunk-MY2GIOOH.js";
+} from "../chunk-CB3EBA7H.js";
 import {
   CODEX_ROLE_NAMES,
   REQUIRED_SKILLS,
@@ -47,7 +47,7 @@ import {
   listOperationHarnesses,
   normalizeEffortSelection,
   syncOpenCodeOwnedSkills
-} from "../chunk-XEEYNMPC.js";
+} from "../chunk-ZEAAWBF2.js";
 import {
   ALL_AGENT_NAMES,
   detectCurrentConfig,
@@ -58,7 +58,7 @@ import {
   resolveExecutingPackageVersion,
   updateOpenCodeMainConfig,
   writeLiteConfig
-} from "../chunk-2TLT6WWY.js";
+} from "../chunk-GIUU6FNE.js";
 
 // src/cli/index.ts
 import { pathToFileURL } from "url";

package/dist/cli/tui/index.js

@@ -2,8 +2,8 @@ import {
   defaultTuiOperations,
   effortChoicesForModel,
   listOperationHarnesses
-} from "../../chunk-XEEYNMPC.js";
-import "../../chunk-2TLT6WWY.js";
+} from "../../chunk-ZEAAWBF2.js";
+import "../../chunk-GIUU6FNE.js";
 
 // src/cli/tui/index.tsx
 import { render } from "ink";

package/dist/config/constants.d.ts

@@ -11,11 +11,11 @@ export declare const CONFIRMED_OPENAI_SUBAGENT_PRESET: {
     };
     readonly librarian: {
         readonly model: "gpt-5.6-luna";
-        readonly effort: "xhigh";
+        readonly effort: "high";
     };
     readonly oracle: {
         readonly model: "gpt-5.6-sol";
-        readonly effort: "xhigh";
+        readonly effort: "high";
     };
     readonly designer: {
         readonly model: "gpt-5.6-sol";
@@ -23,7 +23,7 @@ export declare const CONFIRMED_OPENAI_SUBAGENT_PRESET: {
     };
     readonly quick: {
         readonly model: "gpt-5.6-luna";
-        readonly effort: "xhigh";
+        readonly effort: "low";
     };
     readonly deep: {
         readonly model: "gpt-5.6-sol";

package/dist/harness/adapters/claude-code.d.ts

@@ -13,6 +13,14 @@ export declare const CLAUDE_CODE_SUBAGENT_DEFAULT_MODELS: {
     readonly quick: "haiku";
     readonly deep: "sonnet";
 };
+export declare const CLAUDE_CODE_SUBAGENT_DEFAULT_EFFORTS: {
+    readonly explorer: "low";
+    readonly quick: "low";
+    readonly designer: "medium";
+    readonly deep: "medium";
+    readonly librarian: "high";
+    readonly oracle: "high";
+};
 /**
  * The orchestrator system prompt body. This is the system prompt of the
  * `orchestrator` plugin agent, which the plugin `settings.json` activates as the

package/dist/harness/adapters/codex-surfaces.d.ts

@@ -170,9 +170,9 @@ export declare const CODEX_SURFACES: readonly [{
     readonly id: "per-agent-runtime-permissions";
     readonly target: "permission-control";
     readonly status: "unsupported";
-    readonly fields: ["named installed-role selection", "per-role permission enforcement", "per-agent tool allow/deny equivalent to OpenCode permissions"];
+    readonly fields: ["conditional agent_type selection", "role-prefixed fallback", "per-role permission enforcement", "per-agent tool allow/deny equivalent to OpenCode permissions"];
     readonly diagnosticCode: "codex.permission.memory.enforcement_gap";
-    readonly summary: "Named installed-role selection and per-role permission enforcement are instruction-only because collaboration.spawn_agent has no role selector; OpenCode-style per-agent MCP/tool deny maps are not validated.";
+    readonly summary: "Static packages cannot guarantee active-runtime named-role selection: use collaboration.spawn_agent agent_type when exposed, otherwise the bounded role-prefixed fallback is instruction-only; per-role permission enforcement and OpenCode-style MCP/tool deny maps are not validated.";
     readonly evidence: "Codex approvals/security docs cover sandbox and approval policies, not exact OpenCode per-agent permission maps.";
     readonly fallback: "instruction-only";
 }, {

package/dist/harness/core/agent-pack.d.ts

@@ -8,6 +8,9 @@ export interface AgentRoleContract {
     canMutateWorkspace: boolean;
     scope: string;
     responsibility: string;
+    useWhen: string[];
+    doNotUseWhen: string[];
+    escalateWhen: string[];
     writeScope?: string[];
     toolGovernance: string[];
     verification: string[];
@@ -15,8 +18,18 @@ export interface AgentRoleContract {
 export interface OrchestrationPolicy {
     maxDelegationDepth: number;
     singleWriter: boolean;
+    implementationOwnership: ImplementationOwnershipPolicy;
     rules: string[];
 }
+export type ImplementationOwner = 'orchestrator' | 'designer' | 'quick' | 'deep';
+export interface ImplementationOwnershipPolicy {
+    eligibleOwners: ImplementationOwner[];
+    routeIndependent: boolean;
+    delegationBenefits: string[];
+    rootContinuityBenefits: string[];
+    userDirection: string;
+    insufficientSignals: string[];
+}
 export interface AgentPackContract {
     roles: AgentRoleContract[];
     orchestrationPolicy: OrchestrationPolicy;
@@ -29,9 +42,12 @@ export declare const AGENT_ROLES: readonly [{
     readonly mode: "adaptive-root";
     readonly dispatch: "root-coordinator";
     readonly canMutateWorkspace: true;
-    readonly scope: "requirements, SDD coordination, routing, bounded direct work, decisions, and synthesis";
-    readonly responsibility: "Keep the task coherent, own sequential specification, planning, task, convergence, and archive coordination, act directly when work is clear and bounded, and delegate only for net gain.";
-    readonly toolGovernance: ["may inspect and edit bounded direct work, but every verification is delegated to oracle", "loads the matching thoth-sdd phase contract on demand instead of carrying every phase protocol in its prompt", "owns governed coordination writes under openspec/ and uses append-only tasks.md updates during convergence", "delegates independent or specialist work only when it produces a net gain", "keeps requirements, decisions, and final synthesis in the root thread"];
+    readonly scope: "requirements, SDD coordination, routing, bounded implementation, decisions, and synthesis";
+    readonly responsibility: "Keep requirements, decisions, sequential SDD coordination, and final synthesis in the root thread; evaluate implementation ownership independently in every route and implement directly or delegate according to explicit user direction and demonstrated net gain.";
+    readonly useWhen: ["Coordinate requirements, governed artifacts, routing, and synthesis.", "Implement an accepted mutable surface in any route when accumulated context and continuity outweigh delegation overhead."];
+    readonly doNotUseWhen: ["Not for independent plan review or final verification."];
+    readonly escalateWhen: ["Delegate implementation when specialization, context isolation, or independent bounded work creates a demonstrated net gain; then select designer, quick, or deep by task shape."];
+    readonly toolGovernance: ["may inspect and edit the accepted bounded implementation surface in every route, but every verification is delegated to oracle", "loads the matching thoth-sdd phase contract on demand instead of carrying every phase protocol in its prompt", "owns governed coordination writes under openspec/ and uses append-only tasks.md updates during convergence", "delegates independent or specialist work only when it produces a net gain", "keeps requirements, decisions, and final synthesis in the root thread"];
     readonly verification: ["delegates selected plan-review and every verify phase to oracle; plan review stays optional and final verification stays mandatory", "consolidates summarized evidence returned by child agents"];
 }, {
     readonly name: "explorer";
@@ -40,6 +56,9 @@ export declare const AGENT_ROLES: readonly [{
     readonly canMutateWorkspace: false;
     readonly scope: "local repository discovery";
     readonly responsibility: "Resolve broad or uncertain repository questions and return distilled evidence.";
+    readonly useWhen: ["Repository ownership or behavior is broad or uncertain."];
+    readonly doNotUseWhen: ["Not for implementation, edits, or known narrow questions."];
+    readonly escalateWhen: ["Send external evidence to librarian and mutation scope to root."];
     readonly toolGovernance: ["uses read, search, and code-navigation tools only", "does not mutate files or delegate further"];
     readonly verification: ["reports inspected paths, confidence, and remaining gaps"];
 }, {
@@ -49,6 +68,9 @@ export declare const AGENT_ROLES: readonly [{
     readonly canMutateWorkspace: false;
     readonly scope: "authoritative external research with local confirmation when needed";
     readonly responsibility: "Gather current authoritative evidence and separate documented facts from inference.";
+    readonly useWhen: ["Current authoritative external evidence is required."];
+    readonly doNotUseWhen: ["Not for implementation, edits, or purely local discovery."];
+    readonly escalateWhen: ["Report contradictory or insufficient sources to root."];
     readonly toolGovernance: ["uses research and read-only local tools", "does not mutate files or delegate further"];
     readonly verification: ["provides direct sources for substantive external claims"];
 }, {
@@ -58,6 +80,9 @@ export declare const AGENT_ROLES: readonly [{
     readonly canMutateWorkspace: false;
     readonly scope: "diagnosis, architecture, optional plan review, and independent verification";
     readonly responsibility: "Independently review plans when the user requests it and perform every implementation verification, exposing correctness risks and judging whether results satisfy their contracts.";
+    readonly useWhen: ["Selected plan review, diagnosis, or final verification needs independent judgment."];
+    readonly doNotUseWhen: ["Not for implementation, mutation, persistence, or self-review."];
+    readonly escalateWhen: ["Return blockers and remediation anchors to root."];
     readonly toolGovernance: ["performs read-only analysis and independent review and is never the implementer of the work it judges", "does not implement, persist artifacts, or delegate further"];
     readonly verification: ["separates observations, risks, and recommendations"];
 }, {
@@ -67,6 +92,9 @@ export declare const AGENT_ROLES: readonly [{
     readonly canMutateWorkspace: true;
     readonly scope: "UI/UX decisions, implementation, and visual verification";
     readonly responsibility: "Own user-facing implementation choices and visual quality for UI work.";
+    readonly useWhen: ["User-facing UI/UX, interaction, accessibility, or visual quality is material."];
+    readonly doNotUseWhen: ["Not for backend-only, non-visual, or correctness-heavy cross-cutting work."];
+    readonly escalateWhen: ["Escalate coupled contracts, migrations, or high risk to deep."];
     readonly toolGovernance: ["may edit focused UI/UX files", "owns screenshots and visual QA", "does not delegate further"];
     readonly verification: ["includes visual verification when applicable"];
 }, {
@@ -76,6 +104,9 @@ export declare const AGENT_ROLES: readonly [{
     readonly canMutateWorkspace: true;
     readonly scope: "fast bounded implementation";
     readonly responsibility: "Implement narrow, clear, low-risk changes within an explicitly bounded surface.";
+    readonly useWhen: ["Known narrow mechanical low-risk work has exact targets."];
+    readonly doNotUseWhen: ["Not for coupled contracts, migrations, broad discovery, concurrency, edge cases, or high risk."];
+    readonly escalateWhen: ["Escalate discovery, coupling, edge cases, or higher risk to deep."];
     readonly toolGovernance: ["edits only bounded targets", "escalates when discovery or correctness risk exceeds the assignment", "does not delegate further"];
     readonly verification: ["runs the smallest sufficient focused check"];
 }, {
@@ -85,6 +116,9 @@ export declare const AGENT_ROLES: readonly [{
     readonly canMutateWorkspace: true;
     readonly scope: "correctness-critical implementation and verification";
     readonly responsibility: "Handle multi-file, edge-case-heavy, or high-risk implementation with full local context.";
+    readonly useWhen: ["Implementation is multi-file, edge-case-heavy, migration, concurrency, shared-contract, or high-risk."];
+    readonly doNotUseWhen: ["Not for visual-only work or narrow known low-risk edits."];
+    readonly escalateWhen: ["Return product or architecture choices to root."];
     readonly toolGovernance: ["may edit implementation and tests within the assigned surface", "validates shared behavior against related code and call sites", "does not delegate further"];
     readonly verification: ["reports focused checks and relevant edge-case evidence"];
 }];
@@ -93,4 +127,5 @@ export declare const AGENT_RETURN_CONTRACT: readonly ["conclusion", "evidence",
 export declare const VERIFICATION_PROTOCOL: readonly ["Completion reports identify changed files and verification evidence.", "Behavior changes receive the smallest sufficient automated check or a declared manual check.", "Visual changes receive designer-owned visual QA when applicable."];
 export declare const AGENT_PACK_CONTRACT: AgentPackContract;
 export declare function getAgentRole(name: AgentRoleName): AgentRoleContract;
+export declare function renderAgentRoutingDescription(role: AgentRoleContract): string;
 export declare function getAgentPackContract(): AgentPackContract;

package/dist/harness/core/sdd.d.ts

@@ -24,6 +24,7 @@ export interface SddRoutingDecision {
 }
 export type SddPhaseId = 'explore' | 'specify' | 'clarify' | 'plan' | 'checklist' | 'tasks' | 'plan-review' | 'implement' | 'verify' | 'converge' | 'archive';
 export type SddPhaseActivation = 'required' | 'conditional';
+export type SddPhaseOwner = AgentRoleName | 'adaptive-implementation';
 export interface SddPhaseContract {
     id: SddPhaseId;
     order: number;
@@ -32,7 +33,7 @@ export interface SddPhaseContract {
     activation: SddPhaseActivation;
     prerequisites: SddPhaseId[];
     producesArtifact: boolean;
-    defaultAgentRole: AgentRoleName;
+    defaultAgentRole: SddPhaseOwner;
     eligibleAgentRoles: AgentRoleName[];
     reason: string;
     condition?: string;
@@ -170,9 +171,9 @@ export declare const SDD_PHASES: readonly [{
     readonly activation: "required";
     readonly prerequisites: ["tasks"];
     readonly producesArtifact: false;
-    readonly defaultAgentRole: "orchestrator";
+    readonly defaultAgentRole: "adaptive-implementation";
     readonly eligibleAgentRoles: ["orchestrator", "designer", "quick", "deep"];
-    readonly reason: "Let the adaptive root act directly or route the settled work to one writer.";
+    readonly reason: "Choose root, designer, quick, or deep from task-shaped net gain independently from the SDD route.";
 }, {
     readonly id: "verify";
     readonly order: 8;
@@ -311,7 +312,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "specify";
     readonly objective: "Create a testable, implementation-neutral feature contract in spec.md.";
     readonly requiredInputs: ["User intent and accepted scope", "Explore handoff when the route is full", "Project constitution and existing public contracts when relevant"];
-    readonly instructions: ["Record intent and scope as Why, Impact, and Affected capabilities before prescribing any contract.", "Define prioritized independent stories and map each story to its FR-### and SC-### contracts with Covers metadata.", "Give every normative MUST or SHALL requirement a descriptive title and declare it INTERNAL or as an ADDED, MODIFIED, REMOVED, or RENAMED durable capability delta.", "Classify every success criterion as buildable or outcome; both remain measurable, but only buildable criteria require implementation task coverage.", "Capture assumptions, acceptance scenarios, edge cases, dependencies, and explicit non-goals.", "Use a clarification marker only when no safe default exists and the answer materially changes scope or behavior."];
+    readonly instructions: ["Record intent and scope as Why, Impact, and Affected capabilities before prescribing any contract.", "Define prioritized independent stories and map each story to its FR-### and SC-### contracts with Covers metadata.", "Inspect each affected canonical capability before choosing durable metadata: ADDED is only for genuinely new behavior; MODIFIED and REMOVED preserve exact existing titles; RENAMED names the exact previous title; only ADDED is valid when the capability is absent.", "Give every normative MUST or SHALL requirement a descriptive title and declare it INTERNAL or as an ADDED, MODIFIED, REMOVED, or RENAMED durable capability delta; treat an ADDED warning on an existing capability as a required semantic-overlap review.", "Classify every success criterion as buildable or outcome; both remain measurable, but only buildable criteria require implementation task coverage.", "Capture assumptions, acceptance scenarios, edge cases, dependencies, and explicit non-goals.", "Use a clarification marker only when no safe default exists and the answer materially changes scope or behavior."];
     readonly allowedWrites: ["openspec/changes/<feature>/spec.md"];
     readonly outputSchema: ["spec.md path", "requirements summary", "open clarifications"];
     readonly doneWhen: ["Every accepted FR and SC is testable, materially unambiguous, mapped to a story, and implementation-neutral."];
@@ -370,13 +371,13 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
 }, {
     readonly id: "implement";
     readonly objective: "Execute the accepted task slice with one writer and focused verification.";
-    readonly requiredInputs: ["User request or assigned tasks.md slice", "Accepted spec.md and plan.md when present", "Exact implementation boundaries and verification commands"];
-    readonly instructions: ["The root marks selected artifact-backed tasks [~] before dispatch and marks them [x] only after task-specific evidence is verified.", "Use test-first or TDD execution for behavior changes and preserve one writer per mutable surface.", "Edit only the assigned implementation surface and report justified deviations from the accepted plan.", "When evidence refines the same intent, return it to root so canonical artifacts are updated and only affected downstream artifacts and gates are revalidated.", "Start a new change instead of expanding the active one when the intent changes."];
+    readonly requiredInputs: ["User request or assigned tasks.md slice", "Accepted spec.md and plan.md when present", "Exact implementation boundaries and verification commands", "Implementation owner decision (orchestrator, designer, quick, or deep), exact mutable surface, requirement anchors, and task-shape/net-gain rationale"];
+    readonly instructions: ["The root marks selected artifact-backed tasks [~] before implementation and marks them [x] only after task-specific evidence is verified; Direct or no-artifact work has no task state.", "The SDD route governs artifacts and gates, not implementation ownership; choose root or a specialist from explicit safe user direction and demonstrated task-shaped net gain.", "When root owns implementation, retain the accepted mutable surface with no child dispatch; when a specialist owns implementation, send one bounded dispatch with the exact surface, requirements, and verification.", "Use test-first or TDD execution for behavior changes and preserve one writer per mutable surface.", "Balance specialization, context isolation, independent work, quality, latency, and total cost against sequential dependency, shared mutable state, accumulated context, rediscovery, and coordination overhead.", "Only after deciding delegation creates net gain, select designer for user-facing UI/UX, quick for known narrow low-risk work, and deep for coupled multi-file, edge-case-heavy, migration, concurrency, shared-contract, or high-risk work.", "Record the owner decision, rationale, exact mutable surface, requirement anchors, and verification before implementation or dispatch.", "Proven independent surfaces may use separate writers with non-overlapping files; overlapping or compatibility-coupled surfaces use one deep writer and ordered handoffs.", "Quick and designer must escalate before expanding into deep-risk or compatibility-coupled scope.", "Edit only the assigned implementation surface and report justified deviations from the accepted plan.", "When evidence refines the same intent, return it to root so canonical artifacts are updated and only affected downstream artifacts and gates are revalidated.", "Start a new change instead of expanding the active one when the intent changes."];
     readonly allowedWrites: ["Assigned product and test files", "Root only: task checkbox transitions in openspec/changes/<feature>/tasks.md; child writers must not edit task state."];
     readonly outputSchema: ["status: completed | partial | failed", "per-task outcome", "files changed", "executed verification and results", "deviations, issues, and remaining work"];
     readonly doneWhen: ["The assigned task slice is complete and its focused checks pass with concrete evidence."];
     readonly blockingConditions: ["A task needs scope expansion, a material unresolved decision, or fails repeatedly without a safe bounded recovery."];
-    readonly handoff: ["Pass changed files, per-task evidence, deviations, and verification results to verify."];
+    readonly handoff: ["Pass changed files, per-task evidence, deviations, and verification results to a fresh Oracle for independent verify."];
 }, {
     readonly id: "verify";
     readonly objective: "Judge the implementation against accepted requirements using executed evidence.";
@@ -418,7 +419,7 @@ export declare function getSddPhaseProtocol(id: SddPhaseId): SddPhaseProtocol;
 export declare function getSddPhaseProtocolsForRole(role: AgentRoleName): SddPhaseProtocol[];
 export declare function renderSddPhaseDispatchEnvelope(input: SddPhaseDispatchInput): string;
 export declare function renderSddPhaseDispatchTemplate(): string;
-export declare function getSddPhaseOwner(_route: SddRoute, phaseId: SddPhaseId): AgentRoleName;
+export declare function getSddPhaseOwner(_route: SddRoute, phaseId: SddPhaseId): SddPhaseOwner;
 export declare function getRequiredSddPhaseOrder(route: SddRoute): SddPhaseId[];
 export declare function canEnterSddPhase({ route, completed, target, }: {
     route: SddRoute;

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   renderOpenCodeAgentConfigs,
   spawn,
   spawnSync
-} from "./chunk-MY2GIOOH.js";
+} from "./chunk-CB3EBA7H.js";
 import {
   POLL_INTERVAL_BACKGROUND_MS,
   context7,
@@ -12,7 +12,7 @@ import {
   grep_app,
   loadPluginConfig,
   stripJsonComments
-} from "./chunk-2TLT6WWY.js";
+} from "./chunk-GIUU6FNE.js";
 
 // src/index.ts
 import { fileURLToPath as fileURLToPath3 } from "url";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Adaptive multi-harness orchestration with seven roles, runtime-autonomous Spec Kit-compatible SDD routes, and external provider boundaries.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/plugin/.claude-plugin/.thoth-agents-plugin-assets.json

@@ -9,37 +9,37 @@
     {
       "path": "agents/deep.md",
       "kind": "agent-config",
-      "sha256": "sha256:207ea18daee8dadbf5b201a44c7c9822ec1c1b57b780d0a11ae96147f9d68b35"
+      "sha256": "sha256:f00254f54d1e4226247c3acc1f97d718d200939031ee846cdcad5178f82e2311"
     },
     {
       "path": "agents/designer.md",
       "kind": "agent-config",
-      "sha256": "sha256:b465f25c864e7321c82780fda624652a603a26b8f4f76f089c48557deff82aaa"
+      "sha256": "sha256:506bddde48c14e39ec40fd940ca0993bd468d484f8d461a14c39acf85e878a20"
     },
     {
       "path": "agents/explorer.md",
       "kind": "agent-config",
-      "sha256": "sha256:59b091ec3102a6fe8ae0832b38f7a68031e8fba7b99a920fce61248e591e47d1"
+      "sha256": "sha256:3e622eee39d16224fdb22dd29a06da154e9b21273b1da61590b675f77433e1f3"
     },
     {
       "path": "agents/librarian.md",
       "kind": "agent-config",
-      "sha256": "sha256:accac9b10ff16cafaf389c2ceda65138d2d0222aaa451780ff3c4fdbf0362e75"
+      "sha256": "sha256:0d95292215a64535e8eabca729f9c4778cdaa8542b2467efe5895d9f082d56cb"
     },
     {
       "path": "agents/oracle.md",
       "kind": "agent-config",
-      "sha256": "sha256:b5a2334cc0b52fb95281cb46fb9c2a6fc1df9f87faefe0e47838df270992bfe0"
+      "sha256": "sha256:ce0cabf80941271f9125c4164ddb01250bfff4c96b8432ddebb0b85be725d0a8"
     },
     {
       "path": "agents/orchestrator.md",
       "kind": "agent-config",
-      "sha256": "sha256:b39b6cb996d5dcb38dc66bb83bfd7d6dacbb75d9e1de9097ce2416e64d630b9e"
+      "sha256": "sha256:f66650aa018f4cc0d39468eaf2c0ae35e14f7bbdc5eda99cf6a0dc38761961ee"
     },
     {
       "path": "agents/quick.md",
       "kind": "agent-config",
-      "sha256": "sha256:b22837c17f020d4b8c6faa7fc88de0d1d801909f988d0f90c8571b3d9c5d491c"
+      "sha256": "sha256:f82b9658bd19576c2ec611f28ea37115f316200cc6d7ffee10d873db8707cc80"
     },
     {
       "path": "settings.json",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Adaptive multi-harness agent pack with seven roles and a runtime-autonomous Spec Kit-compatible SDD bundle for Claude Code.",
   "author": {
     "name": "thoth-agents"

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Bundled Spec Kit-compatible SDD skills and MCP configuration; the seven-role global Codex layer requires thoth-agents CLI setup.",
   "skills": "./skills/",
   "mcpServers": "./codex.mcp.json"