import type { C1ProjectOverviewPayload, C1TaskFixturePayload, SurfaceState } from "./model.js"; import { escapeHtml, titleCase } from "./html.js"; import { withQuery } from "./router.js"; import type { AccountListItem } from "./render-accounts.js"; const projectTabs = [ "overview", "vision", "goals", "plans", "work", "factory-runs", "reviews", "decisions", "ci", "delivery", "settings", ] as const; const projectNavGroups = (projectId: string) => [ [ "Home", [ ["Overview", `/projects/${projectId}`, "▣"], ["Needs your attention", "#attention", "♧"], ], ], [ "Work", [ ["Projects", "/projects", "▣"], ["Plans", `/projects/${projectId}?tab=plans`, "≋"], ["Accounts", `/accounts?project=${projectId}`, "◎"], ["Work Items", `/projects/${projectId}?tab=work`, "≋"], ["Queue (Next Up)", `/projects/${projectId}/queue`, "≋"], ["Saved views", "#planned-saved", "≋"], ], ], [ "Execution", [ ["FactoryRuns", `/projects/${projectId}?tab=factory-runs`, "◷"], ["Agents", `/projects/${projectId}?tab=factory-runs`, "◉"], ["CI", "#planned-ci", "⊙"], ], ], [ "Delivery", [ ["Releases / Changes", `/projects/${projectId}?tab=reviews`, "⌘"], ["Deployments", "#planned-deployments", "◇"], ], ], [ "Operations", [ ["Queues", `/projects/${projectId}/queue`, "≋"], ["Health", "#planned-health", "⌁"], ], ], [ "Intelligence", [ ["Reports", "#planned-reports", "▥"], ["Analytics", "#planned-analytics", "◉"], ], ], ["Settings", [["Project Settings", `/projects/${projectId}?tab=settings`, "⚙"]]], ] as const; const stateTone = (state: string): string => { if (["active", "achieved", "completed", "DONE"].includes(state)) return "green"; if (["ready", "running", "READY", "RUNNING"].includes(state)) return "blue"; if (["blocked", "BLOCKED_DEPENDENCY", "BLOCKED_POLICY"].includes(state)) return "red"; if (["waiting", "WAITING_USER", "paused", "PAUSED"].includes(state)) return "amber"; return "purple"; }; const skeletonPanels = (): string => `
${["Current Goals", "Needs Your Attention", "Blockers"].map((title) => `
${title}
`).join("")}
${["Active Plans", "FactoryRuns", "Recently Completed"].map((title) => `
${title}
`).join("")}
Queue / Next Up
`; const emptyPanel = (title: string, text: string, action?: string): string => `
${title}
${text}${action ? `` : ""}
`; const projectSidebar = ( projectId: string, ): string => ``; const projectTopbar = (name: string): string => `
WORK/Projects/${escapeHtml(name)}
OwnerProduct Owner
`; const repositoryLabel = (repositoryUrl: string): string => { try { const parsed = new URL(repositoryUrl); return `${parsed.host}${parsed.pathname}`.replace(/\.git$/u, "").replace(/^github\.com\//u, ""); } catch { return repositoryUrl; } }; const projectHeader = ( project: C1ProjectOverviewPayload["project"], tab: string, mutationsDisabled: boolean, ): string => `
${escapeHtml(project.name)}☆
Agentic software delivery project
▣ ${escapeHtml(repositoryLabel(project.repositoryUrl))}•Canonical Project ${escapeHtml(project.id)}•Status: ${titleCase(project.status)}
◎ Accounts⚖ Decisions I3
`; const projectStateBanner = (state: SurfaceState): string => { if (state === "stale") return `
Project data is staleLast-known state is readable. Protected changes are disabled until refresh confirms current authority.
`; if (state === "error") return ``; if (state === "permission") return `
Read-only Project accessYour current Principal can inspect this Project but cannot execute protected actions.
`; return ""; }; const goalsPanel = (model: C1ProjectOverviewPayload): string => `
◎ Current Goals
${model.goals.map((goal) => `${escapeHtml(goal.title)}${titleCase(goal.status)}`).join("")}
View all goals →
`; const attentionPanel = ( model: C1ProjectOverviewPayload, accounts: readonly AccountListItem[], mutationsDisabled: boolean, ): string => { const draftPlans = model.plans.filter((plan) => plan.status === "draft"); const items: Array<{ title: string; description: string; href: string; action: string; priority: "High" | "Medium"; }> = []; if (draftPlans.length > 0 && accounts.length === 0) { items.push({ title: "Execution account required", description: `${draftPlans.length} draft Plan${draftPlans.length === 1 ? " is" : "s are"} waiting for an account before owner approval can start a real FactoryRun.`, href: `/accounts?project=${encodeURIComponent(model.project.id)}`, action: "Add account", priority: "High", }); } else { for (const plan of draftPlans) { items.push({ title: `Approve & start ${plan.title}`, description: "A draft Plan is ready for the explicit owner launch boundary. Execution after approval remains autonomous.", href: `/projects/${encodeURIComponent(model.project.id)}?tab=plans#${encodeURIComponent(plan.id)}`, action: "Review Plan", priority: "Medium", }); } } if (items.length === 0) return `
△ Needs Your Attention0
No owner action requiredCurrent I1 Project state has no active owner authority boundary.
`; return `
△ Needs Your Attention${items.length}
${items .map( (item) => `
${escapeHtml(item.title)}
${escapeHtml(item.description)}
${item.priority}${mutationsDisabled ? 'Unavailable' : `${escapeHtml(item.action)}`}
`, ) .join("")}
`; }; const blockersPanel = ( model: C1ProjectOverviewPayload, tasks: readonly C1TaskFixturePayload[], ): string => { const blocked = model.queue.filter((entry) => entry.readinessState.startsWith("BLOCKED")); if (blocked.length === 0) return `
▣ Blockers0
No blocked TasksCurrent C1 queue projection has no dependency or policy blocker.
View Queue / Graph →
`; return `
▣ Blockers${blocked.length}
${blocked .map((entry) => { const task = tasks.find((item) => item.id === entry.taskId); return `
${escapeHtml(task?.title ?? entry.taskId)}
Blocked by ${entry.unsatisfiedDependencyIds.map(escapeHtml).join(", ") || "authoritative policy"}.
Next: satisfy the authoritative prerequisite
`; }) .join("")}
`; }; const plansPanel = (model: C1ProjectOverviewPayload): string => `
Active PlansView all plans →
${model.plans.map((plan) => ``).join("")}
Active Plans
PlanProgressStatusGoal linkage
${escapeHtml(plan.title)}—${titleCase(plan.status)}${plan.goalIds.length} Goal${plan.goalIds.length === 1 ? "" : "s"}
`; const planLaunchPanel = ( model: C1ProjectOverviewPayload, accounts: readonly AccountListItem[], mutationsDisabled: boolean, ): string => { const draftPlans = model.plans.filter((plan) => plan.status === "draft"); if (draftPlans.length === 0) { return `
Run setup
No draft Plan is waiting to start.Approved or completed Plans retain their recorded execution provenance.
`; } if (accounts.length === 0) { return `
Run setup
An account is required before the first real FactoryRun.The dedicated K3s Subrouter has no available accounts. No fixture account will be substituted.＋ Add account
`; } const options = accounts .map( (account) => ``, ) .join(""); return `
Run setupManage accounts →
${draftPlans .map( (plan) => `
${escapeHtml(plan.title)} · selected account will be written to Attempt provenance and preserved across automatic task dispatch.
`, ) .join('
')}
`; }; const projectMutationPanel = ( model: C1ProjectOverviewPayload, tasks: readonly C1TaskFixturePayload[], tab: string, mutationsDisabled: boolean, visionSummary?: string, ): string => { const projectId = encodeURIComponent(model.project.id); const disabled = mutationsDisabled ? ' disabled aria-disabled="true"' : ""; if (tab === "vision") { return `
ProjectVision
`; } if (tab === "goals") { return `
Create Goal
`; } if (tab !== "plans") return ""; const dependencyRows = tasks .map((task) => { const options = tasks .filter((candidate) => candidate.id !== task.id) .map( (candidate) => ``, ) .join(""); const prerequisites = task.dependencyIds.length ? task.dependencyIds .map((id) => tasks.find((candidate) => candidate.id === id)?.title ?? id) .map(escapeHtml) .join(", ") : "none"; return `
${escapeHtml(task.title)}${titleCase(task.status)}Prerequisites: ${prerequisites}
${options ? `
` : ""}
`; }) .join(""); return `
Plan authoring
${dependencyRows ? `
Task dependencies
${dependencyRows}
` : ""}
`; }; const factoryPanel = (model: C1ProjectOverviewPayload): string => `
FactoryRuns (What's running now)View all →
${model.factoryRuns.map((run) => ``).join("")}
Current FactoryRuns
Run IDStatusReasonProvider detail
${escapeHtml(run.id)}${titleCase(run.status)}${escapeHtml(run.reason ?? "—")}See FactoryRun
Open FactoryRuns →
`; const completedPanel = (tasks: readonly C1TaskFixturePayload[]): string => { const completed = tasks.filter((task) => task.status === "completed"); return `
Recently Completed
${completed.map((task) => ``).join("")}
Recently completed work
TaskStateRevision
${escapeHtml(task.title)}Completedr${task.revision}
${completed.length === 0 ? '
No completed work yet.
' : ""}
`; }; const queuePanel = ( model: C1ProjectOverviewPayload, tasks: readonly C1TaskFixturePayload[], ): string => { const groups = [ ["Now (Ready)", ["READY", "RUNNING"], "green"], ["Next", ["BLOCKED_DEPENDENCY"], "blue"], ["Later", ["PAUSED"], "purple"], ["Waiting (External)", ["WAITING_USER"], "amber"], ["Blocked", ["BLOCKED_POLICY"], "red"], ] as const; return `
Queue / Next Up (What is to be done soon)View full queue →
${groups .map(([name, states, tone]) => { const entries = model.queue.filter((entry) => states.includes(entry.readinessState as never)); return `
${name}${entries.length}
${ entries.length ? entries .map((entry) => { const task = tasks.find((item) => item.id === entry.taskId); return `${entry.position + 1}${escapeHtml(task?.title ?? entry.taskId)}${escapeHtml(entry.planRevisionId)}`; }) .join("") : '
No work
' }
`; }) .join("")}
`; }; export function renderProjectOverview( model: C1ProjectOverviewPayload, tasks: readonly C1TaskFixturePayload[], requestedState: string, tab = "overview", runAccounts: readonly AccountListItem[] = [], visionSummary?: string, ): string { const state = (["ready", "loading", "error", "stale", "permission", "empty"] as const).includes( requestedState as SurfaceState, ) ? (requestedState as SurfaceState) : "ready"; const mutationsDisabled = state === "stale" || state === "permission" || state === "error"; const header = `${projectSidebar(model.project.id)}
${projectTopbar(model.project.name)}${projectHeader(model.project, tab, mutationsDisabled)}`; if (state === "loading") return `
${header}${skeletonPanels()}
`; if (state === "empty") { const emptyModel = { ...model, goals: [], plans: [], queue: [], factoryRuns: [], } satisfies C1ProjectOverviewPayload; return `
${header}
New ProjectNo Goals, Plans, queueable Tasks, or FactoryRuns exist yet.
${emptyPanel("Current Goals", "No active Goals yet")}${emptyPanel("Needs Your Attention", "Nothing needs attention")}${emptyPanel("Blockers", "No blockers")}
${emptyPanel("Active Plans", "No Plans yet", mutationsDisabled ? undefined : "＋ New Plan")}${emptyPanel("FactoryRuns", "No FactoryRuns yet")}${emptyPanel("Recently Completed", "No completed work yet")}
${queuePanel(emptyModel, [])}
`; } const mutations = projectMutationPanel(model, tasks, tab, mutationsDisabled, visionSummary); const runSetup = tab === "plans" ? planLaunchPanel(model, runAccounts, mutationsDisabled) : ""; return `
${header}
${projectStateBanner(state)}${mutations}${runSetup}
${goalsPanel(model)}${attentionPanel(model, runAccounts, mutationsDisabled)}${blockersPanel(model, tasks)}
${plansPanel(model)}${factoryPanel(model)}${completedPanel(tasks)}
${queuePanel(model, tasks)}
`; }