omegon 0.6.0

package/extensions/web-ui/types.ts

@@ -0,0 +1,284 @@
+/**
+ * ControlPlaneState — versioned read-only snapshot contract for the web UI.
+ *
+ * Served at GET /api/state and derived section routes.
+ * All fields are plain JSON-serialisable values — no Dates, no symbols.
+ */
+
+// ── Schema version ────────────────────────────────────────────────────────────
+
+/** Bumped when the shape of ControlPlaneState changes in a breaking way. */
+export const SCHEMA_VERSION = 2 as const;
+export type SchemaVersion = typeof SCHEMA_VERSION;
+
+// ── Session ───────────────────────────────────────────────────────────────────
+
+export interface SessionSnapshot {
+  /** ISO 8601 timestamp when the snapshot was generated. */
+  capturedAt: string;
+  /** Omegon package version (from package.json). */
+  piKitVersion: string;
+  /** Absolute path of the repository root (process.cwd() at extension load). */
+  repoRoot: string;
+  /** Current git branch, or null if not a git repo. */
+  gitBranch: string | null;
+}
+
+// ── Dashboard ─────────────────────────────────────────────────────────────────
+
+export interface DashboardSnapshot {
+  /** Current display mode. */
+  mode: string;
+  /** Number of conversation turns in the current session. */
+  turns: number;
+  /** Approximate token count of the last memory injection. */
+  memoryTokenEstimate: number;
+  /** Routing policy tier overrides, if any. */
+  routingPolicy: Record<string, unknown> | null;
+  /** Current effort level label, if effort extension is active. */
+  effortLevel: string | null;
+  /** Latest harness recovery event summary, if any. */
+  recovery: RecoverySnapshot | null;
+  /**
+   * Pinned operator-context metadata mirroring the raised-mode dashboard block.
+   * Exposes context/model/thinking and memory-oriented state structurally so
+   * web UI consumers do not need to parse footer or display text.
+   */
+  operatorMetadata: OperatorMetadataSnapshot;
+}
+
+export interface RecoverySnapshot {
+  provider: string;
+  modelId: string;
+  classification: string;
+  summary: string;
+  action: string;
+  retryCount: number | null;
+  timestamp: number;
+  escalated: boolean;
+  /**
+   * True when the recovery event represents a condition that may require
+   * operator attention or UI-level action (e.g. escalation, hard failover).
+   * False for passive/observe-only recovery events.
+   * Web UI consumers should use this flag instead of parsing action strings.
+   */
+  actionable: boolean;
+}
+
+/**
+ * Pinned operator-context metadata exposed by the raised-mode dashboard.
+ * Groups the context/model/thinking indicators and memory-oriented state so
+ * web UI consumers do not need to reverse-engineer values from footer text.
+ */
+export interface OperatorMetadataSnapshot {
+  /** Active effort tier name (e.g. "Ruthless"), or null if effort extension is inactive. */
+  effortName: string | null;
+  /** Numeric effort level 1-7, or null. */
+  effortLevel: number | null;
+  /** Driver model tier (e.g. "victory", "gloriana"), or null. */
+  driverTier: string | null;
+  /** Extended thinking level (e.g. "medium", "high"), or null. */
+  thinkingLevel: string | null;
+  /** Whether the effort level is ceiling-locked by an operator cap. */
+  effortCapped: boolean;
+  /** Approximate token count of the last memory injection. */
+  memoryTokenEstimate: number;
+  /** Number of facts in working memory during the last injection. */
+  workingMemoryCount: number | null;
+  /** Total fact count from the last injection (project + global + working). */
+  totalFactCount: number | null;
+}
+
+// ── Design Tree ───────────────────────────────────────────────────────────────
+
+export interface DesignTreeSnapshot {
+  /** Total node count. */
+  nodeCount: number;
+  /** Count by status. */
+  statusCounts: Record<string, number>;
+  /** Number of open questions across all nodes. */
+  openQuestionCount: number;
+  /** Currently focused node, or null. */
+  focusedNode: DesignNodeSummary | null;
+  /** Summary of every node in the tree. */
+  nodes: DesignNodeSummary[];
+  /** Design pipeline funnel counts, present when dual-lifecycle is active. */
+  designPipeline?: DesignPipelineSnapshot;
+}
+
+export interface DesignNodeSummary {
+  id: string;
+  title: string;
+  status: string;
+  parent: string | null;
+  questionCount: number;
+  questions: string[];
+  tags: string[];
+  openspecChange: string | null;
+  branch: string | null;
+  /** Linked design-phase OpenSpec change info, if any. */
+  designSpec: DesignSpecBinding | null;
+  /** Acceptance-criteria summary counts from the node document, if any. */
+  acSummary: ACSummary | null;
+  /** Latest design-spec assessment result, if any. */
+  assessmentResult: AssessmentResult | null;
+}
+
+/** Binding between a design node and its openspec/design/<nodeId>/ directory. */
+export interface DesignSpecBinding {
+  /** Relative path to the design change directory (openspec/design/<nodeId>/). */
+  changePath: string;
+  hasProposal: boolean;
+  hasSpec: boolean;
+  hasTasks: boolean;
+  hasAssessment: boolean;
+  tasksDone: number;
+  tasksTotal: number;
+  isArchived: boolean;
+}
+
+/** Acceptance-criteria counts parsed from the node's markdown document. */
+export interface ACSummary {
+  scenarios: number;
+  falsifiability: number;
+  constraints: number;
+}
+
+/** Latest assessment.json result for a design-spec change. */
+export interface AssessmentResult {
+  pass: boolean;
+  capturedAt: string;
+}
+
+// ── Design Pipeline ───────────────────────────────────────────────────────────
+
+/**
+ * A single design-phase change entry (openspec/design/<nodeId>/).
+ */
+export interface DesignChangeSummary {
+  nodeId: string;
+  changePath: string;
+  hasProposal: boolean;
+  hasSpec: boolean;
+  hasTasks: boolean;
+  hasAssessment: boolean;
+  assessmentPass: boolean | null;
+  capturedAt: string | null;
+  tasksDone: number;
+  tasksTotal: number;
+  isArchived: boolean;
+  archivedPath: string | undefined;
+}
+
+/**
+ * Funnel counts — how many design nodes have reached each lifecycle milestone.
+ */
+export interface DesignFunnelCounts {
+  /** Total design nodes. */
+  total: number;
+  /** Nodes with an openspec/design/<nodeId>/ binding. */
+  bound: number;
+  /** Bound nodes where tasksTotal > 0 and tasksDone >= tasksTotal. */
+  tasksComplete: number;
+  /** Bound nodes with a passing assessment. */
+  assessed: number;
+  /** Archived design-phase changes. */
+  archived: number;
+}
+
+/**
+ * Snapshot of the design-pipeline funnel.
+ * Top-level slice at GET /api/design-pipeline.
+ */
+export interface DesignPipelineSnapshot {
+  /** ISO 8601 timestamp when snapshot was generated. */
+  capturedAt: string;
+  /** All active + archived design-phase changes. */
+  changes: DesignChangeSummary[];
+  /** Funnel counts across the design tree. */
+  funnelCounts: DesignFunnelCounts;
+}
+
+// ── OpenSpec ──────────────────────────────────────────────────────────────────
+
+export interface OpenSpecSnapshot {
+  changes: OpenSpecChangeSummary[];
+}
+
+export interface OpenSpecChangeSummary {
+  name: string;
+  stage: string;
+  hasProposal: boolean;
+  hasDesign: boolean;
+  hasSpecs: boolean;
+  hasTasks: boolean;
+  tasksTotal: number;
+  tasksDone: number;
+  specDomains: string[];
+}
+
+// ── Cleave ────────────────────────────────────────────────────────────────────
+
+export interface CleaveSnapshot {
+  status: string;
+  runId: string | null;
+  children: CleaveChildSummary[];
+  updatedAt: number | null;
+}
+
+export interface CleaveChildSummary {
+  label: string;
+  status: string;
+  elapsed: number | null;
+}
+
+// ── Models ────────────────────────────────────────────────────────────────────
+
+export interface ModelsSnapshot {
+  routingPolicy: Record<string, unknown> | null;
+  effortLevel: string | null;
+  effortCapped: boolean;
+  resolvedExtractionModelId: string | null;
+}
+
+// ── Memory ────────────────────────────────────────────────────────────────────
+
+export interface MemorySnapshot {
+  tokenEstimate: number;
+  lastInjection: MemoryInjectionSummary | null;
+}
+
+export interface MemoryInjectionSummary {
+  factCount: number;
+  episodeCount: number;
+  workingMemoryCount: number;
+  totalTokens: number;
+}
+
+// ── Health ────────────────────────────────────────────────────────────────────
+
+export interface HealthSnapshot {
+  status: "ok";
+  uptimeMs: number;
+  /** Whether the web UI server itself is considered healthy. */
+  serverAlive: boolean;
+}
+
+// ── Root ──────────────────────────────────────────────────────────────────────
+
+/**
+ * Top-level versioned control-plane state snapshot.
+ * Served at GET /api/state.
+ */
+export interface ControlPlaneState {
+  schemaVersion: SchemaVersion;
+  session: SessionSnapshot;
+  dashboard: DashboardSnapshot;
+  designTree: DesignTreeSnapshot;
+  openspec: OpenSpecSnapshot;
+  cleave: CleaveSnapshot;
+  models: ModelsSnapshot;
+  memory: MemorySnapshot;
+  health: HealthSnapshot;
+  designPipeline: DesignPipelineSnapshot;
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+	"name": "omegon",
+	"version": "0.6.0",
+	"description": "Omegon — agent-native software engineering platform: lifecycle management, memory, orchestration, and visualization for the pi coding agent",
+	"bin": {
+		"pi": "bin/pi.mjs"
+	},
+	"type": "module",
+	"scripts": {
+		"test": "npx tsx --test tests/*.test.ts extensions/**/*.test.ts",
+		"typecheck": "tsc --noEmit",
+		"check:lifecycle": "npx tsx extensions/openspec/lifecycle-files.ts",
+		"check": "tsc --noEmit && npm run check:lifecycle && npx tsx --test extensions/*.test.ts extensions/**/*.test.ts",
+		"build:pi": "cd vendor/pi-mono && npm run build",
+		"update:pi": "git -C vendor/pi-mono pull --ff-only origin main && npm run build:pi",
+		"setup": "git submodule update --init --recursive && cd vendor/pi-mono && npm install && npm run build && cd ../.. && npm link --force"
+	},
+	"keywords": [
+		"pi-package",
+		"coding-agent",
+		"cli"
+	],
+	"author": "cwilson613",
+	"license": "ISC",
+	"pi": {
+		"extensions": [
+			"./extensions/bootstrap",
+			"./extensions/core-renderers.ts",
+			"./extensions/auto-compact.ts",
+			"./extensions/00-secrets",
+			"./extensions/01-auth",
+			"./extensions/chronos",
+			"./extensions/cleave",
+			"./extensions/openspec",
+			"./extensions/defaults.ts",
+			"./extensions/distill.ts",
+			"./extensions/render",
+			"./extensions/local-inference",
+			"./extensions/mcp-bridge",
+			"./extensions/offline-driver.ts",
+			"./extensions/effort",
+			"./extensions/model-budget.ts",
+			"./extensions/project-memory",
+			"./extensions/session-log.ts",
+			"./extensions/spinner-verbs.ts",
+			"./extensions/style.ts",
+			"./extensions/terminal-title.ts",
+			"./extensions/view",
+			"./extensions/web-search",
+			"./extensions/design-tree",
+			"./extensions/dashboard",
+			"./extensions/tool-profile",
+			"./extensions/vault",
+			"./extensions/version-check.ts",
+			"./extensions/web-ui"
+		],
+		"skills": [
+			"./skills"
+		],
+		"prompts": [
+			"./prompts"
+		]
+	},
+	"dependencies": {
+		"@cwilson613/pi-coding-agent": "^0.57.1-cwilson613.2",
+		"@cwilson613/pi-ai": "^0.57.1-cwilson613.2",
+		"@cwilson613/pi-tui": "^0.57.1-cwilson613.2",
+		"@modelcontextprotocol/sdk": "^1.12.1",
+		"@resvg/resvg-js": "^2.6.2",
+		"@sinclair/typebox": "^0.34.48",
+		"better-sqlite3": "^12.6.2"
+	},
+	"devDependencies": {
+		"typescript": "^5.9.3"
+	}
+}

package/prompts/init.md

@@ -0,0 +1,75 @@
+---
+description: First-session environment check — orient to a new project directory
+---
+# Project Init
+
+You are orienting to a project directory for the first time. Perform each step, then present a concise summary.
+
+## 1. Environment Scan
+
+```bash
+pwd
+ls -la
+```
+
+Check if this is a git repository:
+```bash
+git rev-parse --is-inside-work-tree 2>/dev/null && echo "GIT_REPO=yes" || echo "GIT_REPO=no"
+git remote -v 2>/dev/null
+git log --oneline -5 2>/dev/null
+```
+
+Detect project type (look for key files):
+```bash
+ls package.json pyproject.toml Cargo.toml go.mod Makefile Dockerfile *.sln 2>/dev/null
+```
+
+## 2. Initialize Memory
+
+Use `memory_query` to check if project memory already exists.
+
+- If **no facts exist**: this is truly a first session. Read key files (README, config files, project manifests) to understand the project. Use `memory_store` to persist 3-5 foundational facts about the project (language, structure, key abstractions).
+- If **facts exist**: this project has prior context. Skim the facts and skip to step 3.
+
+## 3. Check Tooling State
+
+Use `design_tree` action `list` to see if any design explorations exist.
+
+Check for design doc migration needs:
+```bash
+# If design docs with frontmatter (id/status) exist in docs/ instead of docs/design/,
+# suggest running /migrate to archive completed explorations
+ls docs/design/ 2>/dev/null || echo "NO_DESIGN_ARCHIVE"
+```
+
+If `docs/design/` doesn't exist but `docs/` has markdown files with design-tree frontmatter, note that `/migrate` is available to archive completed design docs.
+
+Check for OpenSpec changes:
+```bash
+ls openspec/changes/ 2>/dev/null
+```
+
+Check for active branches:
+```bash
+git branch --list 2>/dev/null | head -10
+```
+
+## 4. Present Summary
+
+Give the operator a **brief, scannable summary** (not a wall of text):
+
+```
+📍 <directory name> — <one-line description>
+   <language/framework> · <git status or "not a git repo">
+
+🧠 Memory: <N facts | fresh start>
+🌳 Design: <N nodes | none>
+📋 OpenSpec: <N active changes | none>
+🔀 Branch: <current branch>
+
+<If migration available: "📦 /migrate available — N design docs can be archived to docs/design/">
+<If first session: "Ready to explore. What are we building?">
+<If returning: "Welcome back. Pick up where we left off?">
+```
+
+Keep the summary under 10 lines. Do NOT dump file listings or memory contents — just the counts and orientation cues.

package/prompts/new-repo.md

@@ -0,0 +1,54 @@
+---
+description: Guided repository creation with identity awareness and org placement
+---
+# New Repository
+
+Guide through creating a new repository with proper identity awareness and placement.
+
+## Pre-flight: Identity Check
+
+```bash
+echo "Git user: $(git config user.name) <$(git config user.email)>"
+gh auth status
+gh api user -q '.login'
+gh api user/orgs -q '.[].login' 2>/dev/null || echo "(no orgs or limited scope)"
+```
+
+Present identity to user. If wrong, fix before proceeding.
+
+## Guided Questions
+
+Ask the user:
+
+1. **Repo name?**
+2. **Personal account or org?** List available orgs from pre-flight.
+3. **Starting point?** From scratch or existing local code?
+4. **Visibility?** Private (recommended) or public?
+5. **Description?**
+
+## Execution
+
+### From Scratch
+
+```bash
+GH_USER=$(gh api user -q '.login')
+OWNER=${ORG:-$GH_USER}
+gh repo create ${OWNER}/$1 --private --description "$2"
+git clone https://github.com/${OWNER}/$1.git
+```
+
+### From Existing Code
+
+```bash
+cd /path/to/existing/code
+[[ ! -d .git ]] && git init && git add . && git commit -m "feat: initial commit"
+OWNER=${ORG:-$(gh api user -q '.login')}
+gh repo create ${OWNER}/$1 --private --source=. --push
+```
+
+## Post-Creation Checklist
+
+- [ ] Verify git remote identity matches intended account
+- [ ] Add README.md if not present
+- [ ] Set up branch protection if org repo
+- [ ] Add collaborators if needed

package/prompts/oci-login.md

@@ -0,0 +1,56 @@
+---
+description: Authenticate podman with OCI registries (ghcr.io, ECR, Docker Hub)
+---
+# OCI Registry Login
+
+Authenticate with OCI registries for container image operations.
+
+## 1. Pre-flight Check
+
+```bash
+gh auth status
+podman login --get-login ghcr.io 2>/dev/null || echo "ghcr.io: not logged in"
+aws sts get-caller-identity 2>/dev/null || echo "AWS: not authenticated"
+```
+
+## 2. Authenticate
+
+### GitHub Container Registry (ghcr.io)
+
+```bash
+# Ensure write:packages scope
+gh auth refresh -s write:packages
+
+# Login
+gh auth token | podman login ghcr.io -u $(gh api user --jq .login) --password-stdin
+```
+
+### AWS ECR
+
+```bash
+AWS_ACCOUNT=$(aws sts get-caller-identity --query Account --output text)
+AWS_REGION="${AWS_REGION:-${AWS_DEFAULT_REGION:-us-east-1}}"
+aws ecr get-login-password --region "$AWS_REGION" | \
+  podman login --username AWS --password-stdin "$AWS_ACCOUNT.dkr.ecr.$AWS_REGION.amazonaws.com"
+```
+
+### Docker Hub (docker.io)
+
+```bash
+podman login docker.io -u <username>
+```
+
+## 3. Verify
+
+```bash
+podman login --get-login ghcr.io
+```
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| ghcr.io permission denied | `gh auth refresh -s write:packages` |
+| ECR auth failed | `aws sts get-caller-identity` to check session |
+| ECR token expired | Re-run login (tokens valid 12 hours) |
+| podman not found | Use `docker login` instead |

package/prompts/status.md

@@ -0,0 +1,50 @@
+---
+description: Session orientation — load project state and show what's active
+---
+# Status Check
+
+Quick session orientation. Load state from all subsystems and present a dashboard-style summary.
+
+## 1. Load State (parallel)
+
+Do all of these in parallel — they are independent:
+
+- `memory_query` — get project memory (skim for recent sessions, open issues)
+- `design_tree` action `list` — get design nodes
+- `design_tree` action `frontier` — get open questions
+- Check OpenSpec: `ls openspec/changes/ 2>/dev/null`
+- Git state: `git branch --show-current && git status --short | head -10`
+
+## 2. Parse and Summarize
+
+From the loaded state, extract:
+
+- **Design tree**: count by status (exploring/decided/seed), list any open questions
+- **OpenSpec**: list active changes with task completion counts
+- **Memory**: count facts, note the most recent session episode
+- **Git**: current branch, dirty files count
+- **Known issues**: any from memory's Known Issues section
+
+## 3. Present
+
+```
+📊 Status — <project name>
+━━━━━━━━━━━━━━━━━━━━━━━
+
+🌳 Design: <N decided, N exploring, N open questions>
+   <if open questions, list top 3 briefly>
+
+📋 OpenSpec: <N active changes>
+   <list each: name — M/N tasks complete>
+
+🔀 Git: <branch> · <clean | N dirty files>
+🧠 Memory: <N facts> · Last session: <date — topic>
+
+⚠️  Open Issues:
+   <top 2-3 known issues from memory, one line each>
+   <or "None tracked">
+```
+
+If there are actionable next steps (incomplete OpenSpec changes, open design questions, dirty working tree), suggest 1-2 concrete actions at the bottom.
+
+Keep the entire output under 20 lines. This is a glanceable dashboard, not a report.

package/settings.json

@@ -0,0 +1,4 @@
+{
+  "lastChangelogVersion": "0.57.1-cwilson613.1",
+  "theme": "alpharius"
+}