@openweave/weave-skills 1.0.0 → 1.0.1

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

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docsGenSkill = void 0;
+exports.findUndocumentedExports = findUndocumentedExports;
+exports.parseConventionalCommits = parseConventionalCommits;
+exports.renderChangelogSection = renderChangelogSection;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("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+)/;
+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+(.+)$/;
+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);
+}
+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
+// ---------------------------------------------------------------------------
+exports.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 = (0, node_path_1.join)(ctx.projectRoot, relPath);
+                if (!(0, node_fs_1.existsSync)(absPath))
+                    continue;
+                try {
+                    const content = (0, node_fs_1.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 = (0, node_child_process_1.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/cjs/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/cjs/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/cjs/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/cjs/skills/index.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEV_EXPERIENCE_SKILLS = exports.DEVOPS_SKILLS = exports.CORE_DEV_SKILLS = exports.cliInteractiveSkill = exports.multiRepoSkill = exports.contextMemorySkill = exports.commitComposerSkill = exports.onboardingSkill = exports.deployProvisionSkill = exports.containerAdvisorSkill = exports.perfProfileSkill = exports.depAuditSkill = exports.pipelineAwareSkill = exports.refactorSkill = exports.docsGenSkill = exports.testGenSkill = exports.codeReviewSkill = exports.autoFixSkill = void 0;
+// M20 — Core Dev Skills
+var auto_fix_js_1 = require("./auto-fix.js");
+Object.defineProperty(exports, "autoFixSkill", { enumerable: true, get: function () { return auto_fix_js_1.autoFixSkill; } });
+var code_review_js_1 = require("./code-review.js");
+Object.defineProperty(exports, "codeReviewSkill", { enumerable: true, get: function () { return code_review_js_1.codeReviewSkill; } });
+var test_gen_js_1 = require("./test-gen.js");
+Object.defineProperty(exports, "testGenSkill", { enumerable: true, get: function () { return test_gen_js_1.testGenSkill; } });
+var docs_gen_js_1 = require("./docs-gen.js");
+Object.defineProperty(exports, "docsGenSkill", { enumerable: true, get: function () { return docs_gen_js_1.docsGenSkill; } });
+var refactor_js_1 = require("./refactor.js");
+Object.defineProperty(exports, "refactorSkill", { enumerable: true, get: function () { return refactor_js_1.refactorSkill; } });
+// M21 — DevOps Skills
+var pipeline_aware_js_1 = require("./pipeline-aware.js");
+Object.defineProperty(exports, "pipelineAwareSkill", { enumerable: true, get: function () { return pipeline_aware_js_1.pipelineAwareSkill; } });
+var dep_audit_js_1 = require("./dep-audit.js");
+Object.defineProperty(exports, "depAuditSkill", { enumerable: true, get: function () { return dep_audit_js_1.depAuditSkill; } });
+var perf_profile_js_1 = require("./perf-profile.js");
+Object.defineProperty(exports, "perfProfileSkill", { enumerable: true, get: function () { return perf_profile_js_1.perfProfileSkill; } });
+var container_advisor_js_1 = require("./container-advisor.js");
+Object.defineProperty(exports, "containerAdvisorSkill", { enumerable: true, get: function () { return container_advisor_js_1.containerAdvisorSkill; } });
+var deploy_provision_js_1 = require("./deploy-provision.js");
+Object.defineProperty(exports, "deployProvisionSkill", { enumerable: true, get: function () { return deploy_provision_js_1.deployProvisionSkill; } });
+const auto_fix_js_2 = require("./auto-fix.js");
+const code_review_js_2 = require("./code-review.js");
+const test_gen_js_2 = require("./test-gen.js");
+const docs_gen_js_2 = require("./docs-gen.js");
+const refactor_js_2 = require("./refactor.js");
+// M22 — Developer Experience Skills
+var onboarding_js_1 = require("./onboarding.js");
+Object.defineProperty(exports, "onboardingSkill", { enumerable: true, get: function () { return onboarding_js_1.onboardingSkill; } });
+var commit_composer_js_1 = require("./commit-composer.js");
+Object.defineProperty(exports, "commitComposerSkill", { enumerable: true, get: function () { return commit_composer_js_1.commitComposerSkill; } });
+var context_memory_js_1 = require("./context-memory.js");
+Object.defineProperty(exports, "contextMemorySkill", { enumerable: true, get: function () { return context_memory_js_1.contextMemorySkill; } });
+var multi_repo_js_1 = require("./multi-repo.js");
+Object.defineProperty(exports, "multiRepoSkill", { enumerable: true, get: function () { return multi_repo_js_1.multiRepoSkill; } });
+var cli_interactive_js_1 = require("./cli-interactive.js");
+Object.defineProperty(exports, "cliInteractiveSkill", { enumerable: true, get: function () { return cli_interactive_js_1.cliInteractiveSkill; } });
+const pipeline_aware_js_2 = require("./pipeline-aware.js");
+const dep_audit_js_2 = require("./dep-audit.js");
+const perf_profile_js_2 = require("./perf-profile.js");
+const container_advisor_js_2 = require("./container-advisor.js");
+const deploy_provision_js_2 = require("./deploy-provision.js");
+const onboarding_js_2 = require("./onboarding.js");
+const commit_composer_js_2 = require("./commit-composer.js");
+const context_memory_js_2 = require("./context-memory.js");
+const multi_repo_js_2 = require("./multi-repo.js");
+const cli_interactive_js_2 = require("./cli-interactive.js");
+exports.CORE_DEV_SKILLS = [
+    auto_fix_js_2.autoFixSkill,
+    code_review_js_2.codeReviewSkill,
+    test_gen_js_2.testGenSkill,
+    docs_gen_js_2.docsGenSkill,
+    refactor_js_2.refactorSkill,
+];
+exports.DEVOPS_SKILLS = [
+    pipeline_aware_js_2.pipelineAwareSkill,
+    dep_audit_js_2.depAuditSkill,
+    perf_profile_js_2.perfProfileSkill,
+    container_advisor_js_2.containerAdvisorSkill,
+    deploy_provision_js_2.deployProvisionSkill,
+];
+exports.DEV_EXPERIENCE_SKILLS = [
+    onboarding_js_2.onboardingSkill,
+    commit_composer_js_2.commitComposerSkill,
+    context_memory_js_2.contextMemorySkill,
+    multi_repo_js_2.multiRepoSkill,
+    cli_interactive_js_2.cliInteractiveSkill,
+];
+//# sourceMappingURL=index.js.map

package/dist/cjs/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/index.ts"],"names":[],"mappings":";;;AAAA,wBAAwB;AACxB,6CAA6C;AAApC,2GAAA,YAAY,OAAA;AACrB,mDAAmD;AAA1C,iHAAA,eAAe,OAAA;AACxB,6CAA6C;AAApC,2GAAA,YAAY,OAAA;AACrB,6CAA6C;AAApC,2GAAA,YAAY,OAAA;AACrB,6CAA8C;AAArC,4GAAA,aAAa,OAAA;AAEtB,sBAAsB;AACtB,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,+CAA+C;AAAtC,6GAAA,aAAa,OAAA;AACtB,qDAAqD;AAA5C,mHAAA,gBAAgB,OAAA;AACzB,+DAA+D;AAAtD,6HAAA,qBAAqB,OAAA;AAC9B,6DAA6D;AAApD,2HAAA,oBAAoB,OAAA;AAE7B,+CAA6C;AAC7C,qDAAmD;AACnD,+CAA6C;AAC7C,+CAA6C;AAC7C,+CAA8C;AAC9C,oCAAoC;AACpC,iDAAkD;AAAzC,gHAAA,eAAe,OAAA;AACxB,2DAA2D;AAAlD,yHAAA,mBAAmB,OAAA;AAC5B,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AACvB,2DAA2D;AAAlD,yHAAA,mBAAmB,OAAA;AAE5B,2DAAyD;AACzD,iDAA+C;AAC/C,uDAAqD;AACrD,iEAA+D;AAC/D,+DAA6D;AAC7D,mDAAkD;AAClD,6DAA2D;AAC3D,2DAAyD;AACzD,mDAAiD;AACjD,6DAA2D;AAE9C,QAAA,eAAe,GAAG;IAC7B,0BAAY;IACZ,gCAAe;IACf,0BAAY;IACZ,0BAAY;IACZ,2BAAa;CACd,CAAC;AAEW,QAAA,aAAa,GAAG;IAC3B,sCAAkB;IAClB,4BAAa;IACb,kCAAgB;IAChB,4CAAqB;IACrB,0CAAoB;CACrB,CAAC;AAEW,QAAA,qBAAqB,GAAG;IACnC,+BAAe;IACf,wCAAmB;IACnB,sCAAkB;IAClB,8BAAc;IACd,wCAAmB;CACpB,CAAC"}

package/dist/cjs/skills/multi-repo.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Skill: multi-repo
+ *
+ * Allows reasoning across multiple repositories simultaneously.
+ * Aggregates file lists, package manifests and git status from each configured
+ * repo root and produces a unified cross-repo analysis report.
+ *
+ * Input (via SkillContext.graph):
+ *   - `ctx.graph['repos']`   — string[] — absolute paths to additional repo roots
+ *   - `ctx.graph['repoData']` — RepoInfo[] — injectable repo snapshots for tests (bypasses FS)
+ *   - `ctx.graph['mode']`    — 'summary' | 'deps' | 'files' (default: 'summary')
+ *
+ * Output data:
+ *   - MultiRepoResult
+ */
+import type { SkillModule } from '../types.js';
+export interface RepoDependency {
+    name: string;
+    version: string;
+    kind: 'dep' | 'devDep' | 'peer';
+}
+export interface RepoInfo {
+    root: string;
+    name: string;
+    description: string;
+    version: string;
+    dependencies: RepoDependency[];
+    fileCount: number;
+    topLevelEntries: string[];
+    hasTypeScript: boolean;
+    hasTests: boolean;
+    branch?: string;
+}
+export interface CrossRepoDependency {
+    dep: string;
+    repos: string[];
+    versions: string[];
+    versionConflict: boolean;
+}
+export interface MultiRepoResult {
+    mode: 'summary' | 'deps' | 'files';
+    repos: RepoInfo[];
+    crossDeps: CrossRepoDependency[];
+    summary: string;
+}
+export declare function scanRepoRoot(root: string): RepoInfo;
+export declare function findCrossRepoDeps(repos: RepoInfo[]): CrossRepoDependency[];
+export declare function buildSummary(repos: RepoInfo[], crossDeps: CrossRepoDependency[]): string;
+export declare const multiRepoSkill: SkillModule;
+//# sourceMappingURL=multi-repo.d.ts.map

package/dist/cjs/skills/multi-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-repo.d.ts","sourceRoot":"","sources":["../../../src/skills/multi-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA0DnD;AAqBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CA8B1E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAQxF;AAMD,eAAO,MAAM,cAAc,EAAE,WAyC5B,CAAC"}

package/dist/cjs/skills/multi-repo.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Skill: multi-repo
+ *
+ * Allows reasoning across multiple repositories simultaneously.
+ * Aggregates file lists, package manifests and git status from each configured
+ * repo root and produces a unified cross-repo analysis report.
+ *
+ * Input (via SkillContext.graph):
+ *   - `ctx.graph['repos']`   — string[] — absolute paths to additional repo roots
+ *   - `ctx.graph['repoData']` — RepoInfo[] — injectable repo snapshots for tests (bypasses FS)
+ *   - `ctx.graph['mode']`    — 'summary' | 'deps' | 'files' (default: 'summary')
+ *
+ * Output data:
+ *   - MultiRepoResult
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.multiRepoSkill = void 0;
+exports.scanRepoRoot = scanRepoRoot;
+exports.findCrossRepoDeps = findCrossRepoDeps;
+exports.buildSummary = buildSummary;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function scanRepoRoot(root) {
+    const name = (0, node_path_1.basename)(root);
+    let description = '';
+    let version = '0.0.0';
+    const dependencies = [];
+    // Read package.json
+    const pkgPath = (0, node_path_1.join)(root, 'package.json');
+    if ((0, node_fs_1.existsSync)(pkgPath)) {
+        try {
+            const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, 'utf8'));
+            description = pkg['description'] ?? '';
+            version = pkg['version'] ?? '0.0.0';
+            const addDeps = (obj, kind) => {
+                if (!obj)
+                    return;
+                for (const [dep, ver] of Object.entries(obj)) {
+                    dependencies.push({ name: dep, version: ver, kind });
+                }
+            };
+            addDeps(pkg['dependencies'], 'dep');
+            addDeps(pkg['devDependencies'], 'devDep');
+            addDeps(pkg['peerDependencies'], 'peer');
+        }
+        catch {
+            // ignore
+        }
+    }
+    // Top-level entries
+    let topLevelEntries = [];
+    let fileCount = 0;
+    try {
+        topLevelEntries = (0, node_fs_1.readdirSync)(root).filter((e) => !e.startsWith('.') && e !== 'node_modules');
+        // Count files recursively (limited scan)
+        fileCount = countFiles(root, 0, 3);
+    }
+    catch {
+        // ignore FS errors
+    }
+    const hasTypeScript = (0, node_fs_1.existsSync)((0, node_path_1.join)(root, 'tsconfig.json'));
+    const hasTests = (0, node_fs_1.existsSync)((0, node_path_1.join)(root, 'tests')) ||
+        (0, node_fs_1.existsSync)((0, node_path_1.join)(root, '__tests__')) ||
+        topLevelEntries.some((e) => e.endsWith('.test.ts') || e.endsWith('.spec.ts'));
+    return {
+        root,
+        name,
+        description,
+        version,
+        dependencies,
+        fileCount,
+        topLevelEntries,
+        hasTypeScript,
+        hasTests,
+    };
+}
+function countFiles(dir, depth, maxDepth) {
+    if (depth > maxDepth)
+        return 0;
+    let count = 0;
+    try {
+        const entries = (0, node_fs_1.readdirSync)(dir, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.name.startsWith('.') || e.name === 'node_modules' || e.name === 'dist')
+                continue;
+            if (e.isDirectory()) {
+                count += countFiles((0, node_path_1.join)(dir, e.name), depth + 1, maxDepth);
+            }
+            else {
+                count++;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return count;
+}
+function findCrossRepoDeps(repos) {
+    // Map dep → { repo, version }[]
+    const map = new Map();
+    for (const repo of repos) {
+        for (const dep of repo.dependencies) {
+            const arr = map.get(dep.name) ?? [];
+            arr.push({ repo: repo.name, version: dep.version });
+            map.set(dep.name, arr);
+        }
+    }
+    // Only return deps that appear in ≥2 repos
+    const crossDeps = [];
+    for (const [dep, entries] of map) {
+        if (entries.length < 2)
+            continue;
+        const repos = entries.map((e) => e.repo);
+        const versions = [...new Set(entries.map((e) => e.version))];
+        crossDeps.push({
+            dep,
+            repos,
+            versions,
+            versionConflict: versions.length > 1,
+        });
+    }
+    return crossDeps.sort((a, b) => {
+        if (a.versionConflict !== b.versionConflict)
+            return a.versionConflict ? -1 : 1;
+        return b.repos.length - a.repos.length;
+    });
+}
+function buildSummary(repos, crossDeps) {
+    const conflicts = crossDeps.filter((d) => d.versionConflict).length;
+    const lines = [
+        `${repos.length} repositor${repos.length === 1 ? 'y' : 'ies'} analysed`,
+        `${crossDeps.length} shared dependencies (${conflicts} version conflict${conflicts === 1 ? '' : 's'})`,
+        ...repos.map((r) => `  • ${r.name} v${r.version} — ${r.fileCount} files`),
+    ];
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+exports.multiRepoSkill = {
+    id: 'multi-repo',
+    name: 'Multi-Repo Analyser',
+    description: 'Aggregates file lists, package manifests and dependency graphs across multiple repositories for cross-repo analysis.',
+    version: '1.0.0',
+    enabled: true,
+    tags: ['monorepo', 'dx', 'dependencies', 'analysis'],
+    async execute(ctx) {
+        const opts = (ctx.graph ?? {});
+        const mode = opts['mode'] ?? 'summary';
+        // --- Repo list ---
+        let repos;
+        if (Array.isArray(opts['repoData'])) {
+            // Injectable for tests
+            repos = opts['repoData'];
+        }
+        else {
+            const extraRoots = Array.isArray(opts['repos']) ? opts['repos'] : [];
+            const allRoots = [ctx.projectRoot, ...extraRoots].filter(Boolean);
+            repos = allRoots.map(scanRepoRoot);
+        }
+        const crossDeps = findCrossRepoDeps(repos);
+        const summary = buildSummary(repos, crossDeps);
+        const result = {
+            mode,
+            repos,
+            crossDeps: mode === 'files' ? [] : crossDeps,
+            summary,
+        };
+        return {
+            success: true,
+            output: summary,
+            data: result,
+        };
+    },
+};
+//# sourceMappingURL=multi-repo.js.map

package/dist/cjs/skills/multi-repo.js.map

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

package/dist/cjs/skills/onboarding.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Skill: onboarding
+ *
+ * Generates an interactive onboarding tour for new developers:
+ *   - Annotated project tree
+ *   - Primary data-flow description
+ *   - Startup commands (from package.json scripts)
+ *   - Basic FAQ
+ *
+ * Input (via SkillContext.graph or ctx.files):
+ *   - `ctx.graph['format']`     — 'markdown' | 'text' (default: 'markdown')
+ *   - `ctx.graph['pkgJson']`    — parsed package.json object (injectable for tests)
+ *   - `ctx.graph['readmeText']` — README.md content (injectable for tests)
+ *   - `ctx.graph['fileTree']`   — string[] of relative file paths (overrides ctx.files)
+ *
+ * Output data:
+ *   - OnboardingReport
+ */
+import type { SkillModule } from '../types.js';
+export interface TreeNode {
+    name: string;
+    isDir: boolean;
+    annotation?: string;
+}
+export interface StartupCommand {
+    name: string;
+    command: string;
+    description: string;
+}
+export interface OnboardingReport {
+    projectName: string;
+    description: string;
+    tree: TreeNode[];
+    dataFlow: string[];
+    startupCommands: StartupCommand[];
+    faq: Array<{
+        q: string;
+        a: string;
+    }>;
+    format: 'markdown' | 'text';
+}
+export declare function buildTreeNodes(files: string[]): TreeNode[];
+export declare function extractStartupCommands(scripts: Record<string, string>): StartupCommand[];
+export declare function buildDataFlow(files: string[]): string[];
+export declare function renderMarkdown(report: OnboardingReport): string;
+export declare function renderText(report: OnboardingReport): string;
+export declare const onboardingSkill: SkillModule;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/cjs/skills/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../../src/skills/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,GAAG,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7B;AAiCD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAuB1D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,cAAc,EAAE,CAkBlB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAevD;AAqBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA4B/D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0B3D;AAMD,eAAO,MAAM,eAAe,EAAE,WAuE7B,CAAC"}