@tacuchi/agent-workflow-cli 21.10.0 → 21.11.0

package/dist/application/dev-bootstrap-dsn-service.js

@@ -1,64 +1,74 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 export function runBootstrapDsn(paths, input) {
-    const target = paths.userDsnFile();
-    const lines = [];
-    const written = [];
-    if (input.certDsn) {
-        lines.push(`DB_CERT_DSN=${input.certDsn}`);
-        written.push("DB_CERT_DSN");
-    }
-    if (input.prodDsn) {
-        lines.push(`DB_PROD_DSN=${input.prodDsn}`);
-        written.push("DB_PROD_DSN");
-    }
-    if (lines.length === 0) {
+    const entries = [];
+    if (input.certDsn)
+        entries.push({ key: "DB_CERT_DSN", value: input.certDsn });
+    if (input.prodDsn)
+        entries.push({ key: "DB_PROD_DSN", value: input.prodDsn });
+    if (entries.length === 0) {
         return {
             error: "Ni DB_CERT_DSN ni DB_PROD_DSN visibles en el entorno actual. Exportalas en ~/.zshenv (macOS/Linux) o System Environment (Windows) y reabrí Claude Code desde una terminal donde 'echo $DB_CERT_DSN' devuelva valor.",
             exitCode: 2,
         };
     }
-    mkdirSync(dirname(target), { recursive: true });
-    writeFileSync(target, `${lines.join("\n")}\n`, "utf-8");
-    try {
-        chmodSync(target, 0o600);
-    }
-    catch {
-        // ignore chmod failures
-    }
-    return { ok: true, path: target, wrote: written };
+    const path = writeDsnValues(paths, entries);
+    return { ok: true, path, wrote: entries.map((entry) => entry.key) };
 }
 export function writeDsnValue(paths, input) {
+    const path = writeDsnValues(paths, [input]);
+    return { ok: true, path, key: input.key };
+}
+/**
+ * Upsert of every entry into dsn.env, preserving the lines this call does not
+ * own: the file is shared by every connection the user ever bootstrapped, so a
+ * whole-file rewrite would drop the DSNs of the other ones.
+ */
+function writeDsnValues(paths, entries) {
     const target = paths.userDsnFile();
-    const existing = readDsnLines(target);
-    const next = upsertDsnLine(existing, input.key, input.value);
+    let lines = readDsnLines(target);
+    for (const entry of entries) {
+        lines = upsertDsnLine(lines, entry.key, entry.value);
+    }
     mkdirSync(dirname(target), { recursive: true });
-    writeFileSync(target, `${next.join("\n")}\n`, "utf-8");
+    writeFileSync(target, `${lines.join("\n")}\n`, "utf-8");
     try {
         chmodSync(target, 0o600);
     }
     catch {
-        // ignore chmod failures
+        // Best effort: filesystems without POSIX modes (Windows, FAT) must not fail
+        // a write that already landed. The DSN is still written.
     }
-    return { ok: true, path: target, key: input.key };
+    return target;
 }
 function readDsnLines(path) {
     if (!existsSync(path))
         return [];
-    return readFileSync(path, "utf-8")
-        .split(/\r?\n/)
-        .filter((line) => line.length > 0);
+    const lines = readFileSync(path, "utf-8").split(/\r?\n/);
+    // Only the empty tail the final newline produces is dropped. Blank lines
+    // inside the file are the user's own grouping of a file this tool shares with
+    // them, and an upsert has no business collapsing it.
+    if (lines[lines.length - 1] === "")
+        lines.pop();
+    return lines;
 }
 function upsertDsnLine(lines, key, value) {
     const prefix = `${key}=`;
+    const next = [];
     let replaced = false;
-    const next = lines.map((line) => {
-        if (line.startsWith(prefix)) {
-            replaced = true;
-            return `${key}=${value}`;
+    for (const line of lines) {
+        // Compare the line trimmed: an indented assignment still assigns, and
+        // leaving it behind would keep a stale credential alive in a file the user
+        // believes updated. Duplicates of the same key collapse into the first.
+        if (!line.trimStart().startsWith(prefix)) {
+            next.push(line);
+            continue;
         }
-        return line;
-    });
+        if (replaced)
+            continue;
+        replaced = true;
+        next.push(`${key}=${value}`);
+    }
     if (!replaced)
         next.push(`${key}=${value}`);
     return next;

package/dist/application/dev-bootstrap-dsn-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-bootstrap-dsn-service.js","sourceRoot":"","sources":["../../src/application/dev-bootstrap-dsn-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev-bootstrap-dsn-service.js","sourceRoot":"","sources":["../../src/application/dev-bootstrap-dsn-service.ts"],"names":[],"mappings":"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"}

package/dist/application/docs-canon-service.js

@@ -0,0 +1,68 @@
+import { parse as parseToml } from "smol-toml";
+import { checkSafeRelativePath } from "../domain/safe-path.js";
+const TABLE = "docs";
+export async function resolveDocsCanon(fs, paths, categories) {
+    const canon = {};
+    // Workspace last: it overrides the user-global default, same order as skills.
+    for (const path of [paths.userSkillsToml(), paths.cwdSkillsToml()]) {
+        if (!(await fs.exists(path)))
+            continue;
+        const level = await readDocsTable(fs, path);
+        if (!level.ok)
+            return level;
+        for (const [category, dir] of Object.entries(level.table)) {
+            const checked = checkDestination(path, category, dir, categories);
+            if (!checked.ok)
+                return checked;
+            canon[category] = checked.dir;
+        }
+    }
+    return { ok: true, canon };
+}
+async function readDocsTable(fs, path) {
+    let parsed;
+    try {
+        parsed = parseToml(await fs.readText(path));
+    }
+    catch (error) {
+        return { ok: false, error: `${path} no se puede leer como TOML: ${String(error)}` };
+    }
+    const table = parsed[TABLE];
+    if (table === undefined || table === null)
+        return { ok: true, table: {} };
+    if (typeof table !== "object" || Array.isArray(table)) {
+        return { ok: false, error: `${path}: [${TABLE}] no es una tabla` };
+    }
+    return { ok: true, table: table };
+}
+function checkDestination(path, category, dir, categories) {
+    if (!categories.includes(category)) {
+        return {
+            ok: false,
+            error: `${path}: [${TABLE}] no reconoce '${category}'; las categorías son: ${categories.join(", ")}`,
+        };
+    }
+    if (typeof dir !== "string") {
+        return { ok: false, error: `${path}: [${TABLE}].${category} tiene que ser una ruta de texto` };
+    }
+    // Same guard every write boundary uses, so a canon can move a category inside
+    // the workspace and never outside it.
+    const safe = checkSafeRelativePath(dir.replace(/\/+$/, ""));
+    if (!safe.ok) {
+        return { ok: false, error: `${path}: [${TABLE}].${category} = '${dir}' ${safe.why}` };
+    }
+    // Inside the workspace is not enough: it has to be DOCUMENTAL. A canon
+    // pointing at a dot-directory would publish dossiers into the CLI's own
+    // runtime — `.workflow/sessions` is the sharp case, because a published unit
+    // named `NNN-export-…` is then enumerated as a session and the workspace grows
+    // a phantom open line that shows up in `status` and in the next export's
+    // corpus. The tool's own state is not a place a document may be published to.
+    if (safe.path.split("/")[0]?.startsWith(".") === true) {
+        return {
+            ok: false,
+            error: `${path}: [${TABLE}].${category} = '${dir}' apunta a un directorio oculto; el canon documental publica documentos, no estado interno de la herramienta`,
+        };
+    }
+    return { ok: true, dir: safe.path };
+}
+//# sourceMappingURL=docs-canon-service.js.map

package/dist/application/docs-canon-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-canon-service.js","sourceRoot":"","sources":["../../src/application/docs-canon-service.ts"],"names":[],"mappings":"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"}

package/dist/application/dsn-reader-service.js

@@ -22,7 +22,58 @@ export function readBootstrapDsn(paths) {
     return { path, exists: true, values };
 }
 export function dsnKeyForInstance(instance) {
-    const normalized = normalizeMcpInstance(instance);
-    return `DB_${normalized.toUpperCase().replace(/-/g, "_")}_DSN`;
+    return dsnKeyFromSegments(instanceSegments(instance));
+}
+/**
+ * The variable names that may hold the DSN of `instance`, most specific first:
+ * the canonical key, and the one without its leading segment. An alias usually
+ * carries an organisation prefix (`qtc-cert`) that the variable the user really
+ * exported does not (`DB_CERT_DSN`).
+ *
+ * Exactly ONE segment is ever dropped. `qtc-cert-ro` may fall back to
+ * DB_CERT_RO_DSN but never to DB_RO_DSN, because collapsing an alias to its last
+ * segment makes different organisations share one generic name — `acme-prod` and
+ * `qtc-prod` would both reach DB_PROD_DSN, and starting a server against another
+ * environment's credential is a worse outcome than refusing to start.
+ */
+export function dsnKeyCandidates(instance) {
+    const segments = instanceSegments(instance);
+    // A single-segment or degenerate alias still yields its canonical key: callers
+    // must always have at least one name to probe and to name in errors.
+    if (segments.length <= 1)
+        return [dsnKeyFromSegments(segments)];
+    return [dsnKeyFromSegments(segments), dsnKeyFromSegments(segments.slice(1))];
+}
+function instanceSegments(instance) {
+    return normalizeMcpInstance(instance)
+        .split("-")
+        .filter((segment) => segment.length > 0);
+}
+function dsnKeyFromSegments(segments) {
+    return `DB_${segments.join("_").toUpperCase()}_DSN`;
+}
+/**
+ * Single resolution path shared by the dbhub launcher and the connection
+ * tester. Precedence: the whole candidate list in `env` first, then the whole
+ * list in the dsn.env file — an exported variable beats a persisted one, and
+ * among exported variables the most specific name wins.
+ *
+ * Throws whatever `readBootstrapDsn` throws (unreadable dsn.env): each caller
+ * decides how that surfaces instead of it being swallowed here.
+ */
+export function resolveDsnFromCandidates(candidates, env, paths) {
+    for (const variable of candidates) {
+        const fromEnv = env[variable];
+        if (fromEnv && fromEnv.length > 0)
+            return { dsn: fromEnv, variable, source: "env" };
+    }
+    // Read once, and only after every candidate missed in the environment.
+    const values = readBootstrapDsn(paths).values;
+    for (const variable of candidates) {
+        const fromFile = values[variable];
+        if (fromFile && fromFile.length > 0)
+            return { dsn: fromFile, variable, source: "dsn.env" };
+    }
+    return null;
 }
 //# sourceMappingURL=dsn-reader-service.js.map

package/dist/application/dsn-reader-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"dsn-reader-service.js","sourceRoot":"","sources":["../../src/application/dsn-reader-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAoB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAShF,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACxD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;AACjE,CAAC"}
+{"version":3,"file":"dsn-reader-service.js","sourceRoot":"","sources":["../../src/application/dsn-reader-service.ts"],"names":[],"mappings":"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"}

package/dist/application/mcp-dbhub-launcher.js

@@ -1,7 +1,9 @@
-// Launcher that resolves the DSN and spawns `npx -y @bytebase/dbhub` with stdio inherit.
+// Launcher that resolves the DSN and spawns `npx -y @bytebase/dbhub`.
+// stdin/stderr are inherited; stdout is piped so the dbhub startup banner never
+// reaches the MCP JSON-RPC channel (see DbhubBannerFilter).
 import { spawn } from "node:child_process";
 import { normalizeDsnVarName, validateDsnVarName, validateMcpInstance, } from "../domain/mcp-entry.js";
-import { dsnKeyForInstance, readBootstrapDsn } from "./dsn-reader-service.js";
+import { dsnKeyCandidates, resolveDsnFromCandidates, } from "./dsn-reader-service.js";
 export const DBHUB_DSN_VAR_ENV = "DBHUB_DSN_VAR";
 export class DbhubLauncherError extends Error {
     constructor(message) {
@@ -10,38 +12,154 @@ export class DbhubLauncherError extends Error {
     }
 }
 export function resolveDsn(instance, deps) {
-    const dsnVar = resolveDsnVar(instance, deps);
-    const fromEnv = deps.env[dsnVar];
-    if (fromEnv && fromEnv.length > 0) {
-        return { dsn: fromEnv, source: "env" };
-    }
-    // An unreadable dsn.env (e.g. it is a directory, or a permission/race error)
-    // falls through to the DbhubLauncherError below, not a raw fs throw.
-    let fromFile;
+    const candidates = dsnVarCandidates(instance, deps);
+    let resolved = null;
+    let fileError = null;
     try {
-        fromFile = readBootstrapDsn(deps.paths).values[dsnVar];
+        resolved = resolveDsnFromCandidates(candidates, deps.env, deps.paths);
     }
-    catch {
-        fromFile = undefined;
+    catch (err) {
+        // An unreadable dsn.env (a directory in its place, a permission or race
+        // error) surfaces as this launcher's own diagnostic naming the cause,
+        // never as a raw fs throw and never as a silent "not found".
+        fileError = err instanceof Error ? err.message : String(err);
     }
-    if (fromFile && fromFile.length > 0) {
-        return { dsn: fromFile, source: "dsn.env" };
+    if (resolved === null) {
+        throw new DbhubLauncherError(buildUnresolvedDsnMessage(instance, candidates, deps, fileError));
     }
-    throw new DbhubLauncherError(`[dbhub-mcp-runner] ${dsnVar} no visible — no está en process.env ni en ${deps.paths.userDsnFile()}. Asegurate de exportarlo en ~/.zshenv (macOS/Linux) o System Environment (Windows) y reiniciar Claude Code desde una terminal donde 'echo $${dsnVar}' devuelva valor.`);
+    reportNonCanonicalVariable(resolved, candidates, deps);
+    return resolved;
 }
-function resolveDsnVar(instance, deps) {
+/**
+ * Variable names to probe, most specific first. An explicit DBHUB_DSN_VAR names
+ * the variable exactly — no prefix-dropping candidates are derived from it.
+ */
+function dsnVarCandidates(instance, deps) {
     const configured = deps.env[DBHUB_DSN_VAR_ENV];
-    if (configured === undefined || configured.trim().length === 0) {
-        return dsnKeyForInstance(instance);
+    if (configured !== undefined && configured.trim().length > 0) {
+        const validation = validateDsnVarName(configured);
+        if (!validation.ok) {
+            throw new DbhubLauncherError(`[dbhub-mcp-runner] ${DBHUB_DSN_VAR_ENV} inválida '${configured}': ${validation.error}`);
+        }
+        return [normalizeDsnVarName(validation.value)];
     }
-    const validation = validateDsnVarName(configured);
-    if (!validation.ok) {
-        throw new DbhubLauncherError(`[dbhub-mcp-runner] ${DBHUB_DSN_VAR_ENV} inválida '${configured}': ${validation.error}`);
+    const [canonical, ...rest] = dsnKeyCandidates(instance);
+    if (canonical === undefined) {
+        throw new DbhubLauncherError(`[dbhub-mcp-runner] la conexión '${instance}' no deriva ninguna variable DSN`);
+    }
+    return [canonical, ...rest];
+}
+/**
+ * A DSN found under a non-canonical name is a resolution the user did not
+ * spell out: say which variable was used and which one was missing, so the
+ * mismatch never passes as a silent default.
+ */
+function reportNonCanonicalVariable(resolved, candidates, deps) {
+    const canonical = candidates[0];
+    if (resolved.variable === canonical)
+        return;
+    const origin = resolved.source === "env" ? "process.env" : deps.paths.userDsnFile();
+    stderrWriter(deps)(`[dbhub-mcp-runner] usando ${resolved.variable} (desde ${origin}) porque ${canonical} no está definida.\n`);
+}
+function buildUnresolvedDsnMessage(instance, candidates, deps, fileError) {
+    const dsnFile = deps.paths.userDsnFile();
+    const probed = candidates.length === 1 ? "la variable" : "estas variables, en orden";
+    const where = fileError === null
+        ? `primero en process.env y después en ${dsnFile}`
+        : `primero en process.env; ${dsnFile} no se pudo leer (${fileError})`;
+    return [
+        `[dbhub-mcp-runner] no encontré el DSN de la conexión '${instance}'.`,
+        `Probé ${probed}: ${candidates.join(", ")} — ${where}.`,
+        `Salidas: exportá ${candidates[0]} en ~/.zshenv (macOS/Linux) o System Environment (Windows)`,
+        `y reabrí el host desde una terminal donde 'echo $${candidates[0]}' devuelva valor;`,
+        `o nombrá la variable exacta con ${DBHUB_DSN_VAR_ENV} en el entorno del servidor MCP;`,
+        `o registrá la conexión con 'aw mcp setup --instance ${instance} --dsn-var <NOMBRE>'.`,
+    ].join(" ");
+}
+function stderrWriter(deps) {
+    return (deps.stderr ??
+        ((chunk) => {
+            process.stderr.write(chunk);
+        }));
+}
+const NEWLINE = 0x0a;
+const OPEN_BRACE = 0x7b;
+const EMPTY_CHUNK = Buffer.alloc(0);
+/** Narrow enough that a banner containing it verbatim is not a realistic risk. */
+const JSONRPC_MARKER = Buffer.from('{"jsonrpc"');
+/**
+ * Splits dbhub's stdout into banner (stderr) and protocol (stdout).
+ *
+ * `@bytebase/dbhub` prints an ASCII banner on stdout before speaking JSON-RPC,
+ * which corrupts the stdio channel every MCP client reads. Complete lines are
+ * routed to stderr until the first one whose first non-blank byte is `{`; from
+ * that line on the filter is `started` and the caller must hand the pipe over
+ * raw, so the protocol is never re-sliced. Pure on purpose: testable without
+ * spawning a process.
+ */
+export class DbhubBannerFilter {
+    pending = EMPTY_CHUNK;
+    jsonStarted = false;
+    /** True once the JSON-RPC stream began: the caller switches to raw passthrough. */
+    get started() {
+        return this.jsonStarted;
+    }
+    push(chunk) {
+        if (this.jsonStarted)
+            return { stdout: chunk, stderr: EMPTY_CHUNK };
+        this.pending = this.pending.length === 0 ? chunk : Buffer.concat([this.pending, chunk]);
+        // A banner that does not end in a newline would otherwise swallow the first
+        // message glued to its tail, so the protocol marker is a second and narrower
+        // cut point: bytes before it are banner, bytes from it on are protocol.
+        const marker = this.pending.indexOf(JSONRPC_MARKER);
+        const banner = [];
+        let consumed = 0;
+        let newline = this.pending.indexOf(NEWLINE, consumed);
+        while (newline !== -1) {
+            const line = this.pending.subarray(consumed, newline + 1);
+            // A line that already opens the protocol is handed over from its first
+            // byte, blanks included: the marker cut is for a banner glued to the
+            // message, never an excuse to re-slice bytes that are already protocol.
+            if (startsJsonRpc(line))
+                return this.startAt(consumed, consumed, banner);
+            if (marker !== -1 && marker < newline)
+                return this.startAt(marker, consumed, banner);
+            banner.push(line);
+            consumed = newline + 1;
+            newline = this.pending.indexOf(NEWLINE, consumed);
+        }
+        if (marker !== -1)
+            return this.startAt(marker, consumed, banner);
+        this.pending = Buffer.from(this.pending.subarray(consumed));
+        return { stdout: EMPTY_CHUNK, stderr: Buffer.concat(banner) };
+    }
+    /** Protocol starts at `cut`: [consumed, cut) is banner, [cut, …) goes out verbatim. */
+    startAt(cut, consumed, banner) {
+        this.jsonStarted = true;
+        if (cut > consumed)
+            banner.push(this.pending.subarray(consumed, cut));
+        const stdout = Buffer.from(this.pending.subarray(cut));
+        this.pending = EMPTY_CHUNK;
+        return { stdout, stderr: Buffer.concat(banner) };
+    }
+    /** Stream ended: anything still buffered never became a JSON line, so it is banner. */
+    end() {
+        const stderr = this.pending;
+        this.pending = EMPTY_CHUNK;
+        return { stdout: EMPTY_CHUNK, stderr };
+    }
+}
+function startsJsonRpc(line) {
+    for (const byte of line) {
+        // Skip leading blanks (space, tab, CR, LF); a fully blank line is banner.
+        if (byte === 0x20 || byte === 0x09 || byte === 0x0d || byte === NEWLINE)
+            continue;
+        return byte === OPEN_BRACE;
     }
-    return normalizeDsnVarName(validation.value);
+    return false;
 }
 /**
- * Resolves DSN and spawns `npx -y @bytebase/dbhub` with stdio inherited.
+ * Resolves the DSN and spawns `npx -y @bytebase/dbhub`.
  * Resolves only when the spawned child exits.
  */
 export async function runDbhubLauncher(input) {
@@ -53,25 +171,66 @@ export async function runDbhubLauncher(input) {
     const { dsn } = resolveDsn(instance, input.deps);
     const isWin = input.deps.platform === "win32";
     const cmd = isWin ? "npx.cmd" : "npx";
+    const protocol = input.deps.stdout ?? process.stdout;
     return new Promise((resolve, reject) => {
         const child = spawn(cmd, ["-y", "@bytebase/dbhub"], {
-            stdio: "inherit",
+            stdio: ["inherit", "pipe", "inherit"],
             env: { ...input.deps.env, DSN: dsn },
             shell: isWin,
         });
+        if (child.stdout === null) {
+            reject(new DbhubLauncherError("[dbhub-mcp-runner] no pude capturar el stdout de dbhub"));
+            return;
+        }
+        forwardDbhubStdout(child.stdout, {
+            protocol,
+            diagnostics: stderrWriter(input.deps),
+        });
         child.on("error", (err) => reject(new DbhubLauncherError(`[dbhub-mcp-runner] ${err.message}`)));
-        child.on("exit", (code, signal) => {
-            if (signal) {
-                // Honor signal: emulate `process.kill(process.pid, signal)` from JS launcher
-                // by mapping to a non-zero exit. The CLI command will exit with that code.
-                resolve({ exitCode: 128 + (signalToNumber(signal) ?? 0) });
-            }
-            else {
-                resolve({ exitCode: code ?? 0 });
-            }
+        // `close`, not `exit`: `exit` fires before the child's stdout is drained, so
+        // the tail of the protocol would still be in flight. And piping made a second
+        // loss possible that `stdio: "inherit"` ruled out structurally — the child
+        // used to write fd 1 itself, whereas now every byte is re-written through OUR
+        // stdout, and the CLI ends with process.exit(), which drops whatever is still
+        // queued on a pipe. The zero-length write is a drain barrier: its callback
+        // runs once everything before it reached the OS.
+        child.on("close", (code, signal) => {
+            // Honor signal: emulate `process.kill(process.pid, signal)` from JS launcher
+            // by mapping to a non-zero exit. The CLI command will exit with that code.
+            const exitCode = signal ? 128 + (signalToNumber(signal) ?? 0) : (code ?? 0);
+            protocol.write(EMPTY_CHUNK, () => resolve({ exitCode }));
         });
     });
 }
+/**
+ * Wires a dbhub stdout stream to this process's channels: banner lines to
+ * diagnostics, protocol bytes to the protocol channel. Takes its channels as
+ * parameters so the handover can be exercised without spawning anything.
+ */
+export function forwardDbhubStdout(source, channels) {
+    const filter = new DbhubBannerFilter();
+    const onData = (chunk) => {
+        const routed = filter.push(chunk);
+        if (routed.stderr.length > 0)
+            channels.diagnostics(routed.stderr.toString("utf-8"));
+        if (routed.stdout.length > 0)
+            channels.protocol.write(routed.stdout);
+        if (!filter.started)
+            return;
+        // Protocol started: pause before detaching, so no chunk can be emitted
+        // between removing the listener and attaching the pipe. `end: false` keeps
+        // the child's EOF from closing our own stdout.
+        source.pause();
+        source.removeListener("data", onData);
+        source.pipe(channels.protocol, { end: false });
+    };
+    source.on("data", onData);
+    source.on("end", () => {
+        const rest = filter.end();
+        if (rest.stderr.length > 0)
+            channels.diagnostics(rest.stderr.toString("utf-8"));
+    });
+}
 function signalToNumber(signal) {
     // Common signals; fallback to null (will produce exitCode 128 + 0 = 128).
     const map = {

package/dist/application/mcp-dbhub-launcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-dbhub-launcher.js","sourceRoot":"","sources":["../../src/application/mcp-dbhub-launcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-dbhub-launcher.js","sourceRoot":"","sources":["../../src/application/mcp-dbhub-launcher.ts"],"names":[],"mappings":"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"}

package/dist/application/mcp-doctor-service.js

@@ -1,6 +1,6 @@
 import { isDeepStrictEqual } from "node:util";
 import { buildMcpEntry, normalizeMcpInstance, } from "../domain/mcp-entry.js";
-import { dsnKeyForInstance, readBootstrapDsn } from "./dsn-reader-service.js";
+import { dsnKeyCandidates, dsnKeyForInstance, readBootstrapDsn } from "./dsn-reader-service.js";
 import { readMcpEntry } from "./mcp-host-reader.js";
 import { resolveScopeDir } from "./mcp-scope-common.js";
 export function runMcpDoctor(env, paths, input) {
@@ -22,10 +22,19 @@ export function runMcpDoctor(env, paths, input) {
     return { scope: input.scope, scope_dir: scopeDir, reports, summary };
 }
 function buildReport(env, host, instance, scopeDir, dsn, scope, dsnVars) {
-    const dsnKey = dsnVars?.[normalizeMcpInstance(instance)] ?? dsnKeyForInstance(instance);
-    const entry = buildMcpEntry(instance, dsnVars?.[normalizeMcpInstance(instance)]);
+    const declaredVar = dsnVars?.[normalizeMcpInstance(instance)];
+    const entry = buildMcpEntry(instance, declaredVar);
     const snapshot = readMcpEntry(host, scopeDir, entry.name, scope);
-    const dsnPresent = Boolean(env.get(dsnKey)) || (dsn.exists && Boolean(dsn.values[dsnKey]));
+    // Probe the same chain the launcher probes, in the same order. A doctor that
+    // only knows the canonical name reports `missing-dsn` for a connection the
+    // launcher would start happily — a diagnosis contradicting the runtime is
+    // worse than none. What gets reported is the variable that carries the value,
+    // never the canonical name assumed.
+    const candidates = declaredVar !== undefined ? [declaredVar] : dsnKeyCandidates(instance);
+    const resolvedKey = candidates.find((key) => Boolean(env.get(key))) ??
+        (dsn.exists ? candidates.find((key) => Boolean(dsn.values[key])) : undefined);
+    const dsnKey = resolvedKey ?? candidates[0] ?? dsnKeyForInstance(instance);
+    const dsnPresent = resolvedKey !== undefined;
     const dsnInfo = {
         path: dsn.path,
         exists: dsn.exists,