@open-mercato/cli 0.10.1-develop.8033.1.a68811b809 → 0.10.1-develop.8034.1.400508da51

package/dist/agentic/guides/modules/staff/index.md

@@ -1,5 +1,5 @@
 # staff — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/staff
 
 ## Sections

package/dist/agentic/guides/modules/storage_s3/index.md

@@ -1,5 +1,5 @@
 # storage_s3 — module facts (generated, do not edit)
-<!-- generated from @open-mercato/storage-s3 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/storage-s3 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/storage-s3/src/modules/storage_s3
 
 ## Sections

package/dist/agentic/guides/modules/sync_akeneo/index.md

@@ -1,5 +1,5 @@
 # sync_akeneo — module facts (generated, do not edit)
-<!-- generated from @open-mercato/sync-akeneo 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/sync-akeneo 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/sync-akeneo/src/modules/sync_akeneo
 
 ## Sections

package/dist/agentic/guides/modules/sync_excel/index.md

@@ -1,5 +1,5 @@
 # sync_excel — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/sync_excel
 
 ## Sections

package/dist/agentic/guides/modules/system_status_overlays/index.md

@@ -1,5 +1,5 @@
 # system_status_overlays — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/system_status_overlays
 
 ## Sections

package/dist/agentic/guides/modules/telemetry/index.md

@@ -1,5 +1,5 @@
 # telemetry — module facts (generated, do not edit)
-<!-- generated from @open-mercato/telemetry 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/telemetry 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/telemetry/src/modules/telemetry
 
 ## Sections

package/dist/agentic/guides/modules/tillio/index.md

@@ -1,5 +1,5 @@
 # tillio — module facts (generated, do not edit)
-<!-- generated from @open-mercato/tillio 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/tillio 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/tillio/src/modules/tillio
 
 ## Sections

package/dist/agentic/guides/modules/translations/index.md

@@ -1,5 +1,5 @@
 # translations — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/translations
 
 ## Sections

package/dist/agentic/guides/modules/warranty_claims/index.md

@@ -1,5 +1,5 @@
 # warranty_claims — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/warranty_claims
 
 ## Sections

package/dist/agentic/guides/modules/webhooks/index.md

@@ -1,5 +1,5 @@
 # webhooks — module facts (generated, do not edit)
-<!-- generated from @open-mercato/webhooks 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/webhooks 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/webhooks/src/modules/webhooks
 
 ## Sections

package/dist/agentic/guides/modules/wms/index.md

@@ -1,5 +1,5 @@
 # wms — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/wms
 
 ## Sections

package/dist/agentic/guides/modules/workflows/index.md

@@ -1,5 +1,5 @@
 # workflows — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.10.1-develop.8033.1.a68811b809; core 0.10.1-develop.8033.1.a68811b809 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.10.1-develop.8034.1.400508da51; core 0.10.1-develop.8034.1.400508da51 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/workflows
 
 ## Sections

package/dist/agentic/guides/reference-module-facts.json

@@ -1185,7 +1185,7 @@
     "facts": {
       "title": "Example Module",
       "description": "Demonstrates pages, APIs, entities and DI.",
-      "coreVersion": "0.10.1-develop.8033.1.a68811b809",
+      "coreVersion": "0.10.1-develop.8034.1.400508da51",
       "sourcePackage": null,
       "sourceVersion": null,
       "sourceRoot": "src/modules/example",

package/dist/agentic/guides/template-tool.md

@@ -0,0 +1,38 @@
+# Save and Create App Templates
+
+An app template is a GitHub repository with a complete standalone app at its root. Use [create-mercato-template](https://github.com/open-mercato/create-mercato-template#readme) to save this app as one, and `create-mercato-app --template` to create a new app from one. A template is code only: the committed files of one commit. The database, configuration made in the UI, uploads, `.env` files, Git history and registry credentials are never saved. Move anything the next app needs into code (seeds, setup scripts) and commit it first.
+
+Save a reviewed snapshot from the app root:
+
+```bash
+npx create-mercato-template prepare --out ../my-template
+```
+
+It reads the committed `HEAD` offline, runs no app code and never changes the app. `--out` must be a new or empty directory outside the app. Uncommitted changes are listed but not exported unless `--include-uncommitted` is given. The result is `<out>/tree` and `<out>/report.json` with a `snapshotId`. An error finding (a secret, a symlink, a database dump, a missing `yarn.lock`) stops it: fix the source, commit, and run `prepare` again. Use `--allow-file <path>` or `--keep-env <KEY>` only when the user confirms that file or value may be shared. Show the user the report before publishing: errors, warnings, emptied env keys, the module list, uncommitted files and every image path, because images are not scanned and the user must inspect them.
+
+Publish only after the user approves the repository name, the visibility and the reviewed `snapshotId`:
+
+```bash
+npx create-mercato-template publish --from ../my-template --repo your-name/my-template --private --expect <snapshotId>
+```
+
+It needs `gh auth login` and never reads or prints a token. Visibility is always explicit (`--public` or `--private`); never choose it for the user. `--expect` is required with `--json` and without a terminal. It pushes exactly the snapshot as one commit, marks the repository as a template and adds its topics. It never force-pushes. After a failed GitHub step, rerun the printed command with `--resume`. With `--json`, read the exit code: 0 done, 1 a check failed or publication was refused, 2 usage, 3 GitHub auth missing, 4 a GitHub step failed.
+
+To list the template in the catalog:
+
+```bash
+npx create-mercato-template describe --from ../my-template
+```
+
+It prints the catalog YAML and the CONTRIBUTING link. Listing is a pull request the user opens in `open-mercato/modules`; neither tool opens it.
+
+Create a new app from a template outside this app's directory:
+
+```bash
+npx create-mercato-app my-app --template your-name/my-template
+npx create-mercato-app my-crm --template crm
+```
+
+`--template` takes a curator slug or `owner/repo`, optionally with `#ref`; a private repository needs `GITHUB_TOKEN`. Before the download it prints `owner/repo@<sha>` and whether that commit is verified, and it refuses a template on hold. The new app gets the app name in `package.json` (unless `--keep-name`), an `openMercatoTemplate` field with the repository, ref and commit, and no `mercato-template.json`. Then follow the printed next steps, which match the app's scripts: `yarn setup` when it has `setup` and `infra:up`; `docker compose up -d` then `yarn setup` when it has only `setup`; otherwise `yarn install`, `yarn initialize`, `yarn dev`. The declared env keys are listed before the start commands. Imports get no agentic setup; run `yarn mercato agentic:init` inside the new app when wanted.
+
+If `npx create-mercato-template` is not available from npm yet, run it from GitHub: `npx --package github:open-mercato/create-mercato-template create-mercato-template --help`. Without process execution, report that capability gap instead of claiming a snapshot or a publication.

package/dist/agentic/guides/upstream/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generator": "@open-mercato/cli@0.10.1-develop.8033.1.a68811b809",
+  "generator": "@open-mercato/cli@0.10.1-develop.8034.1.400508da51",
   "files": {
     "AGENTS.md": "35c948a32e06ca64b4706970c55ec60946412b410938b22478233a2c5c43df56",
     "BACKWARD_COMPATIBILITY.md": "4e85dfc08b0e9542c78415e25a020e06e4ec3c3bb664b278b5aa3faa3523d873"

package/dist/agentic/shared/AGENTS.md.template

@@ -73,6 +73,7 @@ Open every matched work-unit skill before selection.
 | Route | Work unit | Skill/context |
 |---|---|---|
 | `architecture` | Find, scaffold a module starter, publish, or link an app module | `.ai/guides/module-tool.md`; find: `om-find-module`; new code loads `om-module-scaffold` |
+| `architecture` | Save this app as an app template, or create an app from one | `.ai/guides/template-tool.md` |
 | `architecture` | Explain/choose module, UMES, package, eject | architecture; `om-help` for an unresolved or comparative choice across these mechanisms |
 | `module-data` | Business slice or multi-seam domain/API/command fix | MUST load `om-module-scaffold` + its exact `.ai/skills/om-module-scaffold/references/business-one-shot-blueprints.md` key, which resolves units inside the slice, not ownership — an ownership/capability outline adds `architecture` |
 | `spec-pr` | Spec/plan | Axis 3; phases+integration coverage (`integration-coverage`); no domain routes |

package/dist/agentic/shared/ai/harness/cases.json

@@ -4554,7 +4554,7 @@
     ],
     "maxContextFiles": 5,
     "maxInitialContextBytes": 40960,
-    "maxTotalContextBytes": 116736,
+    "maxTotalContextBytes": 118784,
     "relatedCases": [
       "OMH-058"
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/cli",
-  "version": "0.10.1-develop.8033.1.a68811b809",
+  "version": "0.10.1-develop.8034.1.400508da51",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,10 +60,10 @@
     "@mikro-orm/decorators": "^7.1.14",
     "@mikro-orm/migrations": "^7.1.14",
     "@mikro-orm/postgresql": "^7.1.14",
-    "@open-mercato/events": "0.10.1-develop.8033.1.a68811b809",
-    "@open-mercato/queue": "0.10.1-develop.8033.1.a68811b809",
-    "@open-mercato/shared": "0.10.1-develop.8033.1.a68811b809",
-    "@open-mercato/telemetry": "0.10.1-develop.8033.1.a68811b809",
+    "@open-mercato/events": "0.10.1-develop.8034.1.400508da51",
+    "@open-mercato/queue": "0.10.1-develop.8034.1.400508da51",
+    "@open-mercato/shared": "0.10.1-develop.8034.1.400508da51",
+    "@open-mercato/telemetry": "0.10.1-develop.8034.1.400508da51",
     "cross-spawn": "^7.0.6",
     "minisearch": "7.2.0",
     "pg": "8.23.0",
@@ -75,10 +75,10 @@
     "typescript-js": "npm:typescript@6.0.3"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.10.1-develop.8033.1.a68811b809"
+    "@open-mercato/shared": "0.10.1-develop.8034.1.400508da51"
   },
   "devDependencies": {
-    "@open-mercato/shared": "0.10.1-develop.8033.1.a68811b809",
+    "@open-mercato/shared": "0.10.1-develop.8034.1.400508da51",
     "@types/jest": "^30.0.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.12"