skillops-cli 1.3.0 → 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.3.0";
+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`).
  *
@@ -1417,6 +1303,120 @@ declare function formatHarnessInspectionReport(report: HarnessInspectionReport,
  */
 declare function formatDoctorReport(report: DoctorReport, format?: "table" | "json" | "markdown" | "github"): string;
 
+/**
+ * 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;
+
+/**
+ * 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;
+
 /**
  * Zero-API Deterministic TDD Benchmark Runner & Static HTML/Markdown Exporter (`src/eval/index.ts`).
  *
@@ -2049,22 +2049,6 @@ declare function setupMcpForHarnesses(repoPath: string, options?: McpSetupOption
  */
 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`).
  *
@@ -2089,6 +2073,22 @@ declare function compileSkillBundle(profile: RepoProfile, catalogDir: string, op
 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`).
  *
@@ -2165,7 +2165,7 @@ declare const COMMAND_HELP_SPECS: readonly CommandHelpSpec[];
  */
 declare function findCommandHelpSpec(commandOrAlias: string): CommandHelpSpec | undefined;
 /**
- * Render the 3-Pillar Framework & Library global help screen (`npx skillops-cli --help`).
+ * Render the compact, emoji-free 3-Pillar Framework & Library global help tree (`npx skillops-cli --help`).
  */
 declare function renderGlobalHelp(version: string, colorEnabled?: boolean): string;
 /**
@@ -2228,7 +2228,7 @@ interface BoxOptions {
  */
 declare function renderBox(lines: readonly string[], options?: BoxOptions): string;
 /**
- * Render the official SkillOps Framework & Library top banner.
+ * Render the official SkillOps Framework & Library top header line (clean tree root).
  */
 declare function renderHeaderBanner(subtitle?: string, options?: {
     version?: string;
@@ -2258,7 +2258,7 @@ declare function renderTokenBar(current: number, max: number, options?: TokenBar
  */
 declare const renderProgressBar: typeof renderTokenBar;
 /**
- * Render a stylized section header with a bold cyan rule.
+ * Render a clean minimalist tree section header (`├─ Title`).
  */
 declare function renderSectionHeader(title: string, colorEnabled?: boolean): string;
 type BadgeType = "pass" | "warn" | "fail" | "info" | "skill" | "subagent";
@@ -2267,7 +2267,7 @@ type BadgeType = "pass" | "warn" | "fail" | "info" | "skill" | "subagent";
  */
 declare function formatBadge(type: BadgeType, customLabel?: string, colorEnabled?: boolean): string;
 /**
- * Render a numbered onboarding step line (`  ✔ [1/4] Title — Detail`).
+ * 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 {
@@ -2275,11 +2275,11 @@ interface NextStepHint {
     readonly description: string;
 }
 /**
- * Render an actionable "Next steps" footer guiding the developer on what to run next.
+ * 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 practical guide explaining how to invoke installed Skills & Subagents inside the user's AI coding agents.
+ * 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;
 /**