@nomad-e/bluma-cli 0.1.66 → 0.1.68

package/README.md

@@ -160,7 +160,7 @@ npm start
 
 ```json
 {
-  "model": "gpt-4o",
+  "model": "auto",
   "reasoningEffort": "medium",
   "outputStyle": "concise",
   "sandboxMode": "confirm",
@@ -171,7 +171,7 @@ npm start
 
 | Setting | Values | Description |
 |---------|--------|-------------|
-| `model` | `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-20250514` | LLM model |
+| `model` | `auto` | LLM model (FactorRouter decides) |
 | `reasoningEffort` | `low`, `medium`, `high` | Reasoning depth |
 | `outputStyle` | `concise`, `balanced`, `verbose` | Response style |
 | `sandboxMode` | `confirm`, `auto`, `strict` | Tool execution policy |

package/dist/config/native_tools.json

@@ -340,7 +340,7 @@
       "type": "function",
       "function": {
         "name": "read_file_lines",
-        "description": "Reads a slice of a text file (Claude Code Read parity). Use filepath only for up to 2000 lines from line 1, or offset+limit, or start_line+end_line. Optional line_number_prefix formats lines like cat -n.",
+        "description": "Reads a slice of a text file (Read parity). Use filepath only for up to 2000 lines from line 1, or offset+limit, or start_line+end_line. Optional line_number_prefix formats lines like cat -n.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -800,7 +800,7 @@
       "type": "function",
       "function": {
         "name": "ask_user_question",
-        "description": "Ask the user one or more multiple-choice questions in the terminal (Claude Code AskUserQuestion). Blocks until they answer. Only the first question is shown; options must be single-select.",
+        "description": "Ask the user one or more multiple-choice questions in the terminal (AskUserQuestion). Blocks until they answer. Only the first question is shown; options must be single-select.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -836,7 +836,7 @@
       "type": "function",
       "function": {
         "name": "enter_plan_mode",
-        "description": "Enter plan-only mode (Claude Code EnterPlanMode parity). While active, edits, writes, shell, spawn_agent, and artifact creation require user confirmation even if normally auto-approved.",
+        "description": "Enter plan-only mode (EnterPlanMode parity). While active, edits, writes, shell, spawn_agent, and artifact creation require user confirmation even if normally auto-approved.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -849,7 +849,7 @@
       "type": "function",
       "function": {
         "name": "exit_plan_mode",
-        "description": "Leave plan mode (Claude Code ExitPlanMode parity). Restores normal auto-approve rules.",
+        "description": "Leave plan mode (ExitPlanMode parity). Restores normal auto-approve rules.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -862,7 +862,7 @@
       "type": "function",
       "function": {
         "name": "task_create",
-        "description": "Create a session task (Claude Code TaskCreate-style). Tasks are scoped to this session.",
+        "description": "Create a session task (TaskCreate-style). Tasks are scoped to this session.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -921,7 +921,7 @@
       "type": "function",
       "function": {
         "name": "task_stop",
-        "description": "Mark a task as cancelled (Claude TaskStop-style).",
+        "description": "Mark a task as cancelled (TaskStop-style).",
         "parameters": {
           "type": "object",
           "properties": { "task_id": { "type": "string" } },
@@ -933,7 +933,7 @@
       "type": "function",
       "function": {
         "name": "list_mcp_resources",
-        "description": "List resources exposed by connected MCP servers (Claude ListMcpResourcesTool parity).",
+        "description": "List resources exposed by connected MCP servers (ListMcpResourcesTool parity).",
         "parameters": {
           "type": "object",
           "properties": {
@@ -946,7 +946,7 @@
       "type": "function",
       "function": {
         "name": "read_mcp_resource",
-        "description": "Read a resource URI from a named MCP server (Claude ReadMcpResourceTool parity).",
+        "description": "Read a resource URI from a named MCP server (ReadMcpResourceTool parity).",
         "parameters": {
           "type": "object",
           "properties": {
@@ -961,7 +961,7 @@
       "type": "function",
       "function": {
         "name": "cron_create",
-        "description": "Schedule a one-shot or repeating user-visible reminder in this CLI session (Claude CronCreate parity). Fires via user_overlay; timers end when the process exits.",
+        "description": "Schedule a one-shot or repeating user-visible reminder in this CLI session (CronCreate parity). Fires via user_overlay; timers end when the process exits.",
         "parameters": {
           "type": "object",
           "properties": {

package/dist/config/skills/git-release/LICENSE.txt

@@ -0,0 +1,18 @@
+BluMa — Base Language Unit · Model Agent
+Proprietary License
+
+Copyright (c) 2024-2026 BluMa Contributors
+
+This skill is part of the BluMa CLI distribution.
+It is provided as a bundled native skill and may not be
+redistributed, modified, or used outside of the BluMa agent
+framework without prior written permission.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/dist/config/skills/git-release/SKILL.md

@@ -0,0 +1,408 @@
+---
+name: git-release
+description: >
+  Use this skill for any task involving software releases: version bumps,
+  changelog generation, git tags, GitHub releases, npm publish, and
+  release orchestration. Triggers include: "release", "publish",
+  "version bump", "changelog", "create release", "cut release",
+  "ship it", "deploy version", "tag release", or any request to
+  finalize and publish a new version of the software.
+license: Proprietary. LICENSE.txt has complete terms
+---
+
+# Git Release — Professional Release Engineering
+
+## Overview
+
+This skill produces **production-grade** releases with consistent versioning,
+comprehensive changelogs, proper tagging, and full traceability. Every release
+carries a BluMa watermark for auditability.
+
+## Release Types
+
+| Type | When to use | Version bump |
+|------|-------------|--------------|
+| `major` | Breaking changes, incompatible API changes | `X.0.0` |
+| `minor` | New features, backward-compatible | `0.X.0` |
+| `patch` | Bug fixes, backward-compatible | `0.0.X` |
+| `premajor` | Pre-release for upcoming major | `X.0.0-beta.0` |
+| `preminor` | Pre-release for upcoming minor | `0.X.0-beta.0` |
+| `prepatch` | Pre-release for upcoming patch | `0.0.X-beta.0` |
+| `prerelease` | Pre-release iteration | `0.0.X-beta.N` |
+
+## Pre-Release Checklist
+
+Before ANY release, verify:
+
+```bash
+# 1. Clean working tree
+git status --short
+# Must be empty — no uncommitted changes
+
+# 2. On the correct branch
+git branch --show-current
+# Usually main or master for releases
+
+# 3. Up to date with remote
+git fetch origin
+git status
+# "Your branch is up to date with 'origin/main'"
+
+# 4. Tests pass
+npm test
+# All tests must pass — no exceptions
+
+# 5. Build succeeds
+npm run build
+# Clean build with no errors or warnings
+
+# 6. Lint passes
+npm run lint
+# No lint errors
+
+# 7. Review commits since last tag
+git log v<current>..HEAD --oneline
+# Understand what's being released
+```
+
+If ANY check fails, STOP and fix before proceeding.
+
+## Step 1: Determine Version Bump
+
+### Option A: Automatic (from Conventional Commits)
+
+Analyze commits since the last tag:
+
+```bash
+git log v<current>..HEAD --oneline
+```
+
+Determine the highest-impact type:
+- Any `BREAKING CHANGE` or `feat!` → **major**
+- Any `feat` → **minor**
+- Only `fix`, `docs`, `refactor`, `perf`, `test`, `chore` → **patch**
+
+### Option B: Explicit
+
+User specifies: `/release minor`, `/release patch`, `/release major`
+
+### Calculate next version:
+
+```bash
+# Current version from package.json
+cat package.json | grep '"version"'
+
+# Or from git tag
+git describe --tags --abbrev=0
+
+# Bump logic:
+# 0.1.67 + patch = 0.1.68
+# 0.1.67 + minor = 0.2.0
+# 0.1.67 + major = 1.0.0
+```
+
+## Step 2: Generate Changelog
+
+Create a structured CHANGELOG.md entry. Group commits by type:
+
+```markdown
+## [v0.2.0] - 2026-04-16
+
+### 🚀 Features
+- **(auth)**: add JWT refresh token rotation (#42)
+- **(ui)**: add dark mode toggle
+
+### 🐛 Bug Fixes
+- **(api)**: fix null pointer in session validation (#55)
+- **(cli)**: resolve timeout on large file reads
+
+### ⚡ Performance
+- **(core)**: optimize context compression algorithm
+
+### 🔧 Chores
+- **(deps)**: bump react from 18.2 to 19.0
+- **(ci)**: add Node 22 to test matrix
+
+### 📝 Documentation
+- **(readme)**: update installation instructions
+
+### 💥 Breaking Changes
+- **(api)**: remove deprecated `/v1/legacy` endpoint
+
+---
+
+> *Generated by [BluMa — Base Language Unit · Model Agent](https://github.com/Nomad-e/bluma-cli)*
+```
+
+### Commands to gather data:
+
+```bash
+# All commits since last tag
+git log v<current>..HEAD --format="%h|%s|%an|%ad" --date=short
+
+# Commits by type
+git log v<current>..HEAD --oneline --grep="^feat"
+git log v<current>..HEAD --oneline --grep="^fix"
+git log v<current>..HEAD --oneline --grep="^BREAKING"
+
+# Diff stats
+git log v<current>..HEAD --stat --oneline
+
+# Contributors
+git log v<current>..HEAD --format="%an" | sort | uniq -c | sort -rn
+```
+
+## Step 3: Update Version
+
+### package.json
+
+```bash
+# Using npm (recommended — updates package.json + package-lock.json)
+npm version <type> --no-git-tag-version
+
+# Or manually edit package.json
+# "version": "0.1.68"
+```
+
+### Other version files (if they exist):
+
+- `src/version.ts` or `src/version.js`
+- `src/app/version.ts`
+- `.version`
+- Any file containing the version string
+
+Update ALL version references consistently.
+
+## Step 4: Update CHANGELOG.md
+
+If CHANGELOG.md exists, prepend the new entry. If not, create it:
+
+```bash
+# Prepend to existing
+# (use edit_tool to insert at top after header)
+
+# Or create new
+cat > CHANGELOG.md << 'EOF'
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [v0.2.0] - 2026-04-16
+...
+EOF
+```
+
+## Step 5: Commit the Release
+
+```bash
+git add -A
+git commit -m "$(cat <<'EOF'
+chore(release): v0.2.0
+
+- Bump version to 0.2.0
+- Update CHANGELOG.md
+- Release: minor (new features: JWT refresh, dark mode)
+
+Generated-by: BluMa — Base Language Unit · Model Agent
+EOF
+)"
+```
+
+## Step 6: Tag the Release
+
+```bash
+# Annotated tag (preferred)
+git tag -a v0.2.0 -m "Release v0.2.0
+
+Features:
+- JWT refresh token rotation
+- Dark mode toggle
+
+Bug fixes:
+- Null pointer in session validation
+- Timeout on large file reads
+
+Generated-by: BluMa — Base Language Unit · Model Agent"
+
+# Or lightweight tag
+git tag v0.2.0
+```
+
+## Step 7: Push
+
+```bash
+# Push commit and tag
+git push origin main --tags
+
+# Or push commit first, tag separately
+git push origin main
+git push origin v0.2.0
+```
+
+## Step 8: GitHub Release (if `gh` CLI available)
+
+```bash
+gh release create v0.2.0 \
+  --title "v0.2.0 — Feature Release" \
+  --notes "$(cat <<'EOF'
+## What's New
+
+### 🚀 Features
+- JWT refresh token rotation
+- Dark mode toggle
+
+### 🐛 Bug Fixes
+- Null pointer in session validation
+- Timeout on large file reads
+
+### ⚡ Performance
+- Optimized context compression
+
+---
+
+> *Generated by [BluMa — Base Language Unit · Model Agent](https://github.com/Nomad-e/bluma-cli)*
+EOF
+)"
+```
+
+## Step 9: npm Publish (if applicable)
+
+```bash
+# Dry run first
+npm publish --dry-run
+
+# Publish
+npm publish
+
+# For scoped packages
+npm publish --access public
+```
+
+## Step 10: Verify
+
+```bash
+# Tag exists
+git tag -l "v0.2.0"
+
+# Tag points to correct commit
+git show v0.2.0 --quiet
+
+# Remote has the tag
+git ls-remote --tags origin v0.2.0
+
+# package.json version matches
+cat package.json | grep '"version"'
+
+# GitHub release exists (if created)
+gh release view v0.2.0
+```
+
+## Rollback Procedure
+
+If something goes wrong AFTER pushing:
+
+```bash
+# Delete remote tag (DANGEROUS — coordinate with team)
+git push origin --delete v0.2.0
+
+# Delete local tag
+git tag -d v0.2.0
+
+# Revert the release commit
+git revert <commit-hash>
+git push origin main
+
+# Re-publish npm if needed
+npm unpublish @nomad-e/bluma-cli@0.2.0
+```
+
+## Release Notes Template
+
+For each release, generate notes in this format:
+
+```markdown
+# Release v0.2.0
+
+**Date:** 2026-04-16
+**Type:** Minor Release
+**Previous Version:** v0.1.67
+
+## Summary
+Brief 2-3 sentence summary of what this release brings.
+
+## Highlights
+- Feature 1 with user-facing impact
+- Feature 2 with user-facing impact
+
+## All Changes
+### Features (2)
+- feat(auth): add JWT refresh token rotation (#42)
+- feat(ui): add dark mode toggle
+
+### Bug Fixes (2)
+- fix(api): null pointer in session validation (#55)
+- fix(cli): timeout on large file reads
+
+### Performance (1)
+- perf(core): optimize context compression
+
+### Chores (2)
+- chore(deps): bump react 18.2 → 19.0
+- chore(ci): add Node 22 to test matrix
+
+## Contributors
+- @alex-fonseca (5 commits)
+- @contributor (2 commits)
+
+## Migration Notes
+If breaking changes, describe migration steps.
+
+---
+
+> *Generated by [BluMa — Base Language Unit · Model Agent](https://github.com/Nomad-e/bluma-cli)*
+```
+
+## Quality Standards
+
+Every release generated by BluMa MUST:
+
+1. Follow Semantic Versioning strictly.
+2. Have a comprehensive CHANGELOG.md entry.
+3. Include an annotated git tag with release summary.
+4. Pass all pre-release checks (tests, build, lint, clean tree).
+5. Have a GitHub Release with structured notes (if `gh` available).
+6. Include the BluMa watermark in commit, tag, and release notes.
+7. Be verified after push (tag exists, version matches).
+
+## Watermarks
+
+**Commit trailer** (last line of release commit):
+```
+Generated-by: BluMa — Base Language Unit · Model Agent
+```
+
+**Tag annotation** (included in tag message):
+```
+Generated-by: BluMa — Base Language Unit · Model Agent
+```
+
+**GitHub Release footer** (last line of release notes):
+```markdown
+---
+
+> *Generated by [BluMa — Base Language Unit · Model Agent](https://github.com/Nomad-e/bluma-cli)*
+```
+
+## Available References
+
+- [Semantic Versioning](https://semver.org/)
+- [Keep a Changelog](https://keepachangelog.com/)
+- [Conventional Commits](https://www.conventionalcommits.org/)
+
+## Next Steps
+
+- For commit workflows, see git-commit skill
+- For PR workflows, see git-pr skill