asterscanner 1.0.0

package/dist/skill-tester.js

@@ -0,0 +1,334 @@
+/**
+ * Skill Testing Framework
+ *
+ * Validates skill behavior against defined test cases.
+ * Can run in dry-run mode (validation only) or execution mode.
+ */
+// ============================================================================
+// TEST RUNNER
+// ============================================================================
+export class SkillTestRunner {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            dryRun: options.dryRun ?? true,
+            timeout: options.timeout ?? 30000,
+            filter: options.filter ?? "",
+            bail: options.bail ?? false,
+            verbose: options.verbose ?? false,
+            executor: options.executor,
+        };
+    }
+    /**
+     * Run all tests in a skill's test suite
+     */
+    async run(manifest, skillContent) {
+        const startTime = Date.now();
+        const results = [];
+        const tests = manifest.tests?.tests ?? [];
+        // Get tests to run (filtered)
+        const testsToRun = this.filterTests(tests);
+        // Track coverage
+        const inputsCovered = new Set();
+        const outputsCovered = new Set();
+        const capabilitiesCovered = new Set();
+        for (const test of testsToRun) {
+            // Skip if marked
+            if (test.skip) {
+                results.push({
+                    name: test.name,
+                    passed: true,
+                    duration: 0,
+                    details: { expectedOutput: test.expect.output },
+                });
+                continue;
+            }
+            // Run the test
+            const result = await this.runTest(test, manifest, skillContent);
+            results.push(result);
+            // Track coverage
+            if (test.input) {
+                Object.keys(test.input).forEach((k) => inputsCovered.add(k));
+            }
+            if (test.expect.output) {
+                Object.keys(test.expect.output).forEach((k) => outputsCovered.add(k));
+            }
+            if (test.expect.capabilities) {
+                test.expect.capabilities.forEach((c) => capabilitiesCovered.add(c));
+            }
+            // Bail on failure if configured
+            if (this.options.bail && !result.passed) {
+                break;
+            }
+        }
+        // Calculate coverage gaps
+        const allInputs = manifest.contract?.inputs?.map((i) => i.name) ?? [];
+        const allOutputs = manifest.contract?.outputs?.map((o) => o.name) ?? [];
+        const passed = results.filter((r) => r.passed).length;
+        const failed = results.filter((r) => !r.passed).length;
+        const skipped = tests.filter((t) => t.skip).length;
+        return {
+            total: tests.length,
+            passed,
+            failed,
+            skipped,
+            duration: Date.now() - startTime,
+            results,
+            coverage: {
+                inputsCovered: Array.from(inputsCovered),
+                outputsCovered: Array.from(outputsCovered),
+                capabilitiesCovered: Array.from(capabilitiesCovered),
+                uncoveredInputs: allInputs.filter((i) => !inputsCovered.has(i)),
+                uncoveredOutputs: allOutputs.filter((o) => !outputsCovered.has(o)),
+            },
+        };
+    }
+    /**
+     * Run a single test case
+     */
+    async runTest(test, manifest, skillContent) {
+        const startTime = Date.now();
+        try {
+            // Validate inputs against contract
+            const inputValidation = this.validateInputs(test.input, manifest.contract);
+            if (!inputValidation.valid) {
+                return {
+                    name: test.name,
+                    passed: false,
+                    duration: Date.now() - startTime,
+                    error: `Invalid test inputs: ${inputValidation.errors.join(", ")}`,
+                };
+            }
+            // In dry-run mode, just validate the test structure
+            if (this.options.dryRun || !this.options.executor) {
+                return this.validateTestStructure(test, manifest);
+            }
+            // Execute the test with timeout
+            const execution = await Promise.race([
+                this.options.executor(test, manifest),
+                this.timeout(test.timeout ?? this.options.timeout),
+            ]);
+            // Check expected output
+            const outputMatch = this.matchOutput(test.expect.output ?? {}, execution.output);
+            // Check success expectation
+            const successMatch = test.expect.success === undefined ||
+                test.expect.success === execution.success;
+            const passed = outputMatch.matches && successMatch;
+            return {
+                name: test.name,
+                passed,
+                duration: Date.now() - startTime,
+                error: passed ? undefined : outputMatch.error || "Output mismatch",
+                details: {
+                    expectedOutput: test.expect.output,
+                    actualOutput: execution.output,
+                    mismatchedFields: outputMatch.mismatchedFields,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                name: test.name,
+                passed: false,
+                duration: Date.now() - startTime,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Validate test structure (dry-run mode)
+     */
+    validateTestStructure(test, manifest) {
+        const errors = [];
+        // Check test has required fields
+        if (!test.name) {
+            errors.push("Test missing name");
+        }
+        if (!test.input || Object.keys(test.input).length === 0) {
+            errors.push("Test has no inputs defined");
+        }
+        if (!test.expect || Object.keys(test.expect).length === 0) {
+            errors.push("Test has no expectations defined");
+        }
+        // Validate inputs match contract
+        if (manifest.contract?.inputs) {
+            const requiredInputs = manifest.contract.inputs
+                .filter((i) => i.required)
+                .map((i) => i.name);
+            for (const required of requiredInputs) {
+                if (!(required in (test.input || {}))) {
+                    errors.push(`Missing required input: ${required}`);
+                }
+            }
+        }
+        // Validate expected outputs are in contract
+        if (manifest.contract?.outputs && test.expect.output) {
+            const validOutputs = manifest.contract.outputs.map((o) => o.name);
+            for (const key of Object.keys(test.expect.output)) {
+                if (!validOutputs.includes(key)) {
+                    errors.push(`Unknown output field: ${key}`);
+                }
+            }
+        }
+        return {
+            name: test.name,
+            passed: errors.length === 0,
+            duration: 0,
+            error: errors.length > 0 ? errors.join("; ") : undefined,
+        };
+    }
+    /**
+     * Filter tests based on options
+     */
+    filterTests(tests) {
+        let filtered = tests;
+        // Apply filter pattern
+        if (this.options.filter) {
+            const pattern = new RegExp(this.options.filter, "i");
+            filtered = filtered.filter((t) => pattern.test(t.name));
+        }
+        // Check for 'only' tests
+        const onlyTests = filtered.filter((t) => t.only);
+        if (onlyTests.length > 0) {
+            filtered = onlyTests;
+        }
+        return filtered;
+    }
+    /**
+     * Validate inputs against contract
+     */
+    validateInputs(input, contract) {
+        const errors = [];
+        if (!contract?.inputs) {
+            return { valid: true, errors: [] };
+        }
+        for (const param of contract.inputs) {
+            const value = input[param.name];
+            // Check required
+            if (param.required && value === undefined) {
+                errors.push(`Missing required input: ${param.name}`);
+                continue;
+            }
+            if (value === undefined)
+                continue;
+            // Type checking
+            const actualType = Array.isArray(value) ? "array" : typeof value;
+            if (param.type !== "any" && actualType !== param.type) {
+                errors.push(`Input ${param.name}: expected ${param.type}, got ${actualType}`);
+            }
+            // Enum validation
+            if (param.enum && !param.enum.includes(value)) {
+                errors.push(`Input ${param.name}: value not in enum [${param.enum.join(", ")}]`);
+            }
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    /**
+     * Match actual output against expected
+     */
+    matchOutput(expected, actual) {
+        const mismatched = [];
+        for (const [key, expectedValue] of Object.entries(expected)) {
+            const actualValue = actual[key];
+            if (!this.deepEqual(expectedValue, actualValue)) {
+                mismatched.push(key);
+            }
+        }
+        return {
+            matches: mismatched.length === 0,
+            error: mismatched.length > 0
+                ? `Mismatched fields: ${mismatched.join(", ")}`
+                : undefined,
+            mismatchedFields: mismatched,
+        };
+    }
+    /**
+     * Deep equality check
+     */
+    deepEqual(a, b) {
+        if (a === b)
+            return true;
+        if (typeof a !== typeof b)
+            return false;
+        if (Array.isArray(a) && Array.isArray(b)) {
+            if (a.length !== b.length)
+                return false;
+            return a.every((val, idx) => this.deepEqual(val, b[idx]));
+        }
+        if (typeof a === "object" && a !== null && b !== null) {
+            const aKeys = Object.keys(a);
+            const bKeys = Object.keys(b);
+            if (aKeys.length !== bKeys.length)
+                return false;
+            return aKeys.every((key) => this.deepEqual(a[key], b[key]));
+        }
+        return false;
+    }
+    /**
+     * Create a timeout promise
+     */
+    timeout(ms) {
+        return new Promise((_, reject) => setTimeout(() => reject(new Error(`Test timed out after ${ms}ms`)), ms));
+    }
+}
+// ============================================================================
+// CONVENIENCE FUNCTIONS
+// ============================================================================
+/**
+ * Run tests for a skill (validation only)
+ */
+export async function validateTests(manifest, skillContent, options) {
+    const runner = new SkillTestRunner({ ...options, dryRun: true });
+    return runner.run(manifest, skillContent);
+}
+/**
+ * Calculate test coverage percentage
+ */
+export function calculateCoverage(result) {
+    const totalInputs = result.coverage.inputsCovered.length +
+        result.coverage.uncoveredInputs.length;
+    const totalOutputs = result.coverage.outputsCovered.length +
+        result.coverage.uncoveredOutputs.length;
+    const inputCoverage = totalInputs > 0
+        ? (result.coverage.inputsCovered.length / totalInputs) * 100
+        : 100;
+    const outputCoverage = totalOutputs > 0
+        ? (result.coverage.outputsCovered.length / totalOutputs) * 100
+        : 100;
+    return {
+        inputCoverage,
+        outputCoverage,
+        overallCoverage: (inputCoverage + outputCoverage) / 2,
+    };
+}
+/**
+ * Format test results for display
+ */
+export function formatTestResults(result) {
+    const lines = [];
+    lines.push(`\n📋 Test Results`);
+    lines.push(`${"─".repeat(50)}`);
+    for (const test of result.results) {
+        const icon = test.passed ? "✅" : "❌";
+        lines.push(`${icon} ${test.name} (${test.duration}ms)`);
+        if (test.error) {
+            lines.push(`   └─ ${test.error}`);
+        }
+    }
+    lines.push(`${"─".repeat(50)}`);
+    lines.push(`Total: ${result.total} | Passed: ${result.passed} | Failed: ${result.failed} | Skipped: ${result.skipped}`);
+    lines.push(`Duration: ${result.duration}ms`);
+    // Coverage
+    const coverage = calculateCoverage(result);
+    lines.push(`\n📊 Coverage`);
+    lines.push(`   Input: ${coverage.inputCoverage.toFixed(0)}%`);
+    lines.push(`   Output: ${coverage.outputCoverage.toFixed(0)}%`);
+    if (result.coverage.uncoveredInputs.length > 0) {
+        lines.push(`\n⚠️  Uncovered inputs: ${result.coverage.uncoveredInputs.join(", ")}`);
+    }
+    if (result.coverage.uncoveredOutputs.length > 0) {
+        lines.push(`⚠️  Uncovered outputs: ${result.coverage.uncoveredOutputs.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=skill-tester.js.map

package/dist/skill-tester.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Security severity levels
+ */
+export type Severity = "critical" | "high" | "medium" | "low" | "info";
+/**
+ * Pattern categories for security issues
+ */
+export type PatternCategory = "secrets" | "code_execution" | "file_system" | "network" | "credentials" | "system";
+/**
+ * A security pattern definition
+ */
+export interface SecurityPattern {
+    /** Unique identifier for the pattern */
+    id: string;
+    /** Regular expression to match */
+    pattern: RegExp;
+    /** Type of security issue */
+    type: string;
+    /** Category of the pattern */
+    category: PatternCategory;
+    /** Severity level */
+    severity: Severity;
+    /** Human-readable message */
+    message: string;
+    /** Optional recommendation for fixing */
+    recommendation?: string;
+}
+/**
+ * A detected security issue
+ */
+export interface SecurityIssue {
+    /** Pattern ID that triggered this issue */
+    patternId: string;
+    /** Type of security issue */
+    type: string;
+    /** Category */
+    category: PatternCategory;
+    /** Severity level */
+    severity: Severity;
+    /** Human-readable message */
+    message: string;
+    /** Line number where issue was found (1-indexed) */
+    line: number;
+    /** Column position where issue was found */
+    column?: number;
+    /** The matched content (sanitized) */
+    match: string;
+    /** Recommendation for fixing */
+    recommendation?: string;
+}
+/**
+ * Result of scanning content
+ */
+export interface ScanResult {
+    /** Security score (0-100) */
+    score: number;
+    /** Pass/fail status */
+    passed: boolean;
+    /** List of detected issues */
+    issues: SecurityIssue[];
+    /** Counts by severity */
+    summary: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+        info: number;
+        total: number;
+    };
+    /** Scan metadata */
+    metadata: {
+        scannedAt: string;
+        contentLength: number;
+        lineCount: number;
+        scanDurationMs: number;
+    };
+}
+/**
+ * Options for scanning
+ */
+export interface ScanOptions {
+    /** Minimum score to pass (default: 50) */
+    minScore?: number;
+    /** Categories to scan (default: all) */
+    categories?: PatternCategory[];
+    /** Severity levels to include (default: all) */
+    severities?: Severity[];
+    /** Custom patterns to include */
+    customPatterns?: SecurityPattern[];
+    /** Whether to include info-level issues in score (default: false) */
+    includeInfoInScore?: boolean;
+}
+//# 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;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,gBAAgB,GAChB,aAAa,GACb,SAAS,GACT,aAAa,GACb,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yBAAyB;IACzB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,oBAAoB;IACpB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,gDAAgD;IAChD,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,iCAAiC;IACjC,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "asterscanner",
+  "version": "1.0.0",
+  "description": "Security scanner for AI agent skills",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@types/node": "^25.6.0",
+    "vitest": "^4.1.5",
+    "@vitest/coverage-v8": "^4.1.5"
+  },
+  "keywords": [
+    "security",
+    "scanner",
+    "ai",
+    "agent",
+    "skills"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joinasterism/ask"
+  },
+  "homepage": "https://joinasterism.com",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}