ccski 0.0.0 → 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,334 @@
+import { z } from "zod";
+
+//#region src/types/skill.d.ts
+/**
+ * Skill location types
+ */
+type SkillLocation = "user" | "project" | "plugin";
+/**
+ * Core skill metadata interface
+ */
+interface SkillMetadata {
+  /** Skill name (from frontmatter) */
+  name: string;
+  /** Skill description (from frontmatter) */
+  description: string;
+  /** Location type */
+  location: SkillLocation;
+  /** Absolute path to skill directory */
+  path: string;
+  /** Whether the skill has a references/ directory */
+  hasReferences: boolean;
+  /** Whether the skill has a scripts/ directory */
+  hasScripts: boolean;
+  /** Whether the skill has an assets/ directory */
+  hasAssets: boolean;
+  /** Plugin information (only for plugin skills) */
+  pluginInfo?: {
+    pluginName: string;
+    marketplace: string;
+    version: string;
+  };
+}
+/**
+ * Complete skill interface with content
+ */
+interface Skill extends SkillMetadata {
+  /** Full markdown content (including frontmatter) */
+  content: string;
+  /** Full qualified name (e.g., "plugin:skill" for plugin skills) */
+  fullName: string;
+}
+/**
+ * SKILL.md frontmatter interface
+ */
+interface SkillFrontmatter {
+  name: string;
+  description: string;
+  [key: string]: unknown;
+}
+/**
+ * Plugin registry entry from installed_plugins.json
+ */
+interface PluginEntry {
+  version: string;
+  installedAt: string;
+  lastUpdated: string;
+  installPath: string;
+  gitCommitSha: string;
+  isLocal: boolean;
+}
+/**
+ * Installed plugins JSON structure
+ */
+interface InstalledPlugins {
+  version: number;
+  plugins: Record<string, PluginEntry>;
+}
+//#endregion
+//#region src/types/errors.d.ts
+/**
+ * Base error class for ccski errors
+ */
+declare class CcskiError extends Error {
+  readonly suggestions: string[];
+  constructor(message: string, suggestions?: string[]);
+}
+/**
+ * Error thrown when a skill is not found
+ */
+declare class SkillNotFoundError extends CcskiError {
+  skillName: string;
+  constructor(skillName: string, suggestions?: string[]);
+}
+/**
+ * Error thrown when a skill name is ambiguous
+ */
+declare class AmbiguousSkillNameError extends CcskiError {
+  skillName: string;
+  matches: string[];
+  constructor(skillName: string, matches: string[]);
+}
+/**
+ * Error thrown when skill validation fails
+ */
+declare class ValidationError extends CcskiError {
+  filePath: string;
+  issues: string[];
+  constructor(filePath: string, issues: string[], suggestions?: string[]);
+}
+/**
+ * Error thrown when parsing SKILL.md fails
+ */
+declare class ParseError extends CcskiError {
+  filePath: string;
+  reason: string;
+  constructor(filePath: string, reason: string, suggestions?: string[]);
+}
+//#endregion
+//#region src/types/schemas.d.ts
+/**
+ * Schema for SKILL.md frontmatter
+ */
+declare const SkillFrontmatterSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+  name: z.ZodString;
+  description: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+  name: z.ZodString;
+  description: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Schema for plugin entry in installed_plugins.json
+ */
+declare const PluginEntrySchema: z.ZodObject<{
+  version: z.ZodString;
+  installedAt: z.ZodString;
+  lastUpdated: z.ZodString;
+  installPath: z.ZodString;
+  gitCommitSha: z.ZodString;
+  isLocal: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+  version: string;
+  installedAt: string;
+  lastUpdated: string;
+  installPath: string;
+  gitCommitSha: string;
+  isLocal: boolean;
+}, {
+  version: string;
+  installedAt: string;
+  lastUpdated: string;
+  installPath: string;
+  gitCommitSha: string;
+  isLocal: boolean;
+}>;
+/**
+ * Schema for installed_plugins.json
+ */
+declare const InstalledPluginsSchema: z.ZodObject<{
+  version: z.ZodNumber;
+  plugins: z.ZodRecord<z.ZodString, z.ZodObject<{
+    version: z.ZodString;
+    installedAt: z.ZodString;
+    lastUpdated: z.ZodString;
+    installPath: z.ZodString;
+    gitCommitSha: z.ZodString;
+    isLocal: z.ZodBoolean;
+  }, "strip", z.ZodTypeAny, {
+    version: string;
+    installedAt: string;
+    lastUpdated: string;
+    installPath: string;
+    gitCommitSha: string;
+    isLocal: boolean;
+  }, {
+    version: string;
+    installedAt: string;
+    lastUpdated: string;
+    installPath: string;
+    gitCommitSha: string;
+    isLocal: boolean;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  version: number;
+  plugins: Record<string, {
+    version: string;
+    installedAt: string;
+    lastUpdated: string;
+    installPath: string;
+    gitCommitSha: string;
+    isLocal: boolean;
+  }>;
+}, {
+  version: number;
+  plugins: Record<string, {
+    version: string;
+    installedAt: string;
+    lastUpdated: string;
+    installPath: string;
+    gitCommitSha: string;
+    isLocal: boolean;
+  }>;
+}>;
+/**
+ * Infer TypeScript types from Zod schemas
+ */
+type SkillFrontmatterType = z.infer<typeof SkillFrontmatterSchema>;
+type PluginEntryType = z.infer<typeof PluginEntrySchema>;
+type InstalledPluginsType = z.infer<typeof InstalledPluginsSchema>;
+//#endregion
+//#region src/core/parser.d.ts
+/**
+ * Parse result from parseSkillFile
+ */
+interface ParseResult {
+  frontmatter: SkillFrontmatter;
+  content: string;
+  fullContent: string;
+}
+/**
+ * Parse a SKILL.md file and extract frontmatter and content
+ *
+ * @param filePath - Absolute path to SKILL.md file
+ * @returns Parsed frontmatter and content
+ * @throws {ParseError} If file cannot be read or parsed
+ * @throws {ValidationError} If frontmatter validation fails
+ */
+declare function parseSkillFile(filePath: string): ParseResult;
+/**
+ * Validate a SKILL.md file without throwing errors
+ *
+ * @param filePath - Absolute path to SKILL.md file
+ * @returns Validation result with success flag and error messages
+ */
+declare function validateSkillFile(filePath: string): {
+  success: boolean;
+  errors: string[];
+  suggestions: string[];
+};
+//#endregion
+//#region src/core/discovery.d.ts
+/**
+ * Skill directories in priority order (highest to lowest)
+ */
+declare const SKILL_DIRECTORIES: readonly [".agent/skills", ".claude/skills", `${string}/.agent/skills`, `${string}/.claude/skills`];
+interface DiscoveryDiagnostics {
+  scannedDirectories: string[];
+  warnings: string[];
+  conflicts: string[];
+}
+interface DiscoveryResult {
+  skills: SkillMetadata[];
+  diagnostics: DiscoveryDiagnostics;
+}
+/**
+ * Options for skill discovery
+ */
+interface DiscoveryOptions {
+  /** Additional custom directories to scan */
+  customDirs?: string[];
+  /** Skip plugin skills */
+  skipPlugins?: boolean;
+  /** Whether to scan built-in directories (.agent/.claude). Defaults to true. */
+  scanDefaultDirs?: boolean;
+}
+interface ScanOptions {
+  location?: SkillLocation;
+  recursive?: boolean;
+  diagnostics: DiscoveryDiagnostics;
+}
+/**
+ * Scan a single skill directory and return found skills
+ */
+declare function scanSkillDirectory(dirPath: string, {
+  location,
+  recursive,
+  diagnostics
+}: ScanOptions): SkillMetadata[];
+/**
+ * Discover all skills from standard directories
+ */
+declare function discoverSkills(options?: DiscoveryOptions): DiscoveryResult;
+/**
+ * Load full skill content
+ */
+declare function loadSkill(metadata: SkillMetadata): Skill;
+//#endregion
+//#region src/core/plugins.d.ts
+interface PluginDiscoveryOptions {
+  pluginsFile?: string;
+  pluginsRoot?: string;
+}
+//#endregion
+//#region src/core/registry.d.ts
+type SkillRegistryOptions = DiscoveryOptions & PluginDiscoveryOptions;
+/**
+ * Skill registry for managing discovered skills
+ */
+declare class SkillRegistry {
+  private options;
+  private skills;
+  private diagnostics;
+  constructor(options?: SkillRegistryOptions);
+  /**
+   * Refresh the skill registry by rescanning directories
+   */
+  refresh(): void;
+  /**
+   * Get all skills
+   */
+  getAll(): SkillMetadata[];
+  /**
+   * Find a skill by name (case-insensitive, supports full and short names)
+   */
+  find(name: string): SkillMetadata;
+  /**
+   * Check if a skill exists
+   */
+  has(name: string): boolean;
+  /**
+   * Load full skill content
+   */
+  load(name: string): Skill;
+  /**
+   * Get suggestions for similar skill names (fuzzy matching)
+   */
+  private getSuggestions;
+  /**
+   * Get diagnostic information
+   */
+  getDiagnostics(): {
+    totalSkills: number;
+    byLocation: Record<string, number>;
+    directoriesScanned: string[];
+    pluginSources: string[];
+    warnings: string[];
+    conflicts: string[];
+  };
+}
+//#endregion
+export { AmbiguousSkillNameError, CcskiError, DiscoveryDiagnostics, DiscoveryOptions, DiscoveryResult, InstalledPlugins, InstalledPluginsSchema, InstalledPluginsType, ParseError, ParseResult, PluginEntry, PluginEntrySchema, PluginEntryType, SKILL_DIRECTORIES, Skill, SkillFrontmatter, SkillFrontmatterSchema, SkillFrontmatterType, SkillLocation, SkillMetadata, SkillNotFoundError, SkillRegistry, SkillRegistryOptions, ValidationError, discoverSkills, loadSkill, parseSkillFile, scanSkillDirectory, validateSkillFile };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/skill.ts","../src/types/errors.ts","../src/types/schemas.ts","../src/core/parser.ts","../src/core/discovery.ts","../src/core/plugins.ts","../src/core/registry.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { F as AmbiguousSkillNameError, I as CcskiError, L as ParseError, R as SkillNotFoundError, _ as validateSkillFile, a as discoverSkills, b as SkillFrontmatterSchema, g as parseSkillFile, i as SKILL_DIRECTORIES, o as loadSkill, s as scanSkillDirectory, t as SkillRegistry, v as InstalledPluginsSchema, y as PluginEntrySchema, z as ValidationError } from "./registry-DGrbpgs5.mjs";
+
+export { AmbiguousSkillNameError, CcskiError, InstalledPluginsSchema, ParseError, PluginEntrySchema, SKILL_DIRECTORIES, SkillFrontmatterSchema, SkillNotFoundError, SkillRegistry, ValidationError, discoverSkills, loadSkill, parseSkillFile, scanSkillDirectory, validateSkillFile };