@aemonge-dev/pi-stardeck 0.9.0 → 0.9.2

package/packages/status/src/goal-block.ts

@@ -1,377 +0,0 @@
-import type {
-  ExtensionAPI,
-  ExtensionContext,
-  Theme,
-} from '@earendil-works/pi-coding-agent';
-import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
-import { readFileSync, statSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import type { GoalHeaderState } from './goal.ts';
-import { GOAL_HEADER_STATUSES } from './goal.ts';
-
-/**
- * Goal-block takeover for pi-goal-x: replaces its persistent aboveEditor
- * widget ("goal" key) with a compact deck-style block rendered from the
- * goal entries pi-goal-x already appends to the session branch.
- *
- * pi-goal-x registers its widget once per session (one-shot flag), so the
- * first same-key registration after theirs owns the slot for the session.
- * We re-assert briefly after session start and on turn starts until the
- * takeover sticks. pi-goal-x modals, tools, and storage are untouched.
- */
-
-const GOAL_WIDGET_KEY = 'goal';
-const GOAL_X_STATE_ENTRY = 'pi-goal-state';
-const GOAL_X_FOCUS_ENTRY = 'pi-goal-focus';
-const REASSERT_DELAYS_MS = [800, 2_000, 5_000, 10_000];
-
-export interface GoalBlockTaskCounts {
-  pending: number;
-  active: number;
-  complete: number;
-  total: number;
-}
-
-export interface GoalBlockState {
-  id: string;
-  objective: string;
-  status: string;
-  tokensUsed?: number;
-  activeSeconds?: number;
-  tokenBudget?: number;
-  autoContinue?: boolean;
-  tasks?: GoalBlockTaskCounts;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function countTasks(node: unknown, counts: GoalBlockTaskCounts): void {
-  if (!isRecord(node)) return;
-  const status = node.status;
-  if (status === 'pending' || status === 'active' || status === 'complete') {
-    counts.total += 1;
-    counts[status] += 1;
-  }
-  if (Array.isArray(node.subtasks)) {
-    for (const child of node.subtasks) countTasks(child, counts);
-  }
-}
-
-function parseTaskCounts(taskList: unknown): GoalBlockTaskCounts | undefined {
-  if (!isRecord(taskList) || !Array.isArray(taskList.tasks)) return undefined;
-  const counts: GoalBlockTaskCounts = { pending: 0, active: 0, complete: 0, total: 0 };
-  for (const task of taskList.tasks) countTasks(task, counts);
-  return counts.total > 0 ? counts : undefined;
-}
-
-function parseNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) && value >= 0
-    ? value
-    : undefined;
-}
-
-function parseGoalRecord(value: unknown): GoalBlockState | null {
-  if (!isRecord(value)) return null;
-  if (typeof value.id !== 'string' || value.id.trim() === '') return null;
-  if (typeof value.objective !== 'string' || value.objective.trim() === '') return null;
-  const usage = isRecord(value.usage) ? value.usage : {};
-  const budget = parseNumber(usage.tokenBudget) ?? parseNumber(value.tokenBudget);
-  return {
-    id: value.id.slice(0, 128),
-    objective: value.objective.replace(/\s+/gu, ' ').trim().slice(0, 160),
-    status: typeof value.status === 'string' ? value.status.slice(0, 24) : 'active',
-    tokensUsed: parseNumber(usage.tokensUsed),
-    activeSeconds: parseNumber(usage.activeSeconds),
-    ...(budget !== undefined && budget > 0 ? { tokenBudget: budget } : {}),
-    ...(value.autoContinue === true ? { autoContinue: true } : {}),
-    ...(parseTaskCounts(value.taskList)
-      ? { tasks: parseTaskCounts(value.taskList) }
-      : {}),
-  };
-}
-
-function readGoalBlockRecord(entries: readonly unknown[]): {
-  focusedGoalId: string | null | undefined;
-  record: unknown;
-  recordSeen: boolean;
-} {
-  let focusedGoalId: string | null | undefined;
-  let record: unknown;
-  let recordSeen = false;
-  for (let index = entries.length - 1; index >= 0; index -= 1) {
-    const entry = entries[index];
-    if (!isRecord(entry) || entry.type !== 'custom') continue;
-    if (
-      focusedGoalId === undefined &&
-      entry.customType === GOAL_X_FOCUS_ENTRY &&
-      isRecord(entry.data)
-    ) {
-      focusedGoalId =
-        typeof entry.data.focusedGoalId === 'string' ? entry.data.focusedGoalId : null;
-    }
-    if (
-      !recordSeen &&
-      entry.customType === GOAL_X_STATE_ENTRY &&
-      isRecord(entry.data)
-    ) {
-      record = entry.data.goal;
-      recordSeen = true;
-    }
-    if (focusedGoalId !== undefined && recordSeen) break;
-  }
-  return { focusedGoalId, record, recordSeen };
-}
-
-function isDirectorySafe(path: string): boolean {
-  try {
-    return statSync(path).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-/** Mirror pi-goal-x storage resolution: env root, project root, then the
- * agent-level fallback. Broken symlinks are skipped, never followed. */
-export function resolveGoalRoot(ctx: ExtensionContext): string | undefined {
-  const candidates: string[] = [];
-  if (process.env.PI_GOAL_ROOT) candidates.push(resolve(process.env.PI_GOAL_ROOT));
-  if (typeof ctx.cwd === 'string') {
-    candidates.push(resolve(ctx.cwd, '.pi/goals'));
-  }
-  candidates.push(join(homedir(), '.pi', 'goals'));
-  return candidates.find((candidate) => isDirectorySafe(candidate));
-}
-
-const poolCache = new Map<string, { mtimeMs: number; goals: unknown[] }>();
-
-function snapshotPaths(root: string): string[] {
-  return [
-    join(root, '.metadata', '.goals-pool-snapshot.json'),
-    join(dirname(root), '.goals-pool-snapshot.json'),
-  ];
-}
-
-export function loadPoolGoals(root: string): unknown[] {
-  for (const snapshotPath of snapshotPaths(root)) {
-    try {
-      const stats = statSync(snapshotPath);
-      if (!stats.isFile()) continue;
-      const cached = poolCache.get(snapshotPath);
-      if (cached && cached.mtimeMs === stats.mtimeMs) return cached.goals;
-      const parsed: unknown = JSON.parse(readFileSync(snapshotPath, 'utf8'));
-      if (!isRecord(parsed) || !Array.isArray(parsed.goals)) continue;
-      const goals = parsed.goals.filter(isRecord);
-      poolCache.set(snapshotPath, { mtimeMs: stats.mtimeMs, goals });
-      return goals;
-    } catch {
-      continue;
-    }
-  }
-  return [];
-}
-
-export function readGoalBlockState(ctx: ExtensionContext): GoalBlockState | null {
-  const { focusedGoalId, record, recordSeen } = readGoalBlockRecord(
-    ctx.sessionManager.getBranch(),
-  );
-  if (focusedGoalId === null) return null;
-  let candidate: unknown = recordSeen ? record : undefined;
-  const root = resolveGoalRoot(ctx);
-  if (root) {
-    const goals = loadPoolGoals(root);
-    const fromPool = goals.find((goal) => isRecord(goal) && goal.id === focusedGoalId);
-    if (fromPool !== undefined) candidate = fromPool;
-  }
-  const state = parseGoalRecord(candidate);
-  if (!state) return null;
-  if (
-    focusedGoalId !== undefined &&
-    focusedGoalId !== null &&
-    focusedGoalId !== state.id
-  ) {
-    return null;
-  }
-  return state;
-}
-
-export function readGoalHeadline(ctx: ExtensionContext): GoalHeaderState | null {
-  const state = readGoalBlockState(ctx);
-  if (!state) return null;
-  return {
-    id: state.id,
-    status: (GOAL_HEADER_STATUSES as readonly string[]).includes(state.status)
-      ? (state.status as GoalHeaderState['status'])
-      : 'active',
-    automaticModelTurns: 0,
-    waiting: state.status === 'active',
-    ...(state.objective !== undefined ? { objective: state.objective } : {}),
-    ...(state.activeSeconds !== undefined
-      ? { elapsedSeconds: state.activeSeconds }
-      : {}),
-    ...(state.tasks
-      ? {
-          tasksDone: state.tasks.complete,
-          tasksActive: state.tasks.active,
-          tasksTotal: state.tasks.total,
-        }
-      : {}),
-    ...(state.tokensUsed !== undefined ? { tokensUsed: state.tokensUsed } : {}),
-    ...(state.tokenBudget !== undefined ? { tokenBudget: state.tokenBudget } : {}),
-  };
-}
-
-export function countOpenGoals(ctx: ExtensionContext): number {
-  const root = resolveGoalRoot(ctx);
-  if (!root) return 0;
-  return loadPoolGoals(root).filter(
-    (goal) => isRecord(goal) && goal.status !== 'complete',
-  ).length;
-}
-
-export function formatGoalElapsed(seconds: number): string {
-  if (seconds < 60) return `${Math.floor(seconds)}s`;
-  const totalMinutes = Math.floor(seconds / 60);
-  if (totalMinutes < 60) {
-    return `${totalMinutes}m ${Math.floor(seconds % 60)}s`;
-  }
-  return `${Math.floor(totalMinutes / 60)}h ${totalMinutes % 60}m`;
-}
-
-function formatTokens(tokens: number): string {
-  if (tokens >= 1_000_000) return `${(tokens / 1_000_000).toFixed(1)}M`;
-  if (tokens >= 1_000) return `${(tokens / 1_000).toFixed(1)}k`;
-  return `${Math.floor(tokens)}`;
-}
-
-const STATUS_COLORS: Record<
-  string,
-  'success' | 'accent' | 'warning' | 'error' | 'dim'
-> = {
-  active: 'accent',
-  complete: 'success',
-  paused: 'warning',
-  blocked: 'error',
-  usage_limited: 'warning',
-  budget_limited: 'warning',
-  queued: 'dim',
-};
-
-export function renderGoalBlock(
-  state: GoalBlockState | null,
-  width: number,
-  theme: Theme,
-  openGoals = 0,
-): string[] {
-  if (width < 40) return [];
-  const fg = (semantic: string, text: string): string =>
-    theme.fg(semantic as never, text);
-
-  if (!state) {
-    if (openGoals > 0 && width >= 48) {
-      return [
-        fg(
-          'dim',
-          `◆ ${openGoals} open goal${openGoals === 1 ? '' : 's'} · /goal-focus`,
-        ),
-      ];
-    }
-    return [];
-  }
-
-  const badge = fg(STATUS_COLORS[state.status] ?? 'text', `● ${state.status}`);
-  const elapsed =
-    state.activeSeconds !== undefined
-      ? ` · ${formatGoalElapsed(state.activeSeconds)}`
-      : '';
-  const headline = `◆ ${state.objective}   ${badge}${elapsed}`;
-  const rows: string[] = [truncateToWidth(headline, width, '…')];
-
-  if (state.tasks && width >= 48) {
-    const { complete, total, active } = state.tasks;
-    rows.push(
-      truncateToWidth(
-        `  ├ tasks ${complete}/${total} done` +
-          (active > 0 ? ` · ${active} active` : ''),
-        width,
-        '…',
-      ),
-    );
-  }
-
-  if (
-    width >= 60 &&
-    (state.tokensUsed !== undefined || state.tokenBudget !== undefined)
-  ) {
-    const parts: string[] = [];
-    if (state.tokensUsed !== undefined)
-      parts.push(`${formatTokens(state.tokensUsed)} tokens`);
-    if (state.tokenBudget !== undefined && state.tokensUsed !== undefined) {
-      parts.push(
-        `budget ${Math.min(999, Math.round((state.tokensUsed / state.tokenBudget) * 100))}%`,
-      );
-    }
-    if (parts.length > 0) {
-      rows.push(truncateToWidth(`  └ usage ${parts.join(' · ')}`, width, '…'));
-    }
-  }
-
-  return rows.map((line) => fg('dim', line));
-}
-
-export function installGoalBlockTakeover(pi: ExtensionAPI): () => void {
-  let activeCtx: ExtensionContext | undefined;
-  let stopped = false;
-  const timers: ReturnType<typeof setTimeout>[] = [];
-
-  const register = (ctx: ExtensionContext): void => {
-    if (stopped || ctx.mode !== 'tui' || !ctx.hasUI) return;
-    if (typeof ctx.ui.setWidget !== 'function') return;
-    ctx.ui.setWidget(GOAL_WIDGET_KEY, (tui, _theme: Theme) => {
-      const requestRender = (): void => tui.requestRender();
-      return {
-        render(width: number): string[] {
-          // Pure suppression: the deck owns every goal display, including
-          // the unfocused open-goal hint in its title row.
-          const lines: string[] = [];
-          return lines.every((line) => visibleWidth(line) <= width)
-            ? lines
-            : lines.map((line) => truncateToWidth(line, width, '…'));
-        },
-        invalidate() {
-          requestRender();
-        },
-      };
-    });
-  };
-
-  const scheduleReasserts = (ctx: ExtensionContext): void => {
-    for (const delay of REASSERT_DELAYS_MS) {
-      const timer = setTimeout(() => {
-        if (!stopped && activeCtx === ctx) register(ctx);
-      }, delay);
-      timer.unref?.();
-      timers.push(timer);
-    }
-  };
-
-  pi.on('session_start', (_event, ctx) => {
-    if (!ctx) return;
-    activeCtx = ctx;
-    register(ctx);
-    scheduleReasserts(ctx);
-  });
-
-  pi.on('turn_start', () => {
-    if (!stopped && activeCtx) register(activeCtx);
-  });
-
-  return () => {
-    stopped = true;
-    for (const timer of timers) clearTimeout(timer);
-    activeCtx?.ui.setWidget(GOAL_WIDGET_KEY, undefined);
-    activeCtx = undefined;
-  };
-}

package/packages/status/src/goal.ts

@@ -1,170 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { getAgentDir } from '@earendil-works/pi-coding-agent';
-
-export const GOAL_STATE_ENTRY_TYPE = 'goal-state';
-
-export const GOAL_HEADER_STATUSES = [
-  'active',
-  'queued',
-  'paused',
-  'blocked',
-  'usage_limited',
-  'budget_limited',
-  'complete',
-] as const;
-
-export type GoalHeaderStatus = (typeof GOAL_HEADER_STATUSES)[number];
-
-export interface GoalHeaderState {
-  id: string;
-  status: GoalHeaderStatus;
-  automaticModelTurns: number;
-  waiting: boolean;
-  objective?: string;
-  elapsedSeconds?: number;
-  tasksDone?: number;
-  tasksActive?: number;
-  tasksTotal?: number;
-  tokensUsed?: number;
-  tokenBudget?: number;
-}
-
-const STATUS_SET = new Set<string>(GOAL_HEADER_STATUSES);
-const MAX_GOAL_ID_POINTS = 128;
-const MAX_HEADER_PROGRESS = 9_999;
-const GOAL_PROMPT_MARKER =
-  /<!-- pi-goal-(?:prompt|continuation):[A-Za-z0-9:._-]{1,300} -->/u;
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function parseGoalHeaderState(value: unknown): GoalHeaderState | null {
-  if (value === null) return null;
-  if (!isRecord(value)) return null;
-  if (typeof value.id !== 'string' || !value.id || value.id !== value.id.trim()) {
-    return null;
-  }
-  if (Array.from(value.id).length > MAX_GOAL_ID_POINTS) return null;
-  if (typeof value.status !== 'string' || !STATUS_SET.has(value.status)) return null;
-  const automaticModelTurns =
-    typeof value.automaticModelTurns === 'number' &&
-    Number.isSafeInteger(value.automaticModelTurns) &&
-    value.automaticModelTurns >= 0
-      ? Math.min(value.automaticModelTurns, MAX_HEADER_PROGRESS)
-      : 0;
-  const boundedCount = (input: unknown): number | undefined =>
-    typeof input === 'number' &&
-    Number.isSafeInteger(input) &&
-    input >= 0 &&
-    input <= 9_999
-      ? input
-      : undefined;
-  const objective =
-    typeof value.objective === 'string' && value.objective.trim() !== ''
-      ? value.objective.replace(/\s+/gu, ' ').trim().slice(0, 160)
-      : undefined;
-  const elapsedSeconds =
-    typeof value.elapsedSeconds === 'number' &&
-    Number.isFinite(value.elapsedSeconds) &&
-    value.elapsedSeconds >= 0
-      ? Math.min(value.elapsedSeconds, 3_600_000)
-      : undefined;
-  const tokensUsed =
-    typeof value.tokensUsed === 'number' &&
-    Number.isFinite(value.tokensUsed) &&
-    value.tokensUsed >= 0
-      ? Math.min(value.tokensUsed, 9_999_999_999)
-      : undefined;
-  return {
-    id: value.id,
-    status: value.status as GoalHeaderStatus,
-    automaticModelTurns,
-    waiting: value.status === 'active' && isRecord(value.waiting),
-    ...(objective !== undefined ? { objective } : {}),
-    ...(elapsedSeconds !== undefined ? { elapsedSeconds } : {}),
-    ...(boundedCount(value.tasksDone) !== undefined
-      ? { tasksDone: boundedCount(value.tasksDone) }
-      : {}),
-    ...(boundedCount(value.tasksActive) !== undefined
-      ? { tasksActive: boundedCount(value.tasksActive) }
-      : {}),
-    ...(boundedCount(value.tasksTotal) !== undefined
-      ? { tasksTotal: boundedCount(value.tasksTotal) }
-      : {}),
-    ...(tokensUsed !== undefined ? { tokensUsed } : {}),
-    ...(boundedCount(value.tokenBudget) !== undefined &&
-    (boundedCount(value.tokenBudget) ?? 0) > 0
-      ? { tokenBudget: boundedCount(value.tokenBudget) }
-      : {}),
-  };
-}
-
-export function restoreGoalHeaderState(
-  entries: readonly unknown[],
-): GoalHeaderState | null {
-  for (let index = entries.length - 1; index >= 0; index -= 1) {
-    const entry = entries[index];
-    if (
-      !isRecord(entry) ||
-      entry.type !== 'custom' ||
-      entry.customType !== GOAL_STATE_ENTRY_TYPE
-    ) {
-      continue;
-    }
-    const data = isRecord(entry.data) ? entry.data : undefined;
-    return parseGoalHeaderState(data?.goal);
-  }
-  return null;
-}
-
-export function isGoalOwnedPrompt(value: unknown): boolean {
-  return typeof value === 'string' && GOAL_PROMPT_MARKER.test(value);
-}
-
-export function sameGoalHeaderState(
-  left: GoalHeaderState | null,
-  right: GoalHeaderState | null,
-): boolean {
-  return (
-    left === right ||
-    (left !== null &&
-      right !== null &&
-      left.id === right.id &&
-      left.status === right.status &&
-      left.automaticModelTurns === right.automaticModelTurns &&
-      left.waiting === right.waiting &&
-      left.objective === right.objective &&
-      left.tasksDone === right.tasksDone &&
-      left.tasksActive === right.tasksActive &&
-      left.tasksTotal === right.tasksTotal &&
-      left.tokensUsed === right.tokensUsed &&
-      left.tokenBudget === right.tokenBudget &&
-      Math.floor((left.elapsedSeconds ?? 0) / 10) ===
-        Math.floor((right.elapsedSeconds ?? 0) / 10))
-  );
-}
-
-export function parseGoalAutomaticTurnLimit(value: unknown): number | undefined {
-  if (!isRecord(value)) return undefined;
-  const limits = isRecord(value.continuationLimits)
-    ? value.continuationLimits
-    : undefined;
-  const limit = limits?.automaticTurns;
-  return typeof limit === 'number' &&
-    Number.isSafeInteger(limit) &&
-    limit > 0 &&
-    limit <= MAX_HEADER_PROGRESS
-    ? limit
-    : undefined;
-}
-
-export async function loadGoalAutomaticTurnLimit(): Promise<number | undefined> {
-  try {
-    const raw = await readFile(join(getAgentDir(), 'pi-goal.json'), 'utf8');
-    return parseGoalAutomaticTurnLimit(JSON.parse(raw) as unknown);
-  } catch {
-    return undefined;
-  }
-}