saasforge 0.4.0__py3-none-any.whl

saasforge/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+if __name__ == "__main__":
+    app()

saasforge/adapters/__init__.py

@@ -0,0 +1,40 @@
+from .opencode import OpenCodeAdapter
+from .claude import ClaudeAdapter
+from .gemini import GeminiAdapter
+from .copilot import CopilotAdapter
+from .antigravity import AntigravityAdapter
+from .aider import AiderAdapter
+from .kilocode import KilocodeAdapter
+from .openroutercli import OpenRouterCLIAdapter
+from .terminal import TerminalAdapter
+from .cursor import CursorAdapter
+from .windsurf import WindsurfAdapter
+from .roo import RooAdapter
+from .codex import CodexAdapter
+from .qwen import QwenAdapter
+from .qoder import QoderAdapter
+
+ADAPTERS = {
+    "opencode": OpenCodeAdapter,
+    "claude": ClaudeAdapter,
+    "gemini": GeminiAdapter,
+    "copilot": CopilotAdapter,
+    "antigravity": AntigravityAdapter,
+    "aider": AiderAdapter,
+    "kilocode": KilocodeAdapter,
+    "openroutercli": OpenRouterCLIAdapter,
+    "terminal": TerminalAdapter,
+    "cursor": CursorAdapter,
+    "windsurf": WindsurfAdapter,
+    "roo": RooAdapter,
+    "codex": CodexAdapter,
+    "qwen": QwenAdapter,
+    "qoder": QoderAdapter,
+}
+
+def get_adapter(name: str):
+    cls = ADAPTERS.get(name.lower())
+    if cls is None:
+        available = ", ".join(ADAPTERS.keys())
+        raise ValueError(f"Unknown adapter '{name}'. Available: {available}")
+    return cls()

saasforge/adapters/aider.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class AiderAdapter(CLIAdapter):
+    name = "aider"
+    folder = ".aider"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        rules_dir = target_dir / self.folder
+        rules_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+
+        conventions = rules_dir / "CONVENTIONS.md"
+        if not conventions.exists():
+            conventions.write_text(
+                f"# Aider Conventions for {tool_name}\n\n"
+                f"## Stack\n"
+                f"- Frontend: Next.js + Tailwind + Shadcn\n"
+                f"- Backend: Python FastAPI\n"
+                f"- Database: Turso (libsql-client)\n"
+                f"- Auth: Better Auth\n"
+                f"- Storage: Cloudflare R2\n\n"
+                f"## Workflow\n"
+                f"1. Read spec before implementing\n"
+                f"2. Write tests alongside code\n"
+                f"3. Follow existing patterns\n",
+                encoding="utf-8",
+            )
+            created.append(conventions)
+
+        for cmd in ["specify", "plan", "implement"]:
+            path = rules_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(f"# {cmd}\n\nSaaSForge instruction for {tool_name}.", encoding="utf-8")
+                created.append(path)
+
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/antigravity.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class AntigravityAdapter(CLIAdapter):
+    name = "antigravity"
+    folder = ".antigravity"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        rules_dir = target_dir / self.folder / "rules"
+        rules_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+
+        for cmd in ["constitute", "specify", "plan", "tasks", "implement"]:
+            path = rules_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(f"# {cmd}\n\nSaaSForge instruction for {tool_name}.", encoding="utf-8")
+                created.append(path)
+
+        readme = target_dir / self.folder / "README.md"
+        if not readme.exists():
+            readme.write_text(f"# Antigravity Rules for {tool_name}\n\nGenerated by SaaSForge.", encoding="utf-8")
+            created.append(readme)
+
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/base.py

@@ -0,0 +1,13 @@
+from pathlib import Path
+from typing import Protocol
+
+
+class CLIAdapter(Protocol):
+    name: str
+    folder: str
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        ...
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        ...

saasforge/adapters/claude.py

@@ -0,0 +1,22 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class ClaudeAdapter(CLIAdapter):
+    name = "claude"
+    folder = ".claude"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder / "commands"
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        for cmd in ["constitute", "specify", "plan", "tasks", "implement"]:
+            path = cmds_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(f"# {cmd}\n\nSaaSForge command for {tool_name}.", encoding="utf-8")
+                created.append(path)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/codex.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class CodexAdapter(CLIAdapter):
+    name = "codex"
+    folder = ".codex"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder / "instructions"
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        rules = cmds_dir / "saasforge.md"
+        if not rules.exists():
+            rules.write_text(
+                f"# Codex SaaSForge Instructions — {tool_name}\n\n"
+                f"## Workflow\n"
+                f"Use these slash commands in order:\n"
+                f"- `/sp.specify` — Define what to build\n"
+                f"- `/sp.plan` — Plan with tech stack\n"
+                f"- `/sp.tasks` — Break into tasks\n"
+                f"- `/sp.implement` — Execute all tasks\n"
+                f"- `/sp.analyze` — Check consistency\n",
+                encoding="utf-8",
+            )
+            created.append(rules)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/copilot.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class CopilotAdapter(CLIAdapter):
+    name = "copilot"
+    folder = ".github"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        instructions_dir = target_dir / self.folder / "instructions"
+        instructions_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+
+        for cmd in ["constitute", "specify", "plan", "tasks", "implement"]:
+            path = instructions_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(f"# {cmd}\n\nSaaSForge instruction for {tool_name}.", encoding="utf-8")
+                created.append(path)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/cursor.py

@@ -0,0 +1,34 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class CursorAdapter(CLIAdapter):
+    name = "cursor"
+    folder = ".cursor"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        rules_dir = target_dir / self.folder / "rules"
+        rules_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        rules = rules_dir / "saasforge-workflow.mdc"
+        if not rules.exists():
+            rules.write_text(
+                f"---\n"
+                f"description: SaaSForge spec-driven workflow for {tool_name}\n"
+                f"---\n"
+                f"\n"
+                f"# SaaSForge Workflow — {tool_name}\n\n"
+                f"Use these commands in order:\n"
+                f"1. `/sp.specify` — Define requirements\n"
+                f"2. `/sp.plan` — Create implementation plan\n"
+                f"3. `/sp.tasks` — Break into tasks\n"
+                f"4. `/sp.implement` — Execute\n"
+                f"5. `/sp.analyze` — Review consistency\n",
+                encoding="utf-8",
+            )
+            created.append(rules)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/gemini.py

@@ -0,0 +1,32 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class GeminiAdapter(CLIAdapter):
+    name = "gemini"
+    folder = ".gemini"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        config = f"""# Gemini CLI config for {tool_name}
+instruction_dirs:
+  - {self.folder}/instructions
+"""
+        path = cmds_dir / "config.yaml"
+        path.write_text(config, encoding="utf-8")
+        created.append(path)
+
+        instr_dir = cmds_dir / "instructions"
+        instr_dir.mkdir(exist_ok=True)
+        for cmd in ["constitute", "specify", "plan", "tasks", "implement"]:
+            ipath = instr_dir / f"{cmd}.md"
+            if not ipath.exists():
+                ipath.write_text(f"# {cmd}\n\nSaaSForge instruction for {tool_name}.", encoding="utf-8")
+                created.append(ipath)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/kilocode.py

@@ -0,0 +1,36 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class KilocodeAdapter(CLIAdapter):
+    name = "kilocode"
+    folder = ".kilocode"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder / "instructions"
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+
+        for cmd in ["constitute", "specify", "plan", "tasks", "implement", "analyze"]:
+            path = cmds_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(f"# {cmd}\n\nSaaSForge instruction for {tool_name}.", encoding="utf-8")
+                created.append(path)
+
+        config = target_dir / self.folder / "config.yml"
+        if not config.exists():
+            config.write_text(
+                f"# KiloCode config for {tool_name}\n"
+                f"project: {tool_name}\n"
+                f"framework: spec-driven\n"
+                f"instruction_dirs:\n"
+                f"  - {self.folder}/instructions\n",
+                encoding="utf-8",
+            )
+            created.append(config)
+
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/opencode.py

@@ -0,0 +1,74 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+COMMANDS = {
+    "sp.constitution.md": """# Constitute Project
+
+Analyze the project requirements and establish core principles:
+1. Read _system/DNA.md for architecture patterns
+2. Read project README or requirements
+3. Establish coding standards and conventions
+4. Document architectural decisions
+""",
+    "sp.specify.md": """# Specify
+
+Create a detailed specification for the next component:
+1. Review existing specs and requirements
+2. Define acceptance criteria
+3. Document API contracts if applicable
+4. Specify data models and schemas
+""",
+    "sp.plan.md": """# Plan
+
+Create implementation plan from specification:
+1. Break down into discrete tasks
+2. Estimate complexity
+3. Identify dependencies
+4. Define testing strategy
+""",
+    "sp.tasks.md": """# Tasks
+
+Generate actionable tasks from the plan:
+1. Create individual task descriptions
+2. Define completion criteria
+3. Assign ownership (if applicable)
+4. Set priority levels
+""",
+    "sp.implement.md": """# Implement
+
+Execute the implementation plan:
+1. Follow the tech stack from DNA.md
+2. Create tests alongside implementation
+3. Follow existing code patterns
+4. Update TOOL_PLAN.md with progress
+""",
+    "sp.analyze.md": """# Analyze
+
+Cross-artifact consistency and alignment check:
+1. Verify spec matches requirements
+2. Verify plan matches spec
+3. Verify implementation matches plan
+4. Report any gaps or inconsistencies
+""",
+}
+
+
+class OpenCodeAdapter(CLIAdapter):
+    name = "opencode"
+    folder = ".opencode"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        commands_dir = target_dir / self.folder / "command"
+        commands_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        for filename, content in COMMANDS.items():
+            path = commands_dir / filename
+            if not path.exists():
+                path.write_text(f"# {tool_name} — {filename}\n\n{content}", encoding="utf-8")
+                created.append(path)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/openroutercli.py

@@ -0,0 +1,39 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class OpenRouterCLIAdapter(CLIAdapter):
+    name = "openroutercli"
+    folder = ".openrouter"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        config_dir = target_dir / self.folder
+        config_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+
+        config = config_dir / "config.yml"
+        if not config.exists():
+            config.write_text(
+                f"# OpenRouter CLI config for {tool_name}\n"
+                f"project: {tool_name}\n"
+                f"model: deepseek/deepseek-chat\n"
+                f"system_prompt: |\n"
+                f"  You are building a Micro-SaaS tool called {tool_name}.\n"
+                f"  Follow SaaSForge spec-driven workflow.\n",
+                encoding="utf-8",
+            )
+            created.append(config)
+
+        prompts_dir = config_dir / "prompts"
+        prompts_dir.mkdir(exist_ok=True)
+        for cmd in ["specify", "plan", "implement", "review"]:
+            path = prompts_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(f"# {cmd}\n\nPrompt for {tool_name}.", encoding="utf-8")
+                created.append(path)
+
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/qoder.py

@@ -0,0 +1,25 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class QoderAdapter(CLIAdapter):
+    name = "qoder"
+    folder = ".qoder"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder / "commands"
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        for cmd in ["specify", "plan", "tasks", "implement"]:
+            path = cmds_dir / f"sp.{cmd}.md"
+            if not path.exists():
+                path.write_text(
+                    f"# /sp.{cmd}\n\nSaaSForge workflow command for {tool_name}.",
+                    encoding="utf-8",
+                )
+                created.append(path)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/qwen.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class QwenAdapter(CLIAdapter):
+    name = "qwen"
+    folder = ".qwen"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        rules = cmds_dir / "saasforge.md"
+        if not rules.exists():
+            rules.write_text(
+                f"# Qwen SaaSForge — {tool_name}\n\n"
+                f"## Spec-Driven Workflow\n\n"
+                f"Always follow this order:\n"
+                f"1. **Specify** (`/sp.specify`): Write functional requirements\n"
+                f"2. **Plan** (`/sp.plan`): Choose tech stack and architecture\n"
+                f"3. **Tasks** (`/sp.tasks`): Create actionable task list\n"
+                f"4. **Implement** (`/sp.implement`): Build incrementally\n"
+                f"5. **Analyze** (`/sp.analyze`): Verify cross-artifact consistency\n",
+                encoding="utf-8",
+            )
+            created.append(rules)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/roo.py

@@ -0,0 +1,25 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class RooAdapter(CLIAdapter):
+    name = "roo"
+    folder = ".roo"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        cmds_dir = target_dir / self.folder / "commands"
+        cmds_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        for cmd in ["specify", "plan", "tasks", "implement", "analyze"]:
+            path = cmds_dir / f"{cmd}.md"
+            if not path.exists():
+                path.write_text(
+                    f"# /sp.{cmd}\n\nSaaSForge {cmd} command for {tool_name}.",
+                    encoding="utf-8",
+                )
+                created.append(path)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/adapters/terminal.py

@@ -0,0 +1,45 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class TerminalAdapter(CLIAdapter):
+    name = "terminal"
+    folder = ".saasforge"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        config_dir = target_dir / self.folder
+        config_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+
+        config = config_dir / "config.yml"
+        if not config.exists():
+            config.write_text(
+                f"# SaaSForge config for {tool_name}\n"
+                f"project: {tool_name}\n"
+                f"stack:\n"
+                f"  frontend: nextjs\n"
+                f"  backend: fastapi\n"
+                f"  database: turso\n"
+                f"  auth: better-auth\n"
+                f"workflow: spec-driven\n",
+                encoding="utf-8",
+            )
+            created.append(config)
+
+        readme = config_dir / "README.md"
+        if not readme.exists():
+            readme.write_text(
+                f"# SaaSForge — {tool_name}\n\n"
+                f"Run `saasforge` commands to manage this project:\n"
+                f"- `saasforge workflow --ai terminal`: Generate workflow\n"
+                f"- `saasforge deploy .`: Check deploy readiness\n"
+                f"- `saasforge dna --validate`: Validate DNA\n",
+                encoding="utf-8",
+            )
+            created.append(readme)
+
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, Path.cwd().name)

saasforge/adapters/windsurf.py

@@ -0,0 +1,30 @@
+from pathlib import Path
+
+from .base import CLIAdapter
+
+
+class WindsurfAdapter(CLIAdapter):
+    name = "windsurf"
+    folder = ".windsurf"
+
+    def generate_commands(self, target_dir: Path, tool_name: str) -> list[Path]:
+        rules_dir = target_dir / self.folder
+        rules_dir.mkdir(parents=True, exist_ok=True)
+        created = []
+        rules = rules_dir / "saasforge_rules.md"
+        if not rules.exists():
+            rules.write_text(
+                f"# Windsurf SaaSForge Rules — {tool_name}\n\n"
+                f"Follow this spec-driven workflow:\n"
+                f"1. Specify requirements (/sp.specify)\n"
+                f"2. Plan implementation (/sp.plan)\n"
+                f"3. Create tasks (/sp.tasks)\n"
+                f"4. Implement (/sp.implement)\n"
+                f"5. Analyze consistency (/sp.analyze)\n",
+                encoding="utf-8",
+            )
+            created.append(rules)
+        return created
+
+    def generate_init(self, target_dir: Path) -> list[Path]:
+        return self.generate_commands(target_dir, "project")

saasforge/builtins/constitution.md

@@ -0,0 +1,18 @@
+# Project Constitution
+
+## Core Principles
+
+1. **Free-first infrastructure** — Always start with free tiers (Vercel $0, HF $0, Turso $0)
+2. **Isolation** — Every tool gets its own DB, own Space, own Vercel project
+3. **AI-first** — Use free AI models (Gemini Free, DeepSeek V4 Free) before any paid API
+4. **Security** — 6-layer security: Auth, API, DB, File, Deploy, AI Bill Protection
+5. **Spec-driven** — Spec → Plan → Tasks → Implement → Review
+
+## Tech Stack (Locked)
+
+- Frontend: Next.js + Tailwind + Shadcn → Vercel
+- Backend: Python FastAPI → Hugging Face Spaces (Docker SDK)
+- Database: Turso (libsql-client)
+- Auth: Better Auth (JWT, self-hosted)
+- Storage: Cloudflare R2
+- Payments: Lemon Squeezy + Keenu

saasforge/builtins/specs/plan-template.md

@@ -0,0 +1,20 @@
+# Implementation Plan: {{ tool_name }}
+
+## Phase 1: CLI Prototype
+
+- [ ] Set up Python environment + dependencies
+- [ ] Implement core logic
+- [ ] Write unit tests
+
+## Phase 2: API + UI
+
+- [ ] Build FastAPI endpoints
+- [ ] Create frontend pages
+- [ ] API tests
+
+## Phase 3: Production
+
+- [ ] Dockerfile for HF Spaces
+- [ ] Vercel deployment
+- [ ] Security audit
+- [ ] Tag v1.0.0

saasforge/builtins/specs/spec-template.md

@@ -0,0 +1,31 @@
+# Specification: {{ tool_name }}
+
+## Overview
+
+Brief description of what this tool does.
+
+## User Stories
+
+- As a [user], I want to [action] so that [benefit]
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /api/health | Health check |
+| POST | /api/upload | Upload file |
+
+## Data Models
+
+```python
+class Item(BaseModel):
+    id: str
+    name: str
+    created_at: str
+```
+
+## Acceptance Criteria
+
+- [ ] Feature 1 works
+- [ ] Feature 2 works
+- [ ] Tests pass