@gitset-dev/cli 1.2.0 → 2.0.0

package/{LICENSE.md → LICENSE}

@@ -357,7 +357,7 @@ Exhibit A - Source Code Form License Notice
 
   This Source Code Form is subject to the terms of the Mozilla Public
   License, v. 2.0. If a copy of the MPL was not distributed with this
-  file, You can obtain one at http://mozilla.org/MPL/2.0/.
+  file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
 If it is not possible or desirable to put the notice in a particular
 file, then You may include the notice in a location (such as a LICENSE

package/README.md

@@ -1,191 +1,112 @@
 <div align="center">
-    <img src="https://github.com/imprvhub/gitset/blob/main/public/favicon-192.png" alt="GitSet CLI" />
-    <br>
-    <a href="https://badge.fury.io/js/@gitset-dev%2Fcli">
-        <img src="https://img.shields.io/npm/v/@gitset-dev/cli?color=%237BFEF5" alt="npm version" />
-    </a>
-    <a href="https://opensource.org/licenses/MPL-2.0">
-        <img src="https://img.shields.io/badge/License-MPL_2.0-%237BFEF5" alt="License: MPL 2.0" />
-    </a>
-    <br>
-    <br>
-    <h3>
-        GitSet CLI - AI-Driven Commit Message Generation
-    </h3>
-</div>
-
-## Overview
+  <a href="https://gitset.dev" target="_blank">
+    <img src="https://raw.githubusercontent.com/gitset-dev/gitset/main/public/cli/favicon-192.png" alt="Gitset CLI" width="88" />
+  </a>
 
-GitSet CLI is an integral component of the GitSet.dev ecosystem, designed to enhance Git workflow automation through AI-driven commit message generation. By leveraging Google's Gemini Pro AI technology, it provides intelligent analysis of staged changes to generate contextually appropriate commit messages, supporting both semantic and personalized formatting styles.
+  <h1>Gitset CLI</h1>
 
-## Key Capabilities
+  <p><strong><code>Draft. Refine. Ship.</code></strong></p>
 
-The GitSet CLI enhances repository management through:
-
-- **AI-Powered Analysis**: Utilizes advanced AI processing to analyze staged changes and generate contextually appropriate commit messages
-- **Semantic Versioning Support**: Implements conventional commit standards for maintaining structured version control
-- **Style Adaptation**: Analyzes existing commit patterns to match personal or team commit message conventions
-- **Efficient Processing**: Provides rapid analysis and suggestion generation while maintaining minimal resource utilization
-- **Cross-Platform Architecture**: Ensures consistent operation across various operating systems and environments
-- **License Management**: Flexible licensing system with both free and pro tiers for different usage needs
-- **Usage Tracking**: Built-in monitoring of API usage and license status
+  <p>
+    <img src="https://img.shields.io/badge/license-MPL--2.0-blue?style=flat-square" alt="MPL-2.0" />
+    <img src="https://img.shields.io/badge/model-BYOAI-white?style=flat-square" alt="BYOAI" />
+    <img src="https://img.shields.io/badge/node-%E2%89%A518-green?style=flat-square" alt="node >= 18" />
+  </p>
+</div>
 
-## System Requirements
+---
 
-- Node.js Runtime Environment (Version 18.0.0 or higher)
-- Git (Installed and configured)
-- Active internet connection for AI processing
+Gitset is an open-source toolkit for everything around your code on GitHub:
+commit messages, issues, pull requests, release notes, READMEs, labels, and
+repository upkeep. Every tool drafts from your repository's real context; you
+refine the draft until it ships. This package is the **CLI** — the same
+tools, in your terminal.
 
-## Installation Process
+**The CLI runs entirely on your machine.** There is no account, no login, and
+no telemetry. Your provider keys live in `~/.gitset` with owner-only
+permissions, and your code goes from your machine to your AI provider —
+nowhere else. It never contacts a Gitset server.
 
-Install the GitSet CLI globally via npm:
+## Install
 
-```bash
+```sh
 npm install -g @gitset-dev/cli
 ```
 
-## Implementation Guide
-
-### Basic Usage
+Requires Node.js 18+. Commands that publish to GitHub (`--create`,
+`--apply`) use the [GitHub CLI](https://cli.github.com) (`gh`) with your
+existing login.
 
-1. Stage your modifications:
-```bash
-git add .
-```
+## Quick start
 
-2. Generate commit message suggestions:
-```bash
-# Semantic versioning format (default)
-gitset suggest
+```sh
+# interactive setup — pick a provider, paste your key, pick a model
+gitset config
 
-# Custom formatting style
-gitset suggest --mode custom
+# stage changes, draft a commit message, refine it, commit
+git add -A
+gitset commit
 ```
 
-3. Implement the generated message:
-```bash
-git commit -m "generated_message"
-```
-
-### License Management
-
-Activate your GitSet license:
-```bash
-# Activate with license key
-gitset activate <license-key>
+`gitset config` walks you through it (provider list, masked key entry, a
+curated model per provider with "recommended" pre-selected). Prefer flags or
+scripting? `gitset config set anthropic --key sk-... --default` still works
+exactly as before. Providers: `anthropic` · `openai` · `gemini` ·
+`openrouter` · `custom` (any OpenAI-compatible endpoint). Override per run
+with `--provider` and `--model`.
 
-# Check license status and usage
-gitset status
+Terminal on a light background? `gitset config theme light` switches the
+accent color to one tuned for readability there (defaults to a dark-terminal
+palette).
 
-# Remove current license
-gitset deactivate
-```
+## Commands
 
-### Operational Modes
+Drafting (uses your provider key):
 
-#### Semantic Mode (Default Implementation)
-Implements conventional commit standards to generate structured, semantic commit messages. This mode is optimized for maintaining consistent and professional Git history in enterprise environments.
+| Command | Drafts |
+|---|---|
+| `gitset commit` | A commit message from your staged changes, with interactive refine |
+| `gitset pr` | A pull-request description from the branch diff (`--create` opens it via `gh`) |
+| `gitset issue -m "..."` | A structured GitHub issue from one sentence + repo context |
+| `gitset readme` | A README from your tracked files (`--template` uses yours as the base) |
+| `gitset release` | Release notes from a commit range (default: since the last tag) |
+| `gitset gitignore` | A `.gitignore` for the detected stack |
+| `gitset repo about` | A repository description + topics, applied via `gh` |
 
-Example output:
-```bash
-$ gitset suggest
-✨ Generated Suggestion:
-------------------------
-feat: Implement JWT authentication system
+Local tools (no AI):
 
-- Add token generation and validation mechanisms
-- Integrate login and registration endpoints
-- Configure route protection middleware
-```
+| Command | Does |
+|---|---|
+| `gitset labelspack` | Applies your reusable label set (`~/.gitset/labels.md`) to the repo |
+| `gitset repo backup` | Writes a scheduled mirror-backup GitHub Actions workflow |
+| `gitset repo license` | Generates a LICENSE file, fully offline |
+| `gitset template` / `gitset init` | Manage / scaffold your local templates |
+| `gitset dependabot` | Resolve open Dependabot alerts |
+| `gitset tree` · `gitset status` | Repository structure · git + provider status |
 
-#### Custom Mode
-Analyzes existing commit patterns to generate messages that align with established conventions:
-
-- Evaluates recent commit history (default: 20 commits) for pattern recognition
-- Adapts to existing formatting conventions and structural patterns
-- Maintains sequential naming conventions if detected
-- Preserves emoji usage patterns and placement
-- Replicates capitalization and punctuation styles
-- Balances descriptive content with stylistic consistency
-
-Example of style adaptation:
-```bash
-# Given existing commit pattern:
-FEATURE_123: Enhanced login interface 🚀
-FEATURE_124: Updated navigation system ✨
-FEATURE_125: Resolved routing conflicts 🔧
-
-# Generated suggestion maintains consistency:
-FEATURE_126: Implemented user preferences 🎯
-```
+Common flags: `--provider` `--model` `--yes` `--print` `--json`. Run
+`gitset help <command>` for everything else.
 
-## Configuration Reference
+## Templates
 
-### Command Structure
+Define your commit style, issue structure, PR format, README skeleton, or
+release-notes layout once in `~/.gitset/templates` and every draft follows
+it — the same define-once-reuse-everywhere model as the
+[web app](https://gitset.dev). `gitset template edit <commit|pr|issue|readme|release>`
+opens (or creates) one in `$EDITOR` — no need to hunt for the file path.
 
-Available commands:
-- `gitset suggest` - Initiates commit message generation based on staged changes
-- `gitset activate` - Activates GitSet with a license key
-- `gitset status` - Checks current license status and usage
-- `gitset deactivate` - Removes current license configuration
-- `gitset help` - Displays detailed usage information
+## Configuration
 
-### Available Parameters
+Keys and defaults: `~/.gitset/config.json` (created with `0600`
+permissions). Templates: `~/.gitset/templates`. Label pack:
+`~/.gitset/labels.md`. Delete `~/.gitset` and every trace is gone.
 
-For suggest command:
-- `--mode <mode>` - Specifies generation mode ('semantic' or 'custom')
-- `--commit-count <count>` - Defines number of commits to analyze (default: 20)
-- `--version` - Displays CLI version information
-- `--help` - Provides command usage information
+## Contributing
 
-## Plans and Pricing
+Issues and pull requests are welcome:
+[gitset-dev/gitset-cli-v2](https://github.com/gitset-dev/gitset-cli-v2).
 
-- **Basic (Free)**
-  - 10 requests per month
-  - Basic commit message generation
-  - Semantic and custom modes support
-
-- **Pro**
-  - Unlimited requests
-  - Advanced features and priority support
-  - Visit https://gitset.dev/pricing for details
-
-## Development Contribution
-
-We welcome contributions to enhance the GitSet CLI. Please follow these steps:
-
-1. Fork the repository
-2. Create a feature branch:
-   ```bash
-   git checkout -b feature/enhancement-description
-   ```
-3. Implement modifications:
-   ```bash
-   git commit -m 'feat: Add enhancement description'
-   ```
-4. Push changes:
-   ```bash
-   git push origin feature/enhancement-description
-   ```
-5. Submit a Pull Request
-
-## License Information
-
-This project operates under the Mozilla Public License 2.0 - refer to [LICENSE.md](LICENSE.md) for detailed terms.
-
-## Support Channels
-
-- Technical Support: support@gitset.dev
-- Contact Form: https://gitset.dev/contact
-- Issue Tracking: https://github.com/gitset-dev/gitset-cli/issues
-- Account Management: https://gitset.dev/account
-
-## Acknowledgments
-
-- Contributors who have helped improve this tool
-- Commander.js for CLI framework support
-- Google's Gemini Pro for AI capabilities
-
----
+## License
 
-Part of the [GitSet.dev](https://gitset.dev) ecosystem - Smart AI Documentation & Version Control for GitHub Repositories.
+[MPL-2.0](LICENSE) © Iván Luna. The Gitset name and logo are not covered by
+the code license.

package/index.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Gitset CLI — everything around your code, drafted in your terminal (BYOAI).
+ *
+ * Slim dispatcher. Every AI command runs LOCALLY with the user's own
+ * provider key (managed by `gitset config`, stored in ~/.gitset, never
+ * transmitted). There is NO login and NO Gitset backend — the entire old
+ * gitset_key / remote-API system has been removed.
+ */
+
+const theme = require('./src/utils/theme');
+
+function showHelp() {
+  console.log(`${theme.bold('gitset')} — everything around your code, drafted in your terminal (BYOAI)
+
+${theme.bold('First time?')} Run ${theme.accent('gitset config')} — an interactive wizard sets up your AI provider in under a minute.
+
+${theme.bold('AI commands')} (use your own provider key):
+  commit            Generate a commit message from staged changes
+  pr                Generate a pull-request description from the branch diff
+  issue             Draft a GitHub issue from a description
+  readme            Generate a README from repo context
+  release           Generate release notes from the commit range
+  gitignore         Generate a .gitignore for the detected stack
+  repo about        AI repo description + topics, applied via gh
+
+${theme.bold('Local tools')} (no AI):
+  repo license      Generate a LICENSE file (offline)
+  repo backup       Write a secure mirror-backup GitHub Actions workflow
+  tree              Print the repository structure
+  labelspack        Apply a label pack to the current repo
+  dependabot        Resolve Dependabot alerts
+  status            Show git + provider status
+  template          Manage local templates (~/.gitset/templates), edit <tool> to customize
+  init              Scaffold local templates
+
+${theme.bold('Setup')}:
+  config                                interactive setup wizard
+  config set <provider> --key <key> [--model m] [--default]
+  config list | remove <provider> | theme <dark|light> | path
+
+${theme.bold('Common flags')}: --provider <p> --model <m> --yes --json --print
+Providers: anthropic · openai · gemini · openrouter · custom
+Run ${theme.accent('gitset help <command>')} or ${theme.accent('gitset <command> --help')} for command details.
+
+Gitset is open source & BYOAI: no accounts, no quotas, keys stay on your machine.
+${theme.bold('Draft. Refine. Ship.')} — https://gitset.dev`);
+}
+
+const USAGE = {
+  commit: `Usage: gitset commit [flags]
+Generate a commit message from staged changes, with interactive refine.
+  --provider <p>   override the default provider for this run
+  --model <m>      override the model
+  --style <s>      commit style (default: conventional)
+  --all, -a        git add -A before generating
+  --yes            accept the first result (non-interactive)
+  --print          print the message only; do not commit
+  --json           machine-readable output
+Exit codes: 0 ok · 1 usage/git · 2 provider error`,
+  pr: `Usage: gitset pr [flags]
+Generate a pull-request description from the branch diff.
+  --base <branch>  base branch (default: detected)
+  --title <t>      PR title (default: generated)
+  --create         open the PR via gh after accepting
+  --provider <p> · --model <m> · --yes · --print · --json
+Exit codes: 0 ok · 1 usage · 2 provider error`,
+  issue: `Usage: gitset issue --message <description> [flags]
+Draft a GitHub issue from a description (+ local repo context).
+  --message, -m    what the issue is about (required)
+  --title <t>      issue title (default: generated)
+  --create         create the issue via gh after accepting
+  --provider <p> · --model <m> · --yes · --print · --json
+Exit codes: 0 ok · 1 usage · 2 provider error`,
+  readme: `Usage: gitset readme [flags]
+Generate a README from local repo context (git-tracked files).
+  --output <file>  write path (default: README.md)
+  --template <f>   use a template file as the structural base
+  --force          overwrite an existing file
+  --provider <p> · --model <m> · --yes · --print · --json
+Exit codes: 0 ok · 1 usage/io · 2 provider error`,
+  release: `Usage: gitset release [flags]
+Generate release notes from a commit range.
+  --from <ref>     start ref (default: last tag)
+  --to <ref>       end ref (default: HEAD)
+  --version <v>    release version/tag name
+  --provider <p> · --model <m>`,
+  gitignore: `Usage: gitset gitignore [flags]
+Generate a .gitignore for the locally detected stack.
+  --select         type the stacks yourself instead of auto-detect
+  --append         append to the existing .gitignore
+  --force          overwrite the existing .gitignore
+  --provider <p> · --model <m> · --print`,
+  repo: `Usage: gitset repo <about|license|backup> [flags]
+  about    AI description + topics from local context, applied via gh
+           (--apply · --yes · --provider <p> · --model <m>)
+  license  generate a LICENSE file (offline; see gitset license --list)
+  backup   write a secure mirror-backup GitHub Actions workflow`,
+  license: `Usage: gitset license [--id <spdx>] [--owner <name>] [--list] [--force]
+Fully offline LICENSE generator (MIT, ISC, BSD, Apache-2.0, Unlicense).`,
+  tree: `Usage: gitset tree [flags]
+Print the repository structure.
+  --depth <n>      limit depth
+  --all            include dotfiles
+  --exclude <pat>  exclude pattern (repeatable)
+  --no-gitignore   don't honor .gitignore`,
+  labelspack: `Usage: gitset labelspack [flags]
+Manage & apply a label pack (local pack + gh).
+  (none)           list the pack
+  --apply          create/update the labels in the current repo via gh
+  --init           write the default pack to ~/.gitset/labels.md
+  --add --name <x> --color <hex> --description "..."   add a label
+  --sync           pull the repo's labels into the local pack`,
+  dependabot: `Usage: gitset dependabot [--resolve] [--dry-run] [--save-dev]
+Resolve Dependabot alerts for the current repo (local + gh).`,
+  status: `Usage: gitset status
+Show git + configured-provider status.`,
+  template: `Usage: gitset template <list|show|edit|path>
+Manage local templates in ~/.gitset/templates.
+  list             show templates you have
+  show <name>      print a template's contents
+  edit <name>      open (or create) a template in $EDITOR
+  path             print the templates directory`,
+  init: `Usage: gitset init
+Scaffold the local template directory.`,
+  config: `Usage: gitset config [set|list|remove|theme|path]
+  (no args)        interactive setup wizard
+  set              interactive wizard, or: set <provider> --key <key> [--model m] [--base-url u] [--default]
+  list             show configured providers (keys never printed)
+  remove <provider>
+  theme <dark|light>   colors tuned for your terminal background
+  path             print the config file location
+Providers: anthropic · openai · gemini · openrouter · custom`,
+};
+
+function showCommandHelp(cmd) {
+  if (USAGE[cmd]) { console.log(USAGE[cmd]); return 0; }
+  console.error(`${theme.error('✗')} Unknown command: ${cmd}`);
+  showHelp();
+  return 1;
+}
+
+function deprecatedAuth(name) {
+  console.log(`${theme.warn('ℹ')} \`gitset ${name}\` was removed — Gitset v2 is BYOAI, there is no login.
+  Configure a provider instead:  ${theme.accent('gitset config')}`);
+  return 0;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const rest = args.slice(1);
+  let code = 0;
+
+  if (command === 'help' && rest[0]) {
+    process.exitCode = showCommandHelp(rest[0]);
+    return;
+  }
+  if (command && command !== 'help' && (rest.includes('--help') || rest.includes('-h'))) {
+    process.exitCode = showCommandHelp(command);
+    return;
+  }
+
+  switch (command) {
+    case 'commit':
+      code = await require('./lib/cli-commit').runCommitCommand(rest); break;
+    case 'pr':
+      code = await require('./lib/cli-pr').runPrCommand(rest); break;
+    case 'issue':
+      code = await require('./lib/cli-issue').runIssueCommand(rest); break;
+    case 'readme':
+      code = await require('./lib/cli-readme').runReadmeCommand(rest); break;
+    case 'gitignore':
+      code = await require('./src/commands/gitignore').runGitignoreCommand(rest); break;
+    case 'release':
+      code = await require('./src/commands/release')({
+        from: optVal(args, '--from'), to: optVal(args, '--to'), version: optVal(args, '--version'),
+        provider: optVal(args, '--provider'), model: optVal(args, '--model'),
+      }) || 0; break;
+
+    case 'config':
+      code = await require('./lib/cli-config').runConfigCommand(rest); break;
+
+    case 'repo':
+      code = await require('./src/commands/repo').runRepoCommand(rest); break;
+
+    case 'tree':
+      code = require('./src/commands/tree').runTreeCommand(rest); break;
+    case 'status':
+      code = require('./src/commands/status').runStatusCommand(); break;
+    case 'init':
+      code = require('./src/commands/init').runInitCommand(); break;
+    case 'template':
+      code = require('./src/commands/template').runTemplateCommand(rest); break;
+    case 'license':
+      code = await require('./src/commands/license').runLicenseCommand(rest); break;
+    case 'labelspack':
+      code = await require('./src/commands/labelspack').runLabelspackCommand(rest); break;
+    case 'dependabot':
+      code = (await require('./src/commands/dependabot-resolver')(null, rest)) || 0; break;
+
+    case 'auth': case 'verify': case 'logout':
+      code = deprecatedAuth(command); break;
+
+    case 'help': case '--help': case '-h': case undefined:
+      showHelp(); break;
+
+    case 'version': case '--version': case '-v':
+      console.log(require('./package.json').version); break;
+
+    default:
+      console.error(`${theme.error('✗')} Unknown command: ${command}`);
+      showHelp();
+      code = 1;
+  }
+
+  process.exitCode = code || 0;
+}
+
+function optVal(args, name) {
+  const i = args.indexOf(name);
+  return i !== -1 && args[i + 1] && !args[i + 1].startsWith('--') ? args[i + 1] : undefined;
+}
+
+main().catch((err) => {
+  console.error(`${theme.error('✗')} Fatal: ${err && err.message ? err.message : err}`);
+  process.exit(1);
+});

package/lib/ai/capabilities.js

@@ -0,0 +1,81 @@
+'use strict';
+
+const PROVIDERS = Object.freeze({
+  anthropic: {
+    label: 'Anthropic (Claude)',
+    defaultModel: 'claude-sonnet-4-6',
+    models: ['claude-sonnet-4-6', 'claude-haiku-4-5'],
+    streaming: true,
+    jsonMode: false,
+    contextFloor: 200_000,
+    keyHint: 'sk-ant-...',
+  },
+  openai: {
+    label: 'OpenAI',
+    defaultModel: 'gpt-4o',
+    models: ['gpt-4o', 'gpt-4o-mini', 'gpt-4.1'],
+    streaming: true,
+    jsonMode: true,
+    contextFloor: 128_000,
+    keyHint: 'sk-...',
+  },
+  gemini: {
+    label: 'Google Gemini',
+    defaultModel: 'gemini-2.5-flash',
+    models: ['gemini-2.5-flash', 'gemini-2.5-pro'],
+    streaming: true,
+    jsonMode: true,
+    contextFloor: 1_000_000,
+    keyHint: 'AIza...',
+  },
+  openrouter: {
+    label: 'OpenRouter',
+    defaultModel: 'anthropic/claude-sonnet-4-6',
+    models: ['anthropic/claude-sonnet-4-6', 'openai/gpt-4o'],
+    streaming: true,
+    jsonMode: true,
+    contextFloor: 32_000,
+    keyHint: 'sk-or-...',
+    baseURL: 'https://openrouter.ai/api/v1',
+  },
+  deepseek: {
+    label: 'DeepSeek',
+    defaultModel: 'deepseek-chat',
+    models: ['deepseek-chat', 'deepseek-reasoner'],
+    streaming: true,
+    jsonMode: true,
+    contextFloor: 64_000,
+    keyHint: 'sk-...',
+    baseURL: 'https://api.deepseek.com',
+  },
+  mock: {
+    label: 'Mock (offline/testing)',
+    defaultModel: 'mock-1',
+    streaming: true,
+    jsonMode: true,
+    contextFloor: 1_000_000,
+    keyHint: 'any',
+  },
+});
+
+const SUPPORTED = Object.keys(PROVIDERS);
+
+const FORBIDDEN_MODELS = Object.freeze([
+  'claude-opus-4-8',
+  'claude-fable-5',
+  'claude-mythos-5',
+  'claude-mythos-preview',
+]);
+
+function isForbiddenModel(model) {
+  if (!model) return false;
+  const bare = String(model).trim().toLowerCase().split('/').pop();
+  return FORBIDDEN_MODELS.includes(bare);
+}
+
+function estimateTokens(text) {
+  if (!text) return 0;
+  return Math.ceil(String(text).length / 4);
+}
+
+module.exports = { PROVIDERS, SUPPORTED, FORBIDDEN_MODELS, isForbiddenModel, estimateTokens };