Skip to content

v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 18 Oct 16:06
v0.1.0
f3a540f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Added

  • Opt-in update-all --setup-touchid using the local mo helper, with active PAM
    checks, repeat-safe setup, and verification; package updates are not run by setup.
  • Foreground macOS sudo validation before interactive Homebrew updates, reusing
    cached credentials and native Touch ID/password fallback; --no-auth opt-out.
  • Linux/macOS PR and main CI: shell syntax, ShellCheck errors, workflow lint,
    maintained documentation links, release metadata, and existing/new regressions.
  • Mocked authentication/setup, package-manager isolation, cask-ignore, timeout,
    and release validation tests; shared scripts/check.sh runner.
  • Stable SemVer VERSION and validated main-only GitHub release workflow for
    v0.1.0, using the changelog for notes and read-only PR workflow permissions.
  • Living learnings/dump.md, root agent guidance, and PR documentation checklist.
  • Main branch protection requiring all three CI checks and up-to-date branches,
    including administrator enforcement (configured in GitHub, not by workflows).

Fixed

  • Update-all's test sandbox intercepts the actual cargo install-update dispatcher,
    isolates inherited Cargo/Rustup directories, and tests a deliberately broken
    source guard without allowing real package updates.

Changed

  • Sourcing scripts/update-all.sh now exposes functions without starting updates.
  • Authentication failure stops updates before they start. CI, noninteractive
    sessions, non-macOS systems, and non-Homebrew-only modes skip upfront sudo.
  • README documents setup, password fallback, limitations, rollback, regression
    checks, branch protection requirements, and the post-merge release procedure.
  • Physical Mac acceptance recorded from the repository owner: Touch ID succeeded
    without a password prompt; release authorized on 2026-10-19.
  • This initial SemVer release includes the previously unreleased changes below;
    older dated entries are retained as historical notes.

Changed

  • Skills consolidated under a top-level skills/ directory (#129)
    • Moved project-bootstrap and code-review-checklist from ai-prompts/skills/ to skills/
    • Renamed each skill's templates/ folder to assets/, matching the SKILL.md + scripts/ + references/ + assets/ layout
    • scripts/sync-skills.sh now reads from skills/
    • Skills documentation moved to skills/README.md; ai-prompts/README.md now links to it

Fixed

  • scripts/sync-skills.sh deleted unmanaged skills in ~/.claude/skills (#129)
    • Syncs each skill folder separately, so skills installed from other sources are kept
    • Skips loose files such as skills/README.md
    • Dry run now shows each skill's actual description

Removed

  • docker-completion Homebrew formula (#116)
    • Deprecated upstream and scheduled for removal on 2027-05-31
    • Removed from Brewfile and Brewfile.lock.commented
    • The docker formula already installed via Brewfile provides the CLI (and its completions), so no replacement package is needed

Added

  • Claude Code status line mirroring the fish Tide prompt

    • config/claude/statusline-command.sh renders os, folder, and git segments, plus the model name, effort level, 5-hour and weekly plan usage bars, and context usage (each usage segment colored by usage)
    • scripts/setup-claude-statusline.sh links the script into ~/.claude and sets statusLine in settings.json with jq, keeping other settings and backing up the previous file
    • Tests in tests/claude/statusline.test.sh

  • ubuntu/ directory with a one-shot Ubuntu VPS bootstrap

    • ubuntu/vps-setup.sh installs apt, snap, npm, cargo, and uv tools, plus Claude Code, herdr, and rtk
    • Sets up fish with Fisher, Tide (prompt settings included), fzf.fish, autopair.fish, eza aliases, and zoxide as cd
    • Runs scripts/setup-claude-statusline.sh, cloning the repo to ~/dotfiles when run via curl | bash
    • ubuntu/README.md covers usage and every component

  • mole Homebrew formula to Brewfile (#131)

    • Deep clean and optimize tool for macOS; the CLI is run as mo

  • quick-address-issue skill for resolving GitHub issues end to end (#129)

    • Invoke with /quick-address-issue <issue-url> [base-branch]
    • Covers the account check, clone or fork, branching, granular commits, tests, doc alignment, PR, and issue comment
    • Bundles scripts/parse-issue-url.sh, commit and PR checklists in references/, and PR, comment, and limitation templates in assets/

  • Skill tests in tests/skills/

    • validate-skills.sh checks every skill's layout, frontmatter, and referenced files
    • parse-issue-url.test.sh covers the issue reference parser

  • Herdr agent multiplexer to Brewfile and documentation (#113)

    • Added brew "herdr" to Brewfile, alongside Tmux and Zellij
    • Documented Herdr under the Terminal Multiplexers section in README.md

  • rtk-ai token optimization proxy and gh-stack CLI tools (#114)

    • Added brew "rtk" to Brewfile
    • Created scripts/setup-rtk.sh to install rtk and wire it into Claude Code, Codex, and OpenCode globally
    • Created scripts/setup-gh-stack.sh to install the gh-stack extension and its agent skill (user scope) for Claude Code, Codex, and OpenCode
    • Documented both in docs/ai-tools/INSTALLATION.md and README.md

  • Raycast productivity launcher to Brewfile and documentation

    • Added cask "raycast" to macOS Applications section
    • Created docs/RAYCAST.md with comprehensive setup guide
    • Includes initial setup, hotkey configuration, Quick Links, and AI commands
    • Documented recommended extensions (UUID Generator, GitHub, VS Code, Docker)
    • Updated README.md with Raycast section and directory structure

  • Obsidian knowledge management application to Brewfile

    • Added cask "obsidian" to macOS Applications section
    • Local-first Markdown-based knowledge base
    • Complements existing productivity tools (Notion, AppFlowy)

  • OpenCode terminal-based AI coding assistant to Brewfile

    • Added brew "opencode" to AI Development Tools section
    • Updated docs/ai-tools/INSTALLATION.md with OpenCode setup instructions
    • OpenCode supports multiple providers (Anthropic, OpenAI, Google)
    • Configuration via ~/.config/opencode/config.json

  • Added modern web development terms to IT Dictionary:

    • Astro - Modern static site builder using Island Architecture
    • HTMX - Library for building modern UIs with HTML attributes
    • React Server Components (RSC) - Server-side component rendering paradigm in React

  • Claude Skills directory (ai-prompts/skills/) for reusable skill packages

    • Skills are versioned, reusable packages that extend Claude's capabilities
    • Consistent SKILL.md convention with YAML frontmatter for metadata
    • Support for scripts, templates, and assets within each skill

  • project-bootstrap Skill for initializing new projects

    • Laravel initialization script with Pest, Pint, and standard directory structure
    • Next.js initialization script with TypeScript, Tailwind CSS, and ESLint
    • README and PR template files

  • code-review-checklist Skill for consistent code reviews

    • Backend checklist covering security, performance, testing, and Laravel-specific checks
    • Frontend checklist covering TypeScript, accessibility, performance, and React patterns

  • scripts/sync-skills.sh for syncing Skills to local Claude skills directory

    • Supports dry-run mode for previewing changes
    • Configurable target directory via --target flag or CLAUDE_SKILLS_DIR env var

  • Updated ai-prompts/README.md with comprehensive Skills documentation

  • Updated root README.md with Claude Skills section

  • IT Terms & Jargons Dictionary (docs/dictionary.md)

    • Comprehensive glossary with 50+ IT terminology entries
    • Covers foundational concepts, system design, design patterns, and best practices
    • Categories: Frontend, Backend, DevOps, Software Engineering, System Design
    • Alphabetically organized with table of contents for quick navigation
    • Includes related terms cross-references for deeper understanding
    • Added modern TypeScript terms: Drizzle ORM, tRPC
    • Ready for continuous expansion by contributors

Fixed

  • Fixed update-all.sh script hanging on password prompts and unresponsive operations
    • Added comprehensive timeout handling for all package manager operations
    • Implemented non-interactive flags for Homebrew casks, Composer, RubyGems, and Oh My Zsh
    • Added run_with_timeout() function for safe command execution with fallback support
    • Changed script to continue on errors instead of stopping (removed -e flag)
    • Added error tracking with HAS_ERRORS flag for better completion reporting
    • Configurable timeout values for each package manager (60s-600s based on operation)
    • Enhanced logging to track and report script completion status

Added

  • Elixir, Phoenix, and Ash development environment setup
    • elixir/ directory with complete Elixir development configuration
    • elixir/setup.sh - Automated Elixir/Phoenix/Ash installation script
    • elixir/.tool-versions - Default Erlang/Elixir versions (27.2/1.18.1-otp-27)
    • elixir/README.md - Comprehensive Elixir setup documentation
  • Elixir setup installs:
    • Erlang 27.2 via asdf with optimized compilation
    • Elixir 1.18.1-otp-27 via asdf
    • Phoenix framework with mix archive
    • Hex package manager and Rebar3 build tool
    • Support for Phoenix and Ash framework development
  • asdf version manager to Brewfile for multi-language version management
  • Erlang build dependencies to Brewfile:
    • autoconf for configure script building
    • wxwidgets for GUI toolkit (Erlang observer)
    • libxslt for XML transformation
    • fop for documentation formatting
    • unixodbc for database connectivity

Changed

  • Removed standalone elixir package from Brewfile (replaced with asdf-managed installation)
  • Updated main README.md with Elixir, Phoenix, and Ash Development section
  • Enhanced Features list with asdf version manager support
  • Updated directory structure documentation to include elixir/ setup

Removed (Breaking Changes)

  • XAMPP cask - Legacy Apache/MySQL/PHP package
  • MAMP cask - Legacy web development solution
  • Opera Air cask - Simplified browser for everyday browsing
  • python@3.13 - Development version of Python (unstable)
  • python@3.9 - End-of-life Python version (EOL October 2025)

Changed

  • Consolidated Python versions to use pyenv for version management
  • Retained python@3.12 (LTS) as system fallback
  • Updated README.md with Python Development section showing pyenv usage
  • Added migration note for MAMP/XAMPP users to use Laravel Herd or Docker

Migration Notes

For MAMP/XAMPP users:

  • Consider using Laravel Herd for PHP development (already installed)
  • Alternative: Use Docker Desktop or OrbStack (both installed) for full-stack environments
  • OrbStack is faster and more lightweight than Docker Desktop
  • Herd provides better performance and modern PHP version management

For Python version management:

  • Use pyenv install <version> to install specific Python versions
  • Use .python-version files in projects for automatic version switching
  • System Python 3.12 remains available as fallback

Added

  • Python, FastAPI, and Django development environment setup
    • python/ directory with complete Python development configuration
    • python/setup.sh - Automated Python/FastAPI/Django installation script
    • python/.python-version - Default Python version (3.12.8)
    • python/README.md - Comprehensive Python setup documentation
  • Python setup installs:
    • Python 3.12.8 via pyenv
    • FastAPI with uvicorn ASGI server
    • Django with REST framework and common extensions
    • Development tools: black, flake8, mypy, pylint, poetry
    • Testing frameworks: pytest, pytest-asyncio, httpx
  • Optional Python/FastAPI/Django setup prompt in setup.sh and scripts/adaptive-setup.sh
  • Ruby and Rails development environment setup
    • ruby/ directory with complete Ruby/Rails configuration
    • ruby/setup.sh - Automated Ruby and Rails installation script
    • ruby/.ruby-version - Default Ruby version (3.3.6)
    • ruby/.gemrc - Optimized gem configuration
    • ruby/README.md - Comprehensive Ruby setup documentation
  • Ruby development dependencies to Brewfile:
    • rbenv for Ruby version management
    • ruby-build for installing Ruby versions
    • OpenSSL, readline, libyaml for Ruby compilation
    • Node.js and Yarn for Rails asset pipeline
  • Optional Ruby/Rails setup prompt in setup.sh and scripts/adaptive-setup.sh

Changed (Previous)

  • Updated main README.md with Ruby & Rails Development section
  • Enhanced Brewfile with Ruby development tools and dependencies
  • Reorganized Ruby-related packages in Brewfile for better clarity
  • Removed redundant ruby-install package (replaced by ruby-build)
Assets 2
Loading