spinup-ts 0.1.0

package/dist/update.js

@@ -0,0 +1,207 @@
+import { exec } from 'node:child_process';
+import { constants, access } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { promisify } from 'node:util';
+import * as clack from '@clack/prompts';
+import fs from 'fs-extra';
+const execAsync = promisify(exec);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
+const PKG_FILENAME = 'package.json';
+const BIOME_FILENAME = 'biome.json';
+const ESLINT_FILENAME = 'eslint.config.mjs';
+async function pathExists(p) {
+    try {
+        await access(p, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function applyBiome(dir) {
+    await fs.copy(path.join(TEMPLATE_DIR, BIOME_FILENAME), path.join(dir, BIOME_FILENAME), {
+        overwrite: false,
+        errorOnExist: false,
+    });
+}
+async function applyTsconfig(dir) {
+    const tsconfigPath = path.join(dir, 'tsconfig.json');
+    const tsconfig = (await fs.readJson(tsconfigPath));
+    tsconfig.compilerOptions = {
+        ...tsconfig.compilerOptions,
+        noUncheckedIndexedAccess: true,
+        exactOptionalPropertyTypes: true,
+    };
+    await fs.writeJson(tsconfigPath, tsconfig, { spaces: 2 });
+}
+async function applyEslint(dir) {
+    await fs.copy(path.join(TEMPLATE_DIR, ESLINT_FILENAME), path.join(dir, ESLINT_FILENAME), {
+        overwrite: false,
+        errorOnExist: false,
+    });
+}
+async function applyHusky(dir) {
+    const huskyDir = path.join(dir, '.husky');
+    await fs.ensureDir(huskyDir);
+    await fs.writeFile(path.join(huskyDir, 'pre-commit'), 'pnpm lint-staged\n', 'utf8');
+    const packagePath = path.join(dir, PKG_FILENAME);
+    const packageJson = (await fs.readJson(packagePath));
+    packageJson.scripts = { ...packageJson.scripts };
+    packageJson.scripts.prepare ??= 'husky';
+    packageJson['lint-staged'] ??= {
+        '*.{ts,js,json,md}': [
+            'biome check --write --no-errors-on-unmatched --files-ignore-unknown=true',
+        ],
+        '*.ts': ['eslint --fix --max-warnings=0 --no-warn-ignored'],
+    };
+    await fs.writeJson(packagePath, packageJson, { spaces: 2 });
+}
+async function applyCi(dir) {
+    const target = path.join(dir, '.github', 'workflows', 'ci.yml');
+    await fs.ensureDir(path.dirname(target));
+    await fs.copy(path.join(TEMPLATE_DIR, '.github', 'workflows', 'ci.yml'), target, {
+        overwrite: false,
+        errorOnExist: false,
+    });
+}
+async function applyBeads(dir) {
+    try {
+        await execAsync('bd init --skip-agents --non-interactive', { cwd: dir });
+    }
+    catch {
+        // bd not installed; skip silently
+    }
+}
+async function applySerena(dir) {
+    const package_ = (await fs.readJson(path.join(dir, PKG_FILENAME)));
+    const slug = (package_.name ?? path.basename(dir)).replaceAll('-', '_');
+    const serenaDir = path.join(dir, '.serena');
+    await fs.ensureDir(serenaDir);
+    await fs.writeFile(path.join(serenaDir, 'project.yml'), `project_name: ${slug}\nlanguages:\n  - typescript\n`, 'utf8');
+}
+async function applyVscode(dir) {
+    const vscodeDir = path.join(dir, '.vscode');
+    await fs.ensureDir(vscodeDir);
+    const settingsPath = path.join(vscodeDir, 'settings.json');
+    const biomeSettings = {
+        'editor.defaultFormatter': 'biomejs.biome',
+        'editor.formatOnSave': true,
+        'editor.codeActionsOnSave': {
+            'quickfix.biome': 'explicit',
+            'source.organizeImports.biome': 'explicit',
+        },
+    };
+    const existing = (await pathExists(settingsPath))
+        ? (await fs.readJson(settingsPath))
+        : {};
+    await fs.writeJson(settingsPath, { ...existing, ...biomeSettings }, { spaces: 2 });
+}
+async function needsTsconfigUpdate(targetDir) {
+    const tsconfigPath = path.join(targetDir, 'tsconfig.json');
+    if (!(await pathExists(tsconfigPath)))
+        return false;
+    const tsconfig = (await fs.readJson(tsconfigPath));
+    const co = tsconfig.compilerOptions ?? {};
+    return co.noUncheckedIndexedAccess !== true || co.exactOptionalPropertyTypes !== true;
+}
+async function needsHusky(targetDir) {
+    const huskyPreCommit = path.join(targetDir, '.husky', 'pre-commit');
+    const packageJson = (await fs.readJson(path.join(targetDir, PKG_FILENAME)));
+    return (!(await pathExists(huskyPreCommit)) ||
+        !packageJson['lint-staged'] ||
+        !packageJson.scripts?.prepare);
+}
+async function detectAvailableUpdates(targetDir) {
+    const options = [];
+    if (!(await pathExists(path.join(targetDir, BIOME_FILENAME))))
+        options.push({
+            value: 'biome',
+            label: 'Add Biome config',
+            hint: 'copy template biome.json',
+            apply: applyBiome,
+        });
+    if (await needsTsconfigUpdate(targetDir))
+        options.push({
+            value: 'tsconfig',
+            label: 'Tighten tsconfig.json',
+            hint: 'add noUncheckedIndexedAccess + exactOptionalPropertyTypes',
+            apply: applyTsconfig,
+        });
+    if (!(await pathExists(path.join(targetDir, ESLINT_FILENAME))))
+        options.push({
+            value: 'eslint',
+            label: 'Add ESLint strict config',
+            hint: 'copy template eslint.config.mjs',
+            apply: applyEslint,
+        });
+    if (await needsHusky(targetDir))
+        options.push({
+            value: 'husky',
+            label: 'Add Husky + lint-staged',
+            hint: 'pre-commit hook with biome + eslint',
+            apply: applyHusky,
+        });
+    if (!(await pathExists(path.join(targetDir, '.github', 'workflows', 'ci.yml'))))
+        options.push({
+            value: 'ci',
+            label: 'Add GitHub Actions CI',
+            hint: 'copy template ci.yml',
+            apply: applyCi,
+        });
+    options.push({
+        value: 'vscode',
+        label: 'Configure VS Code Biome formatter',
+        hint: 'merge .vscode/settings.json',
+        apply: applyVscode,
+    });
+    if (!(await pathExists(path.join(targetDir, '.beads'))))
+        options.push({
+            value: 'beads',
+            label: 'Initialize Beads task manager',
+            hint: 'bd init --skip-agents',
+            apply: applyBeads,
+        });
+    if (!(await pathExists(path.join(targetDir, '.serena', 'project.yml'))))
+        options.push({
+            value: 'serena',
+            label: 'Initialize Serena',
+            hint: 'create .serena/project.yml',
+            apply: applySerena,
+        });
+    return options;
+}
+export async function updateProject(targetDir) {
+    if (!(await pathExists(targetDir))) {
+        throw new Error(`Target directory does not exist: ${targetDir}`);
+    }
+    if (!(await pathExists(path.join(targetDir, PKG_FILENAME)))) {
+        throw new Error(`No package.json found in ${targetDir}`);
+    }
+    clack.intro('spinup-ts update');
+    const available = await detectAvailableUpdates(targetDir);
+    if (available.length === 0) {
+        clack.outro('Nothing to update — your project is already up to date!');
+        return;
+    }
+    const selected = await clack.multiselect({
+        message: 'Select updates to apply:',
+        options: available.map(({ value, label, hint }) => hint ? { value, label, hint } : { value, label }),
+        required: false,
+    });
+    if (clack.isCancel(selected) || selected.length === 0) {
+        clack.cancel('No updates applied.');
+        return;
+    }
+    const chosen = available.filter((o) => selected.includes(o.value));
+    const spinner = clack.spinner();
+    spinner.start('Applying updates...');
+    for (const update of chosen) {
+        await update.apply(targetDir);
+    }
+    spinner.stop('Done!');
+    clack.outro(`Applied ${chosen.length} update(s). Review changes with \`git diff\`.`);
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "spinup-ts",
+  "version": "0.1.0",
+  "description": "Scaffold a production-ready TypeScript project with opinionated tooling (Biome, ESLint strict, Vitest, Husky, GitHub Actions, Docusaurus, Docker, devcontainer). The TypeScript sibling of spinup-py.",
+  "type": "module",
+  "bin": {
+    "spinup-ts": "./dist/index.js"
+  },
+  "files": ["dist", "template"],
+  "homepage": "https://github.com/joeblackwaslike/spinup-ts#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joeblackwaslike/spinup-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/joeblackwaslike/spinup-ts/issues"
+  },
+  "keywords": [
+    "typescript",
+    "scaffold",
+    "cli",
+    "template",
+    "boilerplate",
+    "starter",
+    "biome",
+    "eslint",
+    "vitest",
+    "docusaurus"
+  ],
+  "author": "Joe Black <joeblackwaslike@gmail.com>",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest --coverage",
+    "lint": "biome ci . && eslint . --max-warnings=0",
+    "lint:fix": "biome check --write . && eslint --fix .",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm typecheck && pnpm lint",
+    "commit": "cz",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "degit": "^2.8.4",
+    "fs-extra": "^11.2.0",
+    "globby": "^14.0.2",
+    "picocolors": "^1.1.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@commitlint/cli": "^21.0.2",
+    "@commitlint/config-conventional": "^21.0.2",
+    "@types/degit": "^2.8.6",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "commitizen": "^4.3.1",
+    "cz-conventional-changelog": "^3.3.0",
+    "eslint": "^9.28.0",
+    "eslint-plugin-import-x": "^4.12.2",
+    "eslint-plugin-no-secrets": "^1.1.2",
+    "eslint-plugin-sonarjs": "^3.0.2",
+    "eslint-plugin-unicorn": "^56.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.32.1",
+    "vitest": "^3.0.0"
+  },
+  "lint-staged": {
+    "*.{ts,js,json,md}": [
+      "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
+    ],
+    "src/**/*.ts": ["eslint --fix --max-warnings=0 --no-warn-ignored"]
+  },
+  "config": {
+    "commitizen": {
+      "path": "cz-conventional-changelog"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/.commitlintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["@commitlint/config-conventional"]
+}

package/template/.devcontainer/.zshrc

@@ -0,0 +1,159 @@
+# If you come from bash you might have to change your $PATH.
+# export PATH=$HOME/bin:$HOME/.local/bin:/usr/local/bin:$PATH
+
+# Path to your Oh My Zsh installation.
+export ZSH="$HOME/.oh-my-zsh"
+
+# Set name of the theme to load --- if set to "random", it will
+# load a random theme each time Oh My Zsh is loaded, in which case,
+# to know which specific one was loaded, run: echo $RANDOM_THEME
+# See https://github.com/ohmyzsh/ohmyzsh/wiki/Themes
+ZSH_THEME="devcontainers"
+
+# Set list of themes to pick from when loading at random
+# Setting this variable when ZSH_THEME="devcontainers"
+# a theme from this variable instead of looking in $ZSH/themes/
+# If set to an empty array, this variable will have no effect.
+# ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster" )
+
+# Uncomment the following line to use case-sensitive completion.
+# CASE_SENSITIVE="true"
+
+# Uncomment the following line to use hyphen-insensitive completion.
+# Case-sensitive completion must be off. _ and - will be interchangeable.
+HYPHEN_INSENSITIVE="true"
+
+# Uncomment one of the following lines to change the auto-update behavior
+zstyle ':omz:update' mode disabled  # disable automatic updates
+# zstyle ':omz:update' mode auto      # update automatically without asking
+# zstyle ':omz:update' mode reminder  # just remind me to update when it's time
+
+# Uncomment the following line to change how often to auto-update (in days).
+# zstyle ':omz:update' frequency 13
+
+# Uncomment the following line if pasting URLs and other text is messed up.
+# DISABLE_MAGIC_FUNCTIONS="true"
+
+# Uncomment the following line to disable colors in ls.
+# DISABLE_LS_COLORS="true"
+
+# Uncomment the following line to disable auto-setting terminal title.
+# DISABLE_AUTO_TITLE="true"
+
+# Uncomment the following line to enable command auto-correction.
+# ENABLE_CORRECTION="true"
+
+# Uncomment the following line to display red dots whilst waiting for completion.
+# You can also set it to another string to have that shown instead of the default red dots.
+# e.g. COMPLETION_WAITING_DOTS="%F{yellow}waiting...%f"
+# Caution: this setting can cause issues with multiline prompts in zsh < 5.7.1 (see #5765)
+# COMPLETION_WAITING_DOTS="true"
+
+# Uncomment the following line if you want to disable marking untracked files
+# under VCS as dirty. This makes repository status check for large repositories
+# much, much faster.
+DISABLE_UNTRACKED_FILES_DIRTY="true"
+
+# Uncomment the following line if you want to change the command execution time
+# stamp shown in the history command output.
+# You can set one of the optional three formats:
+# "mm/dd/yyyy"|"dd.mm.yyyy"|"yyyy-mm-dd"
+# or set a custom format using the strftime function format specifications,
+# see 'man strftime' for details.
+# HIST_STAMPS="mm/dd/yyyy"
+
+# Would you like to use another custom folder than $ZSH/custom?
+# ZSH_CUSTOM=/path/to/new-custom-folder
+
+# cut loading time in half
+DISABLE_MAGIC_FUNCTIONS="true"
+DISABLE_COMPFIX="true"
+
+ZSH_AUTOSUGGEST_BUFFER_MAX_SIZE="20"
+ZSH_AUTOSUGGEST_USE_ASYNC=1
+
+# Which plugins would you like to load?
+# Standard plugins can be found in $ZSH/plugins/
+# Custom plugins may be added to $ZSH_CUSTOM/plugins/
+# Example format: plugins=(rails git textmate ruby lighthouse)
+# Add wisely, as too many plugins slow down shell startup.
+plugins=(
+    eza
+    asdf
+    git
+)
+
+# eza config
+zstyle ':omz:plugins:eza' 'dirs-first' yes
+zstyle ':omz:plugins:eza' 'git-status' yes
+zstyle ':omz:plugins:eza' 'header' yes
+zstyle ':omz:plugins:eza' 'icons' yes
+zstyle ':omz:plugins:eza' 'hyperlink' yes
+
+# Skip compaudit check - speeds up compinit
+skip_global_compinit=1
+
+# Load compinit with cache checking (once per day)
+autoload -Uz compinit
+if [[ -n ${ZDOTDIR:-$HOME}/.zcompdump(#qNmh+24) ]]; then
+  	compinit
+else
+  	compinit -C
+fi
+
+if [[ -o interactive ]]; then
+	source $ZSH/oh-my-zsh.sh
+fi
+
+# User configuration
+export MANPATH="/usr/local/man:$MANPATH"
+export LANG=en_US.UTF-8
+
+# moor pager (mirrors local macOS settings)
+if command -v moor >/dev/null 2>&1; then
+    export MOOR='-no-clear-on-exit -quit-if-one-screen -reformat -tab-size 4'
+    export PAGER=moor
+    export MANPAGER=moor
+fi
+
+# Claude Code
+export ENABLE_EXPERIMENTAL_MCP_CLI=true
+export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
+
+# in-container claude runs without permission prompts
+alias claude='claude --dangerously-skip-permissions'
+
+# opencode
+export OPENCODE_AGENT_SKILLS_SUPERPOWERS_MODE=true
+
+if command -v eza >/dev/null 2>&1; then
+    alias ls='eza --long --all -g --git --sort name --group --group-directories-first --icons'
+fi
+
+# fzf key bindings + completion
+[ -f /usr/share/doc/fzf/examples/key-bindings.zsh ]  && source /usr/share/doc/fzf/examples/key-bindings.zsh
+[ -f /usr/share/doc/fzf/examples/completion.zsh ]     && source /usr/share/doc/fzf/examples/completion.zsh
+
+# zsh shortcuts
+alias reload='source ~/.zshrc'
+
+# pnpm
+alias pn=pnpm
+
+if [[ -o interactive ]]; then
+    eval "$(oh-my-posh init zsh --config ~/.mytheme.omp.yaml)"
+fi
+
+set -aU path
+
+# source optional runtime env files installed by asdf
+set -aU includes
+includes=(
+    "${ASDF_DATA_DIR:-/home/vscode/.asdf}/installs/rust/stable/env"
+    "${ASDF_DATA_DIR:-/home/vscode/.asdf}/installs/gcloud/"*".0.0/path.zsh.inc"
+    "${ASDF_DATA_DIR:-/home/vscode/.asdf}/installs/gcloud/"*".0.0/completion.zsh.inc"
+)
+
+for file in $includes; do
+    [[ -f $file ]] && . $file
+done

package/template/.devcontainer/DISCOVER-DEPS.md

@@ -0,0 +1,109 @@
+# Dependency Auto-Discovery
+
+`scripts/discover-deps.sh` runs automatically on every `postAttachCommand` (each time you
+attach VS Code to the running container). It scans the workspace root for known manifest and
+lock files, then installs dependencies using the appropriate tool.
+
+---
+
+## Detection logic
+
+Detection runs in this exact order. Within each language, the first matching file wins.
+
+| Signal file | Tool invoked | Notes |
+|---|---|---|
+| `pnpm-lock.yaml` | `pnpm install` | Respects workspace root |
+| `bun.lockb` | `bun install` | |
+| `yarn.lock` | `yarn install` | |
+| `package-lock.json` | `npm ci` | Strict reproducible install |
+| `package.json` (no lock) | `npm install` | Creates a lock file |
+| `pyproject.toml` | `uv sync` | Falls back silently if uv fails |
+| `requirements.txt` | `uv pip install -r` | Falls back to pip if uv unavailable |
+| `Cargo.toml` | `cargo fetch` | Pre-fetches crates; does not build |
+| `go.mod` | `go mod download` | Pre-fetches modules |
+| `Gemfile` | `bundle install` | Only if `bundle` is in PATH |
+| `.devcontainer/custom-setup.sh` | `bash .devcontainer/custom-setup.sh` | Always runs last |
+
+---
+
+## Per-project customization
+
+Create `.devcontainer/custom-setup.sh` in the project repo to add anything
+that the auto-detection above doesn't cover.
+
+The `init-project.sh` CLI creates a stub for you automatically:
+
+```bash
+devcontainer-init                   # bootstraps .devcontainer/ into the current repo
+devcontainer-init ~/github/myrepo   # target a specific directory
+```
+
+### Example `custom-setup.sh`
+
+```bash
+#!/usr/bin/env bash
+# Install a project-specific global CLI
+npm install -g @myorg/internal-cli
+
+# Seed the local Postgres database on first attach
+psql -U postgres -c "CREATE DATABASE myapp;" 2>/dev/null || true
+psql -U postgres myapp < db/seed.sql 2>/dev/null || true
+
+# Export a project-specific env var into the shell
+echo 'export MY_PROJECT_MODE=devcontainer' >> ~/.zshrc
+```
+
+### Extending for a multi-service repo
+
+If your repo has sub-packages in a monorepo layout, the auto-detection only looks at the
+workspace root. Use `custom-setup.sh` to install nested deps:
+
+```bash
+#!/usr/bin/env bash
+pnpm install --filter ./packages/api
+pnpm install --filter ./packages/web
+```
+
+---
+
+## Skipping discovery
+
+Set `DISCOVER_DEPS_SKIP=1` to prevent any installation:
+
+```json
+// devcontainer.json
+"remoteEnv": {
+  "DISCOVER_DEPS_SKIP": "1"
+}
+```
+
+Or export it inside the container at runtime:
+
+```bash
+export DISCOVER_DEPS_SKIP=1
+```
+
+---
+
+## Troubleshooting
+
+**Discovery ran but dependencies are missing**
+
+Check that the lock file is at the workspace root (not in a subfolder). If you have a
+non-standard layout, add the install to `custom-setup.sh`.
+
+**`uv sync` failed silently**
+
+The script uses `uv sync 2>/dev/null || true` so it doesn't abort a partial environment.
+Run `uv sync` manually to see the full error output.
+
+**Discovery is slow on every attach**
+
+Package managers like `pnpm install` and `npm ci` are fast when the lock file hasn't
+changed (they skip work). If your repo is large and you want to skip it, set
+`DISCOVER_DEPS_SKIP=1` in `remoteEnv`.
+
+**I want to add a new language**
+
+Edit `scripts/discover-deps.sh` — the structure is straightforward. Then update the
+detection table above and add the tool to `TOOLS.md`.