skillops-cli 0.0.0-stage → 1.2.1

package/dist/index.d.ts

@@ -0,0 +1,2039 @@
+import { z } from 'zod';
+
+/**
+ * Normative Zod v3 schemas and TypeScript domain contracts for the SkillOps NPX Engine.
+ *
+ * Enforces INV-SKILL-01 through INV-SKILL-05 for both Hybrid Executable Skills (SKILL.md)
+ * and Context-Isolated Subagents (SUBAGENT.md / *.agent.md), as well as Token Economy
+ * telemetry and Multi-Runtime Transpilation lockfiles.
+ */
+
+declare const SKILLOPS_VERSION = "1.2.1";
+/**
+ * Count whitespace-delimited words in text.
+ */
+declare function countWords(text: string): number;
+/**
+ * Deterministic zero-API token count estimator matching SKILL_CONTRACT.md.
+ */
+declare function estimateTokenCount(text: string): number;
+/**
+ * Split a Markdown document into [frontmatterDict, markdownBody].
+ */
+declare function splitFrontmatter(rawText: string, sourceLabel: string): [Record<string, unknown>, string];
+declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly ERROR: 1;
+    readonly COLLISION_ERROR: 2;
+    readonly BUDGET_OR_CONTRACT_ERROR: 3;
+    readonly EVAL_REGRESSION_ERROR: 4;
+};
+type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
+declare const CatalogTrackSchema: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+type CatalogTrack = z.infer<typeof CatalogTrackSchema>;
+declare const CollisionSeveritySchema: z.ZodEnum<["SAFE", "WARNING", "HIGH_RISK", "BLOCKING_ERROR"]>;
+type CollisionSeverity = z.infer<typeof CollisionSeveritySchema>;
+declare const RuntimeTargetSchema: z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>;
+type RuntimeTarget = z.infer<typeof RuntimeTargetSchema>;
+declare const CORE_RUNTIME_TARGETS: readonly RuntimeTarget[];
+declare const ALL_RUNTIME_TARGETS: readonly RuntimeTarget[];
+type HarnessCategory = "cli-agent" | "ai-ide" | "ide-extension" | "autonomous-swe";
+type HarnessSkillFormat = "progressive-skill-dir" | "mdc-rule" | "copilot-instructions" | "markdown-rule" | "openhands-microagent" | "kiro-steering";
+interface RuntimeHarnessSpec {
+    readonly id: RuntimeTarget;
+    readonly displayName: string;
+    readonly vendor: string;
+    readonly category: HarnessCategory;
+    readonly skillFormat: HarnessSkillFormat;
+    readonly skillsDir: string;
+    readonly subagentsDir: string;
+    readonly detectionPaths: readonly string[];
+    readonly alwaysOnFiles: readonly string[];
+    readonly mcpConfigPath: string | null;
+    readonly supportsMcp: boolean;
+}
+declare const RUNTIME_HARNESS_SPECS: Readonly<Record<RuntimeTarget, RuntimeHarnessSpec>>;
+/**
+ * Deterministically detect which of the 20 AI coding agent harnesses have configuration
+ * directories or instruction files present in `repoPath`.
+ */
+declare function detectInstalledHarnesses(repoPath: string): RuntimeTarget[];
+/**
+ * Resolve runtime target specifications (`"all"`, `"auto"`, `"core"`, or comma-separated target names)
+ * into a deduplicated, validated list of `RuntimeTarget` values.
+ */
+declare function resolveRuntimeTargets(rawSpec?: string | readonly string[], repoPath?: string, fallbackTargets?: readonly RuntimeTarget[]): RuntimeTarget[];
+declare const RoutingSignalsSchema: z.ZodObject<{
+    languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    files_any: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    dependencies_any: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    negative_triggers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    languages: string[];
+    files_any: string[];
+    dependencies_any: string[];
+    negative_triggers: string[];
+}, {
+    languages?: string[] | undefined;
+    files_any?: string[] | undefined;
+    dependencies_any?: string[] | undefined;
+    negative_triggers?: string[] | undefined;
+}>;
+type RoutingSignals = z.infer<typeof RoutingSignalsSchema>;
+declare const ScriptEntrypointSchema: z.ZodObject<{
+    path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    description: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    description: string;
+}, {
+    path: string;
+    description: string;
+}>;
+type ScriptEntrypoint = z.infer<typeof ScriptEntrypointSchema>;
+declare const SkillEntrypointsSchema: z.ZodObject<{
+    scripts: z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        description: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        description: string;
+    }, {
+        path: string;
+        description: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    scripts: {
+        path: string;
+        description: string;
+    }[];
+}, {
+    scripts: {
+        path: string;
+        description: string;
+    }[];
+}>;
+type SkillEntrypoints = z.infer<typeof SkillEntrypointsSchema>;
+declare const SkillManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    version: z.ZodDefault<z.ZodString>;
+    track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    routing_signals: z.ZodDefault<z.ZodObject<{
+        languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        files_any: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        dependencies_any: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        negative_triggers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        languages: string[];
+        files_any: string[];
+        dependencies_any: string[];
+        negative_triggers: string[];
+    }, {
+        languages?: string[] | undefined;
+        files_any?: string[] | undefined;
+        dependencies_any?: string[] | undefined;
+        negative_triggers?: string[] | undefined;
+    }>>;
+    entrypoints: z.ZodObject<{
+        scripts: z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+            description: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            description: string;
+        }, {
+            path: string;
+            description: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        scripts: {
+            path: string;
+            description: string;
+        }[];
+    }, {
+        scripts: {
+            path: string;
+            description: string;
+        }[];
+    }>;
+    body_lines: z.ZodDefault<z.ZodNumber>;
+    body_tokens: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    version: string;
+    track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+    tags: string[];
+    routing_signals: {
+        languages: string[];
+        files_any: string[];
+        dependencies_any: string[];
+        negative_triggers: string[];
+    };
+    entrypoints: {
+        scripts: {
+            path: string;
+            description: string;
+        }[];
+    };
+    body_lines: number;
+    body_tokens: number;
+}, {
+    description: string;
+    name: string;
+    track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+    tags: string[];
+    entrypoints: {
+        scripts: {
+            path: string;
+            description: string;
+        }[];
+    };
+    version?: string | undefined;
+    routing_signals?: {
+        languages?: string[] | undefined;
+        files_any?: string[] | undefined;
+        dependencies_any?: string[] | undefined;
+        negative_triggers?: string[] | undefined;
+    } | undefined;
+    body_lines?: number | undefined;
+    body_tokens?: number | undefined;
+}>;
+type SkillManifestInput = z.input<typeof SkillManifestSchema>;
+type SkillManifest = z.output<typeof SkillManifestSchema> & {
+    readonly description_words: number;
+    readonly description_tokens: number;
+};
+declare function createSkillManifest(input: unknown): SkillManifest;
+declare function parseSkillMdFile(filePath: string): SkillManifest;
+declare const SubagentManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    tools: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    user_invocable: z.ZodDefault<z.ZodBoolean>;
+    context_isolation: z.ZodDefault<z.ZodBoolean>;
+    max_output_tokens: z.ZodDefault<z.ZodNumber>;
+    model_tier: z.ZodDefault<z.ZodEnum<["inherit", "fast", "reasoning"]>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    system_prompt_lines: z.ZodDefault<z.ZodNumber>;
+    system_prompt_tokens: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    tags: string[];
+    tools: string[];
+    user_invocable: boolean;
+    context_isolation: boolean;
+    max_output_tokens: number;
+    model_tier: "inherit" | "fast" | "reasoning";
+    system_prompt_lines: number;
+    system_prompt_tokens: number;
+}, {
+    description: string;
+    name: string;
+    tools: string[];
+    tags?: string[] | undefined;
+    user_invocable?: boolean | undefined;
+    context_isolation?: boolean | undefined;
+    max_output_tokens?: number | undefined;
+    model_tier?: "inherit" | "fast" | "reasoning" | undefined;
+    system_prompt_lines?: number | undefined;
+    system_prompt_tokens?: number | undefined;
+}>;
+type SubagentManifest = z.output<typeof SubagentManifestSchema> & {
+    readonly description_tokens: number;
+};
+declare function createSubagentManifest(input: Record<string, unknown>): SubagentManifest;
+declare function parseSubagentMdFile(filePath: string): {
+    manifest: SubagentManifest;
+    systemPromptBody: string;
+};
+declare function classifyCollisionSeverity(similarity: number): CollisionSeverity;
+declare const CollisionPairSchema: z.ZodObject<{
+    skill_a: z.ZodString;
+    skill_b: z.ZodString;
+    similarity: z.ZodNumber;
+    severity: z.ZodEnum<["SAFE", "WARNING", "HIGH_RISK", "BLOCKING_ERROR"]>;
+    shared_terms: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    skill_a: string;
+    skill_b: string;
+    similarity: number;
+    severity: "SAFE" | "WARNING" | "HIGH_RISK" | "BLOCKING_ERROR";
+    shared_terms: string[];
+}, {
+    skill_a: string;
+    skill_b: string;
+    similarity: number;
+    severity: "SAFE" | "WARNING" | "HIGH_RISK" | "BLOCKING_ERROR";
+    shared_terms?: string[] | undefined;
+}>;
+type CollisionPair = z.infer<typeof CollisionPairSchema>;
+declare function createCollisionPair(skillA: string, skillB: string, similarity: number, sharedTerms?: string[]): CollisionPair;
+declare const CollisionReportSchema: z.ZodObject<{
+    catalog_path: z.ZodString;
+    skills_audited: z.ZodNumber;
+    subagents_audited: z.ZodDefault<z.ZodNumber>;
+    total_l1_tokens: z.ZodNumber;
+    max_similarity: z.ZodDefault<z.ZodNumber>;
+    pairs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        skill_a: z.ZodString;
+        skill_b: z.ZodString;
+        similarity: z.ZodNumber;
+        severity: z.ZodEnum<["SAFE", "WARNING", "HIGH_RISK", "BLOCKING_ERROR"]>;
+        shared_terms: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        skill_a: string;
+        skill_b: string;
+        similarity: number;
+        severity: "SAFE" | "WARNING" | "HIGH_RISK" | "BLOCKING_ERROR";
+        shared_terms: string[];
+    }, {
+        skill_a: string;
+        skill_b: string;
+        similarity: number;
+        severity: "SAFE" | "WARNING" | "HIGH_RISK" | "BLOCKING_ERROR";
+        shared_terms?: string[] | undefined;
+    }>, "many">>;
+    budget_errors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    catalog_path: string;
+    skills_audited: number;
+    subagents_audited: number;
+    total_l1_tokens: number;
+    max_similarity: number;
+    pairs: {
+        skill_a: string;
+        skill_b: string;
+        similarity: number;
+        severity: "SAFE" | "WARNING" | "HIGH_RISK" | "BLOCKING_ERROR";
+        shared_terms: string[];
+    }[];
+    budget_errors: string[];
+}, {
+    catalog_path: string;
+    skills_audited: number;
+    total_l1_tokens: number;
+    subagents_audited?: number | undefined;
+    max_similarity?: number | undefined;
+    pairs?: {
+        skill_a: string;
+        skill_b: string;
+        similarity: number;
+        severity: "SAFE" | "WARNING" | "HIGH_RISK" | "BLOCKING_ERROR";
+        shared_terms?: string[] | undefined;
+    }[] | undefined;
+    budget_errors?: string[] | undefined;
+}>;
+type CollisionReport = z.infer<typeof CollisionReportSchema> & {
+    readonly blocking_collisions: CollisionPair[];
+    readonly high_risk_collisions: CollisionPair[];
+    readonly warning_collisions: CollisionPair[];
+    readonly passed: boolean;
+};
+declare function createCollisionReport(input: z.input<typeof CollisionReportSchema>): CollisionReport;
+declare const TokenFileCategorySchema: z.ZodEnum<["always_on_instructions", "always_on_cursor_rule", "mcp_schema_tax", "skill_l1_metadata", "skill_l2_body", "skill_l3_script", "subagent_definition"]>;
+type TokenFileCategory = z.infer<typeof TokenFileCategorySchema>;
+declare const TokenFileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    category: z.ZodEnum<["always_on_instructions", "always_on_cursor_rule", "mcp_schema_tax", "skill_l1_metadata", "skill_l2_body", "skill_l3_script", "subagent_definition"]>;
+    always_loaded_on_startup: z.ZodBoolean;
+    lines: z.ZodNumber;
+    estimated_tokens: z.ZodNumber;
+    notes: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    category: "always_on_instructions" | "always_on_cursor_rule" | "mcp_schema_tax" | "skill_l1_metadata" | "skill_l2_body" | "skill_l3_script" | "subagent_definition";
+    always_loaded_on_startup: boolean;
+    lines: number;
+    estimated_tokens: number;
+    notes: string;
+}, {
+    path: string;
+    category: "always_on_instructions" | "always_on_cursor_rule" | "mcp_schema_tax" | "skill_l1_metadata" | "skill_l2_body" | "skill_l3_script" | "subagent_definition";
+    always_loaded_on_startup: boolean;
+    lines: number;
+    estimated_tokens: number;
+    notes?: string | undefined;
+}>;
+type TokenFileEntry = z.infer<typeof TokenFileEntrySchema>;
+declare const TokenWasteHotspotSchema: z.ZodObject<{
+    path: z.ZodString;
+    severity: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
+    wasted_tokens: z.ZodNumber;
+    issue: z.ZodString;
+    recommendation: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    wasted_tokens: number;
+    issue: string;
+    recommendation: string;
+}, {
+    path: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    wasted_tokens: number;
+    issue: string;
+    recommendation: string;
+}>;
+type TokenWasteHotspot = z.infer<typeof TokenWasteHotspotSchema>;
+declare const TokenEconomyReportSchema: z.ZodObject<{
+    repo_path: z.ZodString;
+    catalog_path: z.ZodString;
+    startup_token_tax: z.ZodNumber;
+    startup_tax_budget: z.ZodDefault<z.ZodNumber>;
+    monolithic_equivalent_tokens: z.ZodNumber;
+    progressive_disclosure_l1_tokens: z.ZodNumber;
+    zero_token_l3_scripts_count: z.ZodNumber;
+    context_isolated_subagents_count: z.ZodNumber;
+    estimated_tokens_saved: z.ZodNumber;
+    token_savings_pct: z.ZodNumber;
+    inspected_files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        category: z.ZodEnum<["always_on_instructions", "always_on_cursor_rule", "mcp_schema_tax", "skill_l1_metadata", "skill_l2_body", "skill_l3_script", "subagent_definition"]>;
+        always_loaded_on_startup: z.ZodBoolean;
+        lines: z.ZodNumber;
+        estimated_tokens: z.ZodNumber;
+        notes: z.ZodDefault<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        category: "always_on_instructions" | "always_on_cursor_rule" | "mcp_schema_tax" | "skill_l1_metadata" | "skill_l2_body" | "skill_l3_script" | "subagent_definition";
+        always_loaded_on_startup: boolean;
+        lines: number;
+        estimated_tokens: number;
+        notes: string;
+    }, {
+        path: string;
+        category: "always_on_instructions" | "always_on_cursor_rule" | "mcp_schema_tax" | "skill_l1_metadata" | "skill_l2_body" | "skill_l3_script" | "subagent_definition";
+        always_loaded_on_startup: boolean;
+        lines: number;
+        estimated_tokens: number;
+        notes?: string | undefined;
+    }>, "many">>;
+    hotspots: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        severity: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
+        wasted_tokens: z.ZodNumber;
+        issue: z.ZodString;
+        recommendation: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        wasted_tokens: number;
+        issue: string;
+        recommendation: string;
+    }, {
+        path: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        wasted_tokens: number;
+        issue: string;
+        recommendation: string;
+    }>, "many">>;
+    passed_budget: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    catalog_path: string;
+    repo_path: string;
+    startup_token_tax: number;
+    startup_tax_budget: number;
+    monolithic_equivalent_tokens: number;
+    progressive_disclosure_l1_tokens: number;
+    zero_token_l3_scripts_count: number;
+    context_isolated_subagents_count: number;
+    estimated_tokens_saved: number;
+    token_savings_pct: number;
+    inspected_files: {
+        path: string;
+        category: "always_on_instructions" | "always_on_cursor_rule" | "mcp_schema_tax" | "skill_l1_metadata" | "skill_l2_body" | "skill_l3_script" | "subagent_definition";
+        always_loaded_on_startup: boolean;
+        lines: number;
+        estimated_tokens: number;
+        notes: string;
+    }[];
+    hotspots: {
+        path: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        wasted_tokens: number;
+        issue: string;
+        recommendation: string;
+    }[];
+    passed_budget: boolean;
+}, {
+    catalog_path: string;
+    repo_path: string;
+    startup_token_tax: number;
+    monolithic_equivalent_tokens: number;
+    progressive_disclosure_l1_tokens: number;
+    zero_token_l3_scripts_count: number;
+    context_isolated_subagents_count: number;
+    estimated_tokens_saved: number;
+    token_savings_pct: number;
+    passed_budget: boolean;
+    startup_tax_budget?: number | undefined;
+    inspected_files?: {
+        path: string;
+        category: "always_on_instructions" | "always_on_cursor_rule" | "mcp_schema_tax" | "skill_l1_metadata" | "skill_l2_body" | "skill_l3_script" | "subagent_definition";
+        always_loaded_on_startup: boolean;
+        lines: number;
+        estimated_tokens: number;
+        notes?: string | undefined;
+    }[] | undefined;
+    hotspots?: {
+        path: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        wasted_tokens: number;
+        issue: string;
+        recommendation: string;
+    }[] | undefined;
+}>;
+type TokenEconomyReport = z.infer<typeof TokenEconomyReportSchema>;
+declare const RepoProfileSchema: z.ZodObject<{
+    repo_path: z.ZodString;
+    languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    frameworks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    databases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    ci_systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    detected_files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    signals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    detected_harnesses: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>, "many">>;
+    python_312_plus: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    languages: string[];
+    repo_path: string;
+    frameworks: string[];
+    databases: string[];
+    dependencies: string[];
+    ci_systems: string[];
+    detected_files: string[];
+    signals: string[];
+    detected_harnesses: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+    python_312_plus: boolean;
+}, {
+    repo_path: string;
+    languages?: string[] | undefined;
+    frameworks?: string[] | undefined;
+    databases?: string[] | undefined;
+    dependencies?: string[] | undefined;
+    ci_systems?: string[] | undefined;
+    detected_files?: string[] | undefined;
+    signals?: string[] | undefined;
+    detected_harnesses?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+    python_312_plus?: boolean | undefined;
+}>;
+type RepoProfile = z.infer<typeof RepoProfileSchema>;
+declare const ScoredSkillSchema: z.ZodObject<{
+    name: z.ZodString;
+    track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+    skill_dir: z.ZodString;
+    relevance_score: z.ZodNumber;
+    l1_tokens: z.ZodNumber;
+    matched_signals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+    skill_dir: string;
+    relevance_score: number;
+    l1_tokens: number;
+    matched_signals: string[];
+}, {
+    name: string;
+    track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+    skill_dir: string;
+    relevance_score: number;
+    l1_tokens: number;
+    matched_signals?: string[] | undefined;
+}>;
+type ScoredSkill = z.infer<typeof ScoredSkillSchema>;
+declare const SkippedSkillSchema: z.ZodObject<{
+    name: z.ZodString;
+    track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+    relevance_score: z.ZodNumber;
+    reason: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+    relevance_score: number;
+    reason: string;
+}, {
+    name: string;
+    track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+    relevance_score: number;
+    reason: string;
+}>;
+type SkippedSkill = z.infer<typeof SkippedSkillSchema>;
+declare const RoutedBundleSchema: z.ZodObject<{
+    repo_profile: z.ZodObject<{
+        repo_path: z.ZodString;
+        languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        frameworks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        databases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        ci_systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        detected_files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        signals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        detected_harnesses: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>, "many">>;
+        python_312_plus: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        languages: string[];
+        repo_path: string;
+        frameworks: string[];
+        databases: string[];
+        dependencies: string[];
+        ci_systems: string[];
+        detected_files: string[];
+        signals: string[];
+        detected_harnesses: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+        python_312_plus: boolean;
+    }, {
+        repo_path: string;
+        languages?: string[] | undefined;
+        frameworks?: string[] | undefined;
+        databases?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        ci_systems?: string[] | undefined;
+        detected_files?: string[] | undefined;
+        signals?: string[] | undefined;
+        detected_harnesses?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+        python_312_plus?: boolean | undefined;
+    }>;
+    catalog_path: z.ZodString;
+    max_skills: z.ZodDefault<z.ZodNumber>;
+    max_l1_tokens: z.ZodDefault<z.ZodNumber>;
+    max_similarity: z.ZodDefault<z.ZodNumber>;
+    selected_skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+        skill_dir: z.ZodString;
+        relevance_score: z.ZodNumber;
+        l1_tokens: z.ZodNumber;
+        matched_signals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        skill_dir: string;
+        relevance_score: number;
+        l1_tokens: number;
+        matched_signals: string[];
+    }, {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        skill_dir: string;
+        relevance_score: number;
+        l1_tokens: number;
+        matched_signals?: string[] | undefined;
+    }>, "many">>;
+    recommended_subagents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    skipped_skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+        relevance_score: z.ZodNumber;
+        reason: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        relevance_score: number;
+        reason: string;
+    }, {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        relevance_score: number;
+        reason: string;
+    }>, "many">>;
+    total_l1_tokens: z.ZodDefault<z.ZodNumber>;
+    max_pairwise_similarity: z.ZodDefault<z.ZodNumber>;
+    passed_invariants: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    catalog_path: string;
+    total_l1_tokens: number;
+    max_similarity: number;
+    repo_profile: {
+        languages: string[];
+        repo_path: string;
+        frameworks: string[];
+        databases: string[];
+        dependencies: string[];
+        ci_systems: string[];
+        detected_files: string[];
+        signals: string[];
+        detected_harnesses: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+        python_312_plus: boolean;
+    };
+    max_skills: number;
+    max_l1_tokens: number;
+    selected_skills: {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        skill_dir: string;
+        relevance_score: number;
+        l1_tokens: number;
+        matched_signals: string[];
+    }[];
+    recommended_subagents: string[];
+    skipped_skills: {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        relevance_score: number;
+        reason: string;
+    }[];
+    max_pairwise_similarity: number;
+    passed_invariants: boolean;
+}, {
+    catalog_path: string;
+    repo_profile: {
+        repo_path: string;
+        languages?: string[] | undefined;
+        frameworks?: string[] | undefined;
+        databases?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        ci_systems?: string[] | undefined;
+        detected_files?: string[] | undefined;
+        signals?: string[] | undefined;
+        detected_harnesses?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+        python_312_plus?: boolean | undefined;
+    };
+    total_l1_tokens?: number | undefined;
+    max_similarity?: number | undefined;
+    max_skills?: number | undefined;
+    max_l1_tokens?: number | undefined;
+    selected_skills?: {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        skill_dir: string;
+        relevance_score: number;
+        l1_tokens: number;
+        matched_signals?: string[] | undefined;
+    }[] | undefined;
+    recommended_subagents?: string[] | undefined;
+    skipped_skills?: {
+        name: string;
+        track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+        relevance_score: number;
+        reason: string;
+    }[] | undefined;
+    max_pairwise_similarity?: number | undefined;
+    passed_invariants?: boolean | undefined;
+}>;
+type RoutedBundle = z.infer<typeof RoutedBundleSchema>;
+declare const SyncedArtifactSchema: z.ZodObject<{
+    target: z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>;
+    skill_name: z.ZodString;
+    relative_path: z.ZodString;
+    sha256: z.ZodString;
+    action: z.ZodEnum<["created", "updated", "unchanged", "removed", "planned", "conflict"]>;
+}, "strict", z.ZodTypeAny, {
+    target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+    skill_name: string;
+    relative_path: string;
+    sha256: string;
+    action: "created" | "updated" | "unchanged" | "removed" | "planned" | "conflict";
+}, {
+    target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+    skill_name: string;
+    relative_path: string;
+    sha256: string;
+    action: "created" | "updated" | "unchanged" | "removed" | "planned" | "conflict";
+}>;
+type SyncedArtifact = z.infer<typeof SyncedArtifactSchema>;
+declare const SyncLockEntrySchema: z.ZodObject<{
+    target: z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>;
+    skill_name: z.ZodString;
+    relative_path: z.ZodString;
+    sha256: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+    skill_name: string;
+    relative_path: string;
+    sha256: string;
+}, {
+    target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+    skill_name: string;
+    relative_path: string;
+    sha256: string;
+}>;
+type SyncLockEntry = z.infer<typeof SyncLockEntrySchema>;
+declare const SyncLockfileSchema: z.ZodObject<{
+    schema_version: z.ZodDefault<z.ZodString>;
+    skillops_version: z.ZodString;
+    targets: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>, "many">>;
+    selected_skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    selected_subagents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    total_l1_tokens: z.ZodDefault<z.ZodNumber>;
+    artifacts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        target: z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>;
+        skill_name: z.ZodString;
+        relative_path: z.ZodString;
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+    }, {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+    }>>>;
+}, "strict", z.ZodTypeAny, {
+    total_l1_tokens: number;
+    selected_skills: string[];
+    schema_version: string;
+    skillops_version: string;
+    targets: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+    selected_subagents: string[];
+    artifacts: Record<string, {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+    }>;
+}, {
+    skillops_version: string;
+    total_l1_tokens?: number | undefined;
+    selected_skills?: string[] | undefined;
+    schema_version?: string | undefined;
+    targets?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+    selected_subagents?: string[] | undefined;
+    artifacts?: Record<string, {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+    }> | undefined;
+}>;
+type SyncLockfile = z.infer<typeof SyncLockfileSchema>;
+declare const SyncReportSchema: z.ZodObject<{
+    repo_path: z.ZodString;
+    catalog_path: z.ZodString;
+    targets: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>, "many">>;
+    dry_run: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    routed_bundle: z.ZodObject<{
+        repo_profile: z.ZodObject<{
+            repo_path: z.ZodString;
+            languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            frameworks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            databases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            ci_systems: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            detected_files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            signals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            detected_harnesses: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>, "many">>;
+            python_312_plus: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            languages: string[];
+            repo_path: string;
+            frameworks: string[];
+            databases: string[];
+            dependencies: string[];
+            ci_systems: string[];
+            detected_files: string[];
+            signals: string[];
+            detected_harnesses: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+            python_312_plus: boolean;
+        }, {
+            repo_path: string;
+            languages?: string[] | undefined;
+            frameworks?: string[] | undefined;
+            databases?: string[] | undefined;
+            dependencies?: string[] | undefined;
+            ci_systems?: string[] | undefined;
+            detected_files?: string[] | undefined;
+            signals?: string[] | undefined;
+            detected_harnesses?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+            python_312_plus?: boolean | undefined;
+        }>;
+        catalog_path: z.ZodString;
+        max_skills: z.ZodDefault<z.ZodNumber>;
+        max_l1_tokens: z.ZodDefault<z.ZodNumber>;
+        max_similarity: z.ZodDefault<z.ZodNumber>;
+        selected_skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+            skill_dir: z.ZodString;
+            relevance_score: z.ZodNumber;
+            l1_tokens: z.ZodNumber;
+            matched_signals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            skill_dir: string;
+            relevance_score: number;
+            l1_tokens: number;
+            matched_signals: string[];
+        }, {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            skill_dir: string;
+            relevance_score: number;
+            l1_tokens: number;
+            matched_signals?: string[] | undefined;
+        }>, "many">>;
+        recommended_subagents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        skipped_skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            track: z.ZodEnum<["ai-engineering", "python-backend", "arch-quality", "token-economy"]>;
+            relevance_score: z.ZodNumber;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            relevance_score: number;
+            reason: string;
+        }, {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            relevance_score: number;
+            reason: string;
+        }>, "many">>;
+        total_l1_tokens: z.ZodDefault<z.ZodNumber>;
+        max_pairwise_similarity: z.ZodDefault<z.ZodNumber>;
+        passed_invariants: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        catalog_path: string;
+        total_l1_tokens: number;
+        max_similarity: number;
+        repo_profile: {
+            languages: string[];
+            repo_path: string;
+            frameworks: string[];
+            databases: string[];
+            dependencies: string[];
+            ci_systems: string[];
+            detected_files: string[];
+            signals: string[];
+            detected_harnesses: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+            python_312_plus: boolean;
+        };
+        max_skills: number;
+        max_l1_tokens: number;
+        selected_skills: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            skill_dir: string;
+            relevance_score: number;
+            l1_tokens: number;
+            matched_signals: string[];
+        }[];
+        recommended_subagents: string[];
+        skipped_skills: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            relevance_score: number;
+            reason: string;
+        }[];
+        max_pairwise_similarity: number;
+        passed_invariants: boolean;
+    }, {
+        catalog_path: string;
+        repo_profile: {
+            repo_path: string;
+            languages?: string[] | undefined;
+            frameworks?: string[] | undefined;
+            databases?: string[] | undefined;
+            dependencies?: string[] | undefined;
+            ci_systems?: string[] | undefined;
+            detected_files?: string[] | undefined;
+            signals?: string[] | undefined;
+            detected_harnesses?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+            python_312_plus?: boolean | undefined;
+        };
+        total_l1_tokens?: number | undefined;
+        max_similarity?: number | undefined;
+        max_skills?: number | undefined;
+        max_l1_tokens?: number | undefined;
+        selected_skills?: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            skill_dir: string;
+            relevance_score: number;
+            l1_tokens: number;
+            matched_signals?: string[] | undefined;
+        }[] | undefined;
+        recommended_subagents?: string[] | undefined;
+        skipped_skills?: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            relevance_score: number;
+            reason: string;
+        }[] | undefined;
+        max_pairwise_similarity?: number | undefined;
+        passed_invariants?: boolean | undefined;
+    }>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        target: z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>;
+        skill_name: z.ZodString;
+        relative_path: z.ZodString;
+        sha256: z.ZodString;
+        action: z.ZodEnum<["created", "updated", "unchanged", "removed", "planned", "conflict"]>;
+    }, "strict", z.ZodTypeAny, {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+        action: "created" | "updated" | "unchanged" | "removed" | "planned" | "conflict";
+    }, {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+        action: "created" | "updated" | "unchanged" | "removed" | "planned" | "conflict";
+    }>, "many">>;
+    drift_conflicts: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    lockfile_path: z.ZodString;
+    passed: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    catalog_path: string;
+    passed: boolean;
+    repo_path: string;
+    targets: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+    artifacts: {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+        action: "created" | "updated" | "unchanged" | "removed" | "planned" | "conflict";
+    }[];
+    dry_run: boolean;
+    force: boolean;
+    routed_bundle: {
+        catalog_path: string;
+        total_l1_tokens: number;
+        max_similarity: number;
+        repo_profile: {
+            languages: string[];
+            repo_path: string;
+            frameworks: string[];
+            databases: string[];
+            dependencies: string[];
+            ci_systems: string[];
+            detected_files: string[];
+            signals: string[];
+            detected_harnesses: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+            python_312_plus: boolean;
+        };
+        max_skills: number;
+        max_l1_tokens: number;
+        selected_skills: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            skill_dir: string;
+            relevance_score: number;
+            l1_tokens: number;
+            matched_signals: string[];
+        }[];
+        recommended_subagents: string[];
+        skipped_skills: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            relevance_score: number;
+            reason: string;
+        }[];
+        max_pairwise_similarity: number;
+        passed_invariants: boolean;
+    };
+    drift_conflicts: string[];
+    lockfile_path: string;
+}, {
+    catalog_path: string;
+    repo_path: string;
+    routed_bundle: {
+        catalog_path: string;
+        repo_profile: {
+            repo_path: string;
+            languages?: string[] | undefined;
+            frameworks?: string[] | undefined;
+            databases?: string[] | undefined;
+            dependencies?: string[] | undefined;
+            ci_systems?: string[] | undefined;
+            detected_files?: string[] | undefined;
+            signals?: string[] | undefined;
+            detected_harnesses?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+            python_312_plus?: boolean | undefined;
+        };
+        total_l1_tokens?: number | undefined;
+        max_similarity?: number | undefined;
+        max_skills?: number | undefined;
+        max_l1_tokens?: number | undefined;
+        selected_skills?: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            skill_dir: string;
+            relevance_score: number;
+            l1_tokens: number;
+            matched_signals?: string[] | undefined;
+        }[] | undefined;
+        recommended_subagents?: string[] | undefined;
+        skipped_skills?: {
+            name: string;
+            track: "ai-engineering" | "python-backend" | "arch-quality" | "token-economy";
+            relevance_score: number;
+            reason: string;
+        }[] | undefined;
+        max_pairwise_similarity?: number | undefined;
+        passed_invariants?: boolean | undefined;
+    };
+    lockfile_path: string;
+    passed?: boolean | undefined;
+    targets?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+    artifacts?: {
+        target: "claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie";
+        skill_name: string;
+        relative_path: string;
+        sha256: string;
+        action: "created" | "updated" | "unchanged" | "removed" | "planned" | "conflict";
+    }[] | undefined;
+    dry_run?: boolean | undefined;
+    force?: boolean | undefined;
+    drift_conflicts?: string[] | undefined;
+}>;
+type SyncReport = z.infer<typeof SyncReportSchema>;
+declare const SkillOpsTokenEconomyConfigSchema: z.ZodObject<{
+    startup_tax_budget: z.ZodDefault<z.ZodNumber>;
+    max_active_skills: z.ZodDefault<z.ZodNumber>;
+    max_l1_tokens: z.ZodDefault<z.ZodNumber>;
+    max_similarity: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    max_similarity: number;
+    startup_tax_budget: number;
+    max_l1_tokens: number;
+    max_active_skills: number;
+}, {
+    max_similarity?: number | undefined;
+    startup_tax_budget?: number | undefined;
+    max_l1_tokens?: number | undefined;
+    max_active_skills?: number | undefined;
+}>;
+type SkillOpsTokenEconomyConfig = z.infer<typeof SkillOpsTokenEconomyConfigSchema>;
+declare const SkillOpsDetectedStackConfigSchema: z.ZodObject<{
+    languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    frameworks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    languages: string[];
+    frameworks: string[];
+}, {
+    languages?: string[] | undefined;
+    frameworks?: string[] | undefined;
+}>;
+type SkillOpsDetectedStackConfig = z.infer<typeof SkillOpsDetectedStackConfigSchema>;
+declare const SkillOpsConfigSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    catalog_dir: z.ZodDefault<z.ZodString>;
+    token_economy: z.ZodDefault<z.ZodObject<{
+        startup_tax_budget: z.ZodDefault<z.ZodNumber>;
+        max_active_skills: z.ZodDefault<z.ZodNumber>;
+        max_l1_tokens: z.ZodDefault<z.ZodNumber>;
+        max_similarity: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        max_similarity: number;
+        startup_tax_budget: number;
+        max_l1_tokens: number;
+        max_active_skills: number;
+    }, {
+        max_similarity?: number | undefined;
+        startup_tax_budget?: number | undefined;
+        max_l1_tokens?: number | undefined;
+        max_active_skills?: number | undefined;
+    }>>;
+    detected_stack: z.ZodDefault<z.ZodObject<{
+        languages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        frameworks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        languages: string[];
+        frameworks: string[];
+    }, {
+        languages?: string[] | undefined;
+        frameworks?: string[] | undefined;
+    }>>;
+    targets: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "antigravity", "cursor", "codex", "copilot", "windsurf", "cline", "roocode", "kilocode", "zed", "continue", "aider", "openhands", "amp", "goose", "opencode", "kiro", "trae", "amazonq", "junie"]>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    version: string;
+    targets: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[];
+    catalog_dir: string;
+    token_economy: {
+        max_similarity: number;
+        startup_tax_budget: number;
+        max_l1_tokens: number;
+        max_active_skills: number;
+    };
+    detected_stack: {
+        languages: string[];
+        frameworks: string[];
+    };
+}, {
+    version?: string | undefined;
+    targets?: ("claude" | "antigravity" | "cursor" | "codex" | "copilot" | "windsurf" | "cline" | "roocode" | "kilocode" | "zed" | "continue" | "aider" | "openhands" | "amp" | "goose" | "opencode" | "kiro" | "trae" | "amazonq" | "junie")[] | undefined;
+    catalog_dir?: string | undefined;
+    token_economy?: {
+        max_similarity?: number | undefined;
+        startup_tax_budget?: number | undefined;
+        max_l1_tokens?: number | undefined;
+        max_active_skills?: number | undefined;
+    } | undefined;
+    detected_stack?: {
+        languages?: string[] | undefined;
+        frameworks?: string[] | undefined;
+    } | undefined;
+}>;
+type SkillOpsConfig = z.infer<typeof SkillOpsConfigSchema>;
+interface LoadedSkillOpsConfigResult {
+    readonly config: SkillOpsConfig | null;
+    readonly configPath: string;
+    readonly exists: boolean;
+    readonly error: string | null;
+}
+/**
+ * Load and validate `.skillops.yml` from a repository root if present.
+ */
+declare function loadSkillOpsConfig(repoPath: string): LoadedSkillOpsConfigResult;
+
+/**
+ * Directory and file discovery/parsing engine for Hybrid Executable Skills (SKILL.md)
+ * and Context-Isolated Subagents (SUBAGENT.md / *.agent.md).
+ */
+
+interface ParsedSkillDirectory {
+    readonly skillDir: string;
+    readonly skillMdPath: string;
+    readonly manifest: SkillManifest;
+    readonly rawText: string;
+    readonly markdownBody: string;
+    readonly totalLines: number;
+    readonly declaredScripts: string[];
+    readonly missingDeclaredScripts: string[];
+    readonly extraScripts: string[];
+    readonly referenceFiles: string[];
+    readonly evalsPath: string | null;
+}
+interface ParsedSubagentFile {
+    readonly filePath: string;
+    readonly manifest: SubagentManifest;
+    readonly systemPromptBody: string;
+    readonly rawText: string;
+}
+interface ParseSkillOptions {
+    readonly requireLayout?: boolean;
+}
+/**
+ * Recursively discover all skill directories under catalogDir containing SKILL.md.
+ */
+declare function discoverSkillDirectories(catalogDir: string): string[];
+/**
+ * Parse a single skill directory and validate its SKILL.md manifest and Level 3 layout.
+ */
+declare function parseSkillDirectory(skillDir: string, options?: ParseSkillOptions): ParsedSkillDirectory;
+/**
+ * Discover all Subagent Markdown definitions in catalog/subagents/ and .github/agents/*.agent.md.
+ */
+declare function discoverSubagentFiles(repoOrCatalogRoot: string): string[];
+/**
+ * Parse and validate a Subagent definition file.
+ */
+declare function parseSubagentFile(filePath: string): ParsedSubagentFile;
+
+/**
+ * 3-Level Progressive Disclosure & Subagent Token Budget Linter (INV-SKILL-01 & INV-SKILL-04).
+ */
+interface SkillTokenBudgetAudit {
+    readonly skillName: string;
+    readonly skillDir: string;
+    readonly l1Words: number;
+    readonly l1Tokens: number;
+    readonly l2Lines: number;
+    readonly l2Tokens: number;
+    readonly totalLines: number;
+    readonly scriptsCount: number;
+    readonly passed: boolean;
+    readonly errors: string[];
+    readonly warnings: string[];
+}
+interface SubagentTokenBudgetAudit {
+    readonly subagentName: string;
+    readonly filePath: string;
+    readonly descriptionTokens: number;
+    readonly systemPromptLines: number;
+    readonly systemPromptTokens: number;
+    readonly maxOutputTokens: number;
+    readonly tools: string[];
+    readonly passed: boolean;
+    readonly errors: string[];
+}
+interface CatalogTokenBudgetSummary {
+    readonly catalogPath: string;
+    readonly skills: SkillTokenBudgetAudit[];
+    readonly subagents: SubagentTokenBudgetAudit[];
+    readonly totalL1Tokens: number;
+    readonly totalSubagentPromptTokens: number;
+    readonly errors: string[];
+    readonly warnings: string[];
+    readonly passed: boolean;
+}
+declare function auditSkillTokenBudget(skillDir: string, options?: {
+    requireLayout?: boolean;
+}): SkillTokenBudgetAudit;
+declare function auditSubagentTokenBudget(filePath: string): SubagentTokenBudgetAudit;
+declare function auditCatalogTokenBudgets(catalogDir: string, options?: {
+    requireLayout?: boolean;
+}): CatalogTokenBudgetSummary;
+
+/**
+ * Zero-API Hybrid Lexical & Structural Semantic Collision Detector (ADR-0002).
+ *
+ * Prevents Implicit Routing Collapse (arXiv:2610.18522) across large skill & subagent
+ * libraries using weighted TF-IDF word unigrams, bigrams, and character 3-grams with
+ * O(N) vector pre-normalization.
+ */
+
+declare function stripNegativeTriggerClauses(description: string): string;
+declare function tokenizeRoutingText(text: string): string[];
+/**
+ * Extract weighted lexical, bigram, character 3-gram, and structural routing features.
+ */
+declare function extractSkillFeatures(manifest: SkillManifest): Map<string, number>;
+/**
+ * Compute smooth corpus IDF weights: idf(t) = 1 + ln((N + 1) / (df(t) + 1)).
+ */
+declare function computeIdfWeights(featureMaps: readonly Map<string, number>[]): Map<string, number>;
+/**
+ * Compute weighted cosine similarity and top shared terms between two feature maps.
+ */
+declare function computeFeatureCosine(featuresA: Map<string, number>, featuresB: Map<string, number>, idfWeights?: Map<string, number>): {
+    similarity: number;
+    sharedTerms: string[];
+};
+/**
+ * Compute all pairwise semantic similarities with O(N) vector pre-normalization.
+ */
+declare function computeCollisionMatrix(manifests: readonly SkillManifest[]): CollisionPair[];
+interface AuditCatalogOptions {
+    readonly requireLayout?: boolean;
+}
+/**
+ * Audit a catalog directory for L1/L2/L3 token budgets, subagent contracts, and semantic collisions.
+ */
+declare function auditCatalog(catalogDir: string, options?: AuditCatalogOptions): CollisionReport;
+
+/**
+ * Repository Token Economy & Startup Context Tax Analyzer (`npx skillops@latest tokens`).
+ *
+ * Implements Issue #60:
+ * - Scans always-on repository instruction files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`,
+ *   `.github/copilot-instructions.md`), `.cursor/rules/*.mdc`, and `.mcp.json` / `.cursor/mcp.json`.
+ * - Scans catalog/repository Skills (L1 frontmatter vs L2 Markdown body vs L3 zero-token scripts)
+ *   and Context-Isolated Subagents (`SUBAGENT.md` / `*.agent.md`).
+ * - Quantifies Startup Token Tax, Monolithic Equivalent Tokens, Progressive Disclosure L1 Tokens,
+ *   Estimated Tokens Saved, Token Savings %, and actionable TokenWasteHotspot items.
+ */
+
+interface AnalyzeTokenEconomyOptions {
+    readonly catalogDir?: string;
+    readonly startupTaxBudget?: number;
+}
+/**
+ * Analyze a repository's Startup Token Tax and Progressive Disclosure savings.
+ */
+declare function analyzeRepoTokenEconomy(repoPath: string, options?: AnalyzeTokenEconomyOptions): TokenEconomyReport;
+/**
+ * Render a TokenEconomyReport as a human-readable ASCII table, Markdown report, or JSON string.
+ */
+declare function formatTokenEconomyReport(report: TokenEconomyReport, format?: "table" | "json" | "markdown" | "github"): string;
+
+/**
+ * Repository Environment Diagnostics & Lockfile Drift Auditor (`npx skillops-cli@latest doctor` / `status`).
+ *
+ * Implements Issue #104:
+ * - Verifies Node.js runtime (`>= 20.0.0`) and Python runtime availability (`>= 3.12`) for Level 3 scripts.
+ * - Validates `.skillops.yml` declarative configuration via `loadSkillOpsConfig()`.
+ * - Audits `.skillops-lock.json` tracked artifacts and verifies their on-disk SHA-256 hash (`healthy`, `drifted`, `missing`).
+ * - Audits Startup Token Tax status via `analyzeRepoTokenEconomy()`.
+ */
+
+interface LockfileArtifactDiagnostic {
+    readonly relative_path: string;
+    readonly target: RuntimeTarget;
+    readonly item_name: string;
+    readonly expected_sha256: string;
+    readonly actual_sha256: string | null;
+    readonly status: "healthy" | "drifted" | "missing";
+}
+interface DoctorCheckItem {
+    readonly id: "node_runtime" | "python_runtime" | "detected_harnesses" | "skillops_config" | "lockfile_integrity" | "startup_token_tax";
+    readonly title: string;
+    readonly status: "pass" | "warn" | "fail";
+    readonly summary: string;
+}
+interface DoctorReport {
+    readonly status: "pass" | "warn" | "fail";
+    readonly repo_path: string;
+    readonly node_version: string;
+    readonly python_version: string | null;
+    readonly detected_harnesses: readonly RuntimeTarget[];
+    readonly config_present: boolean;
+    readonly config_valid: boolean;
+    readonly config_error?: string;
+    readonly lockfile_present: boolean;
+    readonly lockfile_valid: boolean;
+    readonly tracked_artifacts_count: number;
+    readonly healthy_artifacts_count: number;
+    readonly drifted_artifacts_count: number;
+    readonly missing_artifacts_count: number;
+    readonly artifacts: readonly LockfileArtifactDiagnostic[];
+    readonly startup_tax_tokens: number;
+    readonly startup_tax_budget: number;
+    readonly startup_tax_within_budget: boolean;
+    readonly checks: readonly DoctorCheckItem[];
+    readonly remediation: readonly string[];
+}
+interface HarnessInspectionEntry extends RuntimeHarnessSpec {
+    readonly detected: boolean;
+}
+interface HarnessInspectionReport {
+    readonly repo_path: string;
+    readonly total_supported: number;
+    readonly detected_count: number;
+    readonly detected_harnesses: readonly RuntimeTarget[];
+    readonly harnesses: readonly HarnessInspectionEntry[];
+}
+interface DiagnoseRepositoryOptions {
+    readonly catalogDir?: string;
+    readonly startupTaxBudget?: number;
+}
+/**
+ * Run comprehensive environment, configuration, lockfile drift, and token economy diagnostics.
+ */
+declare function diagnoseRepository(repoPath: string, options?: DiagnoseRepositoryOptions): DoctorReport;
+/**
+ * Inspect all 20 supported AI coding agent harnesses and report which ones are detected in `repoPath`.
+ */
+declare function inspectHarnesses(repoPath: string): HarnessInspectionReport;
+/**
+ * Format a `HarnessInspectionReport` as a terminal table, Markdown table, or JSON string.
+ */
+declare function formatHarnessInspectionReport(report: HarnessInspectionReport, format?: "table" | "json" | "markdown"): string;
+/**
+ * Format a `DoctorReport` as a terminal table, Markdown report, or JSON string.
+ */
+declare function formatDoctorReport(report: DoctorReport, format?: "table" | "json" | "markdown" | "github"): string;
+
+/**
+ * Deterministic, zero-execution Repository Stack Fingerprinter (`src/router/fingerprinter.ts`).
+ *
+ * Inspects manifest files (`pyproject.toml`, `requirements*.txt`, `uv.lock`, `package.json`,
+ * `tsconfig.json`, `Cargo.toml`, `go.mod`, `Dockerfile`, `docker-compose*.yml`, `.github/workflows`),
+ * SQL files, and source files without executing untrusted repository code.
+ */
+
+declare function normalizePackageName(rawSpec: string): string;
+declare class RepoFingerprinter {
+    readonly repoPath: string;
+    constructor(repoPath: string);
+    fingerprint(): RepoProfile;
+}
+declare function fingerprintRepository(repoPath: string): RepoProfile;
+
+/**
+ * Dynamic Skill & Subagent Router (`src/router/bundle_compiler.ts`).
+ *
+ * Enforces INV-SKILL-03:
+ * - Compiles a deterministic, collision-free bundle of <= 12 skills (<= 1,500 L1 tokens,
+ *   < 0.78 pairwise cosine similarity) tailored to the repository fingerprint and task prompt.
+ * - Selects matching Context-Isolated Subagents (`recommended_subagents`).
+ */
+
+interface RouteOptions {
+    readonly maxSkills?: number;
+    readonly maxL1Tokens?: number;
+    readonly maxSimilarity?: number;
+    readonly taskPrompt?: string;
+}
+declare function scoreSkillAgainstProfile(parsedSkill: ParsedSkillDirectory, profile: RepoProfile, taskPrompt?: string): {
+    score: number;
+    matchedSignals: string[];
+    negativeMatch: string | null;
+};
+declare function compileSkillBundle(profile: RepoProfile, catalogDir: string, options?: RouteOptions): RoutedBundle;
+declare function routeRepository(repoPath: string, catalogDir: string, options?: RouteOptions): RoutedBundle;
+declare function formatRoutedBundle(bundle: RoutedBundle, format?: "table" | "json" | "markdown"): string;
+
+/**
+ * Multi-Runtime Transpiler for Skills & Context-Isolated Subagents (`src/sync/adapters.ts`).
+ *
+ * Implements Issue #61:
+ * - Transpiles Hybrid Executable Skills (SKILL.md + Level 3 scripts/references) and
+ *   Context-Isolated Subagents (SUBAGENT.md) across:
+ *   1. Claude Code (`.claude/skills/<name>/`, `.claude/agents/<name>.md`)
+ *   2. Antigravity / Gemini CLI (`.agent/skills/<name>/`, `.agent/agents/<name>.md`)
+ *   3. Cursor (`.cursor/rules/skillops-<name>.mdc`, `.cursor/rules/skillops-agent-<name>.mdc`)
+ *   4. OpenAI Codex CLI (`.codex/skills/<name>/`, `.codex/agents/<name>.md`, `AGENTS.md`)
+ *   5. GitHub Copilot (`.github/instructions/`, `.github/prompts/`, `.github/agents/<name>.agent.md`)
+ * - Enforces `.skillops-lock.json` SHA-256 integrity, local drift detection, and surgical `add`.
+ */
+
+interface SyncOptions extends RouteOptions {
+    readonly targets?: readonly RuntimeTarget[];
+    readonly dryRun?: boolean;
+    readonly force?: boolean;
+}
+interface AddOptions {
+    readonly targets?: readonly RuntimeTarget[];
+    readonly dryRun?: boolean;
+    readonly force?: boolean;
+}
+interface RemoveOptions {
+    readonly targets?: readonly RuntimeTarget[];
+    readonly dryRun?: boolean;
+    readonly force?: boolean;
+}
+interface CleanOptions {
+    readonly dryRun?: boolean;
+    readonly force?: boolean;
+}
+declare function computeSha256(content: string): string;
+declare function renderCodexAgentsIndex(existingContent: string | null, skills: readonly ParsedSkillDirectory[], subagents: readonly ParsedSubagentFile[]): string;
+declare function syncRepository(repoPath: string, catalogDir: string, options?: SyncOptions): SyncReport;
+/**
+ * Surgically install a single Skill or Subagent by name across active runtime targets.
+ */
+declare function addSkillOrSubagent(repoPath: string, catalogDir: string, itemName: string, options?: AddOptions): SyncReport;
+declare function stripCodexAgentsBlock(existingContent: string): string;
+/**
+ * Surgically remove a single synced Skill or Subagent by name across target runtimes.
+ */
+declare function removeSkillOrSubagent(repoPath: string, catalogDir: string, itemName: string, options?: RemoveOptions): SyncReport;
+/**
+ * Clean all SkillOps-managed runtime artifacts tracked in `.skillops-lock.json`.
+ */
+declare function cleanSyncedArtifacts(repoPath: string, catalogDir: string, options?: CleanOptions): SyncReport;
+declare function formatSyncReport(report: SyncReport, format?: "table" | "json" | "markdown"): string;
+
+/**
+ * Zero-API Deterministic TDD Benchmark Runner & Static HTML/Markdown Exporter (`src/eval/index.ts`).
+ *
+ * Enforces INV-SKILL-05:
+ * - Validates `evals/evals.json` assertions and `evals/benchmark.json` (`with_skill` vs `without_skill`).
+ * - Verifies that every skill demonstrates measurable pass-rate lift (`delta.pass_rate_gain >= 0.15`)
+ *   and reduced token consumption compared to unguided baseline runs.
+ * - Exports static HTML dashboards, GitHub-flavored Markdown tables, JSON, and ASCII tables.
+ */
+
+declare const EvalAssertionSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    target: z.ZodString;
+    description: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    description: string;
+    target: string;
+    id: string;
+}, {
+    type: string;
+    description: string;
+    target: string;
+    id: string;
+}>;
+type EvalAssertion = z.infer<typeof EvalAssertionSchema>;
+declare const EvalCaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    prompt: z.ZodString;
+    fixtures: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    assertions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        target: z.ZodString;
+        description: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        description: string;
+        target: string;
+        id: string;
+    }, {
+        type: string;
+        description: string;
+        target: string;
+        id: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    prompt: string;
+    fixtures: string[];
+    assertions: {
+        type: string;
+        description: string;
+        target: string;
+        id: string;
+    }[];
+}, {
+    name: string;
+    id: string;
+    prompt: string;
+    assertions: {
+        type: string;
+        description: string;
+        target: string;
+        id: string;
+    }[];
+    fixtures?: string[] | undefined;
+}>;
+type EvalCase = z.infer<typeof EvalCaseSchema>;
+declare const SkillEvalSuiteSchema: z.ZodObject<{
+    skill_name: z.ZodString;
+    schema_version: z.ZodDefault<z.ZodString>;
+    evals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        prompt: z.ZodString;
+        fixtures: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        assertions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            target: z.ZodString;
+            description: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            type: string;
+            description: string;
+            target: string;
+            id: string;
+        }, {
+            type: string;
+            description: string;
+            target: string;
+            id: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        prompt: string;
+        fixtures: string[];
+        assertions: {
+            type: string;
+            description: string;
+            target: string;
+            id: string;
+        }[];
+    }, {
+        name: string;
+        id: string;
+        prompt: string;
+        assertions: {
+            type: string;
+            description: string;
+            target: string;
+            id: string;
+        }[];
+        fixtures?: string[] | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    skill_name: string;
+    schema_version: string;
+    evals: {
+        name: string;
+        id: string;
+        prompt: string;
+        fixtures: string[];
+        assertions: {
+            type: string;
+            description: string;
+            target: string;
+            id: string;
+        }[];
+    }[];
+}, {
+    skill_name: string;
+    evals: {
+        name: string;
+        id: string;
+        prompt: string;
+        assertions: {
+            type: string;
+            description: string;
+            target: string;
+            id: string;
+        }[];
+        fixtures?: string[] | undefined;
+    }[];
+    schema_version?: string | undefined;
+}>;
+type SkillEvalSuite = z.infer<typeof SkillEvalSuiteSchema>;
+declare const BenchmarkArmSchema: z.ZodObject<{
+    pass_rate_mean: z.ZodNumber;
+    pass_rate_stddev: z.ZodNumber;
+    tokens_mean: z.ZodNumber;
+    latency_ms_mean: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    pass_rate_mean: number;
+    pass_rate_stddev: number;
+    tokens_mean: number;
+    latency_ms_mean: number;
+}, {
+    pass_rate_mean: number;
+    pass_rate_stddev: number;
+    tokens_mean: number;
+    latency_ms_mean: number;
+}>;
+type BenchmarkArm = z.infer<typeof BenchmarkArmSchema>;
+declare const BenchmarkDeltaSchema: z.ZodObject<{
+    pass_rate_gain: z.ZodNumber;
+    token_reduction_pct: z.ZodNumber;
+    verdict: z.ZodEnum<["CERTIFIED_IMPROVEMENT", "NEUTRAL", "REGRESSION"]>;
+}, "strict", z.ZodTypeAny, {
+    pass_rate_gain: number;
+    token_reduction_pct: number;
+    verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+}, {
+    pass_rate_gain: number;
+    token_reduction_pct: number;
+    verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+}>;
+type BenchmarkDelta = z.infer<typeof BenchmarkDeltaSchema>;
+declare const SkillBenchmarkSchema: z.ZodObject<{
+    skill_name: z.ZodString;
+    runner: z.ZodDefault<z.ZodString>;
+    timestamp: z.ZodString;
+    eval_cases_count: z.ZodDefault<z.ZodNumber>;
+    assertions_count: z.ZodDefault<z.ZodNumber>;
+    with_skill: z.ZodObject<{
+        pass_rate_mean: z.ZodNumber;
+        pass_rate_stddev: z.ZodNumber;
+        tokens_mean: z.ZodNumber;
+        latency_ms_mean: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    }, {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    }>;
+    without_skill: z.ZodObject<{
+        pass_rate_mean: z.ZodNumber;
+        pass_rate_stddev: z.ZodNumber;
+        tokens_mean: z.ZodNumber;
+        latency_ms_mean: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    }, {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    }>;
+    delta: z.ZodObject<{
+        pass_rate_gain: z.ZodNumber;
+        token_reduction_pct: z.ZodNumber;
+        verdict: z.ZodEnum<["CERTIFIED_IMPROVEMENT", "NEUTRAL", "REGRESSION"]>;
+    }, "strict", z.ZodTypeAny, {
+        pass_rate_gain: number;
+        token_reduction_pct: number;
+        verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+    }, {
+        pass_rate_gain: number;
+        token_reduction_pct: number;
+        verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+    }>;
+    passed: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    passed: boolean;
+    skill_name: string;
+    runner: string;
+    timestamp: string;
+    eval_cases_count: number;
+    assertions_count: number;
+    with_skill: {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    };
+    without_skill: {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    };
+    delta: {
+        pass_rate_gain: number;
+        token_reduction_pct: number;
+        verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+    };
+}, {
+    skill_name: string;
+    timestamp: string;
+    with_skill: {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    };
+    without_skill: {
+        pass_rate_mean: number;
+        pass_rate_stddev: number;
+        tokens_mean: number;
+        latency_ms_mean: number;
+    };
+    delta: {
+        pass_rate_gain: number;
+        token_reduction_pct: number;
+        verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+    };
+    passed?: boolean | undefined;
+    runner?: string | undefined;
+    eval_cases_count?: number | undefined;
+    assertions_count?: number | undefined;
+}>;
+type SkillBenchmark = z.infer<typeof SkillBenchmarkSchema>;
+declare const CatalogEvalSummarySchema: z.ZodObject<{
+    catalog_path: z.ZodString;
+    skills_evaluated: z.ZodNumber;
+    mean_with_skill_pass_rate: z.ZodNumber;
+    mean_without_skill_pass_rate: z.ZodNumber;
+    mean_pass_rate_gain: z.ZodNumber;
+    mean_token_reduction_pct: z.ZodNumber;
+    benchmarks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        skill_name: z.ZodString;
+        runner: z.ZodDefault<z.ZodString>;
+        timestamp: z.ZodString;
+        eval_cases_count: z.ZodDefault<z.ZodNumber>;
+        assertions_count: z.ZodDefault<z.ZodNumber>;
+        with_skill: z.ZodObject<{
+            pass_rate_mean: z.ZodNumber;
+            pass_rate_stddev: z.ZodNumber;
+            tokens_mean: z.ZodNumber;
+            latency_ms_mean: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        }, {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        }>;
+        without_skill: z.ZodObject<{
+            pass_rate_mean: z.ZodNumber;
+            pass_rate_stddev: z.ZodNumber;
+            tokens_mean: z.ZodNumber;
+            latency_ms_mean: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        }, {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        }>;
+        delta: z.ZodObject<{
+            pass_rate_gain: z.ZodNumber;
+            token_reduction_pct: z.ZodNumber;
+            verdict: z.ZodEnum<["CERTIFIED_IMPROVEMENT", "NEUTRAL", "REGRESSION"]>;
+        }, "strict", z.ZodTypeAny, {
+            pass_rate_gain: number;
+            token_reduction_pct: number;
+            verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+        }, {
+            pass_rate_gain: number;
+            token_reduction_pct: number;
+            verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+        }>;
+        passed: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        passed: boolean;
+        skill_name: string;
+        runner: string;
+        timestamp: string;
+        eval_cases_count: number;
+        assertions_count: number;
+        with_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        without_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        delta: {
+            pass_rate_gain: number;
+            token_reduction_pct: number;
+            verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+        };
+    }, {
+        skill_name: string;
+        timestamp: string;
+        with_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        without_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        delta: {
+            pass_rate_gain: number;
+            token_reduction_pct: number;
+            verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+        };
+        passed?: boolean | undefined;
+        runner?: string | undefined;
+        eval_cases_count?: number | undefined;
+        assertions_count?: number | undefined;
+    }>, "many">>;
+    passed: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    catalog_path: string;
+    passed: boolean;
+    skills_evaluated: number;
+    mean_with_skill_pass_rate: number;
+    mean_without_skill_pass_rate: number;
+    mean_pass_rate_gain: number;
+    mean_token_reduction_pct: number;
+    benchmarks: {
+        passed: boolean;
+        skill_name: string;
+        runner: string;
+        timestamp: string;
+        eval_cases_count: number;
+        assertions_count: number;
+        with_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        without_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        delta: {
+            pass_rate_gain: number;
+            token_reduction_pct: number;
+            verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+        };
+    }[];
+}, {
+    catalog_path: string;
+    passed: boolean;
+    skills_evaluated: number;
+    mean_with_skill_pass_rate: number;
+    mean_without_skill_pass_rate: number;
+    mean_pass_rate_gain: number;
+    mean_token_reduction_pct: number;
+    benchmarks?: {
+        skill_name: string;
+        timestamp: string;
+        with_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        without_skill: {
+            pass_rate_mean: number;
+            pass_rate_stddev: number;
+            tokens_mean: number;
+            latency_ms_mean: number;
+        };
+        delta: {
+            pass_rate_gain: number;
+            token_reduction_pct: number;
+            verdict: "CERTIFIED_IMPROVEMENT" | "NEUTRAL" | "REGRESSION";
+        };
+        passed?: boolean | undefined;
+        runner?: string | undefined;
+        eval_cases_count?: number | undefined;
+        assertions_count?: number | undefined;
+    }[] | undefined;
+}>;
+type CatalogEvalSummary = z.infer<typeof CatalogEvalSummarySchema>;
+declare function evaluateSkillDirectory(skillDir: string): SkillBenchmark;
+declare function evaluateCatalog(catalogDir: string, options?: {
+    skillFilter?: string;
+}): CatalogEvalSummary;
+declare function formatEvalSummary(summary: CatalogEvalSummary, format?: "table" | "json" | "markdown" | "html" | "github"): string;
+
+/**
+ * Native JSON-RPC 2.0 Stdio Model Context Protocol Server (`src/mcp/index.ts`).
+ *
+ * Exposes zero-API SkillOps tools over stdio without polluting stdout:
+ * - `audit_catalog`
+ * - `analyze_repo_tokens`
+ * - `route_repo_skills`
+ * - `run_skill_script`
+ * - `get_skill_benchmark`
+ * - `list_catalog_items`
+ */
+
+interface JsonRpcRequest {
+    readonly jsonrpc: "2.0";
+    readonly id?: string | number | null;
+    readonly method: string;
+    readonly params?: Record<string, unknown>;
+}
+interface JsonRpcResponse {
+    readonly jsonrpc: "2.0";
+    readonly id: string | number | null;
+    readonly result?: unknown;
+    readonly error?: {
+        readonly code: number;
+        readonly message: string;
+    };
+}
+interface McpServerContext {
+    readonly repoPath: string;
+    readonly catalogDir: string;
+}
+declare function handleMcpJsonRpcRequest(request: JsonRpcRequest, context: McpServerContext): JsonRpcResponse | null;
+declare function startMcpStdioServer(context: McpServerContext): void;
+interface McpSetupOptions {
+    readonly targets?: readonly RuntimeTarget[];
+    readonly dryRun?: boolean;
+    readonly serverName?: string;
+}
+interface McpConfigAction {
+    readonly target: RuntimeTarget;
+    readonly display_name: string;
+    readonly relative_path: string;
+    readonly status: "created" | "updated" | "unchanged" | "unsupported";
+}
+interface McpSetupReport {
+    readonly repo_path: string;
+    readonly dry_run: boolean;
+    readonly targets_requested: readonly RuntimeTarget[];
+    readonly configured_count: number;
+    readonly actions: readonly McpConfigAction[];
+}
+/**
+ * Idempotently register the SkillOps stdio MCP server (`npx -y skillops-cli@latest mcp`)
+ * across all requested AI coding agent harnesses that support MCP.
+ */
+declare function setupMcpForHarnesses(repoPath: string, options?: McpSetupOptions): McpSetupReport;
+/**
+ * Format an `McpSetupReport` as a terminal table, Markdown report, or JSON string.
+ */
+declare function formatMcpSetupReport(report: McpSetupReport, format?: "table" | "json" | "markdown"): string;
+
+export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type DiagnoseRepositoryOptions, type DoctorCheckItem, type DoctorReport, type EvalAssertion, EvalAssertionSchema, type EvalCase, EvalCaseSchema, ExitCode, type ExitCodeValue, type HarnessCategory, type HarnessInspectionEntry, type HarnessInspectionReport, type HarnessSkillFormat, type JsonRpcRequest, type JsonRpcResponse, type LoadedSkillOpsConfigResult, type LockfileArtifactDiagnostic, type McpConfigAction, type McpServerContext, type McpSetupOptions, type McpSetupReport, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, RUNTIME_HARNESS_SPECS, type RemoveOptions, RepoFingerprinter, type RepoProfile, RepoProfileSchema, type RouteOptions, type RoutedBundle, RoutedBundleSchema, type RoutingSignals, RoutingSignalsSchema, type RuntimeHarnessSpec, type RuntimeTarget, RuntimeTargetSchema, SKILLOPS_VERSION, type ScoredSkill, ScoredSkillSchema, type ScriptEntrypoint, ScriptEntrypointSchema, type SkillBenchmark, SkillBenchmarkSchema, type SkillEntrypoints, SkillEntrypointsSchema, type SkillEvalSuite, SkillEvalSuiteSchema, type SkillManifest, type SkillManifestInput, SkillManifestSchema, type SkillOpsConfig, SkillOpsConfigSchema, type SkillOpsDetectedStackConfig, SkillOpsDetectedStackConfigSchema, type SkillOpsTokenEconomyConfig, SkillOpsTokenEconomyConfigSchema, type SkillTokenBudgetAudit, type SkippedSkill, SkippedSkillSchema, type SubagentManifest, SubagentManifestSchema, type SubagentTokenBudgetAudit, type SyncLockEntry, SyncLockEntrySchema, type SyncLockfile, SyncLockfileSchema, type SyncOptions, type SyncReport, SyncReportSchema, type SyncedArtifact, SyncedArtifactSchema, type TokenEconomyReport, TokenEconomyReportSchema, type TokenFileCategory, TokenFileCategorySchema, type TokenFileEntry, TokenFileEntrySchema, type TokenWasteHotspot, TokenWasteHotspotSchema, addSkillOrSubagent, analyzeRepoTokenEconomy, auditCatalog, auditCatalogTokenBudgets, auditSkillTokenBudget, auditSubagentTokenBudget, classifyCollisionSeverity, cleanSyncedArtifacts, compileSkillBundle, computeCollisionMatrix, computeFeatureCosine, computeIdfWeights, computeSha256, countWords, createCollisionPair, createCollisionReport, createSkillManifest, createSubagentManifest, detectInstalledHarnesses, diagnoseRepository, discoverSkillDirectories, discoverSubagentFiles, estimateTokenCount, evaluateCatalog, evaluateSkillDirectory, extractSkillFeatures, fingerprintRepository, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatRoutedBundle, formatSyncReport, formatTokenEconomyReport, handleMcpJsonRpcRequest, inspectHarnesses, loadSkillOpsConfig, normalizePackageName, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderCodexAgentsIndex, resolveRuntimeTargets, routeRepository, scoreSkillAgainstProfile, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripCodexAgentsBlock, stripNegativeTriggerClauses, syncRepository, tokenizeRoutingText };