constella 0.1.0

package/scripts/vps-install.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Constella VPS bootstrap (Ubuntu Server). Installs Docker + Tailscale, joins the tailnet, and brings
+# up Constella over Tailscale. Run on a fresh VPS:  curl ... | bash  — or  bash scripts/vps-install.sh
+set -euo pipefail
+
+echo "✦ Constella VPS install — Docker + Tailscale"
+
+# 1) Docker
+if ! command -v docker >/dev/null 2>&1; then
+  echo "• Installing Docker…"
+  curl -fsSL https://get.docker.com | sh
+fi
+
+# 2) Tailscale
+if ! command -v tailscale >/dev/null 2>&1; then
+  echo "• Installing Tailscale…"
+  curl -fsSL https://tailscale.com/install.sh | sh
+fi
+
+echo "• Joining your tailnet (a browser auth URL will be printed if needed)…"
+sudo tailscale up || true
+
+# 3) Auth key for the Tailscale container (so the compose sidecar can join headlessly)
+if [ ! -f .env ] || ! grep -q '^TS_AUTHKEY=' .env; then
+  echo
+  echo "  Create a Tailscale auth key at https://login.tailscale.com/admin/settings/keys"
+  read -r -p "  Paste TS_AUTHKEY (tskey-auth-...): " TS_KEY
+  echo "TS_AUTHKEY=${TS_KEY}" >> .env
+fi
+
+# 4) Bring up the stack
+echo "• Building + starting Constella…"
+sudo docker compose up -d --build
+
+IP="$(tailscale ip -4 2>/dev/null | head -1 || true)"
+echo
+echo "✓ Constella is starting."
+echo "  Reach it on your tailnet at:  http://${IP:-<tailscale-ip>}:3000"
+echo "  (Open it from any device on the same tailnet.)"

package/skills/CONTRIBUTING.md

@@ -0,0 +1,122 @@
+# Contributing to the `skills/` knowledge base
+
+This directory is a **curated, research-backed reference library** for AI agents working on Constella. It is **not** the runtime `.claude/skills/` directory (those are per-org executable procedures indexed by `src/server/sync.ts`). Files here are knowledge agents *consult*.
+
+## Non-negotiable trust rules
+
+1. **Official sources only.** Every factual claim, URL, and install command must come from an official origin: the project's own docs site, its official GitHub repo/org, or the canonical standards body (OWASP, W3C, IETF, MDN, the framework's own site). **Reject** blogs, Medium, marketing reposts, content farms, and Stack Overflow as *sources* (they may be linked under "Further reading" only if clearly labeled community).
+2. **Never invent.** If you cannot verify a fact against an official source, omit it. A short, correct skill beats a long, plausible-but-wrong one. No invented install flags, version numbers, API names, or URLs.
+3. **Cite & summarize, never copy.** Paraphrase in your own words and link the source. Do not paste large passages from Codrops, component.gallery, docs, etc. Respect licensing.
+4. **Install commands verbatim.** For stack/language skills, copy the install command **exactly** as it appears on the official install/getting-started page, and cite that page URL.
+5. **Stamp `verified:`** with the date the URLs/claims were last checked (`YYYY-MM-DD`).
+
+## Slug & path conventions
+- Lowercase, hyphenated, ASCII, Windows-safe: `fly-io`, `aspnet-core`, `csharp`, `cpp`, `spring-boot`.
+- One folder per skill. Knowledge skills live at `<group>/<slug>/SKILL.md`. Process skills live at `process/<slug>/SKILL.md` but use Format B below.
+- A skill folder may add `reference.md`, `cheatsheet.md`, or `examples/` for depth — keep `SKILL.md` short and link to them (progressive disclosure).
+
+## Minimum bar (knowledge skills) — below bar = flagged, not shipped
+Frontmatter + Official sources + Install/setup (stacks & languages) + ≥3 Core concepts + ≥3 Best practices + ≥2 Common pitfalls.
+
+---
+
+## Format A — Knowledge `SKILL.md`
+Used by: `meta/`, `engineering/`, `design/`, `languages/`, `stacks/`, `references/`.
+
+```markdown
+---
+name: <slug>
+description: <one sentence, ≤160 chars — what it covers + when to consult it>
+domain: <engineering|design|language|stack|reference|meta>
+category: <e.g. backend, database, security>   # optional sub-group
+tags: [<keyword>, <keyword>]
+official_sources:
+  - <official-docs-url>
+  - <official-repo-url>
+verified: <YYYY-MM-DD>
+---
+
+# <Human Title>
+
+## Overview
+2–4 sentences: what it is, the problem it solves, when to read this.
+
+## Official sources
+- Docs: <url>
+- Repo: <url>
+- Install / download: <url>
+
+## Install / setup            <!-- stack & language skills only -->
+```bash
+<exact command copied from the official install page>
+```
+
+## Core concepts
+- <3–7 ideas needed to use this correctly>
+
+## Best practices
+- <official/widely-endorsed practice — link a source for any non-obvious claim>
+
+## Common pitfalls
+- <mistake> → <correct approach>
+
+## Examples
+```<lang>
+<minimal correct snippet; deeper examples go in reference.md>
+```
+
+## Further reading
+- reference.md — deep dive (loaded only when needed)
+- <deeper official guide URL>
+
+## Related skills
+- ../<sibling-slug> — why it relates
+```
+
+---
+
+## Format B — Runtime `# Skill —` procedure
+Used by: `process/` (executable, matches the existing `.claude/skills/` convention so it could be promoted into a workspace later).
+
+```markdown
+# Skill — <slug>
+
+**Trigger:** <when this procedure applies>
+
+<one-line summary of what the agent produces>
+
+## When to use
+<conditions>
+
+## When NOT to use
+- <when a more specific skill applies, or the trigger is absent>
+
+## Required context & inputs
+- <what to read/gather first>
+
+## Procedure
+1. <step>
+2. <step>
+3. <step>
+
+## Output format
+- <the artifact produced; paths relative to the workspace>
+
+## Quality & validation rules
+- <how to know each step succeeded; the definition of done>
+
+## Failure handling
+- <what to do when a step fails; where to record it>
+
+## Related
+- Sources: <official method/standard URLs — e.g. scrumguides.org, adr.github.io, owasp.org>
+- Skills: <sibling process skills>
+```
+
+---
+
+## How an agent uses this library
+1. Identify the task domain and the org's declared stack (from `.claude/CLAUDE.md`).
+2. Open the matching `SKILL.md` (e.g. `orm: Drizzle` → `stacks/orm/drizzle/SKILL.md`).
+3. Follow `Further reading` / `reference.md` only if you need depth.
+4. Trust the `Official sources`; if `verified:` is stale, re-check before relying on version-specific details.

package/skills/COVERAGE.md

@@ -0,0 +1,129 @@
+# Coverage report
+
+_Generated 2026-06-16._
+
+## Totals
+- **Total skills:** 182
+- **By domain:** design 9, engineering 32, language 15, meta 3, process 15, reference 10, stack 98
+
+## Stack catalog coverage
+Catalog options that map to a skill (excluding "None"): **113/113 covered**, 7 "None" options skipped.
+
+✅ Every selectable catalog option resolves to a skill file.
+
+## Stack lookup table
+| Category | Option | Skill path | Present |
+|---|---|---|---|
+| language | TypeScript | `languages/typescript/SKILL.md` | ✅ |
+| language | JavaScript | `languages/javascript/SKILL.md` | ✅ |
+| language | Python | `languages/python/SKILL.md` | ✅ |
+| language | Go | `languages/go/SKILL.md` | ✅ |
+| language | Rust | `languages/rust/SKILL.md` | ✅ |
+| language | Java | `languages/java/SKILL.md` | ✅ |
+| language | Kotlin | `languages/kotlin/SKILL.md` | ✅ |
+| language | C# | `languages/csharp/SKILL.md` | ✅ |
+| language | Ruby | `languages/ruby/SKILL.md` | ✅ |
+| language | PHP | `languages/php/SKILL.md` | ✅ |
+| language | Elixir | `languages/elixir/SKILL.md` | ✅ |
+| language | Swift | `languages/swift/SKILL.md` | ✅ |
+| language | C++ | `languages/cpp/SKILL.md` | ✅ |
+| language | Scala | `languages/scala/SKILL.md` | ✅ |
+| language | Dart | `languages/dart/SKILL.md` | ✅ |
+| runtime | Node.js | `stacks/runtime/node/SKILL.md` | ✅ |
+| runtime | Bun | `stacks/runtime/bun/SKILL.md` | ✅ |
+| runtime | Deno | `stacks/runtime/deno/SKILL.md` | ✅ |
+| runtime | Python 3 | `stacks/runtime/python3/SKILL.md` | ✅ |
+| runtime | PyPy | `stacks/runtime/pypy/SKILL.md` | ✅ |
+| runtime | JVM | `stacks/runtime/jvm/SKILL.md` | ✅ |
+| runtime | .NET | `stacks/runtime/dotnet/SKILL.md` | ✅ |
+| runtime | BEAM (Erlang VM) | `stacks/runtime/beam/SKILL.md` | ✅ |
+| frontend | React | `stacks/frontend/react/SKILL.md` | ✅ |
+| frontend | Vue | `stacks/frontend/vue/SKILL.md` | ✅ |
+| frontend | Svelte | `stacks/frontend/svelte/SKILL.md` | ✅ |
+| frontend | Angular | `stacks/frontend/angular/SKILL.md` | ✅ |
+| frontend | SolidJS | `stacks/frontend/solidjs/SKILL.md` | ✅ |
+| frontend | Preact | `stacks/frontend/preact/SKILL.md` | ✅ |
+| frontend | Qwik | `stacks/frontend/qwik/SKILL.md` | ✅ |
+| frontend | Lit | `stacks/frontend/lit/SKILL.md` | ✅ |
+| frontend | HTMX | `stacks/frontend/htmx/SKILL.md` | ✅ |
+| frontend | Alpine.js | `stacks/frontend/alpine/SKILL.md` | ✅ |
+| meta | Next.js | `stacks/meta/nextjs/SKILL.md` | ✅ |
+| meta | Nuxt | `stacks/meta/nuxt/SKILL.md` | ✅ |
+| meta | Remix | `stacks/meta/remix/SKILL.md` | ✅ |
+| meta | SvelteKit | `stacks/meta/sveltekit/SKILL.md` | ✅ |
+| meta | Astro | `stacks/meta/astro/SKILL.md` | ✅ |
+| meta | Gatsby | `stacks/meta/gatsby/SKILL.md` | ✅ |
+| meta | Vite (SPA) | `stacks/meta/vite/SKILL.md` | ✅ |
+| backend | NestJS | `stacks/backend/nestjs/SKILL.md` | ✅ |
+| backend | Fastify | `stacks/backend/fastify/SKILL.md` | ✅ |
+| backend | Express | `stacks/backend/express/SKILL.md` | ✅ |
+| backend | Hono | `stacks/backend/hono/SKILL.md` | ✅ |
+| backend | Koa | `stacks/backend/koa/SKILL.md` | ✅ |
+| backend | Django | `stacks/backend/django/SKILL.md` | ✅ |
+| backend | Flask | `stacks/backend/flask/SKILL.md` | ✅ |
+| backend | FastAPI | `stacks/backend/fastapi/SKILL.md` | ✅ |
+| backend | Spring Boot | `stacks/backend/spring-boot/SKILL.md` | ✅ |
+| backend | Laravel | `stacks/backend/laravel/SKILL.md` | ✅ |
+| backend | Ruby on Rails | `stacks/backend/rails/SKILL.md` | ✅ |
+| backend | Gin | `stacks/backend/gin/SKILL.md` | ✅ |
+| backend | Fiber | `stacks/backend/fiber/SKILL.md` | ✅ |
+| backend | Actix | `stacks/backend/actix/SKILL.md` | ✅ |
+| backend | Phoenix | `stacks/backend/phoenix/SKILL.md` | ✅ |
+| backend | ASP.NET Core | `stacks/backend/aspnet-core/SKILL.md` | ✅ |
+| backend | AdonisJS | `stacks/backend/adonisjs/SKILL.md` | ✅ |
+| database | PostgreSQL | `stacks/database/postgresql/SKILL.md` | ✅ |
+| database | MySQL | `stacks/database/mysql/SKILL.md` | ✅ |
+| database | MariaDB | `stacks/database/mariadb/SKILL.md` | ✅ |
+| database | SQLite | `stacks/database/sqlite/SKILL.md` | ✅ |
+| database | MongoDB | `stacks/database/mongodb/SKILL.md` | ✅ |
+| database | Redis | `stacks/database/redis/SKILL.md` | ✅ |
+| database | CockroachDB | `stacks/database/cockroachdb/SKILL.md` | ✅ |
+| database | Cassandra | `stacks/database/cassandra/SKILL.md` | ✅ |
+| database | DynamoDB | `stacks/database/dynamodb/SKILL.md` | ✅ |
+| database | Supabase | `stacks/database/supabase/SKILL.md` | ✅ |
+| database | PlanetScale | `stacks/database/planetscale/SKILL.md` | ✅ |
+| database | Neon | `stacks/database/neon/SKILL.md` | ✅ |
+| orm | Prisma | `stacks/orm/prisma/SKILL.md` | ✅ |
+| orm | Drizzle | `stacks/orm/drizzle/SKILL.md` | ✅ |
+| orm | TypeORM | `stacks/orm/typeorm/SKILL.md` | ✅ |
+| orm | Sequelize | `stacks/orm/sequelize/SKILL.md` | ✅ |
+| orm | SQLAlchemy | `stacks/orm/sqlalchemy/SKILL.md` | ✅ |
+| orm | Django ORM | `stacks/orm/django-orm/SKILL.md` | ✅ |
+| orm | Mongoose | `stacks/orm/mongoose/SKILL.md` | ✅ |
+| orm | Knex | `stacks/orm/knex/SKILL.md` | ✅ |
+| orm | Diesel | `stacks/orm/diesel/SKILL.md` | ✅ |
+| orm | GORM | `stacks/orm/gorm/SKILL.md` | ✅ |
+| styling | Tailwind CSS | `stacks/styling/tailwind/SKILL.md` | ✅ |
+| styling | CSS Modules | `stacks/styling/css-modules/SKILL.md` | ✅ |
+| styling | styled-components | `stacks/styling/styled-components/SKILL.md` | ✅ |
+| styling | Sass | `stacks/styling/sass/SKILL.md` | ✅ |
+| styling | Vanilla Extract | `stacks/styling/vanilla-extract/SKILL.md` | ✅ |
+| styling | UnoCSS | `stacks/styling/unocss/SKILL.md` | ✅ |
+| styling | shadcn/ui | `stacks/styling/shadcn-ui/SKILL.md` | ✅ |
+| styling | MUI | `stacks/styling/mui/SKILL.md` | ✅ |
+| styling | Chakra UI | `stacks/styling/chakra-ui/SKILL.md` | ✅ |
+| container | Docker | `stacks/container/docker/SKILL.md` | ✅ |
+| container | Podman | `stacks/container/podman/SKILL.md` | ✅ |
+| container | containerd | `stacks/container/containerd/SKILL.md` | ✅ |
+| infra | Tailscale | `stacks/infra/tailscale/SKILL.md` | ✅ |
+| infra | Cloudflare | `stacks/infra/cloudflare/SKILL.md` | ✅ |
+| infra | Vercel | `stacks/infra/vercel/SKILL.md` | ✅ |
+| infra | Netlify | `stacks/infra/netlify/SKILL.md` | ✅ |
+| infra | Fly.io | `stacks/infra/fly-io/SKILL.md` | ✅ |
+| infra | Railway | `stacks/infra/railway/SKILL.md` | ✅ |
+| infra | AWS | `stacks/infra/aws/SKILL.md` | ✅ |
+| infra | GCP | `stacks/infra/gcp/SKILL.md` | ✅ |
+| infra | Kubernetes | `stacks/infra/kubernetes/SKILL.md` | ✅ |
+| queue | Redis | `stacks/queue/redis/SKILL.md` | ✅ |
+| queue | BullMQ | `stacks/queue/bullmq/SKILL.md` | ✅ |
+| queue | RabbitMQ | `stacks/queue/rabbitmq/SKILL.md` | ✅ |
+| queue | Kafka | `stacks/queue/kafka/SKILL.md` | ✅ |
+| queue | NATS | `stacks/queue/nats/SKILL.md` | ✅ |
+| queue | Celery | `stacks/queue/celery/SKILL.md` | ✅ |
+| auth | Auth.js | `stacks/auth/authjs/SKILL.md` | ✅ |
+| auth | Clerk | `stacks/auth/clerk/SKILL.md` | ✅ |
+| auth | Lucia | `stacks/auth/lucia/SKILL.md` | ✅ |
+| auth | Supabase Auth | `stacks/auth/supabase-auth/SKILL.md` | ✅ |
+| auth | Keycloak | `stacks/auth/keycloak/SKILL.md` | ✅ |
+| auth | Auth0 | `stacks/auth/auth0/SKILL.md` | ✅ |
+| auth | Passport | `stacks/auth/passport/SKILL.md` | ✅ |