From ccd0920e6eab380b87a1875b5a4b56b695501e90 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Tue, 18 Aug 2026 22:27:16 +0000
Subject: [PATCH] fix(cli): reword os init template descriptions to match what
 srcFiles emits (#9737)

`app` and `plugin` claimed views/actions/extensions their srcFiles maps never
write (both emit objects only). Reword to match actual emission, per triage's
auto-adjudication (option 1); pin the invariant so future templates can't
drift the same way undetected.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 ...it-template-descriptions-match-emission.md | 19 +++++++++++
 content/docs/deployment/cli.mdx               |  2 +-
 packages/cli/src/commands/init.ts             |  4 +--
 packages/cli/test/init.test.ts                | 32 +++++++++++++++++++
 4 files changed, 54 insertions(+), 3 deletions(-)
 create mode 100644 .changeset/init-template-descriptions-match-emission.md

diff --git a/.changeset/init-template-descriptions-match-emission.md b/.changeset/init-template-descriptions-match-emission.md
new file mode 100644
index 0000000000..737b1811d7
--- /dev/null
+++ b/.changeset/init-template-descriptions-match-emission.md
@@ -0,0 +1,19 @@
+---
+"@objectstack/cli": patch
+---
+
+fix(cli): `os init` template descriptions no longer advertise metadata kinds they never emit (#9737)
+
+The `app` and `plugin` templates' `description` strings — shown by `printKV('Template', …)`
+right after `os init -t <template>` runs, and mirrored in `content/docs/deployment/cli.mdx` —
+claimed views, actions, and extensions that neither template's `srcFiles` map ever writes.
+Both templates emit objects only (`src/objects/index.ts` + `src/objects/{namespace}_item.ts`).
+
+- `app`: `'Full application with objects, views, and actions'` → `'Full application with objects'`
+- `plugin`: `'Reusable plugin with objects and extensions'` → `'Reusable plugin with objects'`
+- `content/docs/deployment/cli.mdx`'s template table drops the same false `views` claim from the
+  `app` row.
+
+A new pin (`packages/cli/test/init.test.ts`) asserts every template's description only claims a
+metadata kind (`objects`/`views`/`actions`/`extensions`) its `srcFiles` map actually has an entry
+under, so a future template can't drift the same way.
diff --git a/content/docs/deployment/cli.mdx b/content/docs/deployment/cli.mdx
index 43517f52df..4211f924ad 100644
--- a/content/docs/deployment/cli.mdx
+++ b/content/docs/deployment/cli.mdx
@@ -101,7 +101,7 @@ os init my-app --no-install       # Skip dependency installation
 
 | Template | What it creates |
 |----------|-----------------|
-| `app` | Full application with objects, views, barrel imports |
+| `app` | Full application with objects, barrel imports |
 | `plugin` | Reusable plugin package with objects |
 | `empty` | Minimal project with just `objectstack.config.ts` |
 
diff --git a/packages/cli/src/commands/init.ts b/packages/cli/src/commands/init.ts
index 953b6c6c62..61d738a93a 100644
--- a/packages/cli/src/commands/init.ts
+++ b/packages/cli/src/commands/init.ts
@@ -102,7 +102,7 @@ export const TEMPLATES: Record<string, {
   srcFiles: Record<string, (name: string, namespace: string) => string>;
 }> = {
   app: {
-    description: 'Full application with objects, views, and actions',
+    description: 'Full application with objects',
     get dependencies() {
       const v = pkgVersion();
       // No driver is listed on purpose. `@objectstack/runtime` already depends
@@ -195,7 +195,7 @@ export default ${toCamelCase(namespace)}Item;
   },
 
   plugin: {
-    description: 'Reusable plugin with objects and extensions',
+    description: 'Reusable plugin with objects',
     get dependencies() {
       return {
         '@objectstack/spec': pkgVersion(),
diff --git a/packages/cli/test/init.test.ts b/packages/cli/test/init.test.ts
index 52fd517656..db94bd22e1 100644
--- a/packages/cli/test/init.test.ts
+++ b/packages/cli/test/init.test.ts
@@ -52,6 +52,38 @@ describe('init command — published scaffold', () => {
   });
 });
 
+describe('template description accuracy — matches what srcFiles emits (#9737)', () => {
+  // A template's `description` is what `printKV('Template', …)` and
+  // `content/docs/deployment/cli.mdx` show a user at the moment they pick
+  // `-t <template>` — so a description claiming a metadata kind the template
+  // never writes (the `app`/`plugin` "views"/"actions"/"extensions" claims
+  // this pin exists for) is a load-bearing lie, not cosmetic copy. Each kind
+  // maps to the `src/` subdirectory its files would live under; a claim with
+  // no matching `srcFiles` entry, in either direction, is the drift #9737
+  // found.
+  const KIND_CLAIMS: Array<{ kind: string; claimPattern: RegExp; dirPrefix: string }> = [
+    { kind: 'objects', claimPattern: /\bobjects?\b/i, dirPrefix: 'src/objects/' },
+    { kind: 'views', claimPattern: /\bviews?\b/i, dirPrefix: 'src/views/' },
+    { kind: 'actions', claimPattern: /\bactions?\b/i, dirPrefix: 'src/actions/' },
+    { kind: 'extensions', claimPattern: /\bextensions?\b/i, dirPrefix: 'src/extensions/' },
+  ];
+
+  it.each(Object.keys(TEMPLATES))('template "%s" only claims metadata kinds it actually writes', (key) => {
+    const t = TEMPLATES[key];
+    const emittedPaths = Object.keys(t.srcFiles);
+    for (const { kind, claimPattern, dirPrefix } of KIND_CLAIMS) {
+      const claims = claimPattern.test(t.description);
+      const emits = emittedPaths.some((p) => p.startsWith(dirPrefix));
+      if (claims) {
+        expect(
+          emits,
+          `template "${key}" description claims "${kind}" but srcFiles has no ${dirPrefix}* entry (description: "${t.description}")`,
+        ).toBe(true);
+      }
+    }
+  });
+});
+
 describe('native build allowlist (pnpm-workspace.yaml)', () => {
   // pnpm 10+ blocks dependency build scripts by default. Without an allowlist,
   // the scaffold installs but `serve` crashes with "Could not locate the