spinup-ts 0.1.0

package/template/.devcontainer/devcontainer.json

@@ -0,0 +1,106 @@
+{
+  "name": "__PROJECT_NAME__",
+  "image": "ghcr.io/joeblackwaslike/devcontainer:latest",
+  "features": {
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+      "version": "latest",
+      "enableNonRootDocker": "true",
+      "moby": false
+    }
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "Anthropic.claude-code",
+        "alefragnani.Bookmarks",
+        "antfu.browse-lite",
+        "biomejs.biome",
+        "christian-kohler.npm-intellisense",
+        "DavidAnson.vscode-markdownlint",
+        "dbaeumer.vscode-eslint",
+        "denoland.vscode-deno",
+        "donjayamanne.githistory",
+        "EditorConfig.EditorConfig",
+        "esbenp.prettier-vscode",
+        "github.vscode-github-actions",
+        "GitHub.vscode-pull-request-github",
+        "golang.go",
+        "Jacano.vscode-pnpm",
+        "mhutchie.git-graph",
+        "ms-azuretools.vscode-containers",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "ms-vscode.makefile-tools",
+        "ms-vscode.vscode-typescript-next",
+        "ms-vscode-remote.remote-containers",
+        "oven.bun-vscode",
+        "reduckted.vscode-gitweblinks",
+        "remcohaszing.schemastore",
+        "rust-lang.rust-analyzer",
+        "sst-dev.opencode",
+        "Supabase.vscode-supabase-extension",
+        "tamasfe.even-better-toml",
+        "bradlc.vscode-tailwindcss",
+        "antfu.vite",
+        "bierner.markdown-checkbox",
+        "bierner.markdown-emoji",
+        "bierner.markdown-preview-github-styles",
+        "wilsonsio.color-vision",
+        "yoavbls.pretty-ts-errors"
+      ]
+    }
+  },
+  "mounts": [
+    // Claude Code config (writable — Claude writes sessions, memory, cache)
+    "source=${localEnv:HOME}/.claude,target=/home/vscode/.claude,type=bind,consistency=cached",
+    "source=${localEnv:HOME}/.claude.json,target=/home/vscode/.claude.json,type=bind,consistency=cached",
+    // OpenAI Codex CLI
+    "source=${localEnv:HOME}/.cpdex,target=/home/vscode/.codex,type=bind,consistency=cached",
+    // Skills + agents (read-only — managed in ~/.agents on host)
+    "source=${localEnv:HOME}/.agents,target=/home/vscode/.agents,type=bind,readonly,consistency=cached",
+    // Shell / git identity (read-only)
+    "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,readonly,consistency=cached",
+    "source=${localEnv:HOME}/.gitconfig,target=/home/vscode/.gitconfig,type=bind,readonly,consistency=cached",
+    // GitHub CLI auth (read-only)
+    "source=${localEnv:HOME}/.config/gh,target=/home/vscode/.config/gh,type=bind,readonly,consistency=cached",
+    // Local repos (read-only) — makes MCP server paths from settings.json resolve
+    // via the /Users/joe → /home/vscode symlink added in the Dockerfile
+    "source=${localEnv:HOME}/github/joeblackwaslike,target=/home/vscode/github/joeblackwaslike,type=bind,readonly,consistency=cached",
+    // opencode (read-only — managed on host)
+    "source=${localEnv:HOME}/.config/opencode,target=/home/vscode/.config/opencode,type=bind,readonly,consistency=cached",
+    "source=${localEnv:HOME}/.local/share/opencode,target=/home/vscode/.local/share/opencode,type=bind,readonly,consistency=cached",
+    // Gemini CLI (writable — writes session history, settings, state)
+    "source=${localEnv:HOME}/.gemini,target=/home/vscode/.gemini,type=bind,consistency=cached",
+    // openclaw identity + workspace (writable — writes credentials, logs, workspace state)
+    "source=${localEnv:HOME}/.openclaw,target=/home/vscode/.openclaw,type=bind,consistency=cached",
+    // Docker socket (OrbStack on macOS)
+    "source=${localEnv:HOME}/.orbstack/run/docker.sock,target=/var/run/docker.sock,type=bind,consistency=cached"
+  ],
+  "remoteEnv": {
+    // Anthropic / Claude
+    "ANTHROPIC_API_KEY": "${localEnv:ANTHROPIC_API_KEY}",
+    "ANTHROPIC_MODEL": "${localEnv:ANTHROPIC_MODEL}",
+    "ANTHROPIC_SMALL_FAST_MODEL": "${localEnv:ANTHROPIC_SMALL_FAST_MODEL}",
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "ENABLE_EXPERIMENTAL_MCP_CLI": "true",
+    // OpenAI / Codex
+    "OPENAI_API_KEY": "${localEnv:OPENAI_API_KEY}",
+    "OPENAI_ORG_ID": "${localEnv:OPENAI_ORG_ID}",
+    // 1Password CLI — no mountable socket on this host; use service account token instead.
+    // Generate one at https://developer.1password.com/docs/service-accounts/
+    // then export OP_SERVICE_ACCOUNT_TOKEN in your shell before opening the container.
+    "OP_SERVICE_ACCOUNT_TOKEN": "${localEnv:OP_SERVICE_ACCOUNT_TOKEN}",
+    // MCP server API keys
+    "CONTEXT7_API_KEY": "${localEnv:CONTEXT7_API_KEY}",
+    "EXA_API_KEY": "${localEnv:EXA_API_KEY}",
+    "TAVILY_API_KEY": "${localEnv:TAVILY_API_KEY}",
+    "FIRECRAWL_API_KEY": "${localEnv:FIRECRAWL_API_KEY}",
+    "PERPLEXITY_API_KEY": "${localEnv:PERPLEXITY_API_KEY}",
+    "BRAVE_API_KEY": "${localEnv:BRAVE_API_KEY}",
+    "REF_API_KEY": "${localEnv:REF_API_KEY}",
+    // opencode
+    "OPENCODE_AGENT_SKILLS_SUPERPOWERS_MODE": "true"
+  },
+  "postCreateCommand": "/usr/local/share/devcontainer/scripts/setup.sh",
+  "postAttachCommand": "/usr/local/share/devcontainer/scripts/discover-deps.sh"
+}

package/template/.devcontainer/scripts/init-project.sh

@@ -0,0 +1,167 @@
+#!/usr/bin/env bash
+# Bootstrap the shared devcontainer configuration into any project directory.
+#
+# INSTALL (add to ~/.zshrc or ~/.aliases.zsh on your host machine):
+#   alias devcontainer-init='~/github/joeblackwaslike/devcontainer/.devcontainer/scripts/init-project.sh'
+#
+# USAGE:
+#   devcontainer-init [target-dir] [options]
+#
+# OPTIONS:
+#   --name NAME   Override container name (default: project directory name)
+#   --force       Overwrite existing .devcontainer/ without prompting
+#   --dry-run     Show what would be done without writing any files
+#   --help        Show this help
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEVCONTAINER_SRC="$(dirname "$SCRIPT_DIR")"  # .devcontainer/ dir in this repo
+
+TARGET_DIR=""
+CONTAINER_NAME=""
+FORCE=0
+DRY_RUN=0
+
+# ── Argument parsing ──────────────────────────────────────────────────────────
+
+usage() {
+    cat <<EOF
+Usage: devcontainer-init [target-dir] [options]
+
+Bootstrap the shared Claude Code devcontainer config into a project.
+
+Arguments:
+  target-dir    Project directory to initialize (default: current dir)
+
+Options:
+  --name NAME   Override the devcontainer name (default: project dir name)
+  --force       Overwrite an existing .devcontainer/ directory
+  --dry-run     Print what would happen without writing anything
+  --help        Show this help
+
+After running, open VS Code and choose:
+  "Dev Containers: Reopen in Container"
+
+To customize for a specific project, edit:
+  <project>/.devcontainer/custom-setup.sh
+
+See .devcontainer/DISCOVER-DEPS.md for full documentation.
+EOF
+    exit 0
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --help|-h) usage ;;
+        --force)    FORCE=1;              shift ;;
+        --dry-run)  DRY_RUN=1;            shift ;;
+        --name)     CONTAINER_NAME="$2";  shift 2 ;;
+        -*)         echo "Unknown option: $1" >&2; usage ;;
+        *)          TARGET_DIR="$1";      shift ;;
+    esac
+done
+
+TARGET_DIR="$(cd "${TARGET_DIR:-.}" && pwd)"
+PROJECT_NAME="${CONTAINER_NAME:-$(basename "$TARGET_DIR")}"
+
+# ── Preflight checks ──────────────────────────────────────────────────────────
+
+if [ ! -d "$TARGET_DIR/.git" ]; then
+    echo "error: $TARGET_DIR is not a git repository root" >&2
+    exit 1
+fi
+
+DEST="$TARGET_DIR/.devcontainer"
+
+if [ -d "$DEST" ] && [ "$FORCE" = "0" ]; then
+    echo "error: $DEST already exists — use --force to overwrite" >&2
+    exit 1
+fi
+
+# ── Summary ───────────────────────────────────────────────────────────────────
+
+echo "devcontainer-init"
+echo "  source  : $DEVCONTAINER_SRC"
+echo "  target  : $DEST"
+echo "  name    : $PROJECT_NAME"
+[ "$DRY_RUN" = "1" ] && echo "  mode    : DRY RUN (no files written)"
+echo ""
+
+# ── Copy devcontainer source ──────────────────────────────────────────────────
+
+if [ "$DRY_RUN" = "0" ]; then
+    [ -d "$DEST" ] && rm -rf "$DEST"
+    cp -r "$DEVCONTAINER_SRC" "$DEST"
+    echo "  copied .devcontainer/"
+else
+    echo "  [dry] would copy $DEVCONTAINER_SRC → $DEST"
+fi
+
+# ── Update container name in devcontainer.json ───────────────────────────────
+
+DEVCONTAINER_JSON="$DEST/devcontainer.json"
+if [ -f "$DEVCONTAINER_JSON" ] && [ "$DRY_RUN" = "0" ]; then
+    python3 - "$DEVCONTAINER_JSON" "$PROJECT_NAME" <<'PY'
+import json, sys
+path, name = sys.argv[1], sys.argv[2]
+with open(path) as f:
+    cfg = json.load(f)
+cfg["name"] = name
+# Use the pre-built image in target projects — no per-project build needed
+cfg.pop("build", None)
+cfg["image"] = "ghcr.io/joeblackwaslike/devcontainer:latest"
+with open(path, "w") as f:
+    json.dump(cfg, f, indent=2)
+    f.write("\n")
+PY
+    echo "  set devcontainer name: $PROJECT_NAME"
+    echo "  set image: ghcr.io/joeblackwaslike/devcontainer:latest"
+fi
+
+# ── Create custom-setup.sh stub ───────────────────────────────────────────────
+
+CUSTOM_SETUP="$DEST/custom-setup.sh"
+if [ "$DRY_RUN" = "0" ] && [ ! -f "$CUSTOM_SETUP" ]; then
+    cat > "$CUSTOM_SETUP" <<'STUB'
+#!/usr/bin/env bash
+# Project-specific devcontainer setup hook.
+# Called by .devcontainer/scripts/discover-deps.sh on every container attach,
+# after automatic dependency detection.
+#
+# See .devcontainer/DISCOVER-DEPS.md for documentation and examples.
+#
+# Examples:
+#   npm install -g @myorg/internal-cli
+#   psql -U postgres -c "CREATE DATABASE myapp;" 2>/dev/null || true
+#   export MY_PROJECT_ENV=devcontainer
+STUB
+    chmod +x "$CUSTOM_SETUP"
+    echo "  created custom-setup.sh stub"
+fi
+
+# ── Offer to add .devcontainer/ to .gitignore ─────────────────────────────────
+# The devcontainer template is maintained centrally in this repo.
+# Projects typically don't need to commit it.
+
+GITIGNORE="$TARGET_DIR/.gitignore"
+if [ "$DRY_RUN" = "0" ] && [ -f "$GITIGNORE" ] \
+        && ! grep -q '^\.devcontainer' "$GITIGNORE" 2>/dev/null; then
+    echo ""
+    echo "  The devcontainer template is maintained centrally."
+    echo "  Add .devcontainer/ to $PROJECT_NAME/.gitignore?"
+    read -rp "  [y/N] " answer
+    if [[ "${answer,,}" == "y" ]]; then
+        echo ".devcontainer" >> "$GITIGNORE"
+        echo "  added .devcontainer to .gitignore"
+    fi
+fi
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+
+echo ""
+echo "Done! Next steps:"
+echo "  1.  cd $TARGET_DIR"
+echo "  2.  code .                   (open in VS Code)"
+echo "  3.  'Dev Containers: Reopen in Container'"
+echo "  4.  Edit .devcontainer/custom-setup.sh for project-specific setup"

package/template/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

package/template/.github/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

package/template/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,21 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior.
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS:
+- Node version:
+- Package version:

package/template/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+**Is your feature request related to a problem?**
+A clear and concise description of the problem.
+
+**Describe the solution you'd like**
+
+**Additional context**

package/template/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## Summary
+
+<!-- What does this PR do? -->
+
+## Test plan
+
+- [ ] Tests pass locally (`pnpm test`)
+- [ ] Types check (`pnpm typecheck`)
+- [ ] Linting passes (`pnpm lint`)
+
+## Related issues
+
+<!-- Closes #123 -->

package/template/.github/actions/setup-node-env/action.yml

@@ -0,0 +1,20 @@
+name: Setup Node Environment
+description: Install Node.js and pnpm dependencies
+
+runs:
+  using: composite
+  steps:
+    - name: Setup pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: latest
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version-file: .nvmrc
+        cache: pnpm
+
+    - name: Install dependencies
+      shell: bash
+      run: pnpm install --frozen-lockfile

package/template/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    labels:
+      - ci
+      - dependencies

package/template/.github/labeler.yml

@@ -0,0 +1,17 @@
+docs:
+  - docs/**
+  - '**/*.md'
+
+ci:
+  - .github/**
+
+tests:
+  - src/**/*.test.ts
+  - src/**/*.spec.ts
+
+dependencies:
+  - package.json
+  - pnpm-lock.yaml
+
+source:
+  - src/**

package/template/.github/release-please-config.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "release-type": "node",
+  "packages": {
+    ".": {}
+  }
+}

package/template/.github/workflows/ci.yml

@@ -0,0 +1,95 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    name: Quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ./.github/actions/setup-node-env
+
+      - name: Biome
+        run: pnpm exec biome ci .
+
+      - name: ESLint
+        run: pnpm exec eslint . --max-warnings=0
+
+      - name: Typecheck
+        run: pnpm typecheck
+
+      - name: Dependency check
+        run: pnpm depcheck
+
+  test:
+    name: Test (Node ${{ matrix.node-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20, 22]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test:coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup-node-env
+      - name: Build
+        run: pnpm build
+
+  docs:
+    name: Docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup-node-env
+      - name: Build docs
+        run: pnpm docs:build
+
+  dependency-review:
+    name: Dependency Review
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    permissions:
+      contents: read
+      pull-requests: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/dependency-review-action@v4
+        with:
+          fail-on-severity: moderate

package/template/.github/workflows/codeql.yml

@@ -0,0 +1,31 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '30 1 * * 1'
+
+permissions:
+  security-events: write
+  actions: read
+  contents: read
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: github/codeql-action/init@v3
+        with:
+          languages: javascript-typescript
+
+      - uses: github/codeql-action/autobuild@v3
+
+      - uses: github/codeql-action/analyze@v3
+        with:
+          category: /language:javascript-typescript

package/template/.github/workflows/labeler.yml

@@ -0,0 +1,18 @@
+name: Labeler
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  label:
+    name: Label PR
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/labeler@v5
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

package/template/.github/workflows/release-please.yml

@@ -0,0 +1,72 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    name: Release Please
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          config-file: .github/release-please-config.json
+          manifest-file: .github/.release-please-manifest.json
+
+  publish:
+    name: Publish to npm
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+          registry-url: https://registry.npmjs.org
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm build
+
+      - run: pnpm publish --access public --provenance --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  deploy-docs:
+    name: Deploy docs
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ./.github/actions/setup-node-env
+
+      - name: Build docs
+        run: pnpm docs:build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./build

package/template/.github/workflows/stale.yml

@@ -0,0 +1,32 @@
+name: Stale
+
+on:
+  schedule:
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    name: Mark stale
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          days-before-issue-stale: 60
+          days-before-issue-close: 7
+          days-before-pr-stale: 30
+          days-before-pr-close: -1
+          stale-issue-message: >
+            This issue has been automatically marked as stale due to 60 days of
+            inactivity. It will be closed in 7 days unless there is new activity.
+          close-issue-message: >
+            Closing due to inactivity. Please reopen if this is still relevant.
+          stale-pr-message: >
+            This PR has been automatically marked as stale due to 30 days of
+            inactivity. It will not be auto-closed — please ping when ready to resume.
+          exempt-issue-labels: 'pinned,security,in-progress'
+          exempt-pr-labels: 'pinned,security,in-progress'

package/template/.husky/commit-msg

@@ -0,0 +1 @@
+pnpm commitlint --edit "$1"

package/template/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint-staged

package/template/.nvmrc

@@ -0,0 +1 @@
+__NODE_VERSION__

package/template/.vscode/extensions.json

@@ -0,0 +1,11 @@
+{
+  "recommendations": [
+    "biomejs.biome",
+    "dbaeumer.vscode-eslint",
+    "EditorConfig.EditorConfig",
+    "github.vscode-github-actions",
+    "ms-vscode.vscode-typescript-next",
+    "yoavbls.pretty-ts-errors",
+    "Anthropic.claude-code"
+  ]
+}