@namzu/cli 35.0.0 → 36.1.0

package/assets/pal-godot-mcp.cjs

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+'use strict'
+
+// Adapt the reviewed NPGameDev 1.0.3 bridge without authoring project/game code.
+// The editor is a separate process: an MCP error does not prove it stopped.
+const { AsyncLocalStorage } = require('node:async_hooks')
+const { createHash } = require('node:crypto')
+const fs = require('node:fs')
+const { createRequire, registerHooks } = require('node:module')
+const path = require('node:path')
+const { pathToFileURL } = require('node:url')
+
+const PIN = require('./pal-godot-mcp-pin.json')
+const SEAL = '.namzu-build-integrity.json'
+const OUTCOME = 'namzu/outcome'
+const own = (value, key) => Object.prototype.hasOwnProperty.call(value, key)
+const digest = (bytes) => createHash('sha256').update(bytes).digest('hex')
+const dictionary = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)
+
+// The pinned runtime casts dictionary values directly with bool/int/float.
+// Unlike a conditional, bool("false") is not a valid Godot constructor call:
+// it aborts the coroutine after earlier events may already have been injected.
+// Inspect the WHOLE batch before calling upstream, without changing its values
+// or closing arbitrary event_data dictionaries in the generic SDK.
+function validateInputSimulation(input, wire = false) {
+  if (!dictionary(input)) throw new Error('Godot input_simulate arguments must be an object. No input was dispatched.')
+  let events = input.events
+  // Upstream's top-level addStringCoercion accepts JSON-encoded events. Parse
+  // only for inspection; the original handler still receives the original args.
+  if (!wire && typeof events === 'string') {
+    try { events = JSON.parse(events) } catch { /* Original schema reports invalid JSON. */ }
+  }
+  const batch = Array.isArray(events) ? events : [events]
+  if (wire && !Array.isArray(events)) throw new Error('Godot input_simulate normalized events must be an array. No input was dispatched.')
+  if (!batch.length) throw new Error('Godot input_simulate events must not be empty. No input was dispatched.')
+  const constructorValue = (data, field, kind, prefix) => {
+    if (!own(data, field)) return
+    const value = data[field]
+    const valid = typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value)) || (kind !== 'bool' && typeof value === 'string')
+    if (valid) return
+    const expected = kind === 'bool'
+      ? 'a JSON boolean true/false (or a finite number accepted by Godot)'
+      : 'a number (or a boolean/string accepted by Godot)'
+    const received = value === null ? 'null' : Array.isArray(value) ? 'array' : typeof value
+    throw new Error(`Godot input_simulate ${prefix}.${field} must be ${expected}; received ${received}. No input was dispatched. Correct this field or omit it to use its default, then send a new call.`)
+  }
+  const point = (data, prefix) => {
+    if (!dictionary(data)) return
+    constructorValue(data, 'x', 'float', prefix)
+    constructorValue(data, 'y', 'float', prefix)
+  }
+  const position = (data, prefix) => {
+    if (data.position == null && own(data, 'x')) point(data, prefix)
+    else point(data.position, `${prefix}.position`)
+  }
+  if (wire) constructorValue(input, 'summary', 'bool', 'arguments')
+  for (let index = 0; index < batch.length; index += 1) {
+    const event = batch[index]
+    if (!dictionary(event)) throw new Error(`Godot input_simulate events[${index}] must be an object. No input was dispatched.`)
+    if (!['key', 'mouse_button', 'mouse_motion', 'action', 'click', 'click_node', 'send_text'].includes(event.event_type)) throw new Error(`Godot input_simulate events[${index}].event_type must be key, mouse_button, mouse_motion, action, click, click_node or send_text. No input was dispatched.`)
+    const data = dictionary(event.event_data) ? event.event_data : {}
+    const prefix = `events[${index}].event_data`
+    // Raw MCP delays/summary have legitimate upstream Zod coercion. Only their
+    // normalized wire values are checked here, preserving that public behavior.
+    if (wire) {
+      constructorValue(event, 'delay_before_ms', 'int', `events[${index}]`)
+      constructorValue(event, 'delay_after_ms', 'int', `events[${index}]`)
+    }
+    switch (event.event_type) {
+      case 'key':
+        for (const field of ['keycode', 'physical_keycode', 'unicode']) constructorValue(data, field, 'int', prefix)
+        for (const field of ['pressed', 'shift', 'ctrl', 'alt', 'meta']) constructorValue(data, field, 'bool', prefix)
+        break
+      case 'mouse_button':
+        constructorValue(data, 'pressed', 'bool', prefix)
+        // fall through: clicks use the same button/modifier/position casts.
+      case 'click':
+        constructorValue(data, 'button_index', 'int', prefix)
+        for (const field of ['shift', 'ctrl', 'alt', 'meta']) constructorValue(data, field, 'bool', prefix)
+        if (event.event_type === 'click') constructorValue(data, 'click_delay_ms', 'int', prefix)
+        // fall through: mouse motion shares the same coordinate parser.
+      case 'mouse_motion':
+        position(data, prefix)
+        if (own(data, 'world_position')) point(data.world_position, `${prefix}.world_position`)
+        if (event.event_type === 'mouse_motion' && dictionary(data.relative)) {
+          constructorValue(data.relative, 'x', 'float', `${prefix}.relative`)
+          constructorValue(data.relative, 'y', 'float', `${prefix}.relative`)
+        }
+        break
+      case 'action':
+        constructorValue(data, 'pressed', 'bool', prefix)
+        constructorValue(data, 'strength', 'float', prefix)
+        break
+      case 'send_text':
+        constructorValue(data, 'submit', 'bool', prefix)
+        break
+      // click_node and unknown dictionary keys are left to the pinned server.
+    }
+  }
+}
+
+// Advertise the same per-event bool constructors that the preflight checks.
+// An open event_data record alone gives the model no reason to emit a literal
+// boolean. Keep ignored keys open and do not add defaults: clients must not
+// inject pressed=true into an event that deliberately omitted it.
+const INPUT_BOOLEAN_FIELDS = {
+  key: ['pressed', 'shift', 'ctrl', 'alt', 'meta'],
+  mouse_button: ['pressed', 'shift', 'ctrl', 'alt', 'meta'],
+  mouse_motion: [],
+  action: ['pressed'],
+  click: ['shift', 'ctrl', 'alt', 'meta'],
+  click_node: [],
+  send_text: ['submit'],
+}
+const INPUT_BOOLEAN_GUIDANCE = [
+  'Use literal JSON booleans for pressed, modifiers and submit, never strings such as "false".',
+  'For key, mouse_button and action, omitted pressed defaults to true; release with pressed:false (or numeric 0). action strength:0 does NOT release an action.',
+  'Events run sequentially: delay_before_ms waits before THIS event is dispatched; delay_after_ms waits after THIS event is dispatched, before the next event.',
+  'To hold key, mouse_button or action, put the hold duration on the PRESS event\'s delay_after_ms (or the RELEASE event\'s delay_before_ms). A RELEASE event\'s delay_after_ms waits with the input already released.',
+  'An empty key event is not a wait event; attach the delay to the intended input event instead.',
+  'click already performs press, internal click_delay_ms (default 50ms), then release. Its delay_after_ms is waiting after the click has released.',
+  'Example, hold move_right for 250ms then release: {"events":[{"event_type":"action","event_data":{"action":"move_right","pressed":true},"delay_after_ms":250},{"event_type":"action","event_data":{"action":"move_right","pressed":false}}]}.',
+].join(' ')
+
+function advertiseInputEvents(schema) {
+  if (!dictionary(schema)) return schema
+  const properties = schema.properties
+  const kinds = properties?.event_type?.enum
+  if (schema.type === 'object' && dictionary(properties) && Array.isArray(kinds)) {
+    return {
+      ...schema,
+      anyOf: kinds.map((kind) => {
+        const data = properties.event_data
+        const fields = own(INPUT_BOOLEAN_FIELDS, kind) ? INPUT_BOOLEAN_FIELDS[kind] : undefined
+        if (!dictionary(data) || !fields) return schema
+        const typed = { ...(data.properties || {}) }
+        for (const field of fields) typed[field] = {
+          anyOf: [{ type: 'boolean' }, { type: 'number' }],
+          description: field === 'pressed'
+            ? 'JSON boolean, or a number accepted by Godot bool(). Omitted means true; false or 0 releases. For action, strength 0 does not release.'
+            : `JSON boolean, or a number accepted by Godot bool(). Omitted means false for ${field}.`,
+        }
+        return {
+          ...schema,
+          properties: {
+            ...properties,
+            event_type: { ...properties.event_type, enum: [kind] },
+            event_data: { ...data, properties: typed },
+          },
+        }
+      }),
+    }
+  }
+  const value = { ...schema }
+  for (const union of ['anyOf', 'oneOf']) {
+    if (Array.isArray(schema[union])) value[union] = schema[union].map(advertiseInputEvents)
+  }
+  if (schema.type === 'array') value.items = advertiseInputEvents(schema.items)
+  return value
+}
+
+function advertiseInputTool(result) {
+  if (!Array.isArray(result?.tools)) return result
+  return {
+    ...result,
+    tools: result.tools.map((tool) => {
+      if (tool.name !== 'input_simulate' || !dictionary(tool.inputSchema?.properties?.events)) return tool
+      const events = advertiseInputEvents(tool.inputSchema.properties.events)
+      // The pinned registration accepts JSON-encoded top-level events. Keep
+      // that compatibility, but show native objects first for typed fields.
+      const union = Array.isArray(events.anyOf) ? 'anyOf' : Array.isArray(events.oneOf) ? 'oneOf' : undefined
+      const branches = union ? events[union] : [events]
+      const encoded = branches.some((branch) => branch?.type === 'string')
+      const advertisedEvents = encoded ? events : union
+        ? { ...events, [union]: [...branches, { type: 'string', description: 'Compatibility: JSON-encoded event object or array. Prefer native JSON objects with literal boolean values.' }] }
+        : { anyOf: [...branches, { type: 'string', description: 'Compatibility: JSON-encoded event object or array. Prefer native JSON objects with literal boolean values.' }] }
+      return {
+        ...tool,
+        description: [tool.description, INPUT_BOOLEAN_GUIDANCE].filter(Boolean).join('\n\n'),
+        inputSchema: {
+          ...tool.inputSchema,
+          properties: {
+            ...tool.inputSchema.properties,
+            events: advertisedEvents,
+          },
+        },
+      }
+    }),
+  }
+}
+
+class GodotOutcomeGuard {
+  constructor() {
+    this.storage = new AsyncLocalStorage()
+    this.requests = new Map()
+    this.unknown = false
+  }
+
+  async run(handler) {
+    const scope = { pending: new Set(), issued: false, unknown: false, ended: false }
+    if (this.unknown) return this.annotate({}, 'unknown')
+    return this.storage.run(scope, async () => {
+      let result
+      try {
+        result = await handler()
+      } catch (error) {
+        result = { isError: true, content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }] }
+      }
+      scope.ended = true
+      if (scope.pending.size || scope.unknown) this.unknown = true
+      return this.annotate(result, this.unknown ? 'unknown' : scope.issued ? 'settled' : 'not_dispatched')
+    })
+  }
+
+  annotate(result, outcome) {
+    if (!result || typeof result !== 'object' || Array.isArray(result)) {
+      this.unknown = true
+      result = {}
+      outcome = 'unknown'
+    }
+    const value = { ...result, _meta: { ...(result._meta || {}), [OUTCOME]: outcome } }
+    if (outcome === 'unknown') {
+      value.isError = true
+      value.content = [
+        ...(Array.isArray(result.content) ? result.content : []),
+        { type: 'text', text: 'Godot did not confirm command completion. Do not retry or take over; stop and restart this computer before further work.' },
+      ]
+    }
+    return value
+  }
+
+  beforeSend(socket, data) {
+    if (typeof data !== 'string') return undefined
+    let rpc
+    try { rpc = JSON.parse(data) } catch { return undefined }
+    if (!rpc || rpc.jsonrpc !== '2.0' || typeof rpc.method !== 'string' || rpc.id === undefined) return undefined
+    // Runtime heartbeat is observational; it intentionally outlives a tool call.
+    if (rpc.method === 'ping') return undefined
+    const scope = this.storage.getStore()
+    if (this.unknown) throw new Error('The Godot command outcome is unknown; restart this computer before further work.')
+    if (!scope || scope.ended) throw new Error('Godot editor commands require an active owned MCP request.')
+    if (rpc.method === 'input.simulate') validateInputSimulation(rpc.params, true)
+    let requests = this.requests.get(socket)
+    if (!requests) this.requests.set(socket, requests = new Map())
+    if (requests.has(rpc.id)) throw new Error('A Godot editor request ID is already active.')
+    const record = { socket, id: rpc.id, scope }
+    scope.issued = true
+    scope.pending.add(record)
+    requests.set(rpc.id, record)
+    return record
+  }
+
+  ambiguous(record) {
+    if (!record) return
+    record.scope.unknown = true
+    this.unknown = true
+    this.forget(record)
+  }
+
+  forget(record) {
+    record.scope.pending.delete(record)
+    const requests = this.requests.get(record.socket)
+    requests?.delete(record.id)
+    if (requests?.size === 0) this.requests.delete(record.socket)
+  }
+
+  receive(socket, data) {
+    const requests = this.requests.get(socket)
+    if (!requests?.size) return
+    let rpc
+    try { rpc = JSON.parse(Buffer.isBuffer(data) ? data.toString('utf8') : String(data)) } catch { return }
+    if (!rpc || rpc.jsonrpc !== '2.0' || rpc.method !== undefined || rpc.id === undefined || own(rpc, 'result') === own(rpc, 'error')) return
+    const record = requests.get(rpc.id)
+    if (!record) return
+    // The toolkit watchdog sends a JSON-RPC error while its cancelled coroutine
+    // may still run. Only an application result proves the handler returned.
+    if (own(rpc, 'error')) this.ambiguous(record)
+    else this.forget(record)
+  }
+
+  disconnected(socket) {
+    for (const record of [...(this.requests.get(socket)?.values() || [])]) this.ambiguous(record)
+  }
+
+  installWebSocket(WebSocket) {
+    const guard = this
+    const send = WebSocket.prototype.send
+    const emit = WebSocket.prototype.emit
+    WebSocket.prototype.send = function (...args) {
+      const record = guard.beforeSend(this, args[0])
+      const callbackIndex = typeof args[args.length - 1] === 'function' ? args.length - 1 : -1
+      if (record && callbackIndex >= 0) {
+        const callback = args[callbackIndex]
+        args[callbackIndex] = function (error, ...rest) {
+          if (error) guard.ambiguous(record)
+          return callback.call(this, error, ...rest)
+        }
+      }
+      try { return send.apply(this, args) } catch (error) { guard.ambiguous(record); throw error }
+    }
+    WebSocket.prototype.emit = function (event, ...args) {
+      if (event === 'message') guard.receive(this, args[0])
+      else if (event === 'close' || event === 'error') guard.disconnected(this)
+      return emit.call(this, event, ...args)
+    }
+    return () => { WebSocket.prototype.send = send; WebSocket.prototype.emit = emit }
+  }
+
+  installServer(Server) {
+    const guard = this
+    const setRequestHandler = Server.prototype.setRequestHandler
+    Server.prototype.setRequestHandler = function (schema, handler) {
+      return setRequestHandler.call(this, schema, (request, extra) => guard.run(async () => {
+        if (request?.method === 'tools/call' && request.params?.name === 'input_simulate') validateInputSimulation(request.params.arguments)
+        const result = await handler(request, extra)
+        return request?.method === 'tools/list' ? advertiseInputTool(result) : result
+      }))
+    }
+    return () => { Server.prototype.setRequestHandler = setRequestHandler }
+  }
+}
+
+function adaptModule(relative, source) {
+  const replaceOnce = (before, after) => {
+    if (source.split(before).length !== 2) throw new Error(`The pinned Godot adaptation no longer matches ${relative}`)
+    source = source.replace(before, after)
+  }
+  if (relative === 'dist/transport/channel.js') {
+    replaceOnce('const noReconnect = opts?.noReconnect ?? false;', 'const noReconnect = true;')
+    replaceOnce('if (!hasConnectedOnce)\n            return connect();', 'if (!hasConnectedOnce)\n            return connect();\n        if (noReconnect) return Promise.reject(new BridgeError("DISCONNECTED", "Owned Godot bridge cannot reconnect"));')
+  }
+  if (relative === 'dist/index.js') {
+    // Startup extension discovery sends editor RPCs before the MCP admission.
+    // Builtin tools remain available; extensions are not part of this install.
+    replaceOnce('const { timedOut } = await extensions.discoverEagerly();', 'const timedOut = false;')
+    // First editor authentication can trigger a detached startup reconcile.
+    // Its extension refresh would otherwise share a finished tool's context.
+    replaceOnce('discover: extensions.discoverExtensions', 'discover: async () => {}')
+  }
+  return source
+}
+
+function checkSource(root) {
+  const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'))
+  if (pkg.name !== '@npgamedev/godot-mcp-server' || pkg.version !== '1.0.3') throw new Error('Godot bridge package must match reviewed 1.0.3')
+  for (const [relative, expected] of Object.entries(PIN.files)) {
+    if (digest(fs.readFileSync(path.join(root, relative))) !== expected) throw new Error(`Godot bridge source differs from reviewed pin: ${relative}`)
+  }
+}
+
+function sealBuild(root) {
+  root = fs.realpathSync(root)
+  checkSource(root)
+  const files = {}
+  const walk = (directory) => {
+    for (const item of fs.readdirSync(directory, { withFileTypes: true })) {
+      const filename = path.join(directory, item.name)
+      if (item.isSymbolicLink()) throw new Error('Godot bridge build cannot contain symlinks')
+      if (item.isDirectory()) walk(filename)
+      else if (item.isFile()) files[path.relative(root, filename).split(path.sep).join('/')] = digest(fs.readFileSync(filename))
+    }
+  }
+  walk(path.join(root, 'dist'))
+  if (!files['dist/index.js'] || !files['dist/transport/channel.js']) throw new Error('Build the pinned Godot bridge before sealing it')
+  adaptModule('dist/index.js', fs.readFileSync(path.join(root, 'dist/index.js'), 'utf8'))
+  adaptModule('dist/transport/channel.js', fs.readFileSync(path.join(root, 'dist/transport/channel.js'), 'utf8'))
+  fs.writeFileSync(path.join(root, SEAL), `${JSON.stringify({ commit: PIN.commit, files }, null, 2)}\n`, { mode: 0o600 })
+}
+
+async function main(root) {
+  root = fs.realpathSync(root)
+  if (typeof registerHooks !== 'function') throw new Error('Owned Godot bridge requires Node 22.15+ with synchronous module hooks')
+  checkSource(root)
+  const seal = JSON.parse(fs.readFileSync(path.join(root, SEAL), 'utf8'))
+  if (seal.commit !== PIN.commit || !seal.files || typeof seal.files !== 'object') throw new Error('Godot bridge build integrity is missing')
+  const project = process.env.GODOT_MCP_PROJECT_PATH
+  if (!project || !path.isAbsolute(project) || path.resolve(project) !== path.resolve(process.cwd())) throw new Error('Pin the Godot project with its exact guest cwd and GODOT_MCP_PROJECT_PATH')
+  if (!/^[0-9]+$/.test(process.env.GODOT_MCP_EDITOR_PORT || '')) throw new Error('Pin GODOT_MCP_EDITOR_PORT to disable registry rediscovery/retry')
+  const rootUrl = pathToFileURL(`${root}${path.sep}`).href
+  registerHooks({
+    load(url, context, nextLoad) {
+      const loaded = nextLoad(url, context)
+      if (!url.startsWith(rootUrl) || !url.slice(rootUrl.length).startsWith('dist/')) return loaded
+      const relative = decodeURIComponent(url.slice(rootUrl.length))
+      const expected = seal.files[relative]
+      if (!expected || digest(fs.readFileSync(path.join(root, relative))) !== expected) throw new Error(`Godot bridge built module changed: ${relative}`)
+      if (relative === 'dist/index.js' || relative === 'dist/transport/channel.js') {
+        if (loaded.source == null) throw new Error(`Godot bridge module source is unavailable: ${relative}`)
+        const source = typeof loaded.source === 'string' ? loaded.source : Buffer.from(loaded.source).toString('utf8')
+        return { ...loaded, source: adaptModule(relative, source) }
+      }
+      return loaded
+    },
+  })
+  const requireServer = createRequire(path.join(root, 'package.json'))
+  const sdkCjs = requireServer.resolve('@modelcontextprotocol/sdk/server/index.js')
+  const sdkEsm = sdkCjs.replace(`${path.sep}dist${path.sep}cjs${path.sep}`, `${path.sep}dist${path.sep}esm${path.sep}`)
+  if (sdkEsm === sdkCjs) throw new Error('The installed MCP SDK does not match the reviewed dual-module layout')
+  const { Server } = await import(pathToFileURL(sdkEsm).href)
+  const guard = new GodotOutcomeGuard()
+  guard.installWebSocket(requireServer('ws').WebSocket)
+  guard.installServer(Server)
+  // The upstream CLI receives no wrapper/root arguments.
+  process.argv = [process.argv[0], path.join(root, 'dist/index.js')]
+  await import(pathToFileURL(path.join(root, 'dist/index.js')).href)
+}
+
+module.exports = { GodotOutcomeGuard, adaptModule, checkSource, sealBuild }
+if (require.main === module) {
+  const preparing = process.argv[2] === '--seal'
+  const root = process.argv[preparing ? 3 : 2]
+  if (!root || !path.isAbsolute(root) || process.argv.length !== (preparing ? 4 : 3)) {
+    process.stderr.write('Usage: node pal-godot-mcp.cjs [--seal] /absolute/guest/server-root\n')
+    process.exitCode = 1
+  } else if (preparing) {
+    try { sealBuild(root) } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1 }
+  } else main(root).catch((error) => { process.stderr.write(`${error.message}\n`); process.exitCode = 1 })
+}

package/dist/bin-main.d.ts

@@ -0,0 +1,3 @@
+/** Run the command line as `entrypoint`, the file that was started (`bin.js`, or `bin.ts` from source). */
+export declare function main(entrypoint: string): void;
+//# sourceMappingURL=bin-main.d.ts.map

package/dist/bin-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-main.d.ts","sourceRoot":"","sources":["../src/bin-main.ts"],"names":[],"mappings":"AASA,2GAA2G;AAC3G,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA4B7C"}

package/dist/bin.d.ts

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
-export {};
+import './compile-cache-enable.js';
+import './warning-filter.js';
 //# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAKA,OAAO,2BAA2B,CAAA;AAIlC,OAAO,qBAAqB,CAAA"}

package/dist/bin.js

@@ -1,24 +1,86 @@
 #!/usr/bin/env node
-import { fileURLToPath } from 'node:url';
-import { runCli } from './cli.js';
-import { EXIT_INTERNAL_ERROR } from './exit-codes.js';
-import { resumeInvocation } from './resume-invocation.js';
-import { terminationInProgress } from './termination.js';
-// Preserve source loaders and alternate installations when the public command differs.
-const entrypoint = fileURLToPath(import.meta.url);
-runCli({
-    argv: process.argv,
-    resumeCommand: resumeInvocation(entrypoint),
-}).then((code) => {
-    // A command stopped by a signal can return while its handler is still
-    // giving the conversation back; the handler ends the process.
-    if (terminationInProgress() !== null)
-        return;
-    process.exit(code);
-}, (err) => {
-    if (terminationInProgress() !== null)
-        return;
-    process.stderr.write(`Fatal: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
-    process.exit(EXIT_INTERNAL_ERROR);
-});
-//# sourceMappingURL=bin.js.map
+import { createRequire as __namzuCreateRequire } from 'node:module';
+const require = __namzuCreateRequire(import.meta.url);
+import {
+  __name
+} from "./chunks/chunk-76FLAFCG.js";
+
+// src/bin.ts
+import { fileURLToPath } from "node:url";
+
+// src/compile-cache.ts
+import { statSync } from "node:fs";
+import nodeModule from "node:module";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+function isRealDirectory(path) {
+  try {
+    return statSync(path).isDirectory();
+  } catch {
+    return false;
+  }
+}
+__name(isRealDirectory, "isRealDirectory");
+function enableStartupCompileCache(options = {}) {
+  const env = options.env ?? process.env;
+  const mod = options.module ?? nodeModule;
+  if (typeof mod.enableCompileCache !== "function") {
+    return { state: "skipped", reason: "this Node has no module.enableCompileCache" };
+  }
+  if (env.NODE_DISABLE_COMPILE_CACHE) {
+    return { state: "skipped", reason: "NODE_DISABLE_COMPILE_CACHE is set" };
+  }
+  if (env.NODE_COMPILE_CACHE) {
+    return { state: "skipped", reason: "NODE_COMPILE_CACHE chose the directory" };
+  }
+  try {
+    const configured = env.NAMZU_HOME;
+    const namzuHome = configured === void 0 || configured.length === 0 ? resolve(options.home ?? homedir(), ".namzu") : configured;
+    if (namzuHome.includes("\0") || !isRealDirectory(namzuHome)) {
+      return { state: "skipped", reason: "the Namzu home does not exist yet" };
+    }
+    const result = mod.enableCompileCache(join(namzuHome, "cache", "compile"));
+    if (result.status === nodeModule.constants.compileCacheStatus.ENABLED) {
+      return { state: "enabled", directory: result.directory ?? "" };
+    }
+    if (result.status === nodeModule.constants.compileCacheStatus.ALREADY_ENABLED) {
+      return { state: "skipped", reason: "already enabled" };
+    }
+    return { state: "failed", reason: result.message ?? "Node did not enable the cache" };
+  } catch (error) {
+    return { state: "failed", reason: error instanceof Error ? error.message : String(error) };
+  }
+}
+__name(enableStartupCompileCache, "enableStartupCompileCache");
+
+// src/compile-cache-enable.ts
+enableStartupCompileCache();
+
+// src/warning-filter.ts
+var SQLITE_EXPERIMENTAL = /^SQLite is an experimental feature\b/;
+function isSqliteExperimentalWarning(warning, rest) {
+  const message = typeof warning === "string" ? warning : warning instanceof Error ? warning.message : void 0;
+  if (message === void 0 || !SQLITE_EXPERIMENTAL.test(message)) return false;
+  const first = rest[0];
+  const type = typeof first === "string" ? first : typeof first === "object" && first !== null && "type" in first ? first.type : warning instanceof Error ? warning.name : void 0;
+  return type === "ExperimentalWarning";
+}
+__name(isSqliteExperimentalWarning, "isSqliteExperimentalWarning");
+function suppressSqliteExperimentalWarning(target = process) {
+  const original = target.emitWarning;
+  const filtered = /* @__PURE__ */ __name(function(warning, ...rest) {
+    if (isSqliteExperimentalWarning(warning, rest)) return;
+    original.call(target, warning, ...rest);
+  }, "filtered");
+  target.emitWarning = filtered;
+  return () => {
+    if (target.emitWarning === filtered) target.emitWarning = original;
+  };
+}
+__name(suppressSqliteExperimentalWarning, "suppressSqliteExperimentalWarning");
+suppressSqliteExperimentalWarning();
+
+// src/bin.ts
+var { main } = await import("./chunks/bin-main-EEJHRDIC.js");
+main(fileURLToPath(new URL("./", import.meta.url).href + "bin.js"));
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +1,6 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAExD,uFAAuF;AACvF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,CAAC;IACN,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,aAAa,EAAE,gBAAgB,CAAC,UAAU,CAAC;CAC3C,CAAC,CAAC,IAAI,CACN,CAAC,IAAI,EAAE,EAAE;IACR,sEAAsE;IACtE,8DAA8D;IAC9D,IAAI,qBAAqB,EAAE,KAAK,IAAI;QAAE,OAAM;IAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;IACP,IAAI,qBAAqB,EAAE,KAAK,IAAI;QAAE,OAAM;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC7E,CAAA;IACD,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;AAClC,CAAC,CACD,CAAA"}
+{
+  "version": 3,
+  "sources": ["../src/bin.ts", "../src/compile-cache.ts", "../src/compile-cache-enable.ts", "../src/warning-filter.ts"],
+  "mappings": ";;;;;;;;AAEA,SAAS,qBAAqB;;;ACF9B,SAAS,gBAAgB;AACzB,OAAO,gBAAgB;AACvB,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAoD9B,SAAS,gBAAgB,MAAuB;AAC/C,MAAI;AACH,WAAO,SAAS,IAAI,EAAE,YAAY;AAAA,EACnC,QAAQ;AACP,WAAO;AAAA,EACR;AACD;AANS;AAQF,SAAS,0BAA0B,UAA+B,CAAC,GAAwB;AACjG,QAAM,MAAM,QAAQ,OAAO,QAAQ;AACnC,QAAM,MAAM,QAAQ,UAAU;AAC9B,MAAI,OAAO,IAAI,uBAAuB,YAAY;AACjD,WAAO,EAAE,OAAO,WAAW,QAAQ,6CAA6C;AAAA,EACjF;AACA,MAAI,IAAI,4BAA4B;AACnC,WAAO,EAAE,OAAO,WAAW,QAAQ,oCAAoC;AAAA,EACxE;AACA,MAAI,IAAI,oBAAoB;AAC3B,WAAO,EAAE,OAAO,WAAW,QAAQ,yCAAyC;AAAA,EAC7E;AACA,MAAI;AACH,UAAM,aAAa,IAAI;AACvB,UAAM,YACL,eAAe,UAAa,WAAW,WAAW,IAC/C,QAAQ,QAAQ,QAAQ,QAAQ,GAAG,QAAQ,IAC3C;AACJ,QAAI,UAAU,SAAS,IAAI,KAAK,CAAC,gBAAgB,SAAS,GAAG;AAC5D,aAAO,EAAE,OAAO,WAAW,QAAQ,oCAAoC;AAAA,IACxE;AACA,UAAM,SAAS,IAAI,mBAAmB,KAAK,WAAW,SAAS,SAAS,CAAC;AAEzE,QAAI,OAAO,WAAW,WAAW,UAAU,mBAAmB,SAAS;AACtE,aAAO,EAAE,OAAO,WAAW,WAAW,OAAO,aAAa,GAAG;AAAA,IAC9D;AACA,QAAI,OAAO,WAAW,WAAW,UAAU,mBAAmB,iBAAiB;AAC9E,aAAO,EAAE,OAAO,WAAW,QAAQ,kBAAkB;AAAA,IACtD;AACA,WAAO,EAAE,OAAO,UAAU,QAAQ,OAAO,WAAW,gCAAgC;AAAA,EACrF,SAAS,OAAO;AACf,WAAO,EAAE,OAAO,UAAU,QAAQ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAAA,EAC1F;AACD;AAjCgB;;;AC3DhB,0BAA0B;;;ACc1B,IAAM,sBAAsB;AASrB,SAAS,4BAA4B,SAAkB,MAAmC;AAChG,QAAM,UACL,OAAO,YAAY,WAAW,UAAU,mBAAmB,QAAQ,QAAQ,UAAU;AACtF,MAAI,YAAY,UAAa,CAAC,oBAAoB,KAAK,OAAO,EAAG,QAAO;AACxE,QAAM,QAAQ,KAAK,CAAC;AACpB,QAAM,OACL,OAAO,UAAU,WACd,QACA,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU,QACvD,MAA6B,OAC9B,mBAAmB,QAClB,QAAQ,OACR;AACN,SAAO,SAAS;AACjB;AAdgB;AAoBT,SAAS,kCACf,SAAwB,SACX;AACb,QAAM,WAAW,OAAO;AACxB,QAAM,WAAW,gCAAyB,YAAqB,MAAuB;AACrF,QAAI,4BAA4B,SAAS,IAAI,EAAG;AAC/C,IAAC,SAA0C,KAAK,QAAQ,SAAS,GAAG,IAAI;AAAA,EAC1E,GAHiB;AAIjB,SAAO,cAAc;AACrB,SAAO,MAAM;AACZ,QAAI,OAAO,gBAAgB,SAAU,QAAO,cAAc;AAAA,EAC3D;AACD;AAZgB;AAchB,kCAAkC;;;AHhDlC,IAAM,EAAE,KAAK,IAAI,MAAM,OAAO,+BAAe;AAG7C,KAAK,cAAe,sBAAsB,QAAS,CAAC;",
+  "names": []
+}

package/dist/boot-narrative.d.ts

@@ -0,0 +1,16 @@
+import type { ConfigProvenance } from './config/load.js';
+import type { NamzuCliConfig } from './config/schema.js';
+/**
+ * The CLI-process third of the boot narrative — the two other thirds
+ * (`namzu.sandbox.resolved`/`.provider.resolved`/`.capability.*`/
+ * `.discovery.completed`/`.boot.ready`, and the SDK's own
+ * `namzu.migration.completed`) belong to `createAgentSession`
+ * (`tui/agent.ts`) and `query()` respectively, because they describe facts
+ * an agent session resolves — `doctor` and `login` never reach either.
+ *
+ * Exported (not re-exported from `./index.ts`) so `__tests__/` can drive it
+ * directly with a hand-built `ConfigProvenance` and a capturing sink,
+ * without needing a live Commander parse or a real config cascade on disk.
+ */
+export declare function emitBootNarrative(provenance: ConfigProvenance, config: NamzuCliConfig): void;
+//# sourceMappingURL=boot-narrative.d.ts.map

package/dist/boot-narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-narrative.d.ts","sourceRoot":"","sources":["../src/boot-narrative.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,kBAAkB,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAQxD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA4E5F"}