cullit 1.8.0 → 1.9.1

package/README.md

@@ -0,0 +1,62 @@
+# cullit CLI
+
+AI-powered release notes from your terminal.
+
+`cullit` reads your git history (and optionally Jira/Linear context), then generates and publishes release notes to the channels your team already uses.
+
+## Install
+
+```bash
+# one-off
+npx cullit generate --from v1.0.0 --to v1.1.0
+
+# global
+npm install -g cullit
+
+# dev dependency
+npm install -D cullit
+```
+
+## Quick Start
+
+```bash
+# initialize .cullit.yml
+cullit init
+
+# generate between refs
+cullit generate --from v1.0.0 --to v1.1.0
+
+# autodetect last two tags
+cullit generate
+
+# no AI key needed (template mode)
+cullit generate --from HEAD~10 --provider none
+
+# select a named template profile from .cullit.yml
+cullit generate --from v1.8.0 --template customer-facing
+```
+
+## Common Flags
+
+- `--from <ref>` source git ref / tag / query
+- `--to <ref>` target ref (defaults to `HEAD`)
+- `--provider <name>` `anthropic|openai|gemini|ollama|openclaw|none`
+- `--model <id>` override model
+- `--audience <type>` tune output for `developer|end-user|executive`
+- `--tone <style>` tone controls for generated output
+- `--format <fmt>` output format
+- `--template <name>` select named template profile from config
+- `--quiet` minimal logs
+- `--verbose` detailed logs
+
+## Docs
+
+- Full docs: https://cullit.io/docs
+- Tutorial: https://cullit.io/tutorial
+- Pricing: https://cullit.io/pricing
+
+## Source and Issues
+
+- Repository: https://github.com/mttaylor/cullit
+- Issues: https://github.com/mttaylor/cullit/issues
+- Security: see `SECURITY.md` in the repository

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { runPipeline, VERSION, createLogger, analyzeReleaseReadiness, resolveLicense, AI_PROVIDERS, AUDIENCES, TONES, SOURCE_TYPES } from "@cullit/core";
+import { runPipeline, VERSION, createLogger, analyzeReleaseReadiness, resolveLicense, AI_PROVIDERS, AUDIENCES, TONES, SOURCE_TYPES, OUTPUT_FORMATS } from "@cullit/core";
 import { loadConfig } from "@cullit/config";
 import { getRecentTags } from "@cullit/core";
 import { writeFileSync, readFileSync, existsSync } from "fs";
@@ -48,6 +48,7 @@ var HELP = `
     --to, -t      End ref (defaults to HEAD)
     --config, -c  Path to config file (default: .cullit.yml)
     --format      Output format: markdown, html, html-dark, html-minimal, html-edgy, json
+    --template    Template profile name from config.templates
     --dry-run     Generate but don't publish
     --provider    Override AI provider (anthropic, openai, gemini, ollama, openclaw, none)
     --source      Override source type (local, jira, linear, gitlab, bitbucket)
@@ -64,6 +65,7 @@ var HELP = `
     $ cullit generate --source jira --from "project = PROJ" --provider anthropic
     $ cullit generate --source linear --from "team:ENG" --provider openai
     $ cullit generate --source gitlab --from v1.0.0 --to v1.1.0
+    $ cullit generate --from v1.2.0 --template customer-facing
     $ cullit generate --from HEAD~5 --tone edgy --format html-edgy
     $ cullit init
 `;
@@ -189,17 +191,25 @@ async function runGenerate(from, to, opts) {
     }
     config.source.type = opts.source;
   }
-  const format = opts.format || "markdown";
+  if (opts.format && !OUTPUT_FORMATS.includes(opts.format)) {
+    console.error(`
+\u2717 Invalid format: ${opts.format}`);
+    console.error(`  Valid formats: ${OUTPUT_FORMATS.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const format = opts.format;
   const dryRun = "dry-run" in opts || "dryRun" in opts;
   const logLevel = "verbose" in opts ? "verbose" : "quiet" in opts ? "quiet" : "normal";
   const logger = createLogger(logLevel);
+  const templateProfile = opts.template || opts.templateProfile || opts["template-profile"];
   const license = resolveLicense();
   if (logLevel !== "quiet") {
     const tierLabel = license.tier === "pro" ? "\u{1F511} Pro" : "\u{1F193} Free";
     logger.info(`\xBB License: ${tierLabel}`);
   }
   try {
-    const result = await runPipeline(from, to, config, { format, dryRun, logger });
+    const result = await runPipeline(from, to, config, { format, dryRun, logger, templateProfile });
     if (logLevel !== "quiet") {
       try {
         const advisory = analyzeReleaseReadiness();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cullit",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "type": "module",
   "description": "Cull the noise from your releases. AI-powered release notes from the CLI.",
   "license": "MIT",
@@ -23,14 +23,15 @@
   },
   "main": "./dist/index.js",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"
   },
   "dependencies": {
-    "@cullit/core": "1.8.0",
-    "@cullit/config": "1.8.0"
+    "@cullit/core": "1.9.1",
+    "@cullit/config": "1.9.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",