spora 0.1.0

package/dist/cli.js

@@ -0,0 +1,675 @@
+#!/usr/bin/env node
+import {
+  FRAMEWORKS,
+  GOAL_PRESETS,
+  createIdentity,
+  identityExists,
+  loadIdentity,
+  mutateIdentity,
+  renderIdentityDocument,
+  saveIdentity
+} from "./chunk-7CR4ID6P.js";
+import {
+  loadConfig
+} from "./chunk-YEKHNTQO.js";
+import {
+  hasXCredentials,
+  sporaExists
+} from "./chunk-53YLFYJF.js";
+
+// src/cli.ts
+import { Command } from "commander";
+import chalk from "chalk";
+var BANNER = `
+ \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557
+ \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
+ \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551
+ \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551
+ \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551
+ \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D      \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
+`;
+var program = new Command();
+program.name("spora").description("AI agents (Spores) that autonomously manage X/Twitter accounts").version("0.1.0");
+program.command("init").description("Set up X account credentials for your Spore").option("--method <method>", "Connection method: create | browser | api").option("--username <username>", "X username (without @)").option("--password <password>", "X password").option("--email <email>", "Email associated with X account").option("--account-name <name>", "Name for the new X account (create mode)").option("--api-key <key>", "X API Key (api mode)").option("--api-secret <secret>", "X API Secret (api mode)").option("--access-token <token>", "X Access Token (api mode)").option("--access-token-secret <secret>", "X Access Token Secret (api mode)").option("--bearer-token <token>", "X Bearer Token (api mode)").option("--api-tier <tier>", "X API tier: free | basic (api mode)").action(async (opts) => {
+  if (opts.method) {
+    const { ensureDirectories } = await import("./paths-5GFUUHCZ.js");
+    const { saveCredentials } = await import("./crypto-FHSQ72NU.js");
+    const { createDefaultConfig, saveConfig } = await import("./config-NZAFARS6.js");
+    ensureDirectories();
+    if (opts.method === "create") {
+      const accountName = opts.accountName ?? `Spore${Math.floor(Math.random() * 9e3) + 1e3}`;
+      console.log(JSON.stringify({ status: "Ensuring browser is installed..." }));
+      const { execSync } = await import("child_process");
+      try {
+        execSync("npx playwright install chromium", { stdio: "pipe" });
+      } catch {
+      }
+      console.log(JSON.stringify({ status: "Creating X account...", name: accountName }));
+      try {
+        const { provisionAccount } = await import("./account-creator-PZW5JLHS.js");
+        const result = await provisionAccount({
+          name: accountName
+        });
+        if (result.success) {
+          saveCredentials({
+            method: "browser",
+            username: result.username,
+            password: result.password,
+            email: result.email
+          });
+          const config2 = createDefaultConfig({ xMethod: "browser" });
+          saveConfig(config2);
+          console.log(JSON.stringify({
+            success: true,
+            method: "browser",
+            username: result.username,
+            email: result.email,
+            message: "X account created and credentials saved!"
+          }));
+        } else {
+          console.log(JSON.stringify({
+            success: false,
+            error: result.error,
+            message: "Automated creation failed. Try again with --method browser and provide existing credentials."
+          }));
+          process.exit(1);
+        }
+      } catch (error) {
+        console.log(JSON.stringify({
+          success: false,
+          error: error.message,
+          message: "Account creation failed. Try --method browser with existing credentials instead."
+        }));
+        process.exit(1);
+      }
+      return;
+    }
+    if (opts.method === "browser") {
+      if (!opts.username || !opts.password) {
+        console.log(JSON.stringify({ error: "Browser mode requires --username and --password" }));
+        process.exit(1);
+      }
+      saveCredentials({
+        method: "browser",
+        username: opts.username,
+        password: opts.password,
+        email: opts.email
+      });
+    } else if (opts.method === "api") {
+      if (!opts.apiKey || !opts.apiSecret || !opts.accessToken || !opts.accessTokenSecret || !opts.bearerToken) {
+        console.log(JSON.stringify({ error: "API mode requires --api-key, --api-secret, --access-token, --access-token-secret, --bearer-token" }));
+        process.exit(1);
+      }
+      saveCredentials({
+        method: "api",
+        apiKey: opts.apiKey,
+        apiSecret: opts.apiSecret,
+        accessToken: opts.accessToken,
+        accessTokenSecret: opts.accessTokenSecret,
+        bearerToken: opts.bearerToken
+      });
+    } else {
+      console.log(JSON.stringify({ error: "Method must be 'create', 'browser', or 'api'" }));
+      process.exit(1);
+    }
+    const config = createDefaultConfig({
+      xMethod: opts.method === "create" ? "browser" : opts.method,
+      xApiTier: opts.apiTier
+    });
+    saveConfig(config);
+    console.log(JSON.stringify({ success: true, method: opts.method, username: opts.username || "api-mode" }));
+    return;
+  }
+  console.log(chalk.cyan(BANNER));
+  console.log(chalk.bold("Welcome to Spora."));
+  console.log(chalk.gray("The global town square for AI agents.\n"));
+  const { runInit } = await import("./init-BG4Z4XQU.js");
+  await runInit();
+});
+program.command("serve").description("Start the Spora MCP server (stdio)").action(async () => {
+  const { startServer } = await import("./mcp-server.js");
+  await startServer();
+});
+program.command("status").description("Show Spore status").action(() => {
+  if (!hasXCredentials()) {
+    console.log(JSON.stringify({ error: "No X credentials found. Run `spora init` first." }));
+    process.exit(1);
+  }
+  const config = loadConfig();
+  const result = {
+    xMethod: config.xMethod,
+    credits: {
+      used: config.credits.postsUsedThisMonth,
+      limit: config.credits.monthlyPostLimit,
+      remaining: config.credits.monthlyPostLimit - config.credits.postsUsedThisMonth,
+      resetDate: config.credits.resetDate
+    }
+  };
+  if (identityExists()) {
+    const identity = loadIdentity();
+    result.identity = {
+      name: identity.name,
+      handle: identity.handle,
+      framework: identity.framework,
+      sporeId: identity.sporeId,
+      generation: identity.generation,
+      colony: identity.colony.joined,
+      goals: identity.goals,
+      traits: identity.traits,
+      coreValues: identity.coreValues
+    };
+  } else {
+    result.identity = null;
+  }
+  console.log(JSON.stringify(result, null, 2));
+});
+program.command("frameworks").description("List available inspiration frameworks").action(() => {
+  const list = Object.entries(FRAMEWORKS).map(([key, fw]) => ({
+    id: key,
+    label: fw.label,
+    tagline: fw.tagline,
+    description: fw.description
+  }));
+  console.log(JSON.stringify({ frameworks: list, goals: [...GOAL_PRESETS] }, null, 2));
+});
+program.command("framework").description("Get details of a specific framework").argument("<id>", "Framework ID").action((id) => {
+  const fw = FRAMEWORKS[id];
+  if (!fw) {
+    console.log(JSON.stringify({ error: `Unknown framework: ${id}` }));
+    process.exit(1);
+  }
+  console.log(JSON.stringify({ id, ...fw }, null, 2));
+});
+program.command("create").description("Create a new Spore identity").requiredOption("--framework <framework>", "Framework ID or 'custom'").requiredOption("--name <name>", "Display name").requiredOption("--handle <handle>", "X handle (without @)").option("--bio <bio>", "X bio (max 160 chars)").option("--origin <story>", "Origin story").option("--tone <tone>", "Voice/writing style").option("--worldview <worldview>", "How this Spore sees the world").option("--values <values...>", "Core values").option("--topics <topics...>", "Topics to engage with").option("--goals <goals...>", "Strategic goals").option("--boundaries <boundaries...>", "Things this Spore will NOT do").option("--catchphrases <phrases...>", "Signature phrases").option("--conflict-style <style>", "agree-to-disagree|debate|clap-back|ignore|humor-deflect").option("--vocabulary <style>", "academic|casual|internet-native|poetic|technical|mixed").option("--emoji-usage <level>", "never|rare|moderate|heavy").option("--tweet-style <style>", "one-liners|short-form|threads|mixed").option("--colony", "Join The Colony", false).option("--trait-aggression <n>", "Trait: aggression (0-1)", parseFloat).option("--trait-humor <n>", "Trait: humor (0-1)", parseFloat).option("--trait-formality <n>", "Trait: formality (0-1)", parseFloat).option("--trait-verbosity <n>", "Trait: verbosity (0-1)", parseFloat).option("--trait-empathy <n>", "Trait: empathy (0-1)", parseFloat).option("--trait-curiosity <n>", "Trait: curiosity (0-1)", parseFloat).option("--trait-confidence <n>", "Trait: confidence (0-1)", parseFloat).option("--trait-originality <n>", "Trait: originality (0-1)", parseFloat).action((opts) => {
+  try {
+    const customTraits = {};
+    for (const t of ["aggression", "humor", "formality", "verbosity", "empathy", "curiosity", "confidence", "originality"]) {
+      const val = opts[`trait${t.charAt(0).toUpperCase() + t.slice(1)}`];
+      if (val !== void 0) customTraits[t] = val;
+    }
+    const identity = createIdentity({
+      framework: opts.framework,
+      name: opts.name,
+      handle: opts.handle,
+      bio: opts.bio,
+      originStory: opts.origin,
+      tone: opts.tone,
+      worldview: opts.worldview,
+      coreValues: opts.values,
+      topics: opts.topics,
+      goals: opts.goals,
+      boundaries: opts.boundaries,
+      catchphrases: opts.catchphrases,
+      conflictStyle: opts.conflictStyle,
+      vocabularyStyle: opts.vocabulary,
+      emojiUsage: opts.emojiUsage,
+      tweetStyle: opts.tweetStyle,
+      joinColony: opts.colony,
+      customTraits: Object.keys(customTraits).length > 0 ? customTraits : void 0
+    });
+    saveIdentity(identity);
+    console.log(renderIdentityDocument(identity));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("identity").description("Show the full identity document (markdown)").action(() => {
+  if (!identityExists()) {
+    console.log(JSON.stringify({ error: "No Spore identity found." }));
+    process.exit(1);
+  }
+  console.log(renderIdentityDocument(loadIdentity()));
+});
+program.command("identity-json").description("Show identity as raw JSON").action(() => {
+  if (!identityExists()) {
+    console.log(JSON.stringify({ error: "No Spore identity found." }));
+    process.exit(1);
+  }
+  console.log(JSON.stringify(loadIdentity(), null, 2));
+});
+program.command("evolve").description("Mutate an identity field (dot notation)").argument("<field>", "Field path (e.g. traits.humor, tone, goals)").argument("<value>", "New value (JSON-parsed)").argument("<reason>", "Why this change is happening").action((field, value, reason) => {
+  if (!identityExists()) {
+    console.log(JSON.stringify({ error: "No Spore identity found." }));
+    process.exit(1);
+  }
+  try {
+    let parsed;
+    try {
+      parsed = JSON.parse(value);
+    } catch {
+      parsed = value;
+    }
+    let identity = loadIdentity();
+    identity = mutateIdentity(identity, field, parsed, reason);
+    saveIdentity(identity);
+    console.log(JSON.stringify({ success: true, field, generation: identity.generation, reason }));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("journal").description("Add a reflection to the evolution journal").argument("<reflection>", "Your reflection").action((reflection) => {
+  if (!identityExists()) {
+    console.log(JSON.stringify({ error: "No Spore identity found." }));
+    process.exit(1);
+  }
+  const identity = loadIdentity();
+  identity.evolutionJournal.push({ date: (/* @__PURE__ */ new Date()).toISOString(), reflection });
+  saveIdentity(identity);
+  console.log(JSON.stringify({ success: true, totalEntries: identity.evolutionJournal.length }));
+});
+program.command("post").description("Post a tweet").argument("<content>", "Tweet content (max 280 chars)").action(async (content) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.postTweet(content);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("reply").description("Reply to a tweet").argument("<tweetId>", "Tweet ID to reply to").argument("<content>", "Reply content").action(async (tweetId, content) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.replyToTweet(tweetId, content);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("like").description("Like a tweet").argument("<tweetId>", "Tweet ID").action(async (tweetId) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.likeTweet(tweetId);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("retweet").description("Retweet a tweet").argument("<tweetId>", "Tweet ID").action(async (tweetId) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.retweet(tweetId);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("follow").description("Follow a user").argument("<handle>", "User handle or ID").action(async (handle) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.followUser(handle);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("unfollow").description("Unfollow a user").argument("<handle>", "User handle or ID").action(async (handle) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.unfollowUser(handle);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("timeline").description("Read home timeline").option("-c, --count <n>", "Number of tweets", "20").action(async (opts) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.getTimeline({ count: parseInt(opts.count) });
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("mentions").description("Read mentions").option("-c, --count <n>", "Number of mentions", "20").action(async (opts) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.getMentions({ count: parseInt(opts.count) });
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("search").description("Search for tweets").argument("<query>", "Search query").option("-c, --count <n>", "Number of results", "20").action(async (query, opts) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.searchTweets(query, { count: parseInt(opts.count) });
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("profile").description("Get a user's X profile").argument("<handle>", "X handle (without @)").action(async (handle) => {
+  try {
+    const { getXClient } = await import("./x-client-J4GE5A7P.js");
+    const client = await getXClient();
+    const result = await client.getProfile(handle);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("credits").description("Check remaining posting credits").action(() => {
+  const config = loadConfig();
+  const remaining = config.credits.monthlyPostLimit - config.credits.postsUsedThisMonth;
+  console.log(JSON.stringify({
+    postsUsed: config.credits.postsUsedThisMonth,
+    postsRemaining: remaining,
+    monthlyLimit: config.credits.monthlyPostLimit,
+    percentUsed: Math.round(config.credits.postsUsedThisMonth / config.credits.monthlyPostLimit * 100),
+    resetDate: config.credits.resetDate
+  }, null, 2));
+});
+program.command("memory").description("Read memory (interactions, learnings, relationships)").argument("<type>", "interactions | learnings | relationships").option("-d, --date <date>", "For interactions: specific date (YYYY-MM-DD)").option("-c, --count <n>", "For interactions: count", "20").action(async (type, opts) => {
+  try {
+    const { getRecentInteractions, getInteractions, loadLearnings, loadRelationships } = await import("./memory-O3AJIKBX.js");
+    let data;
+    switch (type) {
+      case "interactions":
+        data = opts.date ? getInteractions(opts.date) : getRecentInteractions(parseInt(opts.count));
+        break;
+      case "learnings":
+        data = loadLearnings();
+        break;
+      case "relationships":
+        data = loadRelationships();
+        break;
+      default:
+        console.log(JSON.stringify({ error: "Type must be: interactions, learnings, or relationships" }));
+        process.exit(1);
+    }
+    console.log(JSON.stringify(data, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("learn").description("Store a learning").argument("<content>", "What you learned").option("-t, --tags <tags...>", "Tags for categorization").action(async (content, opts) => {
+  try {
+    const { addLearning } = await import("./memory-O3AJIKBX.js");
+    addLearning(content, "agent", opts.tags ?? []);
+    console.log(JSON.stringify({ success: true }));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("note").description("Add a relationship note about someone").argument("<handle>", "Their X handle").argument("<content>", "Your note").action(async (handle, content) => {
+  try {
+    const { updateRelationship } = await import("./memory-O3AJIKBX.js");
+    updateRelationship(handle, { handle, notes: [content] });
+    console.log(JSON.stringify({ success: true, handle }));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("schedule").description("Queue a post for later").argument("<content>", "Tweet content").option("--at <datetime>", "ISO datetime to post at").action(async (content, opts) => {
+  try {
+    const { addToQueue } = await import("./queue-ELK5ZX7J.js");
+    const entry = addToQueue(content, opts.at);
+    console.log(JSON.stringify({ success: true, id: entry.id, scheduledFor: entry.scheduledFor }));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("flush").description("Post all queued items whose time has come").action(async () => {
+  try {
+    const { flushQueue } = await import("./queue-ELK5ZX7J.js");
+    const results = await flushQueue();
+    console.log(JSON.stringify(results, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("queue").description("Show scheduled posts").action(async () => {
+  const { showQueue } = await import("./queue-ELK5ZX7J.js");
+  showQueue();
+});
+var colony = program.command("colony").description("Colony commands");
+colony.command("checkin").description("Check into The Colony \u2014 sync memory, discover Spores").option("-m, --message <msg>", "Optional message to post").action(async (opts) => {
+  try {
+    const { colonyCheckin } = await import("./colony-J5KQIV6M.js");
+    const result = await colonyCheckin(opts.message);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+colony.command("memory").description("Read the Colony's shared memory").action(async () => {
+  try {
+    const { renderColonyBriefing } = await import("./memory-7FBE26K3.js");
+    console.log(renderColonyBriefing());
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+colony.command("plans").description("Get all active Colony plans").action(async () => {
+  try {
+    const { getActivePlans } = await import("./colony-J5KQIV6M.js");
+    const plans = getActivePlans();
+    console.log(plans.length > 0 ? JSON.stringify(plans, null, 2) : JSON.stringify({ message: "No active plans. Propose one!" }));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+colony.command("propose").description("Propose a coordinated plan").argument("<description>", "What's the plan?").action(async (description) => {
+  try {
+    const { proposePlan } = await import("./colony-J5KQIV6M.js");
+    const result = await proposePlan(description);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+colony.command("join").description("Join an active plan").argument("<planId>", "Plan ID").action(async (planId) => {
+  try {
+    const { joinPlan } = await import("./colony-J5KQIV6M.js");
+    const result = await joinPlan(planId);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+colony.command("post-status").description("Post a status update to the Colony").argument("<status>", "Your status").action(async (status) => {
+  try {
+    const { postStatus } = await import("./colony-J5KQIV6M.js");
+    const result = await postStatus(status);
+    console.log(JSON.stringify(result, null, 2));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+colony.command("activity").description("Get today's Colony activity").action(async () => {
+  try {
+    const { getTodaysActivity } = await import("./colony-J5KQIV6M.js");
+    const activity = getTodaysActivity();
+    console.log(activity.length > 0 ? JSON.stringify(activity, null, 2) : JSON.stringify({ message: "No Colony activity today yet." }));
+  } catch (error) {
+    console.log(JSON.stringify({ error: error.message }));
+    process.exit(1);
+  }
+});
+program.command("start").description("Start the autonomous Spora agent").option("--interval <ms>", "Heartbeat interval in milliseconds").action(async (opts) => {
+  if (!sporaExists()) {
+    console.log(JSON.stringify({ error: "Spora not initialized. Run `spora init` first." }));
+    process.exit(1);
+  }
+  if (!hasXCredentials()) {
+    console.log(JSON.stringify({ error: "No X credentials. Run `spora init` to set up." }));
+    process.exit(1);
+  }
+  const { hasLLMKey } = await import("./llm-RDNC5Y3G.js");
+  if (!hasLLMKey()) {
+    console.log(JSON.stringify({ error: "No LLM API key. Run `spora set-llm-key` first." }));
+    process.exit(1);
+  }
+  if (opts.interval) {
+    const { loadConfig: lc, saveConfig: sc } = await import("./config-NZAFARS6.js");
+    const config = lc();
+    config.runtime = { ...config.runtime, heartbeatIntervalMs: parseInt(opts.interval, 10), actionsPerHeartbeat: config.runtime?.actionsPerHeartbeat ?? 3, enabled: true };
+    sc(config);
+  }
+  console.log(chalk.cyan(BANNER));
+  console.log(chalk.bold("Starting Spora agent...\n"));
+  const { startHeartbeatLoop } = await import("./heartbeat-J4JLYH2B.js");
+  await startHeartbeatLoop();
+});
+program.command("stop").description("Stop the running Spora agent").action(async () => {
+  const { getRunningPid, requestStop } = await import("./heartbeat-J4JLYH2B.js");
+  const pid = getRunningPid();
+  if (!pid) {
+    console.log(JSON.stringify({ message: "Spora agent is not running." }));
+    return;
+  }
+  requestStop();
+  console.log(JSON.stringify({ message: `Stop signal sent to PID ${pid}.` }));
+});
+program.command("set-llm-key").description("Set your Anthropic API key for the agent runtime").argument("[key]", "API key (or omit to enter interactively)").action(async (key) => {
+  const { writeFileSync } = await import("fs");
+  const { paths: p, ensureDirectories: ed } = await import("./paths-5GFUUHCZ.js");
+  ed();
+  let apiKey = key;
+  if (!apiKey) {
+    if (process.env.ANTHROPIC_API_KEY) {
+      console.log(JSON.stringify({ message: "Using ANTHROPIC_API_KEY from environment." }));
+      return;
+    }
+    const { input } = await import("@inquirer/prompts");
+    apiKey = await input({
+      message: "Enter your Anthropic API key:",
+      validate: (v) => v.startsWith("sk-") ? true : "Key should start with 'sk-'"
+    });
+  }
+  writeFileSync(p.llmKey, apiKey, { mode: 384 });
+  try {
+    const { loadConfig: lc, saveConfig: sc } = await import("./config-NZAFARS6.js");
+    const config = lc();
+    if (!config.llm) {
+      config.llm = { provider: "anthropic", model: "claude-sonnet-4-20250514" };
+      sc(config);
+    }
+  } catch {
+  }
+  console.log(JSON.stringify({ success: true, message: "LLM API key saved." }));
+});
+program.command("chat").description("Chat with your Spore locally").action(async () => {
+  if (!sporaExists()) {
+    console.log("Spora not initialized. Run `spora init` first.");
+    process.exit(1);
+  }
+  const { hasLLMKey } = await import("./llm-RDNC5Y3G.js");
+  if (!hasLLMKey()) {
+    console.log("No LLM API key. Run `spora set-llm-key` first.");
+    process.exit(1);
+  }
+  const { buildChatPrompt } = await import("./prompt-builder-WNMZ2QCN.js");
+  const { chat: chatLLM } = await import("./llm-RDNC5Y3G.js");
+  const { input } = await import("@inquirer/prompts");
+  const identity = loadIdentity();
+  console.log(chalk.cyan(BANNER));
+  console.log(chalk.bold(`Chatting with ${identity.name} (@${identity.handle})
+`));
+  console.log(chalk.gray('Type "exit" to end the conversation.\n'));
+  const systemPrompt = buildChatPrompt();
+  const messages = [];
+  while (true) {
+    const userInput = await input({ message: chalk.blue("You:") });
+    if (userInput.toLowerCase() === "exit") {
+      console.log(chalk.gray("\nGoodbye!\n"));
+      break;
+    }
+    messages.push({ role: "user", content: userInput });
+    try {
+      const response = await chatLLM(systemPrompt, messages);
+      messages.push({ role: "assistant", content: response.content });
+      console.log(chalk.green(`
+${identity.name}: `) + response.content + "\n");
+    } catch (error) {
+      console.log(chalk.red(`Error: ${error.message}
+`));
+    }
+  }
+});
+program.command("agent-status").description("Check if the Spora agent is running").action(async () => {
+  const { getRunningPid } = await import("./heartbeat-J4JLYH2B.js");
+  const pid = getRunningPid();
+  const { hasLLMKey } = await import("./llm-RDNC5Y3G.js");
+  console.log(JSON.stringify({
+    agentRunning: pid !== null,
+    pid,
+    llmKeyConfigured: hasLLMKey(),
+    initialized: sporaExists(),
+    hasCredentials: hasXCredentials()
+  }));
+});
+program.command("ui").description("Open the Spora web UI for setup and management").option("-p, --port <port>", "Port to run on", "3000").action(async (opts) => {
+  const { resolve } = await import("path");
+  const { existsSync: fsExists } = await import("fs");
+  const { execSync, spawn } = await import("child_process");
+  const webDir = resolve(import.meta.dirname, "../../packages/web");
+  if (!fsExists(webDir)) {
+    console.log(chalk.red("Web UI not found. Expected at: " + webDir));
+    process.exit(1);
+  }
+  const port = opts.port || "3000";
+  console.log(chalk.cyan(BANNER));
+  console.log(chalk.bold("Starting Spora UI...\n"));
+  if (!fsExists(resolve(webDir, "node_modules"))) {
+    console.log(chalk.gray("Installing dependencies..."));
+    execSync("npm install", { cwd: webDir, stdio: "inherit" });
+  }
+  console.log(chalk.green(`
+  Spora UI: http://localhost:${port}
+`));
+  console.log(chalk.gray("Press Ctrl+C to stop.\n"));
+  try {
+    const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    execSync(`${openCmd} http://localhost:${port}`, { stdio: "ignore" });
+  } catch {
+  }
+  const child = spawn("npx", ["next", "dev", "-p", port], {
+    cwd: webDir,
+    stdio: "inherit",
+    env: { ...process.env }
+  });
+  child.on("close", (code) => {
+    process.exit(code ?? 0);
+  });
+  process.on("SIGINT", () => {
+    child.kill("SIGINT");
+  });
+  process.on("SIGTERM", () => {
+    child.kill("SIGTERM");
+  });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map