Creer v0.9 — richer federation UX + release polish

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  backend:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Pytest
+        env:
+          PYTHONPATH: .
+        run: pytest -q
+
+  extension:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: extension
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+          cache-dependency-path: extension/package-lock.json
+
+      - name: Install and compile
+        run: |
+          npm ci
+          npm run compile

.github/workflows/release.yml

@@ -0,0 +1,98 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+          cache-dependency-path: extension/package-lock.json
+
+      - name: Install, compile, package
+        working-directory: extension
+        run: |
+          npm ci
+          npm run compile
+          npx --yes @vscode/vsce package
+
+      - name: Upload VSIX artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: creer-vsix
+          path: extension/*.vsix
+          if-no-files-found: error
+
+  github-release:
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - name: Download VSIX artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: creer-vsix
+          path: dist
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*.vsix
+          generate_release_notes: true
+          fail_on_unmatched_files: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    needs: [build]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download VSIX artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: creer-vsix
+          path: dist
+
+      - name: Publish (Marketplace / Open VSX when tokens present)
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+          OVSX_PAT: ${{ secrets.OVSX_PAT }}
+        run: |
+          set -euo pipefail
+          cd dist
+          shopt -s nullglob
+          vsix=(*.vsix)
+          if [ ${#vsix[@]} -eq 0 ]; then
+            echo "No .vsix artifact found"
+            exit 1
+          fi
+          echo "Packaged: ${vsix[*]}"
+
+          published=false
+          if [ -n "${VSCE_PAT:-}" ]; then
+            echo "Publishing to VS Marketplace…"
+            npx --yes @vscode/vsce publish --packagePath "${vsix[0]}" -p "$VSCE_PAT"
+            published=true
+          fi
+          if [ -n "${OVSX_PAT:-}" ]; then
+            echo "Publishing to Open VSX…"
+            npx --yes ovsx publish "${vsix[0]}" -p "$OVSX_PAT"
+            published=true
+          fi
+          if [ "$published" = false ]; then
+            echo "No publish tokens configured — artifact only"
+          fi

.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+*.log
+.env
+**/venv/
+**/__pycache__/
+**/node_modules/
+**/out/
+*.pyc
+.pytest_cache/

PLAN.md

@@ -0,0 +1,26 @@
+# Creer — Final Plan
+
+## Done
+
+- **v0.1** — FastAPI planner/generator + VS Code write-to-workspace (+ optional git)
+- **v0.2** — Preview, GitHub create/push, templates, overwrite protection, `/creer` chat
+- **v0.3** — Streaming, offline/local models, bake-ins, SecretStorage + GIT_ASKPASS
+- **v0.4** — Stream cancel, selectable license/CI bake-ins, quality gates
+- **v0.5** — Content diff preview before write, multi-root workspace targeting, installable JSON/YAML template packs
+- **v0.6** — Pack marketplace + remote URL install/delete, side-by-side conflict diffs, publish packaging
+- **v0.7** — Self-hosted pack registry (`/registry` + download), extension icon, Browse Pack Registry, release changelog
+- **v0.8** — Federated registry (`/registry/federated` + peers), Browse Federated Registry UI, GitHub Actions release + CI (artifact-first; signed publish when secrets exist)
+- **v0.9** — Peer status/probe UX (`creer.registryPeers`, Manage Registry Peers), federated browse enrichment, GitHub Release on tag + `RELEASE.md`
+
+## Optional next
+
+- Human: configure `VSCE_PAT` / `OVSX_PAT` repository secrets; tag `v0.9.0` (see [`RELEASE.md`](RELEASE.md))
+- More peer discovery / registry auth
+
+## Non-goals
+
+- Multi-agent orchestration
+- Memory graphs
+- Overengineered plugin frameworks
+
+Stay power-focused: idea → plan → files → workspace.

README.md

@@ -0,0 +1,88 @@
+# Creer
+
+AI-powered repo scaffolding inside your workspace.
+
+**Current version: 0.9.0**
+
+## Architecture
+
+```
+creer/
+├── backend/     # Python FastAPI AI engine (+ packs/ + registry)
+├── extension/   # VS Code extension (icon in media/)
+└── .github/     # CI + release workflows
+```
+
+## Quick start
+
+```bash
+# Backend
+cd backend && python -m venv venv && source venv/bin/activate
+pip install -r requirements.txt && cp .env.example .env
+uvicorn main:app --reload --port 8000
+
+# Extension
+cd extension && npm install && npm run compile
+# F5 → Creer: Create New Repo
+```
+
+## Registry & federation (v0.7–v0.9)
+
+Self-hosted pack catalog plus optional multi-host federation:
+
+| Method | Path | Description |
+|---|---|---|
+| `GET` | `/registry?q=&source=` | Searchable pack list |
+| `GET` | `/registry/federated?q=&source=&peers=` | Local + peer merge (extra peers CSV) |
+| `GET` | `/registry/peers` | Peer health + configured URLs |
+| `POST` | `/registry/peers/probe` | Probe one peer `{ url }` |
+| `GET` | `/registry/packs/{id}` | Pack metadata |
+| `GET` | `/registry/packs/{id}/download` | Portable JSON pack (installable URL) |
+| `GET` | `/marketplace` | Curated featured view |
+
+Extension settings: `creer.registryPeers` (comma-separated peer base URLs), `creer.showPeerStatus` (peer health in federated browse).
+
+Commands: **Creer: Browse Federated Registry**, **Creer: Manage Registry Peers**.
+
+Install from another Creer host:
+
+```bash
+curl -X POST http://localhost:8000/packs/install \
+  -H 'Content-Type: application/json' \
+  -d '{"url":"http://other-host:8000/registry/packs/fastapi-crud/download"}'
+```
+
+Set `CREER_PUBLIC_BASE_URL` for absolute download links in registry responses.
+Set `CREER_REGISTRY_PEERS` (comma-separated base URLs) for backend-configured federated discovery.
+Use `creer.registryPeers` in the extension for client-side extra peers when browsing.
+
+## Extension commands
+
+| Command | Title |
+|---|---|
+| `creer.createRepo` | Create New Repo |
+| `creer.createRepoFromChat` | Create from Chat Prompt |
+| `creer.browseMarketplace` | Browse Pack Marketplace |
+| `creer.browseRegistry` | Browse Pack Registry |
+| `creer.browseFederatedRegistry` | Browse Federated Registry |
+| `creer.manageRegistryPeers` | Manage Registry Peers |
+| `creer.installPackFromUrl` | Install Pack from URL |
+| `creer.setGitHubToken` / `clearGitHubToken` | SecretStorage token |
+
+## CI & publishing
+
+- **CI** (`.github/workflows/ci.yml`): pytest + extension compile on push/PR
+- **Release** (`.github/workflows/release.yml`): tag `v*` → package `.vsix`, create GitHub Release with attachment; publish to Marketplace / Open VSX only when `VSCE_PAT` / `OVSX_PAT` secrets are set
+
+See [`RELEASE.md`](RELEASE.md) and [`extension/PUBLISH.md`](extension/PUBLISH.md). Package locally:
+
+```bash
+cd extension && npm run compile && npm run package
+# → creer-0.9.0.vsix (includes media/icon.png)
+```
+
+Signed Marketplace / Open VSX publish requires your own `VSCE_PAT` / `OVSX_PAT` (never commit tokens).
+
+## License
+
+MIT

RELEASE.md

@@ -0,0 +1,56 @@
+# Releasing Creer v0.9.0
+
+Exact steps for a human maintainer to cut a tagged release with GitHub Release + optional Marketplace / Open VSX publish.
+
+## 1. Set repository secrets (once)
+
+In GitHub → **Settings → Secrets and variables → Actions**, add:
+
+| Secret | Purpose |
+|---|---|
+| `VSCE_PAT` | Azure DevOps PAT with Marketplace **Acquire** + **Publish** (publisher must match `extension/package.json` → `publisher`) |
+| `OVSX_PAT` | Open VSX access token from [open-vsx.org](https://open-vsx.org/) |
+
+Both are optional. If neither is set, the release workflow still builds the `.vsix`, uploads it as an artifact, and (on tag pushes) creates a **GitHub Release** with the `.vsix` attached. Marketplace / Open VSX publish is skipped with `No publish tokens configured — artifact only`.
+
+Never commit PATs. Prefer repo secrets over exporting tokens in shared shells.
+
+## 2. Bump & verify locally
+
+```bash
+# Confirm extension version is 0.9.0
+grep '"version"' extension/package.json
+
+cd extension
+npm ci
+npm run compile
+npm run package
+# → creer-0.9.0.vsix
+```
+
+Smoke-test: `code --install-extension creer-0.9.0.vsix` (or Cursor equivalent) against a running backend.
+
+## 3. Tag v0.9.0 and push
+
+From a clean `main` (or the release commit):
+
+```bash
+git tag -a v0.9.0 -m "Creer v0.9.0"
+git push origin v0.9.0
+```
+
+Tag pattern `v*` triggers [`.github/workflows/release.yml`](.github/workflows/release.yml).
+
+## 4. What the workflow does
+
+1. **build** — `npm ci` → `compile` → `vsce package` → upload `creer-vsix` artifact  
+2. **github-release** (tag pushes only) — create a GitHub Release and attach the `.vsix` (`contents: write`)  
+3. **publish** — if `VSCE_PAT` / `OVSX_PAT` secrets exist, publish to Marketplace / Open VSX; otherwise artifact-only
+
+You can also run the workflow via **Actions → Release → Run workflow** (`workflow_dispatch`) for a package/artifact without a tag (no GitHub Release job in that case).
+
+## 5. After release
+
+- Confirm the GitHub Release page lists `creer-0.9.0.vsix`
+- If secrets were set, confirm Marketplace / Open VSX listing updated to 0.9.0
+- See [`extension/PUBLISH.md`](extension/PUBLISH.md) for manual `vsce` / `ovsx` publish from a laptop

backend/.env.example

@@ -0,0 +1,27 @@
+# OpenAI API key (required unless CREER_OFFLINE=1 or using a local server that ignores it)
+OPENAI_API_KEY=sk-your-key-here
+
+# Optional OpenAI-compatible base URL for local/offline backends (Ollama, LM Studio, vLLM, etc.)
+# Example: http://127.0.0.1:11434/v1
+OPENAI_BASE_URL=
+
+# Model name (OpenAI or local-compatible)
+CREER_MODEL=gpt-4o-mini
+
+# Template-only / stub generation — never calls the LLM
+# Set to 1, true, or yes to enable
+CREER_OFFLINE=
+
+# Optional extra packs directory (JSON/YAML). Merged with backend/packs;
+# user packs override built-in packs on the same id.
+# When set, remote installs (POST /packs/install) write here.
+# When unset, installs go to backend/packs/installed/.
+# CREER_PACKS_DIR=/path/to/my-packs
+
+# Optional public base URL for absolute registry download links
+# Example: http://localhost:8000 or https://creer.example.com
+# CREER_PUBLIC_BASE_URL=http://localhost:8000
+
+# Comma-separated peer Creer registry base URLs (federated discovery, v0.8)
+# Example: http://127.0.0.1:8001,https://creer-packs.example.com
+# CREER_REGISTRY_PEERS=

backend/.gitignore

@@ -0,0 +1,8 @@
+.env
+venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.mypy_cache/
+packs/installed/*
+!packs/installed/.gitkeep

backend/app/__init__.py

@@ -0,0 +1 @@
+"""Creer backend package."""