@aaronsb/google-workspace-mcp 2.2.0 → 2.5.0

package/build/coverage/analyze.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Build-time coverage analysis tool (ADR-100).
+ *
+ * Compares the curated manifest against the gws CLI's actual surface
+ * to produce a structured coverage report.
+ *
+ * Usage:
+ *   node build/coverage/analyze.js           # print coverage report
+ *   node build/coverage/analyze.js --update   # also update baseline file
+ *   node build/coverage/analyze.js --json     # output as JSON
+ */
+import { loadManifest } from '../factory/generator.js';
+import { discoverSurface } from './discover.js';
+import { compareSurfaces } from './compare.js';
+import { loadBaseline, generateBaseline, writeBaseline } from './baseline.js';
+import { formatTerminalReport, formatJsonReport } from './report.js';
+const args = process.argv.slice(2);
+const doUpdate = args.includes('--update');
+const jsonOutput = args.includes('--json');
+async function main() {
+    // Load curated manifest (same parser the server uses)
+    const manifest = loadManifest();
+    // Load existing baseline (if any)
+    const baseline = loadBaseline();
+    // Discover the gws CLI surface
+    process.stderr.write('[coverage] Discovering gws CLI surface...\n');
+    const discovered = discoverSurface();
+    // Compare
+    const report = compareSurfaces(manifest, discovered, baseline);
+    // Output
+    if (jsonOutput) {
+        process.stdout.write(formatJsonReport(report) + '\n');
+    }
+    else {
+        process.stdout.write(formatTerminalReport(report));
+    }
+    // Update baseline if requested
+    if (doUpdate) {
+        const newBaseline = generateBaseline(report, discovered, baseline);
+        const path = writeBaseline(newBaseline);
+        process.stderr.write(`[coverage] Baseline updated: ${path}\n`);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`[coverage] Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=analyze.js.map

package/build/coverage/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/coverage/analyze.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,sDAAsD;IACtD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAEhC,kCAAkC;IAClC,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAEhC,+BAA+B;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;IAErC,UAAU;IACV,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE/D,SAAS;IACT,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,IAAI,IAAI,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/coverage/baseline.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Baseline file management for coverage tracking.
+ */
+import type { CoverageBaseline, CoverageReport, DiscoveredSurface } from './types.js';
+export declare function loadBaseline(filePath?: string): CoverageBaseline | null;
+/** Generate a new baseline from a coverage report + discovered surface. */
+export declare function generateBaseline(report: CoverageReport, discovered: DiscoveredSurface, existing?: CoverageBaseline | null): CoverageBaseline;
+export declare function writeBaseline(baseline: CoverageBaseline, filePath?: string): string;

package/build/coverage/baseline.js

@@ -0,0 +1,91 @@
+/**
+ * Baseline file management for coverage tracking.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DEFAULT_PATH = 'coverage-baseline.json';
+function resolvePath(filePath) {
+    const p = filePath || DEFAULT_PATH;
+    return path.isAbsolute(p) ? p : path.join(process.cwd(), p);
+}
+export function loadBaseline(filePath) {
+    const resolved = resolvePath(filePath);
+    try {
+        const raw = fs.readFileSync(resolved, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Build the set of manifest-covered resource/helper paths. */
+function getCoveredPaths(report) {
+    const covered = new Set();
+    for (const svc of report.services) {
+        // Ops with param gaps are covered
+        for (const opPath of Object.keys(svc.paramGaps)) {
+            covered.add(`${svc.service}:${opPath}`);
+        }
+    }
+    return covered;
+}
+/** Generate a new baseline from a coverage report + discovered surface. */
+export function generateBaseline(report, discovered, existing) {
+    const services = {};
+    // Build a lookup of covered paths from the report's param gaps
+    // (ops with param gaps are definitely covered)
+    const paramGapPaths = getCoveredPaths(report);
+    for (const svc of report.services) {
+        const disc = discovered.services[svc.service];
+        if (!disc)
+            continue;
+        const existingOps = existing?.services[svc.service]?.operations || {};
+        const operations = {};
+        // Enumerate all discovered operations
+        const allPaths = new Set([
+            ...Object.keys(disc.operations),
+            ...Object.keys(disc.helpers),
+        ]);
+        for (const opPath of allPaths) {
+            // Check if excluded in existing baseline — preserve
+            if (existingOps[opPath]?.status === 'excluded') {
+                operations[opPath] = existingOps[opPath];
+                continue;
+            }
+            // Check if covered (has param gaps recorded)
+            const key = `${svc.service}:${opPath}`;
+            if (paramGapPaths.has(key)) {
+                const gaps = svc.paramGaps[opPath] || [];
+                operations[opPath] = {
+                    status: 'covered',
+                    params: gaps.length > 0
+                        ? Object.fromEntries(gaps.map(g => [g.paramName, g.inManifest ? 'covered' : 'gap']))
+                        : undefined,
+                };
+                continue;
+            }
+            // Check if it's covered but without param gaps — need to check the report counts
+            // We can infer from whether the op was NOT in newOps and NOT excluded
+            const isNew = svc.newOps.includes(opPath);
+            const wasCovered = existingOps[opPath]?.status === 'covered';
+            if (wasCovered && !isNew) {
+                operations[opPath] = { status: 'covered' };
+            }
+            else {
+                operations[opPath] = { status: 'gap' };
+            }
+        }
+        services[svc.service] = { operations };
+    }
+    return {
+        gwsVersion: report.gwsVersion,
+        generatedAt: report.timestamp,
+        services,
+    };
+}
+export function writeBaseline(baseline, filePath) {
+    const resolved = resolvePath(filePath);
+    fs.writeFileSync(resolved, JSON.stringify(baseline, null, 2) + '\n');
+    return resolved;
+}
+//# sourceMappingURL=baseline.js.map

package/build/coverage/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../src/coverage/baseline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,SAAS,WAAW,CAAC,QAAiB;IACpC,MAAM,CAAC,GAAG,QAAQ,IAAI,YAAY,CAAC;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,SAAS,eAAe,CAAC,MAAsB;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClC,kCAAkC;QAClC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAC9B,MAAsB,EACtB,UAA6B,EAC7B,QAAkC;IAElC,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAElD,+DAA+D;IAC/D,+CAA+C;IAC/C,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,WAAW,GAAG,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC;QACtE,MAAM,UAAU,GAAkC,EAAE,CAAC;QAErD,sCAAsC;QACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS;YAC/B,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YAC/B,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;SAC7B,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,oDAAoD;YACpD,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC/C,UAAU,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;gBACzC,SAAS;YACX,CAAC;YAED,6CAA6C;YAC7C,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;YACvC,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACzC,UAAU,CAAC,MAAM,CAAC,GAAG;oBACnB,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;wBACrB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAU,CAAC,CAAC;wBAC7F,CAAC,CAAC,SAAS;iBACd,CAAC;gBACF,SAAS;YACX,CAAC;YAED,iFAAiF;YACjF,sEAAsE;YACtE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC;YAE7D,IAAI,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;gBACzB,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACzC,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,SAAS;QAC7B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAA0B,EAAE,QAAiB;IACzE,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/build/coverage/compare.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compare curated manifest against discovered gws CLI surface.
+ */
+import type { Manifest } from '../factory/types.js';
+import type { DiscoveredSurface, CoverageBaseline, CoverageReport } from './types.js';
+export declare function compareSurfaces(manifest: Manifest, discovered: DiscoveredSurface, baseline?: CoverageBaseline | null): CoverageReport;

package/build/coverage/compare.js

@@ -0,0 +1,129 @@
+/**
+ * Compare curated manifest against discovered gws CLI surface.
+ */
+import { ELIGIBLE_SERVICES, SKIP_PARAMS } from './types.js';
+/** Build a set of gws resource paths and helper names covered by the manifest. */
+function buildCoveredPaths(manifest) {
+    const covered = new Map();
+    for (const [serviceName, serviceDef] of Object.entries(manifest.services)) {
+        for (const [opName, opDef] of Object.entries(serviceDef.operations)) {
+            const path = opDef.resource || opDef.helper;
+            if (!path)
+                continue;
+            const paramNames = new Set();
+            if (opDef.params) {
+                for (const [name, paramDef] of Object.entries(opDef.params)) {
+                    // Use maps_to if declared, otherwise the param name itself
+                    paramNames.add(paramDef.maps_to || name);
+                }
+            }
+            covered.set(path, {
+                service: serviceDef.gws_service,
+                opName,
+                params: paramNames,
+            });
+        }
+    }
+    return covered;
+}
+/** Compare params for a covered operation. */
+function compareParams(manifestParams, gwsParams) {
+    const gaps = [];
+    for (const [name, param] of Object.entries(gwsParams)) {
+        if (SKIP_PARAMS.has(name))
+            continue;
+        if (param.deprecated)
+            continue;
+        if (!manifestParams.has(name)) {
+            gaps.push({
+                paramName: name,
+                inGws: true,
+                inManifest: false,
+                details: `${param.type}${param.required ? ', required' : ''} — ${param.description.slice(0, 80)}`,
+            });
+        }
+    }
+    return gaps;
+}
+export function compareSurfaces(manifest, discovered, baseline) {
+    const coveredPaths = buildCoveredPaths(manifest);
+    const serviceCoverages = [];
+    let totalOps = 0;
+    let totalCovered = 0;
+    for (const service of ELIGIBLE_SERVICES) {
+        const disc = discovered.services[service];
+        if (!disc) {
+            // Service exists in eligible list but gws doesn't expose it
+            continue;
+        }
+        const baselineOps = baseline?.services[service]?.operations || {};
+        const allOps = new Set();
+        // Add resource-based operations
+        for (const path of Object.keys(disc.operations)) {
+            allOps.add(path);
+        }
+        // Add helpers
+        for (const name of Object.keys(disc.helpers)) {
+            allOps.add(name);
+        }
+        let covered = 0;
+        let excluded = 0;
+        let gap = 0;
+        const newOps = [];
+        const removedOps = [];
+        const paramGaps = {};
+        for (const opPath of allOps) {
+            const isCovered = coveredPaths.has(opPath);
+            const baselineEntry = baselineOps[opPath];
+            const wasInBaseline = !!baselineEntry;
+            if (isCovered) {
+                covered++;
+                // Check param gaps for resource-based operations
+                const discOp = disc.operations[opPath];
+                const manifestEntry = coveredPaths.get(opPath);
+                if (discOp && manifestEntry) {
+                    const gaps = compareParams(manifestEntry.params, discOp.params);
+                    if (gaps.length > 0) {
+                        paramGaps[opPath] = gaps;
+                    }
+                }
+            }
+            else if (baselineEntry?.status === 'excluded') {
+                excluded++;
+            }
+            else {
+                gap++;
+                if (!wasInBaseline) {
+                    newOps.push(opPath);
+                }
+            }
+        }
+        // Check for removed operations (in baseline but gone from gws)
+        for (const opPath of Object.keys(baselineOps)) {
+            if (!allOps.has(opPath)) {
+                removedOps.push(opPath);
+            }
+        }
+        totalOps += allOps.size;
+        totalCovered += covered;
+        serviceCoverages.push({
+            service,
+            totalOps: allOps.size,
+            coveredOps: covered,
+            excludedOps: excluded,
+            gapOps: gap,
+            newOps,
+            removedOps,
+            paramGaps,
+        });
+    }
+    return {
+        gwsVersion: discovered.gwsVersion,
+        timestamp: new Date().toISOString(),
+        totalOps: totalOps,
+        coveredOps: totalCovered,
+        coveragePercent: totalOps > 0 ? Math.round((totalCovered / totalOps) * 100) : 0,
+        services: serviceCoverages,
+    };
+}
+//# sourceMappingURL=compare.js.map

package/build/coverage/compare.js.map

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

package/build/coverage/discover.d.ts

@@ -0,0 +1,7 @@
+/**
+ * gws CLI surface discovery — enumerates services, resources, methods,
+ * helpers, and parameter schemas by invoking the gws binary.
+ */
+import { type DiscoveredSurface } from './types.js';
+/** Discover the full gws CLI surface for all eligible services. */
+export declare function discoverSurface(): DiscoveredSurface;

package/build/coverage/discover.js

@@ -0,0 +1,168 @@
+/**
+ * gws CLI surface discovery — enumerates services, resources, methods,
+ * helpers, and parameter schemas by invoking the gws binary.
+ */
+import { execFileSync } from 'node:child_process';
+import { resolveGwsBinary } from '../executor/gws.js';
+import { ELIGIBLE_SERVICES, SKIP_PARAMS, } from './types.js';
+const TIMEOUT = 10_000;
+let cachedBinary;
+function getBinary() {
+    if (!cachedBinary)
+        cachedBinary = resolveGwsBinary();
+    return cachedBinary;
+}
+function gws(args) {
+    return execFileSync(getBinary(), args, {
+        encoding: 'utf8',
+        timeout: TIMEOUT,
+        env: { ...process.env },
+    });
+}
+function gwsSafe(args) {
+    try {
+        return execFileSync(getBinary(), args, {
+            encoding: 'utf8',
+            timeout: TIMEOUT,
+            env: { ...process.env },
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse service --help to find resources and helpers. */
+function parseServiceHelp(output) {
+    const resources = [];
+    const helpers = [];
+    for (const line of output.split('\n')) {
+        const trimmed = line.trimStart();
+        // Helpers: lines starting with +
+        const helperMatch = trimmed.match(/^(\+\w+)\s+(?:\[Helper\]\s*)?(.*)$/);
+        if (helperMatch) {
+            helpers.push({ name: helperMatch[1], description: helperMatch[2].trim() });
+            continue;
+        }
+        // Resources: "word  Operations on the '...' resource"
+        const resourceMatch = trimmed.match(/^(\w+)\s+Operations on the/);
+        if (resourceMatch && resourceMatch[1] !== 'help') {
+            resources.push(resourceMatch[1]);
+        }
+    }
+    return { resources, helpers };
+}
+/** Parse resource --help to find methods and sub-resources. */
+function parseResourceHelp(output) {
+    const methods = [];
+    const subResources = [];
+    for (const line of output.split('\n')) {
+        const trimmed = line.trimStart();
+        if (!trimmed || trimmed.startsWith('Usage:') || trimmed.startsWith('FLAGS:'))
+            continue;
+        const resourceMatch = trimmed.match(/^(\w+)\s+Operations on the/);
+        if (resourceMatch && resourceMatch[1] !== 'help') {
+            subResources.push(resourceMatch[1]);
+            continue;
+        }
+        // Methods: "word  Description text" (not "help", not "Operations on")
+        const methodMatch = trimmed.match(/^(\w+)\s+\S/);
+        if (methodMatch && methodMatch[1] !== 'help' && !trimmed.includes('Operations on')) {
+            methods.push(methodMatch[1]);
+        }
+    }
+    return { methods, subResources };
+}
+/** Parse gws schema JSON output into DiscoveredParam records. */
+function parseSchemaParams(json) {
+    const params = {};
+    try {
+        const schema = JSON.parse(json);
+        const rawParams = schema.parameters || {};
+        for (const [name, def] of Object.entries(rawParams)) {
+            if (SKIP_PARAMS.has(name))
+                continue;
+            const p = def;
+            params[name] = {
+                type: String(p.type === 'integer' ? 'number' : (p.type || 'string')),
+                description: String(p.description || '').replace(/\n/g, ' ').slice(0, 200),
+                required: Boolean(p.required),
+                ...(p.default !== undefined ? { default: p.default } : {}),
+                ...(p.enum ? { enum: p.enum } : {}),
+                ...(p.deprecated ? { deprecated: true } : {}),
+            };
+        }
+    }
+    catch {
+        // Schema parse failed — return empty params
+    }
+    return params;
+}
+/** Recursively discover methods under a resource path. */
+function discoverResource(service, parentPath, parts) {
+    const operations = {};
+    const helpOutput = gwsSafe([service, ...parts, '--help']);
+    if (!helpOutput)
+        return operations;
+    const { methods, subResources } = parseResourceHelp(helpOutput);
+    for (const method of methods) {
+        const resourcePath = `${parentPath}.${method}`;
+        // gws schema uses flat resource names (e.g. drive.replies.list),
+        // not nested CLI paths (e.g. drive.comments.replies.list).
+        // Try the full path first, fall back to leaf resource + method.
+        const leafResource = parts[parts.length - 1];
+        const schemaOutput = gwsSafe(['schema', `${service}.${parentPath}.${method}`])
+            || (parts.length > 1 ? gwsSafe(['schema', `${service}.${leafResource}.${method}`]) : null);
+        let params = {};
+        let description = '';
+        let httpMethod;
+        if (schemaOutput) {
+            params = parseSchemaParams(schemaOutput);
+            try {
+                const schema = JSON.parse(schemaOutput);
+                description = String(schema.description || '').replace(/\n/g, ' ').slice(0, 200);
+                httpMethod = schema.httpMethod;
+            }
+            catch { /* ignore */ }
+        }
+        operations[resourcePath] = { resourcePath, description, httpMethod, params };
+    }
+    for (const sub of subResources) {
+        const subOps = discoverResource(service, `${parentPath}.${sub}`, [...parts, sub]);
+        Object.assign(operations, subOps);
+    }
+    return operations;
+}
+/** Discover the full surface of a single gws service. */
+function discoverService(service) {
+    const helpOutput = gwsSafe([service, '--help']);
+    if (!helpOutput)
+        return { operations: {}, helpers: {} };
+    const { resources, helpers } = parseServiceHelp(helpOutput);
+    const helperMap = {};
+    for (const h of helpers) {
+        helperMap[h.name] = h;
+    }
+    let operations = {};
+    for (const resource of resources) {
+        const resourceOps = discoverResource(service, resource, [resource]);
+        operations = { ...operations, ...resourceOps };
+    }
+    return { operations, helpers: helperMap };
+}
+/** Discover the full gws CLI surface for all eligible services. */
+export function discoverSurface() {
+    // Get gws version
+    let gwsVersion = 'unknown';
+    try {
+        gwsVersion = gws(['--version']).trim().split('\n')[0];
+    }
+    catch { /* ignore */ }
+    const services = {};
+    for (const service of ELIGIBLE_SERVICES) {
+        process.stderr.write(`[coverage] discovering ${service}...\n`);
+        services[service] = discoverService(service);
+    }
+    return { gwsVersion, services };
+}
+//# sourceMappingURL=discover.js.map

package/build/coverage/discover.js.map

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

package/build/coverage/report.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Format coverage reports for terminal and JSON output.
+ */
+import type { CoverageReport } from './types.js';
+export declare function formatTerminalReport(report: CoverageReport): string;
+export declare function formatJsonReport(report: CoverageReport): string;

package/build/coverage/report.js

@@ -0,0 +1,93 @@
+/**
+ * Format coverage reports for terminal and JSON output.
+ */
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const CYAN = '\x1b[36m';
+const RESET = '\x1b[0m';
+function bar(covered, total, width = 20) {
+    if (total === 0)
+        return DIM + '░'.repeat(width) + RESET;
+    const filled = Math.round((covered / total) * width);
+    const color = (covered / total) >= 0.5 ? GREEN : (covered / total) >= 0.25 ? YELLOW : RED;
+    return color + '█'.repeat(filled) + RESET + DIM + '░'.repeat(width - filled) + RESET;
+}
+function pct(n, total) {
+    if (total === 0)
+        return '  -';
+    return `${Math.round((n / total) * 100).toString().padStart(3)}%`;
+}
+export function formatTerminalReport(report) {
+    const lines = [];
+    lines.push('');
+    lines.push(`${BOLD}gws CLI Coverage Analysis${RESET}`);
+    lines.push(`${DIM}gws version: ${report.gwsVersion}${RESET}`);
+    lines.push(`${DIM}timestamp:   ${report.timestamp}${RESET}`);
+    lines.push('');
+    // Summary
+    lines.push(`${BOLD}Coverage: ${report.coveredOps}/${report.totalOps} operations (${report.coveragePercent}%)${RESET}`);
+    lines.push('');
+    // Per-service table
+    const header = `  ${'Service'.padEnd(14)} ${'Covered'.padStart(8)}  ${' '.repeat(20)}  ${'Pct'.padStart(4)}  ${'Gaps'.padStart(5)}  ${'Excl'.padStart(5)}`;
+    lines.push(`${DIM}${header}${RESET}`);
+    lines.push(`${DIM}  ${'─'.repeat(14)} ${'─'.repeat(8)}  ${'─'.repeat(20)}  ${'─'.repeat(4)}  ${'─'.repeat(5)}  ${'─'.repeat(5)}${RESET}`);
+    for (const svc of report.services) {
+        if (svc.totalOps === 0)
+            continue;
+        const svcName = svc.service.padEnd(14);
+        const ratio = `${svc.coveredOps}/${svc.totalOps}`.padStart(8);
+        const barStr = bar(svc.coveredOps, svc.totalOps);
+        const pctStr = pct(svc.coveredOps, svc.totalOps);
+        const gapStr = (svc.gapOps > 0 ? `${svc.gapOps}` : '-').padStart(5);
+        const exclStr = (svc.excludedOps > 0 ? `${svc.excludedOps}` : '-').padStart(5);
+        lines.push(`  ${svcName} ${ratio}  ${barStr}  ${pctStr}  ${gapStr}  ${exclStr}`);
+    }
+    // Uncovered services
+    const uncoveredServices = report.services.filter(s => s.coveredOps === 0 && s.totalOps > 0);
+    if (uncoveredServices.length > 0) {
+        lines.push('');
+        lines.push(`${BOLD}Uncovered services:${RESET}`);
+        for (const svc of uncoveredServices) {
+            lines.push(`  ${YELLOW}${svc.service}${RESET} — ${svc.totalOps} operations available`);
+        }
+    }
+    // New operations since baseline
+    const newOps = report.services.flatMap(s => s.newOps.map(op => ({ service: s.service, op })));
+    if (newOps.length > 0) {
+        lines.push('');
+        lines.push(`${BOLD}New since baseline:${RESET}`);
+        for (const { service, op } of newOps) {
+            lines.push(`  ${GREEN}+${RESET} ${CYAN}${service}${RESET} ${op}`);
+        }
+    }
+    // Removed operations
+    const removedOps = report.services.flatMap(s => s.removedOps.map(op => ({ service: s.service, op })));
+    if (removedOps.length > 0) {
+        lines.push('');
+        lines.push(`${BOLD}Removed from gws:${RESET}`);
+        for (const { service, op } of removedOps) {
+            lines.push(`  ${RED}-${RESET} ${CYAN}${service}${RESET} ${op}`);
+        }
+    }
+    // Parameter gaps
+    const allParamGaps = report.services.flatMap(s => Object.entries(s.paramGaps).map(([op, gaps]) => ({ service: s.service, op, gaps })));
+    if (allParamGaps.length > 0) {
+        lines.push('');
+        lines.push(`${BOLD}Parameter gaps in covered operations:${RESET}`);
+        for (const { service, op, gaps } of allParamGaps) {
+            lines.push(`  ${CYAN}${service}${RESET} ${op}:`);
+            for (const gap of gaps) {
+                lines.push(`    ${YELLOW}+${RESET} ${gap.paramName} ${DIM}(${gap.details || 'missing'})${RESET}`);
+            }
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export function formatJsonReport(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=report.js.map

package/build/coverage/report.js.map

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