@skillsmith/core 0.5.2 → 0.5.4

package/dist/src/indexer/SkillParser.test.js

@@ -0,0 +1,375 @@
+import { describe, it, expect } from 'vitest';
+import SkillParser from './SkillParser.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeSkillMd(frontmatter, body = '# My Skill\n\nDoes things.') {
+    return `---\n${frontmatter}\n---\n\n${body}`;
+}
+const MINIMAL_VALID = makeSkillMd('name: my-skill');
+const FULL_VALID = makeSkillMd([
+    'name: full-skill',
+    'description: A thorough skill with all recommended fields present.',
+    'author: acme',
+    'version: 1.2.3',
+    'license: MIT',
+    'tags:',
+    '  - typescript',
+    '  - testing',
+    '  - vitest',
+    'category: testing',
+    'repository: https://github.com/acme/full-skill',
+].join('\n'));
+// ---------------------------------------------------------------------------
+// extractFrontmatter
+// ---------------------------------------------------------------------------
+describe('SkillParser.extractFrontmatter', () => {
+    const parser = new SkillParser();
+    it('returns null when content does not start with ---', () => {
+        expect(parser.extractFrontmatter('name: foo\n---')).toBeNull();
+    });
+    it('returns null when there is no closing --- delimiter', () => {
+        expect(parser.extractFrontmatter('---\nname: foo\n')).toBeNull();
+    });
+    it('returns null for an empty string', () => {
+        expect(parser.extractFrontmatter('')).toBeNull();
+    });
+    it('parses a simple key-value pair', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: my-skill'));
+        expect(result?.name).toBe('my-skill');
+    });
+    it('parses double-quoted string values', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: "quoted skill"'));
+        expect(result?.name).toBe('quoted skill');
+    });
+    it('parses single-quoted string values', () => {
+        const result = parser.extractFrontmatter(makeSkillMd("name: 'single quoted'"));
+        expect(result?.name).toBe('single quoted');
+    });
+    it('parses boolean true', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ndeprecated: true'));
+        expect(result?.deprecated).toBe(true);
+    });
+    it('parses boolean false', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ndeprecated: false'));
+        expect(result?.deprecated).toBe(false);
+    });
+    it('parses a numeric value', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\nsome_count: 42'));
+        expect(result?.some_count).toBe(42);
+    });
+    it('parses a block-style array', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ntags:\n  - alpha\n  - beta\n  - gamma'));
+        expect(result?.tags).toEqual(['alpha', 'beta', 'gamma']);
+    });
+    it('parses an inline array', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ntags: [alpha, beta, gamma]'));
+        expect(result?.tags).toEqual(['alpha', 'beta', 'gamma']);
+    });
+    it('ignores YAML comments', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('# this is a comment\nname: commented-skill'));
+        expect(result?.name).toBe('commented-skill');
+    });
+    it('preserves unicode characters in string values', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: "日本語スキル"'));
+        expect(result?.name).toBe('日本語スキル');
+    });
+    it('preserves unknown extra keys', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ncustom_field: hello'));
+        expect(result?.custom_field).toBe('hello');
+    });
+    it('coerces a numeric name to a string', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: 123'));
+        expect(typeof result?.name).toBe('string');
+        expect(result?.name).toBe('123');
+    });
+});
+// ---------------------------------------------------------------------------
+// validate
+// ---------------------------------------------------------------------------
+describe('SkillParser.validate', () => {
+    it('is valid for a frontmatter object with a name', () => {
+        const parser = new SkillParser();
+        const result = parser.validate({ name: 'my-skill' });
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('returns an error when name is missing and requireName is true (default)', () => {
+        const parser = new SkillParser();
+        const result = parser.validate({});
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Missing required field: name');
+    });
+    it('does not error on missing name when requireName is false', () => {
+        const parser = new SkillParser({ requireName: false });
+        const result = parser.validate({});
+        expect(result.valid).toBe(true);
+    });
+    it('returns an error when description is required but missing', () => {
+        const parser = new SkillParser({ requireDescription: true });
+        const result = parser.validate({ name: 'x' });
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Missing required field: description');
+    });
+    it('does not error when description is provided and required', () => {
+        const parser = new SkillParser({ requireDescription: true });
+        const result = parser.validate({ name: 'x', description: 'A skill.' });
+        expect(result.valid).toBe(true);
+    });
+    it('emits a warning when description is absent', () => {
+        const parser = new SkillParser();
+        const result = parser.validate({ name: 'x' });
+        expect(result.warnings.some((w) => w.includes('description'))).toBe(true);
+    });
+    it('emits a warning when version is absent', () => {
+        const parser = new SkillParser();
+        const result = parser.validate({ name: 'x' });
+        expect(result.warnings.some((w) => w.includes('version'))).toBe(true);
+    });
+    it('emits a warning when tags are absent', () => {
+        const parser = new SkillParser();
+        const result = parser.validate({ name: 'x' });
+        expect(result.warnings.some((w) => w.includes('tags'))).toBe(true);
+    });
+    it('emits a deprecation warning when composes is present', () => {
+        const parser = new SkillParser();
+        const result = parser.validate({
+            name: 'x',
+            composes: ['other-skill'],
+        });
+        expect(result.warnings.some((w) => w.includes('composes'))).toBe(true);
+    });
+    it('merges errors and warnings from a custom validator', () => {
+        const parser = new SkillParser({
+            customValidator: () => ({
+                valid: false,
+                errors: ['custom error'],
+                warnings: ['custom warning'],
+            }),
+        });
+        const result = parser.validate({ name: 'x' });
+        expect(result.errors).toContain('custom error');
+        expect(result.warnings).toContain('custom warning');
+        expect(result.valid).toBe(false);
+    });
+    it('is valid when custom validator passes', () => {
+        const parser = new SkillParser({
+            customValidator: () => ({ valid: true, errors: [], warnings: [] }),
+        });
+        const result = parser.validate({ name: 'x' });
+        expect(result.valid).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// parse
+// ---------------------------------------------------------------------------
+describe('SkillParser.parse', () => {
+    const parser = new SkillParser();
+    it('returns null for content without a frontmatter block', () => {
+        expect(parser.parse('# Just a heading\n\nNo frontmatter here.')).toBeNull();
+    });
+    it('returns null when required name field is absent', () => {
+        expect(parser.parse(makeSkillMd('description: no name here'))).toBeNull();
+    });
+    it('returns ParsedSkillMetadata for valid minimal content', () => {
+        const result = parser.parse(MINIMAL_VALID);
+        expect(result).not.toBeNull();
+        expect(result?.name).toBe('my-skill');
+    });
+    it('maps all optional fields correctly', () => {
+        const result = parser.parse(FULL_VALID);
+        expect(result.name).toBe('full-skill');
+        expect(result.description).toBe('A thorough skill with all recommended fields present.');
+        expect(result.author).toBe('acme');
+        expect(result.version).toBe('1.2.3');
+        expect(result.license).toBe('MIT');
+        expect(result.tags).toEqual(['typescript', 'testing', 'vitest']);
+        expect(result.category).toBe('testing');
+        expect(result.repository).toBe('https://github.com/acme/full-skill');
+    });
+    it('sets absent optional fields to null', () => {
+        const result = parser.parse(MINIMAL_VALID);
+        expect(result.description).toBeNull();
+        expect(result.author).toBeNull();
+        expect(result.version).toBeNull();
+        expect(result.license).toBeNull();
+        expect(result.category).toBeNull();
+        expect(result.repository).toBeNull();
+    });
+    it('sets tags to an empty array when absent', () => {
+        const result = parser.parse(MINIMAL_VALID);
+        expect(result.tags).toEqual([]);
+    });
+    it('preserves rawContent in the result', () => {
+        const result = parser.parse(MINIMAL_VALID);
+        expect(result.rawContent).toBe(MINIMAL_VALID);
+    });
+    it('includes the original frontmatter object in the result', () => {
+        const result = parser.parse(MINIMAL_VALID);
+        expect(result.frontmatter.name).toBe('my-skill');
+    });
+});
+// ---------------------------------------------------------------------------
+// parseWithValidation
+// ---------------------------------------------------------------------------
+describe('SkillParser.parseWithValidation', () => {
+    const parser = new SkillParser();
+    it('returns failed validation when frontmatter is missing', () => {
+        const { metadata, validation, frontmatter } = parser.parseWithValidation('No frontmatter here.');
+        expect(metadata).toBeNull();
+        expect(frontmatter).toBeNull();
+        expect(validation.valid).toBe(false);
+        expect(validation.errors.length).toBeGreaterThan(0);
+    });
+    it('returns null metadata and errors when validation fails', () => {
+        const { metadata, validation } = parser.parseWithValidation(makeSkillMd('description: missing name'));
+        expect(metadata).toBeNull();
+        expect(validation.valid).toBe(false);
+    });
+    it('returns non-null metadata and the frontmatter when valid', () => {
+        const { metadata, validation, frontmatter } = parser.parseWithValidation(MINIMAL_VALID);
+        expect(metadata).not.toBeNull();
+        expect(validation.valid).toBe(true);
+        expect(frontmatter?.name).toBe('my-skill');
+    });
+    it('includes warnings alongside a successful parse', () => {
+        const { validation } = parser.parseWithValidation(MINIMAL_VALID);
+        expect(validation.warnings.length).toBeGreaterThan(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// extractBody
+// ---------------------------------------------------------------------------
+describe('SkillParser.extractBody', () => {
+    const parser = new SkillParser();
+    it('returns content after the closing --- delimiter', () => {
+        const content = '---\nname: x\n---\n\n# Body\n\nSome content.';
+        expect(parser.extractBody(content)).toBe('# Body\n\nSome content.');
+    });
+    it('returns the full content when no frontmatter delimiter is present', () => {
+        const content = '# Just a body\n\nNo frontmatter.';
+        expect(parser.extractBody(content)).toBe(content);
+    });
+    it('returns an empty string when there is no body after the frontmatter', () => {
+        const content = '---\nname: x\n---';
+        expect(parser.extractBody(content)).toBe('');
+    });
+});
+// ---------------------------------------------------------------------------
+// inferTrustTier
+// ---------------------------------------------------------------------------
+describe('SkillParser.inferTrustTier', () => {
+    const parser = new SkillParser();
+    function makeMetadata(overrides) {
+        return {
+            name: 'test-skill',
+            description: null,
+            author: null,
+            version: null,
+            tags: [],
+            category: null,
+            license: null,
+            repository: null,
+            rawContent: '',
+            frontmatter: { name: 'test-skill' },
+            ...overrides,
+        };
+    }
+    it('returns verified for an anthropic author', () => {
+        expect(parser.inferTrustTier(makeMetadata({ author: 'anthropic' }))).toBe('verified');
+    });
+    it('returns verified for a skillsmith author', () => {
+        expect(parser.inferTrustTier(makeMetadata({ author: 'skillsmith' }))).toBe('verified');
+    });
+    it('is case-insensitive for verified author matching', () => {
+        expect(parser.inferTrustTier(makeMetadata({ author: 'Anthropic' }))).toBe('verified');
+    });
+    it('returns community when metadata score is 3 or more', () => {
+        const metadata = makeMetadata({
+            author: 'acme',
+            // description > 50 chars, 3+ tags, version, license = score 4
+            description: 'A well-documented skill that exceeds the fifty character threshold.',
+            tags: ['a', 'b', 'c'],
+            version: '1.0.0',
+            license: 'MIT',
+        });
+        expect(parser.inferTrustTier(metadata)).toBe('community');
+    });
+    it('returns experimental when metadata score is exactly 1', () => {
+        const metadata = makeMetadata({
+            author: 'acme',
+            version: '1.0.0',
+            // description null, no tags, no license = score 1
+        });
+        expect(parser.inferTrustTier(metadata)).toBe('experimental');
+    });
+    it('returns unknown when there is no meaningful metadata', () => {
+        expect(parser.inferTrustTier(makeMetadata({ author: 'acme' }))).toBe('unknown');
+    });
+});
+// ---------------------------------------------------------------------------
+// SkillParser.parseDependencyBlock (static)
+// ---------------------------------------------------------------------------
+describe('SkillParser.parseDependencyBlock', () => {
+    it('returns undefined when there is no dependencies key', () => {
+        expect(SkillParser.parseDependencyBlock('name: x\nversion: 1.0.0')).toBeUndefined();
+    });
+    it('returns undefined when dependencies is not an object', () => {
+        expect(SkillParser.parseDependencyBlock('dependencies: some-string')).toBeUndefined();
+    });
+    it('returns a parsed array when dependencies has a flat array item', () => {
+        // The built-in parser is best-effort; nested objects need js-yaml.
+        // A flat array under dependencies is the simplest case it can handle.
+        const yaml = 'dependencies:\n  - some-skill';
+        const result = SkillParser.parseDependencyBlock(yaml);
+        expect(result).toEqual(['some-skill']);
+    });
+});
+// ---------------------------------------------------------------------------
+// SkillParser.checkReferences (static)
+// ---------------------------------------------------------------------------
+describe('SkillParser.checkReferences', () => {
+    it('returns empty warnings and matches for clean content', () => {
+        const { warnings, matches } = SkillParser.checkReferences('# A clean skill\n\nNo refs here.');
+        expect(warnings).toHaveLength(0);
+        expect(matches).toHaveLength(0);
+    });
+    it('detects a Docker container name', () => {
+        const { matches } = SkillParser.checkReferences('Run `docker exec myproject-dev-1 npm test`.');
+        expect(matches.some((m) => m.pattern === 'Docker container name')).toBe(true);
+    });
+    it('detects an npm package scope', () => {
+        const { matches } = SkillParser.checkReferences('Install `@skillsmith-tools/helper` first.');
+        expect(matches.some((m) => m.pattern === 'npm package scope')).toBe(true);
+    });
+    it('detects a GitHub repo reference', () => {
+        const { matches } = SkillParser.checkReferences('See github.com/acme-corp/my-repo for details.');
+        expect(matches.some((m) => m.pattern === 'GitHub repo reference')).toBe(true);
+    });
+    it('detects a project URL', () => {
+        const { matches } = SkillParser.checkReferences('Documentation at https://myproject.app/docs/guide.');
+        expect(matches.some((m) => m.pattern === 'Project URL')).toBe(true);
+    });
+    it('includes the correct line number in match results', () => {
+        const content = 'Line one.\nSee github.com/acme-corp/my-repo here.\nLine three.';
+        const { matches } = SkillParser.checkReferences(content);
+        const ghMatch = matches.find((m) => m.pattern === 'GitHub repo reference');
+        expect(ghMatch?.line).toBe(2);
+    });
+    it('truncates matched text longer than 80 characters', () => {
+        const longUrl = 'https://very-long-project.app/' + 'x'.repeat(100) + '/';
+        const { matches } = SkillParser.checkReferences(`See ${longUrl} for info.`);
+        const urlMatch = matches.find((m) => m.pattern === 'Project URL');
+        expect(urlMatch).toBeDefined();
+        expect(urlMatch.text.length).toBeLessThanOrEqual(83); // 80 chars + '...'
+    });
+    it('applies custom patterns alongside the defaults', () => {
+        const { matches } = SkillParser.checkReferences('The secret token is abc-123.', [/abc-\d+/g]);
+        expect(matches.some((m) => m.pattern === 'Custom pattern')).toBe(true);
+    });
+    it('includes a summary warning when matches are found', () => {
+        const { warnings } = SkillParser.checkReferences('See github.com/acme-corp/my-repo for details.');
+        expect(warnings.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=SkillParser.test.js.map

package/dist/src/indexer/SkillParser.test.js.map

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

package/dist/src/sources/LocalFilesystemAdapter.d.ts

@@ -1,8 +1,36 @@
 /**
- * Local Filesystem Source Adapter (SMI-591)
+ * Local Filesystem Source Adapter (SMI-591, SMI-4287, SMI-4319, SMI-4320)
  *
  * Scans local directories for SKILL.md files.
  * Useful for local development and testing.
+ *
+ * SMI-4287 hardening:
+ * - Symlink targets are resolved via `fs.realpath` and checked against the
+ *   adapter's `rootDir`. Targets outside root are skipped with a
+ *   `symlink-escape` warning (unless `allowSymlinksOutsideRoot` is `true`).
+ * - Permission (EACCES/EPERM), not-found (ENOENT), and loop (ELOOP) errors
+ *   are surfaced as `AdapterError` entries on `SourceSearchResult.warnings`
+ *   instead of throwing, so siblings continue to be scanned.
+ * - All `fs.*` calls route through the typed `safeFs` helpers; the historic
+ *   bare `try/catch` for EACCES in `scanDirectory` is removed.
+ *
+ * SMI-4319 hardening:
+ * - `runScan` allocates a fresh `visitedRealpaths: Set<string>` per
+ *   invocation so mutually-recursive / self-looping directory symlinks are
+ *   detected and skipped with a `loop` warning instead of silently wasting
+ *   `maxDepth` traversals.
+ *
+ * SMI-4320 hardening:
+ * - `resolveSkillPath` is now async and routes through `resolveSafeRealpath`
+ *   (byte-wise `startsWith(rootReal + sep)` on realpath outputs — no
+ *   platform lowercasing). Direct-access methods (`getRepository`,
+ *   `fetchSkillContent`, `skillExists`) inherit containment instead of
+ *   relying solely on lexical `validatePath`. This closes the scan-to-fetch
+ *   TOCTOU window where an indexed-then-swapped symlink previously escaped
+ *   containment. `allowSymlinksOutsideRoot` is honoured at every realpath
+ *   callsite. Residual TOCTOU between `resolveSkillPath` and the subsequent
+ *   `fs.readFile` is documented; closing it requires fd-based I/O and is
+ *   tracked as a separate follow-up.
  */
 import { BaseSourceAdapter } from './BaseSourceAdapter.js';
 import type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
@@ -18,6 +46,22 @@ export interface LocalFilesystemConfig extends SourceConfig {
     excludePatterns?: string[];
     /** Whether to follow symlinks (default: false) */
     followSymlinks?: boolean;
+    /**
+     * Allow symlinks whose target resolves outside `rootDir` (SMI-4287).
+     *
+     * Default `false`: symlinks pointing outside the scan root are skipped and
+     * a `symlink-escape` entry is added to `SourceSearchResult.warnings`. This
+     * prevents an attacker with write access to `rootDir` from exfiltrating
+     * content from arbitrary locations on the filesystem (GitHub #600).
+     *
+     * Set to `true` only if you trust every symlink inside `rootDir` (e.g.
+     * monorepo layouts that intentionally point at sibling packages). The
+     * caller accepts the security tradeoff.
+     *
+     * Note: this flag has no effect when `followSymlinks` is `false` — symlinks
+     * are never traversed in that case.
+     */
+    allowSymlinksOutsideRoot?: boolean;
 }
 /**
  * Local Filesystem Source Adapter
@@ -37,6 +81,9 @@ export interface LocalFilesystemConfig extends SourceConfig {
  *
  * await adapter.initialize()
  * const result = await adapter.search({})
+ * for (const warning of result.warnings ?? []) {
+ *   console.warn(`[${warning.code}] ${warning.message}`)
+ * }
  * ```
  */
 export declare class LocalFilesystemAdapter extends BaseSourceAdapter {
@@ -44,26 +91,47 @@ export declare class LocalFilesystemAdapter extends BaseSourceAdapter {
     private readonly maxDepth;
     private readonly excludePatterns;
     private readonly followSymlinks;
+    private readonly allowSymlinksOutsideRoot;
     private discoveredSkills;
+    /**
+     * Warnings accumulated during the most recent scan. Consumed and cleared
+     * by `search()` so each caller sees only the warnings from that call's
+     * underlying scan.
+     */
+    private scanWarnings;
     constructor(config: LocalFilesystemConfig);
     /**
      * Initialize by scanning the filesystem
      */
     protected doInitialize(): Promise<void>;
     /**
-     * Check if root directory exists and is accessible
+     * Check if root directory exists and is accessible.
+     *
+     * SMI-4287: routes `fs.stat(rootDir)` through `safeFs` so the raw Node
+     * error is translated to a typed `AdapterError` message.
      */
     protected doHealthCheck(): Promise<Partial<SourceHealth>>;
     /**
-     * Search for skills in the scanned directories
+     * Search for skills in the scanned directories.
+     *
+     * SMI-4287: `warnings` collects non-fatal `AdapterError` entries from the
+     * scan (symlink escapes, permission denials, loops). An empty array is
+     * returned as `undefined` to keep the field strictly optional.
      */
     search(options?: SourceSearchOptions): Promise<SourceSearchResult>;
     /**
-     * Get repository info for a skill location
+     * Get repository info for a skill location.
+     *
+     * SMI-4287: `fs.stat` is routed through `safeFs`; permission errors are
+     * converted to typed Error messages instead of raw Node throws.
      */
     getRepository(location: SourceLocation): Promise<SourceRepository>;
     /**
-     * Fetch skill content from local file
+     * Fetch skill content from local file.
+     *
+     * SMI-4287: both `fs.readFile` and `fs.stat` route through `safeFs`, so
+     * permission errors (EACCES/EPERM) raise typed Errors with path context
+     * instead of raw Node errors.
      */
     fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
     /**
@@ -71,7 +139,10 @@ export declare class LocalFilesystemAdapter extends BaseSourceAdapter {
      */
     skillExists(location: SourceLocation): Promise<boolean>;
     /**
-     * Rescan the filesystem for new skills
+     * Rescan the filesystem for new skills.
+     *
+     * Returns the count of discovered skills. Warnings from the rescan are
+     * available via the next call to `search()`.
      */
     rescan(): Promise<number>;
     /**
@@ -79,9 +150,16 @@ export declare class LocalFilesystemAdapter extends BaseSourceAdapter {
      */
     get skillCount(): number;
     /**
-     * Scan a directory recursively for skill files
+     * Run the recursive scan starting at `rootDir`. Delegates to the extracted
+     * `scanDirectoryRecursive` helper (see `LocalFilesystemAdapter.scan.ts`).
+     *
+     * SMI-4319: allocates a fresh `visitedRealpaths` set per invocation so
+     * back-to-back scans don't share state. Sibling directories within a
+     * single scan share the set (they're in the same call tree), so
+     * cross-linked loops (A↔B) are caught even when the loop isn't on the
+     * descent path from `rootDir`.
      */
-    private scanDirectory;
+    private runScan;
     /**
      * Check if a path/name should be excluded (SMI-722, SMI-726)
      * Uses centralized safe pattern matching to prevent RegExp injection
@@ -89,11 +167,27 @@ export declare class LocalFilesystemAdapter extends BaseSourceAdapter {
     private isExcluded;
     /**
      * Resolve a skill location to a full filesystem path
-     * Validates that the resolved path remains within rootDir to prevent path traversal attacks (SMI-720, SMI-726)
+     * (SMI-720, SMI-726, SMI-4287, SMI-4320).
+     *
+     * Two-stage containment: (1) lexical `validatePath` fast-fails
+     * `../`-style traversal (SMI-720 contract — callers assert the
+     * "Path traversal detected" message), then (2) `resolveSafeRealpath`
+     * enforces realpath byte-wise containment so symlinks can't escape
+     * `rootDir` even when the lexical path is clean. Honours the SMI-4287
+     * `allowSymlinksOutsideRoot` opt-in.
+     *
+     * Not-found behaviour: realpath ENOENT falls back to the lexically
+     * resolved path so downstream `stat` / `readFile` produce the canonical
+     * caller-visible error. TOCTOU caveat: the window between this resolve
+     * and the caller's subsequent read remains open; closing it requires
+     * fd-based I/O and is tracked separately.
      */
     private resolveSkillPath;
     /**
-     * Convert discovered skill to SourceRepository
+     * Convert discovered skill to SourceRepository.
+     *
+     * Returns both the repository and any warnings encountered while reading
+     * the file (typically permission errors on SKILL.md after discovery).
      */
     private skillToRepository;
     /**

package/dist/src/sources/LocalFilesystemAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalFilesystemAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/LocalFilesystemAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAcnB;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAoBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,gBAAgB,CAAwB;gBAEpC,MAAM,EAAE,qBAAqB;IAQzC;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAItD;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAe/D;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkC5E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBxE;;OAEG;IACY,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAM/B;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;YACW,aAAa;IAuD3B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;YACW,iBAAiB;IA6C/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,sBAAsB,CAMxB"}
+{"version":3,"file":"LocalFilesystemAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/LocalFilesystemAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EAEb,MAAM,YAAY,CAAA;AAanB;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;;;;;;;;OAcG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,gBAAgB,CAA8B;IACtD;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAqB;gBAE7B,MAAM,EAAE,qBAAqB;IASzC;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtD;;;;;OAKG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAc/D;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmC5E;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkCxE;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBxE;;OAEG;IACY,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtE;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAO/B;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;;;;OASG;YACW,OAAO;IAcrB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;;;;;;;;;;;;OAgBG;YACW,gBAAgB;IA2C9B;;;;;OAKG;YACW,iBAAiB;IAiD/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,GAC5B,sBAAsB,CAMxB"}