makersclaw 0.6.0 → 0.7.0

package/templates/next/files/next.config.mjs

@@ -1,3 +1,22 @@
+import { readFileSync } from "node:fs";
+
+// The app's mode, from its manifest (makersclaw.json, beside this file).
+// A browser app builds to files (output: "export"): the platform serves
+// them, and its data door answers their reads and writes. A server app
+// runs `next start`. Absent or unreadable is a server app, as every app
+// before 0.7.0 is (none has a `mode`); only the exact word "browser"
+// makes an export. `makersclaw mode` is what changes the key, never an
+// edit here.
+function mode() {
+  try {
+    const m = JSON.parse(readFileSync(new URL("./makersclaw.json", import.meta.url), "utf8"));
+    return m && m.mode === "browser" ? "browser" : "server";
+  } catch {
+    return "server";
+  }
+}
+const BROWSER = mode() === "browser";
+
 // The dashboard reaches this app at /p/<label>/ through the workspace proxy,
 // so every link and asset must carry that prefix. product_run sets
 // CLAW_BASE_PATH at build AND start time; leave it unset to run at /.
@@ -17,7 +36,8 @@
 // (src/lib/products.ts productAllowedOrigins): the product's own FQDN in
 // production, the dashboard's dev origin under a path prefix. Hardcoding a
 // localhost origin here ships an app that works in dev and refuses every
-// write in production.
+// write in production. A browser app has no Server Actions, so it takes
+// none: its writes go to the platform's data door (lib/door.js).
 const allowedOrigins = (process.env.CLAW_ALLOWED_ORIGINS || "")
   .split(",")
   .map((o) => o.trim())
@@ -28,6 +48,8 @@ const allowedOrigins = (process.env.CLAW_ALLOWED_ORIGINS || "")
 // lookups) whose Origin host is not localhost or listed here; Next 15 only
 // warned. The preview's browser is on the product host, so without this
 // every such request answers 403. Hostnames only: Next compares no port.
+// Both modes: a browser app still previews on `next dev` while it is
+// built, so CLAW_ALLOWED_ORIGINS stays its preview's rule.
 const allowedDevOrigins = [
   ...new Set(
     allowedOrigins
@@ -42,6 +64,12 @@ const allowedDevOrigins = [
 // the production build the platform made, serves and reads as its proof
 // (.next/BUILD_ID). check/run.mjs says more.
 //
+// Under output: "export" a custom distDir is where the export goes, and
+// the build then works in .next anyway (Next 16, build/index.js). So a
+// browser app is built with the default: the build in .next, the files
+// in out/, which is what the platform publishes. Its check builds in a
+// copy of the app, never in the tree.
+//
 // CLAW_TURBOPACK_ROOT is set by `npm run check` alone, when it builds a
 // copy of an app folder it cannot write (check/run.mjs buildSite). The
 // copy's node_modules is a symlink back to the app's, and Turbopack (Next
@@ -65,6 +93,11 @@ const turbopackRoot = process.env.CLAW_TURBOPACK_ROOT || "";
 // turns off, the dev overlay's /__nextjs_attach-nodejs-inspector (it
 // opens a Node debugger on loopback); only the platform can wall that
 // (CHANGELOG, 0.6.0).
+//
+// Browser mode adds three: output "export" (every page a file); images
+// unoptimized, a guard, since the export has no image server (nothing in
+// the template uses next/image); and trailingSlash false, so a page is
+// s/<key>.html, the file the platform's router looks for.
 const nextConfig = {
   basePath: process.env.CLAW_BASE_PATH || "",
   distDir: process.env.CLAW_DIST_DIR || ".next",
@@ -72,11 +105,12 @@ const nextConfig = {
     CLAW_BASE_PATH: process.env.CLAW_BASE_PATH || "",
   },
   agentRules: false,
+  ...(BROWSER ? { output: "export", images: { unoptimized: true }, trailingSlash: false } : {}),
   ...(allowedDevOrigins.length > 0 ? { allowedDevOrigins } : {}),
   ...(turbopackRoot ? { turbopack: { root: turbopackRoot }, outputFileTracingRoot: turbopackRoot } : {}),
   experimental: {
     mcpServer: false,
-    ...(allowedOrigins.length > 0 ? { serverActions: { allowedOrigins } } : {}),
+    ...(!BROWSER && allowedOrigins.length > 0 ? { serverActions: { allowedOrigins } } : {}),
   },
 };
 

package/templates/next/files/surfaces.js

@@ -7,7 +7,8 @@
  *   label      what the nav shows
  *   kind       optional, free text, one or two words for the checklist
  *              ("board", "inbox", "report") — not an enum, nothing keys on it
- *   source     the table the surface reads, when it reads one
+ *   source     the table the surface reads, when it reads one: its bare name
+ *              ("investors"), which the app's own schema answers
  *   home       true on the one surface / opens; otherwise the first entry
  *   component  the surface's component. LEAVE IT OUT while the surface is
  *              still planned: the nav shows it as planned and its page says
@@ -27,7 +28,7 @@
 // A domain surface, once built, looks like this:
 //
 //   import Investors from "./surfaces/investors";
-//   { key: "investors", label: "Investors", kind: "board", source: "public.investors", home: true, component: Investors },
+//   { key: "investors", label: "Investors", kind: "board", source: "investors", home: true, component: Investors },
 
 const surfaces = [];
 

package/templates/next/template.json

@@ -1,7 +1,7 @@
 {
   "name": "next",
   "title": "Makersclaw app (Next.js 16)",
-  "description": "The behaviour every app shares, the parts every app is assembled from, and none of the app's own look — the colours are the workspace's. It carries the data layer (lib/data.js, lib/db.js), the write actions that log activity (lib/actions.js), the _claw platform client with its identity wrapper, the ask bridge (a screen's ask becomes a request, answered in the desk's agent column) and the hooks that follow requests (lib/claw.js, lib/platform.js, lib/hooks.js), routing (/s/<key>), the request proxy (proxy.js), error boundaries, Tailwind v4 mapped to the workspace theme (app/globals.css + _claw/theme.css), the kit (components/ui), the parts bound to the data layer and to the live requests (components/parts) and `npm run check`. The app designs the inside of the App tab on top: app/shell.jsx and every domain surface, assembled from the kit and the blocks with tokens only.",
+  "description": "The behaviour every app shares, the parts every app is assembled from, and none of the app's own look — the colours are the workspace's. It carries the data layer (lib/data.js, lib/db.js), the write actions that log activity (lib/actions.js), the company brain through the platform's data door (lib/brain.js from the browser, lib/brain-server.js for server reads), the app's own tables through the same door from the browser (lib/door.js and its hooks; a browser app's lib/data.js and lib/actions.js re-export it), the _claw platform client with its identity wrapper, the ask bridge (a screen's ask becomes a request, answered in the desk's agent column) and the hooks that follow requests (lib/claw.js, lib/platform.js, lib/hooks.js), routing (/s/<key>), the request proxy (proxy.js), error boundaries, Tailwind v4 mapped to the workspace theme (app/globals.css + _claw/theme.css), the kit (components/ui), the parts bound to the data layer and to the live requests (components/parts) and `npm run check`. The app designs the inside of the App tab on top: app/shell.jsx and every domain surface, assembled from the kit and the blocks with tokens only.",
   "files": {
     "fixed": [
       "app/globals.css",
@@ -24,11 +24,17 @@
       "next.config.mjs",
       "postcss.config.mjs"
     ],
-    "docs": ["README.md", "surfaces/README.md", "schema.sql"],
+    "docs": ["README.md", "surfaces/README.md"],
     "starter": ["app/shell.jsx", "surfaces.js"],
     "merged": ["package.json"],
     "retired": ["middleware.js"]
   },
+  "modes": {
+    "browser": {
+      "overlay": "browser",
+      "drop": ["proxy.js", "app/claw-alive/route.js", "lib/db.js", "lib/brain-server.js"]
+    }
+  },
   "components": [
     {
       "name": "button",
@@ -194,7 +200,7 @@
       "name": "item",
       "type": "component",
       "title": "Item, ItemGroup",
-      "description": "The list row: media (an avatar, an image) or an icon, title, description, meta on the right, actions; href makes the whole row a link, onClick a button, neither static — actions still click on their own. aria-current, onClick, target and rel go on the row's link or button (aria-current fills the row); other props on the row. size default (56px) · sm (44px) · lg (64px); variant plain · outline · muted; layout row · stacked (a card for a grid: icon or media on top, title, description, meta at the foot, actions top-right, full cell height). ItemGroup stacks them with a rule between each (variant plain · outline).",
+      "description": "The list row: media (an avatar, an image) or an icon, title, description, meta on the right, actions; href makes the whole row a link, onClick a button, neither a plain row — actions still click on their own. aria-current, onClick, target and rel go on the row's link or button (aria-current fills the row); other props on the row. size default (56px) · sm (44px) · lg (64px); variant plain · outline · muted; layout row · stacked (a card for a grid: icon or media on top, title, description, meta at the foot, actions top-right, full cell height). ItemGroup stacks them with a rule between each (variant plain · outline).",
       "tags": ["item", "list", "row", "list item", "contact", "file", "settings row"],
       "files": ["components/ui/item.jsx"]
     },

package/templates/next/files/schema.sql

@@ -1,22 +0,0 @@
--- Reference only. artifact_scaffold creates this table in the workspace
--- database when it copies the template; nothing in the app runs this file.
--- (docs/ARTIFACT-CONTRACTS.md §4)
---
--- Every write the app makes (lib/actions.js → lib/db.js logActivity) and
--- every action the artifact's agent takes (its brief tells it to insert
--- here with the sql verb) lands in this table, keyed by the artifact id
--- product_run passes as CLAW_ARTIFACT_ID. The Activity tab the OS draws on
--- the app window reads it (§9b), and so can any surface via loadActivity.
-
-create table if not exists public.artifact_activity (
-  id bigserial primary key,
-  artifact_id uuid not null,
-  at timestamptz not null default now(),
-  action text not null,          -- found, drafted, sent, replied, skipped, edited…
-  surface text,                  -- surface key
-  row_ref text,                  -- id in the surface's source table
-  detail text,                   -- one sentence
-  data jsonb not null default '{}'::jsonb,
-  by text not null default 'agent'  -- 'agent' | 'user:<email>' | 'run:<id>'
-);
-create index if not exists artifact_activity_artifact_at on public.artifact_activity (artifact_id, at desc);