@akagilnc/pi-workflow-roles 0.1.3826 → 0.1.3873

package/dist/host-descriptions.js

@@ -48,6 +48,7 @@ export const HOST_DESCRIPTIONS = Object.freeze({
 /**
  * Headless CLI family (#645). Claude is the first row; codex (#646) adds another.
  * fixedArgs: print mode, isolation without `--bare` (OAuth stays), full permissions.
+ * stream-json + verbose: live host events for sitian records (#811); result is last line.
  * `--setting-sources` empty = load no user/project/local CLAUDE.md/hooks/skills
  * (role envelope is delivered via `--system-prompt` wholesale replace).
  * `--strict-mcp-config` with no `--mcp-config` drops operator MCP + claude.ai connectors.
@@ -57,8 +58,10 @@ export const HEADLESS_HOST_DESCRIPTIONS = Object.freeze({
         binaryFromHome: Object.freeze([".local", "bin", "claude"]),
         sessionBindingFile: "claude-headless-session.json",
         fixedArgs: Object.freeze([
-            // One result envelope (not stream-json): typed receipt only; no event-stream copy.
-            "--output-format", "json",
+            // Live NDJSON events → sitian host-session records (#811); last line is the result receipt.
+            "--output-format", "stream-json",
+            // Intermediate assistant/tool/system events require verbose with stream-json.
+            "--verbose",
             "--permission-mode", "bypassPermissions",
             // Empty sources: no user/project/local operator surface (envelope owns materials).
             "--setting-sources", "",

package/dist/pi/adapter.js

@@ -106,6 +106,17 @@ export function createPiRoleHostAdapter(pi, options = {}) {
                     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),

package/dist/pi/role-turn-host.js

@@ -6,12 +6,13 @@
 import { execFile, spawn } from "node:child_process";
 import { constants } from "node:fs";
 import { access, appendFile, readFile, realpath } from "node:fs/promises";
-import { delimiter, isAbsolute, join, resolve } from "node:path";
+import { basename, delimiter, dirname, isAbsolute, join, resolve } from "node:path";
 import { platform } from "node:process";
 import { promisify } from "node:util";
 import { randomUUID } from "node:crypto";
 import { ExplicitInternalActivationError } from "../host-contracts.js";
 import { applyEngineChildEnv } from "../engine-detour.js";
+import { projectActivationFlags } from "../role-activation-flags.js";
 /** Package-relative Internal role entrypoint (ADR 0052; same path as public-cli registry). */
 const INTERNAL_ROLE_ENTRYPOINT_RELATIVE = "extensions/role-runtime.ts";
 export function resolveInternalRoleEntrypoint(packageRoot) {
@@ -45,95 +46,20 @@ function buildSeatModelCliArgs(model) {
         ...(model.thinking === undefined ? [] : ["--thinking", model.thinking]),
     ];
 }
-function buildActivationFlagArgs(activation) {
-    switch (activation.role) {
-        case "judge":
-            return ["--ak-role", "judge"];
-        case "coder":
-            return [
-                "--ak-role",
-                "coder",
-                "--ak-coder-phase",
-                activation.phase,
-                "--ak-coder-task",
-                activation.taskPath,
-            ];
-        case "fixer":
-            return [
-                "--ak-role",
-                "fixer",
-                "--ak-fixer-phase",
-                activation.phase,
-                "--ak-fix-packet",
-                activation.packetPath,
-                ...(activation.prerequisitesPath === undefined
-                    ? []
-                    : ["--ak-fixer-prerequisites", activation.prerequisitesPath]),
-            ];
-        case "reviewer":
-            return [
-                "--ak-role",
-                "reviewer",
-                "--ak-review-base",
-                activation.baseRevision,
-                ...(activation.authorityRefs.length === 0
-                    ? []
-                    : ["--ak-review-authority-refs", JSON.stringify([...activation.authorityRefs])]),
-                ...(activation.ticketNumber === undefined
-                    ? []
-                    : ["--ak-review-ticket-number", String(activation.ticketNumber)]),
-            ];
-        case "merger":
-            return ["--ak-role", "merger", "--ak-merger-input", activation.inputPath];
-        case "collector":
-            return [
-                "--ak-role",
-                "collector",
-                "--ak-collector-repo",
-                activation.repo,
-                ...(activation.pr === undefined ? [] : ["--ak-collector-pr", activation.pr]),
-                ...(activation.requestManifestPath === undefined
-                    ? []
-                    : ["--ak-collector-request-manifest", activation.requestManifestPath]),
-                ...(activation.waitMs === undefined ? [] : ["--ak-collector-wait-ms", activation.waitMs]),
-            ];
-        case "doctor":
-            return ["--ak-role", "doctor", "--ak-doctor-case", activation.casePath];
-        case "notary":
-            return [
-                "--ak-role",
-                "notary",
-                "--ak-notary-source-run",
-                activation.sourceRun,
-                ...(activation.ticketNumber === undefined
-                    ? []
-                    : ["--ak-notary-ticket-number", String(activation.ticketNumber)]),
-            ];
-        case "countersign":
-            // ticketNumber rides activation/admission/invocation only (#632: no private flag).
-            return ["--ak-role", "countersign"];
-        case "gleaner-left":
-            return [
-                "--ak-role",
-                "gleaner-left",
-                "--ak-gleaner-left-base",
-                activation.baseRevision,
-            ];
-        case "inspector":
-            return ["--ak-role", "inspector"];
-        case "gatekeeper":
-            return ["--ak-role", "gatekeeper"];
-        case "navigator":
-            return ["--ak-role", "navigator"];
-        case "auditor":
-            return ["--ak-role", "auditor"];
-        case "diarist":
-            return ["--ak-role", "diarist"];
-        default: {
-            const _exhaustive = activation;
-            return _exhaustive;
-        }
+/**
+ * Pi last hop only: shared envelope flags → controlled-session argv pairs (#819).
+ * Flag membership/values stay in projectActivationFlags (middle layer).
+ */
+function activationFlagsToPiArgv(flags) {
+    const args = [];
+    for (const [name, value] of flags) {
+        if (value === false)
+            continue;
+        args.push(`--${name}`);
+        if (value !== true)
+            args.push(String(value));
     }
+    return args;
 }
 function buildMethodArgs(methods) {
     const skillArgs = [];
@@ -145,17 +71,41 @@ function buildMethodArgs(methods) {
     return skillArgs;
 }
 /**
- * Translate a closed RoleTurnRequest into Pi argv after `--no-extensions -e entry`.
- * Controlled session constants and session coordinates are adapter-internal.
+ * Pi-native `/skill:<name>` for a single forced method (ADR 0082 `pi-no-privilege`).
+ * 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, prompt) {
+    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;
+ * this function only renders session coords, controlled constants, and pairs.
+ * Single forced method → Pi-native `/skill:` on the argv prompt (#822).
  */
 export function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
     const { sessionFile, sessionDirectory } = authority.decode(request.principal);
-    const prompt = request.continuation.kind === "initial" || request.continuation.kind === "resume"
+    const rawPrompt = request.continuation.kind === "initial" || request.continuation.kind === "resume"
         ? request.continuation.prompt
         : (() => {
             const _exhaustive = request.continuation;
             return _exhaustive;
         })();
+    const prompt = applyPiNativeSkillInvocation(request.methods, rawPrompt);
     return [
         "--no-skills",
         ...buildMethodArgs(request.methods),
@@ -167,7 +117,8 @@ export function buildPiTurnExtraArgs(request, authority, extraPiArgs = []) {
         "--session-dir",
         sessionDirectory,
         ...extraPiArgs,
-        ...buildActivationFlagArgs(request.activation),
+        // Envelope assembly = projectActivationFlags; pi only renders argv pairs.
+        ...activationFlagsToPiArgv(projectActivationFlags(request)),
         "--mode",
         "json",
         ...buildSeatModelCliArgs(request.model),

package/dist/public-cli/invocation.js

@@ -2025,13 +2025,12 @@ export async function admitMergerInvocation(options) {
     };
 }
 /**
- * Build the Pi prompt transport for an admitted Merger request.
- * Every invocation forces package merge-only method expansion before conflict work.
+ * Build the host-neutral prompt transport for an admitted Merger request.
+ * Method material binds on RoleTurnRequest.methods; Pi-native `/skill:` form
+ * is adapter-internal only (ADR 0082).
  */
 export function buildMergerTransportPrompt(admitted, engineMaterial) {
-    const lines = [
-        `/skill:resolving-merge-conflicts ${admitted.instruction}`,
-    ];
+    const lines = [admitted.instruction];
     if (admitted.attachments.length > 0) {
         lines.push("");
         lines.push("已受理附件（冻结快照路径）：");

package/dist/public-cli/load-production-acp-host.js

@@ -36,5 +36,5 @@ export async function loadProductionAcpHostFactory(packageRoot, host) {
     const href = pathToFileURL(target).href;
     const mod = (await import(__rewriteRelativeImportExtension(href)));
     const create = mod.createProductionAcpRoleTurnHost;
-    return (options) => create({ ...options, description });
+    return (options) => create({ ...options, description, hostName: host });
 }

package/dist/public-cli/load-production-external-host.js

@@ -17,3 +17,13 @@ export async function loadProductionExternalHostFactory(packageRoot, host) {
     }
     throw new Error(`unregistered host: ${host}`);
 }
+/** Lazy production external host — sole builder for CLI adapter table + public summons (#820). */
+export function createLazyProductionExternalHost(options) {
+    let hostPromise;
+    return {
+        executeTurn: async (request) => {
+            hostPromise ??= loadProductionExternalHostFactory(options.packageRoot, options.hostName).then((create) => create({ packageRoot: options.packageRoot, principalAuthority: options.principalAuthority }));
+            return (await hostPromise).executeTurn(request);
+        },
+    };
+}

package/dist/public-cli/load-production-headless-host.js

@@ -32,5 +32,5 @@ export async function loadProductionHeadlessHostFactory(packageRoot, host) {
     const href = pathToFileURL(target).href;
     const mod = (await import(__rewriteRelativeImportExtension(href)));
     const create = mod.createProductionHeadlessRoleTurnHost;
-    return (options) => create({ ...options, description });
+    return (options) => create({ ...options, description, hostName: host });
 }