skillops-cli 1.2.1 → 1.3.0

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.0";
 /**
  * Count whitespace-delimited words in text.
  */
@@ -1417,97 +1417,6 @@ 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.
- */
-
-declare function normalizePackageName(rawSpec: string): string;
-declare class RepoFingerprinter {
-    readonly repoPath: string;
-    constructor(repoPath: string);
-    fingerprint(): RepoProfile;
-}
-declare function fingerprintRepository(repoPath: string): RepoProfile;
-
-/**
- * Dynamic Skill & Subagent Router (`src/router/bundle_compiler.ts`).
- *
- * Enforces INV-SKILL-03:
- * - Compiles a deterministic, collision-free bundle of <= 12 skills (<= 1,500 L1 tokens,
- *   < 0.78 pairwise cosine similarity) tailored to the repository fingerprint and task prompt.
- * - Selects matching Context-Isolated Subagents (`recommended_subagents`).
- */
-
-interface RouteOptions {
-    readonly maxSkills?: number;
-    readonly maxL1Tokens?: number;
-    readonly maxSimilarity?: number;
-    readonly taskPrompt?: string;
-}
-declare function scoreSkillAgainstProfile(parsedSkill: ParsedSkillDirectory, profile: RepoProfile, taskPrompt?: string): {
-    score: number;
-    matchedSignals: string[];
-    negativeMatch: string | null;
-};
-declare function compileSkillBundle(profile: RepoProfile, catalogDir: string, options?: RouteOptions): RoutedBundle;
-declare function routeRepository(repoPath: string, catalogDir: string, options?: RouteOptions): RoutedBundle;
-declare function formatRoutedBundle(bundle: RoutedBundle, format?: "table" | "json" | "markdown"): string;
-
-/**
- * Multi-Runtime Transpiler for Skills & Context-Isolated Subagents (`src/sync/adapters.ts`).
- *
- * Implements Issue #61:
- * - Transpiles Hybrid Executable Skills (SKILL.md + Level 3 scripts/references) and
- *   Context-Isolated Subagents (SUBAGENT.md) across:
- *   1. Claude Code (`.claude/skills/<name>/`, `.claude/agents/<name>.md`)
- *   2. Antigravity / Gemini CLI (`.agent/skills/<name>/`, `.agent/agents/<name>.md`)
- *   3. Cursor (`.cursor/rules/skillops-<name>.mdc`, `.cursor/rules/skillops-agent-<name>.mdc`)
- *   4. OpenAI Codex CLI (`.codex/skills/<name>/`, `.codex/agents/<name>.md`, `AGENTS.md`)
- *   5. GitHub Copilot (`.github/instructions/`, `.github/prompts/`, `.github/agents/<name>.agent.md`)
- * - Enforces `.skillops-lock.json` SHA-256 integrity, local drift detection, and surgical `add`.
- */
-
-interface SyncOptions extends RouteOptions {
-    readonly targets?: readonly RuntimeTarget[];
-    readonly dryRun?: boolean;
-    readonly force?: boolean;
-}
-interface AddOptions {
-    readonly targets?: readonly RuntimeTarget[];
-    readonly dryRun?: boolean;
-    readonly force?: boolean;
-}
-interface RemoveOptions {
-    readonly targets?: readonly RuntimeTarget[];
-    readonly dryRun?: boolean;
-    readonly force?: boolean;
-}
-interface CleanOptions {
-    readonly dryRun?: boolean;
-    readonly force?: boolean;
-}
-declare function computeSha256(content: string): string;
-declare function renderCodexAgentsIndex(existingContent: string | null, skills: readonly ParsedSkillDirectory[], subagents: readonly ParsedSubagentFile[]): string;
-declare function syncRepository(repoPath: string, catalogDir: string, options?: SyncOptions): SyncReport;
-/**
- * Surgically install a single Skill or Subagent by name across active runtime targets.
- */
-declare function addSkillOrSubagent(repoPath: string, catalogDir: string, itemName: string, options?: AddOptions): SyncReport;
-declare function stripCodexAgentsBlock(existingContent: string): string;
-/**
- * Surgically remove a single synced Skill or Subagent by name across target runtimes.
- */
-declare function removeSkillOrSubagent(repoPath: string, catalogDir: string, itemName: string, options?: RemoveOptions): SyncReport;
-/**
- * Clean all SkillOps-managed runtime artifacts tracked in `.skillops-lock.json`.
- */
-declare function cleanSyncedArtifacts(repoPath: string, catalogDir: string, options?: CleanOptions): SyncReport;
-declare function formatSyncReport(report: SyncReport, format?: "table" | "json" | "markdown"): string;
-
 /**
  * Zero-API Deterministic TDD Benchmark Runner & Static HTML/Markdown Exporter (`src/eval/index.ts`).
  *
@@ -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 };
+/**
+ * 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 };