@withone/cli 1.47.7 → 1.47.8

package/dist/index.js

@@ -8300,6 +8300,10 @@ function registerSyncSubcommands(sync) {
   sync.command("sql <platform/model> <sql>").description("Run a read-only SELECT / WITH / EXPLAIN against the memory store (type-scoped helper)").action(async (platformModel, sql) => {
     await syncSqlCommand(platformModel, sql);
   });
+  sync.command("schema <platform/model>").description("Inspect the JSON structure of synced records (field paths, types, examples) \u2014 useful before writing `sync sql` queries").action(async (platformModel) => {
+    const { syncSchemaCommand } = await import("./schema-DXHEU47V.js");
+    await syncSchemaCommand(platformModel);
+  });
   sync.command("delete <platform/model>").description('Delete records from local sync data (e.g. one sync delete notion/pages --id "abc-123")').option("--id <value>", "Delete record by ID").option("--where <conditions>", 'Delete records matching conditions (e.g. "status=archived")').option("--where-sql <predicate>", `Delete using a raw SQL WHERE clause (e.g. "json_extract(data, '$.type') = 'promotion'")`).option("--yes", "Skip confirmation prompt").action(async (platformModel, options) => {
     await syncDeleteCommand(platformModel, options);
   });
@@ -10019,6 +10023,7 @@ one --agent sync run stripe
 one --agent mem sync run stripe                    # identical (alias)
 
 # 5. Query + search (read from memory)
+one --agent sync schema stripe/customers                            # inspect field paths/types first
 one --agent sync query stripe/balanceTransactions --where "status=available" --limit 20
 one --agent sync query stripe/customers --where 'address.city=SF'   # dotted --where paths
 one --agent sync search "refund" --platform stripe                  # hybrid FTS + semantic
@@ -10259,6 +10264,7 @@ Every \`sync X\` command is also exposed as \`mem sync X\` \u2014 same handlers,
 | \`sync suggest-searchable <plat>/<model>\` | Rank candidate \`memory.searchable\` paths by signal density; emits paste-ready config |
 | \`sync run <platform>\` | Sync data (\`--full-refresh\`, \`--since\`, \`--dry-run\`, \`--no-memory\`) |
 | \`sync query <plat>/<model>\` | Query memory with \`--where\` (dotted paths), \`--after/before\` |
+| \`sync schema <plat>/<model>\` | Inspect the JSON structure of synced records (field paths, types, examples) \u2014 run before writing \`--where\` / query paths |
 | \`sync search "<query>"\` | Hybrid FTS + semantic across all synced data |
 | \`sync list [platform]\` | Show profiles, record counts, freshness |
 | \`sync schedule add/list/status/remove/repair\` | Manage cron schedules |

package/dist/schema-DXHEU47V.js

@@ -0,0 +1,109 @@
+import {
+  isAgentMode,
+  note,
+  okJson,
+  requireMemoryInit
+} from "./chunk-HS5AHQ4V.js";
+import {
+  getBackend
+} from "./chunk-OADHUAEU.js";
+import "./chunk-TXTRXV74.js";
+import "./chunk-K6MWE2ZH.js";
+
+// src/lib/memory/sync/schema.ts
+import pc from "picocolors";
+var SAMPLE_SIZE = 100;
+function typeOf(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array";
+  return typeof v;
+}
+function exampleOf(v) {
+  if (typeof v === "string") return v.length > 60 ? `${v.slice(0, 57)}\u2026` : v;
+  return v;
+}
+function addPath(path, value, acc) {
+  const t = typeOf(value);
+  let typeLabel;
+  if (t === "array") {
+    const arr = value;
+    const elemType = arr.length ? typeOf(arr[0]) : "unknown";
+    typeLabel = `array[${elemType}]`;
+  } else {
+    typeLabel = t;
+  }
+  const entry = acc.get(path) ?? { types: /* @__PURE__ */ new Set(), hasExample: false, presence: 0 };
+  entry.types.add(typeLabel);
+  entry.presence += 1;
+  if (!entry.hasExample && t !== "object" && t !== "array" && value !== null && value !== void 0) {
+    entry.example = exampleOf(value);
+    entry.hasExample = true;
+  }
+  acc.set(path, entry);
+  if (t === "object") {
+    for (const [k, v] of Object.entries(value)) {
+      addPath(path ? `${path}.${k}` : k, v, acc);
+    }
+  } else if (t === "array") {
+    const arr = value;
+    if (arr.length && typeOf(arr[0]) === "object") {
+      for (const [k, v] of Object.entries(arr[0])) {
+        addPath(`${path}[].${k}`, v, acc);
+      }
+    }
+  }
+}
+function inferSyncSchema(dataRecords) {
+  const acc = /* @__PURE__ */ new Map();
+  for (const data of dataRecords) {
+    if (!data || typeof data !== "object" || Array.isArray(data)) continue;
+    for (const [k, v] of Object.entries(data)) addPath(k, v, acc);
+  }
+  return [...acc.entries()].map(([path, e]) => ({
+    path,
+    types: [...e.types].sort(),
+    ...e.hasExample ? { example: e.example } : {},
+    presence: e.presence
+  })).sort((a, b) => a.path.localeCompare(b.path));
+}
+async function syncSchemaCommand(platformModel, _options = {}) {
+  requireMemoryInit();
+  const type = platformModel;
+  const backend = await getBackend();
+  let recordCount = 0;
+  try {
+    recordCount = await backend.count(type, { status: "active" });
+  } catch {
+  }
+  const records = await backend.list(type, { limit: SAMPLE_SIZE, status: "active" });
+  if (records.length === 0) {
+    if (isAgentMode()) {
+      okJson({ type, recordCount: 0, sampled: 0, fields: [] });
+      return;
+    }
+    note(`No records found for "${type}". Run \`one sync run <platform>\` first, or check \`one --agent sync status\`.`, "Schema");
+    return;
+  }
+  const fields = inferSyncSchema(records.map((r) => r.data));
+  if (isAgentMode()) {
+    okJson({ type, recordCount, sampled: records.length, fields });
+    return;
+  }
+  console.log();
+  console.log(`${pc.bold(type)} ${pc.dim(`(${recordCount.toLocaleString()} record${recordCount === 1 ? "" : "s"}, sampled ${records.length})`)}`);
+  console.log();
+  const pathWidth = Math.min(Math.max(...fields.map((f) => f.path.length), 4) + 2, 50);
+  const typeWidth = Math.max(...fields.map((f) => f.types.join("|").length), 4) + 2;
+  for (const f of fields) {
+    const optional = f.presence < records.length ? pc.yellow(" ?") : "";
+    const ex = f.example !== void 0 ? pc.dim(JSON.stringify(f.example)) : "";
+    console.log(`  ${f.path.padEnd(pathWidth)}${pc.cyan(f.types.join("|").padEnd(typeWidth))}${ex}${optional}`);
+  }
+  console.log();
+  console.log(pc.dim(`  ? = present in only some sampled records (optional/sparse field)`));
+  console.log();
+}
+export {
+  inferSyncSchema,
+  syncSchemaCommand
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withone/cli",
-  "version": "1.47.7",
+  "version": "1.47.8",
   "description": "CLI for managing One",
   "type": "module",
   "files": [

package/skills/one/SKILL.md

@@ -229,6 +229,7 @@ one --agent sync test attio/attioPeople --show-searchable
 
 # Run — memory is always written; pass --no-memory to skip (rare)
 one --agent sync run stripe
+one --agent sync schema stripe/customers         # inspect field paths/types before querying
 one --agent sync query stripe/balanceTransactions --where "status=available" --limit 20
 one --agent sync search "refund"                 # hybrid across all synced platforms
 one --agent sync list stripe                     # progress + freshness