autotel-cli 0.16.2 → 0.17.0

package/dist/index.js

@@ -3307,6 +3307,73 @@ function checkLoggerInstrumentation(packageRoot, deps) {
 	};
 }
 //#endregion
+//#region src/lib/capture-coverage.ts
+/**
+* Mirrors `CAPTURE_SURFACES` in `autotel/evidence`, duplicated because the CLI
+* does not depend on the runtime package. Keep the two lists in step.
+*/
+const CAPTURE_SURFACES = [
+	"llm_calls",
+	"tool_calls",
+	"user_prompts",
+	"file_io",
+	"subprocess",
+	"network",
+	"ide_context"
+];
+/**
+* Which dependency makes each surface observable. A surface with no rule is
+* unobservable by anything in the toolchain — `subprocess` and `ide_context`
+* are there deliberately, and reporting them is the most useful line this check
+* produces. Adding a rule here is how a surface stops being reported as a blind
+* spot, so an omission understates coverage rather than overstating it.
+*/
+const OBSERVED_BY = {
+	llm_calls: ["autotel-genai"],
+	tool_calls: ["autotel-genai", "autotel-mcp-instrumentation"],
+	user_prompts: ["autotel-agents"],
+	file_io: ["@opentelemetry/instrumentation-fs", "@opentelemetry/auto-instrumentations-node"],
+	network: [
+		"@opentelemetry/instrumentation-http",
+		"@opentelemetry/instrumentation-undici",
+		"@opentelemetry/auto-instrumentations-node"
+	]
+};
+function assessCaptureCoverage(deps) {
+	const observed = [];
+	const unobserved = [];
+	for (const surface of CAPTURE_SURFACES) if ((OBSERVED_BY[surface] ?? []).some((pkg) => deps[pkg] !== void 0)) observed.push(surface);
+	else unobserved.push(surface);
+	return {
+		observed,
+		unobserved
+	};
+}
+const NO_SOURCE = "nothing in the autotel toolchain observes this";
+function sourceHint(surface) {
+	const sources = OBSERVED_BY[surface];
+	return sources ? `install one of: ${sources.join(", ")}` : NO_SOURCE;
+}
+/** One check per surface, for `autotel doctor --capture`. */
+function captureCoverageChecks(deps) {
+	const { observed, unobserved } = assessCaptureCoverage(deps);
+	return [...observed.map((surface) => ({
+		id: `capture-${surface}`,
+		title: `Capture: ${surface}`,
+		level: "info",
+		status: "ok",
+		message: `${surface} is observable`
+	})), ...unobserved.map((surface) => ({
+		id: `capture-${surface}`,
+		title: `Capture: ${surface}`,
+		level: "info",
+		status: "warn",
+		informational: true,
+		message: `traces cannot show ${surface} — its absence proves nothing`,
+		details: [sourceHint(surface), "Declare the gap on your spans with captureCoverageAttributes() from autotel/evidence"]
+	}))];
+}
+//#endregion
 //#region src/commands/doctor.ts
 /**
 * All available check definitions
@@ -3346,6 +3413,11 @@ const CHECK_DEFINITIONS = [
 		id: "logger-instrumentation",
 		title: "Logger instrumentation",
 		description: "Check if logger instrumentation packages are installed"
+	},
+	{
+		id: "capture-coverage",
+		title: "Capture coverage",
+		description: "Report which capture surfaces this project can observe at all (--capture)"
 	}
 ];
 /**
@@ -3379,6 +3451,7 @@ async function runChecks(options, projectRoot) {
 		...project.packageJson.dependencies,
 		...project.packageJson.devDependencies
 	};
+	if (options.capture) checks.push(...captureCoverageChecks(deps));
 	const autotelInfo = getAutotelInfo(project.packageJson);
 	if (autotelInfo.installed) checks.push({
 		id: "autotel-installed",
@@ -3583,11 +3656,14 @@ function calculateSummary(checks) {
 	};
 }
 /**
-* Determine exit code from checks
+* Determine exit code from checks. Informational checks are excluded: they
+* describe what the setup can observe rather than judging it, and a permanent
+* fact of the world must not gate CI.
 */
 function getExitCode(checks) {
-	const hasErrors = checks.some((c) => c.status === "error");
-	const hasWarnings = checks.some((c) => c.status === "warn");
+	const judged = checks.filter((c) => !c.informational);
+	const hasErrors = judged.some((c) => c.status === "error");
+	const hasWarnings = judged.some((c) => c.status === "warn");
 	if (hasErrors) return 2;
 	if (hasWarnings) return 1;
 	return 0;
@@ -6638,6 +6714,10 @@ const COMMANDS = [
 				name: "--env-file",
 				takesValue: true,
 				description: "Path to env file to check"
+			},
+			{
+				name: "--capture",
+				description: "Report which capture surfaces this project can observe at all"
 			}
 		],
 		mutating: false,
@@ -9450,7 +9530,7 @@ function createProgram() {
 	});
 	addGlobalOptions(initCmd);
 	program.addCommand(initCmd);
-	const doctorCmd = new Command("doctor").description("Run diagnostics on your autotel setup").option("--json", "Output machine-readable JSON").option("--fix", "Auto-fix resolvable issues").option("--list-checks", "List all available checks").option("--env-file <path>", "Specify env file to check").action(async (opts) => {
+	const doctorCmd = new Command("doctor").description("Run diagnostics on your autotel setup").option("--json", "Output machine-readable JSON").option("--fix", "Auto-fix resolvable issues").option("--list-checks", "List all available checks").option("--env-file <path>", "Specify env file to check").option("--capture", "Report which capture surfaces this project can observe at all").action(async (opts) => {
 		await runDoctor({
 			cwd: opts.cwd ?? process.cwd(),
 			dryRun: false,
@@ -9462,7 +9542,8 @@ function createProgram() {
 			json: opts.json ?? false,
 			fix: opts.fix ?? false,
 			listChecks: opts.listChecks ?? false,
-			envFile: opts.envFile
+			envFile: opts.envFile,
+			capture: opts.capture ?? false
 		});
 	});
 	addGlobalOptions(doctorCmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-cli",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "CLI for autotel - setup wizard, diagnostics, and incremental features",
   "type": "module",
   "bin": {