allye-pi 1.6.0 → 1.6.2

package/README.md

@@ -81,8 +81,8 @@ Prefer the paste-into-agent or marketplace routes below? They still work — the
 After installing, you get:
 - **OAuth authentication** — browser-based login, no tokens to manage
 - **Bootstrap hook** — injects workflow methodology at session start
-- **5 dispatched subagents** — reviewer-standards, reviewer-spec, deep-search, code-analyzer, executor, delegated via the Agent tool for phases that don't need to pause and ask you anything (executor only runs this way if you opt into automatic mode — manual is the default)
-- **17 skills** — Sandbox, Planning, Technical Planning, Orchestrator, and Delivery run as skills loaded directly into your conversation, loaded on-demand by the bootstrap, so they can ask you questions when something's ambiguous
+- **Optional delegation** — bounded research, review, or execution subagents may be used when the runtime supports them and delegation is beneficial; local execution remains valid
+- **17 composable skills** — discovery, planning, execution, review, delivery, memory, verification, and delegation playbooks loaded as needed; no universal phase chain is required
 - **Parallel delivery, when a runtime is detected** — the Orchestrator can drive several independent stories at once, each in its own git worktree and its own watchable agent process; without a detected runtime, delivery degrades to the existing manual and automatic-subagent modes
 
 #### Multiple Allye accounts (multi-tenant)
@@ -113,7 +113,7 @@ The agent will configure the MCP server via OAuth and install the `allye-opencod
 
 After installing, you get:
 - **6 agents in the picker** — Allye, Allye Plan, Allye Orchestrator, Allye Build, Allye Review, Allye Deliver (Ctrl+T to switch)
-- **Auto-loaded context** — your profile and team info injected before every conversation
+- **Adaptive context** — profile, team info, and relevant memories loaded when Allye is available and useful
 - **Dynamic skill discovery** — agents search for your team's standards via MCP
 
 **To update:** Paste this into your agent:
@@ -263,7 +263,7 @@ How multi-phase workflow support is implemented differs by platform, because not
 - **OpenCode** ships 6 agent-picker personas (Ctrl+T to switch) — Allye, Allye Plan, Allye Orchestrator, Allye Build, Allye Review, Allye Deliver — OpenCode's agent model supports switching personas interactively within a session, so all 6 can be full agents. The automatic-Executor dispatch mode is Claude-Code-only for now; OpenCode always runs Executor (Allye Build) as an interactive agent.
 - **Cursor, Codex, Gemini CLI** — a single agent handles all phases with the same workflow knowledge (no multi-agent picker on these platforms).
 - **Hermes Agent** reads skills from a directory (`~/.hermes/skills/allye/`) rather than fetching them over MCP, and gets the `using-allye` bootstrap injected by a small Python plugin at session start instead of a hook — otherwise the same single-agent, same-workflow-knowledge shape as Cursor/Codex/Gemini CLI.
-- **Pi** loads the canonical repository skills through a native Pi package, injects Allye context through the configured MCP adapter, and exposes an adaptive toolkit. Herdr delegation is optional and capability-detected; tasks are recommended rather than mandatory.
+- **Pi** loads the canonical repository skills through a native Pi package, reads `using-allye` into the first prompt, injects Allye context through the configured MCP adapter, and exposes an adaptive toolkit. Herdr delegation is optional and capability-detected; tasks are recommended rather than mandatory.
 
 Every phase, on every platform:
 - Responds in **your language** (detected from your messages, falling back to your profile only before you've said anything)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allye-pi",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Pi package adapter for the canonical Allye workflow",
   "type": "module",
   "keywords": [

package/packages/allye-pi/src/index.ts

@@ -71,7 +71,6 @@ export type DelegationState = {
   panes: OwnedPane[];
   waits: Set<string>;
 };
-const DELEGATION_TOOL_NAME = "allye_herdr";
 const WAIT_EVENT_TYPE = "allye-herdr-wait";
 const RUNTIME_TOOL_NAME = "allye_herdr";
 
@@ -88,10 +87,17 @@ function limitText(text: string, maxChars: number): string {
   return text.length <= maxChars ? text : `${text.slice(0, maxChars)}\n[context truncated]`;
 }
 
-export function describeCapabilities(env: NodeJS.ProcessEnv = process.env): AllyeCapabilities {
+type McpBridgeRuntime = typeof globalThis & {
+  __piMcpAdapterActiveToolCaller?: ActiveMcpToolCaller | null;
+};
+
+export function describeCapabilities(
+  env: NodeJS.ProcessEnv = process.env,
+  mcpAvailable = Boolean((globalThis as McpBridgeRuntime).__piMcpAdapterActiveToolCaller),
+): AllyeCapabilities {
   return {
     piSession: true,
-    allyeMcp: env.ALLYE_PI_MCP !== "0",
+    allyeMcp: env.ALLYE_PI_MCP !== "0" && mcpAvailable,
     filesystem: true,
     subagents: env.ALLYE_PI_SUBAGENTS === "1",
     herdr: env.HERDR_ENV === "1",
@@ -134,9 +140,7 @@ async function configuredMcpCall(toolName: string, args: Record<string, unknown>
   // the in-process runtime. There is no public callMcpTool export in the
   // supported package version, so do not dynamically import its TypeScript
   // source from node_modules. A missing bridge is a hard bootstrap failure.
-  const globalBridge = (globalThis as typeof globalThis & {
-    __piMcpAdapterActiveToolCaller?: ActiveMcpToolCaller | null;
-  }).__piMcpAdapterActiveToolCaller;
+  const globalBridge = (globalThis as McpBridgeRuntime).__piMcpAdapterActiveToolCaller;
   if (!globalBridge) throw new Error("pi-mcp-adapter is not initialized; start the configured MCP adapter before using Allye");
   return globalBridge(MCP_SERVER, toolName, args);
 }
@@ -256,8 +260,8 @@ export function deliverWaitEvent(
 
 export function invalidStartupContext(message: string): StartupContext {
   return {
-    text: `## Allye bootstrap blocked\n${message}\nDo not call team-scoped work_items or intelligence operations. Resolve Allye connectivity and explicitly select a team with allye_team action team_switch before continuing.`,
-    teamSelectionRequired: true,
+    text: `## Allye optional context unavailable\n${message}\nDo not call team-scoped work_items or intelligence operations until Allye connectivity and team context are available. Continue with local, non-team-scoped work when appropriate.`,
+    teamSelectionRequired: false,
     allyeUnavailable: true,
     teams: [],
   };
@@ -267,7 +271,8 @@ export function canUseOwnedPane(state: DelegationState, paneId: string): boolean
   return state.panes.some((pane) => pane.paneId === paneId);
 }
 
-async function loadStartupContext(): Promise<StartupContext> {
+async function loadStartupContext(allyeMcp = true): Promise<StartupContext> {
+  if (!allyeMcp) return invalidStartupContext("Allye/MCP is disabled for this Pi session.");
   const sections: string[] = [];
   try {
     const initialization = await callAllye("allye_initialize", {
@@ -452,7 +457,10 @@ async function runtimeOperation(capabilities: AllyeCapabilities, params: Record<
     const newPane = collectValues(afterLayout, "pane_id").find((id) => !beforePanes.has(id));
     if (!newPane) throw new Error("Herdr split completed but no new pane id was returned");
     const paneRecords = collectPaneRecords(afterLayout);
-    const record = paneRecords.find((candidate) => candidate.paneId === newPane && candidate.workspaceId === String((afterLayout as Record<string, unknown>).workspace_id ?? candidate.workspaceId) && candidate.tabId === String((afterLayout as Record<string, unknown>).tab_id ?? candidate.tabId));
+    const layoutMetadata = afterLayout as Record<string, unknown>;
+    const record = paneRecords.find((candidate) => candidate.paneId === newPane
+      && candidate.workspaceId === String(layoutMetadata.workspace_id ?? candidate.workspaceId)
+      && candidate.tabId === String(layoutMetadata.tab_id ?? candidate.tabId));
     if (!record) throw new Error("Herdr returned a pane without workspace/tab ownership metadata");
     ownership.panes.push(record);
     await waitForInteractiveShell(newPane);
@@ -643,7 +651,7 @@ export default function allyePiAdapter(pi: ExtensionAPI): void {
     usingAllyeBootstrap = loadUsingAllyeSkill();
     syncCapabilityTools();
     if (ctx.hasUI) ctx.ui.setStatus("allye-pi", "loading Allye context…");
-    if (process.env.ALLYE_PI_NATIVE_BOOTSTRAP !== "0") startupContext = await loadStartupContext();
+    if (process.env.ALLYE_PI_NATIVE_BOOTSTRAP !== "0") startupContext = await loadStartupContext(capabilities.allyeMcp);
     if (startupContext.teamSelectionRequired && ctx.hasUI) {
       ctx.ui.notify("Allye has multiple teams and no active team. Use /allye-team <name|prefix|id> before team-scoped work.", "warning");
     }