@open-mercato/cli 0.6.8-develop.6961.1.5b7ca407e7 → 0.6.8-develop.6962.1.bd029a2bb2

package/dist/agentic/shared/ai/harness/writable-spec-oracles.mjs

@@ -49,7 +49,7 @@ const EXAMPLE_ROOT = 'src/modules/example'
 const EXAMPLE_INVENTORY = `${EXAMPLE_ROOT}/references/surface-inventory.json`
 const REFERENCE_FACTS = '.ai/guides/reference-module-facts.json'
 const SOURCE_LINK_INVENTORY = '.ai/harness/source-link-inventory.json'
-const REFERENCE_SHEET = '.ai/guides/reference-modules/example.md'
+const REFERENCE_SHEET = '.ai/guides/reference-modules/example/index.md'
 const EXAMPLE_FILE_PATTERN = /\bsrc\/modules\/example\/[A-Za-z0-9._/-]+\.[A-Za-z0-9]+\b/g
 // A directory-only or globbed hint is not a source link. `src/modules/example/api/**`,
 // `src/modules/example/widgets/*.ts` and a bare `src/modules/example/commands/` all name a

package/dist/agentic/shared/ai/skills/om-build-workflow/SKILL.md

@@ -9,7 +9,7 @@ Compose the installed workflow engine; do not bypass its executor, state machine
 
 ## Workflow
 
-Route before reading: workflow definitions, activities, durable engine state, idempotency, tasks, and outputs stay on `ai-workflow`. Workflow-only work loads `.ai/guides/modules/workflows.md`, not `.ai/guides/contracts.md`; coordinating installed-host order, status, or quantity state also selects `module-data` + `umes` and loads `.ai/guides/contracts.md`, `.ai/guides/extensions.md`, and `om-system-extension`.
+Route before reading: workflow definitions, activities, durable engine state, idempotency, tasks, and outputs stay on `ai-workflow`. Workflow-only work loads `.ai/guides/modules/workflows/index.md`, not `.ai/guides/contracts.md`; coordinating installed-host order, status, or quantity state also selects `module-data` + `umes` and loads `.ai/guides/contracts.md`, `.ai/guides/extensions.md`, and `om-system-extension`.
 
 1. Read `.ai/guides/ai-workflows.md`; inspect the installed workflows module facts and use `om-framework-context` for exact service/activity contracts.
 2. Always load `references/workflow-design.md` before defining steps, transitions, triggers, variables, tasks, compensation, or terminal states.
@@ -18,7 +18,7 @@ Route before reading: workflow definitions, activities, durable engine state, id
 5. Run `yarn generate`; test event storms, retry/restart, rollback, duplicate signal/callback, cancellation, compensation failure, and scope isolation.
 
 Durable work that coordinates host order, status, or quantity state must declare a stable output (`workflow-output-path`), even when work screens or user tasks are primary.
-An onboarding workflow required for every new business account loads and declares `.ai/guides/modules/onboarding.md`, then uses `onTenantCreated` (`on-tenant-created-hook`).
+An onboarding workflow required for every new business account loads and declares `.ai/guides/modules/onboarding/index.md`, then uses `onTenantCreated` (`on-tenant-created-hook`).
 
 ## Rules
 

package/dist/agentic/shared/ai/skills/om-create-ai-agent/SKILL.md

@@ -16,7 +16,7 @@ Choose module AI versus file-agent orchestration, then implement typed inputs/ou
 5. Test missing provider, denied ACL/scope, tool validation, budgets, approval/cancel/expire/stale version, artifact authorization, and generated registration.
 
 An authorized AI file upload stays on the attachment branch; add integration or data-model context only for a custom transport, storage provider, or app-owned persistence.
-An agent/tool that scores or explains customer, contact, lead, or deal records must load `.ai/guides/modules/customers.md`; read-only access still targets that host.
+An agent/tool that scores or explains customer, contact, lead, or deal records must load `.ai/guides/modules/customers/index.md`; read-only access still targets that host.
 
 ## Rules
 

package/dist/agentic/shared/ai/skills/om-create-ai-agent/references/surface-selector.md

@@ -16,4 +16,4 @@ Load this reference before creating files.
 
 Use exact installed orchestrator context for file agents; do not conflate them with product module agents.
 
-MCP/OpenCode configuration, authentication, provider precedence, and session semantics are ask-first contract surfaces. Route them through the `ai-workflow` guide and the installed `.ai/guides/modules/ai_assistant.md` fact sheet rather than guessing.
+MCP/OpenCode configuration, authentication, provider precedence, and session semantics are ask-first contract surfaces. Route them through the `ai-workflow` guide and the installed `.ai/guides/modules/ai_assistant/index.md` fact sheet rather than guessing.

package/dist/agentic/shared/ai/skills/om-module-scaffold/references/business-one-shot-blueprints.md

@@ -100,7 +100,7 @@ Before stopping, run `yarn generate` and then `yarn typecheck`. Any diagnostic m
 
 | One-shot business brief | Mechanism | Routes | Smallest complete vertical slice | Key invariants |
 |---|---|---|---|---|
-| “Generate an app that gathers website leads and adds them to the CRM.” | App module owns public capture + UMES/events create or link CRM customer/deal; MUST read `.ai/guides/modules/customers.md`, invoke `om-data-model-design`, and report `smallest-validation` for the lead record and scalar CRM link | `M+U+B` (`+W` for async handoff) | public form, spam/consent validation, lead inbox, dedupe, qualification command, CRM handoff, attribution, success/error paths | public input never supplies scope; an explicit trusted config/domain binding selects the exact tenant+organization and missing, partial, or ambiguous bindings fail closed—never select or persist the first/oldest active tenant or organization; idempotency lookup and database uniqueness include tenant+organization; merge and revalidate mutation guards' `modifiedPayload` before command dispatch; PII encryption with `TenantDataEncryptionService` and `lookupHashCandidates`; CRM optional/degraded; handoff retry cannot duplicate |
+| “Generate an app that gathers website leads and adds them to the CRM.” | App module owns public capture + UMES/events create or link CRM customer/deal; MUST read `.ai/guides/modules/customers/index.md`, invoke `om-data-model-design`, and report `smallest-validation` for the lead record and scalar CRM link | `M+U+B` (`+W` for async handoff) | public form, spam/consent validation, lead inbox, dedupe, qualification command, CRM handoff, attribution, success/error paths | public input never supplies scope; an explicit trusted config/domain binding selects the exact tenant+organization and missing, partial, or ambiguous bindings fail closed—never select or persist the first/oldest active tenant or organization; idempotency lookup and database uniqueness include tenant+organization; merge and revalidate mutation guards' `modifiedPayload` before command dispatch; PII encryption with `TenantDataEncryptionService` and `lookupHashCandidates`; CRM optional/degraded; handoff retry cannot duplicate |
 | “Build partner referral intake connected to CRM.” | App module + UMES CRM handoff | `M+U+B` | partner-authenticated form, referral record/status, customer/deal match, owner assignment, partner-visible outcome | partner sees only its referrals; deterministic dedupe; immutable attribution; CRM IDs stored as scalars |
 | “Assign incoming leads fairly across eligible staff.” | App assignment policy + UMES customer/staff seams | `M+U` | read both `customers` and `staff` facts; scoped cursor, deterministic selector, availability resolver, assignment command/audit, fallback | concurrency-safe round robin; retries preserve the winner; unauthorized/unavailable staff excluded; staff module optional |
 | “Import trade-show badge scans and turn qualified leads into deals.” | App module + data-sync provider when scanner API is reusable + UMES | `M+P+U+W` | upload/sync, mapping preview, lead staging, dedupe, qualification queue, CRM conversion report | resumable/idempotent batches; row-level errors; encrypted credentials; no partial duplicate conversions |

package/dist/agentic/shared/scripts/evaluate-agent-harness.mjs

@@ -2263,7 +2263,7 @@ function prepareCaseFrameworkContext(caseRecord, controllerRoot, runRoot) {
 
 export function caseReadAllowlist(caseRecord, writable, appRoot) {
   const skillIds = supportingSkillIds(caseRecord)
-  return [...new Set([
+  const declared = [
     'AGENTS.md',
     ...exampleReadAllowlist(caseRecord, appRoot),
     ...(caseRecord.context?.required ?? []),
@@ -2277,7 +2277,12 @@ export function caseReadAllowlist(caseRecord, writable, appRoot) {
     ]),
     ...(caseRecord.materializedFrameworkContextPatterns ?? []),
     ...(writable ? caseRecord.allowedWrites ?? [] : []),
-  ])].sort()
+  ]
+  const moduleFactSections = declared.flatMap((entry) => {
+    const match = /^(\.ai\/guides\/(?:modules|reference-modules)\/[a-z0-9_]+)\/index\.md$/.exec(entry)
+    return match ? [`${match[1]}/*.md`] : []
+  })
+  return [...new Set([...declared, ...moduleFactSections])].sort()
 }
 
 function permittedContextPath(relative, caseRecord) {
@@ -2288,7 +2293,11 @@ function permittedContextPath(relative, caseRecord) {
     ...permittedCaseRoutes(caseRecord).flatMap((route) => ROUTE_STANDARD_CONTEXT[route]?.guides ?? []),
     ...(caseRecord.materializedFrameworkContextPatterns ?? []),
   ]
-  if (contextPaths.some((pattern) => globToRegExp(pattern).test(relative))) return true
+  const expandedContextPaths = contextPaths.flatMap((entry) => {
+    const match = /^(\.ai\/guides\/(?:modules|reference-modules)\/[a-z0-9_]+)\/index\.md$/.exec(entry)
+    return match ? [entry, `${match[1]}/*.md`] : [entry]
+  })
+  if (expandedContextPaths.some((pattern) => globToRegExp(pattern).test(relative))) return true
   const skillPaths = supportingSkillPaths(caseRecord)
   const skillRoots = [...contextPaths, ...skillPaths]
     .filter((entry) => entry.endsWith('/SKILL.md'))

package/dist/lib/__integration__/TC-INT-008.spec.js

@@ -210,12 +210,20 @@ function expectedGuideOutputNames() {
   }
   collected.add("module-facts.json");
   collected.add("module-facts.v2.json");
+  collected.add("reference-module-facts.json");
   collected.add("framework-extension-points.md");
   collected.add("upstream/AGENTS.md");
   collected.add("upstream/BACKWARD_COMPATIBILITY.md");
   collected.add("upstream/manifest.json");
   for (const moduleId of FIXTURE_ENABLED_MODULES) {
-    collected.add(normalizePath(path.join("modules", `${moduleId}.md`)));
+    const moduleFactsRoot = path.join(cliDir, "dist", "agentic", "guides", "modules", moduleId);
+    for (const file of fs.readdirSync(moduleFactsRoot)) {
+      if (file.endsWith(".md")) collected.add(normalizePath(path.join("modules", moduleId, file)));
+    }
+  }
+  const referenceFactsRoot = path.join(cliDir, "dist", "agentic", "guides", "reference-modules");
+  for (const file of listRelativeFiles(referenceFactsRoot)) {
+    collected.add(normalizePath(path.join("reference-modules", file)));
   }
   return Array.from(collected).sort();
 }
@@ -252,7 +260,7 @@ test.describe("TC-INT-008: CLI agentic init mirrors standalone scaffolding asset
       for (const moduleId of FIXTURE_ENABLED_MODULES) {
         expect(agentsSource).toContain(`\`${moduleId}\``);
       }
-      expect(agentsSource).toContain("`.ai/guides/modules/<id>.md`");
+      expect(agentsSource).toContain("`.ai/guides/modules/<id>/index.md`");
       expect(agentsSource.match(/\.ai\/guides\/modules\//g)).toHaveLength(1);
       expect(agentsSource).not.toContain("`auth`");
       expect(agentsSource).not.toContain("Core CRM capabilities");

package/dist/lib/__integration__/TC-INT-008.spec.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/__integration__/TC-INT-008.spec.ts"],
-  "sourcesContent": ["import { expect, test } from '@playwright/test'\nimport { execFileSync } from 'node:child_process'\nimport fs from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst repoRoot = path.resolve(__dirname, '..', '..', '..', '..', '..')\nconst cliDir = path.join(repoRoot, 'packages', 'cli')\nconst cliBin = path.join(cliDir, 'dist', 'bin.js')\nconst cliBuildScript = path.join(cliDir, 'build.mjs')\nconst cliIntegrationRunnerPath = path.join(cliDir, 'src', 'lib', 'testing', 'integration.ts')\nconst standaloneTemplatePackageJsonPath = path.join(repoRoot, 'packages', 'create-app', 'template', 'package.json.template')\nconst agenticRoot = path.join(repoRoot, 'packages', 'create-app', 'agentic')\nconst packagesRoot = path.join(repoRoot, 'packages')\nconst coreVersion = JSON.parse(fs.readFileSync(path.join(packagesRoot, 'core', 'package.json'), 'utf8')).version as string\nconst UNROUTED_PACKAGE_GUIDES = new Set(['cache', 'core', 'events', 'queue', 'search', 'shared', 'ui'])\n\n// Modules the standalone fixture enables in src/modules.ts. Both are on the\n// fact-sheet allowlist, so agentic:init must ship exactly their fact-sheets\n// (enabled \u2229 allowlist \u2014 spec D6) and list them in the AGENTS.md marker block.\nconst FIXTURE_ENABLED_MODULES = ['customers', 'sales']\n\nfunction normalizePath(value: string): string {\n  return value.split(path.sep).join('/')\n}\n\nfunction runCommand(command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv = {}): string {\n  return execFileSync(command, args, {\n    cwd,\n    encoding: 'utf8',\n    env: {\n      ...process.env,\n      FORCE_COLOR: '0',\n      NODE_NO_WARNINGS: '1',\n      // Keep the test hermetic: agentic:init runs scripts/install-skills.sh,\n      // whose external step (`npx skills add`) needs the network. Local tier\n      // symlinks are still installed.\n      OM_SKIP_EXTERNAL_SKILLS: '1',\n      ...env,\n    },\n  })\n}\n\nfunction runMercato(args: string[], cwd: string): string {\n  return runCommand(process.execPath, [cliBin, ...args], cwd)\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n  fs.writeFileSync(filePath, content)\n}\n\nfunction ensureCliBuilt(): void {\n  runCommand(process.execPath, [cliBuildScript], cliDir)\n}\n\nfunction createStandaloneFixture(rootDir: string): string {\n  const appDir = path.join(rootDir, 'sample-store')\n  writeFile(\n    path.join(appDir, 'package.json'),\n    JSON.stringify(\n      {\n        name: 'sample-store',\n        private: true,\n        dependencies: { '@open-mercato/core': coreVersion },\n      },\n      null,\n      2,\n    ),\n  )\n  const moduleEntries = FIXTURE_ENABLED_MODULES\n    .map((moduleId) => `  { id: '${moduleId}', from: '@open-mercato/core' },`)\n    .join('\\n')\n  writeFile(path.join(appDir, 'src', 'modules.ts'), `export const enabledModules = [\\n${moduleEntries}\\n]\\n`)\n  return appDir\n}\n\nfunction installFakeFrameworkPackage(appDir: string): string {\n  const packageRoot = path.join(appDir, 'node_modules', '@open-mercato', 'core')\n  writeFile(path.join(packageRoot, 'package.json'), JSON.stringify({\n    name: '@open-mercato/core',\n    version: coreVersion,\n    type: 'module',\n    exports: { '.': './dist/index.js' },\n  }))\n  writeFile(path.join(packageRoot, 'dist', 'index.js'), 'export {}\\n')\n  writeFile(path.join(packageRoot, 'AGENTS.md'), '# Installed core instructions\\n')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    writeFile(path.join(packageRoot, 'src', 'modules', moduleId, 'AGENTS.md'), `# Installed ${moduleId} instructions\\n`)\n    writeFile(\n      path.join(packageRoot, 'src', 'modules', moduleId, 'data', 'entities.ts'),\n      `export class ${moduleId === 'customers' ? 'Person' : 'Sale'} {}\\n`,\n    )\n  }\n  return packageRoot\n}\n\nfunction snapshotTextFiles(rootDir: string): Record<string, string> {\n  return Object.fromEntries(\n    listRelativeFiles(rootDir).map((relativePath) => [\n      relativePath,\n      fs.readFileSync(path.join(rootDir, relativePath), 'utf8'),\n    ]),\n  )\n}\n\nfunction listRelativeFiles(rootDir: string): string[] {\n  if (!fs.existsSync(rootDir)) {\n    return []\n  }\n\n  const collected: string[] = []\n  for (const entry of fs.readdirSync(rootDir, { withFileTypes: true })) {\n    const absolutePath = path.join(rootDir, entry.name)\n    if (entry.isDirectory()) {\n      for (const nestedPath of listRelativeFiles(absolutePath)) {\n        collected.push(path.join(entry.name, nestedPath))\n      }\n      continue\n    }\n    if (entry.isFile()) {\n      collected.push(entry.name)\n    }\n  }\n\n  return collected.map(normalizePath).sort()\n}\n\nfunction mapSharedSourceToOutput(relativePath: string): string {\n  if (relativePath === 'AGENTS.md.template') {\n    return 'AGENTS.md'\n  }\n\n  if (relativePath.startsWith('scripts/')) {\n    return relativePath\n  }\n\n  if (!relativePath.startsWith('ai/')) {\n    throw new Error(`Unexpected shared source path: ${relativePath}`)\n  }\n\n  return normalizePath(path.join('.ai', relativePath.slice('ai/'.length)))\n}\n\nfunction mapClaudeSourceToOutput(relativePath: string): string {\n  if (relativePath === 'CLAUDE.md.template') {\n    return 'CLAUDE.md'\n  }\n  if (relativePath === 'settings.json') {\n    return '.claude/settings.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/')) {\n    return normalizePath(path.join('.claude', relativePath))\n  }\n\n  throw new Error(`Unexpected Claude source path: ${relativePath}`)\n}\n\nfunction mapCursorSourceToOutput(relativePath: string): string {\n  if (relativePath === 'hooks.json') {\n    return '.cursor/hooks.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.cursor/mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/') || relativePath.startsWith('rules/')) {\n    return normalizePath(path.join('.cursor', relativePath))\n  }\n\n  throw new Error(`Unexpected Cursor source path: ${relativePath}`)\n}\n\nfunction mapCodexSourceToOutput(relativePath: string): string | null {\n  if (relativePath === 'mcp.json.example') {\n    return '.codex/mcp.json.example'\n  }\n  if (relativePath === 'enforcement-rules.md') {\n    return null\n  }\n\n  throw new Error(`Unexpected Codex source path: ${relativePath}`)\n}\n\nfunction readPlaywrightConfigPathFromTemplate(): string {\n  const packageTemplate = JSON.parse(fs.readFileSync(standaloneTemplatePackageJsonPath, 'utf8')) as {\n    scripts?: Record<string, string>\n  }\n  const integrationScript = packageTemplate.scripts?.['test:integration']\n  if (!integrationScript) {\n    throw new Error('Standalone template is missing the test:integration script')\n  }\n\n  const configPathMatch = integrationScript.match(/--config\\s+([^\\s]+)/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('Standalone template test:integration script is missing --config')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction readPlaywrightConfigPathFromCliRunner(): string {\n  const integrationRunnerSource = fs.readFileSync(cliIntegrationRunnerPath, 'utf8')\n  const configPathMatch = integrationRunnerSource.match(/const PLAYWRIGHT_INTEGRATION_CONFIG_PATH = '([^']+)'/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('CLI integration runner is missing PLAYWRIGHT_INTEGRATION_CONFIG_PATH')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction expectedGuideOutputNames(): string[] {\n  const collected = new Set<string>()\n\n  // Static conceptual guides checked into create-app (e.g. module-system.md) are\n  // bundled into dist/agentic/guides by the CLI build and copied wholesale.\n  const staticGuidesRoot = path.join(agenticRoot, 'guides')\n  if (fs.existsSync(staticGuidesRoot)) {\n    for (const entry of fs.readdirSync(staticGuidesRoot, { withFileTypes: true })) {\n      if (entry.isFile() && entry.name.endsWith('.md')) {\n        collected.add(entry.name)\n      }\n    }\n  }\n\n  for (const packageName of fs.readdirSync(packagesRoot)) {\n    const packageGuide = path.join(packagesRoot, packageName, 'agentic', 'standalone-guide.md')\n    if (fs.existsSync(packageGuide) && !UNROUTED_PACKAGE_GUIDES.has(packageName)) {\n      collected.add(`${packageName}.md`)\n    }\n\n    const modulesRoot = path.join(packagesRoot, packageName, 'src', 'modules')\n    if (!fs.existsSync(modulesRoot)) {\n      continue\n    }\n\n    for (const moduleName of fs.readdirSync(modulesRoot)) {\n      const moduleGuide = path.join(modulesRoot, moduleName, 'agentic', 'standalone-guide.md')\n      if (fs.existsSync(moduleGuide)) {\n        collected.add(`${packageName}.${moduleName}.md`)\n      }\n    }\n  }\n\n  // Generated fact-sheet artifacts (spec 2026-06-27-ts-morph-module-fact-sheets):\n  // the v1 module-facts.json and corrected module-facts.v2.json sidecars are copied\n  // as-is and fact-sheets are filtered to the fixture's enabled modules. The legacy\n  // core.<module>.md redirect stubs are no longer\n  // emitted (#3754). framework-extension-points.md is likewise generated into\n  // dist/agentic/guides by both build.mjs pipelines (#4810) rather than checked in\n  // alongside the static conceptual guides, so it needs an explicit entry here.\n  collected.add('module-facts.json')\n  collected.add('module-facts.v2.json')\n  collected.add('framework-extension-points.md')\n  collected.add('upstream/AGENTS.md')\n  collected.add('upstream/BACKWARD_COMPATIBILITY.md')\n  collected.add('upstream/manifest.json')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    collected.add(normalizePath(path.join('modules', `${moduleId}.md`)))\n  }\n\n  return Array.from(collected).sort()\n}\n\nfunction assertPathsExist(appDir: string, relativePaths: string[]): void {\n  const missingPaths = relativePaths.filter((relativePath) => !fs.existsSync(path.join(appDir, relativePath)))\n  expect(missingPaths).toEqual([])\n}\n\ntest.describe('TC-INT-008: CLI agentic init mirrors standalone scaffolding assets', () => {\n  test.beforeAll(() => {\n    ensureCliBuilt()\n  })\n\n  test('should run bootstrap-free and generate the shared, guide, and tool-specific agentic files', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-agentic-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const standalonePlaywrightConfigPath = readPlaywrightConfigPathFromTemplate()\n      const cliPlaywrightConfigPath = readPlaywrightConfigPathFromCliRunner()\n      const commandOutput = runMercato(['agentic:init', '--tool=claude-code,codex,cursor'], appDir)\n\n      expect(cliPlaywrightConfigPath).toBe(standalonePlaywrightConfigPath)\n      expect(commandOutput).toContain('Agentic setup complete:')\n      expect(fs.existsSync(path.join(appDir, '.mercato', 'generated'))).toBe(false)\n\n      const sharedOutputs = listRelativeFiles(path.join(agenticRoot, 'shared')).map(mapSharedSourceToOutput)\n      const claudeOutputs = listRelativeFiles(path.join(agenticRoot, 'claude-code')).map(mapClaudeSourceToOutput)\n      const cursorOutputs = listRelativeFiles(path.join(agenticRoot, 'cursor')).map(mapCursorSourceToOutput)\n      const codexOutputs = listRelativeFiles(path.join(agenticRoot, 'codex'))\n        .map(mapCodexSourceToOutput)\n        .filter((relativePath): relativePath is string => relativePath !== null)\n\n      expect(sharedOutputs).toContain(standalonePlaywrightConfigPath)\n      assertPathsExist(appDir, [...sharedOutputs, ...claudeOutputs, ...cursorOutputs, ...codexOutputs])\n      expect(fs.existsSync(path.join(appDir, standalonePlaywrightConfigPath))).toBe(true)\n\n      const generatedGuideNames = listRelativeFiles(path.join(appDir, '.ai', 'guides'))\n      expect(generatedGuideNames).toEqual(expectedGuideOutputNames())\n\n      const agentsSource = fs.readFileSync(path.join(appDir, 'AGENTS.md'), 'utf8')\n      expect(agentsSource).toContain('<!-- CODEX_ENFORCEMENT_RULES_START -->')\n      expect(agentsSource).toContain('.ai/guides/upstream/BACKWARD_COMPATIBILITY.md')\n\n      // The Module-Specific Guides marker block is a compact enabled-module ID\n      // index (enabled \u2229 bundled) plus one progressively loaded path pattern.\n      for (const moduleId of FIXTURE_ENABLED_MODULES) {\n        expect(agentsSource).toContain(`\\`${moduleId}\\``)\n      }\n      expect(agentsSource).toContain('`.ai/guides/modules/<id>.md`')\n      expect(agentsSource.match(/\\.ai\\/guides\\/modules\\//g)).toHaveLength(1)\n      expect(agentsSource).not.toContain('`auth`')\n      expect(agentsSource).not.toContain('Core CRM capabilities')\n\n      const specsReadmeSource = fs.readFileSync(path.join(appDir, '.ai', 'specs', 'README.md'), 'utf8')\n      expect(specsReadmeSource).toContain('sample-store')\n\n      const cursorRulesSource = fs.readFileSync(path.join(appDir, '.cursor', 'rules', 'open-mercato.mdc'), 'utf8')\n      expect(cursorRulesSource).toContain('sample-store')\n\n      // om-spec-writing moved to the external open-mercato/skills collection\n      // (installed via `yarn install-skills`), so agentic:init must not ship a copy.\n      expect(fs.existsSync(path.join(appDir, '.ai', 'skills', 'om-spec-writing'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, 'scripts', 'install-skills.sh'))).toBe(true)\n\n      // install-skills.sh (run by agentic:init) installs every local tier skill once,\n      // into the canonical .agents/skills/. Codex and Cursor read that directory\n      // natively, so they get no skills directory of their own; Claude Code cannot,\n      // so it keeps a link layer pointing back at the canonical copy.\n      const tiersManifest = JSON.parse(\n        fs.readFileSync(path.join(agenticRoot, 'shared', 'ai', 'skills', 'tiers.json'), 'utf8'),\n      ) as { default: string[]; tiers: Record<string, { skills: string[] }> }\n      const defaultTierSkills = tiersManifest.default.flatMap((tierName) => tiersManifest.tiers[tierName].skills)\n      expect(defaultTierSkills.length).toBeGreaterThan(0)\n\n      for (const skillName of defaultTierSkills) {\n        const canonicalLinkPath = path.join(appDir, '.agents', 'skills', skillName)\n        expect(fs.lstatSync(canonicalLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(canonicalLinkPath))).toBe(`../../.ai/skills/${skillName}`)\n\n        const claudeLinkPath = path.join(appDir, '.claude', 'skills', skillName)\n        expect(fs.lstatSync(claudeLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(claudeLinkPath))).toBe(`../../.agents/skills/${skillName}`)\n      }\n\n      expect(fs.existsSync(path.join(appDir, '.codex', 'skills'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, '.cursor', 'skills'))).toBe(false)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n\n  test('emits a runnable exact-version framework context escape hatch for an installed package', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-framework-context-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const packageRoot = installFakeFrameworkPackage(appDir)\n      const resolvedPackageRoot = fs.realpathSync(packageRoot)\n      const packageBefore = snapshotTextFiles(packageRoot)\n\n      runMercato(['agentic:init', '--tool=codex'], appDir)\n      const generatedScript = path.join(appDir, 'scripts', 'framework-context.mjs')\n      expect(fs.existsSync(generatedScript)).toBe(true)\n\n      const output = runCommand(\n        process.execPath,\n        [generatedScript, '--module', 'customers', '--query', 'Person', '--json'],\n        appDir,\n        // The generated standalone helper must not depend on a globally\n        // installed ripgrep binary; process.execPath is already absolute.\n        { PATH: '', Path: '' },\n      )\n      const context = JSON.parse(output) as {\n        module: string\n        package: { name: string; version: string; root: string }\n        sourceKind: string\n        sourceRoot: string\n        materializedSource: string\n        instructions: Array<{ kind: string; path: string | null; materializedPath?: string }>\n        boundedSearch: { status: string; matches: number; maxMatches: number; result: string }\n        warnings: string[]\n      }\n\n      expect(context.module).toBe('customers')\n      expect(context.package).toEqual({ name: '@open-mercato/core', version: coreVersion, root: resolvedPackageRoot })\n      expect(context.sourceKind).toBe('source')\n      expect(normalizePath(context.sourceRoot)).toBe(normalizePath(path.join(resolvedPackageRoot, 'src', 'modules', 'customers')))\n      expect(context.instructions.filter((entry) => entry.path).map((entry) => entry.kind)).toEqual([\n        'standalone-root',\n        'upstream-bc',\n        'package',\n        'module-1',\n        'upstream-root',\n      ])\n      expect(context.instructions.filter((entry) => entry.path).every((entry) => entry.materializedPath)).toBe(true)\n      expect(context.boundedSearch).toMatchObject({ status: 'matched', matches: 1, maxMatches: 200 })\n      expect(fs.existsSync(path.join(appDir, context.materializedSource))).toBe(true)\n      expect(fs.existsSync(path.join(appDir, context.boundedSearch.result))).toBe(true)\n      expect(context.warnings.some((warning) => warning.includes('Generated facts for customers are stale'))).toBe(false)\n      expect(snapshotTextFiles(packageRoot)).toEqual(packageBefore)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n})\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { expect, test } from '@playwright/test'\nimport { execFileSync } from 'node:child_process'\nimport fs from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst repoRoot = path.resolve(__dirname, '..', '..', '..', '..', '..')\nconst cliDir = path.join(repoRoot, 'packages', 'cli')\nconst cliBin = path.join(cliDir, 'dist', 'bin.js')\nconst cliBuildScript = path.join(cliDir, 'build.mjs')\nconst cliIntegrationRunnerPath = path.join(cliDir, 'src', 'lib', 'testing', 'integration.ts')\nconst standaloneTemplatePackageJsonPath = path.join(repoRoot, 'packages', 'create-app', 'template', 'package.json.template')\nconst agenticRoot = path.join(repoRoot, 'packages', 'create-app', 'agentic')\nconst packagesRoot = path.join(repoRoot, 'packages')\nconst coreVersion = JSON.parse(fs.readFileSync(path.join(packagesRoot, 'core', 'package.json'), 'utf8')).version as string\nconst UNROUTED_PACKAGE_GUIDES = new Set(['cache', 'core', 'events', 'queue', 'search', 'shared', 'ui'])\n\n// Modules the standalone fixture enables in src/modules.ts. Both are on the\n// fact-sheet allowlist, so agentic:init must ship exactly their fact-sheets\n// (enabled \u2229 allowlist \u2014 spec D6) and list them in the AGENTS.md marker block.\nconst FIXTURE_ENABLED_MODULES = ['customers', 'sales']\n\nfunction normalizePath(value: string): string {\n  return value.split(path.sep).join('/')\n}\n\nfunction runCommand(command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv = {}): string {\n  return execFileSync(command, args, {\n    cwd,\n    encoding: 'utf8',\n    env: {\n      ...process.env,\n      FORCE_COLOR: '0',\n      NODE_NO_WARNINGS: '1',\n      // Keep the test hermetic: agentic:init runs scripts/install-skills.sh,\n      // whose external step (`npx skills add`) needs the network. Local tier\n      // symlinks are still installed.\n      OM_SKIP_EXTERNAL_SKILLS: '1',\n      ...env,\n    },\n  })\n}\n\nfunction runMercato(args: string[], cwd: string): string {\n  return runCommand(process.execPath, [cliBin, ...args], cwd)\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n  fs.writeFileSync(filePath, content)\n}\n\nfunction ensureCliBuilt(): void {\n  runCommand(process.execPath, [cliBuildScript], cliDir)\n}\n\nfunction createStandaloneFixture(rootDir: string): string {\n  const appDir = path.join(rootDir, 'sample-store')\n  writeFile(\n    path.join(appDir, 'package.json'),\n    JSON.stringify(\n      {\n        name: 'sample-store',\n        private: true,\n        dependencies: { '@open-mercato/core': coreVersion },\n      },\n      null,\n      2,\n    ),\n  )\n  const moduleEntries = FIXTURE_ENABLED_MODULES\n    .map((moduleId) => `  { id: '${moduleId}', from: '@open-mercato/core' },`)\n    .join('\\n')\n  writeFile(path.join(appDir, 'src', 'modules.ts'), `export const enabledModules = [\\n${moduleEntries}\\n]\\n`)\n  return appDir\n}\n\nfunction installFakeFrameworkPackage(appDir: string): string {\n  const packageRoot = path.join(appDir, 'node_modules', '@open-mercato', 'core')\n  writeFile(path.join(packageRoot, 'package.json'), JSON.stringify({\n    name: '@open-mercato/core',\n    version: coreVersion,\n    type: 'module',\n    exports: { '.': './dist/index.js' },\n  }))\n  writeFile(path.join(packageRoot, 'dist', 'index.js'), 'export {}\\n')\n  writeFile(path.join(packageRoot, 'AGENTS.md'), '# Installed core instructions\\n')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    writeFile(path.join(packageRoot, 'src', 'modules', moduleId, 'AGENTS.md'), `# Installed ${moduleId} instructions\\n`)\n    writeFile(\n      path.join(packageRoot, 'src', 'modules', moduleId, 'data', 'entities.ts'),\n      `export class ${moduleId === 'customers' ? 'Person' : 'Sale'} {}\\n`,\n    )\n  }\n  return packageRoot\n}\n\nfunction snapshotTextFiles(rootDir: string): Record<string, string> {\n  return Object.fromEntries(\n    listRelativeFiles(rootDir).map((relativePath) => [\n      relativePath,\n      fs.readFileSync(path.join(rootDir, relativePath), 'utf8'),\n    ]),\n  )\n}\n\nfunction listRelativeFiles(rootDir: string): string[] {\n  if (!fs.existsSync(rootDir)) {\n    return []\n  }\n\n  const collected: string[] = []\n  for (const entry of fs.readdirSync(rootDir, { withFileTypes: true })) {\n    const absolutePath = path.join(rootDir, entry.name)\n    if (entry.isDirectory()) {\n      for (const nestedPath of listRelativeFiles(absolutePath)) {\n        collected.push(path.join(entry.name, nestedPath))\n      }\n      continue\n    }\n    if (entry.isFile()) {\n      collected.push(entry.name)\n    }\n  }\n\n  return collected.map(normalizePath).sort()\n}\n\nfunction mapSharedSourceToOutput(relativePath: string): string {\n  if (relativePath === 'AGENTS.md.template') {\n    return 'AGENTS.md'\n  }\n\n  if (relativePath.startsWith('scripts/')) {\n    return relativePath\n  }\n\n  if (!relativePath.startsWith('ai/')) {\n    throw new Error(`Unexpected shared source path: ${relativePath}`)\n  }\n\n  return normalizePath(path.join('.ai', relativePath.slice('ai/'.length)))\n}\n\nfunction mapClaudeSourceToOutput(relativePath: string): string {\n  if (relativePath === 'CLAUDE.md.template') {\n    return 'CLAUDE.md'\n  }\n  if (relativePath === 'settings.json') {\n    return '.claude/settings.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/')) {\n    return normalizePath(path.join('.claude', relativePath))\n  }\n\n  throw new Error(`Unexpected Claude source path: ${relativePath}`)\n}\n\nfunction mapCursorSourceToOutput(relativePath: string): string {\n  if (relativePath === 'hooks.json') {\n    return '.cursor/hooks.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.cursor/mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/') || relativePath.startsWith('rules/')) {\n    return normalizePath(path.join('.cursor', relativePath))\n  }\n\n  throw new Error(`Unexpected Cursor source path: ${relativePath}`)\n}\n\nfunction mapCodexSourceToOutput(relativePath: string): string | null {\n  if (relativePath === 'mcp.json.example') {\n    return '.codex/mcp.json.example'\n  }\n  if (relativePath === 'enforcement-rules.md') {\n    return null\n  }\n\n  throw new Error(`Unexpected Codex source path: ${relativePath}`)\n}\n\nfunction readPlaywrightConfigPathFromTemplate(): string {\n  const packageTemplate = JSON.parse(fs.readFileSync(standaloneTemplatePackageJsonPath, 'utf8')) as {\n    scripts?: Record<string, string>\n  }\n  const integrationScript = packageTemplate.scripts?.['test:integration']\n  if (!integrationScript) {\n    throw new Error('Standalone template is missing the test:integration script')\n  }\n\n  const configPathMatch = integrationScript.match(/--config\\s+([^\\s]+)/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('Standalone template test:integration script is missing --config')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction readPlaywrightConfigPathFromCliRunner(): string {\n  const integrationRunnerSource = fs.readFileSync(cliIntegrationRunnerPath, 'utf8')\n  const configPathMatch = integrationRunnerSource.match(/const PLAYWRIGHT_INTEGRATION_CONFIG_PATH = '([^']+)'/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('CLI integration runner is missing PLAYWRIGHT_INTEGRATION_CONFIG_PATH')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction expectedGuideOutputNames(): string[] {\n  const collected = new Set<string>()\n\n  // Static conceptual guides checked into create-app (e.g. module-system.md) are\n  // bundled into dist/agentic/guides by the CLI build and copied wholesale.\n  const staticGuidesRoot = path.join(agenticRoot, 'guides')\n  if (fs.existsSync(staticGuidesRoot)) {\n    for (const entry of fs.readdirSync(staticGuidesRoot, { withFileTypes: true })) {\n      if (entry.isFile() && entry.name.endsWith('.md')) {\n        collected.add(entry.name)\n      }\n    }\n  }\n\n  for (const packageName of fs.readdirSync(packagesRoot)) {\n    const packageGuide = path.join(packagesRoot, packageName, 'agentic', 'standalone-guide.md')\n    if (fs.existsSync(packageGuide) && !UNROUTED_PACKAGE_GUIDES.has(packageName)) {\n      collected.add(`${packageName}.md`)\n    }\n\n    const modulesRoot = path.join(packagesRoot, packageName, 'src', 'modules')\n    if (!fs.existsSync(modulesRoot)) {\n      continue\n    }\n\n    for (const moduleName of fs.readdirSync(modulesRoot)) {\n      const moduleGuide = path.join(modulesRoot, moduleName, 'agentic', 'standalone-guide.md')\n      if (fs.existsSync(moduleGuide)) {\n        collected.add(`${packageName}.${moduleName}.md`)\n      }\n    }\n  }\n\n  // Generated fact-sheet artifacts (spec 2026-06-27-ts-morph-module-fact-sheets):\n  // the v1/v2 sidecars and disabled local-reference projection are copied as-is,\n  // while installed fact-sheets are filtered to the fixture's enabled modules. The legacy\n  // core.<module>.md redirect stubs are no longer\n  // emitted (#3754). framework-extension-points.md is likewise generated into\n  // dist/agentic/guides by both build.mjs pipelines (#4810) rather than checked in\n  // alongside the static conceptual guides, so it needs an explicit entry here.\n  collected.add('module-facts.json')\n  collected.add('module-facts.v2.json')\n  collected.add('reference-module-facts.json')\n  collected.add('framework-extension-points.md')\n  collected.add('upstream/AGENTS.md')\n  collected.add('upstream/BACKWARD_COMPATIBILITY.md')\n  collected.add('upstream/manifest.json')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    const moduleFactsRoot = path.join(cliDir, 'dist', 'agentic', 'guides', 'modules', moduleId)\n    for (const file of fs.readdirSync(moduleFactsRoot)) {\n      if (file.endsWith('.md')) collected.add(normalizePath(path.join('modules', moduleId, file)))\n    }\n  }\n  const referenceFactsRoot = path.join(cliDir, 'dist', 'agentic', 'guides', 'reference-modules')\n  for (const file of listRelativeFiles(referenceFactsRoot)) {\n    collected.add(normalizePath(path.join('reference-modules', file)))\n  }\n\n  return Array.from(collected).sort()\n}\n\nfunction assertPathsExist(appDir: string, relativePaths: string[]): void {\n  const missingPaths = relativePaths.filter((relativePath) => !fs.existsSync(path.join(appDir, relativePath)))\n  expect(missingPaths).toEqual([])\n}\n\ntest.describe('TC-INT-008: CLI agentic init mirrors standalone scaffolding assets', () => {\n  test.beforeAll(() => {\n    ensureCliBuilt()\n  })\n\n  test('should run bootstrap-free and generate the shared, guide, and tool-specific agentic files', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-agentic-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const standalonePlaywrightConfigPath = readPlaywrightConfigPathFromTemplate()\n      const cliPlaywrightConfigPath = readPlaywrightConfigPathFromCliRunner()\n      const commandOutput = runMercato(['agentic:init', '--tool=claude-code,codex,cursor'], appDir)\n\n      expect(cliPlaywrightConfigPath).toBe(standalonePlaywrightConfigPath)\n      expect(commandOutput).toContain('Agentic setup complete:')\n      expect(fs.existsSync(path.join(appDir, '.mercato', 'generated'))).toBe(false)\n\n      const sharedOutputs = listRelativeFiles(path.join(agenticRoot, 'shared')).map(mapSharedSourceToOutput)\n      const claudeOutputs = listRelativeFiles(path.join(agenticRoot, 'claude-code')).map(mapClaudeSourceToOutput)\n      const cursorOutputs = listRelativeFiles(path.join(agenticRoot, 'cursor')).map(mapCursorSourceToOutput)\n      const codexOutputs = listRelativeFiles(path.join(agenticRoot, 'codex'))\n        .map(mapCodexSourceToOutput)\n        .filter((relativePath): relativePath is string => relativePath !== null)\n\n      expect(sharedOutputs).toContain(standalonePlaywrightConfigPath)\n      assertPathsExist(appDir, [...sharedOutputs, ...claudeOutputs, ...cursorOutputs, ...codexOutputs])\n      expect(fs.existsSync(path.join(appDir, standalonePlaywrightConfigPath))).toBe(true)\n\n      const generatedGuideNames = listRelativeFiles(path.join(appDir, '.ai', 'guides'))\n      expect(generatedGuideNames).toEqual(expectedGuideOutputNames())\n\n      const agentsSource = fs.readFileSync(path.join(appDir, 'AGENTS.md'), 'utf8')\n      expect(agentsSource).toContain('<!-- CODEX_ENFORCEMENT_RULES_START -->')\n      expect(agentsSource).toContain('.ai/guides/upstream/BACKWARD_COMPATIBILITY.md')\n\n      // The Module-Specific Guides marker block is a compact enabled-module ID\n      // index (enabled \u2229 bundled) plus one progressively loaded path pattern.\n      for (const moduleId of FIXTURE_ENABLED_MODULES) {\n        expect(agentsSource).toContain(`\\`${moduleId}\\``)\n      }\n      expect(agentsSource).toContain('`.ai/guides/modules/<id>/index.md`')\n      expect(agentsSource.match(/\\.ai\\/guides\\/modules\\//g)).toHaveLength(1)\n      expect(agentsSource).not.toContain('`auth`')\n      expect(agentsSource).not.toContain('Core CRM capabilities')\n\n      const specsReadmeSource = fs.readFileSync(path.join(appDir, '.ai', 'specs', 'README.md'), 'utf8')\n      expect(specsReadmeSource).toContain('sample-store')\n\n      const cursorRulesSource = fs.readFileSync(path.join(appDir, '.cursor', 'rules', 'open-mercato.mdc'), 'utf8')\n      expect(cursorRulesSource).toContain('sample-store')\n\n      // om-spec-writing moved to the external open-mercato/skills collection\n      // (installed via `yarn install-skills`), so agentic:init must not ship a copy.\n      expect(fs.existsSync(path.join(appDir, '.ai', 'skills', 'om-spec-writing'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, 'scripts', 'install-skills.sh'))).toBe(true)\n\n      // install-skills.sh (run by agentic:init) installs every local tier skill once,\n      // into the canonical .agents/skills/. Codex and Cursor read that directory\n      // natively, so they get no skills directory of their own; Claude Code cannot,\n      // so it keeps a link layer pointing back at the canonical copy.\n      const tiersManifest = JSON.parse(\n        fs.readFileSync(path.join(agenticRoot, 'shared', 'ai', 'skills', 'tiers.json'), 'utf8'),\n      ) as { default: string[]; tiers: Record<string, { skills: string[] }> }\n      const defaultTierSkills = tiersManifest.default.flatMap((tierName) => tiersManifest.tiers[tierName].skills)\n      expect(defaultTierSkills.length).toBeGreaterThan(0)\n\n      for (const skillName of defaultTierSkills) {\n        const canonicalLinkPath = path.join(appDir, '.agents', 'skills', skillName)\n        expect(fs.lstatSync(canonicalLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(canonicalLinkPath))).toBe(`../../.ai/skills/${skillName}`)\n\n        const claudeLinkPath = path.join(appDir, '.claude', 'skills', skillName)\n        expect(fs.lstatSync(claudeLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(claudeLinkPath))).toBe(`../../.agents/skills/${skillName}`)\n      }\n\n      expect(fs.existsSync(path.join(appDir, '.codex', 'skills'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, '.cursor', 'skills'))).toBe(false)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n\n  test('emits a runnable exact-version framework context escape hatch for an installed package', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-framework-context-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const packageRoot = installFakeFrameworkPackage(appDir)\n      const resolvedPackageRoot = fs.realpathSync(packageRoot)\n      const packageBefore = snapshotTextFiles(packageRoot)\n\n      runMercato(['agentic:init', '--tool=codex'], appDir)\n      const generatedScript = path.join(appDir, 'scripts', 'framework-context.mjs')\n      expect(fs.existsSync(generatedScript)).toBe(true)\n\n      const output = runCommand(\n        process.execPath,\n        [generatedScript, '--module', 'customers', '--query', 'Person', '--json'],\n        appDir,\n        // The generated standalone helper must not depend on a globally\n        // installed ripgrep binary; process.execPath is already absolute.\n        { PATH: '', Path: '' },\n      )\n      const context = JSON.parse(output) as {\n        module: string\n        package: { name: string; version: string; root: string }\n        sourceKind: string\n        sourceRoot: string\n        materializedSource: string\n        instructions: Array<{ kind: string; path: string | null; materializedPath?: string }>\n        boundedSearch: { status: string; matches: number; maxMatches: number; result: string }\n        warnings: string[]\n      }\n\n      expect(context.module).toBe('customers')\n      expect(context.package).toEqual({ name: '@open-mercato/core', version: coreVersion, root: resolvedPackageRoot })\n      expect(context.sourceKind).toBe('source')\n      expect(normalizePath(context.sourceRoot)).toBe(normalizePath(path.join(resolvedPackageRoot, 'src', 'modules', 'customers')))\n      expect(context.instructions.filter((entry) => entry.path).map((entry) => entry.kind)).toEqual([\n        'standalone-root',\n        'upstream-bc',\n        'package',\n        'module-1',\n        'upstream-root',\n      ])\n      expect(context.instructions.filter((entry) => entry.path).every((entry) => entry.materializedPath)).toBe(true)\n      expect(context.boundedSearch).toMatchObject({ status: 'matched', matches: 1, maxMatches: 200 })\n      expect(fs.existsSync(path.join(appDir, context.materializedSource))).toBe(true)\n      expect(fs.existsSync(path.join(appDir, context.boundedSearch.result))).toBe(true)\n      expect(context.warnings.some((warning) => warning.includes('Generated facts for customers are stale'))).toBe(false)\n      expect(snapshotTextFiles(packageRoot)).toEqual(packageBefore)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n})\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/agentic-setup.js

@@ -63,7 +63,7 @@ function readEnabledModuleIds(modulesPath) {
   }
 }
 function selectModuleFactSheets(targetDir, modulesSubdir) {
-  const available = existsSync(modulesSubdir) ? readdirSync(modulesSubdir).filter((file) => file.endsWith(".md")).map((file) => file.replace(/\.md$/, "")) : [];
+  const available = existsSync(modulesSubdir) ? readdirSync(modulesSubdir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && existsSync(join(modulesSubdir, entry.name, "index.md"))).map((entry) => entry.name) : [];
   if (available.length === 0) return [];
   const parsed = readEnabledModuleIds(join(targetDir, "src", "modules.ts"));
   if (!parsed.parsed) return available;
@@ -80,7 +80,7 @@ function renderModuleGuidesBlock(selected, options = {}) {
   return [
     index,
     "",
-    "Load `.ai/guides/modules/<id>.md` only for a named or targeted installed module/host; never preload all module facts."
+    "Load `.ai/guides/modules/<id>/index.md` only for a targeted installed module/host; never preload all module facts."
   ].join("\n");
 }
 function injectModuleGuides(agentsMdPath, selected, options = {}) {
@@ -301,14 +301,21 @@ function finalizeHarnessManifest(config, selectedTools) {
     ...targetPathsForTree(join(srcDir, "scripts"), join(targetDir, "scripts"))
   ]);
   for (const file of readdirSync(GUIDES_DIR)) {
-    if (file.endsWith(".md") || file === "module-facts.json" || file === "module-facts.v2.json") {
+    if (file.endsWith(".md") || file === "module-facts.json" || file === "module-facts.v2.json" || file === "reference-module-facts.json") {
       paths.add(join(targetDir, ".ai", "guides", file));
     }
   }
   for (const file of listFiles(join(GUIDES_DIR, "upstream"))) {
     paths.add(join(targetDir, ".ai", "guides", "upstream", relative(join(GUIDES_DIR, "upstream"), file)));
   }
-  for (const moduleId of selectedModules) paths.add(join(targetDir, ".ai", "guides", "modules", `${moduleId}.md`));
+  for (const moduleId of selectedModules) {
+    const sourceRoot = join(GUIDES_DIR, "modules", moduleId);
+    const destinationRoot = join(targetDir, ".ai", "guides", "modules", moduleId);
+    for (const file of targetPathsForTree(sourceRoot, destinationRoot)) paths.add(file);
+  }
+  for (const file of listFiles(join(GUIDES_DIR, "reference-modules"))) {
+    paths.add(join(targetDir, ".ai", "guides", "reference-modules", relative(join(GUIDES_DIR, "reference-modules"), file)));
+  }
   if (selectedTools.includes("claude-code")) {
     paths.add(join(targetDir, "CLAUDE.md"));
     paths.add(join(targetDir, ".claude", "settings.json"));
@@ -403,6 +410,11 @@ function applyHarnessUpdate(targetDir, stagingDir, options = {}) {
     const destinationPath = resolveManifestPath(targetRoot, previousEntry.path);
     if (!destinationPath || !existsSync(destinationPath)) continue;
     assertManagedPath(targetRoot, destinationPath, { leaf: "file" });
+    const isRetiredFlatModuleFact = !previousEntry.userEditable && /^\.ai\/guides\/(?:modules|reference-modules)\/[^/]+\.md$/.test(previousEntry.path);
+    if (isRetiredFlatModuleFact) {
+      rmSync(destinationPath, { force: true });
+      continue;
+    }
     let unchanged = false;
     try {
       unchanged = hashFile(destinationPath) === previousEntry.sha256;
@@ -453,12 +465,17 @@ function generateShared(config) {
       ensureDir(destPath);
       copyFileSync(moduleFactsV2Path, destPath);
     }
+    const referenceFactsPath = join(GUIDES_DIR, "reference-module-facts.json");
+    if (existsSync(referenceFactsPath)) {
+      const destPath = join(guidesDestDir, "reference-module-facts.json");
+      ensureDir(destPath);
+      copyFileSync(referenceFactsPath, destPath);
+    }
     copyTree(join(GUIDES_DIR, "upstream"), join(guidesDestDir, "upstream"), config);
+    copyTree(join(GUIDES_DIR, "reference-modules"), join(guidesDestDir, "reference-modules"), config);
     const modulesSubdir = join(GUIDES_DIR, "modules");
     for (const moduleId of selectedModules) {
-      const destPath = join(guidesDestDir, "modules", `${moduleId}.md`);
-      ensureDir(destPath);
-      copyFileSync(join(modulesSubdir, `${moduleId}.md`), destPath);
+      copyTree(join(modulesSubdir, moduleId), join(guidesDestDir, "modules", moduleId), config);
     }
   }
   injectModuleGuides(join(targetDir, "AGENTS.md"), selectedModules);