@minhpnq1807/contextos 0.6.5 → 0.6.7

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.6.7
+
+- **MCP proxy test stability:** Fixed the MCP proxy telemetry smoke test so it waits for the telemetry file before reading it and uses a stable stdin/stdout echo child. This removes the CI race where `telemetry.jsonl` could be read before it existed.
+
+## 0.6.6
+
+- **Global-first skill coverage:** `ctx doctor` now treats global and community skills as valid skill coverage instead of requiring project-local skill packs. Project skills are reported separately as optional project overrides, so repositories with synced global skills no longer show `Skills: 0` or `Not Ready` just because `.codex/skills` is absent.
+- **Evidence-gated skill routing:** Updated Skill Router scoring so global skills are first-class candidates, community skills get a small source boost, and project skills get an override boost without penalizing global catalogs. Prompt+semantic matches without project evidence now remain medium-confidence candidates instead of disappearing.
+- **Shared project context:** `ctx doctor --fix` and `ctx setup --generate-project-context` now scaffold shared project context under `.agents/skills/` and `.agents/workflows/` instead of Codex-only `.codex/` paths. Workflow discovery and certification now read `.agents/workflows` so the same generated context can be synced to Codex, Claude Code, Gemini, and Antigravity.
+
 ## 0.6.5
 
 - **Generated skill frontmatter:** Fixed `ctx doctor --fix` starter `SKILL.md` output so generated project skills include YAML frontmatter with `name` and `description`. This prevents invalid-skill warnings after generated skills are synced through skillshare.

package/README.md

@@ -246,14 +246,15 @@ ctx doctor
 Repository Score
 
 Rules: 92
-Skills: 88
+Skill Coverage: 88
+Project Skill Overrides: 0
 Workflows: 84
 
 Overall:
-ContextOS Ready Gold
+ContextOS Ready Silver
 ```
 
-The score checks project `AGENTS.md` rules, project skill packs under `.codex/skills/` or `.agents/skills/`, and project workflows under `.codex/workflows/` or `.claude/workflows/`. Use the badge only after `ctx doctor` reports Bronze, Silver, or Gold.
+The score checks project `AGENTS.md` rules, global/community skill coverage, optional project skill overrides, and project workflows. Shared project context should live under `.agents/skills/` and `.agents/workflows/`; ContextOS can sync it to Codex, Claude Code, Gemini, and Antigravity agent roots. Use the badge only after `ctx doctor` reports Bronze, Silver, or Gold.
 
 ## Quick Commands
 
@@ -584,14 +585,14 @@ This warning comes from a transitive dependency in the local embedding/WASM stac
 | `ctx install --copy` | Copies only the plugin payload to `$CODEX_HOME/plugins/ctx`. | Legacy local development or manual plugin experiments. | Does not sync the active marketplace, rebuild indexes, register MCP, or install global hooks. Prefer `ctx refresh` for active local updates. |
 | `ctx setup` | Runs the first-run setup wizard. | You want the recommended onboarding flow after `npm install -g @minhpnq1807/contextos`. | Installs selected agents, optionally syncs Ruler rules/MCP and skillshare skills, asks which prompt sections to show, then prints next steps. |
 | `ctx setup --yes` | Runs setup with defaults non-interactively. | You want scriptable Codex setup. | Uses `codex`, enables injection, syncs rules, syncs skills, skips interactive community-skill installation when no TTY is available, and passes `--yes` to dependency setup prompts. Use `--agents codex,claude,agy` for multi-agent setup. |
-| `ctx setup --generate-project-context` | Generates starter project skills and workflow during setup. | Your repo has rules but `ctx doctor` reports missing skills/workflows. | Creates `.codex/skills/<detected-skill>/SKILL.md`, matching `skill.yaml`, and `.codex/workflows/primary.md` without overwriting existing files. |
+| `ctx setup --generate-project-context` | Generates starter shared project skills and workflow during setup. | Your repo has rules but `ctx doctor` reports missing skills/workflows. | Creates `.agents/skills/<detected-skill>/SKILL.md`, matching `skill.yaml`, and `.agents/workflows/primary.md` without overwriting existing files. Run `ctx sync --skills` and `ctx sync --workflows` to push them to selected agents. |
 | `ctx setup --agents <list>` | Runs setup for selected agents. | You want only part of the default set. | Accepts comma-separated `codex`, `claude`, `agy`, or `antigravity`. |
 | `ctx setup --no-rules` | Skips Ruler sync during setup. | You only want hooks/MCP install and maybe skill sync. | Does not run `ctx sync --rules`. |
 | `ctx setup --no-skills` | Skips skillshare sync during setup. | You do not want shared skills configured. | Does not run `ctx sync --skills`. |
 | `ctx setup --quiet` | Runs setup in measurement-only mode. | You want reports/stats without visible injected prompt context. | Installs hooks with prompt context injection disabled. |
 | `ctx debug -- "task"` | Runs the scheduler locally for a fake prompt. | You want to see which AGENTS.md rules and files ContextOS would inject before using Codex. | Prints rule scores, scoring reasons, suggested files, and final `additionalContext`. |
 | `ctx doctor` | Scores repository ContextOS readiness. | You want to add or verify a `ContextOS Ready` badge. | Prints Rules, Skills, Workflows, Overall tier, evidence, and next recommendations. |
-| `ctx doctor --fix` | Generates starter ContextOS project context. | `ctx doctor` says skills/workflows are missing and you want explicit local scaffolding. | Detects package/config evidence, creates up to three starter project skills plus `.codex/workflows/primary.md`, then prints the updated readiness score. |
+| `ctx doctor --fix` | Generates starter ContextOS project context. | `ctx doctor` says skills/workflows are missing and you want explicit local scaffolding. | Detects package/config evidence, creates up to three shared project skills plus `.agents/workflows/primary.md`, then prints the updated readiness score. |
 | `ctx report` | Shows the last Stop-hook compliance report for the current workspace. | An agent task has finished and you want the summary again. | Prints sectioned tables for summary, rule outcomes, suggested files, and runtime telemetry from `~/.ctx/contextos/workspaces/<workspace-id>/last-report.json`. |
 | `ctx evidence` | Shows detailed evidence behind the last report for the current workspace. | You want to inspect why a rule was marked `followed`, `ignored`, `unknown`, or `unmeasurable`. | Prints a compact evidence table plus per-rule detail tables. |
 | `ctx stats` | Shows aggregate runtime metrics for the current workspace. | You want to know whether ContextOS is active and useful over time. | Prints sectioned tables for prompt/report counts, injection rate, efficiency, rule outcomes, hook events, last prompt, and last report. |
@@ -611,7 +612,7 @@ This warning comes from a transitive dependency in the local embedding/WASM stac
 | `ctx sync --skills --no-collect` | Skips collecting existing agent skills into skillshare. | You already manage `~/.config/skillshare/skills` and only want to push it out. | Initializes/syncs skillshare without running `skillshare backup` or `skillshare collect --all`. |
 | `ctx sync --skills --no-embeddings` | Skips ContextOS skill embedding rebuild after skillshare sync. | You have a very large skill catalog and want sync to finish quickly. | Runs skillshare sync, then leaves embeddings to a later `ctx embeddings warm -- "task"` run. |
 | `ctx sync --skills --verbose` | Shows native skillshare token budget warnings during sync. | You are diagnosing skillshare path overlap or always-loaded context size. | Omits ContextOS' default `skillshare sync --quiet` behavior. |
-| `ctx sync --workflows` | Syncs and indexes agent workflow markdown files for prompt-time workflow suggestions. | You use `.claude/workflows/`, `.codex/workflows/`, or Antigravity workflow folders and want every agent to see the same deduped workflow set. | Scans project/global workflow folders, dedupes by workflow name, copies unique workflows to selected global agent roots, warms workflow embeddings, and makes `ctx debug`/prompt hooks show relevant workflow hints. |
+| `ctx sync --workflows` | Syncs and indexes agent workflow markdown files for prompt-time workflow suggestions. | You use `.agents/workflows/`, `.claude/workflows/`, `.codex/workflows/`, or Gemini/Antigravity workflow folders and want every agent to see the same deduped workflow set. | Scans project/global workflow folders, dedupes by workflow name, copies unique workflows to selected global agent roots, warms workflow embeddings, and makes `ctx debug`/prompt hooks show relevant workflow hints. |
 | `ctx sync --workflows --agents <list>` | Syncs workflows only for selected agents. | You want a subset such as `codex,claude` or `codex,claude,agy`. | Accepts comma-separated `codex`, `claude`, `agy`, or `antigravity`; `agy` writes the Gemini/Antigravity workflow roots. |
 | `ctx sync --workflows --dry-run` | Previews workflow sync without writing files. | You want to inspect source workflows and target roots first. | Prints planned sync/index output and skips copying target files. |
 | `ctx skills` | Installs community skill libraries. | You want curated skills without running the full setup wizard. | Opens the community installer, uses a portable shell on Windows/Linux/macOS, repairs unsafe skill symlinks, and syncs installed skills to selected agents. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhpnq1807/contextos",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Inject task-relevant AGENTS.md rules into Codex through plugin hooks.",
   "author": {
     "name": "ContextOS"

package/plugins/ctx/lib/certification.js

@@ -4,7 +4,7 @@ import path from "node:path";
 
 import { filterActionableRules, parseRules } from "./analyzer.js";
 import { readAgentsChain } from "./reader.js";
-import { scanSkills } from "./skill-discoverer.js";
+import { scanSkills, skillSearchRoots } from "./skill-discoverer.js";
 import { scanWorkflows } from "./workflow-discoverer.js";
 
 const PROJECT_SKILL_ROOTS = [
@@ -17,6 +17,7 @@ const PROJECT_SKILL_ROOTS = [
 ];
 
 const PROJECT_WORKFLOW_ROOTS = [
+  [".agents", "workflows"],
   [".claude", "workflows"],
   [".codex", "workflows"],
   [".gemini", "workflows"],
@@ -27,7 +28,7 @@ const PROJECT_WORKFLOW_ROOTS = [
 export function inspectContextOSReady({ cwd = process.cwd(), home = os.homedir() } = {}) {
   const root = findProjectRoot(cwd);
   const rules = inspectRules({ cwd, root, home });
-  const skills = inspectSkills({ root });
+  const skills = inspectSkills({ root, home });
   const workflows = inspectWorkflows({ root });
   const overall = Math.round((rules.score + skills.score + workflows.score) / 3);
   const tier = readinessTier(overall, { rules, skills, workflows });
@@ -48,7 +49,8 @@ export function formatContextOSReady(result) {
     "Repository Score",
     "",
     `Rules: ${result.rules.score}`,
-    `Skills: ${result.skills.score}`,
+    `Skill Coverage: ${result.skills.score}`,
+    `Project Skill Overrides: ${result.skills.projectOverrideScore}`,
     `Workflows: ${result.workflows.score}`,
     "",
     "Overall:",
@@ -56,7 +58,8 @@ export function formatContextOSReady(result) {
     "",
     "Evidence:",
     `- Rules: ${result.rules.summary}`,
-    `- Skills: ${result.skills.summary}`,
+    `- Skill Coverage: ${result.skills.summary}`,
+    `- Project Skill Overrides: ${result.skills.projectSummary}`,
     `- Workflows: ${result.workflows.summary}`
   ];
 
@@ -108,10 +111,15 @@ function inspectRules({ cwd, root, home }) {
   };
 }
 
-function inspectSkills({ root }) {
-  const roots = PROJECT_SKILL_ROOTS.map((parts) => path.join(root, ...parts));
-  const skills = scanSkills({ cwd: root, roots, maxSkills: 500 });
-  const metadataFiles = findFiles(roots, (filePath) => /skill\.ya?ml$/i.test(path.basename(filePath)));
+function inspectSkills({ root, home }) {
+  const projectRoots = PROJECT_SKILL_ROOTS.map((parts) => path.join(root, ...parts));
+  const roots = skillSearchRoots({ cwd: root, home });
+  const skills = scanSkills({ cwd: root, roots, maxSkills: 5000 });
+  const projectSkills = skills.filter((skill) => skill.scope === "project");
+  const sharedSkills = skills.filter((skill) => skill.scope !== "project");
+  const communitySkills = skills.filter((skill) => isCommunitySkillPath(skill.path));
+  const globalSkills = sharedSkills.filter((skill) => !isCommunitySkillPath(skill.path));
+  const metadataFiles = findFiles(projectRoots, (filePath) => /skill\.ya?ml$/i.test(path.basename(filePath)));
   const richMetadata = metadataFiles.filter((filePath) => {
     const content = safeRead(filePath);
     return /^positive_triggers:/m.test(content)
@@ -123,29 +131,52 @@ function inspectSkills({ root }) {
   const recommendations = [];
 
   if (skills.length) score += 50;
-  else recommendations.push("Add project skills under .codex/skills/ or .agents/skills/.");
+  else recommendations.push("Sync or install global skills with `ctx setup` or `ctx sync --skills`.");
 
-  if (metadataFiles.length) score += 20;
-  else recommendations.push("Add skill.yaml metadata beside important SKILL.md files.");
+  if (sharedSkills.length || projectSkills.length >= 3) score += 25;
 
-  if (richMetadata.length) score += 20;
-  else recommendations.push("Include positive_triggers, negative_triggers, evidence, and workflow in skill.yaml.");
+  if (projectSkills.length) score += 10;
 
-  if (skills.length >= 3) score += 10;
-  else recommendations.push("Provide at least three project-relevant skills for common tasks.");
+  if (metadataFiles.length) score += 5;
+  if (richMetadata.length) score += 10;
+  if (projectSkills.length && !metadataFiles.length) {
+    recommendations.push("Add skill.yaml metadata beside project-specific SKILL.md files.");
+  }
+  if (projectSkills.length && !richMetadata.length) {
+    recommendations.push("Include positive_triggers, negative_triggers, evidence, and workflow in project skill.yaml files.");
+  }
 
   return {
     score: Math.min(100, score),
     count: skills.length,
+    globalCount: globalSkills.length,
+    communityCount: communitySkills.length,
+    sharedCount: sharedSkills.length,
+    projectCount: projectSkills.length,
+    projectOverrideScore: projectSkillOverrideScore(projectSkills),
     metadataCount: metadataFiles.length,
     richMetadataCount: richMetadata.length,
     summary: skills.length
-      ? `${skills.length} skill(s), ${metadataFiles.length} metadata file(s)`
-      : "missing project skill packs",
+      ? `${skills.length} skill(s): ${globalSkills.length} global, ${communitySkills.length} community/shared, ${projectSkills.length} project override(s)`
+      : "missing global/community/project skill catalog",
+    projectSummary: projectSkills.length
+      ? `${projectSkills.length} project override skill(s), ${metadataFiles.length} metadata file(s)`
+      : "0 project override skill(s); global/community skills remain valid",
     recommendations
   };
 }
 
+function projectSkillOverrideScore(projectSkills = []) {
+  if (projectSkills.length >= 3) return 100;
+  if (projectSkills.length === 2) return 70;
+  if (projectSkills.length === 1) return 40;
+  return 0;
+}
+
+function isCommunitySkillPath(filePath = "") {
+  return String(filePath || "").includes(`${path.sep}.config${path.sep}skillshare${path.sep}skills${path.sep}`);
+}
+
 function inspectWorkflows({ root }) {
   const roots = PROJECT_WORKFLOW_ROOTS.map((parts) => path.join(root, ...parts));
   const workflows = scanWorkflows({ cwd: root, roots });
@@ -175,6 +206,7 @@ function inspectWorkflows({ root }) {
 
 function readinessTier(overall, { rules, skills, workflows }) {
   if (rules.score < 50 || skills.score < 50 || workflows.score < 50) return "Not Ready";
+  if (!skills.projectCount && overall >= 85) return "Silver";
   if (overall >= 85) return "Gold";
   if (overall >= 70) return "Silver";
   if (overall >= 50) return "Bronze";

package/plugins/ctx/lib/project-context-generator.js

@@ -4,6 +4,7 @@ import path from "node:path";
 import { clearSkillScanCache } from "./skill-discoverer.js";
 
 const STARTER_SKILL_LIMIT = 3;
+const SHARED_PROJECT_CONTEXT_DIR = ".agents";
 
 export function generateProjectContext({ cwd = process.cwd(), force = false } = {}) {
   const root = findProjectRoot(cwd);
@@ -13,7 +14,7 @@ export function generateProjectContext({ cwd = process.cwd(), force = false } =
   const skipped = [];
 
   for (const skill of skills) {
-    const dir = path.join(root, ".codex", "skills", skill.id);
+    const dir = path.join(root, SHARED_PROJECT_CONTEXT_DIR, "skills", skill.id);
     const skillPath = path.join(dir, "SKILL.md");
     const yamlPath = path.join(dir, "skill.yaml");
     fs.mkdirSync(dir, { recursive: true });
@@ -21,7 +22,7 @@ export function generateProjectContext({ cwd = process.cwd(), force = false } =
     writeFile({ filePath: yamlPath, content: renderSkillYaml(skill), force, created, skipped });
   }
 
-  const workflowPath = path.join(root, ".codex", "workflows", "primary.md");
+  const workflowPath = path.join(root, SHARED_PROJECT_CONTEXT_DIR, "workflows", "primary.md");
   fs.mkdirSync(path.dirname(workflowPath), { recursive: true });
   writeFile({
     filePath: workflowPath,
@@ -61,7 +62,8 @@ export function formatProjectContextGeneration(result) {
     for (const filePath of result.skipped) lines.push(`- ${path.relative(result.root, filePath)}`);
   }
   lines.push("", "Next:");
-  lines.push("- Review generated skills/workflow and edit project-specific wording.");
+  lines.push("- Review generated shared skills/workflow and edit project-specific wording.");
+  lines.push("- Run: ctx sync --skills && ctx sync --workflows");
   lines.push("- Run: ctx doctor");
   lines.push("- Run: ctx debug -- \"your task\"");
   return lines.join("\n");

package/plugins/ctx/lib/skill-discoverer.js

@@ -551,7 +551,16 @@ function inferSkillMetadata(skill = {}) {
   }
   if (/\bnext|app router\b/.test(text)) {
     metadata.dependencies.push("next", "react");
-    metadata.positivePrompts.push("frontend", "ui", "role", "dashboard", "app router");
+    metadata.positivePrompts.push("frontend", "ui", "role", "dashboard", "app router", "page", "webapp");
+  }
+  if (/\b(frontend|react|ui|component|layout|design)\b/.test(text)) {
+    metadata.dependencies.push("react");
+    metadata.positivePrompts.push("frontend", "ui", "component", "page", "layout", "button", "modal");
+  }
+  if (/\b(forum|topic|community|chat|message|realtime|websocket|socket|conversation)\b/.test(text)) {
+    metadata.positivePrompts.push("forum", "topic", "new topic", "trending", "chat", "chatting", "message", "realtime", "websocket");
+    metadata.files.push("package.json", "webapp/package.json", "services/*/package.json");
+    metadata.dependencies.push("next", "react", "socket.io", "ws", "@nestjs/websockets");
   }
   return metadata;
 }
@@ -570,16 +579,18 @@ function hybridSkillScore(skill, { prompt, projectEvidence }) {
   const projectEvidenceScore = dependencyEvidence.score;
   const fileConfigScore = fileEvidence.score;
   const importGraphScore = 0;
+  const sourceBoostScore = skillSourceBoostScore(skill);
   const externalGraphScore = 0;
   const memoryScore = 0;
   const hybridScore = Math.max(0, Math.min(1,
-    semanticScore * 0.30
+    semanticScore * 0.25
     + promptMatch.score * 0.20
-    + projectEvidenceScore * 0.20
+    + projectEvidenceScore * 0.25
     + fileConfigScore * 0.10
     + importGraphScore * 0.10
-    + externalGraphScore * 0.05
-    + memoryScore * 0.05
+    + sourceBoostScore * 0.05
+    + externalGraphScore * 0.03
+    + memoryScore * 0.02
     - negativePenalty * 0.20
   ));
   const explicit = (skill.reasons || []).includes("explicit-skill");
@@ -590,13 +601,15 @@ function hybridSkillScore(skill, { prompt, projectEvidence }) {
     dependencyEvidence,
     fileEvidence,
     negativePenalty,
-    explicit
+    explicit,
+    semanticScore
   });
   const evidence = [...new Set([
     ...(skill.reasons || []),
     ...promptMatch.matches.map((item) => `prompt:${item}`),
     ...dependencyEvidence.matches.map((item) => `dependency:${item}`),
-    ...fileEvidence.matches.map((item) => `file:${item}`)
+    ...fileEvidence.matches.map((item) => `file:${item}`),
+    ...(sourceBoostScore ? [`source:${skillSourceLabel(skill)}`] : [])
   ])];
   const negativeEvidence = [
     ...negativeDependencies.matches.map((item) => `dependency:${item}`),
@@ -618,6 +631,7 @@ function hybridSkillScore(skill, { prompt, projectEvidence }) {
     projectEvidenceScore,
     fileConfigScore,
     importGraphScore,
+    sourceBoostScore,
     externalGraphScore,
     memoryScore,
     graphScore: externalGraphScore,
@@ -636,7 +650,8 @@ function calibrateSkillConfidence(score, {
   dependencyEvidence,
   fileEvidence,
   negativePenalty = 0,
-  explicit = false
+  explicit = false,
+  semanticScore = 0
 } = {}) {
   let confidence = Math.max(0, Math.min(1, Number(score || 0)));
   const hasDependencyEvidence = Boolean(dependencyEvidence?.matches?.length);
@@ -647,6 +662,9 @@ function calibrateSkillConfidence(score, {
   if (!hasProjectEvidence && !explicit) {
     confidence = Math.min(confidence, 0.62);
   }
+  if (!hasProjectEvidence && hasPromptEvidence && Number(semanticScore || 0) >= 0.75 && !explicit) {
+    confidence = Math.max(confidence, 0.56);
+  }
   if (isAmbiguousPrompt(prompt) && !(hasDependencyEvidence && hasFileEvidence) && !explicit) {
     confidence = Math.min(confidence, 0.64);
   }
@@ -662,6 +680,22 @@ function calibrateSkillConfidence(score, {
   return Math.max(0, Math.min(1, confidence));
 }
 
+function skillSourceBoostScore(skill = {}) {
+  if (skill.scope === "project") return 1;
+  if (isCommunitySkill(skill)) return 0.4;
+  return 0;
+}
+
+function skillSourceLabel(skill = {}) {
+  if (skill.scope === "project") return "project";
+  if (isCommunitySkill(skill)) return "community";
+  return "global";
+}
+
+function isCommunitySkill(skill = {}) {
+  return String(skill.path || "").includes(`${path.sep}.config${path.sep}skillshare${path.sep}skills${path.sep}`);
+}
+
 function confidenceBand(confidence) {
   const value = Number(confidence || 0);
   if (value >= 0.85) return "high";

package/plugins/ctx/lib/workflow-discoverer.js

@@ -30,11 +30,13 @@ const KNOWN_AGENT_NAMES = new Set([
 
 export function workflowSearchRoots({ cwd = process.cwd(), home = os.homedir() } = {}) {
   return [
+    path.join(cwd, ".agents", "workflows"),
     path.join(cwd, ".claude", "workflows"),
     path.join(cwd, ".codex", "workflows"),
     path.join(cwd, ".gemini", "workflows"),
     path.join(cwd, ".gemini", "antigravity", "workflows"),
     path.join(cwd, ".gemini", "antigravity-cli", "workflows"),
+    path.join(home, ".agents", "workflows"),
     path.join(home, ".claude", "workflows"),
     path.join(home, ".codex", "workflows"),
     path.join(home, ".gemini", "workflows"),

package/plugins/ctx/mcp/proxy.js

@@ -9,6 +9,9 @@ const { serverName, command, args } = parseArgs(process.argv.slice(2));
 const cwd = process.cwd();
 const telemetryPath = path.join(workspaceDataDir({ cwd }), "telemetry.jsonl");
 let inspectBuffer = "";
+let childExit = null;
+let pendingStdinWrites = 0;
+let stdinEnded = false;
 
 const child = spawn(command, args, {
   cwd,
@@ -18,20 +21,32 @@ const child = spawn(command, args, {
 
 process.stdin.on("data", (chunk) => {
   inspectClientChunk(chunk);
-  child.stdin.write(chunk);
+  pendingStdinWrites += 1;
+  if (!child.stdin.write(chunk, onChildStdinWrite)) process.stdin.pause();
 });
 
-process.stdin.on("end", () => {
-  child.stdin.end();
+child.stdin.on("drain", () => {
+  process.stdin.resume();
 });
 
-child.stdout.on("data", (chunk) => {
-  process.stdout.write(chunk);
+process.stdin.on("end", () => {
+  stdinEnded = true;
+  maybeEndChildStdin();
 });
 
-child.stderr.on("data", (chunk) => {
-  process.stderr.write(chunk);
-});
+function onChildStdinWrite() {
+  pendingStdinWrites -= 1;
+  maybeEndChildStdin();
+}
+
+function maybeEndChildStdin() {
+  if (stdinEnded && pendingStdinWrites === 0 && !child.stdin.destroyed) {
+    child.stdin.end();
+  }
+}
+
+child.stdout.pipe(process.stdout);
+child.stderr.pipe(process.stderr);
 
 child.on("error", (error) => {
   process.stderr.write(`contextos mcp proxy failed to start ${serverName}: ${error?.message || String(error)}\n`);
@@ -39,10 +54,16 @@ child.on("error", (error) => {
 });
 
 child.on("exit", (code, signal) => {
-  if (signal) process.kill(process.pid, signal);
-  else process.exit(code ?? 0);
+  childExit = { code, signal };
+  maybeFinish();
 });
 
+function maybeFinish() {
+  if (!childExit) return;
+  if (childExit.signal) process.kill(process.pid, childExit.signal);
+  else process.exitCode = childExit.code ?? 0;
+}
+
 function inspectClientChunk(chunk) {
   inspectBuffer += chunk.toString("utf8");
   const lines = inspectBuffer.split(/\r?\n/);