@quantiya/codevibe-claude-plugin 2.0.43 → 2.0.45

package/node_modules/@quantiya/codevibe-core/dist/orchestration-shell/slash-routes/implementors.d.ts

@@ -0,0 +1,17 @@
+import type { AgentKind } from '../../local-executor/types';
+import type { Tier } from '../types';
+import { detectInstalledAgents } from '../../orchestration';
+import { type ImplementorPreference, readImplementorPreferenceSync } from '../implementor-preference';
+export declare function displayAgentName(agent: string): string;
+/**
+ * Human-readable, ANSI-free rendering of implementor preference & multi-track allocation.
+ */
+export declare function formatImplementorPolicy(detected: readonly AgentKind[], pref: ImplementorPreference, tier?: Tier): string;
+/**
+ * Synchronously formats the user's implementor policy. Never throws.
+ */
+export declare function runImplementorsCli(detectFn?: typeof detectInstalledAgents, readPrefFn?: typeof readImplementorPreferenceSync, tier?: Tier): string;
+/**
+ * Handles CLI invocation of `/implementor-setup <args>`.
+ */
+export declare function runImplementorSetupCli(args: string, detectFn?: typeof detectInstalledAgents): Promise<string>;

package/node_modules/@quantiya/codevibe-core/dist/orchestration-shell/task-lifecycle-lines.d.ts

@@ -0,0 +1,29 @@
+/** The never-started halt reasons of `QUEUED_WORK_ENDED` (engine `halted_reason`). */
+export type QueuedTaskEndReason = 'user_cancelled_queued_task' | 'tier_changed' | 'queued_task_expired';
+/** `#4` → `4`, `#4 retry` → `4`, `#5.2` → `5.2`; anything else unchanged. */
+export declare function labelNumber(label: string): string;
+/** Desktop answer to a queued START (§3.7). */
+export declare function queuedDesktopLine(label: string, info: {
+    runningTracks?: number;
+    trackBudget?: number;
+}): string;
+/** Phone line for a queued START (§3.13 item 1). */
+export declare function queuedPhoneLine(label: string, info: {
+    runningTracks?: number;
+    trackBudget?: number;
+}): string;
+/** Phone line for every single-task start, immediate or from the queue. */
+export declare function startedPhoneLine(label: string, agent: string): string;
+/** Desktop line when a queued task starts because a slot freed. */
+export declare function startedFromQueueDesktopLine(label: string, agent: string): string;
+/** Phone line when a team starts (§3.13 item 1). */
+export declare function teamStartedPhoneLine(label: string, running: number, waiting: number): string;
+/** Phone line when a team track that waited starts later (`#5.4`). */
+export declare function trackStartedPhoneLine(trackLabel: string): string;
+/**
+ * The line (desktop and phone) for a task that never started and was halted.
+ * An unknown reason renders the neutral form.
+ */
+export declare function cancelledLine(label: string, reason: string): string;
+/** `/status` phase for a cancelled task: `cancelled (reason)`. */
+export declare function cancelledStatusLabel(reason?: string): string;

package/node_modules/@quantiya/codevibe-core/dist/orchestration-shell/task-progress.d.ts

@@ -87,6 +87,7 @@ export type TaskProgressEvent = ({
     message: string;
 }) & {
     epoch?: number;
+    progressTaskId?: string;
     tokens?: number;
 };
 /** The callback the QuorumLoop invokes on each progress phase. */

package/node_modules/@quantiya/codevibe-core/dist/orchestration-shell/team-decompose.d.ts

@@ -197,6 +197,8 @@ export interface RunLocalDecomposerDeps {
     localExecutor: LocalExecutor;
     /** Canonicalized real working dir (the repo) — the decomposer reads the tree. */
     workingDir: string;
+    /** Optional user priority order. Defaults to DEFAULT_IMPLEMENTOR_PRIORITY. */
+    priorityOrder?: readonly AgentKind[];
 }
 /**
  * Run the local decomposition pass (§3.B). Spawns the FIRST available agent in
@@ -220,12 +222,11 @@ export declare function runLocalDecomposer(deps: RunLocalDecomposerDeps, brief:
  */
 repoContext?: string): Promise<DecomposerResult>;
 /**
- * Validate + normalize each work item's `implementorAgent` against the active
- * detected agent set (§3.C — v1 is DETECTED-ONLY; NO capability-health
- * filtering, NO per-spawn auth-recheck). For each item:
- * `.toUpperCase()`-normalize the suggested agent; keep it if active +
- * detected; else SUBSTITUTE the first active detected agent. If NO active
- * agent is detected → `null` (the caller falls back to single). Returns NEW
- * work items (does not mutate the inputs).
+ * §3.C / §3.E — availability-validate the parsed agent strings against the
+ * host's detected list.
+ * Allocates tracks across detected agents according to the user's priority order
+ * and in-flight busy agents, matching multi-track allocation.
+ * If no supported active agent is detected → `null` (the caller falls back to single).
+ * Returns NEW work items (does not mutate the inputs).
  */
-export declare function validateAgentAvailability(workItems: DecomposerWorkItem[], detected: AgentKind[]): DecomposerWorkItem[] | null;
+export declare function validateAgentAvailability(workItems: DecomposerWorkItem[], detected: AgentKind[], priorityOrder?: readonly AgentKind[] | null, inFlightAgents?: readonly AgentKind[]): DecomposerWorkItem[] | null;

package/node_modules/@quantiya/codevibe-core/dist/orchestration-shell/types.d.ts

@@ -3,6 +3,9 @@ import type { StructuralSummary } from '../structural-summary/types';
 import type { GatePromptEnvelope, ReviewSummaryPanelModel } from './gate-prompts';
 import type { TaskProgressEvent } from './task-progress';
 import type { ReviewerAgentSpec } from '../types/reviewer';
+import type { ImplementorPreference } from './implementor-preference';
+import type { AgentKind as LocalExecutorAgentKind } from '../local-executor/types';
+import type { WorkItemInput } from '../local-executor/task-group-types';
 /**
  * Engine's reply to `applyUserDecision`. Surfaced by the SDK as
  * `Promise<PostDecisionAction>`. Discriminated by `kind`; payload
@@ -134,6 +137,8 @@ export interface PlannerDecision {
      * locks shape.
      */
     gateRequest?: Record<string, unknown>;
+    /** Task start confirmation metadata when ask_user is confirming a start_task. */
+    startConfirmation?: TaskStartConfirmationState;
 }
 export interface BrainstormContextMetadata {
     needsRepositoryContext: boolean;
@@ -172,7 +177,8 @@ export interface SessionTaskRecord {
     /** 'single' = TASK_LIFECYCLE-tracked; 'team' = Agent Teams track. */
     origin: 'single' | 'team';
     /**
-     * Singles: the lifecycle status — 'running' at dispatch, flipped terminal
+     * Singles: the lifecycle status — 'queued' while a START waits for a
+     * running-track slot (P46b), 'running' at dispatch, flipped terminal
      * by the task-end CLOSER progress events (promoted → 'completed',
      * discarded → 'cancelled', round_failed → 'failed'; Stage-2 r1 Codex
      * MED-2 — no production TASK_LIFECYCLE dispatch ever carries a terminal
@@ -451,6 +457,24 @@ export interface QueuedTask {
  * resolves the most recent question and re-routes through
  * `classifyPlannerPrompt` with the full `clarifications` array.
  */
+/**
+ * Metadata stored on PendingClarification when confirmBeforeStart prompts the user.
+ */
+export interface TaskStartConfirmationState {
+    kind?: 'single' | 'team';
+    agent?: LocalExecutorAgentKind;
+    decision: PlannerDecision;
+    brief: string;
+    attachments?: ImageAttachment[];
+    teamSpec?: {
+        workItems: WorkItemInput[];
+        briefsByTrackIndex: Map<number, string>;
+        groupIdempotencyKey: string;
+        decomposeAttachments?: ImageAttachment[];
+        decomposeAttachmentPaths?: string[];
+        singleFallbackBrief?: string;
+    };
+}
 export interface PendingClarification {
     originalPrompt: string;
     rounds: Array<{
@@ -474,6 +498,12 @@ export interface PendingClarification {
      * both resolve to the correct ref. Grows by exactly this turn's `imagePaths` each turn.
      */
     attachmentPaths?: string[];
+    /**
+     * Task start confirmation metadata when `confirmBeforeStart: true`.
+     * When present, user's subsequent input is intercepted as confirmation ("yes" starts,
+     * anything else cancels) without calling the planner classifier.
+     */
+    startConfirmation?: TaskStartConfirmationState;
 }
 /**
  * A1a #3/#4 — one numbered choice in a `PendingPlannerOffer`. Contract-ready
@@ -560,6 +590,24 @@ export interface PendingApplyConflict {
     }>;
     /** True when this menu follows the one automatic retry's own promote failure. */
     readonly autoRetried: boolean;
+    /**
+     * P46b §3.10 — `group` when the failed promote was a team's (`taskId` is then
+     * the `taskGroupId`; retry reissues the team from its retained launch spec).
+     * Absent = a single task (P46a).
+     */
+    readonly kind?: 'single' | 'group';
+    /** P46b §3.9 — counts only: how many paths each cause failed. */
+    readonly counts?: {
+        readonly sessionTask: number;
+        readonly external: number;
+        readonly writeErrors: number;
+    };
+    /**
+     * P46b §3.9 (ID-20) — the engine retry prompt's gate id once
+     * `openApplyRetryOffer` succeeded: the phone can answer this menu, and it is
+     * resolved with the user's choice. Absent = the desktop-local menu only.
+     */
+    readonly offerGateId?: string;
     /** The `advisory` conversation entry that rendered the numbered options. */
     readonly conversationEntryId: string;
     /** The composed retry brief (original request + files changed since + reviewed contents). */
@@ -680,6 +728,11 @@ export interface LiveProgress {
     updatedAt: string;
     /** ISO — when THIS busy window opened; the wall-clock timer anchor. */
     startedAt: string;
+    /**
+     * P46b §3.7 — the task this line belongs to (from `emitProgressForTask`);
+     * undefined for a classify/familiarize/advisory window.
+     */
+    taskId?: string;
     /**
      * The per-TASK origin epoch of the event that opened/last-refreshed this window
      * (§2/§3). Undefined ONLY for the direct-dispatched classify/familiarize windows
@@ -781,6 +834,13 @@ export interface OrchestrationState {
      * Companion sessions never dispatch `TASK_PROGRESS`, so this stays null.
      */
     progress: LiveProgress | null;
+    /**
+     * `[ADDITIVE WIDENING — P46b §3.7]` One live line per single task that is
+     * busy right now, keyed by task id, under the same epoch/closer rules as
+     * `progress` applied per task. Team tracks are excluded (their rows live in
+     * `MultiTrackStatusNode`). Optional so pre-P46b state literals stay valid.
+     */
+    progressByTask?: Map<string, LiveProgress>;
     /**
      * `[ADDITIVE WIDENING — /reviewer-setup wizard, 2026-06-29]` The active
      * interactive reviewer-panel setup modal, or `null` when no wizard is open
@@ -792,6 +852,12 @@ export interface OrchestrationState {
      * keyboard focus. Non-team / Companion / CP-1.a sessions never open it.
      */
     reviewerWizard: ReviewerWizardState | null;
+    /**
+     * `/implementor-setup` interactive wizard. OPEN sets the state; cleared
+     * on save/cancel (`IMPLEMENTOR_WIZARD_CLOSE`). While non-null,
+     * `<OrchestrationApp>` renders `<ImplementorSetupWizard>` in place of `<InputBar>`.
+     */
+    implementorWizard: ImplementorWizardState | null;
     /**
      * `[ADDITIVE WIDENING — O1 C1 (#652)]` per
      * PHASE-O1-C1-SAFETY-OBSERVABILITY-DESIGN.md §3.1 item 1: the shell used to
@@ -876,6 +942,13 @@ export interface ReviewerWizardState {
     installedAgents: Array<'CLAUDE' | 'GEMINI' | 'CODEX' | 'ANTIGRAVITY'>;
     currentSeats: ReviewerAgentSpec[] | null;
 }
+/**
+ * `/implementor-setup` interactive wizard state.
+ */
+export interface ImplementorWizardState {
+    installedAgents: AgentKind[];
+    currentPreference: ImplementorPreference;
+}
 /**
  * §5.1 LOCK lines 502-513. Discriminated union over every state
  * transition the reducer covers. `attachedTaskId` / `ATTACH` / `DETACH`
@@ -917,6 +990,7 @@ export type OrchestrationAction = {
     decision: PlannerDecision;
     taskId?: string;
     brainstorm?: BrainstormContextMetadata;
+    startConfirmation?: TaskStartConfirmationState;
 } | {
     type: 'EVENT_RECEIVED';
     event: EventStreamEntry;
@@ -967,6 +1041,22 @@ export type OrchestrationAction = {
 } | {
     type: 'CLEAR_PENDING_APPLY_CONFLICT';
     taskId?: string;
+} | {
+    type: 'APPLY_CONFLICT_OFFER_OPENED';
+    taskId: string;
+    gateId: string;
+} | {
+    type: 'SINGLE_TASK_QUEUED';
+    taskId: string;
+    agentKind: string;
+    queuedAt: string;
+} | {
+    type: 'SINGLE_TASK_QUEUE_ENDED';
+    taskId: string;
+    reason: string;
+} | {
+    type: 'GATE_PROMPT_ACTIVATED';
+    promptEntryId: string;
 } | {
     type: 'STRUCTURAL_SUMMARY_GENERATED';
     summary: StructuralSummary;
@@ -1071,6 +1161,11 @@ export type OrchestrationAction = {
     wizard: ReviewerWizardState;
 } | {
     type: 'REVIEWER_WIZARD_CLOSE';
+} | {
+    type: 'IMPLEMENTOR_WIZARD_OPEN';
+    wizard: ImplementorWizardState;
+} | {
+    type: 'IMPLEMENTOR_WIZARD_CLOSE';
 } | {
     type: 'AUDIT_FLAG_INDEX_RETAINED';
     index: AuditFlagIndex;

package/node_modules/@quantiya/codevibe-core/dist/planner/types.d.ts

@@ -19,14 +19,14 @@ export declare const SessionContextSchema: z.ZodObject<{
     sessionId: string;
     userId: string;
     tier: "FREE" | "PRO" | "MAX";
-    currentTaskState: "none" | "merge_gate_pending" | "in_progress" | "awaiting_user" | "awaiting_review";
+    currentTaskState: "none" | "in_progress" | "awaiting_user" | "awaiting_review" | "merge_gate_pending";
     structuralSummaryDigest: string;
     recentEventCount: number;
 }, {
     sessionId: string;
     userId: string;
     tier: "FREE" | "PRO" | "MAX";
-    currentTaskState: "none" | "merge_gate_pending" | "in_progress" | "awaiting_user" | "awaiting_review";
+    currentTaskState: "none" | "in_progress" | "awaiting_user" | "awaiting_review" | "merge_gate_pending";
     structuralSummaryDigest: string;
     recentEventCount: number;
 }>;

package/node_modules/@quantiya/codevibe-core/dist/substrate/command-runner.d.ts

@@ -1,5 +1,6 @@
 import type { CommandResult, CommandRunner, RunnerProc } from './types';
 import type { WorkspaceRootAuthority } from '../local-executor/workspace-authority';
+import type { HostDescendantReap } from '../local-executor/descendant-reaper';
 /**
  * The production `CommandRunner` — runs `docker` / `sandbox-exec` via
  * `node:child_process`. No shell is used (argv is passed directly to
@@ -18,5 +19,6 @@ export declare class ChildProcessCommandRunner implements CommandRunner {
         cwd?: string;
         cwdAuthority?: WorkspaceRootAuthority;
         launchPathAuthorities?: readonly WorkspaceRootAuthority[];
+        descendantReap?: HostDescendantReap;
     }): RunnerProc;
 }

package/node_modules/@quantiya/codevibe-core/dist/substrate/types.d.ts

@@ -1,5 +1,6 @@
 import type { Readable, Writable } from "node:stream";
 import type { WorkspaceRootAuthority } from "../local-executor/workspace-authority";
+import type { HostDescendantReap } from "../local-executor/descendant-reaper";
 /**
  * Isolation backend for a substrate. `firecracker` is [DEF →
  * A3-after-C2] — declared so the union admits the hosted runner without
@@ -173,6 +174,8 @@ export interface SubstrateHandle {
         stdinTty: boolean;
         timeoutMs?: number;
         signal?: AbortSignal;
+        /** P46b ID-31 — the descendant sweep the process host runs if the desktop dies first. */
+        descendantReap?: HostDescendantReap;
     }): Promise<SubstrateProc>;
     /** Idempotent; MUST destroy the sandbox + its fs view. */
     teardown(): Promise<void>;
@@ -276,5 +279,7 @@ export interface CommandRunner {
          * they are not its cwd (for example Claude's private scratch root).
          */
         launchPathAuthorities?: readonly WorkspaceRootAuthority[];
+        /** P46b ID-31 — the descendant sweep the process host runs if the desktop dies first. */
+        descendantReap?: HostDescendantReap;
     }): RunnerProc;
 }

package/node_modules/@quantiya/codevibe-core/dist/substrate-launch/engage-substrate.d.ts

@@ -41,6 +41,8 @@ export interface EngageSubstrateInput {
      * legacy behavior for every existing caller.
      */
     requireConfined?: boolean;
+    /** F-P46a-4 — the implementor spawn's process-tree id (descendant reaping marker). */
+    processTreeId?: string;
     /** Ladder deps (injectable for tests). */
     ladderDeps?: FallbackLadderDeps;
     /** Broker upstream client override (tests inject a stub; default real fetch). */

package/node_modules/@quantiya/codevibe-core/dist/tool-activity/types.d.ts

@@ -66,11 +66,11 @@ export declare const ToolActivityGroupSchema: z.ZodObject<{
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     count: number;
-    tool: string;
     occurrences: {
         id: string;
         ts: string;
     }[];
+    tool: string;
     target?: string | undefined;
     detail?: {
         i: number;
@@ -78,11 +78,11 @@ export declare const ToolActivityGroupSchema: z.ZodObject<{
     }[] | undefined;
 }, {
     count: number;
-    tool: string;
     occurrences: {
         id: string;
         ts: string;
     }[];
+    tool: string;
     target?: string | undefined;
     detail?: {
         i: number;
@@ -130,11 +130,11 @@ export declare const ToolActivityManifestSchema: z.ZodObject<{
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         count: number;
-        tool: string;
         occurrences: {
             id: string;
             ts: string;
         }[];
+        tool: string;
         target?: string | undefined;
         detail?: {
             i: number;
@@ -142,11 +142,11 @@ export declare const ToolActivityManifestSchema: z.ZodObject<{
         }[] | undefined;
     }, {
         count: number;
-        tool: string;
         occurrences: {
             id: string;
             ts: string;
         }[];
+        tool: string;
         target?: string | undefined;
         detail?: {
             i: number;
@@ -157,11 +157,11 @@ export declare const ToolActivityManifestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     groups: {
         count: number;
-        tool: string;
         occurrences: {
             id: string;
             ts: string;
         }[];
+        tool: string;
         target?: string | undefined;
         detail?: {
             i: number;
@@ -176,11 +176,11 @@ export declare const ToolActivityManifestSchema: z.ZodObject<{
 }, {
     groups: {
         count: number;
-        tool: string;
         occurrences: {
             id: string;
             ts: string;
         }[];
+        tool: string;
         target?: string | undefined;
         detail?: {
             i: number;
@@ -247,11 +247,11 @@ export declare const ToolActivityOutboxEnvelopeSchema: z.ZodObject<{
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
             count: number;
-            tool: string;
             occurrences: {
                 id: string;
                 ts: string;
             }[];
+            tool: string;
             target?: string | undefined;
             detail?: {
                 i: number;
@@ -259,11 +259,11 @@ export declare const ToolActivityOutboxEnvelopeSchema: z.ZodObject<{
             }[] | undefined;
         }, {
             count: number;
-            tool: string;
             occurrences: {
                 id: string;
                 ts: string;
             }[];
+            tool: string;
             target?: string | undefined;
             detail?: {
                 i: number;
@@ -274,11 +274,11 @@ export declare const ToolActivityOutboxEnvelopeSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         groups: {
             count: number;
-            tool: string;
             occurrences: {
                 id: string;
                 ts: string;
             }[];
+            tool: string;
             target?: string | undefined;
             detail?: {
                 i: number;
@@ -293,11 +293,11 @@ export declare const ToolActivityOutboxEnvelopeSchema: z.ZodObject<{
     }, {
         groups: {
             count: number;
-            tool: string;
             occurrences: {
                 id: string;
                 ts: string;
             }[];
+            tool: string;
             target?: string | undefined;
             detail?: {
                 i: number;
@@ -317,11 +317,11 @@ export declare const ToolActivityOutboxEnvelopeSchema: z.ZodObject<{
     manifest: {
         groups: {
             count: number;
-            tool: string;
             occurrences: {
                 id: string;
                 ts: string;
             }[];
+            tool: string;
             target?: string | undefined;
             detail?: {
                 i: number;
@@ -343,11 +343,11 @@ export declare const ToolActivityOutboxEnvelopeSchema: z.ZodObject<{
     manifest: {
         groups: {
             count: number;
-            tool: string;
             occurrences: {
                 id: string;
                 ts: string;
             }[];
+            tool: string;
             target?: string | undefined;
             detail?: {
                 i: number;

package/node_modules/@quantiya/codevibe-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantiya/codevibe-core",
-  "version": "2.0.38",
+  "version": "2.0.40",
   "description": "Core library for CodeVibe plugins - shared keychain, crypto, AppSync, and auth functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantiya/codevibe-claude-plugin",
-  "version": "2.0.43",
+  "version": "2.0.45",
   "description": "Control Claude Code from your iPhone and Android — real-time sync, approve file edits, send prompts by voice. Part of CodeVibe.",
   "main": "dist/server.js",
   "codevibe": {
@@ -48,7 +48,7 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@quantiya/codevibe-core": "^2.0.38",
+    "@quantiya/codevibe-core": "^2.0.40",
     "@quantiya/quorum-core": "^1.0.1",
     "dotenv": "^16.6.1",
     "express": "^5.1.0",