@aemonge-dev/pi-stardeck 0.9.1 → 0.9.3

package/packages/pi-stardeck/src/gauge.ts

@@ -62,6 +62,7 @@ export const HEADER_ACTIVITY_KINDS = [
   'regression',
   'verification',
   'result-review',
+  'answering',
   'recovery',
   'awaiting-validation',
   'awaiting-input',
@@ -97,27 +98,15 @@ export type HeaderWork = {
 
 export const HEADER_SELECTION_SOURCES = [
   'openspec',
-  'goal',
   'session-work',
   'subject',
   'legacy',
 ] as const;
 
-export type HeaderSelectionGoalDetail = {
-  status: string;
-  elapsedSeconds?: number;
-  tasksDone?: number;
-  tasksActive?: number;
-  tasksTotal?: number;
-  tokensUsed?: number;
-  tokenBudget?: number;
-};
-
 export type HeaderSelection = {
   source: (typeof HEADER_SELECTION_SOURCES)[number];
   titles: string[];
   color: HeaderColor;
-  goal?: HeaderSelectionGoalDetail;
 };
 
 export const HEADER_SUGGESTIONS = [
@@ -131,7 +120,6 @@ export const HEADER_SUGGESTIONS = [
 export type HeaderSuggestion = (typeof HEADER_SUGGESTIONS)[number];
 
 export type HeaderSnapshot = {
-  openGoals?: number;
   activity?: HeaderActivity | null;
   selection?: HeaderSelection | null;
   suggestion?: HeaderSuggestion | null;
@@ -954,46 +942,10 @@ function parseHeaderSelection(value: unknown): HeaderSelection | null {
   });
   if (titles.length !== candidate.titles.length) return null;
 
-  let goal: HeaderSelectionGoalDetail | undefined;
-  if (
-    candidate.source === 'goal' &&
-    candidate.goal &&
-    typeof candidate.goal === 'object' &&
-    !Array.isArray(candidate.goal)
-  ) {
-    const raw = candidate.goal as Record<string, unknown>;
-    const boundedNumber = (input: unknown): number | undefined =>
-      typeof input === 'number' &&
-      Number.isFinite(input) &&
-      input >= 0 &&
-      input <= 9_999_999_999
-        ? input
-        : undefined;
-    if (typeof raw.status === 'string' && raw.status.length <= 24) {
-      const detail: HeaderSelectionGoalDetail = { status: raw.status };
-      const elapsed = boundedNumber(raw.elapsedSeconds);
-      if (elapsed !== undefined) detail.elapsedSeconds = elapsed;
-      for (const [key, value] of [
-        ['tasksDone', raw.tasksDone],
-        ['tasksActive', raw.tasksActive],
-        ['tasksTotal', raw.tasksTotal],
-        ['tokenBudget', raw.tokenBudget],
-      ] as const) {
-        const parsed = boundedNumber(value);
-        if (parsed !== undefined && parsed <= 9_999) {
-          detail[key] = parsed;
-        }
-      }
-      const tokensUsed = boundedNumber(raw.tokensUsed);
-      if (tokensUsed !== undefined) detail.tokensUsed = tokensUsed;
-      goal = detail;
-    }
-  }
   return {
     source: candidate.source as HeaderSelection['source'],
     titles,
     color: candidate.color,
-    ...(goal !== undefined ? { goal } : {}),
   };
 }
 
@@ -1066,14 +1018,6 @@ export function parseHeaderSnapshot(raw: unknown): HeaderSnapshot | null {
   if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null;
   const message = raw as Record<string, unknown>;
   if (message.protocol !== 1) return null;
-  const openGoals =
-    typeof message.openGoals === 'number' &&
-    Number.isInteger(message.openGoals) &&
-    message.openGoals >= 0 &&
-    message.openGoals <= 99
-      ? message.openGoals
-      : 0;
-
   const standaloneActivity = parseHeaderActivity(message.activity) ?? null;
   let work: HeaderWork | null = null;
   if (
@@ -1190,7 +1134,6 @@ export function parseHeaderSnapshot(raw: unknown): HeaderSnapshot | null {
   const hasExplicitTurn = Object.prototype.hasOwnProperty.call(message, 'turn');
 
   return {
-    openGoals,
     activity: standaloneActivity,
     selection: hasExplicitSelection
       ? parseHeaderSelection(message.selection)

package/packages/pi-stardeck/src/title-state.ts

@@ -42,8 +42,10 @@ const TURN_ELAPSED_MAX = (99 * 60 + 59) * 1_000 + 999;
 export type DeckTitleWorkState = {
   change: string;
   task?: string;
-  done: number;
-  total: number;
+  done?: number;
+  total?: number;
+  schemaName?: string;
+  ladder?: { done: number; total: number; rung?: string };
 };
 
 export type DeckTitleActivityState = {
@@ -116,12 +118,47 @@ function parseTitleWork(value: unknown): DeckTitleWorkState | null | undefined {
   if (value === null) return null;
   if (!isRecord(value)) return undefined;
   const change = boundedText(value.change, IDENTIFIER_MAX);
-  const done = boundedTotal(value.done);
-  const total = boundedTotal(value.total);
-  if (!change || done === null || total === null) return undefined;
+  if (!change) return undefined;
+  // Counts are optional as a pair: absent means unknown (never fabricated
+  // zeros); present-but-invalid rejects the object.
+  const hasCounts = 'done' in value && 'total' in value;
+  if ('done' in value !== 'total' in value) return undefined;
+  const boundedDone = hasCounts ? boundedTotal(value.done) : undefined;
+  const boundedTotalValue = hasCounts ? boundedTotal(value.total) : undefined;
+  if (hasCounts && (boundedDone === null || boundedTotalValue === null)) {
+    return undefined;
+  }
   const task = boundedText(value.task, TASK_ID_MAX, { required: false });
   if (task === null) return undefined;
-  return task === undefined ? { change, done, total } : { change, task, done, total };
+  const schemaName = boundedText(value.schemaName, IDENTIFIER_MAX, {
+    required: false,
+  });
+  if (schemaName === null) return undefined;
+  let ladder: { done: number; total: number; rung?: string } | undefined;
+  if ('ladder' in value) {
+    if (!isRecord(value.ladder)) return undefined;
+    const ladderDone = boundedTotal(value.ladder.done);
+    const ladderTotal = boundedTotal(value.ladder.total);
+    if (ladderDone === null || ladderTotal === null) return undefined;
+    const ladderRung = boundedText(value.ladder.rung, 32, { required: false });
+    if (ladderRung === null) return undefined;
+    ladder = {
+      done: ladderDone,
+      total: ladderTotal,
+      ...(ladderRung ? { rung: ladderRung } : {}),
+    };
+  }
+  const counts =
+    typeof boundedDone === 'number' && typeof boundedTotalValue === 'number'
+      ? { done: boundedDone, total: boundedTotalValue }
+      : {};
+  const extras = {
+    ...(schemaName ? { schemaName } : {}),
+    ...(ladder ? { ladder } : {}),
+  };
+  return task === undefined
+    ? { change, ...counts, ...extras }
+    : { change, task, ...counts, ...extras };
 }
 
 function parseTitleWaiver(value: unknown): DeckTitleWaiverState | null | undefined {
@@ -189,7 +226,46 @@ export function parseDeckTurnCost(value: unknown): DeckTurnCost | null {
   }
 }
 
-/** `change · done/total` — the Work label from the accepted mockups. */
+/** One colored piece of the Work label. */
+export type DeckWorkSegment = { text: string; color: string; bold?: boolean };
+
+/**
+ * The Work label as colored segments — the human-chosen design: `change ⟩
+ * done/total rung › 󰄱 done/total` in one hue per state (accent, success at
+ * complete with a filled checkbox and bold counts). The rung name comes
+ * straight from OpenSpec's status artifacts — never an invented phase
+ * word. Separators are chrome with hard deck-wide colors — `⟩`
+ * thinkingHigh-bold like every semantic separator, `›` accent like every
+ * minor one. Unknown facts degrade honestly; the bare change is the floor.
+ */
+export function deckWorkSegments(work: DeckTitleWorkState): DeckWorkSegment[] {
+  const complete =
+    work.done !== undefined &&
+    work.total !== undefined &&
+    work.total > 0 &&
+    work.done >= work.total;
+  const base = complete ? 'success' : 'accent';
+  const segments: DeckWorkSegment[] = [{ text: work.change, color: base }];
+  const ladder = work.ladder;
+  if (ladder) {
+    segments.push({ text: ' ⟩ ', color: 'thinkingHigh', bold: true });
+    const group = `${ladder.done}/${ladder.total}${ladder.rung ? ` ${ladder.rung}` : ''}`;
+    segments.push({ text: group, color: base });
+  }
+  if (work.done !== undefined && work.total !== undefined) {
+    segments.push({ text: ' › ', color: 'accent' });
+    segments.push({
+      text: `${complete ? '✔' : '󰄱'} ${work.done}/${work.total}`,
+      color: base,
+      ...(complete ? { bold: true } : {}),
+    });
+  }
+  return segments;
+}
+
+/** The plain-text Work label — the segment join without colors. */
 export function formatDeckWorkLabel(work: DeckTitleWorkState): string {
-  return `${work.change} · ${work.done}/${work.total}`;
+  return deckWorkSegments(work)
+    .map((segment) => segment.text)
+    .join('');
 }

package/packages/pi-stardeck/src/title.ts

@@ -45,6 +45,7 @@ const ACTIVITY_LABELS: Record<HeaderActivity['kind'], ActivityLabels> = {
     full: 'reviewing check results',
     compact: 'reviewing results',
   },
+  answering: { full: 'answering the Human', compact: 'answering' },
   recovery: { full: 'repairing bounded failure', compact: 'repair' },
   'awaiting-validation': {
     full: 'Human validation',

package/packages/pi-vim-top-border/prompt-rail.ts

@@ -6,7 +6,6 @@ const TRACKED_WIDGET_IDS = new Set([
   'galactica.openspec-progress',
   'galactica.openspec',
   'galactica.work',
-  'galactica.goal',
   'galactica.project-capabilities',
   'galactica.session-memory',
   'galactica.session-cpu',
@@ -214,7 +213,6 @@ function workWidget(widgets: ReadonlyMap<string, RailWidget>): RailWidget | unde
   for (const id of [
     'galactica.openspec-progress',
     'galactica.openspec',
-    'galactica.goal',
     'galactica.work',
   ]) {
     const widget = widgets.get(id);

package/packages/status/README.md

@@ -7,7 +7,7 @@ editor widget itself.
 ## Architecture
 
 ```text
-Pi tool lifecycle + session/Goal metadata + OpenSpec CLI + aggregate JSON state
+Pi tool lifecycle + session metadata + OpenSpec CLI + aggregate JSON state
                                   │
                                   ▼
                         normalized immutable state
@@ -64,9 +64,9 @@ active OpenSpec footer by themselves.
 
 ## Session focus and terminal title
 
-A Pi session has zero or one explicit OpenSpec task focus, optional read-only Pi Goal
-state, and an independent ephemeral Session Work state. Display priority is OpenSpec
-Task → Goal → Session Work → safe direct fallback. OpenSpec focus clears active Session
+A Pi session has zero or one explicit OpenSpec task focus and an independent
+ephemeral Session Work state. Display priority is OpenSpec
+Task → Session Work → safe direct fallback. OpenSpec focus clears active Session
 Work when acquired, preventing hidden or stale work from resurfacing later.
 
 Session Work is stored only as versioned custom entries on the active Pi session branch;
@@ -80,7 +80,7 @@ it never creates a repository status file. It supports this lifecycle:
 ```
 
 When no OpenSpec portfolio is available, the matching row-one footer fallback is the
-compact `▶ Focus` or `◇ Validate`; an active Goal uses `󰊕 Goal`, and an entirely empty
+compact `▶ Focus` or `◇ Validate`; an entirely empty
 project uses ` no OpenSpec`. The detailed Session Work intent remains in the header
 instead of being duplicated in the footer. Active and validation states also replace the
 fallback terminal title. Reload, resume, and tree navigation restore the newest valid
@@ -97,25 +97,14 @@ publication.
 
 The header projection uses the rich lifecycle `understanding`, `working`, `waiting`,
 `assuring`, `learning`, `answering`, `blocked`, `listening`, or `aborted`. It separately
-publishes one explicit selection with OpenSpec Task → Goal → Session Work precedence,
+publishes one explicit selection with OpenSpec Task → Session Work precedence,
 or `null` when no work is selected. A controlled suggestion enum communicates only
 Human-facing reporting cues such as `requesting-validation`,
 `awaiting-continuation`, or `requesting-redirection`; it never carries generated
 prose. Direct tool
-categories, read-only Pi Goal state, and known Taskflow phases move the lifecycle
-without exposing arguments or raw node prose. Goal state is restored from Pi's canonical
-`goal-state` session entries without enabling Goal RPC. An active Goal renders bounded
-automatic-turn progress from `pi-goal.json`; paused, blocked, limited, external-wait,
-and complete states render controlled labels. Complete projects as
-`awaiting Human validation` rather than Human acceptance. Raw Goal objectives, wait
-reasons, completion summaries, paths, and Goal IDs never enter the visible header. While
-a Goal exists, a session-scoped 500 ms in-memory branch monitor catches idle
-`/goal pause`, clear, and menu transitions; it performs no filesystem, process,
-provider, or network work and stops when Goal state is cleared. A stopped Goal remains
-visible while Pi is idle so its terminal reason is honest, but the next ordinary
-non-Goal turn automatically returns the title to current Ramona, OpenSpec, Session Work,
-or direct activity. This display transition never mutates Goal or focus state; a later
-Goal resume automatically reclaims the title. During a Taskflow tool run, structured
+categories and known Taskflow phases move the lifecycle
+without exposing arguments or raw node prose. Complete projects as
+`awaiting Human validation` rather than Human acceptance. During a Taskflow tool run, structured
 streaming state temporarily replaces the normal focus with the running top-level phase
 ID, such as `working ⟩ work-fragment`; promoted child IDs and generated output remain
 hidden. Visible assistant text moves it to `answering`; settling with selected work
@@ -128,7 +117,7 @@ operation transitions to bounded recovery. This prevents a completed command fro
 looking permanently active while Pi prepares its next action. A Ctrl-C assistant stop
 reason moves it to `aborted` and remains visible until the next turn resets it to
 `understanding`. Legacy work titles still preserve the existing explicit fallback states for compatible
-consumers. The additive selection field contains only an exact OpenSpec Task, Goal, or
+consumers. The additive selection field contains only an exact OpenSpec Task or
 Session Work; otherwise it is `null`, so the deck renders a stable dim `󰓾 —`. `Direct
 response` is never presented as selection and Human prompt text is never copied into it.
 
@@ -181,7 +170,7 @@ Aggregate portfolio progress is independent of focus and remains visible as:
 It occupies the right side of footer row one, opposite the full PWD and Git state. It
 updates from `openspec list --json`; task-list `` replaces `Plans` and notebook ``
 replaces `Tasks`. If no OpenSpec portfolio exists, the slot prefers compact active scope
-(`󰊕 Goal`, then `▶ Focus` or `◇ Validate`) before falling back to dim ` no OpenSpec`.
+(`▶ Focus` or `◇ Validate`) before falling back to dim ` no OpenSpec`.
 Focused-change metadata remains separate and does not replace these totals. The
 no-argument form reports the current focus without changing it. The matching tool calls
 are:
@@ -220,7 +209,7 @@ legacy focused-status producer also gives quiet state feedback:
 
 - actionable task work exists: dim `○ OpenSpec · no focus`
 - no actionable task work exists: dim `○ OpenSpec · clear`
-- no `openspec/` project exists: row one shows Goal or Focus when active, otherwise dim
+- no `openspec/` project exists: row one shows Focus when active, otherwise dim
   ` no OpenSpec`
 - OpenSpec status cannot be read: the last aggregate remains while focused status
   reports unavailable
@@ -282,7 +271,7 @@ A configured `orchestration.stateFile` takes precedence. Useful fields include `
 or node vocabulary is classified into an allowlisted title activity—understanding,
 inspection, synthesis, planning, skill proposal, mutation, implementation, change
 review, regression, verification, result review, recovery, waiting reason, or abort—and
-attached to the current OpenSpec, Goal, Session Work, or explicit empty focus. Task
+attached to the current OpenSpec, Session Work, or explicit empty focus. Task
 text, paths, generated prose, and promoted child IDs never enter the lifecycle title;
 unknown vocabulary produces no activity. The bounded top-level phase ID is the only
 exact Taskflow identifier shown. Named Taskflow runs invoked by the assistant through