projectinator 0.3.1 → 0.4.0

package/src/intake.ts

@@ -1,125 +0,0 @@
-// Intake — the PM's clarifying-questions step. Before planning a vague request,
-// the PM asks 2-4 short questions (each with suggested options) to pin down what
-// to build. A clear request returns no questions and skips straight to planning.
-//
-// Forced structured output, same discipline as pm.ts: one tool, permissive
-// schema, coerced/validated in code.
-
-import {
-  createAgentSession,
-  defineTool,
-} from "@earendil-works/pi-coding-agent";
-import { Type, type Static } from "typebox";
-import type { Backend, Provider } from "./types.js";
-import { findEntry } from "./registry.js";
-import { piRuntime, resolvePiModel } from "./executor.js"
-import { addSessionCost } from "./session-cost.js";
-
-const IntakeSchema = Type.Object(
-  {
-    needsClarification: Type.Boolean({ description: "true only if the request is too vague to plan well" }),
-    questions: Type.Array(
-      Type.Object(
-        {
-          question: Type.String({ description: "one short clarifying question" }),
-          options: Type.Array(Type.String(), { description: "2-4 concrete pickable answers; may be empty for free text" }),
-          multi: Type.Boolean({ description: "true if several options can apply at once" }),
-        },
-        { additionalProperties: true },
-      ),
-      { description: "empty when needsClarification is false; at most 4" },
-    ),
-  },
-  { additionalProperties: true },
-);
-type IntakeRaw = Static<typeof IntakeSchema>;
-
-export interface IntakeQuestion {
-  question: string;
-  options: string[];
-  multi: boolean;
-}
-
-function buildIntakeTool() {
-  let captured: IntakeRaw | undefined;
-  const tool = defineTool({
-    name: "submit_intake",
-    label: "Submit Intake",
-    description: "Submit whether clarification is needed and, if so, the clarifying questions. Call exactly once.",
-    parameters: IntakeSchema,
-    execute: async (_id, params) => {
-      captured = params as IntakeRaw;
-      return { content: [{ type: "text", text: `Intake: ${params.needsClarification ? `${params.questions.length} questions` : "clear"}.` }], details: {} };
-    },
-  });
-  return { tool, get: () => captured };
-}
-
-const SYSTEM = [
-  "You are the PROJECT MANAGER doing intake for a build request.",
-  "If the request already has enough detail to plan and build — its purpose and the",
-  "must-have features are clear or reasonably inferable — set needsClarification=false",
-  "and questions=[].",
-  "If it is vague (a bare template like 'landing page', a one-liner missing the",
-  "essentials), set needsClarification=true and produce 2-4 SHORT questions that most",
-  "reduce ambiguity: what the product/business actually is, a name, must-have",
-  "sections/features, and style. For each question give 2-4 concrete pickable options;",
-  "set multi=true when several can apply (e.g. which sections). Never more than 4",
-  "questions. Do not ask what you can reasonably assume. Call submit_intake exactly once.",
-].join("\n");
-
-export interface AssessOptions {
-  backend: Backend;
-  modelOverride?: { provider: Provider; model: string };
-}
-
-/** Ask the PM whether the request needs clarification; returns up to 4 questions
- *  (empty = clear enough to plan directly). Never throws — returns [] on trouble. */
-export async function assessIntake(idea: string, opts: AssessOptions): Promise<IntakeQuestion[]> {
-  const runtime = await piRuntime();
-  const { entry } = findEntry("plan", "mid");
-  const pick = opts.modelOverride ?? entry.byBackend[opts.backend];
-
-  try {
-    const model = resolvePiModel(runtime, pick.provider, pick.model);
-    const { tool, get } = buildIntakeTool();
-    const { session } = await createAgentSession({
-      model,
-      modelRuntime: runtime,
-      thinkingLevel: "low",
-      noTools: "all",
-      customTools: [tool],
-      tools: ["submit_intake"],
-    });
-    try {
-      await session.prompt(`${SYSTEM}\n\n--- REQUEST ---\n${idea}`);
-      let raw = get();
-      if (!raw) {
-        await session.prompt("Call submit_intake now.");
-        raw = get();
-      }
-      addSessionCost(session.getSessionStats().cost);
-      if (!raw || !raw.needsClarification) return [];
-      return (raw.questions ?? [])
-        .slice(0, 4)
-        .map((q) => ({
-          question: String(q.question ?? "").trim(),
-          options: (q.options ?? []).map((o) => String(o).trim()).filter(Boolean).slice(0, 6),
-          multi: !!q.multi,
-        }))
-        .filter((q) => q.question);
-    } finally {
-      session.dispose();
-    }
-  } catch {
-    return []; // never block a build on intake — fall through to planning
-  }
-}
-
-/** Fold the collected answers into the brief the PM will plan from. */
-export function enrichBrief(idea: string, answers: { question: string; answer: string }[]): string {
-  const kept = answers.filter((a) => a.answer.trim());
-  if (!kept.length) return idea;
-  const lines = kept.map((a) => `- ${a.question} ${a.answer.trim()}`);
-  return `${idea}\n\nClarifications from the requester:\n${lines.join("\n")}`;
-}

package/src/models.ts

@@ -1,175 +0,0 @@
-// Model pricing table. Rates USD per 1,000,000 tokens — copied verbatim from Pi's
-// bundled catalog (pi-coding-agent 0.85.1, Sept 2026); test/executor.test.ts pins every
-// entry against it. Shape mirrors Pi's models.json `cost` block.
-
-import type { Model } from "./types.js";
-import { findOpenRouterModel } from "./openrouter.js";
-
-export const MODELS: Record<string, Model> = {
-  // ---- OpenAI: GPT-5.6 family (prices cut Sept 2026; past 272k input costs 2x) ----
-  "gpt-5.6-sol": {
-    id: "gpt-5.6-sol",
-    provider: "openai",
-    name: "GPT-5.6 Sol",
-    contextWindow: 272_000,
-    cost: { input: 4, output: 20, cacheRead: 0.4, cacheWrite: 5, tiers: [{ inputTokensAbove: 272_000, input: 8, output: 30, cacheRead: 0.8, cacheWrite: 10 }] },
-  },
-  "gpt-5.6-terra": {
-    id: "gpt-5.6-terra",
-    provider: "openai",
-    name: "GPT-5.6 Terra",
-    contextWindow: 272_000,
-    cost: { input: 2, output: 12, cacheRead: 0.2, cacheWrite: 2.5, tiers: [{ inputTokensAbove: 272_000, input: 4, output: 18, cacheRead: 0.4, cacheWrite: 5 }] },
-  },
-  "gpt-5.6-luna": {
-    id: "gpt-5.6-luna",
-    provider: "openai",
-    name: "GPT-5.6 Luna",
-    contextWindow: 272_000,
-    cost: { input: 0.2, output: 1.2, cacheRead: 0.02, cacheWrite: 0.25, tiers: [{ inputTokensAbove: 272_000, input: 0.4, output: 1.8, cacheRead: 0.04, cacheWrite: 0.5 }] },
-  },
-
-  // ---- Anthropic: Claude ----
-  "claude-fable-5-1": {
-    id: "claude-fable-5-1",
-    provider: "anthropic",
-    name: "Claude Fable 5.1",
-    contextWindow: 1_000_000,
-    cost: { input: 10, output: 50, cacheRead: 0.25, cacheWrite: 12.5 },
-  },
-  "claude-fable-5": {
-    id: "claude-fable-5",
-    provider: "anthropic",
-    name: "Claude Fable 5",
-    contextWindow: 1_000_000,
-    cost: { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
-  },
-  "claude-opus-5": {
-    id: "claude-opus-5",
-    provider: "anthropic",
-    name: "Claude Opus 5",
-    contextWindow: 1_000_000,
-    cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
-  },
-  "claude-opus-4-8": {
-    id: "claude-opus-4-8",
-    provider: "anthropic",
-    name: "Claude Opus 4.8",
-    contextWindow: 1_000_000,
-    cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
-  },
-  "claude-sonnet-5": {
-    id: "claude-sonnet-5",
-    provider: "anthropic",
-    name: "Claude Sonnet 5",
-    contextWindow: 1_000_000,
-    cost: { input: 2, output: 10, cacheRead: 0.2, cacheWrite: 2.5 },
-  },
-  "claude-sonnet-4-6": {
-    id: "claude-sonnet-4-6",
-    provider: "anthropic",
-    name: "Claude Sonnet 4.6",
-    contextWindow: 1_000_000,
-    cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
-  },
-  "claude-haiku-4-5": {
-    id: "claude-haiku-4-5",
-    provider: "anthropic",
-    name: "Claude Haiku 4.5",
-    contextWindow: 200_000,
-    cost: { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 },
-  },
-
-  // ---- Google: Gemini ----
-  // NOTE: ids match Pi's built-in registry exactly (provider "google"), so they
-  // resolve directly via ModelRegistry.find() with no alias layer.
-  "gemini-3.1-pro-preview": {
-    id: "gemini-3.1-pro-preview",
-    provider: "google",
-    name: "Gemini 3.1 Pro",
-    contextWindow: 1_000_000,
-    cost: {
-      input: 2,
-      output: 12,
-      cacheRead: 0.2,
-      cacheWrite: 2.5,
-      // Google charges more past 200k input tokens.
-      tiers: [{ inputTokensAbove: 200_000, input: 4, output: 18, cacheRead: 0.4, cacheWrite: 5 }],
-    },
-  },
-  "gemini-3.8-flash": {
-    id: "gemini-3.8-flash",
-    provider: "google",
-    name: "Gemini 3.8 Flash",
-    contextWindow: 1_000_000,
-    cost: { input: 0.75, output: 3.75, cacheRead: 0.075 },
-  },
-  "gemini-3-flash-preview": {
-    id: "gemini-3-flash-preview",
-    provider: "google",
-    name: "Gemini 3 Flash",
-    contextWindow: 1_000_000,
-    cost: { input: 0.5, output: 3, cacheRead: 0.05, cacheWrite: 0.625 },
-  },
-
-  // ---- OpenRouter (one key → frontier models). ids are Pi's OpenRouter-catalog
-  // slugs (vendor/model). Pricing mirrors the underlying model (OpenRouter passes
-  // it through, ~small margin); ACTUAL cost still comes from Pi per run.
-  "anthropic/claude-opus-5": {
-    id: "anthropic/claude-opus-5",
-    provider: "openrouter",
-    name: "Claude Opus 5 (OpenRouter)",
-    contextWindow: 1_000_000,
-    cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
-  },
-  "anthropic/claude-opus-4.8": {
-    id: "anthropic/claude-opus-4.8",
-    provider: "openrouter",
-    name: "Claude Opus 4.8 (OpenRouter)",
-    contextWindow: 1_000_000,
-    cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
-  },
-  "anthropic/claude-sonnet-5": {
-    id: "anthropic/claude-sonnet-5",
-    provider: "openrouter",
-    name: "Claude Sonnet 5 (OpenRouter)",
-    contextWindow: 1_000_000,
-    cost: { input: 2, output: 10, cacheRead: 0.2, cacheWrite: 2.5 },
-  },
-  "anthropic/claude-sonnet-4.6": {
-    id: "anthropic/claude-sonnet-4.6",
-    provider: "openrouter",
-    name: "Claude Sonnet 4.6 (OpenRouter)",
-    contextWindow: 1_000_000,
-    cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
-  },
-  "google/gemini-3.8-flash": {
-    id: "google/gemini-3.8-flash",
-    provider: "openrouter",
-    name: "Gemini 3.8 Flash (OpenRouter)",
-    contextWindow: 1_000_000,
-    cost: { input: 0.75, output: 3.75, cacheRead: 0.075 },
-  },
-  "openai/gpt-5.6-luna": {
-    id: "openai/gpt-5.6-luna",
-    provider: "openrouter",
-    name: "GPT-5.6 Luna (OpenRouter)",
-    contextWindow: 1_050_000,
-    cost: { input: 0.2, output: 1.2, cacheRead: 0.02, cacheWrite: 0.25 },
-  },
-};
-
-export function getModel(id: string): Model {
-  const m = MODELS[id];
-  if (m) return m;
-  // OpenRouter slugs (vendor/model) aren't in the static table — price them from
-  // the OpenRouter catalog (live cache or Pi's built-in list). Fall back to a
-  // rough estimate so a build never crashes on an unpriced model (actual cost
-  // still comes from Pi per run).
-  if (id.includes("/")) {
-    const or = findOpenRouterModel(id);
-    if (or) return { ...or, provider: "openrouter" };
-    return { id, provider: "openrouter", name: id, contextWindow: 200_000, cost: { input: 1, output: 3, cacheRead: 0.1, cacheWrite: 1.25 } };
-  }
-  throw new Error(`Unknown model id: "${id}". Add it to src/models.ts.`);
-}

package/src/narrate.ts

@@ -1,87 +0,0 @@
-// AI narrative for a build retro. Feeds the data-driven RetroReport to a model
-// and gets back a short "what went well / what to improve" write-up. On-demand
-// (costs a small call) and cached on the build state by the caller.
-
-import {
-  createAgentSession,
-  type AgentSession,
-} from "@earendil-works/pi-coding-agent";
-import type { Backend, Provider } from "./types.js";
-import type { RetroReport } from "./retro.js";
-import { findEntry } from "./registry.js";
-import { piRuntime, resolvePiModel } from "./executor.js"
-import { addSessionCost } from "./session-cost.js";
-
-function lastAssistantText(session: AgentSession): string {
-  const msgs = session.messages as Array<{ role?: string; content?: unknown }>;
-  for (let i = msgs.length - 1; i >= 0; i--) {
-    const m = msgs[i];
-    if (m?.role !== "assistant") continue;
-    const c = m.content;
-    if (typeof c === "string") return c;
-    if (Array.isArray(c)) {
-      return c
-        .map((p: unknown) => (typeof p === "string" ? p : p && typeof p === "object" && "text" in p ? String((p as { text: unknown }).text) : ""))
-        .join("")
-        .trim();
-    }
-  }
-  return "";
-}
-
-/** Compact fact sheet the model reasons over — numbers, not prose. */
-function facts(r: RetroReport): string {
-  const lines = [
-    `Idea: ${r.idea}`,
-    `Status: ${r.status}. Tasks done: ${r.doneCount}/${r.taskCount}.`,
-    `Cost: predicted $${r.estCost.toFixed(2)}, actual $${r.totalCost.toFixed(2)}.`,
-    `Tests: ${r.tests.passed} passed, ${r.tests.failed} failed.`,
-    r.retries.length ? `Rebuilds: ${r.retries.map((x) => `${x.taskId}×${x.rounds}`).join(", ")}.` : "Rebuilds: none.",
-    `Cost by epic: ${r.byEpic.map((e) => `${e.epic} $${e.cost}`).join(", ") || "n/a"}.`,
-    `Cost by model: ${r.byModel.map((m) => `${m.model} $${m.cost} (${m.tasks})`).join(", ") || "n/a"}.`,
-    `Priciest tasks: ${r.topCost.map((t) => `${t.taskId} $${t.cost}`).join(", ") || "n/a"}.`,
-    r.bugs.length
-      ? `Tester flags: ${r.bugs.map((b) => `[${b.severity}] ${b.description}`).slice(0, 6).join("; ")}.`
-      : "Tester flags: none.",
-  ];
-  return lines.join("\n");
-}
-
-const PROMPT = [
-  "You are a pragmatic engineering lead writing a SHORT retro for this build.",
-  "Use the facts below — reference the actual numbers. Do not invent anything.",
-  "Write exactly three sections, terse bullets, under 140 words total:",
-  "**What went well** (2-3 bullets)",
-  "**What to improve** (2-3 bullets)",
-  "**Next time** (one line)",
-  "No preamble, no closing remarks.",
-].join("\n");
-
-export interface NarrateOptions {
-  backend: Backend;
-  modelOverride?: { provider: Provider; model: string };
-}
-
-/** Generate the narrative. Throws on failure (caller shows the error). */
-export async function narrateRetro(report: RetroReport, opts: NarrateOptions): Promise<string> {
-  const runtime = await piRuntime();
-  const { entry } = findEntry("plan", "mid");
-  const pick = opts.modelOverride ?? entry.byBackend[opts.backend];
-  const model = resolvePiModel(runtime, pick.provider, pick.model);
-
-  const { session } = await createAgentSession({
-    model,
-    modelRuntime: runtime,
-    thinkingLevel: "low",
-    noTools: "all",
-  });
-  try {
-    await session.prompt(`${PROMPT}\n\n--- FACTS ---\n${facts(report)}`);
-    const text = lastAssistantText(session);
-    if (!text) throw new Error("The model returned no narrative.");
-    return text;
-  } finally {
-    addSessionCost(session.getSessionStats().cost);
-    session.dispose();
-  }
-}

package/src/openrouter.ts

@@ -1,119 +0,0 @@
-// The OpenRouter model catalog — so users can pick ANY OpenRouter model by name
-// (Kimi, DeepSeek, Qwen, …) instead of typing slugs.
-//
-//  - refreshOpenRouterModels(): live-fetch openrouter.ai/api/v1/models (freshest
-//    names + pricing), cache to disk. Falls back to Pi's built-in OR catalog.
-//  - openRouterModels() / findOpenRouterModel(): SYNC reads (disk cache, else Pi's
-//    built-in list) so cost estimation (getModel) can price any picked model.
-
-import { piRuntime } from "./executor.js";
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import type { Model, ModelCost } from "./types.js";
-
-/** A pickable OpenRouter model: our Model shape minus the provider (always "openrouter"). */
-export type ORModel = Omit<Model, "provider">;
-
-const CACHE = join(homedir(), ".projectinator", "openrouter-models.json");
-
-let builtinMemo: ORModel[] | null = null;
-let diskMemo: ORModel[] | null | undefined; // undefined = not read yet, null = no cache
-
-/** Pi's built-in OpenRouter catalog — offline, names + pricing. Sync read of the memo;
- *  call warmBuiltinOpenRouterModels() once at startup to fill it (Pi's runtime is async). */
-export function builtinOpenRouterModels(): ORModel[] {
-  return builtinMemo ?? [];
-}
-
-/** Load Pi's built-in OpenRouter list into the memo. Safe to call repeatedly. */
-export async function warmBuiltinOpenRouterModels(): Promise<ORModel[]> {
-  if (builtinMemo) return builtinMemo;
-  try {
-    const runtime = await piRuntime();
-    builtinMemo = runtime
-      .getModels("openrouter")
-      .filter((m) => !!m.cost)
-      .map((m) => ({
-        id: m.id,
-        name: m.name ?? m.id,
-        contextWindow: m.contextWindow ?? 200_000,
-        cost: m.cost,
-      }))
-      .sort((a, b) => a.name.localeCompare(b.name));
-  } catch {
-    builtinMemo = [];
-  }
-  return builtinMemo;
-}
-
-function readDiskCache(): ORModel[] | null {
-  if (diskMemo !== undefined) return diskMemo;
-  try {
-    if (existsSync(CACHE)) {
-      const parsed = JSON.parse(readFileSync(CACHE, "utf8")) as { models?: ORModel[] };
-      diskMemo = Array.isArray(parsed.models) && parsed.models.length ? parsed.models : null;
-    } else diskMemo = null;
-  } catch {
-    diskMemo = null;
-  }
-  return diskMemo;
-}
-
-/** The list to show / price against: live-fetched disk cache if present, else Pi's built-in. */
-export function openRouterModels(): ORModel[] {
-  const cached = readDiskCache();
-  return cached && cached.length ? cached : builtinOpenRouterModels();
-}
-
-/** Look up one model's pricing/name by slug (cache first, then built-in). Sync. */
-export function findOpenRouterModel(id: string): ORModel | undefined {
-  return openRouterModels().find((m) => m.id === id) ?? builtinOpenRouterModels().find((m) => m.id === id);
-}
-
-/** Map OpenRouter's API pricing (USD per token, strings) to our per-1M-token cost. */
-function mapApiModel(m: {
-  id: string;
-  name?: string;
-  context_length?: number;
-  pricing?: { prompt?: string; completion?: string; input_cache_read?: string; input_cache_write?: string };
-}): ORModel | null {
-  const p = m.pricing ?? {};
-  const input = Number(p.prompt) * 1e6;
-  const output = Number(p.completion) * 1e6;
-  if (!Number.isFinite(input) || !Number.isFinite(output)) return null;
-  const cacheRead = p.input_cache_read != null ? Number(p.input_cache_read) * 1e6 : input * 0.1;
-  const cacheWrite = p.input_cache_write != null ? Number(p.input_cache_write) * 1e6 : input * 1.25;
-  return {
-    id: m.id,
-    name: m.name ?? m.id,
-    contextWindow: m.context_length ?? 200_000,
-    cost: { input, output, cacheRead, cacheWrite },
-  };
-}
-
-/** Live-fetch the catalog and cache it. Falls back to the current list on any failure. */
-export async function refreshOpenRouterModels(timeoutMs = 8000): Promise<ORModel[]> {
-  const ctrl = new AbortController();
-  const timer = setTimeout(() => ctrl.abort(), timeoutMs);
-  try {
-    const res = await fetch("https://openrouter.ai/api/v1/models", { signal: ctrl.signal });
-    if (!res.ok) return openRouterModels();
-    const json = (await res.json()) as { data?: Array<Parameters<typeof mapApiModel>[0]> };
-    const list = (json.data ?? []).map(mapApiModel).filter((m): m is ORModel => m !== null)
-      .sort((a, b) => a.name.localeCompare(b.name));
-    if (list.length) {
-      try {
-        mkdirSync(join(homedir(), ".projectinator"), { recursive: true });
-        writeFileSync(CACHE, JSON.stringify({ fetchedAt: Date.now(), models: list }));
-        diskMemo = list;
-      } catch { /* cache write is best-effort */ }
-      return list;
-    }
-    return openRouterModels();
-  } catch {
-    return openRouterModels();
-  } finally {
-    clearTimeout(timer);
-  }
-}