brady-cli 1.1.0 → 1.2.5

package/.github/prompts/plan-bradyCliSkillsCommands.prompt.md

@@ -0,0 +1,47 @@
+# Plan: brady-cli revival + skills commands
+
+## Context
+
+- Repo: `c:\Users\brady\Documents\Repositories\brady-cli`
+- dotfiles repo: `bharper77/dotfiles` (private), skills at `.agents/skills/{skill-name}/` (folders with SKILL.md + other md files)
+- Skills land in: `.agents/skills/` relative to cwd
+- GitHub access: `gh api` (gh CLI). Pre-flight: run `gh auth status` before any api call; on failure, throw actionable error "Run `gh auth login` to authenticate, then retry." Offer to spawn `gh auth login` inline if not authed.
+- TUI library: `@clack/prompts`
+- Windows-only CLI (exec uses powershell.exe)
+- Current structure: single `src/index.ts` file with `init` command
+
+## Key Technical Decisions
+
+- gh api for fetching: `gh api repos/bharper77/dotfiles/contents/.agents/skills`
+- Files are base64-encoded in GitHub API response → decode with `Buffer.from(content, "base64")`
+- Commander subcommand nesting: `program.command("skills")` → `.addCommand(listCmd)` + `.addCommand(addCmd)`
+- `brady skills add [skill]` — optional positional arg: if present download directly, else show @clack/prompts multiselect
+- Add `"brady": "node dist/index.js"` script to package.json for `pnpm brady skills list` local dev invocation
+- Move `@changesets/cli` from dependencies → devDependencies
+
+## Plan
+
+### Phase 1: Dependencies & Tooling
+
+1. Update package.json: bump all deps to latest, add @clack/prompts (prod), move @changesets/cli to devDeps, add packageManager field
+2. Install deps with pnpm (user runs this)
+
+### Phase 2: Skills Commands in src/index.ts
+
+3. Add skills parent command, list subcommand, add subcommand
+4. Helper: fetchGhJson(apiPath) — runs `gh api {path}` via execSync, returns parsed JSON
+5. Helper: downloadSkill(skillName) — fetches file list for `.agents/skills/{skillName}`, decodes base64 content, writes files to `.agents/skills/{skillName}/` relative to process.cwd()
+6. ensureGhAuth() — runs `gh auth status`; on failure, uses @clack/prompts to ask if user wants to run `gh auth login` now; if yes, spawns it interactively; if no, exits with actionable error message
+7. listSkills() — calls ensureGhAuth(), fetches skill dirs, prints each skill name
+8. addSkill(skill?) — calls ensureGhAuth(); if skill arg provided: downloadSkill directly; else fetch list, @clack/prompts multiselect (space = toggle, enter = confirm), downloadSkill for each selected
+
+### Phase 3: README
+
+9. Create README.md covering: installation, commands (brady init, brady skills list, brady skills add, brady skills add <name>), local dev workflow, changeset releasing workflow
+
+## Dependency updates
+
+- Update all existing deps to latest at implementation time (check npm registry)
+- Note: `@commander-js/extra-typings` must match the major version of `commander`
+- Move `@changesets/cli` from dependencies → devDependencies
+- NEW: `@clack/prompts` (prod dep, latest)

package/.github/workflows/main.yml

@@ -0,0 +1,18 @@
+name: Build
+on:
+  push:
+    branches:
+      - "**"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: "pnpm"
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm run typecheck && pnpm run build

package/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish
+on:
+  push:
+    branches:
+      - "main"
+
+permissions:
+  contents: write # Required to create tags and commits
+  issues: write # Required for semantic-release to comment on issues
+  pull-requests: write # Required for semantic-release to comment on PRs
+  id-token: write # Required for npm provenance
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0 # Required for semantic-release to read full git history
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "pnpm"
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm run release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.releaserc.json

@@ -0,0 +1,21 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    ["@semantic-release/npm", { "npmPublish": false }],
+    [
+      "@semantic-release/exec",
+      { "publishCmd": "npm publish --provenance --access public" }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["CHANGELOG.md", "package.json"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    "@semantic-release/github"
+  ]
+}

package/CHANGELOG.md

@@ -1,7 +1,6 @@
-# brady-cli
+## [1.2.5](https://github.com/BHarper77/brady-cli/compare/v1.2.4...v1.2.5) (2026-05-09)
 
-## 1.1.0
 
-### Minor Changes
+### Bug Fixes
 
-- Added `start` and `build` scripts to `package.json`
+* fixed NPM publishing ([3f6dc6e](https://github.com/BHarper77/brady-cli/commit/3f6dc6e8c8d6ac4804a7a5ecf4535567cbff3f98))

package/README.md

@@ -0,0 +1,111 @@
+# brady-cli
+
+Personal CLI for project scaffolding and agent skill management.
+
+## Installation
+
+```sh
+npm install -g brady-cli
+# or
+pnpm add -g brady-cli
+```
+
+Requires [GitHub CLI](https://cli.github.com/) (`gh`) to be installed and authenticated for skills commands.
+
+## Commands
+
+### `brady init`
+
+Scaffold a new TypeScript Node.js project.
+
+```sh
+brady init -d my-project
+```
+
+| Option                        | Description                        |
+| ----------------------------- | ---------------------------------- |
+| `-d, --directory <directory>` | Directory name for the new project |
+
+---
+
+### `brady skills list`
+
+List all available skills from the dotfiles repo.
+
+```sh
+brady skills list
+```
+
+Prints each skill name fetched from `bharper77/dotfiles` → `.agents/skills/`.
+
+---
+
+### `brady skills add`
+
+Interactively select and download one or more skills into `.agents/skills/` relative to your current working directory.
+
+```sh
+brady skills add
+```
+
+Use **space** to toggle skills and **enter** to confirm your selection.
+
+---
+
+### `brady skills add <name>`
+
+Download a specific skill directly without the interactive picker.
+
+```sh
+brady skills add my-skill
+```
+
+---
+
+## Local Dev Workflow
+
+```sh
+# Install dependencies
+pnpm install
+
+# Build
+pnpm run build
+
+# Run locally (after build)
+pnpm brady skills list
+pnpm brady init -d my-project
+```
+
+## Releasing
+
+This package uses [semantic-release](https://github.com/semantic-release/semantic-release) for fully automated versioning and publishing based on [Conventional Commits](https://www.conventionalcommits.org/).
+
+### How it works
+
+Merging to `main` triggers the Publish workflow, which:
+
+1. Analyzes commits since the last release to determine the semver bump (`fix:` → patch, `feat:` → minor, `BREAKING CHANGE` → major)
+2. Updates `CHANGELOG.md` and bumps the version in `package.json`
+3. Publishes to npm via `pnpm publish`
+4. Commits the updated files back and creates a GitHub release
+
+**No manual steps are needed.** Just write commits using Conventional Commit messages:
+
+| Commit prefix                            | Version bump |
+| ---------------------------------------- | ------------ |
+| `fix:`                                   | patch        |
+| `feat:`                                  | minor        |
+| `feat!:` or `BREAKING CHANGE:` in footer | major        |
+
+### Your workflow
+
+1. **Make changes** using Conventional Commit messages, e.g.:
+
+   ```sh
+   git commit -m "feat: add new scaffold template"
+   git commit -m "fix: correct output path for init command"
+   ```
+
+2. **Push to a branch and open a PR.** The Build workflow runs typecheck + build on every push.
+
+3. **Merge to `main`.** semantic-release automatically determines the version, publishes to npm, and creates a GitHub release.