@skillsmith/cli 0.4.3 → 0.5.1

package/dist/src/commands/create.js

@@ -0,0 +1,325 @@
+/**
+ * SMI-3083: skillsmith create command
+ *
+ * Scaffolds a new Claude Code skill into ~/.claude/skills/<name>/ with
+ * SKILL.md, README.md, CHANGELOG.md, .gitignore, resources/, and an optional
+ * scripts/ directory.
+ *
+ * Relationship with `skillsmith author init`:
+ *   - `create`      → ~/.claude/skills/<name>/  (user-level, publish-oriented,
+ *                       CHANGELOG.md + Behavioral Classification included)
+ *   - `author init` → current working directory  (in-project skill authoring)
+ *
+ * Long-term, `create` is the preferred command for publishing new skills to the
+ * Skillsmith registry. `author init` is retained for in-project authoring workflows.
+ */
+import { Command } from 'commander';
+import { input, confirm, select } from '@inquirer/prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import { mkdir, writeFile, stat } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+import { sanitizeError } from '../utils/sanitize.js';
+import { validateSkillName } from '../utils/skill-name.js';
+import { SKILL_MD_TEMPLATE, README_MD_TEMPLATE, CHANGELOG_MD_TEMPLATE } from '../templates/index.js';
+export { validateSkillName };
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const VALID_TYPES = ['basic', 'intermediate', 'advanced'];
+const VALID_BEHAVIORS = ['autonomous', 'guided', 'interactive', 'configurable'];
+const VALID_CATEGORIES = [
+    'development',
+    'productivity',
+    'communication',
+    'data',
+    'security',
+    'other',
+];
+/** GitHub username format: alphanumeric and hyphens, must start with alphanumeric. */
+const GITHUB_USERNAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9-]*$/;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Sanitize a user-supplied string for safe insertion into a YAML scalar value.
+ * Strips newlines/carriage returns and double-quotes values containing YAML
+ * special characters to prevent frontmatter corruption.
+ */
+function sanitizeYamlScalar(value) {
+    const safe = value.replace(/[\r\n]/g, ' ').trim();
+    // Wrap in double quotes when value contains YAML-special characters
+    if (/[:#[\]{}&|>'"*?!%@`]/.test(safe) || safe.startsWith(' ') || safe.endsWith(' ')) {
+        return `"${safe.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return safe;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function behaviorDescription(behavior) {
+    switch (behavior) {
+        case 'autonomous':
+            return 'This skill operates autonomously — it executes its full workflow without requiring user input at each step.';
+        case 'guided':
+            return 'This skill is guided — it asks for your input on key decisions, then executes based on your choices.';
+        case 'interactive':
+            return 'This skill is interactive — it maintains a back-and-forth dialogue throughout execution.';
+        case 'configurable':
+            return 'This skill is configurable — behavior is controlled by settings you provide upfront.';
+        default:
+            return '';
+    }
+}
+/** Build the SKILL.md content, sanitizing YAML frontmatter values. */
+function buildSkillMd(opts) {
+    const behavioralClassification = `\n## Behavioral Classification\n\n**Type**: ${capitalize(opts.type)}\n**Behavior**: ${capitalize(opts.behavior)}\n\n${behaviorDescription(opts.behavior)}\n`;
+    return SKILL_MD_TEMPLATE.replace(/\{\{name\}\}/g, opts.name)
+        .replace(/\{\{description\}\}/g, sanitizeYamlScalar(opts.description))
+        .replace(/\{\{author\}\}/g, sanitizeYamlScalar(opts.author))
+        .replace(/\{\{category\}\}/g, opts.category)
+        .replace(/\{\{date\}\}/g, opts.date)
+        .replace(/\{\{behavioralClassification\}\}/g, behavioralClassification);
+}
+/**
+ * Scaffold a new Claude Code skill at ~/.claude/skills/<name>/ (or --output).
+ */
+export async function createSkill(name, options = {}) {
+    // 1. Skill name
+    const skillName = name ??
+        (await input({
+            message: 'Skill name (lowercase, hyphens only):',
+            validate: validateSkillName,
+        }));
+    const nameValidation = validateSkillName(skillName);
+    if (nameValidation !== true) {
+        console.error(chalk.red(`Invalid skill name: ${nameValidation}`));
+        process.exit(1);
+    }
+    // 2. Description (identity fields first, so user understands context before technical choices)
+    const description = options.description ??
+        (await input({
+            message: 'Description:',
+            default: `A Claude Code skill for ${skillName}`,
+            validate: (v) => (v.trim() ? true : 'Description is required'),
+        }));
+    if (!description.trim()) {
+        console.error(chalk.red('Description is required'));
+        process.exit(1);
+    }
+    // 3. Author (GitHub username) — validated for URL safety
+    const rawAuthor = options.author ??
+        (await input({
+            message: 'Author (GitHub username):',
+            default: process.env['USER'] ?? process.env['USERNAME'] ?? 'author',
+            validate: (v) => {
+                if (!v.trim())
+                    return 'Author is required';
+                if (!GITHUB_USERNAME_RE.test(v.trim()))
+                    return 'Must be a valid GitHub username (alphanumeric and hyphens only)';
+                return true;
+            },
+        }));
+    if (!rawAuthor.trim() || !GITHUB_USERNAME_RE.test(rawAuthor.trim())) {
+        console.error(chalk.red('Invalid author: must be a valid GitHub username (alphanumeric and hyphens only)'));
+        process.exit(1);
+    }
+    const author = rawAuthor.trim();
+    // 4. Category — validate CLI flag; select prompt constrains to valid values
+    if (options.category && !VALID_CATEGORIES.includes(options.category)) {
+        console.error(chalk.red(`Invalid category: ${options.category}. Valid: ${VALID_CATEGORIES.join(', ')}`));
+        process.exit(1);
+    }
+    const category = options.category ??
+        (await select({
+            message: 'Category:',
+            choices: [
+                { name: 'Development', value: 'development' },
+                { name: 'Productivity', value: 'productivity' },
+                { name: 'Communication', value: 'communication' },
+                { name: 'Data', value: 'data' },
+                { name: 'Security', value: 'security' },
+                { name: 'Other', value: 'other' },
+            ],
+        }));
+    // 5. Skill type — validate CLI flag
+    if (options.type && !VALID_TYPES.includes(options.type)) {
+        console.error(chalk.red(`Invalid type: ${options.type}. Valid: ${VALID_TYPES.join(', ')}`));
+        process.exit(1);
+    }
+    const skillType = options.type ??
+        (await select({
+            message: 'Skill type:',
+            choices: [
+                { name: 'Basic — simple, single-purpose skill', value: 'basic' },
+                { name: 'Intermediate — multi-step with some decisions', value: 'intermediate' },
+                { name: 'Advanced — complex orchestration or agent delegation', value: 'advanced' },
+            ],
+        }));
+    // 6. Behavioral classification — validate CLI flag
+    if (options.behavior && !VALID_BEHAVIORS.includes(options.behavior)) {
+        console.error(chalk.red(`Invalid behavior: ${options.behavior}. Valid: ${VALID_BEHAVIORS.join(', ')}`));
+        process.exit(1);
+    }
+    const behavior = options.behavior ??
+        (await select({
+            message: 'Behavioral classification:',
+            choices: [
+                { name: 'Autonomous — runs without user input', value: 'autonomous' },
+                { name: 'Guided — asks key questions then executes', value: 'guided' },
+                {
+                    name: 'Interactive — back-and-forth dialogue throughout execution',
+                    value: 'interactive',
+                },
+                { name: 'Configurable — settings-driven, provided upfront', value: 'configurable' },
+            ],
+        }));
+    // 7. Scripts directory
+    const includeScripts = options.scripts ??
+        (await confirm({
+            message: 'Include a scripts/ directory?',
+            default: false,
+        }));
+    // 8. Resolve output directory — lazy (never baked in at module load time)
+    const outputDir = options.output ?? join(homedir(), '.claude', 'skills');
+    const skillDir = join(outputDir, skillName);
+    // 9. Overwrite check — after all prompts so user knows what they committed to
+    let exists = false;
+    try {
+        await stat(skillDir);
+        exists = true;
+    }
+    catch {
+        // Directory does not exist — proceed
+    }
+    if (exists && !options.yes) {
+        // --yes semantics: always overwrite without prompt
+        const overwrite = await confirm({
+            message: `${skillDir} already exists. Overwrite?`,
+            default: false,
+        });
+        if (!overwrite) {
+            console.log(chalk.yellow('Cancelled.'));
+            return;
+        }
+    }
+    const date = new Date().toISOString().split('T')[0] ?? new Date().toISOString().slice(0, 10);
+    // Build file contents
+    const skillMdContent = buildSkillMd({
+        name: skillName,
+        description,
+        author,
+        category,
+        type: skillType,
+        behavior,
+        date,
+    });
+    const readmeContent = README_MD_TEMPLATE.replace(/\{\{author\}\}/g, sanitizeYamlScalar(author))
+        .replace(/\{\{name\}\}/g, skillName)
+        .replace(/\{\{description\}\}/g, description);
+    const changelogContent = CHANGELOG_MD_TEMPLATE.replace(/\{\{name\}\}/g, skillName).replace(/\{\{date\}\}/g, date);
+    // JSON.stringify prevents skill names containing single-quotes from breaking generated JS
+    const scriptContent = `#!/usr/bin/env node\n/**\n * ${skillName} - Example Script\n */\nconsole.log(${JSON.stringify(`${skillName} script executed`)})\n`;
+    const gitignoreContent = `# Dependencies\nnode_modules/\n\n# Build output\ndist/\n\n# Environment\n.env\n.env.local\n\n# OS files\n.DS_Store\nThumbs.db\n`;
+    // 10. Dry run — preview scaffold output without writing any files
+    if (options.dryRun) {
+        console.log();
+        console.log(chalk.bold(`Dry run — would scaffold: ${skillDir}/`));
+        console.log(chalk.dim('  SKILL.md'));
+        console.log(chalk.dim('  README.md'));
+        console.log(chalk.dim('  CHANGELOG.md'));
+        console.log(chalk.dim('  .gitignore'));
+        console.log(chalk.dim('  resources/'));
+        if (includeScripts) {
+            console.log(chalk.dim('  scripts/'));
+            console.log(chalk.dim('  scripts/example.js'));
+        }
+        console.log();
+        console.log(chalk.bold('SKILL.md preview:'));
+        const preview = skillMdContent.length > 500 ? skillMdContent.slice(0, 500) + '\n…' : skillMdContent;
+        console.log(chalk.dim(preview));
+        console.log();
+        return;
+    }
+    const spinner = ora('Scaffolding skill...').start();
+    try {
+        await mkdir(skillDir, { recursive: true });
+        await mkdir(join(skillDir, 'resources'), { recursive: true });
+        if (includeScripts) {
+            await mkdir(join(skillDir, 'scripts'), { recursive: true });
+        }
+        await writeFile(join(skillDir, 'SKILL.md'), skillMdContent, 'utf-8');
+        await writeFile(join(skillDir, 'README.md'), readmeContent, 'utf-8');
+        await writeFile(join(skillDir, 'CHANGELOG.md'), changelogContent, 'utf-8');
+        await writeFile(join(skillDir, '.gitignore'), gitignoreContent, 'utf-8');
+        if (includeScripts) {
+            await writeFile(join(skillDir, 'scripts', 'example.js'), scriptContent, 'utf-8');
+        }
+        spinner.succeed(`Skill scaffolded at ${skillDir}`);
+    }
+    catch (error) {
+        spinner.fail(`Failed to scaffold skill: ${sanitizeError(error)}`);
+        throw error;
+    }
+    // Publishing checklist — aligned with v1.1.0 publish gate requirements
+    // (README filled, CHANGELOG filled, release tag, registry submit)
+    console.log();
+    console.log(chalk.bold('Publishing checklist:'));
+    console.log(chalk.dim(`  1. Edit SKILL.md — write your skill's instructions and trigger phrases`));
+    console.log(chalk.dim(`  2. Complete README.md — problem statement, usage examples, requirements`));
+    console.log(chalk.dim(`  3. Update CHANGELOG.md — confirm the [1.0.0] entry is accurate`));
+    console.log(chalk.dim('  4. Test your skill locally with Claude Code'));
+    console.log(chalk.dim('  5. Publish to GitHub:'));
+    console.log(chalk.cyan(`       gh repo create ${skillName} --public`));
+    console.log(chalk.cyan(`       cd ${skillDir} && git init && git add . && git commit -m "feat: initial skill"`));
+    console.log(chalk.cyan(`       git remote add origin https://github.com/${author}/${skillName}`));
+    console.log(chalk.cyan('       git push -u origin main'));
+    console.log(chalk.cyan('       gh release create v1.0.0 --title "v1.0.0" --notes "Initial release"'));
+    console.log(chalk.dim('  6. Submit to Skillsmith registry: skillsmith publish'));
+    console.log();
+}
+// ---------------------------------------------------------------------------
+// Command factory
+// ---------------------------------------------------------------------------
+/**
+ * Create the `skillsmith create` command.
+ * SMI-3083: Scaffold new Claude Code skills without a separate skill install.
+ *
+ * See also: `skillsmith author init` — scaffolds into the CWD for in-project
+ * skill authoring (no CHANGELOG.md or Behavioral Classification section).
+ */
+export function createCreateCommand() {
+    return new Command('create')
+        .description('Scaffold a new Claude Code skill at ~/.claude/skills/<name>/ (see also: skillsmith author init)')
+        .argument('[name]', 'Skill name (lowercase, hyphens only)')
+        .option('-o, --output <dir>', 'Output directory (default: ~/.claude/skills)')
+        .option('--type <type>', 'Skill type: basic|intermediate|advanced')
+        .option('--behavior <behavior>', 'Behavioral classification: autonomous|guided|interactive|configurable')
+        .option('-d, --description <description>', 'Skill description (skips prompt)')
+        .option('-a, --author <author>', 'Author GitHub username (skips prompt)')
+        .option('-c, --category <category>', 'Category: development|productivity|communication|data|security|other (skips prompt)')
+        .option('--scripts', 'Include a scripts/ directory')
+        .option('-y, --yes', 'Auto-confirm overwrite — always overwrites if skill directory exists')
+        .option('--dry-run', 'Preview scaffold output without writing files')
+        .action(async (name, opts) => {
+        try {
+            await createSkill(name, {
+                output: opts['output'],
+                type: opts['type'],
+                behavior: opts['behavior'],
+                description: opts['description'],
+                author: opts['author'],
+                category: opts['category'],
+                scripts: opts['scripts'],
+                yes: opts['yes'],
+                dryRun: opts['dryRun'],
+            });
+        }
+        catch (error) {
+            console.error(chalk.red('Error creating skill:'), sanitizeError(error));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/src/commands/create.js.map

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

package/dist/src/commands/diff.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview skillsmith diff — section-level skill content diff
+ * @module @skillsmith/cli/commands/diff
+ * @see SMI-skill-version-tracking Wave 2
+ *
+ * Compares an installed skill against its latest registry version using
+ * heading-level (H2/H3) section analysis. Produces a human-readable
+ * summary: sections removed (major), added (minor), or modified (patch).
+ *
+ * Tier gate: Individual (requires requireTier('individual')).
+ */
+import { Command } from 'commander';
+/**
+ * Create the diff command
+ */
+export declare function createDiffCommand(): Command;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/commands/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA6JnC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAwD3C"}

package/dist/src/commands/diff.js

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview skillsmith diff — section-level skill content diff
+ * @module @skillsmith/cli/commands/diff
+ * @see SMI-skill-version-tracking Wave 2
+ *
+ * Compares an installed skill against its latest registry version using
+ * heading-level (H2/H3) section analysis. Produces a human-readable
+ * summary: sections removed (major), added (minor), or modified (patch).
+ *
+ * Tier gate: Individual (requires requireTier('individual')).
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+import { classifyChange } from '@skillsmith/core';
+import { requireTier } from '../utils/require-tier.js';
+import { sanitizeError } from '../utils/sanitize.js';
+import { loadManifest } from '../utils/manifest.js';
+function extractHeadings(content) {
+    const headings = new Map();
+    for (const line of content.split('\n')) {
+        const m = /^#{2,3}\s+(.+)/.exec(line);
+        if (m && m[1] !== undefined) {
+            const title = m[1].trim();
+            headings.set(title.toLowerCase(), title);
+        }
+    }
+    return headings;
+}
+function extractSectionBodies(content) {
+    const result = new Map();
+    const lines = content.split('\n');
+    let currentHeading = null;
+    const bodyLines = [];
+    const flush = () => {
+        if (currentHeading !== null) {
+            result.set(currentHeading, bodyLines.join('\n').trim());
+            bodyLines.length = 0;
+        }
+    };
+    for (const line of lines) {
+        const m = /^#{2,3}\s+(.+)/.exec(line);
+        if (m && m[1] !== undefined) {
+            flush();
+            currentHeading = m[1].trim().toLowerCase();
+        }
+        else if (currentHeading !== null) {
+            bodyLines.push(line);
+        }
+    }
+    flush();
+    return result;
+}
+function diffSections(oldContent, newContent) {
+    const oldH = extractHeadings(oldContent);
+    const newH = extractHeadings(newContent);
+    const oldBodies = extractSectionBodies(oldContent);
+    const newBodies = extractSectionBodies(newContent);
+    const removed = [...oldH.values()].filter((t) => !newH.has(t.toLowerCase()));
+    const added = [...newH.values()].filter((t) => !oldH.has(t.toLowerCase()));
+    const modified = [];
+    for (const [key, title] of newH) {
+        if (oldH.has(key)) {
+            const oldBody = oldBodies.get(key) ?? '';
+            const newBody = newBodies.get(key) ?? '';
+            if (oldBody !== newBody)
+                modified.push(title);
+        }
+    }
+    return { added, removed, modified };
+}
+// ============================================================================
+// Content resolution helpers
+// ============================================================================
+async function readInstalledSkillContent(skillName) {
+    const skillPath = join(homedir(), '.claude', 'skills', skillName, 'SKILL.md');
+    try {
+        return await readFile(skillPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convert a GitHub repo URL to the raw SKILL.md URL.
+ * Returns null for non-GitHub or unrecognised URL shapes.
+ */
+function buildRawUrl(source) {
+    if (source.startsWith('https://raw.githubusercontent.com/'))
+        return source;
+    const m = /^https:\/\/github\.com\/([^/]+)\/([^/]+)(?:\/tree\/([^/]+))?/.exec(source);
+    if (!m)
+        return null;
+    const [, owner, repo, ref = 'main'] = m;
+    return `https://raw.githubusercontent.com/${owner}/${repo}/${ref}/SKILL.md`;
+}
+async function fetchLatestContent(skillName) {
+    try {
+        const manifest = await loadManifest();
+        const entry = manifest.installedSkills[skillName];
+        if (!entry?.source)
+            return null;
+        const rawUrl = buildRawUrl(entry.source);
+        if (!rawUrl)
+            return null;
+        const response = await fetch(rawUrl, {
+            headers: { Accept: 'text/plain' },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok)
+            return null;
+        return await response.text();
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Display
+// ============================================================================
+function printDiff(skillName, diff, changeType) {
+    const totalChanges = diff.removed.length + diff.added.length + diff.modified.length;
+    console.log('\n' +
+        chalk.bold(skillName) +
+        '  ' +
+        chalk.dim(`[${changeType.toUpperCase()}]`) +
+        `  ${totalChanges} section(s) changed`);
+    for (const s of diff.removed)
+        console.log(chalk.red(`  - ${s}`));
+    for (const s of diff.added)
+        console.log(chalk.green(`  + ${s}`));
+    for (const s of diff.modified)
+        console.log(chalk.yellow(`  ~ ${s}`));
+    if (totalChanges === 0) {
+        console.log(chalk.dim('  No section-level changes detected'));
+    }
+    console.log();
+}
+// ============================================================================
+// Command factory
+// ============================================================================
+/**
+ * Create the diff command
+ */
+export function createDiffCommand() {
+    return new Command('diff')
+        .description('Show section-level diff between installed and latest version of a skill (Individual tier)')
+        .argument('<skill>', 'Skill name to diff')
+        .option('--old-content <path>', 'Path to old SKILL.md (uses installed skill if omitted)')
+        .option('--new-content <path>', 'Path to new SKILL.md (fetches from registry if omitted)')
+        .action(async (skillName, opts) => {
+        try {
+            await requireTier('individual');
+            // Resolve old content
+            let oldContent = null;
+            if (opts.oldContent) {
+                oldContent = await readFile(opts.oldContent, 'utf-8');
+            }
+            else {
+                oldContent = await readInstalledSkillContent(skillName);
+            }
+            if (!oldContent) {
+                console.error(chalk.red(`Skill "${skillName}" is not installed or SKILL.md not found.`));
+                process.exit(1);
+            }
+            // Resolve new content
+            let newContent = null;
+            if (opts.newContent) {
+                newContent = await readFile(opts.newContent, 'utf-8');
+            }
+            else {
+                newContent = await fetchLatestContent(skillName);
+            }
+            if (!newContent) {
+                console.error(chalk.red(`Could not fetch latest version for "${skillName}". ` +
+                    `Check your network connection or provide --new-content.`));
+                process.exit(1);
+            }
+            const diff = diffSections(oldContent, newContent);
+            const changeType = classifyChange(oldContent, newContent);
+            printDiff(skillName, diff, changeType);
+        }
+        catch (error) {
+            console.error(chalk.red('Error:'), sanitizeError(error));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/src/commands/diff.js.map

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

package/dist/src/commands/diff.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Tests for diff.ts — skillsmith diff CLI command
+ * @see SMI-skill-version-tracking Wave 2
+ */
+export {};
+//# sourceMappingURL=diff.test.d.ts.map

package/dist/src/commands/diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.test.d.ts","sourceRoot":"","sources":["../../../src/commands/diff.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}