@open-mercato/cli 0.6.8-develop.7015.1.af90a2ddc7 → 0.6.8-develop.7019.1.f4c01c4b5c

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

@@ -1,5 +1,5 @@
 # security — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/security
 
 ## Sections

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

@@ -1,5 +1,5 @@
 # shipping_carriers — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/shipping_carriers
 
 ## Sections

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

@@ -1,5 +1,5 @@
 # sso — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/sso
 
 ## Sections

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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/storage-s3 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/sync-akeneo 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/system_status_overlays
 
 ## 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/webhooks 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7; core 0.6.8-develop.7015.1.af90a2ddc7 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.8-develop.7019.1.f4c01c4b5c; core 0.6.8-develop.7019.1.f4c01c4b5c — 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.6.8-develop.7015.1.af90a2ddc7",
+      "coreVersion": "0.6.8-develop.7019.1.f4c01c4b5c",
       "sourcePackage": null,
       "sourceVersion": null,
       "sourceRoot": "src/modules/example",

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

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generator": "@open-mercato/cli@0.6.8-develop.7015.1.af90a2ddc7",
+  "generator": "@open-mercato/cli@0.6.8-develop.7019.1.f4c01c4b5c",
   "files": {
     "AGENTS.md": "1f54610cebc4fd7e42b56d1c18859edc7ed7d3165c9af72c4530b6feaf76e457",
     "BACKWARD_COMPATIBILITY.md": "d2fdc675a9c86cab32ab024dae29f45717f441ddc305329c056fb66c5b498c27"

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

@@ -12,7 +12,7 @@ Route first; never probe unmatched context.
 - Put entities in `src/modules/<id>/data/entities.ts`; API routes need per-method `metadata` + `openApi`.
 - Editable records expose `updated_at`/`updatedAt`; custom update/delete clients send the version and surface 409s.
 - Run `yarn db:generate`, review scoped SQL/snapshot, and ask before applying it.
-- Run `yarn generate` after discovery files, `src/modules.ts`, routes, pages, events, widgets, agents, tools, or workflows change.
+- Run `yarn generate` after discovery files/`src/modules.ts`/routes/pages/events/widgets/agents/tools/workflows change.
 - Contract-surface changes (route/schema/ID/export/seam/signature/event payload/CLI) MUST read `.ai/guides/upstream/BACKWARD_COMPATIBILITY.md`; tenant/org scope alone is not a contract.
 - Localize strings; use shared UI/tokens and cover loading/empty/error/conflict/keyboard/a11y.
 
@@ -23,8 +23,8 @@ Route first; never probe unmatched context.
 ## Never
 
 - Never leak tenants, trust payload scope, or treat missing scope as unrestricted.
-- Never edit `node_modules`, `.mercato/generated/**`, generated facts, or shipped migrations.
-- Never use cross-module ORM relations; use IDs/snapshots, events, enrichers, extensions, or optional DI.
+- Never edit `node_modules`/`.mercato/generated/**`/generated facts/shipped migrations.
+- Never use cross-module ORM relations; use IDs/snapshots/events/enrichers/extensions/optional DI.
 - Never use raw admin `fetch`/`<form>`, ad hoc crypto/cache/queues, role-name guards, or direct mutations when helpers exist.
 - Never hard-code user strings/status colors; expose secrets/transcripts; or guess answerable contracts.
 

package/dist/agentic/shared/ai/harness/README.md

@@ -1,6 +1,6 @@
 # Agent harness evaluations
 
-`cases.json` is the 233-case standalone-app contract. Run `yarn harness:validate --all` for the deterministic gate. Live routing uses a fresh read-only process per case:
+`cases.json` is the 234-case standalone-app contract. Run `yarn harness:validate --all` for the deterministic gate. Live routing uses a fresh read-only process per case:
 
 UMES routing is fact-first. The additive and unified-override audit evaluations, plus their targeted cases, resolve exact/pattern hosts, outgoing contributions, correlation provenance, round-trip groups, framework-owned targets, and override domain/key/mode from the generated module sheets and `.ai/guides/framework-extension-points.md` before bounded installed source. The repository UMES umbrella spec may appear as optional source-checkout provenance; it is never required in a standalone scaffold.
 
@@ -18,7 +18,7 @@ yarn harness:release --runner codex --prepare-targets /absolute/empty-release-ta
 yarn harness:release --runner codex --portability-runner claude --prepare-targets /absolute/empty-release-targets --acknowledge-writes
 ```
 
-The primary runner owns all 233 routing cases, all 49 writable cases, and all generative-judge runs. No per-case fallback or mixed primary ownership is allowed. Omitting `--portability-runner` is valid and the sanitized report records `portabilityRunner: null`; explicitly requesting an unavailable or failing secondary runner fails that extended run.
+The primary runner owns all 234 routing cases, all 49 writable cases, and all generative-judge runs. No per-case fallback or mixed primary ownership is allowed. Omitting `--portability-runner` is valid and the sanitized report records `portabilityRunner: null`; explicitly requesting an unavailable or failing secondary runner fails that extended run.
 
 Writable evaluation is intentionally opt-in. The expanded catalog has a 49-case writable release target, but only cases registered in `release-matrix.json` and backed by controller-owned fixtures and oracles are executable. Copy or create a fresh standalone app for one registered case, then seed only that case and mark the target disposable:
 

package/dist/agentic/shared/ai/harness/RELEASE.md

@@ -6,7 +6,7 @@ Run the complete per-release gate from a generated standalone app with one comma
 yarn harness:release --runner codex --prepare-targets /absolute/empty-release-targets --acknowledge-writes
 ```
 
-Choose exactly one blocking primary runner with `--runner codex` or `--runner claude`. That runner owns the complete 233-case routing gate and every writable/review lane. To add cross-model portability evidence, explicitly pass the other runner as `--portability-runner claude` or `--portability-runner codex`; it runs only the exact 49-case representative read-only set. The two runners must differ. Omitting the portability option is valid and is recorded as `portabilityRunner: null`; no secondary result is claimed. There is no per-case fallback or mixed primary ownership. Once requested, a portability failure or unavailable runner fails that extended release run.
+Choose exactly one blocking primary runner with `--runner codex` or `--runner claude`. That runner owns the complete 234-case routing gate and every writable/review lane. To add cross-model portability evidence, explicitly pass the other runner as `--portability-runner claude` or `--portability-runner codex`; it runs only the exact 49-case representative read-only set. The two runners must differ. Omitting the portability option is valid and is recorded as `portabilityRunner: null`; no secondary result is claimed. There is no per-case fallback or mixed primary ownership. Once requested, a portability failure or unavailable runner fails that extended release run.
 
 `--prepare-targets` accepts only an absolute, new or empty regular directory outside the controller app. The controller must be a sanitized fresh scaffold: automatic preparation fails before copying when it finds `.env`, `.env.*` (except `.env.example`, `.env.sample`, and `.env.template`), credential files, or private-key files. Never use a configured development or production app as the controller. It copies the fresh scaffold once per catalog case whose `evaluationKind` is `implementation` or `regression`, while excluding `.git`, `node_modules`, build/cache/coverage output, `.ai/harness/results`, `.ai/reports`, and `.ai/framework-context`. Each target receives a guarded link to the controller's installed dependency tree. The OS sandbox resolves that link as read-only during both the writable model run and the target command gate. The release gate also hashes every dependency entry and regular-file body once before execution and once after the complete suite, and fails if any nested content or metadata changed. A generated `release-targets.json` records the local mapping.
 
@@ -34,17 +34,17 @@ For externally prepared apps, `--writable-targets /absolute/release-targets.json
 }
 ```
 
-The current catalog contains 233 cases, including 49 writable implementation/regression cases (21.0%). The command still derives all counts and case IDs from `cases.json`, `validators.json`, and `release-matrix.json`; those figures are documented release facts, not runner constants. The matrix keeps both supported runner model selectors, an exact all-case primary profile, an exact 49-case portability profile, and runner-neutral writable assignments. Run `yarn install-skills` first so the pinned external `om-code-review` skill and ownership evidence are present; the reusable local `om-judge-agent-session` skill ships with the scaffold. Before running a model or writing a fixture, the release command requires complete deterministic, primary live-routing, writable, trusted-oracle, target, generated-test, and generative-judge coverage. Every one of the 49 writable cases must have a judge assignment composing both skills. Missing business fixtures or release-matrix entries fail preflight and are listed by exact case ID in the report.
+The current catalog contains 234 cases, including 49 writable implementation/regression cases (20.9%). The command still derives all counts and case IDs from `cases.json`, `validators.json`, and `release-matrix.json`; those figures are documented release facts, not runner constants. The matrix keeps both supported runner model selectors, an exact all-case primary profile, an exact 49-case portability profile, and runner-neutral writable assignments. Run `yarn install-skills` first so the pinned external `om-code-review` skill and ownership evidence are present; the reusable local `om-judge-agent-session` skill ships with the scaffold. Before running a model or writing a fixture, the release command requires complete deterministic, primary live-routing, writable, trusted-oracle, target, generated-test, and generative-judge coverage. Every one of the 49 writable cases must have a judge assignment composing both skills. Missing business fixtures or release-matrix entries fail preflight and are listed by exact case ID in the report.
 
 ## PR #4529 remediation evidence
 
-The PR's focused remediation evidence is not a release-certification substitute. Fresh emitted controllers pass deterministic 192/192, and the field-tested OMH-188–192 generative cohort passes on default Codex, Claude Sonnet, and high-effort gpt-5.4-mini. Fresh OMH-185 writable attempts fixed concrete organization-scope, command-object, module-activation, command-snapshot, schema, custom-field, UI, and Jest guidance defects at their routed owners without relaxing trusted oracles. The final attempt reached the case's fixed 600-second ceiling and is excluded from pass evidence. Issue #4670 now owns the complete selected-primary 233-case routing and 49-case writable/generated-test/review certification, prioritizing the generative cohort and recording unavailable Claude lanes without fallback or mixed-runner ownership.
+The PR's focused remediation evidence is not a release-certification substitute. Fresh emitted controllers pass deterministic 192/192, and the field-tested OMH-188–192 generative cohort passes on default Codex, Claude Sonnet, and high-effort gpt-5.4-mini. Fresh OMH-185 writable attempts fixed concrete organization-scope, command-object, module-activation, command-snapshot, schema, custom-field, UI, and Jest guidance defects at their routed owners without relaxing trusted oracles. The final attempt reached the case's fixed 600-second ceiling and is excluded from pass evidence. Issue #4670 now owns the complete selected-primary 234-case routing and 49-case writable/generated-test/review certification, prioritizing the generative cohort and recording unavailable Claude lanes without fallback or mixed-runner ownership.
 
 After preflight it runs, in order:
 
 1. deterministic validation for the complete catalog;
 2. the release matrix's fixed `yarn generate`, `yarn typecheck`, `yarn lint`, and `yarn build` foundation;
-3. the selected primary runner across all 233 live-routing cases, followed by the optional distinct portability runner across the exact 49-case read-only sample when requested;
+3. the selected primary runner across all 234 live-routing cases, followed by the optional distinct portability runner across the exact 49-case read-only sample when requested;
 4. fixture preparation and the selected primary runner for every writable case, including the controller-owned AST/behavior oracles and target typecheck;
 5. `yarn generate`, `yarn typecheck`, `yarn lint`, and `yarn build` in every writable target, after its trusted oracles;
 6. real generated-code execution for OMH-163 and OMH-192 through fixed Jest, OMH-164 through API-only Playwright, and OMH-165 through real-browser Playwright; and

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

@@ -21100,5 +21100,88 @@
       "OMH-039",
       "OMH-232"
     ]
+  },
+  {
+    "id": "OMH-234",
+    "title": "Reuse installed collaborative documents instead of building a private notes system",
+    "family": "architecture",
+    "mode": "analysis",
+    "evaluationKind": "routing",
+    "risk": "high",
+    "prompt": "In a freshly scaffolded standalone Open Mercato app, account teams need shared rich documents attached to customers, deals, quotes, and orders. Several staff members must be able to edit at the same time, discuss selected text, mention colleagues, restore earlier versions, reuse templates, attach files, and grant viewer, commenter, editor, or owner access per document. Decide the smallest safe design against what the installed modules already provide, keep tenant, organization, and record-level visibility boundaries intact, state the access-control posture for reading, commenting, editing, sharing, and managing templates, and identify the smallest relevant validation. Do not model your own document, content, comment, share, version, attachment, or template tables before establishing whether an installed module already owns this capability.",
+    "tags": [
+      "architecture",
+      "module-facts",
+      "reuse-installed",
+      "collaborative-documents"
+    ],
+    "owner": {
+      "kind": "facts",
+      "path": ".ai/guides/modules/documents/index.md",
+      "ruleIds": [
+        "BC-01",
+        "BC-04"
+      ]
+    },
+    "expectedRouter": {
+      "required": [
+        "architecture"
+      ],
+      "allowedExtra": [
+        "module-data",
+        "backend-ui",
+        "umes",
+        "framework-context"
+      ]
+    },
+    "requiredSkills": [
+      "om-help"
+    ],
+    "context": {
+      "required": [
+        "AGENTS.md",
+        ".ai/guides/architecture.md",
+        ".ai/skills/om-help/SKILL.md",
+        ".ai/guides/modules/documents/index.md"
+      ],
+      "allowedExtra": [
+        ".ai/guides/contracts.md",
+        ".ai/guides/extensions.md",
+        ".ai/guides/backend-ui.md"
+      ],
+      "forbidden": [
+        ".env*",
+        ".git/**"
+      ]
+    },
+    "requiredDecisions": [
+      "facts-first",
+      "reuse-installed-documents",
+      "per-document-access",
+      "tenant-scope",
+      "acl-features",
+      "smallest-validation"
+    ],
+    "forbiddenPatterns": [
+      "node_modules.{0,40}(?:write|edit|patch)",
+      "(?:tenant|organization).{0,30}(?:unscoped|scope optional)"
+    ],
+    "validators": [
+      "catalog.schema",
+      "owner.reference",
+      "skills.reference",
+      "router.contract",
+      "context.budget",
+      "context.forbidden",
+      "patterns.forbidden"
+    ],
+    "maxContextFiles": 8,
+    "maxInitialContextBytes": 53248,
+    "maxTotalContextBytes": 147456,
+    "relatedCases": [
+      "OMH-002",
+      "OMH-194",
+      "OMH-210"
+    ]
   }
 ]

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

@@ -3,8 +3,8 @@
   "$id": "https://open-mercato.dev/schemas/standalone-harness-cases.schema.json",
   "title": "Open Mercato standalone harness case catalog",
   "type": "array",
-  "minItems": 233,
-  "maxItems": 233,
+  "minItems": 234,
+  "maxItems": 234,
   "items": {
     "type": "object",
     "additionalProperties": false,
@@ -15,7 +15,7 @@
       "maxTotalContextBytes", "relatedCases"
     ],
     "properties": {
-      "id": { "type": "string", "pattern": "^OMH-(00[1-9]|0[1-9][0-9]|1[0-9][0-9]|20[0-9]|21[0-9]|22[0-9]|23[0-3])$" },
+      "id": { "type": "string", "pattern": "^OMH-(00[1-9]|0[1-9][0-9]|1[0-9][0-9]|20[0-9]|21[0-9]|22[0-9]|23[0-4])$" },
       "title": { "type": "string", "minLength": 12, "maxLength": 180 },
       "family": { "enum": ["architecture", "module", "umes", "integration", "ai-workflow", "bugfix", "business", "testing"] },
       "mode": { "enum": ["analysis", "one-shot", "spec", "bugfix", "review"] },
@@ -168,7 +168,7 @@
       "maxInitialContextBytes": { "type": "integer", "minimum": 4096, "maximum": 98304 },
       "maxTotalContextBytes": { "type": "integer", "minimum": 8192, "maximum": 1048576 },
       "timeoutMs": { "type": "integer", "minimum": 1000, "maximum": 600000 },
-      "relatedCases": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^OMH-(00[1-9]|0[1-9][0-9]|1[0-9][0-9]|20[0-9]|21[0-9]|22[0-9]|23[0-3])$" } },
+      "relatedCases": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^OMH-(00[1-9]|0[1-9][0-9]|1[0-9][0-9]|20[0-9]|21[0-9]|22[0-9]|23[0-4])$" } },
       "source": {
         "type": "object",
         "additionalProperties": false,

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

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "catalog": {
-    "expectedCaseCount": 233,
+    "expectedCaseCount": 234,
     "maxContextFiles": 16,
     "maxInitialContextBytes": 98304,
     "maxTotalContextBytes": 1048576,

package/dist/lib/generators/module-registry.js

@@ -320,6 +320,38 @@ function extractObjectPropertiesFromAst(sourceFile, exportName) {
   }
   return Object.keys(result).length > 0 ? result : null;
 }
+function namedObjectLiteralDeclaresProperty(sourceFile, exportName, propertyName) {
+  let source = "";
+  try {
+    source = fs.readFileSync(sourceFile, "utf8");
+  } catch {
+    return false;
+  }
+  const parsed = ts.createSourceFile(sourceFile, source, ts.ScriptTarget.Latest, true, inferScriptKind(sourceFile));
+  const exportedNames = /* @__PURE__ */ new Set();
+  for (const statement of parsed.statements) {
+    if (ts.isExportDeclaration(statement) && statement.exportClause && ts.isNamedExports(statement.exportClause) && !statement.moduleSpecifier) {
+      for (const element of statement.exportClause.elements) exportedNames.add(element.name.text);
+    }
+  }
+  for (const statement of parsed.statements) {
+    if (!ts.isVariableStatement(statement)) continue;
+    const exportsDirectly = (ts.canHaveModifiers(statement) ? ts.getModifiers(statement) : void 0)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword);
+    for (const declaration of statement.declarationList.declarations) {
+      if (!ts.isIdentifier(declaration.name) || declaration.name.text !== exportName) continue;
+      if (!exportsDirectly && !exportedNames.has(exportName)) continue;
+      const objectLiteral2 = unwrapObjectLiteralExpression(declaration.initializer);
+      if (!objectLiteral2) return false;
+      return objectLiteral2.properties.some((property) => {
+        const name = property.name;
+        if (!name) return false;
+        const key = ts.isIdentifier(name) ? name.text : ts.isStringLiteral(name) ? name.text : null;
+        return key === propertyName;
+      });
+    }
+  }
+  return false;
+}
 function extractNamedObjectLiteralExport(sourceFile, exportName) {
   const literal = extractNamedObjectLiteralSource(sourceFile, exportName);
   if (literal) {
@@ -1238,6 +1270,7 @@ function normalizeWorkerMetadata(raw) {
   if (typeof source.concurrency === "number") normalized.concurrency = source.concurrency;
   if (typeof source.lockDuration === "number") normalized.lockDuration = source.lockDuration;
   if (typeof source.maxStalledCount === "number") normalized.maxStalledCount = source.maxStalledCount;
+  if (typeof source.onJobAbandoned === "function") normalized.hasJobAbandonedHook = true;
   return Object.keys(normalized).length > 0 ? normalized : null;
 }
 async function loadSubscriberMetadata(sourceFile) {
@@ -1246,7 +1279,12 @@ async function loadSubscriberMetadata(sourceFile) {
 }
 async function loadWorkerMetadata(sourceFile) {
   const sourceModule = await loadModuleExportsFromSource(sourceFile);
-  return normalizeWorkerMetadata(sourceModule?.metadata) ?? normalizeWorkerMetadata(extractNamedObjectLiteralExport(sourceFile, "metadata"));
+  const metadata = normalizeWorkerMetadata(sourceModule?.metadata) ?? normalizeWorkerMetadata(extractNamedObjectLiteralExport(sourceFile, "metadata"));
+  if (!metadata) return null;
+  if (!metadata.hasJobAbandonedHook && namedObjectLiteralDeclaresProperty(sourceFile, "metadata", "onJobAbandoned")) {
+    metadata.hasJobAbandonedHook = true;
+  }
+  return metadata;
 }
 async function discoverSubscribers(roots, imps, modId) {
   const subscribers = [];
@@ -1708,12 +1746,16 @@ function processSubscribers(discovered) {
   }
   return subscribers;
 }
+const ABANDON_HOOK_FACTORY = "createLazyModuleWorkerAbandonHook";
+function workersDeclareAbandonHook(discovered) {
+  return discovered.some(({ metadata }) => metadata.hasJobAbandonedHook === true);
+}
 function processWorkers(discovered) {
   const workers = [];
   for (const { id, importPath, metadata } of discovered) {
     const workerId = metadata.id ?? id;
     workers.push(
-      `{ id: ${toLiteral(workerId)}, queue: ${toLiteral(metadata.queue)}, concurrency: ${toLiteral(metadata.concurrency ?? 1)}${metadata.lockDuration === void 0 ? "" : `, lockDuration: ${toLiteral(metadata.lockDuration)}`}${metadata.maxStalledCount === void 0 ? "" : `, maxStalledCount: ${toLiteral(metadata.maxStalledCount)}`}, handler: createLazyModuleWorker(() => ${buildDynamicImportExpression(importPath)}, ${toLiteral(workerId)}) }`
+      `{ id: ${toLiteral(workerId)}, queue: ${toLiteral(metadata.queue)}, concurrency: ${toLiteral(metadata.concurrency ?? 1)}${metadata.lockDuration === void 0 ? "" : `, lockDuration: ${toLiteral(metadata.lockDuration)}`}${metadata.maxStalledCount === void 0 ? "" : `, maxStalledCount: ${toLiteral(metadata.maxStalledCount)}`}${metadata.hasJobAbandonedHook ? `, onJobAbandoned: ${ABANDON_HOOK_FACTORY}(() => ${buildDynamicImportExpression(importPath)}, ${toLiteral(workerId)})` : ""}, handler: createLazyModuleWorker(() => ${buildDynamicImportExpression(importPath)}, ${toLiteral(workerId)}) }`
     );
   }
   return workers;
@@ -1920,6 +1962,7 @@ function renderAstModuleRegistryFile(options) {
     namedImports: [
       { name: "createLazyModuleSubscriber" },
       { name: "createLazyModuleWorker" },
+      ...options.includeAbandonHookImport ? [{ name: ABANDON_HOOK_FACTORY }] : [],
       { name: "Module", isTypeOnly: true }
     ]
   });
@@ -2010,9 +2053,10 @@ function buildLazyRouteComponentExpression(importPath) {
   return `async (props: any) => { const mod = await ${buildDynamicImportExpression(importPath)}; const Component = (mod.default ?? mod) as any; return createElement(Component, props) }`;
 }
 function renderAstLegacyModuleRegistryOutput(options) {
+  const needsAbandonHookImport = options.includeAbandonHookImport || options.moduleEntries.some((entry) => entry.includes(ABANDON_HOOK_FACTORY));
   const importSection = [
     ...options.includeCreateElementImport ? ["import { createElement } from 'react'"] : [],
-    "import { createLazyModuleSubscriber, createLazyModuleWorker, type Module } from '@open-mercato/shared/modules/registry'",
+    needsAbandonHookImport ? "import { createLazyModuleSubscriber, createLazyModuleWorker, createLazyModuleWorkerAbandonHook, type Module } from '@open-mercato/shared/modules/registry'" : "import { createLazyModuleSubscriber, createLazyModuleWorker, type Module } from '@open-mercato/shared/modules/registry'",
     ...options.imports.map((entry) => serializeGeneratedImport(entry))
   ].join("\n");
   return `// AUTO-GENERATED by mercato generate registry
@@ -2279,6 +2323,13 @@ function processWorkersAst(discovered) {
         { name: "concurrency", value: metadata.concurrency ?? 1 },
         ...metadata.lockDuration === void 0 ? [] : [{ name: "lockDuration", value: metadata.lockDuration }],
         ...metadata.maxStalledCount === void 0 ? [] : [{ name: "maxStalledCount", value: metadata.maxStalledCount }],
+        ...metadata.hasJobAbandonedHook ? [{
+          name: "onJobAbandoned",
+          value: callExpression(identifier(ABANDON_HOOK_FACTORY), [
+            arrowFunction({ body: importExpression(importPath) }),
+            workerId
+          ])
+        }] : [],
         {
           name: "handler",
           value: callExpression(identifier("createLazyModuleWorker"), [
@@ -2588,6 +2639,7 @@ async function generateModuleRegistryFromDiscovery(options) {
   const requiresByModule = /* @__PURE__ */ new Map();
   const commandLoaderEntries = [];
   let hasRouteComponents = false;
+  let hasAbandonHookWorkers = false;
   const umesConflictSources = [];
   const seenBackendRoutePatterns = /* @__PURE__ */ new Map();
   for (const discovered of discovery.modules) {
@@ -2791,7 +2843,9 @@ async function generateModuleRegistryFromDiscovery(options) {
       extraImports: runtimeImports
     }));
     subscribers.push(...processSubscribers(await discovered.getSubscribers()));
-    workers.push(...processWorkers(await discovered.getWorkers()));
+    const discoveredWorkersForModule = await discovered.getWorkers();
+    if (workersDeclareAbandonHook(discoveredWorkersForModule)) hasAbandonHookWorkers = true;
+    workers.push(...processWorkers(discoveredWorkersForModule));
     {
       const parts = [];
       if (fieldsImportName)
@@ -2943,13 +2997,15 @@ async function generateModuleRegistryFromDiscovery(options) {
     fileName: "modules.generated.ts",
     imports,
     moduleEntries: moduleDecls,
-    includeCreateElementImport: hasRouteComponents
+    includeCreateElementImport: hasRouteComponents,
+    includeAbandonHookImport: hasAbandonHookWorkers
   });
   const runtimeOutput = renderAstLegacyModuleRegistryOutput({
     fileName: "modules.runtime.generated.ts",
     imports: runtimeImports,
     moduleEntries: runtimeModuleDecls,
-    includeCreateElementImport: true
+    includeCreateElementImport: true,
+    includeAbandonHookImport: hasAbandonHookWorkers
   });
   const frontendRoutesOutput = renderAstLegacyManifestOutput({
     fileName: "frontend-routes.generated.ts",
@@ -3137,6 +3193,7 @@ async function generateModuleRegistryAppFromDiscovery(options) {
   const requiresByModule = /* @__PURE__ */ new Map();
   const commandLoaderEntries = [];
   let hasRouteComponents = false;
+  let hasAbandonHookWorkers = false;
   const seenBackendRoutePatterns = /* @__PURE__ */ new Map();
   for (const discovered of discovery.modules) {
     const { modId, roots, imps, appImportBase } = discovered;
@@ -3282,7 +3339,9 @@ async function generateModuleRegistryAppFromDiscovery(options) {
       i18nLocaleShards.set(locale, shard);
     }
     subscribers.push(...processSubscribersAst(await discovered.getSubscribers()));
-    workers.push(...processWorkersAst(await discovered.getWorkers()));
+    const discoveredWorkersForModule = await discovered.getWorkers();
+    if (workersDeclareAbandonHook(discoveredWorkersForModule)) hasAbandonHookWorkers = true;
+    workers.push(...processWorkersAst(discoveredWorkersForModule));
     {
       dashboardWidgetsValue = buildModuleDashboardWidgetsValue(discovered.dashboardWidgetEntries);
     }
@@ -3399,19 +3458,22 @@ async function generateModuleRegistryAppFromDiscovery(options) {
     generator: "registry (app version)",
     imports,
     moduleEntries: moduleDecls,
-    includeCreateElementImport: hasRouteComponents
+    includeCreateElementImport: hasRouteComponents,
+    includeAbandonHookImport: hasAbandonHookWorkers
   });
   const bootstrapOutput = renderAstModuleRegistryFile({
     fileName: "modules.bootstrap.generated.ts",
     generator: "registry (bootstrap version)",
     imports: bootstrapImports,
-    moduleEntries: bootstrapModuleDecls
+    moduleEntries: bootstrapModuleDecls,
+    includeAbandonHookImport: hasAbandonHookWorkers
   });
   const i18nOutput = renderAstModuleRegistryFile({
     fileName: "modules.i18n.generated.ts",
     generator: "registry (i18n version)",
     imports: i18nImports,
-    moduleEntries: i18nModuleDecls
+    moduleEntries: i18nModuleDecls,
+    includeAbandonHookImport: hasAbandonHookWorkers
   });
   const legacyOutput = renderAstLegacyAliasFile({
     fileName: "bootstrap-modules.generated.ts",
@@ -3486,6 +3548,7 @@ async function generateModuleRegistryAppFromDiscovery(options) {
   return result;
 }
 async function generateModuleRegistryCliFromDiscovery(options) {
+  let hasAbandonHookWorkers = false;
   const { resolver, quiet = false } = options;
   const { discovery } = options;
   const result = createGeneratorResult();
@@ -3604,6 +3667,7 @@ async function generateModuleRegistryCliFromDiscovery(options) {
     subscribers.push(...processSubscribersAst(await discovered.getSubscribers()));
     const discoveredWorkers = await discovered.getWorkers();
     const workerGenerationEntries = collectWorkerGenerationEntries(discoveredWorkers, modId);
+    if (workersDeclareAbandonHook(discoveredWorkers)) hasAbandonHookWorkers = true;
     workers.push(...processWorkersAst(discoveredWorkers));
     devSupervisorWorkers.push(...workerGenerationEntries.map(({ importPath: _importPath, ...worker }) => worker));
     {
@@ -3720,7 +3784,8 @@ async function generateModuleRegistryCliFromDiscovery(options) {
     fileName: "modules.cli.generated.ts",
     generator: "registry (CLI version)",
     imports,
-    moduleEntries: moduleDecls
+    moduleEntries: moduleDecls,
+    includeAbandonHookImport: hasAbandonHookWorkers
   });
   const legacyOutput = renderAstLegacyAliasFile({
     fileName: "cli-modules.generated.ts",
@@ -3806,6 +3871,7 @@ export {
   generateModuleRegistryApp,
   generateModuleRegistryCli,
   hasNamedExport,
+  namedObjectLiteralDeclaresProperty,
   resetConventionWarnings,
   resolveNamedObjectExport,
   warnIfPageMetaMissingMetadataExport,