busy-cli 0.2.0 → 0.2.1

package/dist/cli/index.js

@@ -310,14 +310,15 @@ const packageCmd = program
 // Package add
 packageCmd
     .command('add')
-    .description('Add a package from URL')
-    .argument('<url>', 'URL to the BUSY document')
+    .description('Add a package from URL or local folder')
+    .argument('<url>', 'URL or local path to the BUSY document or folder')
     .option('-d, --dir <directory>', 'Workspace directory', '.')
+    .option('-r, --recursive', 'Recursively add all files from a local folder')
     .action(async (url, options) => {
     try {
         const workspaceRoot = resolve(options.dir);
         console.log(`\nAdding package from: ${url}\n`);
-        const result = await addPackage(workspaceRoot, url);
+        const result = await addPackage(workspaceRoot, url, { recursive: options.recursive });
         console.log(`  ID:       ${result.id}`);
         console.log(`  Provider: ${result.provider}`);
         console.log(`  Version:  ${result.version}`);

package/dist/commands/package.d.ts

@@ -71,12 +71,15 @@ export declare function checkWorkspace(workspaceRoot: string, options?: {
     skipExternal?: boolean;
 }): Promise<CheckResult>;
 /**
- * Add a package from URL
+ * Add a package from URL or local folder
  *
  * If the URL points to a package.busy.md manifest, fetches the entire package.
+ * If it's a local directory with --recursive (or without a manifest), copies all files.
  * Otherwise, fetches a single file.
  */
-export declare function addPackage(workspaceRoot: string, url: string): Promise<AddResult>;
+export declare function addPackage(workspaceRoot: string, url: string, options?: {
+    recursive?: boolean;
+}): Promise<AddResult>;
 /**
  * Remove a package
  */

package/dist/commands/package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/commands/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAmB,YAAY,EAAiC,MAAM,sBAAsB,CAAC;AAKpG,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,wBAAwB,CAAC;AAChC,OAAO,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC9E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CA8CtH;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAoFvF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwBnG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM3G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4ErG"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/commands/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAmB,YAAY,EAAiC,MAAM,sBAAsB,CAAC;AAKpG,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,wBAAwB,CAAC;AAChC,OAAO,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC9E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CA8CtH;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAgH1H;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwBnG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM3G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4ErG"}

package/dist/commands/package.js

@@ -8,7 +8,7 @@ import * as path from 'node:path';
 import { CacheManager, deriveCachePath } from '../cache/index.js';
 import { PackageRegistry, deriveEntryId, deriveCategory } from '../registry/index.js';
 import { providerRegistry } from '../providers/index.js';
-import { isPackageManifestUrl, fetchPackageFromManifest } from '../package/manifest.js';
+import { isPackageManifestUrl, fetchPackageFromManifest, fetchPackageFromLocalFolder } from '../package/manifest.js';
 // Ensure providers are registered
 import '../providers/local.js';
 import '../providers/github.js';
@@ -94,12 +94,40 @@ export async function checkWorkspace(workspaceRoot, options) {
     };
 }
 /**
- * Add a package from URL
+ * Add a package from URL or local folder
  *
  * If the URL points to a package.busy.md manifest, fetches the entire package.
+ * If it's a local directory with --recursive (or without a manifest), copies all files.
  * Otherwise, fetches a single file.
  */
-export async function addPackage(workspaceRoot, url) {
+export async function addPackage(workspaceRoot, url, options) {
+    // Check if this is a local directory that should use folder-based discovery
+    if (url.startsWith('./') || url.startsWith('../') || url.startsWith('/') || (!url.includes('://') && !url.startsWith('http'))) {
+        const resolvedPath = path.isAbsolute(url) ? url : path.resolve(process.cwd(), url);
+        try {
+            const stat = await fs.stat(resolvedPath);
+            if (stat.isDirectory()) {
+                const manifestExists = await fs.stat(path.join(resolvedPath, 'package.busy.md'))
+                    .then(() => true).catch(() => false);
+                if (options?.recursive || !manifestExists) {
+                    // Use folder-based discovery: --recursive flag or no manifest available
+                    const result = await fetchPackageFromLocalFolder(workspaceRoot, resolvedPath);
+                    return {
+                        id: result.name,
+                        source: resolvedPath,
+                        provider: 'local',
+                        cached: result.cached,
+                        version: result.version,
+                        integrity: result.integrity,
+                    };
+                }
+                // Has manifest and not --recursive: fall through to manifest-based flow
+            }
+        }
+        catch {
+            // Not a directory or doesn't exist - fall through to normal handling
+        }
+    }
     // Check if this is a package manifest URL
     if (isPackageManifestUrl(url)) {
         // Use manifest-based package installation

package/dist/package/manifest.d.ts

@@ -56,4 +56,16 @@ export declare function parsePackageManifest(content: string): PackageManifest;
  * Fetch a package from its manifest URL or local path
  */
 export declare function fetchPackageFromManifest(workspaceRoot: string, manifestUrl: string): Promise<FetchPackageResult>;
+/**
+ * Recursively discover all files in a directory.
+ * Skips hidden directories (e.g. .git, .libraries) and node_modules.
+ */
+export declare function discoverFiles(dirPath: string): Promise<string[]>;
+/**
+ * Fetch a package from a local folder, copying all files.
+ *
+ * If a package.busy.md exists, its metadata (name, version, description) is used.
+ * Otherwise, metadata is derived from the folder name.
+ */
+export declare function fetchPackageFromLocalFolder(workspaceRoot: string, folderPath: string): Promise<FetchPackageResult>;
 //# sourceMappingURL=manifest.d.ts.map

package/dist/package/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/package/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,wBAAwB,CAAC;AAChC,OAAO,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAazD;AAyBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAiHrE;AAkBD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA4G7B"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/package/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,wBAAwB,CAAC;AAChC,OAAO,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAazD;AAyBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAiHrE;AAkBD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA4G7B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBtE;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAqG7B"}

package/dist/package/manifest.js

@@ -262,4 +262,122 @@ export async function fetchPackageFromManifest(workspaceRoot, manifestUrl) {
         integrity,
     };
 }
+/**
+ * Recursively discover all files in a directory.
+ * Skips hidden directories (e.g. .git, .libraries) and node_modules.
+ */
+export async function discoverFiles(dirPath) {
+    const results = [];
+    async function walk(dir) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                results.push(fullPath);
+            }
+        }
+    }
+    await walk(dirPath);
+    return results;
+}
+/**
+ * Fetch a package from a local folder, copying all files.
+ *
+ * If a package.busy.md exists, its metadata (name, version, description) is used.
+ * Otherwise, metadata is derived from the folder name.
+ */
+export async function fetchPackageFromLocalFolder(workspaceRoot, folderPath) {
+    const absolutePath = path.isAbsolute(folderPath)
+        ? folderPath
+        : path.resolve(process.cwd(), folderPath);
+    // Verify it's a directory
+    const stat = await fs.stat(absolutePath);
+    if (!stat.isDirectory()) {
+        throw new Error(`Not a directory: ${absolutePath}`);
+    }
+    // Try to read manifest for metadata
+    const manifestPath = path.join(absolutePath, 'package.busy.md');
+    let manifest = null;
+    let manifestContent = null;
+    try {
+        manifestContent = await fs.readFile(manifestPath, 'utf-8');
+        manifest = parsePackageManifest(manifestContent);
+    }
+    catch {
+        // No manifest - that's fine
+    }
+    const packageName = manifest?.name || path.basename(absolutePath);
+    // Discover all files in the folder
+    const discoveredFiles = await discoverFiles(absolutePath);
+    // Filter out package.busy.md itself (handled separately)
+    const filesToCopy = discoveredFiles
+        .filter(f => path.basename(f) !== 'package.busy.md')
+        .map(f => ({
+        relativePath: path.relative(absolutePath, f),
+        absolutePath: f,
+    }));
+    // Initialize cache
+    const cache = new CacheManager(workspaceRoot);
+    await cache.init();
+    // Copy files
+    let combinedContent = '';
+    const documents = [];
+    for (const file of filesToCopy) {
+        try {
+            const content = await fs.readFile(file.absolutePath, 'utf-8');
+            combinedContent += content;
+            const cachePath = path.join(packageName, file.relativePath);
+            await cache.save(cachePath, content);
+            documents.push({
+                name: path.basename(file.relativePath, path.extname(file.relativePath)),
+                relativePath: './' + file.relativePath,
+            });
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to read ${file.absolutePath}: ${error}`);
+        }
+    }
+    // Save manifest if it exists
+    if (manifestContent) {
+        await cache.save(path.join(packageName, 'package.busy.md'), manifestContent);
+    }
+    // Calculate integrity
+    const integrity = calculateIntegrity(combinedContent);
+    // Add to registry
+    const registry = new PackageRegistry(workspaceRoot);
+    try {
+        await registry.load();
+    }
+    catch {
+        await registry.init();
+        await registry.load();
+    }
+    const entry = {
+        id: packageName,
+        description: manifest?.description || '',
+        source: absolutePath,
+        provider: 'local',
+        cached: `.libraries/${packageName}`,
+        version: manifest?.version || 'latest',
+        fetched: new Date().toISOString(),
+        integrity,
+        category: 'Packages',
+    };
+    registry.addPackage(entry);
+    await registry.save();
+    return {
+        name: packageName,
+        version: manifest?.version || 'latest',
+        description: manifest?.description || '',
+        documents,
+        cached: `.libraries/${packageName}`,
+        integrity,
+    };
+}
 //# sourceMappingURL=manifest.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busy-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI for BUSY document framework - parse, validate, and manage BUSY workspaces",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli/index.ts

@@ -352,16 +352,17 @@ const packageCmd = program
 // Package add
 packageCmd
   .command('add')
-  .description('Add a package from URL')
-  .argument('<url>', 'URL to the BUSY document')
+  .description('Add a package from URL or local folder')
+  .argument('<url>', 'URL or local path to the BUSY document or folder')
   .option('-d, --dir <directory>', 'Workspace directory', '.')
+  .option('-r, --recursive', 'Recursively add all files from a local folder')
   .action(async (url: string, options) => {
     try {
       const workspaceRoot = resolve(options.dir);
 
       console.log(`\nAdding package from: ${url}\n`);
 
-      const result = await addPackage(workspaceRoot, url);
+      const result = await addPackage(workspaceRoot, url, { recursive: options.recursive });
 
       console.log(`  ID:       ${result.id}`);
       console.log(`  Provider: ${result.provider}`);

package/src/commands/package.ts

@@ -9,7 +9,7 @@ import * as path from 'node:path';
 import { CacheManager, calculateIntegrity, deriveCachePath } from '../cache/index.js';
 import { PackageRegistry, PackageEntry, deriveEntryId, deriveCategory } from '../registry/index.js';
 import { providerRegistry } from '../providers/index.js';
-import { isPackageManifestUrl, fetchPackageFromManifest } from '../package/manifest.js';
+import { isPackageManifestUrl, fetchPackageFromManifest, fetchPackageFromLocalFolder } from '../package/manifest.js';
 
 // Ensure providers are registered
 import '../providers/local.js';
@@ -166,12 +166,41 @@ export async function checkWorkspace(workspaceRoot: string, options?: { skipExte
 }
 
 /**
- * Add a package from URL
+ * Add a package from URL or local folder
  *
  * If the URL points to a package.busy.md manifest, fetches the entire package.
+ * If it's a local directory with --recursive (or without a manifest), copies all files.
  * Otherwise, fetches a single file.
  */
-export async function addPackage(workspaceRoot: string, url: string): Promise<AddResult> {
+export async function addPackage(workspaceRoot: string, url: string, options?: { recursive?: boolean }): Promise<AddResult> {
+  // Check if this is a local directory that should use folder-based discovery
+  if (url.startsWith('./') || url.startsWith('../') || url.startsWith('/') || (!url.includes('://') && !url.startsWith('http'))) {
+    const resolvedPath = path.isAbsolute(url) ? url : path.resolve(process.cwd(), url);
+    try {
+      const stat = await fs.stat(resolvedPath);
+      if (stat.isDirectory()) {
+        const manifestExists = await fs.stat(path.join(resolvedPath, 'package.busy.md'))
+          .then(() => true).catch(() => false);
+
+        if (options?.recursive || !manifestExists) {
+          // Use folder-based discovery: --recursive flag or no manifest available
+          const result = await fetchPackageFromLocalFolder(workspaceRoot, resolvedPath);
+          return {
+            id: result.name,
+            source: resolvedPath,
+            provider: 'local',
+            cached: result.cached,
+            version: result.version,
+            integrity: result.integrity,
+          };
+        }
+        // Has manifest and not --recursive: fall through to manifest-based flow
+      }
+    } catch {
+      // Not a directory or doesn't exist - fall through to normal handling
+    }
+  }
+
   // Check if this is a package manifest URL
   if (isPackageManifestUrl(url)) {
     // Use manifest-based package installation

package/src/package/manifest.ts

@@ -347,3 +347,141 @@ export async function fetchPackageFromManifest(
     integrity,
   };
 }
+
+/**
+ * Recursively discover all files in a directory.
+ * Skips hidden directories (e.g. .git, .libraries) and node_modules.
+ */
+export async function discoverFiles(dirPath: string): Promise<string[]> {
+  const results: string[] = [];
+
+  async function walk(dir: string) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+        continue;
+      }
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walk(fullPath);
+      } else if (entry.isFile()) {
+        results.push(fullPath);
+      }
+    }
+  }
+
+  await walk(dirPath);
+  return results;
+}
+
+/**
+ * Fetch a package from a local folder, copying all files.
+ *
+ * If a package.busy.md exists, its metadata (name, version, description) is used.
+ * Otherwise, metadata is derived from the folder name.
+ */
+export async function fetchPackageFromLocalFolder(
+  workspaceRoot: string,
+  folderPath: string,
+): Promise<FetchPackageResult> {
+  const absolutePath = path.isAbsolute(folderPath)
+    ? folderPath
+    : path.resolve(process.cwd(), folderPath);
+
+  // Verify it's a directory
+  const stat = await fs.stat(absolutePath);
+  if (!stat.isDirectory()) {
+    throw new Error(`Not a directory: ${absolutePath}`);
+  }
+
+  // Try to read manifest for metadata
+  const manifestPath = path.join(absolutePath, 'package.busy.md');
+  let manifest: PackageManifest | null = null;
+  let manifestContent: string | null = null;
+
+  try {
+    manifestContent = await fs.readFile(manifestPath, 'utf-8');
+    manifest = parsePackageManifest(manifestContent);
+  } catch {
+    // No manifest - that's fine
+  }
+
+  const packageName = manifest?.name || path.basename(absolutePath);
+
+  // Discover all files in the folder
+  const discoveredFiles = await discoverFiles(absolutePath);
+
+  // Filter out package.busy.md itself (handled separately)
+  const filesToCopy = discoveredFiles
+    .filter(f => path.basename(f) !== 'package.busy.md')
+    .map(f => ({
+      relativePath: path.relative(absolutePath, f),
+      absolutePath: f,
+    }));
+
+  // Initialize cache
+  const cache = new CacheManager(workspaceRoot);
+  await cache.init();
+
+  // Copy files
+  let combinedContent = '';
+  const documents: PackageDocument[] = [];
+
+  for (const file of filesToCopy) {
+    try {
+      const content = await fs.readFile(file.absolutePath, 'utf-8');
+      combinedContent += content;
+
+      const cachePath = path.join(packageName, file.relativePath);
+      await cache.save(cachePath, content);
+
+      documents.push({
+        name: path.basename(file.relativePath, path.extname(file.relativePath)),
+        relativePath: './' + file.relativePath,
+      });
+    } catch (error) {
+      console.warn(`Warning: Failed to read ${file.absolutePath}: ${error}`);
+    }
+  }
+
+  // Save manifest if it exists
+  if (manifestContent) {
+    await cache.save(path.join(packageName, 'package.busy.md'), manifestContent);
+  }
+
+  // Calculate integrity
+  const integrity = calculateIntegrity(combinedContent);
+
+  // Add to registry
+  const registry = new PackageRegistry(workspaceRoot);
+  try {
+    await registry.load();
+  } catch {
+    await registry.init();
+    await registry.load();
+  }
+
+  const entry: PackageEntry = {
+    id: packageName,
+    description: manifest?.description || '',
+    source: absolutePath,
+    provider: 'local',
+    cached: `.libraries/${packageName}`,
+    version: manifest?.version || 'latest',
+    fetched: new Date().toISOString(),
+    integrity,
+    category: 'Packages',
+  };
+
+  registry.addPackage(entry);
+  await registry.save();
+
+  return {
+    name: packageName,
+    version: manifest?.version || 'latest',
+    description: manifest?.description || '',
+    documents,
+    cached: `.libraries/${packageName}`,
+    integrity,
+  };
+}