@cullit/core 1.9.2 → 1.10.0

package/dist/index.d.ts

@@ -71,7 +71,7 @@ interface PipelineResult {
     duration: number;
 }
 
-declare const VERSION = "1.9.2";
+declare const VERSION = "1.10.0";
 declare const DEFAULT_CATEGORIES: string[];
 declare const DEFAULT_MODELS: Record<string, string>;
 declare const AI_PROVIDERS: readonly ["anthropic", "openai", "gemini", "ollama", "openclaw", "none"];
@@ -159,6 +159,7 @@ declare function registerFormatter(format: string, fn: FormatterFn): void;
 declare function getFormatter(format: string): FormatterFn | undefined;
 declare function listFormatters(): string[];
 declare function formatNotes(notes: ReleaseNotes, format: OutputFormat): string;
+declare function escapeHtml(str: string): string;
 
 /**
  * Outputs release notes to stdout (default).
@@ -281,7 +282,7 @@ declare function reportUsage(project?: string): Promise<void>;
  * Core registers: git collector, template generator, stdout/file publishers.
  * Pro registers:  AI generator, Jira/Linear collectors + enrichers, Slack/Discord/GitHub publishers.
  *
- * The CLI calls `await import('@cullit/pro')` to load pro plugins if installed.
+ * Paid plugin registration is preloaded by the licensed distribution package.
  */
 
 type CollectorFactory = (...args: any[]) => Collector;
@@ -321,4 +322,4 @@ declare function runPipeline(from: string, to: string, config: CullConfig, optio
     templateProfile?: string;
 }): Promise<PipelineResult>;
 
-export { AI_PROVIDERS, AUDIENCES, CHANGE_CATEGORIES, type ChangeCategory, type ChangeEntry, type Collector, type CollectorFactory, DEFAULT_CATEGORIES, DEFAULT_MODELS, ENRICHMENT_TYPES, type EnrichedContext, type EnrichedTicket, type Enricher, type EnricherFactory, FilePublisher, type Generator, type GeneratorFactory, GitCollector, type GitCommit, type GitDiff, type LicenseStatus, type LicenseTier, type LogLevel, type Logger, MultiRepoCollector, OUTPUT_FORMATS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TONES, type TeamFeature, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFeatureGating, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isEnrichmentAllowed, isFeatureAllowed, isProviderAllowed, isPublisherAllowed, listCollectors, listEnrichers, listFormatters, listGenerators, listPublishers, registerCollector, registerEnricher, registerFormatter, registerGenerator, registerPublisher, reportUsage, resolveLicense, runPipeline, upgradeMessage, validateLicense };
+export { AI_PROVIDERS, AUDIENCES, CHANGE_CATEGORIES, type ChangeCategory, type ChangeEntry, type Collector, type CollectorFactory, DEFAULT_CATEGORIES, DEFAULT_MODELS, ENRICHMENT_TYPES, type EnrichedContext, type EnrichedTicket, type Enricher, type EnricherFactory, FilePublisher, type Generator, type GeneratorFactory, GitCollector, type GitCommit, type GitDiff, type LicenseStatus, type LicenseTier, type LogLevel, type Logger, MultiRepoCollector, OUTPUT_FORMATS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TONES, type TeamFeature, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, escapeHtml, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFeatureGating, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isEnrichmentAllowed, isFeatureAllowed, isProviderAllowed, isPublisherAllowed, listCollectors, listEnrichers, listFormatters, listGenerators, listPublishers, registerCollector, registerEnricher, registerFormatter, registerGenerator, registerPublisher, reportUsage, resolveLicense, runPipeline, upgradeMessage, validateLicense };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/constants.ts
-var VERSION = "1.9.2";
+var VERSION = "1.10.0";
 var DEFAULT_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chores"];
 var DEFAULT_MODELS = {
   anthropic: "claude-sonnet-4-20250514",
@@ -72,7 +72,8 @@ var GitCollector = class {
         { cwd: this.cwd, encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
       );
     } catch (error) {
-      const stderr = error?.stderr?.toString?.() || "";
+      const errWithStderr = typeof error === "object" && error !== null && "stderr" in error ? error : void 0;
+      const stderr = errWithStderr?.stderr?.toString?.() || "";
       const hint = stderr.includes("unknown revision") ? 'Check that both refs exist (run "cullit tags" to see tags).' : stderr.includes("not a git repository") ? "Run this command inside a git repository." : `Make sure both refs exist and you're in a git repository.`;
       throw new Error(
         `Failed to read git log between ${from} and ${to}. ${hint}`
@@ -417,15 +418,15 @@ function formatNotes(notes, format) {
   const fn = formatters.get(format) || formatters.get("markdown");
   return fn(notes);
 }
-function escapeMarkdown(text) {
+function sanitizeForMarkdown(text) {
   return escapeHtml(text).replace(/\r?\n/g, " ");
 }
 function formatMarkdown(notes) {
   const lines = [];
-  lines.push(`## ${escapeMarkdown(notes.version)} \u2014 ${escapeMarkdown(notes.date)}`);
+  lines.push(`## ${sanitizeForMarkdown(notes.version)} \u2014 ${sanitizeForMarkdown(notes.date)}`);
   lines.push("");
   if (notes.summary) {
-    lines.push(escapeMarkdown(notes.summary));
+    lines.push(sanitizeForMarkdown(notes.summary));
     lines.push("");
   }
   const grouped = groupByCategory(notes);
@@ -435,8 +436,8 @@ function formatMarkdown(notes) {
     lines.push(`### ${CATEGORY_LABELS[category]}`);
     lines.push("");
     for (const entry of entries) {
-      let line = `- ${escapeMarkdown(entry.description)}`;
-      if (entry.ticketKey) line += ` (${escapeMarkdown(entry.ticketKey)})`;
+      let line = `- ${sanitizeForMarkdown(entry.description)}`;
+      if (entry.ticketKey) line += ` (${sanitizeForMarkdown(entry.ticketKey)})`;
       lines.push(line);
     }
     lines.push("");
@@ -444,7 +445,7 @@ function formatMarkdown(notes) {
   if (notes.contributors?.length) {
     lines.push("### Contributors");
     lines.push("");
-    lines.push(notes.contributors.map((c) => `@${escapeMarkdown(c)}`).join(", "));
+    lines.push(notes.contributors.map((c) => `@${sanitizeForMarkdown(c)}`).join(", "));
     lines.push("");
   }
   if (notes.metadata) {
@@ -772,7 +773,7 @@ async function validateLicense() {
     if (cachedValidation && cachedValidation.key === key) {
       return cachedValidation.status;
     }
-    return { tier: "pro", valid: true, message: "Offline validation \u2014 using cached license." };
+    return { tier: "free", valid: true, message: "License validation unavailable offline. Run while connected to activate your Pro license." };
   }
 }
 function isProviderAllowed(provider, license) {
@@ -977,7 +978,10 @@ async function runPipeline(from, to, config, options = {}) {
   const log = options.logger || createLogger("normal");
   const license = await validateLicense();
   if (!license.valid) {
-    throw new Error(license.message || "Invalid CULLIT_API_KEY");
+    if (!isProviderAllowed(config.ai.provider, license)) {
+      throw new Error(license.message || "Invalid CULLIT_API_KEY");
+    }
+    log.warn(`\u26A0 ${license.message || "Invalid CULLIT_API_KEY \u2014 running in free mode."}`);
   }
   if (!isProviderAllowed(config.ai.provider, license)) {
     throw new Error(upgradeMessage(`AI provider "${config.ai.provider}"`));
@@ -985,7 +989,7 @@ async function runPipeline(from, to, config, options = {}) {
   const collectorFactory = getCollector(config.source.type);
   if (!collectorFactory) {
     throw new Error(
-      `Source type "${config.source.type}" is not available. ` + (config.source.type !== "local" ? "Install @cullit/pro to use this source." : "Valid sources: local")
+      `Source type "${config.source.type}" is not available. ` + (config.source.type !== "local" ? "Install @cullit/licensed (private distribution) to use this source." : "Valid sources: local")
     );
   }
   const sourceLabel = config.source.type === "local" ? `commits between ${from}..${to}` : `items from ${config.source.type}`;
@@ -1007,7 +1011,7 @@ async function runPipeline(from, to, config, options = {}) {
     }
     const enricherFactory = getEnricher(source);
     if (!enricherFactory) {
-      log.info(`\xBB Skipping ${source} enrichment \u2014 install @cullit/pro to enable`);
+      log.info(`\xBB Skipping ${source} enrichment \u2014 install @cullit/licensed to enable`);
       continue;
     }
     log.info(`\xBB Enriching from ${source}...`);
@@ -1031,7 +1035,7 @@ async function runPipeline(from, to, config, options = {}) {
   const generatorFactory = getGenerator(config.ai.provider);
   if (!generatorFactory) {
     throw new Error(
-      `AI provider "${config.ai.provider}" is not available. ` + (config.ai.provider !== "none" ? "Install @cullit/pro to use AI providers." : "")
+      `AI provider "${config.ai.provider}" is not available. ` + (config.ai.provider !== "none" ? "Install @cullit/licensed (private distribution) to use AI providers." : "")
     );
   }
   let generator;
@@ -1061,7 +1065,7 @@ async function runPipeline(from, to, config, options = {}) {
         }
         const publisherFactory = getPublisher(target.type);
         if (!publisherFactory) {
-          log.info(`\xBB Skipping ${target.type} \u2014 install @cullit/pro to enable`);
+          log.info(`\xBB Skipping ${target.type} \u2014 install @cullit/licensed to enable`);
           continue;
         }
         const publisher = publisherFactory(target);
@@ -1129,6 +1133,7 @@ export {
   VERSION,
   analyzeReleaseReadiness,
   createLogger,
+  escapeHtml,
   fetchWithTimeout,
   formatNotes,
   getCollector,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cullit/core",
-  "version": "1.9.2",
+  "version": "1.10.0",
   "type": "module",
   "description": "Core engine for Cullit — AI-powered release note generation.",
   "license": "MIT",
@@ -16,6 +16,10 @@
     "ai",
     "automation"
   ],
+  "homepage": "https://cullit.io",
+  "bugs": {
+    "url": "https://github.com/mttaylor/cullit/issues"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -28,10 +32,13 @@
     "dist"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
-    "@cullit/config": "1.9.2"
+    "@cullit/config": "1.10.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",