@pi-unipi/unipi 0.1.9 → 0.1.12

package/README.md

@@ -24,6 +24,8 @@ pi install npm:@pi-unipi/notify
 pi install npm:@pi-unipi/utility
 pi install npm:@pi-unipi/mcp
 pi install npm:@pi-unipi/ask-user
+pi install npm:@pi-unipi/milestone
+pi install npm:@pi-unipi/kanboard
 ```
 
 ## Packages
@@ -43,6 +45,8 @@ pi install npm:@pi-unipi/ask-user
 | `@pi-unipi/utility` | Environment info, diagnostics, settings inspector, cleanup |
 | `@pi-unipi/mcp` | MCP server discovery, connection, and tool integration |
 | `@pi-unipi/ask-user` | Structured user input with options and freeform text |
+| `@pi-unipi/milestone` | Milestone tracking and project progress management |
+| `@pi-unipi/kanboard` | Kanboard visualization server with TUI overlay |
 
 ## Commands
 
@@ -152,6 +156,9 @@ pi install npm:@pi-unipi/ask-user
 | `/unipi:status` | Show module status |
 | `/unipi:cleanup` | Clean stale temp files |
 | `/unipi:reload` | Reload extensions |
+| `/unipi:name-badge` | Toggle session name badge overlay |
+| `/unipi:badge-gen` | Generate session name via background agent |
+| `/unipi:badge-toggle` | Configure badge settings |
 
 ### MCP (`/unipi:mcp-*`)
 
@@ -191,6 +198,24 @@ pi install npm:@pi-unipi/ask-user
 | `ctx_fetch_and_index` | compactor | Fetch and index web content |
 | `ctx_stats` | compactor | Show compaction statistics |
 | `ctx_doctor` | compactor | Diagnose compactor issues |
+| `set_session_name` | utility | Set session name for badge display |
+| `ctx_batch` | utility | Atomic batch execution with rollback |
+| `ctx_env` | utility | Show environment information |
+
+### Milestone (`/unipi:milestone-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:milestone-onboard` | Create MILESTONES.md from existing workflow docs |
+| `/unipi:milestone-update` | Sync MILESTONES.md with completed work |
+
+### Kanboard (`/unipi:kanboard*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:kanboard` | Toggle kanboard visualization server |
+| `/unipi:kanboard-doctor` | Diagnose and fix kanboard parser issues |
+| `/unipi:name-gen` | Generate session name badge via background agent |
 
 ## How It Works
 
@@ -220,6 +245,10 @@ pi install npm:@pi-unipi/ask-user
 
 **Ask User** provides structured user input with multiple-choice, multi-select, and freeform text options.
 
+**Milestone** tracks project progress with MILESTONES.md — onboards existing work and syncs with completed tasks.
+
+**Kanboard** provides a visualization server with htmx + Alpine.js UI for kanban boards, workflow timelines, and milestone progress. Includes a TUI overlay for quick access.
+
 ## Module Discovery
 
 Modules announce presence via `pi.events`. When `@pi-unipi/workflow` detects `@pi-unipi/ralph`, it enables loop integration. Each module works standalone.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -48,6 +48,8 @@
       "node_modules/@pi-unipi/mcp/src/index.ts",
       "node_modules/@pi-unipi/compactor/src/index.ts",
       "node_modules/@pi-unipi/notify/index.ts",
+      "node_modules/@pi-unipi/milestone/index.ts",
+      "node_modules/@pi-unipi/kanboard/index.ts",
       "node_modules/@pi-unipi/command-enchantment/src/index.ts"
     ],
     "skills": [
@@ -59,7 +61,9 @@
       "node_modules/@pi-unipi/mcp/skills",
       "node_modules/@pi-unipi/utility/skills",
       "node_modules/@pi-unipi/compactor/skills",
-      "node_modules/@pi-unipi/notify/skills"
+      "node_modules/@pi-unipi/notify/skills",
+      "node_modules/@pi-unipi/milestone/skills",
+      "node_modules/@pi-unipi/kanboard/skills"
     ]
   },
   "peerDependencies": {
@@ -81,6 +85,8 @@
     "@pi-unipi/ralph": "*",
     "@pi-unipi/subagents": "*",
     "@pi-unipi/utility": "*",
+    "@pi-unipi/milestone": "*",
+    "@pi-unipi/kanboard": "*",
     "@pi-unipi/web-api": "*",
     "@pi-unipi/workflow": "*"
   },

package/packages/ask-user/skills/ask-user/SKILL.md

@@ -38,6 +38,26 @@ Use the `ask_user` tool to collect structured input from the user.
 | `allowFreeform` | boolean? | true | Add "Custom response" checkable option |
 | `timeout` | number? | — | Auto-dismiss after N ms |
 
+### Option Properties
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `label` | string | required | Display label |
+| `description` | string? | — | Description shown below label |
+| `value` | string? | label | Value returned when selected |
+| `allowCustom` | boolean? | false | Allow user to add custom text for this option (shorthand for `action: "input"`) |
+| `action` | string? | "select" | Special action: `"select"`, `"input"`, `"end_turn"`, `"new_session"` |
+| `prefill` | string? | — | Prefill message for `"new_session"` action |
+
+### Action Types
+
+| Action | Behavior |
+|--------|----------|
+| `"select"` | Normal selection (default). Returns immediately. |
+| `"input"` | Enters text input mode. Returns `combined` response with selection + text. |
+| `"end_turn"` | Signals end of agent turn. Returns `end_turn` response kind. |
+| `"new_session"` | Starts a new session. Returns `new_session` response kind with optional `prefill`. |
+
 ## Examples
 
 Single choice:
@@ -98,3 +118,35 @@ ask_user({
 })
 ```
 User can check "Auth", "Cache", and "Custom response" to type additional features.
+
+With per-option custom text:
+```
+ask_user({
+  question: "Does this look right?",
+  options: [
+    { label: "Yes", value: "yes" },
+    { label: "Partially", value: "partial", allowCustom: true },
+    { label: "No", value: "no", allowCustom: true }
+  ],
+  allowFreeform: false
+})
+```
+Selecting "Partially" or "No" enters text input so the user can explain what needs to change.
+
+With end_turn and new_session actions:
+```
+ask_user({
+  question: "How would you like to proceed?",
+  options: [
+    { label: "Looks good, proceed", value: "proceed" },
+    { label: "I want changes", value: "changes", action: "input" },
+    { label: "Done for now", value: "done", action: "end_turn" },
+    { label: "Start fresh", value: "new", action: "new_session", prefill: "Let's redesign the..." }
+  ],
+  allowFreeform: false
+})
+```
+- "Looks good" returns immediately with selection
+- "I want changes" enters text input mode for the user to explain
+- "Done for now" signals the agent to end its turn
+- "Start fresh" starts a new session with the prefill message

package/packages/autocomplete/src/constants.ts

@@ -20,6 +20,7 @@ export const PACKAGE_ORDER: string[] = [
   "workflow",
   "ralph",
   "memory",
+  "milestone",
   "mcp",
   "utility",
   "ask-user",
@@ -27,6 +28,7 @@ export const PACKAGE_ORDER: string[] = [
   "web-api",
   "compact",
   "notify",
+  "kanboard",
 ];
 
 // ─── Package Colors ──────────────────────────────────────────────────
@@ -35,6 +37,7 @@ export const PACKAGE_COLORS: Record<string, string> = {
   workflow:  `${ESC}[91m`, // Bright Red
   ralph:     `${ESC}[33m`, // Yellow/Orange
   memory:    `${ESC}[93m`, // Bright Yellow
+  milestone: `${ESC}[32m`, // Green
   mcp:       `${ESC}[32m`, // Green
   utility:   `${ESC}[36m`, // Cyan
   "ask-user": `${ESC}[94m`, // Bright Blue
@@ -42,6 +45,7 @@ export const PACKAGE_COLORS: Record<string, string> = {
   "web-api": `${ESC}[95m`, // Bright Magenta
   compact:   `${ESC}[37m`, // White
   notify:    `${ESC}[96m`, // Bright Cyan
+  kanboard:  `${ESC}[92m`, // Bright Green
 };
 
 // ─── Command Registry ────────────────────────────────────────────────
@@ -89,13 +93,17 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:mcp-settings": "mcp",
   "unipi:mcp-reload":   "mcp",
 
-  // utility (6 commands)
-  "unipi:continue": "utility",
-  "unipi:reload":   "utility",
-  "unipi:status":   "utility",
-  "unipi:cleanup":  "utility",
-  "unipi:env":      "utility",
-  "unipi:doctor":   "utility",
+  // utility (10 commands)
+  "unipi:continue":   "utility",
+  "unipi:reload":     "utility",
+  "unipi:status":     "utility",
+  "unipi:cleanup":    "utility",
+  "unipi:env":        "utility",
+  "unipi:doctor":     "utility",
+  "unipi:badge-name": "utility",
+  "unipi:badge-gen":  "utility",
+  "unipi:badge-toggle": "utility",
+  "unipi:badge-settings": "utility",
 
   // ask-user (1 command)
   "unipi:ask-user-settings": "ask-user",
@@ -119,11 +127,19 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:compact-search":  "compact",
   "unipi:compact-purge":   "compact",
 
+  // milestone (2 commands)
+  "unipi:milestone-onboard": "milestone",
+  "unipi:milestone-update":  "milestone",
+
   // notify (4 commands)
   "unipi:notify-settings":  "notify",
   "unipi:notify-set-gotify": "notify",
   "unipi:notify-set-tg":    "notify",
   "unipi:notify-test":      "notify",
+
+  // kanboard (3 commands)
+  "unipi:kanboard":          "kanboard",
+  "unipi:kanboard-doctor":   "kanboard",
 };
 
 // ─── Description Map ─────────────────────────────────────────────────
@@ -167,12 +183,18 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:mcp-settings": "Configure MCP settings",
   "unipi:mcp-reload":   "Reload MCP connections",
 
-  "unipi:continue": "Continue the last conversation",
-  "unipi:reload":   "Reload extensions and settings",
-  "unipi:status":   "Show system status",
-  "unipi:cleanup":  "Clean up old sessions and cache",
-  "unipi:env":      "Show environment info",
-  "unipi:doctor":   "Run diagnostics",
+  "unipi:continue":   "Continue the last conversation",
+  "unipi:reload":     "Reload extensions and settings",
+  "unipi:status":     "Show system status",
+  "unipi:cleanup":    "Clean up old sessions and cache",
+  "unipi:env":        "Show environment info",
+  "unipi:doctor":     "Run diagnostics",
+  "unipi:badge-name": "Toggle session name badge overlay",
+  "unipi:badge-gen":  "Generate session name via background agent",
+  "unipi:badge-toggle": "Configure badge settings (autoGen, badgeEnabled, agentTool)",
+  "unipi:badge-settings": "Configure badge settings via TUI overlay",
+  "unipi:kanboard":        "Start the kanboard visualization server",
+  "unipi:kanboard-doctor": "Diagnose and fix kanboard parser issues",
 
   "unipi:ask-user-settings": "Configure ask-user settings",
 
@@ -196,6 +218,9 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:notify-set-gotify": "Set up Gotify push notifications",
   "unipi:notify-set-tg":    "Set up Telegram bot notifications",
   "unipi:notify-test":      "Test all enabled notification platforms",
+
+  "unipi:milestone-onboard": "Create MILESTONES.md from existing workflow docs",
+  "unipi:milestone-update":  "Sync MILESTONES.md with completed work",
 };
 
 // ─── Package Display Names ───────────────────────────────────────────
@@ -204,6 +229,7 @@ export const PACKAGE_LABELS: Record<string, string> = {
   workflow:  "workflow",
   ralph:     "ralph",
   memory:    "memory",
+  milestone: "milestone",
   mcp:       "mcp",
   utility:   "utility",
   "ask-user": "ask-user",
@@ -211,4 +237,5 @@ export const PACKAGE_LABELS: Record<string, string> = {
   "web-api": "web-api",
   compact:   "compact",
   notify:    "notify",
+  kanboard:  "kanboard",
 };

package/packages/autocomplete/src/provider.ts

@@ -52,6 +52,7 @@ function detectNamespaceBoost(query: string): string | null {
     workflow: "workflow",
     ralph: "ralph",
     memory: "memory",
+    milestone: "milestone",
     mcp: "mcp",
     utility: "utility",
     "ask-user": "ask-user",
@@ -61,6 +62,8 @@ function detectNamespaceBoost(query: string): string | null {
     notify: "notify",
     // Unambiguous short aliases
     mem: "memory",
+    ms: "milestone",
+    goal: "milestone",
     util: "utility",
     web: "web-api",
     notification: "notify",
@@ -117,7 +120,18 @@ function getEnhancedUnipiItems(
     });
   }
 
-  // Sort: boosted package first, then by PACKAGE_ORDER, then alphabetically.
+  // Determine match quality for ranking exact > prefix > fuzzy
+  const getMatchPriority = (cmd: string): number => {
+    const name = isPastUnipiColon
+      ? cmd.replace("unipi:", "").toLowerCase()
+      : cmd.toLowerCase();
+    if (name === query) return 0;        // Exact match
+    if (name.startsWith(query)) return 1; // Prefix match
+    return 2;                              // Fuzzy match
+  };
+
+  // Sort: boosted package first, then exact > prefix > fuzzy,
+  // then by PACKAGE_ORDER, then alphabetically.
   matched.sort((a, b) => {
     const pkgA = a[1];
     const pkgB = b[1];
@@ -129,6 +143,11 @@ function getEnhancedUnipiItems(
       if (!aIsBoosted && bIsBoosted) return 1;
     }
 
+    // Rank by match quality: exact > prefix > fuzzy
+    const priA = getMatchPriority(a[0]);
+    const priB = getMatchPriority(b[0]);
+    if (priA !== priB) return priA - priB;
+
     const orderA = PACKAGE_ORDER.indexOf(pkgA);
     const orderB = PACKAGE_ORDER.indexOf(pkgB);
     if (orderA !== orderB) return orderA - orderB;
@@ -262,7 +281,7 @@ export function createEnchantedProvider(
           : null;
       }
 
-      // Merge: non-unipi first, then enhanced unipi (sorted by package)
+      // Merge: system commands first, then enhanced unipi (sorted by package)
       return {
         items: [...nonUnipiItems, ...enhancedUnipiItems],
         prefix: effectivePrefix,

package/packages/core/index.ts

@@ -8,3 +8,4 @@ export * from "./constants.js";
 export * from "./events.js";
 export * from "./sandbox.js";
 export * from "./utils.js";
+export * from "./model-cache.js";

package/packages/kanboard/README.md

@@ -0,0 +1,137 @@
+# @pi-unipi/kanboard
+
+Visualization layer for unipi workflow data. Kanboard provides an HTTP server with htmx + Alpine.js UI, modular parsers for all workflow document types, two web pages (Milestones + Workflow), a TUI overlay with tasks list and kanban board, and a doctor skill for parser diagnostics.
+
+## Quick Start
+
+```bash
+# Start the kanboard server
+/unipi:kanboard
+
+# Diagnose parser issues
+/unipi:kanboard-doctor
+```
+
+## Architecture
+
+```
+kanboard/
+├── server/          # HTTP server with port allocation
+│   ├── index.ts     # Server core (KanboardServer class)
+│   └── routes/      # Route handlers (milestone, workflow)
+├── parser/          # Document parsers
+│   ├── index.ts     # ParserRegistry + createDefaultRegistry()
+│   ├── specs.ts     # Spec parser (checklist items)
+│   ├── plans.ts     # Plan parser (task statuses)
+│   ├── milestones.ts # Milestone parser
+│   └── remaining.ts # Quick-work, debug, fix, chore, review
+├── ui/              # Web UI
+│   ├── layouts/     # Base HTML layout
+│   ├── static/      # CSS + JS (style.css, app.js)
+│   ├── components/  # Reusable components
+│   ├── milestone/   # Milestone page renderer
+│   └── workflow/    # Workflow page renderer
+├── tui/             # TUI overlay
+│   └── kanboard-overlay.ts
+├── skills/          # Skills
+│   └── kanboard-doctor/ # Parser diagnostics
+├── commands.ts      # Command registration
+├── types.ts         # Shared TypeScript types
+└── index.ts         # Extension entry point
+```
+
+## Web Pages
+
+### Milestones (`/`)
+- Displays MILESTONES.md phases with progress bars
+- Checklist items with status indicators (✓ done, ○ todo)
+- Collapsible sections per phase
+- Copy-to-clipboard for `/unipi:milestone-update`
+
+### Workflow (`/workflow`)
+- Cards grouped by document type (specs, plans, fixes, etc.)
+- Progress indicators per card
+- Alpine.js filtering by status (All, To Do, In Progress, Done)
+- Copy-to-clipboard for relevant commands
+
+## TUI Overlay
+
+Two tabs accessible via the kanboard overlay:
+
+- **Tasks** — Flat list of all tasks from all documents with status icons
+- **Board** — Kanban columns (To Do / In Progress / Done)
+
+### Controls
+- `j/k` — Navigate up/down
+- `h/l` — Switch columns (Board tab)
+- `Tab` or `b` — Switch between Tasks/Board tabs
+- `t` — Switch to Tasks tab
+- `gg/G` — Jump to top/bottom
+- `q/Esc` — Close overlay
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/` | Milestone page |
+| GET | `/workflow` | Workflow page |
+| GET | `/api/milestones` | Milestone JSON data |
+| GET | `/api/workflow` | Workflow JSON data |
+| POST | `/api/docs/:type/:file/items/:line` | Update item status |
+
+## Parser System
+
+Kanboard parses 8 document types from `.unipi/docs/`:
+
+| Type | Directory | What's Parsed |
+|------|-----------|---------------|
+| Spec | `specs/` | `- [ ]` / `- [x]` checklist items |
+| Plan | `plans/` | `unstarted:` / `in-progress:` / `completed:` statuses |
+| Milestone | `MILESTONES.md` | Phase headers + checklist items |
+| Quick-work | `quick-work/` | Title + checklist items |
+| Debug | `debug/` | Headers + checklists |
+| Fix | `fix/` | Headers + checklists + related debug ref |
+| Chore | `chore/` | Chore steps as checklist items |
+| Review | `reviews/` | Review remarks as checklist items |
+
+### Parser Warnings
+
+Parsers are resilient — they collect warnings per file and return partial results:
+- Empty checkbox text
+- Malformed checkboxes
+- Missing frontmatter
+- Unparseable lines
+
+Warnings are surfaced in the kanboard-doctor skill.
+
+## Doctor Skill
+
+The `kanboard-doctor` skill runs all parsers and produces a diagnostic report:
+
+1. **Run All Parsers** — Parse every document
+2. **Collect Errors** — Group warnings by file
+3. **Present Report** — Structured error listing
+4. **Fix One by One** — Suggest fixes, ask user to confirm
+5. **Re-validate** — Re-run parser after each fix
+
+## Server Configuration
+
+Default configuration (from `@pi-unipi/core`):
+
+```typescript
+KANBOARD_DEFAULTS = {
+  PORT: 8165,      // Starting port
+  MAX_PORT: 8175,  // Maximum port to try
+}
+```
+
+- Port allocation: tries 8165, increments on EADDRINUSE
+- PID file: `.unipi/kanboard.pid`
+- Graceful shutdown on SIGINT/SIGTERM
+- Static files served from `ui/static/`
+
+## Dependencies
+
+- `@pi-unipi/core` — Shared constants and utilities
+- `@mariozechner/pi-coding-agent` — Extension API
+- `@mariozechner/pi-tui` — TUI overlay API

package/packages/kanboard/index.ts

@@ -0,0 +1,80 @@
+/**
+ * @pi-unipi/kanboard — Extension entry
+ *
+ * Visualization layer for unipi workflow data.
+ * HTTP server with htmx + Alpine.js UI, modular parsers, TUI overlay, and kanban board.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { MODULES, KANBOARD_COMMANDS } from "@pi-unipi/core";
+import { registerCommands } from "./commands.js";
+
+/** Package version */
+const VERSION = "0.1.0";
+
+export default function (pi: ExtensionAPI): void {
+  // Register skills directory
+  const skillsDir = new URL("./skills", import.meta.url).pathname;
+
+  pi.on("resources_discover", async () => {
+    return {
+      skillPaths: [skillsDir],
+    };
+  });
+
+  // Register commands
+  registerCommands(pi);
+
+  // Note: Badge generation on first message is handled by the utility module.
+  // Kanboard no longer manages badge generation to avoid duplication.
+
+  // Register info-screen group
+  const globalObj = globalThis as any;
+  const registry = globalObj.__unipi_info_registry;
+  if (registry) {
+    registry.registerGroup({
+      id: "kanboard",
+      name: "Kanboard",
+      icon: "📋",
+      priority: 50,
+      config: {
+        showByDefault: true,
+        stats: [
+          { id: "status", label: "Server Status", show: true },
+          { id: "url", label: "URL", show: true },
+          { id: "docs", label: "Documents", show: true },
+          { id: "tasks", label: "Tasks", show: true },
+        ],
+      },
+      dataProvider: async () => {
+        const { createDefaultRegistry } = await import("./parser/index.js");
+        const registry = await createDefaultRegistry();
+        const docs = registry.parseAll(".unipi/docs");
+        const totalItems = docs.reduce((sum, d) => sum + d.items.length, 0);
+        const doneItems = docs.reduce(
+          (sum, d) => sum + d.items.filter((i) => i.status === "done").length,
+          0,
+        );
+
+        return {
+          status: {
+            value: "Ready",
+            detail: "Server not running (use /unipi:kanboard to start)",
+          },
+          url: {
+            value: "—",
+            detail: "Start server to get URL",
+          },
+          docs: {
+            value: String(docs.length),
+            detail: `${docs.length} documents parsed`,
+          },
+          tasks: {
+            value: `${doneItems}/${totalItems}`,
+            detail: `${totalItems > 0 ? Math.round((doneItems / totalItems) * 100) : 0}% complete`,
+          },
+        };
+      },
+    });
+  }
+}

package/packages/kanboard/skills/kanboard-doctor/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: kanboard-doctor
+description: "Diagnose and fix kanboard parser issues — validates all workflow documents, reports errors, suggests fixes."
+---
+
+# Kanboard Doctor
+
+Diagnose parser issues across all workflow documents. Non-destructive — only suggests fixes, asks user to confirm.
+
+## Phase 1: Run All Parsers
+
+Execute each parser against its document type directory:
+
+1. Load the parser registry from `@pi-unipi/kanboard`
+2. Run `registry.parseAll(".unipi/docs")` to parse all documents
+3. Collect all `ParsedDoc` results including their `warnings` arrays
+
+## Phase 2: Collect Errors
+
+Group warnings and errors by file with line numbers:
+
+1. For each `ParsedDoc` with `warnings.length > 0`:
+   - Group by `filePath`
+   - Include line numbers where available
+   - Categorize: malformed checkboxes, empty fields, parse failures
+2. Also flag documents that returned 0 items (may indicate parsing failure)
+
+## Phase 3: Present Report
+
+Show a structured error report:
+
+```
+📋 Kanboard Doctor Report
+
+Files scanned: N
+Files with issues: M
+
+📄 .unipi/docs/specs/example.md
+  ⚠ Line 15: Empty checkbox text
+  ⚠ Line 23: Malformed checkbox (missing bracket)
+
+📄 .unipi/docs/plans/old-plan.md
+  ⚠ Line 5: Empty task name after status
+```
+
+## Phase 4: Fix One by One
+
+For each issue, suggest a fix and ask user to confirm:
+
+1. Show the problematic line with context
+2. Suggest the corrected version
+3. Ask: "Apply this fix? (y/n)"
+4. If yes, apply the fix using the edit tool
+5. Move to next issue
+
+**Non-destructive rules:**
+- Never modify without asking
+- Show before/after for each change
+- Allow skipping individual fixes
+- Allow "fix all" for simple patterns (e.g., trailing whitespace)
+
+## Phase 5: Re-validate
+
+After each fix, re-run the parser on the modified file:
+
+1. Parse the file again
+2. Verify the specific error is resolved
+3. Check that no new errors were introduced
+4. Report: "✓ Fixed" or "✗ Still has issues"
+
+After all fixes, run full `registry.parseAll()` to confirm clean state.

package/packages/memory/index.ts

@@ -75,6 +75,12 @@ export default function (pi: ExtensionAPI) {
     projectStorage = new MemoryStorage(projectName);
     try {
       projectStorage.init();
+      
+      // Sync any orphaned markdown files into the database
+      const synced = projectStorage.syncOrphanedFiles();
+      if (synced > 0) {
+        console.warn(`[unipi/memory] Synced ${synced} orphaned memory files into database`);
+      }
     } catch (err) {
       console.warn("[unipi/memory] Failed to initialize storage, running without memory:", (err as any)?.message ?? err);
       projectStorage = null;