@akagilnc/pi-workflow-roles 0.1.2076 → 0.1.2086

package/README.md

@@ -114,7 +114,7 @@ Generated from `src/public-cli/option-definitions.ts`. Prefer `ak-role help <com
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | `--model` | — | `provider/model` | no | no | option | — | Override the effective seat model for this invocation (before or after the command). |
 | `--thinking` | — | `level` | no | no | option | — | Override thinking level: off\|minimal\|low\|medium\|high\|xhigh\|max. |
-| `--engine` | — | `name` | no | no | option | — | Optional Judge labor engine for this invocation (name must exist in packaged engine materials; judge-only). |
+| `--engine` | — | `name` | no | no | option | — | Optional Judge labor engine for this invocation (owner pool-directive name; packaged notes attached when present; judge-only). |
 | `--help` | `-h` | — | no | no | option | — | Show public CLI help and exit. |
 
 ### `judge`

package/README.zh-CN.md

@@ -143,7 +143,7 @@ Codex fast 档：开启：`echo "fast_mode = on" > ~/.pi-codex-fast`；关闭：
 | --- | --- | --- | --- | --- | --- | --- | --- |
 | `--model` | — | `provider/model` | 否 | 否 | option | — | 覆盖本调用有效席位模型（可置于子命令前或后）。 |
 | `--thinking` | — | `level` | 否 | 否 | option | — | 覆盖 thinking 档位：off\|minimal\|low\|medium\|high\|xhigh\|max。 |
-| `--engine` | — | `name` | 否 | 否 | option | — | 本调用可选 Judge 劳动引擎（名字须存在于包内引擎调法材料；仅 Judge）。 |
+| `--engine` | — | `name` | 否 | 否 | option | — | 本调用可选 Judge 劳动引擎（池令名字；有包内调法笔记则附卷；仅 Judge）。 |
 | `--help` | `-h` | — | 否 | 否 | option | — | 显示公开 CLI 帮助并退出。 |
 
 ### `judge`

package/dist/public-cli/main.js

@@ -23,32 +23,19 @@ function isEngineNameSyntax(name) {
   if (name.length === 0 || name.trim() !== name) return false;
   if (name === "." || name === "..") return false;
   if (name.includes("/") || name.includes("\\") || name.includes("\0")) return false;
-  if (name.includes("..")) return false;
   return true;
 }
 function resolveEngineMaterialDirectory(packageRoot2) {
   return join2(packageRoot2, ENGINE_MATERIAL_RELATIVE_ROOT);
 }
-function listEngineMaterialNames(packageRoot2) {
-  const dir = resolveEngineMaterialDirectory(packageRoot2);
-  if (!existsSync2(dir)) return Object.freeze([]);
-  const names = readdirSync(dir).filter((entry) => entry.endsWith(".md")).map((entry) => entry.slice(0, -".md".length)).filter((stem) => isEngineNameSyntax(stem)).sort();
-  return Object.freeze([...names]);
-}
 function resolveEngineMaterialPath(packageRoot2, name) {
-  const legal = assertLegalEngineName(packageRoot2, name);
+  const legal = assertLegalEngineName(name);
   return join2(resolveEngineMaterialDirectory(packageRoot2), `${legal}.md`);
 }
-function assertLegalEngineName(packageRoot2, name) {
+function assertLegalEngineName(name) {
   if (!isEngineNameSyntax(name)) {
     throw new Error(`illegal engine name: ${name}`);
   }
-  const legal = listEngineMaterialNames(packageRoot2);
-  if (!legal.includes(name)) {
-    throw new Error(
-      `unknown engine: ${name} (known: ${legal.length === 0 ? "(none)" : legal.join(", ")})`
-    );
-  }
   return name;
 }
 function engineSessionMaterialFromOptions(options) {
@@ -56,11 +43,12 @@ function engineSessionMaterialFromOptions(options) {
   if (options.packageRoot === void 0 || options.packageRoot.trim() === "") {
     throw new Error("packageRoot is required when engine is configured");
   }
-  const name = assertLegalEngineName(options.packageRoot, options.engine);
-  return Object.freeze({
-    name,
-    materialPath: resolveEngineMaterialPath(options.packageRoot, name)
-  });
+  const name = assertLegalEngineName(options.engine);
+  const materialPath = resolveEngineMaterialPath(options.packageRoot, name);
+  if (existsSync2(materialPath)) {
+    return Object.freeze({ name, materialPath });
+  }
+  return Object.freeze({ name });
 }
 function appendEngineSessionMaterial(lines, engineMaterial) {
   if (engineMaterial === void 0) {
@@ -68,9 +56,13 @@ function appendEngineSessionMaterial(lines, engineMaterial) {
   }
   const out = [...lines];
   out.push("");
-  out.push("Engine method material (read these bytes and follow them):");
-  out.push(`- engine: ${engineMaterial.name}`);
-  out.push(`- ${engineMaterial.materialPath}`);
+  if (engineMaterial.materialPath !== void 0) {
+    out.push("Engine method material (read these bytes and follow them):");
+    out.push(`- engine: ${engineMaterial.name}`);
+    out.push(`- ${engineMaterial.materialPath}`);
+  } else {
+    out.push(`- engine: ${engineMaterial.name}`);
+  }
   return out;
 }
 var ENGINE_MATERIAL_RELATIVE_ROOT;
@@ -14476,7 +14468,7 @@ function setPersistentSeatEngine(config, seat, engine) {
 function seatModelOnly(seat) {
   return seat.thinking === void 0 ? { provider: seat.provider, model: seat.model } : { provider: seat.provider, model: seat.model, thinking: seat.thinking };
 }
-function validatePublicCliConfigEngines(config, packageRoot2) {
+function validatePublicCliConfigEngines(config, _packageRoot) {
   for (const seat of Object.keys(config.seats)) {
     const row = config.seats[seat];
     if (row?.engine === void 0) continue;
@@ -14486,10 +14478,10 @@ function validatePublicCliConfigEngines(config, packageRoot2) {
       );
     }
     try {
-      assertLegalEngineName(packageRoot2, row.engine);
+      assertLegalEngineName(row.engine);
     } catch (error) {
       throw new Error(
-        `config seat ${seat} engine is unknown: ${row.engine}`,
+        `config seat ${seat} engine is illegal: ${row.engine}`,
         { cause: error }
       );
     }
@@ -15925,8 +15917,8 @@ var init_option_definitions = __esm({
         repeatable: false,
         form: "option",
         description: {
-          en: "Optional Judge labor engine for this invocation (name must exist in packaged engine materials; judge-only).",
-          zh: "\u672C\u8C03\u7528\u53EF\u9009 Judge \u52B3\u52A8\u5F15\u64CE\uFF08\u540D\u5B57\u987B\u5B58\u5728\u4E8E\u5305\u5185\u5F15\u64CE\u8C03\u6CD5\u6750\u6599\uFF1B\u4EC5 Judge\uFF09\u3002"
+          en: "Optional Judge labor engine for this invocation (owner pool-directive name; packaged notes attached when present; judge-only).",
+          zh: "\u672C\u8C03\u7528\u53EF\u9009 Judge \u52B3\u52A8\u5F15\u64CE\uFF08\u6C60\u4EE4\u540D\u5B57\uFF1B\u6709\u5305\u5185\u8C03\u6CD5\u7B14\u8BB0\u5219\u9644\u5377\uFF1B\u4EC5 Judge\uFF09\u3002"
         }
       },
       {
@@ -20720,13 +20712,11 @@ function auditIncompleteFromCandidate(candidate) {
 }
 function boundRetainedAuditResponse(entries, callIndex, resultIndex, auditToolName) {
   const matches = [];
-  let retainedResponseCount = 0;
   for (let index = callIndex + 1; index < resultIndex; index += 1) {
     const entry = entries[index];
     if (entry?.type !== "custom" || entry.customType !== COMPLIANCE_RESPONSE_ENTRY_TYPE) {
       continue;
     }
-    retainedResponseCount += 1;
     if (!isRecord5(entry.data) || !isRecord5(entry.data.response)) continue;
     const response = entry.data.response;
     if (!Array.isArray(response.content)) continue;
@@ -20736,7 +20726,7 @@ function boundRetainedAuditResponse(entries, callIndex, resultIndex, auditToolNa
     if (calls.length !== 1 || calls[0]?.name !== auditToolName) continue;
     matches.push({ candidate: calls[0]?.arguments });
   }
-  return retainedResponseCount === 1 && matches.length === 1 ? matches[0] : void 0;
+  return matches.length === 1 ? matches[0] : void 0;
 }
 function extractComplianceAuditIncompleteRoleOutcome(entries, role, outputToolName) {
   if (outputToolName !== outputToolNameForAuditedRole(role)) return void 0;
@@ -26954,9 +26944,9 @@ function invocationFromParsed(parsed) {
     ...parsed.engine === void 0 ? {} : { engine: parsed.engine }
   };
 }
-function requireLegalEngineName(packageRoot2, name) {
+function requireLegalEngineName(name) {
   try {
-    return assertLegalEngineName(packageRoot2, name);
+    return assertLegalEngineName(name);
   } catch (error) {
     throw new CliUsageError(
       error instanceof Error ? error.message : String(error),
@@ -27153,7 +27143,7 @@ async function runConfigCommand(args, home, packageRoot2, io) {
         `engine axis is judge-only; refused seat ${seat}`
       );
     }
-    requireLegalEngineName(packageRoot2, name);
+    requireLegalEngineName(name);
     let config = await loadAndValidateConfig(home, packageRoot2);
     try {
       config = setPersistentSeatEngine(config, seat, name);
@@ -27204,7 +27194,7 @@ async function runAkRole(argv, env) {
     env = { ...env, packageRoot: await realpath5(env.packageRoot) };
     const parsed = parseArgv(argv);
     if (parsed.engine !== void 0) {
-      requireLegalEngineName(env.packageRoot, parsed.engine);
+      requireLegalEngineName(parsed.engine);
       if (!parsed.help && parsed.command !== void 0 && parsed.command !== "help" && parsed.command !== "judge") {
         throw new CliUsageError(
           `engine axis is judge-only; refused command ${parsed.command}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.2076",
+  "version": "0.1.2086",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/resources/engines/opus.md

@@ -0,0 +1,31 @@
+# opus engine method material
+
+This file is packaged method material for the optional `opus` labor engine
+(Claude Code CLI on the host). When a role run selects this engine, read these
+bytes and follow the local CLI's actual interface for the labor detour. Return
+the labor result to the same role session so typed submission stays on the
+existing in-session path.
+
+Material is data for the model, not a code contract. Do not invent package flags.
+
+## Invocation examples (local Claude Code CLI)
+
+The machine entrypoint is `claude`. Run from the role project root. Non-interactive
+print mode (`-p` / `--print`) is verified available on this host:
+
+```bash
+claude -p "YOUR_LABOR_PROMPT"
+```
+
+Pin the Opus model explicitly (`--model opus` verified accepted on this host):
+
+```bash
+claude -p --model opus "YOUR_LABOR_PROMPT"
+```
+
+Prefer `claude --help` on the host over any remembered flag set. Do not wrap this
+engine behind `ak-role` flags.
+
+When the package detour tool is available, start exactly one subprocess through
+it with argv assembled from this material and the local CLI; return the stdout
+labor content to the same session for the existing typed submission path.

package/src/engine-detour-tool.ts

@@ -24,7 +24,7 @@ const engineDetourArgsSchema = Type.Object(
     argv: Type.Array(Type.String({ minLength: 1 }), {
       minItems: 1,
       description:
-        "Executable argv for one engine subprocess. First element is the command (PATH lookup); remaining elements are arguments. Assemble from engine method material — do not invent package flags.",
+        "Executable argv for one engine subprocess. First element is the command (PATH lookup); remaining elements are arguments. Build argv from the host CLI actual interface for the configured engine name; when optional packaged notes are present in the session prompt, follow those bytes. Do not invent package flags.",
     }),
   },
   { additionalProperties: false },
@@ -70,11 +70,11 @@ export function registerEngineDetourTool(
     name: ENGINE_DETOUR_TOOL_NAME,
     label: "Engine Detour",
     description:
-      `Run one labor-engine subprocess (engine=${engineName}) and return its stdout to this session. Call at most once per activation. Assemble argv from the engine method material path delivered in the session prompt.`,
+      `Run one labor-engine subprocess (engine=${engineName}) and return its stdout to this session. Call at most once per activation. Build argv from the host CLI actual interface for this engine name; when optional packaged notes are present in the session prompt, follow those bytes too.`,
     promptSnippet: "Run the configured labor engine once and return its stdout",
     promptGuidelines: [
-      `Use ${ENGINE_DETOUR_TOOL_NAME} exactly once when engine method material is present.`,
-      "Pass argv assembled from the material and the host CLI — first element is the executable name on PATH.",
+      `Use ${ENGINE_DETOUR_TOOL_NAME} exactly once for the configured engine (${engineName}). Optional packaged notes are guidance when present; a bare engine name alone is also a valid call path.`,
+      "Pass argv for the host CLI of this engine name — first element is the executable name on PATH. Follow optional packaged notes when delivered; otherwise act from the engine name and the host CLI actual interface. Do not invent package flags.",
       "On success, use the returned stdout as labor content for the existing typed submission tool.",
     ],
     parameters: engineDetourArgsSchema,

package/src/package-resources/engine-material.ts

@@ -1,7 +1,8 @@
 /**
- * Packaged engine method-material seam (#356 T1 / ADR 0069).
- * Legal engine names = directory stems under resources/engines/ — no code whitelist.
- * Material body is data for the LLM, not a code contract.
+ * Packaged engine method-material seam (#356 T1 / ADR 0069 / #376).
+ * Engine names are owner pool-directive labels — not a closed material catalog.
+ * Material body is optional data for the LLM, not a code contract.
+ * Only path-safety syntax is checked at real I/O seams.
  */
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
@@ -10,16 +11,17 @@ const ENGINE_MATERIAL_RELATIVE_ROOT = "resources/engines" as const;
 
 export type EngineSessionMaterial = Readonly<{
   name: string;
-  materialPath: string;
+  /** Present only when a packaged notes file exists for this name. */
+  materialPath?: string;
 }>;
 
-/** Non-empty, trimmed, no path separators or traversal. */
+/** Non-empty, trimmed; reject only real path hazards at the I/O seam. */
 export function isEngineNameSyntax(name: string): boolean {
   if (typeof name !== "string") return false;
   if (name.length === 0 || name.trim() !== name) return false;
+  // Exact "." / ".." are directory aliases; consecutive dots inside a label are not.
   if (name === "." || name === "..") return false;
   if (name.includes("/") || name.includes("\\") || name.includes("\0")) return false;
-  if (name.includes("..")) return false;
   return true;
 }
 
@@ -32,8 +34,8 @@ export function resolveEngineMaterialDirectory(packageRoot: string): string {
 }
 
 /**
- * Enumerate legal engine names from packaged material files.
- * Only `*.md` stems that pass name syntax are legal.
+ * Enumerate packaged engine notes stems (discovery only — not a legal-name gate).
+ * Only `*.md` stems that pass name syntax are listed.
  */
 export function listEngineMaterialNames(packageRoot: string): readonly string[] {
   const dir = resolveEngineMaterialDirectory(packageRoot);
@@ -46,34 +48,35 @@ export function listEngineMaterialNames(packageRoot: string): readonly string[]
   return Object.freeze([...names]);
 }
 
+/**
+ * Build the packaged notes path for a syntax-legal engine name.
+ * Does not require the file to exist (material is optional data).
+ */
 export function resolveEngineMaterialPath(
   packageRoot: string,
   name: string,
 ): string {
-  const legal = assertLegalEngineName(packageRoot, name);
+  const legal = assertLegalEngineName(name);
   return join(resolveEngineMaterialDirectory(packageRoot), `${legal}.md`);
 }
 
 /**
- * Assert `name` is a legal engine material stem under packageRoot.
- * Returns the canonical name on success; throws Error on illegal.
+ * Path-safety syntax gate for engine labels at real I/O seams.
+ * Returns the canonical name on success; throws Error on illegal syntax.
+ * Does not consult any material catalog (ADR 0069 pool-directive axis).
  */
-export function assertLegalEngineName(packageRoot: string, name: string): string {
+export function assertLegalEngineName(name: string): string {
   if (!isEngineNameSyntax(name)) {
     throw new Error(`illegal engine name: ${name}`);
   }
-  const legal = listEngineMaterialNames(packageRoot);
-  if (!legal.includes(name)) {
-    throw new Error(
-      `unknown engine: ${name} (known: ${legal.length === 0 ? "(none)" : legal.join(", ")})`,
-    );
-  }
   return name;
 }
 
 /**
  * Resolve optional engine options into session material coordinates.
  * No engine → undefined (caller keeps default prompt bytes).
+ * Engine with packaged notes → name + absolute material path.
+ * Engine without notes → name only (pass-through; no warning).
  */
 export function engineSessionMaterialFromOptions(options: {
   engine?: string;
@@ -83,17 +86,20 @@ export function engineSessionMaterialFromOptions(options: {
   if (options.packageRoot === undefined || options.packageRoot.trim() === "") {
     throw new Error("packageRoot is required when engine is configured");
   }
-  const name = assertLegalEngineName(options.packageRoot, options.engine);
-  return Object.freeze({
-    name,
-    materialPath: resolveEngineMaterialPath(options.packageRoot, name),
-  });
+  const name = assertLegalEngineName(options.engine);
+  const materialPath = resolveEngineMaterialPath(options.packageRoot, name);
+  if (existsSync(materialPath)) {
+    return Object.freeze({ name, materialPath });
+  }
+  return Object.freeze({ name });
 }
 
 /**
- * Append engine method-material path delivery to session initial material lines.
- * No material → identity copy (byte-stable when joined the same way).
- * Delivers engine name + absolute material path only — never material body.
+ * Append engine method-material delivery to session initial material lines.
+ * No engine → identity copy (byte-stable when joined the same way).
+ * With notes → read-these-bytes header + engine name + absolute material path.
+ * Name only → engine name coordinate only (no read-these-bytes header, no path, no warning).
+ * Never delivers material body.
  */
 export function appendEngineSessionMaterial(
   lines: readonly string[],
@@ -104,8 +110,13 @@ export function appendEngineSessionMaterial(
   }
   const out = [...lines];
   out.push("");
-  out.push("Engine method material (read these bytes and follow them):");
-  out.push(`- engine: ${engineMaterial.name}`);
-  out.push(`- ${engineMaterial.materialPath}`);
+  if (engineMaterial.materialPath !== undefined) {
+    out.push("Engine method material (read these bytes and follow them):");
+    out.push(`- engine: ${engineMaterial.name}`);
+    out.push(`- ${engineMaterial.materialPath}`);
+  } else {
+    // Name-only pass-through: no packaged bytes to read.
+    out.push(`- engine: ${engineMaterial.name}`);
+  }
   return out;
 }

package/src/public-cli/cli.ts

@@ -324,9 +324,9 @@ function invocationFromParsed(parsed: ParsedGlobal): InvocationModelOverride | u
   };
 }
 
-function requireLegalEngineName(packageRoot: string, name: string): string {
+function requireLegalEngineName(name: string): string {
   try {
-    return assertLegalEngineName(packageRoot, name);
+    return assertLegalEngineName(name);
   } catch (error) {
     throw new CliUsageError(
       error instanceof Error ? error.message : String(error),
@@ -546,7 +546,7 @@ async function runConfigCommand(
         `engine axis is judge-only; refused seat ${seat}`,
       );
     }
-    requireLegalEngineName(packageRoot, name);
+    requireLegalEngineName(name);
     let config = await loadAndValidateConfig(home, packageRoot);
     try {
       config = setPersistentSeatEngine(config, seat, name);
@@ -608,7 +608,7 @@ export async function runAkRole(
     // Invocation --engine rejects at the call-request seam (not role submission).
     // #356 MVP: engine axis is Judge-only (not resume / non-Judge seats).
     if (parsed.engine !== undefined) {
-      requireLegalEngineName(env.packageRoot, parsed.engine);
+      requireLegalEngineName(parsed.engine);
       if (
         !parsed.help &&
         parsed.command !== undefined &&

package/src/public-cli/config.ts

@@ -143,7 +143,7 @@ export function setPersistentSeatEngine(
       },
     };
   }
-  // Engine-name legality is owned solely by assertLegalEngineName
+  // Engine-name path-safety syntax is owned solely by assertLegalEngineName
   // (call-request + config-parse seams). Setter is pure seat mutation.
   return {
     seats: {
@@ -161,13 +161,14 @@ export function seatModelOnly(seat: PersistentSeatConfig): SeatModelConfig {
 }
 
 /**
- * Config-parse seam: engine axis is Judge-only; Judge engine names must exist
- * in package materials. Call with packageRoot after load / before dispatch (#356).
- * Legality authority = assertLegalEngineName (no injected duplicate).
+ * Config-parse seam: engine axis is Judge-only; Judge engine names need only
+ * path-safety syntax (no closed material catalog; #376 / ADR 0069).
+ * Call with packageRoot after load / before dispatch (#356).
+ * Syntax authority = assertLegalEngineName (no injected duplicate).
  */
 export function validatePublicCliConfigEngines(
   config: PublicCliConfig,
-  packageRoot: string,
+  _packageRoot: string,
 ): void {
   for (const seat of Object.keys(config.seats) as PublicConfigurableSeat[]) {
     const row = config.seats[seat];
@@ -178,10 +179,10 @@ export function validatePublicCliConfigEngines(
       );
     }
     try {
-      assertLegalEngineName(packageRoot, row.engine);
+      assertLegalEngineName(row.engine);
     } catch (error) {
       throw new Error(
-        `config seat ${seat} engine is unknown: ${row.engine}`,
+        `config seat ${seat} engine is illegal: ${row.engine}`,
         { cause: error },
       );
     }
@@ -314,7 +315,7 @@ function parseSeatModelConfig(value: unknown, seat: string): PersistentSeatConfi
     thinking: raw.thinking as PublicThinkingLevel,
   };
   if (raw.engine !== undefined) {
-    // Shape only: engine must be a string field. Name legality is deferred to
+    // Shape only: engine must be a string field. Path-safety syntax is deferred to
     // validatePublicCliConfigEngines → assertLegalEngineName (single authority).
     if (typeof raw.engine !== "string") {
       throw new Error(`config seat ${seat} engine must be a string`);

package/src/public-cli/option-definitions.ts

@@ -288,8 +288,8 @@ const GLOBAL_OPTIONS = [
     repeatable: false,
     form: "option",
     description: {
-      en: "Optional Judge labor engine for this invocation (name must exist in packaged engine materials; judge-only).",
-      zh: "本调用可选 Judge 劳动引擎（名字须存在于包内引擎调法材料；仅 Judge）。",
+      en: "Optional Judge labor engine for this invocation (owner pool-directive name; packaged notes attached when present; judge-only).",
+      zh: "本调用可选 Judge 劳动引擎（池令名字；有包内调法笔记则附卷；仅 Judge）。",
     },
   },
   {

package/src/public-cli/settlement.ts

@@ -1696,13 +1696,11 @@ function boundRetainedAuditResponse(
   auditToolName: string,
 ): BoundRetainedAuditResponse | undefined {
   const matches: BoundRetainedAuditResponse[] = [];
-  let retainedResponseCount = 0;
   for (let index = callIndex + 1; index < resultIndex; index += 1) {
     const entry = entries[index];
     if (entry?.type !== "custom" || entry.customType !== COMPLIANCE_RESPONSE_ENTRY_TYPE) {
       continue;
     }
-    retainedResponseCount += 1;
     if (!isRecord(entry.data) || !isRecord(entry.data.response)) continue;
     const response = entry.data.response;
     if (!Array.isArray(response.content)) continue;
@@ -1713,7 +1711,9 @@ function boundRetainedAuditResponse(
     if (calls.length !== 1 || calls[0]?.name !== auditToolName) continue;
     matches.push({ candidate: calls[0]?.arguments });
   }
-  return retainedResponseCount === 1 && matches.length === 1 ? matches[0] : undefined;
+  // Unique seat-bound match binds even when multi-turn investigation retained
+  // intermediate non-decision responses in the same call/result interval.
+  return matches.length === 1 ? matches[0] : undefined;
 }
 
 export function extractComplianceAuditIncompleteRoleOutcome(

package/resources/engines/codex.md

@@ -1,32 +0,0 @@
-# codex engine method material
-
-This file is packaged method material for the optional `codex` labor engine.
-When a role run selects this engine, read these bytes and follow the local CLI's
-actual interface for the labor detour. Return the labor result to the same role
-session so typed submission stays on the existing in-session path.
-
-Material is data for the model, not a code contract. Do not invent package flags.
-
-## Invocation examples (local Codex CLI)
-
-Non-interactive labor prompt (working root = role project):
-
-```bash
-codex exec -C "$PROJECT_ROOT" "YOUR_LABOR_PROMPT"
-```
-
-Write the last agent message to a file, then bring that text back into the role
-session:
-
-```bash
-codex exec -C "$PROJECT_ROOT" -o /tmp/codex-labor-last.txt "YOUR_LABOR_PROMPT"
-```
-
-JSON event stream when the host needs machine-readable progress:
-
-```bash
-codex exec --json -C "$PROJECT_ROOT" "YOUR_LABOR_PROMPT"
-```
-
-Prefer the installed `codex` binary's own `--help` / `codex exec --help` over
-any remembered flag set. Do not wrap this engine behind `ak-role` flags.

package/resources/engines/kimi.md

@@ -1,35 +0,0 @@
-# kimi engine method material
-
-This file is packaged method material for the optional `kimi` labor engine.
-When a role run selects this engine, read these bytes and follow the local CLI's
-actual interface for the labor detour. Return the labor result to the same role
-session so typed submission stays on the existing in-session path.
-
-Material is data for the model, not a code contract. Do not invent package flags.
-
-## Invocation examples (local Kimi Code CLI)
-
-One-shot non-interactive prompt from the role project root:
-
-```bash
-kimi --yolo -p "YOUR_LABOR_PROMPT"
-```
-
-Pin a model alias when needed:
-
-```bash
-kimi --yolo -m <model-alias> -p "YOUR_LABOR_PROMPT"
-```
-
-Machine-readable prompt mode:
-
-```bash
-kimi --yolo --output-format text -p "YOUR_LABOR_PROMPT"
-```
-
-Prefer `kimi --help` on the host over any remembered flag set. Do not wrap this
-engine behind `ak-role` flags.
-
-When the package detour tool is available, start exactly one subprocess through
-it with argv assembled from this material and the local CLI; return the stdout
-labor content to the same session for the existing typed submission path.