cullit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cullit (Matt)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { runPipeline, VERSION } from "@cullit/core";
+import { loadConfig } from "@cullit/config";
+import { getRecentTags } from "@cullit/core";
+import { writeFileSync, readFileSync, existsSync } from "fs";
+import { resolve } from "path";
+function loadEnv() {
+  const envPath = resolve(process.cwd(), ".env");
+  if (!existsSync(envPath)) return;
+  const content = readFileSync(envPath, "utf-8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const val = trimmed.slice(eqIndex + 1).trim().replace(/^["']|["']$/g, "");
+    if (key && val && !process.env[key]) {
+      process.env[key] = val;
+    }
+  }
+}
+loadEnv();
+var HELP = `
+  \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 v${VERSION}                           \u2551
+  \u2551  Cull the noise from your releases.     \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
+
+  USAGE
+    $ cullit <command> [options]
+
+  COMMANDS
+    generate    Generate release notes from git, Jira, or Linear
+    init        Create a .cullit.yml config file
+    tags        List recent tags in the current repo
+
+  OPTIONS (generate)
+    --from, -f    Start ref, JQL query, or Linear filter
+    --to, -t      End ref (defaults to HEAD)
+    --config, -c  Path to config file (default: .cullit.yml)
+    --format      Output format: markdown, html, json (default: markdown)
+    --dry-run     Generate but don't publish
+    --provider    Override AI provider (anthropic, openai, gemini, ollama, openclaw, none)
+    --source      Override source type (local, jira, linear)
+    --audience    Override audience (developer, end-user, executive)
+
+  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 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];
+  if (!command || command === "--help" || command === "-h") {
+    console.log(HELP);
+    process.exit(0);
+  }
+  if (command === "--version" || command === "-v") {
+    console.log(`cull 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.");
+    process.exit(0);
+  }
+  if (command === "tags") {
+    const tags = getRecentTags(process.cwd(), 20);
+    if (tags.length === 0) {
+      console.log("No tags found in this repository.");
+    } else {
+      console.log("Recent tags:");
+      tags.forEach((t, i) => console.log(`  ${i === 0 ? "\u2192" : " "} ${t}`));
+    }
+    process.exit(0);
+  }
+  if (command === "generate") {
+    const opts = parseArgs(args.slice(1));
+    const from = opts.from || opts.f;
+    let to = opts.to || opts.t || "HEAD";
+    if (!from) {
+      const tags = getRecentTags();
+      if (tags.length >= 2) {
+        console.log(`\xBB Auto-detected: generating notes from ${tags[1]} to ${tags[0]}`);
+        const autoFrom = tags[1];
+        to = tags[0];
+        return await runGenerate(autoFrom, to, opts);
+      }
+      console.error("Error: --from is required. Specify a tag, branch, or commit SHA.");
+      console.error("  Example: cullit generate --from v1.0.0 --to v1.1.0");
+      console.error('  Run "cullit tags" to see available tags.');
+      process.exit(1);
+    }
+    return await runGenerate(from, to, opts);
+  }
+  console.error(`Unknown command: ${command}`);
+  console.log(HELP);
+  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;
+  if (opts.model) config.ai.model = opts.model;
+  if (opts.source) config.source.type = opts.source;
+  const format = opts.format || "markdown";
+  const dryRun = "dry-run" in opts || "dryRun" in opts;
+  try {
+    const result = await runPipeline(from, to, config, { format, dryRun });
+  } catch (err) {
+    console.error(`
+\u2717 Error: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+function parseArgs(args) {
+  const result = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("--")) {
+      const key = arg.substring(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("-")) {
+        result[key] = next;
+        i++;
+      } else {
+        result[key] = "true";
+      }
+    } else if (arg.startsWith("-") && arg.length === 2) {
+      const key = arg.substring(1);
+      const next = args[i + 1];
+      if (next && !next.startsWith("-")) {
+        result[key] = next;
+        i++;
+      } else {
+        result[key] = "true";
+      }
+    }
+  }
+  return result;
+}
+main().catch((err) => {
+  console.error(`Fatal: ${err.message}`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "cullit",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Cull the noise from your releases. AI-powered release notes from the CLI.",
+  "license": "MIT",
+  "author": "Cullit <matt@cullit.io>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mttaylor/cullit",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "release-notes",
+    "changelog",
+    "ai",
+    "cli",
+    "devops",
+    "automation"
+  ],
+  "bin": {
+    "cullit": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@cullit/core": "0.1.0",
+    "@cullit/config": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsup src/index.ts --format esm --watch"
+  }
+}