hyperstack-core 1.5.0 → 1.5.1

package/README.md

@@ -223,6 +223,12 @@ await hs.store({
 ## CLI
 
 ```bash
+# Ingest a README into cards + edges (no manual card creation)
+npx hyperstack-core ingest ./README.md
+npx hyperstack-core ingest ./docs/                    # whole directory
+cat DECISIONS.md | npx hyperstack-core ingest --source decisions  # stdin pipe
+npx hyperstack-core ingest ./README.md --dry          # preview without storing
+
 # Store a card
 npx hyperstack-core store --slug "use-clerk" --title "Use Clerk" --type decision
 
@@ -232,9 +238,12 @@ npx hyperstack-core decide --slug "use-clerk" --title "Use Clerk" --rationale "B
 # Check blockers
 npx hyperstack-core blockers deploy-prod
 
-# Traverse graph
+# Traverse graph — forward (what this card points to)
 npx hyperstack-core graph auth-api --depth 2
 
+# Traverse graph — reverse (what points at this card)
+npx hyperstack-core graph auth-api --depth 2 --reverse
+
 # Search
 npx hyperstack-core search "authentication setup"
 

package/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * hyperstack-core CLI
@@ -43,7 +43,7 @@ Commands:
   store               Store a card (use --slug, --title, --body, --type, --links)
   decide              Record a decision (use --slug, --title, --rationale)
   blockers <slug>     Show what blocks a card
-  graph <slug>        Traverse graph from a card
+  graph <slug>        Traverse graph from a card (--reverse for inbound edges)
   list                List all cards
 
 Templates:
@@ -592,12 +592,15 @@ async function run() {
   if (command === "graph") {
     const from = args[1];
     if (!from) { console.error("Usage: hyperstack-core graph <slug>"); process.exit(1); }
+    const reverse = args.includes("--reverse");
     try {
       const result = await client.graph(from, {
         depth: parseInt(getFlag("depth", "2")),
         relation: getFlag("relation") || undefined,
+        mode: reverse ? "impact" : undefined,
       });
-      console.log(`Graph from [${from}]: ${result.nodes?.length || 0} nodes, ${result.edges?.length || 0} edges\n`);
+      const direction = reverse ? "pointing at" : "from";
+      console.log(`Graph ${direction} [${from}]: ${result.nodes?.length || 0} nodes, ${result.edges?.length || 0} edges\n`);
       for (const n of result.nodes || []) {
         console.log(`  [${n.slug}] ${n.title || "?"} (${n.cardType || "?"})`);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperstack-core",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "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

@@ -165,6 +165,7 @@ class HyperStackClient {
    * @param {number} [opts.depth=1] — hops to traverse (1-3)
    * @param {string} [opts.relation] — filter by relation type
    * @param {string} [opts.type] — filter by card type
+   * @param {string} [opts.mode] — "impact" for reverse traversal, "replay" for decision replay
    * @param {string} [opts.at] — ISO timestamp for time-travel
    * @returns {Promise<{nodes: Array, edges: Array}>}
    */
@@ -173,6 +174,7 @@ class HyperStackClient {
     if (opts.depth) url += `&depth=${opts.depth}`;
     if (opts.relation) url += `&relation=${opts.relation}`;
     if (opts.type) url += `&type=${opts.type}`;
+    if (opts.mode) url += `&mode=${opts.mode}`;
     if (opts.at) url += `&at=${encodeURIComponent(opts.at)}`;
     return this._request("GET", url);
   }