@mediamonks/canopy-cli 0.5.0 → 0.6.0

package/dist/migrations-B0kJarjr.mjs

@@ -0,0 +1,50 @@
+import { l as tryReadCanopyJson } from "./site-DQnysZ3W.mjs";
+import { o as apiDataRequest } from "./ui-BhzMeKQl.mjs";
+import { readFileSync, readdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+//#region src/migrations.ts
+/**
+* The CLI side of schema migrations (docs/13-migrations-and-drizzle.md):
+* reads the project's migration files (canopy.json "migrations" dir, e.g.
+* Drizzle's `drizzle-kit generate` output) and sends them to the platform's
+* migrate primitive. Shared by `canopy db migrate`, the deploy step, and the
+* `--local` sandbox boot.
+*/
+/**
+* The project's migration files in apply order, or undefined when canopy.json
+* configures no "migrations" dir. A configured-but-unreadable dir is an error;
+* a readable dir with no .sql files is an empty list.
+*/
+function readMigrationFiles(dir) {
+	const migrationsPath = tryReadCanopyJson(dir)?.migrations;
+	if (!migrationsPath) return void 0;
+	const migrationsDir = resolve(dir, migrationsPath);
+	let entries;
+	try {
+		entries = readdirSync(migrationsDir, { withFileTypes: true });
+	} catch {
+		throw new Error(`Migrations directory not found: ${migrationsDir} (canopy.json "migrations").`);
+	}
+	return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".sql")).map((entry) => ({
+		name: entry.name,
+		sql: readFileSync(join(migrationsDir, entry.name), "utf8")
+	})).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+}
+/** Run (or dry-run) the project's migrations against its live database. */
+function migrateProject(slug, migrations, plan = false) {
+	return apiDataRequest("POST", "/db/migrate", slug, {
+		migrations,
+		plan
+	});
+}
+/** One-line-per-fact summary shared by `db migrate` and the deploy step. */
+function describeMigrateResult(result) {
+	const lines = [];
+	for (const name of result.appliedNow) lines.push(`applied ${name}`);
+	if (result.appliedNow.length === 0 && result.pending.length === 0) lines.push(`nothing pending (${result.applied.length} applied previously)`);
+	if (result.snapshot !== void 0) lines.push(`pre-migrate snapshot: ${result.snapshot} (canopy db restore --snapshot …)`);
+	if (result.missing.length > 0) lines.push(`note: ${result.missing.length} journaled migration(s) have no local file`);
+	return lines;
+}
+//#endregion
+export { migrateProject as n, readMigrationFiles as r, describeMigrateResult as t };

package/dist/{open-DnlYDqrU.mjs → open-BmgYBSdR.mjs}

@@ -1,5 +1,5 @@
-import { i as projectDirArgs, o as projectUrl, s as resolveProject } from "./site-BJjoePQS.mjs";
-import { n as reportErrors, t as openBrowser } from "./ui-DThlyHgo.mjs";
+import { a as projectDirArgs, c as resolveProject, s as projectUrl } from "./site-DQnysZ3W.mjs";
+import { n as reportErrors, t as openBrowser } from "./ui-BhzMeKQl.mjs";
 import { defineCommand } from "citty";
 //#region src/open.ts
 /**

package/dist/{package-Bi5FfVSP.mjs → package-D1wDsLSU.mjs}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.5.0";
+var version = "0.6.0";
 //#endregion
 export { version as t };

package/dist/{projects-ijfe7Ffx.mjs → projects-CoGh8m9A.mjs}

@@ -1,5 +1,5 @@
-import { c as tryReadCanopyJson, n as siteConfig, o as projectUrl } from "./site-BJjoePQS.mjs";
-import { c as apiRequest, i as unwrap, n as reportErrors, r as requireTty } from "./ui-DThlyHgo.mjs";
+import { l as tryReadCanopyJson, n as siteConfig, s as projectUrl } from "./site-DQnysZ3W.mjs";
+import { c as apiRequest, i as unwrap, n as reportErrors, r as requireTty } from "./ui-BhzMeKQl.mjs";
 import { defineCommand } from "citty";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { join, relative, resolve, sep } from "node:path";
@@ -75,7 +75,12 @@ function writeCanopyJson(dir, fields) {
 	writeFileSync(join(dir, "canopy.json"), `${JSON.stringify(next, null, 2)}\n`);
 }
 function slugify(input) {
-	return input.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replaceAll(/(^-+|-+$)/g, "").slice(0, 40);
+	let slug = input.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replaceAll(/(^-+|-+$)/g, "").slice(0, 40);
+	while (slug.includes("-dot-")) slug = slug.replaceAll("-dot-", "-");
+	return slug;
+}
+function shouldScaffoldCreate(requested, cwd = process.cwd()) {
+	return requested ?? !existsSync(join(cwd, "canopy.json"));
 }
 const createCommand = defineCommand({
 	meta: {
@@ -98,7 +103,6 @@ const createCommand = defineCommand({
 		},
 		scaffold: {
 			type: "boolean",
-			default: true,
 			description: "Scaffold ./<slug>/ from the starter template",
 			negativeDescription: "Only register — no files written"
 		}
@@ -118,12 +122,16 @@ const createCommand = defineCommand({
 			message: "Slug",
 			defaultValue: slugify(name),
 			placeholder: slugify(name),
-			validate: (value) => !value || /^[a-z0-9][a-z0-9-]*$/.test(value) ? void 0 : "Lowercase letters, digits and dashes only."
+			validate: (value) => {
+				if (value && !/^[a-z0-9][a-z0-9-]*$/.test(value)) return "Lowercase letters, digits and dashes only.";
+				if (value?.includes("-dot-")) return `"-dot-" is reserved for preview hostnames.`;
+			}
 		})).trim();
 		slug ||= slugify(name);
+		const scaffold = shouldScaffoldCreate(args.scaffold);
 		let template = TEMPLATES.find((t) => t.id === (args.template ?? "static"));
 		if (!template) throw new Error(`Unknown template "${args.template}" — available: ${TEMPLATES.map((t) => t.id).join(", ")}.`);
-		if (args.scaffold && !args.template && process.stdin.isTTY) {
+		if (scaffold && !args.template && process.stdin.isTTY) {
 			const id = unwrap(await p.select({
 				message: "Template",
 				options: TEMPLATES.filter((t) => !t.hidden).map((t) => ({
@@ -136,7 +144,7 @@ const createCommand = defineCommand({
 		}
 		if (template.hidden) p.log.warn("Per-project Workers are not deployable yet (Phase 2) — `canopy deploy` publishes the frontend only for now.");
 		const targetDir = resolve(slug);
-		if (args.scaffold && existsSync(targetDir)) throw new Error(`Directory ./${slug} already exists — remove it, or use --no-scaffold to only register.`);
+		if (scaffold && existsSync(targetDir)) throw new Error(`Directory ./${slug} already exists — remove it, or use --no-scaffold to only register.`);
 		const spin = p.spinner();
 		spin.start(`Registering ${slug}…`);
 		let project;
@@ -150,7 +158,7 @@ const createCommand = defineCommand({
 			throw err;
 		}
 		spin.stop(`Created ${project.name} — ${projectUrl(project.slug)}`);
-		if (args.scaffold) {
+		if (scaffold) {
 			scaffoldTemplate(template.id, targetDir, {
 				name,
 				slug
@@ -166,7 +174,7 @@ const createCommand = defineCommand({
 			];
 			p.note(steps.join("\n"), `Scaffolded ./${slug}/ (${template.id}) — next`);
 			p.outro(`Live URL (after first deploy): ${projectUrl(project.slug)}`);
-		} else p.outro("Registered without scaffolding — add a canopy.json to deploy an existing app.");
+		} else p.outro(existsSync(join(process.cwd(), "canopy.json")) ? "Registered without scaffolding — the existing canopy.json was left unchanged." : "Registered without scaffolding — add a canopy.json to deploy an existing app.");
 	})
 });
 /** Empty enough to scaffold into: missing, or holding only dotfiles (.git, .agents…). */

package/dist/{site-BJjoePQS.mjs → site-DQnysZ3W.mjs}

@@ -185,6 +185,13 @@ function tryReadCanopyJson(dir) {
 	}
 	return JSON.parse(raw);
 }
+/** The validated dialect lock from canopy.json, if the project set one. */
+function projectDialect(dir) {
+	const dialect = tryReadCanopyJson(dir)?.dialect;
+	if (dialect === void 0) return void 0;
+	if (dialect !== "sqlite" && dialect !== "postgres") throw new Error(`canopy.json "dialect" must be "sqlite" or "postgres", not ${JSON.stringify(dialect)}.`);
+	return dialect;
+}
 function readCanopyJson(dir) {
 	const config = tryReadCanopyJson(dir);
 	if (config === void 0) throw new Error(`No canopy.json in ${dir} — run from a project created by \`canopy create\`, add one ({"slug": "<slug>", "dist": "dist"}), or pass --project <slug>.`);
@@ -251,4 +258,4 @@ function siteHeaderLine(cliVersion) {
 	return `canopy ${cliVersion} · ${c.envOverride || !c.profileId ? c.apiUrl : `${c.profileId} (${c.projectDomain ?? new URL(c.apiUrl).hostname})`}`;
 }
 //#endregion
-export { projectFlagArgs as a, tryReadCanopyJson as c, readConfigFile as d, setActiveProfile as f, isProfileId as g, getBakedProfile as h, projectDirArgs as i, clearAllProfileTokens as l, writeConfigFile as m, siteConfig as n, projectUrl as o, upsertProfileAuth as p, siteHeaderLine as r, resolveProject as s, setInvocationProfile as t, listBakedProfiles as u };
+export { isProfileId as _, projectDirArgs as a, resolveProject as c, listBakedProfiles as d, readConfigFile as f, getBakedProfile as g, writeConfigFile as h, projectDialect as i, tryReadCanopyJson as l, upsertProfileAuth as m, siteConfig as n, projectFlagArgs as o, setActiveProfile as p, siteHeaderLine as r, projectUrl as s, setInvocationProfile as t, clearAllProfileTokens as u };

package/dist/skill/canopy/SKILL.md

@@ -91,9 +91,26 @@ truth and never go stale.
 - Deploy: `canopy deploy` (add `--build` if the project has a build step)
 - Roll back: `canopy rollback`
 - Open the live site: `canopy open`
-- Manage data: `canopy db pull | snapshot | snapshots | restore`
+- Manage data: `canopy db pull | snapshot | snapshots | restore | migrate`
 - CI credentials: `canopy token create | list | revoke`
 
+## Custom tables & migrations (devs; Drizzle recommended)
+
+The document API (`canopy.db.collection(…)`) needs no schema — prefer it. When
+a project defines its **own tables** (raw `canopy.db.sql()` / Drizzle), use the
+migrations flow — read `canopy docs migrations` first. The rules that prevent
+confusing failures:
+
+- Pin `"dialect"` and `"migrations"` in `canopy.json`; put ordered `.sql`
+  files in that directory (Drizzle: `npx drizzle-kit generate` writes them).
+- **There is no `DATABASE_URL` and never will be.** Never run
+  `drizzle-kit push`/`migrate`/`studio` or Drizzle's runtime `migrate()` —
+  generating is local, applying is Canopy's job: `canopy deploy` applies
+  pending migrations automatically (`canopy db migrate` applies without a
+  deploy; `canopy dev --local` applies to the sandbox on boot).
+- Never edit an applied migration (the platform refuses edited history) and
+  never reference `_canopy_*` tables.
+
 ## Choosing a starter template (`canopy create` / `canopy init`)
 
 Both `canopy create` and `canopy init` scaffold from the same three templates.

package/dist/{skill-IAAa2EkK.mjs → skill-192EdixC.mjs}

@@ -1,5 +1,5 @@
-import { t as version } from "./package-Bi5FfVSP.mjs";
-import { n as reportErrors } from "./ui-DThlyHgo.mjs";
+import { t as version } from "./package-D1wDsLSU.mjs";
+import { n as reportErrors } from "./ui-BhzMeKQl.mjs";
 import { defineCommand } from "citty";
 import { cpSync, existsSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
 import { join, relative } from "node:path";

package/dist/templates/worker/AGENTS.md

@@ -39,6 +39,9 @@ the [Canopy dashboard](https://dashboard.thanarie.dev).
   writes never reach the platform. Prefer it for destructive experiments.
 - `canopy deploy` — builds (`npm run build`) and publishes; live (behind
   company login) at https://{{slug}}.thanarie.dev.
+- Defining your own tables (raw `sql()` / Drizzle)? Use the migrations flow —
+  `canopy docs migrations`. Never invent a `DATABASE_URL` (none exists):
+  generate migrations locally, and `canopy deploy` applies them.
 
 ## Boundaries
 

package/dist/{token-BeF9zczg.mjs → token-CWgp_Lqe.mjs}

@@ -1,5 +1,5 @@
-import { a as projectFlagArgs, i as projectDirArgs, s as resolveProject } from "./site-BJjoePQS.mjs";
-import { c as apiRequest, n as reportErrors } from "./ui-DThlyHgo.mjs";
+import { a as projectDirArgs, c as resolveProject, o as projectFlagArgs } from "./site-DQnysZ3W.mjs";
+import { c as apiRequest, n as reportErrors } from "./ui-BhzMeKQl.mjs";
 import { defineCommand } from "citty";
 const tokenCommand = defineCommand({
 	meta: {

package/dist/{ui-DThlyHgo.mjs → ui-BhzMeKQl.mjs}

@@ -1,4 +1,4 @@
-import { n as siteConfig } from "./site-BJjoePQS.mjs";
+import { n as siteConfig } from "./site-DQnysZ3W.mjs";
 import { spawn } from "node:child_process";
 import { cancel, isCancel } from "@clack/prompts";
 //#region src/api.ts

package/dist/{upgrade-DNxR-zh7.mjs → upgrade-BrHSSg2e.mjs}

@@ -1,5 +1,5 @@
 import { t as PACKAGE_NAME } from "./version-check-Cuh6HaLX.mjs";
-import { n as reportErrors } from "./ui-DThlyHgo.mjs";
+import { n as reportErrors } from "./ui-BhzMeKQl.mjs";
 import { defineCommand } from "citty";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
@@ -112,7 +112,7 @@ const upgradeCommand = defineCommand({
 		const spec = `${PACKAGE_NAME}@${args.version ?? "latest"}`;
 		const command = pmCommand(pm);
 		const cmd = installArgs(pm, spec);
-		const { skillInstalled } = await import("./skill-IAAa2EkK.mjs");
+		const { skillInstalled } = await import("./skill-192EdixC.mjs");
 		const refreshSkill = skillInstalled(process.cwd());
 		console.log(`Upgrading via ${command}: ${command} ${cmd.join(" ")}`);
 		await run(command, cmd);

package/dist/{usage-DQpH7A3X.mjs → usage-CYQRLXwf.mjs}

@@ -1,5 +1,5 @@
-import { a as projectFlagArgs, s as resolveProject } from "./site-BJjoePQS.mjs";
-import { c as apiRequest, l as withContext, n as reportErrors } from "./ui-DThlyHgo.mjs";
+import { c as resolveProject, o as projectFlagArgs } from "./site-DQnysZ3W.mjs";
+import { c as apiRequest, l as withContext, n as reportErrors } from "./ui-BhzMeKQl.mjs";
 import { defineCommand } from "citty";
 //#region src/usage.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediamonks/canopy-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Canopy CLI — create, develop and deploy Canopy projects.",
   "bin": {
     "canopy": "./dist/index.mjs"
@@ -20,8 +20,8 @@
     "esbuild": "^0.28.1",
     "hono": "^4.8.0",
     "vite-server": "npm:vite@^7",
-    "@mediamonks/canopy": "0.0.3",
-    "@mediamonks/canopy-data-plane": "0.0.1"
+    "@mediamonks/canopy-data-plane": "0.0.2",
+    "@mediamonks/canopy": "0.0.3"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",

package/dist/dev-BJ5xEwqW.mjs

@@ -1,2 +0,0 @@
-import { t as devCommand } from "./dev-CQQhMOoD.mjs";
-export { devCommand };