@theglitchking/semantic-memory 1.0.0

package/dist/chunk-JPQHNG3R.js

@@ -0,0 +1,147 @@
+// src/core/log.ts
+import { readFile, writeFile, appendFile, access } from "fs/promises";
+import { constants } from "fs";
+import { join } from "path";
+var LOG_FILE = "log.md";
+var HEADER = `# Vault Log
+
+> Append-only session and ingest log. Machine-readable YAML blocks follow each line.
+
+`;
+async function logEvent(vaultPath, input) {
+  const path = join(vaultPath, LOG_FILE);
+  const ts = input.ts ?? (/* @__PURE__ */ new Date()).toISOString();
+  const entry = { ts, kind: input.kind, summary: input.summary };
+  if (input.payload) entry.payload = input.payload;
+  await ensureLogFile(path);
+  const line = `- ${ts} \u2014 ${input.kind}: ${input.summary}
+`;
+  const block = renderYamlBlock(entry);
+  await appendFile(path, line + block + "\n", "utf-8");
+  return entry;
+}
+async function logQuery(vaultPath, opts = {}) {
+  const path = join(vaultPath, LOG_FILE);
+  let raw = "";
+  try {
+    raw = await readFile(path, "utf-8");
+  } catch {
+    return [];
+  }
+  const entries = parseEntries(raw);
+  const filtered = entries.filter((e) => {
+    if (opts.kind && e.kind !== opts.kind) return false;
+    if (opts.after && new Date(e.ts).getTime() < new Date(opts.after).getTime()) return false;
+    if (opts.before && new Date(e.ts).getTime() > new Date(opts.before).getTime()) return false;
+    return true;
+  });
+  if (opts.limit) return filtered.slice(-opts.limit);
+  return filtered;
+}
+async function ensureLogFile(path) {
+  try {
+    await access(path, constants.F_OK);
+  } catch {
+    await writeFile(path, HEADER, "utf-8");
+  }
+}
+function renderYamlBlock(entry) {
+  const lines = [
+    "```yaml event",
+    `ts: ${entry.ts}`,
+    `kind: ${entry.kind}`,
+    `summary: ${yamlInline(entry.summary)}`
+  ];
+  if (entry.payload && Object.keys(entry.payload).length > 0) {
+    lines.push(`payload:`);
+    for (const [k, v] of Object.entries(entry.payload)) {
+      lines.push(`  ${k}: ${yamlInline(v)}`);
+    }
+  }
+  lines.push("```");
+  return lines.join("\n") + "\n";
+}
+function yamlInline(v) {
+  if (v == null) return "null";
+  if (typeof v === "number" || typeof v === "boolean") return String(v);
+  if (Array.isArray(v)) return "[" + v.map((x) => yamlInline(x)).join(", ") + "]";
+  if (typeof v === "object") return JSON.stringify(v);
+  const s = String(v);
+  if (/[:\-#&*!|>%@`"'{}[\]]|^\s|\s$/.test(s) || /^(true|false|null|\d)/i.test(s)) {
+    return JSON.stringify(s);
+  }
+  return s;
+}
+function parseEntries(raw) {
+  const entries = [];
+  const blockRe = /```yaml event\n([\s\S]*?)```/g;
+  let m;
+  while ((m = blockRe.exec(raw)) !== null) {
+    const block = m[1];
+    const parsed = parseFlatYaml(block);
+    if (parsed && typeof parsed.ts === "string" && typeof parsed.kind === "string") {
+      entries.push(parsed);
+    }
+  }
+  return entries;
+}
+function parseFlatYaml(block) {
+  const out = {};
+  const lines = block.split(/\r?\n/);
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (/^\s*$/.test(line)) {
+      i++;
+      continue;
+    }
+    const topMatch = line.match(/^([a-z_]+):\s*(.*)$/i);
+    if (!topMatch) {
+      i++;
+      continue;
+    }
+    const [, key, rhs] = topMatch;
+    if (key === "payload") {
+      const payload = {};
+      i++;
+      while (i < lines.length && /^\s{2,}[a-z_]/i.test(lines[i])) {
+        const m2 = lines[i].match(/^\s+([a-z_]+):\s*(.*)$/i);
+        if (m2) payload[m2[1]] = parseYamlScalar(m2[2]);
+        i++;
+      }
+      out.payload = payload;
+      continue;
+    }
+    out[key] = parseYamlScalar(rhs);
+    i++;
+  }
+  return out;
+}
+function parseYamlScalar(s) {
+  const v = s.trim();
+  if (v === "") return "";
+  if (v === "null") return null;
+  if (v === "true") return true;
+  if (v === "false") return false;
+  if (/^-?\d+(\.\d+)?$/.test(v)) return Number(v);
+  if (v.startsWith("[") && v.endsWith("]")) {
+    try {
+      return JSON.parse(v);
+    } catch {
+    }
+  }
+  if (v.startsWith('"') && v.endsWith('"') || v.startsWith("'") && v.endsWith("'")) {
+    try {
+      return JSON.parse(v.replace(/^'|'$/g, '"'));
+    } catch {
+      return v.slice(1, -1);
+    }
+  }
+  return v;
+}
+
+export {
+  logEvent,
+  logQuery
+};
+//# sourceMappingURL=chunk-JPQHNG3R.js.map

package/dist/chunk-JPQHNG3R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/log.ts"],"sourcesContent":["import { readFile, writeFile, appendFile, access } from \"node:fs/promises\";\nimport { constants } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/**\n * Structured append-only log at the vault root.\n *\n * Shape: one markdown bullet per event, each followed by a fenced `yaml event`\n * block carrying the machine-readable payload. Human scrolling and YAML parsing\n * both work on the same file.\n *\n * Example rendered line pair:\n *   - 2026-04-22T00:00:00Z — ingest: added 3 notes from RFC-1234\n *   ```yaml event\n *   ts: 2026-04-22T00:00:00Z\n *   kind: ingest\n *   payload:\n *     source: RFC-1234\n *     count: 3\n *   ```\n */\n\nconst LOG_FILE = \"log.md\";\nconst HEADER = `# Vault Log\\n\\n> Append-only session and ingest log. Machine-readable YAML blocks follow each line.\\n\\n`;\n\nexport interface LogEventInput {\n  kind: string;\n  summary: string;\n  payload?: Record<string, unknown>;\n  ts?: string;\n}\n\nexport interface LogEntry {\n  ts: string;\n  kind: string;\n  summary: string;\n  payload?: Record<string, unknown>;\n}\n\nexport interface LogQueryOptions {\n  kind?: string;\n  after?: string;\n  before?: string;\n  limit?: number;\n}\n\nexport async function logEvent(vaultPath: string, input: LogEventInput): Promise<LogEntry> {\n  const path = join(vaultPath, LOG_FILE);\n  const ts = input.ts ?? new Date().toISOString();\n  const entry: LogEntry = { ts, kind: input.kind, summary: input.summary };\n  if (input.payload) entry.payload = input.payload;\n\n  await ensureLogFile(path);\n\n  const line = `- ${ts} — ${input.kind}: ${input.summary}\\n`;\n  const block = renderYamlBlock(entry);\n  await appendFile(path, line + block + \"\\n\", \"utf-8\");\n\n  return entry;\n}\n\nexport async function logQuery(vaultPath: string, opts: LogQueryOptions = {}): Promise<LogEntry[]> {\n  const path = join(vaultPath, LOG_FILE);\n  let raw = \"\";\n  try {\n    raw = await readFile(path, \"utf-8\");\n  } catch {\n    return [];\n  }\n\n  const entries = parseEntries(raw);\n  const filtered = entries.filter((e) => {\n    if (opts.kind && e.kind !== opts.kind) return false;\n    if (opts.after && new Date(e.ts).getTime() < new Date(opts.after).getTime()) return false;\n    if (opts.before && new Date(e.ts).getTime() > new Date(opts.before).getTime()) return false;\n    return true;\n  });\n  if (opts.limit) return filtered.slice(-opts.limit);\n  return filtered;\n}\n\nasync function ensureLogFile(path: string): Promise<void> {\n  try {\n    await access(path, constants.F_OK);\n  } catch {\n    await writeFile(path, HEADER, \"utf-8\");\n  }\n}\n\nfunction renderYamlBlock(entry: LogEntry): string {\n  const lines = [\n    \"```yaml event\",\n    `ts: ${entry.ts}`,\n    `kind: ${entry.kind}`,\n    `summary: ${yamlInline(entry.summary)}`,\n  ];\n  if (entry.payload && Object.keys(entry.payload).length > 0) {\n    lines.push(`payload:`);\n    for (const [k, v] of Object.entries(entry.payload)) {\n      lines.push(`  ${k}: ${yamlInline(v)}`);\n    }\n  }\n  lines.push(\"```\");\n  return lines.join(\"\\n\") + \"\\n\";\n}\n\nfunction yamlInline(v: unknown): string {\n  if (v == null) return \"null\";\n  if (typeof v === \"number\" || typeof v === \"boolean\") return String(v);\n  if (Array.isArray(v)) return \"[\" + v.map((x) => yamlInline(x)).join(\", \") + \"]\";\n  if (typeof v === \"object\") return JSON.stringify(v);\n  const s = String(v);\n  // Quote if it contains colons, special chars, or would be parsed as a non-string\n  if (/[:\\-#&*!|>%@`\"'{}[\\]]|^\\s|\\s$/.test(s) || /^(true|false|null|\\d)/i.test(s)) {\n    return JSON.stringify(s);\n  }\n  return s;\n}\n\nfunction parseEntries(raw: string): LogEntry[] {\n  const entries: LogEntry[] = [];\n  const blockRe = /```yaml event\\n([\\s\\S]*?)```/g;\n  let m: RegExpExecArray | null;\n  while ((m = blockRe.exec(raw)) !== null) {\n    const block = m[1];\n    const parsed = parseFlatYaml(block);\n    if (parsed && typeof parsed.ts === \"string\" && typeof parsed.kind === \"string\") {\n      entries.push(parsed as LogEntry);\n    }\n  }\n  return entries;\n}\n\n/**\n * Minimal line-by-line YAML parser for the fixed shape we emit.\n * Accepts: top-level scalars + `payload:` followed by indented `key: value` pairs.\n * Anything more complex than our renderer produces is not guaranteed.\n */\nfunction parseFlatYaml(block: string): Partial<LogEntry> | null {\n  const out: any = {};\n  const lines = block.split(/\\r?\\n/);\n  let i = 0;\n  while (i < lines.length) {\n    const line = lines[i];\n    if (/^\\s*$/.test(line)) {\n      i++;\n      continue;\n    }\n    const topMatch = line.match(/^([a-z_]+):\\s*(.*)$/i);\n    if (!topMatch) {\n      i++;\n      continue;\n    }\n    const [, key, rhs] = topMatch;\n    if (key === \"payload\") {\n      const payload: Record<string, unknown> = {};\n      i++;\n      while (i < lines.length && /^\\s{2,}[a-z_]/i.test(lines[i])) {\n        const m2 = lines[i].match(/^\\s+([a-z_]+):\\s*(.*)$/i);\n        if (m2) payload[m2[1]] = parseYamlScalar(m2[2]);\n        i++;\n      }\n      out.payload = payload;\n      continue;\n    }\n    out[key] = parseYamlScalar(rhs);\n    i++;\n  }\n  return out;\n}\n\nfunction parseYamlScalar(s: string): unknown {\n  const v = s.trim();\n  if (v === \"\") return \"\";\n  if (v === \"null\") return null;\n  if (v === \"true\") return true;\n  if (v === \"false\") return false;\n  if (/^-?\\d+(\\.\\d+)?$/.test(v)) return Number(v);\n  if (v.startsWith(\"[\") && v.endsWith(\"]\")) {\n    try {\n      return JSON.parse(v);\n    } catch {\n      /* fall through */\n    }\n  }\n  if ((v.startsWith('\"') && v.endsWith('\"')) || (v.startsWith(\"'\") && v.endsWith(\"'\"))) {\n    try {\n      return JSON.parse(v.replace(/^'|'$/g, '\"'));\n    } catch {\n      return v.slice(1, -1);\n    }\n  }\n  return v;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PZ5AY32C.js

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-PZ5AY32C.js.map

package/dist/chunk-PZ5AY32C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node