gsd-pi 2.79.0 → 2.80.0-dev.b62439b9f

package/src/resources/extensions/gsd/auto/workflow-sidecar-queue.ts

@@ -0,0 +1,46 @@
+// Project/App: GSD-2
+// File Purpose: Sidecar queue scheduling and dequeue adapter for auto-mode loop.
+
+import type { SidecarItem } from "./session.js";
+
+export interface SidecarDequeuePayload extends Record<string, unknown> {
+  kind: SidecarItem["kind"];
+  unitType: string;
+  unitId: string;
+}
+
+export interface DequeueSidecarItemInput {
+  queue: SidecarItem[];
+  executionGraphEnabled: boolean;
+  scheduleQueue: (queue: SidecarItem[]) => Promise<SidecarItem[]>;
+  warnSchedulingFailure: (message: string) => void;
+  logDequeue: (payload: SidecarDequeuePayload) => void;
+  emitDequeue: (payload: SidecarDequeuePayload) => void;
+}
+
+export async function dequeueSidecarItem(
+  input: DequeueSidecarItemInput,
+): Promise<SidecarItem | undefined> {
+  if (input.queue.length === 0) return undefined;
+
+  if (input.executionGraphEnabled && input.queue.length > 1) {
+    try {
+      const scheduledQueue = await input.scheduleQueue(input.queue);
+      input.queue.splice(0, input.queue.length, ...scheduledQueue);
+    } catch (err) {
+      input.warnSchedulingFailure(err instanceof Error ? err.message : String(err));
+    }
+  }
+
+  const sidecarItem = input.queue.shift();
+  if (!sidecarItem) return undefined;
+
+  const payload = {
+    kind: sidecarItem.kind,
+    unitType: sidecarItem.unitType,
+    unitId: sidecarItem.unitId,
+  };
+  input.logDequeue(payload);
+  input.emitDequeue(payload);
+  return sidecarItem;
+}

package/src/resources/extensions/gsd/auto/workflow-turn-reporter.ts

@@ -0,0 +1,68 @@
+// Project/App: GSD-2
+// File Purpose: Thin adapter for workflow turn observer reporting.
+
+import type {
+  FailureClass,
+  TurnStatus,
+  UokTurnObserver,
+} from "../uok/contracts.js";
+
+export interface WorkflowTurnReporterInput {
+  observer?: UokTurnObserver;
+  traceId: string;
+  turnId: string;
+  iteration: number;
+  basePath: string;
+  startedAt: string;
+  clearCurrentTurn: () => void;
+  now?: () => string;
+}
+
+export interface WorkflowTurnFinishInput {
+  status: TurnStatus;
+  failureClass?: FailureClass;
+  error?: string;
+  unitType?: string;
+  unitId?: string;
+}
+
+export interface WorkflowTurnReporter {
+  start(): void;
+  finish(input: WorkflowTurnFinishInput): void;
+}
+
+export function createWorkflowTurnReporter(input: WorkflowTurnReporterInput): WorkflowTurnReporter {
+  let finished = false;
+  const now = input.now ?? (() => new Date().toISOString());
+
+  return {
+    start(): void {
+      input.observer?.onTurnStart({
+        traceId: input.traceId,
+        turnId: input.turnId,
+        iteration: input.iteration,
+        basePath: input.basePath,
+        startedAt: input.startedAt,
+      });
+    },
+
+    finish(finishInput: WorkflowTurnFinishInput): void {
+      if (finished) return;
+      finished = true;
+      input.observer?.onTurnResult({
+        traceId: input.traceId,
+        turnId: input.turnId,
+        iteration: input.iteration,
+        unitType: finishInput.unitType,
+        unitId: finishInput.unitId,
+        status: finishInput.status,
+        failureClass: finishInput.failureClass ?? "none",
+        phaseResults: [],
+        error: finishInput.error,
+        startedAt: input.startedAt,
+        finishedAt: now(),
+      });
+      input.clearCurrentTurn();
+    },
+  };
+}

package/src/resources/extensions/gsd/auto/workflow-unit-dispatch.ts

@@ -0,0 +1,89 @@
+// Project/App: GSD-2
+// File Purpose: Unit dispatch contract adapter for auto-mode loop.
+
+import type { SidecarItem } from "./session.js";
+import type {
+  IterationContext,
+  IterationData,
+  LoopState,
+  PhaseResult,
+} from "./types.js";
+import { ExecutionGraphScheduler } from "../uok/execution-graph.js";
+import type { UokGraphNode } from "../uok/contracts.js";
+import { runUnitPhase } from "./phases.js";
+import { decideDispatchNodeKind } from "./workflow-kernel.js";
+
+export type DispatchContract = "legacy-direct" | "uok-scheduler";
+
+export type UnitPhaseResult = PhaseResult<{
+  unitStartedAt?: number;
+  requestDispatchedAt?: number;
+}>;
+
+export interface UnitDispatchScheduler {
+  registerHandler(
+    kind: UokGraphNode["kind"],
+    handler: (node: UokGraphNode) => Promise<void>,
+  ): void;
+  run(nodes: UokGraphNode[], options: { parallel: false; maxWorkers: 1 }): Promise<unknown>;
+}
+
+export interface RunUnitPhaseViaContractDeps {
+  runUnitPhase: (
+    ic: IterationContext,
+    iterData: IterationData,
+    loopState: LoopState,
+    sidecarItem?: SidecarItem,
+  ) => Promise<UnitPhaseResult>;
+  createScheduler: () => UnitDispatchScheduler;
+}
+
+export async function runUnitPhaseViaContract(
+  dispatchContract: DispatchContract,
+  ic: IterationContext,
+  iterData: IterationData,
+  loopState: LoopState,
+  sidecarItem: SidecarItem | undefined,
+  deps: RunUnitPhaseViaContractDeps,
+): Promise<UnitPhaseResult> {
+  if (dispatchContract === "legacy-direct") {
+    return deps.runUnitPhase(ic, iterData, loopState, sidecarItem);
+  }
+
+  const scheduler = deps.createScheduler();
+  let outcome: UnitPhaseResult | null = null;
+  const executeNode = async (): Promise<void> => {
+    outcome = await deps.runUnitPhase(ic, iterData, loopState, sidecarItem);
+  };
+  const kinds: UokGraphNode["kind"][] = [
+    "unit",
+    "hook",
+    "subagent",
+    "team-worker",
+    "verification",
+    "reprocess",
+  ];
+  for (const kind of kinds) scheduler.registerHandler(kind, executeNode);
+
+  const nodeId = `dispatch:${ic.iteration}:${iterData.unitType}:${iterData.unitId}`;
+  await scheduler.run([
+    {
+      id: nodeId,
+      kind: decideDispatchNodeKind(iterData.unitType, sidecarItem?.kind),
+      dependsOn: [],
+      metadata: {
+        unitType: iterData.unitType,
+        unitId: iterData.unitId,
+      },
+    },
+  ], { parallel: false, maxWorkers: 1 });
+
+  return outcome ?? { action: "break", reason: "scheduler-dispatch-missing-result" };
+}
+
+export function createExecutionGraphUnitDispatchDeps(): RunUnitPhaseViaContractDeps {
+  return {
+    runUnitPhase: async (...args) => runUnitPhase(...args),
+    createScheduler: () => new ExecutionGraphScheduler(),
+  };
+}

package/src/resources/extensions/gsd/auto/workflow-worker-heartbeat.ts

@@ -0,0 +1,38 @@
+// Project/App: GSD-2
+// File Purpose: Best-effort worker heartbeat adapter for auto-mode loop.
+
+export interface WorkerHeartbeatSession {
+  workerId?: string | null;
+  currentMilestoneId?: string | null;
+  milestoneLeaseToken?: number | null;
+}
+
+export interface MaintainWorkerHeartbeatDeps {
+  heartbeatAutoWorker: (workerId: string) => void;
+  refreshMilestoneLease: (
+    workerId: string,
+    milestoneId: string,
+    fencingToken: number,
+  ) => boolean;
+  logHeartbeatFailure: (err: unknown) => void;
+}
+
+export function maintainWorkerHeartbeat(
+  session: WorkerHeartbeatSession,
+  deps: MaintainWorkerHeartbeatDeps,
+): void {
+  if (!session.workerId) return;
+
+  try {
+    deps.heartbeatAutoWorker(session.workerId);
+    if (session.currentMilestoneId && session.milestoneLeaseToken) {
+      deps.refreshMilestoneLease(
+        session.workerId,
+        session.currentMilestoneId,
+        session.milestoneLeaseToken,
+      );
+    }
+  } catch (err) {
+    deps.logHeartbeatFailure(err);
+  }
+}

package/src/resources/extensions/gsd/auto-artifact-paths.ts

@@ -159,9 +159,9 @@ export function diagnoseExpectedArtifact(
       }
       return `${relSliceFile(base, mid, sid!, "RESEARCH")} (slice research)`;
     case "plan-slice":
-      return `${relSliceFile(base, mid, sid!, "PLAN")} (slice plan)`;
+      return `${relSliceFile(base, mid, sid!, "PLAN")} plus tasks/T##-PLAN.md files (slice plan and task plans)`;
     case "refine-slice":
-      return `${relSliceFile(base, mid, sid!, "PLAN")} (refined slice plan from sketch)`;
+      return `${relSliceFile(base, mid, sid!, "PLAN")} plus tasks/T##-PLAN.md files (refined slice plan and task plans)`;
     case "execute-task": {
       return `Task ${tid} marked [x] in ${relSliceFile(base, mid, sid!, "PLAN")} + summary written`;
     }

package/src/resources/extensions/gsd/auto-dashboard.ts

@@ -583,6 +583,10 @@ export function updateProgressWidget(
     : state.activeSlice;
   const task = state.activeTask;
 
+  if (mid) {
+    updateSliceProgressCache(accessors.getBasePath(), mid.id, slice?.id);
+  }
+
   // Cache git branch at widget creation time (not per render)
   let cachedBranch: string | null = null;
   try { cachedBranch = getCurrentBranch(accessors.getBasePath()); } catch (err) { /* not in git repo */

package/src/resources/extensions/gsd/auto-dispatch.ts

@@ -692,6 +692,7 @@ export const DISPATCH_RULES: DispatchRule[] = [
       const contextFile = resolveMilestoneFile(basePath, mid, "CONTEXT");
       const hasContext = !!(contextFile && (await loadFile(contextFile)));
       if (hasContext) return null; // fall through to next rule
+      if (prefs?.planning_depth === "deep") return null;
       // H6 fix (#4973): keep the non-deep auto-mode bypass, but do not
       // pre-verify deep planning's user-facing milestone approval gate.
       if (shouldBypassMilestoneDepthGateInAuto(prefs)) {