cullit 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { runPipeline, VERSION } from "@cullit/core";
+import { runPipeline, VERSION, createLogger, analyzeReleaseReadiness, resolveLicense } from "@cullit/core";
 import { loadConfig } from "@cullit/config";
 import { getRecentTags } from "@cullit/core";
 import { writeFileSync, readFileSync, existsSync } from "fs";
 import { resolve } from "path";
+import { createInterface } from "readline";
 function loadEnv() {
   const envPath = resolve(process.cwd(), ".env");
   if (!existsSync(envPath)) return;
@@ -34,6 +35,7 @@ var HELP = `
 
   COMMANDS
     generate    Generate release notes from git, Jira, or Linear
+    status      Release readiness check \u2014 should you release?
     init        Create a .cullit.yml config file
     tags        List recent tags in the current repo
 
@@ -46,6 +48,8 @@ var HELP = `
     --provider    Override AI provider (anthropic, openai, gemini, ollama, openclaw, none)
     --source      Override source type (local, jira, linear)
     --audience    Override audience (developer, end-user, executive)
+    --verbose     Show detailed output
+    --quiet       Suppress all output except errors
 
   EXAMPLES
     $ cullit generate --from v1.0.0 --to v1.1.0
@@ -56,40 +60,6 @@ var HELP = `
     $ cullit generate --source linear --from "team:ENG" --provider openai
     $ cullit init
 `;
-var DEFAULT_YML = `# Cullit Configuration
-# https://cullit.io/docs/config
-
-ai:
-  provider: anthropic          # anthropic | openai | gemini | ollama | openclaw | none
-  # model: claude-sonnet-4-20250514  # optional: override default model
-  audience: developer          # developer | end-user | executive
-  tone: professional           # professional | casual | terse
-  categories: [features, fixes, breaking, improvements, chores]
-
-source:
-  type: local                  # local | jira | linear
-  # enrichment: [jira, linear] # uncomment to enable enrichment
-
-publish:
-  - type: stdout               # always output to terminal
-  # - type: file
-  #   path: RELEASE_NOTES.md
-  # - type: slack
-  #   webhook_url: $SLACK_WEBHOOK_URL
-  # - type: discord
-  #   webhook_url: $DISCORD_WEBHOOK_URL
-
-# jira:
-#   domain: yourcompany.atlassian.net
-#   # Set JIRA_EMAIL and JIRA_API_TOKEN in your environment
-
-# linear:
-#   # Set LINEAR_API_KEY in your environment
-
-# openclaw:
-#   baseUrl: http://localhost:18789  # OpenClaw gateway URL
-#   # Set OPENCLAW_TOKEN in your environment
-`;
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
@@ -98,13 +68,19 @@ async function main() {
     process.exit(0);
   }
   if (command === "--version" || command === "-v") {
-    console.log(`cull v${VERSION}`);
+    console.log(`cullit v${VERSION}`);
     process.exit(0);
   }
   if (command === "init") {
-    writeFileSync(".cullit.yml", DEFAULT_YML, "utf-8");
-    console.log("\u2713 Created .cullit.yml");
-    console.log("  Edit it to configure your AI provider, integrations, and publish targets.");
+    if (existsSync(".cullit.yml")) {
+      console.log("\u26A0 .cullit.yml already exists. Delete it first to re-initialize.");
+      process.exit(1);
+    }
+    await interactiveInit();
+    process.exit(0);
+  }
+  if (command === "status") {
+    printReleaseStatus();
     process.exit(0);
   }
   if (command === "tags") {
@@ -141,21 +117,191 @@ async function main() {
   process.exit(1);
 }
 async function runGenerate(from, to, opts) {
-  const config = loadConfig(opts.config || opts.c || process.cwd());
-  if (opts.provider) config.ai.provider = opts.provider;
-  if (opts.audience) config.ai.audience = opts.audience;
+  let config;
+  try {
+    config = loadConfig(opts.config || opts.c || process.cwd());
+  } catch (err) {
+    console.error(`
+\u2717 Config error: ${err.message}`);
+    console.error("  Fix your .cullit.yml or delete it to use defaults.");
+    process.exitCode = 1;
+    return;
+  }
+  const VALID_PROVIDERS = ["anthropic", "openai", "gemini", "ollama", "openclaw", "none"];
+  const VALID_AUDIENCES = ["developer", "end-user", "executive"];
+  const VALID_SOURCES = ["local", "jira", "linear"];
+  if (opts.provider) {
+    if (!VALID_PROVIDERS.includes(opts.provider)) {
+      console.error(`
+\u2717 Invalid provider: ${opts.provider}`);
+      console.error(`  Valid providers: ${VALID_PROVIDERS.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    config.ai.provider = opts.provider;
+  }
+  if (opts.audience) {
+    if (!VALID_AUDIENCES.includes(opts.audience)) {
+      console.error(`
+\u2717 Invalid audience: ${opts.audience}`);
+      console.error(`  Valid audiences: ${VALID_AUDIENCES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    config.ai.audience = opts.audience;
+  }
   if (opts.model) config.ai.model = opts.model;
-  if (opts.source) config.source.type = opts.source;
+  if (opts.source) {
+    if (!VALID_SOURCES.includes(opts.source)) {
+      console.error(`
+\u2717 Invalid source: ${opts.source}`);
+      console.error(`  Valid sources: ${VALID_SOURCES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    config.source.type = opts.source;
+  }
   const format = opts.format || "markdown";
   const dryRun = "dry-run" in opts || "dryRun" in opts;
+  const logLevel = "verbose" in opts ? "verbose" : "quiet" in opts ? "quiet" : "normal";
+  const logger = createLogger(logLevel);
+  const license = resolveLicense();
+  if (logLevel !== "quiet") {
+    const tierLabel = license.tier === "pro" ? "\u{1F511} Pro" : "\u{1F193} Free";
+    logger.info(`\xBB License: ${tierLabel}`);
+  }
   try {
-    const result = await runPipeline(from, to, config, { format, dryRun });
+    const result = await runPipeline(from, to, config, { format, dryRun, logger });
+    if (logLevel !== "quiet") {
+      try {
+        const advisory = analyzeReleaseReadiness();
+        if (advisory.shouldRelease && advisory.nextVersion) {
+          console.log(`
+  \u{1F4A1} Release advisory: ${advisory.reasons[0]}`);
+          console.log(`     Suggested: ${advisory.nextVersion} (${advisory.suggestedBump}) \u2014 ${advisory.commitCount} unreleased commit(s)`);
+          console.log(`     Run "cullit status" for full breakdown.
+`);
+        } else if (advisory.commitCount > 0 && advisory.daysSinceRelease !== null && advisory.daysSinceRelease > 7) {
+          console.log(`
+  \u{1F4A1} ${advisory.commitCount} unreleased commit(s), ${advisory.daysSinceRelease} days since last release. Run "cullit status" to check readiness.
+`);
+        }
+      } catch {
+      }
+    }
   } catch (err) {
     console.error(`
 \u2717 Error: ${err.message}`);
     process.exitCode = 1;
   }
 }
+function printReleaseStatus() {
+  const advisory = analyzeReleaseReadiness();
+  const bar = (count, max, char = "\u2588") => {
+    const width = Math.min(Math.round(count / Math.max(max, 1) * 20), 20);
+    return char.repeat(width) || "\xB7";
+  };
+  console.log(`
+  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+  \u2551  Cullit \u2014 Release Readiness               \u2551
+  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+  `);
+  if (!advisory.currentVersion) {
+    console.log("  No tags found. Create your first release with:");
+    console.log("    git tag v0.1.0 && git push --tags\n");
+    return;
+  }
+  const { breakdown, commitCount } = advisory;
+  const verdict = advisory.shouldRelease ? "\u{1F7E2} Yes \u2014 time to release" : "\u{1F7E1} Not yet \u2014 keep going";
+  console.log(`  Current version:   ${advisory.currentVersion}`);
+  if (advisory.nextVersion) {
+    console.log(`  Suggested next:    ${advisory.nextVersion} (${advisory.suggestedBump})`);
+  }
+  if (advisory.daysSinceRelease !== null) {
+    console.log(`  Last release:      ${advisory.daysSinceRelease} day(s) ago`);
+  }
+  console.log(`  Unreleased commits: ${commitCount}`);
+  console.log(`  Contributors:      ${advisory.contributorCount}`);
+  if (commitCount > 0) {
+    console.log("\n  Commit breakdown:");
+    const maxCount = Math.max(breakdown.features, breakdown.fixes, breakdown.breaking, breakdown.chores, breakdown.other, 1);
+    if (breakdown.features > 0) console.log(`    \u2728 Features:  ${bar(breakdown.features, maxCount)} ${breakdown.features}`);
+    if (breakdown.fixes > 0) console.log(`    \u{1F41B} Fixes:     ${bar(breakdown.fixes, maxCount)} ${breakdown.fixes}`);
+    if (breakdown.breaking > 0) console.log(`    \u26A0\uFE0F  Breaking:  ${bar(breakdown.breaking, maxCount)} ${breakdown.breaking}`);
+    if (breakdown.chores > 0) console.log(`    \u{1F9F9} Chores:    ${bar(breakdown.chores, maxCount)} ${breakdown.chores}`);
+    if (breakdown.other > 0) console.log(`    \u{1F4DD} Other:     ${bar(breakdown.other, maxCount)} ${breakdown.other}`);
+  }
+  console.log(`
+  Should you release? ${verdict}`);
+  if (advisory.reasons.length > 0) {
+    console.log("\n  Why:");
+    for (const reason of advisory.reasons) {
+      console.log(`    \u2192 ${reason}`);
+    }
+  }
+  if (advisory.shouldRelease && advisory.nextVersion) {
+    console.log(`
+  Quick release:`);
+    console.log(`    cullit generate --from ${advisory.currentVersion} --to HEAD`);
+    console.log(`    git tag ${advisory.nextVersion} && git push --tags`);
+  }
+  console.log("");
+}
+function ask(rl, question) {
+  return new Promise((resolve2) => rl.question(question, resolve2));
+}
+async function interactiveInit() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  console.log("\n  Cullit \u2014 Project Setup\n");
+  const provider = await ask(rl, "  AI provider (anthropic/openai/gemini/ollama/openclaw/none) [anthropic]: ") || "anthropic";
+  const source = await ask(rl, "  Source type (local/jira/linear) [local]: ") || "local";
+  const audience = await ask(rl, "  Audience (developer/end-user/executive) [developer]: ") || "developer";
+  const tone = await ask(rl, "  Tone (professional/casual/terse) [professional]: ") || "professional";
+  let enrichment = "";
+  if (source === "local") {
+    enrichment = await ask(rl, "  Enrich from (jira/linear/both/none) [none]: ") || "none";
+  }
+  rl.close();
+  const enrichmentLine = enrichment === "both" ? "\n  enrichment: [jira, linear]" : enrichment === "jira" || enrichment === "linear" ? `
+  enrichment: [${enrichment}]` : "";
+  const sections = [];
+  if (enrichment === "jira" || enrichment === "both" || source === "jira") {
+    sections.push(`
+jira:
+  domain: yourcompany.atlassian.net
+  # Set JIRA_EMAIL and JIRA_API_TOKEN in your environment`);
+  }
+  if (enrichment === "linear" || enrichment === "both" || source === "linear") {
+    sections.push(`
+linear:
+  # Set LINEAR_API_KEY in your environment`);
+  }
+  const yml = `# Cullit Configuration
+# https://cullit.io
+
+ai:
+  provider: ${provider}
+  audience: ${audience}
+  tone: ${tone}
+  categories: [features, fixes, breaking, improvements, chores]
+
+source:
+  type: ${source}${enrichmentLine}
+
+publish:
+  - type: stdout
+  # - type: file
+  #   path: RELEASE_NOTES.md
+  # - type: slack
+  #   webhook_url: $SLACK_WEBHOOK_URL
+  # - type: discord
+  #   webhook_url: $DISCORD_WEBHOOK_URL
+${sections.join("\n")}
+`;
+  writeFileSync(".cullit.yml", yml, "utf-8");
+  console.log("\n  \u2713 Created .cullit.yml");
+  console.log('  Run "cullit generate --from <tag>" to generate release notes.\n');
+}
 function parseArgs(args) {
   const result = {};
   for (let i = 0; i < args.length; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cullit",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Cull the noise from your releases. AI-powered release notes from the CLI.",
   "license": "MIT",
@@ -25,9 +25,12 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
-    "@cullit/core": "0.1.0",
-    "@cullit/config": "0.1.0"
+    "@cullit/core": "0.3.0",
+    "@cullit/config": "0.3.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean",