refacil-sdd-ai 4.5.1 → 4.5.3

package/README.md

@@ -38,6 +38,18 @@ refacil-sdd-ai init
 #    Generates AGENTS.md and the .agents/ directory for the project
 ```
 
+### Adding a new IDE to an existing installation
+
+If you already have the methodology installed for Claude Code or Cursor and want to add OpenCode (or any other IDE), just run `init` again from the repo root:
+
+```bash
+refacil-sdd-ai init
+```
+
+The selector will pre-select the IDEs whose folders already exist (`.claude/`, `.cursor/`). Check the new IDE you want to add (e.g. OpenCode), leave the existing ones checked, and confirm — only the newly selected IDE will receive files; existing installations are refreshed in place.
+
+> **`update` does not add new IDEs** — it only updates IDEs already installed. Use `init` to add a new one.
+
 ### Update
 
 ```bash
@@ -54,14 +66,6 @@ refacil-sdd-ai clean           # in the repo (removes skills + SDD-AI hooks for
 npm uninstall -g refacil-sdd-ai
 ```
 
-### Legacy `openspec/` directory
-
-Older repos may still have **`openspec/changes/`**. The package **migrates automatically** to **`refacil-sdd/`** the first time you run any **`refacil-sdd-ai sdd …`** subcommand or when **`check-update`** runs at session start. After you confirm the tree under **`refacil-sdd/`**, you can remove the leftover **`openspec/`** folder.
-
-Some teams still install the **OpenSpec CLI** for **`opsx:*`** commands; those can coexist with SDD-AI. The **supported** path for changes, review markers, and archiving is **`refacil-sdd/`** plus **`refacil-sdd-ai sdd`** and **`/refacil:*`** skills.
-
----
-
 ## CLI Commands
 
 ### Package management

package/bin/cli.js

@@ -207,7 +207,8 @@ async function selectIDEs() {
     const clack = require('@clack/prompts');
     const result = await clack.multiselect({
       message: 'Select IDEs to install refacil-sdd-ai into:',
-      options: options.map((o) => ({ label: o.label, value: o.value, selected: o.selected })),
+      options: options.map((o) => ({ label: o.label, value: o.value })),
+      initialValues: options.filter((o) => o.selected).map((o) => o.value),
       required: false,
     });
     if (clack.isCancel(result)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refacil-sdd-ai",
-  "version": "4.5.1",
+  "version": "4.5.3",
   "description": "SDD-AI: Specification-Driven Development with AI — development methodology using AI with Claude Code, Cursor and OpenCode",
   "bin": {
     "refacil-sdd-ai": "./bin/cli.js"
@@ -21,6 +21,7 @@
     "methodology",
     "claude-code",
     "cursor",
+    "opencode",
     "sdd",
     "specification-driven",
     "testing",

package/skills/prereqs/METHODOLOGY-CONTRACT.md

@@ -55,24 +55,48 @@ Critical rule:
 
 ### Protocol when the current branch is protected
 
-If the current branch is protected and code needs to be written:
-
-1. **Ask for a task identifier first** — before any git action, ask the user:
-   *"What is the task number or name for this branch? (e.g. SEGINF-20, REF-123, or a short descriptive name)"*
-   Wait for the user's answer before continuing.
-2. Verify clean working directory (`git status --porcelain`).
-3. If there are uncommitted changes, ask for approval to `git stash push -m "auto-stash-refacil"`.
-4. Detect the base branch to create a working branch from:
+If the current branch is protected and code needs to be written, follow the gates below strictly. Each gate is a hard stop — do not proceed to the next gate until the user has replied in the current one.
+
+---
+
+**[GATE 1 — STOP AND WAIT: ask for task identifier]**
+
+Ask the user exactly this question and then STOP. Do NOT run any git command. Do NOT propose a branch name. Do NOT continue to Gate 2 until the user replies:
+
+> "What is the task number or identifier for this branch? (e.g. SEGINF-20, REF-123, or a short descriptive name)"
+
+If the user says they have no ID, note that and proceed to Gate 2 with `<ID> = none`.
+
+---
+
+**[GATE 2 — STOP AND WAIT: propose branch name and ask for approval]**
+
+Only after receiving the user's reply to Gate 1:
+
+1. Verify clean working directory (`git status --porcelain`).
+2. If there are uncommitted changes, ask for approval to stash them (`git stash push -m "auto-stash-refacil"`). Do NOT stash without approval.
+3. Detect the base branch:
    - Prefer `develop`, then `dev`.
    - Only if neither exists (new repo), use `main` or `master` as a temporary exception.
-   - Switch and update (`git pull origin <base>`). If none exist, stop.
-5. **Propose the branch name and wait for explicit user approval before creating it:**
+4. Compose the branch name:
    - Feature: `feature/<ID>` (e.g. `feature/SEGINF-20`)
    - Bugfix: `fix/<ID>` (e.g. `fix/SEGINF-20`)
-   - Without ID: propose a short descriptive name (e.g. `fix/project-root-consistency`) and **require explicit approval** before proceeding.
-   Example: *"I'll create branch `fix/SEGINF-20` from `develop`. Shall I proceed?"*
-6. **Only after explicit user confirmation**: create the branch and restore stash if used.
-7. If the user does not approve at any point, stop.
+   - Without ID: propose a short descriptive name (e.g. `fix/session-timeout-redis`)
+5. Present the proposed name and ask for approval. Then STOP. Do NOT run `git checkout` or `git switch`. Do NOT create the branch yet. Wait for the user's explicit confirmation:
+
+> "I'll create branch `<proposed-name>` from `<base-branch>`. Shall I proceed?"
+
+---
+
+**[GATE 3 — execute only after explicit approval from Gate 2]**
+
+Only after the user explicitly confirms (e.g. "yes", "go", "ok", "proceed"):
+
+1. Switch to the base branch and update it (`git checkout <base>` + `git pull origin <base>`).
+2. Create the working branch (`git checkout -b <branch-name>`).
+3. If a stash was approved in Gate 2, restore it (`git stash pop`).
+
+If the user does not approve at Gate 2, stop entirely. Do not create any branch.
 
 ## §5 — Output policy (UX)