@unbrained/pm-web 2026.6.4 → 2026.6.13-2

package/public/src/views/plan-execution.js

@@ -0,0 +1,191 @@
+const DONE_STATUSES = new Set(['done', 'completed', 'closed']);
+const BLOCKED_STATUSES = new Set(['blocked']);
+function normalizeStatus(status) {
+    const value = (status || 'pending').trim().toLowerCase().replace(/\s+/g, '_');
+    return value || 'pending';
+}
+function normalizeStepRef(step, index) {
+    const candidate = (step.ref || step.id || '').trim();
+    return candidate || `step-${index + 1}`;
+}
+function normalizeDependsOn(step) {
+    const raw = Array.isArray(step.dependsOn)
+        ? step.dependsOn
+        : (Array.isArray(step.depends_on) ? step.depends_on : []);
+    const unique = new Set();
+    for (const dep of raw) {
+        const trimmed = String(dep || '').trim();
+        if (trimmed)
+            unique.add(trimmed);
+    }
+    return Array.from(unique);
+}
+function formatStepLine(step) {
+    return `- [${step.ref}] ${step.title}`;
+}
+function formatWaitReason(step) {
+    const blockers = [
+        ...step.incompleteDependencies,
+        ...step.unresolvedDependencies.map(dep => `${dep} (missing)`),
+    ];
+    if (blockers.length === 0)
+        return 'waiting';
+    return `waiting on ${blockers.join(', ')}`;
+}
+function stepDependencyBlockers(step) {
+    return [
+        ...step.incompleteDependencies,
+        ...step.unresolvedDependencies.map(dep => `${dep} (missing)`),
+    ];
+}
+export function buildPlanExecutionSnapshot(steps) {
+    const normalized = steps.map((step, index) => {
+        const status = normalizeStatus(step.status);
+        return {
+            ref: normalizeStepRef(step, index),
+            title: (step.title || '(untitled)').trim() || '(untitled)',
+            description: (step.description || '').trim(),
+            status,
+            blockedReason: (step.blockedReason || step.blocked_reason || '').trim(),
+            dependsOn: normalizeDependsOn(step),
+            unresolvedDependencies: [],
+            incompleteDependencies: [],
+            isDone: DONE_STATUSES.has(status),
+            isBlocked: BLOCKED_STATUSES.has(status),
+            original: step,
+        };
+    });
+    const stepByRef = {};
+    for (const step of normalized) {
+        if (!stepByRef[step.ref])
+            stepByRef[step.ref] = step;
+    }
+    const completedRefs = new Set(normalized.filter(step => step.isDone).map(step => step.ref));
+    for (const step of normalized) {
+        if (step.isDone || step.isBlocked)
+            continue;
+        for (const dep of step.dependsOn) {
+            if (!stepByRef[dep]) {
+                step.unresolvedDependencies.push(dep);
+            }
+            else if (!completedRefs.has(dep)) {
+                step.incompleteDependencies.push(dep);
+            }
+        }
+    }
+    const readySteps = [];
+    const waitingSteps = [];
+    const blockedStepDetails = [];
+    for (const step of normalized) {
+        if (step.isDone)
+            continue;
+        if (step.isBlocked) {
+            blockedStepDetails.push(step);
+            continue;
+        }
+        if (step.incompleteDependencies.length === 0 && step.unresolvedDependencies.length === 0) {
+            readySteps.push(step);
+        }
+        else {
+            waitingSteps.push(step);
+        }
+    }
+    const totalSteps = normalized.length;
+    const completedSteps = normalized.filter(step => step.isDone).length;
+    const blockedSteps = blockedStepDetails.length;
+    const completionPct = totalSteps > 0 ? Math.round((completedSteps / totalSteps) * 100) : 0;
+    return {
+        totalSteps,
+        completedSteps,
+        blockedSteps,
+        waitingSteps,
+        readySteps,
+        blockedStepDetails,
+        allSteps: normalized,
+        stepByRef,
+        completionPct,
+        nextReadyStep: readySteps[0] || null,
+    };
+}
+export function buildPlanAgentBrief(plan, snapshot) {
+    const title = (plan.title || plan.id || '(untitled)').trim();
+    const lines = [
+        '# Plan execution brief',
+        `Plan: ${title}`,
+    ];
+    if (plan.id)
+        lines.push(`Plan ID: ${plan.id}`);
+    if (plan.status)
+        lines.push(`Status: ${plan.status}`);
+    if (plan.scope)
+        lines.push(`Scope: ${plan.scope}`);
+    if (plan.description)
+        lines.push('', 'Description:', plan.description.trim());
+    lines.push('', 'Execution summary:', `- Completed: ${snapshot.completedSteps}/${snapshot.totalSteps} (${snapshot.completionPct}%)`, `- Ready now: ${snapshot.readySteps.length}`, `- Waiting on dependencies: ${snapshot.waitingSteps.length}`, `- Explicitly blocked: ${snapshot.blockedStepDetails.length}`);
+    if (snapshot.readySteps.length > 0) {
+        lines.push('', `Ready now (${snapshot.readySteps.length}):`);
+        for (const step of snapshot.readySteps)
+            lines.push(formatStepLine(step));
+    }
+    else {
+        lines.push('', 'Ready now: none');
+    }
+    if (snapshot.waitingSteps.length > 0) {
+        lines.push('', `Waiting (${snapshot.waitingSteps.length}):`);
+        for (const step of snapshot.waitingSteps) {
+            lines.push(`${formatStepLine(step)} (${formatWaitReason(step)})`);
+        }
+    }
+    if (snapshot.blockedStepDetails.length > 0) {
+        lines.push('', `Blocked (${snapshot.blockedStepDetails.length}):`);
+        for (const step of snapshot.blockedStepDetails) {
+            const reason = step.blockedReason ? `: ${step.blockedReason}` : '';
+            lines.push(`${formatStepLine(step)}${reason}`);
+        }
+    }
+    lines.push('', 'Instruction:', 'Pick the top ready step, execute it end-to-end, and report tests/evidence before moving to the next.');
+    return lines.join('\n');
+}
+export function buildNextStepPrompt(plan, snapshot, stepRef) {
+    const step = stepRef ? snapshot.stepByRef[stepRef] : snapshot.nextReadyStep;
+    if (!step) {
+        const planName = (plan.title || plan.id || '(untitled)').trim();
+        return [
+            `No ready step is currently available for plan "${planName}".`,
+            'Please inspect waiting and blocked steps, resolve dependencies, and refresh the plan.',
+        ].join('\n');
+    }
+    const planName = (plan.title || plan.id || '(untitled)').trim();
+    const dependencyBlockers = stepDependencyBlockers(step);
+    const isWaiting = dependencyBlockers.length > 0 && !step.isBlocked;
+    const readinessLabel = step.isBlocked ? 'blocked' : (isWaiting ? 'waiting' : 'ready');
+    const lines = [
+        '# Next step execution prompt',
+        `You are working on plan "${planName}"${plan.id ? ` (${plan.id})` : ''}.`,
+        `Current progress: ${snapshot.completedSteps}/${snapshot.totalSteps} complete.`,
+        `Step readiness: ${readinessLabel}.`,
+        '',
+        `Execute step [${step.ref}] ${step.title}.`,
+    ];
+    if (step.description) {
+        lines.push(`Step details: ${step.description}`);
+    }
+    if (step.isBlocked) {
+        lines.push(`Blocked reason: ${step.blockedReason || 'No reason provided.'}`, 'This step is explicitly blocked. Resolve the blocker before implementation.');
+    }
+    else if (isWaiting) {
+        lines.push(`Pending dependencies: ${dependencyBlockers.join(', ')}`, 'This step is waiting on dependencies. Do not start implementation until dependencies are complete.');
+    }
+    else if (step.dependsOn.length > 0) {
+        lines.push(`Dependencies already satisfied: ${step.dependsOn.join(', ')}`);
+    }
+    lines.push('', 'Execution requirements:');
+    if (step.isBlocked || isWaiting) {
+        lines.push('- Resolve blockers/dependencies first, then refresh this plan snapshot.', '- Once ready, execute the step in production-ready quality.', '- Report exact commands/outcomes and evidence collected.', '- Update dependency and step status notes after each change.');
+    }
+    else {
+        lines.push('- Implement in production-ready quality.', '- Add or update tests where feasible.', '- Report the exact commands and outcomes.', '- Update the step status when done.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=plan-execution.js.map

package/public/src/views/plan-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-execution.js","sourceRoot":"","sources":["plan-execution.ts"],"names":[],"mappings":"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"}

package/public/src/views/plan-execution.ts

@@ -0,0 +1,279 @@
+type PlanStepInput = {
+  id?: string;
+  ref?: string;
+  title?: string;
+  description?: string;
+  status?: string;
+  blockedReason?: string;
+  blocked_reason?: string;
+  dependsOn?: string[];
+  depends_on?: string[];
+};
+
+type PlanInput = {
+  id?: string;
+  title?: string;
+  description?: string;
+  scope?: string;
+  status?: string;
+};
+
+export type AnalyzedPlanStep = {
+  ref: string;
+  title: string;
+  description: string;
+  status: string;
+  blockedReason: string;
+  dependsOn: string[];
+  unresolvedDependencies: string[];
+  incompleteDependencies: string[];
+  isDone: boolean;
+  isBlocked: boolean;
+  original: PlanStepInput;
+};
+
+export type PlanExecutionSnapshot = {
+  totalSteps: number;
+  completedSteps: number;
+  blockedSteps: number;
+  waitingSteps: AnalyzedPlanStep[];
+  readySteps: AnalyzedPlanStep[];
+  blockedStepDetails: AnalyzedPlanStep[];
+  allSteps: AnalyzedPlanStep[];
+  stepByRef: Record<string, AnalyzedPlanStep>;
+  completionPct: number;
+  nextReadyStep: AnalyzedPlanStep | null;
+};
+
+const DONE_STATUSES = new Set(['done', 'completed', 'closed']);
+const BLOCKED_STATUSES = new Set(['blocked']);
+
+function normalizeStatus(status?: string): string {
+  const value = (status || 'pending').trim().toLowerCase().replace(/\s+/g, '_');
+  return value || 'pending';
+}
+
+function normalizeStepRef(step: PlanStepInput, index: number): string {
+  const candidate = (step.ref || step.id || '').trim();
+  return candidate || `step-${index + 1}`;
+}
+
+function normalizeDependsOn(step: PlanStepInput): string[] {
+  const raw = Array.isArray(step.dependsOn)
+    ? step.dependsOn
+    : (Array.isArray(step.depends_on) ? step.depends_on : []);
+  const unique = new Set<string>();
+  for (const dep of raw) {
+    const trimmed = String(dep || '').trim();
+    if (trimmed) unique.add(trimmed);
+  }
+  return Array.from(unique);
+}
+
+function formatStepLine(step: AnalyzedPlanStep): string {
+  return `- [${step.ref}] ${step.title}`;
+}
+
+function formatWaitReason(step: AnalyzedPlanStep): string {
+  const blockers = [
+    ...step.incompleteDependencies,
+    ...step.unresolvedDependencies.map(dep => `${dep} (missing)`),
+  ];
+  if (blockers.length === 0) return 'waiting';
+  return `waiting on ${blockers.join(', ')}`;
+}
+
+function stepDependencyBlockers(step: AnalyzedPlanStep): string[] {
+  return [
+    ...step.incompleteDependencies,
+    ...step.unresolvedDependencies.map(dep => `${dep} (missing)`),
+  ];
+}
+
+export function buildPlanExecutionSnapshot(steps: PlanStepInput[]): PlanExecutionSnapshot {
+  const normalized: AnalyzedPlanStep[] = steps.map((step, index) => {
+    const status = normalizeStatus(step.status);
+    return {
+      ref: normalizeStepRef(step, index),
+      title: (step.title || '(untitled)').trim() || '(untitled)',
+      description: (step.description || '').trim(),
+      status,
+      blockedReason: (step.blockedReason || step.blocked_reason || '').trim(),
+      dependsOn: normalizeDependsOn(step),
+      unresolvedDependencies: [],
+      incompleteDependencies: [],
+      isDone: DONE_STATUSES.has(status),
+      isBlocked: BLOCKED_STATUSES.has(status),
+      original: step,
+    };
+  });
+
+  const stepByRef: Record<string, AnalyzedPlanStep> = {};
+  for (const step of normalized) {
+    if (!stepByRef[step.ref]) stepByRef[step.ref] = step;
+  }
+
+  const completedRefs = new Set(normalized.filter(step => step.isDone).map(step => step.ref));
+
+  for (const step of normalized) {
+    if (step.isDone || step.isBlocked) continue;
+    for (const dep of step.dependsOn) {
+      if (!stepByRef[dep]) {
+        step.unresolvedDependencies.push(dep);
+      } else if (!completedRefs.has(dep)) {
+        step.incompleteDependencies.push(dep);
+      }
+    }
+  }
+
+  const readySteps: AnalyzedPlanStep[] = [];
+  const waitingSteps: AnalyzedPlanStep[] = [];
+  const blockedStepDetails: AnalyzedPlanStep[] = [];
+
+  for (const step of normalized) {
+    if (step.isDone) continue;
+    if (step.isBlocked) {
+      blockedStepDetails.push(step);
+      continue;
+    }
+    if (step.incompleteDependencies.length === 0 && step.unresolvedDependencies.length === 0) {
+      readySteps.push(step);
+    } else {
+      waitingSteps.push(step);
+    }
+  }
+
+  const totalSteps = normalized.length;
+  const completedSteps = normalized.filter(step => step.isDone).length;
+  const blockedSteps = blockedStepDetails.length;
+  const completionPct = totalSteps > 0 ? Math.round((completedSteps / totalSteps) * 100) : 0;
+
+  return {
+    totalSteps,
+    completedSteps,
+    blockedSteps,
+    waitingSteps,
+    readySteps,
+    blockedStepDetails,
+    allSteps: normalized,
+    stepByRef,
+    completionPct,
+    nextReadyStep: readySteps[0] || null,
+  };
+}
+
+export function buildPlanAgentBrief(plan: PlanInput, snapshot: PlanExecutionSnapshot): string {
+  const title = (plan.title || plan.id || '(untitled)').trim();
+  const lines: string[] = [
+    '# Plan execution brief',
+    `Plan: ${title}`,
+  ];
+  if (plan.id) lines.push(`Plan ID: ${plan.id}`);
+  if (plan.status) lines.push(`Status: ${plan.status}`);
+  if (plan.scope) lines.push(`Scope: ${plan.scope}`);
+  if (plan.description) lines.push('', 'Description:', plan.description.trim());
+
+  lines.push(
+    '',
+    'Execution summary:',
+    `- Completed: ${snapshot.completedSteps}/${snapshot.totalSteps} (${snapshot.completionPct}%)`,
+    `- Ready now: ${snapshot.readySteps.length}`,
+    `- Waiting on dependencies: ${snapshot.waitingSteps.length}`,
+    `- Explicitly blocked: ${snapshot.blockedStepDetails.length}`
+  );
+
+  if (snapshot.readySteps.length > 0) {
+    lines.push('', `Ready now (${snapshot.readySteps.length}):`);
+    for (const step of snapshot.readySteps) lines.push(formatStepLine(step));
+  } else {
+    lines.push('', 'Ready now: none');
+  }
+
+  if (snapshot.waitingSteps.length > 0) {
+    lines.push('', `Waiting (${snapshot.waitingSteps.length}):`);
+    for (const step of snapshot.waitingSteps) {
+      lines.push(`${formatStepLine(step)} (${formatWaitReason(step)})`);
+    }
+  }
+
+  if (snapshot.blockedStepDetails.length > 0) {
+    lines.push('', `Blocked (${snapshot.blockedStepDetails.length}):`);
+    for (const step of snapshot.blockedStepDetails) {
+      const reason = step.blockedReason ? `: ${step.blockedReason}` : '';
+      lines.push(`${formatStepLine(step)}${reason}`);
+    }
+  }
+
+  lines.push(
+    '',
+    'Instruction:',
+    'Pick the top ready step, execute it end-to-end, and report tests/evidence before moving to the next.'
+  );
+
+  return lines.join('\n');
+}
+
+export function buildNextStepPrompt(
+  plan: PlanInput,
+  snapshot: PlanExecutionSnapshot,
+  stepRef?: string
+): string {
+  const step = stepRef ? snapshot.stepByRef[stepRef] : snapshot.nextReadyStep;
+  if (!step) {
+    const planName = (plan.title || plan.id || '(untitled)').trim();
+    return [
+      `No ready step is currently available for plan "${planName}".`,
+      'Please inspect waiting and blocked steps, resolve dependencies, and refresh the plan.',
+    ].join('\n');
+  }
+
+  const planName = (plan.title || plan.id || '(untitled)').trim();
+  const dependencyBlockers = stepDependencyBlockers(step);
+  const isWaiting = dependencyBlockers.length > 0 && !step.isBlocked;
+  const readinessLabel = step.isBlocked ? 'blocked' : (isWaiting ? 'waiting' : 'ready');
+  const lines: string[] = [
+    '# Next step execution prompt',
+    `You are working on plan "${planName}"${plan.id ? ` (${plan.id})` : ''}.`,
+    `Current progress: ${snapshot.completedSteps}/${snapshot.totalSteps} complete.`,
+    `Step readiness: ${readinessLabel}.`,
+    '',
+    `Execute step [${step.ref}] ${step.title}.`,
+  ];
+
+  if (step.description) {
+    lines.push(`Step details: ${step.description}`);
+  }
+
+  if (step.isBlocked) {
+    lines.push(
+      `Blocked reason: ${step.blockedReason || 'No reason provided.'}`,
+      'This step is explicitly blocked. Resolve the blocker before implementation.'
+    );
+  } else if (isWaiting) {
+    lines.push(
+      `Pending dependencies: ${dependencyBlockers.join(', ')}`,
+      'This step is waiting on dependencies. Do not start implementation until dependencies are complete.'
+    );
+  } else if (step.dependsOn.length > 0) {
+    lines.push(`Dependencies already satisfied: ${step.dependsOn.join(', ')}`);
+  }
+
+  lines.push('', 'Execution requirements:');
+  if (step.isBlocked || isWaiting) {
+    lines.push(
+      '- Resolve blockers/dependencies first, then refresh this plan snapshot.',
+      '- Once ready, execute the step in production-ready quality.',
+      '- Report exact commands/outcomes and evidence collected.',
+      '- Update dependency and step status notes after each change.'
+    );
+  } else {
+    lines.push(
+      '- Implement in production-ready quality.',
+      '- Add or update tests where feasible.',
+      '- Report the exact commands and outcomes.',
+      '- Update the step status when done.'
+    );
+  }
+
+  return lines.join('\n');
+}