cullit 1.9.1 → 1.10.0

package/README.md

@@ -1,62 +1,76 @@
-# 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
+# cullit CLI
+
+Public CLI installer for Cullit's local, template-based workflow.
+
+The `cullit` package on npm is intentionally limited to the free local surface:
+
+- local git collection
+- template generation with `--provider none`
+- stdout and file publishing
+- config, status, and tag helpers
+
+Installing from npm does not grant paid access by itself. Licensed AI providers, Jira/Linear enrichment, premium publishers, dashboard workflows, and other paid surfaces are delivered through Cullit-hosted or private licensed distributions.
+
+## Install
+
+```bash
+# one-off free local run
+npx cullit generate --from v1.0.0 --to v1.1.0 --provider none
+
+# global install
+npm install -g cullit
+
+# dev dependency
+npm install -D cullit
+```
+
+## Quick Start
+
+```bash
+# initialize .cullit.yml
+cullit init
+
+# generate between refs with the built-in template engine
+cullit generate --from v1.0.0 --to v1.1.0 --provider none
+
+# autodetect the last two tags
+cullit generate --provider none
+
+# write release notes to a file
+cullit generate --from HEAD~10 --provider none --format markdown --dry-run
+
+# select a named template profile from .cullit.yml
+cullit generate --from v1.8.0 --provider none --template customer-facing
+```
+
+## Licensing
+
+- Public npm package: free local/template workflow only
+- Paid tiers (Pro, Team, Enterprise): delivered through the private package `@cullit/licensed`
+- `CULLIT_API_KEY`: used by licensed hosted/private Cullit surfaces
+- Need Pro or Team access: https://cullit.io/pricing
+
+## 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, OUTPUT_FORMATS } from "@cullit/core";
+import { runPipeline, VERSION, createLogger, analyzeReleaseReadiness, resolveLicense, reportUsage, 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";
@@ -38,7 +38,7 @@ var HELP = `
     $ cullit <command> [options]
 
   COMMANDS
-    generate    Generate release notes from git, Jira, or Linear
+    generate    Generate release notes from git or licensed sources
     status      Release readiness check \u2014 should you release?
     init        Create a .cullit.yml config file
     tags        List recent tags in the current repo
@@ -57,14 +57,13 @@ var HELP = `
     --verbose     Show detailed output
     --quiet       Suppress all output except errors
 
+  NOTES
+    Public npm package: local git + template mode + stdout/file
+    Licensed/private Cullit surfaces add AI, enrichments, and premium publishers
+
   EXAMPLES
     $ cullit generate --from v1.0.0 --to v1.1.0
-    $ cullit generate --from HEAD~10 --provider gemini
-    $ cullit generate --from HEAD~5 --provider ollama --model llama3.1
     $ cullit generate --from HEAD~5 --provider none         # no AI key needed
-    $ 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
@@ -209,7 +208,9 @@ async function runGenerate(from, to, opts) {
     logger.info(`\xBB License: ${tierLabel}`);
   }
   try {
-    const result = await runPipeline(from, to, config, { format, dryRun, logger, templateProfile });
+    await runPipeline(from, to, config, { format, dryRun, logger, templateProfile });
+    reportUsage(from).catch(() => {
+    });
     if (logLevel !== "quiet") {
       try {
         const advisory = analyzeReleaseReadiness();
@@ -296,7 +297,7 @@ async function interactiveInit() {
   const VALID_TONES = TONES;
   const VALID_ENRICHMENTS = ["jira", "linear", "both", "none"];
   console.log("\n  Cullit \u2014 Project Setup\n");
-  const provider = await ask(rl, "  AI provider (anthropic/openai/gemini/ollama/openclaw/none) [anthropic]: ") || "anthropic";
+  const provider = await ask(rl, "  AI provider (anthropic/openai/gemini/ollama/openclaw/none) [none]: ") || "none";
   if (!VALID_PROVIDERS.includes(provider)) {
     console.error(`
   \u2717 Invalid provider: ${provider}. Must be one of: ${VALID_PROVIDERS.join(", ")}`);
@@ -317,7 +318,7 @@ async function interactiveInit() {
     rl.close();
     process.exit(1);
   }
-  const tone = await ask(rl, "  Tone (professional/casual/terse) [professional]: ") || "professional";
+  const tone = await ask(rl, "  Tone (professional/casual/terse/edgy/hype/snarky) [professional]: ") || "professional";
   if (!VALID_TONES.includes(tone)) {
     console.error(`
   \u2717 Invalid tone: ${tone}. Must be one of: ${VALID_TONES.join(", ")}`);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "cullit",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "type": "module",
-  "description": "Cull the noise from your releases. AI-powered release notes from the CLI.",
+  "description": "Public Cullit CLI for local, template-based release notes. Licensed AI and integrations are delivered separately.",
   "license": "MIT",
   "author": "Cullit <matt@cullit.io>",
   "repository": {
@@ -18,6 +18,10 @@
     "devops",
     "automation"
   ],
+  "homepage": "https://cullit.io",
+  "bugs": {
+    "url": "https://github.com/mttaylor/cullit/issues"
+  },
   "bin": {
     "cullit": "./dist/index.js"
   },
@@ -27,11 +31,11 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "dependencies": {
-    "@cullit/core": "1.9.1",
-    "@cullit/config": "1.9.1"
+    "@cullit/core": "1.10.0",
+    "@cullit/config": "1.10.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",