omniconductor 0.5.0 → 1.0.1

package/adapters/copilot/metadata.json

@@ -0,0 +1,36 @@
+{
+  "_comment": "Single source for enumerable adapter facts (ADR-040). CI asserts transform.sh / validator / matrix agree with this file. Update HERE first; docs follow.",
+  "tool": "copilot",
+  "display_name": "Copilot",
+  "tier": "T2",
+  "outputs": [
+    { "path": ".github/copilot-instructions.md", "kind": "always_loaded", "validated": true },
+    { "path": ".github/instructions", "kind": "rules", "validated": true },
+    { "path": "docs/CURRENT_WORK.md", "kind": "docs", "validated": false }
+  ],
+  "reflector_outputs": [
+    { "path": ".github/hooks/conductor-reflect.json", "note": "session-end trajectory hook config (recipe-gated)" },
+    { "path": ".conductor/reflect", "note": "runner + brief + scheduling (recipe-gated)" }
+  ],
+  "install": { "ala_carte": "per-file" },
+  "legacy_paths": [],
+  "capabilities": {
+    "tool_native": {
+      "hooks": "yes",
+      "sub_agents": "yes",
+      "model_routing": "yes",
+      "commands": "yes",
+      "glob_scoping": "yes",
+      "scheduler": "cloud-only"
+    },
+    "conductor_emitted": {
+      "rules": "full",
+      "guard_hooks": "none",
+      "reflector_loop": "recipe",
+      "role_agents": "none",
+      "model_routing": "none"
+    }
+  },
+  "live_verification": { "status": "pending", "date": null, "cli": null, "note": "per-IDE — see docs/IDE-SMOKE-TESTING.md" },
+  "headless_cli": { "command": "copilot", "invocation": "copilot -p" }
+}

package/adapters/copilot/transform.sh

@@ -30,7 +30,7 @@
 #   core/recipes/<r>.md (selected) →  <target>/.github/instructions/<r>.instructions.md (applyTo: from paths)
 #   core/docs-templates/*.md       →  <target>/docs/*.md
 #   core/hooks/*                   →  SKIP (Reflector hook emitted via --recipes=self-improvement, ADR-032; other guards Claude-only, ADR-034)
-#   core/roles/*                   →  SKIP (Copilot has no sub-agent dispatch)
+#   core/roles/*                   →  SKIP (role emission is Claude-only today; Copilot supports sub-agents natively — ADR-031)
 #
 # Layer 2 transformation (--per-rule alternative):
 #   core/universal-rules/<r>.md   →  <target>/.github/instructions/<r>.instructions.md (applyTo: '**')
@@ -56,6 +56,7 @@ set -eu
 
 TARGET=""
 RECIPES=""
+MODE="full"
 DRY_RUN="false"
 NO_PROMPT="false"
 PER_RULE="false"
@@ -67,6 +68,7 @@ WIZARD_APPLY_RULES="true"
 while [ $# -gt 0 ]; do
   case "$1" in
     --recipes=*) RECIPES="${1#--recipes=}" ;;
+    --mode=*)    MODE="${1#--mode=}" ;;
     --dry-run)   DRY_RUN="true" ;;
     --no-prompt) NO_PROMPT="true" ;;
     --per-rule)  PER_RULE="true" ;;
@@ -78,6 +80,11 @@ Usage: bash adapters/copilot/transform.sh <target-project> [options]
 
 Options:
   --recipes=A,B,C       Comma-separated list of recipes to install
+  --mode=<m>            Install preset (ADR-044): full (default) | minimal (rules text +
+                        docs only; no Reflector runtime) | strict (abort if
+                        .github/copilot-instructions.md exists) | recipes-only (ONLY the
+                        selected recipe .instructions.md files; requires --recipes=) |
+                        reflector-only (self-improvement loop standalone)
   --dry-run             Preview only — no files written
   --no-prompt           Skip interactive prompts; apply defaults (CI-safe)
   --per-rule            Split 5 universal rules into per-file .instructions.md
@@ -87,16 +94,16 @@ Options:
                         Conductor-emitted files when none.
   --force               Bypass uninstall safety checks (active worktrees, missing manifest)
 
-Recipes available: web-mobile-parity, i18n, monorepo, branch-strategy, auto-mock-data, coding-conventions, tdd, debugging, database-discipline, design-system, self-improvement, git-hygiene
+Recipes available: web-mobile-parity, i18n, monorepo, branch-strategy, auto-mock-data, coding-conventions, tdd, debugging, database-discipline, design-system, self-improvement, git-hygiene, loop-engineering
 
 Output (default):
   <target>/.github/copilot-instructions.md            (5 universal rules merged)
   <target>/.github/instructions/<recipe>.instructions.md  (per recipe, applyTo: from paths)
   <target>/docs/{CURRENT_WORK,REMAINING_TASKS,PLANS,TASKS,INDEX}.md
 
-Skipped (not supported by Copilot):
-  Sub-agent dispatch (roles)  — Copilot has no Agent equivalent
-  PreToolUse / Stop hooks     — Copilot has no commit-blocking hooks
+Skipped (not yet emitted for Copilot — the tool supports these natively, ADR-031):
+  Sub-agent dispatch (roles)  — full agent emission is Phase 2
+  PreToolUse / Stop hooks     — full hook emission is Phase 2 (Reflector hook ships via --recipes=self-improvement)
 
 IDE coverage: VS Code, Cursor (Copilot ext), Windsurf (Copilot adapter), JetBrains
               (Copilot plugin), Neovim (copilot.vim) all read .github/instructions/.
@@ -121,10 +128,30 @@ if [ -z "$TARGET" ]; then
   exit 1
 fi
 
+case "$MODE" in
+  full|minimal|strict|recipes-only|reflector-only) : ;;
+  *) echo "Error: unknown --mode '$MODE' (one of: full, minimal, strict, recipes-only, reflector-only)" >&2; exit 1 ;;
+esac
+if [ "$MODE" = "reflector-only" ]; then
+  if [ -n "$RECIPES" ] && [ "$RECIPES" != "self-improvement" ]; then
+    echo "NOTE: --mode=reflector-only ignores --recipes (installs self-improvement only)" >&2
+  fi
+  RECIPES="self-improvement"
+fi
+if [ "$MODE" = "recipes-only" ] && [ -z "$RECIPES" ] && [ "$UNINSTALL" != "true" ]; then
+  echo "Error: --mode=recipes-only requires --recipes=A,B,..." >&2
+  exit 1
+fi
+
 CONDUCTOR_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 CORE_ROOT="$CONDUCTOR_ROOT/core"
 [ -d "$CORE_ROOT" ] || { echo "Error: core/ not found at $CORE_ROOT" >&2; exit 1; }
 
+# CONDUCTOR package version for the manifest — parsed at runtime from package.json
+# so releases never drift the manifest (falls back to "unknown" on any error).
+CONDUCTOR_VERSION="$(/usr/bin/sed -n -E 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p' "$CONDUCTOR_ROOT/package.json" 2>/dev/null | /usr/bin/head -n 1)"
+[ -n "$CONDUCTOR_VERSION" ] || CONDUCTOR_VERSION="unknown"
+
 if [ "$DRY_RUN" = "true" ]; then
   mkdir -p "$TARGET"
 fi
@@ -246,20 +273,7 @@ EOF
 
 # backup_if_exists <dest>
 backup_if_exists() {
-  local dest="$1"
-  MANIFEST_LAST_BACKUP=""
-  if [ -f "$dest" ]; then
-    if [ "$DRY_RUN" = "true" ]; then
-      log "would back up existing $dest -> $dest.conductor-backup-<ts>"
-    else
-      local ts
-      ts="$(/bin/date +%Y%m%d-%H%M%S)"
-      local backup="${dest}.conductor-backup-${ts}"
-      /bin/cp "$dest" "$backup"
-      log "  backed up existing $dest -> $backup"
-      MANIFEST_LAST_BACKUP="${backup#$TARGET_ABS/}"
-    fi
-  fi
+  conductor_manifest_backup_and_remember "$1"
 }
 
 # ----- manifest tracking (mirrors claude adapter ADR-020) ----------------
@@ -269,6 +283,9 @@ MANIFEST_STAGE_PATH=""
 MANIFEST_TS=""
 MANIFEST_LAST_BACKUP=""
 
+# shellcheck source=../../tools/manifest-safety.sh
+. "$CONDUCTOR_ROOT/tools/manifest-safety.sh"
+
 init_manifest() {
   if [ "$DRY_RUN" = "true" ]; then
     log "would init manifest staging at $MANIFEST_PATH.staging"
@@ -287,12 +304,13 @@ record_emit() {
   local relpath="$1" src="$2" backup="${3:-}"
   local had_backup="false"
   [ -n "$backup" ] && had_backup="true"
-  local esc_path esc_src esc_backup
+  local esc_path esc_src esc_backup emitted_sha
   esc_path="$(printf '%s' "$relpath" | /usr/bin/sed 's/\\/\\\\/g; s/"/\\"/g')"
   esc_src="$(printf '%s' "$src" | /usr/bin/sed 's/\\/\\\\/g; s/"/\\"/g')"
   esc_backup="$(printf '%s' "$backup" | /usr/bin/sed 's/\\/\\\\/g; s/"/\\"/g')"
-  printf '    {"path": "%s", "source": "%s", "had_backup": %s, "backup_path": "%s"},\n' \
-    "$esc_path" "$esc_src" "$had_backup" "$esc_backup" >> "$MANIFEST_STAGE_PATH"
+  emitted_sha="$(conductor_sha256_file "$TARGET_ABS/$relpath")"
+  printf '    {"path": "%s", "source": "%s", "had_backup": %s, "backup_path": "%s", "sha256": "%s"},\n' \
+    "$esc_path" "$esc_src" "$had_backup" "$esc_backup" "$emitted_sha" >> "$MANIFEST_STAGE_PATH"
 }
 
 finalize_manifest() {
@@ -336,8 +354,9 @@ finalize_manifest() {
 
   /bin/cat > "$MANIFEST_PATH" <<EOF
 {
-  "version": "v0.2.0",
+  "version": "v$CONDUCTOR_VERSION",
   "adapter": "copilot",
+  "mode": "$MODE",
   "install_timestamp": "$MANIFEST_TS",
   "conductor_root": "$CONDUCTOR_ROOT",
   "per_rule_mode": $PER_RULE,
@@ -351,6 +370,19 @@ EOF
   log "  wrote manifest $MANIFEST_PATH"
 }
 
+# ----- framework detection (ADR-044 — suggest, NEVER auto-switch) ----------
+
+detect_coexisting_frameworks() {
+  local found=""
+  [ -d "$TARGET_ABS/.specify" ] && found="$found Spec-Kit"
+  { [ -d "$TARGET_ABS/_bmad" ] || [ -d "$TARGET_ABS/.bmad-core" ]; } && found="$found BMAD"
+  if [ -n "$found" ] && [ "$MODE" = "full" ]; then
+    log "NOTE: detected coexisting framework(s):$found"
+    log "      Consider --mode=recipes-only or --mode=reflector-only to coexist without"
+    log "      overlapping workflow rules (suggestion only — nothing was changed)."
+  fi
+}
+
 # ----- uninstall flow ----------------------------------------------------
 
 do_uninstall() {
@@ -383,6 +415,7 @@ do_uninstall() {
   local restored=0
   local deleted=0
   local missing=0
+  local preserved=0
 
   while IFS= read -r line; do
     case "$line" in
@@ -390,15 +423,26 @@ do_uninstall() {
       *) continue ;;
     esac
     entries_count=$((entries_count + 1))
-    local rel_path had_backup backup_path
+    local rel_path had_backup backup_path expected_sha
     rel_path="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"path": *"([^"]*)".*/\1/')"
     had_backup="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"had_backup": *(true|false).*/\1/')"
     backup_path="$(printf '%s' "$line" | /usr/bin/sed -E 's/.*"backup_path": *"([^"]*)".*/\1/')"
+    expected_sha="$(conductor_manifest_field "$line" sha256 2>/dev/null || true)"
 
     local abs_dest="$TARGET_ABS/$rel_path"
     local abs_backup=""
     [ -n "$backup_path" ] && abs_backup="$TARGET_ABS/$backup_path"
 
+    if [ -f "$abs_dest" ] && ! conductor_manifest_file_matches "$abs_dest" "$expected_sha"; then
+      if [ -z "$expected_sha" ]; then
+        log "  WARNING: preserving $rel_path (legacy manifest has no checksum)"
+      else
+        log "  WARNING: preserving user-modified $rel_path"
+      fi
+      preserved=$((preserved + 1))
+      continue
+    fi
+
     if [ "$had_backup" = "true" ] && [ -n "$abs_backup" ]; then
       if [ -f "$abs_backup" ]; then
         if [ "$DRY_RUN" = "true" ]; then
@@ -470,6 +514,7 @@ do_uninstall() {
   echo "  Backups restored: $restored"
   echo "  Files deleted: $deleted"
   echo "  Backup-missing deletes: $missing"
+  [ "$preserved" -gt 0 ] && echo "  User-modified files preserved: $preserved"
   echo "========================================================"
 }
 
@@ -503,6 +548,26 @@ if [ -f "$TARGET_ABS/.github/copilot-instructions.md" ] || [ -d "$TARGET_ABS/.gi
   IS_ADOPTER_CASE="true"
 fi
 
+detect_coexisting_frameworks
+
+# --mode=strict: never overwrite an existing baseline, even with a backup (ADR-044).
+if [ "$MODE" = "strict" ]; then
+  if [ -f "$TARGET_ABS/.github/copilot-instructions.md" ]; then
+    echo "Error (--mode=strict): $TARGET_ABS/.github/copilot-instructions.md already exists — strict mode aborts instead of overwriting a baseline." >&2
+    echo "  Use --mode=full (timestamped backup + manifest-based restore), or move the file first." >&2
+    exit 3
+  fi
+  if [ -d "$TARGET_ABS/.github/instructions" ] && [ -n "$(/bin/ls -A "$TARGET_ABS/.github/instructions" 2>/dev/null)" ]; then
+    echo "Error (--mode=strict): $TARGET_ABS/.github/instructions/ already has files — strict mode never writes next to an existing rules surface." >&2
+    exit 3
+  fi
+fi
+
+# À-la-carte modes are non-interactive by design.
+if [ "$MODE" != "full" ] && [ "$MODE" != "strict" ]; then
+  NO_PROMPT="true"
+fi
+
 if [ "$IS_ADOPTER_CASE" = "true" ] && [ "$NO_PROMPT" = "false" ] && [ "$DRY_RUN" = "false" ]; then
   echo ""
   echo "========================================================"
@@ -523,7 +588,7 @@ if [ "$IS_ADOPTER_CASE" = "true" ] && [ "$NO_PROMPT" = "false" ] && [ "$DRY_RUN"
 
   echo ""
   echo "Available recipes:"
-  echo "  web-mobile-parity, i18n, monorepo, branch-strategy, auto-mock-data, coding-conventions, tdd, debugging, database-discipline, design-system, self-improvement, git-hygiene"
+  echo "  web-mobile-parity, i18n, monorepo, branch-strategy, auto-mock-data, coding-conventions, tdd, debugging, database-discipline, design-system, self-improvement, git-hygiene, loop-engineering"
   printf "Select recipes (comma-separated, blank for none): "
   read -r _recipe_answer
   if [ -n "$_recipe_answer" ]; then
@@ -547,7 +612,9 @@ fi
 
 init_manifest
 
-if [ "$WIZARD_APPLY_RULES" = "true" ]; then
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  log "Step 1/4: universal-rules — skipped (--mode=$MODE is à la carte)"
+elif [ "$WIZARD_APPLY_RULES" = "true" ]; then
   if [ "$PER_RULE" = "true" ]; then
     log "Step 1/4: universal-rules → .github/instructions/*.instructions.md (per-rule mode)"
     mkdir_if_real "$TARGET_ABS/.github/instructions"
@@ -580,10 +647,12 @@ if [ "$WIZARD_APPLY_RULES" = "true" ]; then
 
 ## Topology note (Copilot)
 
-GitHub Copilot does not have sub-agent dispatch or commit-blocking hooks. The 5
-universal rules below are self-policed: the human (and Copilot Chat) must follow
+GitHub Copilot supports sub-agent dispatch and hooks natively (ADR-031), but
+CONDUCTOR's Copilot adapter currently emits rule text (plus the Reflector loop)
+only — full hook/agent emission is Phase 2. The 5
+universal rules below are therefore self-policed: the human (and Copilot Chat) must follow
 the same Plan → Architecture → Tasks → Implementation → Review → Spec workflow
-that Claude Code enforces with hooks. Two-stage code review degrades to the
+that Claude Code enforces with CONDUCTOR-emitted hooks. Two-stage code review degrades to the
 Copilot PR review feature for Stage B (configure separately at the repo level).
 
 ---
@@ -613,6 +682,7 @@ fi
 # ----- step 2: recipes → .github/instructions/<r>.instructions.md --------
 
 log "Step 2/4: recipes (opt-in) → .github/instructions/"
+INSTALLED_RECIPES=""
 if [ -n "$RECIPES" ]; then
   mkdir_if_real "$TARGET_ABS/.github/instructions"
   IFS=',' read -ra RECIPE_LIST <<< "$RECIPES"
@@ -631,13 +701,26 @@ if [ -n "$RECIPES" ]; then
     write_copilot_per_file "$src" "$dest" "$applyto"
     log "  recipe $r → applyTo: '$applyto'"
     record_emit ".github/instructions/$r.instructions.md" "core/recipes/$r.md" "$MANIFEST_LAST_BACKUP"
+    INSTALLED_RECIPES="$INSTALLED_RECIPES $r"
   done
 else
   log "  (no recipes selected — pass --recipes=name1,name2 to install)"
 fi
 
 # ---- Step 2.6: self-improvement runtime (only with --recipes=self-improvement) ----
-case ",$RECIPES," in
+if [ "$MODE" = "recipes-only" ] && [ -z "${INSTALLED_RECIPES// /}" ] && [ "$DRY_RUN" != "true" ]; then
+  echo "Error: --mode=recipes-only resolved ZERO valid recipes from '--recipes=$RECIPES' — nothing to install (check the names)." >&2
+  /bin/rm -f "$MANIFEST_STAGE_PATH"
+  exit 1
+fi
+
+if [ "$MODE" = "minimal" ]; then
+  RECIPES_FOR_RUNTIME=""
+  log "Step 2.6/4: self-improvement runtime — skipped (--mode=minimal ships text only)"
+else
+  RECIPES_FOR_RUNTIME="$RECIPES"
+fi
+case ",$RECIPES_FOR_RUNTIME," in
   *",self-improvement,"*)
     log "Step 2.6/4: self-improvement (Reflector) → hooks/prompt/agent"
     if [ "$DRY_RUN" != "true" ]; then
@@ -684,6 +767,9 @@ esac
 
 # ----- step 3: docs templates --------------------------------------------
 
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  log "Step 3/4: docs templates — skipped (--mode=$MODE is à la carte; docs ship with full/minimal)"
+else
 log "Step 3/4: docs templates → docs/"
 mkdir_if_real "$TARGET_ABS/docs"
 mkdir_if_real "$TARGET_ABS/docs/specs"
@@ -719,11 +805,13 @@ fi
 
 # ----- step 4: skip notice -----------------------------------------------
 
-log "Step 4/4: skipped layers (Copilot has no equivalent)"
-log "  - core/roles/         → SKIP (no sub-agent dispatch)"
+log "Step 4/4: skipped layers (not yet emitted for Copilot — tool supports them natively, ADR-031)"
+log "  - core/roles/         → SKIP (agent emission is Phase 2; Copilot supports sub-agents natively — ADR-031)"
 log "  - core/hooks/         → SKIP except Reflector hook (--recipes=self-improvement, ADR-032; other guards Claude-only, ADR-034)"
 log "  - hookify-templates/  → SKIP (Claude Code plugin only)"
 
+fi
+
 finalize_manifest
 
 # ----- summary -----------------------------------------------------------
@@ -732,13 +820,16 @@ echo ""
 echo "========================================================"
 echo " Done."
 echo "  Target: $TARGET_ABS"
-if [ "$PER_RULE" = "true" ]; then
+if [ "$MODE" = "recipes-only" ] || [ "$MODE" = "reflector-only" ]; then
+  echo "  Universal rules: 0 (à la carte)"
+elif [ "$PER_RULE" = "true" ]; then
   echo "  Universal rules: 5 → .github/instructions/*.instructions.md (per-rule mode)"
 else
   echo "  Universal rules: 5 → .github/copilot-instructions.md (single-file mode)"
 fi
 echo "  Recipes installed: ${RECIPES:-(none)}"
-echo "  Skipped (Copilot incompatibility): roles, hooks, hookify-templates"
+echo "  Mode: $MODE"
+echo "  Not emitted (Phase 2 — Copilot supports these natively, ADR-031/034): roles, guard hooks, hookify"
 echo ""
 echo " Activation:"
 echo "   GitHub Copilot reads .github/copilot-instructions.md and .github/instructions/"
@@ -752,6 +843,6 @@ echo "========================================================"
 echo ""
 echo "Next steps for the project:"
 echo "  1. Open the project in any IDE with Copilot enabled."
-echo "  2. Edit docs/CURRENT_WORK.md with the project's current state."
+[ -d "$TARGET_ABS/docs" ] && echo "  2. Edit docs/CURRENT_WORK.md with the project's current state."
 echo "  3. Configure Copilot PR review at the repo level (Stage B analog)."
 echo "  4. Verify: cat $TARGET_ABS/.github/copilot-instructions.md | head -30"

package/adapters/cursor/README.md

@@ -1,43 +1,41 @@
-# Adapter — Cursor (T1, partial support)
+# Adapter — Cursor (T1)
 
 Cursor is a strong CONDUCTOR target because:
 
 - It supports per-pattern rule scoping via `.cursor/rules/*.mdc` `globs:` front-matter — close to Claude's lazy rule loading.
-- It supports an always-loaded baseline via `.cursorrules`.
-- Its `.cursor/commands/*.md` provide a partial slash-command analog.
+- Universal rules install as `alwaysApply: true` `.mdc` files (the modern always-loaded mechanism; the legacy `.cursorrules` single file is opt-in via `--legacy-cursorrules`).
+- Its Skills surface (`.cursor/skills/` — the 2.4+ successor to project commands) gives a native `/reflect` entry point: CONDUCTOR emits `.cursor/skills/reflect/SKILL.md` with `--recipes=self-improvement`.
 - Its rule UI surfaces which rules loaded for the current file, useful for debugging.
 
-It is **partial T1** because:
+**Tool capability vs CONDUCTOR emission (ADR-031):** as of 2026 Cursor ships hooks, sub-agent dispatch, custom named agents, per-task model routing, and commands natively. What is limited today is what CONDUCTOR **emits** for it — rule text + docs + the opt-in Reflector loop; the enforcement guard hooks, role agents, and model-routing config are Phase-2 emission (ADR-034). That is a CONDUCTOR gap, not a Cursor limitation.
 
-- ❌ No sub-agent dispatch — single chat session per task.
-- ❌ No hooks — cannot ABSOLUTE-enforce spec-as-you-go or two-stage code review.
-- ❌ No per-call model routing — model is per-session.
-- ❌ No built-in memory directory — DIY at `.memory/`.
+**Tier**: T1 (see `docs/COMPATIBILITY-MATRIX.md` — glob rule-scoping + hooks incl. session/stop events + sub-agents + per-task model all present; richest non-Claude target for Phase-2 emission).
+
+> Enumerable facts about this adapter (output paths / tier / capabilities / live verification / headless CLI) are machine-readable in [`metadata.json`](./metadata.json) and CI-checked against `transform.sh` + the validator (ADR-040).
 
-**Tier**: T1 — Full support for what Cursor itself supports; partial vs Claude's reference implementation due to missing sub-agents/hooks.
 
 ## Installation path
 
 ```bash
-# Install (the cursor adapter is implemented):
-bash /path/to/conductor/adapters/cursor/transform.sh /path/to/target [--dry-run]
+# Recommended (npm, no clone):
+npx omniconductor init --target=cursor <target-dir>
 
-# (planned / roadmap — not yet available):
-# npx omniconductor init --target=cursor [target-dir]
+# Or from a local clone:
+bash /path/to/conductor/adapters/cursor/transform.sh /path/to/target [--dry-run] [--legacy-cursorrules]
 ```
 
 ## What gets installed
 
 ```
 <target>/
-├── .cursorrules                                # Always-loaded baseline
 ├── .cursor/
 │   └── rules/
-│       ├── operations.mdc                      # globs: **
-│       ├── coding-conventions.mdc              # globs: **/*.{ts,tsx,...}
-│       ├── token-economy.mdc                   # globs: **
-│       ├── spec-as-you-go.mdc                  # globs: docs/specs/**, **/*.md
-│       └── model-routing.mdc                   # globs: ** (informational)
+│       ├── workflow.mdc                        # alwaysApply: true
+│       ├── spec-as-you-go.mdc                  # alwaysApply: true
+│       ├── quality-gates.mdc                   # alwaysApply: true
+│       ├── operations.mdc                      # alwaysApply: true
+│       ├── meta-discipline.mdc                 # alwaysApply: true
+│       └── <recipe>.mdc                        # per --recipes=, path-scoped via globs:
 └── docs/
     ├── CURRENT_WORK.md                         # (universal templates, identical to other adapters)
     ├── REMAINING_TASKS.md
@@ -47,29 +45,32 @@ bash /path/to/conductor/adapters/cursor/transform.sh /path/to/target [--dry-run]
     └── specs/_example.md
 ```
 
-## Native features supported
+- `--legacy-cursorrules` additionally bundles everything into a flat `.cursorrules` (Cursor < 0.45).
+- `--recipes=self-improvement` additionally emits the Reflector loop: session-end trajectory hook config (`.cursor/hooks.json`), the `/reflect` Skill (`.cursor/skills/reflect/SKILL.md`), a reflector agent (`.cursor/agents/`), prune script, and the `.conductor/reflect/` weekly runner (ADR-032/033).
+
+## Native features supported (emitted today)
 
-- ✅ Always-loaded baseline (`.cursorrules`).
-- ✅ Per-pattern rule scoping (`globs:` on `.mdc`).
+- ✅ Always-loaded universal rules (`.mdc`, `alwaysApply: true`).
+- ✅ Per-pattern rule scoping (`globs:` on recipe `.mdc`).
 - ✅ All universal rule TEXT.
 - ✅ All doc templates.
-- ⚠️ Project commands (partial slash-command analog).
+- ✅ Reflector loop (opt-in recipe) — hook config + `/reflect` Skill + agent.
 
-## Features NOT supported (Cursor limitations)
+## Not emitted yet (Phase 2 — Cursor supports these natively, ADR-031/034)
 
-| Feature | Workaround |
+| Feature | Interim workaround |
 |---|---|
-| Sub-agent dispatch | Human plays orchestrator role manually. The orchestrator manual section in `.cursorrules` serves as the prompt template when starting a complex task. |
-| Hooks (Stop / PreToolUse) | Not available. Pair with a project-level pre-commit git hook for enforcement. |
-| Per-call model routing | Cursor uses one model per session. Switch sessions to switch model. Pick the right model in Cursor UI before starting a complex task. |
-| Built-in memory directory | DIY at `<target>/.memory/`. Add to `.gitignore`. |
+| Enforcement guard hooks (Stop / PreToolUse set) | Self-police, or pair with a project-level pre-commit git hook. Only the Reflector session-end hook is emitted today. |
+| The 6 role agents (sub-agent dispatch) | Cursor has native sub-agents; CONDUCTOR doesn't emit its role definitions for Cursor yet. Use the orchestrator-manual rule text as the prompt template. |
+| Per-call model-routing config | Pick the model in Cursor's UI per task (Cursor supports per-task model selection). |
+| 4-type memory pattern | Self-managed at `<target>/.memory/` (gitignored); Cursor's native Memories feature is separate. |
 | Specialized review agents (Stage A / Stage B) | Run review prompts manually in Cursor chat. |
 
 ## After install — first steps
 
 1. Open the target project in Cursor.
 2. Open the rule indicator (Cursor UI shows which rules loaded for the current file). Verify the universal rules appear.
-3. Customize `.cursorrules` — replace `{{PROJECT_NAME}}` placeholder.
+3. Skim the emitted `.cursor/rules/*.mdc` and adjust recipe `globs:` to your repo layout if needed.
 4. Rename `docs/specs/_example.md` → `docs/specs/<your-area>.md` and start a real spec.
 5. Add `.memory/` to `.gitignore`. Create your first memory entry.
 6. Add your first entry to `docs/CURRENT_WORK.md`.

package/adapters/cursor/metadata.json

@@ -0,0 +1,35 @@
+{
+  "_comment": "Single source for enumerable adapter facts (ADR-040). CI asserts transform.sh / validator / matrix agree with this file. Update HERE first; docs follow.",
+  "tool": "cursor",
+  "display_name": "Cursor",
+  "tier": "T1",
+  "outputs": [
+    { "path": ".cursor/rules", "kind": "rules", "validated": true },
+    { "path": "docs/CURRENT_WORK.md", "kind": "docs", "validated": false }
+  ],
+  "reflector_outputs": [
+    { "path": ".cursor/hooks.json", "note": "session-end trajectory hook config (recipe-gated)" },
+    { "path": ".conductor/reflect", "note": "runner + brief + scheduling (recipe-gated)" }
+  ],
+  "install": { "ala_carte": "per-file" },
+  "legacy_paths": [".cursorrules"],
+  "capabilities": {
+    "tool_native": {
+      "hooks": "yes",
+      "sub_agents": "yes",
+      "model_routing": "yes",
+      "commands": "yes",
+      "glob_scoping": "yes",
+      "scheduler": "cloud-only"
+    },
+    "conductor_emitted": {
+      "rules": "full",
+      "guard_hooks": "none",
+      "reflector_loop": "recipe",
+      "role_agents": "none",
+      "model_routing": "none"
+    }
+  },
+  "live_verification": { "status": "pending", "date": null, "cli": null, "note": "not yet run" },
+  "headless_cli": { "command": "cursor-agent", "invocation": "cursor-agent -p" }
+}