feat: initial release

Author: lucifer1004

.claude/commands/discuss.md

@@ -0,0 +1,85 @@
+---
+description: Fast path for trivial changes — skip governance, minimal ceremony
+allowed-tools: Read, Write, StrReplace, Shell, Glob, Grep, LS, SemanticSearch, TodoWrite
+argument-hint: <what-to-do>
+---
+
+# /quick — Fast Path Workflow
+
+Execute a lightweight workflow for trivial changes: `$ARGUMENTS`
+
+**Use for:** Documentation fixes, typos, comments, small refactors, non-behavioral changes.
+
+**Do NOT use for:** New features, behavioral changes, anything requiring RFC/ADR.
+
+---
+
+## WORKFLOW
+
+### 1. Validate Environment
+
+```bash
+govctl status
+```
+
+**Detect VCS:** Try `jj status` first. If it succeeds, use jujutsu. Otherwise use git.
+
+### 2. Create Work Item
+
+```bash
+govctl work new --active "<concise-title>"
+govctl work add <WI-ID> acceptance_criteria "chore: Change completed"
+```
+
+### 3. Implement
+
+Make the changes. If referencing governance artifacts in code comments, use `[[artifact-id]]` syntax:
+
+```rust
+// Implements [[RFC-0001:C-FOO]]
+```
+
+Run validations:
+
+```bash
+govctl check
+```
+
+### 4. Record
+
+```bash
+# jj
+jj commit -m "<type>(<scope>): <description>"
+
+# git
+git add . && git commit -m "<type>(<scope>): <description>"
+```
+
+### 5. Complete
+
+```bash
+govctl work tick <WI-ID> acceptance_criteria "Change completed" -s done
+govctl work move <WI-ID> done
+```
+
+### 6. Final Record
+
+```bash
+# jj
+jj commit -m "chore(work): complete <WI-ID>"
+
+# git
+git add . && git commit -m "chore(work): complete <WI-ID>"
+```
+
+---
+
+## WHEN TO SWITCH TO /gov
+
+If during implementation you discover:
+
+- This requires behavioral changes → switch to `/gov`
+- This needs RFC specification → switch to `/gov`
+- This is an architectural decision → switch to `/gov`
+
+**BEGIN EXECUTION NOW.**

.claude/commands/gov.md

@@ -0,0 +1,91 @@
+---
+description: Show governance status — read-only summary of RFCs, ADRs, and work items
+allowed-tools: Read, Shell, Glob, Grep, LS
+argument-hint: [focus-area]
+---
+
+# /status — Governance Status
+
+Display the current governance state. Read-only, no mutations.
+
+---
+
+## OVERVIEW
+
+```bash
+govctl status
+```
+
+---
+
+## DETAILED VIEWS
+
+### RFCs
+
+```bash
+govctl rfc list
+```
+
+### ADRs
+
+```bash
+govctl adr list
+```
+
+### Work Items
+
+```bash
+# All pending (queue + active)
+govctl work list pending
+
+# All work items
+govctl work list
+```
+
+---
+
+## FOCUS AREAS
+
+If `$ARGUMENTS` specifies a focus:
+
+| Argument              | Action                  |
+| --------------------- | ----------------------- |
+| `rfc` or `rfcs`       | Show RFC list only      |
+| `adr` or `adrs`       | Show ADR list only      |
+| `work` or `tasks`     | Show work items only    |
+| `pending` or `active` | Show pending work items |
+| `<RFC-ID>`            | Read specific RFC       |
+| `<ADR-ID>`            | Read specific ADR       |
+| `<WI-ID>`             | Read specific work item |
+
+---
+
+## VALIDATION
+
+Check for governance issues:
+
+```bash
+govctl check
+```
+
+---
+
+## OUTPUT FORMAT
+
+Provide a structured summary:
+
+```
+=== GOVERNANCE STATUS ===
+
+RFCs: <count> (<normative>/<draft>/<deprecated>)
+ADRs: <count> (<accepted>/<proposed>/<deprecated>)
+Work Items: <active>/<queue>/<done>
+
+Active Work:
+- <WI-ID>: <title>
+
+Recent Activity:
+- <summary of recent changes>
+```
+
+**This is a read-only command. No files will be modified.**

.claude/commands/quick.md

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+  RUST_BACKTRACE: 1
+
+jobs:
+  ci:
+    name: CI
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Format
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-features -- -D warnings
+
+      - name: Test
+        run: cargo test --all-features
+
+      - name: Build
+        run: cargo build --release
+
+  build:
+    name: Build (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo build --release
+
+  deny:
+    name: cargo-deny
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: EmbarkStudios/cargo-deny-action@v2
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: llvm-tools-preview
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Install cargo-llvm-cov
+        uses: taiki-e/install-action@cargo-llvm-cov
+
+      - name: Generate coverage
+        run: cargo llvm-cov --all-features --lcov --output-path lcov.info
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          fail_ci_if_error: false
+          files: lcov.info
+          token: ${{ secrets.CODECOV_TOKEN }}

.claude/commands/status.md

@@ -0,0 +1,61 @@
+name: mdBook
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build:
+    name: Build Book
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup mdBook
+        uses: peaceiris/actions-mdbook@v2
+        with:
+          mdbook-version: "0.5.2"
+
+      - name: Install govctl
+        uses: jaxxstorm/action-install-gh-release@v2.1.0
+        with:
+          repo: govctl-org/govctl
+          tag: latest
+
+      - name: Build mdbook
+        run: ./scripts/build-book.sh
+
+      # Upload for PR inspection
+      - name: Upload book artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: book
+          path: docs/book
+
+      # Upload for Pages deployment (main branch only)
+      - name: Upload Pages artifact
+        if: github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: docs/book
+
+  deploy:
+    name: Deploy to Pages
+    if: github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: Pre-commit
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version: "1.25"
+
+      - name: Install govctl
+        uses: jaxxstorm/action-install-gh-release@v2.1.0
+        with:
+          repo: govctl-org/govctl
+          tag: latest
+
+      - uses: j178/prek-action@v1
+        with:
+          extra-args: --all-files