fix: smoke-test 3.6.0 bugs + quality gates

[chenliuyun]

Summary

• Fix 9 bugs found in 3.6.0 smoke test (strict int parsing, dry-run stdout discipline, excess arguments, format support, catalog search validation)
• Add parseStrictInt() as single source of truth for integer validation (rejects leading zeros, whitespace; accepts +N)
• Migrate all dry-run/diagnostic output from stdout to stderr across 10 commands
• Add scripts/lint-stdout.sh quality gate (dry-run channel enforcement, bare Number() detection, command test coverage)
• Add scripts/verify-release.mjs pre-release invariant checker (MCP tool count, audit version, doc consistency)
• Add tests/contract/format-matrix.test.ts (health + catalog × 5 formats)
• Add catalog-coverage doctor check

Test plan

• npm test — 2385 tests pass
• bash scripts/lint-stdout.sh — all checks pass
• node scripts/verify-release.mjs — no errors
• npm run typecheck — clean

🤖 Generated with Claude Code

[chenliuyun]

Code review

Found 3 issues:

1. rules explain data field incorrectly moved to stderr. The dry_run: true line at line 896 is a structured output field in a key-value report (alongside hysteresis:, maxFiringsPerHour:, suppressIfAlreadyDesired:, last fired: — all on stdout). Moving only this field to stderr breaks the report format. The lint script (lint-stdout.sh) false-positive matched console.log.*dry.run but this is a rule property, not a dry-run diagnostic.

switchbot-openapi-cli/src/commands/rules.ts

Lines 893 to 897 in fc16327

	if (detail.hysteresis) console.log(`hysteresis: ${detail.hysteresis}`);
	if (detail.maxFiringsPerHour !== null) console.log(`maxFiringsPerHour: ${detail.maxFiringsPerHour}`);
	if (detail.suppressIfAlreadyDesired) console.log(`suppressIfAlreadyDesired: true`);
	if (detail.dryRun) console.error(`dry_run: true`);
	console.log(`last fired: ${detail.lastFired ?? '(never)'}`);

2. health.ts renames breakdown key from 'unknown' to 'client' (line 113) — a JSON output schema change visible to consumers of health check --json. The test fixture at tests/commands/health-check.test.ts:153 still references breakdown: { 'unknown': 4 } and was not updated to match.

switchbot-openapi-cli/src/utils/health.ts

Lines 112 to 114 in fc16327

	for (const e of errorEntries) {
	const code = e.statusCode !== undefined ? String(e.statusCode) : 'client';
	breakdown[code] = (breakdown[code] ?? 0) + 1;

3. New catalog-coverage doctor check added in doctor.ts but not listed in README.md (line 635). CLAUDE.md pre-release checklist item fix: derive CLI version from package.json (v1.3.2) #4 says: "Doctor checks — compare [...] against the list in README.md. All checks must be listed."

switchbot-openapi-cli/src/commands/doctor.ts

Lines 998 to 1000 in fc16327

	{ name: 'catalog', description: 'catalog loads', run: () => checkCatalog() },
	{ name: 'catalog-coverage', description: 'all cached device types have catalog entries', run: () => checkCatalogCoverage() },
	{ name: 'catalog-schema', description: 'catalog vs agent-bootstrap version aligned', run: () => checkCatalogSchema() },

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}