@skillit/core 1.5.0

package/dist/types.d.ts

@@ -0,0 +1,519 @@
+import type { ExtractedConfigSurface } from './config-types.js';
+/** Extracted API surface for a single package/module */
+export interface ExtractedSkill {
+    /** Package or module name */
+    name: string;
+    /** Package description */
+    description: string;
+    /** License identifier (e.g. "MIT", "Apache-2.0") */
+    license?: string;
+    /** Keywords from package.json — used to enrich trigger descriptions */
+    keywords?: string[];
+    /** Repository URL */
+    repository?: string;
+    /** Author name */
+    author?: string;
+    /** Package description from package.json or README intro — used for SKILL.md description and body */
+    packageDescription?: string;
+    /** Extended remarks from @packageDocumentation @remarks — architectural context, trade-offs, mental models */
+    remarks?: string;
+    /** Additional documentation content (from projectDocuments, README, etc.) */
+    documents?: ExtractedDocument[];
+    /** Exported functions */
+    functions: ExtractedFunction[];
+    /** Exported classes */
+    classes: ExtractedClass[];
+    /** Exported interfaces and type aliases */
+    types: ExtractedType[];
+    /** Exported enums */
+    enums: ExtractedEnum[];
+    /** Exported variables and constants */
+    variables: ExtractedVariable[];
+    /** Usage examples from @example tags or doc pages */
+    examples: string[];
+    /** Aggregated @useWhen triggers from all exports */
+    useWhen?: string[];
+    /** Aggregated @useWhen with source info for decision tables */
+    useWhenSources?: Array<{
+        text: string;
+        sourceName: string;
+        sourceKind: string;
+        sourceDescription?: string;
+    }>;
+    /** Aggregated @avoidWhen triggers from all exports */
+    avoidWhen?: string[];
+    /** Aggregated @avoidWhen with source info for decision tables */
+    avoidWhenSources?: Array<{
+        text: string;
+        sourceName: string;
+        sourceKind: string;
+        sourceDescription?: string;
+    }>;
+    /** Aggregated @never from all exports */
+    pitfalls?: string[];
+    /** Configuration surfaces (CLI commands, config files) */
+    configSurfaces?: ExtractedConfigSurface[];
+    /** Features section from README — rendered inline in SKILL.md */
+    readmeFeatures?: string;
+    /** Troubleshooting section from README — rendered inline in SKILL.md */
+    readmeTroubleshooting?: string;
+    /** MCP resources (empty/absent for non-MCP extractors). */
+    resources?: ExtractedResource[];
+    /** MCP prompts (empty/absent for non-MCP extractors). */
+    prompts?: ExtractedPrompt[];
+    /** Setup instructions emitted when the invocation target is CLI-based. */
+    setup?: SkillSetup;
+    /**
+     * Structured audit execution state for extractors that run an audit pipeline.
+     *
+     * `undefined` means the extractor does not populate audit state. Use this
+     * field when callers need to distinguish "audit skipped" from "audit ran
+     * clean" without relying on optional-array semantics.
+     */
+    readonly audit?: ExtractedSkillAudit;
+    /**
+     * Structured audit findings surfaced for backward compatibility.
+     *
+     * Tri-state semantics:
+     * - `undefined` — audit was skipped or this extractor does not populate
+     *   compatibility findings.
+     * - `[]` — audit ran and found no issues.
+     * - `[…]` — audit ran and found issues. Length and `severity` distribution
+     *   are the gate criteria for CI.
+     *
+     * @remarks
+     * The element shape (`McpAuditIssue`) is forward-declared here in
+     * `@skillit/core` so this field is typeable without a runtime dependency
+     * on `@skillit/mcp`. The concrete audit engine lives in `@skillit/mcp`,
+     * which re-exports the type as `AuditIssue` for adapter-author ergonomics.
+     *
+     * @deprecated Prefer `audit`. When present, this mirrors
+     * `audit.status === 'completed' ? audit.issues : undefined`.
+     */
+    readonly auditIssues?: readonly McpAuditIssue[];
+}
+/** Audit severity levels for structured extractor findings. */
+export type McpAuditSeverity = 'fatal' | 'error' | 'warning' | 'alert';
+export type ExtractedSkillAudit = {
+    readonly status: 'skipped';
+} | {
+    readonly status: 'completed';
+    readonly issues: readonly McpAuditIssue[];
+};
+/**
+ * Structural shape of an extractor audit issue. Historically this matched the
+ * MCP package's `AuditIssue`, and the name is retained for compatibility, but
+ * other extractors may also populate `ExtractedSkill.auditIssues` using this
+ * shared structural contract.
+ */
+export interface McpAuditIssue {
+    /** Pipeline-specific finding code such as M1 or C4. */
+    readonly code: `${string}${number}`;
+    /** Severity level. */
+    readonly severity: McpAuditSeverity;
+    /** Human-readable description of the finding. */
+    readonly message: string;
+    /** Where the issue was found. Fields vary by extractor. */
+    readonly location?: {
+        readonly tool?: string;
+        readonly parameter?: string;
+        readonly command?: string;
+        readonly option?: string;
+        readonly argument?: string;
+    };
+    /** Actionable next step or concrete remediation hint. */
+    readonly suggestion?: string;
+}
+/** An MCP-exposed resource (static or templated URI, readable by the agent harness). */
+export interface ExtractedResource {
+    /** Canonical URI. MAY contain URI Template expressions per RFC 6570 for parameterized resources. */
+    uri: string;
+    /** Short human-readable name */
+    name: string;
+    /** Prose description (single paragraph) */
+    description: string;
+    /** MIME type of the resource content. Optional — not all servers advertise it. */
+    mimeType?: string;
+    /** Source module for grouping (rarely meaningful for resources; present for IR parity). */
+    sourceModule?: string;
+}
+/** An MCP-exposed prompt (a named, argument-templated prompt the agent may request). */
+export interface ExtractedPrompt {
+    /** Short identifier used by MCP `prompts/get` requests. */
+    name: string;
+    /** Prose description of what the prompt produces. */
+    description: string;
+    /** Typed argument schema (may be empty). */
+    arguments: ExtractedPromptArgument[];
+    /** Present for IR parity with functions/classes; rarely meaningful for prompts. */
+    sourceModule?: string;
+}
+export interface ExtractedPromptArgument {
+    name: string;
+    description: string;
+    /**
+     * Whether the argument is mandatory on `prompts/get` invocation.
+     * MCP prompt arguments are strings in the current spec; a typed `type` field
+     * may be added in a future revision without breaking callers.
+     */
+    required: boolean;
+}
+/** Setup instructions emitted into SKILL.md body when the invocation target is CLI-based. */
+export interface SkillSetup {
+    /** Human-prose install instructions (markdown-safe). */
+    install: string;
+    /** One-time configuration step the consumer must run (e.g. `mcpc connect @server`). */
+    oneTimeSetup?: string;
+    /** Adapter fingerprint for freshness checks (per FR-IT-012). */
+    generatedBy: AdapterFingerprint;
+}
+/** Identifies the adapter that rendered a skill — used for freshness audits. */
+export interface AdapterFingerprint {
+    /** npm package name of the adapter (e.g. "@skillit/target-mcpc") */
+    adapter: string;
+    /** Adapter package semver version */
+    version: string;
+    /** Semver range of the target CLI the adapter was written against (e.g. "mcpc@^2.1") */
+    targetCliRange?: string;
+}
+export interface ExtractedFunction {
+    name: string;
+    description: string;
+    signature: string;
+    parameters: ExtractedParameter[];
+    returnType: string;
+    /** Prose description from @returns JSDoc tag */
+    returnsDescription?: string;
+    /** Extended description from @remarks tag — expert knowledge beyond summary */
+    remarks?: string;
+    examples: string[];
+    tags: Record<string, string>;
+    /** MCP-specific metadata used by MCP audit/enrichment without magic tag keys. */
+    mcpMetadata?: ExtractedFunctionMcpMetadata;
+    /** Additional overload signatures (if function has multiple signatures) */
+    overloads?: string[];
+    /** Source module name derived from file path (e.g. "renderer", "tokens") */
+    sourceModule?: string;
+    /** Category for grouping (from @category tag) */
+    category?: string;
+}
+export interface ExtractedClass {
+    name: string;
+    description: string;
+    constructorSignature: string;
+    methods: ExtractedFunction[];
+    properties: ExtractedProperty[];
+    examples: string[];
+    /** JSDoc block tags (e.g. @deprecated, @since, @useWhen, @never) */
+    tags: Record<string, string>;
+    /** Base class name (from `extends`) */
+    extends?: string;
+    /** Implemented interface names (from `implements`) */
+    implements?: string[];
+    /** Source module name derived from file path (e.g. "renderer", "tokens") */
+    sourceModule?: string;
+    /** Category for grouping (from @category tag) */
+    category?: string;
+}
+export interface ExtractedType {
+    name: string;
+    description: string;
+    definition: string;
+    properties?: ExtractedProperty[];
+    /** Source module name derived from file path (e.g. "renderer", "tokens") */
+    sourceModule?: string;
+    /** Category for grouping (from @category tag) */
+    category?: string;
+}
+export interface ExtractedEnum {
+    name: string;
+    description: string;
+    members: Array<{
+        name: string;
+        value: string;
+        description: string;
+    }>;
+    /** Source module name derived from file path (e.g. "renderer", "tokens") */
+    sourceModule?: string;
+    /** Category for grouping (from @category tag) */
+    category?: string;
+}
+export interface ExtractedVariable {
+    name: string;
+    type: string;
+    description: string;
+    isConst: boolean;
+    /** Source module name derived from file path (e.g. "renderer", "tokens") */
+    sourceModule?: string;
+    /** Category for grouping (from @category tag) */
+    category?: string;
+}
+export interface ExtractedParameter {
+    name: string;
+    type: string;
+    description: string;
+    optional: boolean;
+    defaultValue?: string;
+}
+export interface ExtractedFunctionMcpMetadata {
+    /** Structured `_meta.toSkills` metadata extracted from MCP tool annotations. */
+    readonly toSkills?: {
+        readonly useWhen?: readonly string[];
+        readonly avoidWhen?: readonly string[];
+        readonly pitfalls?: readonly string[];
+        readonly malformedReason?: string;
+    };
+    /** Schema-introspection failures that MCP audit rules should surface. */
+    readonly schemaError?: {
+        readonly kind: 'ref-cycle';
+    };
+}
+export interface ExtractedProperty {
+    name: string;
+    type: string;
+    description: string;
+    optional: boolean;
+}
+export interface ExtractedDocument {
+    /** Document title */
+    title: string;
+    /** Document content (markdown) */
+    content: string;
+    /** Category from frontmatter — used to disambiguate duplicate titles and organize into subdirs */
+    category?: string;
+    /** Frontmatter description — used for category summaries in SKILL.md */
+    description?: string;
+    /** True when this doc has children (is a parent/overview doc) */
+    isParent?: boolean;
+    /** API class/type names from {@link} tags in "## API reference" sections — enables bidirectional linking */
+    apiRefs?: string[];
+}
+/** A single rendered file */
+export interface RenderedFile {
+    /** File path relative to output dir */
+    filename: string;
+    /** File content */
+    content: string;
+    /** Estimated token count */
+    tokens?: number;
+}
+/** A rendered skill with progressive disclosure structure */
+export interface RenderedSkill {
+    /** The SKILL.md discovery file (lean — frontmatter, overview, quick ref) */
+    skill: RenderedFile;
+    /** Reference files loaded on demand (functions, classes, types, etc.) */
+    references: RenderedFile[];
+}
+export type RefCategory = 'functions' | 'classes' | 'types' | 'variables' | 'commands' | 'config' | 'docs' | 'resources' | 'prompts' | 'examples';
+export interface RefManifestEntry {
+    /** Relative path surfaced from SKILL.md loading triggers. */
+    path: `references/${string}`;
+    /** Whether the trigger points at a single file or a directory index. */
+    mode: 'file' | 'directory';
+}
+export type RefManifest = Partial<Record<RefCategory, RefManifestEntry>>;
+/** @deprecated Use RenderedFile instead */
+export type RenderedSkillLegacy = RenderedFile;
+/** Options controlling skill file writes after rendering. */
+export interface SkillWriteOptions {
+    /** Primary output directory for rendered skills. */
+    outDir: string;
+    /** Additional install targets that receive copied skill directories. */
+    installTargets?: readonly string[];
+    /**
+     * Whether to write into `outDir` as well as install targets.
+     *
+     * Callers that want install-target-only writes (for example bundled
+     * guidance that should not appear in the primary generated output) set this
+     * to `false`. Defaults to `true`.
+     */
+    includeOutDir?: boolean;
+}
+export type SkillWritePreserveReason = 'curated' | 'bundled-custom-skill' | 'bundled-name-mismatch' | 'bundled-missing-version' | 'bundled-same-version' | 'bundled-newer-version';
+export interface SkillWriteResult {
+    /** Root directory that was evaluated for this write. */
+    readonly root: string;
+    /** Whether the result applies to the primary outDir or an install target. */
+    readonly rootKind: 'outDir' | 'installTarget';
+    /** Relative skill directory name (for example `demo-skill`). */
+    readonly skillName: string;
+    /** Whether the skill was written or intentionally preserved. */
+    readonly action: 'written' | 'preserved';
+    /** Preserve reason when `action === "preserved"`. */
+    readonly preserveReason?: SkillWritePreserveReason;
+}
+/** Options controlling skill rendering */
+export interface SkillRenderOptions {
+    /** Output directory for skill files (default: ".github/skills") */
+    outDir: string;
+    /** Include usage examples (default: true) */
+    includeExamples: boolean;
+    /** Include type signatures (default: true) */
+    includeSignatures: boolean;
+    /** Maximum approximate token budget per skill (default: 4000) */
+    maxTokens: number;
+    /** Custom name prefix */
+    namePrefix: string;
+    /** License to include in frontmatter (default: read from package.json) */
+    license: string;
+    /** Invocation adapter that selects rendering dialect. Defaults to the mcp-protocol adapter. */
+    invocation?: InvocationAdapter;
+    /**
+     * Forwarded into `AdapterRenderContext.launchCommand` for invocation adapters.
+     * Used in extract mode where the host has determined how to launch a third-party
+     * MCP server (e.g. via stdio transport configuration). Mutually informative with
+     * `invocationPackageName`: when both are set, adapters typically prefer the
+     * package-name-driven launch (npx-by-name) for self-referential bundle output.
+     */
+    invocationLaunchCommand?: {
+        command: string;
+        args?: readonly string[];
+        env?: Readonly<Record<string, string>>;
+    };
+    /**
+     * Forwarded into `AdapterRenderContext.packageName` for bundle-mode self-reference.
+     * Set by `@skillit/mcp` bundle commands so the emitted skill instructs MCP-native
+     * harnesses to launch the server via `npx <packageName>`.
+     */
+    invocationPackageName?: string;
+    /**
+     * Forwarded into `AdapterRenderContext.binName` for bundle-mode multi-bin
+     * packages. When the host package's `bin` field is an object with multiple
+     * entries and the bundle config selects one, the adapter emits the npx
+     * `--package=<pkg> <binName>` form so the right bin is invoked at run time
+     * (FR-034). Ignored when `invocationPackageName` is unset.
+     */
+    invocationBinName?: string;
+    /**
+     * Forwarded into `AdapterRenderContext.httpEndpoint` for HTTP-transport extract mode.
+     *
+     * @remarks
+     * When the host extracts a skill from an HTTP-based MCP server (`--url ...`),
+     * there is no shell launch command — adapters should emit a `{ url, headers }`
+     * shape instead of `{ command, args, env }`. Set by `@skillit/mcp`'s extract
+     * pipeline. Mutually exclusive with `invocationLaunchCommand` in practice; the
+     * MCP adapter prefers `httpEndpoint` when both are present.
+     */
+    invocationHttpEndpoint?: {
+        url: string;
+        headers?: Readonly<Record<string, string>>;
+    };
+    /**
+     * Additional frontmatter keys merged into SKILL.md by the default renderer path.
+     *
+     * @remarks
+     * Used by invocation adapters that delegate body rendering to core's default
+     * path (e.g. `McpProtocolAdapter` injecting `mcp:` frontmatter). Existing keys
+     * (`name`, `description`, `license`) take precedence — collisions silently keep
+     * the existing value. The canonicalization pass alphabetizes keys after merge.
+     */
+    additionalFrontmatter?: Readonly<Record<string, unknown>>;
+    /**
+     * Markdown content injected into the SKILL.md body immediately AFTER the
+     * frontmatter delimiter and BEFORE the first heading.
+     *
+     * @remarks
+     * CLI-as-proxy invocation adapters (`@skillit/target-mcpc`,
+     * `@skillit/target-fastmcp`) use this to inject a Setup section that
+     * tells the consumer how to install/connect the underlying CLI. The string
+     * is inserted verbatim — callers are responsible for formatting and
+     * trailing newlines. Defaults to empty (no prefix injected).
+     */
+    bodyPrefix?: string;
+    /**
+     * When `true`, the default renderer path skips emission of
+     * `references/functions.md`. CLI-as-proxy adapters set this so they can
+     * emit their own `references/tools.md` carrying command-shape rows
+     * instead of TypeScript signatures. Defaults to `false`.
+     */
+    skipDefaultFunctionsRef?: boolean;
+    /**
+     * When `false`, the default renderer path returns its `RenderedSkill`
+     * without running the trailing canonicalization pass. Adapters that wrap
+     * `renderSkill` for body rendering and then mutate `references` (e.g.
+     * `@skillit/target-mcpc` appending its own `tools.md`) pass `false` here
+     * so canonicalization runs exactly once — at the host's outer wrapper —
+     * over the final shape including the appended files. Defaults to `true`.
+     *
+     * Has no effect on the invocation-adapter dispatch path (which always
+     * canonicalizes the adapter's output at the host wrapper).
+     */
+    canonicalize?: boolean;
+}
+/**
+ * Pluggable rendering strategy — selects the SKILL.md dialect emitted for an `ExtractedSkill`.
+ *
+ * Built-in implementations (shipped from `@skillit/mcp`'s target packages) include
+ * `mcp-protocol` (emits `mcp:` frontmatter for MCP-native agent harnesses) and
+ * `cli:*` targets (emit shell-command skills that route through an external MCP CLI).
+ */
+export interface InvocationAdapter {
+    readonly target: string;
+    readonly fingerprint: AdapterFingerprint;
+    render(skill: ExtractedSkill, ctx: AdapterRenderContext): Promise<RenderedSkill>;
+}
+/**
+ * Fields shared by every arm of {@link AdapterRenderContext}. Adapters can
+ * destructure these without first checking `mode`.
+ */
+export interface AdapterRenderContextBase {
+    /** Output directory name chosen by the caller (e.g. "filesystem", "my-server"). */
+    readonly skillName: string;
+    /** Token budget ceiling per reference file — adapters should stay under this but the host will truncate if exceeded. */
+    readonly maxTokens: number;
+    /** When `true` (default), the host runs a canonicalization pass on the adapter's output so re-runs produce content-identical files. */
+    readonly canonicalize: boolean;
+}
+/**
+ * Bundle-mode arm — the host bundle command flagged this skill as self-referential
+ * and the adapter should emit `npx <packageName>` (or the multi-bin
+ * `--package=<packageName> <binName>` form per FR-034) as the launch shape.
+ */
+export interface AdapterRenderContextBundle extends AdapterRenderContextBase {
+    readonly mode: 'bundle';
+    /** Bundle-mode self-reference — the package name the emitted skill should invoke via `npx`. */
+    readonly packageName: string;
+    /**
+     * Bundle-mode multi-bin selector — when set, the adapter emits the npx
+     * `--package=<packageName> <binName>` form (FR-034) so the right bin is
+     * invoked at run time. Optional; defaults to the package's single-bin
+     * default when omitted.
+     */
+    readonly binName?: string;
+}
+/**
+ * HTTP-extract arm — the host extracted the skill from an HTTP-based MCP
+ * server (`--url ...`). There is no shell launch command; adapters that emit
+ * MCP-launch frontmatter must produce a `{ url, headers }` shape.
+ */
+export interface AdapterRenderContextHttp extends AdapterRenderContextBase {
+    readonly mode: 'http';
+    readonly httpEndpoint: {
+        readonly url: string;
+        readonly headers?: Readonly<Record<string, string>>;
+    };
+}
+/**
+ * Stdio-extract arm — the host extracted the skill from a stdio-transport MCP
+ * server. Adapters that emit MCP-launch frontmatter use the `{ command, args,
+ * env }` shape verbatim.
+ */
+export interface AdapterRenderContextStdio extends AdapterRenderContextBase {
+    readonly mode: 'stdio';
+    readonly launchCommand: {
+        readonly command: string;
+        readonly args?: readonly string[];
+        readonly env?: Readonly<Record<string, string>>;
+    };
+}
+/**
+ * Discriminated union over `mode` — encodes the "exactly one of
+ * packageName | httpEndpoint | launchCommand" invariant at compile time.
+ *
+ * Adapters narrow on `ctx.mode` via `switch` (with an exhaustive default).
+ * Constructing two arms simultaneously is rejected by TypeScript's
+ * excess-property checker on object literals; the renderer's invocation-adapter
+ * dispatch enforces the same invariant at runtime for non-literal callers.
+ */
+export type AdapterRenderContext = AdapterRenderContextBundle | AdapterRenderContextHttp | AdapterRenderContextStdio;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/writer.d.ts

@@ -0,0 +1,17 @@
+import type { RenderedSkill, SkillWriteOptions, SkillWriteResult } from './types.js';
+/**
+ * Write rendered skill file sets to disk (SKILL.md + references/).
+ *
+ * @category I/O
+ * @useWhen
+ * - You have RenderedSkill objects from renderSkills() and need to persist them to the filesystem
+ * - Building a custom pipeline that separates rendering from writing (e.g., for preview or dry-run)
+ */
+export declare function writeSkills(skills: RenderedSkill[], options: SkillWriteOptions): SkillWriteResult[];
+export declare function readInstalledSkillMetadata(skillDir: string): {
+    bundledGuidance?: boolean;
+    curated?: boolean;
+    version?: string;
+    name?: string;
+} | null;
+//# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,aAAa,EACb,iBAAiB,EAEjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,EAAE,CAqCpB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE1F"}