clawnify 0.11.7 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -0
- package/dist/{chunk-DOMSGMWA.js → chunk-TR3GJVCX.js} +15 -4
- package/dist/chunk-TR3GJVCX.js.map +1 -0
- package/dist/{cli-KNQJJMHG.js → cli-UFC2VLJT.js} +179 -13
- package/dist/cli-UFC2VLJT.js.map +1 -0
- package/dist/index.js +2 -2
- package/dist/{mcp-ERAYEJ63.js → mcp-FQ7VFFFF.js} +2 -2
- package/package.json +1 -1
- package/dist/chunk-DOMSGMWA.js.map +0 -1
- package/dist/cli-KNQJJMHG.js.map +0 -1
- /package/dist/{mcp-ERAYEJ63.js.map → mcp-FQ7VFFFF.js.map} +0 -0
package/README.md
CHANGED
|
@@ -100,6 +100,11 @@ clawnify open <slug> # Open app in browser
|
|
|
100
100
|
clawnify logs <app-id> # View build logs
|
|
101
101
|
clawnify rm <app-id> # Delete an app
|
|
102
102
|
clawnify whoami # Show current user
|
|
103
|
+
clawnify flows list # List ClawFlow drafts + latest published version
|
|
104
|
+
clawnify flows read <name> # Print a flow's current draft definition
|
|
105
|
+
clawnify flows create <name> --file flow.json # Create a draft (validated on-box)
|
|
106
|
+
clawnify flows edit <name> # Edit the draft in $EDITOR (or --file)
|
|
107
|
+
clawnify flows publish <name> # Publish the draft as the next numbered version
|
|
103
108
|
clawnify ai-files install # Install rules + skills + MCP into your agent(s)
|
|
104
109
|
clawnify ai-files uninstall # Remove them
|
|
105
110
|
```
|
|
@@ -418,7 +418,12 @@ function runGit(args, dir) {
|
|
|
418
418
|
return execSync(`git ${args.join(" ")}`, {
|
|
419
419
|
cwd: dir,
|
|
420
420
|
encoding: "utf-8",
|
|
421
|
-
stdio: ["pipe", "pipe", "pipe"]
|
|
421
|
+
stdio: ["pipe", "pipe", "pipe"],
|
|
422
|
+
// execSync's default maxBuffer is 1MB. `ls-files --others` enumerates
|
|
423
|
+
// every file under an unignored node_modules, which easily exceeds that —
|
|
424
|
+
// the throw was caught below and untracked files silently vanished from
|
|
425
|
+
// the archive (new assets never deployed).
|
|
426
|
+
maxBuffer: 64 * 1024 * 1024
|
|
422
427
|
});
|
|
423
428
|
} catch {
|
|
424
429
|
return null;
|
|
@@ -427,7 +432,13 @@ function runGit(args, dir) {
|
|
|
427
432
|
function getGitFiles(dir) {
|
|
428
433
|
const tracked = runGit(["ls-files", "-z"], dir);
|
|
429
434
|
if (tracked === null) return null;
|
|
430
|
-
const
|
|
435
|
+
const untrackedResult = runGit(["ls-files", "-z", "--others", "--exclude-standard"], dir);
|
|
436
|
+
if (untrackedResult === null) {
|
|
437
|
+
console.warn(
|
|
438
|
+
" warning: could not list untracked files (git ls-files --others failed); newly created files that aren't committed may be missing from this deploy."
|
|
439
|
+
);
|
|
440
|
+
}
|
|
441
|
+
const untracked = untrackedResult ?? "";
|
|
431
442
|
const merged = /* @__PURE__ */ new Set();
|
|
432
443
|
for (const f of tracked.split("\0")) if (f) merged.add(f);
|
|
433
444
|
for (const f of untracked.split("\0")) if (f) merged.add(f);
|
|
@@ -582,7 +593,7 @@ async function pollUntilReady(resourceId, options = {}) {
|
|
|
582
593
|
}
|
|
583
594
|
|
|
584
595
|
// src/version.ts
|
|
585
|
-
var VERSION = "0.
|
|
596
|
+
var VERSION = "0.12.0";
|
|
586
597
|
|
|
587
598
|
export {
|
|
588
599
|
OAUTH_CLIENT_ID,
|
|
@@ -606,4 +617,4 @@ export {
|
|
|
606
617
|
pollUntilReady,
|
|
607
618
|
VERSION
|
|
608
619
|
};
|
|
609
|
-
//# sourceMappingURL=chunk-
|
|
620
|
+
//# sourceMappingURL=chunk-TR3GJVCX.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/lib/auth.ts","../src/lib/config.ts","../src/lib/api.ts","../src/lib/archive.ts","../src/lib/poll.ts","../src/version.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport crypto from \"node:crypto\";\nimport { homedir } from \"node:os\";\nimport { setTimeout as sleep } from \"node:timers/promises\";\n\nconst SUPABASE_URL = \"https://auth.clawnify.com\";\nconst SUPABASE_ANON_KEY =\n \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Imh0a3l4Zm1pbXlkeG5iemd4aGZ6Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzgzNDk5MjEsImV4cCI6MjA1MzkyNTkyMX0.wopxB_gQSbNMPuxLUNK0BrGXE_0JxJqzMYFPeXFV1GE\";\nexport const OAUTH_CLIENT_ID = \"3defc0e6-80de-4e7a-aa36-0b501c06b697\";\nexport const OAUTH_AUTHORIZE_URL = `${SUPABASE_URL}/auth/v1/oauth/authorize`;\nexport const OAUTH_TOKEN_URL = `${SUPABASE_URL}/auth/v1/oauth/token`;\n\nconst AUTH_DIR = path.join(homedir(), \".clawnify\");\nconst AUTH_FILE = path.join(AUTH_DIR, \"auth.json\");\nconst LOCK_FILE = path.join(AUTH_DIR, \"auth.lock\");\n\n// A refresh POST is a single network round-trip; anything holding the lock\n// longer than this has crashed, so the lock is stolen. The wait timeout is a\n// bit longer so a legitimately in-flight refresh is never pre-empted.\nconst LOCK_STALE_MS = 15_000;\nconst LOCK_WAIT_MS = 20_000;\n\nexport interface AuthData {\n access_token: string;\n refresh_token: string;\n expires_at: number;\n org_id?: string;\n org_slug?: string;\n}\n\nexport function loadAuth(): AuthData | null {\n try {\n const data = fs.readFileSync(AUTH_FILE, \"utf-8\");\n return JSON.parse(data) as AuthData;\n } catch {\n return null;\n }\n}\n\nexport function saveAuth(data: AuthData): void {\n fs.mkdirSync(AUTH_DIR, { recursive: true, mode: 0o700 });\n fs.writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });\n}\n\nexport function clearAuth(): void {\n try {\n fs.unlinkSync(AUTH_FILE);\n } catch {\n // ignore if not exists\n }\n}\n\nexport async function getValidToken(): Promise<string | null> {\n // An env-provided token wins entirely — a headless agent / CI can't do the\n // browser OAuth. CLAWNIFY_TOKEN must be a Supabase access token (JWT), minted\n // by whatever runs the CLI; it is used as-is and never refreshed.\n if (process.env.CLAWNIFY_TOKEN) return process.env.CLAWNIFY_TOKEN;\n\n const auth = loadAuth();\n if (!auth) return null;\n\n const now = Math.floor(Date.now() / 1000);\n if (auth.expires_at - 60 > now) {\n return auth.access_token;\n }\n\n // Locally expired — refresh under a cross-process lock so parallel `clawnify`\n // invocations don't each present the same refresh token (Supabase rotates it\n // on every use and revokes the whole family on reuse).\n return refreshUnderLock(auth.access_token);\n}\n\n/**\n * Force a refresh after the server rejected a token that looked locally valid\n * (family revocation, clock skew, rotation race). Returns a usable access token\n * or null if the session is genuinely dead. Env-token callers can't refresh, so\n * they get null and the caller surfaces the real error.\n */\nexport async function refreshOnUnauthorized(\n rejectedToken: string,\n): Promise<string | null> {\n if (process.env.CLAWNIFY_TOKEN) return null;\n if (!loadAuth()) return null;\n return refreshUnderLock(rejectedToken);\n}\n\n/**\n * Serialize the refresh across processes with an exclusive lock file, then\n * double-check: another invocation may have already rotated the token while we\n * waited. Only the process that still sees the stale token performs the network\n * refresh; everyone else re-reads the freshly rotated token from disk. This is\n * what keeps concurrent invocations from triggering Supabase reuse detection.\n */\nasync function refreshUnderLock(staleToken: string): Promise<string | null> {\n const release = await acquireRefreshLock();\n try {\n const auth = loadAuth();\n if (!auth) return null;\n\n // Someone else refreshed while we waited for the lock — use their token.\n const now = Math.floor(Date.now() / 1000);\n if (auth.access_token !== staleToken && auth.expires_at - 60 > now) {\n return auth.access_token;\n }\n\n const res = await fetch(OAUTH_TOKEN_URL, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: new URLSearchParams({\n grant_type: \"refresh_token\",\n refresh_token: auth.refresh_token,\n client_id: OAUTH_CLIENT_ID,\n }),\n });\n\n if (!res.ok) {\n clearAuth();\n return null;\n }\n\n const tokens = (await res.json()) as {\n access_token: string;\n refresh_token: string;\n expires_in: number;\n };\n\n const newAuth: AuthData = {\n ...auth,\n access_token: tokens.access_token,\n refresh_token: tokens.refresh_token,\n expires_at: Math.floor(Date.now() / 1000) + tokens.expires_in,\n };\n\n saveAuth(newAuth);\n return tokens.access_token;\n } finally {\n release();\n }\n}\n\n/**\n * Acquire an exclusive lock via atomic `O_EXCL` file creation. Waits for a\n * concurrent holder, steals a stale lock (holder crashed), and gives up after\n * LOCK_WAIT_MS to proceed best-effort rather than hang a command forever.\n */\nasync function acquireRefreshLock(): Promise<() => void> {\n fs.mkdirSync(AUTH_DIR, { recursive: true, mode: 0o700 });\n const start = Date.now();\n\n for (;;) {\n try {\n const fd = fs.openSync(LOCK_FILE, \"wx\", 0o600);\n fs.closeSync(fd);\n return () => {\n try {\n fs.unlinkSync(LOCK_FILE);\n } catch {\n // already released / stolen — nothing to do\n }\n };\n } catch (err) {\n if ((err as NodeJS.ErrnoException).code !== \"EEXIST\") throw err;\n\n // Held by another process — steal it if it's stale.\n try {\n const age = Date.now() - fs.statSync(LOCK_FILE).mtimeMs;\n if (age > LOCK_STALE_MS) {\n fs.unlinkSync(LOCK_FILE);\n continue;\n }\n } catch {\n // lock vanished between openSync and statSync — retry immediately\n continue;\n }\n\n if (Date.now() - start > LOCK_WAIT_MS) {\n // Couldn't get the lock in time; proceed unlocked rather than hang.\n return () => {};\n }\n await sleep(50 + Math.floor(Math.random() * 50));\n }\n }\n}\n\nexport async function requireAuth(): Promise<AuthData> {\n // Env override (headless / CI): synthesize AuthData from CLAWNIFY_TOKEN so\n // nothing is read from or written to disk. CLAWNIFY_ORG_ID optionally pins the\n // org (else the API's default org, or a per-command --org).\n if (process.env.CLAWNIFY_TOKEN) {\n return {\n access_token: process.env.CLAWNIFY_TOKEN,\n refresh_token: \"\",\n expires_at: Number.MAX_SAFE_INTEGER,\n org_id: process.env.CLAWNIFY_ORG_ID,\n };\n }\n\n const token = await getValidToken();\n if (!token) {\n console.error(\n \"Not logged in. Run `clawnify login`, or set CLAWNIFY_TOKEN (a Supabase access token) for headless / CI use.\",\n );\n process.exit(1);\n }\n return loadAuth()!;\n}\n\n/** Parse email from Supabase JWT claims (base64url-decoded payload) */\nexport function getEmailFromToken(token: string): string | null {\n try {\n const payload = token.split(\".\")[1]!;\n const decoded = JSON.parse(\n Buffer.from(payload, \"base64url\").toString(\"utf-8\")\n );\n return decoded.email ?? null;\n } catch {\n return null;\n }\n}\n\n/** Generate PKCE code_verifier and code_challenge */\nexport function generatePkce(): {\n codeVerifier: string;\n codeChallenge: string;\n} {\n const codeVerifier = crypto.randomBytes(32).toString(\"base64url\");\n const codeChallenge = crypto\n .createHash(\"sha256\")\n .update(codeVerifier)\n .digest(\"base64url\");\n return { codeVerifier, codeChallenge };\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport interface ClawnifyAppConfig {\n framework: string;\n database?: boolean;\n storage?: boolean;\n}\n\nexport interface ClawnifyWebsiteConfig {\n framework: string;\n}\n\n/**\n * An agent member (see `docs/internal/adr-company-monorepo.md` § Layer 1).\n * `harness` selects the runtime adapter — today only `openclaw`, whose\n * payload is `AGENT.md` + `skills/` + `flows/` + `openclaw.json`.\n */\nexport interface ClawnifyAgentConfig {\n harness: string;\n}\n\n/**\n * A workspace root is a monorepo that hosts an org's apps. It carries no\n * `app`/`website` block of its own — its `clawnify.json` declares only the\n * org every child app deploys to. See `docs/internal/adr-company-monorepo.md`.\n */\nexport interface ClawnifyWorkspaceConfig {\n /** Org slug or id this workspace (and every app under it) is bound to. */\n org: string;\n}\n\nexport interface ClawnifyManifest {\n name: string;\n description?: string;\n app?: ClawnifyAppConfig;\n website?: ClawnifyWebsiteConfig;\n /**\n * Overloaded (kept for back-compat with the published schema):\n * - OBJECT `{ harness }` → this project IS an agent (workspace member, #814).\n * - STRING → path to an app's agent-instructions file (schema default\n * \"agent.md\"); an app declares it alongside `app`, and the build reads\n * the file (`app-deployer.ts`). It is NOT a project kind.\n */\n agent?: ClawnifyAgentConfig | string;\n workspace?: ClawnifyWorkspaceConfig;\n}\n\nexport type ManifestKind = \"app\" | \"website\" | \"agent\";\n\nexport interface ProjectConfig {\n kind?: ManifestKind;\n org_id?: string;\n org_slug?: string;\n app_id?: string;\n app_token?: string;\n website_id?: string;\n slug?: string;\n /** Agent link: the server + named agent this member deploys to. */\n server_id?: string;\n agent_name?: string;\n}\n\nexport function readManifest(dir: string = process.cwd()): ClawnifyManifest | null {\n try {\n const data = fs.readFileSync(path.join(dir, \"clawnify.json\"), \"utf-8\");\n const manifest = JSON.parse(data) as ClawnifyManifest;\n if (!manifest.name) return null;\n if (!manifest.app && !manifest.website && !manifest.agent) return null;\n return manifest;\n } catch {\n return null;\n }\n}\n\n/**\n * Returns the manifest kind, or throws with a clear message when neither or\n * both blocks are present. Callers should run this before dispatching deploy.\n */\nexport function manifestKind(manifest: ClawnifyManifest): ManifestKind {\n // `agent` is a project kind ONLY when it's an object ({ harness }). A string\n // value is an app's agent-instructions file path (schema default \"agent.md\"),\n // declared alongside `app` — it must not be counted as a second kind, or\n // every app that references its agent.md fails with a false \"more than one\n // kind\" error (open-crm, open-kitchen, …).\n const isAgentProject =\n typeof manifest.agent === \"object\" && manifest.agent !== null;\n const present: ManifestKind[] = [\n manifest.app ? \"app\" : null,\n manifest.website ? \"website\" : null,\n isAgentProject ? \"agent\" : null,\n ].filter((k): k is ManifestKind => k !== null);\n if (present.length > 1) {\n throw new Error(\n `clawnify.json declares more than one of \\`app\\`, \\`website\\`, \\`agent\\` (${present.join(\", \")}) — a project is exactly one kind.`,\n );\n }\n if (present.length === 0) {\n throw new Error(\n \"clawnify.json must declare an `app`, `website`, or `agent` block.\",\n );\n }\n return present[0]!;\n}\n\nexport function readProject(dir: string = process.cwd()): ProjectConfig | null {\n try {\n const data = fs.readFileSync(\n path.join(dir, \".clawnify\", \"project.json\"),\n \"utf-8\"\n );\n return JSON.parse(data) as ProjectConfig;\n } catch {\n return null;\n }\n}\n\nexport function saveProject(dir: string, data: ProjectConfig): void {\n const projDir = path.join(dir, \".clawnify\");\n fs.mkdirSync(projDir, { recursive: true });\n fs.writeFileSync(\n path.join(projDir, \"project.json\"),\n JSON.stringify(data, null, 2)\n );\n}\n\nexport interface WorkspaceRoot {\n /** Absolute path to the workspace root directory. */\n dir: string;\n /** Org slug or id the workspace is bound to. */\n org: string;\n}\n\n/**\n * Read a workspace root's binding from `clawnify.json` at `dir`, or null if\n * that dir isn't a workspace root. A workspace is discriminated by the\n * presence of a `workspace.org` field (mirrors how app/website are detected).\n */\nexport function readWorkspaceConfig(dir: string): WorkspaceRoot | null {\n try {\n const data = fs.readFileSync(path.join(dir, \"clawnify.json\"), \"utf-8\");\n const manifest = JSON.parse(data) as ClawnifyManifest;\n if (manifest.workspace?.org) return { dir, org: manifest.workspace.org };\n return null;\n } catch {\n return null;\n }\n}\n\n/**\n * Walk up from `startDir` to the filesystem root, returning the nearest\n * enclosing workspace root, or null if there is none. Used so `init` drops\n * new apps under `apps/` and `deploy` inherits the org for a fresh app.\n */\nexport function findWorkspaceRoot(\n startDir: string = process.cwd(),\n): WorkspaceRoot | null {\n let cur = path.resolve(startDir);\n for (;;) {\n const ws = readWorkspaceConfig(cur);\n if (ws) return ws;\n const parent = path.dirname(cur);\n if (parent === cur) return null;\n cur = parent;\n }\n}\n","import {\n requireAuth,\n loadAuth,\n saveAuth,\n refreshOnUnauthorized,\n type AuthData,\n} from \"./auth.js\";\nimport { readProject, findWorkspaceRoot } from \"./config.js\";\nimport readline from \"node:readline\";\n\n// Overridable for CLI development against a local `wrangler dev` API.\nconst API_BASE = process.env.CLAWNIFY_API_BASE ?? \"https://provision.clawnify.com\";\n\nasync function apiRequest(\n method: string,\n path: string,\n options?: {\n body?: unknown;\n formData?: FormData;\n token?: string;\n orgId?: string;\n }\n): Promise<Response> {\n const headers: Record<string, string> = {};\n\n if (options?.token) {\n headers[\"Authorization\"] = `Bearer ${options.token}`;\n }\n if (options?.orgId) {\n headers[\"x-org-id\"] = options.orgId;\n }\n\n let body: BodyInit | undefined;\n if (options?.formData) {\n body = options.formData;\n } else if (options?.body) {\n headers[\"Content-Type\"] = \"application/json\";\n body = JSON.stringify(options.body);\n }\n\n return fetch(`${API_BASE}${path}`, { method, headers, body });\n}\n\nasync function ensureOrg(auth: AuthData): Promise<AuthData> {\n if (auth.org_id) return auth;\n\n // Fetch orgs and prompt\n const orgsRes = await apiRequest(\"GET\", \"/v1/orgs\", { token: auth.access_token });\n if (!orgsRes.ok) return auth;\n\n const { orgs } = (await orgsRes.json()) as {\n orgs: Array<{ id: string; name: string; slug: string; role: string }>;\n };\n\n if (orgs.length === 0) return auth;\n\n let orgId: string;\n if (orgs.length === 1) {\n orgId = orgs[0].id;\n } else if (!process.stdin.isTTY || process.env.CLAWNIFY_TOKEN) {\n // Non-interactive (headless agent / CI / env auth): can't prompt — default\n // to the first org and tell the caller how to pin one.\n console.error(\n `Multiple orgs — defaulting to \"${orgs[0].name}\". Pin with CLAWNIFY_ORG_ID or --org.`,\n );\n orgId = orgs[0].id;\n } else {\n console.log(\"\\nSelect an organization:\\n\");\n orgs.forEach((org, i) => {\n console.log(` ${i + 1}) ${org.name} (${org.role})`);\n });\n console.log();\n\n const rl = readline.createInterface({\n input: process.stdin,\n output: process.stdout,\n });\n\n const choice = await new Promise<string>((resolve) => {\n rl.question(\"Enter number: \", (answer) => {\n rl.close();\n resolve(answer.trim());\n });\n });\n\n const index = parseInt(choice, 10) - 1;\n orgId = (index >= 0 && index < orgs.length) ? orgs[index].id : orgs[0].id;\n console.log(`Selected: ${orgs[index >= 0 && index < orgs.length ? index : 0].name}\\n`);\n }\n\n const updated = { ...auth, org_id: orgId };\n if (!process.env.CLAWNIFY_TOKEN) saveAuth(updated);\n return updated;\n}\n\ntype OrgSource = \"flag\" | \"env\" | \"link\" | \"workspace\" | \"active\";\nlet orgCtxCache: string | undefined | null = null;\nlet orgEchoed = false;\n\n/** Print the org a command is acting on, once, to stderr (keeps stdout clean). */\nfunction echoOrg(label: string, source: OrgSource): void {\n if (orgEchoed) return;\n orgEchoed = true;\n process.stderr.write(`→ org: ${label}\\n`);\n if (source === \"active\") {\n process.stderr.write(\n \" (global active org — link this folder / use a workspace, or pass --org, to pin it)\\n\",\n );\n }\n}\n\nasync function matchOrg(ref: string): Promise<{ id: string; slug: string }> {\n const orgs = await listMyOrgs();\n const m = orgs.find((o) => o.id === ref || o.slug === ref);\n if (!m) {\n console.error(`No org matched \"${ref}\". Available: ${orgs.map((o) => o.slug).join(\", \")}`);\n process.exit(1);\n }\n return { id: m.id, slug: m.slug };\n}\n\n/**\n * Resolve which org the current command targets, folder-first:\n * --org → CLAWNIFY_ORG_ID → .clawnify/project.json org_id → workspace.org\n * → ~/.clawnify/auth.json org_id (global active)\n * The folder link and the enclosing workspace both outrank the persisted\n * global-active org, so a command run in a linked folder / workspace never\n * silently targets a different org. Mirrors `deploy`'s precedence for every\n * other command. Memoized + echoed once; returns undefined when nothing\n * resolves (caller prompts / falls back to the API default org).\n */\nexport async function resolveOrgContext(\n opts?: { orgFlag?: string; dir?: string },\n): Promise<string | undefined> {\n if (orgCtxCache !== null) return orgCtxCache;\n const dir = opts?.dir ?? process.cwd();\n\n if (opts?.orgFlag) {\n const m = await matchOrg(opts.orgFlag);\n const proj = readProject(dir);\n if (proj?.org_id && proj.org_id !== m.id) {\n console.error(\n `This folder is linked to a different org (${proj.org_slug ?? proj.org_id}).\\n` +\n ` --org ${opts.orgFlag} resolves to ${m.slug}. Re-link, or run from another directory.`,\n );\n process.exit(1);\n }\n orgCtxCache = m.id;\n echoOrg(m.slug, \"flag\");\n return m.id;\n }\n\n const env = process.env.CLAWNIFY_ORG_ID;\n if (env) {\n orgCtxCache = env;\n echoOrg(env, \"env\");\n return env;\n }\n\n const proj = readProject(dir);\n if (proj?.org_id) {\n orgCtxCache = proj.org_id;\n echoOrg(proj.org_slug ?? proj.org_id, \"link\");\n return proj.org_id;\n }\n\n const ws = findWorkspaceRoot(dir);\n if (ws?.org) {\n const m = await matchOrg(ws.org);\n orgCtxCache = m.id;\n echoOrg(m.slug, \"workspace\");\n return m.id;\n }\n\n // Global active org — interactive/disk auth only. Headless (CLAWNIFY_TOKEN)\n // keeps its own default-org behavior via ensureOrg.\n if (!process.env.CLAWNIFY_TOKEN) {\n const auth = loadAuth();\n if (auth?.org_id) {\n orgCtxCache = auth.org_id;\n echoOrg(auth.org_slug ?? auth.org_id, \"active\");\n return auth.org_id;\n }\n }\n\n orgCtxCache = undefined;\n return undefined;\n}\n\nasync function authedRequest(\n method: string,\n path: string,\n options?: { body?: unknown; formData?: FormData; orgId?: string }\n): Promise<Response> {\n let auth = await requireAuth();\n let orgId = options?.orgId;\n if (!orgId) {\n orgId = await resolveOrgContext();\n if (!orgId) {\n auth = await ensureOrg(auth);\n orgId = auth.org_id;\n }\n }\n\n const res = await apiRequest(method, path, {\n ...options,\n token: auth.access_token,\n orgId,\n });\n\n if (res.status !== 401) return res;\n\n // A 401 is not necessarily an expired session: the token may have been\n // rotated by a concurrent invocation, revoked, or the route itself may be\n // rejecting an otherwise-valid token. Attempt exactly one silent refresh and\n // retry before deciding it's a login problem.\n const fresh = await refreshOnUnauthorized(auth.access_token);\n if (!fresh) {\n if (process.env.CLAWNIFY_TOKEN) {\n console.error(\"CLAWNIFY_TOKEN was rejected (401). Provide a valid Supabase access token.\");\n } else {\n console.error(\"Session expired. Run `clawnify login` again.\");\n }\n process.exit(1);\n }\n\n // Retry once with the refreshed token. If it still 401s, this isn't a session\n // problem — return the response so the caller surfaces the real error instead\n // of masquerading it as a login failure.\n return apiRequest(method, path, {\n ...options,\n token: fresh,\n orgId,\n });\n}\n\nexport interface Org {\n id: string;\n name: string;\n slug: string;\n role: string;\n}\n\n/** List every org the authenticated user belongs to, bypassing org selection. */\nexport async function listMyOrgs(): Promise<Org[]> {\n const auth = await requireAuth();\n const res = await apiRequest(\"GET\", \"/v1/orgs\", { token: auth.access_token });\n if (!res.ok) return [];\n const { orgs } = (await res.json()) as { orgs: Org[] };\n return orgs ?? [];\n}\n\nexport const api = {\n get: (path: string, opts?: { orgId?: string }) =>\n authedRequest(\"GET\", path, opts),\n post: (path: string, body?: unknown, opts?: { orgId?: string }) =>\n authedRequest(\"POST\", path, { body, ...opts }),\n postForm: (path: string, formData: FormData, opts?: { orgId?: string }) =>\n authedRequest(\"POST\", path, { formData, ...opts }),\n del: (path: string, opts?: { orgId?: string }) =>\n authedRequest(\"DELETE\", path, opts),\n // Generic authed request for the `clawnify api` escape hatch (any method).\n call: (method: string, path: string, opts?: { body?: unknown; orgId?: string }) =>\n authedRequest(method, path, opts),\n request: apiRequest,\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { execSync } from \"node:child_process\";\nimport { gzipSync } from \"node:zlib\";\n\nconst EXCLUDE_DIRS = new Set([\n \"node_modules\",\n \".git\",\n \"dist\",\n \".next\",\n \".clawnify\",\n \"build\",\n]);\n\nconst MAX_SIZE = 20 * 1024 * 1024; // 20MB\n\nfunction runGit(args: string[], dir: string): string | null {\n try {\n return execSync(`git ${args.join(\" \")}`, {\n cwd: dir,\n encoding: \"utf-8\",\n stdio: [\"pipe\", \"pipe\", \"pipe\"],\n // execSync's default maxBuffer is 1MB. `ls-files --others` enumerates\n // every file under an unignored node_modules, which easily exceeds that —\n // the throw was caught below and untracked files silently vanished from\n // the archive (new assets never deployed).\n maxBuffer: 64 * 1024 * 1024,\n });\n } catch {\n return null;\n }\n}\n\n/**\n * Collect every file `git add .` would stage: tracked files plus untracked\n * files that aren't ignored. Returns null if the directory isn't a git repo,\n * so the caller falls back to walkDir.\n *\n * The previous implementation used only `git ls-files`, which silently\n * excluded brand-new untracked files — a common foot-gun when an agent\n * (or human) creates a file but forgets to `git add` it.\n */\nfunction getGitFiles(dir: string): string[] | null {\n const tracked = runGit([\"ls-files\", \"-z\"], dir);\n if (tracked === null) return null;\n const untrackedResult = runGit([\"ls-files\", \"-z\", \"--others\", \"--exclude-standard\"], dir);\n if (untrackedResult === null) {\n // Never fail silently here: proceeding without untracked files means a\n // brand-new asset quietly missing from the deployed site.\n console.warn(\n \" warning: could not list untracked files (git ls-files --others failed); \" +\n \"newly created files that aren't committed may be missing from this deploy.\",\n );\n }\n const untracked = untrackedResult ?? \"\";\n const merged = new Set<string>();\n for (const f of tracked.split(\"\\0\")) if (f) merged.add(f);\n for (const f of untracked.split(\"\\0\")) if (f) merged.add(f);\n return [...merged];\n}\n\nfunction walkDir(dir: string, base: string = \"\"): string[] {\n const files: string[] = [];\n for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n if (EXCLUDE_DIRS.has(entry.name)) continue;\n const rel = base ? `${base}/${entry.name}` : entry.name;\n const full = path.join(dir, entry.name);\n if (entry.isDirectory()) {\n files.push(...walkDir(full, rel));\n } else if (entry.isFile()) {\n files.push(rel);\n }\n }\n return files;\n}\n\n/**\n * A repo-root `manifest.json` is not part of the clawnify contract\n * (clawnify.json is). Some templates leave a Preact-style manifest behind;\n * users see \"manifest\" and assume it controls something. Warn so they know\n * it's being uploaded as a dumb file.\n */\nfunction warnOnStaleManifest(dir: string, files: string[]) {\n if (!files.includes(\"manifest.json\")) return;\n try {\n const raw = fs.readFileSync(path.join(dir, \"manifest.json\"), \"utf-8\");\n const parsed = JSON.parse(raw) as Record<string, unknown>;\n if (parsed && typeof parsed === \"object\" && \"framework\" in parsed && \"files\" in parsed) {\n console.warn(\n ` warning: manifest.json looks like a stale auto-generated file. ` +\n `Clawnify uses clawnify.json — manifest.json is ignored.`,\n );\n }\n } catch {\n // not JSON, not our concern\n }\n}\n\n/**\n * EXCLUDE_DIRS must hold on BOTH listing paths. The git path lists whatever\n * git would stage — which includes `.clawnify/` (app_token!) or `.env` when\n * the surrounding repo's .gitignore doesn't cover them (e.g. a cloned\n * template). Those must never be uploaded regardless of git status.\n */\nfunction isExcludedPath(rel: string): boolean {\n const parts = rel.split(\"/\");\n return parts.some((p) => EXCLUDE_DIRS.has(p)) || parts[parts.length - 1] === \".env\";\n}\n\nfunction listFiles(dir: string): string[] {\n const fromGit = getGitFiles(dir);\n const files = (fromGit ?? walkDir(dir)).filter((f) => !isExcludedPath(f));\n warnOnStaleManifest(dir, files);\n return files;\n}\n\n/** Public helper for `clawnify deploy --dry-run`. */\nexport function listArchiveFiles(dir: string): string[] {\n return listFiles(dir);\n}\n\nfunction createTarHeader(filename: string, size: number): Buffer {\n const header = Buffer.alloc(512);\n header.write(filename, 0, Math.min(filename.length, 100), \"utf-8\");\n header.write(\"0000644\\0\", 100, 8, \"utf-8\");\n header.write(\"0000000\\0\", 108, 8, \"utf-8\");\n header.write(\"0000000\\0\", 116, 8, \"utf-8\");\n header.write(size.toString(8).padStart(11, \"0\") + \"\\0\", 124, 12, \"utf-8\");\n const mtime = Math.floor(Date.now() / 1000);\n header.write(mtime.toString(8).padStart(11, \"0\") + \"\\0\", 136, 12, \"utf-8\");\n header.write(\"0\", 156, 1, \"utf-8\");\n header.write(\"ustar\\0\", 257, 6, \"utf-8\");\n header.write(\"00\", 263, 2, \"utf-8\");\n header.write(\" \", 148, 8, \"utf-8\");\n let checksum = 0;\n for (let i = 0; i < 512; i++) {\n checksum += header[i]!;\n }\n header.write(checksum.toString(8).padStart(6, \"0\") + \"\\0 \", 148, 8, \"utf-8\");\n return header;\n}\n\n/**\n * Drizzle migrations live under `.clawnify/drizzle/<NNNN>_<name>.sql`\n * locally (gitignored, regenerated by the CLI on dev/deploy). The\n * deploy pipeline (PR #444) scans R2's `drizzle/` prefix on each\n * deploy. We remap on upload — the user's repo stays clean, the\n * pipeline contract is unchanged.\n *\n * Only top-level `*.sql` files come along; drizzle's `meta/` snapshot\n * dir is local-only state.\n */\nfunction collectDrizzleMigrations(\n dir: string,\n): { src: string; tarName: string }[] {\n const drizzleDir = path.join(dir, \".clawnify\", \"drizzle\");\n if (!fs.existsSync(drizzleDir)) return [];\n try {\n return fs\n .readdirSync(drizzleDir)\n .filter((name) => name.endsWith(\".sql\"))\n .sort()\n .map((name) => ({\n src: path.join(drizzleDir, name),\n tarName: `drizzle/${name}`,\n }));\n } catch {\n return [];\n }\n}\n\nexport function createArchive(dir: string): { archive: Buffer; files: string[] } {\n const files = listFiles(dir);\n const parts: Buffer[] = [];\n const includedFiles: string[] = [];\n\n function addEntry(absPath: string, tarName: string): void {\n let stat: fs.Stats;\n try {\n stat = fs.statSync(absPath);\n } catch {\n return;\n }\n if (!stat.isFile()) return;\n\n const content = fs.readFileSync(absPath);\n const header = createTarHeader(tarName, content.length);\n parts.push(header);\n parts.push(content);\n includedFiles.push(tarName);\n\n const remainder = content.length % 512;\n if (remainder > 0) {\n parts.push(Buffer.alloc(512 - remainder));\n }\n }\n\n for (const file of files) {\n addEntry(path.join(dir, file), file);\n }\n\n for (const m of collectDrizzleMigrations(dir)) {\n addEntry(m.src, m.tarName);\n }\n\n parts.push(Buffer.alloc(1024));\n\n const tar = Buffer.concat(parts);\n const gzipped = gzipSync(tar);\n\n if (gzipped.length > MAX_SIZE) {\n throw new Error(\n `Archive too large (${(gzipped.length / 1024 / 1024).toFixed(1)}MB). Maximum is 20MB.`,\n );\n }\n\n return { archive: gzipped, files: includedFiles };\n}\n","import { api } from \"./api.js\";\n\nconst SPINNER_FRAMES = [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"];\n\nexport interface AppStatus {\n status: string;\n status_message?: string;\n url?: string;\n error?: string;\n}\n\n// Status values that mean we're done — apps use \"live\"/\"error\", websites\n// use \"live\"/\"failed\". Pollers stop on any of these.\nconst TERMINAL_STATUSES = new Set([\"live\", \"ready\", \"error\", \"failed\"]);\nconst FAILURE_STATUSES = new Set([\"error\", \"failed\"]);\n// Draft-first: a CLI website deploy builds to the draft tier and parks at\n// \"preview\" (publishing to live is an explicit, separate action from the\n// dashboard). So \"preview\" is a terminal SUCCESS for websites — without this\n// the poller would spin until it times out on a perfectly good deploy.\nconst WEBSITE_TERMINAL_SUCCESS = new Set([\"preview\"]);\n\nexport async function pollUntilReady(\n resourceId: string,\n options: {\n interval?: number;\n timeout?: number;\n kind?: \"app\" | \"website\";\n orgId?: string;\n } = {},\n): Promise<AppStatus> {\n const interval = options.interval ?? 3000;\n const timeout = options.timeout ?? 300000;\n const kind = options.kind ?? \"app\";\n const basePath = kind === \"website\" ? \"/v1/websites\" : \"/v1/apps\";\n const start = Date.now();\n let frame = 0;\n const isTTY = Boolean(process.stdout.isTTY);\n let lastMessage = \"\";\n\n while (Date.now() - start < timeout) {\n const res = await api.get(`${basePath}/${resourceId}`, { orgId: options.orgId });\n const data = (await res.json()) as AppStatus;\n const message = data.status_message || data.status;\n\n if (isTTY) {\n const spinner = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];\n process.stdout.write(`\\r${spinner} ${message}`);\n } else if (message !== lastMessage) {\n // Non-TTY (CI logs, background tasks): write whole lines so the\n // output survives in pipes and files instead of being mangled by\n // cursor escapes from the spinner.\n console.log(`status: ${message}`);\n lastMessage = message;\n }\n frame++;\n\n const terminal =\n TERMINAL_STATUSES.has(data.status) ||\n (kind === \"website\" && WEBSITE_TERMINAL_SUCCESS.has(data.status));\n if (terminal) {\n if (isTTY) process.stdout.write(\"\\r\\x1b[K\");\n // Normalize \"failed\" to \"error\" so downstream callers only branch\n // on one terminal-failure value.\n if (FAILURE_STATUSES.has(data.status)) {\n return { ...data, status: \"error\" };\n }\n return data;\n }\n\n await new Promise((r) => setTimeout(r, interval));\n }\n\n if (isTTY) process.stdout.write(\"\\r\\x1b[K\");\n throw new Error(\"Timed out waiting for deployment\");\n}\n","/**\n * The CLI's real version, injected at build time from package.json by\n * tsup.config.ts. package.json stays the single source of truth — bumping it\n * IS the release (see .github/workflows/publish-cli.yml), and this makes\n * `clawnify --version` say the same thing.\n *\n * It used to be a hardcoded \"0.1.0\" in cli.ts and mcp.ts, which meant every\n * build ever published reported the same string. That made \"are you on the\n * fixed CLI?\" unanswerable — a stale global install (npm installs into the\n * ACTIVE nvm node version, so one per node version is easy to end up with)\n * was indistinguishable from a current one.\n */\ndeclare const __CLI_VERSION__: string;\n\nexport const VERSION = __CLI_VERSION__;\n"],"mappings":"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","names":["fs","path","path","proj","fs","path","path","fs"]}
|
|
@@ -20,7 +20,7 @@ import {
|
|
|
20
20
|
resolveOrgContext,
|
|
21
21
|
saveAuth,
|
|
22
22
|
saveProject
|
|
23
|
-
} from "./chunk-
|
|
23
|
+
} from "./chunk-TR3GJVCX.js";
|
|
24
24
|
|
|
25
25
|
// src/cli.ts
|
|
26
26
|
import { Command } from "commander";
|
|
@@ -1242,7 +1242,7 @@ async function envUnsetCommand(key) {
|
|
|
1242
1242
|
}
|
|
1243
1243
|
|
|
1244
1244
|
// src/commands/api.ts
|
|
1245
|
-
async function apiCommand(
|
|
1245
|
+
async function apiCommand(path10, opts) {
|
|
1246
1246
|
const method = (opts.method || (opts.data !== void 0 ? "POST" : "GET")).toUpperCase();
|
|
1247
1247
|
let body;
|
|
1248
1248
|
if (opts.data !== void 0) {
|
|
@@ -1253,7 +1253,7 @@ async function apiCommand(path9, opts) {
|
|
|
1253
1253
|
process.exit(1);
|
|
1254
1254
|
}
|
|
1255
1255
|
}
|
|
1256
|
-
const p =
|
|
1256
|
+
const p = path10.startsWith("/") ? path10 : `/${path10}`;
|
|
1257
1257
|
const res = await api.call(method, p, { body, orgId: opts.org });
|
|
1258
1258
|
const text = await res.text();
|
|
1259
1259
|
let out = text;
|
|
@@ -1376,9 +1376,9 @@ var DETECTORS = [
|
|
|
1376
1376
|
{ agent: "aider", markers: ["CONVENTIONS.md", ".aider.conf.yml"], target: "CONVENTIONS.md" }
|
|
1377
1377
|
];
|
|
1378
1378
|
function exists(cwd, name) {
|
|
1379
|
-
const
|
|
1379
|
+
const path10 = join(cwd, name);
|
|
1380
1380
|
try {
|
|
1381
|
-
statSync(
|
|
1381
|
+
statSync(path10);
|
|
1382
1382
|
return true;
|
|
1383
1383
|
} catch {
|
|
1384
1384
|
return false;
|
|
@@ -1402,12 +1402,12 @@ function agentByName(name) {
|
|
|
1402
1402
|
var ALL_AGENTS = DETECTORS.map((d) => d.agent);
|
|
1403
1403
|
|
|
1404
1404
|
// src/lib/skills/content.gen.ts
|
|
1405
|
-
var CLI_VERSION = "0.
|
|
1405
|
+
var CLI_VERSION = "0.12.0";
|
|
1406
1406
|
var BUNDLED_SKILLS = [
|
|
1407
1407
|
{
|
|
1408
1408
|
name: "build-a-clawnify-app",
|
|
1409
1409
|
description: "Author a Clawnify app end-to-end \u2014 the canonical Hono + React + Vite + @hono/zod-openapi + @clawnify/db (Drizzle) stack, schema.ts (typed queries) kept in sync with schema.sql (the DDL the deploy applies), OpenAPIHono routes (createRoute) that auto-generate an OpenAPI spec, and platform-injected identity via user()/orgId()/caller(). Use when building or modifying an app that deploys to the Clawnify platform.",
|
|
1410
|
-
content: '# Build a Clawnify app\n\nCanonical skill: how to author a Clawnify app end-to-end. Same content\nfor humans reading the docs and for AI coding agents injecting this as\ninstructions during an app build.\n\nIf you\'re an agent: this document is enough context to produce a\nworking app from scratch. Follow it literally. The patterns here\nare exactly what `clawnify init` scaffolds and what the platform\nexpects.\n\n## TL;DR\n\n- **One stack.** Hono + React + Vite + `@hono/zod-openapi` +\n `@clawnify/db` (Drizzle) + `@clawnify/app` (entry, routing,\n identity) + Tailwind v4. Nothing else.\n- **Schema lives in two files kept in sync** \u2014 `schema.ts` (Drizzle\n DSL, the typed view your queries use) and `schema.sql` (the DDL the\n deploy applies to your app\'s D1). Change one, change the other.\n- **Queries through `getDB`** \u2014 `import { getDB, eq } from\n "@clawnify/db"`. JSON columns auto-serialize.\n- **API routes are `OpenAPIHono` + `createRoute`** \u2014 Zod-validated\n request/response.\n- **`createApp()`** (from `@clawnify/app`) builds the entry \u2014 it returns an\n `OpenAPIHono` with API discovery already mounted (`/api/openapi.json` +\n `/llms.txt`, generated from your live routes). That descriptor *is* the\n tool surface agents discover. Never hand-write those routes.\n- **One import.** `@clawnify/app` re-exports `createRoute`, `z` and\n `OpenAPIHono`, and adds `user` / `orgId` / `caller`. Import from it, not\n from `@clawnify/routes` directly.\n- **`clawnify.json`** declares framework, env, and public routes.\n There is no `api.tools[]` \u2014 the agent discovers and calls your\n endpoints via `/llms.txt` (and the OpenAPI spec).\n- **Identity is injected by the platform** \u2014 read it with `user(c)` /\n `orgId(c)` / `caller(c)` from `@clawnify/app`. Your app never\n authenticates anyone.\n\n## Stack rationale\n\nOne template, one set of decisions. Don\'t deviate unless the user has\nexplicitly asked. `clawnify init` (type `app`) scaffolds either a\n`blank` template (one GET route + a page) or a `crud` template (a\ntable with list/create/update/delete + a form). Both share the exact\nsame stack below.\n\n## File layout\n\n```\nmy-app/\n clawnify.json \u2190 Manifest (validated against /schema/v1/clawnify.json)\n package.json\n tsconfig.json\n vite.config.ts \u2190 @vitejs/plugin-react + @tailwindcss/vite; proxies /api \u2192 :8787\n index.html\n .gitignore\n .clawnify/ \u2190 CLI cache (gitignored)\n wrangler.toml \u2190 Generated per-dev wrangler config\n src/\n server/\n index.ts \u2190 OpenAPIHono entry \u2014 mounts routes, serves /api/openapi.json\n routes.ts \u2190 OpenAPIHono + createRoute definitions \u2014 the API surface\n schema.ts \u2190 Drizzle table definitions (typed view for queries)\n schema.sql \u2190 canonical DDL the deploy applies \u2014 keep in sync with schema.ts\n worker-env.d.ts \u2190 Cloudflare Workers types reference\n uploads.ts \u2190 R2 helpers (only when storage is enabled)\n client/\n main.tsx \u2190 React mount point\n app.tsx \u2190 Root component (plain fetch against /api/*)\n index.css \u2190 @import "tailwindcss"\n```\n\n## Schema \u2014 `schema.ts` + `schema.sql`, kept in sync\n\nTwo files describe the same tables. `schema.ts` (Drizzle DSL) is the\ntyped view your queries compile against; `schema.sql` is the DDL the\ndeploy applies to your app\'s D1. **When you change one, update the\nother** \u2014 they must describe the same tables.\n\nThe scaffold\'s starter table (blank template):\n\n```ts\n// src/server/schema.ts\nimport { sqliteTable, text, integer } from "@clawnify/db";\n\nexport const items = sqliteTable("items", {\n id: integer("id").primaryKey({ autoIncrement: true }),\n name: text("name").notNull(),\n createdAt: text("created_at").notNull().$default(() => new Date().toISOString()),\n});\n```\n\nReal apps are multi-tenant. Every user-facing table carries an\n`org_id`, every query filters by it. JSON columns and indexes use the\nDrizzle DSL re-exported from `@clawnify/db`:\n\n```ts\nimport { sqliteTable, text, integer, index } from "@clawnify/db";\n\nexport const notes = sqliteTable(\n "notes",\n {\n id: integer("id").primaryKey({ autoIncrement: true }),\n orgId: text("org_id").notNull(), // ALWAYS filter by this in queries\n title: text("title").notNull(),\n body: text("body").notNull().default(""),\n tags: text("tags", { mode: "json" }).$type<string[]>().notNull().default([]),\n createdAt: text("created_at").notNull().$default(() => new Date().toISOString()),\n },\n (t) => ({\n byOrg: index("notes_by_org").on(t.orgId, t.createdAt),\n }),\n);\n```\n\nRules:\n- JSON columns: `text(col, { mode: "json" }).$type<T>()` \u2014 Drizzle\n serializes on write and parses on read.\n- Multi-tenancy: every user-facing table has `org_id`. Every query\n filters by it. No exceptions.\n- Identifiers: snake_case in SQL, camelCase in TS (Drizzle bridges).\n\n## `schema.sql` \u2014 the DDL the deploy applies\n\nAlongside `schema.ts`, keep a `schema.sql` describing the same tables.\nThis is the DDL applied to your app\'s database on deploy.\n\n```sql\n-- src/server/schema.sql (mirror of the schema.ts tables)\nCREATE TABLE IF NOT EXISTS notes (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n org_id TEXT NOT NULL,\n title TEXT NOT NULL,\n body TEXT NOT NULL DEFAULT \'\',\n tags TEXT NOT NULL DEFAULT \'[]\', -- JSON column\n created_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS notes_by_org ON notes(org_id, created_at);\n```\n\nRules:\n- Always `CREATE TABLE IF NOT EXISTS` \u2014 the apply is additive and\n re-run-safe.\n- Add a new column with `ALTER TABLE <t> ADD COLUMN \u2026` at the **end** of\n `schema.sql`, and reflect it in `schema.ts`. The deploy adds it.\n- Deploys are **additive**: new tables and columns are added\n automatically. Destructive changes (dropping or retyping a column) are\n not applied automatically \u2014 do those deliberately, and never drop a\n table with user data unless explicitly asked.\n- **Never let `schema.ts` and `schema.sql` drift.** Change one, change\n the other \u2014 they must describe the same tables.\n\n## `src/server/index.ts` \u2014 the entry\n\n```ts\nimport { createApp } from "@clawnify/app";\nimport api from "./routes";\n\ntype Env = { Bindings: { DB: D1Database } };\n\n// db:false \u2014 this app reads the database per request via getDB(c.env),\n// which needs no init middleware.\nconst app = createApp<Env>({ title: "My app", version: "1.0.0", db: false });\n\napp.route("/", api);\n\nexport default app;\n```\n\nThe entry is thin: `createApp()` then mount your routes. `createApp`\nreturns an `OpenAPIHono` with **API discovery already mounted** \u2014 it\nserves both `/api/openapi.json` (generated from your `createRoute`\ndefinitions, with schemas) **and** `/llms.txt` (the same, agent-readable).\nAny `/api/*` route written as a plain `app.get` with no `createRoute` is\nstill listed from the live route table, so the endpoint inventory is\nalways complete. **Never hand-write a `/openapi.json` or `/llms.txt`\nhandler** \u2014 and don\'t call `mountDiscovery` yourself; `createApp` did it.\n\nWhen storage (file uploads) is enabled, the entry also wires the R2\nbucket in a middleware before mounting routes:\n\n```ts\nimport { createApp } from "@clawnify/app";\nimport { initUploads } from "./uploads";\nimport api from "./routes";\n\ntype Env = { Bindings: { DB: D1Database; UPLOADS: R2Bucket } };\n\nconst app = createApp<Env>({ title: "My app", version: "1.0.0", db: false });\n\napp.use("*", async (c, next) => {\n initUploads(c.env.UPLOADS);\n await next();\n});\n\napp.route("/", api);\n\nexport default app;\n```\n\n## `src/server/routes.ts` \u2014 routes with `createRoute`\n\nEach endpoint is a `createRoute({ method, path, summary, request, responses })`\ndefinition paired with a handler via `api.openapi(route, handler)`.\nRequest bodies and params are Zod-validated (`c.req.valid("json")`,\n`c.req.valid("param")`); response shapes are declared with\n`.openapi("Name")` Zod schemas so they land in the generated spec.\n\nBlank template \u2014 one read route:\n\n```ts\nimport { OpenAPIHono, createRoute, z } from "@clawnify/app";\nimport { getDB, desc } from "@clawnify/db";\nimport * as schema from "./schema";\n\ntype Env = { Bindings: { DB: D1Database } };\nconst api = new OpenAPIHono<Env>();\n\nconst ItemSchema = z.object({\n id: z.number(),\n name: z.string(),\n createdAt: z.string(),\n}).openapi("Item");\n\napi.openapi(\n createRoute({\n method: "get",\n path: "/api/items",\n summary: "List items",\n responses: {\n 200: {\n description: "List of items",\n content: { "application/json": { schema: z.array(ItemSchema) } },\n },\n },\n }),\n async (c) => {\n const db = getDB(c.env, { schema });\n const items = await db\n .select()\n .from(schema.items)\n .orderBy(desc(schema.items.createdAt));\n return c.json(items);\n },\n);\n\nexport default api;\n```\n\nCRUD template \u2014 the full list/create/update/delete surface:\n\n```ts\nimport { OpenAPIHono, createRoute, z } from "@clawnify/app";\nimport { getDB, eq, desc } from "@clawnify/db";\nimport * as schema from "./schema";\n\ntype Env = { Bindings: { DB: D1Database } };\nconst api = new OpenAPIHono<Env>();\n\nconst ItemSchema = z.object({\n id: z.number(),\n title: z.string(),\n status: z.string(),\n createdAt: z.string(),\n}).openapi("Item");\n\nconst CreateItemSchema = z.object({ title: z.string().min(1) }).openapi("CreateItem");\nconst UpdateItemSchema = z.object({\n title: z.string().min(1).optional(),\n status: z.string().optional(),\n}).openapi("UpdateItem");\nconst IdParamSchema = z.object({ id: z.string() });\nconst OkSchema = z.object({ ok: z.boolean() }).openapi("Ok");\n\napi.openapi(\n createRoute({\n method: "get",\n path: "/api/items",\n summary: "List items",\n responses: {\n 200: {\n description: "List of items",\n content: { "application/json": { schema: z.array(ItemSchema) } },\n },\n },\n }),\n async (c) => {\n const db = getDB(c.env, { schema });\n const items = await db\n .select()\n .from(schema.items)\n .orderBy(desc(schema.items.createdAt));\n return c.json(items);\n },\n);\n\napi.openapi(\n createRoute({\n method: "post",\n path: "/api/items",\n summary: "Create item",\n request: { body: { content: { "application/json": { schema: CreateItemSchema } } } },\n responses: {\n 201: {\n description: "Created item",\n content: { "application/json": { schema: ItemSchema } },\n },\n },\n }),\n async (c) => {\n const { title } = c.req.valid("json");\n const db = getDB(c.env, { schema });\n const [row] = await db\n .insert(schema.items)\n .values({ title: title.trim() })\n .returning();\n return c.json(row, 201);\n },\n);\n\napi.openapi(\n createRoute({\n method: "patch",\n path: "/api/items/:id",\n summary: "Update item",\n request: {\n params: IdParamSchema,\n body: { content: { "application/json": { schema: UpdateItemSchema } } },\n },\n responses: {\n 200: { description: "Updated", content: { "application/json": { schema: OkSchema } } },\n },\n }),\n async (c) => {\n const { id } = c.req.valid("param");\n const body = c.req.valid("json");\n const patch: Partial<typeof schema.items.$inferInsert> = {};\n if (body.title !== undefined) patch.title = body.title;\n if (body.status !== undefined) patch.status = body.status;\n if (Object.keys(patch).length === 0) return c.json({ ok: false }, 400);\n const db = getDB(c.env, { schema });\n await db.update(schema.items).set(patch).where(eq(schema.items.id, Number(id)));\n return c.json({ ok: true });\n },\n);\n\napi.openapi(\n createRoute({\n method: "delete",\n path: "/api/items/:id",\n summary: "Delete item",\n request: { params: IdParamSchema },\n responses: {\n 200: { description: "Deleted", content: { "application/json": { schema: OkSchema } } },\n },\n }),\n async (c) => {\n const { id } = c.req.valid("param");\n const db = getDB(c.env, { schema });\n await db.delete(schema.items).where(eq(schema.items.id, Number(id)));\n return c.json({ ok: true });\n },\n);\n\nexport default api;\n```\n\nPatterns to follow:\n- **Give every route a clear `summary`/`description`.** The generated\n OpenAPI spec is what the agent reads to decide which endpoint to\n call \u2014 a vague summary makes your endpoint invisible in practice.\n- **Validate input with Zod** via `request.body` / `request.params`\n and read it with `c.req.valid("json")` / `c.req.valid("param")`.\n Never parse `c.req.raw` by hand.\n- **Declare response shapes** with `.openapi("Name")` schemas \u2014 they\n become the documented return type in the spec.\n- **Filter by the org** on every user-facing query (see "who is\n calling" below). No exceptions.\n\n## `src/server` \u2014 who is calling\n\nThe platform authenticates every caller at its perimeter and injects a\nverified identity onto the request (it strips any client-supplied\nversion first, so it can\'t be spoofed). Your app never authenticates\nanyone: no `Authorization`, no cookies, no JWT, no login screen.\n\nRead it with the helpers from `@clawnify/app` \u2014 don\'t parse headers\nyourself:\n\n```ts\nimport { user, orgId, caller } from "@clawnify/app";\n\napp.get("/api/notes", async (c) => {\n const org = orgId(c);\n if (!org) return c.json({ error: "unauthorized" }, 401);\n\n const db = getDB(c.env, { schema });\n return c.json(\n await db.select().from(schema.notes).where(eq(schema.notes.orgId, org)),\n );\n});\n```\n\n| Helper | Returns |\n|--------|---------|\n| `orgId(c)` | Organization UUID \u2014 the tenant key. Filter every user-facing query by it. |\n| `user(c)` | `{ id, email, name, avatarUrl, firstName, lastName }` \u2014 or **`null`** when the caller isn\'t a person. |\n| `caller(c)` | `user`, `api`, `agent`, `agent-browser`, `public`, `bypass`, `system`, or `app`. |\n\nTwo rules that catch people out:\n\n- **`user(c)` is null for five of the eight caller kinds**\n (`agent-browser`, `public`, `bypass`, `system`, `app`). Always handle\n the null case \u2014 don\'t assume a person is present just because a\n request arrived. For per-user rows, store `user(c).id` in a `user_id`\n column and filter on it, exactly as you filter on `org_id`.\n- **`firstName` / `lastName` are a heuristic** split of a single stored\n full name (first word / the rest). Fine for a greeting; never persist\n them or treat them as someone\'s legal name \u2014 store `name`.\n\nDon\'t build app-level users, roles, or permissions. Authorization\nalready happened at the perimeter.\n\n## `src/client` \u2014 React + plain fetch\n\nThe client mounts React and talks to the API with plain `fetch`\nagainst the `/api/*` routes. No data-layer library is scaffolded.\n\n```tsx\n// src/client/main.tsx\nimport { StrictMode } from "react";\nimport { createRoot } from "react-dom/client";\nimport { App } from "./app";\nimport "./index.css";\n\ncreateRoot(document.getElementById("app")!).render(\n <StrictMode>\n <App />\n </StrictMode>\n);\n```\n\n```tsx\n// src/client/app.tsx (CRUD template shape)\nimport { useState, useEffect } from "react";\n\ninterface Item {\n id: number;\n title: string;\n status: string;\n createdAt: string;\n}\n\nexport function App() {\n const [items, setItems] = useState<Item[]>([]);\n const [title, setTitle] = useState("");\n\n async function load() {\n const res = await fetch("/api/items");\n setItems(await res.json());\n }\n\n useEffect(() => { load(); }, []);\n\n async function addItem(e: React.FormEvent) {\n e.preventDefault();\n if (!title.trim()) return;\n await fetch("/api/items", {\n method: "POST",\n headers: { "Content-Type": "application/json" },\n body: JSON.stringify({ title }),\n });\n setTitle("");\n load();\n }\n\n // ...toggleStatus / deleteItem call PATCH/DELETE the same way.\n\n return (\n <div className="max-w-xl mx-auto mt-10 px-4">\n {/* form + list */}\n </div>\n );\n}\n```\n\nIn local dev, Vite proxies `/api` to the Worker on `:8787` (see\n`vite.config.ts`), so the same relative fetch paths work in dev and\nin production. The API is the one contract: the UI calls it over\n`fetch`, and the agent calls it over the OpenAPI spec.\n\n## Design\n\nIf the project contains a `DESIGN.md`, it is the single source of\ntruth for visuals \u2014 follow its tokens, don\'t restyle around it. The\nscaffold ships Tailwind v4 (via `@tailwindcss/vite`, imported with\n`@import "tailwindcss";` in `index.css`) and nothing else \u2014 no\ncomponent library. The rules every Clawnify app follows:\n\n- **Neutral chrome.** White canvas and surfaces, one text ramp\n (foreground \u2192 muted \u2192 faint), hairline borders. Color is for\n meaning, not decoration.\n- **One primary CTA per screen.** Blue is reserved for links and\n focus rings; never a second accent.\n- **Status colors are muted pairs** \u2014 never pure-saturated fills.\n- **Style with Tailwind utilities.** Don\'t install another component\n library or write a bespoke CSS system unless the user asks.\n- **Sizes in rem**, so browser zoom and font settings are respected.\n\n## `clawnify.json` \u2014 the manifest\n\n```json\n{\n "$schema": "https://app.clawnify.com/schema/v1/clawnify.json",\n "version": 1,\n "name": "Notes",\n "description": "Take and organize notes. Searchable by tag.",\n "app": {\n "framework": "react+hono",\n "database": true,\n "storage": false\n },\n "env": {\n "optional": ["OPENROUTER_API_KEY"]\n },\n "api": {\n "public_routes": [\n { "path": "/api/feed", "methods": ["GET"] }\n ]\n }\n}\n```\n\n`clawnify init` writes the minimal form:\n`{ app: { framework: "react+hono", database: true, storage } }`. Add\nthe rest as needed.\n\nIf the app talks to third-party services the user has connected\n(ads platforms, CRMs, messaging), declare them:\n\n```json\n{ "app": { "credentials": ["metaads", "googleads"] } }\n```\n\nGet the ids and names from `clawnify connections list` \u2014 see the\nnaming rule below.\n\n`env` supports `required` (deploy warns if missing), `optional`\n(injected when available), and `oneOf` (at least one per group).\n\nRules:\n- **There is no `api.tools[]`.** The manifest\'s `api` object only\n accepts `public_routes` and `automation_bypass`. Your API surface\n is discovered from the generated OpenAPI spec, not a hand-authored\n tools list (see the next section).\n- **Public routes are the exception**, not the default. Every route\n is behind the Clawnify perimeter (auth-required) unless you\n explicitly add a matching path to `api.public_routes`. Use only for\n webhooks, RSS, embedded feeds.\n- **`framework: "react+hono"`** for new apps. Never `preact+hono` or\n `vite-preact` \u2014 those are legacy.\n- **`database: true`** if the app uses a DB. Ship both `schema.ts`\n (typed) and `schema.sql` (the applied DDL), kept in sync.\n\n## How the agent reaches your API (no `api.tools[]`)\n\nThe old tRPC stack emitted an `api.tools[]` array from procedure meta.\nThat mechanism is gone. Today the flow is:\n\n1. Your `createRoute` definitions + `app.doc("/api/openapi.json", \u2026)`\n auto-generate a live OpenAPI 3.0 spec. The platform still reads this\n internally (e.g. `update_app` triage decides whether an existing\n endpoint can serve a request instead of a rebuild), so keep it\n accurate \u2014 but it is **not** the agent\'s discovery channel.\n2. The agent discovers your endpoints from the app\'s **`agent.md`**\n (extracted into `agent_instructions`, returned by `get_app`) and, for\n the exact routes, `get_app_source`. It then drives them with the\n built-in `call_app_api` tool (invoke a `method` + `path` on the live\n app). No per-app MCP registration, no manifest tools array, and no\n raw-OpenAPI tool \u2014 a generated spec is only as complete as its\n annotations, so `agent.md` is the authored contract of record.\n\nSo you make an endpoint "agent-callable" by describing it in `agent.md`\n(what it does, method + path, when to use it) and shipping it with a\nclear `summary`/`description` and Zod-typed request/response. The\nclearer both are, the more reliably the agent uses it.\n\n## Connections & secrets \u2014 `@clawnify/connections`\n\n**The naming rule \u2014 never invent an identifier.** Before declaring\n`credentials` or env names, run `clawnify connections list`: it shows\nthe org\'s canonical integration ids (`googleads`, never `google_ads`),\nthe fixed provider-key names (`OPENROUTER_API_KEY`, never\n`OPENROUTER_KEY`), and custom env vars already defined \u2014 each with\nconnected/set state. Reuse those exact identifiers; a misspelled one\ndoesn\'t fail the build, it silently resolves to nothing at runtime. If\nyou need a custom secret that isn\'t listed, pick a clear name and tell\nthe user to set it in the dashboard.\n\nIf the app needs a third-party service or a provider API key, use\nthe `@clawnify/connections` SDK. Never read credential bindings\ndirectly, never paste API keys, never hardcode a token or endpoint.\n\n```ts\nimport { connect, secret, describe, searchActions } from "@clawnify/connections";\n\n// A connected integration:\nconst meta = connect("metaads", env);\nconst accounts = await meta.adAccounts("name,currency");\n\n// A provider key the user supplied (null if absent):\nconst key = secret("OPENROUTER_API_KEY", env);\n\n// What\'s wired vs missing \u2014 drive your setup/empty state from this:\nconst status = await describe(env, undefined, REQUIRES);\n```\n\nHow to call a connected service \u2014 the mistake that silently breaks\nintegration apps, so get it right:\n\n- **Prefer the typed client\'s semantic methods** where they exist\n (`meta.adAccounts(...)`, `googleads.query(gaql)`).\n- **For anything else, discover and run an action:**\n ```ts\n const [best] = await searchActions("list google ads campaigns", env);\n const data = await connect(best.service, env).run(best.slug, body);\n ```\n- Some integrations also expose a raw REST client\n (`connect("bird", env).get("/path")`) \u2014 but if `.get()`/`.post()`\n throws for a service, that service only supports semantic methods\n and `run()`. When unsure, use `run()`.\n- **Need exact paths/arguments for a raw-REST provider?** Some carry\n a `spec_url` (the provider\'s published OpenAPI spec) \u2014\n `clawnify connections list --json` shows it. Download and query it \u2014\n `curl -s <spec_url> -o spec.json && jq \'.paths | keys\' spec.json` \u2014\n never read a whole spec into context (they run to 10+ MB).\n- **Never fall back to raw `fetch`** against a provider API, and\n never invent endpoints or guess tokens.\n\n**The one exception \u2014 a service we don\'t support at all.** If a\nprovider isn\'t in the connections registry (nothing to `connect()`\nto, and `clawnify connections list` doesn\'t show it), the sanctioned\npath *is* a raw call with a user-supplied key: declare the key(s) it\nneeds in `clawnify.json` `env` (`required`/`optional`/`oneOf`), tell\nthe user to set them in the dashboard, read them with\n`secret("THAT_KEY", env)`, and `fetch` the provider\'s documented\nendpoints directly. This is the escape hatch for the long tail of\nintegrations we don\'t model yet \u2014 it does **not** apply to a service\nwe *do* support (use `connect()` / `run()` for those, always). Keep\nthe endpoint and token server-side, never in the client bundle.\n\nBuild a `describe()`-driven setup state instead of assuming\nconnections exist \u2014 show the user what\'s missing and where to\nconnect it.\n\n## Scheduling & deferred work \u2014 the managed queue\n\nA deployed app **cannot bind Cloudflare Queues, Durable Objects, or cron\ntriggers** (the platform builds every app with a fixed binding set: `DB` +\n`ASSETS` + `UPLOADS`). To run work later \u2014 a scheduled publish, a reminder, a\nretry, a "do this in 10 minutes" \u2014 use the **Clawnify managed queue service**\nover HTTP. It owns the clock, retries, and at-least-once delivery, then calls an\nendpoint on *your own app* back at the scheduled time.\n\nIt\'s a thin seam over a platform primitive, same shape as `@clawnify/db` /\n`@clawnify/connections` (a `@clawnify/queue` package is coming; inline the seam\nuntil then). Auth is the build-injected `env.CLAWNIFY_TOKEN`; with no token\n(local dev) the seam degrades to a no-op.\n\n**Enqueue** a deferred call to your own endpoint:\n\n```ts\n// POST https://services.clawnify.com/queue/enqueue (Bearer CLAWNIFY_TOKEN)\nconst res = await fetch("https://services.clawnify.com/queue/enqueue", {\n method: "POST",\n headers: { Authorization: `Bearer ${env.CLAWNIFY_TOKEN}`, "Content-Type": "application/json" },\n body: JSON.stringify({\n target_url: `${origin}/api/internal/publish`, // an endpoint on THIS app\n payload: { post_id: id }, // echoed back to you on fire\n run_at: new Date(whenMs).toISOString(),\n idempotency_key: `post:${id}:${whenMs}`, // same key dedupes; new time = new job\n }),\n});\nconst { job_id } = await res.json(); // store it to cancel/reschedule\n```\n\nPersist `job_id` on the row (e.g. `posts.queue_job_id`). **Cancel / reschedule**:\n`DELETE https://services.clawnify.com/queue/jobs/{job_id}` (Bearer token);\nreschedule = cancel + a fresh enqueue.\n\n**The callback endpoint is a public, signature-verified route.** The queue calls\n`target_url` from outside the perimeter, so the endpoint must be declared in\n`clawnify.json` `public_routes` **and** verify the delivery signature itself \u2014\nthe signature *is* its auth (never trust an unsigned call):\n\n```jsonc\n// clawnify.json\n"api": { "public_routes": [ { "path": "/api/internal/publish", "methods": ["POST"] } ] }\n```\n\nDeliveries are signed with the platform\'s **ECDSA P-256 (ES256)** key,\nStripe-style over `${timestamp}.${rawBody}`, verified against\n`https://services.clawnify.com/.well-known/jwks.json` (public key \u2014 nothing\nbreaks on token rotation). Read the raw body, check the signature + a timestamp\ntolerance (~5 min) before doing anything:\n\n```ts\napp.post("/api/internal/publish", async (c) => {\n const raw = await c.req.text();\n const ok = await verifyDelivery(raw, {\n signature: c.req.header("x-clawnify-signature"),\n timestamp: c.req.header("x-clawnify-timestamp"),\n keyId: c.req.header("x-clawnify-key-id"),\n });\n if (!ok) return c.json({ error: "bad signature" }, 401);\n const { post_id } = JSON.parse(raw);\n // \u2026do the deferred work (short: it\'s one normal Worker invocation)\u2026\n return c.json({ ok: true });\n});\n```\n\nEach fire is a normal Worker request \u2014 size the work to one invocation (publish a\npost, send a digest). For long compute *now* (not deferred), hold the request\nopen and return when done; don\'t fire-and-forget past the response.\n\n## Migrations\n\nKeep `schema.ts` and `schema.sql` in sync by hand. The workflow is:\n\n1. Edit `src/server/schema.ts` for the new shape (types + queries).\n2. Make the matching edit in `src/server/schema.sql` \u2014 a new\n `CREATE TABLE IF NOT EXISTS`, or `ALTER TABLE \u2026 ADD COLUMN \u2026` at the\n **end** of the file for a new column.\n3. Run `clawnify dev` locally, then `clawnify deploy`.\n\nOn deploy your schema changes are applied to the app\'s database \u2014 new\ntables and columns are added automatically.\n\nDestructive changes (drop column, rename) are not applied automatically;\ndo them deliberately, and only when the user explicitly asks. Renames\nare risky on production data \u2014 prefer "add new column, backfill, switch\nqueries, drop old column" over a single-step rename.\n\n## What the agent must NOT do\n\n- Author a `/openapi.json` handler by hand. `app.doc("/api/openapi.json", \u2026)`\n generates it from your `createRoute` definitions.\n- Let `schema.ts` and `schema.sql` drift. They describe the same\n tables \u2014 change both, every time.\n- Hand-author migration SQL files. Make schema changes in `schema.sql`\n (and mirror them in `schema.ts`); the deploy applies them.\n- Invent an `api.tools[]` array in the manifest. It isn\'t a valid\n field \u2014 the OpenAPI spec is the tool surface.\n- Use `JSON.stringify` on query params. JSON columns auto-serialize\n via Drizzle. The raw SQL API has `json()` as a helper.\n- Skip the `org_id` filter on a user-facing query. Multi-tenant\n leak is the worst-class bug we can ship.\n- Read auth from `Authorization` / cookies / `Bearer` tokens, or\n hand-parse `X-Clawnify-*` headers. Use `user(c)` / `orgId(c)` /\n `caller(c)` from `@clawnify/app`.\n- Call third-party APIs with raw `fetch` or hardcoded tokens. Go\n through `@clawnify/connections` (`connect` / `secret` / `run`).\n- Install `drizzle-orm` as a separate top-level dependency.\n `@clawnify/db@^0.4.1` pulls it in transitively; only add it if you\n need to pin a specific version (rare).\n\n## What the agent SHOULD do\n\n- Import everything from `@clawnify/db` where possible\n (`getDB`, `eq`, `and`, `desc`, `sql`, `sqliteTable`, `text`,\n `integer`, `index`, etc. are all re-exported there). Drop to\n `drizzle-orm` directly only for things not re-exported.\n- Give every route a clear `summary`/`description` and Zod-typed\n request/response so the agent can discover and call it via the\n OpenAPI spec.\n- Test on the draft URL (`<slug>.draft.clawnify.com`) before\n publishing \u2014 the preview tier catches schema drift and type errors\n at build time.\n- When unsure about a Drizzle pattern, check the `@clawnify/db`\n README for the current API + version notes.\n\n## Schema-as-data exception\n\nApps that let END users define data shapes at runtime (CMS, no-code\ntable editor) can\'t model their schema in `schema.ts` \u2014 the table\ndefinitions live in rows. Those apps fall back to the raw SQL API\nfrom `@clawnify/db` (`query`, `get`, `run`, `json`). Open-cms is\nthe canonical example.\n\nIf you\'re building this kind of app, you still use Drizzle\'s\n`schema.ts` for the **registry** tables (content types, field\ndefinitions). Only the dynamically-spawned per-collection tables\nneed raw SQL. See open-cms\'s `src/server/schema-sync.ts` for the\nruntime DDL pattern.\n'
|
|
1410
|
+
content: '# Build a Clawnify app\n\nCanonical skill: how to author a Clawnify app end-to-end. Same content\nfor humans reading the docs and for AI coding agents injecting this as\ninstructions during an app build.\n\nIf you\'re an agent: this document is enough context to produce a\nworking app from scratch. Follow it literally. The patterns here\nare exactly what `clawnify init` scaffolds and what the platform\nexpects.\n\n## TL;DR\n\n- **One stack.** Hono + React + Vite + `@hono/zod-openapi` +\n `@clawnify/db` (Drizzle) + `@clawnify/app` (entry, routing,\n identity) + Tailwind v4. Nothing else.\n- **Schema lives in two files kept in sync** \u2014 `schema.ts` (Drizzle\n DSL, the typed view your queries use) and `schema.sql` (the DDL the\n deploy applies to your app\'s D1). Change one, change the other.\n- **Queries through `getDB`** \u2014 `import { getDB, eq } from\n "@clawnify/db"`. JSON columns auto-serialize.\n- **API routes are `OpenAPIHono` + `createRoute`** \u2014 Zod-validated\n request/response.\n- **`createApp()`** (from `@clawnify/app`) builds the entry \u2014 it returns an\n `OpenAPIHono` with API discovery already mounted (`/api/openapi.json` +\n `/llms.txt`, generated from your live routes). That descriptor *is* the\n tool surface agents discover. Never hand-write those routes.\n- **One import.** `@clawnify/app` re-exports `createRoute`, `z` and\n `OpenAPIHono`, and adds `user` / `orgId` / `caller`. Import from it, not\n from `@clawnify/routes` directly.\n- **`clawnify.json`** declares framework, env, and public routes.\n There is no `api.tools[]` \u2014 the agent discovers and calls your\n endpoints via `/llms.txt` (and the OpenAPI spec).\n- **Identity is injected by the platform** \u2014 read it with `user(c)` /\n `orgId(c)` / `caller(c)` from `@clawnify/app`. Your app never\n authenticates anyone.\n\n## Stack rationale\n\nOne template, one set of decisions. Don\'t deviate unless the user has\nexplicitly asked. `clawnify init` (type `app`) scaffolds either a\n`blank` template (one GET route + a page) or a `crud` template (a\ntable with list/create/update/delete + a form). Both share the exact\nsame stack below.\n\n## File layout\n\n```\nmy-app/\n clawnify.json \u2190 Manifest (validated against /schema/v1/clawnify.json)\n package.json\n tsconfig.json\n vite.config.ts \u2190 @vitejs/plugin-react + @tailwindcss/vite; proxies /api \u2192 :8787\n index.html\n .gitignore\n .clawnify/ \u2190 CLI cache (gitignored)\n wrangler.toml \u2190 Generated per-dev wrangler config\n src/\n server/\n index.ts \u2190 OpenAPIHono entry \u2014 mounts routes, serves /api/openapi.json\n routes.ts \u2190 OpenAPIHono + createRoute definitions \u2014 the API surface\n schema.ts \u2190 Drizzle table definitions (typed view for queries)\n schema.sql \u2190 canonical DDL the deploy applies \u2014 keep in sync with schema.ts\n worker-env.d.ts \u2190 Cloudflare Workers types reference\n uploads.ts \u2190 R2 helpers (only when storage is enabled)\n client/\n main.tsx \u2190 React mount point\n app.tsx \u2190 Root component (plain fetch against /api/*)\n index.css \u2190 @import "tailwindcss"\n```\n\n## Schema \u2014 `schema.ts` + `schema.sql`, kept in sync\n\nTwo files describe the same tables. `schema.ts` (Drizzle DSL) is the\ntyped view your queries compile against; `schema.sql` is the DDL the\ndeploy applies to your app\'s D1. **When you change one, update the\nother** \u2014 they must describe the same tables.\n\nThe scaffold\'s starter table (blank template):\n\n```ts\n// src/server/schema.ts\nimport { sqliteTable, text, integer } from "@clawnify/db";\n\nexport const items = sqliteTable("items", {\n id: integer("id").primaryKey({ autoIncrement: true }),\n name: text("name").notNull(),\n createdAt: text("created_at").notNull().$default(() => new Date().toISOString()),\n});\n```\n\nReal apps are multi-tenant. Every user-facing table carries an\n`org_id`, every query filters by it. JSON columns and indexes use the\nDrizzle DSL re-exported from `@clawnify/db`:\n\n```ts\nimport { sqliteTable, text, integer, index } from "@clawnify/db";\n\nexport const notes = sqliteTable(\n "notes",\n {\n id: integer("id").primaryKey({ autoIncrement: true }),\n orgId: text("org_id").notNull(), // ALWAYS filter by this in queries\n title: text("title").notNull(),\n body: text("body").notNull().default(""),\n tags: text("tags", { mode: "json" }).$type<string[]>().notNull().default([]),\n createdAt: text("created_at").notNull().$default(() => new Date().toISOString()),\n },\n (t) => ({\n byOrg: index("notes_by_org").on(t.orgId, t.createdAt),\n }),\n);\n```\n\nRules:\n- JSON columns: `text(col, { mode: "json" }).$type<T>()` \u2014 Drizzle\n serializes on write and parses on read.\n- Multi-tenancy: every user-facing table has `org_id`. Every query\n filters by it. No exceptions.\n- Identifiers: snake_case in SQL, camelCase in TS (Drizzle bridges).\n\n## `schema.sql` \u2014 the DDL the deploy applies\n\nAlongside `schema.ts`, keep a `schema.sql` describing the same tables.\nThis is the DDL applied to your app\'s database on deploy.\n\n```sql\n-- src/server/schema.sql (mirror of the schema.ts tables)\nCREATE TABLE IF NOT EXISTS notes (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n org_id TEXT NOT NULL,\n title TEXT NOT NULL,\n body TEXT NOT NULL DEFAULT \'\',\n tags TEXT NOT NULL DEFAULT \'[]\', -- JSON column\n created_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS notes_by_org ON notes(org_id, created_at);\n```\n\nRules:\n- Always `CREATE TABLE IF NOT EXISTS` \u2014 the apply is additive and\n re-run-safe.\n- Add a new column with `ALTER TABLE <t> ADD COLUMN \u2026` at the **end** of\n `schema.sql`, and reflect it in `schema.ts`. The deploy adds it.\n- Deploys are **additive**: new tables and columns are added\n automatically. Destructive changes (dropping or retyping a column) are\n not applied automatically \u2014 do those deliberately, and never drop a\n table with user data unless explicitly asked.\n- **Never let `schema.ts` and `schema.sql` drift.** Change one, change\n the other \u2014 they must describe the same tables.\n\n## `src/server/index.ts` \u2014 the entry\n\n```ts\nimport { createApp } from "@clawnify/app";\nimport api from "./routes";\n\ntype Env = { Bindings: { DB: D1Database } };\n\n// db:false \u2014 this app reads the database per request via getDB(c.env),\n// which needs no init middleware.\nconst app = createApp<Env>({ title: "My app", version: "1.0.0", db: false });\n\napp.route("/", api);\n\nexport default app;\n```\n\nThe entry is thin: `createApp()` then mount your routes. `createApp`\nreturns an `OpenAPIHono` with **API discovery already mounted** \u2014 it\nserves both `/api/openapi.json` (generated from your `createRoute`\ndefinitions, with schemas) **and** `/llms.txt` (the same, agent-readable).\nAny `/api/*` route written as a plain `app.get` with no `createRoute` is\nstill listed from the live route table, so the endpoint inventory is\nalways complete. **Never hand-write a `/openapi.json` or `/llms.txt`\nhandler** \u2014 and don\'t call `mountDiscovery` yourself; `createApp` did it.\n\nWhen storage (file uploads) is enabled, the entry also wires the R2\nbucket in a middleware before mounting routes:\n\n```ts\nimport { createApp } from "@clawnify/app";\nimport { initUploads } from "./uploads";\nimport api from "./routes";\n\ntype Env = { Bindings: { DB: D1Database; UPLOADS: R2Bucket } };\n\nconst app = createApp<Env>({ title: "My app", version: "1.0.0", db: false });\n\napp.use("*", async (c, next) => {\n initUploads(c.env.UPLOADS);\n await next();\n});\n\napp.route("/", api);\n\nexport default app;\n```\n\n## `src/server/routes.ts` \u2014 routes with `createRoute`\n\nEach endpoint is a `createRoute({ method, path, summary, request, responses })`\ndefinition paired with a handler via `api.openapi(route, handler)`.\nRequest bodies and params are Zod-validated (`c.req.valid("json")`,\n`c.req.valid("param")`); response shapes are declared with\n`.openapi("Name")` Zod schemas so they land in the generated spec.\n\nBlank template \u2014 one read route:\n\n```ts\nimport { OpenAPIHono, createRoute, z } from "@clawnify/app";\nimport { getDB, desc } from "@clawnify/db";\nimport * as schema from "./schema";\n\ntype Env = { Bindings: { DB: D1Database } };\nconst api = new OpenAPIHono<Env>();\n\nconst ItemSchema = z.object({\n id: z.number(),\n name: z.string(),\n createdAt: z.string(),\n}).openapi("Item");\n\napi.openapi(\n createRoute({\n method: "get",\n path: "/api/items",\n summary: "List items",\n responses: {\n 200: {\n description: "List of items",\n content: { "application/json": { schema: z.array(ItemSchema) } },\n },\n },\n }),\n async (c) => {\n const db = getDB(c.env, { schema });\n const items = await db\n .select()\n .from(schema.items)\n .orderBy(desc(schema.items.createdAt));\n return c.json(items);\n },\n);\n\nexport default api;\n```\n\nCRUD template \u2014 the full list/create/update/delete surface:\n\n```ts\nimport { OpenAPIHono, createRoute, z } from "@clawnify/app";\nimport { getDB, eq, desc } from "@clawnify/db";\nimport * as schema from "./schema";\n\ntype Env = { Bindings: { DB: D1Database } };\nconst api = new OpenAPIHono<Env>();\n\nconst ItemSchema = z.object({\n id: z.number(),\n title: z.string(),\n status: z.string(),\n createdAt: z.string(),\n}).openapi("Item");\n\nconst CreateItemSchema = z.object({ title: z.string().min(1) }).openapi("CreateItem");\nconst UpdateItemSchema = z.object({\n title: z.string().min(1).optional(),\n status: z.string().optional(),\n}).openapi("UpdateItem");\nconst IdParamSchema = z.object({ id: z.string() });\nconst OkSchema = z.object({ ok: z.boolean() }).openapi("Ok");\n\napi.openapi(\n createRoute({\n method: "get",\n path: "/api/items",\n summary: "List items",\n responses: {\n 200: {\n description: "List of items",\n content: { "application/json": { schema: z.array(ItemSchema) } },\n },\n },\n }),\n async (c) => {\n const db = getDB(c.env, { schema });\n const items = await db\n .select()\n .from(schema.items)\n .orderBy(desc(schema.items.createdAt));\n return c.json(items);\n },\n);\n\napi.openapi(\n createRoute({\n method: "post",\n path: "/api/items",\n summary: "Create item",\n request: { body: { content: { "application/json": { schema: CreateItemSchema } } } },\n responses: {\n 201: {\n description: "Created item",\n content: { "application/json": { schema: ItemSchema } },\n },\n },\n }),\n async (c) => {\n const { title } = c.req.valid("json");\n const db = getDB(c.env, { schema });\n const [row] = await db\n .insert(schema.items)\n .values({ title: title.trim() })\n .returning();\n return c.json(row, 201);\n },\n);\n\napi.openapi(\n createRoute({\n method: "patch",\n path: "/api/items/:id",\n summary: "Update item",\n request: {\n params: IdParamSchema,\n body: { content: { "application/json": { schema: UpdateItemSchema } } },\n },\n responses: {\n 200: { description: "Updated", content: { "application/json": { schema: OkSchema } } },\n },\n }),\n async (c) => {\n const { id } = c.req.valid("param");\n const body = c.req.valid("json");\n const patch: Partial<typeof schema.items.$inferInsert> = {};\n if (body.title !== undefined) patch.title = body.title;\n if (body.status !== undefined) patch.status = body.status;\n if (Object.keys(patch).length === 0) return c.json({ ok: false }, 400);\n const db = getDB(c.env, { schema });\n await db.update(schema.items).set(patch).where(eq(schema.items.id, Number(id)));\n return c.json({ ok: true });\n },\n);\n\napi.openapi(\n createRoute({\n method: "delete",\n path: "/api/items/:id",\n summary: "Delete item",\n request: { params: IdParamSchema },\n responses: {\n 200: { description: "Deleted", content: { "application/json": { schema: OkSchema } } },\n },\n }),\n async (c) => {\n const { id } = c.req.valid("param");\n const db = getDB(c.env, { schema });\n await db.delete(schema.items).where(eq(schema.items.id, Number(id)));\n return c.json({ ok: true });\n },\n);\n\nexport default api;\n```\n\nPatterns to follow:\n- **Give every route a clear `summary`/`description`.** The generated\n OpenAPI spec is what the agent reads to decide which endpoint to\n call \u2014 a vague summary makes your endpoint invisible in practice.\n- **Validate input with Zod** via `request.body` / `request.params`\n and read it with `c.req.valid("json")` / `c.req.valid("param")`.\n Never parse `c.req.raw` by hand.\n- **Declare response shapes** with `.openapi("Name")` schemas \u2014 they\n become the documented return type in the spec.\n- **Filter by the org** on every user-facing query (see "who is\n calling" below). No exceptions.\n\n## `src/server` \u2014 who is calling\n\nThe platform authenticates every caller at its perimeter and injects a\nverified identity onto the request (it strips any client-supplied\nversion first, so it can\'t be spoofed). Your app never authenticates\nanyone: no `Authorization`, no cookies, no JWT, no login screen.\n\nRead it with the helpers from `@clawnify/app` \u2014 don\'t parse headers\nyourself:\n\n```ts\nimport { user, orgId, caller } from "@clawnify/app";\n\napp.get("/api/notes", async (c) => {\n const org = orgId(c);\n if (!org) return c.json({ error: "unauthorized" }, 401);\n\n const db = getDB(c.env, { schema });\n return c.json(\n await db.select().from(schema.notes).where(eq(schema.notes.orgId, org)),\n );\n});\n```\n\n| Helper | Returns |\n|--------|---------|\n| `orgId(c)` | Organization UUID \u2014 the tenant key. Filter every user-facing query by it. |\n| `user(c)` | `{ id, email, name, avatarUrl, firstName, lastName }` \u2014 or **`null`** when the caller isn\'t a person. |\n| `caller(c)` | `user`, `api`, `agent`, `agent-browser`, `public`, `bypass`, `system`, or `app`. |\n\nTwo rules that catch people out:\n\n- **`user(c)` is null for five of the eight caller kinds**\n (`agent-browser`, `public`, `bypass`, `system`, `app`). Always handle\n the null case \u2014 don\'t assume a person is present just because a\n request arrived. For per-user rows, store `user(c).id` in a `user_id`\n column and filter on it, exactly as you filter on `org_id`.\n- **`firstName` / `lastName` are a heuristic** split of a single stored\n full name (first word / the rest). Fine for a greeting; never persist\n them or treat them as someone\'s legal name \u2014 store `name`.\n\nDon\'t build app-level users, roles, or permissions. Authorization\nalready happened at the perimeter.\n\n## `src/client` \u2014 React + plain fetch\n\nThe client mounts React and talks to the API with plain `fetch`\nagainst the `/api/*` routes. No data-layer library is scaffolded.\n\n```tsx\n// src/client/main.tsx\nimport { StrictMode } from "react";\nimport { createRoot } from "react-dom/client";\nimport { App } from "./app";\nimport "./index.css";\n\ncreateRoot(document.getElementById("app")!).render(\n <StrictMode>\n <App />\n </StrictMode>\n);\n```\n\n```tsx\n// src/client/app.tsx (CRUD template shape)\nimport { useState, useEffect } from "react";\n\ninterface Item {\n id: number;\n title: string;\n status: string;\n createdAt: string;\n}\n\nexport function App() {\n const [items, setItems] = useState<Item[]>([]);\n const [title, setTitle] = useState("");\n\n async function load() {\n const res = await fetch("/api/items");\n setItems(await res.json());\n }\n\n useEffect(() => { load(); }, []);\n\n async function addItem(e: React.FormEvent) {\n e.preventDefault();\n if (!title.trim()) return;\n await fetch("/api/items", {\n method: "POST",\n headers: { "Content-Type": "application/json" },\n body: JSON.stringify({ title }),\n });\n setTitle("");\n load();\n }\n\n // ...toggleStatus / deleteItem call PATCH/DELETE the same way.\n\n return (\n <div className="max-w-xl mx-auto mt-10 px-4">\n {/* form + list */}\n </div>\n );\n}\n```\n\nIn local dev, Vite proxies `/api` to the Worker on `:8787` (see\n`vite.config.ts`), so the same relative fetch paths work in dev and\nin production. The API is the one contract: the UI calls it over\n`fetch`, and the agent calls it over the OpenAPI spec.\n\n## Design\n\nIf the project contains a `DESIGN.md`, it is the single source of\ntruth for visuals \u2014 follow its tokens, don\'t restyle around it. The\nscaffold ships Tailwind v4 (via `@tailwindcss/vite`, imported with\n`@import "tailwindcss";` in `index.css`) and nothing else \u2014 no\ncomponent library. The rules every Clawnify app follows:\n\n- **Neutral chrome.** White canvas and surfaces, one text ramp\n (foreground \u2192 muted \u2192 faint), hairline borders. Color is for\n meaning, not decoration.\n- **One primary CTA per screen.** Blue is reserved for links and\n focus rings; never a second accent.\n- **Status colors are muted pairs** \u2014 never pure-saturated fills.\n- **Style with Tailwind utilities.** Don\'t install another component\n library or write a bespoke CSS system unless the user asks.\n- **Sizes in rem**, so browser zoom and font settings are respected.\n\n## `clawnify.json` \u2014 the manifest\n\n```json\n{\n "$schema": "https://app.clawnify.com/schema/v1/clawnify.json",\n "version": 1,\n "name": "Notes",\n "description": "Take and organize notes. Searchable by tag.",\n "app": {\n "framework": "react+hono",\n "database": true,\n "storage": false\n },\n "env": {\n "optional": ["OPENROUTER_API_KEY"]\n },\n "api": {\n "public_routes": [\n { "path": "/api/feed", "methods": ["GET"] }\n ]\n }\n}\n```\n\n`clawnify init` writes the minimal form:\n`{ app: { framework: "react+hono", database: true, storage } }`. Add\nthe rest as needed.\n\nIf the app talks to third-party services the user has connected\n(ads platforms, CRMs, messaging), declare them:\n\n```json\n{ "app": { "credentials": ["metaads", "googleads"] } }\n```\n\nGet the ids and names from `clawnify connections list` \u2014 see the\nnaming rule below.\n\n`env` supports `required` (deploy warns if missing), `optional`\n(injected when available), and `oneOf` (at least one per group).\n\nRules:\n- **There is no `api.tools[]`.** The manifest\'s `api` object only\n accepts `public_routes` and `automation_bypass`. Your API surface\n is discovered from the generated OpenAPI spec, not a hand-authored\n tools list (see the next section).\n- **Public routes are the exception**, not the default. Every route\n is behind the Clawnify perimeter (auth-required) unless you\n explicitly add a matching path to `api.public_routes`. Use only for\n webhooks, RSS, embedded feeds.\n- **`framework: "react+hono"`** for new apps. Never `preact+hono` or\n `vite-preact` \u2014 those are legacy.\n- **`database: true`** if the app uses a DB. Ship both `schema.ts`\n (typed) and `schema.sql` (the applied DDL), kept in sync.\n\n## How the agent reaches your API (no `api.tools[]`)\n\nThe old tRPC stack emitted an `api.tools[]` array from procedure meta.\nThat mechanism is gone. Today the flow is:\n\n1. Your `createRoute` definitions auto-generate a live OpenAPI 3.0 spec\n plus a lean `/llms.txt` index, both served for you \u2014 never hand-write\n or route them yourself. **These are the agent\'s discovery channel:**\n it calls `call_app_api` with `GET /llms.txt` (index of every\n endpoint) or `GET /api/openapi.json` (full request/response schemas).\n Because both are generated from the live route table, they cannot\n drift from the code.\n2. The agent then drives your endpoints with `call_app_api` (a `method`\n + `path` on the live app). No per-app MCP registration and no\n manifest tools array. Use source reading to *modify* code, not to\n discover endpoints.\n\nSo you make an endpoint "agent-callable" by defining it with\n`createRoute()` + `app.openapi()` and giving it a clear\n`summary`/`description` with Zod-typed request/response. The clearer\nthose are, the more reliably the agent uses it.\n\n### `agent.md` \u2014 lead with the procedure, not the endpoint list\n\n`agent.md` is extracted into `agent_instructions` on every build. Since\ndiscovery is already covered by the generated surfaces above, **`agent.md`\nis not an API reference** \u2014 re-listing every payload there just creates a\nsecond source of truth that goes stale the first time a route changes.\nIt is the one place for what generation can\'t produce: **judgment**.\n\nWrite it in this order:\n\n1. **Division of labour, first and short.** What the agent should do\n itself vs. what it must delegate to the app \u2014 and say the wrong move\n out loud (*"never look up contact details yourself; post the records\n and let the app resolve them"*). This one block prevents more misuse\n than the rest of the file combined.\n2. **The procedure** \u2014 numbered steps for the app\'s main job, written so\n the agent can follow them on a request it has never seen.\n3. **Pages**, flagging the screenshot-friendly ones.\n4. **API anchors, not API docs** \u2014 method, path, and *when to reach for\n it*, plus the one or two request shapes the agent writes most often.\n For anything else, let it read `/llms.txt`.\n5. **How to read failures**, and any **cost discipline** \u2014 which calls\n spend the user\'s money and which are free.\n\n**Don\'t ship a per-app skill.** A skill\'s frontmatter stays resident in\nagent context, so one skill per app grows the agent\'s context floor as\nthe app count grows; `agent_instructions` and `/llms.txt` are pulled on\ndemand instead. Skills are for **cross-app** procedures \u2014 if one earns\nreuse across more than one app, promote that single procedure\n(parameterized) to the shared skills library rather than copying it into\nevery app.\n\n## Connections & secrets \u2014 `@clawnify/connections`\n\n**The naming rule \u2014 never invent an identifier.** Before declaring\n`credentials` or env names, run `clawnify connections list`: it shows\nthe org\'s canonical integration ids (`googleads`, never `google_ads`),\nthe fixed provider-key names (`OPENROUTER_API_KEY`, never\n`OPENROUTER_KEY`), and custom env vars already defined \u2014 each with\nconnected/set state. Reuse those exact identifiers; a misspelled one\ndoesn\'t fail the build, it silently resolves to nothing at runtime. If\nyou need a custom secret that isn\'t listed, pick a clear name and tell\nthe user to set it in the dashboard.\n\nIf the app needs a third-party service or a provider API key, use\nthe `@clawnify/connections` SDK. Never read credential bindings\ndirectly, never paste API keys, never hardcode a token or endpoint.\n\n```ts\nimport { connect, secret, describe, searchActions } from "@clawnify/connections";\n\n// A connected integration:\nconst meta = connect("metaads", env);\nconst accounts = await meta.adAccounts("name,currency");\n\n// A provider key the user supplied (null if absent):\nconst key = secret("OPENROUTER_API_KEY", env);\n\n// What\'s wired vs missing \u2014 drive your setup/empty state from this:\nconst status = await describe(env, undefined, REQUIRES);\n```\n\nHow to call a connected service \u2014 the mistake that silently breaks\nintegration apps, so get it right:\n\n- **Prefer the typed client\'s semantic methods** where they exist\n (`meta.adAccounts(...)`, `googleads.query(gaql)`).\n- **For anything else, discover and run an action:**\n ```ts\n const [best] = await searchActions("list google ads campaigns", env);\n const data = await connect(best.service, env).run(best.slug, body);\n ```\n- Some integrations also expose a raw REST client\n (`connect("bird", env).get("/path")`) \u2014 but if `.get()`/`.post()`\n throws for a service, that service only supports semantic methods\n and `run()`. When unsure, use `run()`.\n- **Need exact paths/arguments for a raw-REST provider?** Some carry\n a `spec_url` (the provider\'s published OpenAPI spec) \u2014\n `clawnify connections list --json` shows it. Download and query it \u2014\n `curl -s <spec_url> -o spec.json && jq \'.paths | keys\' spec.json` \u2014\n never read a whole spec into context (they run to 10+ MB).\n- **Never fall back to raw `fetch`** against a provider API, and\n never invent endpoints or guess tokens.\n\n**The one exception \u2014 a service we don\'t support at all.** If a\nprovider isn\'t in the connections registry (nothing to `connect()`\nto, and `clawnify connections list` doesn\'t show it), the sanctioned\npath *is* a raw call with a user-supplied key: declare the key(s) it\nneeds in `clawnify.json` `env` (`required`/`optional`/`oneOf`), tell\nthe user to set them in the dashboard, read them with\n`secret("THAT_KEY", env)`, and `fetch` the provider\'s documented\nendpoints directly. This is the escape hatch for the long tail of\nintegrations we don\'t model yet \u2014 it does **not** apply to a service\nwe *do* support (use `connect()` / `run()` for those, always). Keep\nthe endpoint and token server-side, never in the client bundle.\n\nBuild a `describe()`-driven setup state instead of assuming\nconnections exist \u2014 show the user what\'s missing and where to\nconnect it.\n\n## Scheduling & deferred work \u2014 the managed queue\n\nA deployed app **cannot bind Cloudflare Queues, Durable Objects, or cron\ntriggers** (the platform builds every app with a fixed binding set: `DB` +\n`ASSETS` + `UPLOADS`). To run work later \u2014 a scheduled publish, a reminder, a\nretry, a "do this in 10 minutes" \u2014 use the **Clawnify managed queue service**\nover HTTP. It owns the clock, retries, and at-least-once delivery, then calls an\nendpoint on *your own app* back at the scheduled time.\n\nIt\'s a thin seam over a platform primitive, same shape as `@clawnify/db` /\n`@clawnify/connections` (a `@clawnify/queue` package is coming; inline the seam\nuntil then). Auth is the build-injected `env.CLAWNIFY_TOKEN`; with no token\n(local dev) the seam degrades to a no-op.\n\n**Enqueue** a deferred call to your own endpoint:\n\n```ts\n// POST https://services.clawnify.com/queue/enqueue (Bearer CLAWNIFY_TOKEN)\nconst res = await fetch("https://services.clawnify.com/queue/enqueue", {\n method: "POST",\n headers: { Authorization: `Bearer ${env.CLAWNIFY_TOKEN}`, "Content-Type": "application/json" },\n body: JSON.stringify({\n target_url: `${origin}/api/internal/publish`, // an endpoint on THIS app\n payload: { post_id: id }, // echoed back to you on fire\n run_at: new Date(whenMs).toISOString(),\n idempotency_key: `post:${id}:${whenMs}`, // same key dedupes; new time = new job\n }),\n});\nconst { job_id } = await res.json(); // store it to cancel/reschedule\n```\n\nPersist `job_id` on the row (e.g. `posts.queue_job_id`). **Cancel / reschedule**:\n`DELETE https://services.clawnify.com/queue/jobs/{job_id}` (Bearer token);\nreschedule = cancel + a fresh enqueue.\n\n**The callback endpoint is a public, signature-verified route.** The queue calls\n`target_url` from outside the perimeter, so the endpoint must be declared in\n`clawnify.json` `public_routes` **and** verify the delivery signature itself \u2014\nthe signature *is* its auth (never trust an unsigned call):\n\n```jsonc\n// clawnify.json\n"api": { "public_routes": [ { "path": "/api/internal/publish", "methods": ["POST"] } ] }\n```\n\nDeliveries are signed with the platform\'s **ECDSA P-256 (ES256)** key,\nStripe-style over `${timestamp}.${rawBody}`, verified against\n`https://services.clawnify.com/.well-known/jwks.json` (public key \u2014 nothing\nbreaks on token rotation). Read the raw body, check the signature + a timestamp\ntolerance (~5 min) before doing anything:\n\n```ts\napp.post("/api/internal/publish", async (c) => {\n const raw = await c.req.text();\n const ok = await verifyDelivery(raw, {\n signature: c.req.header("x-clawnify-signature"),\n timestamp: c.req.header("x-clawnify-timestamp"),\n keyId: c.req.header("x-clawnify-key-id"),\n });\n if (!ok) return c.json({ error: "bad signature" }, 401);\n const { post_id } = JSON.parse(raw);\n // \u2026do the deferred work (short: it\'s one normal Worker invocation)\u2026\n return c.json({ ok: true });\n});\n```\n\nEach fire is a normal Worker request \u2014 size the work to one invocation (publish a\npost, send a digest). For long compute *now* (not deferred), hold the request\nopen and return when done; don\'t fire-and-forget past the response.\n\n## Migrations\n\nKeep `schema.ts` and `schema.sql` in sync by hand. The workflow is:\n\n1. Edit `src/server/schema.ts` for the new shape (types + queries).\n2. Make the matching edit in `src/server/schema.sql` \u2014 a new\n `CREATE TABLE IF NOT EXISTS`, or `ALTER TABLE \u2026 ADD COLUMN \u2026` at the\n **end** of the file for a new column.\n3. Run `clawnify dev` locally, then `clawnify deploy`.\n\nOn deploy your schema changes are applied to the app\'s database \u2014 new\ntables and columns are added automatically.\n\nDestructive changes (drop column, rename) are not applied automatically;\ndo them deliberately, and only when the user explicitly asks. Renames\nare risky on production data \u2014 prefer "add new column, backfill, switch\nqueries, drop old column" over a single-step rename.\n\n## What the agent must NOT do\n\n- Author a `/openapi.json` handler by hand. `app.doc("/api/openapi.json", \u2026)`\n generates it from your `createRoute` definitions.\n- Let `schema.ts` and `schema.sql` drift. They describe the same\n tables \u2014 change both, every time.\n- Hand-author migration SQL files. Make schema changes in `schema.sql`\n (and mirror them in `schema.ts`); the deploy applies them.\n- Invent an `api.tools[]` array in the manifest. It isn\'t a valid\n field \u2014 the OpenAPI spec is the tool surface.\n- Use `JSON.stringify` on query params. JSON columns auto-serialize\n via Drizzle. The raw SQL API has `json()` as a helper.\n- Skip the `org_id` filter on a user-facing query. Multi-tenant\n leak is the worst-class bug we can ship.\n- Read auth from `Authorization` / cookies / `Bearer` tokens, or\n hand-parse `X-Clawnify-*` headers. Use `user(c)` / `orgId(c)` /\n `caller(c)` from `@clawnify/app`.\n- Call third-party APIs with raw `fetch` or hardcoded tokens. Go\n through `@clawnify/connections` (`connect` / `secret` / `run`).\n- Install `drizzle-orm` as a separate top-level dependency.\n `@clawnify/db@^0.4.1` pulls it in transitively; only add it if you\n need to pin a specific version (rare).\n\n## What the agent SHOULD do\n\n- Import everything from `@clawnify/db` where possible\n (`getDB`, `eq`, `and`, `desc`, `sql`, `sqliteTable`, `text`,\n `integer`, `index`, etc. are all re-exported there). Drop to\n `drizzle-orm` directly only for things not re-exported.\n- Give every route a clear `summary`/`description` and Zod-typed\n request/response so the agent can discover and call it via the\n OpenAPI spec.\n- Test on the draft URL (`<slug>.draft.clawnify.com`) before\n publishing \u2014 the preview tier catches schema drift and type errors\n at build time.\n- When unsure about a Drizzle pattern, check the `@clawnify/db`\n README for the current API + version notes.\n\n## Schema-as-data exception\n\nApps that let END users define data shapes at runtime (CMS, no-code\ntable editor) can\'t model their schema in `schema.ts` \u2014 the table\ndefinitions live in rows. Those apps fall back to the raw SQL API\nfrom `@clawnify/db` (`query`, `get`, `run`, `json`). Open-cms is\nthe canonical example.\n\nIf you\'re building this kind of app, you still use Drizzle\'s\n`schema.ts` for the **registry** tables (content types, field\ndefinitions). Only the dynamically-spawned per-collection tables\nneed raw SQL. See open-cms\'s `src/server/schema-sync.ts` for the\nruntime DDL pattern.\n'
|
|
1411
1411
|
},
|
|
1412
1412
|
{
|
|
1413
1413
|
name: "use-the-clawnify-cli",
|
|
@@ -1437,10 +1437,10 @@ var VERSION_HEADER_RE = /<!--\s*clawnify-skill:\s*([\w-]+)\s+v([\d.]+)\s*-->/;
|
|
|
1437
1437
|
function versionHeader(name) {
|
|
1438
1438
|
return `<!-- clawnify-skill: ${name} v${CLI_VERSION} -->`;
|
|
1439
1439
|
}
|
|
1440
|
-
function readExistingVersion(
|
|
1441
|
-
if (!existsSync2(
|
|
1440
|
+
function readExistingVersion(path10) {
|
|
1441
|
+
if (!existsSync2(path10)) return null;
|
|
1442
1442
|
try {
|
|
1443
|
-
const head = readFileSync(
|
|
1443
|
+
const head = readFileSync(path10, "utf8").slice(0, 500);
|
|
1444
1444
|
const match = head.match(VERSION_HEADER_RE);
|
|
1445
1445
|
return match ? match[2] : null;
|
|
1446
1446
|
} catch {
|
|
@@ -3535,8 +3535,8 @@ async function docsCommand(slug, options) {
|
|
|
3535
3535
|
process.exit(1);
|
|
3536
3536
|
}
|
|
3537
3537
|
const caller = options.caller ?? "external";
|
|
3538
|
-
const
|
|
3539
|
-
const res = await fetch(DOCS_URL +
|
|
3538
|
+
const path10 = slug ? `/docs/${auth.org_id}/${slug}.md?caller=${caller}` : `/docs/${auth.org_id}/index.md`;
|
|
3539
|
+
const res = await fetch(DOCS_URL + path10, {
|
|
3540
3540
|
headers: {
|
|
3541
3541
|
authorization: "Bearer " + token
|
|
3542
3542
|
}
|
|
@@ -3727,6 +3727,166 @@ Valid: ${ALL_AGENTS.join(", ")}`
|
|
|
3727
3727
|
return detectAgents(process.cwd());
|
|
3728
3728
|
}
|
|
3729
3729
|
|
|
3730
|
+
// src/commands/flows.ts
|
|
3731
|
+
import { spawnSync } from "child_process";
|
|
3732
|
+
import fs8 from "fs";
|
|
3733
|
+
import os from "os";
|
|
3734
|
+
import path9 from "path";
|
|
3735
|
+
function flowFileName(name) {
|
|
3736
|
+
return name.endsWith(".json") ? name : `${name}.json`;
|
|
3737
|
+
}
|
|
3738
|
+
function parseFlowFile(file) {
|
|
3739
|
+
const abs = path9.resolve(file);
|
|
3740
|
+
let raw;
|
|
3741
|
+
try {
|
|
3742
|
+
raw = fs8.readFileSync(abs, "utf8");
|
|
3743
|
+
} catch {
|
|
3744
|
+
console.error(`Cannot read ${abs}.`);
|
|
3745
|
+
process.exit(1);
|
|
3746
|
+
}
|
|
3747
|
+
try {
|
|
3748
|
+
const parsed = JSON.parse(raw);
|
|
3749
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error();
|
|
3750
|
+
return parsed;
|
|
3751
|
+
} catch {
|
|
3752
|
+
console.error(`${abs} is not a valid flow definition (expected a JSON object).`);
|
|
3753
|
+
process.exit(1);
|
|
3754
|
+
}
|
|
3755
|
+
}
|
|
3756
|
+
function failValidation(payload, note) {
|
|
3757
|
+
console.error(payload.error ?? "Flow validation failed:");
|
|
3758
|
+
for (const e of payload.errors ?? []) {
|
|
3759
|
+
const where = [e.node && `node "${e.node}"`, e.field].filter(Boolean).join(", ");
|
|
3760
|
+
console.error(` - ${where ? `${where}: ` : ""}${e.message}`);
|
|
3761
|
+
}
|
|
3762
|
+
if (note) console.error(note);
|
|
3763
|
+
process.exit(1);
|
|
3764
|
+
}
|
|
3765
|
+
async function draftExists(serverId, name) {
|
|
3766
|
+
const res = await api.get(`/servers/${serverId}/flows?name=${encodeURIComponent(flowFileName(name))}`);
|
|
3767
|
+
return res.ok;
|
|
3768
|
+
}
|
|
3769
|
+
async function saveDraft(serverId, name, flow, validationNote) {
|
|
3770
|
+
const res = await api.post(`/servers/${serverId}/flows`, { name, flow });
|
|
3771
|
+
const payload = await res.json().catch(() => ({}));
|
|
3772
|
+
if (res.status === 422 && payload.errors) failValidation(payload, validationNote);
|
|
3773
|
+
if (!res.ok) {
|
|
3774
|
+
console.error(`Failed to save draft (${res.status})${payload.error ? `: ${payload.error}` : ""}.`);
|
|
3775
|
+
process.exit(1);
|
|
3776
|
+
}
|
|
3777
|
+
}
|
|
3778
|
+
async function flowsListCommand(opts) {
|
|
3779
|
+
const serverId = await resolveServerId(opts.server);
|
|
3780
|
+
const res = await api.get(`/servers/${serverId}/flows`);
|
|
3781
|
+
if (!res.ok) {
|
|
3782
|
+
console.error(`Failed to list flows (${res.status}).`);
|
|
3783
|
+
process.exit(1);
|
|
3784
|
+
}
|
|
3785
|
+
const { flows } = await res.json();
|
|
3786
|
+
if (opts.json) {
|
|
3787
|
+
console.log(JSON.stringify(flows, null, 2));
|
|
3788
|
+
return;
|
|
3789
|
+
}
|
|
3790
|
+
if (!flows || flows.length === 0) {
|
|
3791
|
+
console.log("No flows on this server. Create one with: clawnify flows create <name> --file flow.json");
|
|
3792
|
+
return;
|
|
3793
|
+
}
|
|
3794
|
+
const nameW = Math.max(4, ...flows.map((f) => f.flow.length));
|
|
3795
|
+
console.log(`${"Name".padEnd(nameW)} ${"Nodes".padEnd(5)} ${"Published".padEnd(9)} Updated`);
|
|
3796
|
+
console.log(`${"\u2500".repeat(nameW)} ${"\u2500".repeat(5)} ${"\u2500".repeat(9)} ${"\u2500".repeat(10)}`);
|
|
3797
|
+
for (const f of flows) {
|
|
3798
|
+
const published = f.published != null ? `v${f.published}` : "\u2014";
|
|
3799
|
+
const updated = (f.updated_at ?? "").slice(0, 16).replace("T", " ");
|
|
3800
|
+
console.log(`${f.flow.padEnd(nameW)} ${String(f.nodes?.length ?? 0).padEnd(5)} ${published.padEnd(9)} ${updated}`);
|
|
3801
|
+
}
|
|
3802
|
+
}
|
|
3803
|
+
async function flowsReadCommand(name, opts) {
|
|
3804
|
+
const serverId = await resolveServerId(opts.server);
|
|
3805
|
+
const res = await api.get(`/servers/${serverId}/flows?name=${encodeURIComponent(flowFileName(name))}`);
|
|
3806
|
+
if (!res.ok) {
|
|
3807
|
+
if (res.status === 404) console.error(`No draft flow named "${name}" on this server.`);
|
|
3808
|
+
else console.error(`Failed to read flow (${res.status}).`);
|
|
3809
|
+
process.exit(1);
|
|
3810
|
+
}
|
|
3811
|
+
const { flow } = await res.json();
|
|
3812
|
+
console.log(JSON.stringify(flow, null, 2));
|
|
3813
|
+
}
|
|
3814
|
+
async function flowsCreateCommand(name, opts) {
|
|
3815
|
+
if (!opts.file) {
|
|
3816
|
+
console.error(`Provide the flow definition: clawnify flows create ${name} --file flow.json`);
|
|
3817
|
+
process.exit(1);
|
|
3818
|
+
}
|
|
3819
|
+
const serverId = await resolveServerId(opts.server);
|
|
3820
|
+
const flow = parseFlowFile(opts.file);
|
|
3821
|
+
if (await draftExists(serverId, name)) {
|
|
3822
|
+
console.error(`A draft named "${name}" already exists. Update it with: clawnify flows edit ${name} --file ${opts.file}`);
|
|
3823
|
+
process.exit(1);
|
|
3824
|
+
}
|
|
3825
|
+
await saveDraft(serverId, name, flow);
|
|
3826
|
+
const nodes = Array.isArray(flow.nodes) ? flow.nodes.length : 0;
|
|
3827
|
+
console.log(`Created draft flow "${name}" (${nodes} node${nodes === 1 ? "" : "s"}). Not live yet \u2014 publish with: clawnify flows publish ${name}`);
|
|
3828
|
+
}
|
|
3829
|
+
async function flowsEditCommand(name, opts) {
|
|
3830
|
+
const serverId = await resolveServerId(opts.server);
|
|
3831
|
+
if (!await draftExists(serverId, name)) {
|
|
3832
|
+
console.error(`No draft flow named "${name}" on this server. Create it with: clawnify flows create ${name} --file flow.json`);
|
|
3833
|
+
process.exit(1);
|
|
3834
|
+
}
|
|
3835
|
+
let flow;
|
|
3836
|
+
let tmpDir = null;
|
|
3837
|
+
let tmpFile = null;
|
|
3838
|
+
if (opts.file) {
|
|
3839
|
+
flow = parseFlowFile(opts.file);
|
|
3840
|
+
} else {
|
|
3841
|
+
const res = await api.get(`/servers/${serverId}/flows?name=${encodeURIComponent(flowFileName(name))}`);
|
|
3842
|
+
const { flow: current } = await res.json();
|
|
3843
|
+
tmpDir = fs8.mkdtempSync(path9.join(os.tmpdir(), "clawnify-flow-"));
|
|
3844
|
+
tmpFile = path9.join(tmpDir, flowFileName(name));
|
|
3845
|
+
fs8.writeFileSync(tmpFile, JSON.stringify(current, null, 2) + "\n");
|
|
3846
|
+
const editor = process.env.VISUAL || process.env.EDITOR || "vi";
|
|
3847
|
+
const result = spawnSync(`${editor} "${tmpFile}"`, { shell: true, stdio: "inherit" });
|
|
3848
|
+
if (result.status !== 0) {
|
|
3849
|
+
console.error(`Editor exited without saving \u2014 draft unchanged (kept at ${tmpFile}).`);
|
|
3850
|
+
process.exit(1);
|
|
3851
|
+
}
|
|
3852
|
+
const edited = fs8.readFileSync(tmpFile, "utf8");
|
|
3853
|
+
if (edited === JSON.stringify(current, null, 2) + "\n") {
|
|
3854
|
+
fs8.rmSync(tmpDir, { recursive: true, force: true });
|
|
3855
|
+
console.log("No changes.");
|
|
3856
|
+
return;
|
|
3857
|
+
}
|
|
3858
|
+
try {
|
|
3859
|
+
flow = JSON.parse(edited);
|
|
3860
|
+
} catch {
|
|
3861
|
+
console.error(`Edited file is not valid JSON \u2014 draft unchanged (kept at ${tmpFile}; re-save with: clawnify flows edit ${name} --file "${tmpFile}")`);
|
|
3862
|
+
process.exit(1);
|
|
3863
|
+
}
|
|
3864
|
+
}
|
|
3865
|
+
await saveDraft(
|
|
3866
|
+
serverId,
|
|
3867
|
+
name,
|
|
3868
|
+
flow,
|
|
3869
|
+
tmpFile ? `Draft unchanged \u2014 your edits are kept at ${tmpFile}; fix and re-save with: clawnify flows edit ${name} --file "${tmpFile}"` : void 0
|
|
3870
|
+
);
|
|
3871
|
+
if (tmpDir) fs8.rmSync(tmpDir, { recursive: true, force: true });
|
|
3872
|
+
console.log(`Saved draft "${name}". Live runs still use the last published version \u2014 publish with: clawnify flows publish ${name}`);
|
|
3873
|
+
}
|
|
3874
|
+
async function flowsPublishCommand(name, opts) {
|
|
3875
|
+
const serverId = await resolveServerId(opts.server);
|
|
3876
|
+
const res = await api.post(`/servers/${serverId}/flows/publish`, { name });
|
|
3877
|
+
const payload = await res.json().catch(() => ({}));
|
|
3878
|
+
if (res.status === 404) {
|
|
3879
|
+
console.error(`No draft flow named "${name}" on this server \u2014 nothing to publish.`);
|
|
3880
|
+
process.exit(1);
|
|
3881
|
+
}
|
|
3882
|
+
if (res.status === 422 && payload.errors) failValidation(payload);
|
|
3883
|
+
if (!res.ok) {
|
|
3884
|
+
console.error(`Failed to publish (${res.status})${payload.error ? `: ${payload.error}` : ""}.`);
|
|
3885
|
+
process.exit(1);
|
|
3886
|
+
}
|
|
3887
|
+
console.log(`Published "${name}" as v${payload.version}. flow_run and webhook triggers now use v${payload.version}.`);
|
|
3888
|
+
}
|
|
3889
|
+
|
|
3730
3890
|
// src/cli.ts
|
|
3731
3891
|
async function runCli() {
|
|
3732
3892
|
const program = new Command();
|
|
@@ -3764,6 +3924,12 @@ async function runCli() {
|
|
|
3764
3924
|
agents.command("skills [agent]").description("Show an agent's effective skill inventory (what it can actually run, not just its workspace)").option("--server <id>", "Target server (default: the org's server)").action(agentsSkillsCommand);
|
|
3765
3925
|
agents.command("grant-skill <skill>").description("Grant an existing (main-authored) skill to one agent (--to) or every agent (--all)").option("--server <id>", "Target server (default: the org's server)").option("--to <agent>", "Grant to one specialist agent").option("--all", "Grant to every agent (shared managed root; includes future agents)").action(agentsGrantSkillCommand);
|
|
3766
3926
|
agents.command("create <slug>").description("Create a new specialist agent (RESTARTS the gateway \u2014 needs --yes)").option("--server <id>", "Target server (default: the org's server)").option("--name <name>", "Display name (default: the slug)").option("--description <role>", "The agent's role/specialization (seeded into its AGENTS.md)").option("--yes", "Confirm \u2014 proceed with the gateway restart").action(agentsCreateCommand);
|
|
3927
|
+
const flows = program.command("flows").description("Manage ClawFlows: create/edit drafts, publish versions");
|
|
3928
|
+
flows.command("list", { isDefault: true }).description("List flow drafts and their latest published version").option("--server <id>", "Target server (default: the org's server)").option("--json", "Print the raw JSON payload").action(flowsListCommand);
|
|
3929
|
+
flows.command("read <name>").description("Print a flow's current draft definition").option("--server <id>", "Target server (default: the org's server)").action(flowsReadCommand);
|
|
3930
|
+
flows.command("create <name>").description("Create a flow draft from a local JSON definition").option("--file <path>", "Flow definition JSON (required)").option("--server <id>", "Target server (default: the org's server)").action(flowsCreateCommand);
|
|
3931
|
+
flows.command("edit <name>").description("Replace a flow draft \u2014 from --file, or interactively via $EDITOR").option("--file <path>", "Flow definition JSON (default: open the current draft in $EDITOR)").option("--server <id>", "Target server (default: the org's server)").action(flowsEditCommand);
|
|
3932
|
+
flows.command("publish <name>").description("Validate the draft and publish it as the next numbered version").option("--server <id>", "Target server (default: the org's server)").action(flowsPublishCommand);
|
|
3767
3933
|
const env = program.command("env").description("Org custom environment variables (read via `connections list`)");
|
|
3768
3934
|
env.command("set <key> <value>").description("Set an org-wide custom env var (NON-SECRET config; restarts the gateway to apply)").action(envSetCommand);
|
|
3769
3935
|
env.command("unset <key>").description("Remove an org-wide custom env var (restarts the gateway to apply)").action(envUnsetCommand);
|
|
@@ -3797,4 +3963,4 @@ async function runCli() {
|
|
|
3797
3963
|
export {
|
|
3798
3964
|
runCli
|
|
3799
3965
|
};
|
|
3800
|
-
//# sourceMappingURL=cli-
|
|
3966
|
+
//# sourceMappingURL=cli-UFC2VLJT.js.map
|