@skillit/core 1.5.0

package/dist/refine/loop.js

@@ -0,0 +1,98 @@
+// packages/core/src/refine/loop.ts
+import { auditSkill } from '../audit.js';
+import { estimateSkillJudgeScore } from '../audit-score.js';
+import { selectWorkItems } from './select-targets.js';
+const DEFAULT_PASSING_GRADES = ['A'];
+const DEFAULT_MAX_ITERATIONS = 5;
+const DEFAULT_ITEMS_PER_ITERATION = 5;
+function defaultScore(source) {
+    return (skill) => {
+        const audit = auditSkill(skill, source.auditContext(skill));
+        return estimateSkillJudgeScore(audit, skill);
+    };
+}
+export async function refineSkill(opts) {
+    const { source, model, passingGrades = DEFAULT_PASSING_GRADES, maxIterations = DEFAULT_MAX_ITERATIONS, itemsPerIteration = DEFAULT_ITEMS_PER_ITERATION, onIteration, scoreSkill = defaultScore(source) } = opts;
+    const passingSet = new Set(passingGrades);
+    const iterations = [];
+    let skill = await source.extract();
+    const guidance = await source.guidance?.();
+    let estimate = scoreSkill(skill);
+    if (passingSet.has(estimate.grade)) {
+        return finished('passed', skill, estimate, iterations, guidance);
+    }
+    let prevTotal = estimate.total;
+    for (let i = 0; i < maxIterations; i++) {
+        // Plateau: if this isn't the last allowed iteration and score hasn't improved, stop early.
+        if (i > 0 && i < maxIterations - 1 && estimate.total <= prevTotal) {
+            return finished('plateau', skill, estimate, iterations, guidance);
+        }
+        const workItems = selectWorkItems(estimate.improvements, itemsPerIteration);
+        if (workItems.length === 0) {
+            return finished('no-improvements', skill, estimate, iterations, guidance);
+        }
+        const fixes = [];
+        for (const item of workItems) {
+            const fn = skill.functions.find((f) => f.name === item.toolName);
+            let currentValue;
+            if (fn) {
+                const tag = item.tag;
+                if (tag === 'useWhen' || tag === 'avoidWhen' || tag === 'pitfalls') {
+                    currentValue = fn.mcpMetadata?.toSkills?.[tag]?.[0];
+                }
+                else {
+                    currentValue = fn.tags[tag];
+                }
+            }
+            let draft = await model.draft({
+                toolName: item.toolName,
+                tag: item.tag,
+                suggestion: item.improvement.suggestion,
+                currentValue,
+                skill,
+                guidance
+            });
+            const review = await model.review({
+                toolName: item.toolName,
+                tag: item.tag,
+                draft,
+                suggestion: item.improvement.suggestion,
+                skill,
+                guidance
+            });
+            if (review.verdict === 'revise') {
+                draft = await model.draft({
+                    toolName: item.toolName,
+                    tag: item.tag,
+                    suggestion: review.feedback,
+                    currentValue: draft,
+                    skill,
+                    guidance
+                });
+            }
+            fixes.push({ toolName: item.toolName, tag: item.tag, value: draft });
+        }
+        await source.applyFixes(fixes);
+        prevTotal = estimate.total;
+        skill = await source.extract();
+        estimate = scoreSkill(skill);
+        const iteration = { iteration: i + 1, estimate, workItems, fixes };
+        iterations.push(iteration);
+        onIteration?.(iteration);
+        if (passingSet.has(estimate.grade)) {
+            return finished('passed', skill, estimate, iterations, guidance);
+        }
+    }
+    return finished('max-iterations', skill, estimate, iterations, guidance);
+}
+function finished(stoppedReason, finalSkill, finalEstimate, iterations, guidance) {
+    return {
+        iterations,
+        finalSkill,
+        finalEstimate,
+        passed: stoppedReason === 'passed',
+        stoppedReason,
+        guidance
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/refine/loop.js.map

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

package/dist/refine/select-targets.d.ts

@@ -0,0 +1,5 @@
+import type { ActionableImprovement } from '../index.js';
+import type { RefineTag, RefineWorkItem } from './types.js';
+export declare function parseTag(suggestion: string): RefineTag | undefined;
+export declare function selectWorkItems(improvements: readonly ActionableImprovement[], limit: number): RefineWorkItem[];
+//# sourceMappingURL=select-targets.d.ts.map

package/dist/refine/select-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-targets.d.ts","sourceRoot":"","sources":["../../src/refine/select-targets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5D,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAYlE;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,SAAS,qBAAqB,EAAE,EAC9C,KAAK,EAAE,MAAM,GACZ,cAAc,EAAE,CAYlB"}

package/dist/refine/select-targets.js

@@ -0,0 +1,30 @@
+const TAG_RE = /@(\w+)/;
+export function parseTag(suggestion) {
+    const match = suggestion.match(TAG_RE);
+    if (!match)
+        return undefined;
+    const tag = match[1];
+    const valid = new Set([
+        'useWhen',
+        'avoidWhen',
+        'pitfalls',
+        'remarks',
+        'example'
+    ]);
+    return valid.has(tag) ? tag : undefined;
+}
+export function selectWorkItems(improvements, limit) {
+    const items = [];
+    for (const imp of improvements) {
+        const tag = parseTag(imp.suggestion);
+        if (!tag)
+            continue;
+        const targets = imp.targets ?? [];
+        for (const target of targets) {
+            items.push({ toolName: target.name, tag, improvement: imp });
+        }
+    }
+    items.sort((a, b) => b.improvement.points - a.improvement.points);
+    return items.slice(0, limit);
+}
+//# sourceMappingURL=select-targets.js.map

package/dist/refine/select-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-targets.js","sourceRoot":"","sources":["../../src/refine/select-targets.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,UAAkB;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAc,CAAC;IAClC,MAAM,KAAK,GAA2B,IAAI,GAAG,CAAC;QAC5C,SAAS;QACT,WAAW;QACX,UAAU;QACV,SAAS;QACT,SAAS;KACV,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,YAA8C,EAC9C,KAAa;IAEb,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/refine/types.d.ts

@@ -0,0 +1,67 @@
+import type { ExtractedSkill, SkillJudgeEstimate, ActionableImprovement, AuditContext } from '../index.js';
+export type RefineTag = 'useWhen' | 'avoidWhen' | 'pitfalls' | 'remarks' | 'example';
+export interface DraftRequest {
+    toolName: string;
+    tag: RefineTag;
+    suggestion: string;
+    currentValue: string | undefined;
+    skill: ExtractedSkill;
+    guidance?: string;
+}
+export interface ReviewRequest {
+    toolName: string;
+    tag: RefineTag;
+    draft: string;
+    suggestion: string;
+    skill: ExtractedSkill;
+    guidance?: string;
+}
+export type ReviewVerdict = 'accepted' | 'revise';
+export interface ReviewResult {
+    verdict: ReviewVerdict;
+    feedback: string;
+}
+export interface DraftedFix {
+    toolName: string;
+    tag: RefineTag;
+    value: string;
+}
+export interface ModelClient {
+    draft(req: DraftRequest): Promise<string>;
+    review(req: ReviewRequest): Promise<ReviewResult>;
+}
+export interface RefineSource {
+    extract(): Promise<ExtractedSkill>;
+    auditContext(skill: ExtractedSkill): AuditContext;
+    applyFixes(fixes: readonly DraftedFix[]): Promise<void>;
+    guidance?(): string | Promise<string>;
+}
+export interface RefineWorkItem {
+    toolName: string;
+    tag: RefineTag;
+    improvement: ActionableImprovement;
+}
+export type RefineStopReason = 'passed' | 'max-iterations' | 'no-improvements' | 'plateau';
+export interface RefineIteration {
+    iteration: number;
+    estimate: SkillJudgeEstimate;
+    workItems: readonly RefineWorkItem[];
+    fixes: readonly DraftedFix[];
+}
+export interface RefineOptions {
+    source: RefineSource;
+    model: ModelClient;
+    passingGrades?: ReadonlyArray<SkillJudgeEstimate['grade']>;
+    maxIterations?: number;
+    itemsPerIteration?: number;
+    onIteration?: (iteration: RefineIteration) => void;
+}
+export interface RefineResult {
+    iterations: readonly RefineIteration[];
+    finalSkill: ExtractedSkill;
+    finalEstimate: SkillJudgeEstimate;
+    passed: boolean;
+    stoppedReason: RefineStopReason;
+    guidance: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/refine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/refine/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAAC;IAClD,UAAU,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,qBAAqB,CAAC;CACpC;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,UAAU,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,gBAAgB,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B"}

package/dist/refine/types.js

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

package/dist/refine/types.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,27 @@
+import type { ExtractedSkill, RenderedSkill, SkillRenderOptions } from './types.js';
+/**
+ * Render multiple extracted skills into progressive disclosure file sets.
+ *
+ * @category Rendering
+ * @useWhen
+ * - You have one or more ExtractedSkill objects and need SKILL.md + references/ output
+ * - Building a custom extraction pipeline that bypasses the TypeDoc plugin
+ * @never
+ * - NEVER set maxTokens below 500 — reference files become truncated mid-signature, producing broken code blocks that confuse LLMs
+ * - NEVER pass skills with empty `name` — the output directory becomes a bare `/` path
+ */
+export declare function renderSkills(skills: ExtractedSkill[], options?: Partial<Omit<SkillRenderOptions, 'invocation'>>): RenderedSkill[];
+/**
+ * Render a single skill into SKILL.md + references/.
+ *
+ * @category Rendering
+ * @useWhen
+ * - You need fine-grained control over rendering a single skill
+ * @never
+ * - NEVER set maxTokens below 500 — reference files become truncated mid-signature, producing broken code blocks
+ */
+export declare function renderSkill(skill: ExtractedSkill, options?: Partial<SkillRenderOptions>): RenderedSkill;
+export declare function renderSkill(skill: ExtractedSkill, options: Partial<SkillRenderOptions> & {
+    invocation: NonNullable<SkillRenderOptions['invocation']>;
+}): Promise<RenderedSkill>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,cAAc,EASd,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA+BpB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC,GACxD,aAAa,EAAE,CAWjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,aAAa,CAAC;AACjB,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG;IACrC,UAAU,EAAE,WAAW,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;CAC3D,GACA,OAAO,CAAC,aAAa,CAAC,CAAC"}