@cullit/config 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+type AIProvider = 'anthropic' | 'openai' | 'gemini' | 'ollama' | 'openclaw' | 'none';
+type Audience = 'developer' | 'end-user' | 'executive';
+type Tone = 'professional' | 'casual' | 'terse';
+type OutputFormat = 'markdown' | 'html' | 'json';
+type PublisherType = 'stdout' | 'github-release' | 'slack' | 'discord' | 'file';
+type EnrichmentType = 'jira' | 'linear';
+interface AIConfig {
+    provider: AIProvider;
+    model?: string;
+    apiKey?: string;
+    audience: Audience;
+    tone: Tone;
+    categories: string[];
+    maxTokens?: number;
+}
+interface SourceConfig {
+    type: 'local' | 'jira' | 'linear';
+    owner?: string;
+    repo?: string;
+    enrichment?: EnrichmentType[];
+}
+interface PublishTarget {
+    type: PublisherType;
+    channel?: string;
+    webhookUrl?: string;
+    path?: string;
+}
+interface JiraConfig {
+    domain: string;
+    email?: string;
+    apiToken?: string;
+}
+interface LinearConfig {
+    apiKey?: string;
+}
+interface OpenClawConfig {
+    baseUrl?: string;
+    token?: string;
+}
+interface CullConfig {
+    ai: AIConfig;
+    source: SourceConfig;
+    publish: PublishTarget[];
+    jira?: JiraConfig;
+    linear?: LinearConfig;
+    openclaw?: OpenClawConfig;
+}
+
+/**
+ * Loads config from .cullit.yml in the project root.
+ * Falls back to sensible defaults.
+ * Resolves environment variable references ($ENV_VAR syntax).
+ */
+declare function loadConfig(cwdOrPath?: string): CullConfig;
+
+export { type AIConfig, type AIProvider, type Audience, type CullConfig, type EnrichmentType, type JiraConfig, type LinearConfig, type OpenClawConfig, type OutputFormat, type PublishTarget, type PublisherType, type SourceConfig, type Tone, loadConfig };

package/dist/index.js

@@ -1,33 +1,28 @@
 // src/index.ts
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
+var DEFAULT_CATEGORIES = ["features", "fixes", "breaking", "improvements", "chores"];
 var DEFAULT_CONFIG = {
   ai: {
     provider: "anthropic",
     audience: "developer",
     tone: "professional",
-    categories: ["features", "fixes", "breaking", "improvements", "chores"]
+    categories: DEFAULT_CATEGORIES
   },
   source: {
     type: "local"
   },
   publish: [{ type: "stdout" }]
 };
-function loadConfig(cwd = process.cwd()) {
-  const configPath = join(cwd, ".cullit.yml");
+function loadConfig(cwdOrPath = process.cwd()) {
+  const configPath = cwdOrPath.endsWith(".yml") || cwdOrPath.endsWith(".yaml") ? cwdOrPath : join(cwdOrPath, ".cullit.yml");
   if (!existsSync(configPath)) {
     return DEFAULT_CONFIG;
   }
-  try {
-    const raw = readFileSync(configPath, "utf-8");
-    const parsed = parseSimpleYaml(raw);
-    const resolved = resolveEnvVars(parsed);
-    return mergeWithDefaults(resolved);
-  } catch (err) {
-    console.warn(`\u26A0 Could not parse .cullit.yml: ${err.message}`);
-    console.warn("Using default configuration.");
-    return DEFAULT_CONFIG;
-  }
+  const raw = readFileSync(configPath, "utf-8");
+  const parsed = parseSimpleYaml(raw);
+  const resolved = resolveEnvVars(parsed);
+  return mergeWithDefaults(resolved);
 }
 function parseSimpleYaml(raw) {
   const result = {};
@@ -106,6 +101,10 @@ function parseSimpleYaml(raw) {
   return result;
 }
 function parseValue(val) {
+  if (!val.startsWith('"') && !val.startsWith("'") && !val.startsWith("[")) {
+    const commentIdx = val.indexOf(" #");
+    if (commentIdx > 0) val = val.substring(0, commentIdx).trim();
+  }
   if (val === "true") return true;
   if (val === "false") return false;
   if (val === "null") return null;
@@ -143,12 +142,21 @@ function mergeWithDefaults(parsed) {
       ...DEFAULT_CONFIG.source,
       ...parsed.source || {}
     },
-    publish: parsed.publish || DEFAULT_CONFIG.publish,
+    publish: normalizePublishTargets(parsed.publish || DEFAULT_CONFIG.publish),
     jira: parsed.jira,
     linear: parsed.linear,
     openclaw: parsed.openclaw
   };
 }
+function normalizePublishTargets(targets) {
+  return targets.map((t) => {
+    const normalized = { type: t.type };
+    if (t.webhookUrl || t.webhook_url) normalized.webhookUrl = t.webhookUrl || t.webhook_url;
+    if (t.channel) normalized.channel = t.channel;
+    if (t.path) normalized.path = t.path;
+    return normalized;
+  });
+}
 export {
   loadConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cullit/config",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Config loader for Cullit — YAML config parsing with env var resolution.",
   "license": "MIT",
@@ -21,8 +21,11 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --clean",
+    "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts --format esm --watch"
   }
 }