ouroboros-ai 0.26.2.dev38__tar.gz → 0.26.3.dev2__tar.gz

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "ouroboros",
       "description": "Transform vague ideas into validated seed specifications through Socratic questioning and ontological analysis",
-      "version": "0.26.1",
+      "version": "0.26.2",
       "author": {
         "name": "Q00",
         "email": "jqyu.lee@gmail.com"

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ouroboros",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "description": "Self-improving AI workflow system. Crystallize requirements before execution with Socratic interview, ambiguity scoring, and 3-stage evaluation.",
   "author": {
     "name": "Q00",

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ouroboros-ai
-Version: 0.26.2.dev38
+Version: 0.26.3.dev2
 Summary: Specification-first workflow engine for AI coding agents. Works with Claude Code and Codex CLI.
 Author-email: Q00 <jqyu.lee@gmail.com>
 License-File: LICENSE
@@ -143,6 +143,17 @@ See runtime guides: [Claude Code](./docs/runtime-guides/claude-code.md) · [Code
 
 </details>
 
+<details>
+<summary><strong>Uninstall</strong></summary>
+
+```bash
+ouroboros uninstall
+```
+
+Removes all configuration, MCP registration, and data. See [UNINSTALL.md](./UNINSTALL.md) for details.
+
+</details>
+
 > **Python >= 3.12 required.** See [pyproject.toml](./pyproject.toml) for the full dependency list.
 
 ---

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/README.ko.md

@@ -127,6 +127,17 @@ ouroboros setup                         # 런타임 설정
 
 </details>
 
+<details>
+<summary><strong>완전 삭제</strong></summary>
+
+```bash
+ouroboros uninstall
+```
+
+모든 설정, MCP 등록, 데이터를 제거합니다. 자세한 내용은 [UNINSTALL.md](./UNINSTALL.md)를 참고하세요.
+
+</details>
+
 <details>
 <summary><strong>무슨 일이 일어났나요?</strong></summary>
 

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/README.md

@@ -103,6 +103,17 @@ See runtime guides: [Claude Code](./docs/runtime-guides/claude-code.md) · [Code
 
 </details>
 
+<details>
+<summary><strong>Uninstall</strong></summary>
+
+```bash
+ouroboros uninstall
+```
+
+Removes all configuration, MCP registration, and data. See [UNINSTALL.md](./UNINSTALL.md) for details.
+
+</details>
+
 > **Python >= 3.12 required.** See [pyproject.toml](./pyproject.toml) for the full dependency list.
 
 ---

ouroboros_ai-0.26.3.dev2/UNINSTALL.md

@@ -0,0 +1,66 @@
+# Clean Uninstall Guide
+
+## One Command
+
+```bash
+ouroboros uninstall
+```
+
+This interactively removes all Ouroboros configuration:
+- MCP server registration (`~/.claude/mcp.json`, `~/.codex/config.toml`)
+- CLAUDE.md integration block (`<!-- ooo:START -->` ... `<!-- ooo:END -->`)
+- Codex rules and skills (`~/.codex/rules/ouroboros.md`, `~/.codex/skills/ouroboros/`)
+- Project-level config (`.ouroboros/`)
+- Data directory (`~/.ouroboros/` — config, credentials, DB, seeds, logs, locks, prefs)
+
+Then finish with:
+
+```bash
+uv tool uninstall ouroboros-ai            # or: pip uninstall ouroboros-ai
+claude plugin uninstall ouroboros         # if using Claude Code plugin
+```
+
+### Options
+
+| Flag | Effect |
+|:-----|:-------|
+| `-y`, `--yes` | Skip confirmation prompt |
+| `--dry-run` | Preview what would be removed, change nothing |
+| `--keep-data` | Keep entire `~/.ouroboros/` (config, credentials, seeds, DB, logs) |
+
+### Inside Claude Code
+
+Inside an active Claude Code session, type:
+
+```
+/ouroboros:setup --uninstall
+```
+
+This is a **skill command** (not a CLI flag) that removes MCP registration and the CLAUDE.md block interactively.
+
+---
+
+## What Lives Where
+
+| Path | Created by | Contents |
+|:-----|:-----------|:---------|
+| `~/.claude/mcp.json` | `ooo setup` / `ouroboros setup` | MCP server entry |
+| `~/.codex/config.toml` | `ouroboros setup --runtime codex` | Codex MCP section |
+| `~/.codex/rules/ouroboros.md` | `ouroboros setup --runtime codex` | Codex rules |
+| `~/.codex/skills/ouroboros/` | `ouroboros setup --runtime codex` | Codex skills |
+| `CLAUDE.md` | `ooo setup` | Command reference block |
+| `~/.ouroboros/config.yaml` | `ouroboros setup` | Runtime configuration |
+| `~/.ouroboros/credentials.yaml` | `ouroboros setup` | API credentials |
+| `~/.ouroboros/ouroboros.db` | First run | Event store + brownfield registry |
+| `~/.ouroboros/seeds/` | `ooo seed` / `ooo interview` | Generated seed specs |
+| `~/.ouroboros/data/` | `ooo interview` | Interview state |
+| `~/.ouroboros/logs/` | Any run | Log files |
+| `~/.ouroboros/locks/` | `ooo run` | Heartbeat locks |
+| `~/.ouroboros/prefs.json` | `ooo setup` | Preferences |
+| `.ouroboros/` (project) | `ooo evaluate` | Mechanical eval config |
+
+## What Is NOT Removed
+
+- Your project source code and git history
+- Generated seed YAML files copied outside `~/.ouroboros/seeds/`
+- Package manager caches (run `uv cache clean ouroboros-ai` or `pip cache purge` if needed)

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/docs/cli-reference.md

@@ -42,7 +42,8 @@ ouroboros [OPTIONS] COMMAND [ARGS]...
 | `init` | Start interactive interview to refine requirements |
 | `run` | Execute Ouroboros workflows |
 | `cancel` | Cancel stuck or orphaned executions |
-| `config` | Manage Ouroboros configuration |
+| `config` | Manage Ouroboros configuration (show, switch backend, set values) |
+| `uninstall` | Cleanly remove all Ouroboros configuration from your system |
 | `status` | Check Ouroboros system status |
 | `tui` | Interactive TUI monitor for real-time workflow monitoring |
 | `monitor` | Shorthand for `tui monitor` |
@@ -311,11 +312,9 @@ ouroboros cancel execution orch_abc123 --reason "Stuck for 2 hours"
 
 Manage Ouroboros configuration.
 
-> **Current state:** the `config` subcommands are scaffolding. They currently print placeholder output and do not mutate `~/.ouroboros/config.yaml`. Use `ouroboros setup` for initial runtime setup, then edit `~/.ouroboros/config.yaml` directly for manual changes.
-
 ### `config show`
 
-Display current configuration.
+Display current configuration summary, or a specific section.
 
 ```bash
 ouroboros config show [SECTION]
@@ -325,16 +324,43 @@ ouroboros config show [SECTION]
 
 | Argument | Description |
 |----------|-------------|
-| `SECTION` | Configuration section to display (e.g., `providers`) |
+| `SECTION` | Configuration section to display (e.g., `orchestrator`, `llm`, `consensus`) |
 
 **Examples:**
 
 ```bash
-# Show all configuration
+# Show configuration summary (backend, CLI path, DB, log level)
 ouroboros config show
 
-# Show only providers section
-ouroboros config show providers
+# Show only orchestrator section
+ouroboros config show orchestrator
+```
+
+### `config backend`
+
+Show or switch the runtime backend. This sets both `orchestrator.runtime_backend` and `llm.backend` together — they are always kept in sync for simplicity. Advanced users can decouple them with `config set`.
+
+```bash
+ouroboros config backend [BACKEND]
+```
+
+**Arguments:**
+
+| Argument | Description |
+|----------|-------------|
+| `BACKEND` | Backend to switch to: `claude` or `codex`. Omit to show current |
+
+**Examples:**
+
+```bash
+# Show current backend
+ouroboros config backend
+
+# Switch to Codex CLI
+ouroboros config backend codex
+
+# Switch to Claude Code
+ouroboros config backend claude
 ```
 
 ### `config init`
@@ -349,7 +375,7 @@ Creates `~/.ouroboros/config.yaml` and `~/.ouroboros/credentials.yaml` with defa
 
 ### `config set`
 
-Set a configuration value.
+Set a configuration value using dot notation.
 
 ```bash
 ouroboros config set KEY VALUE
@@ -365,13 +391,16 @@ ouroboros config set KEY VALUE
 **Examples:**
 
 ```bash
-# Placeholder command surface (does not yet write files)
-ouroboros config set orchestrator.runtime_backend codex
+# Change log level
+ouroboros config set logging.level debug
+
+# Override LLM backend separately from runtime backend
+ouroboros config set llm.backend litellm
 ```
 
 ### `config validate`
 
-Validate current configuration.
+Validate current configuration. Checks that the runtime backend is supported and the CLI binary path exists.
 
 ```bash
 ouroboros config validate
@@ -379,6 +408,57 @@ ouroboros config validate
 
 ---
 
+## `ouroboros uninstall`
+
+Cleanly remove all Ouroboros configuration from your system. Reverses everything `ouroboros setup` did.
+
+```bash
+ouroboros uninstall [OPTIONS]
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `--keep-data` | Keep entire `~/.ouroboros/` directory (config, credentials, seeds, logs, DB) |
+| `--dry-run` | Show what would be removed without actually deleting |
+| `-y, --yes` | Skip confirmation prompt |
+
+**Examples:**
+
+```bash
+# Interactive uninstall (shows what will be removed, asks for confirmation)
+ouroboros uninstall
+
+# Non-interactive
+ouroboros uninstall -y
+
+# Preview only
+ouroboros uninstall --dry-run
+
+# Remove MCP/artifacts but keep ~/.ouroboros/
+ouroboros uninstall --keep-data
+```
+
+**What it removes:**
+
+- `ouroboros` entry from `~/.claude/mcp.json`
+- `[mcp_servers.ouroboros]` section from `~/.codex/config.toml`
+- `~/.codex/rules/ouroboros.md` and `~/.codex/skills/ouroboros/`
+- `<!-- ooo:START -->` … `<!-- ooo:END -->` block from `CLAUDE.md`
+- `.ouroboros/` directory in the current project
+- `~/.ouroboros/` directory (unless `--keep-data`)
+
+**What it does NOT remove:**
+
+- The Python package — run `pip uninstall ouroboros-ai` or `uv tool uninstall ouroboros-ai` separately
+- The Claude Code plugin — run `claude plugin uninstall ouroboros` separately
+- Your project source code or git history
+
+See [UNINSTALL.md](../UNINSTALL.md) for the full guide.
+
+---
+
 ## `ouroboros status`
 
 Check Ouroboros system status.

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/skills/setup/SKILL.md

@@ -246,7 +246,7 @@ A backup will be created: CLAUDE.md.bak
 **If "Preview first", show:**
 ````markdown
 <!-- ooo:START -->
-<!-- ooo:VERSION:0.26.1 -->
+<!-- ooo:VERSION:0.26.2 -->
 # Ouroboros — Specification-First AI Development
 
 > Before telling AI what to build, define what should be built.

{ouroboros_ai-0.26.2.dev38 → ouroboros_ai-0.26.3.dev2}/src/ouroboros/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.26.2.dev38'
-__version_tuple__ = version_tuple = (0, 26, 2, 'dev38')
+__version__ = version = '0.26.3.dev2'
+__version_tuple__ = version_tuple = (0, 26, 3, 'dev2')
 
 __commit_id__ = commit_id = None