@smilintux/skcapstone 0.1.0

package/.cursorrules

@@ -0,0 +1,33 @@
+# SKCapstone — Cursor Agent Rules
+
+## Multi-Agent Coordination (REQUIRED)
+
+At the START of every session, run: skcapstone coord briefing
+
+This teaches you the full coordination protocol. It works in any terminal.
+
+Quick commands:
+  skcapstone coord status                   # See what's available
+  skcapstone coord claim <id> --agent <you> # Claim work
+  skcapstone coord complete <id> --agent <you> # Mark done
+  skcapstone coord create --title "..." --by <you> # New task
+  skcapstone coord board                    # Regenerate BOARD.md
+
+The coordination board lives at ~/.skcapstone/coordination/ and syncs
+via Syncthing. Only write to YOUR OWN agent file. Tasks are immutable
+after creation.
+
+## Skill Available
+
+If the skcapstone-coordination skill is available in your skills list,
+read it for the full detailed protocol. Otherwise, `skcapstone coord briefing`
+gives you everything you need.
+
+## Code Conventions
+
+- Python 3.11+, PEP 8, black formatting
+- Type hints on all functions
+- Pydantic for data validation
+- Google-style docstrings
+- Pytest tests in /tests mirroring src structure
+- Max 500 lines per file — split into modules if approaching

package/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: python -m pytest tests/ -v --tb=short
+      - run: pip install black ruff && black --check src/ tests/ && ruff check src/
+        if: matrix.python-version == '3.12'

package/.github/workflows/publish.yml

@@ -0,0 +1,52 @@
+name: Publish to PyPI and npm
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: python -m pytest tests/ -v
+
+  publish-pypi:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+
+  publish-npm:
+    needs: test
+    runs-on: ubuntu-latest
+    if: hashFiles('package.json') != ''
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/AGENTS.md

@@ -0,0 +1,74 @@
+# SKCapstone — Agent Onboarding (Universal)
+
+This file provides instructions for ANY AI agent working on SKCapstone,
+regardless of tool, IDE, or platform.
+
+## Step 1: Learn the Coordination Protocol
+
+```bash
+skcapstone coord briefing
+```
+
+This single command prints everything you need:
+- The complete multi-agent coordination protocol
+- JSON schemas for tasks and agent files
+- CLI commands for all operations
+- A live snapshot of current tasks and who's working on what
+
+For machine-readable output:
+
+```bash
+skcapstone coord briefing --format json
+```
+
+## Step 2: Check In
+
+```bash
+skcapstone coord status
+```
+
+See what tasks are open, what's claimed, and which agents are active.
+
+## Step 3: Claim Work
+
+```bash
+skcapstone coord claim <task_id> --agent <your_name>
+```
+
+## Step 4: Do the Work
+
+Follow the project conventions:
+- Python 3.11+, PEP 8, type hints, black formatting
+- Pydantic for data models
+- Pytest tests (happy path + edge case + failure case)
+- Google-style docstrings on every function
+- Max 500 lines per file
+
+## Step 5: Complete
+
+```bash
+skcapstone coord complete <task_id> --agent <your_name>
+```
+
+## Step 6: Create Discovered Work
+
+```bash
+skcapstone coord create --title "What needs doing" --by <your_name>
+```
+
+## Directory Reference
+
+| Path | Purpose |
+|------|---------|
+| `src/skcapstone/` | Core framework modules |
+| `tests/` | Pytest test suite |
+| `docs/` | Architecture and design docs |
+| `~/.skcapstone/coordination/` | Syncthing-synced task board |
+| `~/.skcapstone/coordination/tasks/` | Task JSON files (immutable) |
+| `~/.skcapstone/coordination/agents/` | Agent status JSON files |
+
+## How Sync Works
+
+The `~/.skcapstone/` directory is synchronized via Syncthing across all
+devices in the mesh. No SSH, no APIs, no cloud services — just encrypted
+peer-to-peer file sync. Create a task here, it appears everywhere.

package/CLAUDE.md

@@ -0,0 +1,56 @@
+# SKCapstone — Agent Instructions (Claude Code)
+
+You are working on **SKCapstone**, a sovereign agent framework built under
+the Fiducia Communitatis PMA. This file ensures you integrate with the
+multi-agent coordination system regardless of which tool you run in.
+
+## First Thing Every Session
+
+Run this command to learn the full coordination protocol:
+
+```bash
+skcapstone coord briefing
+```
+
+This prints the complete protocol, JSON schemas, rules, and a live snapshot
+of current tasks and agent assignments. It works in any terminal.
+
+## Quick Reference
+
+```bash
+skcapstone coord status              # See open tasks and agent states
+skcapstone coord claim <id> --agent <you>   # Claim a task
+skcapstone coord complete <id> --agent <you> # Mark done
+skcapstone coord create --title "..." --by <you>  # Add new work
+skcapstone coord board               # Regenerate BOARD.md
+skcapstone coord briefing --format json      # Machine-readable protocol
+```
+
+## Key Rules
+
+1. **Read before you write** — check the board before starting work
+2. **Own your file** — only write to `~/.skcapstone/coordination/agents/<your_name>.json`
+3. **Tasks are immutable** — never edit a task file after creation
+4. **Claim before working** — prevents duplicate effort across agents
+5. **Create discovered work** — if you find something that needs doing, add a task
+
+## Project Structure
+
+- `src/skcapstone/` — Core framework (models, CLI, coordination, memory, sync)
+- `tests/` — Pytest tests mirroring src structure
+- `docs/` — Architecture, security design, sovereign singularity spec
+- `~/.skcapstone/coordination/` — Syncthing-synced task board (JSON files)
+
+## Code Style
+
+- Python 3.11+, PEP 8, type hints everywhere
+- Format with `black`, validate with `pydantic`
+- Google-style docstrings on every function
+- Tests: pytest, at least 3 per feature (happy path, edge case, failure)
+
+## Running Tests
+
+```bash
+cd /home/cbrd21/Nextcloud/p/smilintux-org/skcapstone
+python -m pytest tests/ -v
+```