busy-cli 0.1.2

package/dist/providers/gitlab.js

@@ -0,0 +1,101 @@
+/**
+ * GitLab URL provider
+ *
+ * Handles URLs like:
+ * - https://gitlab.com/org/repo/-/blob/ref/path/to/file.md
+ * - https://gitlab.com/org/repo/-/tree/ref/path/to/dir
+ */
+import { providerRegistry } from './base.js';
+// Pattern for GitLab blob URLs
+const BLOB_PATTERN = /gitlab\.com\/([^/]+)\/([^/]+)\/-\/blob\/([^/]+)\/(.+)/;
+// Pattern for GitLab tree URLs
+const TREE_PATTERN = /gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)\/(.+)/;
+// Pattern for GitLab raw URLs
+const RAW_PATTERN = /gitlab\.com\/([^/]+)\/([^/]+)\/-\/raw\/([^/]+)\/(.+)/;
+export class GitLabProvider {
+    name = 'gitlab';
+    matches(url) {
+        // Use proper URL parsing to check the hostname
+        try {
+            const parsed = new URL(url);
+            return parsed.hostname === 'gitlab.com';
+        }
+        catch {
+            return false;
+        }
+    }
+    parse(url) {
+        // Extract anchor if present
+        const [urlWithoutAnchor, anchor] = url.split('#');
+        // Try blob pattern first
+        let match = urlWithoutAnchor.match(BLOB_PATTERN);
+        if (match) {
+            return {
+                provider: 'gitlab',
+                org: match[1],
+                repo: match[2],
+                ref: match[3],
+                path: match[4],
+                anchor,
+            };
+        }
+        // Try tree pattern
+        match = urlWithoutAnchor.match(TREE_PATTERN);
+        if (match) {
+            return {
+                provider: 'gitlab',
+                org: match[1],
+                repo: match[2],
+                ref: match[3],
+                path: match[4],
+                anchor,
+            };
+        }
+        // Try raw pattern
+        match = urlWithoutAnchor.match(RAW_PATTERN);
+        if (match) {
+            return {
+                provider: 'gitlab',
+                org: match[1],
+                repo: match[2],
+                ref: match[3],
+                path: match[4],
+                anchor,
+                rawUrl: urlWithoutAnchor,
+            };
+        }
+        throw new Error(`Cannot parse GitLab URL: ${url}`);
+    }
+    getRawUrl(parsed) {
+        if (parsed.rawUrl) {
+            return parsed.rawUrl;
+        }
+        return `https://gitlab.com/${parsed.org}/${parsed.repo}/-/raw/${parsed.ref}/${parsed.path}`;
+    }
+    async fetch(url) {
+        const parsed = this.parse(url);
+        const rawUrl = this.getRawUrl(parsed);
+        const response = await fetch(rawUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch ${rawUrl}: ${response.status} ${response.statusText}`);
+        }
+        return response.text();
+    }
+    async getLatestVersion(parsed) {
+        // GitLab API for tags
+        const apiUrl = `https://gitlab.com/api/v4/projects/${encodeURIComponent(`${parsed.org}/${parsed.repo}`)}/repository/tags`;
+        const response = await fetch(apiUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch tags from GitLab API: ${response.status}`);
+        }
+        const tags = await response.json();
+        if (tags.length === 0) {
+            throw new Error(`No tags found for ${parsed.org}/${parsed.repo}`);
+        }
+        return tags[0].name;
+    }
+}
+// Create and register the GitLab provider
+export const gitlabProvider = new GitLabProvider();
+providerRegistry.register(gitlabProvider);
+//# sourceMappingURL=gitlab.js.map

package/dist/providers/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider System Exports
+ *
+ * URL providers for fetching content from different sources.
+ * Registration order matters - specific providers (GitHub, GitLab)
+ * should be registered before the generic URL provider.
+ */
+export { Provider, ParsedURL, ProviderRegistry, providerRegistry, } from './base.js';
+export { LocalProvider, localProvider } from './local.js';
+export { GitHubProvider, githubProvider } from './github.js';
+export { GitLabProvider, gitlabProvider } from './gitlab.js';
+export { URLProvider, urlProvider } from './url.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,17 @@
+/**
+ * Provider System Exports
+ *
+ * URL providers for fetching content from different sources.
+ * Registration order matters - specific providers (GitHub, GitLab)
+ * should be registered before the generic URL provider.
+ */
+// Base types and registry
+export { ProviderRegistry, providerRegistry, } from './base.js';
+// Local file provider (registered first for priority)
+export { LocalProvider, localProvider } from './local.js';
+// Specific providers
+export { GitHubProvider, githubProvider } from './github.js';
+export { GitLabProvider, gitlabProvider } from './gitlab.js';
+// Generic URL provider (registered last as fallback)
+export { URLProvider, urlProvider } from './url.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/local.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Local File Provider
+ *
+ * Provider for local file system paths (relative or absolute).
+ * Handles both individual files and directories containing package.busy.md.
+ */
+import { Provider, ParsedURL } from './base.js';
+export declare class LocalProvider implements Provider {
+    name: string;
+    /**
+     * Working directory for resolving relative paths
+     */
+    private workingDir;
+    constructor(workingDir?: string);
+    setWorkingDir(dir: string): void;
+    matches(url: string): boolean;
+    parse(url: string): ParsedURL;
+    getRawUrl(parsed: ParsedURL): string;
+    fetch(url: string): Promise<string>;
+    /**
+     * Resolve a path to an absolute path
+     */
+    resolvePath(relativePath: string): string;
+    /**
+     * Check if a path points to a package directory (contains package.busy.md)
+     */
+    isPackageDirectory(dirPath: string): Promise<boolean>;
+    getLatestVersion(_parsed: ParsedURL): Promise<string>;
+}
+export declare const localProvider: LocalProvider;
+//# sourceMappingURL=local.d.ts.map

package/dist/providers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAC;AAElE,qBAAa,aAAc,YAAW,QAAQ;IAC5C,IAAI,SAAW;IAEf;;OAEG;IACH,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAI/B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAmB7B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAiB7B,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM;IAU9B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBzC;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAOzC;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrD,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;CAG5D;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/providers/local.js

@@ -0,0 +1,116 @@
+/**
+ * Local File Provider
+ *
+ * Provider for local file system paths (relative or absolute).
+ * Handles both individual files and directories containing package.busy.md.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { providerRegistry } from './base.js';
+export class LocalProvider {
+    name = 'local';
+    /**
+     * Working directory for resolving relative paths
+     */
+    workingDir;
+    constructor(workingDir) {
+        this.workingDir = workingDir || process.cwd();
+    }
+    setWorkingDir(dir) {
+        this.workingDir = dir;
+    }
+    matches(url) {
+        // Match relative paths (./  ../)
+        if (url.startsWith('./') || url.startsWith('../')) {
+            return true;
+        }
+        // Match absolute paths
+        if (url.startsWith('/')) {
+            return true;
+        }
+        // Match paths that look like local directories or files (no protocol)
+        if (!url.includes('://') && !url.startsWith('http')) {
+            // Check if it looks like a path (contains / or ends with .md or .busy.md)
+            if (url.includes('/') || url.endsWith('.md') || url.endsWith('.busy')) {
+                return true;
+            }
+        }
+        return false;
+    }
+    parse(url) {
+        // Extract anchor if present
+        const [pathWithoutAnchor, anchor] = url.split('#');
+        // Resolve to absolute path
+        let absolutePath = path.isAbsolute(pathWithoutAnchor)
+            ? pathWithoutAnchor
+            : path.resolve(this.workingDir, pathWithoutAnchor);
+        return {
+            provider: 'local',
+            path: absolutePath,
+            anchor,
+            rawUrl: url,
+        };
+    }
+    getRawUrl(parsed) {
+        // If path is a directory, return path to package.busy.md
+        // This is checked synchronously by checking if path ends with .md or .busy
+        const p = parsed.path;
+        if (!p.endsWith('.md') && !p.endsWith('.busy')) {
+            return path.join(p, 'package.busy.md');
+        }
+        return p;
+    }
+    async fetch(url) {
+        const parsed = this.parse(url);
+        let targetPath = parsed.path;
+        // Check if path is a directory
+        try {
+            const stat = await fs.stat(targetPath);
+            if (stat.isDirectory()) {
+                // Look for package.busy.md in the directory
+                targetPath = path.join(targetPath, 'package.busy.md');
+            }
+        }
+        catch {
+            // Path doesn't exist yet, try as-is
+        }
+        // Read the file
+        try {
+            const content = await fs.readFile(targetPath, 'utf-8');
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to read local file ${targetPath}: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    /**
+     * Resolve a path to an absolute path
+     */
+    resolvePath(relativePath) {
+        if (path.isAbsolute(relativePath)) {
+            return relativePath;
+        }
+        return path.resolve(this.workingDir, relativePath);
+    }
+    /**
+     * Check if a path points to a package directory (contains package.busy.md)
+     */
+    async isPackageDirectory(dirPath) {
+        const manifestPath = path.join(dirPath, 'package.busy.md');
+        try {
+            await fs.access(manifestPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Local files don't support version resolution
+    async getLatestVersion(_parsed) {
+        throw new Error('Local provider does not support version resolution');
+    }
+}
+// Create and register the local provider (registered first for priority)
+export const localProvider = new LocalProvider();
+providerRegistry.register(localProvider);
+//# sourceMappingURL=local.js.map

package/dist/providers/url.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic URL provider
+ *
+ * Fallback provider for direct HTTP(S) URLs that don't match specific providers.
+ */
+import { Provider, ParsedURL } from './base.js';
+export declare class URLProvider implements Provider {
+    name: string;
+    matches(url: string): boolean;
+    parse(url: string): ParsedURL;
+    getRawUrl(parsed: ParsedURL): string;
+    fetch(url: string): Promise<string>;
+    getLatestVersion(_parsed: ParsedURL): Promise<string>;
+}
+export declare const urlProvider: URLProvider;
+//# sourceMappingURL=url.d.ts.map

package/dist/providers/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/providers/url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAC;AAElE,qBAAa,WAAY,YAAW,QAAQ;IAC1C,IAAI,SAAS;IAEb,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAe7B,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM;IAI9B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAanC,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;CAG5D;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/providers/url.js

@@ -0,0 +1,45 @@
+/**
+ * Generic URL provider
+ *
+ * Fallback provider for direct HTTP(S) URLs that don't match specific providers.
+ */
+import { providerRegistry } from './base.js';
+export class URLProvider {
+    name = 'url';
+    matches(url) {
+        // Match any HTTP(S) URL as fallback
+        return url.startsWith('http://') || url.startsWith('https://');
+    }
+    parse(url) {
+        // Extract anchor if present
+        const [urlWithoutAnchor, anchor] = url.split('#');
+        // Parse URL to extract path
+        const urlObj = new URL(urlWithoutAnchor);
+        return {
+            provider: 'url',
+            path: urlObj.pathname,
+            anchor,
+            rawUrl: urlWithoutAnchor,
+        };
+    }
+    getRawUrl(parsed) {
+        return parsed.rawUrl || parsed.path;
+    }
+    async fetch(url) {
+        const parsed = this.parse(url);
+        const fetchUrl = parsed.rawUrl || url;
+        const response = await fetch(fetchUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch ${fetchUrl}: ${response.status} ${response.statusText}`);
+        }
+        return response.text();
+    }
+    // Generic URLs don't support version resolution
+    async getLatestVersion(_parsed) {
+        throw new Error('Generic URL provider does not support version resolution');
+    }
+}
+// Create and register the URL provider (registered last as fallback)
+export const urlProvider = new URLProvider();
+providerRegistry.register(urlProvider);
+//# sourceMappingURL=url.js.map

package/dist/registry/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Package Registry for package.busy.md
+ *
+ * Parses and manages the package registry file.
+ */
+/**
+ * Package entry in the registry
+ */
+export interface PackageEntry {
+    id: string;
+    description: string;
+    source: string;
+    provider: string;
+    cached: string;
+    version: string;
+    fetched: string;
+    integrity?: string;
+    category: string;
+}
+/**
+ * Registry metadata from frontmatter
+ */
+export interface RegistryMetadata {
+    name: string;
+    type: string;
+    description: string;
+}
+/**
+ * Parsed package registry
+ */
+export interface ParsedRegistry {
+    metadata: RegistryMetadata;
+    packages: PackageEntry[];
+}
+/**
+ * Derive entry ID from URL
+ *
+ * If URL has #anchor, use anchor as ID
+ * Else, use filename without extension
+ * Slugify result (lowercase, hyphens)
+ */
+export declare function deriveEntryId(url: string): string;
+/**
+ * Derive category from URL path
+ */
+export declare function deriveCategory(url: string): string;
+/**
+ * Parse package.busy.md content
+ */
+export declare function parsePackageRegistry(content: string): ParsedRegistry;
+/**
+ * Package Registry Manager
+ *
+ * Manages the package.busy.md file in a workspace.
+ */
+export declare class PackageRegistry {
+    private workspaceRoot;
+    private registryPath;
+    private metadata;
+    private packages;
+    constructor(workspaceRoot: string);
+    /**
+     * Initialize a new package.busy.md if it doesn't exist
+     */
+    init(): Promise<void>;
+    /**
+     * Load existing package.busy.md
+     */
+    load(): Promise<void>;
+    /**
+     * Save changes to package.busy.md
+     */
+    save(): Promise<void>;
+    /**
+     * Get all packages
+     */
+    getPackages(): PackageEntry[];
+    /**
+     * Get package by ID
+     */
+    getPackage(id: string): PackageEntry | undefined;
+    /**
+     * Add or update a package
+     */
+    addPackage(entry: PackageEntry): void;
+    /**
+     * Remove a package by ID
+     */
+    removePackage(id: string): boolean;
+    /**
+     * Get packages by category
+     */
+    getPackagesByCategory(category: string): PackageEntry[];
+    /**
+     * Get all unique categories
+     */
+    getCategories(): string[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAclD;AAuCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA0FpE;AA+FD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAA4B;gBAEhC,aAAa,EAAE,MAAM;IAWjC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIrC;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE;IAIvD;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;CAO1B"}