feat(v0.3.1): CSV editing MVP, video embed parsing, and planning baseline

Land v0.3.1 PRDs and ROADMAP refresh, archive v0.3.0 task snapshots, and add cyclopsctl handover scaffolding (.gitignore for .cyclopsctl/).

Code: CSV rendered cell editing with size gating, undo, and keyboard navigation; initial video embed URL parsing module and parser AST hooks (rendering follows in later tasks).
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: OlaProeis

.gitignore

@@ -112,3 +112,6 @@ logs
 # Task files
 # tasks.json
 # tasks/ 
+# Cyclopsctl (added by cyclopsctl init)
+cyclopsctl.toml
+.cyclopsctl/

Cargo.lock

@@ -45,6 +45,7 @@ serde_yaml = "0.9"
 toml = "0.8"
 dirs = "5"
 open = "5"
+url = "2"
 rfd = "0.14"
 log = "0.4"
 env_logger = "0.11"

Cargo.toml

@@ -123,7 +123,7 @@ This transparency is intentional — I want others to learn from (and improve up
 
 > ✨ **v0.3.0 (Latest):** **eframe / egui 0.34.2** platform refresh. **PDF + themed HTML export**. **Executable code blocks** (`▶ Run`). **Rendered edit session** (one-click WYSIWYG block switching). **Split-view scroll sync**. **User accent color**. **Mermaid** insert toolbar + validation + flowchart polish. **Phosphor icons**. **Session recovery** hardening. **Quick note workflow**. See [CHANGELOG.md](CHANGELOG.md) for full details.
 
-> 🛠️ **Coming in v0.3.1:** LSP diagnostics panel, executable code block hardening, and remaining Mermaid parity. See [ROADMAP.md](ROADMAP.md) for the full plan.
+> 🛠️ **Coming in v0.3.1:** LSP (diagnostics panel + hover/complete), YouTube embeds, Mermaid second wave, multi-window, CSV editing, and GitHub HTML parity. See [ROADMAP.md](ROADMAP.md) and [prd-v0.3.1.md](docs/ai-workflow/prds/prd-v0.3.1.md).
 
 > 📦 **v0.2.6 Highlights:** Custom Editor Engine with virtual scrolling (80MB file uses ~80MB RAM), Multi-Cursor Editing, Code Folding, IME/CJK input improvements.
 

README.md

@@ -0,0 +1,61 @@
+# Ferrite v0.3.1 — Mermaid Wave 2, Embeds, Multi-Window, Data UX & Polish - AI Context
+
+## Rules (DO NOT UPDATE)
+- **Implementation sessions:** follow **Implementation Phase Rules** below only.
+- **Update sessions:** follow **Update Phase Rules** below only when you receive the update handover prompt.
+- Only do the task specified; do not start the next task or go over scope.
+- Run `cargo test` after code changes to verify tests pass.
+- Follow existing code patterns and conventions.
+- Use Context7 MCP to fetch library documentation when needed (resolve library ID first, then fetch docs). Task operations use **`cyclopsctl tasks` CLI only**.
+
+## Implementation Phase Rules
+When working from **`current-handover-prompt.md`** (the normal case for every cyclopsctl task cycle):
+
+- **DO:** Implement and test only the current parent task described in the handover.
+- **DO:** Run `cargo test` before finishing; meet the task test strategy.
+- **DO:** Use Context7 MCP for up-to-date library documentation when implementing unfamiliar APIs or frameworks.
+- **DO NOT:** Read `prd.md` during cyclopsctl cycles — task scope, details, and test strategy are already in this handover.
+- **DO NOT:** Mark tasks done or change task status.
+- **DO NOT:** Run `cyclopsctl tasks next`, rewrite `current-handover-prompt.md`, or edit `ai-context.md`.
+- **DO NOT:** Create or update docs in `docs/`, or edit `docs/index.md`.
+- **DO NOT:** Edit `update-handover-prompt.md`.
+
+Task completion and all documentation updates happen only in the **update phase** (`update-handover-prompt.md`).
+
+## Update Phase Rules
+When `update-handover-prompt.md` is provided (after implementation in the same agent session):
+
+- **DO:** Follow every step in `update-handover-prompt.md`.
+- **DO:** Use `cyclopsctl tasks list pending --project-root G:\DEV\markDownNotepad` and pick the **lowest numeric parent id** for the next handover — not `cyclopsctl tasks next` (priority can skip ahead).
+- **DO:** Rewrite `current-handover-prompt.md` for the **next** task (this is the only time that file may change).
+- **DO:** Update `ai-context.md` project memory per update handover step 2 (key facts only, not a changelog).
+- **DO:** Use `cyclopsctl tasks` with `--project-root G:\DEV\markDownNotepad` for all task commands (see Environment in the handover).
+- **DO:** Document by feature (e.g., `auth-layer.md`), not by task number; update `docs/index.md` when adding documentation.
+- **DO NOT:** Re-implement or extend the task you just finished unless tests are broken.
+
+## Conventions
+- **Documentation:** Feature-based names in `docs/` (e.g., `auth-layer.md`), not `task-1.md`. Update `docs/index.md` in the update phase only.
+- **Tasks:** `cyclopsctl tasks` CLI only from agents.
+
+## Handover Files
+| File | Who may edit | When |
+|------|----------------|------|
+| `current-handover-prompt.md` | Update-phase agent only | After implementation |
+| `update-handover-prompt.md` | Human / template only | Never edited by agents |
+| `ai-context.md` | Update-phase agent only | Every update phase — project memory bullets (see update handover step 2) |
+
+## Tech Stack
+Rust
+
+## Architecture & Data Model
+See `prd.md` for product architecture. This file captures agent workflow rules and where project artifacts live.
+
+## Where Things Live
+| Want to... | Look in... |
+|------------|------------|
+| Product requirements | `prd.md` |
+| Current implementation handover | `current-handover-prompt.md` |
+| Post-task update rules | `update-handover-prompt.md` |
+| Documentation map | `docs/index.md` |
+| Tasks and complexity | `.cyclopsctl/tasks/tasks.json`, `.cyclopsctl/reports/complexity-report.json` |
+| Cyclopsctl config | `cyclopsctl.toml` |

ROADMAP.md

@@ -0,0 +1,56 @@
+# Session Handover
+
+# Task ID: 1
+
+## Environment
+- **Project:** Ferrite v0.3.1 — Mermaid Wave 2, Embeds, Multi-Window, Data UX & Polish
+- **Project root:** `G:\DEV\markDownNotepad`
+- **Tech stack:** ** See prd.md and ai-context.md
+- **Context file:** Cyclopsctl prepends `ai-context.md` automatically — follow its implementation rules.
+- **Branch:** `master`
+- **Tasks CLI:** `cyclopsctl tasks ... --project-root G:\DEV\markDownNotepad`
+
+## Core Handover Rules
+- **NO HISTORY:** This file describes only the current task. Do not infer remaining work from prior handovers or git history.
+- **SCOPE:** Implement task **1** only. Do not start the next task or mark tasks done.
+- **IMPLEMENTATION ONLY:** Do not edit docs, `ai-context.md`, or this handover during implementation.
+
+## Implementation Phase — Do Only This
+- Implement and test only the current parent task below.
+- Run `python -m pytest` before finishing; meet the task test strategy.
+- Use Context7 MCP for library docs per `ai-context.md` (resolve library ID first; not for task queue ops).
+- **Do not** mark tasks done, run `cyclopsctl tasks next`, rewrite this file, or edit `update-handover-prompt.md`.
+- **Do not** create or update docs in `docs/` or edit `docs/index.md`.
+
+## Current Task: 1 — Execute v0.3.0 platform verification matrix (#106, #111, #112)
+
+| Field | Value |
+|-------|--------|
+| ID | 1 |
+| Title | Execute v0.3.0 platform verification matrix (#106, #111, #112) |
+| Complexity | 3 |
+| Priority | high |
+| Dependencies | none |
+| Status | pending |
+
+### Description
+
+Run the remaining blank rows of the v0.3.0 regression matrix on target OSes, focusing on KBD-8 (Wayland, #106), KBD-9 (macOS Sonoma, #111), and Windows borderless (#112), and record outcomes so these carry-over gates can be closed or re-scoped.
+
+### Implementation Details
+
+Manual QA + documentation only; no code changes expected. Follow docs/technical/platform/v0.3.0-regression-matrix.md and fill the blank rows for Wayland keyboard handling, Sonoma keyboard handling, and Windows borderless window behaviour. Record per-row pass/fail with environment details. Update CHANGELOG.md with verification outcomes; draft closing comments for GitHub issues #106/#111/#112 when confirmed fixed, or write scoped follow-up issue text when not. Out of scope: any fixes discovered (file follow-ups instead), other matrix rows already filled.
+
+### Test Strategy
+
+All targeted matrix rows have recorded outcomes in v0.3.0-regression-matrix.md; CHANGELOG.md contains a platform-verification note; each of #106/#111/#112 has either a documented 'verified' result or a written, scoped follow-up. Diff review of the matrix and CHANGELOG confirms no row left blank for KBD-8/KBD-9/Windows borderless.
+
+## Verification
+
+```bash
+python -m pytest
+```
+
+## Model Selection
+
+Complexity **3** → **Composer 2.5** (`composer-2.5`). Informational only; the cyclopsctl selects the runtime model from the complexity report when using automated runs.

ai-context.md

@@ -83,6 +83,7 @@ fn process(text: &str) -> Vec<&str> { text.lines().collect() }
 | External invalidation epoch (`source_epoch`) | `state.rs` → `Tab::source_epoch()`, `bump_source_epoch()`, `record_external_edit_from_snapshot()` |
 | Rendered table cells (hits, Tab focus) | `markdown/widgets.rs` `EditableTable` — [`table-cell-focus-navigation.md`](./technical/markdown/table-cell-focus-navigation.md); session/force-commit in [`rendered-edit-session-tables.md`](./technical/markdown/rendered-edit-session-tables.md) |
 | Modify markdown parsing | `markdown/parser.rs` |
+| Video embed parsing | `markdown/video_embed.rs`, `parser.rs` (`VideoEmbed` AST) — [`video-embed-parsing.md`](./technical/markdown/video-embed-parsing.md) |
 | Modify central panel | `app/central_panel.rs` |
 | Add special tab | `state.rs` → `SpecialTabKind`, `app/central_panel.rs` |
 | Add viewer tab | `state.rs` → `TabKind` variant + state struct, `app/central_panel.rs` → render method |

current-handover-prompt.md

@@ -49,7 +49,9 @@ PRDs define features and acceptance criteria for each version.
 | `prd-v0.2.5.md` | v0.2.5 | Mermaid, CSV, i18n |
 | `prd-v0.2.6.1.md` | v0.2.6.1 | Patch & stability, PR #74, code signing |
 | `prd-v0.2.7.md` | v0.2.7 | Pre–v0.2.8 cycle (tasks 11–45); archived from `.taskmaster` Mar 2026 |
-| `prd-v0.3.0-mermaid-crate.md` | v0.3.0 | Mermaid crate extraction |
+| `prd-v0.3.0.md` | v0.3.0 | Platform refresh, PDF/HTML export, code run, Mermaid wave 1 (egui 0.34); archived from `.taskmaster` May 2026 |
+| `prd-v0.3.1.md` | v0.3.1 | LSP, video embeds, HTML Ph 1–2, Mermaid wave 2, multi-window, CSV/table UX (active PRD) |
+| `prd-v0.3.0-mermaid-crate.md` | v0.3.0 | Mermaid crate extraction (deferred scope doc) |
 
 ---
 
@@ -67,6 +69,8 @@ Task files generated from PRDs showing how requirements were broken down.
 | `tasks-v0.2.6.1.json` | v0.2.6.1 | v0.2.6.1 patch release tasks |
 | `tasks-v0.2.7-archive-2026-03-25.json` | v0.2.7 | Full `tasks.json` snapshot (tasks 11–45) before v0.2.8 reset |
 | `task-complexity-report-v0.2.7-archive-2026-03-25.json` | v0.2.7 | Complexity report snapshot for that cycle |
+| `tasks-v0.3.0-archive-2026-05-31.json` | v0.3.0 | Full `tasks.json` snapshot (tasks 57–106, 50 tasks) before v0.3.1 reset |
+| `task-complexity-report-v0.3.0-archive-2026-05-31.json` | v0.3.0 | Complexity report snapshot for v0.3.0 cycle |
 | `tasks-v0.3.0-mermaid-crate.json` | v0.3.0 | Mermaid crate tasks |
 
 ---