@openweave/weave-skills 1.0.0

package/dist/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/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/skills/multi-repo.js

@@ -0,0 +1,175 @@
+/**
+ * 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 { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function scanRepoRoot(root) {
+    const name = basename(root);
+    let description = '';
+    let version = '0.0.0';
+    const dependencies = [];
+    // Read package.json
+    const pkgPath = join(root, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(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 = 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 = existsSync(join(root, 'tsconfig.json'));
+    const hasTests = existsSync(join(root, 'tests')) ||
+        existsSync(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 = 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(join(dir, e.name), depth + 1, maxDepth);
+            }
+            else {
+                count++;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return count;
+}
+export 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;
+    });
+}
+export 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
+// ---------------------------------------------------------------------------
+export const 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/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/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/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"}

package/dist/skills/onboarding.js

@@ -0,0 +1,245 @@
+/**
+ * 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 { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const DIR_ANNOTATIONS = {
+    'src': 'Source code',
+    'packages': 'Workspace packages (monorepo)',
+    'apps': 'Application entry points',
+    'docs': 'Documentation',
+    'scripts': 'Dev & deploy scripts',
+    'tests': 'Test suites',
+    '__tests__': 'Test suites',
+    'dist': 'Compiled output (generated)',
+    'node_modules': 'Dependencies (generated)',
+    '.github': 'CI/CD workflows',
+    '.weave': 'OpenWeave session data',
+};
+const FILE_ANNOTATIONS = {
+    'package.json': 'Project manifest & npm scripts',
+    'tsconfig.json': 'TypeScript compiler config',
+    'README.md': 'Project documentation',
+    'ROADMAP.md': 'Development roadmap',
+    'LICENSE': 'License terms',
+    '.env.example': 'Environment variable template',
+    'docker-compose.yml': 'Docker services config',
+    'Dockerfile': 'Container build instructions',
+    'vitest.config.ts': 'Vitest test runner config',
+    'pnpm-workspace.yaml': 'pnpm workspace definition',
+};
+export function buildTreeNodes(files) {
+    const seen = new Set();
+    const nodes = [];
+    for (const f of files) {
+        const parts = f.split('/');
+        // Add top-level dirs & files
+        const top = parts[0];
+        if (!seen.has(top)) {
+            seen.add(top);
+            const isDir = parts.length > 1;
+            nodes.push({
+                name: top,
+                isDir,
+                annotation: isDir ? DIR_ANNOTATIONS[top] : FILE_ANNOTATIONS[top],
+            });
+        }
+    }
+    return nodes.sort((a, b) => {
+        if (a.isDir !== b.isDir)
+            return a.isDir ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+}
+export function extractStartupCommands(scripts) {
+    const KNOWN = {
+        dev: 'Start development server with hot-reload',
+        start: 'Start production server',
+        build: 'Compile TypeScript / bundle assets',
+        test: 'Run test suite',
+        lint: 'Run linter (ESLint / tsc --noEmit)',
+        format: 'Format source files (Prettier)',
+        clean: 'Remove build artifacts',
+    };
+    return Object.entries(scripts)
+        .filter(([name]) => KNOWN[name] !== undefined)
+        .map(([name, _command]) => ({
+        name,
+        command: `pnpm ${name}`,
+        description: KNOWN[name],
+    }));
+}
+export function buildDataFlow(files) {
+    const hasMcp = files.some((f) => f.includes('mcp-server') || f.includes('weave-link'));
+    const hasAgent = files.some((f) => f.includes('agent-core') || f.includes('AgentCore'));
+    const hasGraph = files.some((f) => f.includes('weave-graph') || f.includes('WeaveGraph'));
+    const hasEmbed = files.some((f) => f.includes('weave-embed'));
+    const hasDash = files.some((f) => f.includes('weave-dashboard') || f.includes('dashboard'));
+    const flow = [];
+    if (hasAgent)
+        flow.push('User input → AgentCore (ReAct loop)');
+    if (hasMcp)
+        flow.push('AgentCore → ToolRegistry → WeaveLink MCP Server');
+    if (hasGraph)
+        flow.push('Tool calls → WeaveGraph (knowledge persistence)');
+    if (hasEmbed)
+        flow.push('WeaveGraph ↔ EmbeddingService (semantic search)');
+    if (hasDash)
+        flow.push('WeaveGraph → Dashboard (REST API + SSE)');
+    if (flow.length === 0)
+        flow.push('See README.md for architecture overview');
+    return flow;
+}
+const DEFAULT_FAQ = [
+    {
+        q: 'How do I start the project?',
+        a: 'Run `pnpm install` then `pnpm dev` (or `pnpm start`) in the repo root.',
+    },
+    {
+        q: 'How do I run tests?',
+        a: 'Run `pnpm test` in the repo root, or `pnpm --filter <package> test` for a single package.',
+    },
+    {
+        q: 'Where is the configuration?',
+        a: 'Project config lives in `.weave.config.json` at the repo root. Copy `.env.example` to `.env` for secrets.',
+    },
+    {
+        q: 'How do I add a new skill?',
+        a: 'Create a new file in `packages/weave-skills/src/skills/`, export a `SkillModule`, and register it in the barrel index.',
+    },
+];
+export function renderMarkdown(report) {
+    const lines = [
+        `# 👋 Welcome to **${report.projectName}**`,
+        '',
+        `> ${report.description}`,
+        '',
+        '## 📁 Project Structure',
+        '',
+        ...report.tree.map((n) => `- ${n.isDir ? '📂' : '📄'} \`${n.name}${n.isDir ? '/' : ''}\`${n.annotation ? ` — ${n.annotation}` : ''}`),
+        '',
+        '## 🔄 Data Flow',
+        '',
+        ...report.dataFlow.map((line) => `1. ${line}`),
+        '',
+        '## 🚀 Getting Started',
+        '',
+        ...report.startupCommands.map((cmd) => `- \`${cmd.command}\` — ${cmd.description}`),
+        '',
+        '## ❓ FAQ',
+        '',
+        ...report.faq.flatMap((item) => [`**Q: ${item.q}**`, `A: ${item.a}`, '']),
+    ];
+    return lines.join('\n');
+}
+export function renderText(report) {
+    const lines = [
+        `Welcome to ${report.projectName}`,
+        `${'='.repeat(report.projectName.length + 11)}`,
+        '',
+        report.description,
+        '',
+        'PROJECT STRUCTURE',
+        '-----------------',
+        ...report.tree.map((n) => `  ${n.name}${n.isDir ? '/' : ''}${n.annotation ? ` (${n.annotation})` : ''}`),
+        '',
+        'DATA FLOW',
+        '---------',
+        ...report.dataFlow.map((l, i) => `  ${i + 1}. ${l}`),
+        '',
+        'GETTING STARTED',
+        '---------------',
+        ...report.startupCommands.map((cmd) => `  ${cmd.command}  — ${cmd.description}`),
+        '',
+        'FAQ',
+        '---',
+        ...report.faq.flatMap((item) => [`Q: ${item.q}`, `A: ${item.a}`, '']),
+    ];
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const onboardingSkill = {
+    id: 'onboarding',
+    name: 'Onboarding Tour Generator',
+    description: 'Generates an annotated project tree, data-flow overview, startup commands and FAQ for new developers.',
+    version: '1.0.0',
+    enabled: true,
+    tags: ['dx', 'documentation', 'onboarding'],
+    async execute(ctx) {
+        const graph = (ctx.graph ?? {});
+        const format = graph['format'] ?? 'markdown';
+        // --- Load package.json ---
+        let pkgName = 'Project';
+        let pkgDescription = 'No description provided.';
+        let scripts = {};
+        if (graph['pkgJson']) {
+            const pkg = graph['pkgJson'];
+            pkgName = pkg['name'] ?? pkgName;
+            pkgDescription = pkg['description'] ?? pkgDescription;
+            scripts = pkg['scripts'] ?? {};
+        }
+        else {
+            const pkgPath = join(ctx.projectRoot, 'package.json');
+            if (existsSync(pkgPath)) {
+                try {
+                    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+                    pkgName = pkg['name'] ?? pkgName;
+                    pkgDescription = pkg['description'] ?? pkgDescription;
+                    scripts = pkg['scripts'] ?? {};
+                }
+                catch {
+                    // ignore parse errors
+                }
+            }
+        }
+        // Override description from README if available
+        if (!graph['pkgJson'] && graph['readmeText']) {
+            const firstLine = graph['readmeText'].split('\n').find((l) => l.trim() && !l.startsWith('#'));
+            if (firstLine)
+                pkgDescription = firstLine.trim();
+        }
+        // --- File tree ---
+        const rawFiles = Array.isArray(graph['fileTree'])
+            ? graph['fileTree']
+            : ctx.files;
+        const tree = buildTreeNodes(rawFiles);
+        const dataFlow = buildDataFlow(rawFiles);
+        const startupCommands = extractStartupCommands(scripts);
+        const report = {
+            projectName: pkgName,
+            description: pkgDescription,
+            tree,
+            dataFlow,
+            startupCommands,
+            faq: DEFAULT_FAQ,
+            format,
+        };
+        const rendered = format === 'markdown' ? renderMarkdown(report) : renderText(report);
+        return {
+            success: true,
+            output: `Onboarding tour generated for "${pkgName}" — ${tree.length} tree nodes, ${startupCommands.length} startup commands`,
+            data: { report, rendered },
+        };
+    },
+};
+//# sourceMappingURL=onboarding.js.map

package/dist/skills/onboarding.js.map

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

package/dist/skills/perf-profile.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Skill: perf-profile
+ *
+ * Analyses build, test and bundle timing data and produces a prioritised
+ * table of bottlenecks with actionable suggestions.
+ *
+ * Input options (ctx.graph):
+ *   - `timings`    {TimingEntry[]}  — inject timing data directly (tests / CI JSON)
+ *   - `ciLog`      {string}         — parse timing information from a raw CI log
+ *   - `threshold`  {number}         — ms threshold to flag a step as slow (default: 10_000)
+ */
+import type { SkillModule } from '../types.js';
+export interface TimingEntry {
+    label: string;
+    durationMs: number;
+    category: 'build' | 'test' | 'bundle' | 'lint' | 'install' | 'other';
+    package?: string;
+}
+export interface Bottleneck {
+    label: string;
+    durationMs: number;
+    category: TimingEntry['category'];
+    severity: 'critical' | 'warning' | 'info';
+    suggestion: string;
+}
+export interface PerfReport {
+    entries: TimingEntry[];
+    bottlenecks: Bottleneck[];
+    totalMs: number;
+    slowestStep: TimingEntry | null;
+    summary: string;
+}
+export declare function extractTimingsFromLog(log: string): TimingEntry[];
+export declare function analyseTimings(entries: TimingEntry[], threshold?: number): PerfReport;
+export declare const perfProfileSkill: SkillModule;
+//# sourceMappingURL=perf-profile.d.ts.map

package/dist/skills/perf-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-profile.d.ts","sourceRoot":"","sources":["../../src/skills/perf-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAClC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAwDD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAoChE;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,SAAS,GAAG,UAAU,CAqCrF;AAMD,eAAO,MAAM,gBAAgB,EAAE,WAiD9B,CAAC"}