specsmith 0.20.1.dev748__tar.gz → 0.20.1.dev749__tar.gz

{specsmith-0.20.1.dev748/src/specsmith.egg-info → specsmith-0.20.1.dev749}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.20.1.dev748
+Version: 0.20.1.dev749
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT
@@ -357,6 +357,20 @@ specsmith audit                          # full governance health check
 > Every utterance is preflighted automatically. Use `/why` to see the governance trace.
 > For the multi-agent DAG dispatcher, see `specsmith dispatch run "<task>"`.
 
+### Standalone CLI (no AI agent)
+
+All governance commands work without any AI agent or IDE integration:
+
+```bash
+specsmith audit                     # governance health check
+specsmith preflight "<intent>" --json  # gate a change
+specsmith verify                    # check equilibrium after changes
+specsmith save                      # ESDB backup + commit + push
+specsmith kill-session              # clean shutdown
+```
+
+For the full standalone session workflow, Nexus REPL usage, multi-agent dispatcher, and CI integration: **[Standalone CLI docs →](https://specsmith.readthedocs.io/en/stable/standalone-cli/)**
+
 ---
 
 ## Machine State Sync + YAML Governance
@@ -1155,6 +1169,121 @@ oz agent run-cloud --skill "layer1labs/specsmith:specsmith-save" --prompt "save
 
 ---
 
+## Agent Integrations
+
+Run `specsmith integrate <tool>` once in your project root — specsmith writes the governance file your AI client reads automatically.
+
+| Tool | Command | Generated file | MCP support |
+|---|---|---|---|
+| **Warp** | `specsmith integrate warp` | `.warp/specsmith-mcp.json` + `.warp/launch_configs/` | ✓ Native |
+| **Claude Code** | `specsmith integrate claude-code` | `CLAUDE.md` | ✓ via `.mcp.json` |
+| **Cursor** | `specsmith integrate cursor` | `.cursor/rules/governance.mdc` | ✓ via `.cursor/mcp.json` |
+| **Windsurf** | `specsmith integrate windsurf` | `.windsurfrules` | ✓ via Settings → MCP |
+| **Gemini CLI** | `specsmith integrate gemini` | `GEMINI.md` | — |
+| **Aider** | `specsmith integrate aider` | `.aider.conf.yml` | — |
+| **Copilot** | `specsmith integrate copilot` | `.github/copilot-instructions.md` | — |
+
+All generated files embed the same core content: governance rules, the mandatory session protocol, preflight requirements, and AGENTS.md as the primary governance source.
+
+### Mandatory session protocol (all tools)
+
+```bash
+# Session start
+specsmith kill-session 2>/dev/null || true
+specsmith audit --project-dir .
+specsmith sync  --project-dir .
+specsmith checkpoint --project-dir .   # output GOVERNANCE ANCHOR verbatim
+
+# Before every code change
+specsmith preflight "<describe the change>" --json
+# decision == "accepted"           → proceed with work_item_id in scope
+# decision == "needs_clarification" → surface instruction to user first
+
+# Every 8–10 turns
+specsmith checkpoint --project-dir .
+
+# Session end
+specsmith save && specsmith kill-session
+```
+
+### Claude Code
+
+```bash
+specsmith integrate claude-code   # writes CLAUDE.md
+```
+
+To enable native MCP tool calls, add to `.mcp.json` (project root) or `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "specsmith-governance": {
+      "command": "specsmith",
+      "args": ["mcp", "serve", "--project-dir", "."]
+    }
+  }
+}
+```
+
+Or run `specsmith mcp install-claude-code` to print the snippet. With MCP configured, Claude calls governance tools natively — no shell roundtrip.
+
+### Cursor
+
+```bash
+specsmith integrate cursor   # writes .cursor/rules/governance.mdc
+```
+
+Add to `.cursor/mcp.json` to enable MCP:
+
+```json
+{
+  "specsmith-governance": {
+    "command": "specsmith",
+    "args": ["mcp", "serve", "--project-dir", "${workspaceFolder}"]
+  }
+}
+```
+
+### Windsurf
+
+```bash
+specsmith integrate windsurf   # writes .windsurfrules
+```
+
+MCP: **Settings → MCP Servers** → `{ "specsmith-governance": { "command": "specsmith", "args": ["mcp", "serve"] } }`
+
+### Gemini CLI
+
+```bash
+specsmith integrate gemini   # writes GEMINI.md (read automatically by the gemini CLI)
+```
+
+### Aider
+
+```bash
+specsmith integrate aider   # writes .aider.conf.yml
+```
+
+For full governance, use `--no-auto-commits` and commit via `specsmith save`:
+
+```bash
+aider --no-auto-commits --read AGENTS.md --read .agents/skills/specsmith-session-governance/SKILL.md
+```
+
+Run `specsmith preflight` in a separate terminal before each change; run `specsmith save` after aider finishes.
+
+### GitHub Copilot
+
+```bash
+specsmith integrate copilot   # writes .github/copilot-instructions.md
+```
+
+Copilot reads `.github/copilot-instructions.md` for all workspace interactions. MCP not yet natively supported; governance is enforced through the instructions file and `AGENTS.md`.
+
+Full per-tool setup: **[Agent Integrations docs →](https://specsmith.readthedocs.io/en/stable/agent-integrations/)**
+
+---
+
 ## Warp Terminal Integration
 
 specsmith ships first-class integration with [Warp](https://www.warp.dev) terminal: a

{specsmith-0.20.1.dev748 → specsmith-0.20.1.dev749}/README.md

@@ -279,6 +279,20 @@ specsmith audit                          # full governance health check
 > Every utterance is preflighted automatically. Use `/why` to see the governance trace.
 > For the multi-agent DAG dispatcher, see `specsmith dispatch run "<task>"`.
 
+### Standalone CLI (no AI agent)
+
+All governance commands work without any AI agent or IDE integration:
+
+```bash
+specsmith audit                     # governance health check
+specsmith preflight "<intent>" --json  # gate a change
+specsmith verify                    # check equilibrium after changes
+specsmith save                      # ESDB backup + commit + push
+specsmith kill-session              # clean shutdown
+```
+
+For the full standalone session workflow, Nexus REPL usage, multi-agent dispatcher, and CI integration: **[Standalone CLI docs →](https://specsmith.readthedocs.io/en/stable/standalone-cli/)**
+
 ---
 
 ## Machine State Sync + YAML Governance
@@ -1077,6 +1091,121 @@ oz agent run-cloud --skill "layer1labs/specsmith:specsmith-save" --prompt "save
 
 ---
 
+## Agent Integrations
+
+Run `specsmith integrate <tool>` once in your project root — specsmith writes the governance file your AI client reads automatically.
+
+| Tool | Command | Generated file | MCP support |
+|---|---|---|---|
+| **Warp** | `specsmith integrate warp` | `.warp/specsmith-mcp.json` + `.warp/launch_configs/` | ✓ Native |
+| **Claude Code** | `specsmith integrate claude-code` | `CLAUDE.md` | ✓ via `.mcp.json` |
+| **Cursor** | `specsmith integrate cursor` | `.cursor/rules/governance.mdc` | ✓ via `.cursor/mcp.json` |
+| **Windsurf** | `specsmith integrate windsurf` | `.windsurfrules` | ✓ via Settings → MCP |
+| **Gemini CLI** | `specsmith integrate gemini` | `GEMINI.md` | — |
+| **Aider** | `specsmith integrate aider` | `.aider.conf.yml` | — |
+| **Copilot** | `specsmith integrate copilot` | `.github/copilot-instructions.md` | — |
+
+All generated files embed the same core content: governance rules, the mandatory session protocol, preflight requirements, and AGENTS.md as the primary governance source.
+
+### Mandatory session protocol (all tools)
+
+```bash
+# Session start
+specsmith kill-session 2>/dev/null || true
+specsmith audit --project-dir .
+specsmith sync  --project-dir .
+specsmith checkpoint --project-dir .   # output GOVERNANCE ANCHOR verbatim
+
+# Before every code change
+specsmith preflight "<describe the change>" --json
+# decision == "accepted"           → proceed with work_item_id in scope
+# decision == "needs_clarification" → surface instruction to user first
+
+# Every 8–10 turns
+specsmith checkpoint --project-dir .
+
+# Session end
+specsmith save && specsmith kill-session
+```
+
+### Claude Code
+
+```bash
+specsmith integrate claude-code   # writes CLAUDE.md
+```
+
+To enable native MCP tool calls, add to `.mcp.json` (project root) or `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "specsmith-governance": {
+      "command": "specsmith",
+      "args": ["mcp", "serve", "--project-dir", "."]
+    }
+  }
+}
+```
+
+Or run `specsmith mcp install-claude-code` to print the snippet. With MCP configured, Claude calls governance tools natively — no shell roundtrip.
+
+### Cursor
+
+```bash
+specsmith integrate cursor   # writes .cursor/rules/governance.mdc
+```
+
+Add to `.cursor/mcp.json` to enable MCP:
+
+```json
+{
+  "specsmith-governance": {
+    "command": "specsmith",
+    "args": ["mcp", "serve", "--project-dir", "${workspaceFolder}"]
+  }
+}
+```
+
+### Windsurf
+
+```bash
+specsmith integrate windsurf   # writes .windsurfrules
+```
+
+MCP: **Settings → MCP Servers** → `{ "specsmith-governance": { "command": "specsmith", "args": ["mcp", "serve"] } }`
+
+### Gemini CLI
+
+```bash
+specsmith integrate gemini   # writes GEMINI.md (read automatically by the gemini CLI)
+```
+
+### Aider
+
+```bash
+specsmith integrate aider   # writes .aider.conf.yml
+```
+
+For full governance, use `--no-auto-commits` and commit via `specsmith save`:
+
+```bash
+aider --no-auto-commits --read AGENTS.md --read .agents/skills/specsmith-session-governance/SKILL.md
+```
+
+Run `specsmith preflight` in a separate terminal before each change; run `specsmith save` after aider finishes.
+
+### GitHub Copilot
+
+```bash
+specsmith integrate copilot   # writes .github/copilot-instructions.md
+```
+
+Copilot reads `.github/copilot-instructions.md` for all workspace interactions. MCP not yet natively supported; governance is enforced through the instructions file and `AGENTS.md`.
+
+Full per-tool setup: **[Agent Integrations docs →](https://specsmith.readthedocs.io/en/stable/agent-integrations/)**
+
+---
+
 ## Warp Terminal Integration
 
 specsmith ships first-class integration with [Warp](https://www.warp.dev) terminal: a

{specsmith-0.20.1.dev748 → specsmith-0.20.1.dev749}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.20.1.dev748"
+version = "0.20.1.dev749"
 description = "AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider."
 readme = "README.md"
 license = "MIT"

{specsmith-0.20.1.dev748 → specsmith-0.20.1.dev749/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.20.1.dev748
+Version: 0.20.1.dev749
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT
@@ -357,6 +357,20 @@ specsmith audit                          # full governance health check
 > Every utterance is preflighted automatically. Use `/why` to see the governance trace.
 > For the multi-agent DAG dispatcher, see `specsmith dispatch run "<task>"`.
 
+### Standalone CLI (no AI agent)
+
+All governance commands work without any AI agent or IDE integration:
+
+```bash
+specsmith audit                     # governance health check
+specsmith preflight "<intent>" --json  # gate a change
+specsmith verify                    # check equilibrium after changes
+specsmith save                      # ESDB backup + commit + push
+specsmith kill-session              # clean shutdown
+```
+
+For the full standalone session workflow, Nexus REPL usage, multi-agent dispatcher, and CI integration: **[Standalone CLI docs →](https://specsmith.readthedocs.io/en/stable/standalone-cli/)**
+
 ---
 
 ## Machine State Sync + YAML Governance
@@ -1155,6 +1169,121 @@ oz agent run-cloud --skill "layer1labs/specsmith:specsmith-save" --prompt "save
 
 ---
 
+## Agent Integrations
+
+Run `specsmith integrate <tool>` once in your project root — specsmith writes the governance file your AI client reads automatically.
+
+| Tool | Command | Generated file | MCP support |
+|---|---|---|---|
+| **Warp** | `specsmith integrate warp` | `.warp/specsmith-mcp.json` + `.warp/launch_configs/` | ✓ Native |
+| **Claude Code** | `specsmith integrate claude-code` | `CLAUDE.md` | ✓ via `.mcp.json` |
+| **Cursor** | `specsmith integrate cursor` | `.cursor/rules/governance.mdc` | ✓ via `.cursor/mcp.json` |
+| **Windsurf** | `specsmith integrate windsurf` | `.windsurfrules` | ✓ via Settings → MCP |
+| **Gemini CLI** | `specsmith integrate gemini` | `GEMINI.md` | — |
+| **Aider** | `specsmith integrate aider` | `.aider.conf.yml` | — |
+| **Copilot** | `specsmith integrate copilot` | `.github/copilot-instructions.md` | — |
+
+All generated files embed the same core content: governance rules, the mandatory session protocol, preflight requirements, and AGENTS.md as the primary governance source.
+
+### Mandatory session protocol (all tools)
+
+```bash
+# Session start
+specsmith kill-session 2>/dev/null || true
+specsmith audit --project-dir .
+specsmith sync  --project-dir .
+specsmith checkpoint --project-dir .   # output GOVERNANCE ANCHOR verbatim
+
+# Before every code change
+specsmith preflight "<describe the change>" --json
+# decision == "accepted"           → proceed with work_item_id in scope
+# decision == "needs_clarification" → surface instruction to user first
+
+# Every 8–10 turns
+specsmith checkpoint --project-dir .
+
+# Session end
+specsmith save && specsmith kill-session
+```
+
+### Claude Code
+
+```bash
+specsmith integrate claude-code   # writes CLAUDE.md
+```
+
+To enable native MCP tool calls, add to `.mcp.json` (project root) or `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "specsmith-governance": {
+      "command": "specsmith",
+      "args": ["mcp", "serve", "--project-dir", "."]
+    }
+  }
+}
+```
+
+Or run `specsmith mcp install-claude-code` to print the snippet. With MCP configured, Claude calls governance tools natively — no shell roundtrip.
+
+### Cursor
+
+```bash
+specsmith integrate cursor   # writes .cursor/rules/governance.mdc
+```
+
+Add to `.cursor/mcp.json` to enable MCP:
+
+```json
+{
+  "specsmith-governance": {
+    "command": "specsmith",
+    "args": ["mcp", "serve", "--project-dir", "${workspaceFolder}"]
+  }
+}
+```
+
+### Windsurf
+
+```bash
+specsmith integrate windsurf   # writes .windsurfrules
+```
+
+MCP: **Settings → MCP Servers** → `{ "specsmith-governance": { "command": "specsmith", "args": ["mcp", "serve"] } }`
+
+### Gemini CLI
+
+```bash
+specsmith integrate gemini   # writes GEMINI.md (read automatically by the gemini CLI)
+```
+
+### Aider
+
+```bash
+specsmith integrate aider   # writes .aider.conf.yml
+```
+
+For full governance, use `--no-auto-commits` and commit via `specsmith save`:
+
+```bash
+aider --no-auto-commits --read AGENTS.md --read .agents/skills/specsmith-session-governance/SKILL.md
+```
+
+Run `specsmith preflight` in a separate terminal before each change; run `specsmith save` after aider finishes.
+
+### GitHub Copilot
+
+```bash
+specsmith integrate copilot   # writes .github/copilot-instructions.md
+```
+
+Copilot reads `.github/copilot-instructions.md` for all workspace interactions. MCP not yet natively supported; governance is enforced through the instructions file and `AGENTS.md`.
+
+Full per-tool setup: **[Agent Integrations docs →](https://specsmith.readthedocs.io/en/stable/agent-integrations/)**
+
+---
+
 ## Warp Terminal Integration
 
 specsmith ships first-class integration with [Warp](https://www.warp.dev) terminal: a