@vibe-agent-toolkit/discovery 0.1.0-rc.7 → 0.1.0-rc.9

package/dist/detectors/format-detector.d.ts

@@ -0,0 +1,15 @@
+import type { DetectedFormat } from '../types.js';
+/**
+ * Detect file format based on filename
+ *
+ * Detection rules:
+ * - Exact match "SKILL.md" → claude-skill
+ * - Exact match "agent.yaml" or "agent.yml" → vat-agent
+ * - Extension ".md" → markdown
+ * - Everything else → unknown
+ *
+ * @param filePath - Path to file (can be relative or absolute)
+ * @returns Detected format
+ */
+export declare function detectFormat(filePath: string): DetectedFormat;
+//# sourceMappingURL=format-detector.d.ts.map

package/dist/detectors/format-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-detector.d.ts","sourceRoot":"","sources":["../../src/detectors/format-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAkB7D"}

package/dist/detectors/format-detector.js

@@ -0,0 +1,29 @@
+import * as path from 'node:path';
+/**
+ * Detect file format based on filename
+ *
+ * Detection rules:
+ * - Exact match "SKILL.md" → claude-skill
+ * - Exact match "agent.yaml" or "agent.yml" → vat-agent
+ * - Extension ".md" → markdown
+ * - Everything else → unknown
+ *
+ * @param filePath - Path to file (can be relative or absolute)
+ * @returns Detected format
+ */
+export function detectFormat(filePath) {
+    const basename = path.basename(filePath);
+    // Exact matches (case-sensitive)
+    if (basename === 'SKILL.md') {
+        return 'claude-skill';
+    }
+    if (basename === 'agent.yaml' || basename === 'agent.yml') {
+        return 'vat-agent';
+    }
+    // Extension-based detection (case-insensitive)
+    if (basename.toLowerCase().endsWith('.md')) {
+        return 'markdown';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=format-detector.js.map

package/dist/detectors/format-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-detector.js","sourceRoot":"","sources":["../../src/detectors/format-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEzC,iCAAiC;IACjC,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC1D,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/filters/pattern-filter.d.ts

@@ -0,0 +1,16 @@
+export interface PatternFilterOptions {
+    /** Include patterns (if specified, only matching files included) */
+    include?: string[];
+    /** Exclude patterns (applied after include) */
+    exclude?: string[];
+}
+/**
+ * Create a filter function for include/exclude patterns
+ *
+ * Uses picomatch for fast glob matching. Exclude patterns are applied after include.
+ *
+ * @param options - Pattern filter options
+ * @returns Filter function (returns true if file should be included)
+ */
+export declare function createPatternFilter(options: PatternFilterOptions): (filePath: string) => boolean;
+//# sourceMappingURL=pattern-filter.d.ts.map

package/dist/filters/pattern-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-filter.d.ts","sourceRoot":"","sources":["../../src/filters/pattern-filter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CA0B/B"}

package/dist/filters/pattern-filter.js

@@ -0,0 +1,32 @@
+import picomatch from 'picomatch';
+/**
+ * Create a filter function for include/exclude patterns
+ *
+ * Uses picomatch for fast glob matching. Exclude patterns are applied after include.
+ *
+ * @param options - Pattern filter options
+ * @returns Filter function (returns true if file should be included)
+ */
+export function createPatternFilter(options) {
+    const { include, exclude } = options;
+    // Compile patterns once for performance
+    // Use { contains: true } to match paths containing patterns (e.g., 'node_modules' matches 'path/node_modules/file')
+    const includeMatcher = include?.length
+        ? picomatch(include, { contains: true })
+        : null;
+    const excludeMatcher = exclude?.length
+        ? picomatch(exclude, { contains: true })
+        : null;
+    return (filePath) => {
+        // If include patterns specified, file must match at least one
+        if (includeMatcher && !includeMatcher(filePath)) {
+            return false;
+        }
+        // If exclude patterns specified, file must not match any
+        if (excludeMatcher?.(filePath)) {
+            return false;
+        }
+        return true;
+    };
+}
+//# sourceMappingURL=pattern-filter.js.map

package/dist/filters/pattern-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-filter.js","sourceRoot":"","sources":["../../src/filters/pattern-filter.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAUlC;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6B;IAE7B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAErC,wCAAwC;IACxC,oHAAoH;IACpH,MAAM,cAAc,GAAG,OAAO,EAAE,MAAM;QACpC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,cAAc,GAAG,OAAO,EAAE,MAAM;QACpC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,CAAC,QAAgB,EAAW,EAAE;QACnC,8DAA8D;QAC9D,IAAI,cAAc,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,yDAAyD;QACzD,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export { detectFormat } from './detectors/format-detector.js';
+export { createPatternFilter } from './filters/pattern-filter.js';
+export { scan } from './scanners/local-scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC"}

package/{src/index.ts → dist/index.js}

@@ -2,3 +2,4 @@ export * from './types.js';
 export { detectFormat } from './detectors/format-detector.js';
 export { createPatternFilter } from './filters/pattern-filter.js';
 export { scan } from './scanners/local-scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/scanners/local-scanner.d.ts

@@ -0,0 +1,9 @@
+import type { ScanOptions, ScanSummary } from '../types.js';
+/**
+ * Scan local filesystem for VAT agents and Claude Skills
+ *
+ * @param options - Scan options
+ * @returns Scan summary with all discovered files
+ */
+export declare function scan(options: ScanOptions): Promise<ScanSummary>;
+//# sourceMappingURL=local-scanner.d.ts.map

package/dist/scanners/local-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-scanner.d.ts","sourceRoot":"","sources":["../../src/scanners/local-scanner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAc,WAAW,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAsFrE"}

package/dist/scanners/local-scanner.js

@@ -0,0 +1,87 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { crawlDirectory, isGitIgnored } from '@vibe-agent-toolkit/utils';
+import { detectFormat } from '../detectors/format-detector.js';
+import { createPatternFilter } from '../filters/pattern-filter.js';
+/**
+ * Scan local filesystem for VAT agents and Claude Skills
+ *
+ * @param options - Scan options
+ * @returns Scan summary with all discovered files
+ */
+export async function scan(options) {
+    const { path: targetPath, recursive = false, include, exclude } = options;
+    // Resolve to absolute path
+    const absolutePath = path.resolve(targetPath);
+    // Check if target exists
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolutePath is validated user input
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`Path does not exist: ${absolutePath}`);
+    }
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolutePath validated above
+    const stat = fs.statSync(absolutePath);
+    // Determine scan root for relative paths
+    const scanRoot = stat.isDirectory() ? absolutePath : path.dirname(absolutePath);
+    // Get file list
+    let filePaths;
+    if (stat.isFile()) {
+        filePaths = [absolutePath];
+    }
+    else if (stat.isDirectory()) {
+        if (recursive) {
+            filePaths = await crawlDirectory({
+                baseDir: absolutePath,
+                respectGitignore: false, // We handle gitignore separately
+                exclude: [], // Don't exclude anything - we handle filtering ourselves
+            });
+        }
+        else {
+            // Non-recursive: only immediate children
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolutePath validated above
+            filePaths = fs.readdirSync(absolutePath)
+                .map(name => path.join(absolutePath, name))
+                // eslint-disable-next-line security/detect-non-literal-fs-filename -- paths are from validated directory
+                .filter(p => fs.statSync(p).isFile());
+        }
+    }
+    else {
+        throw new Error(`Path is neither file nor directory: ${absolutePath}`);
+    }
+    // Create pattern filter
+    const patternFilter = createPatternFilter({
+        ...(include && { include }),
+        ...(exclude && { exclude }),
+    });
+    // Process each file
+    const results = [];
+    for (const filePath of filePaths) {
+        const relativePath = path.relative(scanRoot, filePath);
+        // Apply pattern filter
+        if (!patternFilter(relativePath)) {
+            continue;
+        }
+        const format = detectFormat(filePath);
+        const gitIgnored = isGitIgnored(filePath, scanRoot);
+        results.push({
+            path: filePath,
+            format,
+            isGitIgnored: gitIgnored,
+            relativePath,
+        });
+    }
+    // Build summary
+    const byFormat = results.reduce((acc, r) => {
+        acc[r.format] = (acc[r.format] ?? 0) + 1;
+        return acc;
+    }, {});
+    const sourceFiles = results.filter(r => !r.isGitIgnored);
+    const buildOutputs = results.filter(r => r.isGitIgnored);
+    return {
+        results,
+        totalScanned: results.length,
+        byFormat: byFormat,
+        sourceFiles,
+        buildOutputs,
+    };
+}
+//# sourceMappingURL=local-scanner.js.map

package/dist/scanners/local-scanner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Format types that discovery can detect
+ */
+export type DetectedFormat = 'claude-skill' | 'vat-agent' | 'markdown' | 'unknown';
+/**
+ * Options for scanning/discovery operations
+ */
+export interface ScanOptions {
+    /** Path to scan (file or directory) */
+    path: string;
+    /** Recursive scan (search subdirectories) */
+    recursive?: boolean;
+    /** Include patterns (glob) */
+    include?: string[];
+    /** Exclude patterns (glob) */
+    exclude?: string[];
+    /** Follow symbolic links */
+    followSymlinks?: boolean;
+}
+/**
+ * Result of scanning a single file
+ */
+export interface ScanResult {
+    /** Absolute path to file */
+    path: string;
+    /** Detected format */
+    format: DetectedFormat;
+    /** Is this file gitignored (likely build output) */
+    isGitIgnored: boolean;
+    /** Relative path from scan root */
+    relativePath: string;
+}
+/**
+ * Summary of scan operation
+ */
+export interface ScanSummary {
+    /** All discovered files */
+    results: ScanResult[];
+    /** Total files scanned */
+    totalScanned: number;
+    /** Files by format */
+    byFormat: Record<DetectedFormat, number>;
+    /** Source files (not gitignored) */
+    sourceFiles: ScanResult[];
+    /** Build outputs (gitignored) */
+    buildOutputs: ScanResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,WAAW,GACX,UAAU,GACV,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IAEvB,oDAAoD;IACpD,YAAY,EAAE,OAAO,CAAC;IAEtB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAEzC,oCAAoC;IACpC,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,iCAAiC;IACjC,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/discovery",
-  "version": "0.1.0-rc.7",
+  "version": "0.1.0-rc.9",
   "description": "Intelligent file discovery for VAT agents and Claude Skills",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,10 @@
       "default": "./dist/index.js"
     }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
@@ -18,7 +22,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@vibe-agent-toolkit/utils": "workspace:*",
+    "@vibe-agent-toolkit/utils": "0.1.0-rc.9",
     "picomatch": "^4.0.2"
   },
   "devDependencies": {

package/src/detectors/format-detector.ts

@@ -1,35 +0,0 @@
-import * as path from 'node:path';
-
-import type { DetectedFormat } from '../types.js';
-
-/**
- * Detect file format based on filename
- *
- * Detection rules:
- * - Exact match "SKILL.md" → claude-skill
- * - Exact match "agent.yaml" or "agent.yml" → vat-agent
- * - Extension ".md" → markdown
- * - Everything else → unknown
- *
- * @param filePath - Path to file (can be relative or absolute)
- * @returns Detected format
- */
-export function detectFormat(filePath: string): DetectedFormat {
-  const basename = path.basename(filePath);
-
-  // Exact matches (case-sensitive)
-  if (basename === 'SKILL.md') {
-    return 'claude-skill';
-  }
-
-  if (basename === 'agent.yaml' || basename === 'agent.yml') {
-    return 'vat-agent';
-  }
-
-  // Extension-based detection (case-insensitive)
-  if (basename.toLowerCase().endsWith('.md')) {
-    return 'markdown';
-  }
-
-  return 'unknown';
-}

package/src/filters/pattern-filter.ts

@@ -1,47 +0,0 @@
-import picomatch from 'picomatch';
-
-export interface PatternFilterOptions {
-  /** Include patterns (if specified, only matching files included) */
-  include?: string[];
-
-  /** Exclude patterns (applied after include) */
-  exclude?: string[];
-}
-
-/**
- * Create a filter function for include/exclude patterns
- *
- * Uses picomatch for fast glob matching. Exclude patterns are applied after include.
- *
- * @param options - Pattern filter options
- * @returns Filter function (returns true if file should be included)
- */
-export function createPatternFilter(
-  options: PatternFilterOptions
-): (filePath: string) => boolean {
-  const { include, exclude } = options;
-
-  // Compile patterns once for performance
-  // Use { contains: true } to match paths containing patterns (e.g., 'node_modules' matches 'path/node_modules/file')
-  const includeMatcher = include?.length
-    ? picomatch(include, { contains: true })
-    : null;
-
-  const excludeMatcher = exclude?.length
-    ? picomatch(exclude, { contains: true })
-    : null;
-
-  return (filePath: string): boolean => {
-    // If include patterns specified, file must match at least one
-    if (includeMatcher && !includeMatcher(filePath)) {
-      return false;
-    }
-
-    // If exclude patterns specified, file must not match any
-    if (excludeMatcher?.(filePath)) {
-      return false;
-    }
-
-    return true;
-  };
-}

package/src/scanners/local-scanner.ts

@@ -1,102 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-
-import { crawlDirectory , isGitIgnored } from '@vibe-agent-toolkit/utils';
-
-import { detectFormat } from '../detectors/format-detector.js';
-import { createPatternFilter } from '../filters/pattern-filter.js';
-import type { ScanOptions, ScanResult, ScanSummary } from '../types.js';
-
-/**
- * Scan local filesystem for VAT agents and Claude Skills
- *
- * @param options - Scan options
- * @returns Scan summary with all discovered files
- */
-export async function scan(options: ScanOptions): Promise<ScanSummary> {
-  const { path: targetPath, recursive = false, include, exclude } = options;
-
-  // Resolve to absolute path
-  const absolutePath = path.resolve(targetPath);
-
-  // Check if target exists
-  // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolutePath is validated user input
-  if (!fs.existsSync(absolutePath)) {
-    throw new Error(`Path does not exist: ${absolutePath}`);
-  }
-
-  // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolutePath validated above
-  const stat = fs.statSync(absolutePath);
-
-  // Determine scan root for relative paths
-  const scanRoot = stat.isDirectory() ? absolutePath : path.dirname(absolutePath);
-
-  // Get file list
-  let filePaths: string[];
-
-  if (stat.isFile()) {
-    filePaths = [absolutePath];
-  } else if (stat.isDirectory()) {
-    if (recursive) {
-      filePaths = await crawlDirectory({
-        baseDir: absolutePath,
-        respectGitignore: false, // We handle gitignore separately
-        exclude: [], // Don't exclude anything - we handle filtering ourselves
-      });
-    } else {
-      // Non-recursive: only immediate children
-      // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolutePath validated above
-      filePaths = fs.readdirSync(absolutePath)
-        .map(name => path.join(absolutePath, name))
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- paths are from validated directory
-        .filter(p => fs.statSync(p).isFile());
-    }
-  } else {
-    throw new Error(`Path is neither file nor directory: ${absolutePath}`);
-  }
-
-  // Create pattern filter
-  const patternFilter = createPatternFilter({
-    ...(include && { include }),
-    ...(exclude && { exclude }),
-  });
-
-  // Process each file
-  const results: ScanResult[] = [];
-
-  for (const filePath of filePaths) {
-    const relativePath = path.relative(scanRoot, filePath);
-
-    // Apply pattern filter
-    if (!patternFilter(relativePath)) {
-      continue;
-    }
-
-    const format = detectFormat(filePath);
-    const gitIgnored = isGitIgnored(filePath, scanRoot);
-
-    results.push({
-      path: filePath,
-      format,
-      isGitIgnored: gitIgnored,
-      relativePath,
-    });
-  }
-
-  // Build summary
-  const byFormat = results.reduce((acc, r) => {
-    acc[r.format] = (acc[r.format] ?? 0) + 1;
-    return acc;
-  }, {} as Record<string, number>);
-
-  const sourceFiles = results.filter(r => !r.isGitIgnored);
-  const buildOutputs = results.filter(r => r.isGitIgnored);
-
-  return {
-    results,
-    totalScanned: results.length,
-    byFormat: byFormat as ScanSummary['byFormat'],
-    sourceFiles,
-    buildOutputs,
-  };
-}

package/src/types.ts

@@ -1,65 +0,0 @@
-/**
- * Format types that discovery can detect
- */
-export type DetectedFormat =
-  | 'claude-skill'    // SKILL.md
-  | 'vat-agent'       // agent.yaml
-  | 'markdown'        // *.md (resource file)
-  | 'unknown';        // Other files
-
-/**
- * Options for scanning/discovery operations
- */
-export interface ScanOptions {
-  /** Path to scan (file or directory) */
-  path: string;
-
-  /** Recursive scan (search subdirectories) */
-  recursive?: boolean;
-
-  /** Include patterns (glob) */
-  include?: string[];
-
-  /** Exclude patterns (glob) */
-  exclude?: string[];
-
-  /** Follow symbolic links */
-  followSymlinks?: boolean;
-}
-
-/**
- * Result of scanning a single file
- */
-export interface ScanResult {
-  /** Absolute path to file */
-  path: string;
-
-  /** Detected format */
-  format: DetectedFormat;
-
-  /** Is this file gitignored (likely build output) */
-  isGitIgnored: boolean;
-
-  /** Relative path from scan root */
-  relativePath: string;
-}
-
-/**
- * Summary of scan operation
- */
-export interface ScanSummary {
-  /** All discovered files */
-  results: ScanResult[];
-
-  /** Total files scanned */
-  totalScanned: number;
-
-  /** Files by format */
-  byFormat: Record<DetectedFormat, number>;
-
-  /** Source files (not gitignored) */
-  sourceFiles: ScanResult[];
-
-  /** Build outputs (gitignored) */
-  buildOutputs: ScanResult[];
-}

package/test/format-detector.test.ts

@@ -1,45 +0,0 @@
-import { describe, it, expect } from 'vitest';
-
-import { detectFormat } from '../src/detectors/format-detector.js';
-
-const CLAUDE_SKILL_FORMAT = 'claude-skill';
-
-describe('detectFormat', () => {
-  it('should detect SKILL.md as claude-skill', () => {
-    expect(detectFormat('SKILL.md')).toBe(CLAUDE_SKILL_FORMAT);
-    expect(detectFormat('/path/to/SKILL.md')).toBe(CLAUDE_SKILL_FORMAT);
-    expect(detectFormat('./my-skill/SKILL.md')).toBe(CLAUDE_SKILL_FORMAT);
-  });
-
-  it('should detect agent.yaml as vat-agent', () => {
-    expect(detectFormat('agent.yaml')).toBe('vat-agent');
-    expect(detectFormat('/path/to/agent.yaml')).toBe('vat-agent');
-  });
-
-  it('should detect agent.yml as vat-agent', () => {
-    expect(detectFormat('agent.yml')).toBe('vat-agent');
-  });
-
-  it('should detect .md files as markdown', () => {
-    expect(detectFormat('README.md')).toBe('markdown');
-    expect(detectFormat('docs/guide.md')).toBe('markdown');
-    expect(detectFormat('reference/api.md')).toBe('markdown');
-  });
-
-  it('should not detect SKILL.md as markdown', () => {
-    expect(detectFormat('SKILL.md')).not.toBe('markdown');
-    expect(detectFormat('SKILL.md')).toBe(CLAUDE_SKILL_FORMAT);
-  });
-
-  it('should return unknown for other files', () => {
-    expect(detectFormat('package.json')).toBe('unknown');
-    expect(detectFormat('index.ts')).toBe('unknown');
-    expect(detectFormat('test.txt')).toBe('unknown');
-  });
-
-  it('should be case-sensitive for SKILL.md', () => {
-    expect(detectFormat('skill.md')).toBe('markdown');
-    expect(detectFormat('Skill.md')).toBe('markdown');
-    expect(detectFormat('SKILL.MD')).toBe('markdown');
-  });
-});

package/test/local-scanner.test.ts

@@ -1,109 +0,0 @@
-/* eslint-disable security/detect-non-literal-fs-filename -- test file uses controlled temp directory */
-import { spawnSync } from 'node:child_process';
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-
-import { scan } from '../src/scanners/local-scanner.js';
-
-describe('scan', () => {
-  let tempDir: string;
-
-  beforeEach(() => {
-    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'discovery-test-'));
-  });
-
-  afterEach(() => {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  });
-
-  it('should scan single SKILL.md file', async () => {
-    const skillPath = path.join(tempDir, 'SKILL.md');
-    fs.writeFileSync(skillPath, '# Test Skill');
-
-    const result = await scan({ path: skillPath });
-
-    expect(result.totalScanned).toBe(1);
-    expect(result.results).toHaveLength(1);
-    expect(result.results[0]?.format).toBe('claude-skill');
-    expect(result.results[0]?.path).toBe(skillPath);
-  });
-
-  it('should scan directory non-recursively', async () => {
-    fs.writeFileSync(path.join(tempDir, 'SKILL.md'), '# Skill');
-    fs.writeFileSync(path.join(tempDir, 'README.md'), '# Readme');
-    fs.mkdirSync(path.join(tempDir, 'sub'));
-    fs.writeFileSync(path.join(tempDir, 'sub', 'agent.yaml'), 'name: test');
-
-    const result = await scan({ path: tempDir, recursive: false });
-
-    expect(result.totalScanned).toBe(2);
-    expect(result.byFormat['claude-skill']).toBe(1);
-    expect(result.byFormat['markdown']).toBe(1);
-  });
-
-  it('should scan directory recursively', async () => {
-    fs.writeFileSync(path.join(tempDir, 'SKILL.md'), '# Skill');
-    fs.mkdirSync(path.join(tempDir, 'sub'));
-    fs.writeFileSync(path.join(tempDir, 'sub', 'agent.yaml'), 'name: test');
-
-    const result = await scan({ path: tempDir, recursive: true });
-
-    expect(result.totalScanned).toBe(2);
-    expect(result.byFormat['claude-skill']).toBe(1);
-    expect(result.byFormat['vat-agent']).toBe(1);
-  });
-
-  it('should respect include patterns', async () => {
-    fs.writeFileSync(path.join(tempDir, 'test.md'), '# Test');
-    fs.writeFileSync(path.join(tempDir, 'test.ts'), 'code');
-
-    const result = await scan({
-      path: tempDir,
-      include: ['*.md']
-    });
-
-    expect(result.totalScanned).toBe(1);
-    expect(result.results[0]?.format).toBe('markdown');
-  });
-
-  it('should respect exclude patterns', async () => {
-    fs.mkdirSync(path.join(tempDir, 'node_modules'));
-    fs.writeFileSync(path.join(tempDir, 'README.md'), '# Readme');
-    fs.writeFileSync(path.join(tempDir, 'node_modules', 'pkg.md'), '# Pkg');
-
-    const result = await scan({
-      path: tempDir,
-      recursive: true,
-      exclude: ['**/node_modules/**']
-    });
-
-    expect(result.totalScanned).toBe(1);
-    expect(result.results[0]?.relativePath).toBe('README.md');
-  });
-
-  it('should detect gitignored files', async () => {
-    // Initialize git repo for git check-ignore to work
-    const gitPath = 'git';
-    // eslint-disable-next-line sonarjs/no-os-command-from-path -- test setup uses git from PATH
-    spawnSync(gitPath, ['init'], { cwd: tempDir, stdio: 'pipe' });
-    // eslint-disable-next-line sonarjs/no-os-command-from-path -- test setup uses git from PATH
-    spawnSync(gitPath, ['config', 'user.email', 'test@example.com'], { cwd: tempDir, stdio: 'pipe' });
-    // eslint-disable-next-line sonarjs/no-os-command-from-path -- test setup uses git from PATH
-    spawnSync(gitPath, ['config', 'user.name', 'Test User'], { cwd: tempDir, stdio: 'pipe' });
-
-    fs.writeFileSync(path.join(tempDir, '.gitignore'), 'dist/\n');
-    fs.mkdirSync(path.join(tempDir, 'dist'));
-    fs.writeFileSync(path.join(tempDir, 'dist', 'SKILL.md'), '# Built');
-    fs.writeFileSync(path.join(tempDir, 'SKILL.md'), '# Source');
-
-    const result = await scan({ path: tempDir, recursive: true });
-
-    expect(result.totalScanned).toBe(2);
-    expect(result.sourceFiles).toHaveLength(1);
-    expect(result.buildOutputs).toHaveLength(1);
-    expect(result.sourceFiles[0]?.relativePath).toBe('SKILL.md');
-  });
-});

package/test/pattern-filter.test.ts

@@ -1,74 +0,0 @@
-import { describe, it, expect } from 'vitest';
-
-import { createPatternFilter } from '../src/filters/pattern-filter.js';
-
-describe('createPatternFilter', () => {
-  describe('include patterns', () => {
-    it('should include files matching pattern', () => {
-      const filter = createPatternFilter({ include: ['*.md'] });
-
-      expect(filter('test.md')).toBe(true);
-      expect(filter('docs/guide.md')).toBe(true);
-      expect(filter('test.ts')).toBe(false);
-    });
-
-    it('should support glob patterns', () => {
-      const filter = createPatternFilter({ include: ['**/*.test.ts'] });
-
-      expect(filter('src/utils.test.ts')).toBe(true);
-      expect(filter('test/unit/parser.test.ts')).toBe(true);
-      expect(filter('src/utils.ts')).toBe(false);
-    });
-
-    it('should support multiple include patterns', () => {
-      const filter = createPatternFilter({
-        include: ['*.md', '*.yaml']
-      });
-
-      expect(filter('README.md')).toBe(true);
-      expect(filter('config.yaml')).toBe(true);
-      expect(filter('index.ts')).toBe(false);
-    });
-  });
-
-  describe('exclude patterns', () => {
-    it('should exclude files matching pattern', () => {
-      const filter = createPatternFilter({ exclude: ['node_modules'] });
-
-      expect(filter('node_modules/pkg/index.js')).toBe(false);
-      expect(filter('src/index.ts')).toBe(true);
-    });
-
-    it('should support glob patterns', () => {
-      const filter = createPatternFilter({
-        exclude: ['**/dist/**', '**/*.test.ts']
-      });
-
-      expect(filter('packages/cli/dist/index.js')).toBe(false);
-      expect(filter('src/utils.test.ts')).toBe(false);
-      expect(filter('src/utils.ts')).toBe(true);
-    });
-  });
-
-  describe('include + exclude patterns', () => {
-    it('should apply exclude after include', () => {
-      const filter = createPatternFilter({
-        include: ['**/*.md'],
-        exclude: ['**/node_modules/**'],
-      });
-
-      expect(filter('README.md')).toBe(true);
-      expect(filter('docs/guide.md')).toBe(true);
-      expect(filter('node_modules/pkg/README.md')).toBe(false);
-    });
-  });
-
-  describe('no patterns', () => {
-    it('should include all files when no patterns specified', () => {
-      const filter = createPatternFilter({});
-
-      expect(filter('any-file.txt')).toBe(true);
-      expect(filter('path/to/file.js')).toBe(true);
-    });
-  });
-});

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "references": [
-    { "path": "../utils" }
-  ]
-}