reflex-agent 0.18.1 → 0.19.0

package/dist/lib/reflex/ids.js

@@ -0,0 +1,66 @@
+/**
+ * Canonical id / slug sanitizers for Reflex (north-star SpaceStore, Layer 1).
+ *
+ * Historically every store rolled its own. These are the SAME implementations,
+ * gathered in one place so the variants are named and discoverable. They are
+ * deliberately NOT collapsed into one parameterized function: the behaviors
+ * differ in subtle ways (allowed charset, ASCII vs unicode, length cap, whether
+ * existing dashes survive) and merging them would silently rename existing
+ * on-disk files. Cohesion of location, not of implementation.
+ *
+ * Pure, dependency-free (so it compiles cleanly under both the app and CLI
+ * tsconfigs and sits at the bottom of the import-direction graph).
+ */
+/**
+ * Strip everything except `[A-Za-z0-9_-]` (no replacement, no length cap).
+ * Topic ids — a filename must round-trip an externally supplied id without
+ * changing its length. (was: lib/server/topics.ts)
+ */
+export function sanitizeIdStrip(id) {
+    return id.replace(/[^A-Za-z0-9_-]/g, "");
+}
+/**
+ * Replace disallowed chars with `-` and cap at 80. Widget + workflow ids
+ * (agent-authored, kebab-ish). (was: lib/server/widgets/store.ts,
+ * lib/server/workflows/store.ts — identical)
+ */
+export function sanitizeIdDash(id) {
+    return id.replace(/[^A-Za-z0-9_-]/g, "-").slice(0, 80);
+}
+/**
+ * NFKD + lowercase ASCII slug, trimmed of leading/trailing dashes, capped at
+ * 60. Task ids. (was: lib/server/tasks/store.ts)
+ */
+export function slugify(s) {
+    return s
+        .normalize("NFKD")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+/**
+ * NFKD + lowercase UNICODE-aware slug (keeps non-ASCII letters/numbers),
+ * trimmed, capped at 60. KB filenames. (was: lib/server/agents/kb-writer.ts)
+ */
+export function slugifyUnicode(s) {
+    return s
+        .normalize("NFKD")
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+/**
+ * Trim + lowercase, collapse to `[a-z0-9-]` (existing dashes preserved, no
+ * NFKD), trimmed, capped at 64. Skill handles. (was: lib/server/skills.ts)
+ */
+export function slugifyHandle(raw) {
+    return raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64);
+}
+//# sourceMappingURL=ids.js.map

package/dist/lib/reflex/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../lib/reflex/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC;SACL,SAAS,CAAC,MAAM,CAAC;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,CAAC;SACL,SAAS,CAAC,MAAM,CAAC;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;SAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG;SACP,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/lib/reflex/paths.js

@@ -30,4 +30,30 @@ export function mirrorInReflex(root, relDir) {
 export function subdirIndexPath(root, relDir) {
     return path.join(mirrorInReflex(root, relDir), INDEX_MD);
 }
+// ---------------------------------------------------------------------------
+// Per-Space (project) .reflex sub-locations. `reflexRoot()` is the SOLE place
+// the literal ".reflex" appears — every store resolves its directory through
+// these helpers, never by hand-joining ".reflex". (north-star SpaceStore)
+/** Join segments under `<root>/.reflex/`. */
+export function reflexSubpath(root, ...segs) {
+    return path.join(reflexRoot(root), ...segs);
+}
+export function topicsDir(root) {
+    return reflexSubpath(root, "topics");
+}
+export function widgetsDir(root) {
+    return reflexSubpath(root, "widgets");
+}
+export function workflowsDir(root) {
+    return reflexSubpath(root, "workflows");
+}
+export function memoryDir(root) {
+    return reflexSubpath(root, "memory");
+}
+export function projectSkillsDir(root) {
+    return reflexSubpath(root, "skills");
+}
+export function suggestionsFile(root) {
+    return reflexSubpath(root, "suggestions.json");
+}
 //# sourceMappingURL=paths.js.map

package/dist/lib/reflex/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../lib/reflex/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,SAAS;IACT,MAAM;IACN,cAAc;IACd,WAAW;CACZ,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAClD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../lib/reflex/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,SAAS;IACT,MAAM;IACN,cAAc;IACd,WAAW;CACZ,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAClD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,0EAA0E;AAE1E,6CAA6C;AAC7C,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAG,IAAc;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,aAAa,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/reflex/store/json-store.js

@@ -0,0 +1,50 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const locks = (globalThis.__reflexJsonStoreLocks ??=
+    new Map());
+/** Run `fn` after any in-flight write to `file` settles (success or failure). */
+export function withFileLock(file, fn) {
+    const prev = locks.get(file) ?? Promise.resolve();
+    const next = prev.then(fn, fn);
+    // Track a non-throwing tail so a rejected write can't wedge the chain.
+    locks.set(file, next.then(noop, noop));
+    return next;
+}
+function noop() { }
+function isNotFound(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+/** Read + JSON.parse a file, or `null` if it doesn't exist. Throws on other IO
+ *  / parse errors so corruption is surfaced, not silently swallowed. */
+export async function readJsonFile(file) {
+    let raw;
+    try {
+        raw = await fs.readFile(file, "utf8");
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return null;
+        throw err;
+    }
+    return JSON.parse(raw);
+}
+/** Atomically write a value as pretty JSON (tmp + rename), serialized per file. */
+export async function writeJsonFile(file, value, opts = {}) {
+    await withFileLock(file, async () => {
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        const tmp = `${file}.tmp`; // unique under the per-file lock (one writer)
+        const body = JSON.stringify(value, null, 2) + "\n";
+        await fs.writeFile(tmp, body, {
+            encoding: "utf8",
+            ...(opts.mode !== undefined ? { mode: opts.mode } : {}),
+        });
+        // Re-assert mode in case umask masked it on create.
+        if (opts.mode !== undefined)
+            await fs.chmod(tmp, opts.mode);
+        await fs.rename(tmp, file);
+    });
+}
+//# sourceMappingURL=json-store.js.map

package/dist/lib/reflex/store/json-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-store.js","sourceRoot":"","sources":["../../../../lib/reflex/store/json-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAyB7B,MAAM,KAAK,GAAkC,CAAC,UAAU,CAAC,sBAAsB;IAC7E,IAAI,GAAG,EAAE,CAAC,CAAC;AAEb,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAI,IAAY,EAAE,EAAoB;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/B,uEAAuE;IACvE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,IAAI,KAAU,CAAC;AAExB,SAAS,UAAU,CAAC,GAAY;IAC9B,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACZ,GAAwB,CAAC,IAAI,KAAK,QAAQ,CAC5C,CAAC;AACJ,CAAC;AAED;wEACwE;AACxE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY;IAEZ,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACjC,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAOD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,KAAc,EACd,OAAyB,EAAE;IAE3B,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,8CAA8C;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;YAC5B,QAAQ,EAAE,MAAM;YAChB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAC,CAAC;QACH,oDAAoD;QACpD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "reflex-agent",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "private": false,
   "description": "Local-first knowledge base built by an agent over a chosen directory.",
   "license": "MIT",
   "author": "legostin",
-  "homepage": "https://github.com/legostin/reflex-agent#readme",
+  "homepage": "https://github.com/reflex-agent/reflex-agent#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/legostin/reflex-agent.git"
+    "url": "git+https://github.com/reflex-agent/reflex-agent.git"
   },
   "bugs": {
-    "url": "https://github.com/legostin/reflex-agent/issues"
+    "url": "https://github.com/reflex-agent/reflex-agent/issues"
   },
   "type": "module",
   "bin": {
@@ -35,7 +35,10 @@
     "build:cli": "tsc -p tsconfig.cli.json",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.cli.json --noEmit",
     "prepack": "node -e \"require('fs').rmSync('.next/cache', { recursive: true, force: true })\"",
-    "prepublishOnly": "pnpm run build"
+    "prepublishOnly": "pnpm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint:boundaries": "node scripts/check-boundaries.mjs"
   },
   "engines": {
     "node": ">=20"
@@ -84,6 +87,7 @@
     "@types/node": "^24",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "typescript": "^6"
+    "typescript": "^6",
+    "vitest": "^4.1.7"
   }
 }