@skillit/core 1.5.0 → 2.1.0

package/dist/refine/config-source.js

@@ -0,0 +1,283 @@
+// packages/core/src/refine/config-source.ts
+import { existsSync } from 'node:fs';
+import { glob, readFile, writeFile } from 'node:fs/promises';
+import { basename, dirname, join, resolve } from 'node:path';
+import { extractConfigSurface } from '../config-extract.js';
+import { truncateToTokenBudget } from '../tokens.js';
+import { stripRefineTags, upsertPropertyJsDocTag } from './ast-edit.js';
+import { readPackageMetadata } from './package-metadata.js';
+/** Token cap for the implementation-reference grounding fed to the model. */
+const GROUNDING_TOKEN_CAP = 8000;
+const EXCLUDED_GROUNDING_DIRS = new Set(['node_modules', 'dist', 'build', '.git', 'coverage']);
+/** Maximum directories to walk upward from the config file seeking package.json. */
+const MAX_PACKAGE_LOOKUP_DEPTH = 8;
+/**
+ * {@link RefineSource} for a TypeScript configuration surface.
+ *
+ * Reads the consumer's config type with {@link extractConfigSurface}, exposes it
+ * as a single `config` surface in an {@link ExtractedSkill}, and writes routing
+ * tags back as JSDoc onto the type's individual property declarations. Unlike
+ * the CLI source — whose routing lives at the command (surface) level — a config
+ * surface is documented per-OPTION: each fix targets one property by its
+ * dot-path `configKey` (e.g. `outDir`, `components.prefix`), routed through
+ * {@link upsertPropertyJsDocTag}.
+ *
+ * It also enriches the skill from the package.json nearest the config file (its
+ * description, keywords, repository) and a sibling README, supplying the audit
+ * context the metadata checks (F1/F2/F3/E5/W4/W5/W6) score against — without it
+ * a config skill forfeits those points even when the package already carries
+ * the data.
+ */
+export class ConfigRefineSource {
+    opts;
+    /** Cached metadata, populated by {@link extract} (which the loop runs first). */
+    metadata = {};
+    /** Cached surface, populated by {@link extract}; read by {@link guidance}. */
+    surface;
+    /** Cached implementation-reference grounding, populated by {@link extract}. */
+    grounding = '';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async extract() {
+        const source = await readFile(this.opts.configFile, 'utf8');
+        const surface = extractConfigSurface(source, this.opts.typeName);
+        if (!surface) {
+            throw new Error(`[skillit] config type '${this.opts.typeName}' not found in ${this.opts.configFile}`);
+        }
+        this.surface = surface;
+        this.grounding = await this.loadGrounding();
+        const meta = await this.loadMetadata();
+        // The render headline (`skill.description`) prefers a caller-supplied
+        // config-specific description so the skill body describes the config surface
+        // rather than the package. `skill.packageDescription` (set below) is kept as
+        // the LITERAL package.json description so the audit's F1 check validates the
+        // real published metadata — a config override must not mask a missing or
+        // too-short package.json description.
+        const description = this.opts.description ?? meta.packageDescription ?? '';
+        const skill = {
+            name: this.opts.name ?? meta.packageName ?? this.opts.typeName,
+            description,
+            functions: [],
+            classes: [],
+            types: [],
+            enums: [],
+            variables: [],
+            examples: [],
+            configSurfaces: [surface]
+        };
+        if (meta.keywords?.length)
+            skill.keywords = meta.keywords;
+        if (meta.repository)
+            skill.repository = meta.repository;
+        if (meta.packageDescription)
+            skill.packageDescription = meta.packageDescription;
+        if (meta.readme !== undefined)
+            skill.readme = meta.readme;
+        // A sibling `<config>.example.ts` (if present) is the skill's usage example
+        // — clears E4 and feeds the rendered Examples section. The refine loop
+        // drafts it once when absent; reading it back here surfaces it thereafter.
+        // Read directly and tolerate ENOENT (no existsSync precheck — that is a
+        // check-then-use race).
+        try {
+            const example = (await readFile(this.exampleFilePath(), 'utf8')).trim();
+            if (example)
+                skill.examples = [example];
+        }
+        catch {
+            // No/unreadable example — leave examples empty (E4 stays a gap).
+        }
+        return skill;
+    }
+    /**
+     * Map an improvement target to its on-disk location. Config targets carry the
+     * option's dot-path `configKey` as `name` (kind `config-option`); the config
+     * type holds them, so the file is always the config file and the declName is
+     * the type. A `config-example` target points at the same file with no path.
+     */
+    resolveTargetLocation(target) {
+        if (target.kind === 'config-example') {
+            return { file: this.opts.configFile, declName: this.opts.typeName };
+        }
+        return {
+            file: this.opts.configFile,
+            declName: this.opts.typeName,
+            propertyPath: target.name
+        };
+    }
+    async applyFixes(fixes) {
+        // An `@example` fix is the drafted config-example FILE, not a JSDoc tag:
+        // write it to the sibling `<config>.example.ts` — but only if one does not
+        // already exist, so a hand-authored example is never clobbered.
+        const exampleFix = fixes.find((fix) => fix.tag === 'example');
+        if (exampleFix) {
+            // Write-if-absent atomically with the `wx` flag (create, fail if exists)
+            // rather than existsSync-then-write — the latter is a TOCTOU race, and the
+            // atomic flag enforces the no-clobber intent at the syscall.
+            try {
+                await writeFile(this.exampleFilePath(), normalizeExampleFile(exampleFix.value), {
+                    encoding: 'utf8',
+                    flag: 'wx'
+                });
+            }
+            catch (error) {
+                // EEXIST = an example already exists; preserve it. Re-throw anything else.
+                if (error.code !== 'EEXIST')
+                    throw error;
+            }
+        }
+        let source = await readFile(this.opts.configFile, 'utf8');
+        let changed = false;
+        for (const fix of fixes) {
+            if (fix.tag === 'example')
+                continue; // handled above (separate file)
+            // `fix.toolName` is the option's dot-path configKey (set by the
+            // audit-score config-option target). Route it to the matching property.
+            const next = upsertPropertyJsDocTag(source, this.opts.typeName, fix.toolName, fix.tag, fix.value);
+            if (next !== source) {
+                source = next;
+                changed = true;
+            }
+        }
+        if (changed) {
+            await writeFile(this.opts.configFile, source, 'utf8');
+        }
+    }
+    /**
+     * Drafting conventions passed to the model each iteration. Scopes every
+     * routing tag to the single named option, constrains claims to what the type
+     * and provided context can support (the model sees the type, NOT the code that
+     * consumes the config, so unconstrained drafting invents wrong runtime
+     * semantics), and tells it how to draft the `@example` config file. Built from
+     * the cached surface that {@link extract} populates first.
+     */
+    guidance() {
+        const optionList = (this.surface?.options ?? [])
+            .map((o) => `- \`${o.configKey ?? o.name}\`: ${o.type}`)
+            .join('\n');
+        const typeName = this.opts.typeName;
+        return [
+            `You are documenting the individual options of the TypeScript configuration object \`${typeName}\`.`,
+            `Each work item's "Tool" is ONE option, named by its dot-path key (e.g. \`outDir\`, \`components.prefix\`) — except an @example work item, whose "Tool" is the config type \`${typeName}\` itself.`,
+            `For @useWhen / @avoidWhen / @pitfalls: write guidance SPECIFIC to that single option — when to set it (and to what kind of value), when to leave it unset, and footguns unique to its value or interactions. Do NOT describe the configuration type as a whole, the annotate-vs-\`defineConfig()\` choice, or anything that applies to every option; never repeat the same point across options.`,
+            this.grounding
+                ? `GROUND every runtime-behavior claim in the IMPLEMENTATION REFERENCE below (the actual code that consumes this config) and the option's type. State behavior the code actually exhibits — e.g. what an empty array/object means, whether an invalid value throws or is silently ignored, what a flag toggles, how options interact. Do NOT contradict the reference, and do NOT assert behavior absent from both the reference and the type; omit it instead. A confidently wrong "NEVER" is worse than no pitfall.`
+                : `GROUND every claim in the option's TYPE and the documentation provided to you. You can see the type, not the code that reads this config — so do NOT assert runtime behavior you cannot verify: whether an empty array/object means "all" or "none", whether an invalid value throws or is silently ignored, what a boolean flag actually toggles, or how two options interact at runtime. If a behavior is not evidenced by the type or the docs, omit it or phrase it as a type-level fact ("\`mode\` accepts 'submit' | 'auto-save'"). A confidently wrong "NEVER" is worse than no pitfall — prefer fewer, verifiable points over speculative ones.`,
+            `For @example: output a COMPLETE, type-correct example configuration FILE — import statements plus a default export — saved verbatim as a sibling \`*.config.example.ts\` that must compile. Import \`defineConfig\`/\`${typeName}\` from the package by its published name ONLY if the example lives outside that package; if it sits inside the package's own \`src\`, import from the local source entrypoint (a relative path) so the self-import does not resolve to an unbuilt \`dist\`. Use realistic values for required options and a few common optional ones. Output ONLY the file source: no prose, no markdown, no code fences.`,
+            `Options (key: type):\n${optionList}`,
+            ...(this.grounding
+                ? [
+                    `IMPLEMENTATION REFERENCE (the code that consumes this config — ground runtime-behavior claims in it):\n${this.grounding}`
+                ]
+                : [])
+        ].join('\n\n');
+    }
+    /**
+     * Discover and parse the package.json nearest the config file (walking up to
+     * {@link MAX_PACKAGE_LOOKUP_DEPTH} directories) plus a sibling README. Cached
+     * so repeated extract/score passes read the filesystem once. Never throws —
+     * unreadable or absent files just yield empty fields.
+     */
+    async loadMetadata() {
+        const pkgDir = this.findPackageDir();
+        if (!pkgDir)
+            return this.metadata;
+        const meta = await readPackageMetadata(pkgDir);
+        this.metadata = {
+            ...(meta.packageDescription !== undefined
+                ? { packageDescription: meta.packageDescription }
+                : {}),
+            ...(meta.keywords !== undefined ? { keywords: meta.keywords } : {}),
+            ...(meta.repository !== undefined ? { repository: meta.repository } : {}),
+            ...(meta.readme !== undefined ? { readme: meta.readme } : {})
+        };
+        return meta;
+    }
+    /**
+     * Sibling example path for the config file: same directory, the config file's
+     * base name with any `.ts`/`.tsx`/`.mts`/`.cts` extension replaced by
+     * `.example.ts` (e.g. `z2f.config.ts` → `z2f.config.example.ts`,
+     * `config.ts` → `config.example.ts`).
+     */
+    exampleFilePath() {
+        const dir = dirname(this.opts.configFile);
+        const base = basename(this.opts.configFile).replace(/\.[cm]?tsx?$/, '');
+        return join(dir, `${base}.example.ts`);
+    }
+    /**
+     * Read the grounding globs into a single token-capped implementation
+     * reference. Prepends the config module's own declarations (refine tags
+     * stripped — see {@link stripRefineTags}) so preset tables/defaults/validation
+     * ground the model, then appends the matched glob files (skipping `.d.ts`,
+     * excluded dirs, and the already-included config file). Returns `''` when no
+     * globs are configured or nothing matches — never throws.
+     */
+    async loadGrounding() {
+        const globs = this.opts.groundingGlobs;
+        if (!globs?.length)
+            return '';
+        const configAbs = resolve(this.opts.configFile);
+        const seen = new Set([configAbs]);
+        const parts = [];
+        // The config module itself often holds non-type declarations the model
+        // needs to be accurate — preset tables, defaults, `defineConfig`/validation
+        // (e.g. z2f's `SHADCN_OVERRIDES`). Include it, but strip ONLY the routing
+        // tags this source writes back across iterations (so our own accumulated
+        // annotations aren't fed back as "implementation"); hand-authored prose —
+        // the real runtime-behavior grounding — is preserved.
+        const configSource = await readFile(this.opts.configFile, 'utf8').catch(() => '');
+        const configDecls = stripRefineTags(configSource).trim();
+        if (configDecls)
+            parts.push(`// ${this.opts.configFile} (config module declarations)\n${configDecls}`);
+        for (const pattern of globs) {
+            let matches;
+            try {
+                matches = glob(pattern, {
+                    exclude: (f) => f.endsWith('.d.ts') || f.split(/[\\/]/).some((seg) => EXCLUDED_GROUNDING_DIRS.has(seg))
+                });
+            }
+            catch {
+                continue; // bad pattern — skip
+            }
+            for await (const file of matches) {
+                const abs = resolve(file);
+                if (seen.has(abs))
+                    continue; // config file is pre-seeded above
+                seen.add(abs);
+                const content = await readFile(file, 'utf8').catch(() => '');
+                if (content.trim())
+                    parts.push(`// ${file}\n${content.trim()}`);
+            }
+        }
+        if (parts.length === 0)
+            return '';
+        return truncateToTokenBudget(parts.join('\n\n'), GROUNDING_TOKEN_CAP);
+    }
+    /** Nearest ancestor directory of the config file that holds a package.json. */
+    findPackageDir() {
+        let dir = dirname(this.opts.configFile);
+        for (let i = 0; i < MAX_PACKAGE_LOOKUP_DEPTH; i++) {
+            if (existsSync(join(dir, 'package.json')))
+                return dir;
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+        return undefined;
+    }
+}
+/**
+ * Normalize model-drafted example content into a clean source file: strip a
+ * surrounding markdown code fence if the model added one, and ensure a trailing
+ * newline. The draft is instructed to omit fences, but a chatty backend may add
+ * them anyway.
+ */
+function normalizeExampleFile(raw) {
+    let body = raw.trim();
+    const fenced = body.match(/^```[a-zA-Z]*\n([\s\S]*?)\n```$/);
+    if (fenced?.[1] !== undefined)
+        body = fenced[1].trim();
+    return `${body}\n`;
+}
+//# sourceMappingURL=config-source.js.map

package/dist/refine/config-source.js.map

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

package/dist/refine/dep-skills.d.ts

@@ -0,0 +1,4 @@
+import type { DepSkillRef } from '../types.js';
+export declare function discoverDepSkillsSync(pkgDir: string): DepSkillRef[];
+export declare function discoverDepSkills(pkgDir: string): Promise<DepSkillRef[]>;
+//# sourceMappingURL=dep-skills.d.ts.map

package/dist/refine/dep-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-skills.d.ts","sourceRoot":"","sources":["../../src/refine/dep-skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6E/C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAWnE;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAE9E"}

package/dist/refine/dep-skills.js

@@ -0,0 +1,98 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+function extractFrontmatterField(content, field) {
+    const match = content.match(new RegExp(`^${field}:\\s*(.+?)\\s*$`, 'm'));
+    if (!match?.[1])
+        return undefined;
+    return match[1].replace(/^["']|["']$/g, '');
+}
+function parseSkillMd(skillMdPath) {
+    let content;
+    try {
+        content = readFileSync(skillMdPath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    const name = extractFrontmatterField(content, 'name');
+    if (!name)
+        return undefined;
+    const description = extractFrontmatterField(content, 'description');
+    return { name, ...(description ? { description } : {}) };
+}
+function discoverForDep(pkgDir, depName) {
+    const depDir = join(pkgDir, 'node_modules', depName);
+    if (!existsSync(depDir))
+        return [];
+    const depPkgPath = join(depDir, 'package.json');
+    if (!existsSync(depPkgPath))
+        return [];
+    let depPkg = {};
+    try {
+        depPkg = JSON.parse(readFileSync(depPkgPath, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    const skillDirs = [];
+    const explicitSkills = depPkg.skillit?.skills;
+    if (Array.isArray(explicitSkills) && explicitSkills.length > 0) {
+        for (const relPath of explicitSkills) {
+            if (typeof relPath === 'string') {
+                const dir = join(depDir, relPath);
+                if (existsSync(join(dir, 'SKILL.md')))
+                    skillDirs.push(dir);
+            }
+        }
+    }
+    else {
+        const skillsRoot = join(depDir, 'skills');
+        if (existsSync(skillsRoot)) {
+            let entries;
+            try {
+                entries = readdirSync(skillsRoot, { withFileTypes: true, encoding: 'utf8' });
+            }
+            catch {
+                return [];
+            }
+            for (const dirent of entries) {
+                if (!dirent.isDirectory())
+                    continue;
+                const skillDir = join(skillsRoot, dirent.name);
+                if (existsSync(join(skillDir, 'SKILL.md')))
+                    skillDirs.push(skillDir);
+            }
+        }
+    }
+    const refs = [];
+    for (const skillDir of skillDirs) {
+        const parsed = parseSkillMd(join(skillDir, 'SKILL.md'));
+        if (!parsed)
+            continue;
+        const relativePath = skillDir.slice(pkgDir.length + 1);
+        refs.push({
+            name: parsed.name,
+            path: relativePath,
+            ...(parsed.description ? { description: parsed.description } : {})
+        });
+    }
+    return refs;
+}
+export function discoverDepSkillsSync(pkgDir) {
+    let pkg = {};
+    try {
+        pkg = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    const depNames = Object.keys(pkg.dependencies ?? {});
+    const refs = [];
+    for (const depName of depNames)
+        refs.push(...discoverForDep(pkgDir, depName));
+    return refs;
+}
+export async function discoverDepSkills(pkgDir) {
+    return discoverDepSkillsSync(pkgDir);
+}
+//# sourceMappingURL=dep-skills.js.map

package/dist/refine/dep-skills.js.map

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

package/dist/refine/index.d.ts

@@ -3,5 +3,10 @@ export * from './select-targets.js';
 export { refineSkill } from './loop.js';
 export type { ScoreSkill } from './loop.js';
 export { insertJsDocTag } from './jsdoc-edit.js';
-export { upsertJsDocTag, readJsDocTags } from './ast-edit.js';
+export { upsertJsDocTag, upsertPropertyJsDocTag, readJsDocTags } from './ast-edit.js';
+export { ConfigRefineSource } from './config-source.js';
+export type { ConfigRefineSourceOptions } from './config-source.js';
+export { stripScope, findNearestPackageDir, readPackageMetadata } from './package-metadata.js';
+export type { PackageMetadata } from './package-metadata.js';
+export { discoverDepSkills, discoverDepSkillsSync } from './dep-skills.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/refine/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/refine/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/refine/index.js

@@ -2,5 +2,8 @@ export * from './types.js';
 export * from './select-targets.js';
 export { refineSkill } from './loop.js';
 export { insertJsDocTag } from './jsdoc-edit.js';
-export { upsertJsDocTag, readJsDocTags } from './ast-edit.js';
+export { upsertJsDocTag, upsertPropertyJsDocTag, readJsDocTags } from './ast-edit.js';
+export { ConfigRefineSource } from './config-source.js';
+export { stripScope, findNearestPackageDir, readPackageMetadata } from './package-metadata.js';
+export { discoverDepSkills, discoverDepSkillsSync } from './dep-skills.js';
 //# sourceMappingURL=index.js.map

package/dist/refine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/refine/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/refine/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/refine/jsdoc-edit.d.ts

@@ -1,4 +1,11 @@
 import type { RefineTag } from './types.js';
-/** @deprecated internal alias — use upsertJsDocTag. Kept for callers/tests. */
+/**
+ * @deprecated internal alias — use {@link upsertJsDocTag}. Kept for callers/tests.
+ *
+ * @remarks
+ * A thin pass-through to {@link upsertJsDocTag} with identical parameters and
+ * behaviour; retained only so existing callers and tests that import the old
+ * name keep compiling. New code should call {@link upsertJsDocTag} directly.
+ */
 export declare function insertJsDocTag(source: string, exportName: string, tag: RefineTag, content: string): string;
 //# sourceMappingURL=jsdoc-edit.d.ts.map

package/dist/refine/jsdoc-edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsdoc-edit.d.ts","sourceRoot":"","sources":["../../src/refine/jsdoc-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}
+{"version":3,"file":"jsdoc-edit.d.ts","sourceRoot":"","sources":["../../src/refine/jsdoc-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}

package/dist/refine/jsdoc-edit.js

@@ -1,5 +1,12 @@
 import { upsertJsDocTag } from './ast-edit.js';
-/** @deprecated internal alias — use upsertJsDocTag. Kept for callers/tests. */
+/**
+ * @deprecated internal alias — use {@link upsertJsDocTag}. Kept for callers/tests.
+ *
+ * @remarks
+ * A thin pass-through to {@link upsertJsDocTag} with identical parameters and
+ * behaviour; retained only so existing callers and tests that import the old
+ * name keep compiling. New code should call {@link upsertJsDocTag} directly.
+ */
 export function insertJsDocTag(source, exportName, tag, content) {
     return upsertJsDocTag(source, exportName, tag, content);
 }

package/dist/refine/jsdoc-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsdoc-edit.js","sourceRoot":"","sources":["../../src/refine/jsdoc-edit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,UAAkB,EAClB,GAAc,EACd,OAAe;IAEf,OAAO,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"jsdoc-edit.js","sourceRoot":"","sources":["../../src/refine/jsdoc-edit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,UAAkB,EAClB,GAAc,EACd,OAAe;IAEf,OAAO,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/refine/loop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,kBAAkB,CAAC;AAavE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAChD,OAAO,CAAC,YAAY,CAAC,CA0FvB"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/refine/loop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,kBAAkB,CAAC;AAwBvE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAChD,OAAO,CAAC,YAAY,CAAC,CAuGvB"}

package/dist/refine/loop.js

@@ -5,14 +5,24 @@ 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) {
+function defaultScore() {
     return (skill) => {
-        const audit = auditSkill(skill, source.auditContext(skill));
+        const audit = auditSkill(skill);
         return estimateSkillJudgeScore(audit, skill);
     };
 }
+/**
+ * Total work items currently available across all improvements (uncapped), used
+ * as the loop's "backlog" signal. Reuses {@link selectWorkItems} so it counts
+ * exactly what would become work — i.e. improvements with a parseable tag and
+ * targets. Shrinks as config options get tagged; stays flat when the model is
+ * stuck re-drafting the same still-failing targets.
+ */
+function countAvailableWork(improvements) {
+    return selectWorkItems(improvements, Number.POSITIVE_INFINITY).length;
+}
 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 { source, model, passingGrades = DEFAULT_PASSING_GRADES, maxIterations = DEFAULT_MAX_ITERATIONS, itemsPerIteration = DEFAULT_ITEMS_PER_ITERATION, onIteration, scoreSkill = defaultScore() } = opts;
     const passingSet = new Set(passingGrades);
     const iterations = [];
     let skill = await source.extract();
@@ -22,9 +32,19 @@ export async function refineSkill(opts) {
         return finished('passed', skill, estimate, iterations, guidance);
     }
     let prevTotal = estimate.total;
+    let prevAvailable = countAvailableWork(estimate.improvements);
     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) {
+        const available = countAvailableWork(estimate.improvements);
+        // Plateau: stop early when the score has stalled — but NOT while we're still
+        // burning down a backlog of work. Per-option config coverage targets become
+        // score-neutral once the routing thresholds (W7/W8/W9) pass, yet each
+        // iteration still documents more options; a pure score check would halt that
+        // mid-surface. Only plateau when the score is flat AND the available-work
+        // pool is not shrinking (the genuinely-stuck case the check exists to catch).
+        if (i > 0 &&
+            i < maxIterations - 1 &&
+            estimate.total <= prevTotal &&
+            available >= prevAvailable) {
             return finished('plateau', skill, estimate, iterations, guidance);
         }
         const workItems = selectWorkItems(estimate.improvements, itemsPerIteration);
@@ -74,6 +94,7 @@ export async function refineSkill(opts) {
         }
         await source.applyFixes(fixes);
         prevTotal = estimate.total;
+        prevAvailable = available;
         skill = await source.extract();
         estimate = scoreSkill(skill);
         const iteration = { iteration: i + 1, estimate, workItems, fixes };

package/dist/refine/loop.js.map

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

package/dist/refine/package-metadata.d.ts

@@ -0,0 +1,34 @@
+import type { ParsedReadme } from '../audit-types.js';
+/** Package metadata read from a package dir (package.json fields + parsed README). */
+export interface PackageMetadata {
+    /** Scope-stripped package name. */
+    packageName?: string;
+    /** Full (scoped) package name as written in package.json, e.g. `@scope/pkg`. */
+    fullPackageName?: string;
+    packageDescription?: string;
+    keywords?: string[];
+    repository?: string;
+    readme?: ParsedReadme;
+    /** `bin` field from package.json — maps command names to entry-point paths. */
+    bin?: Record<string, string>;
+    /** `private` field from package.json — true means the package is not published. */
+    isPrivate?: boolean;
+}
+/** Strip a leading `@scope/` from a package name. */
+export declare function stripScope(name: string): string;
+/**
+ * Walk up from `startDir` (inclusive) up to `maxDepth` parents looking for a
+ * directory containing a `package.json`. Returns the dir, or undefined.
+ *
+ * @param startDir - Directory to start the upward search from (searched first).
+ * @param maxDepth - Maximum number of parent directories to ascend (default 5).
+ * @returns The nearest directory containing a `package.json`, or `undefined`
+ *   when none is found within `maxDepth` levels (or the filesystem root is hit).
+ */
+export declare function findNearestPackageDir(startDir: string, maxDepth?: number): Promise<string | undefined>;
+/**
+ * Read package.json fields + `parseReadme(README.md)` from `pkgDir`. Never
+ * throws — unreadable/absent files yield unset fields.
+ */
+export declare function readPackageMetadata(pkgDir: string): Promise<PackageMetadata>;
+//# sourceMappingURL=package-metadata.d.ts.map

package/dist/refine/package-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-metadata.d.ts","sourceRoot":"","sources":["../../src/refine/package-metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAoB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAa7B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAsClF"}