@openweave/weave-skills 1.0.0

package/dist/skills/deploy-provision.js

@@ -0,0 +1,270 @@
+/**
+ * Skill: deploy-provision
+ *
+ * Interactive production provisioning guide. Validates prerequisites
+ * (DNS resolution, open ports, Docker availability, required env vars)
+ * and optionally invokes `scripts/deploy/setup.sh` step by step.
+ *
+ * Integrates with M23 — the deploy scripts live in `scripts/deploy/`.
+ *
+ * Modes (ctx.graph['mode']):
+ *   - 'validate'  — check prerequisites only (default, safe)
+ *   - 'provision' — run setup.sh steps (requires confirmRun: true)
+ *
+ * Input options (ctx.graph):
+ *   - `domain`      {string}   — FQDN to check DNS for
+ *   - `apiKey`      {string}   — WEAVE_API_KEY value to validate
+ *   - `ports`       {number[]} — ports to check (default: [80, 443, 3001])
+ *   - `dryRun`      {boolean}  — simulate without executing shell commands
+ *   - `confirmRun`  {boolean}  — must be true to allow mode='provision'
+ *   - `env`         {Record<string,string>} — inject env for testing
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Prerequisite validators
+// ---------------------------------------------------------------------------
+function checkDocker(dryRun) {
+    if (dryRun)
+        return { id: 'docker', name: 'Docker available', status: 'skip', message: 'dry-run' };
+    try {
+        execSync('docker --version', { stdio: 'pipe' });
+        return { id: 'docker', name: 'Docker available', status: 'ok', message: 'Docker is installed' };
+    }
+    catch {
+        return {
+            id: 'docker',
+            name: 'Docker available',
+            status: 'fail',
+            message: 'Docker not found in PATH',
+            fix: 'Install Docker Engine: https://docs.docker.com/engine/install/',
+        };
+    }
+}
+function checkDns(domain, dryRun) {
+    if (!domain) {
+        return { id: 'dns', name: 'DNS resolution', status: 'warn', message: 'No domain provided — skipping DNS check' };
+    }
+    if (dryRun) {
+        return { id: 'dns', name: 'DNS resolution', status: 'skip', message: `dry-run (would resolve ${domain})` };
+    }
+    try {
+        execSync(`nslookup ${domain}`, { stdio: 'pipe' });
+        return { id: 'dns', name: 'DNS resolution', status: 'ok', message: `${domain} resolves` };
+    }
+    catch {
+        try {
+            execSync(`ping -c 1 ${domain}`, { stdio: 'pipe' });
+            return { id: 'dns', name: 'DNS resolution', status: 'ok', message: `${domain} reachable` };
+        }
+        catch {
+            return {
+                id: 'dns',
+                name: 'DNS resolution',
+                status: 'fail',
+                message: `Cannot resolve ${domain}`,
+                fix: `Ensure an A record for ${domain} points to this server's public IP`,
+            };
+        }
+    }
+}
+function checkPorts(ports, dryRun) {
+    if (dryRun) {
+        return ports.map((p) => ({
+            id: `port-${p}`,
+            name: `Port ${p} reachable`,
+            status: 'skip',
+            message: 'dry-run',
+        }));
+    }
+    return ports.map((p) => {
+        try {
+            // Check if port is already in use (potential conflict)
+            execSync(`lsof -i :${p} -sTCP:LISTEN`, { stdio: 'pipe' });
+            return {
+                id: `port-${p}`,
+                name: `Port ${p} available`,
+                status: 'warn',
+                message: `Port ${p} is already in use — may conflict with new service`,
+                fix: `Stop the existing process on port ${p} before provisioning`,
+            };
+        }
+        catch {
+            // lsof returns non-zero when nothing is listening — that means the port is free
+            return {
+                id: `port-${p}`,
+                name: `Port ${p} available`,
+                status: 'ok',
+                message: `Port ${p} is free`,
+            };
+        }
+    });
+}
+function checkEnvVars(required, env) {
+    return required.map((key) => {
+        const val = env[key];
+        if (!val) {
+            return {
+                id: `env-${key}`,
+                name: `Env: ${key}`,
+                status: 'fail',
+                message: `${key} is not set`,
+                fix: `export ${key}=<value>`,
+            };
+        }
+        if (val.length < 8 && key.toLowerCase().includes('key')) {
+            return {
+                id: `env-${key}`,
+                name: `Env: ${key}`,
+                status: 'warn',
+                message: `${key} looks too short — use a strong random value`,
+                fix: `weave-link keygen`,
+            };
+        }
+        return {
+            id: `env-${key}`,
+            name: `Env: ${key}`,
+            status: 'ok',
+            message: `${key} is set`,
+        };
+    });
+}
+function checkDeployScripts(projectRoot) {
+    const setupPath = join(projectRoot, 'scripts', 'deploy', 'setup.sh');
+    if (existsSync(setupPath)) {
+        return { id: 'scripts', name: 'Deploy scripts present', status: 'ok', message: setupPath };
+    }
+    return {
+        id: 'scripts',
+        name: 'Deploy scripts present',
+        status: 'warn',
+        message: 'scripts/deploy/setup.sh not found — M23 scripts not yet implemented',
+        fix: 'Implement M23 deploy scripts or set mode=validate to skip provisioning',
+    };
+}
+// ---------------------------------------------------------------------------
+// Provision steps (M23 integration)
+// ---------------------------------------------------------------------------
+const PROVISION_STEPS = [
+    { id: 'validate-env', name: 'Validate environment variables', script: 'scripts/deploy/validate-env.sh' },
+    { id: 'install-docker', name: 'Ensure Docker is installed', script: 'scripts/deploy/docker.sh' },
+    { id: 'setup-firewall', name: 'Configure firewall (ufw)', script: 'scripts/deploy/firewall.sh' },
+    { id: 'start-compose', name: 'Start weave-link container', script: 'scripts/deploy/compose.yml' },
+    { id: 'setup-nginx', name: 'Configure nginx reverse proxy', script: 'scripts/deploy/nginx.sh' },
+    { id: 'setup-tls', name: 'Obtain TLS certificate (Let\'s Encrypt)', script: 'scripts/deploy/certbot.sh' },
+    { id: 'verify', name: 'Smoke-test HTTPS endpoint', script: 'scripts/deploy/verify.sh' },
+];
+function runProvisionStep(step, projectRoot, dryRun) {
+    if (dryRun) {
+        return { ...step, status: 'done', output: `[dry-run] would execute ${step.script}` };
+    }
+    const absScript = join(projectRoot, step.script);
+    if (!existsSync(absScript)) {
+        return { ...step, status: 'skipped', output: `Script not found: ${step.script}` };
+    }
+    try {
+        const output = execSync(`bash "${absScript}"`, {
+            cwd: projectRoot,
+            stdio: 'pipe',
+            encoding: 'utf-8',
+            timeout: 120_000,
+        });
+        return { ...step, status: 'done', output: output.slice(0, 500) };
+    }
+    catch (err) {
+        const e = err;
+        return { ...step, status: 'failed', error: String(e.stderr ?? e.message ?? 'unknown error').slice(0, 300) };
+    }
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const deployProvisionSkill = {
+    id: 'deploy-provision',
+    name: 'Deploy & Provision',
+    description: 'Validates production prerequisites (DNS, Docker, ports, env vars) and optionally runs scripts/deploy/setup.sh',
+    version: '1.0.0',
+    enabled: false,
+    tags: ['devops', 'deploy'],
+    async execute(ctx) {
+        const opts = ctx.graph ?? {};
+        const mode = String(opts['mode'] ?? 'validate');
+        const domain = String(opts['domain'] ?? '');
+        const dryRun = Boolean(opts['dryRun'] ?? true);
+        const confirmRun = Boolean(opts['confirmRun'] ?? false);
+        const ports = Array.isArray(opts['ports'])
+            ? opts['ports']
+            : [80, 443, 3001];
+        const injectedEnv = opts['env'] ?? process.env;
+        // -- Prerequisite validation --
+        const prereqs = [
+            checkDocker(dryRun),
+            checkDns(domain, dryRun),
+            ...checkPorts(ports, dryRun),
+            ...checkEnvVars(['WEAVE_API_KEY', 'DOMAIN'], injectedEnv),
+            checkDeployScripts(ctx.projectRoot),
+        ];
+        const failedPrereqs = prereqs.filter((p) => p.status === 'fail');
+        const warnPrereqs = prereqs.filter((p) => p.status === 'warn');
+        // -- Provision steps --
+        let steps = [];
+        if (mode === 'provision') {
+            if (!confirmRun) {
+                return {
+                    success: false,
+                    output: '❌ Provision mode requires `confirmRun: true` in ctx.graph to prevent accidental execution.',
+                    error: 'confirmRun not set',
+                };
+            }
+            if (failedPrereqs.length > 0 && !dryRun) {
+                return {
+                    success: false,
+                    output: `❌ ${failedPrereqs.length} prerequisite(s) failed — fix them before provisioning.`,
+                    error: 'prerequisites failed',
+                };
+            }
+            for (const stepDef of PROVISION_STEPS) {
+                const result = runProvisionStep(stepDef, ctx.projectRoot, dryRun);
+                steps.push(result);
+                if (result.status === 'failed')
+                    break; // stop on first failure
+            }
+        }
+        const ready = failedPrereqs.length === 0;
+        const summary = ready
+            ? `✅ All prerequisites passed${mode === 'provision' ? ' · provisioning complete' : ''}`
+            : `❌ ${failedPrereqs.length} prerequisite(s) failed · ${warnPrereqs.length} warning(s)`;
+        const report = { domain, prereqs, steps, ready, summary };
+        // -- Format output --
+        const lines = [
+            `🚀 Deploy Provision (mode: ${mode}${dryRun ? ' · dry-run' : ''})`,
+            `   ${summary}`,
+            '',
+            '  PREREQUISITES:',
+        ];
+        for (const p of prereqs) {
+            const icon = p.status === 'ok' ? '✅' : p.status === 'fail' ? '❌' : p.status === 'warn' ? '⚠️ ' : '⏭ ';
+            lines.push(`  ${icon} ${p.name}: ${p.message}`);
+            if (p.fix)
+                lines.push(`     💡 ${p.fix}`);
+        }
+        if (steps.length > 0) {
+            lines.push('', '  PROVISION STEPS:');
+            for (const s of steps) {
+                const icon = s.status === 'done' ? '✅' : s.status === 'failed' ? '❌' : s.status === 'skipped' ? '⏭ ' : '⏳';
+                lines.push(`  ${icon} ${s.name}`);
+                if (s.output)
+                    lines.push(`     ${s.output.split('\n')[0]}`);
+                if (s.error)
+                    lines.push(`     ⚠️  ${s.error.split('\n')[0]}`);
+            }
+        }
+        return {
+            success: ready,
+            output: lines.join('\n'),
+            data: report,
+        };
+    },
+};
+//# sourceMappingURL=deploy-provision.js.map

package/dist/skills/deploy-provision.js.map

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

package/dist/skills/docs-gen.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Skill: docs-gen
+ *
+ * Generates documentation stubs for exported TypeScript entities that lack JSDoc,
+ * and produces a CHANGELOG draft from conventional commits.
+ *
+ * Two modes (controlled via ctx.graph options):
+ *   - `mode: 'jsdoc'`     — scan for undocumented exports → generate JSDoc stubs
+ *   - `mode: 'changelog'` — parse git log → draft CHANGELOG.md section
+ *   - `mode: 'both'`      — run both (default)
+ */
+import type { SkillModule } from '../types.js';
+export interface UndocumentedEntity {
+    file: string;
+    line: number;
+    name: string;
+    kind: 'function' | 'class' | 'const' | 'interface' | 'type';
+    stub: string;
+}
+export interface ChangelogEntry {
+    hash: string;
+    type: string;
+    scope: string;
+    message: string;
+}
+export interface DocsGenResult {
+    undocumented: UndocumentedEntity[];
+    changelog: ChangelogEntry[];
+    jsDocStubs: string;
+    changelogSection: string;
+}
+export declare function findUndocumentedExports(source: string, filePath: string): UndocumentedEntity[];
+export declare function parseConventionalCommits(gitLog: string): ChangelogEntry[];
+export declare function renderChangelogSection(entries: ChangelogEntry[], version?: string): string;
+export declare const docsGenSkill: SkillModule;
+//# sourceMappingURL=docs-gen.d.ts.map

package/dist/skills/docs-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-gen.d.ts","sourceRoot":"","sources":["../../src/skills/docs-gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AASD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA4B9F;AA0BD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAYzE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,OAAO,SAAe,GAAG,MAAM,CA2BhG;AAMD,eAAO,MAAM,YAAY,EAAE,WA6E1B,CAAC"}

package/dist/skills/docs-gen.js

@@ -0,0 +1,187 @@
+/**
+ * Skill: docs-gen
+ *
+ * Generates documentation stubs for exported TypeScript entities that lack JSDoc,
+ * and produces a CHANGELOG draft from conventional commits.
+ *
+ * Two modes (controlled via ctx.graph options):
+ *   - `mode: 'jsdoc'`     — scan for undocumented exports → generate JSDoc stubs
+ *   - `mode: 'changelog'` — parse git log → draft CHANGELOG.md section
+ *   - `mode: 'both'`      — run both (default)
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// JSDoc analysis
+// ---------------------------------------------------------------------------
+const EXPORTED_SYMBOL_RE = /^(export\s+(?:async\s+)?function|export\s+(?:abstract\s+)?class|export\s+(?:const|let|var)\s+\w+|export\s+interface\s+\w+|export\s+type\s+\w+)/;
+const NAME_RE = /(?:function|class|interface|type|const|let|var)\s+(\w+)/;
+export function findUndocumentedExports(source, filePath) {
+    const lines = source.split('\n');
+    const results = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!EXPORTED_SYMBOL_RE.test(line))
+            continue;
+        // Check previous lines for a JSDoc block
+        const prevLine = lines[i - 1]?.trimEnd() ?? '';
+        const hasDocs = prevLine.trimEnd().endsWith('*/') || prevLine.trimStart().startsWith('* ') || prevLine.trimStart().startsWith('/**');
+        if (hasDocs)
+            continue;
+        const nameMatch = NAME_RE.exec(line);
+        if (!nameMatch)
+            continue;
+        const name = nameMatch[1];
+        let kind = 'const';
+        if (/export\s+(?:async\s+)?function/.test(line))
+            kind = 'function';
+        else if (/export\s+(?:abstract\s+)?class/.test(line))
+            kind = 'class';
+        else if (/export\s+interface/.test(line))
+            kind = 'interface';
+        else if (/export\s+type/.test(line))
+            kind = 'type';
+        const stub = generateJsDoc(name, kind);
+        results.push({ file: filePath, line: i + 1, name, kind, stub });
+    }
+    return results;
+}
+function generateJsDoc(name, kind) {
+    const lines = ['/**'];
+    lines.push(` * ${name}`);
+    if (kind === 'function') {
+        lines.push(` *`);
+        lines.push(` * @param args - TODO: document parameters`);
+        lines.push(` * @returns TODO: describe return value`);
+    }
+    else if (kind === 'class') {
+        lines.push(` *`);
+        lines.push(` * @example`);
+        lines.push(` * \`\`\`typescript`);
+        lines.push(` * const instance = new ${name}();`);
+        lines.push(` * \`\`\``);
+    }
+    lines.push(` */`);
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Changelog from git log
+// ---------------------------------------------------------------------------
+const CONVENTIONAL_RE = /^([a-z]+)(?:\(([^)]+)\))?!?:\s+(.+)$/;
+export function parseConventionalCommits(gitLog) {
+    return gitLog
+        .split('\n')
+        .filter(Boolean)
+        .map((line) => {
+        const [hash, ...rest] = line.split(' ');
+        const msg = rest.join(' ');
+        const m = CONVENTIONAL_RE.exec(msg);
+        if (!m)
+            return null;
+        return { hash: hash.slice(0, 7), type: m[1], scope: m[2] ?? '', message: m[3] };
+    })
+        .filter((e) => e !== null);
+}
+export function renderChangelogSection(entries, version = 'Unreleased') {
+    if (entries.length === 0)
+        return `## [${version}]\n\n_No conventional commits found._\n`;
+    const groups = {};
+    for (const e of entries) {
+        (groups[e.type] ??= []).push(e);
+    }
+    const ORDER = ['feat', 'fix', 'perf', 'refactor', 'docs', 'test', 'chore', 'ci'];
+    const LABELS = {
+        feat: '✨ Features', fix: '🐛 Bug Fixes', perf: '⚡ Performance',
+        refactor: '♻️  Refactoring', docs: '📚 Documentation', test: '🧪 Tests',
+        chore: '🔧 Chores', ci: '⚙️  CI',
+    };
+    const lines = [`## [${version}] — ${new Date().toISOString().slice(0, 10)}`, ''];
+    for (const type of [...ORDER, ...Object.keys(groups).filter((t) => !ORDER.includes(t))]) {
+        if (!groups[type])
+            continue;
+        lines.push(`### ${LABELS[type] ?? type}`);
+        for (const e of groups[type]) {
+            const scope = e.scope ? ` **${e.scope}:**` : '';
+            lines.push(`- \`${e.hash}\`${scope} ${e.message}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const docsGenSkill = {
+    id: 'docs-gen',
+    name: 'Docs Generator',
+    description: 'Generates JSDoc stubs for undocumented exports and drafts CHANGELOG from conventional commits',
+    version: '1.0.0',
+    enabled: false,
+    tags: ['dev', 'docs'],
+    async execute(ctx) {
+        const opts = ctx.graph ?? {};
+        const mode = String(opts['mode'] ?? 'both');
+        const version = String(opts['version'] ?? 'Unreleased');
+        const undocumented = [];
+        const changelog = [];
+        let jsDocStubs = '';
+        let changelogSection = '';
+        // --- JSDoc mode ---
+        if (mode === 'jsdoc' || mode === 'both') {
+            const tsFiles = ctx.files.filter((f) => f.endsWith('.ts') && !f.endsWith('.test.ts') && !f.endsWith('.d.ts') && !f.includes('/dist/'));
+            for (const relPath of tsFiles) {
+                const absPath = join(ctx.projectRoot, relPath);
+                if (!existsSync(absPath))
+                    continue;
+                try {
+                    const content = readFileSync(absPath, 'utf-8');
+                    undocumented.push(...findUndocumentedExports(content, relPath));
+                }
+                catch { /* skip unreadable */ }
+            }
+            if (undocumented.length > 0) {
+                jsDocStubs = undocumented
+                    .map((u) => `// ${u.file}:${u.line} — ${u.name}\n${u.stub}`)
+                    .join('\n\n');
+            }
+        }
+        // --- Changelog mode ---
+        if (mode === 'changelog' || mode === 'both') {
+            try {
+                const gitLog = execSync('git log --oneline --no-merges -50', {
+                    cwd: ctx.projectRoot,
+                    stdio: 'pipe',
+                    encoding: 'utf-8',
+                });
+                const entries = parseConventionalCommits(gitLog);
+                changelog.push(...entries);
+                changelogSection = renderChangelogSection(entries, version);
+            }
+            catch {
+                changelogSection = '_(git log unavailable)_';
+            }
+        }
+        const lines = [`📚 Docs Generator`, ''];
+        if (mode !== 'changelog') {
+            lines.push(`  JSDoc gaps: ${undocumented.length} undocumented exports`);
+            if (undocumented.length > 0) {
+                for (const u of undocumented.slice(0, 10)) {
+                    lines.push(`  ⬜ ${u.file}:${u.line} — ${u.kind} ${u.name}`);
+                }
+                if (undocumented.length > 10)
+                    lines.push(`  … and ${undocumented.length - 10} more`);
+            }
+        }
+        if (mode !== 'jsdoc') {
+            lines.push('');
+            lines.push(`  CHANGELOG: ${changelog.length} conventional commit(s) parsed`);
+        }
+        return {
+            success: true,
+            output: lines.join('\n'),
+            data: { undocumented, changelog, jsDocStubs, changelogSection },
+        };
+    },
+};
+//# sourceMappingURL=docs-gen.js.map

package/dist/skills/docs-gen.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,19 @@
+export { autoFixSkill } from './auto-fix.js';
+export { codeReviewSkill } from './code-review.js';
+export { testGenSkill } from './test-gen.js';
+export { docsGenSkill } from './docs-gen.js';
+export { refactorSkill } from './refactor.js';
+export { pipelineAwareSkill } from './pipeline-aware.js';
+export { depAuditSkill } from './dep-audit.js';
+export { perfProfileSkill } from './perf-profile.js';
+export { containerAdvisorSkill } from './container-advisor.js';
+export { deployProvisionSkill } from './deploy-provision.js';
+export { onboardingSkill } from './onboarding.js';
+export { commitComposerSkill } from './commit-composer.js';
+export { contextMemorySkill } from './context-memory.js';
+export { multiRepoSkill } from './multi-repo.js';
+export { cliInteractiveSkill } from './cli-interactive.js';
+export declare const CORE_DEV_SKILLS: import("../types.js").SkillModule[];
+export declare const DEVOPS_SKILLS: import("../types.js").SkillModule[];
+export declare const DEV_EXPERIENCE_SKILLS: import("../types.js").SkillModule[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQ7D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAa3D,eAAO,MAAM,eAAe,qCAM3B,CAAC;AAEF,eAAO,MAAM,aAAa,qCAMzB,CAAC;AAEF,eAAO,MAAM,qBAAqB,qCAMjC,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,55 @@
+// M20 — Core Dev Skills
+export { autoFixSkill } from './auto-fix.js';
+export { codeReviewSkill } from './code-review.js';
+export { testGenSkill } from './test-gen.js';
+export { docsGenSkill } from './docs-gen.js';
+export { refactorSkill } from './refactor.js';
+// M21 — DevOps Skills
+export { pipelineAwareSkill } from './pipeline-aware.js';
+export { depAuditSkill } from './dep-audit.js';
+export { perfProfileSkill } from './perf-profile.js';
+export { containerAdvisorSkill } from './container-advisor.js';
+export { deployProvisionSkill } from './deploy-provision.js';
+import { autoFixSkill } from './auto-fix.js';
+import { codeReviewSkill } from './code-review.js';
+import { testGenSkill } from './test-gen.js';
+import { docsGenSkill } from './docs-gen.js';
+import { refactorSkill } from './refactor.js';
+// M22 — Developer Experience Skills
+export { onboardingSkill } from './onboarding.js';
+export { commitComposerSkill } from './commit-composer.js';
+export { contextMemorySkill } from './context-memory.js';
+export { multiRepoSkill } from './multi-repo.js';
+export { cliInteractiveSkill } from './cli-interactive.js';
+import { pipelineAwareSkill } from './pipeline-aware.js';
+import { depAuditSkill } from './dep-audit.js';
+import { perfProfileSkill } from './perf-profile.js';
+import { containerAdvisorSkill } from './container-advisor.js';
+import { deployProvisionSkill } from './deploy-provision.js';
+import { onboardingSkill } from './onboarding.js';
+import { commitComposerSkill } from './commit-composer.js';
+import { contextMemorySkill } from './context-memory.js';
+import { multiRepoSkill } from './multi-repo.js';
+import { cliInteractiveSkill } from './cli-interactive.js';
+export const CORE_DEV_SKILLS = [
+    autoFixSkill,
+    codeReviewSkill,
+    testGenSkill,
+    docsGenSkill,
+    refactorSkill,
+];
+export const DEVOPS_SKILLS = [
+    pipelineAwareSkill,
+    depAuditSkill,
+    perfProfileSkill,
+    containerAdvisorSkill,
+    deployProvisionSkill,
+];
+export const DEV_EXPERIENCE_SKILLS = [
+    onboardingSkill,
+    commitComposerSkill,
+    contextMemorySkill,
+    multiRepoSkill,
+    cliInteractiveSkill,
+];
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,oCAAoC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,aAAa;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;IACd,mBAAmB;CACpB,CAAC"}