hyperstack-core 1.0.0 → 1.1.0

package/README.md

@@ -91,6 +91,10 @@ const blockers = await builder.tools.hs_blockers({ slug: "deploy-prod" });
 # Initialize with multi-agent template
 npx hyperstack-core init openclaw-multiagent
 
+# Auto-extract cards from text (zero LLM cost)
+npx hyperstack-core ingest project.txt
+echo "We use Next.js 14 and PostgreSQL" | npx hyperstack-core ingest -
+
 # Store cards
 npx hyperstack-core store --slug "use-clerk" --title "Use Clerk" --type decision
 

package/adapters/openclaw.js

@@ -176,6 +176,27 @@ function createOpenClawAdapter(opts = {}) {
           cards,
         };
       },
+
+      /**
+       * Auto-extract cards from raw text (conversation, project description).
+       * Finds preferences, people, decisions, tech stack mentions.
+       * Zero LLM cost. Best for onboarding.
+       */
+      async hs_ingest({ text }) {
+        if (!text || text.trim().length === 0) {
+          return { text: "Error: text parameter required", cards: [] };
+        }
+
+        const result = await client.ingest(text);
+        const cards = result.cards || [];
+
+        return {
+          text: `✅ Created ${cards.length} cards from ${text.length} chars of text:\n` +
+            cards.map(c => `  [${c.slug}] ${c.title} (${c.cardType})`).join("\n"),
+          cards,
+          count: cards.length,
+        };
+      },
     },
 
     /**

package/cli.js

@@ -42,6 +42,7 @@ Commands:
   decide              Record a decision (use --slug, --title, --rationale)
   blockers <slug>     Show what blocks a card
   graph <slug>        Traverse graph from a card
+  ingest <file|text>  Auto-extract cards from text (zero LLM cost)
   list                List all cards
 
 Templates:
@@ -61,6 +62,8 @@ Examples:
   npx hyperstack-core store --slug "use-clerk" --title "Use Clerk for auth" --type decision
   npx hyperstack-core blockers deploy-prod
   npx hyperstack-core graph auth-api --depth 2
+  npx hyperstack-core ingest project.txt
+  echo "We use Next.js 14 and PostgreSQL" | npx hyperstack-core ingest -
 `);
 }
 
@@ -480,6 +483,47 @@ async function run() {
     return;
   }
 
+  if (command === "ingest") {
+    let text = "";
+    const input = args[1];
+
+    if (!input) {
+      console.error("Usage: npx hyperstack-core ingest <file|text|->");
+      console.error("  file   Read from file");
+      console.error("  -      Read from stdin");
+      console.error("  text   Treat argument as raw text");
+      process.exit(1);
+    }
+
+    if (input === "-") {
+      // Read from stdin
+      const chunks = [];
+      process.stdin.on("data", chunk => chunks.push(chunk));
+      await new Promise(resolve => process.stdin.on("end", resolve));
+      text = Buffer.concat(chunks).toString("utf-8");
+    } else if (existsSync(input)) {
+      // Read from file
+      text = readFileSync(input, "utf-8");
+    } else {
+      // Treat as raw text
+      text = input;
+    }
+
+    if (!text || text.trim().length === 0) {
+      console.error("Error: No text provided");
+      process.exit(1);
+    }
+
+    console.log(`Ingesting ${text.length} chars...`);
+    const result = await client.ingest(text);
+    const cards = result.cards || [];
+    console.log(`\n✅ Created ${cards.length} cards:\n`);
+    for (const c of cards) {
+      console.log(`  [${c.slug}] ${c.title} (${c.cardType || "general"})`);
+    }
+    return;
+  }
+
   if (command === "list") {
     const result = await client.list();
     console.log(`HyperStack: ${result.count ?? 0}/${result.limit ?? "?"} cards (plan: ${result.plan || "?"})\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperstack-core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Typed graph memory for AI agents. Replace GOALS.md with queryable cards + relations. Works with OpenClaw, Claude Desktop, Cursor.",
   "type": "module",
   "main": "index.js",

package/src/client.js

@@ -129,6 +129,17 @@ class HyperStackClient {
     return this._request("DELETE", `/api/cards?workspace=${this.workspace}&id=${slug}`);
   }
 
+  /**
+   * Auto-extract cards from raw text.
+   * Finds preferences, people, decisions, tech stack mentions using regex.
+   * Zero LLM cost. Great for onboarding.
+   * @param {string} text — raw conversation or project description
+   * @returns {Promise<{cards: Array, count: number}>}
+   */
+  async ingest(text) {
+    return this._request("POST", `/api/ingest?workspace=${this.workspace}`, { text });
+  }
+
   // ─── Graph ───────────────────────────────────────────
 
   /**