@lumerahq/cli 0.19.22 → 0.19.24-dev.0

package/dist/{chunk-RH4FQF6O.js → chunk-3ESHIPZH.js}

@@ -4,7 +4,7 @@ import {
 import {
   createApiClient,
   isApiErrorStatus
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   findProjectRoot,
   getAppName

package/dist/{chunk-XT4EGGK7.js → chunk-HEUXW7SQ.js}

@@ -2,7 +2,7 @@ import {
   userContextHeaders,
   validateProjectExternalId,
   validateProjectNameLength
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   fetchWithRetry
 } from "./chunk-FJFIWC7G.js";
@@ -69,29 +69,12 @@ async function ensureAppRecord(apiBase, token, appName, appTitle) {
   if (appIdError) throw new Error(appIdError);
   const appNameError = validateProjectNameLength(appTitle, "App name");
   if (appNameError) throw new Error(appNameError);
-  const filterParam = encodeURIComponent(JSON.stringify({ external_id: appName }));
-  const searchRes = await fetchWithRetry(
-    `${apiBase}/pb/collections/lm_custom_apps/records?filter=${filterParam}`,
-    {
-      headers: {
-        Authorization: `Bearer ${token}`,
-        "X-Lumera-Client": "lumera-cli",
-        ...userContextHeaders()
-      }
-    }
-  );
-  if (!searchRes.ok) {
-    throw new Error(`Failed to check app record: ${await searchRes.text()}`);
-  }
-  const existing = (await searchRes.json()).items?.[0];
   const appData = {
-    external_id: appName,
     name: appTitle,
     hosting_type: "s3"
   };
-  const endpoint = existing ? `${apiBase}/pb/collections/lm_custom_apps/records/${existing.id}` : `${apiBase}/pb/collections/lm_custom_apps/records`;
-  const res = await fetchWithRetry(endpoint, {
-    method: existing ? "PATCH" : "POST",
+  const res = await fetchWithRetry(`${apiBase}/custom-apps/${encodeURIComponent(appName)}/registration`, {
+    method: "PUT",
     headers: {
       Authorization: `Bearer ${token}`,
       "Content-Type": "application/json",
@@ -145,6 +128,29 @@ async function deploy(options) {
 Deployed! ${launchUrl}`));
   return { launchUrl, version };
 }
+async function registerDevApp(apiBase, token, appName, appTitle, appUrl) {
+  const appIdError = validateProjectExternalId(appName);
+  if (appIdError) throw new Error(appIdError);
+  const appNameError = validateProjectNameLength(appTitle, "App name");
+  if (appNameError) throw new Error(appNameError);
+  const appData = {
+    name: appTitle,
+    dev_iframe_url: appUrl
+  };
+  const res = await fetchWithRetry(`${apiBase}/custom-apps/${encodeURIComponent(appName)}/registration`, {
+    method: "PUT",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+      "X-Lumera-Client": "lumera-cli",
+      ...userContextHeaders()
+    },
+    body: JSON.stringify(appData)
+  });
+  if (!res.ok) {
+    throw new Error(`Failed to register app: ${await res.text()}`);
+  }
+}
 function isPortInUse(port, host = "127.0.0.1") {
   return new Promise((resolve2) => {
     const socket = createConnection({ port, host });
@@ -236,6 +242,8 @@ async function dev(options) {
     console.log(pc.yellow(`  Dev server already running on port ${port}, skipping start.`));
     return;
   }
+  console.log(pc.dim("  Registering dev preview URL..."));
+  await registerDevApp(apiUrl, token, appName, appTitle, appUrl);
   console.log();
   console.log(pc.cyan(pc.bold(`  ${appTitle} - Dev Server`)));
   console.log();

package/dist/{chunk-JMRD5WIY.js → chunk-HTPNRY3F.js}

@@ -328,42 +328,30 @@ var ApiClient = class {
       body: JSON.stringify(body)
     });
   }
-  // Projects — register/lookup via PocketBase records API
+  // Projects — register through typed project API; lookup can still use PB reads.
   async registerProject(name, externalId) {
     const extId = externalId || name;
     const nameError = validateProjectNameLength(name, "App name");
     if (nameError) throw new Error(nameError);
     const externalIdError = validateProjectExternalId(extId);
     if (externalIdError) throw new Error(externalIdError);
-    const existing = await this.getProjectByExternalId(extId);
-    if (existing) {
-      return existing;
-    }
-    try {
-      const rec = await this.request(
-        "/api/pb/collections/lm_projects/records",
-        {
-          method: "POST",
-          body: JSON.stringify({ name, external_id: extId })
-        }
-      );
-      return {
-        id: rec.id,
-        name: rec.name,
-        external_id: rec.external_id,
-        template: rec.template,
-        status: rec.status,
-        owner_id: rec.owner_id,
-        created: rec.created,
-        updated: rec.updated
-      };
-    } catch (error) {
-      const created = await this.getProjectByExternalId(extId);
-      if (created) {
-        return created;
+    const res = await this.request(
+      "/api/projects/register",
+      {
+        method: "POST",
+        body: JSON.stringify({ name, external_id: extId })
       }
-      throw error;
-    }
+    );
+    return {
+      id: res.project.id,
+      name: res.project.name,
+      external_id: res.project.external_id,
+      template: res.project.template,
+      status: res.project.status,
+      owner_id: res.project.owner_id,
+      created: res.project.created,
+      updated: res.project.updated
+    };
   }
   async getProjectByExternalId(externalId) {
     const filterParam = encodeURIComponent(JSON.stringify({ external_id: externalId }));

package/dist/{deps-VTLXKCQ7.js → deps-HWO6X5WM.js}

@@ -1,9 +1,9 @@
 import {
   deps,
   syncDeps
-} from "./chunk-RH4FQF6O.js";
+} from "./chunk-3ESHIPZH.js";
 import "./chunk-2CR762KB.js";
-import "./chunk-JMRD5WIY.js";
+import "./chunk-HTPNRY3F.js";
 import "./chunk-ZH3NVYEQ.js";
 import "./chunk-FJFIWC7G.js";
 import "./chunk-PNKVD2UK.js";

package/dist/{dev-EQK27BUM.js → dev-AZ6APGU3.js}

@@ -1,15 +1,15 @@
 import {
   dev
-} from "./chunk-XT4EGGK7.js";
+} from "./chunk-HEUXW7SQ.js";
 import {
   syncDeps
-} from "./chunk-RH4FQF6O.js";
+} from "./chunk-3ESHIPZH.js";
 import {
   loadEnv
 } from "./chunk-2CR762KB.js";
 import {
   createApiClient
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   findProjectRoot,
   getApiUrl,

package/dist/index.js

@@ -219,39 +219,39 @@ async function main() {
     switch (command) {
       // Resource commands
       case "plan":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.plan(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.plan(args.slice(1)));
         break;
       case "apply":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.apply(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.apply(args.slice(1)));
         break;
       case "pull":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.pull(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.pull(args.slice(1)));
         break;
       case "destroy":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.destroy(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.destroy(args.slice(1)));
         break;
       case "list":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.list(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.list(args.slice(1)));
         break;
       case "show":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.show(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.show(args.slice(1)));
         break;
       case "diff":
-        await import("./resources-Z5ZMPWTK.js").then((m) => m.diff(args.slice(1)));
+        await import("./resources-33YKJE7P.js").then((m) => m.diff(args.slice(1)));
         break;
       // Development
       case "dev":
-        await import("./dev-EQK27BUM.js").then((m) => m.dev(args.slice(1)));
+        await import("./dev-AZ6APGU3.js").then((m) => m.dev(args.slice(1)));
         break;
       case "run":
-        await import("./run-LHHX7UBN.js").then((m) => m.run(args.slice(1)));
+        await import("./run-DJXAXDD2.js").then((m) => m.run(args.slice(1)));
         break;
       // Project
       case "init":
-        await import("./init-UF4JYQSQ.js").then((m) => m.init(args.slice(1)));
+        await import("./init-FXG2BFGT.js").then((m) => m.init(args.slice(1)));
         break;
       case "register":
-        await import("./register-BQCVUPWS.js").then((m) => m.register(args.slice(1)));
+        await import("./register-ZCNHHGZH.js").then((m) => m.register(args.slice(1)));
         break;
       case "templates":
         await import("./templates-LNUOTNLN.js").then((m) => m.templates(subcommand, args.slice(2)));
@@ -268,7 +268,7 @@ async function main() {
         break;
       // Dependencies
       case "deps":
-        await import("./deps-VTLXKCQ7.js").then((m) => m.deps(args.slice(1)));
+        await import("./deps-HWO6X5WM.js").then((m) => m.deps(args.slice(1)));
         break;
       // Auth
       case "login":

package/dist/{init-UF4JYQSQ.js → init-FXG2BFGT.js}

@@ -8,7 +8,7 @@ import {
 import {
   createApiClient,
   validateProjectNameLength
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   getToken,
   init_auth,
@@ -27,7 +27,7 @@ import pc from "picocolors";
 import prompts from "prompts";
 import { execSync } from "child_process";
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, readlinkSync, symlinkSync } from "fs";
-import { join, resolve } from "path";
+import { dirname, join, resolve } from "path";
 function toTitleCase(str) {
   return str.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
@@ -43,6 +43,84 @@ function processTemplate(content, replacements) {
 var TEMPLATE_EXCLUDE = /* @__PURE__ */ new Set(["template.json"]);
 var TEMPLATE_RENAMES = /* @__PURE__ */ new Map([["_gitignore", ".gitignore"]]);
 var TEMPLATE_RAW_COPY = /* @__PURE__ */ new Set(["pnpm-lock.yaml"]);
+var STUDIO_PROBLEM_FIRST_FLAG = "studio_problem_first";
+var MEMORY_AGENTS_SECTION = `## Project Memory
+
+This project may use repo-backed memory in \`memory/\`.
+
+Before substantial work, read \`memory/README.md\` if it exists, then any
+relevant memory files.
+
+Update memory when the user confirms a durable project decision, workflow
+rule, data contract, naming convention, recurring assumption, or correction
+that should survive future sessions.
+
+Do not store secrets, credentials, tokens, private keys, or raw sensitive
+source files in memory.
+
+If a memory item affects app behavior, do not rely only on repo memory.
+Persist it to the app's runtime source of truth, such as collections or config,
+and expose it in the app UI or a clear review/edit path.
+
+Summarize memory updates in your final response.
+`;
+var MEMORY_FILES = /* @__PURE__ */ new Map([
+  ["README.md", `# Project Memory
+
+Repo-backed memory keeps durable project context available across agent
+sessions. Keep it concise and reviewable.
+
+Use this folder for:
+- confirmed project decisions
+- durable workflow rules and mappings
+- data contracts and source-file assumptions
+- runbooks for recurring work
+- open questions that should carry forward
+
+Do not store secrets, credentials, tokens, private keys, or raw sensitive source
+files here.
+
+If a memory item affects app behavior, also persist it to the app's runtime
+source of truth, such as collections or config, and expose it in the app UI or a
+clear review/edit path.
+`],
+  ["project-context.md", `# Project Context
+
+Summarize what this app does, who uses it, and the recurring workflow it
+supports.
+`],
+  ["decisions.md", `# Decisions
+
+Record durable decisions that future sessions should preserve.
+
+| Date | Decision | Reason |
+| --- | --- | --- |
+`],
+  ["open-questions.md", `# Open Questions
+
+Track unresolved questions that should be answered before durable workflow
+behavior is finalized.
+`],
+  ["rules/README.md", `# Rules
+
+Document durable business rules, validation rules, thresholds, and exception
+handling expectations.
+`],
+  ["mappings/README.md", `# Mappings
+
+Document source-to-target mappings, normalization rules, and user-approved
+corrections.
+`],
+  ["data-contracts/README.md", `# Data Contracts
+
+Document expected source files, required columns, data types, and known source
+system assumptions.
+`],
+  ["runbooks/README.md", `# Runbooks
+
+Document repeatable operating steps for recurring workflows.
+`]
+]);
 function copyDir(src, dest, replacements, isRoot = true) {
   if (!existsSync(dest)) {
     mkdirSync(dest, { recursive: true });
@@ -82,6 +160,35 @@ function ensureClaudeInstructionsLink(projectRoot) {
     writeFileSync(claudeMdPath, readFileSync(agentsMdPath, "utf-8"));
   }
 }
+async function isStudioProblemFirstScaffoldEnabled(targetDir) {
+  try {
+    const token = getToken(targetDir);
+    const api = createApiClient(token);
+    const me = await api.getMe();
+    return me.user?.feature_flags?.[STUDIO_PROBLEM_FIRST_FLAG] === true;
+  } catch {
+    return false;
+  }
+}
+function writeFileIfMissing(path, content) {
+  if (existsSync(path)) return;
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, content);
+}
+function applyProblemFirstMemoryScaffold(projectRoot) {
+  const agentsMdPath = join(projectRoot, "AGENTS.md");
+  if (existsSync(agentsMdPath)) {
+    const agentsMd = readFileSync(agentsMdPath, "utf-8");
+    if (!agentsMd.includes("## Project Memory")) {
+      writeFileSync(agentsMdPath, `${agentsMd.trimEnd()}
+
+${MEMORY_AGENTS_SECTION}`);
+    }
+  }
+  for (const [relativePath, content] of MEMORY_FILES) {
+    writeFileIfMissing(join(projectRoot, "memory", relativePath), content);
+  }
+}
 function isGitInstalled() {
   try {
     execSync("git --version", { stdio: "ignore" });
@@ -374,7 +481,11 @@ async function init(args) {
     [sourceName, finalProjectName],
     [sourceTitle, projectTitle]
   ];
+  const problemFirstScaffold = await isStudioProblemFirstScaffoldEnabled(targetDir);
   copyDir(templateDir, targetDir, replacements);
+  if (problemFirstScaffold) {
+    applyProblemFirstMemoryScaffold(targetDir);
+  }
   ensureClaudeInstructionsLink(targetDir);
   const installCommand = existsSync(join(targetDir, "pnpm-lock.yaml")) ? "pnpm install --frozen-lockfile" : "pnpm install";
   function listFiles(dir, prefix = "") {

package/dist/{register-BQCVUPWS.js → register-ZCNHHGZH.js}

@@ -7,7 +7,7 @@ import {
 import {
   createApiClient,
   validateProjectExternalId
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   findProjectRoot,
   getAppName,

package/dist/{resources-Z5ZMPWTK.js → resources-33YKJE7P.js}

@@ -1,9 +1,9 @@
 import {
   deploy
-} from "./chunk-XT4EGGK7.js";
+} from "./chunk-HEUXW7SQ.js";
 import {
   syncDeps
-} from "./chunk-RH4FQF6O.js";
+} from "./chunk-3ESHIPZH.js";
 import {
   loadEnv
 } from "./chunk-2CR762KB.js";
@@ -11,7 +11,7 @@ import {
   ApiError,
   createApiClient,
   validateCollectionNameLength
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   findProjectRoot,
   getApiUrl,
@@ -2872,7 +2872,7 @@ async function destroyApp(skipConfirm) {
     }
   }
   const deleteRes = await fetchWithRetry(
-    `${apiUrl}/api/pb/collections/lm_custom_apps/records/${appRecord.id}`,
+    `${apiUrl}/api/custom-apps/${encodeURIComponent(appRecord.external_id)}`,
     {
       method: "DELETE",
       headers: {

package/dist/{run-LHHX7UBN.js → run-DJXAXDD2.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-2CR762KB.js";
 import {
   createApiClient
-} from "./chunk-JMRD5WIY.js";
+} from "./chunk-HTPNRY3F.js";
 import {
   findProjectRoot,
   getApiUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.19.22",
+  "version": "0.19.24-dev.0",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {