@fold-run/cli 0.1.2 → 0.2.0

package/dist/lib/bundler.js

@@ -2,40 +2,113 @@ import { build } from 'esbuild';
 /**
  * Dev shim for @fold-run/runtime — stubs all platform bindings for local development.
  * Injected by the esbuild plugin when bundling for `fold dev`.
+ *
+ * Stubs provide functional in-memory implementations for KV and Storage,
+ * logged no-ops for AI/Queue/Vectorize, and middleware support in defineHandler.
  */
 const FOLD_RUNTIME_DEV_SHIM = `
 class DevKV {
   constructor() { this._store = new Map(); }
-  async get(key) { return this._store.get(key) ?? null; }
-  async put(key, value) { this._store.set(key, value); }
+  async get(key, opts) {
+    const val = this._store.get(key);
+    if (val === undefined) return null;
+    if (opts?.type === 'json') return JSON.parse(val);
+    if (opts?.type === 'arrayBuffer') return new TextEncoder().encode(val).buffer;
+    return val;
+  }
+  async put(key, value, opts) {
+    const str = typeof value === 'string' ? value : '[binary]';
+    this._store.set(key, str);
+    if (opts?.expirationTtl) {
+      setTimeout(() => this._store.delete(key), opts.expirationTtl * 1000);
+    }
+  }
   async delete(key) { this._store.delete(key); }
   async list(opts) {
-    const keys = [...this._store.keys()].filter(k => !opts?.prefix || k.startsWith(opts.prefix));
-    return { keys: keys.slice(0, opts?.limit ?? 1000).map(name => ({ name })) };
+    const all = [...this._store.keys()];
+    const filtered = opts?.prefix ? all.filter(k => k.startsWith(opts.prefix)) : all;
+    const limited = filtered.slice(0, opts?.limit ?? 1000);
+    return { keys: limited.map(name => ({ name })), list_complete: limited.length === filtered.length, cursor: undefined };
   }
 }
+
 class DevStorage {
-  async put() { console.warn('[fold dev] Storage binding not available locally'); }
-  async get() { return null; }
-  async delete() {}
-  async list() { return { objects: [] }; }
+  constructor() { this._store = new Map(); }
+  async put(key, value) {
+    let body;
+    if (typeof value === 'string') body = value;
+    else if (value instanceof ArrayBuffer) body = new TextDecoder().decode(value);
+    else body = '[stream/blob]';
+    const obj = { key, size: body.length, etag: Math.random().toString(36).slice(2), uploaded: new Date(), body };
+    this._store.set(key, obj);
+    return { key: obj.key, size: obj.size, etag: obj.etag, uploaded: obj.uploaded };
+  }
+  async get(key) {
+    const obj = this._store.get(key);
+    if (!obj) return null;
+    const body = obj.body;
+    return {
+      key: obj.key, size: obj.size, etag: obj.etag, uploaded: obj.uploaded,
+      body: new ReadableStream({ start(c) { c.enqueue(new TextEncoder().encode(body)); c.close(); } }),
+      bodyUsed: false,
+      text: async () => body,
+      json: async () => JSON.parse(body),
+      arrayBuffer: async () => new TextEncoder().encode(body).buffer,
+      blob: async () => new Blob([body]),
+    };
+  }
+  async head(key) {
+    const obj = this._store.get(key);
+    if (!obj) return null;
+    return { key: obj.key, size: obj.size, etag: obj.etag, uploaded: obj.uploaded };
+  }
+  async delete(keys) {
+    const arr = Array.isArray(keys) ? keys : [keys];
+    for (const k of arr) this._store.delete(k);
+  }
+  async list(opts) {
+    const all = [...this._store.keys()];
+    const filtered = opts?.prefix ? all.filter(k => k.startsWith(opts.prefix)) : all;
+    const limited = filtered.slice(0, opts?.limit ?? 1000);
+    return {
+      objects: limited.map(k => { const o = this._store.get(k); return { key: o.key, size: o.size, etag: o.etag, uploaded: o.uploaded }; }),
+      truncated: limited.length < filtered.length,
+      cursor: undefined,
+      delimitedPrefixes: [],
+    };
+  }
 }
+
 class DevDB {
-  prepare() {
-    const noop = { bind: () => noop, first: async () => null, all: async () => ({ results: [] }), run: async () => ({ success: true, meta: {} }) };
+  prepare(query) {
+    console.log('[fold dev] DB.prepare:', query.slice(0, 80));
+    const noop = { bind: () => noop, first: async () => null, all: async () => ({ results: [], success: true }), run: async () => ({ success: true, meta: {} }) };
     return noop;
   }
+  async batch(stmts) { console.log('[fold dev] DB.batch:', stmts.length, 'statements'); return []; }
+  async exec(query) { console.log('[fold dev] DB.exec:', query.slice(0, 80)); return { count: 0, duration: 0 }; }
 }
+
 class DevAI {
-  async run(model) {
-    console.warn('[fold dev] AI.run("' + model + '") is not available locally');
+  async run(model, inputs) {
+    console.warn('[fold dev] AI.run("' + model + '") — returns empty stub. Use fold deploy to test with real models.');
     return {};
   }
 }
+
 class DevQueue {
-  async send(body) { console.log('[fold dev] Queue.send:', body); }
+  async send(body) { console.log('[fold dev] Queue.send:', JSON.stringify(body).slice(0, 200)); }
   async sendBatch(messages) { console.log('[fold dev] Queue.sendBatch:', messages.length, 'messages'); }
 }
+
+class DevVectorize {
+  async insert(vectors) { console.warn('[fold dev] Vectorize.insert:', vectors.length, 'vectors — stub'); return { count: vectors.length, ids: vectors.map(v => v.id) }; }
+  async upsert(vectors) { console.warn('[fold dev] Vectorize.upsert:', vectors.length, 'vectors — stub'); return { count: vectors.length, ids: vectors.map(v => v.id) }; }
+  async query() { return { matches: [], count: 0 }; }
+  async getByIds() { return []; }
+  async deleteByIds(ids) { return { count: ids.length, ids }; }
+}
+
 class FoldContext {
   constructor(request, env) {
     this.request = request;
@@ -44,33 +117,66 @@ class FoldContext {
     this.db = new DevDB();
     this.ai = new DevAI();
     this.queue = new DevQueue();
+    this.vectorize = new DevVectorize();
     this.tenantId = undefined;
+    this._waitUntil = null;
     const managed = new Set(['AI', 'VECTORIZE', 'KV', 'DB', 'STORAGE', 'QUEUE', 'FOLD_TENANT_ID']);
     this.env = Object.fromEntries(
       Object.entries(env).filter(([k, v]) => !managed.has(k) && typeof v === 'string').map(([k, v]) => [k, v])
     );
   }
+  waitUntil(promise) { if (this._waitUntil) this._waitUntil(promise); }
   json(data, status = 200) { return Response.json(data, { status }); }
   text(body, status = 200) { return new Response(body, { status, headers: { 'content-type': 'text/plain' } }); }
+  async body() { return this.request.json(); }
+  query(name) { return new URL(this.request.url).searchParams.get(name); }
+  queries() { return Object.fromEntries(new URL(this.request.url).searchParams.entries()); }
+  header(name) { return this.request.headers.get(name); }
   stream(generator) {
     const { readable, writable } = new TransformStream();
     const writer = writable.getWriter();
     const enc = new TextEncoder();
     (async () => {
       try { for await (const chunk of generator()) await writer.write(enc.encode(chunk)); }
-      finally { await writer.close(); }
+      catch (err) { try { await writer.write(enc.encode('event: error\\ndata: ' + JSON.stringify({ error: err?.message ?? 'Stream error' }) + '\\n\\n')); } catch {} }
+      finally { try { await writer.close(); } catch {} }
     })();
-    return new Response(readable, { headers: { 'content-type': 'text/event-stream', 'cache-control': 'no-cache' } });
+    return new Response(readable, { headers: { 'content-type': 'text/event-stream', 'cache-control': 'no-cache', 'connection': 'keep-alive' } });
   }
 }
+
+function composeMiddleware(middleware, handler) {
+  return (ctx) => {
+    let index = 0;
+    const dispatch = () => {
+      if (index < middleware.length) { const mw = middleware[index++]; return Promise.resolve(mw(ctx, dispatch)); }
+      return Promise.resolve(handler(ctx));
+    };
+    return dispatch();
+  };
+}
+
 export function defineHandler(handlerOrOptions) {
-  const fetchFn = typeof handlerOrOptions === 'function' ? handlerOrOptions : handlerOrOptions.fetch;
+  const isOptions = typeof handlerOrOptions !== 'function';
+  const rawFetchFn = isOptions ? handlerOrOptions.fetch : handlerOrOptions;
+  const middleware = isOptions ? handlerOrOptions.middleware : undefined;
+  const scheduledFn = isOptions ? handlerOrOptions.scheduled : undefined;
+  const fetchFn = middleware?.length ? composeMiddleware(middleware, rawFetchFn) : rawFetchFn;
   return {
-    async fetch(request, env) {
+    async fetch(request, env, ctx) {
       const context = new FoldContext(request, env ?? {});
+      context._waitUntil = ctx?.waitUntil?.bind(ctx);
       try { return await fetchFn(context); }
       catch (err) { return Response.json({ error: err instanceof Error ? err.message : 'Internal error' }, { status: 500 }); }
     },
+    ...(scheduledFn && {
+      async scheduled(event, env, ctx) {
+        const req = new Request('https://scheduled.internal/__scheduled', { method: 'POST' });
+        const context = new FoldContext(req, env ?? {});
+        context._waitUntil = ctx?.waitUntil?.bind(ctx);
+        await scheduledFn(context, event);
+      }
+    }),
   };
 }
 export { FoldContext };
@@ -103,7 +209,7 @@ export async function bundleFile(entryPoint, opts = {}) {
         write: false,
         format: 'esm',
         target: 'esnext',
-        platform: 'browser', // Workers runtime is closer to browser than node
+        platform: 'browser',
         minify: !opts.dev,
         treeShaking: true,
         conditions: ['worker', 'browser'],

package/dist/lib/bundler.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../src/lib/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuE7B,CAAC;AAEF,qEAAqE;AACrE,MAAM,oBAAoB,GAAW;IACnC,IAAI,EAAE,kBAAkB;IACxB,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAC,CAAC;QACJ,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,QAAQ,EAAE,qBAAqB;YAC/B,MAAM,EAAE,IAAI;SACb,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,OAA0B,EAAE;IAC/E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,SAAS,EAAE,iDAAiD;QACtE,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG;QACjB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QACjC,2EAA2E;QAC3E,yEAAyE;QACzE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,mBAAmB,CAAC;QAC7E,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE;KAChD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../src/lib/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,SAAS,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8K7B,CAAC;AAEF,qEAAqE;AACrE,MAAM,oBAAoB,GAAW;IACnC,IAAI,EAAE,kBAAkB;IACxB,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAC,CAAC;QACJ,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACnE,QAAQ,EAAE,qBAAqB;YAC/B,MAAM,EAAE,IAAI;SACb,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,OAA0B,EAAE;IAC/E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG;QACjB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QACjC,2EAA2E;QAC3E,yEAAyE;QACzE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,mBAAmB,CAAC;QAC7E,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE;KAChD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/lib/colorize.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Colorize a JSON string for terminal display.
+ * Applies syntax highlighting to keys, strings, numbers, booleans, and null.
+ */
+export declare function colorizeJson(json: string): string;

package/dist/lib/colorize.js

@@ -0,0 +1,28 @@
+// Lightweight JSON syntax highlighting for terminal output.
+// No dependencies — uses ANSI escape codes directly.
+const RESET = '\x1b[0m';
+const CYAN = '\x1b[36m'; // keys
+const GREEN = '\x1b[32m'; // strings
+const YELLOW = '\x1b[33m'; // numbers
+const MAGENTA = '\x1b[35m'; // booleans, null
+/**
+ * Colorize a JSON string for terminal display.
+ * Applies syntax highlighting to keys, strings, numbers, booleans, and null.
+ */
+export function colorizeJson(json) {
+    return json.replace(/("(?:\\.|[^"\\])*")\s*(:)?|(\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b)|(\bnull\b|\btrue\b|\bfalse\b)/g, (match, str, colon, num, lit) => {
+        if (str) {
+            // It's a string — is it a key (followed by :) or a value?
+            if (colon) {
+                return `${CYAN}${str}${RESET}:`;
+            }
+            return `${GREEN}${str}${RESET}`;
+        }
+        if (num)
+            return `${YELLOW}${num}${RESET}`;
+        if (lit)
+            return `${MAGENTA}${lit}${RESET}`;
+        return match;
+    });
+}
+//# sourceMappingURL=colorize.js.map

package/dist/lib/colorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorize.js","sourceRoot":"","sources":["../../src/lib/colorize.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,qDAAqD;AAErD,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,OAAO;AAChC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,UAAU;AACpC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,UAAU;AACrC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,iBAAiB;AAE7C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CACjB,gGAAgG,EAChG,CAAC,KAAK,EAAE,GAAuB,EAAE,KAAyB,EAAE,GAAuB,EAAE,GAAuB,EAAE,EAAE;QAC9G,IAAI,GAAG,EAAE,CAAC;YACR,0DAA0D;YAC1D,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,KAAK,GAAG,CAAC;YAClC,CAAC;YACD,OAAO,GAAG,KAAK,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;QAClC,CAAC;QACD,IAAI,GAAG;YAAE,OAAO,GAAG,MAAM,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;QAC1C,IAAI,GAAG;YAAE,OAAO,GAAG,OAAO,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/cron.d.ts

@@ -0,0 +1,13 @@
+export interface CronValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate a cron expression.
+ * Returns { valid: true } or { valid: false, error: "..." }
+ */
+export declare function validateCron(expression: string): CronValidationResult;
+/**
+ * Format a cron validation error with usage hint.
+ */
+export declare function formatCronError(error: string): string;

package/dist/lib/cron.js

@@ -0,0 +1,107 @@
+// Cron expression validator for standard 5-field cron format:
+//   minute hour day-of-month month day-of-week
+// Supports: numbers, ranges (1-5), steps (e.g. every 5), lists (1,3,5), wildcards (*)
+const CRON_FIELDS = [
+    { name: 'minute', min: 0, max: 59 },
+    { name: 'hour', min: 0, max: 23 },
+    { name: 'day of month', min: 1, max: 31 },
+    { name: 'month', min: 1, max: 12 },
+    { name: 'day of week', min: 0, max: 7 }, // 0 and 7 are both Sunday
+];
+// Validate a single cron field value (e.g., "5", "1-10", "1,5,10")
+function validateField(value, field) {
+    // Wildcard
+    if (value === '*') {
+        return null;
+    }
+    // Step values: */5 or 1-10/2
+    if (value.includes('/')) {
+        const [range, stepStr] = value.split('/');
+        const step = parseInt(stepStr, 10);
+        if (Number.isNaN(step) || step < 1) {
+            return `invalid step value "${stepStr}" in ${field.name}`;
+        }
+        // Validate the range part
+        if (range !== '*') {
+            const rangeError = validateField(range, field);
+            if (rangeError)
+                return rangeError;
+        }
+        return null;
+    }
+    // List values: 1,5,10
+    if (value.includes(',')) {
+        const parts = value.split(',');
+        for (const part of parts) {
+            const error = validateField(part.trim(), field);
+            if (error)
+                return error;
+        }
+        return null;
+    }
+    // Range values: 1-10
+    if (value.includes('-')) {
+        const [startStr, endStr] = value.split('-');
+        const start = parseInt(startStr, 10);
+        const end = parseInt(endStr, 10);
+        if (Number.isNaN(start) || Number.isNaN(end)) {
+            return `invalid range "${value}" in ${field.name}`;
+        }
+        if (start < field.min || start > field.max) {
+            return `${field.name} start value ${start} out of range (${field.min}-${field.max})`;
+        }
+        if (end < field.min || end > field.max) {
+            return `${field.name} end value ${end} out of range (${field.min}-${field.max})`;
+        }
+        if (start > end) {
+            return `invalid range "${value}" in ${field.name}: start > end`;
+        }
+        return null;
+    }
+    // Single number
+    const num = parseInt(value, 10);
+    if (Number.isNaN(num)) {
+        return `invalid value "${value}" in ${field.name}`;
+    }
+    if (num < field.min || num > field.max) {
+        return `${field.name} value ${num} out of range (${field.min}-${field.max})`;
+    }
+    return null;
+}
+/**
+ * Validate a cron expression.
+ * Returns { valid: true } or { valid: false, error: "..." }
+ */
+export function validateCron(expression) {
+    const trimmed = expression.trim();
+    if (!trimmed) {
+        return { valid: false, error: 'cron expression cannot be empty' };
+    }
+    const fields = trimmed.split(/\s+/);
+    if (fields.length !== 5) {
+        return {
+            valid: false,
+            error: `expected 5 fields (minute hour day month weekday), got ${fields.length}`,
+        };
+    }
+    for (let i = 0; i < 5; i++) {
+        const error = validateField(fields[i], CRON_FIELDS[i]);
+        if (error) {
+            return { valid: false, error };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Format a cron validation error with usage hint.
+ */
+export function formatCronError(error) {
+    return `Invalid cron expression: ${error}
+
+Format: <minute> <hour> <day> <month> <weekday>
+Examples:
+  */5 * * * *     Every 5 minutes
+  0 9 * * 1-5     9 AM on weekdays
+  0 0 1 * *       Midnight on the 1st of each month`;
+}
+//# sourceMappingURL=cron.js.map

package/dist/lib/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/lib/cron.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,+CAA+C;AAC/C,sFAAsF;AAQtF,MAAM,WAAW,GAAgB;IAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACnC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACjC,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACzC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAClC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,0BAA0B;CACpE,CAAC;AAEF,mEAAmE;AACnE,SAAS,aAAa,CAAC,KAAa,EAAE,KAAgB;IACpD,WAAW;IACX,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,uBAAuB,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,0BAA0B;QAC1B,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,UAAU;gBAAE,OAAO,UAAU,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB;IACtB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,kBAAkB,KAAK,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC3C,OAAO,GAAG,KAAK,CAAC,IAAI,gBAAgB,KAAK,kBAAkB,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC;QACvF,CAAC;QACD,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACvC,OAAO,GAAG,KAAK,CAAC,IAAI,cAAc,GAAG,kBAAkB,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC;QACnF,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,OAAO,kBAAkB,KAAK,QAAQ,KAAK,CAAC,IAAI,eAAe,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB;IAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,kBAAkB,KAAK,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACvC,OAAO,GAAG,KAAK,CAAC,IAAI,UAAU,GAAG,kBAAkB,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC;IAC/E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAElC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,0DAA0D,MAAM,CAAC,MAAM,EAAE;SACjF,CAAC;IACJ,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,4BAA4B,KAAK;;;;;;oDAMU,CAAC;AACrD,CAAC"}

package/dist/lib/manifest.d.ts

@@ -0,0 +1,31 @@
+export interface FoldManifest {
+    name?: string;
+    entrypoint?: string;
+    tenant_id?: string;
+    intent?: {
+        trigger?: string;
+        bindings?: string[];
+    };
+}
+export interface ManifestValidationError {
+    field: string;
+    message: string;
+}
+export interface ManifestResult {
+    manifest: FoldManifest | null;
+    errors: ManifestValidationError[];
+    warnings: string[];
+}
+/**
+ * Load and validate fold.json from current directory.
+ * Returns manifest (if valid), errors (blocking), and warnings (non-blocking).
+ */
+export declare function loadManifest(dir?: string): ManifestResult;
+/**
+ * Format validation errors for display.
+ */
+export declare function formatManifestErrors(errors: ManifestValidationError[]): string;
+/**
+ * Format warnings for display.
+ */
+export declare function formatManifestWarnings(warnings: string[]): string;

package/dist/lib/manifest.js

@@ -0,0 +1,195 @@
+// fold.json manifest validation
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+const KNOWN_FIELDS = ['name', 'entrypoint', 'tenant_id', 'intent'];
+const KNOWN_INTENT_FIELDS = ['trigger', 'bindings'];
+const VALID_TRIGGERS = ['http', 'cron', 'webhook', 'queue'];
+const VALID_BINDINGS = ['kv', 'storage', 'db', 'queue', 'ai'];
+function validateType(value, field, expected) {
+    const actual = Array.isArray(value) ? 'array' : typeof value;
+    if (actual !== expected) {
+        return `"${field}" must be a ${expected}, got ${actual}`;
+    }
+    return null;
+}
+/**
+ * Load and validate fold.json from current directory.
+ * Returns manifest (if valid), errors (blocking), and warnings (non-blocking).
+ */
+export function loadManifest(dir) {
+    const manifestPath = resolve(dir ?? '.', 'fold.json');
+    const errors = [];
+    const warnings = [];
+    if (!existsSync(manifestPath)) {
+        return { manifest: null, errors: [], warnings: [] };
+    }
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, 'utf-8');
+    }
+    catch (err) {
+        errors.push({ field: 'file', message: `Could not read fold.json: ${err}` });
+        return { manifest: null, errors, warnings };
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (err) {
+        const parseErr = err;
+        errors.push({ field: 'json', message: `Invalid JSON: ${parseErr.message}` });
+        return { manifest: null, errors, warnings };
+    }
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        errors.push({ field: 'root', message: 'fold.json must be an object' });
+        return { manifest: null, errors, warnings };
+    }
+    const obj = data;
+    // Check for unknown top-level fields
+    for (const key of Object.keys(obj)) {
+        if (!KNOWN_FIELDS.includes(key)) {
+            warnings.push(`Unknown field "${key}" in fold.json (will be ignored)`);
+        }
+    }
+    // Validate name
+    if (obj.name !== undefined) {
+        const typeErr = validateType(obj.name, 'name', 'string');
+        if (typeErr) {
+            errors.push({ field: 'name', message: typeErr });
+        }
+        else if (typeof obj.name === 'string') {
+            if (obj.name.trim() === '') {
+                errors.push({ field: 'name', message: '"name" cannot be empty' });
+            }
+            else if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/.test(obj.name)) {
+                errors.push({
+                    field: 'name',
+                    message: '"name" must be lowercase alphanumeric with hyphens (e.g., "my-function")',
+                });
+            }
+        }
+    }
+    // Validate entrypoint
+    if (obj.entrypoint !== undefined) {
+        const typeErr = validateType(obj.entrypoint, 'entrypoint', 'string');
+        if (typeErr) {
+            errors.push({ field: 'entrypoint', message: typeErr });
+        }
+        else if (typeof obj.entrypoint === 'string') {
+            if (obj.entrypoint.trim() === '') {
+                errors.push({ field: 'entrypoint', message: '"entrypoint" cannot be empty' });
+            }
+            else {
+                const entryPath = resolve(dir ?? '.', obj.entrypoint);
+                if (!existsSync(entryPath)) {
+                    errors.push({
+                        field: 'entrypoint',
+                        message: `Entrypoint file not found: ${obj.entrypoint}`,
+                    });
+                }
+            }
+        }
+    }
+    // Validate tenant_id
+    if (obj.tenant_id !== undefined) {
+        const typeErr = validateType(obj.tenant_id, 'tenant_id', 'string');
+        if (typeErr) {
+            errors.push({ field: 'tenant_id', message: typeErr });
+        }
+        else if (typeof obj.tenant_id === 'string' && obj.tenant_id.trim() === '') {
+            errors.push({ field: 'tenant_id', message: '"tenant_id" cannot be empty' });
+        }
+    }
+    // Validate intent
+    if (obj.intent !== undefined) {
+        const typeErr = validateType(obj.intent, 'intent', 'object');
+        if (typeErr) {
+            errors.push({ field: 'intent', message: typeErr });
+        }
+        else if (typeof obj.intent === 'object' && obj.intent !== null && !Array.isArray(obj.intent)) {
+            const intent = obj.intent;
+            // Check for unknown intent fields
+            for (const key of Object.keys(intent)) {
+                if (!KNOWN_INTENT_FIELDS.includes(key)) {
+                    warnings.push(`Unknown field "intent.${key}" (will be ignored)`);
+                }
+            }
+            // Validate trigger
+            if (intent.trigger !== undefined) {
+                const triggerErr = validateType(intent.trigger, 'intent.trigger', 'string');
+                if (triggerErr) {
+                    errors.push({ field: 'intent.trigger', message: triggerErr });
+                }
+                else if (typeof intent.trigger === 'string' && !VALID_TRIGGERS.includes(intent.trigger)) {
+                    warnings.push(`Unknown trigger "${intent.trigger}" (valid: ${VALID_TRIGGERS.join(', ')})`);
+                }
+            }
+            // Validate bindings
+            if (intent.bindings !== undefined) {
+                const bindingsErr = validateType(intent.bindings, 'intent.bindings', 'array');
+                if (bindingsErr) {
+                    errors.push({ field: 'intent.bindings', message: bindingsErr });
+                }
+                else if (Array.isArray(intent.bindings)) {
+                    for (let i = 0; i < intent.bindings.length; i++) {
+                        const b = intent.bindings[i];
+                        if (typeof b !== 'string') {
+                            errors.push({
+                                field: `intent.bindings[${i}]`,
+                                message: `Binding must be a string, got ${typeof b}`,
+                            });
+                        }
+                        else if (!VALID_BINDINGS.includes(b)) {
+                            warnings.push(`Unknown binding "${b}" (valid: ${VALID_BINDINGS.join(', ')})`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { manifest: null, errors, warnings };
+    }
+    // Build validated manifest
+    const manifest = {};
+    if (typeof obj.name === 'string')
+        manifest.name = obj.name;
+    if (typeof obj.entrypoint === 'string')
+        manifest.entrypoint = obj.entrypoint;
+    if (typeof obj.tenant_id === 'string')
+        manifest.tenant_id = obj.tenant_id;
+    if (typeof obj.intent === 'object' && obj.intent !== null) {
+        const intent = obj.intent;
+        manifest.intent = {};
+        if (typeof intent.trigger === 'string')
+            manifest.intent.trigger = intent.trigger;
+        if (Array.isArray(intent.bindings)) {
+            manifest.intent.bindings = intent.bindings.filter((b) => typeof b === 'string');
+        }
+    }
+    return { manifest, errors, warnings };
+}
+/**
+ * Format validation errors for display.
+ */
+export function formatManifestErrors(errors) {
+    const lines = ['Invalid fold.json:', ''];
+    for (const err of errors) {
+        lines.push(`  \x1b[31m✗\x1b[0m ${err.message}`);
+    }
+    lines.push('');
+    lines.push('Example fold.json:');
+    lines.push('  {');
+    lines.push('    "name": "my-function",');
+    lines.push('    "entrypoint": "function.ts",');
+    lines.push('    "intent": { "bindings": ["kv"] }');
+    lines.push('  }');
+    return lines.join('\n');
+}
+/**
+ * Format warnings for display.
+ */
+export function formatManifestWarnings(warnings) {
+    return warnings.map((w) => `\x1b[33mWarning:\x1b[0m ${w}`).join('\n');
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/lib/manifest.ts"],"names":[],"mappings":"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"}

package/dist/lib/prompt.d.ts

@@ -1,3 +1,30 @@
+/**
+ * Prompt for yes/no confirmation. Returns true if user confirms.
+ * Defaults to 'no' if user just presses enter.
+ */
+export declare function confirm(message: string): Promise<boolean>;
+/**
+ * Prompt for a single line of text input.
+ * Returns the trimmed input, or defaultValue if the user presses Enter.
+ */
+export declare function ask(message: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt the user to select from a list of options using arrow keys.
+ * Returns the selected option value. Falls back to numbered list on non-TTY.
+ */
+export declare function select<T extends string>(message: string, options: {
+    label: string;
+    value: T;
+}[]): Promise<T>;
+/**
+ * Prompt for toggling multiple options on/off. Returns selected values.
+ * Space to toggle, Enter to confirm.
+ */
+export declare function multiSelect<T extends string>(message: string, options: {
+    label: string;
+    value: T;
+    default?: boolean;
+}[]): Promise<T[]>;
 /**
  * Read a line of input with masked output (shows * for each character).
  * Handles backspace and Ctrl+C.