@speclife/cli 0.9.0 → 0.9.2

package/templates/commands/setup.md

@@ -4,295 +4,23 @@ id: speclife-setup
 category: SpecLife
 description: Discover project configuration and populate openspec/speclife.md.
 ---
-# /speclife setup
-
-Discover project configuration and populate `openspec/speclife.md`.
-
-## ⚡ Execution
-
-**When this command is invoked, IMMEDIATELY execute the workflow below.**
-
-- Scan project files to detect build system and commands
-- Check for existing workflows and context files
-- Update `openspec/speclife.md` with discovered configuration
-- Offer to create publish workflow if missing (ask first)
-
-## Goal
-
-Auto-detect project commands (test, build, lint), publishing configuration, and context files to configure speclife for this project.
-
-## Steps
-
-1. **Read current config**: Check if `openspec/speclife.md` exists and what's already configured
-
-2. **Detect build system**: Look for project configuration files:
-   - `package.json` → Node.js (npm/yarn/pnpm)
-   - `Cargo.toml` → Rust (cargo)
-   - `go.mod` → Go
-   - `Makefile` → Make-based
-   - `pyproject.toml` or `setup.py` → Python
-   - `build.gradle` or `pom.xml` → Java
-
-3. **Extract commands**: From the detected build system, find:
-   - **Test command**: e.g., `npm test`, `cargo test`, `make test`
-   - **Build command**: e.g., `npm run build`, `cargo build`, `make build`
-   - **Lint command**: e.g., `npm run lint`, `cargo clippy`, `make lint`
-
-4. **Detect publish configuration**: Based on project type:
-
-   | Project Type | Detection | Registry | Secret Required |
-   |--------------|-----------|----------|-----------------|
-   | Node.js | `package.json` with `name` (not private) | npm | `NPM_TOKEN` |
-   | Node.js monorepo | `workspaces` in package.json | npm | `NPM_TOKEN` |
-   | Rust | `Cargo.toml` with `[package]` | crates.io | `CARGO_REGISTRY_TOKEN` |
-   | Python | `pyproject.toml` with `[project]` | PyPI | `PYPI_TOKEN` |
-   | Go | `go.mod` | N/A (no central registry) | None |
-   | Internal/private | `"private": true` in package.json | N/A | None |
-
-5. **Check for existing workflows**: Look in `.github/workflows/` for:
-   - `publish.yml` or similar publish workflow
-   - `release.yml` - release workflow
-
-6. **Identify context files**: Look for common documentation:
-   - `openspec/project.md` - project context
-   - `openspec/AGENTS.md` - agent guidelines
-   - `README.md` - project overview
-   - `CONTRIBUTING.md` - contribution guidelines
-
-7. **Update speclife.md**: Write discovered values to `openspec/speclife.md`
-
-8. **Offer to create publish workflow** (if missing):
-   - If no publish workflow exists AND project is publishable (not private, not Go):
-     - Ask: "No publish workflow found. Would you like me to create `.github/workflows/publish.yml`?"
-     - If user agrees, create the appropriate workflow from the templates below
-     - Remind user to add the required secret in repo settings
-   - If project is private (`"private": true`) or Go (no central registry):
-     - Skip this step (no publish workflow needed)
-
-9. **Report**: Tell the user what was configured and any next steps
-
-## Publish Workflow Templates
-
-Use these templates when creating publish workflows:
-
-### Node.js (single package)
-```yaml
-# .github/workflows/publish.yml
-name: Publish to npm
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-      - run: npm ci
-      - run: npm test
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-```
-
-### Node.js (monorepo with workspaces)
-```yaml
-# .github/workflows/publish.yml
-name: Publish to npm
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-      - run: npm ci
-      - run: npm run build
-      - run: npm test
-      # Publish each workspace package
-      - run: npm publish -w packages/<package-name> --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-```
-
-### Rust
-```yaml
-# .github/workflows/publish.yml
-name: Publish to crates.io
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-      - run: cargo test
-      - run: cargo publish
-        env:
-          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
-```
-
-### Python
-```yaml
-# .github/workflows/publish.yml
-name: Publish to PyPI
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-      - run: pip install build twine
-      - run: python -m build
-      - run: twine upload dist/*
-        env:
-          TWINE_USERNAME: __token__
-          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
-```
-
-## Output
-
-Update `openspec/speclife.md` with discovered configuration:
-
-```markdown
-# SpecLife Configuration
-
-## Commands
-
-- **Test:** `<detected-test-command>`
-- **Build:** `<detected-build-command>`
-- **Lint:** `<detected-lint-command>`
-
-## Release Policy
-
-- **Auto-release:** patch and minor versions
-- **Manual release:** major versions (breaking changes)
-
-## Publish
-
-- **Registry:** npm / PyPI / crates.io / None
-- **Workflow:** .github/workflows/publish.yml (exists / TODO)
-- **Secret:** NPM_TOKEN / PYPI_TOKEN / CARGO_REGISTRY_TOKEN
-
-## Context Files
-
-When implementing changes, always read:
-- `openspec/project.md` - project context and conventions
-- `openspec/AGENTS.md` - agent guidelines
-- `README.md` - project overview
-```
-
-## Example Output
-
-### When publish workflow exists:
-```
-User: /speclife setup
-
-Agent:
-Detecting project configuration...
-
-✓ Project type: Node.js monorepo (npm workspaces)
-✓ Packages: @speclife/core, @speclife/cli, @speclife/mcp-server
-
-Commands detected:
-  ✓ Test: npm test
-  ✓ Build: npm run build
-  ✓ Lint: npm run lint
-
-Workflows:
-  ✓ Release: .github/workflows/release.yml
-  ✓ Publish: .github/workflows/publish.yml
-
-Context files:
-  ✓ openspec/project.md
-  ✓ openspec/AGENTS.md
-  ✓ README.md
-
-✓ Updated openspec/speclife.md
-```
-
-### When publish workflow is missing:
-```
-User: /speclife setup
-
-Agent:
-Detecting project configuration...
-
-✓ Project type: Node.js (single package)
-✓ Package: my-awesome-lib
-
-Commands detected:
-  ✓ Test: npm test
-  ✓ Build: npm run build
-  ✓ Lint: npm run lint
-
-Workflows:
-  ✓ Release: .github/workflows/release.yml
-  ⚠ Publish: Not found
-
-This package appears to be publishable to npm. Would you like me to create 
-`.github/workflows/publish.yml`?
-
-User: yes
-
-Agent:
-✓ Created .github/workflows/publish.yml
-
-⚠️ Remember to add NPM_TOKEN to your repository secrets:
-   GitHub → Settings → Secrets and variables → Actions → New repository secret
-   
-   Get your token from: https://www.npmjs.com/settings/~/tokens
-
-✓ Updated openspec/speclife.md
-
-Done! Your project is configured for automated releases and publishing.
-```
-
-### When project is private:
-```
-User: /speclife setup
-
-Agent:
-Detecting project configuration...
-
-✓ Project type: Node.js (private package)
-
-Commands detected:
-  ✓ Test: npm test
-  ✓ Build: npm run build
-
-Workflows:
-  ✓ Release: .github/workflows/release.yml
-  ℹ Publish: Not needed (private package)
-
-✓ Updated openspec/speclife.md
-```
-
-## Notes
-
-- If a command can't be detected, leave it as a TODO for the user
-- Don't overwrite user customizations if speclife.md already exists
-- This command is idempotent - safe to run multiple times
-- Always ask before creating publish workflow (don't auto-create)
-- Remind about secrets after creating publish workflow
-
-
+**Guardrails**
+- Execute immediately—scan project to auto-detect configuration
+- Don't overwrite existing user customizations in speclife.md
+- Ask before creating publish workflow (don't auto-create)
+
+**Steps**
+1. Read existing `openspec/speclife.md` if present.
+2. Detect build system: package.json (Node), Cargo.toml (Rust), go.mod (Go), pyproject.toml (Python), etc.
+3. Extract commands: test, build, lint from detected system (e.g., `npm test`, `cargo test`).
+4. Detect publish config: registry (npm/crates.io/PyPI), required secret, private flag.
+5. Check `.github/workflows/` for existing release/publish workflows.
+6. Identify context files: `openspec/project.md`, `openspec/AGENTS.md`, `README.md`.
+7. Update `openspec/speclife.md` with discovered values.
+8. If publishable and no publish workflow exists: ask user, create if agreed, remind about secrets.
+9. Report: project type, detected commands, workflow status, what was configured.
+
+**Reference**
+- Publish workflow templates: Node.js, Rust, Python (standard patterns)
+- Private packages (`"private": true`) skip publish workflow
+- Go has no central registry—skip publish step

package/templates/commands/ship.md

@@ -4,165 +4,21 @@ id: speclife-ship
 category: SpecLife
 description: Commit changes, push to remote, and create a PR for review.
 ---
-# /speclife ship
-
-Create a PR from your current branch. Works with spec branches and ad-hoc branches.
-
-## ⚡ Execution
-
-**When this command is invoked, IMMEDIATELY execute the workflow below.**
-
-- Do NOT skip steps or ask for confirmation before starting
-- Detect branch type first, then follow the appropriate flow
-- If there are uncommitted changes, proceed to stage and commit them
-- Create or update PR as the final step
-- **STOP after PR created—do NOT auto-invoke `/speclife land`**
-
-## TL;DR
-
-```
-/speclife ship           # Ship current branch
-/speclife ship --draft   # Create as draft PR
-```
-
-**Quick flow:**
-1. Detect branch type (spec vs ad-hoc)
-2. For spec branches: validate → commit changes → archive → commit archive
-3. For ad-hoc branches: stage, commit
-4. Push, create/update PR
-
-## Mode Detection
-
-```bash
-BRANCH=$(git branch --show-current)
-```
-
-| Branch | Type | Behavior |
-|--------|------|----------|
-| `spec/*` | **Spec** | Full workflow with OpenSpec (validate, archive) |
-| Any other non-main | **Ad-hoc** | Simplified (skip spec steps) |
-| `main` | **Error** | Cannot ship from main |
-
-Note: Spec mode is determined by branch name prefix (`spec/`), not worktree existence. Works identically whether you're in a worktree or the main repo.
-
-## Core Steps
-
-### 1. Spec Branch Only
-If spec branch detected:
-- Run `openspec validate <change-id>`
-- Read proposal.md for commit message
-- Commit the implementation changes:
-  ```bash
-  git add -A
-  git commit -m "<type>: <description>"
-  ```
-- Run `/openspec-archive` (may require updating project.md)
-- Commit the archive changes:
-  ```bash
-  git add -A
-  git commit -m "chore: archive <change-id> spec"
-  ```
-- Skip to step 3 (push only, no additional commit needed)
-
-### 2. Ad-hoc Branch Only
-- Infer commit type from branch name (`fix/*` → `fix:`, `feat/*` → `feat:`)
-- Ask user for commit message if needed
-
-### 3. All Branches
-```bash
-# For ad-hoc branches only (spec branches already committed above):
-git add -A
-git commit -m "<type>: <description>"  # if uncommitted changes
-
-# All branches:
-git push -u origin <branch>
-```
-
-### 4. Create PR
-```bash
-# Check if PR exists
-gh pr view --json url 2>/dev/null
-
-# If not, create
-gh pr create --fill --base main
-# Or: gh pr create --fill --base main --draft
-```
-
-### 5. Report and STOP
-```
-✓ Committed: "feat: description"
-✓ Pushed to origin/<branch>
-✓ Created PR #42: <url>
-
-Next: After approval, run /speclife land
-```
-
-**⛔ STOP HERE.** Do NOT proceed to merge. Wait for:
-1. PR review and approval
-2. User to invoke `/speclife land`
-
----
-
-<!-- REFERENCE SECTIONS - Read only when needed -->
-
-## Appendix: Commit Type Inference
-
-| Branch Pattern | Commit Type |
-|----------------|-------------|
-| `fix/*`, `bugfix/*`, `hotfix/*` | `fix:` |
-| `feat/*`, `feature/*` | `feat:` |
-| `docs/*` | `docs:` |
-| `refactor/*` | `refactor:` |
-| `chore/*` | `chore:` |
-| Other | Ask user |
-
-## Appendix: Error Handling
-
-**Cannot ship from main:**
-```
-❌ Cannot ship from main. Create a branch first.
-```
-
-**No changes:**
-```
-❌ No changes to ship. Working directory clean.
-```
-
-**Spec validation failed:**
-```
-❌ Spec validation failed:
-   - proposal.md: Missing "What" section
-Fix issues and retry, or use --skip-validation
-```
-
-**PR already exists:**
-```
-ℹ️ PR #43 already exists. Pushing updates...
-✓ Updated PR #43
-```
-
-## Appendix: Examples
-
-**Spec branch:**
-```
-User: /speclife ship
-
-Agent:
-ℹ️ Spec branch: spec/add-oauth-login
-✓ Validated spec
-✓ Committed: "feat: add OAuth login"
-✓ Archived to openspec/changes/archive/
-✓ Committed: "chore: archive add-oauth-login spec"
-✓ Pushed to origin/spec/add-oauth-login
-✓ Created PR #42
-```
-
-**Ad-hoc branch:**
-```
-User: /speclife ship
-
-Agent:
-ℹ️ Ad-hoc branch: fix/login-bug
-✓ Committed: "fix: resolve login redirect"
-✓ Created PR #43
-```
+**Guardrails**
+- Execute immediately—do not ask for confirmation
+- Detect branch type: `spec/*` = full OpenSpec workflow, other non-main = ad-hoc, `main` = error
+- STOP after PR created—do NOT auto-invoke `/speclife land`
+- Do NOT manually replicate `openspec` commands—run them and report errors if they fail
+
+**Steps**
+1. For spec branches: run `openspec validate <id>`, commit changes, run `openspec archive <id> --yes`, commit archive.
+2. For ad-hoc branches: infer commit type from branch name (`fix/*` → `fix:`, `feat/*` → `feat:`), ask if ambiguous.
+3. Push branch: `git push -u origin <branch>`.
+4. Create/update PR: `gh pr create --title "<type>: <description>" --body "<body>" --base main` (add `--draft` if requested).
+5. Report: commits made, branch pushed, PR URL. Next: `/speclife land` after approval.
+
+**Reference**
+- Commit type inference: fix/bugfix/hotfix → `fix:`, feat/feature → `feat:`, docs → `docs:`, refactor → `refactor:`, chore → `chore:`
+- If PR exists, push updates it automatically
+- PR title: use conventional commit format (`<type>: <meaningful description>`)
+- PR body: if `.github/pull_request_template.md` exists, read it and fill in each section based on the change context