@ai-outfitter/outfitter 0.11.0 → 1.0.2

package/dist/skills/ProfileSkillResolution.js

@@ -1,88 +0,0 @@
-// Resolves a profile's selected skill IDs into generated skill sources before adapter launch.
-import { join } from 'node:path';
-import { inferProfileIncludeSourceRoot } from '../profiles/PromptIncludes.js';
-import { skillControlEntryIdentity } from '../agents/LaunchResources.js';
-import { discoverSkillCatalog } from './SkillCatalog.js';
-import { resolveSkillEntries, } from './SkillResolution.js';
-/**
- * Resolves catalog skill IDs in `controls.skills` (generic and adapter-scoped) to
- * generated skill directories, so adapters keep receiving plain path sources.
- */
-export const resolveProfileSkillControls = (input) => {
-    const catalog = discoverSkillCatalog({
-        projectDirectory: input.projectDirectory,
-        profileLayers: input.profileLayers,
-        sourcePaths: input.sourcePaths,
-    });
-    const diagnostics = [];
-    const outputDirectory = input.outputDirectory === undefined ? undefined : join(input.outputDirectory, 'outfitter', 'skills');
-    // One skill ID materializes once; selecting it from several control scopes reuses
-    // the same generated directory, and conflicting reference sets are an error.
-    const materializationCache = new Map();
-    const resolveEntries = (entries, scope) => {
-        const resolution = resolveSkillEntries({
-            entries: entries.map((entry) => toSkillEntryInput(entry, scope, input.profileLayers)),
-            catalog,
-            projectDirectory: input.projectDirectory,
-            outputDirectory,
-            materializationCache,
-        });
-        diagnostics.push(...resolution.diagnostics);
-        return resolution.sources;
-    };
-    const controls = resolveSkillControls(input.profile.controls, resolveEntries);
-    diagnostics.push(...createShadowedSkillDiagnostics(catalog, input.profile.controls));
-    return { profile: { ...input.profile, controls }, diagnostics };
-};
-const resolveSkillControls = (controls, resolveEntries) => ({
-    ...controls,
-    ...(controls.skills === undefined ? {} : { skills: resolveEntries(controls.skills, 'skills') }),
-    ...(controls.pi?.skills === undefined
-        ? {}
-        : { pi: { ...controls.pi, skills: resolveEntries(controls.pi.skills, 'pi') } }),
-    ...(controls.claude?.skills === undefined
-        ? {}
-        : { claude: { ...controls.claude, skills: resolveEntries(controls.claude.skills, 'claude') } }),
-});
-/**
- * Profile-added `file` references resolve from the repository containing the
- * declaring profile. The lookup stays within the entry's own control scope so an
- * object selection in another scope cannot supply the wrong repository root.
- */
-const toSkillEntryInput = (entry, scope, profileLayers) => {
-    if (typeof entry === 'string') {
-        return { entry };
-    }
-    const identity = skillControlEntryIdentity(entry);
-    const declaringLayer = [...profileLayers]
-        .reverse()
-        .find((layer) => readScopedSkillEntries(layer.profile.controls, scope).some((layerEntry) => typeof layerEntry !== 'string' && skillControlEntryIdentity(layerEntry) === identity));
-    return {
-        entry,
-        profileReferenceRoot: declaringLayer === undefined
-            ? undefined
-            : inferProfileIncludeSourceRoot({
-                sourceRootPath: declaringLayer.sourceRootPath,
-                profilePath: declaringLayer.profilePath,
-            }),
-    };
-};
-const readScopedSkillEntries = (controls, scope) => (scope === 'skills' ? controls.skills : controls[scope]?.skills) ?? [];
-const readLayerSkillEntries = (controls) => [
-    ...(controls.skills ?? []),
-    ...(controls.pi?.skills ?? []),
-    ...(controls.claude?.skills ?? []),
-];
-/** Reports shadowing only for IDs the profile actually selects. */
-const createShadowedSkillDiagnostics = (catalog, controls) => {
-    const selectedIds = new Set(readLayerSkillEntries(controls).map((entry) => (typeof entry === 'string' ? entry : entry.id)));
-    return catalog.shadowed
-        .filter((shadow) => selectedIds.has(shadow.selected.id))
-        .map((shadow) => ({
-        severity: 'warning',
-        path: shadow.shadowedDirectory,
-        message: `Skill ID '${shadow.selected.id}' is supplied by ${shadow.selected.origin} ('${shadow.selected.directory}') ` +
-            `and shadows '${shadow.shadowedDirectory}'.`,
-    }));
-};
-//# sourceMappingURL=ProfileSkillResolution.js.map

package/dist/skills/ProfileSkillResolution.js.map

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

package/dist/skills/SkillCatalog.d.ts

@@ -1,41 +0,0 @@
-export interface SkillCatalogRoot {
-    /** Directory scanned for `<skill-id>/SKILL.md` entries. */
-    readonly skillsDirectory: string;
-    /** Root that skill `file` references resolve from (the repository containing the skill). */
-    readonly referenceRoot: string;
-    /** Human-readable origin for shadowing diagnostics. */
-    readonly origin: string;
-}
-export interface SkillCatalogEntry {
-    readonly id: string;
-    readonly directory: string;
-    readonly skillPath: string;
-    readonly referenceRoot: string;
-    readonly origin: string;
-}
-export interface SkillCatalog {
-    readonly entries: ReadonlyMap<string, SkillCatalogEntry>;
-    readonly shadowed: readonly {
-        readonly selected: SkillCatalogEntry;
-        readonly shadowedDirectory: string;
-    }[];
-}
-export interface SkillCatalogInput {
-    readonly projectDirectory?: string;
-    /** Directory-profile resource roots contributing bundled `skills/` folders. */
-    readonly profileLayers?: readonly {
-        readonly sourceRootPath?: string;
-        readonly resourceRootPath?: string;
-    }[];
-    /** Materialized configured profile-source paths, in configured (precedence) order. */
-    readonly sourcePaths?: readonly string[];
-}
-/**
- * Builds the skill ID catalog following layer precedence: project-local, project,
- * bundled directory-profile skills (highest-precedence layer first), then
- * configured sources (later entries outrank earlier ones, matching profile
- * precedence). The first root supplying an ID wins; later roots are reported as
- * shadowed.
- */
-export declare const discoverSkillCatalog: (input: SkillCatalogInput) => SkillCatalog;
-export declare const createSkillCatalogRoots: (input: SkillCatalogInput) => readonly SkillCatalogRoot[];

package/dist/skills/SkillCatalog.js

@@ -1,119 +0,0 @@
-// Discovers catalog skills across project, directory-profile, and configured-source roots.
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { basename, dirname, join } from 'node:path';
-import { inferProfileIncludeSourceRoot } from '../profiles/PromptIncludes.js';
-import { isValidSkillId } from './SkillDocument.js';
-/**
- * Builds the skill ID catalog following layer precedence: project-local, project,
- * bundled directory-profile skills (highest-precedence layer first), then
- * configured sources (later entries outrank earlier ones, matching profile
- * precedence). The first root supplying an ID wins; later roots are reported as
- * shadowed.
- */
-export const discoverSkillCatalog = (input) => {
-    const entries = new Map();
-    const shadowed = [];
-    for (const root of createSkillCatalogRoots(input)) {
-        for (const entry of readSkillCatalogRootEntries(root)) {
-            const selected = entries.get(entry.id);
-            if (selected === undefined) {
-                entries.set(entry.id, entry);
-            }
-            else if (selected.directory !== entry.directory) {
-                shadowed.push({ selected, shadowedDirectory: entry.directory });
-            }
-        }
-    }
-    return { entries, shadowed };
-};
-export const createSkillCatalogRoots = (input) => {
-    const roots = [];
-    if (input.projectDirectory !== undefined) {
-        roots.push({
-            skillsDirectory: join(input.projectDirectory, '.outfitter', 'local', 'skills'),
-            referenceRoot: input.projectDirectory,
-            origin: 'project-local skills',
-        }, {
-            skillsDirectory: join(input.projectDirectory, '.outfitter', 'skills'),
-            referenceRoot: input.projectDirectory,
-            origin: 'project skills',
-        });
-    }
-    // Profile layers arrive lowest-precedence first (see ProfileMerger); reverse so
-    // the selected profile's bundled skill outranks an inherited base profile's.
-    for (const layer of [...(input.profileLayers ?? [])].reverse()) {
-        if (layer.resourceRootPath === undefined) {
-            continue;
-        }
-        roots.push({
-            skillsDirectory: join(layer.resourceRootPath, 'skills'),
-            referenceRoot: inferProfileIncludeSourceRoot({
-                sourceRootPath: layer.sourceRootPath,
-                profilePath: join(layer.resourceRootPath, 'profile.yml'),
-                /* v8 ignore next -- directory profiles always sit under a source root. */
-            }) ?? layer.resourceRootPath,
-            origin: `profile '${basename(layer.resourceRootPath)}' skills`,
-        });
-    }
-    // Later configured sources outrank earlier ones for profiles; mirror that here.
-    for (const sourcePath of [...(input.sourcePaths ?? [])].reverse()) {
-        const catalogRoot = resolveCatalogRoot(sourcePath);
-        roots.push({
-            skillsDirectory: join(catalogRoot, 'skills'),
-            referenceRoot: basename(catalogRoot) === '.outfitter' ? dirname(catalogRoot) : catalogRoot,
-            origin: `source '${sourcePath}'`,
-        });
-    }
-    return dedupeSkillCatalogRoots(roots);
-};
-/**
- * The catalog root is the directory containing `profiles/`. A source path that
- * points directly at the profiles directory resolves to its parent.
- */
-const resolveCatalogRoot = (sourcePath) => basename(sourcePath) === 'profiles' ? dirname(sourcePath) : sourcePath;
-const dedupeSkillCatalogRoots = (roots) => {
-    const seen = new Set();
-    return roots.filter((root) => {
-        if (seen.has(root.skillsDirectory)) {
-            return false;
-        }
-        seen.add(root.skillsDirectory);
-        return true;
-    });
-};
-const readSkillCatalogRootEntries = (root) => readOptionalDirectoryNames(root.skillsDirectory)
-    .filter((name) => isValidSkillId(name) && existsSync(join(root.skillsDirectory, name, 'SKILL.md')))
-    .sort()
-    .map((name) => ({
-    id: name,
-    directory: join(root.skillsDirectory, name),
-    skillPath: join(root.skillsDirectory, name, 'SKILL.md'),
-    referenceRoot: root.referenceRoot,
-    origin: root.origin,
-}));
-const readOptionalDirectoryNames = (directory) => {
-    try {
-        return readdirSync(directory, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory() || isSymlinkedDirectory(join(directory, entry.name), entry.isSymbolicLink()))
-            .map((entry) => entry.name);
-    }
-    catch (error) {
-        if (isMissingPathError(error)) {
-            return [];
-        }
-        throw new Error(`Could not read skills directory '${directory}': ${String(error)}`, { cause: error });
-    }
-};
-const isSymlinkedDirectory = (path, isSymbolicLink) => {
-    if (!isSymbolicLink) {
-        return false;
-    }
-    try {
-        return statSync(path).isDirectory();
-    }
-    catch {
-        return false;
-    }
-};
-const isMissingPathError = (error) => error !== null && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';
-//# sourceMappingURL=SkillCatalog.js.map

package/dist/skills/SkillCatalog.js.map

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

package/dist/skills/SkillResolution.d.ts

@@ -1,34 +0,0 @@
-import type { SkillControlEntry } from '../profiles/Profile.js';
-import type { SkillCatalog } from './SkillCatalog.js';
-export interface SkillResolutionDiagnostic {
-    readonly severity: 'error' | 'warning';
-    readonly path: string;
-    readonly message: string;
-}
-export interface SkillEntryInput {
-    readonly entry: SkillControlEntry;
-    /** Root for `file` references appended by the declaring profile. */
-    readonly profileReferenceRoot?: string;
-}
-/**
- * Shared across control scopes so one skill ID materializes once; a second
- * selection reuses the generated directory, and differing reference sets error.
- */
-export type SkillMaterializationCache = Map<string, {
-    readonly referencesKey: string;
-    readonly generatedDirectory?: string;
-}>;
-export interface SkillResolutionInput {
-    readonly entries: readonly SkillEntryInput[];
-    readonly catalog: SkillCatalog;
-    readonly projectDirectory?: string;
-    /** When set, resolved skills are copied here as `<id>/` with materialized references. */
-    readonly outputDirectory?: string;
-    readonly materializationCache?: SkillMaterializationCache;
-}
-export interface SkillResolutionResult {
-    /** Skill sources in entry order: generated directories for resolved IDs, original strings otherwise. */
-    readonly sources: readonly string[];
-    readonly diagnostics: readonly SkillResolutionDiagnostic[];
-}
-export declare const resolveSkillEntries: (input: SkillResolutionInput) => SkillResolutionResult;

package/dist/skills/SkillResolution.js

@@ -1,369 +0,0 @@
-// Resolves selected skill IDs, validates references, and materializes generated skills.
-import { copyFileSync, cpSync, existsSync, globSync, mkdirSync, readdirSync, realpathSync, statSync, } from 'node:fs';
-import { basename, isAbsolute, join, relative, sep } from 'node:path';
-import { isSkillDocumentIssue, isValidSkillId, readSkillDocument, skillMaterializationSections, } from './SkillDocument.js';
-export const resolveSkillEntries = (input) => {
-    const sources = [];
-    const diagnostics = [];
-    for (const entryInput of input.entries) {
-        const outcome = resolveSkillEntry(input, entryInput);
-        sources.push(...outcome.sources);
-        diagnostics.push(...outcome.diagnostics);
-    }
-    return { sources, diagnostics };
-};
-const resolveSkillEntry = (input, entryInput) => {
-    const { entry, profileReferenceRoot } = entryInput;
-    const selection = typeof entry === 'string' ? { id: entry } : entry;
-    const catalogEntry = input.catalog.entries.get(selection.id);
-    if (catalogEntry === undefined) {
-        return resolveUncataloguedEntry(entry, selection.id);
-    }
-    const references = selection.references ?? [];
-    const referencesKey = JSON.stringify(references);
-    const cached = input.materializationCache?.get(selection.id);
-    if (cached !== undefined) {
-        return resolveCachedEntry(cached, referencesKey, selection.id);
-    }
-    const resolved = resolveCatalogSkill({
-        catalogEntry,
-        references,
-        profileReferenceRoot,
-        projectDirectory: input.projectDirectory,
-        outputDirectory: input.outputDirectory,
-    });
-    input.materializationCache?.set(selection.id, {
-        referencesKey,
-        generatedDirectory: resolved.generatedDirectory,
-    });
-    return { sources: toEntrySources(resolved.generatedDirectory), diagnostics: resolved.diagnostics };
-};
-const resolveCachedEntry = (cached, referencesKey, id) => {
-    if (cached.referencesKey !== referencesKey) {
-        return {
-            sources: [],
-            diagnostics: [
-                {
-                    severity: 'error',
-                    path: `controls.skills/${id}`,
-                    message: `Skill '${id}' is selected with conflicting reference sets across control scopes.`,
-                },
-            ],
-        };
-    }
-    return { sources: toEntrySources(cached.generatedDirectory), diagnostics: [] };
-};
-const toEntrySources = (generatedDirectory) => generatedDirectory === undefined ? [] : [generatedDirectory];
-const resolveUncataloguedEntry = (entry, id) => {
-    if (typeof entry !== 'string') {
-        return {
-            sources: [],
-            diagnostics: [
-                {
-                    severity: 'error',
-                    path: `controls.skills/${id}`,
-                    message: `Skill ID '${id}' does not resolve in any skills directory.`,
-                },
-            ],
-        };
-    }
-    if (isValidSkillId(entry)) {
-        return {
-            sources: [entry],
-            diagnostics: [
-                {
-                    severity: 'warning',
-                    path: `controls.skills/${entry}`,
-                    message: `Skill '${entry}' does not resolve in any skills directory; passing it through as a path source.`,
-                },
-            ],
-        };
-    }
-    return { sources: [entry], diagnostics: [] };
-};
-const resolveCatalogSkill = (input) => {
-    const { catalogEntry } = input;
-    const diagnostics = [];
-    const document = readSkillDocument(catalogEntry.skillPath);
-    if (isSkillDocumentIssue(document)) {
-        return { diagnostics: [{ severity: 'error', path: document.path, message: document.message }] };
-    }
-    if (document.name !== catalogEntry.id) {
-        return {
-            diagnostics: [
-                {
-                    severity: 'error',
-                    path: catalogEntry.skillPath,
-                    message: `SKILL.md 'name' ('${document.name}') must match its directory name ('${catalogEntry.id}').`,
-                },
-            ],
-        };
-    }
-    const materializations = planSkillMaterializations(input, document, diagnostics);
-    if (diagnostics.some((diagnostic) => diagnostic.severity === 'error') || input.outputDirectory === undefined) {
-        return { diagnostics };
-    }
-    const generatedDirectory = join(input.outputDirectory, catalogEntry.id);
-    cpSync(catalogEntry.directory, generatedDirectory, { recursive: true });
-    for (const materialization of materializations) {
-        const sectionDirectory = join(generatedDirectory, materialization.section);
-        mkdirSync(sectionDirectory, { recursive: true });
-        const destinationPath = join(sectionDirectory, materialization.destinationName);
-        // Both copies preserve the source mode, so materialized scripts stay
-        // executable. Directory targets dereference symlinks that the contained
-        // scan already validated, so the generated skill is self-contained.
-        if (materialization.kind === 'directory') {
-            copyDirectoryDereferenced(materialization.sourcePath, destinationPath);
-        }
-        else {
-            copyFileSync(materialization.sourcePath, destinationPath);
-        }
-    }
-    return { generatedDirectory, diagnostics };
-};
-const planSkillMaterializations = (input, document, diagnostics) => {
-    const materializations = [];
-    for (const section of skillMaterializationSections) {
-        const entries = [
-            ...document[section].map((reference) => ({ reference, fileRoot: input.catalogEntry.referenceRoot })),
-            // Profile-added references resolve `file` from the declaring profile's repository.
-            ...(section === 'references'
-                ? input.references.map((reference) => ({
-                    reference,
-                    fileRoot: input.profileReferenceRoot ?? input.projectDirectory ?? input.catalogEntry.referenceRoot,
-                }))
-                : []),
-        ];
-        materializations.push(...planSectionMaterializations(input, section, entries, diagnostics));
-    }
-    return materializations;
-};
-const planSectionMaterializations = (input, section, entries, diagnostics) => {
-    const materializations = [];
-    const destinationSources = new Map();
-    for (const { reference, fileRoot } of entries) {
-        const outcomes = resolveReferenceMaterializations({
-            reference,
-            section,
-            fileRoot,
-            projectDirectory: input.projectDirectory,
-            skillPath: input.catalogEntry.skillPath,
-        });
-        for (const resolved of outcomes) {
-            if ('message' in resolved) {
-                diagnostics.push(resolved);
-                continue;
-            }
-            const collision = describeDestinationCollision(input, section, resolved, destinationSources);
-            if (collision !== undefined) {
-                diagnostics.push({ severity: 'error', path: input.catalogEntry.skillPath, message: collision });
-                continue;
-            }
-            destinationSources.set(resolved.destinationName, resolved.sourcePath);
-            materializations.push(resolved);
-        }
-    }
-    return materializations;
-};
-/** Reports a destination claimed twice or already shipped inside the skill directory. */
-const describeDestinationCollision = (input, section, resolved, destinationSources) => {
-    const previousSource = destinationSources.get(resolved.destinationName);
-    if (previousSource !== undefined) {
-        return (`Destination '${section}/${resolved.destinationName}' is declared more than once ` +
-            `(by '${previousSource}' and '${resolved.sourcePath}').`);
-    }
-    // Checked against the source skill directory during planning so lint reports
-    // shipped-file collisions without materializing anything.
-    if (existsSync(join(input.catalogEntry.directory, section, resolved.destinationName))) {
-        return (`Destination '${section}/${resolved.destinationName}' collides with a file ` +
-            `already shipped by skill '${input.catalogEntry.id}'.`);
-    }
-    return undefined;
-};
-const describeReference = (reference, fileRoot, projectDirectory) => 'repo_file' in reference
-    ? { declaredPath: reference.repo_file, root: projectDirectory, kind: 'repo_file', rootLabel: 'project' }
-    : { declaredPath: reference.file, root: fileRoot, kind: 'file', rootLabel: 'catalog' };
-const targetError = (skillPath, message) => ({
-    severity: 'error',
-    path: skillPath,
-    message,
-});
-/**
- * Resolves one reference entry to its materializations: one for a literal
- * target, one per match for a glob target, and none for an omitted missing
- * `repo_file` target.
- */
-const resolveReferenceMaterializations = (input) => {
-    const { declaredPath, root, kind, rootLabel } = describeReference(input.reference, input.fileRoot, input.projectDirectory);
-    if (root === undefined) {
-        return [
-            targetError(input.skillPath, `Reference ${kind} '${declaredPath}' has no ${rootLabel} root to resolve from.`),
-        ];
-    }
-    const context = { root, kind, rootLabel, section: input.section, skillPath: input.skillPath };
-    if (isGlobPattern(declaredPath)) {
-        return expandGlobMaterializations(declaredPath, context);
-    }
-    const resolved = resolveTargetMaterialization(declaredPath, context);
-    return resolved === undefined ? [] : [resolved];
-};
-/**
- * Matches when a target uses glob syntax instead of naming one literal path.
- * Only the gitignore-style metacharacters count; braces are literal path
- * characters, so a braced filename resolves as a literal target.
- */
-const isGlobPattern = (declaredPath) => /[*?[]/u.test(declaredPath);
-/**
- * Expands a glob target against its root. Each match then follows the same
- * rules as a literal target, so a matched directory materializes recursively
- * while an escaping or special match fails validation individually.
- */
-const expandGlobMaterializations = (pattern, context) => {
-    // Braces are literal path characters in this contract, but globSync
-    // brace-expands them textually and offers no escape, so mixing them with
-    // glob syntax fails validation rather than silently matching other paths.
-    if (/[{}]/u.test(pattern)) {
-        return [
-            targetError(context.skillPath, `Reference ${context.kind} glob '${pattern}' must not contain braces; ` +
-                `braces are literal path characters, not glob syntax.`),
-        ];
-    }
-    // Sorted so diagnostics and collisions are deterministic across platforms.
-    const matches = globSync(pattern, { cwd: context.root }).sort();
-    if (matches.length === 0) {
-        // A consuming project may not contain repo_file matches; the reference is omitted.
-        return context.kind === 'repo_file'
-            ? []
-            : [targetError(context.skillPath, `Reference file glob '${pattern}' matched no files under '${context.root}'.`)];
-    }
-    const resolved = [];
-    for (const match of matches) {
-        const outcome = resolveTargetMaterialization(match, context);
-        if (outcome !== undefined) {
-            resolved.push(outcome);
-        }
-    }
-    return resolved;
-};
-/** Validates one concrete target path — a literal target or a single glob match. */
-const resolveTargetMaterialization = (targetPath, context) => {
-    const { root, kind, rootLabel, skillPath } = context;
-    const error = (message) => targetError(skillPath, message);
-    const sourcePath = isAbsolute(targetPath) ? targetPath : join(root, targetPath);
-    if (!existsSync(sourcePath)) {
-        // A consuming project may not contain a repo_file target; the reference is omitted.
-        return kind === 'repo_file' ? undefined : error(`Reference file '${targetPath}' was not found under '${root}'.`);
-    }
-    const stats = statSync(sourcePath);
-    if (!stats.isFile() && !stats.isDirectory()) {
-        return error(`Reference ${kind} '${targetPath}' must be a regular file or directory.`);
-    }
-    if (escapesRoot(sourcePath, root)) {
-        return error(`Reference ${kind} '${targetPath}' resolves outside its ${rootLabel} root '${root}'.`);
-    }
-    const directoryIssue = describeDirectoryTargetIssue(stats, sourcePath, targetPath, context);
-    if (directoryIssue !== undefined) {
-        return error(directoryIssue);
-    }
-    return {
-        section: context.section,
-        sourcePath,
-        destinationName: basename(targetPath),
-        kind: stats.isDirectory() ? 'directory' : 'file',
-    };
-};
-/** Describes the first escaping, cyclic, or special path inside a directory target, if any. */
-const describeDirectoryTargetIssue = (stats, sourcePath, targetPath, context) => {
-    if (!stats.isDirectory()) {
-        return undefined;
-    }
-    const issue = scanDirectoryTarget(sourcePath, context.root, [realpathSync(sourcePath)], new Set());
-    if (issue === undefined) {
-        return undefined;
-    }
-    const containedPath = relative(sourcePath, issue.path);
-    const problemDescriptions = {
-        escaping: `which resolves outside its ${context.rootLabel} root '${context.root}'`,
-        cyclic: 'which creates a symlink cycle',
-        special: 'which is not a regular file or directory',
-    };
-    return (`Reference ${context.kind} '${targetPath}' contains ` + `'${containedPath}', ${problemDescriptions[issue.problem]}.`);
-};
-/**
- * Finds the first path inside a directory target whose realpath escapes the
- * reference root, a symlink that cycles back into an ancestor directory, or an
- * entry that is neither a regular file nor a directory. Directory
- * materialization dereferences symlinks recursively, so an escaping link would
- * smuggle outside content into the generated skill, a cyclic link would never
- * finish copying, and a special file such as a FIFO could block the copy.
- */
-const scanDirectoryTarget = (directory, root, 
-/** Realpaths of the directories on the current descent, for cycle detection. */
-ancestry, 
-/** Realpaths of fully scanned directories, so shared subtrees scan once. */
-scanned) => {
-    for (const entry of readdirSync(directory, { withFileTypes: true })) {
-        const entryPath = join(directory, entry.name);
-        if (escapesRoot(entryPath, root)) {
-            return { path: entryPath, problem: 'escaping' };
-        }
-        // statSync follows symlinks, so in-root symlinked subdirectories are
-        // scanned too and a link to a special file is rejected like the file itself.
-        const entryStats = statSync(entryPath);
-        if (!entryStats.isFile() && !entryStats.isDirectory()) {
-            return { path: entryPath, problem: 'special' };
-        }
-        if (!entryStats.isDirectory()) {
-            continue;
-        }
-        const resolvedEntryPath = realpathSync(entryPath);
-        if (ancestry.includes(resolvedEntryPath)) {
-            return { path: entryPath, problem: 'cyclic' };
-        }
-        if (!scanned.has(resolvedEntryPath)) {
-            scanned.add(resolvedEntryPath);
-            const issue = scanDirectoryTarget(entryPath, root, [...ancestry, resolvedEntryPath], scanned);
-            if (issue !== undefined) {
-                return issue;
-            }
-        }
-    }
-    return undefined;
-};
-/**
- * Copies a directory target while dereferencing symlinks, so the generated
- * skill has no links back into catalog or project checkouts. cpSync's
- * dereference option only follows the top-level source path, so nested entries
- * are walked explicitly; copyFileSync preserves each file's mode.
- */
-const copyDirectoryDereferenced = (source, destination) => {
-    mkdirSync(destination, { recursive: true });
-    for (const entry of readdirSync(source, { withFileTypes: true })) {
-        const sourcePath = join(source, entry.name);
-        const destinationPath = join(destination, entry.name);
-        // statSync follows symlinks; scanDirectoryTarget already rejected cycles.
-        if (statSync(sourcePath).isDirectory()) {
-            copyDirectoryDereferenced(sourcePath, destinationPath);
-        }
-        else {
-            copyFileSync(sourcePath, destinationPath);
-        }
-    }
-};
-/** Targets must remain within their root after following symlinks. */
-const escapesRoot = (sourcePath, root) => {
-    let resolvedSource;
-    let resolvedRoot;
-    try {
-        resolvedSource = realpathSync(sourcePath);
-        resolvedRoot = realpathSync(root);
-    }
-    catch {
-        /* v8 ignore next 2 -- existsSync guards the source; a vanished root is a race we treat as escaping. */
-        return true;
-    }
-    const relativePath = relative(resolvedRoot, resolvedSource);
-    // A bare '..' or a '../' prefix escapes; a sibling name like '..config' does not.
-    return relativePath === '..' || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath);
-};
-//# sourceMappingURL=SkillResolution.js.map