@dieulc/workflow 0.9.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dieulc/workflow",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "type": "module",
   "private": false,
   "keywords": ["pi-package", "workflow", "plan-mode", "review-mode", "questionnaire", "rewind"],
@@ -9,7 +9,8 @@
   "scripts": {
     "test": "node --test utils.todo.test.ts permissions.test.ts roles.test.ts profiles.test.ts thinking-levels.test.ts workflow-status.test.ts picker.test.ts questionnaire-layout.test.ts questionnaire-view.test.ts model-default.test.ts review.test.ts review-ui.test.ts extension.test.ts commit-policy.test.ts edit-policy.test.ts tab-policy.test.ts tab-editor.test.ts",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "check:policy": "node --experimental-transform-types scripts/verify-write-policy.mjs"
+    "check:policy": "node --experimental-transform-types scripts/verify-write-policy.mjs",
+    "prepublishOnly": "node ../../../scripts/verify-packages.mjs --pack-only --packages workflow"
   },
   "repository": {
     "type": "git",
@@ -34,6 +35,8 @@
     "picker.ts",
     "tab-policy.ts",
     "tab-editor.ts",
+    "thinking-levels.ts",
+    "workflow-status.ts",
     "questionnaire-layout.ts",
     "questionnaire-view.ts",
     "model-default.ts",

package/thinking-levels.ts

@@ -0,0 +1,67 @@
+/**
+ * Model-aware thinking levels for the role/profile editors (2026-10-31 UI plan).
+ *
+ * Pi's `getSupportedThinkingLevels` is the authority. The editors used to list
+ * every level (`VALID_THINKING_LEVELS`) for every model, so a profile could
+ * store `medium` for a model whose map makes it unsupported; Pi then silently
+ * clamped it on activation. These helpers keep the staged value inside the
+ * model's set and fall back to the full list only when the model is unknown
+ * (offline editing, hand-edited files) so a missing registry entry never
+ * blocks the picker.
+ */
+
+import {
+  clampThinkingLevel,
+  getSupportedThinkingLevels,
+} from "@earendil-works/pi-ai";
+
+import { VALID_THINKING_LEVELS, type ThinkingLevel } from "./roles.ts";
+
+function isKnownModel(model: unknown): model is Record<string, unknown> {
+  if (!model || typeof model !== "object") return false;
+  const record = model as Record<string, unknown>;
+  return typeof record.reasoning === "boolean";
+}
+
+function asThinkingLevel(value: string): ThinkingLevel | null {
+  return (VALID_THINKING_LEVELS as readonly string[]).includes(value)
+    ? (value as ThinkingLevel)
+    : null;
+}
+
+/** The model's supported levels, or all levels when the model is unknown. */
+export function thinkingLevelsForModel(model: unknown): ThinkingLevel[] {
+  if (!isKnownModel(model)) return [...VALID_THINKING_LEVELS];
+  try {
+    const levels = getSupportedThinkingLevels(model as never)
+      .map((level) => asThinkingLevel(String(level)))
+      .filter((level): level is ThinkingLevel => level !== null);
+    return levels.length > 0 ? levels : [...VALID_THINKING_LEVELS];
+  } catch {
+    return [...VALID_THINKING_LEVELS];
+  }
+}
+
+/** Clamp a stored level to the model's set (no-op for an unknown model). */
+export function clampThinkingForModel(model: unknown, level: ThinkingLevel): ThinkingLevel {
+  if (!isKnownModel(model)) return level;
+  try {
+    return asThinkingLevel(String(clampThinkingLevel(model as never, level))) ?? level;
+  } catch {
+    return level;
+  }
+}
+
+/** The pair an editor should stage after a model change / before a save. */
+export function thinkingLevelsForPair(
+  model: unknown,
+  level: ThinkingLevel,
+): { levels: ThinkingLevel[]; level: ThinkingLevel } {
+  const levels = thinkingLevelsForModel(model);
+  if (levels.includes(level)) return { levels, level };
+  const clamped = clampThinkingForModel(model, level);
+  return {
+    levels,
+    level: levels.includes(clamped) ? clamped : (levels[0] ?? level),
+  };
+}

package/workflow-status.ts

@@ -0,0 +1,81 @@
+/**
+ * Workflow footer segments (2026-10-31 UI plan, step 10).
+ *
+ * The extension used to publish one long `workflow` status containing the mode,
+ * progress, profile/role, commit/write policy and review text. Desktop hosts can
+ * only lay an arbitrary status string out as one column, and terminal Pi wraps
+ * the same line less efficiently. This module builds short, stable segments so
+ * each can be its own footer column.
+ *
+ * `workflow` stays the mode/progress string: it is what the Desktop parser
+ * (`src/shared/workflow-mode.ts`) and existing terminal Pi users already know.
+ * The other keys are additive.
+ */
+
+export const WORKFLOW_STATUS_KEYS = {
+  mode: "workflow",
+  profile: "workflow-profile",
+  policy: "workflow-policy",
+  review: "workflow-review",
+} as const;
+
+export interface WorkflowStatusInput {
+  mode: "build" | "plan" | null;
+  /** Plannotator's Plan sub-state, shown inside the mode segment. */
+  plannotatorActive?: boolean;
+  done: number;
+  total: number;
+  stale?: boolean;
+  profileLabel?: string;
+  roleLabel?: string;
+  commitMode: string;
+  /** Only Default mode has a write policy; null/undefined omits it. */
+  writeMode?: string | null;
+}
+
+export interface WorkflowStatusSegments {
+  mode: string;
+  profile: string;
+  policy: string;
+}
+
+export function buildWorkflowStatusSegments(
+  input: WorkflowStatusInput,
+): WorkflowStatusSegments {
+  const done = Number.isFinite(input.done) ? Math.max(0, input.done) : 0;
+  const total = Number.isFinite(input.total) ? Math.max(0, input.total) : 0;
+  const stale = input.stale ? " ⚠" : "";
+  const profile = [input.profileLabel ?? "", input.roleLabel ?? ""]
+    .map((part) => part.trim())
+    .filter(Boolean)
+    .join(" | ");
+  const policy =
+    `commits:${input.commitMode}` +
+    (input.writeMode ? ` · writes:${input.writeMode}` : "");
+
+  let mode: string;
+  if (input.mode === "build") {
+    mode = total > 0 ? `▶ build ${done}/${total}${stale}` : `▶ build${stale}`;
+  } else if (input.mode === "plan") {
+    const base = input.plannotatorActive
+      ? "⏸ plan — reviewing in browser"
+      : "⏸ plan";
+    mode = total > 0 ? `${base} ${done}/${total}${stale}` : `${base}${stale}`;
+  } else if (total > 0) {
+    // The default mode must stay parseable by the Desktop badge decoder.
+    mode = `◦ ${done}/${total}${stale}`;
+  } else {
+    mode = `◦ commits:${input.commitMode}${stale}`;
+  }
+
+  return { mode, profile, policy };
+}
+
+/** Sets a status only while it has text; `undefined` removes a stale key. */
+export function setWorkflowStatus(
+  ui: { setStatus?: (key: string, text: string | undefined) => void },
+  key: string,
+  text: string,
+): void {
+  ui.setStatus?.(key, text.length > 0 ? text : undefined);
+}