@akagilnc/pi-workflow-roles 0.1.5037 → 0.1.5066

package/dist/public-cli/post-admission.js

@@ -863,6 +863,7 @@ export function resumeTurnRequestProjectionOptions(admitted, request, env, summo
     return {
         packageRoot: env.packageRoot,
         home: env.home,
+        ...(env.host === undefined ? {} : { host: env.host }),
         agentDir: env.agentDir,
         ...(env.model === undefined ? {} : { model: env.model }),
         ...pickEngineAxis(env),
@@ -884,6 +885,7 @@ export function roleTurnOptions(env, admitted, continuation) {
     return {
         packageRoot: env.packageRoot,
         home: env.home,
+        ...(env.host === undefined ? {} : { host: env.host }),
         agentDir: env.agentDir,
         ...(env.model === undefined ? {} : { model: env.model }),
         ...pickEngineAxis(env),

package/dist/public-cli/registry.js

@@ -13,7 +13,8 @@ const PUBLIC_CLI_SUPPORT_COMMANDS = [
   "config",
   "help",
   "resume",
-  "new"
+  "new",
+  "setup"
 ];
 function seatModelOnly(seat) {
   if (seat?.provider === void 0 || seat.model === void 0) return void 0;

package/dist/public-cli/settlement.js

@@ -28,7 +28,6 @@ import { DOCTOR_CANDIDATE_ENTRY_TYPE } from "../dossier-resolution.js";
 import { REVIEWER_OUTPUT_TOOL_NAME, } from "../package-contracts/reviewer-output.js";
 import { packagedAuditToolName, packagedDurableOfficerEntry, packagedProjectsTargetBindRejection, packagedRoleAcceptedOutputTool, packagedRoleMetadata, packagedSkipsGateOnInfrastructureStage, } from "../packaged-role-registry.js";
 import { SECRETARIAT_COUNTERSIGN_TERMINAL_FACT_KEY, SECRETARIAT_GATE_OFFICER_ENTRY_TYPE, } from "../secretariat-contracts.js";
-import { observePackagedMethodSkillInvocation, resolvePackagedMethodSkillPath, } from "../package-resources/method-skill.js";
 import { classifyPackagedRoleTerminalResult, findLatestDurablePackagedRoleTerminal, hasNavigatorInfrastructureFailureBase, isAcceptedPackagedRoleTerminalResult, isReceiptSettlementBindingClear, NAVIGATOR_INVOCATION_ENTRY, parseInvocationMarkerIdentity, } from "../navigator-invocation-identity.js";
 import { NO_RECEIPT_LIFECYCLE_ENTRY_TYPE, RECEIPT_DELIVERY_TURN_LIMIT, noReceiptLifecycleFacts, parseNoReceiptLifecycleFacts, } from "../receipt-delivery-policy.js";
 import { roleRunArtifactsDirectory } from "../role-run-placement.js";
@@ -1784,8 +1783,8 @@ async function publishAcceptedTerminalArtifacts(admitted, roleOutcome, coordinat
     ];
 }
 /** Publish one accepted seat's report/evidence face from the shared leaf table. */
-export async function publishSeatAcceptedArtifacts(admitted, roleOutcome, coordinates, entries = [], options = {}) {
-    return publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates, entries, options);
+export async function publishSeatAcceptedArtifacts(admitted, roleOutcome, coordinates, entries = []) {
+    return publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates, entries);
 }
 /**
  * Read session entries for lawful settlement. Missing path → undefined (absence).
@@ -1871,9 +1870,9 @@ async function settleSealedAcceptedOrToolResidual(admitted, authority, scope, ro
 /**
  * One settlement for every registered seat. The registry `settlement` leaf
  * picks sealed ledger, sealed-or-residual, or the accepted-tool scan.
- * Seat evidence and the observed-method tail stay on the artifact face.
+ * Seat evidence stays on the artifact face.
  */
-async function settleSeat(admitted, authority, scope, options) {
+async function settleSeat(admitted, authority, scope) {
     const record = packagedRoleMetadata(admitted.role);
     if (record === undefined) {
         throw new Error(`no settlement for ${admitted.role}`);
@@ -1881,7 +1880,7 @@ async function settleSeat(admitted, authority, scope, options) {
     if (record.settlement === "accepted") {
         return trySettleAcceptedSeatTerminalResult(admitted, authority, scope);
     }
-    const publish = (roleOutcome, coordinates, entries) => publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates, entries, options);
+    const publish = (roleOutcome, coordinates, entries) => publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates, entries);
     if (record.settlement === "residual") {
         return settleSealedAcceptedOrToolResidual(admitted, authority, scope, admitted.role, record.residualTool, record.residualScan, publish);
     }
@@ -1894,75 +1893,21 @@ async function settleSeat(admitted, authority, scope, options) {
  * Try to settle any registered seat. Undefined only for genuine absence.
  * Session malformation and publication exceptions keep their typed identity.
  */
-export async function trySettleSeatTerminalResult(admitted, authority, options = {}, scope) {
-    return settleSeat(admitted, authority, scope, options);
+export async function trySettleSeatTerminalResult(admitted, authority, scope) {
+    return settleSeat(admitted, authority, scope);
 }
 /**
  * Settle any registered seat. Throws when no lawful outcome is present.
  * Session-read and publication failures retain their typed identity.
  */
-export async function settleSeatTerminalResult(admitted, authority, options = {}, scope) {
-    const settled = await settleSeat(admitted, authority, scope, options);
+export async function settleSeatTerminalResult(admitted, authority, scope) {
+    const settled = await settleSeat(admitted, authority, scope);
     if (settled === undefined) {
         const label = admitted.role.charAt(0).toUpperCase() + admitted.role.slice(1);
         throw new Error(`${label} Role run completed without a lawful typed terminal result`);
     }
     return settled;
 }
-function sessionMessageText(message) {
-    if (message === undefined)
-        return "";
-    if (typeof message.content === "string")
-        return message.content;
-    if (!Array.isArray(message.content))
-        return "";
-    const parts = [];
-    for (const part of message.content) {
-        if (typeof part === "object" &&
-            part !== null &&
-            !Array.isArray(part) &&
-            part.type === "text" &&
-            typeof part.text === "string") {
-            parts.push(part.text);
-        }
-    }
-    return parts.join("\n");
-}
-/**
- * Locations a loaded packaged method may be observed at.
- * The name is the loaded material; the configured path is the package copy.
- */
-export function observedMethodSkillOptions(packageRoot, material) {
-    return {
-        methodProvenance: material.provenance,
-        methodSkillPath: material.skillPath,
-        methodSkillConfiguredPath: resolvePackagedMethodSkillPath(packageRoot, material.name),
-    };
-}
-/**
- * Observe packaged method Skill expansions from the session.
- * The skill name is the caller's packaged method; home locations never count.
- */
-function extractObservedMethodInvocations(entries, options) {
-    const observed = [];
-    for (const entry of entries) {
-        if (entry?.type !== "message")
-            continue;
-        const message = entry.message;
-        if (message?.role !== "user")
-            continue;
-        const text = sessionMessageText(message);
-        if (text.length === 0)
-            continue;
-        const hit = observePackagedMethodSkillInvocation(text, {
-            name: options.name,
-            allowedLocations: options.allowedLocations,
-        });
-        if (hit !== undefined)
-            observed.push(hit);
-    }
-    return Object.freeze(observed);
-}
 /**
  * #836: cost and the auditor's no-receipt facts ride beside the role's
  * testimony on the current attempt's candidate entry. Absence is omitted,
@@ -2027,30 +1972,7 @@ function doctorReportFacts(face, roleOutcome, entries) {
         ...(facts.auditNoReceipt === undefined ? {} : { auditNoReceipt: facts.auditNoReceipt }),
     };
 }
-function observedMethodTail(face, entries, options) {
-    if (face.method === undefined)
-        return {};
-    if (face.method === "optional") {
-        return options.methodProvenance === undefined
-            ? {}
-            : { methodProvenance: options.methodProvenance };
-    }
-    if (options.methodProvenance === undefined
-        || options.methodSkillPath === undefined
-        || options.methodSkillConfiguredPath === undefined) {
-        throw new Error("observed method publication is missing packaged method coordinates");
-    }
-    const methodInvocations = extractObservedMethodInvocations(entries, {
-        name: options.methodProvenance.name,
-        allowedLocations: [options.methodSkillPath, options.methodSkillConfiguredPath],
-    });
-    return {
-        methodProvenance: options.methodProvenance,
-        methodInvocationObserved: methodInvocations.length > 0,
-        methodInvocations,
-    };
-}
-async function publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates, entries, options = {}) {
+async function publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates, entries) {
     const face = seatArtifactFace(admitted.role);
     const phase = face.reportPhase === true
         ? { phase: readAdmittedPath(admitted, "phase") }
@@ -2071,7 +1993,6 @@ async function publishDeclaredSeatArtifacts(admitted, roleOutcome, coordinates,
             sessionFile: coordinates.sessionFile,
             admittedRequestPath: admitted.admittedRequestPath,
             attachments: acceptedArtifactAttachmentRefs(admitted.attachments),
-            ...observedMethodTail(face, entries, options),
         },
     });
 }
@@ -2163,16 +2084,8 @@ export async function trySettleAcceptedSeatTerminalResult(admitted, authority, s
     return applySecretariatCountersignTerminal(admitted, authority, settled);
 }
 /** One settlement dispatch. The registry `settlement` leaf selects the path. */
-export async function trySettlePublicSeat(admitted, authority, scope, material, packageRoot) {
-    const face = seatArtifactFace(admitted.role);
-    if (face.method === "observed" && material === undefined)
-        return undefined;
-    const options = face.method === "observed" && material !== undefined
-        ? observedMethodSkillOptions(packageRoot, material)
-        : face.method === "optional" && material !== undefined
-            ? { methodProvenance: material.provenance }
-            : {};
-    return settleSeat(admitted, authority, scope, options);
+export async function trySettlePublicSeat(admitted, authority, scope) {
+    return settleSeat(admitted, authority, scope);
 }
 /**
  * #969 seat projection sole authority: 给事中 terminal (署|上呈) booked as a

package/dist/public-cli/turn-request.js

@@ -1,6 +1,6 @@
 import { pickEngineAxis } from "../package-resources/engine-material.js";
-import { resolvePackagedMethodSkillPath, } from "../package-resources/method-skill.js";
 import { packagedRoleActivationFlags, packagedRoleMetadata, } from "../packaged-role-registry.js";
+import { installedMethodSkillPath } from "./machine-method-skills.js";
 import { parentRunPathFromGatePointerInstruction } from "./run-lifecycle.js";
 export function projectRoleTurnRequest(admitted, roleDetails, options) {
     const cwd = admitted.projectRoot ?? admitted.repoRoot ?? admitted.cwd;
@@ -86,7 +86,7 @@ function activationForAdmitted(admitted) {
     return activation;
 }
 /** Skill bindings declared on the composition-root record for this admitted run. */
-function methodBindings(admitted, packageRoot) {
+export function requiredMethodSkills(admitted) {
     const record = packagedRoleMetadata(admitted.role);
     const names = [];
     if (record !== undefined && "methodSkills" in record && record.methodSkills !== undefined) {
@@ -95,15 +95,23 @@ function methodBindings(admitted, packageRoot) {
     const apply = packagedSettleSkill(admitted);
     if (apply !== undefined && !names.includes(apply))
         names.push(apply);
-    return names.map((name) => ({
-        kind: "skill",
-        path: resolvePackagedMethodSkillPath(packageRoot, name),
-    }));
+    return names;
+}
+function methodBindings(admitted, home, host) {
+    if (host !== undefined && host !== "pi")
+        return [];
+    return requiredMethodSkills(admitted).flatMap((name) => {
+        const path = installedMethodSkillPath(home, name);
+        return path === undefined ? [] : [{
+                kind: "skill",
+                path,
+            }];
+    });
 }
 /** Registry activation and method bindings for one admitted public seat. */
-export function admittedSeatTurnDetails(admitted, packageRoot) {
+export function admittedSeatTurnDetails(admitted, home, host) {
     return {
         activation: activationForAdmitted(admitted),
-        methods: methodBindings(admitted, packageRoot),
+        methods: methodBindings(admitted, home, host),
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.5037",
+  "version": "0.1.5066",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",
@@ -26,6 +26,8 @@
   },
   "files": [
     "dist",
+    "!dist/package-resources/method-skill.js",
+    "!dist/package-resources/method-skill-binding.js",
     "extensions",
     "scripts/generate-tool-execution-observation-schema.ts",
     "scripts/build-package.mjs",

package/resources/836-deleted-machine-instruction-inventory.md

@@ -9,7 +9,7 @@
 | `compliance-transport.ts` `AUDITOR_DOSSIER_PROMPT` | `本 run 卷宗已就绪。` | 改为台院同形路径指针。 |
 | `doctor-role.ts` case catalog | `provenance: "由留存 session 字节推导，封入受理回执。"` | 删。catalog 只留 cost 与证据指针。 |
 | `collector-role.ts` bounceInfrastructure | `请省略该字段后重新提交。` | 代码打回推翻自报已删。 |
-| `reviewer-role.ts` output description | `Standards/Spec 评审腿由 runtime 以取证子会话代跑…` | #836 改为「本席自调 code-review skill」。#917 后随包方法为 `ak-cross-m-review`；`resources/methods/code-review/` 已删，现役指针见 `resources/methods/ak-cross-m-review/SKILL.md`。 |
+| `reviewer-role.ts` output description | `Standards/Spec 评审腿由 runtime 以取证子会话代跑…` | #836 改为「本席自调 code-review skill」。#917 后方法为 `ak-cross-m-review`；#1043 起不再随包，由 `ak-role setup` 从 Akagilnc/ak-cross-m-review 装入机器 `~/.agents/skills`。 |
 | `run-lifecycle.ts` A4.1 | `[ak-role:resume-continue]` | 生产码不再含此字面量。结算只跳过空轮与引擎指针续跑。 |
 | `run-lifecycle.ts` A4.2 | `重新读 <path>` | 前轮已删改写。 |
 | `submission-correctable-error.ts` A4.5 | `终局交卷并非本轮唯一工具调用。` | 删。Pi/ACP `deliverSubmissionRejection` 不再注入该句。 |

package/scripts/build-package.mjs

@@ -1,4 +1,4 @@
-import { chmod, copyFile, cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { chmod, copyFile, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { build } from "esbuild";
@@ -203,11 +203,6 @@ export async function buildPackageArtifacts() {
   await buildAcpProductionHost();
   await buildHeadlessProductionHost();
   await buildMigrateBookTopology();
-  const pluginDir = join("dist", "method-host-plugin");
-  await rm(pluginDir, { recursive: true, force: true });
-  await mkdir(pluginDir, { recursive: true });
-  await cp("resources/method-host-plugin/.claude-plugin", join(pluginDir, ".claude-plugin"), { recursive: true });
-  await cp("resources/methods", join(pluginDir, "skills"), { recursive: true });
   // Packaged handbook/playbook paths resolve via injected packageRoot (#962) —
   // do not mirror resources/ into dist/resources (one authority, no parallel copy).
 }

package/src/headless-host/description.ts

@@ -94,8 +94,6 @@ export function headlessTurnArgs(options: {
   readonly effort?: string;
   /** Fresh session: pass as session id. Resume: pass as resume id. */
   readonly session: { readonly kind: "new"; readonly id: string } | { readonly kind: "resume"; readonly id: string };
-  /** Packaged method plugin dir (`--plugin-dir`). */
-  readonly pluginDir?: string;
 }): string[] {
   const { description } = options;
   const args: string[] = [
@@ -107,7 +105,6 @@ export function headlessTurnArgs(options: {
   if (options.jsonSchema !== undefined) {
     args.push(description.jsonSchemaFlag, JSON.stringify(options.jsonSchema));
   }
-  if (options.pluginDir) args.push("--plugin-dir", options.pluginDir);
   if (options.mcpConfigPath !== undefined && options.mcpConfigPath !== "") {
     args.push(description.mcpConfigFlag, options.mcpConfigPath);
   }

package/src/headless-host/role-turn-host.ts

@@ -23,12 +23,6 @@ import {
 } from "../prepared-role-turn.ts";
 
 import { reportHostSessionEvent } from "../host-session-record.ts";
-import {
-  applyClaudeSkillInvocation,
-  applyCodexSkillInvocation,
-  hostMethodSkills,
-  packagedMethodPluginDir,
-} from "../host-native-method.ts";
 import {
   closeJsonSchemaForCodex,
   codexTurnArgs,
@@ -418,7 +412,6 @@ function buildTurnArgs(options: {
   readonly sessionKind: "new" | "resume";
   readonly cwd: string;
   readonly writableRoots?: readonly string[];
-  readonly pluginDir?: string;
 }): readonly string[] {
   if (isCodexExecDescription(options.description)) {
     if (options.sessionKind === "resume" && !options.sessionId) {
@@ -451,7 +444,6 @@ function buildTurnArgs(options: {
     ...(options.model === undefined ? {} : { model: options.model }),
     ...(options.effort === undefined ? {} : { effort: options.effort }),
     session: { kind: options.sessionKind, id: options.sessionId },
-    ...(options.pluginDir === undefined ? {} : { pluginDir: options.pluginDir }),
   });
 }
 
@@ -460,7 +452,7 @@ export function createHeadlessRoleTurnHost(config: HeadlessRoleTurnHostConfig):
   return createSerializedRoleTurnHost(async (request): Promise<RoleTurnResult> => {
     const prepared = await config.prepare(request);
     const systemPrompt = renderSystemPromptOverride(prepared.systemPrompt);
-    const codex = isCodexExecDescription(config.description);
+      const codex = isCodexExecDescription(config.description);
     let outcome: RoleTurnResult = failure("session", "HeadlessNoOutcome", "no-outcome");
     try {
       // Claude mints a package UUID for --session-id; codex waits for thread.started.
@@ -486,10 +478,6 @@ export function createHeadlessRoleTurnHost(config: HeadlessRoleTurnHostConfig):
       await writeFile(systemPromptPath, systemPrompt, "utf8");
       let mcpConfigPath: string | undefined;
       let outputSchemaPath: string | undefined;
-      let pluginDir: string | undefined;
-      let applyMethodPrompt: (prompt: string) => string = codex
-        ? (prompt) => applyCodexSkillInvocation(request.methods, prompt)
-        : (prompt) => prompt;
       if (codex) {
         // #959: navigator is a prose-exit seat — no closed output-schema.
         if (prepared.terminatingToolName !== NAVIGATOR_OUTPUT_TOOL_NAME) {
@@ -507,14 +495,6 @@ export function createHeadlessRoleTurnHost(config: HeadlessRoleTurnHostConfig):
           `${JSON.stringify(headlessMcpConfigDocument(prepared.mcpServers), null, 2)}\n`,
           "utf8",
         );
-        if (hostMethodSkills(request.methods).length > 0) {
-          const packageRoot = env.AK_PACKAGE_ROOT ?? process.env.AK_PACKAGE_ROOT;
-          if (typeof packageRoot !== "string" || packageRoot === "") {
-            throw new Error("claude method plugin-dir requires AK_PACKAGE_ROOT");
-          }
-          pluginDir = packagedMethodPluginDir(packageRoot);
-          applyMethodPrompt = (prompt) => applyClaudeSkillInvocation(request.methods, prompt);
-        }
       }
 
       const sessionParent = config.sessionIdentity.resolveSessionFile(request.principal);
@@ -542,7 +522,6 @@ export function createHeadlessRoleTurnHost(config: HeadlessRoleTurnHostConfig):
               sessionKind,
               cwd: request.cwd,
               ...(gitCommonDir === undefined ? {} : { writableRoots: [gitCommonDir] }),
-              ...(pluginDir === undefined ? {} : { pluginDir }),
             });
           } catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -560,7 +539,7 @@ export function createHeadlessRoleTurnHost(config: HeadlessRoleTurnHostConfig):
               args,
               cwd: request.cwd,
               env,
-              stdin: request.continuation.kind === "resume" ? prompt : applyMethodPrompt(prompt),
+              stdin: prompt,
               ...(abortSignal === undefined ? {} : { signal: abortSignal }),
               ...(request.timeoutMs === undefined ? {} : { timeoutMs: request.timeoutMs }),
               onStdoutLine(line) {

package/src/host-contracts.ts

@@ -74,7 +74,7 @@ export class ExplicitInternalActivationError extends Error {
   }
 }
 
-/** Packaged method skill binding (zero/one/many). */
+/** Required machine-installed method Skill (zero/one/many). */
 export type MethodBinding = {
   readonly kind: "skill";
   readonly path: string;
@@ -350,33 +350,13 @@ type HostGatekeeperSubject = {
 };
 /** Gatekeeper non-pass faces returned to parent (#836 includes transport_failure; never kill leg). */
 type HostGatekeeperNonPass = { readonly status: "continue" | "escalate" | "no_receipt" | "transport_failure" } & Record<string, unknown>;
-export type HostSubmissionNonPass =
-  | HostGatekeeperNonPass
-  | { readonly code: "coder_skill_expansion_evidence_missing" };
+export type HostSubmissionNonPass = HostGatekeeperNonPass;
 export type HostGatekeeperActions = {
   failInfrastructure(error: unknown, context: HostContext, toolCallId?: string): never;
   /** Envelope-owned execute→tool_result bridge for any structured submission non-pass. */
   bindSubmissionNonPass(toolCallId: string, result: HostSubmissionNonPass): void;
 };
 
-export type HostSkillExpansionEvidence = Readonly<{
-  name: string;
-  location: string;
-  content: string;
-  userMessage: string;
-}>;
-
-/** Host capability declaration (contract verb ④). */
-export type HostCapabilityDeclaration = Readonly<{
-  skillExpansion(prompt: string): HostSkillExpansionEvidence | undefined;
-  /**
-   * Pi-only: recover the plain original request from a native skill turn text
-   * (argv may already carry `/skill:<name>` from the Pi adapter). Absent on
-   * non-pi hosts so role body never parses Pi slash syntax (ADR 0082).
-   */
-  skillOriginalRequest?(name: string, text: string): string;
-}>;
-
 /** Host-owned effects used by the shared activation envelope. */
 export interface RoleEnvelopeHost {
   readonly host: RoleHost;
@@ -388,7 +368,6 @@ export interface RoleEnvelopeHost {
 
 /** The activation surface consumed by package role factories. */
 export interface RoleHost {
-  readonly capabilities?: HostCapabilityDeclaration;
   /** Deliver a typed correctable rejection into the current durable session's model context. */
   deliverSubmissionRejection?(rejection: { readonly kind: "correctable-rejection"; readonly code: string; readonly toolCallIds: readonly string[] }): void | Promise<void>;
   registerFlag(name: string, definition:

package/src/host-descriptions.ts

@@ -56,9 +56,8 @@ export const HOST_DESCRIPTIONS: Readonly<Record<string, AcpHostDescription>> = O
  * Headless CLI family (#645 / #646). Claude print-mode is the first row;
  * codex exec (#646) adds another. Protocol-specific argv/parse live in
  * headless-host helpers (#752 per-host impl).
- * Claude fixedArgs: print mode, full permissions. stream-json + verbose: live
- * host events for sitian records (#811); result is last line. Forced methods
- * ride `--plugin-dir` (#922); operator skill/setting surfaces stay open.
+ * Claude fixedArgs: print mode. stream-json + verbose: live
+ * host events for sitian records (#811); result is last line.
  */
 export const HEADLESS_HOST_DESCRIPTIONS: Readonly<Record<string, HeadlessHostDescription>> = Object.freeze({
   "claude": Object.freeze({

package/src/packaged-role-registry.ts

@@ -42,7 +42,6 @@ export type PackagedArtifactFace = {
   readonly reportPhase?: true;
   readonly evidenceRole?: true;
   readonly leaves: readonly PackagedArtifactLeaf[];
-  readonly method?: "optional" | "observed";
   readonly doctorReportFacts?: true;
 };
 
@@ -132,7 +131,6 @@ export const PUBLIC_ROLE_RECORDS = [
         { key: "prerequisitesPath", omitUndefined: true },
         { key: "prerequisites" },
       ],
-      method: "observed",
     },
     boardPlacement: "marshal",
     activationFlags: [
@@ -158,7 +156,6 @@ export const PUBLIC_ROLE_RECORDS = [
     worker: true,
     applyMethod: "tdd",
     /** Method-material load failure keeps the activation cause (not reviewer/fixer). */
-    methodLoadFailureCause: "activation",
     boardPlacement: "coder",
     phases: ["plan", "apply"],
     outputTool: CODER_OUTPUT_TOOL_NAME,
@@ -170,7 +167,6 @@ export const PUBLIC_ROLE_RECORDS = [
         { key: "phase" },
         { key: "taskPath" },
       ],
-      method: "optional",
     },
     activationFlags: [
       { field: "taskPath", flag: "ak-coder-task", binds: "input" },
@@ -212,7 +208,6 @@ export const PUBLIC_ROLE_RECORDS = [
         { key: "authorityRefs", copyArray: true },
         { key: "callerProvenance", callerProvenance: true },
       ],
-      method: "observed",
     },
     /** Frozen base/lens/authority become the initial prompt; instruction follows. */
     transportPrompt: "skill-args",
@@ -311,7 +306,6 @@ export const PUBLIC_ROLE_RECORDS = [
     methodSkills: ["resolving-merge-conflicts"],
     settleMethod: "resolving-merge-conflicts",
     /** Method-material load failure keeps the activation cause (not reviewer/fixer). */
-    methodLoadFailureCause: "activation",
     phases: [null],
     outputTool: MERGER_OUTPUT_TOOL_NAME,
     settlement: "residual",
@@ -324,7 +318,6 @@ export const PUBLIC_ROLE_RECORDS = [
         { key: "mergerInputPath" },
         { key: "derived" },
       ],
-      method: "observed",
     },
     activationFlags: [
       { field: "inputPath", from: "mergerInputPath", flag: "ak-merger-input", binds: "input" },
@@ -582,6 +575,20 @@ export function packagedRoleMetadata(role: string): PackagedRoleMetadata | undef
   return PACKAGED_ROLE_REGISTRY.find((entry) => entry.role === role);
 }
 
+/** Names any public seat may require. Setup and missing-Skill checks both read this. */
+export function packagedMethodSkillNames(): readonly string[] {
+  const names: string[] = [];
+  for (const record of PACKAGED_ROLE_REGISTRY) {
+    if ("methodSkills" in record && record.methodSkills !== undefined) {
+      for (const name of record.methodSkills) if (!names.includes(name)) names.push(name);
+    }
+    if ("applyMethod" in record && record.applyMethod !== undefined && !names.includes(record.applyMethod)) {
+      names.push(record.applyMethod);
+    }
+  }
+  return names;
+}
+
 /** Review officers (台院 / 符宝郎 / 审刑院). Absent on every other seat. */
 export function isOfficerReviewSeat(role: string): boolean {
   const record = packagedRoleMetadata(role);
@@ -652,13 +659,6 @@ export function packagedRoleOutputTool(role: string): string | undefined {
   return packagedRoleMetadata(role)?.outputTool;
 }
 
-/** Method-material load failure cause declared on the seat. Absent means no typed cause. */
-export function packagedMethodLoadFailureCause(role: string): "activation" | undefined {
-  const record = packagedRoleMetadata(role);
-  if (record === undefined || !("methodLoadFailureCause" in record)) return undefined;
-  return record.methodLoadFailureCause;
-}
-
 /** Diarist binds a board ticket onto its own run. Other seats do not. */
 export function packagedBindsBoardTicket(role: string): boolean {
   const record = packagedRoleMetadata(role);

package/src/pi/adapter.ts

@@ -1,5 +1,4 @@
 import {
-  parseSkillBlock,
   type BeforeAgentStartEventResult,
   type ExtensionAPI,
   type ExtensionContext,
@@ -166,32 +165,6 @@ export function createPiRoleHostAdapter(
     deliverSubmissionRejection(_rejection) {
       // #836 删 1/A4.5: no package-authored non-sole resume sentence.
     },
-    capabilities: {
-      skillExpansion(prompt) {
-        const parsed = parseSkillBlock(prompt);
-        if (parsed == null) return undefined;
-        const userMessage = parsed.userMessage ?? "";
-        return Object.freeze({
-          name: parsed.name,
-          location: parsed.location,
-          content: parsed.content,
-          userMessage,
-        });
-      },
-      /** Recover plain original request from Pi-native `/skill:` turn text (ADR 0082). */
-      skillOriginalRequest(name, text) {
-        const token = `/skill:${name}`;
-        const trimmed = text.trimStart();
-        if (
-          trimmed === token
-          || trimmed.startsWith(`${token} `)
-          || trimmed.startsWith(`${token}\n`)
-        ) {
-          return text.slice(text.indexOf(token) + token.length).trim();
-        }
-        return text.trim();
-      },
-    },
     registerFlag: (name, definition) => pi.registerFlag(name, definition),
     getFlag: (name) => pi.getFlag(name),
     registerTool: (tool) => pi.registerTool(toPiToolDefinition(

package/src/pi/role-turn-host.ts

@@ -6,7 +6,7 @@
 import { execFile, spawn } from "node:child_process";
 import { constants } from "node:fs";
 import { access, appendFile, readFile, realpath } from "node:fs/promises";
-import { basename, delimiter, dirname, isAbsolute, join, resolve } from "node:path";
+import { delimiter, dirname, isAbsolute, join, resolve } from "node:path";
 import { platform } from "node:process";
 import { promisify } from "node:util";
 import { randomUUID } from "node:crypto";
@@ -86,38 +86,12 @@ function buildMethodArgs(methods: readonly MethodBinding[]): string[] {
   const skillArgs: string[] = [];
   for (const method of methods) {
     if (method.kind === "skill") {
-      skillArgs.push("--skill", method.path);
+      skillArgs.push("--skill", dirname(method.path));
     }
   }
   return skillArgs;
 }
 
-/**
- * Pi-native `/skill:<name>` for a single forced method (ADR 0082: pi is one adapter
- * with no privilege; Pi-only seams stay inside the pi adapter).
- * Driven by typed RoleTurnRequest.methods — middle-layer decision, Pi-only syntax.
- * Zero/many methods leave the prompt alone (Fixer optional pair stays `--skill` only).
- */
-export function applyPiNativeSkillInvocation(
-  methods: readonly MethodBinding[],
-  prompt: string,
-): string {
-  const skills = methods.filter((method) => method.kind === "skill");
-  if (skills.length !== 1) return prompt;
-  const name = basename(dirname(skills[0]!.path));
-  if (name.length === 0) return prompt;
-  const token = `/skill:${name}`;
-  const trimmed = prompt.trimStart();
-  if (
-    trimmed === token
-    || trimmed.startsWith(`${token} `)
-    || trimmed.startsWith(`${token}\n`)
-  ) {
-    return prompt;
-  }
-  return prompt.length === 0 ? token : `${token} ${prompt}`;
-}
-
 /**
  * Pi last-hop argv after `--no-extensions -e entry` (#819).
  * Activation flag membership comes from middle-layer projectActivationFlags;
@@ -165,9 +139,7 @@ function piUserDialogueBody(request: RoleTurnRequest): string {
           const _exhaustive: never = request.continuation;
           return _exhaustive;
         })();
-  return request.continuation.kind === "resume"
-    ? rawPrompt
-    : applyPiNativeSkillInvocation(request.methods, rawPrompt);
+  return rawPrompt;
 }
 
 export type PiSpawnRunner = (