cullit 1.9.2 → 1.10.0

package/README.md

@@ -1,16 +1,23 @@
 # cullit CLI
 
-AI-powered release notes from your terminal.
+Public CLI installer for Cullit's local, template-based workflow.
 
-`cullit` reads your git history (and optionally Jira/Linear context), then generates and publishes release notes to the channels your team already uses.
+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
-npx cullit generate --from v1.0.0 --to v1.1.0
+# one-off free local run
+npx cullit generate --from v1.0.0 --to v1.1.0 --provider none
 
-# global
+# global install
 npm install -g cullit
 
 # dev dependency
@@ -23,19 +30,26 @@ npm install -D cullit
 # initialize .cullit.yml
 cullit init
 
-# generate between refs
-cullit generate --from v1.0.0 --to v1.1.0
+# generate between refs with the built-in template engine
+cullit generate --from v1.0.0 --to v1.1.0 --provider none
 
-# autodetect last two tags
-cullit generate
+# autodetect the last two tags
+cullit generate --provider none
 
-# no AI key needed (template mode)
-cullit generate --from HEAD~10 --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 --template customer-facing
+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

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.2",
+  "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.2",
-    "@cullit/config": "1.9.2"
+    "@cullit/core": "1.10.0",
+    "@cullit/config": "1.10.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",