@shawnowen/comet-mcp 2.4.1 → 2.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shawnowen/comet-mcp",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "MCP Server that gives Claude Code superpowers with Perplexity Comet browser - agentic web browsing, deep research, and real-time monitoring",
   "type": "module",
   "main": "dist/index.js",

package/dist/discovery/capability-entry.d.ts

@@ -1,215 +0,0 @@
-/**
- * capability-entry.ts
- * Core type definitions for the Comet Discovery Layer (Spec 042).
- * All types are derived from data-model.md and capability-entry.schema.json.
- * No runtime logic — pure type declarations + tagged unions.
- */
-/** Which canonical source owns a capability entry. */
-export type SourceLayer = "mcp" | "plugin" | "extension";
-/** Rank order for dedup: plugin (3) > extension (2) > mcp (1). */
-export declare const SOURCE_LAYER_RANK: Record<SourceLayer, number>;
-/**
- * Safety classification — reused verbatim from docs/TOOL-SAFETY-REFERENCE.md.
- * No default, no UNKNOWN class. Every capability must have exactly one.
- *
- * SAFE     — Read-only, zero side effects, no session required.
- * SESSION  — Requires an active Comet CDP session; scoped to the calling agent's tab group.
- * CAUTION  — Cross-session side effects possible; requires explicit multi-agent awareness.
- */
-export type SafetyClass = "SAFE" | "SESSION" | "CAUTION";
-export type Precondition = {
-    kind: "cdp_session";
-    note: string;
-} | {
-    kind: "profile";
-    value: "oe" | "moon";
-} | {
-    kind: "task_group";
-    note: string;
-} | {
-    kind: "task_thread";
-    note: string;
-} | {
-    kind: "free";
-    note: string;
-};
-export type Invocation = {
-    kind: "native";
-    /** Name of the existing MCP tool — pass-through, no behavior change (FR-009). */
-    toolName: string;
-} | {
-    kind: "guide";
-    /** Claude Code Skill name (e.g. "comet-browse"). */
-    skill: string;
-    /** Args to pass to Skill(). */
-    normalizedArgs: Record<string, unknown>;
-    /** Human hint: "Invoke via Skill('comet-browse') with these args." */
-    nextStepHint: string;
-} | {
-    kind: "cdp";
-    /** Chrome DevTools Protocol method string. */
-    method: string;
-    params?: Record<string, unknown>;
-} | {
-    kind: "filesystem";
-    path: string;
-    mode: "read" | "signal";
-} | {
-    kind: "cli";
-    command: string;
-    args: string[];
-};
-/**
- * One CapabilityEntry per source-side definition.
- * A plugin command that wraps a native MCP tool produces TWO entries sharing a canonicalId.
- */
-export interface CapabilityEntry {
-    /**
-     * Globally unique tool-facing identifier.
-     * Native: existing tool name (e.g. "comet_screenshot").
-     * Plugin: "plugin_<slug>".
-     * Extension: "ext_<slug>".
-     * Regex: /^[a-z][a-z0-9_]{2,63}$/
-     */
-    name: string;
-    /** Which canonical source owns this entry. */
-    sourceLayer: SourceLayer;
-    /**
-     * Repo-relative path + optional #fragment pointing to the canonical definition.
-     * e.g. "comet-mcp/src/index.ts#tool_comet_screenshot"
-     */
-    sourcePath: string;
-    /**
-     * Shared identity key for dedup grouping across layers.
-     * Entries sharing a canonicalId form a CapabilityGroup.
-     * Regex: /^[a-z][a-z0-9_-]{2,63}$/
-     */
-    canonicalId: string;
-    /**
-     * Human-readable verb-phrase description.
-     * Template: "<verb> <object> [<modifier>]. Source: <layer>. Safety: <class>."
-     * Min 24 chars, max 400 chars.
-     */
-    description: string;
-    /**
-     * At least 3 lowercase keywords capturing common search intents.
-     * Drives natural-language ToolSearch ranking (FR-006, SC-002).
-     */
-    intentKeywords: string[];
-    /**
-     * Safety class — must be set; no default.
-     * Reused verbatim from docs/TOOL-SAFETY-REFERENCE.md.
-     */
-    safety: SafetyClass;
-    /**
-     * Prerequisites the agent must satisfy before calling this tool.
-     * May be empty array, never missing.
-     */
-    preconditions: Precondition[];
-    /**
-     * JSON Schema draft 2020-12 fragment for the tool's arguments.
-     * Empty schema `{ type: "object", properties: {} }` is valid.
-     */
-    argsSchema: Record<string, unknown>;
-    /**
-     * True iff this capability has no agent-reachable programmatic entry point
-     * and is deliberately excluded from virtual-tool registration.
-     * MUST be accompanied by a matching HumanOnlyException.
-     */
-    humanOnly: boolean;
-    /** Determines what the virtual MCP tool body returns or dispatches. */
-    invocation: Invocation;
-    /**
-     * The `name` of the paired entry in this entry's CapabilityGroup, or null for singletons.
-     */
-    crossRef: string | null;
-    /**
-     * True for the highest-layer entry in a group (plugin > extension > mcp).
-     * Singletons are always recommended: true.
-     */
-    recommended: boolean;
-    /** For non-recommended entries: "lower-level". For recommended: null. */
-    alternativeLabel: "lower-level" | null;
-}
-/**
- * Transient collection of CapabilityEntry instances sharing a canonicalId.
- * Emits exactly one "recommended" virtual tool and up to one "alternative (lower-level)".
- */
-export interface CapabilityGroup {
-    canonicalId: string;
-    /** Highest-layer member (plugin > extension > mcp). */
-    recommendedEntry: CapabilityEntry;
-    /** Lowest-layer member when distinct from recommendedEntry. null for singletons. */
-    alternativeEntry: CapabilityEntry | null;
-    /**
-     * Intermediate members NOT registered as virtual tools.
-     * Still listed for traceability under the recommended entry's alternates.
-     */
-    suppressedEntries: CapabilityEntry[];
-}
-export interface HumanOnlyException {
-    /** Must equal the canonicalId of a capability with humanOnly: true. */
-    name: string;
-    /** Why no programmatic entry point exists. Min 24 chars. */
-    reason: string;
-    /** GitHub handle (@username) or team (@org/team). */
-    owner: string;
-    /** Plan to make this capability agent-accessible, or null if genuinely blocked. */
-    enhancementPath: string | null;
-    /** ISO 8601 date string. Staleness warning fires if older than 90 days. */
-    lastReviewed: string;
-}
-export interface SourceError {
-    /** Which source layer failed. */
-    source: SourceLayer;
-    /** Human-readable reason. */
-    reason: string;
-    /** Original error, if any. */
-    originalError?: unknown;
-}
-export type DriftStatus = "pass" | "warn" | "fail";
-export interface DriftReport {
-    generatedAt: string;
-    emittedBy: "ci" | "session-start";
-    available: SourceLayer[];
-    unavailable: Array<{
-        source: SourceLayer;
-        reason: string;
-    }>;
-    capabilityCount: number;
-    virtualToolCount: number;
-    /** canonicalIds in canonical source but missing from registry → hard failure. */
-    missingFromRegistry: string[];
-    /** Virtual tool names in registry with no canonical source → hard failure. */
-    extrasInRegistry: string[];
-    /** Entry names missing safety field → hard failure. */
-    safetyGaps: string[];
-    /** humanOnly: true capabilities lacking a matching exception → hard failure. */
-    humanOnlyDangling: string[];
-    /** Exception names that don't resolve to any humanOnly: true capability → hard failure. */
-    exceptionsDangling: string[];
-    /** Exceptions with lastReviewed older than review window → warning only. */
-    exceptionsStale: string[];
-    status: DriftStatus;
-}
-export interface GoldenQueryResult {
-    query: string;
-    expectedCanonicalId: string;
-    top5Names: string[];
-    hit: boolean;
-}
-export interface CoverageReport {
-    sources: Record<SourceLayer, number>;
-    totalCapabilities: number;
-    coverageRatio: number;
-    goldenQueries: GoldenQueryResult[];
-    top5HitRate: number;
-    metadataCompleteness: number;
-}
-/** Minimal MCP tool definition shape accepted by the comet-mcp Server. */
-export interface McpToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-}
-//# sourceMappingURL=capability-entry.d.ts.map

package/dist/discovery/capability-entry.js

@@ -1,13 +0,0 @@
-/**
- * capability-entry.ts
- * Core type definitions for the Comet Discovery Layer (Spec 042).
- * All types are derived from data-model.md and capability-entry.schema.json.
- * No runtime logic — pure type declarations + tagged unions.
- */
-/** Rank order for dedup: plugin (3) > extension (2) > mcp (1). */
-export const SOURCE_LAYER_RANK = {
-    plugin: 3,
-    extension: 2,
-    mcp: 1,
-};
-//# sourceMappingURL=capability-entry.js.map

package/dist/discovery/description-template.d.ts

@@ -1,40 +0,0 @@
-/**
- * description-template.ts
- * R10 description template renderer (Spec 042, T031).
- *
- * Produces consistent, searchable descriptions for virtual MCP tool entries.
- * Format: "<verb> <object> [<modifier>]. Source: <layer>. Safety: <class>. [multi-agent clause for CAUTION]"
- *
- * Constraints (from spec):
- *   - Min 24 chars, max 400 chars
- *   - CAUTION entries MUST include the cross-session warning phrase
- */
-import type { SafetyClass, SourceLayer } from "./capability-entry.js";
-export declare const CAUTION_MULTI_AGENT_CLAUSE: string;
-export interface DescriptionOptions {
-    /** Short verb phrase: e.g. "Capture a screenshot" */
-    verbPhrase: string;
-    /** Optional modifier appended after verbPhrase: e.g. "in this agent's tab" */
-    modifier?: string;
-    /** Source layer — appended as "Source: <layer>." */
-    sourceLayer: SourceLayer;
-    /** Safety class — appended as "Safety: <class>." */
-    safety: SafetyClass;
-}
-/**
- * Render the R10 description for a capability entry.
- * Returns a string between MIN_LENGTH and MAX_LENGTH characters.
- * Throws if the rendered string is outside those bounds.
- */
-export declare function renderDescription(opts: DescriptionOptions): string;
-/**
- * Safe version — returns the string if valid, or an error-annotated fallback.
- * Used when the verbPhrase is untrusted (e.g. from plugin YAML frontmatter).
- */
-export declare function renderDescriptionSafe(opts: DescriptionOptions, fallback?: string): string;
-/**
- * Render a CAUTION description with the mandatory multi-agent clause.
- * Convenience wrapper for T033.
- */
-export declare function renderCautionDescription(verbPhrase: string, sourceLayer: SourceLayer, modifier?: string): string;
-//# sourceMappingURL=description-template.d.ts.map

package/dist/discovery/description-template.js

@@ -1,61 +0,0 @@
-/**
- * description-template.ts
- * R10 description template renderer (Spec 042, T031).
- *
- * Produces consistent, searchable descriptions for virtual MCP tool entries.
- * Format: "<verb> <object> [<modifier>]. Source: <layer>. Safety: <class>. [multi-agent clause for CAUTION]"
- *
- * Constraints (from spec):
- *   - Min 24 chars, max 400 chars
- *   - CAUTION entries MUST include the cross-session warning phrase
- */
-// Canonical cross-session warning for CAUTION tools.
-// Must appear verbatim in every CAUTION entry description (tested in T029).
-export const CAUTION_MULTI_AGENT_CLAUSE = "CAUTION: may have cross-session side effects — only use on your own session and tab group. " +
-    "Never close or modify browser resources you did not create.";
-const MIN_LENGTH = 24;
-const MAX_LENGTH = 400;
-/**
- * Render the R10 description for a capability entry.
- * Returns a string between MIN_LENGTH and MAX_LENGTH characters.
- * Throws if the rendered string is outside those bounds.
- */
-export function renderDescription(opts) {
-    const { verbPhrase, modifier, sourceLayer, safety } = opts;
-    let text = verbPhrase.trimEnd();
-    if (modifier)
-        text += " " + modifier.trim();
-    text += ". ";
-    text += `Source: ${sourceLayer}. Safety: ${safety}.`;
-    if (safety === "CAUTION") {
-        text += " " + CAUTION_MULTI_AGENT_CLAUSE;
-    }
-    if (text.length < MIN_LENGTH) {
-        throw new RangeError(`Description too short (${text.length} < ${MIN_LENGTH}): "${text}"`);
-    }
-    if (text.length > MAX_LENGTH) {
-        throw new RangeError(`Description too long (${text.length} > ${MAX_LENGTH}): "${text.slice(0, 80)}…"`);
-    }
-    return text;
-}
-/**
- * Safe version — returns the string if valid, or an error-annotated fallback.
- * Used when the verbPhrase is untrusted (e.g. from plugin YAML frontmatter).
- */
-export function renderDescriptionSafe(opts, fallback) {
-    try {
-        return renderDescription(opts);
-    }
-    catch {
-        const fb = fallback ?? `${opts.verbPhrase}. Source: ${opts.sourceLayer}. Safety: ${opts.safety}.`;
-        return fb.slice(0, MAX_LENGTH);
-    }
-}
-/**
- * Render a CAUTION description with the mandatory multi-agent clause.
- * Convenience wrapper for T033.
- */
-export function renderCautionDescription(verbPhrase, sourceLayer, modifier) {
-    return renderDescription({ verbPhrase, modifier, sourceLayer, safety: "CAUTION" });
-}
-//# sourceMappingURL=description-template.js.map

package/dist/discovery/golden-queries.fixture.d.ts

@@ -1,22 +0,0 @@
-/**
- * golden-queries.fixture.ts
- * Hand-picked golden query set for US1 ToolSearch ranking tests (Spec 042, T025).
- *
- * Each entry describes a natural-language query an agent might issue plus the
- * canonical tool name expected to appear in the top 5 ToolSearch results.
- *
- * Coverage targets: SC-002 (≥ 95% top-5 hit rate = 19/20 queries must hit).
- * At least one query per safety class and per major capability area.
- */
-export interface GoldenQuery {
-    /** Natural language query the agent would type into ToolSearch */
-    query: string;
-    /** canonicalId of the entry that must appear in the top-5 results */
-    expectedCanonicalId: string;
-    /** Expected tool name for direct assertion */
-    expectedToolName: string;
-    /** Human note explaining why this query should resolve to this tool */
-    note: string;
-}
-export declare const GOLDEN_QUERIES: GoldenQuery[];
-//# sourceMappingURL=golden-queries.fixture.d.ts.map

package/dist/discovery/golden-queries.fixture.js

@@ -1,137 +0,0 @@
-/**
- * golden-queries.fixture.ts
- * Hand-picked golden query set for US1 ToolSearch ranking tests (Spec 042, T025).
- *
- * Each entry describes a natural-language query an agent might issue plus the
- * canonical tool name expected to appear in the top 5 ToolSearch results.
- *
- * Coverage targets: SC-002 (≥ 95% top-5 hit rate = 19/20 queries must hit).
- * At least one query per safety class and per major capability area.
- */
-export const GOLDEN_QUERIES = [
-    // ── Observation / SAFE tools ─────────────────────────────────────────────
-    {
-        query: "observe browser status",
-        expectedCanonicalId: "comet-observe",
-        expectedToolName: "comet_observe",
-        note: "Primary observation tool — should rank #1 for status queries",
-    },
-    {
-        query: "health check browser extension",
-        expectedCanonicalId: "comet-observe",
-        expectedToolName: "comet_observe",
-        note: "Health check is a sub-action of comet_observe",
-    },
-    {
-        query: "peek at another agent tab",
-        expectedCanonicalId: "comet-peek",
-        expectedToolName: "comet_peek",
-        note: "Cross-agent read-only inspection without affecting the tab",
-    },
-    {
-        query: "inspect tab screenshot cross agent",
-        expectedCanonicalId: "comet-peek",
-        expectedToolName: "comet_peek",
-        note: "comet_peek action=screenshot for another agent's tab",
-    },
-    {
-        query: "list all tab groups",
-        expectedCanonicalId: "comet-tab-groups",
-        expectedToolName: "comet_tab_groups",
-        note: "Tab group management including list action",
-    },
-    {
-        query: "equabot task thread running agents",
-        expectedCanonicalId: "comet-task-status",
-        expectedToolName: "comet_task_status",
-        note: "SAFE status overview tool for orchestrator agents",
-    },
-    // ── Session tools (SESSION class) ────────────────────────────────────────
-    {
-        query: "connect to Comet browser start session",
-        expectedCanonicalId: "comet-connect",
-        expectedToolName: "comet_connect",
-        note: "Entry-point for all browser work — must rank first for connect queries",
-    },
-    {
-        query: "take a screenshot of current page",
-        expectedCanonicalId: "comet-screenshot",
-        expectedToolName: "comet_screenshot",
-        note: "Explicit screenshot request in the session context",
-    },
-    {
-        query: "full page screenshot dark mode",
-        expectedCanonicalId: "comet-screenshot",
-        expectedToolName: "comet_screenshot",
-        note: "Natural-language screenshot variant — must appear in top 5",
-    },
-    {
-        query: "navigate to url open page",
-        expectedCanonicalId: "comet-navigate",
-        expectedToolName: "comet_navigate",
-        note: "Explicit navigate request",
-    },
-    {
-        query: "read page content extract text markdown",
-        expectedCanonicalId: "comet-read-page",
-        expectedToolName: "comet_read_page",
-        note: "Content extraction from the current tab",
-    },
-    {
-        query: "click button fill form interact",
-        expectedCanonicalId: "comet-interact",
-        expectedToolName: "comet_interact",
-        note: "DOM interaction — click/type/fill queries",
-    },
-    {
-        query: "ask perplexity research question ai",
-        expectedCanonicalId: "comet-ask",
-        expectedToolName: "comet_ask",
-        note: "Primary research/AI-prompt tool",
-    },
-    {
-        query: "generate pdf print page document",
-        expectedCanonicalId: "comet-pdf",
-        expectedToolName: "comet_pdf",
-        note: "PDF export from current tab",
-    },
-    {
-        query: "scrape extract table structured data",
-        expectedCanonicalId: "comet-scrape",
-        expectedToolName: "comet_scrape",
-        note: "Structured data extraction",
-    },
-    {
-        query: "capture network requests api traffic",
-        expectedCanonicalId: "comet-network",
-        expectedToolName: "comet_network",
-        note: "Network request monitoring",
-    },
-    {
-        query: "run automation workflow multi step",
-        expectedCanonicalId: "comet-automate",
-        expectedToolName: "comet_automate",
-        note: "Multi-step automation playbook",
-    },
-    // ── Lifecycle tools ───────────────────────────────────────────────────────
-    {
-        query: "start task thread lifecycle register run",
-        expectedCanonicalId: "comet-lifecycle-start",
-        expectedToolName: "comet_lifecycle_start",
-        note: "Lifecycle start — agent registers a new task run",
-    },
-    {
-        query: "mark task complete finish run",
-        expectedCanonicalId: "comet-lifecycle-complete",
-        expectedToolName: "comet_lifecycle_complete",
-        note: "Terminal lifecycle action for success",
-    },
-    // ── CAUTION tools ─────────────────────────────────────────────────────────
-    {
-        query: "delegate task spawn sub-agent equabot",
-        expectedCanonicalId: "comet-delegate",
-        expectedToolName: "comet_delegate",
-        note: "CAUTION: spawns a new agent — must appear with the CAUTION warning",
-    },
-];
-//# sourceMappingURL=golden-queries.fixture.js.map

package/dist/discovery/mcp-source.d.ts

@@ -1,38 +0,0 @@
-/**
- * mcp-source.ts
- * MCP source reader for the Comet Discovery Layer (Spec 042, T020).
- *
- * Reads the native tool metadata catalog (tool-meta.ts) and the TOOLS
- * array from the running MCP server (imported via tool-registry.ts to
- * avoid circular imports), then produces CapabilityEntry[] with
- * sourceLayer: "mcp" for every registered native tool.
- *
- * Tools in the TOOLS array that have no matching entry in TOOL_META_MAP
- * are skipped with a SourceError (warn-and-continue, FR-008a).
- */
-import type { CapabilityEntry, SourceError } from "./capability-entry.js";
-/**
- * Minimal shape of a native MCP tool definition.
- * Matches the Tool type in index.ts without importing it (avoids circular dep).
- */
-interface NativeTool {
-    name: string;
-    description?: string;
-    inputSchema: Record<string, unknown>;
-}
-/**
- * Read the native MCP tool source and return CapabilityEntry[].
- *
- * Accepts the TOOLS array as an argument so tests can inject fixtures
- * without touching index.ts (FR-009).
- *
- * @param tools  The TOOLS array from index.ts (or a fixture subset for tests).
- * @returns      { entries, errors } — entries for every tool in TOOL_META_MAP;
- *               errors for tools missing from the catalog.
- */
-export declare function readMcpSource(tools: NativeTool[]): {
-    entries: CapabilityEntry[];
-    errors: SourceError[];
-};
-export {};
-//# sourceMappingURL=mcp-source.d.ts.map

package/dist/discovery/mcp-source.js

@@ -1,70 +0,0 @@
-/**
- * mcp-source.ts
- * MCP source reader for the Comet Discovery Layer (Spec 042, T020).
- *
- * Reads the native tool metadata catalog (tool-meta.ts) and the TOOLS
- * array from the running MCP server (imported via tool-registry.ts to
- * avoid circular imports), then produces CapabilityEntry[] with
- * sourceLayer: "mcp" for every registered native tool.
- *
- * Tools in the TOOLS array that have no matching entry in TOOL_META_MAP
- * are skipped with a SourceError (warn-and-continue, FR-008a).
- */
-import { errorFromException } from "./source-error.js";
-import { assertSafety } from "./safety.js";
-import { TOOL_META_MAP } from "./tool-meta.js";
-// ---------------------------------------------------------------------------
-// Source reader
-// ---------------------------------------------------------------------------
-/**
- * Read the native MCP tool source and return CapabilityEntry[].
- *
- * Accepts the TOOLS array as an argument so tests can inject fixtures
- * without touching index.ts (FR-009).
- *
- * @param tools  The TOOLS array from index.ts (or a fixture subset for tests).
- * @returns      { entries, errors } — entries for every tool in TOOL_META_MAP;
- *               errors for tools missing from the catalog.
- */
-export function readMcpSource(tools) {
-    const entries = [];
-    const errors = [];
-    for (const tool of tools) {
-        const meta = TOOL_META_MAP.get(tool.name);
-        if (!meta) {
-            errors.push({
-                source: "mcp",
-                reason: `Tool "${tool.name}" has no entry in TOOL_META_MAP — add one to tool-meta.ts`,
-            });
-            continue;
-        }
-        // Validate safety class (should always pass for hand-authored catalog)
-        let safety;
-        try {
-            safety = assertSafety(meta.safety, tool.name);
-        }
-        catch (err) {
-            errors.push(errorFromException("mcp", err));
-            continue;
-        }
-        const entry = {
-            name: tool.name,
-            sourceLayer: "mcp",
-            sourcePath: `comet-mcp/src/index.ts#tool_${tool.name}`,
-            canonicalId: meta.canonicalId,
-            description: meta.description,
-            intentKeywords: meta.intentKeywords,
-            safety,
-            preconditions: meta.preconditions,
-            argsSchema: tool.inputSchema,
-            humanOnly: false,
-            invocation: { kind: "native", toolName: tool.name },
-            crossRef: null, // singletons until dedup.ts runs (T043)
-            recommended: true, // all native entries are recommended until dedup.ts runs
-            alternativeLabel: null,
-        };
-        entries.push(entry);
-    }
-    return { entries, errors };
-}
-//# sourceMappingURL=mcp-source.js.map

package/dist/discovery/metadata-completeness.d.ts

@@ -1,48 +0,0 @@
-/**
- * metadata-completeness.ts
- * Metadata completeness validator for the Comet Discovery Layer (Spec 042, T032).
- *
- * Walks a CapabilityEntry[] and returns a MetadataCompletenessReport with:
- *   - completeness ratio (1.0 = SC-003 satisfied)
- *   - per-entry gap list for drift-check and test assertion
- *
- * Used by:
- *   - metadata-completeness.test.ts (T028)
- *   - coverage.ts (US4, T054) for DriftReport.safetyGaps
- */
-import type { CapabilityEntry } from "./capability-entry.js";
-export interface MetadataGap {
-    /** Entry name (tool name / plugin slug / extension slug). */
-    name: string;
-    /** Which field is incomplete. */
-    field: "safety" | "sourceLayer" | "preconditions" | "description" | "canonicalId" | "intentKeywords";
-    /** Human-readable reason. */
-    reason: string;
-}
-export interface MetadataCompletenessReport {
-    /**
-     * Ratio of entries with zero gaps to total entries.
-     * 0.0 (all entries gapped) to 1.0 (all entries complete).
-     * 1.0 = SC-003 satisfied.
-     */
-    completeness: number;
-    /** All gaps found across all entries. */
-    gaps: MetadataGap[];
-    /** How many entries were checked. */
-    totalChecked: number;
-    /** How many entries had zero gaps. */
-    totalComplete: number;
-}
-/**
- * Validate metadata completeness for a list of CapabilityEntry objects.
- * Returns the completeness ratio and all gaps found.
- *
- * @param entries  The composed registry entries to validate.
- */
-export declare function checkMetadataCompleteness(entries: CapabilityEntry[]): MetadataCompletenessReport;
-/**
- * Returns the names of entries missing their safety classification.
- * Used by coverage.ts to populate DriftReport.safetyGaps.
- */
-export declare function getSafetyGaps(entries: CapabilityEntry[]): string[];
-//# sourceMappingURL=metadata-completeness.d.ts.map