squads-cli 0.2.0 → 0.2.1

package/dist/chunk-QJ7C7CMB.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+
+// src/version.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
+var version = pkg.version;
+
+// src/lib/telemetry.ts
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir, platform, release } from "os";
+import { randomUUID } from "crypto";
+var TELEMETRY_DIR = join(homedir(), ".squads-cli");
+var CONFIG_PATH = join(TELEMETRY_DIR, "telemetry.json");
+var EVENTS_PATH = join(TELEMETRY_DIR, "events.json");
+var TELEMETRY_ENDPOINT = process.env.SQUADS_TELEMETRY_ENDPOINT || Buffer.from(
+  "aHR0cHM6Ly9zcXVhZHMtdGVsZW1ldHJ5LTk3ODg3MTgxNzYxMC51cy1jZW50cmFsMS5ydW4uYXBwL3Bpbmc=",
+  "base64"
+).toString();
+var TELEMETRY_KEY = process.env.SQUADS_TELEMETRY_KEY || "";
+var eventQueue = [];
+var flushScheduled = false;
+var cachedSystemContext = null;
+function detectUserType() {
+  if (process.env.SQUADS_AGENT) {
+    return "agent";
+  }
+  if (process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true" || process.env.GITLAB_CI === "true" || process.env.JENKINS_URL || process.env.BUILDKITE === "true" || process.env.CIRCLECI === "true" || process.env.AZURE_PIPELINES === "true" || process.env.TF_BUILD === "True") {
+    return "ci";
+  }
+  return "human";
+}
+function getSystemContext() {
+  if (cachedSystemContext) return cachedSystemContext;
+  cachedSystemContext = {
+    os: platform(),
+    // darwin, linux, win32
+    osVersion: release(),
+    nodeVersion: process.version,
+    shell: process.env.SHELL?.split("/").pop() || process.env.ComSpec?.split("\\").pop(),
+    terminal: process.env.TERM_PROGRAM || void 0,
+    ci: process.env.CI === "true" ? "true" : void 0,
+    userType: detectUserType(),
+    // Agent context (set by squads run)
+    squad: process.env.SQUADS_SQUAD || void 0,
+    agent: process.env.SQUADS_AGENT || void 0,
+    executionId: process.env.SQUADS_EXECUTION_ID || void 0
+  };
+  return cachedSystemContext;
+}
+function ensureDir() {
+  if (!existsSync(TELEMETRY_DIR)) {
+    mkdirSync(TELEMETRY_DIR, { recursive: true });
+  }
+}
+function getConfig() {
+  ensureDir();
+  if (!existsSync(CONFIG_PATH)) {
+    const config = {
+      enabled: true,
+      // Opt-out by default (common for CLIs)
+      anonymousId: randomUUID(),
+      firstRun: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+    return config;
+  }
+  try {
+    return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+  } catch {
+    return { enabled: false, anonymousId: "", firstRun: "" };
+  }
+}
+function isEnabled() {
+  if (process.env.SQUADS_TELEMETRY_DISABLED === "1") {
+    return false;
+  }
+  if (process.env.DO_NOT_TRACK === "1") {
+    return false;
+  }
+  return getConfig().enabled;
+}
+async function track(event, properties) {
+  if (!isEnabled()) return;
+  const config = getConfig();
+  const telemetryEvent = {
+    event,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    properties: {
+      ...properties,
+      ...getSystemContext(),
+      anonymousId: config.anonymousId,
+      cliVersion: version
+    }
+  };
+  storeEventLocally(telemetryEvent);
+  eventQueue.push(telemetryEvent);
+  if (TELEMETRY_ENDPOINT && !flushScheduled) {
+    flushScheduled = true;
+    setImmediate(() => {
+      flushEvents().catch(() => {
+      });
+    });
+  }
+}
+async function flushEvents() {
+  if (!TELEMETRY_ENDPOINT || !TELEMETRY_KEY || eventQueue.length === 0) {
+    flushScheduled = false;
+    return;
+  }
+  const batch = [...eventQueue];
+  eventQueue = [];
+  flushScheduled = false;
+  try {
+    await fetch(TELEMETRY_ENDPOINT, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Squads-Key": TELEMETRY_KEY
+      },
+      body: JSON.stringify({ events: batch }),
+      signal: AbortSignal.timeout(5e3)
+    });
+  } catch {
+    eventQueue = [...batch, ...eventQueue].slice(-100);
+  }
+}
+function storeEventLocally(event) {
+  ensureDir();
+  let events = [];
+  if (existsSync(EVENTS_PATH)) {
+    try {
+      events = JSON.parse(readFileSync(EVENTS_PATH, "utf-8"));
+    } catch {
+      events = [];
+    }
+  }
+  events.push(event);
+  if (events.length > 1e3) {
+    events = events.slice(-1e3);
+  }
+  writeFileSync(EVENTS_PATH, JSON.stringify(events, null, 2));
+}
+var Events = {
+  // Lifecycle
+  CLI_INIT: "cli.init",
+  CLI_ERROR: "cli.error",
+  // Commands
+  CLI_RUN: "cli.run",
+  CLI_STATUS: "cli.status",
+  CLI_DASHBOARD: "cli.dashboard",
+  CLI_WORKERS: "cli.workers",
+  CLI_TONIGHT: "cli.tonight",
+  CLI_CONTEXT: "cli.context",
+  CLI_COST: "cli.cost",
+  CLI_EXEC: "cli.exec",
+  CLI_BASELINE: "cli.baseline",
+  // Goals
+  CLI_GOAL_SET: "cli.goal.set",
+  CLI_GOAL_LIST: "cli.goal.list",
+  CLI_GOAL_COMPLETE: "cli.goal.complete",
+  CLI_GOAL_PROGRESS: "cli.goal.progress",
+  // Memory
+  CLI_MEMORY_QUERY: "cli.memory.query",
+  CLI_MEMORY_SHOW: "cli.memory.show",
+  CLI_MEMORY_UPDATE: "cli.memory.update",
+  CLI_MEMORY_LIST: "cli.memory.list",
+  CLI_MEMORY_SYNC: "cli.memory.sync",
+  // Feedback
+  CLI_FEEDBACK_ADD: "cli.feedback.add",
+  CLI_FEEDBACK_SHOW: "cli.feedback.show",
+  CLI_FEEDBACK_STATS: "cli.feedback.stats",
+  // Learnings
+  CLI_LEARN: "cli.learn",
+  CLI_LEARN_SHOW: "cli.learn.show",
+  CLI_LEARN_SEARCH: "cli.learn.search",
+  // Auth
+  CLI_LOGIN: "cli.login",
+  CLI_LOGOUT: "cli.logout",
+  // Providers
+  CLI_PROVIDERS: "cli.providers",
+  // KPIs
+  CLI_KPI_SHOW: "cli.kpi.show",
+  CLI_KPI_RECORD: "cli.kpi.record",
+  CLI_KPI_TREND: "cli.kpi.trend",
+  CLI_KPI_INSIGHTS: "cli.kpi.insights",
+  CLI_KPI_LIST: "cli.kpi.list",
+  // Cycle Sync
+  CLI_SYNC_CYCLE: "cli.sync.cycle",
+  // Context Condenser
+  CONDENSER_COMPRESS: "condenser.compress",
+  CONDENSER_DEDUPE: "condenser.dedupe",
+  CONDENSER_PRUNE: "condenser.prune",
+  CONDENSER_SUMMARIZE: "condenser.summarize"
+};
+var exitHandlerRegistered = false;
+function registerExitHandler() {
+  if (exitHandlerRegistered) return;
+  exitHandlerRegistered = true;
+  process.on("beforeExit", async () => {
+    if (eventQueue.length > 0) {
+      await flushEvents();
+    }
+  });
+  const signalHandler = async (_signal) => {
+    if (eventQueue.length > 0) {
+      await flushEvents();
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", () => signalHandler("SIGINT"));
+  process.on("SIGTERM", () => signalHandler("SIGTERM"));
+}
+
+export {
+  version,
+  track,
+  flushEvents,
+  Events,
+  registerExitHandler
+};
+//# sourceMappingURL=chunk-QJ7C7CMB.js.map

package/dist/chunk-QJ7C7CMB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts","../src/lib/telemetry.ts"],"sourcesContent":["import { createRequire } from 'module';\nconst require = createRequire(import.meta.url);\nconst pkg = require('../package.json');\nexport const version: string = pkg.version;\n","import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport { join } from 'path';\nimport { homedir, platform, release } from 'os';\nimport { randomUUID } from 'crypto';\nimport { version as cliVersion } from '../version.js';\n\ninterface TelemetryEvent {\n  event: string;\n  timestamp: string;\n  properties?: Record<string, string | number | boolean | undefined>;\n}\n\ninterface TelemetryConfig {\n  enabled: boolean;\n  anonymousId: string;\n  firstRun: string;\n}\n\nconst TELEMETRY_DIR = join(homedir(), '.squads-cli');\nconst CONFIG_PATH = join(TELEMETRY_DIR, 'telemetry.json');\nconst EVENTS_PATH = join(TELEMETRY_DIR, 'events.json');\n\n// Telemetry endpoint - locked to Agents Squads infrastructure\n// Users can opt-out but cannot redirect telemetry\nconst TELEMETRY_ENDPOINT = process.env.SQUADS_TELEMETRY_ENDPOINT || Buffer.from(\n  'aHR0cHM6Ly9zcXVhZHMtdGVsZW1ldHJ5LTk3ODg3MTgxNzYxMC51cy1jZW50cmFsMS5ydW4uYXBwL3Bpbmc=',\n  'base64'\n).toString();\n\n// API key for endpoint validation — must be set via environment variable\n// NEVER hardcode API keys in source (see: engineering#51)\nconst TELEMETRY_KEY = process.env.SQUADS_TELEMETRY_KEY || '';\n\n// Event queue for batch flushing\nlet eventQueue: TelemetryEvent[] = [];\nlet flushScheduled = false;\n\n// Cached system context (computed once per session)\nlet cachedSystemContext: Record<string, string | undefined> | null = null;\n\n/**\n * Detect user type for segmentation.\n * - 'agent': Autonomous agent execution (via squads run)\n * - 'ci': CI/CD environment (GitHub Actions, Azure Pipelines, etc)\n * - 'human': Interactive terminal usage\n */\nfunction detectUserType(): 'human' | 'agent' | 'ci' {\n  // Agent execution (set by squads run command)\n  // SQUADS_AGENT contains the agent name when running via squads run\n  if (process.env.SQUADS_AGENT) {\n    return 'agent';\n  }\n\n  // CI/CD environments\n  if (\n    process.env.CI === 'true' ||\n    process.env.GITHUB_ACTIONS === 'true' ||\n    process.env.GITLAB_CI === 'true' ||\n    process.env.JENKINS_URL ||\n    process.env.BUILDKITE === 'true' ||\n    process.env.CIRCLECI === 'true' ||\n    process.env.AZURE_PIPELINES === 'true' ||\n    process.env.TF_BUILD === 'True'\n  ) {\n    return 'ci';\n  }\n\n  return 'human';\n}\n\n/**\n * Get minimal system context for error identification.\n * Computed once per session for performance.\n */\nfunction getSystemContext(): Record<string, string | undefined> {\n  if (cachedSystemContext) return cachedSystemContext;\n\n  cachedSystemContext = {\n    os: platform(), // darwin, linux, win32\n    osVersion: release(),\n    nodeVersion: process.version,\n    shell: process.env.SHELL?.split('/').pop() || process.env.ComSpec?.split('\\\\').pop(),\n    terminal: process.env.TERM_PROGRAM || undefined,\n    ci: process.env.CI === 'true' ? 'true' : undefined,\n    userType: detectUserType(),\n    // Agent context (set by squads run)\n    squad: process.env.SQUADS_SQUAD || undefined,\n    agent: process.env.SQUADS_AGENT || undefined,\n    executionId: process.env.SQUADS_EXECUTION_ID || undefined,\n  };\n\n  return cachedSystemContext;\n}\n\nfunction ensureDir(): void {\n  if (!existsSync(TELEMETRY_DIR)) {\n    mkdirSync(TELEMETRY_DIR, { recursive: true });\n  }\n}\n\nfunction getConfig(): TelemetryConfig {\n  ensureDir();\n\n  if (!existsSync(CONFIG_PATH)) {\n    const config: TelemetryConfig = {\n      enabled: true, // Opt-out by default (common for CLIs)\n      anonymousId: randomUUID(),\n      firstRun: new Date().toISOString(),\n    };\n    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));\n    return config;\n  }\n\n  try {\n    return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));\n  } catch {\n    return { enabled: false, anonymousId: '', firstRun: '' };\n  }\n}\n\nfunction saveConfig(config: TelemetryConfig): void {\n  ensureDir();\n  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));\n}\n\n/**\n * Check if telemetry is enabled.\n * Telemetry is disabled if SQUADS_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1.\n * @returns true if telemetry collection is enabled\n */\nexport function isEnabled(): boolean {\n  // Check environment variable first (allows CI/testing override)\n  if (process.env.SQUADS_TELEMETRY_DISABLED === '1') {\n    return false;\n  }\n  if (process.env.DO_NOT_TRACK === '1') {\n    return false;\n  }\n\n  return getConfig().enabled;\n}\n\n/**\n * Enable telemetry collection.\n * Persists the setting to ~/.squads-cli/telemetry.json\n */\nexport function enable(): void {\n  const config = getConfig();\n  config.enabled = true;\n  saveConfig(config);\n}\n\n/**\n * Disable telemetry collection.\n * Persists the setting to ~/.squads-cli/telemetry.json\n */\nexport function disable(): void {\n  const config = getConfig();\n  config.enabled = false;\n  saveConfig(config);\n}\n\n/**\n * Get the anonymous identifier for this CLI installation.\n * Generated once on first run and persisted.\n * @returns UUID string\n */\nexport function getAnonymousId(): string {\n  return getConfig().anonymousId;\n}\n\n/**\n * Track a telemetry event with optional properties.\n * Events are batched and flushed asynchronously.\n * @param event - Event name (e.g., 'cli.status', 'cli.error')\n * @param properties - Optional key-value pairs of event metadata\n */\nexport async function track(event: string, properties?: Record<string, string | number | boolean | undefined>): Promise<void> {\n  if (!isEnabled()) return;\n\n  const config = getConfig();\n\n  const telemetryEvent: TelemetryEvent = {\n    event,\n    timestamp: new Date().toISOString(),\n    properties: {\n      ...properties,\n      ...getSystemContext(),\n      anonymousId: config.anonymousId,\n      cliVersion,\n    },\n  };\n\n  // Store locally (for debugging/review)\n  storeEventLocally(telemetryEvent);\n\n  // Queue for batch sending\n  eventQueue.push(telemetryEvent);\n\n  // Schedule flush if not already scheduled\n  if (TELEMETRY_ENDPOINT && !flushScheduled) {\n    flushScheduled = true;\n    // Flush on next tick to batch events from same command\n    setImmediate(() => {\n      flushEvents().catch(() => {});\n    });\n  }\n}\n\n/**\n * Flush queued events to the telemetry endpoint\n */\nexport async function flushEvents(): Promise<void> {\n  if (!TELEMETRY_ENDPOINT || !TELEMETRY_KEY || eventQueue.length === 0) {\n    flushScheduled = false;\n    return;\n  }\n\n  const batch = [...eventQueue];\n  eventQueue = [];\n  flushScheduled = false;\n\n  try {\n    await fetch(TELEMETRY_ENDPOINT, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Squads-Key': TELEMETRY_KEY,\n      },\n      body: JSON.stringify({ events: batch }),\n      signal: AbortSignal.timeout(5000),\n    });\n  } catch {\n    // Restore events on failure (will retry on next track)\n    eventQueue = [...batch, ...eventQueue].slice(-100); // Keep max 100\n  }\n}\n\n/**\n * Track an error event\n */\nexport async function trackError(\n  command: string,\n  error: Error,\n  context?: Record<string, string | number | boolean>\n): Promise<void> {\n  await track(Events.CLI_ERROR, {\n    command,\n    errorType: error.constructor.name,\n    errorMessage: error.message.slice(0, 100), // Truncate for privacy\n    ...context,\n  });\n}\n\n/**\n * Wrap an async command function with telemetry\n */\nexport function instrumentCommand<T>(\n  name: string,\n  fn: () => Promise<T>\n): () => Promise<T> {\n  return async () => {\n    const start = Date.now();\n    try {\n      const result = await fn();\n      await track(`cli.${name}`, {\n        durationMs: Date.now() - start,\n        success: true,\n      });\n      return result;\n    } catch (error) {\n      await trackError(name, error as Error, {\n        durationMs: Date.now() - start,\n      });\n      throw error;\n    }\n  };\n}\n\nfunction storeEventLocally(event: TelemetryEvent): void {\n  ensureDir();\n\n  let events: TelemetryEvent[] = [];\n\n  if (existsSync(EVENTS_PATH)) {\n    try {\n      events = JSON.parse(readFileSync(EVENTS_PATH, 'utf-8'));\n    } catch {\n      events = [];\n    }\n  }\n\n  // Keep last 1000 events\n  events.push(event);\n  if (events.length > 1000) {\n    events = events.slice(-1000);\n  }\n\n  writeFileSync(EVENTS_PATH, JSON.stringify(events, null, 2));\n}\n\n/**\n * Pre-defined event names for consistency across the CLI.\n * Use these constants instead of string literals.\n */\nexport const Events = {\n  // Lifecycle\n  CLI_INIT: 'cli.init',\n  CLI_ERROR: 'cli.error',\n\n  // Commands\n  CLI_RUN: 'cli.run',\n  CLI_STATUS: 'cli.status',\n  CLI_DASHBOARD: 'cli.dashboard',\n  CLI_WORKERS: 'cli.workers',\n  CLI_TONIGHT: 'cli.tonight',\n  CLI_CONTEXT: 'cli.context',\n  CLI_COST: 'cli.cost',\n  CLI_EXEC: 'cli.exec',\n  CLI_BASELINE: 'cli.baseline',\n\n  // Goals\n  CLI_GOAL_SET: 'cli.goal.set',\n  CLI_GOAL_LIST: 'cli.goal.list',\n  CLI_GOAL_COMPLETE: 'cli.goal.complete',\n  CLI_GOAL_PROGRESS: 'cli.goal.progress',\n\n  // Memory\n  CLI_MEMORY_QUERY: 'cli.memory.query',\n  CLI_MEMORY_SHOW: 'cli.memory.show',\n  CLI_MEMORY_UPDATE: 'cli.memory.update',\n  CLI_MEMORY_LIST: 'cli.memory.list',\n  CLI_MEMORY_SYNC: 'cli.memory.sync',\n\n  // Feedback\n  CLI_FEEDBACK_ADD: 'cli.feedback.add',\n  CLI_FEEDBACK_SHOW: 'cli.feedback.show',\n  CLI_FEEDBACK_STATS: 'cli.feedback.stats',\n\n  // Learnings\n  CLI_LEARN: 'cli.learn',\n  CLI_LEARN_SHOW: 'cli.learn.show',\n  CLI_LEARN_SEARCH: 'cli.learn.search',\n\n  // Auth\n  CLI_LOGIN: 'cli.login',\n  CLI_LOGOUT: 'cli.logout',\n\n  // Providers\n  CLI_PROVIDERS: 'cli.providers',\n\n  // KPIs\n  CLI_KPI_SHOW: 'cli.kpi.show',\n  CLI_KPI_RECORD: 'cli.kpi.record',\n  CLI_KPI_TREND: 'cli.kpi.trend',\n  CLI_KPI_INSIGHTS: 'cli.kpi.insights',\n  CLI_KPI_LIST: 'cli.kpi.list',\n\n  // Cycle Sync\n  CLI_SYNC_CYCLE: 'cli.sync.cycle',\n\n  // Context Condenser\n  CONDENSER_COMPRESS: 'condenser.compress',\n  CONDENSER_DEDUPE: 'condenser.dedupe',\n  CONDENSER_PRUNE: 'condenser.prune',\n  CONDENSER_SUMMARIZE: 'condenser.summarize',\n} as const;\n\n/**\n * Track command execution time.\n * Call at start of command, returns function to call when command completes.\n * @param command - Command name (without 'cli.' prefix)\n * @returns Callback to invoke when command completes\n * @example\n * const done = trackCommand('status');\n * // ... execute command ...\n * done(); // Records duration\n */\nexport function trackCommand(command: string): () => void {\n  const start = Date.now();\n\n  return () => {\n    const duration = Date.now() - start;\n    track(`cli.${command}`, { durationMs: duration });\n  };\n}\n\n// Register exit handler to flush remaining events\nlet exitHandlerRegistered = false;\n\n/**\n * Register process exit handlers to flush pending telemetry events.\n * Call once at CLI startup. Handles SIGINT, SIGTERM, and normal exit.\n */\nexport function registerExitHandler(): void {\n  if (exitHandlerRegistered) return;\n  exitHandlerRegistered = true;\n\n  // beforeExit allows async operations (unlike 'exit')\n  process.on('beforeExit', async () => {\n    if (eventQueue.length > 0) {\n      await flushEvents();\n    }\n  });\n\n  // For signals, we need to handle manually\n  const signalHandler = async (_signal: string) => {\n    if (eventQueue.length > 0) {\n      await flushEvents();\n    }\n    process.exit(0);\n  };\n\n  process.on('SIGINT', () => signalHandler('SIGINT'));\n  process.on('SIGTERM', () => signalHandler('SIGTERM'));\n}\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAC9B,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,MAAMA,SAAQ,iBAAiB;AAC9B,IAAM,UAAkB,IAAI;;;ACHnC,SAAS,YAAY,cAAc,eAAe,iBAAiB;AACnE,SAAS,YAAY;AACrB,SAAS,SAAS,UAAU,eAAe;AAC3C,SAAS,kBAAkB;AAe3B,IAAM,gBAAgB,KAAK,QAAQ,GAAG,aAAa;AACnD,IAAM,cAAc,KAAK,eAAe,gBAAgB;AACxD,IAAM,cAAc,KAAK,eAAe,aAAa;AAIrD,IAAM,qBAAqB,QAAQ,IAAI,6BAA6B,OAAO;AAAA,EACzE;AAAA,EACA;AACF,EAAE,SAAS;AAIX,IAAM,gBAAgB,QAAQ,IAAI,wBAAwB;AAG1D,IAAI,aAA+B,CAAC;AACpC,IAAI,iBAAiB;AAGrB,IAAI,sBAAiE;AAQrE,SAAS,iBAA2C;AAGlD,MAAI,QAAQ,IAAI,cAAc;AAC5B,WAAO;AAAA,EACT;AAGA,MACE,QAAQ,IAAI,OAAO,UACnB,QAAQ,IAAI,mBAAmB,UAC/B,QAAQ,IAAI,cAAc,UAC1B,QAAQ,IAAI,eACZ,QAAQ,IAAI,cAAc,UAC1B,QAAQ,IAAI,aAAa,UACzB,QAAQ,IAAI,oBAAoB,UAChC,QAAQ,IAAI,aAAa,QACzB;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAMA,SAAS,mBAAuD;AAC9D,MAAI,oBAAqB,QAAO;AAEhC,wBAAsB;AAAA,IACpB,IAAI,SAAS;AAAA;AAAA,IACb,WAAW,QAAQ;AAAA,IACnB,aAAa,QAAQ;AAAA,IACrB,OAAO,QAAQ,IAAI,OAAO,MAAM,GAAG,EAAE,IAAI,KAAK,QAAQ,IAAI,SAAS,MAAM,IAAI,EAAE,IAAI;AAAA,IACnF,UAAU,QAAQ,IAAI,gBAAgB;AAAA,IACtC,IAAI,QAAQ,IAAI,OAAO,SAAS,SAAS;AAAA,IACzC,UAAU,eAAe;AAAA;AAAA,IAEzB,OAAO,QAAQ,IAAI,gBAAgB;AAAA,IACnC,OAAO,QAAQ,IAAI,gBAAgB;AAAA,IACnC,aAAa,QAAQ,IAAI,uBAAuB;AAAA,EAClD;AAEA,SAAO;AACT;AAEA,SAAS,YAAkB;AACzB,MAAI,CAAC,WAAW,aAAa,GAAG;AAC9B,cAAU,eAAe,EAAE,WAAW,KAAK,CAAC;AAAA,EAC9C;AACF;AAEA,SAAS,YAA6B;AACpC,YAAU;AAEV,MAAI,CAAC,WAAW,WAAW,GAAG;AAC5B,UAAM,SAA0B;AAAA,MAC9B,SAAS;AAAA;AAAA,MACT,aAAa,WAAW;AAAA,MACxB,WAAU,oBAAI,KAAK,GAAE,YAAY;AAAA,IACnC;AACA,kBAAc,aAAa,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAC1D,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,KAAK,MAAM,aAAa,aAAa,OAAO,CAAC;AAAA,EACtD,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,aAAa,IAAI,UAAU,GAAG;AAAA,EACzD;AACF;AAYO,SAAS,YAAqB;AAEnC,MAAI,QAAQ,IAAI,8BAA8B,KAAK;AACjD,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,IAAI,iBAAiB,KAAK;AACpC,WAAO;AAAA,EACT;AAEA,SAAO,UAAU,EAAE;AACrB;AAqCA,eAAsB,MAAM,OAAe,YAAmF;AAC5H,MAAI,CAAC,UAAU,EAAG;AAElB,QAAM,SAAS,UAAU;AAEzB,QAAM,iBAAiC;AAAA,IACrC;AAAA,IACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,YAAY;AAAA,MACV,GAAG;AAAA,MACH,GAAG,iBAAiB;AAAA,MACpB,aAAa,OAAO;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAGA,oBAAkB,cAAc;AAGhC,aAAW,KAAK,cAAc;AAG9B,MAAI,sBAAsB,CAAC,gBAAgB;AACzC,qBAAiB;AAEjB,iBAAa,MAAM;AACjB,kBAAY,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IAC9B,CAAC;AAAA,EACH;AACF;AAKA,eAAsB,cAA6B;AACjD,MAAI,CAAC,sBAAsB,CAAC,iBAAiB,WAAW,WAAW,GAAG;AACpE,qBAAiB;AACjB;AAAA,EACF;AAEA,QAAM,QAAQ,CAAC,GAAG,UAAU;AAC5B,eAAa,CAAC;AACd,mBAAiB;AAEjB,MAAI;AACF,UAAM,MAAM,oBAAoB;AAAA,MAC9B,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,gBAAgB;AAAA,MAClB;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,QAAQ,MAAM,CAAC;AAAA,MACtC,QAAQ,YAAY,QAAQ,GAAI;AAAA,IAClC,CAAC;AAAA,EACH,QAAQ;AAEN,iBAAa,CAAC,GAAG,OAAO,GAAG,UAAU,EAAE,MAAM,IAAI;AAAA,EACnD;AACF;AA2CA,SAAS,kBAAkB,OAA6B;AACtD,YAAU;AAEV,MAAI,SAA2B,CAAC;AAEhC,MAAI,WAAW,WAAW,GAAG;AAC3B,QAAI;AACF,eAAS,KAAK,MAAM,aAAa,aAAa,OAAO,CAAC;AAAA,IACxD,QAAQ;AACN,eAAS,CAAC;AAAA,IACZ;AAAA,EACF;AAGA,SAAO,KAAK,KAAK;AACjB,MAAI,OAAO,SAAS,KAAM;AACxB,aAAS,OAAO,MAAM,IAAK;AAAA,EAC7B;AAEA,gBAAc,aAAa,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAC5D;AAMO,IAAM,SAAS;AAAA;AAAA,EAEpB,UAAU;AAAA,EACV,WAAW;AAAA;AAAA,EAGX,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,aAAa;AAAA,EACb,aAAa;AAAA,EACb,aAAa;AAAA,EACb,UAAU;AAAA,EACV,UAAU;AAAA,EACV,cAAc;AAAA;AAAA,EAGd,cAAc;AAAA,EACd,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,mBAAmB;AAAA;AAAA,EAGnB,kBAAkB;AAAA,EAClB,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA;AAAA,EAGjB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,oBAAoB;AAAA;AAAA,EAGpB,WAAW;AAAA,EACX,gBAAgB;AAAA,EAChB,kBAAkB;AAAA;AAAA,EAGlB,WAAW;AAAA,EACX,YAAY;AAAA;AAAA,EAGZ,eAAe;AAAA;AAAA,EAGf,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,cAAc;AAAA;AAAA,EAGd,gBAAgB;AAAA;AAAA,EAGhB,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,iBAAiB;AAAA,EACjB,qBAAqB;AACvB;AAsBA,IAAI,wBAAwB;AAMrB,SAAS,sBAA4B;AAC1C,MAAI,sBAAuB;AAC3B,0BAAwB;AAGxB,UAAQ,GAAG,cAAc,YAAY;AACnC,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,YAAY;AAAA,IACpB;AAAA,EACF,CAAC;AAGD,QAAM,gBAAgB,OAAO,YAAoB;AAC/C,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,YAAY;AAAA,IACpB;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,UAAQ,GAAG,UAAU,MAAM,cAAc,QAAQ,CAAC;AAClD,UAAQ,GAAG,WAAW,MAAM,cAAc,SAAS,CAAC;AACtD;","names":["require"]}

package/dist/chunk-RM6BWILN.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+// src/lib/cron.ts
+function cronMatches(cron, date) {
+  const parts = cron.trim().split(/\s+/);
+  if (parts.length < 5) return false;
+  const fields = [
+    { value: date.getMinutes(), field: parts[0], min: 0, max: 59 },
+    { value: date.getHours(), field: parts[1], min: 0, max: 23 },
+    { value: date.getDate(), field: parts[2], min: 1, max: 31 },
+    { value: date.getMonth() + 1, field: parts[3], min: 1, max: 12 },
+    { value: date.getDay(), field: parts[4], min: 0, max: 6 }
+  ];
+  return fields.every(
+    ({ value, field, min, max }) => fieldMatches(field, value, min, max)
+  );
+}
+function fieldMatches(field, value, min, max) {
+  if (field.includes(",")) {
+    return field.split(",").some((part) => fieldMatches(part.trim(), value, min, max));
+  }
+  if (field.includes("/")) {
+    const [range, stepStr] = field.split("/");
+    const step = parseInt(stepStr);
+    if (isNaN(step) || step <= 0) return false;
+    let start = min;
+    let end = max;
+    if (range !== "*") {
+      if (range.includes("-")) {
+        [start, end] = range.split("-").map(Number);
+      } else {
+        start = parseInt(range);
+      }
+    }
+    if (value < start || value > end) return false;
+    return (value - start) % step === 0;
+  }
+  if (field.includes("-")) {
+    const [start, end] = field.split("-").map(Number);
+    return value >= start && value <= end;
+  }
+  if (field === "*") return true;
+  return parseInt(field) === value;
+}
+function getNextCronRun(cron, after = /* @__PURE__ */ new Date()) {
+  const next = new Date(after);
+  next.setSeconds(0, 0);
+  next.setMinutes(next.getMinutes() + 1);
+  const maxIterations = 60 * 24 * 8;
+  for (let i = 0; i < maxIterations; i++) {
+    if (cronMatches(cron, next)) return next;
+    next.setMinutes(next.getMinutes() + 1);
+  }
+  const fallback = new Date(after);
+  fallback.setDate(fallback.getDate() + 1);
+  return fallback;
+}
+function parseCooldown(cooldown) {
+  const match = cooldown.match(/^(\d+)\s*(m|min|minutes?|h|hours?|d|days?)$/i);
+  if (!match) return 0;
+  const value = parseInt(match[1]);
+  const unit = match[2].toLowerCase();
+  if (unit.startsWith("m")) return value * 60 * 1e3;
+  if (unit.startsWith("h")) return value * 60 * 60 * 1e3;
+  if (unit.startsWith("d")) return value * 24 * 60 * 60 * 1e3;
+  return 0;
+}
+
+export {
+  cronMatches,
+  getNextCronRun,
+  parseCooldown
+};
+//# sourceMappingURL=chunk-RM6BWILN.js.map

package/dist/chunk-RM6BWILN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/cron.ts"],"sourcesContent":["/**\n * Zero-dependency cron evaluator utilities\n * Extracted from autonomous.ts for reusability and testing\n */\n\n/**\n * Check if a cron expression matches a given date\n * @param cron - Cron expression (minute hour day month weekday)\n * @param date - Date to check against\n * @returns true if the cron matches the date\n */\nexport function cronMatches(cron: string, date: Date): boolean {\n  const parts = cron.trim().split(/\\s+/);\n  if (parts.length < 5) return false;\n\n  const fields = [\n    { value: date.getMinutes(), field: parts[0], min: 0, max: 59 },\n    { value: date.getHours(), field: parts[1], min: 0, max: 23 },\n    { value: date.getDate(), field: parts[2], min: 1, max: 31 },\n    { value: date.getMonth() + 1, field: parts[3], min: 1, max: 12 },\n    { value: date.getDay(), field: parts[4], min: 0, max: 6 },\n  ];\n\n  return fields.every(({ value, field, min, max }) =>\n    fieldMatches(field, value, min, max)\n  );\n}\n\n/**\n * Check if a cron field matches a value\n * Handles wildcards, ranges, steps, and lists\n */\nexport function fieldMatches(\n  field: string,\n  value: number,\n  min: number,\n  max: number\n): boolean {\n  // Handle lists: \"1,3,5\"\n  if (field.includes(\",\")) {\n    return field.split(\",\").some((part) => fieldMatches(part.trim(), value, min, max));\n  }\n\n  // Handle step: \"*/5\" or \"1-10/2\"\n  if (field.includes(\"/\")) {\n    const [range, stepStr] = field.split(\"/\");\n    const step = parseInt(stepStr);\n    if (isNaN(step) || step <= 0) return false;\n\n    let start = min;\n    let end = max;\n    if (range !== \"*\") {\n      if (range.includes(\"-\")) {\n        [start, end] = range.split(\"-\").map(Number);\n      } else {\n        start = parseInt(range);\n      }\n    }\n    if (value < start || value > end) return false;\n    return (value - start) % step === 0;\n  }\n\n  // Handle range: \"1-5\"\n  if (field.includes(\"-\")) {\n    const [start, end] = field.split(\"-\").map(Number);\n    return value >= start && value <= end;\n  }\n\n  // Wildcard\n  if (field === \"*\") return true;\n\n  // Exact match\n  return parseInt(field) === value;\n}\n\n/**\n * Get the next occurrence of a cron expression after `after`.\n * Brute-forces minute by minute (max 48h lookahead).\n */\nexport function getNextCronRun(cron: string, after: Date = new Date()): Date {\n  const next = new Date(after);\n  next.setSeconds(0, 0);\n  next.setMinutes(next.getMinutes() + 1); // Start from next minute\n\n  const maxIterations = 60 * 24 * 8; // 8 days (covers weekly schedules)\n  for (let i = 0; i < maxIterations; i++) {\n    if (cronMatches(cron, next)) return next;\n    next.setMinutes(next.getMinutes() + 1);\n  }\n\n  // Fallback: 24h from now\n  const fallback = new Date(after);\n  fallback.setDate(fallback.getDate() + 1);\n  return fallback;\n}\n\n/**\n * Parse a cooldown string like \"30m\", \"6 hours\", \"7d\" into milliseconds\n * @param cooldown - String like \"30m\", \"6 hours\", \"7d\"\n * @returns milliseconds, or 0 if invalid\n */\nexport function parseCooldown(cooldown: string): number {\n  const match = cooldown.match(/^(\\d+)\\s*(m|min|minutes?|h|hours?|d|days?)$/i);\n  if (!match) return 0;\n\n  const value = parseInt(match[1]);\n  const unit = match[2].toLowerCase();\n\n  if (unit.startsWith(\"m\")) return value * 60 * 1000;\n  if (unit.startsWith(\"h\")) return value * 60 * 60 * 1000;\n  if (unit.startsWith(\"d\")) return value * 24 * 60 * 60 * 1000;\n  return 0;\n}\n"],"mappings":";;;AAWO,SAAS,YAAY,MAAc,MAAqB;AAC7D,QAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AACrC,MAAI,MAAM,SAAS,EAAG,QAAO;AAE7B,QAAM,SAAS;AAAA,IACb,EAAE,OAAO,KAAK,WAAW,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG;AAAA,IAC7D,EAAE,OAAO,KAAK,SAAS,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG;AAAA,IAC3D,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG;AAAA,IAC1D,EAAE,OAAO,KAAK,SAAS,IAAI,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,GAAG,KAAK,GAAG;AAAA,IAC/D,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,GAAG,KAAK,EAAE;AAAA,EAC1D;AAEA,SAAO,OAAO;AAAA,IAAM,CAAC,EAAE,OAAO,OAAO,KAAK,IAAI,MAC5C,aAAa,OAAO,OAAO,KAAK,GAAG;AAAA,EACrC;AACF;AAMO,SAAS,aACd,OACA,OACA,KACA,KACS;AAET,MAAI,MAAM,SAAS,GAAG,GAAG;AACvB,WAAO,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,SAAS,aAAa,KAAK,KAAK,GAAG,OAAO,KAAK,GAAG,CAAC;AAAA,EACnF;AAGA,MAAI,MAAM,SAAS,GAAG,GAAG;AACvB,UAAM,CAAC,OAAO,OAAO,IAAI,MAAM,MAAM,GAAG;AACxC,UAAM,OAAO,SAAS,OAAO;AAC7B,QAAI,MAAM,IAAI,KAAK,QAAQ,EAAG,QAAO;AAErC,QAAI,QAAQ;AACZ,QAAI,MAAM;AACV,QAAI,UAAU,KAAK;AACjB,UAAI,MAAM,SAAS,GAAG,GAAG;AACvB,SAAC,OAAO,GAAG,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI,MAAM;AAAA,MAC5C,OAAO;AACL,gBAAQ,SAAS,KAAK;AAAA,MACxB;AAAA,IACF;AACA,QAAI,QAAQ,SAAS,QAAQ,IAAK,QAAO;AACzC,YAAQ,QAAQ,SAAS,SAAS;AAAA,EACpC;AAGA,MAAI,MAAM,SAAS,GAAG,GAAG;AACvB,UAAM,CAAC,OAAO,GAAG,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI,MAAM;AAChD,WAAO,SAAS,SAAS,SAAS;AAAA,EACpC;AAGA,MAAI,UAAU,IAAK,QAAO;AAG1B,SAAO,SAAS,KAAK,MAAM;AAC7B;AAMO,SAAS,eAAe,MAAc,QAAc,oBAAI,KAAK,GAAS;AAC3E,QAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,OAAK,WAAW,GAAG,CAAC;AACpB,OAAK,WAAW,KAAK,WAAW,IAAI,CAAC;AAErC,QAAM,gBAAgB,KAAK,KAAK;AAChC,WAAS,IAAI,GAAG,IAAI,eAAe,KAAK;AACtC,QAAI,YAAY,MAAM,IAAI,EAAG,QAAO;AACpC,SAAK,WAAW,KAAK,WAAW,IAAI,CAAC;AAAA,EACvC;AAGA,QAAM,WAAW,IAAI,KAAK,KAAK;AAC/B,WAAS,QAAQ,SAAS,QAAQ,IAAI,CAAC;AACvC,SAAO;AACT;AAOO,SAAS,cAAc,UAA0B;AACtD,QAAM,QAAQ,SAAS,MAAM,8CAA8C;AAC3E,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,QAAQ,SAAS,MAAM,CAAC,CAAC;AAC/B,QAAM,OAAO,MAAM,CAAC,EAAE,YAAY;AAElC,MAAI,KAAK,WAAW,GAAG,EAAG,QAAO,QAAQ,KAAK;AAC9C,MAAI,KAAK,WAAW,GAAG,EAAG,QAAO,QAAQ,KAAK,KAAK;AACnD,MAAI,KAAK,WAAW,GAAG,EAAG,QAAO,QAAQ,KAAK,KAAK,KAAK;AACxD,SAAO;AACT;","names":[]}