@open-mercato/cli 0.6.8-develop.7100.1.fbf66fca35 → 0.7.0

package/src/lib/testing/integration.ts

@@ -1,5 +1,4 @@
 import type { ChildProcess, StdioOptions } from 'node:child_process'
-import { spawnSync } from 'node:child_process'
 import { createServer } from 'node:net'
 import { existsSync, readFileSync } from 'node:fs'
 import { mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises'
@@ -763,56 +762,23 @@ function runNpxCommand(args: string[], environment: NodeJS.ProcessEnv): Promise<
   })
 }
 
-export type CapturedOutputProcess = ChildProcess & {
-  readCapturedOutput?: () => string
-}
-
-export const CAPTURED_OUTPUT_MAX_LENGTH = 64 * 1024
-
-export function createBoundedOutputBuffer(): { append: (chunk: Buffer | string) => void; read: () => string } {
-  let buffered = ''
-  return {
-    append: (chunk: Buffer | string) => {
-      buffered += chunk.toString()
-      if (buffered.length > CAPTURED_OUTPUT_MAX_LENGTH) {
-        buffered = `…(truncated)…${buffered.slice(-CAPTURED_OUTPUT_MAX_LENGTH)}`
-      }
-    },
-    read: () => buffered,
-  }
-}
-
-// Both streams are returned when both carry output: a single stderr deprecation notice must not
-// hide the stdout tail that usually holds the real startup failure. The 20-line tail in
-// `exitError()` does the trimming.
-export function formatCapturedOutput(stderrText: string, stdoutText: string): string {
-  if (stderrText && stdoutText) {
-    return `--- stderr ---\n${stderrText}\n--- stdout ---\n${stdoutText}`
-  }
-  return stderrText || stdoutText
-}
-
 function startYarnRawCommand(
   commandArgs: string[],
   environment: NodeJS.ProcessEnv,
-  opts: { silent?: boolean; detached?: boolean } = {},
+  opts: { silent?: boolean } = {},
   cwd: string = projectRootDirectory,
-): CapturedOutputProcess {
+): ChildProcess {
   const outputMode: StdioOptions = opts.silent ? ['ignore', 'pipe', 'pipe'] : 'inherit'
-  const resolvedSpawn = resolveSpawnCommand(resolveYarnBinary(), commandArgs, { detached: opts.detached })
-  const processHandle: CapturedOutputProcess = spawn(resolvedSpawn.command, resolvedSpawn.args, {
+  const resolvedSpawn = resolveSpawnCommand(resolveYarnBinary(), commandArgs)
+  const processHandle: ChildProcess = spawn(resolvedSpawn.command, resolvedSpawn.args, {
     cwd,
     env: environment,
     stdio: outputMode,
     ...resolvedSpawn.spawnOptions,
   })
   if (opts.silent) {
-    const stdoutBuffer = createBoundedOutputBuffer()
-    const stderrBuffer = createBoundedOutputBuffer()
-    processHandle.stdout?.on('data', (chunk: Buffer | string) => stdoutBuffer.append(chunk))
-    processHandle.stderr?.on('data', (chunk: Buffer | string) => stderrBuffer.append(chunk))
-    processHandle.readCapturedOutput = () =>
-      formatCapturedOutput(stderrBuffer.read().trim(), stdoutBuffer.read().trim())
+    processHandle.stdout?.on('data', () => {})
+    processHandle.stderr?.on('data', () => {})
   }
   return processHandle
 }
@@ -820,9 +786,9 @@ function startYarnRawCommand(
 function startYarnCommand(
   args: string[],
   environment: NodeJS.ProcessEnv,
-  opts: { silent?: boolean; detached?: boolean } = {},
+  opts: { silent?: boolean } = {},
   cwd: string = projectRootDirectory,
-): CapturedOutputProcess {
+): ChildProcess {
   return startYarnRawCommand(['run', ...args], environment, opts, cwd)
 }
 
@@ -1802,172 +1768,6 @@ function isProcessRunning(processId: number): boolean {
   }
 }
 
-export type ProcessTreeKillDependencies = {
-  platform?: NodeJS.Platform
-  killPosixProcessGroup?: (pid: number, signal: NodeJS.Signals) => void
-  killWindowsProcessTree?: (pid: number, options: { forced: boolean }) => void
-  gracePeriodMs?: number
-}
-
-function defaultKillPosixProcessGroup(pid: number, signal: NodeJS.Signals): void {
-  process.kill(-pid, signal)
-}
-
-// `/f` is added only on escalation so the Windows path mirrors the POSIX SIGTERM → grace → SIGKILL
-// sequence: the first attempt lets the tree shut down cleanly, the second forces it.
-function defaultKillWindowsProcessTree(pid: number, options: { forced: boolean }): void {
-  spawnSync('taskkill', ['/pid', String(pid), '/t', ...(options.forced ? ['/f'] : [])])
-}
-
-export function killProcessTree(
-  pid: number,
-  signal: NodeJS.Signals,
-  dependencies: ProcessTreeKillDependencies = {},
-): void {
-  const platform = dependencies.platform ?? process.platform
-  if (platform === 'win32') {
-    const killWindowsProcessTree = dependencies.killWindowsProcessTree ?? defaultKillWindowsProcessTree
-    killWindowsProcessTree(pid, { forced: signal === 'SIGKILL' })
-    return
-  }
-  const killPosixProcessGroup = dependencies.killPosixProcessGroup ?? defaultKillPosixProcessGroup
-  killPosixProcessGroup(pid, signal)
-}
-
-const PROCESS_TREE_KILL_GRACE_PERIOD_MS = 3_000
-
-function killProcessTreeIfRunning(
-  pid: number,
-  signal: NodeJS.Signals,
-  dependencies: ProcessTreeKillDependencies,
-): void {
-  try {
-    killProcessTree(pid, signal, dependencies)
-  } catch (error) {
-    if ((error as NodeJS.ErrnoException).code !== 'ESRCH') {
-      throw error
-    }
-  }
-}
-
-// `getProcessExitPromise` only observes *future* events, so a process that already exited would
-// never settle it and the caller would stall for the whole grace period. This waiter detaches both
-// listeners and clears the timer whichever way it settles, so nothing is left pending and a late
-// `'error'` cannot surface as an unhandled rejection.
-function waitForProcessExitWithin(childProcess: ChildProcess, timeoutMs: number): Promise<boolean> {
-  return new Promise((resolve) => {
-    const settle = (exited: boolean) => {
-      clearTimeout(gracePeriodTimer)
-      childProcess.off('exit', onExit)
-      childProcess.off('error', onError)
-      resolve(exited)
-    }
-    const onExit = () => settle(true)
-    const onError = () => settle(false)
-    const gracePeriodTimer = setTimeout(() => settle(false), timeoutMs)
-    childProcess.on('exit', onExit)
-    childProcess.on('error', onError)
-  })
-}
-
-// A `ChildProcess` reports `null` on both fields while it is alive, so a non-null value means the
-// exit has already happened and its `'exit'` event will never fire again.
-function hasProcessAlreadyExited(childProcess: ChildProcess): boolean {
-  return (childProcess.exitCode ?? null) !== null || (childProcess.signalCode ?? null) !== null
-}
-
-export async function terminateProcessTree(
-  childProcess: CapturedOutputProcess,
-  dependencies: ProcessTreeKillDependencies = {},
-): Promise<void> {
-  const pid = childProcess.pid
-  if (!pid) return
-  // A reaped leader answers only "waiting for its `'exit'` event can never settle" — without this the
-  // crash path would stall the whole teardown for the grace period waiting for an event that already
-  // fired. It does *not* mean the process group is empty: on the readiness-failure path the `yarn`
-  // wrapper exits non-zero while the `mercato start`/Next/worker descendants it spawned stay in its
-  // group, so the group still has to be signalled or #5333's orphan survives verbatim. POSIX keeps
-  // the group id reserved while any member holds it, so signalling it after the leader is reaped is
-  // both safe and effective. Skip the wait, never the signal — and go straight to SIGKILL, since
-  // there is no leader left to coordinate a graceful shutdown or to report the exit we would await.
-  if (hasProcessAlreadyExited(childProcess)) {
-    killProcessTreeIfRunning(pid, 'SIGKILL', dependencies)
-    return
-  }
-
-  killProcessTreeIfRunning(pid, 'SIGTERM', dependencies)
-
-  const gracePeriodMs = dependencies.gracePeriodMs ?? PROCESS_TREE_KILL_GRACE_PERIOD_MS
-  const exitedBeforeGracePeriod = await waitForProcessExitWithin(childProcess, gracePeriodMs)
-
-  if (!exitedBeforeGracePeriod && isProcessRunning(pid)) {
-    killProcessTreeIfRunning(pid, 'SIGKILL', dependencies)
-  }
-}
-
-const EPHEMERAL_SHUTDOWN_SIGNALS: NodeJS.Signals[] = ['SIGINT', 'SIGTERM']
-
-export type ShutdownProcessRef = Pick<NodeJS.Process, 'once' | 'off' | 'removeAllListeners' | 'kill' | 'pid'>
-
-export type EphemeralShutdownHandlers = { dispose: () => void }
-
-// The application is spawned `detached: true`, which puts its whole tree in a new session. A
-// terminal Ctrl+C only reaches the foreground process group of the controlling terminal, so the
-// tree never sees the signal and would outlive the run holding `server-start.lock` — exactly the
-// orphan this harness exists to prevent. Node also skips `'exit'` listeners when it dies from a
-// signal, so the crash sweep cannot cover this path either. The runner therefore forwards the
-// interrupt itself: stop the environment, then re-raise the signal so the process still exits with
-// the conventional 130/143 instead of a synthetic success.
-export function registerEphemeralShutdownHandlers(options: {
-  stop: () => Promise<void>
-  killApplicationTree: () => void
-  onSignal?: (signal: NodeJS.Signals) => void
-  processRef?: ShutdownProcessRef
-}): EphemeralShutdownHandlers {
-  const processRef = options.processRef ?? process
-  const onProcessExit = () => options.killApplicationTree()
-  const signalHandlers = new Map<NodeJS.Signals, () => void>()
-
-  // Registered per `startEphemeralEnvironment()` call, and the environment is restarted on retry,
-  // so the handlers must come back off in `stop()` or a retried run stacks dead closures until it
-  // trips MaxListenersExceededWarning.
-  const dispose = () => {
-    processRef.off('exit', onProcessExit)
-    for (const [signal, handler] of signalHandlers) {
-      processRef.off(signal, handler)
-    }
-    signalHandlers.clear()
-  }
-
-  for (const signal of EPHEMERAL_SHUTDOWN_SIGNALS) {
-    const handler = () => {
-      void (async () => {
-        options.onSignal?.(signal)
-        try {
-          await options.stop()
-        } catch (error) {
-          // A teardown failure must not become an unhandled rejection, and must not swallow the
-          // signal: report it and still re-raise so the runner exits the way the shell expects.
-          console.error(`Failed to stop the ephemeral environment on ${signal}:`, error)
-        } finally {
-          dispose()
-          // Load-bearing, not cleanup: `dispose()` already detached this module's `once` handler, so
-          // the only listeners left belong to somebody else (testcontainers, Playwright, a host CLI).
-          // Any survivor would swallow the re-raised signal and turn the interrupt back into the
-          // synthetic success this whole path exists to avoid, so they come off before the re-raise.
-          processRef.removeAllListeners(signal)
-          processRef.kill(processRef.pid as number, signal)
-        }
-      })()
-    }
-    signalHandlers.set(signal, handler)
-    processRef.once(signal, handler)
-  }
-
-  processRef.once('exit', onProcessExit)
-  return { dispose }
-}
-
 async function getPathAgeMilliseconds(targetPath: string): Promise<number | null> {
   try {
     const stats = await stat(targetPath)
@@ -2294,7 +2094,7 @@ export async function tryReuseExistingEnvironment(options: EphemeralRuntimeOptio
 
 export async function waitForApplicationReadiness(
   baseUrl: string,
-  appProcess: CapturedOutputProcess,
+  appProcess: ChildProcess,
   options: { timeoutMs: number; intervalMs?: number; stabilizationMs?: number },
 ): Promise<void> {
   const startTimestamp = Date.now()
@@ -2315,15 +2115,8 @@ export async function waitForApplicationReadiness(
       return { exited: true as const }
     },
   )
-  const exitError = () => {
-    const capturedOutput = appProcess.readCapturedOutput?.().trim()
-    const capturedOutputTail = capturedOutput
-      ? `\nCaptured output:\n${capturedOutput.split('\n').slice(-20).join('\n')}`
-      : ''
-    return new Error(
-      `Application process exited before readiness check (exit ${exitCode ?? 'unknown'})${capturedOutputTail}`,
-    )
-  }
+  const exitError = () =>
+    new Error(`Application process exited before readiness check (exit ${exitCode ?? 'unknown'})`)
 
   while (Date.now() - startTimestamp < options.timeoutMs) {
     // Run one probe cycle to completion before starting the next. Overlapping cycles (the previous
@@ -3627,45 +3420,21 @@ export async function startEphemeralEnvironment(options: EphemeralRuntimeOptions
     })
 
     const runtimeLock = await acquireEphemeralRuntimeLock(options.logPrefix)
-    let applicationProcess: CapturedOutputProcess | null = null
+    let applicationProcess: ChildProcess | null = null
     let isStopped = false
-    let shutdownHandlers: EphemeralShutdownHandlers | null = null
     const stop = async (): Promise<void> => {
       if (isStopped) return
       isStopped = true
       try {
         if (applicationProcess && !applicationProcess.killed) {
-          try {
-            await terminateProcessTree(applicationProcess)
-          } catch (error) {
-            // `killProcessTreeIfRunning` rethrows anything that is not `ESRCH`, and this call sits
-            // ahead of the container and state cleanup. A kill that fails must not strand the
-            // Postgres container and the state file too — report it and finish tearing down.
-            console.error(`[${options.logPrefix}] Failed to terminate the application process tree:`, error)
-          }
+          applicationProcess.kill('SIGTERM')
         }
         await databaseContainer.stop()
         await clearEphemeralEnvironmentState()
       } finally {
         await runtimeLock.release()
-        shutdownHandlers?.dispose()
-      }
-    }
-    shutdownHandlers = registerEphemeralShutdownHandlers({
-      stop,
-      onSignal: (signal) =>
-        console.log(`[${options.logPrefix}] Received ${signal}, stopping ephemeral environment...`),
-      // Deliberately not guarded on `isStopped`: `startEphemeralEnvironment`'s own catch already ran
-      // `stop()` before rethrowing, so the guard made the sweep dead on exactly the paths that need
-      // it. After a successful `stop()` the extra group kill is a harmless `ESRCH` this swallows.
-      killApplicationTree: () => {
-        const pid = applicationProcess?.pid
-        if (!pid) return
-        try {
-          killProcessTree(pid, 'SIGKILL')
-        } catch {}
-      },
-    })
+      }
+    }
 
     try {
       const appReadyTimeoutMs = resolveAppReadyTimeoutMs(options.logPrefix)
@@ -3752,7 +3521,6 @@ export async function startEphemeralEnvironment(options: EphemeralRuntimeOptions
       console.log(`[${options.logPrefix}] Starting application on ${applicationBaseUrl}...`)
       const startedAppProcess = startYarnCommand(['start'], commandEnvironment, {
         silent: !options.verbose,
-        detached: true,
       }, appDirectory)
       applicationProcess = startedAppProcess
 
@@ -3791,11 +3559,15 @@ export async function startEphemeralEnvironment(options: EphemeralRuntimeOptions
   }
 }
 
-// Interrupt handling belongs to `startEphemeralEnvironment`, which owns the detached tree and now
-// registers SIGINT/SIGTERM handlers for every run — not just the `--keep` ones. Registering a
-// second pair here would race them: both fire on the same signal, and this one's `process.exit()`
-// would cut the environment's teardown short mid-await.
-async function keepEnvironmentRunningForever(): Promise<void> {
+async function keepEnvironmentRunningForever(options: { logPrefix: string; stop: () => Promise<void> }): Promise<void> {
+  const onSignal = async (signal: string): Promise<void> => {
+    console.log(`[${options.logPrefix}] Received ${signal}, stopping ephemeral environment...`)
+    await options.stop()
+    process.exit(0)
+  }
+
+  process.once('SIGINT', () => void onSignal('SIGINT'))
+  process.once('SIGTERM', () => void onSignal('SIGTERM'))
   await new Promise<void>(() => {})
 }
 
@@ -3845,7 +3617,10 @@ export async function runIntegrationTestsInEphemeralEnvironment(rawArgs: string[
 
     if (options.keep) {
       console.log('[integration] --keep enabled: leaving app and database running. Press Ctrl+C to stop.')
-      await keepEnvironmentRunningForever()
+      await keepEnvironmentRunningForever({
+        logPrefix: 'integration',
+        stop: environment.stop,
+      })
     }
   } finally {
     if (!options.keep) {
@@ -3873,7 +3648,10 @@ export async function runEphemeralAppForQa(rawArgs: string[]): Promise<void> {
     console.log('[ephemeral] Reused existing environment. Press Ctrl+C to exit without stopping the shared runtime.')
   }
 
-  await keepEnvironmentRunningForever()
+  await keepEnvironmentRunningForever({
+    logPrefix: 'ephemeral',
+    stop: environment.stop,
+  })
 }
 
 export async function runInteractiveIntegrationInEphemeralEnvironment(rawArgs: string[]): Promise<void> {

package/src/mercato.ts

@@ -78,29 +78,6 @@ function getRegisteredCliWorkers(modules: Module[] = getCliModules()): ModuleWor
   return allWorkers
 }
 
-/**
- * Picks the abandoned-job callback for a queue from its workers.
- *
- * The numeric queue options merge across a queue's workers with `Math.max`; two callbacks cannot
- * merge, so the first declared one wins. Silence there would make a genuine wiring mistake — two
- * handlers on one queue each expecting to report its abandoned jobs — look like it works while one of
- * them never runs.
- */
-export function resolveQueueAbandonHook(
-  queueName: string,
-  queueWorkers: Array<Pick<ModuleWorker, 'id' | 'onJobAbandoned'>>,
-  warn: (message: string) => void = console.warn,
-): ModuleWorker['onJobAbandoned'] {
-  const declaring = queueWorkers.filter((worker) => worker.onJobAbandoned)
-  if (declaring.length > 1) {
-    warn(
-      `[worker] Queue "${queueName}" has ${declaring.length} workers declaring onJobAbandoned `
-      + `(${declaring.map((worker) => worker.id).join(', ')}); using the first and ignoring the rest.`,
-    )
-  }
-  return declaring[0]?.onJobAbandoned
-}
-
 function shouldEmbedLocalSchedulerInSharedWorker(env: NodeJS.ProcessEnv = process.env): boolean {
   return parseBooleanToken(env.OM_DEV_EMBED_SCHEDULER_IN_SHARED_WORKER) === true
 }
@@ -1701,7 +1678,6 @@ export async function run(argv = process.argv) {
                 Math.max(...queueWorkers.map((w) => w.concurrency), 1)
               const maxStalledCount = Math.max(...queueWorkers.map((w) => w.maxStalledCount ?? 1), 1)
               const lockDuration = Math.max(...queueWorkers.map((w) => w.lockDuration ?? 0), 0) || undefined
-              const onJobAbandoned = resolveQueueAbandonHook(queue, queueWorkers)
 
               console.log(`[worker] Starting "${queue}" with ${queueWorkers.length} handler(s), concurrency: ${concurrency}`)
 
@@ -1712,7 +1688,6 @@ export async function run(argv = process.argv) {
                 concurrency,
                 lockDuration,
                 maxStalledCount,
-                onJobAbandoned,
                 background: true,
                 handler: createPerJobWorkerHandler(queueWorkers, createRequestContainer),
               })
@@ -1758,7 +1733,6 @@ export async function run(argv = process.argv) {
               const concurrency = budgetPlan.entries[0]?.effective ?? requested
               const maxStalledCount = Math.max(...queueWorkers.map((w) => w.maxStalledCount ?? 1), 1)
               const lockDuration = Math.max(...queueWorkers.map((w) => w.lockDuration ?? 0), 0) || undefined
-              const onJobAbandoned = resolveQueueAbandonHook(queueName!, queueWorkers)
 
               console.log(`[worker] Found ${queueWorkers.length} worker(s) for queue "${queueName}"`)
 
@@ -1769,7 +1743,6 @@ export async function run(argv = process.argv) {
                 concurrency,
                 lockDuration,
                 maxStalledCount,
-                onJobAbandoned,
                 handler: createPerJobWorkerHandler(queueWorkers, createRequestContainer),
               })
             } else {

package/dist/agentic/guides/modules/api_keys/di-registrations-rich.md

@@ -1,11 +0,0 @@
-# api_keys — DI registrations (rich)
-
-[Back to module index](index.md)
-
-## DI registrations (rich)
-
-| Token | Kind | Lifetime | Injection | Provider | Source |
-|---|---|---|---|---|---|
-| apiKeyPrincipalService | class | scoped | — | DefaultApiKeyPrincipalService | [di.ts:6](../../../../node_modules/@open-mercato/core/src/modules/api_keys/di.ts#L6) |
-
-<!-- end module facts section: api_keys/di-registrations-rich -->

package/dist/agentic/guides/modules/api_keys/di-service-tokens.md

@@ -1,11 +0,0 @@
-# api_keys — DI service tokens
-
-[Back to module index](index.md)
-
-## DI service tokens
-
-| Token | Source |
-|---|---|
-| apiKeyPrincipalService | [di.ts:6](../../../../node_modules/@open-mercato/core/src/modules/api_keys/di.ts#L6) |
-
-<!-- end module facts section: api_keys/di-service-tokens -->

package/dist/agentic/guides/modules/channel_discord/acl-features.md

@@ -1,13 +0,0 @@
-# channel_discord — ACL features
-
-[Back to module index](index.md)
-
-## ACL features  (3)
-
-| Feature | Source |
-|---|---|
-| channel_discord.view | [acl.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/acl.ts) |
-| channel_discord.configure | [acl.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/acl.ts) |
-| channel_discord.ai_auto_reply.run | [acl.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/acl.ts) |
-
-<!-- end module facts section: channel_discord/acl-features -->

package/dist/agentic/guides/modules/channel_discord/ai-agents.md

@@ -1,11 +0,0 @@
-# channel_discord — AI agents
-
-[Back to module index](index.md)
-
-## AI agents
-
-| ID / path | Source |
-|---|---|
-| channel_discord.auto_reply | [ai-agents.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/ai-agents.ts) |
-
-<!-- end module facts section: channel_discord/ai-agents -->

package/dist/agentic/guides/modules/channel_discord/backend-pages.md

@@ -1,11 +0,0 @@
-# channel_discord — Backend pages
-
-[Back to module index](index.md)
-
-## Backend pages
-
-| ID / path | Source |
-|---|---|
-| /backend/channel_discord/channels/[id]/ai-auto-reply | [backend/channel_discord/channels/[id]/ai-auto-reply/page.tsx](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/backend/channel_discord/channels/[id]/ai-auto-reply/page.tsx) |
-
-<!-- end module facts section: channel_discord/backend-pages -->

package/dist/agentic/guides/modules/channel_discord/cli-commands.md

@@ -1,13 +0,0 @@
-# channel_discord — CLI commands
-
-[Back to module index](index.md)
-
-## CLI commands
-
-| ID / path | Source |
-|---|---|
-| start-gateway | [cli.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/cli.ts) |
-| configure-from-env | [cli.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/cli.ts) |
-| register-slash-commands | [cli.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/cli.ts) |
-
-<!-- end module facts section: channel_discord/cli-commands -->

package/dist/agentic/guides/modules/channel_discord/contribution-resolutions.md

@@ -1,14 +0,0 @@
-# channel_discord — Contribution resolutions
-
-[Back to module index](index.md)
-
-## Contribution resolutions
-
-| Contribution | Target | Resolution | Activations | Source |
-|---|---|---|---|---|
-| ai:channel_discord.auto_reply | module:channel_discord.auto_reply | capability-only | — | [ai-agents.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/ai-agents.ts) |
-| channel_discord:ai-auto-reply | event:communication_channels.message.received @communication_channels | capability-only | — | [subscribers/ai-auto-reply.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/subscribers/ai-auto-reply.ts) |
-| channel_discord.injection.connect@profile:communication-channels:connect | widget-spot:profile:communication-channels:connect @communication_channels | bound | widget-spot:profile:communication-channels:connect:widget-injection-consumer | [widgets/injection-table.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/widgets/injection-table.ts) |
-| integration:channel_discord | module:channel_discord | capability-only | — | [integration.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/integration.ts) |
-
-<!-- end module facts section: channel_discord/contribution-resolutions -->

package/dist/agentic/guides/modules/channel_discord/di-registrations-rich.md

@@ -1,12 +0,0 @@
-# channel_discord — DI registrations (rich)
-
-[Back to module index](index.md)
-
-## DI registrations (rich)
-
-| Token | Kind | Lifetime | Injection | Provider | Source |
-|---|---|---|---|---|---|
-| channelDiscordAdapter | value | — | — | — | [di.ts:20](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/di.ts#L20) |
-| channelDiscordHealthCheck | value | — | — | — | [di.ts:24](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/di.ts#L24) |
-
-<!-- end module facts section: channel_discord/di-registrations-rich -->

package/dist/agentic/guides/modules/channel_discord/exact-override-targets.md

@@ -1,26 +0,0 @@
-# channel_discord — Exact override targets
-
-[Back to module index](index.md)
-
-## Exact override targets
-
-| Domain | Path / key | Supported modes | Referenced fact | Source |
-|---|---|---|---|---|
-| acl | `overrides.acl.features["channel_discord.ai_auto_reply.run"]` | disable-replace | aclFeatures:channel_discord.ai_auto_reply.run | [acl.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/acl.ts) |
-| acl | `overrides.acl.features["channel_discord.configure"]` | disable-replace | aclFeatures:channel_discord.configure | [acl.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/acl.ts) |
-| acl | `overrides.acl.features["channel_discord.view"]` | disable-replace | aclFeatures:channel_discord.view | [acl.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/acl.ts) |
-| ai | `overrides.ai.agents["channel_discord.auto_reply"]` | disable-replace | aiAgents:channel_discord.auto_reply | [ai-agents.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/ai-agents.ts) |
-| cli | `overrides.cli["configure-from-env"]` | disable-replace | cliCommands:configure-from-env | [cli.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/cli.ts) |
-| cli | `overrides.cli["register-slash-commands"]` | disable-replace | cliCommands:register-slash-commands | [cli.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/cli.ts) |
-| cli | `overrides.cli["start-gateway"]` | disable-replace | cliCommands:start-gateway | [cli.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/cli.ts) |
-| di | `overrides.di["channelDiscordAdapter"]` | disable-replace | ownedContracts.di-registration:channelDiscordAdapter | [di.ts:20](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/di.ts#L20) |
-| di | `overrides.di["channelDiscordHealthCheck"]` | disable-replace | ownedContracts.di-registration:channelDiscordHealthCheck | [di.ts:24](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/di.ts#L24) |
-| events | `overrides.events.subscribers["channel_discord:ai-auto-reply"]` | disable-replace | extensionSurfaces.contributions:channel_discord:ai-auto-reply | [subscribers/ai-auto-reply.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/subscribers/ai-auto-reply.ts) |
-| routes | `overrides.routes.pages["backend:/backend/channel_discord/channels/[id]/ai-auto-reply"]` | disable-replace | backendPages:/backend/channel_discord/channels/[id]/ai-auto-reply | [backend/channel_discord/channels/[id]/ai-auto-reply/page.tsx](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/backend/channel_discord/channels/[id]/ai-auto-reply/page.tsx) |
-| setup | `overrides.setup.defaultRoleFeatures` | replace | ownedContracts.setup:channel_discord:setup | [setup.ts:33](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/setup.ts#L33) |
-| setup | `overrides.setup.onTenantCreated` | replace | ownedContracts.setup:channel_discord:setup | [setup.ts:33](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/setup.ts#L33) |
-| widgets | `overrides.widgets.injection["channel_discord.injection.connect"]` | disable-replace | extensionSurfaces.contributions:channel_discord.injection.connect@profile:communication-channels:connect | [widgets/injection-table.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/widgets/injection-table.ts) |
-| workers | `overrides.workers["channel_discord:gateway"]` | disable-replace | ownedContracts.worker:channel_discord:gateway | [workers/discord-gateway.ts:50](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/workers/discord-gateway.ts#L50) |
-| workers | `overrides.workers["channel_discord:interactions"]` | disable-replace | ownedContracts.worker:channel_discord:interactions | [workers/discord-interactions.ts:39](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/workers/discord-interactions.ts#L39) |
-
-<!-- end module facts section: channel_discord/exact-override-targets -->

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

@@ -1,22 +0,0 @@
-# channel_discord — module facts (generated, do not edit)
-<!-- generated from @open-mercato/channel-discord 0.6.8-develop.7100.1.fbf66fca35; core 0.6.8-develop.7100.1.fbf66fca35 — R1 staleness stamp -->
-Source root: node_modules/@open-mercato/channel-discord/src/modules/channel_discord
-
-## Sections
-
-- [ACL features](acl-features.md) — ~1 KB — Generated acl features facts for channel_discord.
-- [Backend pages](backend-pages.md) — ~1 KB — Generated backend pages facts for channel_discord.
-- [UMES contributions](umes-contributions.md) — ~2 KB — Generated umes contributions facts for channel_discord.
-- [Contribution resolutions](contribution-resolutions.md) — ~2 KB — Generated contribution resolutions facts for channel_discord.
-- [CLI commands](cli-commands.md) — ~1 KB — Generated cli commands facts for channel_discord.
-- [AI agents](ai-agents.md) — ~1 KB — Generated ai agents facts for channel_discord.
-- [Exact override targets](exact-override-targets.md) — ~5 KB — Generated exact override targets facts for channel_discord.
-- [Owned contract — module metadata](owned-contract-module-metadata.md) — ~1 KB — Generated owned contract — module metadata facts for channel_discord.
-- [Workers](workers.md) — ~1 KB — Generated workers facts for channel_discord.
-- [Setup](setup.md) — ~1 KB — Generated setup facts for channel_discord.
-- [DI registrations (rich)](di-registrations-rich.md) — ~1 KB — Generated di registrations (rich) facts for channel_discord.
-
-Read only the section files needed for the task; every section ends with a completion marker.
-A section absent from this list has no facts for channel_discord; this index is complete only when the read reaches the marker below.
-
-<!-- end module facts: channel_discord — 11 sections -->

package/dist/agentic/guides/modules/channel_discord/owned-contract-module-metadata.md

@@ -1,11 +0,0 @@
-# channel_discord — Owned contract — module metadata
-
-[Back to module index](index.md)
-
-## Owned contract — module metadata
-
-| ID | Metadata | Source |
-|---|---|---|
-| channel_discord | — | [index.ts:1](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/index.ts#L1) |
-
-<!-- end module facts section: channel_discord/owned-contract-module-metadata -->

package/dist/agentic/guides/modules/channel_discord/setup.md

@@ -1,11 +0,0 @@
-# channel_discord — Setup
-
-[Back to module index](index.md)
-
-## Setup
-
-| ID | Metadata | Source |
-|---|---|---|
-| channel_discord:setup | hooks=onTenantCreated; roles=admin, superadmin | [setup.ts:33](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/setup.ts#L33) |
-
-<!-- end module facts section: channel_discord/setup -->

package/dist/agentic/guides/modules/channel_discord/umes-contributions.md

@@ -1,14 +0,0 @@
-# channel_discord — UMES contributions
-
-[Back to module index](index.md)
-
-## UMES contributions
-
-| ID | Kind | Target | Phase / operations | Contract | Resolution | Source |
-|---|---|---|---|---|---|---|
-| ai:channel_discord.auto_reply | specialized-registry | channel_discord.auto_reply | — | registry=ai; registryId=channel_discord.auto_reply; specialistRoute=aiAgents | fact-ref | [ai-agents.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/ai-agents.ts) |
-| integration:channel_discord | specialized-registry | channel_discord | — | registry=integration; registryId=channel_discord; specialistRoute=integrations | fact-ref | [integration.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/integration.ts) |
-| channel_discord:ai-auto-reply | subscriber | communication_channels.message.received | async-delivery | event=communication_channels.message.received; persistent=true; subscriberId=channel_discord:ai-auto-reply; sync=false | fact-ref | [subscribers/ai-auto-reply.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/subscribers/ai-auto-reply.ts) |
-| channel_discord.injection.connect@profile:communication-channels:connect | widget | profile:communication-channels:connect | — | executionGuard=host; payload=render; registryKey=channel_discord.injection.connect | exact | [widgets/injection-table.ts](../../../../node_modules/@open-mercato/channel-discord/src/modules/channel_discord/widgets/injection-table.ts) |
-
-<!-- end module facts section: channel_discord/umes-contributions -->