craftdesk 0.1.0 → 0.3.0

package/dist/types/craftdesk-lock.d.ts

@@ -0,0 +1,34 @@
+export interface CraftDeskLock {
+    version: string;
+    lockfileVersion: number;
+    generatedAt: string;
+    crafts: Record<string, LockEntry>;
+    tree?: DependencyTree;
+    metadata?: {
+        totalCrafts: number;
+        totalSize: string;
+        installPath: string;
+    };
+}
+export interface LockEntry {
+    version: string;
+    resolved: string;
+    integrity: string;
+    type: 'skill' | 'agent' | 'command' | 'hook' | 'plugin';
+    author?: string;
+    registry?: string;
+    scope?: string;
+    dependencies?: Record<string, string>;
+    git?: string;
+    branch?: string;
+    tag?: string;
+    commit?: string;
+    path?: string;
+    file?: string;
+}
+export interface DependencyTree {
+    [key: string]: {
+        dependencies?: DependencyTree;
+    } | string;
+}
+//# sourceMappingURL=craftdesk-lock.d.ts.map

package/dist/types/craftdesk-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craftdesk-lock.d.ts","sourceRoot":"","sources":["../../src/types/craftdesk-lock.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,YAAY,CAAC,EAAE,cAAc,CAAC;KAC/B,GAAG,MAAM,CAAC;CACZ"}

package/dist/types/craftdesk-lock.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=craftdesk-lock.js.map

package/dist/types/craftdesk-lock.js.map

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

package/dist/utils/file-system.d.ts

@@ -0,0 +1,10 @@
+import { CraftDeskJson } from '../types/craftdesk-json';
+import { CraftDeskLock } from '../types/craftdesk-lock';
+export declare function readCraftDeskJson(dir?: string): Promise<CraftDeskJson | null>;
+export declare function writeCraftDeskJson(data: CraftDeskJson, dir?: string): Promise<void>;
+export declare function readCraftDeskLock(dir?: string): Promise<CraftDeskLock | null>;
+export declare function writeCraftDeskLock(data: CraftDeskLock, dir?: string): Promise<void>;
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function removeDir(dirPath: string): Promise<void>;
+export declare function exists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=file-system.d.ts.map

package/dist/utils/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,wBAAsB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CASlG;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG;AAED,wBAAsB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CASlG;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxG;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D"}

package/dist/utils/file-system.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCraftDeskJson = readCraftDeskJson;
+exports.writeCraftDeskJson = writeCraftDeskJson;
+exports.readCraftDeskLock = readCraftDeskLock;
+exports.writeCraftDeskLock = writeCraftDeskLock;
+exports.ensureDir = ensureDir;
+exports.removeDir = removeDir;
+exports.exists = exists;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+async function readCraftDeskJson(dir = process.cwd()) {
+    const filePath = path_1.default.join(dir, 'craftdesk.json');
+    try {
+        const content = await fs_extra_1.default.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        return null;
+    }
+}
+async function writeCraftDeskJson(data, dir = process.cwd()) {
+    const filePath = path_1.default.join(dir, 'craftdesk.json');
+    const content = JSON.stringify(data, null, 2);
+    await fs_extra_1.default.writeFile(filePath, content, 'utf-8');
+}
+async function readCraftDeskLock(dir = process.cwd()) {
+    const filePath = path_1.default.join(dir, 'craftdesk.lock');
+    try {
+        const content = await fs_extra_1.default.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        return null;
+    }
+}
+async function writeCraftDeskLock(data, dir = process.cwd()) {
+    const filePath = path_1.default.join(dir, 'craftdesk.lock');
+    const content = JSON.stringify(data, null, 2);
+    await fs_extra_1.default.writeFile(filePath, content, 'utf-8');
+}
+async function ensureDir(dirPath) {
+    await fs_extra_1.default.ensureDir(dirPath);
+}
+async function removeDir(dirPath) {
+    await fs_extra_1.default.remove(dirPath);
+}
+async function exists(filePath) {
+    try {
+        await fs_extra_1.default.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=file-system.js.map

package/dist/utils/file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":";;;;;AAKA,8CASC;AAED,gDAIC;AAED,8CASC;AAED,gDAIC;AAED,8BAEC;AAED,8BAEC;AAED,wBAOC;AAtDD,wDAA0B;AAC1B,gDAAwB;AAIjB,KAAK,UAAU,iBAAiB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,IAAmB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACvF,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAEM,KAAK,UAAU,iBAAiB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,IAAmB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACvF,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,kBAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAEM,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+export declare class Logger {
+    private spinnerText;
+    success(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    info(message: string): void;
+    debug(message: string): void;
+    startSpinner(text: string): void;
+    updateSpinner(text: string): void;
+    succeedSpinner(text?: string): void;
+    failSpinner(text?: string): void;
+    stopSpinner(): void;
+    log(message: string): void;
+    bold(text: string): string;
+    dim(text: string): string;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAaA,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAuB;IAE1C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKhC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOjC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAOnC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAOhC,WAAW,IAAI,IAAI;IAInB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG1B;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+// ANSI color codes
+const colors = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+};
+class Logger {
+    spinnerText = null;
+    success(message) {
+        console.log(`${colors.green}✓${colors.reset}`, message);
+    }
+    error(message) {
+        console.error(`${colors.red}✗${colors.reset}`, message);
+    }
+    warn(message) {
+        console.log(`${colors.yellow}!${colors.reset}`, message);
+    }
+    info(message) {
+        console.log(`${colors.blue}→${colors.reset}`, message);
+    }
+    debug(message) {
+        if (process.env.DEBUG) {
+            console.log(`${colors.gray}[DEBUG]${colors.reset}`, message);
+        }
+    }
+    startSpinner(text) {
+        this.spinnerText = text;
+        console.log(`${colors.cyan}⋯${colors.reset}`, text);
+    }
+    updateSpinner(text) {
+        if (this.spinnerText) {
+            this.spinnerText = text;
+            console.log('  ', text);
+        }
+    }
+    succeedSpinner(text) {
+        if (this.spinnerText) {
+            console.log(`${colors.green}✓${colors.reset}`, text || this.spinnerText);
+            this.spinnerText = null;
+        }
+    }
+    failSpinner(text) {
+        if (this.spinnerText) {
+            console.log(`${colors.red}✗${colors.reset}`, text || this.spinnerText);
+            this.spinnerText = null;
+        }
+    }
+    stopSpinner() {
+        this.spinnerText = null;
+    }
+    log(message) {
+        console.log(message);
+    }
+    bold(text) {
+        return `${colors.bold}${text}${colors.reset}`;
+    }
+    dim(text) {
+        return `${colors.dim}${text}${colors.reset}`;
+    }
+}
+exports.Logger = Logger;
+exports.logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/docs/DEPENDENCY_RESOLUTION.md

@@ -0,0 +1,237 @@
+# CraftDesk Dependency Resolution
+
+## Overview
+
+CraftDesk supports multiple dependency sources and resolves them intelligently, including transitive dependencies.
+
+## Dependency Sources
+
+### 1. Registry Dependencies (Default)
+
+Standard dependencies are fetched from registries:
+
+```json
+{
+  "dependencies": {
+    "ruby-on-rails": "^7.0.0"
+  }
+}
+```
+
+**Resolution Process:**
+1. Query the registry API for package metadata
+2. Resolve version constraints
+3. Fetch transitive dependencies
+4. Generate lockfile with exact versions
+
+### 2. Git Dependencies
+
+Dependencies can be fetched directly from git repositories:
+
+```json
+{
+  "dependencies": {
+    "my-skill": {
+      "git": "https://github.com/user/repo.git",
+      "branch": "main"
+    }
+  }
+}
+```
+
+**Resolution Process:**
+1. Clone the repository (shallow clone for efficiency)
+2. Check out specified branch/tag/commit
+3. Look for `craftdesk.json` in the repository
+4. Extract metadata and dependencies
+5. Recursively resolve any dependencies found
+
+## Handling Missing craftdesk.json
+
+When a git dependency doesn't have a `craftdesk.json` file, the CLI:
+
+### 1. Generates Minimal Metadata
+
+```json
+{
+  "name": "repository-name",
+  "version": "branch-or-tag-or-commit",
+  "type": "skill",  // Inferred from structure
+  "description": "Git dependency from <url>",
+  "dependencies": {}
+}
+```
+
+### 2. Type Inference
+
+The system tries to infer the craft type by looking for:
+
+1. **Marker Files:**
+   - `SKILL.md` → type: "skill"
+   - `AGENT.md` → type: "agent"
+   - `COMMAND.md` → type: "command"
+   - `HOOK.md` → type: "hook"
+
+2. **Directory Name Patterns:**
+   - Contains "skill" → type: "skill"
+   - Contains "agent" → type: "agent"
+   - Contains "command" → type: "command"
+   - Contains "hook" → type: "hook"
+
+3. **Default:** type: "skill"
+
+## Monorepo Support
+
+For git repositories containing multiple crafts:
+
+```json
+{
+  "dependencies": {
+    "auth-handler": {
+      "git": "https://github.com/company/monorepo.git",
+      "tag": "v3.0.0",
+      "path": "packages/auth"
+    },
+    "data-processor": {
+      "git": "https://github.com/company/monorepo.git",
+      "tag": "v3.0.0",
+      "path": "agents/processor"
+    }
+  }
+}
+```
+
+The CLI:
+1. Clones the repository once
+2. Looks for `craftdesk.json` in each specified `path`
+3. Installs only the contents of the specified subdirectory
+
+## Transitive Dependencies
+
+### From Registry Packages
+
+Registry packages include their dependencies in metadata:
+```json
+{
+  "name": "ruby-on-rails",
+  "version": "7.1.0",
+  "dependencies": {
+    "activerecord": "^7.1.0",
+    "actionpack": "^7.1.0"
+  }
+}
+```
+
+### From Git Packages
+
+Git packages' dependencies are discovered by reading their `craftdesk.json`:
+```json
+// In https://github.com/user/my-skill.git/craftdesk.json
+{
+  "name": "my-skill",
+  "version": "2.0.0",
+  "dependencies": {
+    "postgres-expert": "^1.0.0",  // Will be resolved from registry
+    "helper-lib": {
+      "git": "https://github.com/user/helper.git"  // Will be resolved from git
+    }
+  }
+}
+```
+
+## Resolution Algorithm
+
+```typescript
+1. Start with direct dependencies from craftdesk.json
+2. For each dependency:
+   a. If registry: Query API for metadata
+   b. If git: Clone and extract craftdesk.json
+3. Add discovered dependencies to resolution queue
+4. Repeat until all dependencies resolved
+5. Check for version conflicts
+6. Generate lockfile with exact versions
+```
+
+## Lockfile Structure
+
+The lockfile captures the complete resolution:
+
+```json
+{
+  "version": "1.0.0",
+  "lockfileVersion": 1,
+  "crafts": {
+    "my-skill": {
+      "version": "2.0.0",
+      "resolved": "https://github.com/user/my-skill.git",
+      "integrity": "abc123def456",  // Git commit hash
+      "type": "skill",
+      "git": "https://github.com/user/my-skill.git",
+      "branch": "main",
+      "commit": "abc123def456789012345678901234567890abcd",
+      "dependencies": {
+        "postgres-expert": "^1.0.0"
+      }
+    },
+    "postgres-expert": {
+      "version": "1.2.3",
+      "resolved": "https://craftdesk.ai/api/v1/crafts/anthropic/postgres-expert/versions/1.2.3/download",
+      "integrity": "sha256-xyz789...",
+      "type": "agent",
+      "registry": "https://craftdesk.ai",
+      "dependencies": {}
+    }
+  }
+}
+```
+
+## Error Handling
+
+### Missing Dependencies
+- Git repos without craftdesk.json: Generate minimal metadata
+- Unreachable git repos: Fail with clear error message
+- Registry packages not found: Fail with suggestions
+
+### Version Conflicts
+- Currently: Last-write-wins
+- Future: Interactive conflict resolution
+
+### Circular Dependencies
+- Detected during resolution
+- Fails with error showing the circular chain
+
+## Performance Optimizations
+
+1. **Shallow Clones:** Git repos cloned with `--depth 1`
+2. **Parallel Resolution:** Registry queries run in parallel
+3. **Caching:** Git repos cached for 15 minutes during resolution
+4. **Minimal Transfers:** Only specified subdirectories copied for monorepos
+
+## Example: Mixed Resolution
+
+Given this `craftdesk.json`:
+```json
+{
+  "dependencies": {
+    "ruby-on-rails": "^7.0.0",
+    "custom-auth": {
+      "git": "https://github.com/company/auth.git",
+      "branch": "main"
+    }
+  }
+}
+```
+
+Resolution steps:
+1. Query registry for ruby-on-rails@^7.0.0
+   - Resolves to 7.1.2
+   - Has dependencies: activerecord@^7.1.0, actionpack@^7.1.0
+2. Clone https://github.com/company/auth.git
+   - Check out main branch
+   - Read craftdesk.json
+   - Has dependency: jwt-helper@^2.0.0
+3. Resolve transitive dependencies:
+   - activerecord@^7.1.0 → 7.1.0
+   - actionpack@^7.1.0 → 7.1.0
+   - jwt-helper@^2.0.0 → 2.1.0
+4. Generate complete lockfile with all 5 packages

package/examples/craftdesk-all-sources.json

@@ -0,0 +1,79 @@
+{
+  "name": "full-example-project",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "Example showing all dependency source types",
+
+  "dependencies": {
+    // Registry dependencies (default)
+    "ruby-on-rails": "^7.0.0",
+    "postgres-expert": "~1.2.0",
+
+    // Registry with custom registry
+    "@company/private-skill": {
+      "version": "^3.0.0",
+      "registry": "company-private"
+    },
+
+    // Direct registry URL
+    "special-tool": {
+      "version": "^2.0.0",
+      "registry": "https://tools.example.com"
+    },
+
+    // Git dependencies with branch
+    "experimental-agent": {
+      "git": "https://github.com/user/agent-repo.git",
+      "branch": "develop"
+    },
+
+    // Git with specific tag
+    "stable-skill": {
+      "git": "https://github.com/org/skills.git",
+      "tag": "v2.1.0"
+    },
+
+    // Git with subdirectory (monorepo)
+    "auth-handler": {
+      "git": "https://github.com/company/monorepo.git",
+      "branch": "main",
+      "path": "packages/auth"
+    },
+
+    // Git with commit hash
+    "specific-version": {
+      "git": "https://github.com/user/repo.git",
+      "commit": "a1b2c3d4e5f6789012345678901234567890abcd"
+    },
+
+    // Multiple skills from same git repo
+    "data-processor": {
+      "git": "https://github.com/company/monorepo.git",
+      "tag": "v1.0.0",
+      "path": "skills/data-processor"
+    },
+    "report-generator": {
+      "git": "https://github.com/company/monorepo.git",
+      "tag": "v1.0.0",
+      "path": "skills/report-generator"
+    }
+  },
+
+  "devDependencies": {
+    "test-runner": "^1.0.0",
+    "code-reviewer": {
+      "git": "https://github.com/tools/reviewer.git",
+      "branch": "latest"
+    }
+  },
+
+  "registries": {
+    "default": {
+      "url": "https://craftdesk.ai"
+    },
+    "company-private": {
+      "url": "https://registry.company.com",
+      "scope": "@company"
+    }
+  }
+}

package/examples/craftdesk-git-monorepo.json

@@ -0,0 +1,41 @@
+{
+  "name": "monorepo-example",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "Example using git monorepo with multiple crafts",
+
+  "dependencies": {
+    "auth-handler": {
+      "git": "https://github.com/company/ai-crafts-monorepo.git",
+      "tag": "v3.2.0",
+      "path": "skills/auth"
+    },
+    "data-processor": {
+      "git": "https://github.com/company/ai-crafts-monorepo.git",
+      "tag": "v3.2.0",
+      "path": "agents/data-processor"
+    },
+    "report-generator": {
+      "git": "https://github.com/company/ai-crafts-monorepo.git",
+      "tag": "v3.2.0",
+      "path": "skills/reporting"
+    },
+    "test-runner": {
+      "git": "https://github.com/company/ai-crafts-monorepo.git",
+      "tag": "v3.2.0",
+      "path": "commands/test"
+    },
+    "pre-commit-hook": {
+      "git": "https://github.com/company/ai-crafts-monorepo.git",
+      "tag": "v3.2.0",
+      "path": "hooks/pre-commit"
+    },
+    "ruby-on-rails": "^7.0.0"
+  },
+
+  "registries": {
+    "default": {
+      "url": "https://craftdesk.ai"
+    }
+  }
+}

package/examples/craftdesk-multi-registry.json

@@ -0,0 +1,40 @@
+{
+  "name": "my-enterprise-project",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "Enterprise project with multiple registries",
+  "author": "Your Company",
+
+  "dependencies": {
+    "ruby-on-rails": "^7.0.0",
+    "postgres-expert": "~1.2.0",
+    "@company/auth-handler": {
+      "version": "^3.0.0",
+      "registry": "company-private"
+    },
+    "special-tool": {
+      "version": "^2.0.0",
+      "registry": "https://tools.example.com"
+    },
+    "@partner/analytics": "^1.5.0"
+  },
+
+  "devDependencies": {
+    "code-reviewer": "^2.0.0",
+    "@company/test-suite": {
+      "version": "^1.0.0",
+      "registry": "company-private"
+    }
+  },
+
+  "registries": {
+    "company-private": {
+      "url": "https://registry.internal.mycompany.com",
+      "scope": "@company"
+    },
+    "partner": {
+      "url": "https://api.partner.com/registry",
+      "scope": "@partner"
+    }
+  }
+}

package/examples/craftdesk-with-registries.json

@@ -0,0 +1,49 @@
+{
+  "name": "my-enterprise-project",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "Enterprise project with multiple registries",
+  "author": "Your Company",
+
+  "dependencies": {
+    // Simple dependencies use default registry or scope-based routing
+    "ruby-on-rails": "^7.0.0",
+    "postgres-expert": "~1.2.0",
+
+    // Dependency with inline registry specification
+    "@company/auth-handler": {
+      "version": "^3.0.0",
+      "registry": "company-private"  // References registry defined below
+    },
+
+    // Direct URL registry specification
+    "special-tool": {
+      "version": "^2.0.0",
+      "registry": "https://tools.example.com"
+    },
+
+    // Scoped packages automatically use their scope's registry if configured
+    "@partner/analytics": "^1.5.0"  // Will use partner registry defined below
+  },
+
+  "devDependencies": {
+    "code-reviewer": "^2.0.0",
+    "@company/test-suite": {
+      "version": "^1.0.0",
+      "registry": "company-private"
+    }
+  },
+
+  // Registry configuration (all in one file!)
+  "registries": {
+    // Named registries
+    "company-private": {
+      "url": "https://registry.internal.mycompany.com",
+      "scope": "@company"  // All @company/* packages will use this registry
+    },
+    "partner": {
+      "url": "https://api.partner.com/registry",
+      "scope": "@partner"  // All @partner/* packages will use this registry
+    }
+  }
+}