skillops-cli 1.2.1 → 1.3.1

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { z } from 'zod';
  * telemetry and Multi-Runtime Transpilation lockfiles.
  */
 
-declare const SKILLOPS_VERSION = "1.2.1";
+declare const SKILLOPS_VERSION = "1.3.1";
 /**
  * Count whitespace-delimited words in text.
  */
@@ -1189,95 +1189,6 @@ interface LoadedSkillOpsConfigResult {
  */
 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).
  *
@@ -1315,31 +1226,6 @@ interface AuditCatalogOptions {
  */
 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`).
  *
@@ -1418,95 +1304,118 @@ declare function formatHarnessInspectionReport(report: HarnessInspectionReport,
 declare function formatDoctorReport(report: DoctorReport, format?: "table" | "json" | "markdown" | "github"): string;
 
 /**
- * Deterministic, zero-execution Repository Stack Fingerprinter (`src/router/fingerprinter.ts`).
- *
- * Inspects manifest files (`pyproject.toml`, `requirements*.txt`, `uv.lock`, `package.json`,
- * `tsconfig.json`, `Cargo.toml`, `go.mod`, `Dockerfile`, `docker-compose*.yml`, `.github/workflows`),
- * SQL files, and source files without executing untrusted repository code.
+ * Directory and file discovery/parsing engine for Hybrid Executable Skills (SKILL.md)
+ * and Context-Isolated Subagents (SUBAGENT.md / *.agent.md).
  */
 
-declare function normalizePackageName(rawSpec: string): string;
-declare class RepoFingerprinter {
-    readonly repoPath: string;
-    constructor(repoPath: string);
-    fingerprint(): RepoProfile;
+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;
 }
-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`).
+ * Recursively discover all skill directories under catalogDir containing SKILL.md.
  */
-
-interface RouteOptions {
-    readonly maxSkills?: number;
-    readonly maxL1Tokens?: number;
-    readonly maxSimilarity?: number;
-    readonly taskPrompt?: string;
-}
-declare function scoreSkillAgainstProfile(parsedSkill: ParsedSkillDirectory, profile: RepoProfile, taskPrompt?: string): {
-    score: number;
-    matchedSignals: string[];
-    negativeMatch: string | null;
-};
-declare function compileSkillBundle(profile: RepoProfile, catalogDir: string, options?: RouteOptions): RoutedBundle;
-declare function routeRepository(repoPath: string, catalogDir: string, options?: RouteOptions): RoutedBundle;
-declare function formatRoutedBundle(bundle: RoutedBundle, format?: "table" | "json" | "markdown"): string;
-
+declare function discoverSkillDirectories(catalogDir: string): 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`.
+ * 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;
 
-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;
+/**
+ * 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 RemoveOptions {
-    readonly targets?: readonly RuntimeTarget[];
-    readonly dryRun?: boolean;
-    readonly force?: boolean;
+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 CleanOptions {
-    readonly dryRun?: boolean;
-    readonly force?: boolean;
+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 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;
+declare function auditSkillTokenBudget(skillDir: string, options?: {
+    requireLayout?: boolean;
+}): SkillTokenBudgetAudit;
+declare function auditSubagentTokenBudget(filePath: string): SubagentTokenBudgetAudit;
+declare function auditCatalogTokenBudgets(catalogDir: string, options?: {
+    requireLayout?: boolean;
+}): CatalogTokenBudgetSummary;
+
 /**
- * Surgically install a single Skill or Subagent by name across active runtime targets.
+ * 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.
  */
-declare function addSkillOrSubagent(repoPath: string, catalogDir: string, itemName: string, options?: AddOptions): SyncReport;
-declare function stripCodexAgentsBlock(existingContent: string): string;
+
+interface AnalyzeTokenEconomyOptions {
+    readonly catalogDir?: string;
+    readonly startupTaxBudget?: number;
+}
 /**
- * Surgically remove a single synced Skill or Subagent by name across target runtimes.
+ * Analyze a repository's Startup Token Tax and Progressive Disclosure savings.
  */
-declare function removeSkillOrSubagent(repoPath: string, catalogDir: string, itemName: string, options?: RemoveOptions): SyncReport;
+declare function analyzeRepoTokenEconomy(repoPath: string, options?: AnalyzeTokenEconomyOptions): TokenEconomyReport;
 /**
- * Clean all SkillOps-managed runtime artifacts tracked in `.skillops-lock.json`.
+ * Render a TokenEconomyReport as a human-readable ASCII table, Markdown report, or JSON string.
  */
-declare function cleanSyncedArtifacts(repoPath: string, catalogDir: string, options?: CleanOptions): SyncReport;
-declare function formatSyncReport(report: SyncReport, format?: "table" | "json" | "markdown"): string;
+declare function formatTokenEconomyReport(report: TokenEconomyReport, format?: "table" | "json" | "markdown" | "github"): string;
 
 /**
  * Zero-API Deterministic TDD Benchmark Runner & Static HTML/Markdown Exporter (`src/eval/index.ts`).
@@ -1975,6 +1884,110 @@ declare function evaluateCatalog(catalogDir: string, options?: {
 }): 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`).
  *
@@ -2036,4 +2049,247 @@ declare function setupMcpForHarnesses(repoPath: string, options?: McpSetupOption
  */
 declare function formatMcpSetupReport(report: McpSetupReport, format?: "table" | "json" | "markdown"): string;
 
-export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type DiagnoseRepositoryOptions, type DoctorCheckItem, type DoctorReport, type EvalAssertion, EvalAssertionSchema, type EvalCase, EvalCaseSchema, ExitCode, type ExitCodeValue, type HarnessCategory, type HarnessInspectionEntry, type HarnessInspectionReport, type HarnessSkillFormat, type JsonRpcRequest, type JsonRpcResponse, type LoadedSkillOpsConfigResult, type LockfileArtifactDiagnostic, type McpConfigAction, type McpServerContext, type McpSetupOptions, type McpSetupReport, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, RUNTIME_HARNESS_SPECS, type RemoveOptions, RepoFingerprinter, type RepoProfile, RepoProfileSchema, type RouteOptions, type RoutedBundle, RoutedBundleSchema, type RoutingSignals, RoutingSignalsSchema, type RuntimeHarnessSpec, type RuntimeTarget, RuntimeTargetSchema, SKILLOPS_VERSION, type ScoredSkill, ScoredSkillSchema, type ScriptEntrypoint, ScriptEntrypointSchema, type SkillBenchmark, SkillBenchmarkSchema, type SkillEntrypoints, SkillEntrypointsSchema, type SkillEvalSuite, SkillEvalSuiteSchema, type SkillManifest, type SkillManifestInput, SkillManifestSchema, type SkillOpsConfig, SkillOpsConfigSchema, type SkillOpsDetectedStackConfig, SkillOpsDetectedStackConfigSchema, type SkillOpsTokenEconomyConfig, SkillOpsTokenEconomyConfigSchema, type SkillTokenBudgetAudit, type SkippedSkill, SkippedSkillSchema, type SubagentManifest, SubagentManifestSchema, type SubagentTokenBudgetAudit, type SyncLockEntry, SyncLockEntrySchema, type SyncLockfile, SyncLockfileSchema, type SyncOptions, type SyncReport, SyncReportSchema, type SyncedArtifact, SyncedArtifactSchema, type TokenEconomyReport, TokenEconomyReportSchema, type TokenFileCategory, TokenFileCategorySchema, type TokenFileEntry, TokenFileEntrySchema, type TokenWasteHotspot, TokenWasteHotspotSchema, addSkillOrSubagent, analyzeRepoTokenEconomy, auditCatalog, auditCatalogTokenBudgets, auditSkillTokenBudget, auditSubagentTokenBudget, classifyCollisionSeverity, cleanSyncedArtifacts, compileSkillBundle, computeCollisionMatrix, computeFeatureCosine, computeIdfWeights, computeSha256, countWords, createCollisionPair, createCollisionReport, createSkillManifest, createSubagentManifest, detectInstalledHarnesses, diagnoseRepository, discoverSkillDirectories, discoverSubagentFiles, estimateTokenCount, evaluateCatalog, evaluateSkillDirectory, extractSkillFeatures, fingerprintRepository, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatRoutedBundle, formatSyncReport, formatTokenEconomyReport, handleMcpJsonRpcRequest, inspectHarnesses, loadSkillOpsConfig, normalizePackageName, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderCodexAgentsIndex, resolveRuntimeTargets, routeRepository, scoreSkillAgainstProfile, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripCodexAgentsBlock, stripNegativeTriggerClauses, syncRepository, tokenizeRoutingText };
+/**
+ * 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;
+
+/**
+ * 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;
+
+/**
+ * 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 compact, emoji-free 3-Pillar Framework & Library global help tree (`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 header line (clean tree root).
+ */
+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 clean minimalist tree section header (`├─ Title`).
+ */
+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" tree footer guiding the developer on what to run next.
+ */
+declare function renderNextSteps(hints: readonly NextStepHint[], colorEnabled?: boolean): string;
+/**
+ * Render a compact, emoji-free tree guide explaining how to invoke installed Skills & Subagents.
+ */
+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 };