omniconductor 0.3.0

package/adapters/windsurf/README.md

@@ -0,0 +1,93 @@
+# Adapter — Windsurf (T3)
+
+Windsurf (the AI-IDE) is a T3 target because:
+
+- It supports an always-loaded baseline at `.windsurfrules`.
+- It supports a directory of additional rules at `.devin/rules/*.md` (preferred; legacy `.windsurf/rules/` is still read).
+- Its workflow is similar to Cursor's but with less per-pattern scoping.
+
+It is **T3** because:
+
+- ❌ No per-pattern rule scoping (rules in `.devin/rules/` all load together; no glob filtering).
+- ❌ No sub-agent dispatch.
+- ❌ No hooks.
+- ❌ No per-call model routing.
+- ❌ No built-in memory directory.
+
+**Tier**: T3 — Basic. Rule TEXT installs and groups well, but enforcement and scoping are minimal.
+
+## Installation path
+
+```bash
+# Install (always-loaded baseline + grouped rules + docs):
+bash adapters/windsurf/transform.sh <target>
+
+# With opt-in recipes:
+bash adapters/windsurf/transform.sh <target> --recipes=i18n,monorepo
+
+# Preview without writing:
+bash adapters/windsurf/transform.sh <target> --dry-run
+
+# Revert a previous install (manifest-based):
+bash adapters/windsurf/transform.sh <target> --uninstall
+```
+
+## What gets installed
+
+```
+<target>/
+├── .windsurfrules                              # Always-loaded baseline (orchestrator manual + ABSOLUTE rules)
+├── .devin/                                     # Preferred rules dir (legacy .windsurf/rules/ still read)
+│   └── rules/
+│       ├── operations.md
+│       ├── coding-conventions.md
+│       ├── token-economy.md
+│       ├── spec-as-you-go.md
+│       └── model-routing.md
+└── docs/
+    ├── CURRENT_WORK.md                         # Universal templates
+    ├── REMAINING_TASKS.md
+    ├── PLANS.md
+    ├── TASKS.md
+    ├── INDEX.md
+    └── specs/_example.md
+```
+
+## Native features supported
+
+- ✅ Always-loaded baseline (`.windsurfrules`).
+- ✅ Directory-based rule loading (`.devin/rules/`; legacy `.windsurf/rules/` still read).
+- ✅ All universal rule TEXT.
+- ✅ All doc templates.
+
+## Features NOT supported
+
+| Feature | Workaround |
+|---|---|
+| Per-pattern rule scoping | All rules in `.devin/rules/` load together. No glob filtering. |
+| Sub-agent dispatch | Human plays orchestrator. |
+| Hooks | Pair with project pre-commit git hooks. |
+| Per-call model routing | Single model per session. |
+| Built-in memory directory | DIY at `.memory/`. |
+
+## After install — first steps
+
+1. Open the project in Windsurf.
+2. Verify `.windsurfrules` loads on session start.
+3. Verify `.devin/rules/*.md` load alongside.
+4. Customize `.windsurfrules` — replace `{{PROJECT_NAME}}`.
+5. Rename `docs/specs/_example.md` → `docs/specs/<your-area>.md`.
+6. Add `.memory/` to `.gitignore`.
+
+## Quirks / known issues (P3.5 will fill)
+
+- TBD: confirm Windsurf reads ALL files under `.devin/rules/` (vs requiring a manifest); legacy `.windsurf/rules/` is still read.
+- TBD: priority order when `.windsurfrules` and `.devin/rules/*.md` contain conflicting rules.
+
+## Status (P0 foundation)
+
+- ✅ `README.md`
+- ✅ `SUPPORTED-FEATURES.md`
+- ✅ `transform-spec.md`
+- ✅ `transform.sh` (implemented)
+- ⏳ `notes.md` (P3.5)

package/adapters/windsurf/SUPPORTED-FEATURES.md

@@ -0,0 +1,67 @@
+# Windsurf — supported features
+
+Detailed matrix of which CONDUCTOR features Windsurf supports.
+
+## Feature support
+
+| Feature | Windsurf support | Mechanism | Notes |
+|---|---|---|---|
+| **Always-loaded baseline** | ✅ Native | `.windsurfrules` at project root | Auto-loaded on session start. |
+| **Directory-based rule loading** | ✅ Native | `.devin/rules/*.md` | All files in directory load together. No per-pattern scoping. Legacy `.windsurf/rules/` still read. |
+| **In-IDE chat / completion** | ✅ Native | Windsurf's primary feature | Similar to Cursor. |
+| **Per-pattern rule scoping** | ⚠️ Directory-based only | — | Whole `.devin/rules/` directory loads; no per-file glob filtering. |
+| **Sub-agent dispatch** | ✅ Native (2026) | Cascade sub-agent dispatch | See `docs/COMPATIBILITY-MATRIX.md` / ADR-031. CONDUCTOR ships the reflector as a manual rule (`.devin/rules/reflector.md`) rather than a named agent file. |
+| **Hooks** | ✅ Native (2026) | `.windsurf/hooks.json` | ADR-031. No session-start/stop hook event — CONDUCTOR uses `post_cascade_response_with_transcript` instead. Only the Reflector hook is emitted today (ADR-032); broader hook-set emission is Phase 2. |
+| **Per-task model routing** | ✅ Native (2026) | Per-task model selection | ADR-031. |
+| **Custom slash commands** | ✅ Native (2026) | Workflows at `.windsurf/workflows/*.md` | ADR-031. |
+| **Built-in memory directory** | ❌ | — | DIY at `.memory/`. |
+| **In-repo doc templates** | ✅ Universal | Plain markdown | Read on demand. |
+| **Spec-as-you-go ABSOLUTE enforcement** | ❌ rule reminder only | Rule text reminds | Self-policed. |
+| **Two-stage code review enforcement** | ❌ rule reminder only | | |
+
+## Universal-rule → Windsurf translation
+
+For each `core/universal-rules/<rule>.md`:
+
+1. Parse YAML front-matter.
+2. If `always_loaded: true` → APPEND content (sans front-matter) to `.windsurfrules`.
+3. Else → write `.devin/rules/<rule>.md` (preferred dir; legacy `.windsurf/rules/` still read) (front-matter STRIPPED — Windsurf doesn't use it for filtering).
+4. Tool-specific callouts:
+   - `> **Windsurf-only mechanism**` (rare): keep.
+   - `> **Claude-only mechanism**`: REPLACE with `> **Note (Windsurf)**: enforced by hook on Claude Code; on Windsurf, follow self-policed.`
+   - Other tool callouts: STRIP.
+
+## Strengths to lean into
+
+- Always-loaded baseline + grouped rules directory is a natural fit for the universal-rules collection.
+- In-IDE experience similar to Cursor — many of the same UX wins.
+
+## Weaknesses to acknowledge
+
+- Lack of per-pattern scoping means `coding-conventions.md` loads even when editing a `README.md`. Acceptable; just adds a small context cost per session.
+- Hooks are now natively supported (`.windsurf/hooks.json` — see `docs/COMPATIBILITY-MATRIX.md` / ADR-031), but Windsurf has no session-start/stop hook event; CONDUCTOR uses `post_cascade_response_with_transcript` as the closest equivalent. CONDUCTOR currently emits only the self-improvement Reflector hook (ADR-032); broader hook-set emission (commit-blocking, spec enforcement) is Phase 2 — until then, pair with a git pre-commit hook for mechanical enforcement.
+
+## Adapter status
+
+- ✅ `transform.sh` implemented — emits `.windsurfrules` (always-loaded baseline), `.devin/rules/*.md` (5 universal rules + opt-in recipes, front-matter stripped; legacy `.windsurf/rules/` still read), and `docs/*`. Supports `--recipes=`, `--dry-run`, `--no-prompt`, `--uninstall`/`--force`, `--help`. Writes a `.conductor-manifest.json` for clean rollback.
+
+## Self-improvement (Reflector) — opt-in
+
+With `--recipes=self-improvement`, the Windsurf adapter emits the Reflector loop (ADR-032):
+
+- **Hook**: `.windsurf/hooks.json` — registers `.conductor/reflect/trajectory-log.sh` on the `post_cascade_response_with_transcript` event (Windsurf has no session-start/stop event; this is the closest equivalent). Written only if no hook config exists; if one is already present, the adapter emits a manual-merge log entry instead of overwriting.
+- **Command**: `.windsurf/workflows/reflect.md` — the `/reflect` workflow that distills the trajectory log into lesson candidates.
+- **Rule**: `.devin/rules/reflector.md` — the reflector is shipped as a manual rule (not a named agent file) on Windsurf.
+- **Scripts**: `.conductor/reflect/trajectory-log.sh` (session trajectory capture) and `.conductor/reflect/prune-lessons.sh` (lesson-file size pruning).
+
+Note: the adapter's rules now target `.devin/rules/` (the legacy `.windsurf/rules/` location is still read by Windsurf).
+
+The loop is propose-only — lessons are proposed for human review, never auto-applied to rules. The hook no-ops unless `.conductor/reflect/` exists, so installs without the recipe are unaffected (opt-in gate).
+
+## Verification
+
+| Feature claim | Verified-by-real-install | Verification command / observation |
+|---|---|---|
+| `transform.sh` emits baseline + grouped rules + docs | ✅ implemented | `bash adapters/windsurf/transform.sh <target> --no-prompt` then inspect tree. |
+| `.windsurfrules` auto-loads | ⏳ P3.5 | Open project in Windsurf; verify rule indicator. |
+| `.devin/rules/*.md` auto-loads | ⏳ P3.5 | Verify rule indicator includes all files in directory. |

package/adapters/windsurf/transform-spec.md

@@ -0,0 +1,99 @@
+# Windsurf adapter — transform.sh specification
+
+What `adapters/windsurf/transform.sh` MUST do when implemented in P3.5.
+
+## Invocation
+
+```bash
+./transform.sh <target-dir> [--dry-run]
+```
+
+## Inputs
+
+```
+core/universal-rules/meta-discipline.md
+core/universal-rules/operations.md
+core/universal-rules/quality-gates.md
+core/universal-rules/spec-as-you-go.md
+core/universal-rules/workflow.md
+core/docs-templates/*.md
+core/docs-templates/specs/_example.md
+core/memory-pattern/README.md
+adapters/windsurf/_native/windsurfrules.tpl       # Header template (Windsurf-flavored intro)
+```
+
+## Outputs
+
+```
+<target-dir>/
+├── .windsurfrules                              # Always-loaded baseline (orchestrator manual + ABSOLUTE rules + always-loaded rules)
+├── .devin/                                     # Preferred rules dir (legacy .windsurf/rules/ still read)
+│   └── rules/
+│       ├── meta-discipline.md
+│       ├── operations.md
+│       ├── quality-gates.md
+│       ├── spec-as-you-go.md
+│       └── workflow.md
+└── docs/
+    ├── CURRENT_WORK.md                         # Verbatim
+    ├── REMAINING_TASKS.md
+    ├── PLANS.md
+    ├── TASKS.md
+    ├── INDEX.md
+    └── specs/_example.md
+```
+
+## `.windsurfrules` composition (in order)
+
+1. **Header from `_native/windsurfrules.tpl`** — bilingual (한/영) intro adapted for Windsurf.
+2. **ABSOLUTE rules section** — R1-R8 minus Claude-only sub-agent enforcement. R-prefix renumbered.
+3. **Always-loaded universal rules** — content from rules with `always_loaded: true` in `core/`.
+4. **Pointer to docs** — `Read docs/CURRENT_WORK.md first every session.`
+5. **Pointer to `.devin/rules/`** — informational ("additional rules load from .devin/rules/ (preferred; legacy .windsurf/rules/ still read)").
+
+## Universal-rules → Windsurf translation
+
+For each `core/universal-rules/<rule>.md`:
+
+1. Parse YAML front-matter.
+2. If `always_loaded: true`:
+   - APPEND content (sans front-matter, with section heading) to `.windsurfrules` "Universal Rules" section.
+   - Do NOT also emit to `.devin/rules/` (would double-load).
+3. Else:
+   - Emit `.devin/rules/<rule>.md` (preferred dir; legacy `.windsurf/rules/` is still read) with front-matter STRIPPED (Windsurf doesn't use it).
+   - Body preserved verbatim (with tool-specific callout replacement).
+
+## Edge cases
+
+| Case | Adapter behavior |
+|---|---|
+| `.devin/` doesn't exist | Create it. |
+| Existing `.windsurfrules` at target | Skip; report "SKIP (exists)". |
+| Existing `.devin/rules/operations.md` | Skip individually. |
+
+## Idempotency check
+
+Re-run reports "SKIP (exists)" for everything.
+
+## Verification commands (P3.5 will fill)
+
+```bash
+test -f "<target>/.windsurfrules"                      || echo "MISSING .windsurfrules"
+test -d "<target>/.devin/rules"                        || echo "MISSING .devin/rules dir"
+test -f "<target>/.devin/rules/spec-as-you-go.md"      || echo "MISSING spec-as-you-go"
+
+# Open project in Windsurf; verify rule indicator shows .windsurfrules + all .devin/rules/ files.
+```
+
+## P3.5 Windsurf version compatibility check
+
+- Confirm `.windsurfrules` IS the canonical always-loaded location.
+- Confirm Windsurf reads ALL files under `.devin/rules/` (not just a manifest-listed subset); legacy `.windsurf/rules/` is still read.
+- Confirm priority order when same rule exists in both locations.
+
+If Windsurf has changed conventions by P3.5, document in `notes.md`.
+
+## Out of scope
+
+- Windsurf authentication.
+- Per-stack auto-detection.