hyperstack-core 1.5.1 → 1.5.2

package/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * hyperstack-core CLI
@@ -37,6 +37,7 @@ hyperstack-core — Typed graph memory for AI agents
 Commands:
   login               Authenticate via browser (OAuth device flow)
   logout              Remove saved credentials
+  quickstart          Scan current dir, ingest docs, show graph — 90 seconds to value
   init <template>     Initialize a project with a template
   ingest <path>       Auto-parse files into cards + edges (markdown/text/logs)
   search <query>      Search the knowledge graph
@@ -387,6 +388,116 @@ async function run() {
     return;
   }
 
+  // ─── Quickstart command ─────────────────────────────
+
+  if (command === "quickstart") {
+    console.log("\n🧠 HyperStack Quickstart\n");
+
+    // 1. Auth check
+    const qsApiKey = getApiKey();
+    if (!qsApiKey) {
+      console.log("  Not authenticated.\n");
+      console.log("  Option A: npx hyperstack-core login");
+      console.log("  Option B: export HYPERSTACK_API_KEY=hs_your_key");
+      console.log("  Get a free key: https://cascadeai.dev/hyperstack\n");
+      process.exit(1);
+    }
+    console.log("  ✅ Authenticated\n");
+
+    // 2. Scan current directory for ingestable files
+    const cwd = process.cwd();
+    const scanDirs = [cwd];
+    const docsDir = join(cwd, "docs");
+    if (existsSync(docsDir) && statSync(docsDir).isDirectory()) scanDirs.push(docsDir);
+
+    const found = [];
+    for (const dir of scanDirs) {
+      const entries = readdirSync(dir).filter((f) => /\.(md|txt)$/i.test(f));
+      for (const f of entries) {
+        const full = join(dir, f);
+        const stat = statSync(full);
+        const rel = dir === cwd ? f : `docs/${f}`;
+        found.push({ path: full, name: rel, size: stat.size });
+      }
+    }
+
+    if (!found.length) {
+      console.log("  No .md or .txt files found in current directory.\n");
+      console.log("  Try: npx hyperstack-core ingest <file>");
+      process.exit(0);
+    }
+
+    console.log("  Found files:\n");
+    for (const f of found) {
+      const kb = (f.size / 1024).toFixed(1);
+      console.log(`    📄 ${f.name} (${kb} KB)`);
+    }
+
+    const workspace = getFlag("workspace", "default");
+    console.log(`\n  Workspace: ${workspace}`);
+    console.log(`  Files: ${found.length}\n`);
+
+    // 3. Confirm (skip with --yes)
+    if (!args.includes("--yes") && !args.includes("-y")) {
+      const { createInterface } = await import("readline");
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      const answer = await new Promise((res) => {
+        rl.question("  Ingest these files? [Y/n] ", (a) => { rl.close(); res(a.trim().toLowerCase()); });
+      });
+      if (answer === "n" || answer === "no") {
+        console.log("\n  Cancelled.\n");
+        return;
+      }
+    }
+
+    // 4. Parse all files
+    console.log("\n  Parsing...\n");
+    let allCards = [];
+    let totalEdges = 0;
+
+    for (const f of found) {
+      const content = readFileSync(f.path, "utf-8");
+      const prefix = slugify(f.name.replace(/\.[^.]+$/, ""));
+      const result = parse(content, { prefix });
+      allCards.push(...result.cards);
+      totalEdges += result.edgeCount;
+      console.log(`    📄 ${f.name} → ${result.cards.length} cards, ${result.edgeCount} edges (${result.format})`);
+    }
+
+    if (!allCards.length) {
+      console.log("\n  No cards extracted. Files may be empty.\n");
+      return;
+    }
+
+    // 5. Store
+    console.log(`\n  Storing ${allCards.length} cards...`);
+    const qsClient = new HyperStackClient({ apiKey: qsApiKey, workspace });
+
+    const result = await qsClient.ingest(allCards, {
+      onProgress: () => process.stdout.write("."),
+    });
+
+    console.log("\n");
+    if (result.failed) {
+      console.log(`  ✅ ${result.stored} cards stored, ${result.failed} failed`);
+      for (const e of result.errors) console.log(`    ❌ [${e.slug}] ${e.error}`);
+    } else {
+      console.log(`  ✅ ${result.stored} cards stored, ${totalEdges} edges from ${found.length} file(s)`);
+    }
+
+    // 6. Next steps
+    const firstSlug = allCards[0]?.slug || "";
+    const searchTerm = allCards[0]?.title?.split(" ").slice(0, 3).join(" ") || "getting started";
+    console.log(`
+  Next steps:
+
+    npx hyperstack-core search "${searchTerm}"
+    npx hyperstack-core graph ${firstSlug} --depth 2 --reverse
+    npx hyperstack-core list
+`);
+    return;
+  }
+
   // ─── Ingest command ─────────────────────────────────
 
   if (command === "ingest") {

package/package.json

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