skillsets 0.2.3 → 0.2.5

package/README.md

@@ -1,62 +1,60 @@
 # Skillsets CLI
 
+## Purpose
 Command-line tool for discovering, installing, and contributing verified Claude Code skillsets.
 
-## Quick Start
-
-```bash
-# Browse available skillsets
-npx skillsets list
-
-# Sort by popularity
-npx skillsets list --sort downloads
-
-# Search by keyword
-npx skillsets search "sdlc"
-
-# Install a skillset
-npx skillsets install @supercollectible/The_Skillset
+## Architecture
 ```
-
-## Commands
-
-| Command | Purpose |
-|---------|---------|
-| `list` | Browse all skillsets with live star/download counts |
-| `search <query>` | Fuzzy search by name, description, or tags |
-| `install <id>` | Install skillset to current directory (verifies checksums) |
-| `init` | Scaffold a new skillset for contribution |
-| `audit` | Validate skillset before submission |
-| `submit` | Open PR to registry (requires `gh` CLI) |
-
-## Options
-
-### list
-- `-l, --limit <n>` - Limit number of results
-- `-s, --sort <field>` - Sort by: `name`, `stars`, `downloads`
-- `--json` - Output as JSON
-
-### search
-- `-t, --tags <tags...>` - Filter by tags
-- `-l, --limit <n>` - Limit results (default: 10)
-
-### install
-- `-f, --force` - Overwrite existing files
-- `-b, --backup` - Backup existing files before install
-
-## Live Stats
-
-The CLI fetches live star and download counts from the API, so you always see current numbers (not stale build-time data).
-
-## Development
-
-```bash
-npm install    # Install dependencies
-npm run build  # Build TypeScript
-npm test       # Run tests (43 tests)
+cli/
+├── src/
+│   ├── index.ts           # CLI entry point
+│   ├── commands/          # Command implementations
+│   │   ├── list.ts
+│   │   ├── search.ts
+│   │   ├── install.ts
+│   │   ├── init.ts
+│   │   ├── audit.ts
+│   │   └── submit.ts
+│   ├── lib/               # Shared utilities
+│   │   ├── api.ts
+│   │   ├── checksum.ts
+│   │   ├── constants.ts
+│   │   ├── errors.ts
+│   │   ├── filesystem.ts
+│   │   └── versions.ts
+│   └── types/
+│       └── index.ts
+└── docs_cli/              # Documentation
+    ├── ARC_cli.md
+    ├── commands/
+    └── lib/
 ```
 
-## Documentation
-
-- [CLI Style Guide](../.claude/resources/cli_styleguide.md) - Development patterns
-- [CLAUDE.md](../CLAUDE.md) - Project overview
+## Files
+
+| File | Purpose | Documentation |
+|------|---------|---------------|
+| — | Architecture, data flow, key patterns | [ARC_cli.md](./docs_cli/ARC_cli.md) |
+
+### Commands
+| File | Purpose | Documentation |
+|------|---------|---------------|
+| `list.ts` | Browse all skillsets with live stats | [Docs](./docs_cli/commands/list.md) |
+| `search.ts` | Fuzzy search by name, description, tags | [Docs](./docs_cli/commands/search.md) |
+| `install.ts` | Install skillset via degit + verify checksums | [Docs](./docs_cli/commands/install.md) |
+| `init.ts` | Scaffold new skillset for contribution | [Docs](./docs_cli/commands/init.md) |
+| `audit.ts` | Validate skillset before submission | [Docs](./docs_cli/commands/audit.md) |
+| `submit.ts` | Open PR to registry | [Docs](./docs_cli/commands/submit.md) |
+
+### Lib
+| File | Purpose | Documentation |
+|------|---------|---------------|
+| `api.ts` | API client for skillsets.cc | [Docs](./docs_cli/lib/api.md) |
+| `checksum.ts` | SHA-256 verification | [Docs](./docs_cli/lib/checksum.md) |
+| `constants.ts` | Shared constants | [Docs](./docs_cli/lib/constants.md) |
+| `errors.ts` | Error types | [Docs](./docs_cli/lib/errors.md) |
+| `filesystem.ts` | File utilities | [Docs](./docs_cli/lib/filesystem.md) |
+| `versions.ts` | Semver comparison | [Docs](./docs_cli/lib/versions.md) |
+
+## Related Documentation
+- [CLI Style Guide](../.claude/resources/cli_styleguide.md)

package/dist/commands/audit.js

@@ -1,26 +1,10 @@
 import chalk from 'chalk';
 import ora from 'ora';
-import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'fs';
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, openSync, readSync, closeSync } from 'fs';
 import { join, relative } from 'path';
 import yaml from 'js-yaml';
 import { fetchSkillsetMetadata } from '../lib/api.js';
-/**
- * Compare semver versions. Returns:
- * -1 if a < b, 0 if a == b, 1 if a > b
- */
-function compareVersions(a, b) {
-    const partsA = a.split('.').map(Number);
-    const partsB = b.split('.').map(Number);
-    for (let i = 0; i < 3; i++) {
-        const numA = partsA[i] || 0;
-        const numB = partsB[i] || 0;
-        if (numA < numB)
-            return -1;
-        if (numA > numB)
-            return 1;
-    }
-    return 0;
-}
+import { compareVersions } from '../lib/versions.js';
 const MAX_FILE_SIZE = 1048576; // 1MB
 const TEXT_EXTENSIONS = new Set([
     '.md', '.txt', '.json', '.yaml', '.yml',
@@ -69,9 +53,9 @@ function isBinaryFile(filePath) {
     // Check for null bytes in first 512 bytes
     try {
         const buffer = Buffer.alloc(512);
-        const fd = require('fs').openSync(filePath, 'r');
-        require('fs').readSync(fd, buffer, 0, 512, 0);
-        require('fs').closeSync(fd);
+        const fd = openSync(filePath, 'r');
+        readSync(fd, buffer, 0, 512, 0);
+        closeSync(fd);
         return buffer.includes(0);
     }
     catch {
@@ -152,8 +136,8 @@ function validateManifest(cwd) {
         if (!data.author?.handle || !/^@[A-Za-z0-9_-]+$/.test(data.author.handle)) {
             errors.push('author.handle must start with @ (e.g., @username)');
         }
-        if (!data.verification?.production_url) {
-            errors.push('verification.production_url is required');
+        if (!Array.isArray(data.verification?.production_links) || data.verification.production_links.length === 0) {
+            errors.push('verification.production_links must be an array with at least one entry');
         }
         if (!data.verification?.audit_report) {
             errors.push('verification.audit_report is required');

package/dist/commands/init.js

@@ -16,7 +16,8 @@ author:
 
 # Verification
 verification:
-  production_url: "{{PRODUCTION_URL}}"
+  production_links:
+    - url: "{{PRODUCTION_URL}}"
   production_proof: "./PROOF.md"
   audit_report: "./AUDIT_REPORT.md"
 

package/dist/commands/list.js

@@ -11,16 +11,18 @@ export async function list(options) {
         let skillsets = mergeStats(index.skillsets, stats);
         // Sort
         const sortBy = options.sort || 'name';
-        if (sortBy === 'stars') {
-            skillsets.sort((a, b) => b.stars - a.stars);
+        switch (sortBy) {
+            case 'stars':
+                skillsets.sort((a, b) => b.stars - a.stars);
+                break;
+            case 'downloads':
+                skillsets.sort((a, b) => (b.downloads ?? 0) - (a.downloads ?? 0));
+                break;
+            case 'name':
+            default:
+                skillsets.sort((a, b) => a.name.localeCompare(b.name));
+                break;
         }
-        else if (sortBy === 'downloads') {
-            skillsets.sort((a, b) => (b.downloads ?? 0) - (a.downloads ?? 0));
-        }
-        else if (sortBy === 'name') {
-            skillsets.sort((a, b) => a.name.localeCompare(b.name));
-        }
-        // 'recent' would require a date field - skip for now
         // Limit
         const limit = parseInt(options.limit || '0', 10);
         if (limit > 0) {

package/dist/commands/submit.js

@@ -6,24 +6,8 @@ import { join } from 'path';
 import yaml from 'js-yaml';
 import { tmpdir } from 'os';
 import { fetchSkillsetMetadata } from '../lib/api.js';
+import { compareVersions } from '../lib/versions.js';
 const REGISTRY_REPO = 'skillsets-cc/main';
-/**
- * Compare semver versions. Returns:
- * -1 if a < b, 0 if a == b, 1 if a > b
- */
-function compareVersions(a, b) {
-    const partsA = a.split('.').map(Number);
-    const partsB = b.split('.').map(Number);
-    for (let i = 0; i < 3; i++) {
-        const numA = partsA[i] || 0;
-        const numB = partsB[i] || 0;
-        if (numA < numB)
-            return -1;
-        if (numA > numB)
-            return 1;
-    }
-    return 0;
-}
 const REGISTRY_URL = `https://github.com/${REGISTRY_REPO}`;
 function checkGhCli() {
     try {

package/dist/index.js

@@ -10,7 +10,7 @@ import { handleError } from './lib/errors.js';
 program
     .name('skillsets')
     .description('CLI tool for discovering and installing verified skillsets')
-    .version('0.1.0');
+    .version('0.2.4');
 // === Discovery Commands ===
 program
     .command('list')

package/dist/lib/checksum.js

@@ -9,10 +9,6 @@ export async function computeFileChecksum(filePath) {
     const content = await fs.readFile(filePath, 'utf-8');
     return crypto.createHash('sha256').update(content).digest('hex');
 }
-/**
- * Verifies checksums of installed skillset against registry.
- * Returns validation result with list of mismatches.
- */
 /**
  * Strips algorithm prefix from checksum (e.g., "sha256:abc123" -> "abc123").
  */

package/dist/lib/versions.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compare semver versions. Returns:
+ * -1 if a < b, 0 if a == b, 1 if a > b
+ */
+export declare function compareVersions(a: string, b: string): number;

package/dist/lib/versions.js

@@ -0,0 +1,17 @@
+/**
+ * Compare semver versions. Returns:
+ * -1 if a < b, 0 if a == b, 1 if a > b
+ */
+export function compareVersions(a, b) {
+    const partsA = a.split('.').map(Number);
+    const partsB = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const numA = partsA[i] || 0;
+        const numB = partsB[i] || 0;
+        if (numA < numB)
+            return -1;
+        if (numA > numB)
+            return 1;
+    }
+    return 0;
+}

package/dist/types/index.d.ts

@@ -17,7 +17,10 @@ export interface SearchIndexEntry {
     version: string;
     status: 'active' | 'deprecated' | 'archived';
     verification: {
-        production_url: string;
+        production_links: Array<{
+            url: string;
+            label?: string;
+        }>;
         production_proof?: string;
         audit_report: string;
     };
@@ -43,7 +46,10 @@ export interface Skillset {
         url: string;
     };
     verification: {
-        production_url: string;
+        production_links: Array<{
+            url: string;
+            label?: string;
+        }>;
         production_proof?: string;
         audit_report: string;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillsets",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "CLI tool for discovering and installing verified skillsets",
   "type": "module",
   "bin": {