import { HyperStackClient } from "hyperstack-core";

const hs = new HyperStackClient({ apiKey: "hs_..." });

// Store a decision with typed relations
await hs.store({
  slug: "use-clerk",
  title: "Use Clerk for auth",
  body: "Better DX, lower cost, native Next.js support",
  cardType: "decision",
  links: [{ target: "auth-api", relation: "affects" }],
});

// Store a blocker
await hs.store({
  slug: "migration-23",
  title: "Auth migration to Clerk",
  cardType: "task",
  links: [{ target: "deploy-prod", relation: "blocks" }],
});

// What blocks deploy?
const result = await hs.blockers("deploy-prod");
// → { blockers: [{ slug: "migration-23", title: "Auth migration to Clerk" }] }

// What breaks if auth changes?
const impact = await hs.impact("use-clerk");
// → [auth-api, deploy-prod, billing-v2]

// Batch store
await hs.bulkStore([{ slug: "p1", title: "Project A", body: "..." }, { slug: "p2", title: "Project B", body: "..." }]);

// Agentic routing (deterministic, no LLM)
const canDo = await hs.can({ query: "what breaks if auth changes?", slug: "auth-api" });
const steps = await hs.plan({ goal: "add 2FA to auth-api" });

// Parse markdown/logs into cards (CLI: npx hyperstack-core ingest)
await hs.parse("# DECISIONS.md content", { source: "decisions" });

// Ingest conversation transcript
await hs.autoRemember("Alice is senior engineer. We decided Clerk for auth.");

// Memory hub: working / semantic / episodic
const cards = await hs.hsMemory({ surface: "semantic" });

// What did the agent know when "use-clerk" was decided?
const replay = await hs.graph({ from: "use-clerk", mode: "replay" });

// replay.narrative:
// "Decision: [Use Clerk for Auth] made at 2026-02-19T20:59:00Z"
// "Agent knew 1 of 2 connected cards at decision time."
// "⚠️ 1 card(s) were modified after the decision (potential hindsight): [blocker-clerk-migration]"

// Report success/failure — updates utility scores on edges
await hs.feedback({
  cardSlugs: ["use-clerk", "auth-api"],
  outcome: "success",
  taskId: "task-auth-refactor"
});

// Retrieve most useful cards first
GET /api/cards?workspace=X&sortBy=utility

// Graph traversal weighted by utility
GET /api/graph?from=auth-api&weightBy=utility

// Fork before an experiment
const branch = await hs.fork({ branchName: "try-new-routing" });

// Make changes in the branch
await hs.store({ slug: "new-approach", title: "...", ... });

// See what changed
await hs.diff({ branchWorkspaceId: branch.branchWorkspaceId });

// Merge if it worked
await hs.merge({ branchWorkspaceId: branch.branchWorkspaceId, strategy: "branch-wins" });

// Or discard if it didn't
await hs.discard({ branchWorkspaceId: branch.branchWorkspaceId });

// Register at session start (idempotent)
await hs.identify({ agentSlug: "research-agent" });

// All hs.store() calls auto-stamp sourceAgent
await hs.store({ slug: "finding-001", ... });

// Check trust score
const profile = await hs.profile({ agentSlug: "research-agent" });
// → { trustScore: 0.84, verifiedCards: 42, cardCount: 50 }
// Formula: (verifiedCards/total)×0.7 + min(cardCount/100,1.0)×0.3

// Store with provenance
await hs.store({
  slug: "finding-latency",
  body: "p99 latency ~200ms under load",
  confidence: 0.6,
  truthStratum: "hypothesis"  // draft | hypothesis | confirmed
});

// After verification
await hs.store({
  slug: "finding-latency",
  confidence: 0.95,
  truthStratum: "confirmed",
  verifiedBy: "human:deeq"
  // verifiedAt auto-set server-side
});