@owlmeans/create-app 0.1.18-rc.6 → 0.1.18-rc.60

package/build/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAA;AAiB3D,eAAO,MAAM,GAAG,SAAgB,UAAU,KAAG,OAAO,CAAC,MAAM,CA4E1D,CAAA"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAA;AAQ5D,eAAO,MAAM,GAAG,SAAgB,UAAU,KAAG,OAAO,CAAC,MAAM,CAyF1D,CAAA"}

package/build/run.js

@@ -1,13 +1,8 @@
 import { spawnSync } from 'node:child_process';
-import { basename, resolve } from 'node:path';
+import { resolve } from 'node:path';
 import { run as installSkills } from '@owlmeans/agent-skills';
-import { copyTemplate, isEmptyDir, templateDir } from './template.js';
-const slugify = (input) => basename(input)
-    .toLowerCase()
-    .replace(/[^a-z0-9-]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    || 'owlmeans-app';
-const titleize = (slug) => slug.split('-').filter(Boolean).map(w => w[0].toUpperCase() + w.slice(1)).join(' ');
+import { namingHelper } from './naming.js';
+import { templateHelper } from './template.js';
 const installArgs = (pm) => pm === 'yarn' ? [] : ['install'];
 const log = (msg) => { process.stdout.write(msg + '\n'); };
 export const run = async (args) => {
@@ -16,15 +11,23 @@ export const run = async (args) => {
         return 2;
     }
     const dest = resolve(args.dir);
-    const slug = slugify(args.dir);
-    const name = args.name ?? titleize(slug);
-    if (!isEmptyDir(dest) && !args.yes) {
+    const slug = args.slug ?? namingHelper.slugify(args.dir);
+    if (!namingHelper.isValidSlug(slug)) {
+        process.stderr.write(`error: cannot derive a package slug from "${args.dir}" (got "${slug}")`
+            + ' — pass one with --slug\n');
+        return 2;
+    }
+    const name = args.name ?? namingHelper.titleize(slug);
+    const description = args.description ?? namingHelper.defaultDescription(name);
+    if (!templateHelper.isEmptyDir(dest) && !args.yes) {
         process.stderr.write(`error: ${dest} is not empty. Re-run with --yes to scaffold into it anyway.\n`);
         return 1;
     }
     log(`\nScaffolding OwlMeans app "${name}" into ${dest}\n`);
-    copyTemplate(templateDir(), dest, { slug, name });
-    log('  ✓ template copied (common + api + web)');
+    templateHelper.copyTemplate(templateHelper.templateDir(), dest, { slug, name, lang: args.lang, description }, { bare: args.bare });
+    log(args.bare
+        ? '  ✓ template copied (common + api + web, bare shell)'
+        : '  ✓ template copied (common + api + web)');
     if (args.git) {
         const git = spawnSync('git', ['init', '-q'], { cwd: dest, stdio: 'ignore' });
         if (git.status === 0)
@@ -47,7 +50,7 @@ export const run = async (args) => {
         log(args.install
             ? '\nDeploying agent skills via @owlmeans/agent-skills…'
             : '\nDeploying harness guidance via @owlmeans/agent-skills (general skills only — re-run'
-                + '\n`npx @owlmeans/agent-skills` after installing to add the package-specific ones)…');
+                + '\n`npx @owlmeans/agent-skills@^0.1.18-rc.51` after installing to add the package-specific ones)…');
         try {
             const result = await installSkills({
                 dir: dest,
@@ -59,7 +62,7 @@ export const run = async (args) => {
                 help: false,
             });
             if (result.code !== 0) {
-                process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills\` later.\n`);
+                process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills@^0.1.18-rc.51\` later.\n`);
             }
         }
         catch (err) {
@@ -74,8 +77,11 @@ export const run = async (args) => {
         log(`  ${installCmd}`);
     log(`  ${runCmd}\n`);
     log('The web app starts on http://localhost:3001 and the API on http://localhost:3000.');
-    log('Open the "Session" page to exercise the in-memory session resource.\n');
-    log('Agent guidance was scaffolded: AGENTS.md (with a CLAUDE.md bridge), the skills in');
+    log(args.bare
+        ? 'Add your entrypoints in sources/common/src/entrypoints.ts, handlers in sources/api\n'
+            + 'and screens in sources/web/src/screens — the Home screen shows where they go.\n'
+        : 'Open the "Session" page to exercise the in-memory session resource.\n');
+    log('Agent guidance was scaffolded: AGENTS.md, the skills in');
     log('.agents/skills/ and the shared memory store at .agents/memory/MEMORY.md.');
     log('Open the project in any coding agent — on the first session it will ask what the');
     log('project is for and fill in its purpose for you.\n');

package/build/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAErE,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE,CACxC,QAAQ,CAAC,KAAK,CAAC;KACZ,WAAW,EAAE;KACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;KAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;OACrB,cAAc,CAAA;AAErB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAErF,MAAM,WAAW,GAAG,CAAC,EAAkB,EAAY,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAEtF,MAAM,GAAG,GAAG,CAAC,GAAW,EAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA,CAAC,CAAC,CAAA;AAEvE,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,EAAE,IAAgB,EAAmB,EAAE;IAC7D,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACvF,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IAExC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,UAAU,IAAI,gEAAgE,CAC/E,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,GAAG,CAAC,+BAA+B,IAAI,UAAU,IAAI,IAAI,CAAC,CAAA;IAC1D,YAAY,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,GAAG,CAAC,0CAA0C,CAAC,CAAA;IAE/C,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC5E,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAC7D,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,GAAG,CAAC,kCAAkC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QACrF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE,yCAAyC,IAAI,KAAK,CAAC,CAAA;QAChG,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,4BAA4B,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,uFAAuF;QACvF,qFAAqF;QACrF,wFAAwF;QACxF,GAAG,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,sDAAsD;YACxD,CAAC,CAAC,uFAAuF;kBACrF,oFAAoF,CAAC,CAAA;QAC3F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;gBACjC,GAAG,EAAE,IAAI;gBACT,GAAG,EAAE,IAAI;gBACT,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,KAAK;aACZ,CAAC,CAAA;YACF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,MAAM,CAAC,IAAI,2DAA2D,CAAC,CAAA;YACjI,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACtG,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,UAAU,CAAA;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,UAAU,CAAA;IACrE,GAAG,CAAC,uBAAuB,CAAC,CAAA;IAC5B,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IACvB,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC,CAAA;IACzC,GAAG,CAAC,KAAK,MAAM,IAAI,CAAC,CAAA;IACpB,GAAG,CAAC,mFAAmF,CAAC,CAAA;IACxF,GAAG,CAAC,uEAAuE,CAAC,CAAA;IAC5E,GAAG,CAAC,mFAAmF,CAAC,CAAA;IACxF,GAAG,CAAC,0EAA0E,CAAC,CAAA;IAC/E,GAAG,CAAC,kFAAkF,CAAC,CAAA;IACvF,GAAG,CAAC,mDAAmD,CAAC,CAAA;IAExD,OAAO,CAAC,CAAA;AACV,CAAC,CAAA"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}

package/build/scaffold.d.ts

@@ -0,0 +1,8 @@
+import type { ScaffoldOptions } from './types.js';
+/**
+ * Filesystem-only scaffolding for tools that drive create-app themselves: no git, no
+ * dependency install, no agent-skills deploy, no output. Everything the CLI adds around
+ * the copy is the CLI's business — a caller that wants it calls `run` instead.
+ */
+export declare const scaffold: (opts: ScaffoldOptions) => void;
+//# sourceMappingURL=scaffold.d.ts.map

package/build/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,SAAU,eAAe,KAAG,IAShD,CAAA"}

package/build/scaffold.js

@@ -0,0 +1,19 @@
+import { resolve } from 'node:path';
+import { namingHelper } from './naming.js';
+import { DEFAULT_LANG } from './consts.js';
+import { templateHelper } from './template.js';
+/**
+ * Filesystem-only scaffolding for tools that drive create-app themselves: no git, no
+ * dependency install, no agent-skills deploy, no output. Everything the CLI adds around
+ * the copy is the CLI's business — a caller that wants it calls `run` instead.
+ */
+export const scaffold = (opts) => {
+    const name = opts.name ?? namingHelper.titleize(opts.slug);
+    templateHelper.copyTemplate(templateHelper.templateDir(), resolve(opts.dir), {
+        slug: opts.slug,
+        name,
+        lang: opts.lang ?? DEFAULT_LANG,
+        description: opts.description ?? namingHelper.defaultDescription(name),
+    }, { bare: opts.bare === true });
+};
+//# sourceMappingURL=scaffold.js.map

package/build/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAqB,EAAQ,EAAE;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE1D,cAAc,CAAC,YAAY,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC3E,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC;KACvE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAA;AAClC,CAAC,CAAA"}

package/build/template/types.d.ts

@@ -0,0 +1,16 @@
+import type { CopyTemplateOptions, TemplateReplacements } from '../types.js';
+/** The bundled `template/` tree and its copy into a new project. */
+export interface TemplateHelper {
+    /** Absolute path to the bundled `template/` directory (sibling of `build/`). */
+    templateDir: () => string;
+    /**
+     * Recursively copy `src` → `dest`, substituting the `__APP_*__` placeholders in text files
+     * and renaming shipped dotfiles (`_gitignore` → `.gitignore`). With `bare` the template's
+     * `_bare.json` decides what is dropped and which `.bare.` variant supplies the content, so
+     * the demo inventory lives in the template rather than in this code.
+     */
+    copyTemplate: (src: string, dest: string, r: TemplateReplacements, opts?: CopyTemplateOptions) => void;
+    /** Whether a directory is missing or has no entries. */
+    isEmptyDir: (dir: string) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/template/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/template/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE5E,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,WAAW,EAAE,MAAM,MAAM,CAAA;IACzB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACtG,wDAAwD;IACxD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACrC"}

package/build/template/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/template/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/template/types.ts"],"names":[],"mappings":""}

package/build/template.d.ts

@@ -1,17 +1,4 @@
-import { renameSync } from 'node:fs';
-export interface TemplateReplacements {
-    /** package/workspace slug, e.g. `my-app` */
-    slug: string;
-    /** human-readable name, e.g. `My App` */
-    name: string;
-}
-/** Absolute path to the bundled `template/` directory (sibling of `build/`). */
-export declare const templateDir: () => string;
-/**
- * Recursively copy `src` → `dest`, substituting `__APP_SLUG__` / `__APP_NAME__`
- * in text files and renaming shipped dotfiles (`_gitignore` → `.gitignore`).
- */
-export declare const copyTemplate: (src: string, dest: string, r: TemplateReplacements) => void;
-export declare const isEmptyDir: (dir: string) => boolean;
-export { renameSync };
+import type { TemplateHelper } from './template/types.js';
+export declare const createTemplateHelper: () => TemplateHelper;
+export declare const templateHelper: TemplateHelper;
 //# sourceMappingURL=template.d.ts.map

package/build/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,UAAU,EAA2B,MAAM,SAAS,CAAA;AAsBvH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAO,MACqC,CAAA;AAYpE;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,QAAQ,MAAM,KAAK,oBAAoB,KAAG,IAoBjF,CAAA;AAED,eAAO,MAAM,UAAU,QAAS,MAAM,KAAG,OAGxC,CAAA;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,eAAO,MAAM,oBAAoB,QAAO,cA4FvC,CAAA;AAED,eAAO,MAAM,cAAc,gBAAyB,CAAA"}

package/build/template.js

@@ -1,57 +1,74 @@
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { dirname, join, resolve } from 'node:path';
-/** Dotfiles/dirs are shipped with an underscore prefix so npm does not strip them from the tarball. */
-const DOTFILE_RENAMES = {
-    '_gitignore': '.gitignore',
-    '_npmrc': '.npmrc',
-    '_env': '.env',
-    '_github': '.github',
-    // `_agents` carries the canonical harness — AGENTS.md's skills, the shared memory
-    // store and the link-skills bridge; the template seed (sync-agent-meta) writes
-    // `_agents/skills/` into this tree. `_claude` carries only the Claude Code bridge
-    // (SessionStart hook + the gitkept symlink dir). Entries whose source dir is
-    // absent are inert.
-    '_agents': '.agents',
-    '_claude': '.claude',
-};
-/** Files whose contents are binary or must not be string-substituted. */
-const BINARY_EXT = new Set(['.ico', '.png', '.jpg', '.jpeg', '.gif', '.webp', '.woff', '.woff2']);
-/** Absolute path to the bundled `template/` directory (sibling of `build/`). */
-export const templateDir = () => resolve(dirname(fileURLToPath(import.meta.url)), '..', 'template');
-const applyReplacements = (content, r) => content
-    .replaceAll('__APP_SLUG__', r.slug)
-    .replaceAll('__APP_NAME__', r.name);
-const isBinary = (file) => {
-    const dot = file.lastIndexOf('.');
-    return dot >= 0 && BINARY_EXT.has(file.slice(dot).toLowerCase());
-};
-/**
- * Recursively copy `src` → `dest`, substituting `__APP_SLUG__` / `__APP_NAME__`
- * in text files and renaming shipped dotfiles (`_gitignore` → `.gitignore`).
- */
-export const copyTemplate = (src, dest, r) => {
-    mkdirSync(dest, { recursive: true });
-    for (const entry of readdirSync(src)) {
-        const from = join(src, entry);
-        const targetName = DOTFILE_RENAMES[entry] ?? entry;
-        const to = join(dest, targetName);
-        if (statSync(from).isDirectory()) {
-            copyTemplate(from, to, r);
-            continue;
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { BARE_MANIFEST, BINARY_EXT, DOTFILE_RENAMES, GLOBSTAR } from './consts.local.js';
+export const createTemplateHelper = () => {
+    const templateDir = () => resolve(dirname(fileURLToPath(import.meta.url)), '..', 'template');
+    const applyReplacements = (content, r) => content
+        .replaceAll('__APP_SLUG__', r.slug)
+        .replaceAll('__APP_NAME__', r.name)
+        .replaceAll('__APP_LANG__', r.lang)
+        .replaceAll('__APP_DESCRIPTION__', r.description);
+    const isBinary = (file) => {
+        const dot = file.lastIndexOf('.');
+        return dot >= 0 && BINARY_EXT.has(file.slice(dot).toLowerCase());
+    };
+    /**
+     * Bare variants sit beside the files they replace so the normal template still compiles as
+     * one project — which is also why they are filtered out of the copy in BOTH modes.
+     */
+    const isBareVariant = (entry) => entry.includes('.bare.');
+    const globToRegExp = (pattern) => new RegExp('^' + pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replaceAll('**/', GLOBSTAR)
+        .replace(/\*/g, '[^/]*')
+        .replaceAll(GLOBSTAR, '(?:.*/)?')
+        + '$');
+    const isRemoved = (rel, patterns) => patterns.some(pattern => rel === pattern
+        // A directory pattern takes its whole subtree — the walk simply never descends into it.
+        || rel.startsWith(pattern.endsWith('/') ? pattern : pattern + '/')
+        || (pattern.includes('*') && globToRegExp(pattern).test(rel)));
+    const readBareManifest = (root) => {
+        const file = join(root, BARE_MANIFEST);
+        if (!existsSync(file)) {
+            throw new Error(`bare scaffolding requires ${BARE_MANIFEST} in the template (${root})`);
         }
-        if (isBinary(from)) {
-            cpSync(from, to);
-            continue;
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return { remove: parsed.remove ?? [], overrides: parsed.overrides ?? {} };
+    };
+    const toPosix = (path) => path.split(sep).join('/');
+    const copyTree = (src, dest, r, root, bare) => {
+        mkdirSync(dest, { recursive: true });
+        for (const entry of readdirSync(src)) {
+            const from = join(src, entry);
+            const rel = toPosix(relative(root, from));
+            if (rel === BARE_MANIFEST || isBareVariant(entry))
+                continue;
+            if (bare != null && isRemoved(rel, bare.remove))
+                continue;
+            const to = join(dest, DOTFILE_RENAMES[entry] ?? entry);
+            if (statSync(from).isDirectory()) {
+                copyTree(from, to, r, root, bare);
+                continue;
+            }
+            const override = bare?.overrides[rel];
+            const source = override != null ? join(root, override) : from;
+            if (isBinary(source)) {
+                cpSync(source, to);
+                continue;
+            }
+            writeFileSync(to, applyReplacements(readFileSync(source, 'utf8'), r));
         }
-        const content = applyReplacements(readFileSync(from, 'utf8'), r);
-        writeFileSync(to, content);
-    }
-};
-export const isEmptyDir = (dir) => {
-    if (!existsSync(dir))
-        return true;
-    return readdirSync(dir).length === 0;
+    };
+    const copyTemplate = (src, dest, r, opts = {}) => {
+        copyTree(src, dest, r, src, opts.bare === true ? readBareManifest(src) : null);
+    };
+    const isEmptyDir = (dir) => {
+        if (!existsSync(dir))
+            return true;
+        return readdirSync(dir).length === 0;
+    };
+    return { templateDir, copyTemplate, isEmptyDir };
 };
-export { renameSync };
+export const templateHelper = createTemplateHelper();
 //# sourceMappingURL=template.js.map

package/build/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -0,0 +1,61 @@
+export type PackageManager = 'bun' | 'npm' | 'yarn';
+export interface CreateArgs {
+    /** Target directory (positional). `null` means it must be prompted/derived. */
+    dir: string | null;
+    /** Human-readable app name. Defaults to the directory slug. */
+    name: string | null;
+    /** Explicit package slug. `null` derives it from the target directory. */
+    slug: string | null;
+    /** BCP-47-ish language of the generated UI text and `<html lang>`. */
+    lang: string;
+    /** One-line project description for the README, AGENTS.md and the index.html meta tags. */
+    description: string | null;
+    /** Scaffold the shell without the example/demo code. */
+    bare: boolean;
+    /** Package manager used to install deps and (for `bun`) run the project. */
+    pm: PackageManager;
+    /** Install dependencies after copying the template. */
+    install: boolean;
+    /** Deploy agent skills via @owlmeans/agent-skills after install. */
+    skills: boolean;
+    /** Run `git init` in the new project. */
+    git: boolean;
+    /** Skip confirmations / proceed into a non-empty directory. */
+    yes: boolean;
+    help: boolean;
+}
+export interface ScaffoldOptions {
+    /** Destination directory. Created when missing; an existing one is written into as-is. */
+    dir: string;
+    /** package/workspace slug, e.g. `my-app`. */
+    slug: string;
+    /** Human-readable name. Defaults to the titleized slug. */
+    name?: string;
+    /** BCP-47-ish UI language and `<html lang>`. Defaults to `en`. */
+    lang?: string;
+    /** One-line description for the README, AGENTS.md and the index.html meta tags. */
+    description?: string;
+    /** Scaffold the shell without the example/demo code. */
+    bare?: boolean;
+}
+export interface BareManifest {
+    /** Template-relative paths — a file, a directory subtree, or a `*` / `**` glob — the bare shell omits. */
+    remove: string[];
+    /** Target template path → the `.bare.`-infixed source whose CONTENT is written there instead. */
+    overrides: Record<string, string>;
+}
+export interface TemplateReplacements {
+    /** package/workspace slug, e.g. `my-app` */
+    slug: string;
+    /** human-readable name, e.g. `My App` */
+    name: string;
+    /** BCP-47-ish UI language, e.g. `en` — also the generated `<html lang>` */
+    lang: string;
+    /** one-line project description for the README, AGENTS.md and the index.html meta tags */
+    description: string;
+}
+export interface CopyTemplateOptions {
+    /** Scaffold the demo-free shell: apply `_bare.json`'s removals and overrides. */
+    bare?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAEnD,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,2FAA2F;IAC3F,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,wDAAwD;IACxD,IAAI,EAAE,OAAO,CAAA;IACb,4EAA4E;IAC5E,EAAE,EAAE,cAAc,CAAA;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAA;IACf,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAA;IACZ,+DAA+D;IAC/D,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,GAAG,EAAE,MAAM,CAAA;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,0GAA0G;IAC1G,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,iGAAiG;IACjG,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,0FAA0F;IAC1F,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@owlmeans/create-app",
-  "version": "0.1.18-rc.6",
+  "version": "0.1.18-rc.60",
   "license": "MIT",
-  "description": "Scaffold a minimal fullstack OwlMeans Common app — common + api + web workspaces, shadcn UI navigation/layout, no auth, and a session-scoped in-memory resource. Deploys agent skills via @owlmeans/agent-skills by default.",
+  "description": "Scaffold a fullstack OwlMeans Common app — common + api + web workspaces, shadcn UI navigation/layout, no auth, and a session-scoped in-memory resource, or --bare for the demo-free shell. Also usable programmatically via scaffold(). Deploys agent skills via @owlmeans/agent-skills by default.",
   "type": "module",
   "scripts": {
     "build": "tsc -b",
+    "test": "bun test ./tests",
     "dev": "nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
     "watch": "tsc -b -w --preserveWatchOutput --pretty"
   },
@@ -29,11 +30,11 @@
     "template"
   ],
   "dependencies": {
-    "@owlmeans/agent-skills": "^0.1.18-rc.6"
+    "@owlmeans/agent-skills": "^0.1.18-rc.51"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.6.4",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/template/AGENTS.md

@@ -2,10 +2,13 @@
 
 ## Project purpose
 
+__APP_DESCRIPTION__
+
 <!-- OWLMEANS:PROJECT-PURPOSE -->
 > **Agents — this project has not been described yet.** Before doing anything else on the first
 > session, ask the user what this project is for: its purpose, domain, goals, and key constraints.
 > Then replace this whole block with a short description of the project, and remove this notice.
+<!-- /OWLMEANS:PROJECT-PURPOSE -->
 
 ## Git Workflow (mandatory)
 
@@ -27,6 +30,15 @@ skill.
 - Report finished git work as a Markdown table (**Action**, **Target**, **Result**), and never
   commit a conflicted working copy — stop, list the conflicted paths, hand control back.
 
+## Code structure (mandatory)
+
+The functions of one domain are ONE object built by a factory: its `interface` is declared first
+(never `ReturnType<typeof …>`; interfaces over types wherever possible), the implementation and its
+private parts live in the factory, and a shared context or collaborator is bound into the factory.
+Types, consts and code live in separate files; an object with parts gets a same-named folder
+(`x.ts` + `x/types.ts`). Load `/owlmeans-code-structure` before writing, moving or reviewing any
+`.ts`/`.tsx`, and hold every diff to it.
+
 ## Reporting (mandatory)
 
 Always report concisely and briefly, in table format, about WHAT was done rather than why —
@@ -76,20 +88,67 @@ package (in the installed packages and at https://github.com/owlmeans/common) or
 already solves the problem **before** proposing a third-party library or a custom solution, and
 simplify whatever you do write. This is required for every planning and development task.
 
+## Runtime config advertisement
+
+The config endpoint is default-deny. A backend config field reaches the browser only when the
+package that owns its browser consumer imports `apiConfigPlugin({ allow, deny? })` from
+`@owlmeans/api-config` at module scope. Name public nested fields precisely; use `every()` and a
+nested `deny` selector when a public collection carries a credential. Databases, queues, SMTP,
+tokens, secrets and internal addresses never belong in an `allow` selector.
+
+## Logging (mandatory)
+
+Before adding any log line, catch block or `console` call, follow the `logging` skill (mechanics: `log`).
+
+- No `console.*`: `const log = logger('<scope>')` from `@owlmeans/log`, a deliberate level, the
+  `Error` itself to `log.error`; never secrets, tokens or personal content.
+- The level is set per environment, never in code: the api reads `LOG_LEVEL` / `LOG_DEBUG`
+  (default `info`), the web build reads `VITE_LOG_LEVEL` / `VITE_LOG_DEBUG` (`debug` under `vite`,
+  `info` in a build). Local values go in the git-ignored `sources/api/.env` / `sources/web/.env`.
+- Never set `cfg.debug = { all: true }` — it does not control logging and must not reach production.
+
 ## Skills
 
 Reusable guidance lives in `.agents/skills/<name>/SKILL.md`, deployed by `@owlmeans/agent-skills`
 from the installed `@owlmeans/*` packages. Agents load a skill by topic, or you run `/<name>`
 explicitly. Copilot and Codex read `.agents/skills/` directly; Claude Code reads the generated
-symlinks in `.claude/skills/` (see `CLAUDE.md`).
+symlinks in `.claude/skills/` (see "Claude Code" below).
 
-- After adding or updating any `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills` to refresh
+- After adding or updating any `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills@^0.1.18-rc.51` to refresh
   the deployed skills.
+- `/logging` — before adding any log line, catch block or `console` call (mechanics: `/log`).
 - Deployed files carry an `AUTO-GENERATED` banner and are refreshed in place — never hand-edit them.
 - To capture your own guidance, see the `skill-authoring` skill; to turn repeatedly-used memory into
   a skill, `memory-promotion`. Keep it inside this repository, in `.agents/skills/` — never in a
   per-agent or home directory.
 
+<!-- OWLMEANS:LINKED-SKILLS -->
+### Skills linked from installed packages
+
+`sh .agents/scripts/link-skills.sh` also links in the skills that ship inside the installed
+`@owlmeans/*` packages (`node_modules/@owlmeans/<pkg>/agent-meta/skills/<name>`), so they load
+by name (`/<name>`) like a local skill. They land in `.agents/linked-skills/<name>` for Copilot
+and Codex and in `.claude/skills/<name>` for Claude Code, with a `skill / origin repo /
+description` table in `.agents/linked-skills/INDEX.md`. A local skill of the same name always
+wins. The directory is generated and git-ignored — never edit or commit it.
+
+The root `prepare` script runs it on every `bun install`, and a session-start hook runs it
+again, so a fresh checkout carries the links for every agent — Copilot and Codex included,
+not just Claude Code.
+
+<!-- /OWLMEANS:LINKED-SKILLS -->
+
+## Claude Code
+
+Claude Code reads this file directly — there is no `CLAUDE.md`. Skills live only in
+`.agents/skills/<name>/SKILL.md`, the single canonical location shared with Copilot and Codex.
+`.claude/skills/` holds only generated per-skill symlinks (gitignored except `.gitkeep`); the
+committed `SessionStart` hook runs `sh .agents/scripts/link-skills.sh` to (re)create them each session.
+
+- Never author files under `.claude/skills/` — write skills in `.agents/skills/`.
+- After creating, renaming, or deleting a skill, re-run
+  `sh .agents/scripts/link-skills.sh` so the session picks it up.
+
 ## Develop
 
 ```sh