@openweave/weave-skills 1.0.0

package/dist/skills/refactor.js

@@ -0,0 +1,210 @@
+/**
+ * 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 { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants (overridable via ctx.graph)
+// ---------------------------------------------------------------------------
+const LONG_FUNCTION_LINES = 40;
+const LARGE_FILE_LINES = 300;
+const MAX_NESTING = 4; // levels (each ~2 spaces, so 8 spaces indent)
+const MAX_PARAMS = 4;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function detectSmells(source, filePath) {
+    const lines = source.split('\n');
+    const smells = [];
+    // ── Large file ──────────────────────────────────────────────────────────
+    if (lines.length > LARGE_FILE_LINES) {
+        smells.push({
+            file: filePath,
+            line: 1,
+            kind: 'large-file',
+            severity: 'warning',
+            message: `File has ${lines.length} lines (threshold: ${LARGE_FILE_LINES})`,
+        });
+    }
+    // ── Duplicate imports ────────────────────────────────────────────────────
+    const importSeen = new Map(); // module → first line
+    const IMPORT_RE = /^\s*import\s+.+\s+from\s+['"]([^'"]+)['"]/;
+    for (let i = 0; i < lines.length; i++) {
+        const m = IMPORT_RE.exec(lines[i]);
+        if (!m)
+            continue;
+        const mod = m[1];
+        if (importSeen.has(mod)) {
+            smells.push({
+                file: filePath,
+                line: i + 1,
+                kind: 'duplicate-import',
+                severity: 'warning',
+                message: `Duplicate import of '${mod}' (first seen at line ${importSeen.get(mod)})`,
+            });
+        }
+        else {
+            importSeen.set(mod, i + 1);
+        }
+    }
+    // ── Per-line checks ──────────────────────────────────────────────────────
+    const funcStack = [];
+    let braceDepth = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNo = i + 1;
+        const trimmed = line.trimStart();
+        // TODO / FIXME / HACK
+        if (/\b(TODO|FIXME|HACK|XXX)\b/.test(trimmed)) {
+            smells.push({
+                file: filePath,
+                line: lineNo,
+                kind: 'todo-comment',
+                severity: 'info',
+                message: `TODO/FIXME comment at line ${lineNo}`,
+                detail: trimmed.slice(0, 80),
+            });
+        }
+        // Magic numbers
+        // Exclude: 0, 1, -1, 2, 100, numbers inside imports/require, pure number literals in tests
+        const MAGIC_RE = /(?<![.\w])(-?\b(?:[3-9]\d*|1\d+|2\d+)\b)(?!\s*[%,]?\s*\/\*)/g;
+        const isCommentLine = trimmed.startsWith('//') || trimmed.startsWith('*');
+        const isImportLine = /^\s*import\s/.test(line) || /require\(/.test(line);
+        if (!isCommentLine && !isImportLine) {
+            let mm;
+            while ((mm = MAGIC_RE.exec(line)) !== null) {
+                const num = Number(mm[1]);
+                if (Number.isFinite(num) && Math.abs(num) > 1 && num !== 100) {
+                    smells.push({
+                        file: filePath,
+                        line: lineNo,
+                        kind: 'magic-number',
+                        severity: 'info',
+                        message: `Magic number ${mm[1]} — consider extracting to a named constant`,
+                    });
+                }
+            }
+        }
+        // Deep nesting — count leading spaces (2 spaces = 1 level)
+        const indent = line.length - trimmed.length;
+        const nestLevel = Math.floor(indent / 2);
+        if (nestLevel > MAX_NESTING && trimmed.length > 0 && !isCommentLine) {
+            smells.push({
+                file: filePath,
+                line: lineNo,
+                kind: 'deep-nesting',
+                severity: 'warning',
+                message: `Nesting depth ${nestLevel} exceeds threshold (${MAX_NESTING})`,
+            });
+        }
+        // Long parameter lists in function/method signatures
+        const PARAM_RE = /(?:function\s+\w+|(?:\w+)\s*=\s*(?:async\s+)?\()\s*([^)]{30,})\)/;
+        const paramMatch = PARAM_RE.exec(line);
+        if (paramMatch) {
+            const params = paramMatch[1].split(',').filter((p) => p.trim().length > 0);
+            if (params.length > MAX_PARAMS) {
+                smells.push({
+                    file: filePath,
+                    line: lineNo,
+                    kind: 'long-param-list',
+                    severity: 'warning',
+                    message: `Function has ${params.length} parameters (threshold: ${MAX_PARAMS}) — consider an options object`,
+                });
+            }
+        }
+        // Brace tracking for long-function detection
+        const opens = (line.match(/\{/g) ?? []).length;
+        const closes = (line.match(/\}/g) ?? []).length;
+        // Detect function start
+        const FUNC_START_RE = /(?:(?:export\s+)?(?:async\s+)?function\s+(\w+)|(?:(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\([^)]*\)\s*(?:=>\s*)?\{))/;
+        const funcMatch = FUNC_START_RE.exec(line);
+        if (funcMatch && line.includes('{')) {
+            funcStack.push({ startLine: lineNo, name: funcMatch[1] ?? funcMatch[2] ?? '(anonymous)', depth: braceDepth });
+        }
+        braceDepth += opens - closes;
+        // Check if function closed
+        while (funcStack.length > 0 && braceDepth <= funcStack[funcStack.length - 1].depth) {
+            const fn = funcStack.pop();
+            const length = lineNo - fn.startLine + 1;
+            if (length > LONG_FUNCTION_LINES) {
+                smells.push({
+                    file: filePath,
+                    line: fn.startLine,
+                    kind: 'long-function',
+                    severity: 'warning',
+                    message: `Function '${fn.name}' is ${length} lines long (threshold: ${LONG_FUNCTION_LINES})`,
+                });
+            }
+        }
+    }
+    return smells;
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const refactorSkill = {
+    id: 'refactor',
+    name: 'Refactor Advisor',
+    description: 'Detects code smells (long functions, magic numbers, deep nesting, large files, etc.) and suggests refactoring',
+    version: '1.0.0',
+    enabled: false,
+    tags: ['dev', 'quality'],
+    async execute(ctx) {
+        const tsFiles = ctx.files.filter((f) => f.endsWith('.ts') && !f.endsWith('.test.ts') && !f.endsWith('.d.ts') && !f.includes('/dist/'));
+        const smells = [];
+        for (const relPath of tsFiles) {
+            const absPath = join(ctx.projectRoot, relPath);
+            if (!existsSync(absPath))
+                continue;
+            try {
+                const content = readFileSync(absPath, 'utf-8');
+                smells.push(...detectSmells(content, relPath));
+            }
+            catch { /* skip unreadable */ }
+        }
+        // Summary
+        const summary = {};
+        for (const s of smells) {
+            summary[s.kind] = (summary[s.kind] ?? 0) + 1;
+        }
+        const errors = smells.filter((s) => s.severity === 'error').length;
+        const warnings = smells.filter((s) => s.severity === 'warning').length;
+        const infos = smells.filter((s) => s.severity === 'info').length;
+        const lines = [
+            `♻️  Refactor Advisor — ${tsFiles.length} files analyzed`,
+            `   ${errors} error(s), ${warnings} warning(s), ${infos} info(s)`,
+            '',
+        ];
+        const SEVERITY_ORDER = ['error', 'warning', 'info'];
+        for (const sev of SEVERITY_ORDER) {
+            const group = smells.filter((s) => s.severity === sev);
+            if (group.length === 0)
+                continue;
+            lines.push(`  ${sev.toUpperCase()}S:`);
+            for (const s of group.slice(0, 15)) {
+                lines.push(`    ${s.file}:${s.line} [${s.kind}] ${s.message}`);
+            }
+            if (group.length > 15)
+                lines.push(`    … and ${group.length - 15} more`);
+            lines.push('');
+        }
+        return {
+            success: true,
+            output: lines.join('\n'),
+            data: { smells, filesAnalyzed: tsFiles.length, summary },
+        };
+    },
+};
+//# sourceMappingURL=refactor.js.map

package/dist/skills/refactor.js.map

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

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

@@ -0,0 +1,36 @@
+/**
+ * Skill: test-gen
+ *
+ * Detects exported TypeScript functions and classes that have no corresponding
+ * test file, then generates Vitest-compatible test stubs.
+ *
+ * Strategy:
+ *   1. Walk ctx.files for *.ts files (excluding *.test.ts and *.d.ts)
+ *   2. For each source file, check if a <name>.test.ts exists next to it
+ *   3. Parse exported function/class names via regex (fast, no full AST)
+ *   4. Generate a stub test file matching the project's Vitest patterns
+ *
+ * Output data:
+ *   - untested: UncoveredFile[]    — files with no test counterpart
+ *   - stubs: TestStub[]           — generated test stubs (not written to disk)
+ */
+import type { SkillModule } from '../types.js';
+export interface UncoveredFile {
+    sourcePath: string;
+    exports: string[];
+}
+export interface TestStub {
+    testFilePath: string;
+    sourcePath: string;
+    content: string;
+}
+export interface TestGenResult {
+    untested: UncoveredFile[];
+    stubs: TestStub[];
+    totalSourceFiles: number;
+    testedCount: number;
+}
+export declare function extractExports(content: string): string[];
+export declare function generateStub(sourcePath: string, exportNames: string[]): string;
+export declare const testGenSkill: SkillModule;
+//# sourceMappingURL=test-gen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-gen.d.ts","sourceRoot":"","sources":["../../src/skills/test-gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAYD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBxD;AAQD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA8B9E;AAMD,eAAO,MAAM,YAAY,EAAE,WAkF1B,CAAC"}

package/dist/skills/test-gen.js

@@ -0,0 +1,154 @@
+/**
+ * Skill: test-gen
+ *
+ * Detects exported TypeScript functions and classes that have no corresponding
+ * test file, then generates Vitest-compatible test stubs.
+ *
+ * Strategy:
+ *   1. Walk ctx.files for *.ts files (excluding *.test.ts and *.d.ts)
+ *   2. For each source file, check if a <name>.test.ts exists next to it
+ *   3. Parse exported function/class names via regex (fast, no full AST)
+ *   4. Generate a stub test file matching the project's Vitest patterns
+ *
+ * Output data:
+ *   - untested: UncoveredFile[]    — files with no test counterpart
+ *   - stubs: TestStub[]           — generated test stubs (not written to disk)
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join, dirname, basename, extname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const EXPORT_FN_RE = /^export\s+(?:async\s+)?function\s+(\w+)/gm;
+const EXPORT_CLASS_RE = /^export\s+(?:abstract\s+)?class\s+(\w+)/gm;
+const EXPORT_CONST_FN_RE = /^export\s+(?:const|let)\s+(\w+)\s*[=:]/gm;
+const EXPORT_DEFAULT_RE = /^export\s+default\s+(?:function\s+)?(\w+)/gm;
+const REEXPORT_RE = /^export\s*\{[^}]+\}\s*from/m;
+export function extractExports(content) {
+    // Skip pure re-export files
+    if (REEXPORT_RE.test(content) && !EXPORT_FN_RE.test(content))
+        return [];
+    const names = new Set();
+    let m;
+    EXPORT_FN_RE.lastIndex = 0;
+    while ((m = EXPORT_FN_RE.exec(content)) !== null)
+        names.add(m[1]);
+    EXPORT_CLASS_RE.lastIndex = 0;
+    while ((m = EXPORT_CLASS_RE.exec(content)) !== null)
+        names.add(m[1]);
+    EXPORT_CONST_FN_RE.lastIndex = 0;
+    while ((m = EXPORT_CONST_FN_RE.exec(content)) !== null) {
+        if (m[1] !== 'type' && m[1] !== 'interface')
+            names.add(m[1]);
+    }
+    EXPORT_DEFAULT_RE.lastIndex = 0;
+    while ((m = EXPORT_DEFAULT_RE.exec(content)) !== null)
+        names.add(m[1]);
+    return Array.from(names);
+}
+function testFilePath(sourcePath) {
+    const dir = dirname(sourcePath);
+    const base = basename(sourcePath, extname(sourcePath));
+    return join(dir, `${base}.test.ts`);
+}
+export function generateStub(sourcePath, exportNames) {
+    const base = basename(sourcePath, '.ts');
+    const relPath = `./${base}.js`;
+    const imports = exportNames.length > 0
+        ? `import { ${exportNames.join(', ')} } from '${relPath}';\n`
+        : `// import { ... } from '${relPath}';\n`;
+    const describes = exportNames.map((name) => [
+        `describe('${name}', () => {`,
+        `  it('should be defined', () => {`,
+        `    expect(${name}).toBeDefined();`,
+        `  });`,
+        ``,
+        `  it('TODO: add meaningful test', () => {`,
+        `    // Arrange`,
+        `    // Act`,
+        `    // Assert`,
+        `    expect(true).toBe(true);`,
+        `  });`,
+        `});`,
+    ].join('\n'));
+    return [
+        `import { describe, it, expect } from 'vitest';`,
+        imports,
+        ...describes,
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Skill
+// ---------------------------------------------------------------------------
+export const testGenSkill = {
+    id: 'test-gen',
+    name: 'Test Generator',
+    description: 'Detects untested exported functions/classes and generates Vitest test stubs',
+    version: '1.0.0',
+    enabled: false,
+    tags: ['dev', 'quality'],
+    async execute(ctx) {
+        const tsFiles = ctx.files
+            .filter((f) => f.endsWith('.ts') &&
+            !f.endsWith('.test.ts') &&
+            !f.endsWith('.d.ts') &&
+            !f.includes('node_modules') &&
+            !f.includes('/dist/'));
+        if (tsFiles.length === 0) {
+            return {
+                success: true,
+                output: 'No TypeScript source files found in context.',
+                data: { untested: [], stubs: [], totalSourceFiles: 0, testedCount: 0 },
+            };
+        }
+        const untested = [];
+        let testedCount = 0;
+        for (const relPath of tsFiles) {
+            const absPath = join(ctx.projectRoot, relPath);
+            const testPath = testFilePath(absPath);
+            if (existsSync(testPath)) {
+                testedCount++;
+                continue;
+            }
+            let content = '';
+            try {
+                content = readFileSync(absPath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const exports = extractExports(content);
+            if (exports.length > 0) {
+                untested.push({ sourcePath: relPath, exports });
+            }
+        }
+        const stubs = untested.map((u) => ({
+            testFilePath: testFilePath(join(ctx.projectRoot, u.sourcePath)),
+            sourcePath: u.sourcePath,
+            content: generateStub(u.sourcePath, u.exports),
+        }));
+        const lines = [
+            `🧪 Test Generator`,
+            `Source files: ${tsFiles.length} | Tested: ${testedCount} | Missing tests: ${untested.length}`,
+            '',
+        ];
+        if (untested.length === 0) {
+            lines.push('  ✅ All exported files have test counterparts.');
+        }
+        else {
+            lines.push('  Files missing tests:');
+            for (const u of untested) {
+                lines.push(`  ⬜ ${u.sourcePath}`);
+                lines.push(`     Exports: ${u.exports.slice(0, 5).join(', ')}${u.exports.length > 5 ? '…' : ''}`);
+            }
+            lines.push('');
+            lines.push(`  💡 ${stubs.length} test stub(s) generated (see data.stubs)`);
+        }
+        return {
+            success: true,
+            output: lines.join('\n'),
+            data: { untested, stubs, totalSourceFiles: tsFiles.length, testedCount },
+        };
+    },
+};
+//# sourceMappingURL=test-gen.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * WeaveSkills — Type Definitions
+ *
+ * Core contracts for the Skill Module system (M19).
+ * All skill modules implement SkillModule; the registry manages their lifecycle.
+ */
+/** Git state available to skills that need to inspect staged/unstaged changes. */
+export interface SkillGitContext {
+    /** Current branch name */
+    branch: string;
+    /** Paths of staged files (`git diff --name-only --cached`) */
+    stagedFiles: string[];
+    /** Paths of unstaged modified files */
+    unstagedFiles: string[];
+    /** Full diff of staged changes (may be truncated) */
+    stagedDiff: string;
+}
+/**
+ * Context object injected into every skill at execution time.
+ * Skills may use any subset — unused fields can be null when unavailable.
+ */
+export interface SkillContext {
+    /** Absolute path to the project root */
+    projectRoot: string;
+    /** File paths in the project (relative to projectRoot) */
+    files: string[];
+    /**
+     * Opaque knowledge-graph snapshot.
+     * Typed as unknown to avoid a circular dependency on @openweave/weave-graph.
+     * Skills that need the graph should cast to the WeaveGraph types they import.
+     */
+    graph: unknown | null;
+    /** Active session metadata */
+    session: {
+        id: string;
+        chatId?: string;
+    } | null;
+    /** Git workspace state — null if not a git repository */
+    git: SkillGitContext | null;
+}
+/** Structured result returned by every skill execution. */
+export interface SkillResult {
+    /** Whether the skill completed successfully */
+    success: boolean;
+    /** Human-readable summary of the outcome (for CLI / agent logging) */
+    output: string;
+    /** Arbitrary structured payload — skill-specific */
+    data?: unknown;
+    /** Error message when success === false */
+    error?: string;
+}
+/**
+ * Base contract every skill module must implement.
+ *
+ * @example
+ * ```typescript
+ * import type { SkillModule, SkillContext, SkillResult } from '@openweave/weave-skills';
+ *
+ * export const mySkill: SkillModule = {
+ *   id: 'my-skill',
+ *   name: 'My Skill',
+ *   description: 'Does something useful',
+ *   version: '1.0.0',
+ *   enabled: true,
+ *   tags: ['dev'],
+ *   async execute(ctx: SkillContext): Promise<SkillResult> {
+ *     return { success: true, output: 'done' };
+ *   },
+ * };
+ * ```
+ */
+export interface SkillModule {
+    /** Unique kebab-case identifier (e.g. 'auto-fix', 'code-review') */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Short description shown in `weave skills list` */
+    description: string;
+    /** Semver string */
+    version: string;
+    /**
+     * Whether this skill is active by default when first registered.
+     * The registry always defers to the loaded SkillConfig over this value.
+     */
+    enabled: boolean;
+    /** Optional categorisation tags ('dev' | 'devops' | 'dx' | 'custom') */
+    tags?: string[];
+    /**
+     * Execute the skill.
+     * @param context - Runtime context (files, graph, session, git)
+     * @returns Structured result with success flag, output message and optional data
+     */
+    execute(context: SkillContext): Promise<SkillResult>;
+}
+/** Internal record maintained by SkillRegistry for each registered skill. */
+export interface RegisteredSkill {
+    module: SkillModule;
+    /** Current enabled state — authoritative source of truth at runtime */
+    enabled: boolean;
+    /** When the skill was registered in this process */
+    registeredAt: Date;
+}
+/**
+ * Persisted skill configuration stored in `.weave.config.json`.
+ *
+ * @example
+ * ```json
+ * {
+ *   "skills": {
+ *     "auto-fix": true,
+ *     "code-review": false,
+ *     "test-gen": true
+ *   }
+ * }
+ * ```
+ */
+export interface SkillConfig {
+    /** Map of skill id → enabled flag */
+    skills: Record<string, boolean>;
+}
+/**
+ * Shape of the full `.weave.config.json` file.
+ * Only the `skills` section is managed by weave-skills; other properties are preserved.
+ */
+export interface WeaveConfig {
+    /** Project name */
+    projectName?: string;
+    /** Skill enable/disable flags */
+    skills?: Record<string, boolean>;
+    /** Other config keys are preserved verbatim */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uCAAuC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,8BAA8B;IAC9B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,yDAAyD;IACzD,GAAG,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7B;AAMD,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACtD;AAMD,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,YAAY,EAAE,IAAI,CAAC;CACpB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,+CAA+C;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * WeaveSkills — Type Definitions
+ *
+ * Core contracts for the Skill Module system (M19).
+ * All skill modules implement SkillModule; the registry manages their lifecycle.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@openweave/weave-skills",
+  "version": "1.0.0",
+  "description": "WeaveSkills — Skill Module Registry for OpenWeave agent extensibility",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "openweave",
+    "skills",
+    "plugins",
+    "agent",
+    "extensibility"
+  ],
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "typescript": "5.7.2",
+    "vitest": "3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src --max-warnings 0",
+    "clean": "rm -rf dist"
+  }
+}