@lumerahq/cli 0.19.22 → 0.19.23

package/dist/index.js

@@ -248,7 +248,7 @@ async function main() {
         break;
       // Project
       case "init":
-        await import("./init-UF4JYQSQ.js").then((m) => m.init(args.slice(1)));
+        await import("./init-FTDMPFR3.js").then((m) => m.init(args.slice(1)));
         break;
       case "register":
         await import("./register-BQCVUPWS.js").then((m) => m.register(args.slice(1)));

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

@@ -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/package.json

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