@sna-sdk/core 0.0.0

package/dist/lib/sna-run.d.ts

@@ -0,0 +1,25 @@
+/**
+ * sna-run — Awaitable skill invocation for SNA pipelines.
+ *
+ * Lets you chain Claude Code skills programmatically using async/await.
+ *
+ * @example
+ * import { sna } from "sna/lib/sna-run";
+ *
+ * await sna.run("/devlog-collect");
+ * await sna.run("/devlog-analyze --week");
+ * await sna.run("/devlog-report");
+ */
+declare const sna: {
+    /**
+     * Invoke a Claude Code skill by slash command and await its completion.
+     *
+     * @param command - e.g. "/devlog-collect --since 7d"
+     * @param opts.timeout - Max wait time in ms (default: 5 minutes)
+     */
+    run: (command: string, opts?: {
+        timeout?: number;
+    }) => Promise<void>;
+};
+
+export { sna };

package/dist/lib/sna-run.js

@@ -0,0 +1,74 @@
+import { spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+import { getDb } from "../db/schema.js";
+const ROOT = process.cwd();
+const STATE_DIR = path.join(ROOT, ".sna");
+const CLAUDE_PATH_FILE = path.join(STATE_DIR, "claude-path");
+const POLL_INTERVAL_MS = 500;
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1e3;
+function getClaudePath() {
+  if (fs.existsSync(CLAUDE_PATH_FILE)) {
+    return fs.readFileSync(CLAUDE_PATH_FILE, "utf-8").trim();
+  }
+  for (const p of ["/usr/local/bin/claude", "/opt/homebrew/bin/claude"]) {
+    if (fs.existsSync(p)) return p;
+  }
+  throw new Error("Claude binary not found. Run /sna-up first.");
+}
+function parseSkillName(command) {
+  return command.trim().replace(/^\//, "").split(/\s+/)[0];
+}
+function waitForComplete(skill, afterId, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs;
+    const timer = setInterval(() => {
+      if (Date.now() > deadline) {
+        clearInterval(timer);
+        reject(new Error(`Skill "${skill}" timed out after ${timeoutMs / 1e3}s`));
+        return;
+      }
+      const db = getDb();
+      const row = db.prepare(`
+        SELECT type, message FROM skill_events
+        WHERE skill = ? AND id > ? AND type IN ('complete', 'success', 'error', 'failed')
+        ORDER BY id ASC LIMIT 1
+      `).get(skill, afterId);
+      if (!row) return;
+      clearInterval(timer);
+      if (row.type === "complete" || row.type === "success") {
+        resolve();
+      } else {
+        reject(new Error(`Skill "${skill}" failed: ${row.message}`));
+      }
+    }, POLL_INTERVAL_MS);
+  });
+}
+function getLatestEventId() {
+  const db = getDb();
+  const row = db.prepare("SELECT MAX(id) as id FROM skill_events").get();
+  return row.id ?? 0;
+}
+const sna = {
+  /**
+   * Invoke a Claude Code skill by slash command and await its completion.
+   *
+   * @param command - e.g. "/devlog-collect --since 7d"
+   * @param opts.timeout - Max wait time in ms (default: 5 minutes)
+   */
+  run: async (command, opts) => {
+    const skillName = parseSkillName(command);
+    const timeoutMs = opts?.timeout ?? DEFAULT_TIMEOUT_MS;
+    const afterId = getLatestEventId();
+    const claudePath = getClaudePath();
+    spawn(claudePath, ["--print", command], {
+      cwd: ROOT,
+      stdio: "inherit",
+      env: { ...process.env }
+    });
+    await waitForComplete(skillName, afterId, timeoutMs);
+  }
+};
+export {
+  sna
+};

package/dist/scripts/emit.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/scripts/emit.js

@@ -0,0 +1,48 @@
+import { getDb } from "../db/schema.js";
+function parseArgs(args2) {
+  const result = {};
+  for (let i = 0; i < args2.length; i += 2) {
+    const key = args2[i]?.replace(/^--/, "");
+    if (key) result[key] = args2[i + 1] ?? "";
+  }
+  return result;
+}
+const [, , ...args] = process.argv;
+const flags = parseArgs(args);
+const VALID_TYPES = [
+  "called",
+  "success",
+  "failed",
+  "permission_needed",
+  "start",
+  "progress",
+  "milestone",
+  "complete",
+  "error"
+];
+if (!flags.skill || !flags.type || !flags.message) {
+  console.error("Usage: tsx node_modules/sna/src/scripts/emit.ts --skill <name> --type <type> --message <text> [--data <json>]");
+  process.exit(1);
+}
+if (!VALID_TYPES.includes(flags.type)) {
+  console.error(`Invalid type: ${flags.type}. Must be one of: ${VALID_TYPES.join(", ")}`);
+  process.exit(1);
+}
+const db = getDb();
+db.prepare(`
+  INSERT INTO skill_events (skill, type, message, data)
+  VALUES (?, ?, ?, ?)
+`).run(flags.skill, flags.type, flags.message, flags.data ?? null);
+const prefix = {
+  called: "\u2192",
+  success: "\u2713",
+  failed: "\u2717",
+  permission_needed: "\u26A0",
+  start: "\u25B6",
+  progress: "\xB7",
+  milestone: "\u25C6",
+  complete: "\u2713",
+  error: "\u2717"
+};
+const p = prefix[flags.type] ?? "\xB7";
+console.log(`${p} [${flags.skill}] ${flags.message}`);

package/dist/scripts/hook.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/scripts/hook.js

@@ -0,0 +1,34 @@
+import { getDb } from "../db/schema.js";
+const chunks = [];
+process.stdin.on("data", (chunk) => chunks.push(chunk));
+process.stdin.on("end", () => {
+  try {
+    const raw = Buffer.concat(chunks).toString().trim();
+    if (!raw) process.exit(0);
+    const input = JSON.parse(raw);
+    const toolName = input.tool_name ?? "unknown";
+    const toolInput = input.tool_input ?? {};
+    const db = getDb();
+    const latestCalled = db.prepare(`
+      SELECT skill FROM skill_events
+      WHERE type = 'called'
+        AND id > COALESCE(
+          (SELECT MAX(id) FROM skill_events WHERE type IN ('success', 'failed')),
+          0
+        )
+      ORDER BY id DESC LIMIT 1
+    `).get();
+    const skillName = latestCalled?.skill ?? "system";
+    const summary = toolName === "Bash" ? String(toolInput.command ?? "").slice(0, 120) : toolName === "Write" ? String(toolInput.file_path ?? "") : toolName === "Edit" || toolName === "MultiEdit" ? String(toolInput.file_path ?? "") : JSON.stringify(toolInput).slice(0, 120);
+    db.prepare(
+      `INSERT INTO skill_events (skill, type, message, data) VALUES (?, ?, ?, ?)`
+    ).run(
+      skillName,
+      "permission_needed",
+      `${toolName}: ${summary}`,
+      JSON.stringify({ tool_name: toolName, tool_input: toolInput })
+    );
+  } catch {
+  }
+  process.exit(0);
+});

package/dist/scripts/init-db.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/scripts/init-db.js

@@ -0,0 +1,3 @@
+import { getDb } from "../db/schema.js";
+getDb();
+console.log("\u2713 Database initialized");

package/dist/scripts/sna.d.ts

@@ -0,0 +1,2 @@
+
+export {  }