@cullit/core 2.0.6 → 2.1.0

package/dist/index.d.ts

@@ -71,7 +71,7 @@ interface PipelineResult {
     duration: number;
 }
 
-declare const VERSION = "2.0.6";
+declare const VERSION = "2.1.0";
 declare const DEFAULT_CATEGORIES: string[];
 declare const DEFAULT_MODELS: Record<string, string>;
 declare const AI_PROVIDERS: readonly ["anthropic", "openai", "gemini", "ollama", "none"];
@@ -82,8 +82,8 @@ declare const CHANGE_CATEGORIES: readonly ["features", "fixes", "breaking", "imp
 declare const AUDIENCES: readonly ["developer", "end-user", "executive"];
 declare const TONES: readonly ["professional", "casual", "terse", "edgy", "hype", "snarky"];
 declare const SOURCE_TYPES: readonly ["local", "jira", "linear", "gitlab", "bitbucket", "multi-repo"];
-declare const TIERS: readonly ["free", "basic", "pro", "team", "enterprise"];
-declare const PAID_TIERS: readonly ["basic", "pro", "team", "enterprise"];
+declare const TIERS: readonly ["free", "pro", "team", "enterprise"];
+declare const PAID_TIERS: readonly ["pro", "team", "enterprise"];
 declare const TEAM_TIERS: readonly ["team", "enterprise"];
 declare const TEAM_PLANS: readonly ["team-5", "team-10", "team-25"];
 type TeamPlan = (typeof TEAM_PLANS)[number];
@@ -219,13 +219,16 @@ declare function analyzeReleaseReadiness(cwd?: string): ReleaseAdvisory;
 /**
  * Cullit License Gating
  *
- * Free tier (no key):  provider=none, publish to stdout/file only
- * Pro tier (with key): all providers, all publishers, all enrichments
+ * Free tier (no key):  3 AI gens/month, all providers (BYOK), publish to stdout/file only
+ * Pro tier (with key): 500 gens/month, all providers, all publishers, enrichments, audience/tone
+ * Team tier:           2000 gens/month, team management, advanced publishers
+ * Team 25:             5000 gens/month, 500 projects, branded widget, project templates, audit logs
+ * Enterprise tier:     unlimited everything
  *
  * validateLicense() performs async remote validation with caching.
  * resolveLicense() remains sync for quick format-only checks (display).
  */
-type LicenseTier = 'free' | 'basic' | 'pro' | 'team' | 'enterprise';
+type LicenseTier = 'free' | 'pro' | 'team' | 'enterprise';
 interface LicenseStatus {
     tier: LicenseTier;
     valid: boolean;
@@ -244,6 +247,7 @@ declare function resolveLicense(): LicenseStatus;
 declare function validateLicense(): Promise<LicenseStatus>;
 /**
  * Check whether the current license allows the requested provider.
+ * All tiers now allow AI providers (BYOK) — enforcement is via generation limits.
  */
 declare function isProviderAllowed(provider: string, license: LicenseStatus): boolean;
 /**
@@ -275,11 +279,22 @@ interface UsageLimits {
  * Get usage limits for a license tier.
  */
 declare function getTierLimits(tier: string): UsageLimits;
+/**
+ * Get usage limits for a specific plan, falling back to tier defaults.
+ * Use when the plan is known (API context); use getTierLimits when only tier is known (CLI).
+ */
+declare function getPlanLimits(plan: string, tier: string): UsageLimits;
 type TeamFeature = 'drafts' | 'approvals' | 'shared_history' | 'project_templates' | 'hosted_changelog' | 'branded_widget' | 'team_publishers' | 'org_settings' | 'audit_logs' | 'sso';
 /**
  * Check whether a license tier grants access to a Team/Enterprise feature.
  */
 declare function isFeatureAllowed(feature: TeamFeature, tier: string, valid?: boolean): boolean;
+/**
+ * Check whether a specific plan grants access to a feature.
+ * Use when the plan is known (API context); enterprise always passes.
+ * Falls back to tier-level check for features without plan restrictions.
+ */
+declare function isPlanFeatureAllowed(feature: TeamFeature, plan: string, tier: string, valid?: boolean): boolean;
 /**
  * Build a gating summary for a tier — which features are unlocked.
  */
@@ -396,4 +411,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, CoreErrorCode, type CoreErrorCodeValue, CullitError, 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, PAID_TIERS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type RateLimitResult, type RateLimiter, type RateLimiterOptions, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TEAM_PLANS, TEAM_PLAN_SEATS, TEAM_TIERS, TIERS, TONES, type TeamFeature, type TeamPlan, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, createRateLimiter, escapeHtml, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFeatureGating, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isAudienceToneAllowed, 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, CoreErrorCode, type CoreErrorCodeValue, CullitError, 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, PAID_TIERS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type RateLimitResult, type RateLimiter, type RateLimiterOptions, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TEAM_PLANS, TEAM_PLAN_SEATS, TEAM_TIERS, TIERS, TONES, type TeamFeature, type TeamPlan, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, createRateLimiter, escapeHtml, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFeatureGating, getFormatter, getGenerator, getLatestTag, getPlanLimits, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isAudienceToneAllowed, isEnrichmentAllowed, isFeatureAllowed, isPlanFeatureAllowed, 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 = "2.0.6";
+var VERSION = "2.1.0";
 var DEFAULT_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chores"];
 var DEFAULT_MODELS = {
   anthropic: "claude-sonnet-4-20250514",
@@ -15,8 +15,8 @@ var CHANGE_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chore
 var AUDIENCES = ["developer", "end-user", "executive"];
 var TONES = ["professional", "casual", "terse", "edgy", "hype", "snarky"];
 var SOURCE_TYPES = ["local", "jira", "linear", "gitlab", "bitbucket", "multi-repo"];
-var TIERS = ["free", "basic", "pro", "team", "enterprise"];
-var PAID_TIERS = ["basic", "pro", "team", "enterprise"];
+var TIERS = ["free", "pro", "team", "enterprise"];
+var PAID_TIERS = ["pro", "team", "enterprise"];
 var TEAM_TIERS = ["team", "enterprise"];
 var TEAM_PLANS = ["team-5", "team-10", "team-25"];
 var TEAM_PLAN_SEATS = {
@@ -757,7 +757,6 @@ async function fetchWithTimeout(url, init, timeoutMs = DEFAULT_TIMEOUT) {
 }
 
 // src/gate.ts
-var FREE_PROVIDERS = /* @__PURE__ */ new Set(["none"]);
 var FREE_PUBLISHERS = /* @__PURE__ */ new Set(["stdout", "file"]);
 var TEAM_ONLY_PUBLISHERS = /* @__PURE__ */ new Set(["confluence", "notion", "teams"]);
 var LICENSE_CACHE_TTL = 24 * 60 * 60 * 1e3;
@@ -809,7 +808,7 @@ async function validateLicense() {
     if (res.ok) {
       const data = await res.json();
       const status2 = {
-        tier: data.tier === "team" || data.tier === "enterprise" ? data.tier : data.tier === "pro" ? "pro" : data.tier === "basic" ? "basic" : "free",
+        tier: data.tier === "team" || data.tier === "enterprise" ? data.tier : data.tier === "pro" ? "pro" : "free",
         valid: data.valid !== false,
         message: data.message
       };
@@ -831,8 +830,8 @@ async function validateLicense() {
   }
 }
 function isProviderAllowed(provider, license) {
-  if (license.tier !== "free" && license.valid) return true;
-  return FREE_PROVIDERS.has(provider);
+  if (!license.valid) return provider === "none";
+  return true;
 }
 function isPublisherAllowed(publisherType, license) {
   if (TEAM_ONLY_PUBLISHERS.has(publisherType)) {
@@ -848,38 +847,59 @@ function isAudienceToneAllowed(license) {
   return (license.tier === "pro" || license.tier === "team" || license.tier === "enterprise") && license.valid;
 }
 function upgradeMessage(feature, minTier) {
-  const tierLabel = minTier === "team" ? "a Team plan or above" : minTier === "pro" ? "a Pro plan or above" : minTier === "basic" ? "a Basic plan or above" : minTier === "enterprise" ? "an Enterprise plan" : "a paid Cullit plan";
+  const tierLabel = minTier === "team" ? "a Team plan or above" : minTier === "pro" ? "a Pro plan or above" : minTier === "enterprise" ? "an Enterprise plan" : "a paid Cullit plan";
   return `\u{1F512} ${feature} requires ${tierLabel}.
    Upgrade at https://cullit.io/pricing
    Then set CULLIT_API_KEY in your environment.`;
 }
 var TIER_LIMITS = {
-  free: { generationsPerMonth: 5, maxProjects: 3 },
-  basic: { generationsPerMonth: 50, maxProjects: 10 },
+  free: { generationsPerMonth: 3, maxProjects: 3 },
   pro: { generationsPerMonth: 500, maxProjects: 100 },
   team: { generationsPerMonth: 2e3, maxProjects: 250 },
   enterprise: { generationsPerMonth: Infinity, maxProjects: Infinity }
 };
+var PLAN_LIMITS = {
+  "team-25": { generationsPerMonth: 5e3, maxProjects: 500 }
+};
 function getTierLimits(tier) {
   return TIER_LIMITS[tier] || TIER_LIMITS.free;
 }
+function getPlanLimits(plan, tier) {
+  return PLAN_LIMITS[plan] || TIER_LIMITS[tier] || TIER_LIMITS.free;
+}
 var FEATURE_TIERS = {
   drafts: /* @__PURE__ */ new Set(["team", "enterprise"]),
   approvals: /* @__PURE__ */ new Set(["team", "enterprise"]),
   shared_history: /* @__PURE__ */ new Set(["team", "enterprise"]),
-  project_templates: /* @__PURE__ */ new Set(["team", "enterprise"]),
+  project_templates: /* @__PURE__ */ new Set(["enterprise"]),
+  // plan-gated: team-25 via PLAN_FEATURES
   hosted_changelog: /* @__PURE__ */ new Set(["pro", "team", "enterprise"]),
-  branded_widget: /* @__PURE__ */ new Set(["team", "enterprise"]),
+  branded_widget: /* @__PURE__ */ new Set(["enterprise"]),
+  // plan-gated: team-25 via PLAN_FEATURES
   team_publishers: /* @__PURE__ */ new Set(["team", "enterprise"]),
   org_settings: /* @__PURE__ */ new Set(["team", "enterprise"]),
   audit_logs: /* @__PURE__ */ new Set(["enterprise"]),
+  // plan-gated: team-25 via PLAN_FEATURES
   sso: /* @__PURE__ */ new Set(["enterprise"])
 };
+var PLAN_FEATURES = {
+  branded_widget: /* @__PURE__ */ new Set(["team-25"]),
+  project_templates: /* @__PURE__ */ new Set(["team-25"]),
+  audit_logs: /* @__PURE__ */ new Set(["team-25"])
+};
 function isFeatureAllowed(feature, tier, valid = true) {
   if (!valid) return false;
   const allowed = FEATURE_TIERS[feature];
   return allowed ? allowed.has(tier) : false;
 }
+function isPlanFeatureAllowed(feature, plan, tier, valid = true) {
+  if (!valid) return false;
+  if (tier === "enterprise") return true;
+  const planSet = PLAN_FEATURES[feature];
+  if (planSet) return planSet.has(plan);
+  const tierSet = FEATURE_TIERS[feature];
+  return tierSet ? tierSet.has(tier) : false;
+}
 function getFeatureGating(tier) {
   const result = {};
   for (const feature of Object.keys(FEATURE_TIERS)) {
@@ -1182,6 +1202,11 @@ async function runPipeline(from, to, config, options = {}) {
     }
   }
   const context = { diff, tickets };
+  const hasCustomAudience = config.ai.audience && config.ai.audience !== "developer";
+  const hasCustomTone = config.ai.tone && config.ai.tone !== "professional";
+  if ((hasCustomAudience || hasCustomTone) && !isAudienceToneAllowed(license)) {
+    throw new CullitError(CoreErrorCode.LICENSE_TIER_INSUFFICIENT, upgradeMessage("Audience and tone control", "pro"));
+  }
   const providerNames = {
     anthropic: "Claude",
     openai: "OpenAI",
@@ -1306,6 +1331,7 @@ export {
   getFormatter,
   getGenerator,
   getLatestTag,
+  getPlanLimits,
   getPublisher,
   getRecentTags,
   getTierLimits,
@@ -1316,6 +1342,7 @@ export {
   isAudienceToneAllowed,
   isEnrichmentAllowed,
   isFeatureAllowed,
+  isPlanFeatureAllowed,
   isProviderAllowed,
   isPublisherAllowed,
   listCollectors,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cullit/core",
-  "version": "2.0.6",
+  "version": "2.1.0",
   "type": "module",
   "description": "Core engine for Cullit — AI-powered release note generation.",
   "license": "SEE LICENSE IN LICENSE",
@@ -38,7 +38,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cullit/config": "2.0.6"
+    "@cullit/config": "2.1.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",