@soleri/core 9.13.0 → 9.14.4

package/dist/skills/validate-skill-docs.js

@@ -0,0 +1,476 @@
+/**
+ * Build-time validator for SKILL.md inline op-call examples.
+ *
+ * Parses `YOUR_AGENT_core op:<name> params: { ... }` blocks in SKILL.md files
+ * and validates the params against the actual Zod schemas defined in the
+ * facade source files.
+ *
+ * Usage:  tsx packages/core/src/skills/validate-skill-docs.ts
+ * Exit 0 = all valid, Exit 1 = mismatches found.
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, resolve, relative } from 'node:path';
+// ── Facade factory imports ──────────────────────────────────────────────
+import { createVaultFacadeOps } from '../runtime/facades/vault-facade.js';
+import { createPlanFacadeOps } from '../runtime/facades/plan-facade.js';
+import { createBrainFacadeOps } from '../runtime/facades/brain-facade.js';
+import { createMemoryFacadeOps } from '../runtime/facades/memory-facade.js';
+import { createAdminFacadeOps } from '../runtime/facades/admin-facade.js';
+import { createCuratorFacadeOps } from '../runtime/facades/curator-facade.js';
+import { createLoopFacadeOps } from '../runtime/facades/loop-facade.js';
+import { createOrchestrateFacadeOps } from '../runtime/facades/orchestrate-facade.js';
+import { createControlFacadeOps } from '../runtime/facades/control-facade.js';
+import { createContextFacadeOps } from '../runtime/facades/context-facade.js';
+import { createAgencyFacadeOps } from '../runtime/facades/agency-facade.js';
+import { createChatFacadeOps } from '../runtime/facades/chat-facade.js';
+import { createOperatorFacadeOps } from '../runtime/facades/operator-facade.js';
+import { createArchiveFacadeOps } from '../runtime/facades/archive-facade.js';
+import { createSyncFacadeOps } from '../runtime/facades/sync-facade.js';
+import { createReviewFacadeOps } from '../runtime/facades/review-facade.js';
+import { createIntakeFacadeOps } from '../runtime/facades/intake-facade.js';
+import { createLinksFacadeOps } from '../runtime/facades/links-facade.js';
+import { createBranchingFacadeOps } from '../runtime/facades/branching-facade.js';
+import { createTierFacadeOps } from '../runtime/facades/tier-facade.js';
+import { createEmbeddingFacadeOps } from '../runtime/facades/embedding-facade.js';
+// ── Mock runtime ────────────────────────────────────────────────────────
+// Schemas are constructed during factory calls but handlers are never invoked,
+// so a recursive proxy that returns itself for any property access is enough.
+function createNoopProxy() {
+    const handler = {
+        get(_target, prop) {
+            // Return primitives for common property checks
+            if (prop === Symbol.toPrimitive)
+                return () => '';
+            if (prop === Symbol.iterator)
+                return undefined;
+            if (prop === 'then')
+                return undefined; // prevent Promise detection
+            if (prop === 'toString')
+                return () => '[mock]';
+            if (prop === 'valueOf')
+                return () => 0;
+            if (prop === 'length')
+                return 0;
+            // Return a callable proxy for methods
+            return new Proxy(function () { }, handler);
+        },
+        apply() {
+            // When called as a function, return a new proxy
+            return new Proxy({}, handler);
+        },
+    };
+    return new Proxy({}, handler);
+}
+// ── Schema registry ─────────────────────────────────────────────────────
+// Build a flat map of opName → ZodSchema from all facades.
+function buildSchemaRegistry() {
+    const runtime = createNoopProxy();
+    const registry = new Map();
+    const facadeFactories = [
+        createVaultFacadeOps,
+        createPlanFacadeOps,
+        createBrainFacadeOps,
+        createMemoryFacadeOps,
+        createAdminFacadeOps,
+        createCuratorFacadeOps,
+        createLoopFacadeOps,
+        createOrchestrateFacadeOps,
+        createControlFacadeOps,
+        createContextFacadeOps,
+        createAgencyFacadeOps,
+        createChatFacadeOps,
+        createOperatorFacadeOps,
+        createArchiveFacadeOps,
+        createSyncFacadeOps,
+        createReviewFacadeOps,
+        createIntakeFacadeOps,
+        createLinksFacadeOps,
+        createBranchingFacadeOps,
+        createTierFacadeOps,
+        createEmbeddingFacadeOps,
+    ];
+    for (const factory of facadeFactories) {
+        try {
+            const ops = factory(runtime);
+            for (const op of ops) {
+                if (op.schema) {
+                    registry.set(op.name, op.schema);
+                }
+            }
+        }
+        catch {
+            // Some facades may fail with the mock runtime — skip them.
+            // Schemas from other facades still get registered.
+        }
+    }
+    return registry;
+}
+// ── SKILL.md parser ─────────────────────────────────────────────────────
+// Extracts op-call examples from fenced code blocks.
+//
+// Formats matched:
+//   YOUR_AGENT_core op:<name>
+//   YOUR_AGENT_core op:<name> params: { ... }
+//   YOUR_AGENT_core op:<name>
+//     params: { ... }
+function extractOpExamples(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const examples = [];
+    // Track code blocks
+    let inCodeBlock = false;
+    let codeBlockStart = -1;
+    let codeBlockLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trimStart().startsWith('```')) {
+            if (!inCodeBlock) {
+                inCodeBlock = true;
+                codeBlockStart = i + 1;
+                codeBlockLines = [];
+            }
+            else {
+                // Process the code block
+                extractFromCodeBlock(filePath, codeBlockStart, codeBlockLines, examples);
+                inCodeBlock = false;
+                codeBlockLines = [];
+            }
+            continue;
+        }
+        if (inCodeBlock) {
+            codeBlockLines.push(line);
+        }
+    }
+    return examples;
+}
+function extractFromCodeBlock(filePath, startLine, blockLines, results) {
+    // Pattern: YOUR_AGENT_core op:<name> [params: { ... }]
+    // Also matches: op:<name> params: { ... } (without facade prefix)
+    const opPattern = /(?:YOUR_AGENT_\w+\s+)?op:(\w+)(?:\s+params:\s*(.*))?/;
+    for (let i = 0; i < blockLines.length; i++) {
+        const line = blockLines[i];
+        const match = line.match(opPattern);
+        if (!match)
+            continue;
+        const opName = match[1];
+        const lineNum = startLine + i + 1; // 1-indexed
+        // Collect params — may be inline or on following lines
+        let rawParams = '';
+        if (match[2]) {
+            // Params start on same line
+            rawParams = match[2].trim();
+        }
+        else if (i + 1 < blockLines.length && blockLines[i + 1].trim().startsWith('params:')) {
+            // Params on next line(s)
+            const paramsLine = blockLines[i + 1].trim();
+            const paramsMatch = paramsLine.match(/^params:\s*(.*)/);
+            if (paramsMatch) {
+                rawParams = paramsMatch[1].trim();
+            }
+        }
+        // If we found params start, collect the full multi-line object
+        if (rawParams) {
+            // Collect continuation lines for multi-line objects
+            const fullParams = collectMultiLineParams(blockLines, i, rawParams);
+            const { parsed, error } = parseLooseJson(fullParams);
+            results.push({
+                file: filePath,
+                line: lineNum,
+                opName,
+                rawParams: fullParams,
+                parsedParams: parsed,
+                parseError: error,
+            });
+        }
+        else {
+            // Op without params — nothing to validate
+        }
+    }
+}
+/**
+ * Collect multi-line params from code block lines.
+ * Handles the common pattern where params span multiple indented lines:
+ *   params: {
+ *     key: "value",
+ *     nested: { ... }
+ *   }
+ */
+function collectMultiLineParams(blockLines, opLineIdx, initial) {
+    // If the initial string already has balanced braces, return it
+    if (isBalanced(initial))
+        return initial;
+    // Start from the line after the op line (or after params: line)
+    let startIdx = opLineIdx + 1;
+    if (!blockLines[opLineIdx].includes('params:') && startIdx < blockLines.length) {
+        if (blockLines[startIdx].trim().startsWith('params:')) {
+            startIdx++;
+        }
+    }
+    let result = initial;
+    for (let j = startIdx; j < blockLines.length; j++) {
+        const nextLine = blockLines[j].trim();
+        if (!nextLine)
+            continue;
+        // Stop if we hit another op: line
+        if (nextLine.match(/(?:YOUR_AGENT_\w+\s+)?op:\w+/))
+            break;
+        result += '\n' + nextLine;
+        if (isBalanced(result))
+            break;
+    }
+    return result;
+}
+/** Check if braces/brackets are balanced in a string. */
+function isBalanced(s) {
+    let depth = 0;
+    for (const ch of s) {
+        if (ch === '{' || ch === '[')
+            depth++;
+        if (ch === '}' || ch === ']')
+            depth--;
+        if (depth < 0)
+            return false;
+    }
+    return depth === 0;
+}
+/**
+ * Parse loose JS-like object notation into a JS object.
+ * Handles: unquoted keys, single quotes, trailing commas, [...] arrays,
+ * template strings like "<placeholder>".
+ */
+function parseLooseJson(raw) {
+    if (!raw.trim())
+        return { parsed: null };
+    try {
+        // Normalize to valid JSON-ish:
+        const normalized = raw
+            // Replace <placeholder> values with "placeholder"
+            .replace(/"<([^">]+)>"/g, '"$1"')
+            // Unquoted keys → quoted keys
+            .replace(/([{,]\s*)(\w+)\s*:/g, '$1"$2":')
+            // Single quotes → double quotes (simple cases)
+            .replace(/'/g, '"')
+            // Trailing commas before } or ]
+            .replace(/,\s*([}\]])/g, '$1')
+            // Spread syntax [...] → placeholder
+            .replace(/\.\.\./g, '')
+            // Handle array shorthand [item1, item2, ...]
+            .replace(/\["?<[^>]+>"?\]/g, '["placeholder"]');
+        // Try to parse
+        const result = JSON.parse(normalized);
+        return { parsed: result };
+    }
+    catch (e) {
+        // Second attempt: extract key-value pairs manually for simple flat objects
+        try {
+            const result = extractFlatParams(raw);
+            if (result && Object.keys(result).length > 0) {
+                return { parsed: result };
+            }
+        }
+        catch {
+            // fall through
+        }
+        return {
+            parsed: null,
+            error: `Cannot parse params: ${e.message}`,
+        };
+    }
+}
+/**
+ * Extract flat key-value pairs from loose notation.
+ * Handles: `key: "value"`, `key: true`, `key: 123`
+ */
+function extractFlatParams(raw) {
+    const result = {};
+    // Match patterns like: key: "value" or key: value or key: [...] or key: {...}
+    const kvPattern = /(\w+)\s*:\s*(?:"([^"]*)"|\[([^\]]*)\]|(\{[^}]*\})|(\w+))/g;
+    let match;
+    let found = false;
+    while ((match = kvPattern.exec(raw)) !== null) {
+        found = true;
+        const key = match[1];
+        if (match[2] !== undefined) {
+            // Quoted string
+            result[key] = match[2].replace(/<[^>]+>/g, 'placeholder');
+        }
+        else if (match[3] !== undefined) {
+            // Array
+            result[key] = ['placeholder'];
+        }
+        else if (match[4] !== undefined) {
+            // Object — keep as generic object
+            result[key] = {};
+        }
+        else if (match[5] !== undefined) {
+            // Unquoted value
+            const val = match[5];
+            if (val === 'true')
+                result[key] = true;
+            else if (val === 'false')
+                result[key] = false;
+            else if (/^\d+$/.test(val))
+                result[key] = parseInt(val, 10);
+            else
+                result[key] = val;
+        }
+    }
+    return found ? result : null;
+}
+// ── Validation ──────────────────────────────────────────────────────────
+/**
+ * Check if a value looks like a placeholder (e.g., "correct-tier", "type",
+ * "critical|warning|suggestion") rather than a concrete example value.
+ */
+function isPlaceholder(value) {
+    if (typeof value !== 'string')
+        return false;
+    // Pipe-separated enum hints like "critical|warning|suggestion"
+    if (value.includes('|'))
+        return true;
+    // Common placeholder patterns
+    if (/^<.*>$/.test(value))
+        return true;
+    // Generic placeholder words (including hyphenated like "correct-tier", "entry-id")
+    if (/^(placeholder|example|value|name|id|title|description|type|domain)$/i.test(value))
+        return true;
+    if (/^[\w]+-[\w]+$/.test(value) &&
+        /\b(correct|your|my|the|this|some|new|old|entry|item|current)\b/i.test(value))
+        return true;
+    return false;
+}
+/**
+ * Filter Zod issues to exclude those caused by placeholder values.
+ * Keeps structural issues (missing required fields, wrong types) but
+ * skips enum mismatches on placeholder strings.
+ */
+function isPlaceholderIssue(issue, params) {
+    // "Invalid enum value" on a placeholder string
+    if (issue.code === 'invalid_enum_value') {
+        const received = issue.received ?? getNestedValue(params, issue.path);
+        if (isPlaceholder(received))
+            return true;
+    }
+    return false;
+}
+/** Traverse nested object by path segments. */
+function getNestedValue(obj, path) {
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+function validateExamples(examples, registry) {
+    const errors = [];
+    for (const ex of examples) {
+        // Skip examples where params couldn't be parsed
+        if (ex.parseError) {
+            // Don't report parse errors — many SKILL.md examples use placeholder syntax
+            // that's intentionally not valid JSON (e.g., "<title>", "...")
+            continue;
+        }
+        if (!ex.parsedParams)
+            continue;
+        const schema = registry.get(ex.opName);
+        if (!schema) {
+            // Op not found in registry — may be from a facade that failed to load,
+            // or a typo in the SKILL.md. Report it.
+            errors.push({
+                file: ex.file,
+                line: ex.line,
+                opName: ex.opName,
+                message: `unknown op — not found in any facade schema registry`,
+            });
+            continue;
+        }
+        // Validate params against schema
+        const result = schema.safeParse(ex.parsedParams);
+        if (!result.success && result.error) {
+            for (const issue of result.error.issues) {
+                // Skip issues caused by placeholder values
+                if (isPlaceholderIssue(issue, ex.parsedParams)) {
+                    continue;
+                }
+                const path = issue.path.join('.');
+                errors.push({
+                    file: ex.file,
+                    line: ex.line,
+                    opName: ex.opName,
+                    message: `${path ? path + ': ' : ''}${issue.message}`,
+                });
+            }
+        }
+    }
+    return errors;
+}
+// ── SKILL.md discovery ──────────────────────────────────────────────────
+function discoverSkillDocs(rootDir) {
+    const skillsDir = join(rootDir, 'packages', 'forge', 'src', 'skills');
+    const paths = [];
+    if (!existsSync(skillsDir))
+        return paths;
+    const entries = readdirSync(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillMd = join(skillsDir, entry.name, 'SKILL.md');
+        if (existsSync(skillMd)) {
+            paths.push(skillMd);
+        }
+    }
+    return paths;
+}
+// ── Main ────────────────────────────────────────────────────────────────
+export function validateSkillDocs(rootDir) {
+    const registry = buildSchemaRegistry();
+    const skillFiles = discoverSkillDocs(rootDir);
+    let totalExamples = 0;
+    const allErrors = [];
+    for (const file of skillFiles) {
+        const examples = extractOpExamples(file);
+        totalExamples += examples.length;
+        const errors = validateExamples(examples, registry);
+        allErrors.push(...errors);
+    }
+    return {
+        errors: allErrors,
+        totalExamples,
+        totalFiles: skillFiles.length,
+        registrySize: registry.size,
+    };
+}
+// ── CLI entry point ─────────────────────────────────────────────────────
+function main() {
+    // Find project root — walk up from this file's location
+    const thisDir = new URL('.', import.meta.url).pathname;
+    const rootDir = resolve(thisDir, '..', '..', '..', '..');
+    console.log('Validating SKILL.md op-call examples against Zod schemas...\n');
+    const { errors, totalExamples, totalFiles, registrySize } = validateSkillDocs(rootDir);
+    console.log(`  Schema registry: ${registrySize} ops`);
+    console.log(`  Skill files:     ${totalFiles}`);
+    console.log(`  Op examples:     ${totalExamples}`);
+    console.log('');
+    if (errors.length === 0) {
+        console.log('All examples validate against their schemas.');
+        process.exit(0);
+    }
+    console.log(`Found ${errors.length} validation error(s):\n`);
+    for (const err of errors) {
+        const relPath = relative(rootDir, err.file);
+        console.log(`  ${relPath}:${err.line} — ${err.opName}: ${err.message}`);
+    }
+    console.log('');
+    process.exit(1);
+}
+// Run if invoked directly
+const isMainModule = typeof process !== 'undefined' &&
+    process.argv[1] &&
+    (process.argv[1].endsWith('validate-skill-docs.ts') ||
+        process.argv[1].endsWith('validate-skill-docs.js'));
+if (isMainModule) {
+    main();
+}
+//# sourceMappingURL=validate-skill-docs.js.map

package/dist/skills/validate-skill-docs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/core",
-  "version": "9.13.0",
+  "version": "9.14.4",
   "description": "Shared engine for Soleri agents — vault, brain, planner, LLM utilities, and facade infrastructure.",
   "keywords": [
     "agent",
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && rm -rf dist/knowledge-packs && cp -r ../../knowledge-packs dist/knowledge-packs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",

package/src/__tests__/deviation-detection.test.ts

@@ -156,6 +156,55 @@ describe('deviation-detection', () => {
       expect(plan.steps[1].allowedTools).toEqual(['tool_b']);
     });
 
+    it('injects workflowPrompt and workflowName when override has prompt', () => {
+      const plan = makePlan([
+        {
+          id: 'step-1',
+          name: 'Step one',
+          tools: [],
+          parallel: false,
+          requires: [],
+          status: 'pending',
+        },
+      ]);
+
+      const override: WorkflowOverride = {
+        name: 'feature-dev',
+        prompt: '# Feature Development\nFollow TDD approach.',
+        gates: [],
+        tools: [],
+      };
+
+      applyWorkflowOverride(plan, override);
+
+      expect(plan.workflowPrompt).toBe('# Feature Development\nFollow TDD approach.');
+      expect(plan.workflowName).toBe('feature-dev');
+    });
+
+    it('does not set workflowPrompt when override has no prompt', () => {
+      const plan = makePlan([
+        {
+          id: 'step-1',
+          name: 'Step one',
+          tools: [],
+          parallel: false,
+          requires: [],
+          status: 'pending',
+        },
+      ]);
+
+      const override: WorkflowOverride = {
+        name: 'test-workflow',
+        gates: [],
+        tools: [],
+      };
+
+      applyWorkflowOverride(plan, override);
+
+      expect(plan.workflowPrompt).toBeUndefined();
+      expect(plan.workflowName).toBeUndefined();
+    });
+
     it('does not set allowedTools on steps that remain tool-less', () => {
       const plan = makePlan([
         {

package/src/enforcement/adapters/claude-code.test.ts

@@ -130,22 +130,22 @@ describe('ClaudeCodeAdapter', () => {
 
     it('should generate hookify file for pre-commit trigger', () => {
       const rule = createRule({
-        id: 'no-ai-attribution',
+        id: 'no-console-log',
         trigger: 'pre-commit',
-        pattern: 'Co-Authored-By',
-        message: 'No AI attribution in commits',
-        description: 'Blocks AI co-author lines',
+        pattern: 'console\\.log',
+        message: 'No console.log in commits',
+        description: 'Blocks console.log statements',
       });
       const result = adapter.translate(createConfig([rule]));
 
       expect(result.files).toHaveLength(1);
-      expect(result.files[0].path).toBe('.claude/hookify.no-ai-attribution.local.md');
+      expect(result.files[0].path).toBe('.claude/hookify.no-console-log.local.md');
 
       const content = result.files[0].content;
-      expect(content).toContain('name: no-ai-attribution');
-      expect(content).toContain('Blocks AI co-author lines');
-      expect(content).toContain('Pattern: `Co-Authored-By`');
-      expect(content).toContain('No AI attribution in commits');
+      expect(content).toContain('name: no-console-log');
+      expect(content).toContain('Blocks console.log statements');
+      expect(content).toContain('Pattern: `console\\.log`');
+      expect(content).toContain('No console.log in commits');
     });
 
     it('should generate hookify file without pattern when none provided', () => {

package/src/engine/bin/soleri-engine.ts

@@ -163,10 +163,12 @@ async function main(): Promise<void> {
       .join(', ')})`,
   );
 
-  // 6b. Auto-sync skills to ~/.claude/skills/
+  // 6b. Auto-sync skills to project-local .claude/skills/
   const skillsDir = join(agentDir, 'skills');
   if (existsSync(skillsDir)) {
-    const syncResult = syncSkillsToClaudeCode([skillsDir], config.name as string);
+    const syncResult = syncSkillsToClaudeCode([skillsDir], config.name as string, {
+      projectRoot: process.cwd(),
+    });
     const total = syncResult.installed.length + syncResult.updated.length;
     if (total > 0) {
       console.error(
@@ -176,6 +178,9 @@ async function main(): Promise<void> {
     if (syncResult.removed.length) {
       console.error(`${tag} Removed ${syncResult.removed.length} orphaned skill(s)`);
     }
+    if (syncResult.cleanedGlobal.length) {
+      console.error(`${tag} Cleaned ${syncResult.cleanedGlobal.length} stale global skill(s)`);
+    }
   }
 
   // 7. Load domain packs

package/src/flows/types.ts

@@ -194,6 +194,10 @@ export interface OrchestrationPlan {
   estimatedTools: number;
   context: OrchestrationContext;
   deviations?: ToolDeviation[];
+  /** Workflow prompt.md content injected by applyWorkflowOverride */
+  workflowPrompt?: string;
+  /** Name of the matched workflow */
+  workflowName?: string;
 }
 
 export interface OrchestrationContext {