cli-changescribe 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Ulloa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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/README.md

@@ -0,0 +1,65 @@
+# changescribe
+
+CLI to generate Conventional Commit messages and PR summaries using Groq.
+
+## Install
+
+```bash
+npm install -g cli-changescribe
+```
+
+## Setup
+
+Create a `.env.local` file in the repo where you run the CLI:
+
+```bash
+GROQ_API_KEY="your-key-here"
+```
+
+Optional environment variables for PR summaries:
+
+- `PR_SUMMARY_BASE` (default: `main`)
+- `PR_SUMMARY_OUT` (default: `.pr-summaries/PR_SUMMARY.md`)
+- `PR_SUMMARY_LIMIT` (default: `400`)
+- `PR_SUMMARY_ISSUE` (default: empty)
+- `GROQ_PR_MODEL` (default: `openai/gpt-oss-120b`)
+- `GROQ_MODEL` (fallback)
+
+## Usage
+
+### Init scripts in a repo
+
+```bash
+npx changescribe init
+```
+
+### Commit message
+
+```bash
+changescribe commit --dry-run
+changescribe commit
+```
+
+### PR summary
+
+```bash
+changescribe pr --base main --mode release
+changescribe pr --base main --create-pr --mode release
+changescribe pr --dry-run
+```
+
+### Npm script parity aliases
+
+These match the npm scripts in your repo:
+
+```bash
+changescribe pr:summary
+changescribe feature:pr
+changescribe staging:pr
+```
+
+## Notes
+
+- `changescribe commit` stages changes if nothing is staged and commits/pushes by default.
+- `changescribe pr` can create or update a GitHub PR when `--create-pr` is passed (requires `gh`).
+- The CLI must be run inside a git repo.

package/bin/changescribe.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+const { runCommit } = require('../src/commit');
+const { runInit } = require('../src/init');
+const { runPrSummary } = require('../src/pr-summary');
+
+function printHelp() {
+  console.log(`changescribe <command> [options]
+
+Commands:
+  commit        Generate a commit message and commit/push changes
+  pr            Generate a PR summary (optionally create/update PR)
+  init          Add npm scripts to the current repo
+  pr:summary    Alias for pr
+  feature:pr    Alias for: pr --base staging --create-pr --mode feature
+  staging:pr    Alias for: pr --base main --create-pr --mode release
+
+Examples:
+  changescribe init
+  changescribe commit --dry-run
+  changescribe pr --base main --mode release
+  changescribe feature:pr
+  changescribe staging:pr
+`);
+}
+
+async function main() {
+  const [, , command, ...rest] = process.argv;
+  if (!command || command === '-h' || command === '--help') {
+    printHelp();
+    return;
+  }
+
+  if (command === 'commit') {
+    await runCommit(rest);
+    return;
+  }
+
+  if (command === 'init') {
+    await runInit();
+    return;
+  }
+
+  if (command === 'pr' || command === 'pr:summary') {
+    await runPrSummary(rest);
+    return;
+  }
+
+  if (command === 'feature:pr') {
+    await runPrSummary(['--base', 'staging', '--create-pr', '--mode', 'feature']);
+    return;
+  }
+
+  if (command === 'staging:pr') {
+    await runPrSummary(['--base', 'main', '--create-pr', '--mode', 'release']);
+    return;
+  }
+
+  console.error(`Unknown command: ${command}`);
+  printHelp();
+  process.exit(1);
+}
+
+main();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "cli-changescribe",
+  "version": "0.1.0",
+  "description": "CLI for generating commit messages and PR summaries",
+  "bin": {
+    "changescribe": "./bin/changescribe.js"
+  },
+  "type": "commonjs",
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "cli",
+    "commit",
+    "conventional-commits",
+    "pr",
+    "summary",
+    "changelog",
+    "groq"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "dotenv": "^17.2.1",
+    "groq-sdk": "^0.8.0"
+  }
+}