@spooky-sync/cli 0.0.1-canary.33 → 0.0.1-canary.330

package/dist/cli.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";const r=require("child_process"),s=require("./resolve-binary-CFmJcXEj.cjs"),o=s.findBinary(),e=r.spawnSync(o,process.argv.slice(2),{stdio:"inherit"});e.error&&(console.error(`Failed to execute spooky: ${e.error.message}`),process.exit(1));process.exit(e.status??1);
+"use strict";const r=require("child_process"),s=require("./resolve-binary-J8VAJRMF.cjs"),i=s.findBinary(),e=r.spawnSync(i,process.argv.slice(2),{stdio:"inherit"});e.error&&(console.error(`Failed to execute spky: ${e.error.message}`),process.exit(1));process.exit(e.status??1);

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawnSync as e } from "child_process";
-import { f as s } from "./resolve-binary-BYotYL89.js";
+import { f as s } from "./resolve-binary-kH1Jwk0z.js";
 const o = s(), r = e(o, process.argv.slice(2), { stdio: "inherit" });
-r.error && (console.error(`Failed to execute spooky: ${r.error.message}`), process.exit(1));
+r.error && (console.error(`Failed to execute spky: ${r.error.message}`), process.exit(1));
 process.exit(r.status ?? 1);

package/dist/resolve-binary-J8VAJRMF.cjs

@@ -0,0 +1,8 @@
+"use strict";const o=require("os"),e=require("path"),t=require("fs"),g=require("url"),k=require("module");var s=typeof document<"u"?document.currentScript:null;const x=g.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:s&&s.tagName.toUpperCase()==="SCRIPT"&&s.src||new URL("resolve-binary-J8VAJRMF.cjs",document.baseURI).href),c=e.dirname(x),d={"darwin-arm64":"@spooky-sync/cli-darwin-arm64","darwin-x64":"@spooky-sync/cli-darwin-x64","linux-arm64":"@spooky-sync/cli-linux-arm64","linux-x64":"@spooky-sync/cli-linux-x64","win32-x64":"@spooky-sync/cli-win32-x64"};function $(){const r=`${o.platform()}-${o.arch()}`,n=d[r];if(!n)return;const l=o.platform()==="win32"?"spky.exe":"spky";try{const i=k.createRequire(typeof document>"u"?require("url").pathToFileURL(__filename).href:s&&s.tagName.toUpperCase()==="SCRIPT"&&s.src||new URL("resolve-binary-J8VAJRMF.cjs",document.baseURI).href).resolve(`${n}/package.json`);return e.resolve(e.dirname(i),l)}catch{return}}function w(){const r=o.platform()==="win32"?"spky.exe":"spky",n=$();if(n&&t.existsSync(n))return n;const l=[e.resolve(c,"../../../target/release",r),e.resolve(c,"../target/release",r),e.resolve(c,"../../../target/debug",r),e.resolve(c,"../target/debug",r)],u=l.filter(a=>t.existsSync(a));if(u.length>0)return u.sort((a,h)=>t.statSync(h).mtimeMs-t.statSync(a).mtimeMs),u[0];const i=e.resolve(c,"..",r);if(t.existsSync(i))return i;const p=e.resolve(process.cwd(),r);if(t.existsSync(p))return p;const m=`${o.platform()}-${o.arch()}`,y=d[m],f=y?`
+Try installing the platform package: npm install ${y}`:`
+Your platform (${m}) is not supported.`;throw new Error(`Could not find spky binary. Checked paths:
+  - Platform package (${y??"none"})
+`+l.map(a=>`  - ${a}
+`).join("")+`  - ${i}
+  - ${p}
+`+f)}exports.findBinary=w;

package/dist/resolve-binary-kH1Jwk0z.js

@@ -0,0 +1,60 @@
+import { platform as m, arch as u } from "os";
+import { dirname as d, resolve as t } from "path";
+import { existsSync as c, statSync as f } from "fs";
+import { fileURLToPath as h } from "url";
+import { createRequire as w } from "module";
+const $ = h(import.meta.url), i = d($), k = {
+  "darwin-arm64": "@spooky-sync/cli-darwin-arm64",
+  "darwin-x64": "@spooky-sync/cli-darwin-x64",
+  "linux-arm64": "@spooky-sync/cli-linux-arm64",
+  "linux-x64": "@spooky-sync/cli-linux-x64",
+  "win32-x64": "@spooky-sync/cli-win32-x64"
+};
+function P() {
+  const r = `${m()}-${u()}`, n = k[r];
+  if (!n) return;
+  const a = m() === "win32" ? "spky.exe" : "spky";
+  try {
+    const e = w(import.meta.url).resolve(`${n}/package.json`);
+    return t(d(e), a);
+  } catch {
+    return;
+  }
+}
+function B() {
+  const r = m() === "win32" ? "spky.exe" : "spky", n = P();
+  if (n && c(n))
+    return n;
+  const a = [
+    t(i, "../../../target/release", r),
+    // workspace release
+    t(i, "../target/release", r),
+    // per-package release
+    t(i, "../../../target/debug", r),
+    // workspace debug
+    t(i, "../target/debug", r)
+    // per-package debug
+  ], s = a.filter((o) => c(o));
+  if (s.length > 0)
+    return s.sort((o, x) => f(x).mtimeMs - f(o).mtimeMs), s[0];
+  const e = t(i, "..", r);
+  if (c(e))
+    return e;
+  const p = t(process.cwd(), r);
+  if (c(p))
+    return p;
+  const y = `${m()}-${u()}`, l = k[y], g = l ? `
+Try installing the platform package: npm install ${l}` : `
+Your platform (${y}) is not supported.`;
+  throw new Error(
+    `Could not find spky binary. Checked paths:
+  - Platform package (${l ?? "none"})
+` + a.map((o) => `  - ${o}
+`).join("") + `  - ${e}
+  - ${p}
+` + g
+  );
+}
+export {
+  B as f
+};

package/dist/resolve-binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-binary.d.ts","sourceRoot":"","sources":["../src/resolve-binary.ts"],"names":[],"mappings":"AAiCA,wBAAgB,UAAU,IAAI,MAAM,CAyCnC"}
+{"version":3,"file":"resolve-binary.d.ts","sourceRoot":"","sources":["../src/resolve-binary.ts"],"names":[],"mappings":"AAiCA,wBAAgB,UAAU,IAAI,MAAM,CAuDnC"}

package/dist/syncgen.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("child_process"),a=require("util"),i=require("./resolve-binary-CFmJcXEj.cjs"),d=a.promisify(t.execFile);async function f(e){const n=i.findBinary(),r=[];r.push("--input",e.input),r.push("--output",e.output),e.format&&r.push("--format",e.format),e.pretty&&r.push("--pretty"),e.all&&r.push("--all"),e.noHeader&&r.push("--no-header"),e.append&&r.push("--append",e.append),e.modulesDir&&r.push("--modules-dir",e.modulesDir),e.mode&&r.push("--mode",e.mode),e.endpoint&&r.push("--endpoint",e.endpoint),e.secret&&r.push("--secret",e.secret),e.config&&r.push("--config",e.config);try{const{stdout:u,stderr:c}=await d(n,r);return c&&console.error(c),u}catch(u){throw new Error(`Syncgen failed: ${u.message}`)}}exports.runSyncgen=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("child_process"),a=require("util"),i=require("./resolve-binary-J8VAJRMF.cjs"),d=a.promisify(t.execFile);async function f(e){const n=i.findBinary(),r=[];r.push("--input",e.input),r.push("--output",e.output),e.format&&r.push("--format",e.format),e.pretty&&r.push("--pretty"),e.all&&r.push("--all"),e.noHeader&&r.push("--no-header"),e.append&&r.push("--append",e.append),e.modulesDir&&r.push("--modules-dir",e.modulesDir),e.mode&&r.push("--mode",e.mode),e.endpoint&&r.push("--endpoint",e.endpoint),e.secret&&r.push("--secret",e.secret),e.config&&r.push("--config",e.config);try{const{stdout:u,stderr:c}=await d(n,r);return c&&console.error(c),u}catch(u){throw new Error(`Syncgen failed: ${u.message}`,{cause:u})}}exports.runSyncgen=f;

package/dist/syncgen.js

@@ -1,17 +1,17 @@
 import { execFile as c } from "child_process";
 import { promisify as d } from "util";
-import { f as t } from "./resolve-binary-BYotYL89.js";
+import { f as t } from "./resolve-binary-kH1Jwk0z.js";
 const i = d(c);
-async function p(e) {
+async function s(e) {
   const a = t(), r = [];
   r.push("--input", e.input), r.push("--output", e.output), e.format && r.push("--format", e.format), e.pretty && r.push("--pretty"), e.all && r.push("--all"), e.noHeader && r.push("--no-header"), e.append && r.push("--append", e.append), e.modulesDir && r.push("--modules-dir", e.modulesDir), e.mode && r.push("--mode", e.mode), e.endpoint && r.push("--endpoint", e.endpoint), e.secret && r.push("--secret", e.secret), e.config && r.push("--config", e.config);
   try {
-    const { stdout: f, stderr: u } = await i(a, r);
-    return u && console.error(u), f;
-  } catch (f) {
-    throw new Error(`Syncgen failed: ${f.message}`);
+    const { stdout: u, stderr: f } = await i(a, r);
+    return f && console.error(f), u;
+  } catch (u) {
+    throw new Error(`Syncgen failed: ${u.message}`, { cause: u });
   }
 }
 export {
-  p as runSyncgen
+  s as runSyncgen
 };

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@spooky-sync/cli",
-  "version": "0.0.1-canary.33",
+  "version": "0.0.1-canary.330",
   "description": "Generate TypeScript/Dart types from SurrealDB schema files",
   "type": "module",
   "main": "./dist/syncgen.cjs",
   "module": "./dist/syncgen.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "spooky": "./dist/cli.js"
+    "spky": "./dist/cli.js"
   },
   "exports": {
+    "./devtools-mcp": "./devtools-mcp/index.js",
     ".": {
       "import": "./dist/syncgen.js",
       "require": "./dist/syncgen.cjs",
@@ -17,15 +18,20 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "devtools-mcp",
+    "templates/cookbook",
+    "AGENTS.md"
   ],
   "scripts": {
     "dev": "vite",
+    "dev:build": "cargo build -p sp00ky-cli",
     "build:rust": "cargo build --release",
     "build:vite": "vite build",
     "build:types": "tsc --emitDeclarationOnly --declaration --declarationDir dist",
+    "build:devtools-mcp": "vite build --config vite.config.devtools-mcp.ts",
     "build:js": "npm run build:vite && npm run build:types",
-    "build": "npm run build:rust && npm run build:js",
+    "build": "npm run build:rust && npm run build:devtools-mcp && npm run build:js",
     "preview": "vite preview",
     "test": "vitest",
     "lint": "eslint src",
@@ -56,10 +62,10 @@
     "vitest": "^1.0.0"
   },
   "optionalDependencies": {
-    "@spooky-sync/cli-darwin-arm64": "0.0.1-canary.33",
-    "@spooky-sync/cli-darwin-x64": "0.0.1-canary.33",
-    "@spooky-sync/cli-linux-arm64": "0.0.1-canary.33",
-    "@spooky-sync/cli-linux-x64": "0.0.1-canary.33",
-    "@spooky-sync/cli-win32-x64": "0.0.1-canary.33"
+    "@spooky-sync/cli-darwin-arm64": "0.0.1-canary.330",
+    "@spooky-sync/cli-darwin-x64": "0.0.1-canary.330",
+    "@spooky-sync/cli-linux-arm64": "0.0.1-canary.330",
+    "@spooky-sync/cli-linux-x64": "0.0.1-canary.330",
+    "@spooky-sync/cli-win32-x64": "0.0.1-canary.330"
   }
 }

package/templates/cookbook/INDEX.md

@@ -0,0 +1,31 @@
+# sp00ky cookbook
+
+A short, scannable list of patterns an AI agent (or human) reaches for when writing code against a sp00ky-backed app. Each entry has a one-sentence "when to use," the canonical snippet, and one gotcha.
+
+Render any recipe with:
+```
+spky recipe <recipe> --table <your-table>
+```
+or pass `--out path/to/file.tsx` to write the snippet directly.
+
+## Recipes
+
+### `live-list`
+**When to use:** you want a reactive, sorted list of rows from a table that updates as records change.
+**Render:** `spky recipe live-list --table thread`
+**Gotcha:** end the query with `.build()` — `useQuery` will hang on a bare builder.
+
+### `optimistic-mutation`
+**When to use:** you're inserting a new record from a UI action (form submit, button click) and want the local cache to update immediately while the mutation drains to the remote.
+**Render:** `spky recipe optimistic-mutation --table thread`
+**Gotcha:** `db.create` takes a *full* record-ID string (`'thread:abc'`), not `(table, payload)`. Use `Uuid` to mint IDs.
+
+### `crdt-text-field`
+**When to use:** a `TYPE string` field is annotated `-- @crdt text` in your schema and several people should edit it at once.
+**Render:** `spky recipe crdt-text-field --table note --field body`
+**Gotcha:** edit through `useCrdtField(table, () => id, field)` and its `getDoc()`; never put the field in a `db.create` / `db.update` payload (the server owns it). The column itself is the server-written plain text, fine to read with `useQuery` for previews, but it trails live edits until the server folds the edit log. For `@crdt prosemirror` fields bind a ProseMirror editor with `loro-prosemirror` instead of a textarea.
+
+## Related
+
+- See `AGENTS.md` (in your project root or `node_modules/@spooky-sync/*/AGENTS.md`) for the broader mental model and gotchas.
+- After editing the schema: `spky generate` then `spky doctor` to confirm everything is in sync.

package/templates/cookbook/crdt-text-field.tsx

@@ -0,0 +1,54 @@
+// Recipe: crdt-text-field
+// A collaborative textarea for `{{table}}.{{field}}`, declared in the schema as
+//
+//   -- @crdt text
+//   DEFINE FIELD {{field}} ON TABLE {{table}} TYPE string;
+//
+// The editor binds to the field's Loro document. Each client sends only its own
+// edits (rows of the generated `{{table}}__crdt_log` table, through the outbox)
+// and merges everyone else's as they sync; the server folds them into the
+// canonical document. The `{{field}}` column itself is the server-written plain
+// text: render it for previews, never write it with `db.create` / `db.update`.
+
+import { createEffect, createSignal, onCleanup, Show } from 'solid-js';
+import { useCrdtField, useDb, useQuery } from '@spooky-sync/client-solid';
+import { schema } from '../schema.gen';
+
+export function {{TablePascal}}{{FieldPascal}}Editor(props: { id: string }) {
+  // 3 arguments: table, a reactive record id, field. Reopens when the id changes.
+  const field = useCrdtField('{{table}}', () => props.id, '{{field}}');
+  const [text, setText] = createSignal('');
+
+  // Follow the document: local and remote edits alike re-render the textarea.
+  createEffect(() => {
+    const doc = field()?.getDoc();
+    if (!doc) return;
+    const loroText = doc.getText('{{field}}');
+    setText(loroText.toString());
+    onCleanup(doc.subscribe(() => setText(loroText.toString())));
+  });
+
+  const handleInput = (e: InputEvent & { currentTarget: HTMLTextAreaElement }) => {
+    const doc = field()?.getDoc();
+    if (!doc) return;
+    // Diff into the document rather than replacing it, so concurrent edits merge.
+    doc.getText('{{field}}').update(e.currentTarget.value);
+    doc.commit();
+  };
+
+  return (
+    <Show when={field()} fallback={<p>Loading...</p>}>
+      <textarea value={text()} onInput={handleInput} />
+    </Show>
+  );
+}
+
+// Previews read the column like any other. It is the document's text as of the
+// server's last fold, so it trails live edits (a few seconds by default).
+export function {{TablePascal}}{{FieldPascal}}Preview(props: { id: string }) {
+  const db = useDb<typeof schema>();
+  const result = useQuery(() =>
+    db.query('{{table}}').where({ id: props.id } as any).build()
+  );
+  return <p>{result.data()?.[0]?.{{field}}}</p>;
+}

package/templates/cookbook/live-list.tsx

@@ -0,0 +1,22 @@
+// Recipe: live-list
+// Reactive, sorted list of `{{table}}` rows. Re-runs automatically as records change.
+
+import { For } from 'solid-js';
+import { useQuery, useDb } from '@spooky-sync/client-solid';
+import { schema } from '../schema.gen';
+
+export function {{TablePascal}}List() {
+  const db = useDb<typeof schema>();
+
+  const result = useQuery(() =>
+    db.query('{{table}}').orderBy('id', 'asc').limit(50).build()
+  );
+
+  return (
+    <ul>
+      <For each={result.data() ?? []}>
+        {(row) => <li>{row.id}</li>}
+      </For>
+    </ul>
+  );
+}

package/templates/cookbook/optimistic-mutation.tsx

@@ -0,0 +1,33 @@
+// Recipe: optimistic-mutation
+// Insert a new `{{table}}` row from a UI action. Local cache updates immediately;
+// the mutation drains to the remote in the background.
+
+import { createSignal } from 'solid-js';
+import { Uuid, useDb } from '@spooky-sync/client-solid';
+import { schema } from '../schema.gen';
+
+export function Create{{TablePascal}}Form() {
+  const db = useDb<typeof schema>();
+  const [submitting, setSubmitting] = createSignal(false);
+
+  const handleSubmit = async (e: SubmitEvent) => {
+    e.preventDefault();
+    setSubmitting(true);
+    try {
+      const id = new Uuid().toString();
+      await db.create(`{{table}}:${id}`, {
+        // TODO: fill in the fields your `{{table}}` schema requires.
+      });
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <button type="submit" disabled={submitting()}>
+        {submitting() ? 'Creating…' : 'Create {{table}}'}
+      </button>
+    </form>
+  );
+}

package/dist/resolve-binary-BYotYL89.js

@@ -1,51 +0,0 @@
-import { platform as s, arch as l } from "os";
-import { dirname as y, resolve as a } from "path";
-import { existsSync as e } from "fs";
-import { fileURLToPath as k } from "url";
-import { createRequire as d } from "module";
-const x = k(import.meta.url), m = y(x), f = {
-  "darwin-arm64": "@spooky-sync/cli-darwin-arm64",
-  "darwin-x64": "@spooky-sync/cli-darwin-x64",
-  "linux-arm64": "@spooky-sync/cli-linux-arm64",
-  "linux-x64": "@spooky-sync/cli-linux-x64",
-  "win32-x64": "@spooky-sync/cli-win32-x64"
-};
-function w() {
-  const r = `${s()}-${l()}`, o = f[r];
-  if (!o) return;
-  const n = s() === "win32" ? "spooky.exe" : "spooky";
-  try {
-    const t = d(import.meta.url).resolve(`${o}/package.json`);
-    return a(y(t), n);
-  } catch {
-    return;
-  }
-}
-function _() {
-  const r = s() === "win32" ? "spooky.exe" : "spooky", o = w();
-  if (o && e(o))
-    return o;
-  const n = a(m, "../target/release", r);
-  if (e(n))
-    return n;
-  const i = a(m, "..", r);
-  if (e(i))
-    return i;
-  const t = a(process.cwd(), r);
-  if (e(t))
-    return t;
-  const p = `${s()}-${l()}`, c = f[p], u = c ? `
-Try installing the platform package: npm install ${c}` : `
-Your platform (${p}) is not supported.`;
-  throw new Error(
-    `Could not find spooky binary. Checked paths:
-  - Platform package (${c ?? "none"})
-  - ${n}
-  - ${i}
-  - ${t}
-` + u
-  );
-}
-export {
-  _ as f
-};

package/dist/resolve-binary-CFmJcXEj.cjs

@@ -1,8 +0,0 @@
-"use strict";const n=require("os"),r=require("path"),c=require("fs"),d=require("url"),m=require("module");var o=typeof document<"u"?document.currentScript:null;const h=d.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:o&&o.tagName.toUpperCase()==="SCRIPT"&&o.src||new URL("resolve-binary-CFmJcXEj.cjs",document.baseURI).href),p=r.dirname(h),y={"darwin-arm64":"@spooky-sync/cli-darwin-arm64","darwin-x64":"@spooky-sync/cli-darwin-x64","linux-arm64":"@spooky-sync/cli-linux-arm64","linux-x64":"@spooky-sync/cli-linux-x64","win32-x64":"@spooky-sync/cli-win32-x64"};function k(){const t=`${n.platform()}-${n.arch()}`,e=y[t];if(!e)return;const s=n.platform()==="win32"?"spooky.exe":"spooky";try{const i=m.createRequire(typeof document>"u"?require("url").pathToFileURL(__filename).href:o&&o.tagName.toUpperCase()==="SCRIPT"&&o.src||new URL("resolve-binary-CFmJcXEj.cjs",document.baseURI).href).resolve(`${e}/package.json`);return r.resolve(r.dirname(i),s)}catch{return}}function x(){const t=n.platform()==="win32"?"spooky.exe":"spooky",e=k();if(e&&c.existsSync(e))return e;const s=r.resolve(p,"../target/release",t);if(c.existsSync(s))return s;const a=r.resolve(p,"..",t);if(c.existsSync(a))return a;const i=r.resolve(process.cwd(),t);if(c.existsSync(i))return i;const u=`${n.platform()}-${n.arch()}`,l=y[u],f=l?`
-Try installing the platform package: npm install ${l}`:`
-Your platform (${u}) is not supported.`;throw new Error(`Could not find spooky binary. Checked paths:
-  - Platform package (${l??"none"})
-  - ${s}
-  - ${a}
-  - ${i}
-`+f)}exports.findBinary=x;