skillops-cli 0.0.0-stage → 1.3.0

package/dist/index.d.ts

@@ -0,0 +1,2295 @@
+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.3.0";
+/**
+ * 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;
+
+/**
+ * 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;
+
+/**
+ * SkillOps Framework & Library Operations Engine (Issue #126).
+ *
+ * Implements:
+ * 1. Library Explorer: `inspectCatalogItem` (`skillops info <name>`) & `searchCatalog` (`skillops search <query>`)
+ * 2. Framework Scaffolder: `scaffoldFrameworkItem` (`skillops create skill|subagent <name>`)
+ * 3. 1-Command Onboarding Pipeline: `runQuickstart` (`skillops quickstart` / `skillops setup`)
+ */
+
+interface CatalogItemInfo {
+    readonly kind: "skill" | "subagent";
+    readonly name: string;
+    readonly description: string;
+    readonly path: string;
+    readonly l1Tokens: number;
+    readonly l2Lines: number;
+    readonly l2Tokens: number;
+    readonly savingsPct: number;
+    readonly scripts: readonly string[];
+    readonly evalCasesCount: number;
+    readonly tools: readonly string[];
+    readonly maxOutputTokens: number | null;
+    readonly isolation: string | null;
+    readonly headings: readonly string[];
+}
+/**
+ * Inspect a single Skill or Subagent from the Library by name (`skillops info <name>`).
+ */
+declare function inspectCatalogItem(catalogDir: string, itemName: string): CatalogItemInfo;
+/**
+ * Format detailed inspection card for a Skill or Subagent.
+ */
+declare function formatCatalogItemInfo(info: CatalogItemInfo, format?: "table" | "json" | "markdown", colorEnabled?: boolean): string;
+interface CatalogSearchMatch {
+    readonly kind: "skill" | "subagent";
+    readonly name: string;
+    readonly score: number;
+    readonly tokens: number;
+    readonly summary: string;
+}
+interface CatalogSearchReport {
+    readonly query: string;
+    readonly total_matches: number;
+    readonly matches: readonly CatalogSearchMatch[];
+}
+/**
+ * Search the SkillOps Library of Skills & Subagents by keyword (`skillops search <query>`).
+ */
+declare function searchCatalog(catalogDir: string, query: string): CatalogSearchReport;
+/**
+ * Format search results from the SkillOps Library.
+ */
+declare function formatCatalogSearchReport(report: CatalogSearchReport, format?: "table" | "json" | "markdown", colorEnabled?: boolean): string;
+interface ScaffoldResult {
+    readonly kind: "skill" | "subagent";
+    readonly name: string;
+    readonly target_dir: string;
+    readonly created_files: readonly string[];
+}
+interface ScaffoldOptions {
+    readonly description?: string;
+    readonly force?: boolean;
+}
+/**
+ * Scaffold a new custom Hybrid Executable Skill (`INV-SKILL-01..03`) or Context-Isolated Subagent (`INV-SKILL-04`)
+ * using the SkillOps Framework Contract (`skillops create skill|subagent <name>`).
+ */
+declare function scaffoldFrameworkItem(catalogDir: string, kind: "skill" | "subagent", rawName: string, options?: ScaffoldOptions): ScaffoldResult;
+/**
+ * Format the output of `skillops create skill|subagent <name>`.
+ */
+declare function formatScaffoldReport(result: ScaffoldResult, format?: "table" | "json" | "markdown", colorEnabled?: boolean): string;
+interface QuickstartOptions {
+    readonly targetsArg?: string;
+    readonly maxSkills?: number;
+    readonly dryRun?: boolean;
+    readonly force?: boolean;
+    readonly skipMcp?: boolean;
+}
+interface QuickstartReport {
+    readonly repo_path: string;
+    readonly config_path: string;
+    readonly dry_run: boolean;
+    readonly detected_languages: readonly string[];
+    readonly detected_frameworks: readonly string[];
+    readonly detected_harnesses: readonly RuntimeTarget[];
+    readonly active_targets: readonly RuntimeTarget[];
+    readonly selected_skills: readonly string[];
+    readonly selected_subagents: readonly string[];
+    readonly total_l1_tokens: number;
+    readonly max_l1_budget: number;
+    readonly synced_files_count: number;
+    readonly mcp_configured_count: number;
+    readonly passed: boolean;
+}
+/**
+ * Execute the 1-Command Onboarding Pipeline (`skillops quickstart` / `skillops setup`).
+ */
+declare function runQuickstart(repoPath: string, catalogDir: string, options?: QuickstartOptions): QuickstartReport;
+/**
+ * Render the visual 4-step Quickstart summary dashboard.
+ */
+declare function formatQuickstartReport(report: QuickstartReport, format?: "table" | "json" | "markdown", colorEnabled?: boolean): 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;
+
+/**
+ * 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", colorEnabled?: boolean): 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", colorEnabled?: boolean): string;
+
+/**
+ * SkillOps CLI Help System, 3-Pillar Framework/Library Dashboard & Fuzzy Typo Matcher (`src/ui/help.ts`).
+ */
+interface CommandOptionSpec {
+    readonly flags: string;
+    readonly description: string;
+}
+interface CommandHelpSpec {
+    readonly name: string;
+    readonly aliases: readonly string[];
+    readonly pillar: "library" | "framework" | "runtime";
+    readonly summary: string;
+    readonly usage: string;
+    readonly options: readonly CommandOptionSpec[];
+    readonly examples: readonly {
+        readonly command: string;
+        readonly description: string;
+    }[];
+}
+declare const COMMAND_HELP_SPECS: readonly CommandHelpSpec[];
+/**
+ * Find a command help specification by primary name or alias.
+ */
+declare function findCommandHelpSpec(commandOrAlias: string): CommandHelpSpec | undefined;
+/**
+ * Render the 3-Pillar Framework & Library global help screen (`npx skillops-cli --help`).
+ */
+declare function renderGlobalHelp(version: string, colorEnabled?: boolean): string;
+/**
+ * Render detailed per-command help (`npx skillops-cli <cmd> --help` or `npx skillops-cli help <cmd>`).
+ */
+declare function renderCommandHelp(spec: CommandHelpSpec, version: string, colorEnabled?: boolean): string;
+
+/**
+ * SkillOps Zero-Dependency Terminal UI (TUI) Aesthetic Engine.
+ *
+ * Provides ANSI styling with automatic TTY / NO_COLOR / FORCE_COLOR awareness,
+ * Unicode rounded panels, ANSI-aware aligned multi-column tables, visual token
+ * budget progress bars, step indicators, AI invocation guides, and fuzzy
+ * Levenshtein command suggestions.
+ */
+interface ColorOverrideOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly isTTY?: boolean;
+}
+/**
+ * Determine whether ANSI terminal colors should be emitted.
+ * Respects https://no-color.org (`NO_COLOR`), `FORCE_COLOR`, `TERM=dumb`, and `stdout.isTTY`.
+ */
+declare function isColorEnabled(options?: ColorOverrideOptions): boolean;
+declare const style: {
+    bold: (text: string, enabled?: boolean) => string;
+    dim: (text: string, enabled?: boolean) => string;
+    italic: (text: string, enabled?: boolean) => string;
+    underline: (text: string, enabled?: boolean) => string;
+    cyan: (text: string, enabled?: boolean) => string;
+    green: (text: string, enabled?: boolean) => string;
+    yellow: (text: string, enabled?: boolean) => string;
+    red: (text: string, enabled?: boolean) => string;
+    magenta: (text: string, enabled?: boolean) => string;
+    blue: (text: string, enabled?: boolean) => string;
+    gray: (text: string, enabled?: boolean) => string;
+    white: (text: string, enabled?: boolean) => string;
+};
+/**
+ * Strip all ANSI SGR escape sequences from a string.
+ */
+declare function stripAnsi(text: string): string;
+/**
+ * Compute visible character width of a string ignoring ANSI color codes.
+ */
+declare function visibleLength(text: string): number;
+/**
+ * Pad a potentially ANSI-styled string to a target visible width.
+ */
+declare function padVisible(text: string, width: number, align?: "left" | "right" | "center"): string;
+interface BoxOptions {
+    readonly title?: string;
+    readonly borderColor?: (text: string, enabled?: boolean) => string;
+    readonly paddingX?: number;
+    readonly minWidth?: number;
+    readonly colorEnabled?: boolean;
+}
+/**
+ * Render a rounded Unicode panel (`╭───╮ │ ╰───╯`).
+ */
+declare function renderBox(lines: readonly string[], options?: BoxOptions): string;
+/**
+ * Render the official SkillOps Framework & Library top banner.
+ */
+declare function renderHeaderBanner(subtitle?: string, options?: {
+    version?: string;
+    colorEnabled?: boolean;
+}): string;
+interface TableOptions {
+    readonly align?: readonly ("left" | "right" | "center")[];
+    readonly indent?: number;
+    readonly colorEnabled?: boolean;
+}
+/**
+ * Render an ANSI-aware multi-column aligned table with Unicode header rules.
+ */
+declare function renderTable(headers: readonly string[], rows: readonly (readonly string[])[], options?: TableOptions): string;
+interface TokenBarOptions {
+    readonly width?: number;
+    readonly label?: string;
+    readonly unit?: string;
+    readonly colorEnabled?: boolean;
+}
+/**
+ * Render a visual token budget progress bar (`[████████░░░░░░░░] 48.0% (720 / 1,500 tokens)`).
+ */
+declare function renderTokenBar(current: number, max: number, options?: TokenBarOptions): string;
+/**
+ * Alias for renderTokenBar used across token/budget progress visualizations.
+ */
+declare const renderProgressBar: typeof renderTokenBar;
+/**
+ * Render a stylized section header with a bold cyan rule.
+ */
+declare function renderSectionHeader(title: string, colorEnabled?: boolean): string;
+type BadgeType = "pass" | "warn" | "fail" | "info" | "skill" | "subagent";
+/**
+ * Render a semantic status or artifact badge.
+ */
+declare function formatBadge(type: BadgeType, customLabel?: string, colorEnabled?: boolean): string;
+/**
+ * Render a numbered onboarding step line (`  ✔ [1/4] Title — Detail`).
+ */
+declare function renderStep(step: number, total: number, title: string, detail?: string, status?: "done" | "warn" | "skip", colorEnabled?: boolean): string;
+interface NextStepHint {
+    readonly command: string;
+    readonly description: string;
+}
+/**
+ * Render an actionable "Next steps" footer guiding the developer on what to run next.
+ */
+declare function renderNextSteps(hints: readonly NextStepHint[], colorEnabled?: boolean): string;
+/**
+ * Render a practical guide explaining how to invoke installed Skills & Subagents inside the user's AI coding agents.
+ */
+declare function renderAiUsageGuide(targets: readonly string[], skills: readonly string[], subagents: readonly string[], colorEnabled?: boolean): string;
+/**
+ * Compute Levenshtein edit distance between two strings for typo suggestions.
+ */
+declare function levenshteinDistance(a: string, b: string): number;
+declare const DEFAULT_VALID_COMMANDS: readonly string[];
+/**
+ * Suggest the closest valid CLI command when a user makes a typo.
+ */
+declare function suggestCommand(unknownCommand: string, validCommands?: readonly string[]): string | null;
+
+export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BadgeType, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, type BoxOptions, COMMAND_HELP_SPECS, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogItemInfo, type CatalogSearchMatch, type CatalogSearchReport, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type ColorOverrideOptions, type CommandHelpSpec, type CommandOptionSpec, DEFAULT_VALID_COMMANDS, 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 NextStepHint, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, type QuickstartOptions, type QuickstartReport, 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 ScaffoldOptions, type ScaffoldResult, 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 TableOptions, type TokenBarOptions, 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, findCommandHelpSpec, fingerprintRepository, formatBadge, formatCatalogItemInfo, formatCatalogSearchReport, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatQuickstartReport, formatRoutedBundle, formatScaffoldReport, formatSyncReport, formatTokenEconomyReport, handleMcpJsonRpcRequest, inspectCatalogItem, inspectHarnesses, isColorEnabled, levenshteinDistance, loadSkillOpsConfig, normalizePackageName, padVisible, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderAiUsageGuide, renderBox, renderCodexAgentsIndex, renderCommandHelp, renderGlobalHelp, renderHeaderBanner, renderNextSteps, renderProgressBar, renderSectionHeader, renderStep, renderTable, renderTokenBar, resolveRuntimeTargets, routeRepository, runQuickstart, scaffoldFrameworkItem, scoreSkillAgainstProfile, searchCatalog, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripAnsi, stripCodexAgentsBlock, stripNegativeTriggerClauses, style, suggestCommand, syncRepository, tokenizeRoutingText, visibleLength };