@openweave/weave-skills 1.0.0

package/dist/skills/perf-profile.js

@@ -0,0 +1,179 @@
+/**
+ * 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)
+ */
+// ---------------------------------------------------------------------------
+// Suggestions by category
+// ---------------------------------------------------------------------------
+const SUGGESTIONS = {
+    build: 'Enable incremental TypeScript builds (`incremental: true` in tsconfig). Consider `isolatedModules`.',
+    test: 'Use `--reporter=dot` or run only changed files with `--changed`. Parallelise across workers.',
+    bundle: 'Enable Vite/esbuild caching. Code-split large entry points. Analyse bundle with `rollup-plugin-visualizer`.',
+    lint: 'Use `lint-staged` to lint only staged files. Enable ESLint caching (`--cache`).',
+    install: 'Use `pnpm install --frozen-lockfile`. Cache `~/.pnpm-store` in CI. Audit dep count.',
+    other: 'Profile the step further to identify sub-task bottlenecks.',
+};
+// ---------------------------------------------------------------------------
+// Log-based timing extraction
+// ---------------------------------------------------------------------------
+const TIMING_PATTERNS = [
+    // GitHub Actions step duration: "##[group]Run pnpm build (3m 12s)"
+    {
+        pattern: /##\[group\](.+?)\s+\((\d+)m\s+(\d+)s\)/i,
+        label: (m) => m[1].trim(),
+        category: 'build',
+    },
+    // Generic "Step X completed in Ns" or "done in Ns"
+    {
+        pattern: /(?:completed in|done in|finished in)\s+(\d+(?:\.\d+)?)\s*s(?:ec(?:onds?)?)?/i,
+        label: (_m, line) => (line ?? 'step').trim().slice(0, 50),
+        category: 'other',
+    },
+    // Vitest / Jest duration: "Duration  12.34 s"
+    {
+        pattern: /Duration\s+(\d+(?:\.\d+)?)\s*s\b/i,
+        label: () => 'Test suite',
+        category: 'test',
+    },
+    // npm/pnpm install: "added N packages in Xs"
+    {
+        pattern: /added\s+\d+\s+packages?\s+in\s+(\d+(?:\.\d+)?)\s*s/i,
+        label: () => 'Package install',
+        category: 'install',
+    },
+    // tsc timing
+    {
+        pattern: /tsc\s+.*?(\d+(?:\.\d+)?)\s*s(?:ec)?/i,
+        label: () => 'TypeScript compile',
+        category: 'build',
+    },
+];
+export function extractTimingsFromLog(log) {
+    const lines = log.split('\n');
+    const entries = [];
+    for (const line of lines) {
+        for (const rule of TIMING_PATTERNS) {
+            const m = rule.pattern.exec(line);
+            if (!m)
+                continue;
+            // Try to parse duration
+            let durationMs = 0;
+            if (rule.pattern.source.includes('(\\d+)m')) {
+                // "Xm Ys" format
+                const mins = parseInt(m[2], 10);
+                const secs = parseInt(m[3], 10);
+                durationMs = (mins * 60 + secs) * 1000;
+            }
+            else {
+                // seconds as float
+                const secIdx = m.findIndex((v, i) => i > 0 && /^\d+(\.\d+)?$/.test(v ?? ''));
+                if (secIdx > 0) {
+                    durationMs = Math.round(parseFloat(m[secIdx]) * 1000);
+                }
+            }
+            if (durationMs > 0) {
+                entries.push({
+                    label: rule.label(m, line),
+                    durationMs,
+                    category: rule.category,
+                });
+                break;
+            }
+        }
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Analysis
+// ---------------------------------------------------------------------------
+export function analyseTimings(entries, threshold = 10_000) {
+    if (entries.length === 0) {
+        return {
+            entries: [],
+            bottlenecks: [],
+            totalMs: 0,
+            slowestStep: null,
+            summary: 'No timing data available',
+        };
+    }
+    const sorted = [...entries].sort((a, b) => b.durationMs - a.durationMs);
+    const slowest = sorted[0];
+    const totalMs = entries.reduce((sum, e) => sum + e.durationMs, 0);
+    const bottlenecks = sorted
+        .filter((e) => e.durationMs >= threshold / 2) // surface anything ≥ half the threshold
+        .map((e) => {
+        let severity = 'info';
+        if (e.durationMs >= threshold)
+            severity = 'critical';
+        else if (e.durationMs >= threshold * 0.6)
+            severity = 'warning';
+        return {
+            label: e.label,
+            durationMs: e.durationMs,
+            category: e.category,
+            severity,
+            suggestion: SUGGESTIONS[e.category],
+        };
+    });
+    const criticals = bottlenecks.filter((b) => b.severity === 'critical').length;
+    const summary = criticals > 0
+        ? `❌ ${criticals} step(s) exceed ${threshold / 1000}s threshold — total pipeline: ${(totalMs / 1000).toFixed(1)}s`
+        : `✅ All steps within threshold — total: ${(totalMs / 1000).toFixed(1)}s`;
+    return { entries, bottlenecks, totalMs, slowestStep: slowest, summary };
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const perfProfileSkill = {
+    id: 'perf-profile',
+    name: 'Perf Profiler',
+    description: 'Analyses build/test/bundle timing data and surfaces bottlenecks with optimisation suggestions',
+    version: '1.0.0',
+    enabled: false,
+    tags: ['devops', 'performance'],
+    async execute(ctx) {
+        const opts = ctx.graph ?? {};
+        const threshold = typeof opts['threshold'] === 'number' ? opts['threshold'] : 10_000;
+        let entries = [];
+        if (Array.isArray(opts['timings'])) {
+            entries = opts['timings'];
+        }
+        else if (typeof opts['ciLog'] === 'string') {
+            entries = extractTimingsFromLog(opts['ciLog']);
+        }
+        const report = analyseTimings(entries, threshold);
+        const lines = [
+            `⏱  Perf Profiler — ${report.entries.length} timing entries`,
+            `   ${report.summary}`,
+            '',
+        ];
+        if (report.bottlenecks.length > 0) {
+            lines.push('  BOTTLENECKS (slowest first):');
+            for (const b of report.bottlenecks) {
+                const icon = b.severity === 'critical' ? '❌' : b.severity === 'warning' ? '⚠️ ' : 'ℹ️ ';
+                const dur = b.durationMs >= 60_000
+                    ? `${(b.durationMs / 60_000).toFixed(1)}m`
+                    : `${(b.durationMs / 1000).toFixed(1)}s`;
+                lines.push(`  ${icon} ${b.label} [${b.category}] — ${dur}`);
+                lines.push(`     💡 ${b.suggestion}`);
+                lines.push('');
+            }
+        }
+        else {
+            lines.push('  ✅ No bottlenecks detected.');
+        }
+        return {
+            success: report.bottlenecks.filter((b) => b.severity === 'critical').length === 0,
+            output: lines.join('\n'),
+            data: report,
+        };
+    },
+};
+//# sourceMappingURL=perf-profile.js.map

package/dist/skills/perf-profile.js.map

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

package/dist/skills/pipeline-aware.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skill: pipeline-aware
+ *
+ * Parses CI/CD log output (GitHub Actions, GitLab CI, generic) and produces a
+ * structured diagnosis: root cause, failing step, and a suggested remediation.
+ *
+ * Input options (ctx.graph):
+ *   - `log`      {string}  — inject raw log content directly (for tests / piping)
+ *   - `logFile`  {string}  — absolute path to a log file to read
+ *   - `platform` {'github'|'gitlab'|'auto'} — hint for parser (default: 'auto')
+ */
+import type { SkillModule } from '../types.js';
+export type CIPlatform = 'github' | 'gitlab' | 'generic';
+export type FailureCategory = 'test-failure' | 'build-error' | 'lint-error' | 'permission-error' | 'network-error' | 'config-error' | 'timeout' | 'unknown';
+export interface CIFailure {
+    step: string;
+    category: FailureCategory;
+    severity: 'critical' | 'high' | 'medium';
+    message: string;
+    context: string;
+    suggestion: string;
+}
+export interface PipelineReport {
+    platform: CIPlatform;
+    status: 'passed' | 'failed' | 'unknown';
+    failures: CIFailure[];
+    totalLines: number;
+    summary: string;
+}
+export declare function detectPlatform(log: string): CIPlatform;
+export declare function parsePipelineLog(log: string, platform?: CIPlatform): PipelineReport;
+export declare const pipelineAwareSkill: SkillModule;
+//# sourceMappingURL=pipeline-aware.d.ts.map

package/dist/skills/pipeline-aware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-aware.d.ts","sourceRoot":"","sources":["../../src/skills/pipeline-aware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAM1E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAItD;AAgID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,cAAc,CAwCnF;AAMD,eAAO,MAAM,kBAAkB,EAAE,WAyDhC,CAAC"}

package/dist/skills/pipeline-aware.js

@@ -0,0 +1,226 @@
+/**
+ * Skill: pipeline-aware
+ *
+ * Parses CI/CD log output (GitHub Actions, GitLab CI, generic) and produces a
+ * structured diagnosis: root cause, failing step, and a suggested remediation.
+ *
+ * Input options (ctx.graph):
+ *   - `log`      {string}  — inject raw log content directly (for tests / piping)
+ *   - `logFile`  {string}  — absolute path to a log file to read
+ *   - `platform` {'github'|'gitlab'|'auto'} — hint for parser (default: 'auto')
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Platform detection
+// ---------------------------------------------------------------------------
+export function detectPlatform(log) {
+    if (/##\[group\]|##\[error\]|##\[warning\]|::(?:error|warning|notice|debug)(?:::|[ ,])/i.test(log))
+        return 'github';
+    if (/Running with gitlab-runner|CI_JOB_ID|GITLAB_CI/i.test(log))
+        return 'gitlab';
+    return 'generic';
+}
+const PATTERNS = [
+    // GitHub Actions step failure
+    {
+        pattern: /##\[error\](.+)/i,
+        category: 'build-error',
+        severity: 'critical',
+        step: (_m, line) => line,
+        suggestion: 'Check the full Actions log for the step that emitted ##[error]. Expand collapsed groups.',
+    },
+    {
+        pattern: /::error (?:file=([^,]+),)?[^:]*::(.+)/i,
+        category: 'build-error',
+        severity: 'critical',
+        step: (m) => m[1] ?? 'unknown file',
+        suggestion: 'Fix the reported error in the specified file and re-run the workflow.',
+    },
+    // Test failures
+    {
+        pattern: /\b(\d+)\s+(?:test(?:s)?|spec(?:s)?)\s+failed\b/i,
+        category: 'test-failure',
+        severity: 'critical',
+        step: (_m, line) => line.trim().slice(0, 60),
+        suggestion: 'Run the test suite locally with the same Node/Python version to reproduce and fix failures.',
+    },
+    {
+        pattern: /FAIL\s+([\w/.-]+\.(?:test|spec)\.[jt]sx?)/i,
+        category: 'test-failure',
+        severity: 'critical',
+        step: (m) => m[1],
+        suggestion: `Run \`npx vitest run ${'{file}'}\` locally to reproduce the test failure.`,
+    },
+    {
+        pattern: /AssertionError|expect\(.+\)\.to(?:Be|Equal|Throw)|FAILED|✕/,
+        category: 'test-failure',
+        severity: 'high',
+        step: (_m, line) => line.trim().slice(0, 60),
+        suggestion: 'Inspect the failed assertion — check mocks, fixtures and async handling.',
+    },
+    // TypeScript / build errors
+    {
+        pattern: /error TS(\d+):\s*(.+)/i,
+        category: 'build-error',
+        severity: 'critical',
+        step: (m) => `TS${m[1]}`,
+        suggestion: 'Fix the TypeScript compilation error. Run `tsc --noEmit` locally for the full list.',
+    },
+    {
+        pattern: /Cannot find module '([^']+)'/i,
+        category: 'build-error',
+        severity: 'critical',
+        step: (m) => m[1],
+        suggestion: 'Run `pnpm install` or add the missing package to package.json dependencies.',
+    },
+    // Lint errors
+    {
+        pattern: /ESLint: (\d+) error/i,
+        category: 'lint-error',
+        severity: 'high',
+        step: (_m, line) => line.trim().slice(0, 60),
+        suggestion: 'Run `pnpm lint --fix` locally to auto-fix lint errors before pushing.',
+    },
+    // Permission / auth errors
+    {
+        pattern: /permission denied|EACCES|403 Forbidden|401 Unauthorized/i,
+        category: 'permission-error',
+        severity: 'critical',
+        step: (_m, line) => line.trim().slice(0, 60),
+        suggestion: 'Check repository secrets and Action permissions (Settings → Actions → Workflow permissions).',
+    },
+    // Network errors
+    {
+        pattern: /ECONNREFUSED|ETIMEDOUT|getaddrinfo ENOTFOUND|npm ERR! network/i,
+        category: 'network-error',
+        severity: 'high',
+        step: (_m, line) => line.trim().slice(0, 60),
+        suggestion: 'Transient network failure — retry the job. If persistent, check npm registry or VPN settings.',
+    },
+    // Timeout
+    {
+        pattern: /exceeded the timeout|timed out after|##\[warning\]Approaching timeout/i,
+        category: 'timeout',
+        severity: 'high',
+        step: (_m, line) => line.trim().slice(0, 60),
+        suggestion: 'Increase `timeout-minutes` in the job definition or optimise the slow step.',
+    },
+    // Exit code
+    {
+        pattern: /Process completed with exit code (\d+)/i,
+        category: 'unknown',
+        severity: 'critical',
+        step: (m) => `exit code ${m[1]}`,
+        suggestion: 'Non-zero exit code from process. Scroll up in the log to find the originating error.',
+    },
+    // GitLab-style
+    {
+        pattern: /ERROR:\s+(.+)/,
+        category: 'build-error',
+        severity: 'high',
+        step: (m) => m[1].slice(0, 60),
+        suggestion: 'Investigate the ERROR line above for the root cause.',
+    },
+    {
+        pattern: /Job failed: (.+)/i,
+        category: 'unknown',
+        severity: 'critical',
+        step: (m) => m[1].slice(0, 60),
+        suggestion: 'Check the GitLab job trace for the step that triggered the failure.',
+    },
+];
+// ---------------------------------------------------------------------------
+// Core parser
+// ---------------------------------------------------------------------------
+export function parsePipelineLog(log, platform) {
+    const lines = log.split('\n');
+    const resolvedPlatform = platform ?? detectPlatform(log);
+    const failures = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const rule of PATTERNS) {
+            const m = rule.pattern.exec(line);
+            if (!m)
+                continue;
+            // Gather surrounding context (up to 3 lines before/after)
+            const ctxStart = Math.max(0, i - 2);
+            const ctxEnd = Math.min(lines.length - 1, i + 2);
+            const context = lines.slice(ctxStart, ctxEnd + 1).join('\n');
+            const suggestion = rule.suggestion.replace('{file}', m[1] ?? 'file');
+            failures.push({
+                step: rule.step(m, line),
+                category: rule.category,
+                severity: rule.severity,
+                message: line.trim().slice(0, 120),
+                context,
+                suggestion,
+            });
+            break; // one rule match per line
+        }
+    }
+    const status = failures.length === 0 ? 'passed' : 'failed';
+    const criticals = failures.filter((f) => f.severity === 'critical').length;
+    const highs = failures.filter((f) => f.severity === 'high').length;
+    const summary = status === 'passed'
+        ? '✅ No failure patterns detected'
+        : `❌ ${criticals} critical, ${highs} high-severity failure(s) detected`;
+    return { platform: resolvedPlatform, status, failures, totalLines: lines.length, summary };
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const pipelineAwareSkill = {
+    id: 'pipeline-aware',
+    name: 'Pipeline Aware',
+    description: 'Parses CI/CD logs (GitHub Actions, GitLab) and produces structured failure diagnosis with root-cause suggestions',
+    version: '1.0.0',
+    enabled: false,
+    tags: ['devops', 'ci'],
+    async execute(ctx) {
+        const opts = ctx.graph ?? {};
+        let log = '';
+        if (typeof opts['log'] === 'string') {
+            log = opts['log'];
+        }
+        else if (typeof opts['logFile'] === 'string') {
+            const absPath = opts['logFile'].startsWith('/')
+                ? opts['logFile']
+                : join(ctx.projectRoot, opts['logFile']);
+            if (!existsSync(absPath)) {
+                return { success: false, output: `❌ Log file not found: ${absPath}`, error: 'log file not found' };
+            }
+            log = readFileSync(absPath, 'utf-8');
+        }
+        else {
+            return { success: false, output: '❌ Provide `log` (string) or `logFile` (path) via ctx.graph', error: 'no log input' };
+        }
+        const platform = typeof opts['platform'] === 'string'
+            ? opts['platform']
+            : undefined;
+        const report = parsePipelineLog(log, platform);
+        const lines = [
+            `🔍 Pipeline Aware — ${report.platform.toUpperCase()} (${report.totalLines} lines)`,
+            `   ${report.summary}`,
+            '',
+        ];
+        if (report.failures.length > 0) {
+            for (const f of report.failures.slice(0, 10)) {
+                const icon = f.severity === 'critical' ? '❌' : f.severity === 'high' ? '⚠️ ' : 'ℹ️ ';
+                lines.push(`  ${icon} [${f.category}] ${f.step}`);
+                lines.push(`     ${f.message.slice(0, 80)}`);
+                lines.push(`     💡 ${f.suggestion}`);
+                lines.push('');
+            }
+            if (report.failures.length > 10) {
+                lines.push(`  … and ${report.failures.length - 10} more failure(s)`);
+            }
+        }
+        return {
+            success: report.status !== 'failed',
+            output: lines.join('\n'),
+            data: report,
+        };
+    },
+};
+//# sourceMappingURL=pipeline-aware.js.map

package/dist/skills/pipeline-aware.js.map

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

package/dist/skills/refactor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skill: refactor
+ *
+ * Detects common code smells in TypeScript source files and produces a prioritised
+ * list of refactoring suggestions. Purely static / heuristic — no AST required.
+ *
+ * Detects:
+ *   - Long functions     (> LONG_FUNCTION_LINES lines between opening { and matching })
+ *   - Large files        (> LARGE_FILE_LINES total lines)
+ *   - Magic numbers      (numeric literals that are not 0, 1, -1, 2, 100)
+ *   - Deep nesting       (indentation depth > MAX_NESTING spaces / 2)
+ *   - Long parameter lists (> MAX_PARAMS parameters in a function signature)
+ *   - TODO / FIXME / HACK comments
+ *   - Duplicate imports  (same module imported more than once)
+ */
+import type { SkillModule } from '../types.js';
+export type SmellKind = 'long-function' | 'large-file' | 'magic-number' | 'deep-nesting' | 'long-param-list' | 'todo-comment' | 'duplicate-import';
+export interface RefactorSmell {
+    file: string;
+    line: number;
+    kind: SmellKind;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    detail?: string;
+}
+export interface RefactorResult {
+    smells: RefactorSmell[];
+    filesAnalyzed: number;
+    summary: Record<SmellKind, number>;
+}
+export declare function detectSmells(source: string, filePath: string): RefactorSmell[];
+export declare const refactorSkill: SkillModule;
+//# sourceMappingURL=refactor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refactor.d.ts","sourceRoot":"","sources":["../../src/skills/refactor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAe1E,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,kBAAkB,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;CACpC;AAMD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAwI9E;AAMD,eAAO,MAAM,aAAa,EAAE,WA0D3B,CAAC"}