@cullit/core 1.0.0 → 1.5.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { EnrichmentType, OutputFormat, AIConfig, CullConfig } from '@cullit/config';
-export { AIConfig, AIProvider, Audience, BitbucketConfig, ConfluenceConfig, CullConfig, EnrichmentType, GitLabConfig, JiraConfig, LinearConfig, NotionConfig, OpenClawConfig, OutputFormat, PublishTarget, PublisherType, SourceConfig, Tone } from '@cullit/config';
+import { EnrichmentType, OutputFormat, AIConfig, RepoSource, CullConfig } from '@cullit/config';
+export { AIConfig, AIProvider, Audience, BitbucketConfig, ConfluenceConfig, CullConfig, EnrichmentType, GitLabConfig, JiraConfig, LinearConfig, NotionConfig, OpenClawConfig, OutputFormat, PublishTarget, PublisherType, RepoSource, SourceConfig, Tone } from '@cullit/config';
 
 interface GitCommit {
     hash: string;
@@ -71,17 +71,17 @@ interface PipelineResult {
     duration: number;
 }
 
-declare const VERSION = "1.0.0";
+declare const VERSION = "1.5.0";
 declare const DEFAULT_CATEGORIES: string[];
 declare const DEFAULT_MODELS: Record<string, string>;
 declare const AI_PROVIDERS: readonly ["anthropic", "openai", "gemini", "ollama", "openclaw", "none"];
-declare const OUTPUT_FORMATS: readonly ["markdown", "html", "json"];
+declare const OUTPUT_FORMATS: readonly ["markdown", "html", "html-dark", "html-minimal", "html-edgy", "json"];
 declare const PUBLISHER_TYPES: readonly ["stdout", "file", "slack", "discord", "github-release", "teams", "confluence", "notion", "gitlab-release", "changelog"];
 declare const ENRICHMENT_TYPES: readonly ["jira", "linear"];
 declare const CHANGE_CATEGORIES: readonly ["features", "fixes", "breaking", "improvements", "chores", "other"];
 declare const AUDIENCES: readonly ["developer", "end-user", "executive"];
-declare const TONES: readonly ["professional", "casual", "terse"];
-declare const SOURCE_TYPES: readonly ["local", "jira", "linear", "gitlab", "bitbucket"];
+declare const TONES: readonly ["professional", "casual", "terse", "edgy", "hype", "snarky"];
+declare const SOURCE_TYPES: readonly ["local", "jira", "linear", "gitlab", "bitbucket", "multi-repo"];
 
 type LogLevel = 'quiet' | 'normal' | 'verbose';
 interface Logger {
@@ -123,6 +123,23 @@ declare function getRecentTags(cwd?: string, count?: number): string[];
  */
 declare function getLatestTag(cwd?: string): string | null;
 
+/**
+ * Collects commits from multiple repositories and merges them into a single GitDiff.
+ * Supports both local paths and remote URLs (shallow-cloned to temp dirs).
+ *
+ * Commits are tagged with `[repo-name]` prefix in the message for traceability.
+ * Results are sorted by date (newest first) across all repos.
+ */
+declare class MultiRepoCollector implements Collector {
+    private repos;
+    private tempDirs;
+    constructor(repos: RepoSource[]);
+    collect(from: string, to: string): Promise<GitDiff>;
+    private resolveRepoPath;
+    private inferName;
+    private cleanup;
+}
+
 /**
  * Template-based release notes generator — no AI required.
  * Groups commits by conventional commit prefix and ticket type.
@@ -293,4 +310,4 @@ declare function runPipeline(from: string, to: string, config: CullConfig, optio
     logger?: Logger;
 }): 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, OUTPUT_FORMATS, PUBLISHER_TYPES, type PipelineResult, type Publisher, type PublisherFactory, type ReleaseAdvisory, type ReleaseNotes, SOURCE_TYPES, type SemverBump, StdoutPublisher, TONES, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isEnrichmentAllowed, 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, TemplateGenerator, type UsageLimits, VERSION, analyzeReleaseReadiness, createLogger, fetchWithTimeout, formatNotes, getCollector, getEnricher, getFormatter, getGenerator, getLatestTag, getPublisher, getRecentTags, getTierLimits, hasCollector, hasEnricher, hasGenerator, hasPublisher, isEnrichmentAllowed, 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.0.0";
+var VERSION = "1.5.0";
 var DEFAULT_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chores"];
 var DEFAULT_MODELS = {
   anthropic: "claude-sonnet-4-20250514",
@@ -9,13 +9,13 @@ var DEFAULT_MODELS = {
   openclaw: "anthropic/claude-sonnet-4-6"
 };
 var AI_PROVIDERS = ["anthropic", "openai", "gemini", "ollama", "openclaw", "none"];
-var OUTPUT_FORMATS = ["markdown", "html", "json"];
+var OUTPUT_FORMATS = ["markdown", "html", "html-dark", "html-minimal", "html-edgy", "json"];
 var PUBLISHER_TYPES = ["stdout", "file", "slack", "discord", "github-release", "teams", "confluence", "notion", "gitlab-release", "changelog"];
 var ENRICHMENT_TYPES = ["jira", "linear"];
 var CHANGE_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chores", "other"];
 var AUDIENCES = ["developer", "end-user", "executive"];
-var TONES = ["professional", "casual", "terse"];
-var SOURCE_TYPES = ["local", "jira", "linear", "gitlab", "bitbucket"];
+var TONES = ["professional", "casual", "terse", "edgy", "hype", "snarky"];
+var SOURCE_TYPES = ["local", "jira", "linear", "gitlab", "bitbucket", "multi-repo"];
 
 // src/logger.ts
 function createLogger(level = "normal") {
@@ -36,7 +36,7 @@ function createLogger(level = "normal") {
 }
 
 // src/collectors/git.ts
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 function validateRef(ref) {
   if (!ref || ref.length > 256) {
     throw new Error(`Invalid git ref: too ${ref ? "long" : "short"}`);
@@ -66,8 +66,9 @@ var GitCollector = class {
     const format = "%H|%h|%an|%aI|%s|%b";
     const separator = "---CULLIT_COMMIT---";
     try {
-      return execSync(
-        `git log ${from}..${to} --format="${format}${separator}" --no-merges`,
+      return execFileSync(
+        "git",
+        ["log", `${from}..${to}`, `--format=${format}${separator}`, "--no-merges"],
         { cwd: this.cwd, encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
       );
     } catch (error) {
@@ -130,8 +131,9 @@ ${body}` : message;
   }
   getFilesChanged(from, to) {
     try {
-      const output = execSync(
-        `git diff --shortstat ${from}..${to}`,
+      const output = execFileSync(
+        "git",
+        ["diff", "--shortstat", `${from}..${to}`],
         { cwd: this.cwd, encoding: "utf-8" }
       );
       const match = output.match(/(\d+) files? changed/);
@@ -143,8 +145,9 @@ ${body}` : message;
 };
 function getRecentTags(cwd = process.cwd(), count = 10) {
   try {
-    const output = execSync(
-      `git tag --sort=-v:refname`,
+    const output = execFileSync(
+      "git",
+      ["tag", "--sort=-v:refname"],
       { cwd, encoding: "utf-8" }
     );
     return output.trim().split("\n").filter(Boolean).slice(0, count);
@@ -154,7 +157,7 @@ function getRecentTags(cwd = process.cwd(), count = 10) {
 }
 function getLatestTag(cwd = process.cwd()) {
   try {
-    return execSync("git describe --tags --abbrev=0", { cwd, encoding: "utf-8" }).trim();
+    return execFileSync("git", ["describe", "--tags", "--abbrev=0"], { cwd, encoding: "utf-8" }).trim();
   } catch {
     return null;
   }
@@ -164,8 +167,9 @@ function getCommitsSince(from, to, cwd = process.cwd()) {
   validateRef(to);
   const format = "%H|%h|%an|%aI|%s";
   const separator = "---CULLIT_COMMIT---";
-  const log = execSync(
-    `git log ${from}..${to} --format="${format}${separator}" --no-merges`,
+  const log = execFileSync(
+    "git",
+    ["log", `${from}..${to}`, `--format=${format}${separator}`, "--no-merges"],
     { cwd, encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 }
   );
   if (!log.trim()) return [];
@@ -181,6 +185,80 @@ function getCommitsSince(from, to, cwd = process.cwd()) {
   });
 }
 
+// src/collectors/multi-repo.ts
+import { execFileSync as execFileSync2 } from "child_process";
+import { mkdtempSync, rmSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+var MultiRepoCollector = class {
+  repos;
+  tempDirs = [];
+  constructor(repos) {
+    if (!repos.length) throw new Error("Multi-repo collector requires at least one repo");
+    this.repos = repos;
+  }
+  async collect(from, to) {
+    const allCommits = [];
+    let totalFilesChanged = 0;
+    try {
+      for (const repo of this.repos) {
+        const repoPath = await this.resolveRepoPath(repo);
+        const repoName = repo.name || this.inferName(repo);
+        const repoFrom = repo.from || from;
+        const repoTo = repo.to || to;
+        const collector = new GitCollector(repoPath);
+        const diff = await collector.collect(repoFrom, repoTo);
+        const taggedCommits = diff.commits.map((c) => ({
+          ...c,
+          message: `[${repoName}] ${c.message}`
+        }));
+        allCommits.push(...taggedCommits);
+        totalFilesChanged += diff.filesChanged || 0;
+      }
+    } finally {
+      this.cleanup();
+    }
+    allCommits.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+    return {
+      from,
+      to,
+      commits: allCommits,
+      filesChanged: totalFilesChanged
+    };
+  }
+  async resolveRepoPath(repo) {
+    if (repo.path) return repo.path;
+    if (!repo.url) {
+      throw new Error('Each repo must have either "url" or "path"');
+    }
+    if (!/^(https?:\/\/|git@|ssh:\/\/)/.test(repo.url)) {
+      throw new Error(`Invalid repo URL: ${repo.url}`);
+    }
+    const tempDir = mkdtempSync(join(tmpdir(), "cullit-repo-"));
+    this.tempDirs.push(tempDir);
+    execFileSync2(
+      "git",
+      ["clone", "--depth=500", "--single-branch", repo.url, tempDir],
+      { encoding: "utf-8", timeout: 6e4, stdio: "pipe" }
+    );
+    return tempDir;
+  }
+  inferName(repo) {
+    const source = repo.url || repo.path || "unknown";
+    const basename = source.replace(/\.git$/, "").split(/[/\\]/).pop();
+    return basename || "unknown";
+  }
+  cleanup() {
+    for (const dir of this.tempDirs) {
+      try {
+        rmSync(dir, { recursive: true, force: true });
+      } catch {
+      }
+    }
+    this.tempDirs = [];
+  }
+};
+
 // src/generators/template.ts
 var TemplateGenerator = class {
   async generate(context, config) {
@@ -292,6 +370,18 @@ var TemplateGenerator = class {
       if (parts.length === 0) return `A quick update with ${commitCount} commits \u2014 nothing too wild.`;
       return `We've got ${parts.join(", ")} packed into ${commitCount} commits. Let's go!`;
     }
+    if (tone === "edgy") {
+      if (parts.length === 0) return `${commitCount} commits. No fluff. Just code that needed to exist.`;
+      return `Shipped: ${parts.join(", ")}. ${commitCount} commits. Zero apologies.`;
+    }
+    if (tone === "hype") {
+      if (parts.length === 0) return `\u{1F525} ${commitCount} commits just dropped and they're INCREDIBLE!`;
+      return `\u{1F680} HUGE release! ${parts.join(", ")} across ${commitCount} commits! This changes EVERYTHING!`;
+    }
+    if (tone === "snarky") {
+      if (parts.length === 0) return `${commitCount} commits. We were bored, okay?`;
+      return `Oh look, ${parts.join(", ")} from ${commitCount} commits. You're welcome.`;
+    }
     return parts.length > 0 ? `This release includes ${parts.join(", ")} across ${commitCount} commits.` : `This release includes ${commitCount} commits.`;
   }
 };
@@ -396,12 +486,64 @@ function groupByCategory(notes) {
   }
   return grouped;
 }
+var THEME_DARK = `<style>
+.cull-release{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0f1117;color:#d4d4e0;padding:2rem;border-radius:12px;max-width:720px;line-height:1.7}
+.cull-release h2{color:#f0f0f5;font-size:1.6rem;border-bottom:2px solid #5eead4;padding-bottom:.5rem;margin-bottom:1rem}
+.cull-release h3{color:#5eead4;font-size:1.1rem;margin:1.5rem 0 .5rem}
+.cull-release .summary{color:#7e819a;font-size:.95rem;margin-bottom:1.5rem}
+.cull-release ul{list-style:none;padding:0}
+.cull-release li{padding:.4rem 0;border-bottom:1px solid #1e2030;font-size:.9rem}
+.cull-release li:last-child{border-bottom:none}
+.cull-release code{background:#161822;color:#5eead4;padding:.15rem .4rem;border-radius:4px;font-size:.8rem}
+.cull-release footer{margin-top:2rem;padding-top:1rem;border-top:1px solid #282a3a;color:#7e819a;font-size:.75rem}
+.cull-release a{color:#5eead4;text-decoration:none}
+</style>
+`;
+var THEME_MINIMAL = `<style>
+.cull-release{font-family:'Georgia',serif;background:#fafafa;color:#222;padding:2.5rem;max-width:680px;line-height:1.8}
+.cull-release h2{font-weight:400;font-size:1.4rem;letter-spacing:-.02em;border-bottom:1px solid #ddd;padding-bottom:.75rem;margin-bottom:1.25rem}
+.cull-release h3{font-weight:600;font-size:.9rem;text-transform:uppercase;letter-spacing:.1em;color:#888;margin:1.5rem 0 .5rem}
+.cull-release .summary{color:#555;font-size:.95rem;font-style:italic;margin-bottom:1.5rem}
+.cull-release ul{list-style:none;padding:0}
+.cull-release li{padding:.5rem 0;border-bottom:1px solid #eee;font-size:.9rem}
+.cull-release li:last-child{border-bottom:none}
+.cull-release code{background:#f0f0f0;color:#c7254e;padding:.1rem .35rem;border-radius:3px;font-size:.8rem}
+.cull-release footer{margin-top:2rem;color:#aaa;font-size:.75rem}
+.cull-release a{color:#222}
+</style>
+`;
+var THEME_EDGY = `<style>
+.cull-release{font-family:'Courier New',monospace;background:#000;color:#0f0;padding:2rem;border:1px solid #0f0;border-radius:0;max-width:720px;line-height:1.6;text-shadow:0 0 4px rgba(0,255,0,.3)}
+.cull-release h2{color:#0f0;font-size:1.5rem;text-transform:uppercase;letter-spacing:.15em;border-bottom:2px solid #0f0;padding-bottom:.5rem;margin-bottom:1rem}
+.cull-release h3{color:#0f0;font-size:1rem;text-transform:uppercase;letter-spacing:.1em;margin:1.5rem 0 .5rem;opacity:.8}
+.cull-release h3::before{content:'> '}
+.cull-release .summary{color:#0c0;font-size:.9rem;margin-bottom:1.5rem;opacity:.7}
+.cull-release ul{list-style:none;padding:0}
+.cull-release li{padding:.3rem 0;font-size:.85rem}
+.cull-release li::before{content:'$ ';color:#0a0;opacity:.6}
+.cull-release code{background:#001100;color:#5f5;padding:.15rem .4rem;border:1px solid #0a0;font-size:.8rem}
+.cull-release footer{margin-top:2rem;padding-top:1rem;border-top:1px solid #0a0;color:#0a0;font-size:.7rem;opacity:.5}
+.cull-release a{color:#0f0}
+</style>
+`;
+function formatThemedHTML(theme) {
+  const themeCSS = {
+    dark: THEME_DARK,
+    minimal: THEME_MINIMAL,
+    edgy: THEME_EDGY
+  };
+  return (notes) => (themeCSS[theme] || "") + formatHTML(notes);
+}
 registerFormatter("markdown", formatMarkdown);
 registerFormatter("html", formatHTML);
+registerFormatter("html-dark", formatThemedHTML("dark"));
+registerFormatter("html-minimal", formatThemedHTML("minimal"));
+registerFormatter("html-edgy", formatThemedHTML("edgy"));
 registerFormatter("json", (notes) => JSON.stringify(notes, null, 2));
 
 // src/publishers/index.ts
 import { writeFileSync } from "fs";
+import { resolve, relative, isAbsolute } from "path";
 var StdoutPublisher = class {
   async publish(notes, format, preformatted) {
     console.log(preformatted || formatNotes(notes, format));
@@ -410,6 +552,12 @@ var StdoutPublisher = class {
 var FilePublisher = class {
   constructor(path) {
     this.path = path;
+    const resolved = resolve(path);
+    const cwd = resolve(".");
+    const rel = relative(cwd, resolved);
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+      throw new Error(`File output path must be within the project directory. Got: ${path}`);
+    }
   }
   async publish(notes, format, preformatted) {
     const output = preformatted || formatNotes(notes, format);
@@ -419,7 +567,7 @@ var FilePublisher = class {
 };
 
 // src/advisor.ts
-import { execSync as execSync2 } from "child_process";
+import { execFileSync as execFileSync3 } from "child_process";
 var COMMIT_PATTERNS = [
   { pattern: /^breaking[(!:]|^BREAKING CHANGE/i, category: "breaking" },
   { pattern: /!:/, category: "breaking" },
@@ -456,8 +604,9 @@ function getCommitsSinceTag(tag, cwd) {
 }
 function getTagDate(tag, cwd) {
   try {
-    const dateStr = execSync2(
-      `git log -1 --format=%aI ${tag}`,
+    const dateStr = execFileSync3(
+      "git",
+      ["log", "-1", "--format=%aI", tag],
       { cwd, encoding: "utf-8" }
     ).trim();
     return new Date(dateStr);
@@ -565,6 +714,7 @@ async function fetchWithTimeout(url, init, timeoutMs = DEFAULT_TIMEOUT) {
 var FREE_PROVIDERS = /* @__PURE__ */ new Set(["none"]);
 var FREE_PUBLISHERS = /* @__PURE__ */ new Set(["stdout", "file"]);
 var LICENSE_CACHE_TTL = 24 * 60 * 60 * 1e3;
+var LICENSE_FAILURE_CACHE_TTL = 5 * 60 * 1e3;
 var cachedValidation = null;
 function resolveLicense() {
   const key = process.env.CULLIT_API_KEY?.trim();
@@ -612,10 +762,13 @@ async function validateLicense() {
       valid: false,
       message: "License validation failed. Check your API key at https://cullit.io/pricing"
     };
-    cachedValidation = { status, key, expiresAt: Date.now() + LICENSE_CACHE_TTL };
+    cachedValidation = { status, key, expiresAt: Date.now() + LICENSE_FAILURE_CACHE_TTL };
     return status;
   } catch {
-    return { tier: "pro", valid: true };
+    if (cachedValidation && cachedValidation.key === key) {
+      return cachedValidation.status;
+    }
+    return { tier: "pro", valid: true, message: "Offline validation \u2014 using cached license." };
   }
 }
 function isProviderAllowed(provider, license) {
@@ -635,7 +788,7 @@ function upgradeMessage(feature) {
    Then set CULLIT_API_KEY in your environment.`;
 }
 var TIER_LIMITS = {
-  free: { generationsPerMonth: 10, maxProjects: 1 },
+  free: { generationsPerMonth: 3, maxProjects: 1 },
   pro: { generationsPerMonth: 500, maxProjects: 5 },
   team: { generationsPerMonth: 2e3, maxProjects: 25 },
   enterprise: { generationsPerMonth: Infinity, maxProjects: Infinity }
@@ -719,7 +872,11 @@ function listPublishers() {
 }
 
 // src/index.ts
-registerCollector("local", () => new GitCollector());
+registerCollector("local", (config) => new GitCollector(config.source?.repoPath));
+registerCollector("multi-repo", (config) => {
+  if (!config.repos?.length) throw new Error('Multi-repo source requires "repos" array in config');
+  return new MultiRepoCollector(config.repos);
+});
 registerGenerator("none", () => new TemplateGenerator());
 registerPublisher("stdout", (_target) => new StdoutPublisher());
 registerPublisher("file", (target) => new FilePublisher(target.path));
@@ -834,6 +991,7 @@ export {
   ENRICHMENT_TYPES,
   FilePublisher,
   GitCollector,
+  MultiRepoCollector,
   OUTPUT_FORMATS,
   PUBLISHER_TYPES,
   SOURCE_TYPES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cullit/core",
-  "version": "1.0.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "Core engine for Cullit — AI-powered release note generation.",
   "license": "MIT",
@@ -31,10 +31,11 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@cullit/config": "1.0.0"
+    "@cullit/config": "1.5.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts --format esm --dts --watch"
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "test": "vitest run"
   }
 }