@quantiya/codevibe-claude-plugin 2.0.42 → 2.0.44

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

@@ -14,3 +14,10 @@ export declare function reducer(state: OrchestrationState, action: Orchestration
  * task-start size heuristic.
  */
 export declare function hasRunningSingleTask(state: OrchestrationState): boolean;
+/**
+ * P46a C3 — the apply-conflict menu's reply hint. A digit answers it only while
+ * no review gate is awaiting a number (the gate composer takes digits first);
+ * `/task retry <n>` / `/task discard <n>` answer it unambiguously at any time.
+ * Slash commands keep the menu open; any other text closes it (Stage 1 r1 F3).
+ */
+export declare const APPLY_CONFLICT_MENU_HINT = "Reply with a number 1-2 (or /task retry <n> / /task discard <n> while another review is open); other text closes this menu.";

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

@@ -52,6 +52,11 @@ export interface ContinuationCliDeps {
     } | null>;
     /** Resolve the active-task request context (loop state). `null` if no active task. */
     getActiveRequestContext?: () => ActiveContinuationRequestContext | null;
+    /**
+     * P46a B1 — the refusal text when `getActiveRequestContext` is null (several
+     * tasks running a round → the `#n` candidates; none → the plain message).
+     */
+    explainNoActiveRequest?: () => string;
     /**
      * PHASE-CP-10-MIN (#585) #C10M-9/11 — `/continue accept <target>`: the
      * rescue/headless path. The entrypoint wires this to call

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-label.d.ts

@@ -0,0 +1,25 @@
+import type { OrchestrationState } from './types';
+export declare function shortTaskId(taskId: string): string;
+/**
+ * The label for `taskId` (a single task id, a team child task id, a
+ * `taskGroupId`, or a `group:<id>` gate id).
+ */
+export declare function taskLabel(state: Pick<OrchestrationState, 'taskOrdinals' | 'team'>, taskId: string): string;
+/**
+ * Resolve `#n` / `n` (a single task or a team group number) back to the id
+ * that holds it, or null. Used by `/task focus <n>`.
+ */
+export declare function taskIdForOrdinal(state: Pick<OrchestrationState, 'taskOrdinals'>, ordinal: number): string | null;
+/**
+ * P46a (F-P46a-6) — the advisory the shell prints under a gate prompt whose
+ * task already ENDED on this side as `discarded` (its implementor round failed
+ * here — typically the result's submit lost its response in a network cut —
+ * while the engine still had the result, reviewed it and raised the gate).
+ * Accepting such a gate applies nothing; the user must know before deciding.
+ * Returns null for a live task or any other outcome.
+ */
+export declare function endedTaskAdvisory(described: ReadonlyArray<{
+    taskId: string;
+    label: string;
+    outcome: string;
+}>, taskId: string): string | null;

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;
@@ -427,6 +432,7 @@ export type ConversationEntry = {
     panel: {
         variant: 'prompt';
         envelope: GatePromptEnvelope;
+        taskLabel?: string;
     } | {
         variant: 'summary';
         reviewSummary: ReviewSummaryPanelModel;
@@ -450,6 +456,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<{
@@ -473,6 +497,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
@@ -522,6 +552,51 @@ export interface PendingPlannerOffer {
     /** §13 Option-2 — ordered-with-dups carried paths for the number-based chip rewrite. */
     attachmentPaths?: string[];
 }
+/**
+ * P46a D1 — one in-session task number. Assigned by the reducer from ONE
+ * per-session counter (`nextTaskOrdinal`) at the START-confirmed point of a
+ * single task (`QuorumLoop.startTask`) or when `createTaskGroup` returns for a
+ * team (`launchTeamFromWorkItems`), so both paths share the numbering. A team
+ * group is one number (its child tasks render `#n.1`, `#n.2` via `state.team`).
+ * `retryOf` links a `#n retry` task (P46a C2/C3) to the `apply_failed` original.
+ * In-memory only: production has no session resume (design §2.4/A8), so every
+ * launch is a new session with its own numbering; nothing is persisted.
+ */
+export interface TaskOrdinalRecord {
+    readonly ordinal: number;
+    readonly kind: 'single' | 'group';
+    readonly retryOf?: string;
+}
+/**
+ * P46a C3 — the desktop-local "could not apply" menu. Modeled on
+ * `pendingPlannerOffer` (a local numbered reply resolves it; free text clears
+ * it) but NEVER mirrored to mobile — the durable, mobile-answerable form is
+ * P46b A5 (HD-10). Not durable: a desktop relaunch drops it with its session
+ * (the failed task's shadow is already discarded; the durable `apply_failed`
+ * outcome stands).
+ */
+export interface PendingApplyConflict {
+    /** The `apply_failed` task the menu is about. */
+    readonly taskId: string;
+    /** Its rendered label (`#n`, `#n retry`, or the short-id fallback). */
+    readonly taskLabel: string;
+    /** Workspace-relative paths + their attribution (paths only — never content). */
+    readonly conflicts: ReadonlyArray<{
+        readonly path: string;
+        readonly cause: 'session-task' | 'external' | 'write-error';
+        /** Rendered label of the session task whose promote changed the path. */
+        readonly byTaskLabel?: string;
+    }>;
+    /** True when this menu follows the one automatic retry's own promote failure. */
+    readonly autoRetried: boolean;
+    /** The `advisory` conversation entry that rendered the numbered options. */
+    readonly conversationEntryId: string;
+    /** The composed retry brief (original request + files changed since + reviewed contents). */
+    readonly retryBrief: string;
+    /** The ROOT user request the retry carries (Stage 1 r3 F1: web access and `/status` follow the user's own words). */
+    readonly request: string;
+    readonly agent: AgentKind;
+}
 /**
  * [ADDITIVE WIDENING — CP-12 W3, per PHASE-CP-12-DESIGN.md §3.5 "minimal
  * multi-track status node; rich UX is #469"]. Per-track lifecycle state as the
@@ -679,6 +754,32 @@ export interface OrchestrationState {
      * source of truth.
      */
     pendingPlannerOffer: PendingPlannerOffer | null;
+    /**
+     * `[ADDITIVE WIDENING — P46a D1]` The in-session task numbers, keyed by
+     * single-task id or team `taskGroupId`. Reducer-owned (`TASK_ORDINAL_ASSIGNED`)
+     * from the single per-session `nextTaskOrdinal` counter; never persisted.
+     */
+    taskOrdinals: Map<string, TaskOrdinalRecord>;
+    /** `[ADDITIVE WIDENING — P46a D1]` The next number to assign (starts at 1). */
+    nextTaskOrdinal: number;
+    /**
+     * `[ADDITIVE WIDENING — P46a C3]` The OPEN desktop-local apply-conflict menus,
+     * keyed by the failed task's id, in presentation order (empty by default).
+     * Set by `APPLY_CONFLICT_PRESENTED` (a second task's menu never replaces the
+     * first — Stage 1 r2 F2); `/task retry|discard <n>` answers one by number, a
+     * bare digit only when exactly one is open; other desktop text closes them
+     * (`CLEAR_PENDING_APPLY_CONFLICT`). Never mirrored to mobile (P46b A5).
+     */
+    pendingApplyConflicts: ReadonlyMap<string, PendingApplyConflict>;
+    /**
+     * `[ADDITIVE WIDENING — P46a D1]` The gate-prompt entry the desktop composer,
+     * its pinned card and a typed digit currently target (null when no open gate
+     * is answerable). Reducer-owned and STICKY (Stage 1 r2 F1): it stays on the
+     * current gate while that gate is answerable; only when it leaves the
+     * answerable phases does the oldest answerable open gate take over — a
+     * rolled-back older gate waits its turn instead of taking the digits back.
+     */
+    activeGatePromptId: string | null;
     inputHistory: string[];
     /**
      * `[ADDITIVE WIDENING — CP-1.d]` per `PHASE-CP-1-D-DESIGN.md` §4.8
@@ -720,6 +821,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
@@ -804,6 +911,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`
@@ -845,6 +959,7 @@ export type OrchestrationAction = {
     decision: PlannerDecision;
     taskId?: string;
     brainstorm?: BrainstormContextMetadata;
+    startConfirmation?: TaskStartConfirmationState;
 } | {
     type: 'EVENT_RECEIVED';
     event: EventStreamEntry;
@@ -884,6 +999,17 @@ export type OrchestrationAction = {
     offer: PendingPlannerOffer;
 } | {
     type: 'CLEAR_PENDING_PLANNER_OFFER';
+} | {
+    type: 'TASK_ORDINAL_ASSIGNED';
+    taskId: string;
+    kind: 'single' | 'group';
+    retryOf?: string;
+} | {
+    type: 'APPLY_CONFLICT_PRESENTED';
+    menu: Omit<PendingApplyConflict, 'conversationEntryId'>;
+} | {
+    type: 'CLEAR_PENDING_APPLY_CONFLICT';
+    taskId?: string;
 } | {
     type: 'STRUCTURAL_SUMMARY_GENERATED';
     summary: StructuralSummary;
@@ -988,6 +1114,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/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.37",
+  "version": "2.0.39",
   "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.42",
+  "version": "2.0.44",
   "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.37",
+    "@quantiya/codevibe-core": "^2.0.39",
     "@quantiya/quorum-core": "^1.0.1",
     "dotenv": "^16.6.1",
     "express": "^5.1.0",