@dragonflymcp/plugin 1.0.0

package/dist/tools/framework/sync-evaluator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Sync Evaluator
+ * Loads synchronization rules from .claude/synchronizations/ and matches by event type.
+ *
+ * Supports two formats:
+ * 1. Compact DSL (main.sync): `story.create[ready]:completed -> architecture.design:opus @architecture`
+ * 2. Legacy YAML (legacy/*.yaml): `synchronizations:` blocks with when/where/then
+ *
+ * Key constraint: Does NOT evaluate `where` conditions — returns them to Claude,
+ * which has the runtime state context. Only matches by when.concept + when.action + when.status.
+ */
+import type { SyncEvalResult } from "./types.js";
+/**
+ * SyncEvaluator loads and matches synchronization rules
+ */
+export declare class SyncEvaluator {
+    private rules;
+    private loaded;
+    private syncRoot;
+    constructor(contentRoot: string);
+    /**
+     * Evaluate an event against loaded sync rules.
+     * Returns matching rules with their actions and unevaluated where conditions.
+     */
+    evaluate(concept: string, action: string, status: string): SyncEvalResult;
+    /**
+     * Get all loaded rules count
+     */
+    getRuleCount(): number;
+    /**
+     * Check if event matches a rule's when clause
+     */
+    private matchesEvent;
+    /**
+     * Lazy load all sync rules from disk
+     */
+    private ensureLoaded;
+}
+export declare const getSyncEvaluator: () => SyncEvaluator;
+export declare const resetSyncEvaluator: () => void;
+//# sourceMappingURL=sync-evaluator.d.ts.map

package/dist/tools/framework/sync-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-evaluator.d.ts","sourceRoot":"","sources":["../../../src/tools/framework/sync-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAwB,cAAc,EAAE,MAAM,YAAY,CAAC;AAuMvE;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,EAAE,MAAM;IAI/B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAqBzE;;OAEG;IACH,YAAY,IAAI,MAAM;IAKtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,OAAO,CAAC,YAAY;CA6CrB;AAQD,eAAO,MAAM,gBAAgB,qBAA0B,CAAC;AACxD,eAAO,MAAM,kBAAkB,YAA4B,CAAC"}

package/dist/tools/framework/sync-evaluator.js

@@ -0,0 +1,298 @@
+/**
+ * Sync Evaluator
+ * Loads synchronization rules from .claude/synchronizations/ and matches by event type.
+ *
+ * Supports two formats:
+ * 1. Compact DSL (main.sync): `story.create[ready]:completed -> architecture.design:opus @architecture`
+ * 2. Legacy YAML (legacy/*.yaml): `synchronizations:` blocks with when/where/then
+ *
+ * Key constraint: Does NOT evaluate `where` conditions — returns them to Claude,
+ * which has the runtime state context. Only matches by when.concept + when.action + when.status.
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { createResettableLazyLoader } from "../../utils/lazy.js";
+import { config } from "../../core/config.js";
+/** Files to skip in synchronizations directory */
+const SKIP_FILES = new Set(["slo-registry.yaml", "error-policy.yaml"]);
+/**
+ * Parse compact DSL rule lines from main.sync
+ *
+ * Format: `concept.action[qualifier]:status -> target_concept.target_action:model @slo [conditions]`
+ *
+ * Examples:
+ *   - story.create[ready]:completed -> code-analysis.context:sonnet @mcp [parallel]
+ *   - architecture.design:completed -> verification.verify[pass=1]:sonnet @verification [risk != low]
+ *   - quality.test:failed -> quality.self_repair:sonnet @execution_loop [repair_attempts < 3, mcp]
+ */
+function parseDslRules(content, sourcePath) {
+    const rules = [];
+    const lines = content.split("\n");
+    let currentSection = "";
+    let ruleIndex = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Track section headers
+        const sectionMatch = trimmed.match(/^(\w+):$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            continue;
+        }
+        // Skip non-rule sections
+        if (!["rules", "recovery", "learning", "context", "checkpoints", "fallback"].includes(currentSection)) {
+            continue;
+        }
+        // Match rule lines: `- trigger -> action`
+        const ruleMatch = trimmed.match(/^-\s+(.+?)\s+->\s+(.+)$/);
+        if (!ruleMatch)
+            continue;
+        const triggerPart = ruleMatch[1].trim();
+        const actionPart = ruleMatch[2].trim();
+        // Parse trigger: concept.action[qualifier]:status
+        const triggerRegex = /^([\w*-]+)\.([\w*|]+)(?:\[([^\]]*)\])?:(\w+)$/;
+        const triggerMatch = triggerPart.match(triggerRegex);
+        if (!triggerMatch)
+            continue;
+        const [, concept, action, qualifier, status] = triggerMatch;
+        // Parse action: target_concept.target_action:model @slo [conditions]
+        // Some actions are special (ask_user, inject_context, set_flag, etc.)
+        const actionRegex = /^([\w-]+(?:\.[\w-]+)?)(?:\[([^\]]*)\])?(?::(\w+))?\s*(?:@(\w+))?\s*(?:\[([^\]]*)\])?$/;
+        const actionMatch = actionPart.match(actionRegex);
+        let targetConcept = "";
+        let targetAction = "";
+        let model = null;
+        let conditions = null;
+        if (actionMatch) {
+            const fullTarget = actionMatch[1];
+            const dotIdx = fullTarget.indexOf(".");
+            if (dotIdx !== -1) {
+                targetConcept = fullTarget.slice(0, dotIdx);
+                targetAction = fullTarget.slice(dotIdx + 1);
+            }
+            else {
+                targetConcept = fullTarget;
+                targetAction = "";
+            }
+            model = actionMatch[3] || null;
+            conditions = actionMatch[5] || null;
+        }
+        else {
+            // Fallback: just use the whole thing as concept
+            targetConcept = actionPart;
+        }
+        // Build where clause from qualifier and conditions
+        const whereParts = [];
+        if (qualifier)
+            whereParts.push(qualifier);
+        if (conditions)
+            whereParts.push(conditions);
+        const where = whereParts.length > 0 ? whereParts.join(" AND ") : null;
+        ruleIndex++;
+        rules.push({
+            id: `dsl-${currentSection}-${ruleIndex}`,
+            description: `${currentSection}: ${triggerPart} -> ${actionPart}`,
+            source: path.basename(sourcePath),
+            when: { concept, action, status },
+            where,
+            then: [
+                {
+                    concept: targetConcept,
+                    action: targetAction,
+                    model,
+                    inputs: {},
+                },
+            ],
+        });
+    }
+    return rules;
+}
+/**
+ * Parse legacy YAML synchronization rules
+ *
+ * Extracts from `synchronizations:` blocks using regex-based parsing
+ * (no js-yaml dependency, same approach as content-loader frontmatter parser)
+ */
+function parseLegacyYamlRules(content, sourcePath) {
+    const rules = [];
+    // Find the synchronizations block
+    const syncBlockStart = content.indexOf("\nsynchronizations:");
+    if (syncBlockStart === -1)
+        return rules;
+    const afterSync = content.slice(syncBlockStart + "\nsynchronizations:".length);
+    // Split into individual rule blocks (each starts with `  - id:`)
+    const ruleBlocks = afterSync.split(/\n  - id:\s*/);
+    for (let i = 1; i < ruleBlocks.length; i++) {
+        const block = ruleBlocks[i];
+        // Extract id
+        const idMatch = block.match(/^"([^"]+)"/);
+        if (!idMatch)
+            continue;
+        const id = idMatch[1];
+        // Extract description
+        const descMatch = block.match(/description:\s*"([^"]+)"/);
+        const description = descMatch ? descMatch[1] : id;
+        // Extract when block
+        const conceptMatch = block.match(/when:\s*\n\s+concept:\s*"([^"]+)"/);
+        const actionMatch = block.match(/action:\s*"([^"]+)"/);
+        const statusMatch = block.match(/status:\s*"([^"]+)"/);
+        if (!conceptMatch || !statusMatch)
+            continue;
+        const concept = conceptMatch[1];
+        const action = actionMatch ? actionMatch[1] : "*";
+        const status = statusMatch[1];
+        // Extract where query
+        const whereMatch = block.match(/where:\s*\n\s+query:\s*"([^"]+)"/);
+        const where = whereMatch ? whereMatch[1] : null;
+        // Extract then actions
+        const thenActions = [];
+        const thenMatch = block.match(/then:\s*\n([\s\S]*?)(?=\n\s{4}\w|\n\s{2}-\s+id:|\n[a-z]|$)/);
+        if (thenMatch) {
+            const thenBlock = thenMatch[1];
+            // Find concept-based actions using a global regex
+            const conceptActionRegex = /- concept:\s*"([^"]+)"[\s\S]*?action:\s*"([^"]+)"(?:[\s\S]*?model:\s*"([^"]+)")?/g;
+            let match;
+            while ((match = conceptActionRegex.exec(thenBlock)) !== null) {
+                thenActions.push({
+                    concept: match[1],
+                    action: match[2],
+                    model: match[3] || null,
+                    inputs: {},
+                });
+            }
+            // Also handle special actions (ask_user, inject_context, etc.)
+            if (thenActions.length === 0) {
+                const specialAction = thenBlock.match(/- action:\s*"([^"]+)"/);
+                if (specialAction) {
+                    thenActions.push({
+                        concept: "",
+                        action: specialAction[1],
+                        model: null,
+                        inputs: {},
+                    });
+                }
+            }
+        }
+        if (thenActions.length === 0)
+            continue;
+        rules.push({
+            id,
+            description,
+            source: path.basename(sourcePath),
+            when: { concept, action, status },
+            where,
+            then: thenActions,
+        });
+    }
+    return rules;
+}
+/**
+ * SyncEvaluator loads and matches synchronization rules
+ */
+export class SyncEvaluator {
+    rules = [];
+    loaded = false;
+    syncRoot;
+    constructor(contentRoot) {
+        this.syncRoot = path.join(contentRoot, "synchronizations");
+    }
+    /**
+     * Evaluate an event against loaded sync rules.
+     * Returns matching rules with their actions and unevaluated where conditions.
+     */
+    evaluate(concept, action, status) {
+        this.ensureLoaded();
+        const matched = [];
+        for (const rule of this.rules) {
+            if (!this.matchesEvent(rule, concept, action, status))
+                continue;
+            matched.push({
+                rule,
+                actions: rule.then,
+                where: rule.where,
+            });
+        }
+        return {
+            event: { concept, action, status },
+            matchedRules: matched,
+            noMatch: matched.length === 0,
+        };
+    }
+    /**
+     * Get all loaded rules count
+     */
+    getRuleCount() {
+        this.ensureLoaded();
+        return this.rules.length;
+    }
+    /**
+     * Check if event matches a rule's when clause
+     */
+    matchesEvent(rule, concept, action, status) {
+        // Concept matching (supports *)
+        if (rule.when.concept !== "*" && rule.when.concept !== concept)
+            return false;
+        // Action matching (supports * and pipe-separated alternatives)
+        if (rule.when.action !== "*") {
+            const allowedActions = rule.when.action.split("|");
+            if (!allowedActions.includes(action))
+                return false;
+        }
+        // Status matching
+        if (rule.when.status !== status)
+            return false;
+        return true;
+    }
+    /**
+     * Lazy load all sync rules from disk
+     */
+    ensureLoaded() {
+        if (this.loaded)
+            return;
+        if (!fs.existsSync(this.syncRoot)) {
+            this.loaded = true;
+            return;
+        }
+        // Load main.sync (compact DSL) — check both installed and template forms
+        const mainSyncPath = path.join(this.syncRoot, "main.sync");
+        const mainSyncTemplatePath = path.join(this.syncRoot, "main.sync.template");
+        const syncPath = fs.existsSync(mainSyncPath) ? mainSyncPath : fs.existsSync(mainSyncTemplatePath) ? mainSyncTemplatePath : null;
+        if (syncPath) {
+            try {
+                const content = fs.readFileSync(syncPath, "utf-8");
+                this.rules.push(...parseDslRules(content, syncPath));
+            }
+            catch {
+                // Skip on read error
+            }
+        }
+        // Load legacy YAML files — check both installed and template forms
+        const legacyDir = path.join(this.syncRoot, "legacy");
+        const archiveDir = path.join(this.syncRoot, "archive");
+        const legacyDirs = [legacyDir, archiveDir].filter((d) => fs.existsSync(d));
+        for (const dir of legacyDirs) {
+            try {
+                const files = fs.readdirSync(dir).filter((f) => (f.endsWith(".yaml") || f.endsWith(".yaml.template")) && !SKIP_FILES.has(f) && !SKIP_FILES.has(f.replace(".template", "")));
+                for (const file of files) {
+                    try {
+                        const content = fs.readFileSync(path.join(dir, file), "utf-8");
+                        this.rules.push(...parseLegacyYamlRules(content, file));
+                    }
+                    catch {
+                        // Skip files that can't be parsed
+                    }
+                }
+            }
+            catch {
+                // Skip if directory can't be read
+            }
+        }
+        this.loaded = true;
+    }
+}
+/**
+ * Singleton sync evaluator (resettable for testing)
+ */
+const syncEvaluatorLoader = createResettableLazyLoader(() => new SyncEvaluator(config().frameworkContentRoot));
+export const getSyncEvaluator = syncEvaluatorLoader.get;
+export const resetSyncEvaluator = syncEvaluatorLoader.reset;
+//# sourceMappingURL=sync-evaluator.js.map

package/dist/tools/framework/sync-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-evaluator.js","sourceRoot":"","sources":["../../../src/tools/framework/sync-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,kDAAkD;AAClD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAEvE;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,OAAe,EAAE,UAAkB;IACxD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,wBAAwB;QACxB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YACtG,SAAS;QACX,CAAC;QAED,0CAA0C;QAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEvC,kDAAkD;QAClD,MAAM,YAAY,GAAG,+CAA+C,CAAC;QACrE,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY;YAAE,SAAS;QAE5B,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;QAE5D,qEAAqE;QACrE,sEAAsE;QACtE,MAAM,WAAW,GAAG,uFAAuF,CAAC;QAC5G,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAElD,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,IAAI,UAAU,GAAkB,IAAI,CAAC;QAErC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC5C,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,UAAU,CAAC;gBAC3B,YAAY,GAAG,EAAE,CAAC;YACpB,CAAC;YACD,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAC/B,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,gDAAgD;YAChD,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC;QAED,mDAAmD;QACnD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,UAAU;YAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtE,SAAS,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,OAAO,cAAc,IAAI,SAAS,EAAE;YACxC,WAAW,EAAE,GAAG,cAAc,KAAK,WAAW,OAAO,UAAU,EAAE;YACjE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACjC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;YACjC,KAAK;YACL,IAAI,EAAE;gBACJ;oBACE,OAAO,EAAE,aAAa;oBACtB,MAAM,EAAE,YAAY;oBACpB,KAAK;oBACL,MAAM,EAAE,EAAE;iBACX;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,OAAe,EAAE,UAAkB;IAC/D,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,kCAAkC;IAClC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D,IAAI,cAAc,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE/E,iEAAiE;IACjE,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAE5B,aAAa;QACb,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEtB,sBAAsB;QACtB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAElD,qBAAqB;QACrB,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAEvD,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW;YAAE,SAAS;QAE5C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAE9B,sBAAsB;QACtB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEhD,uBAAuB;QACvB,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5F,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAE/B,kDAAkD;YAClD,MAAM,kBAAkB,GAAG,mFAAmF,CAAC;YAC/G,IAAI,KAAK,CAAC;YACV,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC7D,WAAW,CAAC,IAAI,CAAC;oBACf,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;oBAChB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI;oBACvB,MAAM,EAAE,EAAE;iBACX,CAAC,CAAC;YACL,CAAC;YAED,+DAA+D;YAC/D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAC/D,IAAI,aAAa,EAAE,CAAC;oBAClB,WAAW,CAAC,IAAI,CAAC;wBACf,OAAO,EAAE,EAAE;wBACX,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;wBACxB,KAAK,EAAE,IAAI;wBACX,MAAM,EAAE,EAAE;qBACX,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEvC,KAAK,CAAC,IAAI,CAAC;YACT,EAAE;YACF,WAAW;YACX,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACjC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;YACjC,KAAK;YACL,IAAI,EAAE,WAAW;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,KAAK,GAAe,EAAE,CAAC;IACvB,MAAM,GAAG,KAAK,CAAC;IACf,QAAQ,CAAS;IAEzB,YAAY,WAAmB;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,OAAe,EAAE,MAAc,EAAE,MAAc;QACtD,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,MAAM,OAAO,GAAmC,EAAE,CAAC;QAEnD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;gBAAE,SAAS;YAChE,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;YAClC,YAAY,EAAE,OAAO;YACrB,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAc,EAAE,OAAe,EAAE,MAAc,EAAE,MAAc;QAClF,gCAAgC;QAChC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;QAE7E,+DAA+D;QAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;QACrD,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAE9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QAED,yEAAyE;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;QAChI,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAClI,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;wBAC/D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;oBAC1D,CAAC;oBAAC,MAAM,CAAC;wBACP,kCAAkC;oBACpC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,mBAAmB,GAAG,0BAA0B,CACpD,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC,oBAAoB,CAAC,CACvD,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,KAAK,CAAC"}

package/dist/tools/framework/sync-evaluator.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SyncEvaluator Tests
+ */
+export {};
+//# sourceMappingURL=sync-evaluator.test.d.ts.map

package/dist/tools/framework/sync-evaluator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-evaluator.test.d.ts","sourceRoot":"","sources":["../../../src/tools/framework/sync-evaluator.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tools/framework/sync-evaluator.test.js

@@ -0,0 +1,288 @@
+/**
+ * SyncEvaluator Tests
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { SyncEvaluator } from "./sync-evaluator.js";
+import { evaluateSyncForStep, CONCEPT_DEFAULT_ACTIONS } from "./index.js";
+describe("SyncEvaluator", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "sync-eval-test-"));
+        fs.mkdirSync(path.join(tmpDir, "synchronizations"), { recursive: true });
+        fs.mkdirSync(path.join(tmpDir, "synchronizations", "legacy"), { recursive: true });
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    describe("compact DSL parsing", () => {
+        it("should parse basic DSL rules", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+rules:
+  - story.create:completed -> architecture.design:opus @architecture
+  - architecture.design:completed -> implementation.generate:sonnet @implementation
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            const result = evaluator.evaluate("story", "create", "completed");
+            expect(result.noMatch).toBe(false);
+            expect(result.matchedRules).toHaveLength(1);
+            expect(result.matchedRules[0].actions[0].concept).toBe("architecture");
+            expect(result.matchedRules[0].actions[0].action).toBe("design");
+            expect(result.matchedRules[0].actions[0].model).toBe("opus");
+        });
+        it("should parse rules with qualifiers as where clauses", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+rules:
+  - story.create[ready]:completed -> architecture.design:opus @architecture
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            const result = evaluator.evaluate("story", "create", "completed");
+            expect(result.matchedRules).toHaveLength(1);
+            expect(result.matchedRules[0].where).toContain("ready");
+        });
+        it("should parse rules with conditions", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+rules:
+  - architecture.design:completed -> verification.verify:sonnet @verification [risk != low]
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            const result = evaluator.evaluate("architecture", "design", "completed");
+            expect(result.matchedRules).toHaveLength(1);
+            expect(result.matchedRules[0].where).toContain("risk != low");
+        });
+        it("should parse rules from multiple sections", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+rules:
+  - story.create:completed -> architecture.design:opus @architecture
+
+recovery:
+  - story.create:failed -> ask_user @quick
+
+learning:
+  - quality.review:completed -> retrospective.extract_pattern:sonnet @quick
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            const storyComplete = evaluator.evaluate("story", "create", "completed");
+            expect(storyComplete.matchedRules).toHaveLength(1);
+            const storyFailed = evaluator.evaluate("story", "create", "failed");
+            expect(storyFailed.matchedRules).toHaveLength(1);
+            const qualityComplete = evaluator.evaluate("quality", "review", "completed");
+            expect(qualityComplete.matchedRules).toHaveLength(1);
+        });
+        it("should skip non-rule sections like workflows and decisions", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+workflows:
+  feature:
+    pipeline: story | architecture | implementation
+
+decisions:
+  story_ambiguous:
+    trigger: story.clarity == ambiguous
+
+rules:
+  - story.create:completed -> architecture.design:opus @architecture
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            expect(evaluator.getRuleCount()).toBe(1);
+        });
+    });
+    describe("legacy YAML parsing", () => {
+        it("should parse legacy synchronization blocks", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "legacy", "feature-development.yaml"), `
+version: "1.0.0"
+
+synchronizations:
+  - id: "story-to-arch"
+    description: "When story ready, design architecture"
+    when:
+      concept: "story"
+      action: "create"
+      status: "completed"
+    where:
+      query: "story.status == 'ready'"
+    then:
+      - concept: "architecture"
+        action: "design"
+        model: "opus"
+        inputs:
+          story_id: "\${story.id}"
+
+    provenance:
+      flow_id: "\${flow.id}"
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            const result = evaluator.evaluate("story", "create", "completed");
+            // Should match both DSL and legacy (if DSL also has one)
+            expect(result.noMatch).toBe(false);
+            const legacyMatch = result.matchedRules.find((m) => m.rule.id === "story-to-arch");
+            expect(legacyMatch).toBeDefined();
+            expect(legacyMatch.where).toBe("story.status == 'ready'");
+            expect(legacyMatch.actions[0].concept).toBe("architecture");
+        });
+        it("should skip metadata files", () => {
+            // These should be ignored
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "legacy", "slo-registry.yaml"), "slo_templates:\n  test: true");
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "legacy", "error-policy.yaml"), "error_policies:\n  test: true");
+            const evaluator = new SyncEvaluator(tmpDir);
+            expect(evaluator.getRuleCount()).toBe(0);
+        });
+    });
+    describe("event matching", () => {
+        let evaluator;
+        beforeEach(() => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+rules:
+  - story.create:completed -> architecture.design:opus @architecture
+  - architecture.design:completed -> implementation.generate:sonnet @implementation
+  - implementation.generate:completed -> quality.review:sonnet @quality
+
+checkpoints:
+  - version.commit:completed -> checkpoint.create:haiku @quick
+`);
+            evaluator = new SyncEvaluator(tmpDir);
+        });
+        it("should match exact concept+action+status", () => {
+            const result = evaluator.evaluate("story", "create", "completed");
+            expect(result.matchedRules.length).toBeGreaterThanOrEqual(1);
+            expect(result.matchedRules.some((m) => m.actions[0].concept === "architecture")).toBe(true);
+        });
+        it("should match rules from checkpoints section", () => {
+            const result = evaluator.evaluate("version", "commit", "completed");
+            const checkpointMatch = result.matchedRules.find((m) => m.actions[0].concept === "checkpoint");
+            expect(checkpointMatch).toBeDefined();
+        });
+        it("should return noMatch for unmatched events", () => {
+            const result = evaluator.evaluate("story", "create", "starting");
+            expect(result.noMatch).toBe(true);
+            expect(result.matchedRules).toHaveLength(0);
+        });
+        it("should echo the event in results", () => {
+            const result = evaluator.evaluate("story", "create", "completed");
+            expect(result.event).toEqual({
+                concept: "story",
+                action: "create",
+                status: "completed",
+            });
+        });
+    });
+    describe("pipe-separated action matching", () => {
+        it("should match pipe-separated actions", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "legacy", "test.yaml"), `
+synchronizations:
+  - id: "quality-any-to-version"
+    description: "Quality review or test triggers version"
+    when:
+      concept: "quality"
+      action: "review|test"
+      status: "completed"
+    then:
+      - concept: "version"
+        action: "commit"
+        model: "sonnet"
+
+    provenance:
+      flow_id: "test"
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            const reviewResult = evaluator.evaluate("quality", "review", "completed");
+            expect(reviewResult.noMatch).toBe(false);
+            const testResult = evaluator.evaluate("quality", "test", "completed");
+            expect(testResult.noMatch).toBe(false);
+            const otherResult = evaluator.evaluate("quality", "analyze", "completed");
+            expect(otherResult.noMatch).toBe(true);
+        });
+    });
+    describe("getRuleCount()", () => {
+        it("should return total loaded rules", () => {
+            fs.writeFileSync(path.join(tmpDir, "synchronizations", "main.sync"), `
+rules:
+  - story.create:completed -> architecture.design:opus @architecture
+  - architecture.design:completed -> implementation.generate:sonnet @impl
+
+recovery:
+  - story.create:failed -> ask_user @quick
+`);
+            const evaluator = new SyncEvaluator(tmpDir);
+            expect(evaluator.getRuleCount()).toBe(3);
+        });
+        it("should return 0 when no sync files exist", () => {
+            // Remove the synchronizations directory
+            fs.rmSync(path.join(tmpDir, "synchronizations"), { recursive: true });
+            const evaluator = new SyncEvaluator(tmpDir);
+            expect(evaluator.getRuleCount()).toBe(0);
+        });
+    });
+});
+describe("evaluateSyncForStep", () => {
+    describe("CONCEPT_DEFAULT_ACTIONS mapping", () => {
+        it("should map all core workflow concepts", () => {
+            expect(CONCEPT_DEFAULT_ACTIONS.story).toBe("create");
+            expect(CONCEPT_DEFAULT_ACTIONS.architecture).toBe("design");
+            expect(CONCEPT_DEFAULT_ACTIONS.implementation).toBe("generate");
+            expect(CONCEPT_DEFAULT_ACTIONS.quality).toBe("review");
+            expect(CONCEPT_DEFAULT_ACTIONS.version).toBe("commit");
+        });
+        it("should map optional concepts", () => {
+            expect(CONCEPT_DEFAULT_ACTIONS["code-analysis"]).toBe("context");
+            expect(CONCEPT_DEFAULT_ACTIONS.verification).toBe("verify");
+            expect(CONCEPT_DEFAULT_ACTIONS.documentation).toBe("generate");
+            expect(CONCEPT_DEFAULT_ACTIONS.security).toBe("threat_model");
+        });
+    });
+    describe("evaluateSyncForStep()", () => {
+        it("should return a result (may include catch-all rules from bundled templates)", () => {
+            // evaluateSyncForStep uses the singleton evaluator which reads from
+            // frameworkContentRoot. With bundled templates, catch-all rules (e.g. SLO monitoring)
+            // may match unknown concepts, so we only verify the event mapping is correct.
+            const result = evaluateSyncForStep("nonexistent-concept", "success");
+            // Result may be defined (catch-all rule matched) or undefined (no rules) — both valid
+            if (result) {
+                expect(result.event.concept).toBe("nonexistent-concept");
+                expect(result.event.status).toBe("completed");
+            }
+        });
+        it("should map success outcome to completed status", () => {
+            // The function maps "success" → "completed" for sync evaluation
+            // We verify the mapping indirectly through the result
+            const result = evaluateSyncForStep("story", "success");
+            // If rules match, the event should show "completed" status
+            if (result) {
+                expect(result.event.status).toBe("completed");
+                expect(result.event.action).toBe("create");
+            }
+        });
+        it("should map failed outcome to failed status", () => {
+            const result = evaluateSyncForStep("story", "failed");
+            if (result) {
+                expect(result.event.status).toBe("failed");
+            }
+        });
+        it("should map partial outcome to completed status", () => {
+            const result = evaluateSyncForStep("architecture", "partial");
+            if (result) {
+                expect(result.event.status).toBe("completed");
+                expect(result.event.action).toBe("design");
+            }
+        });
+        it("should set autoAdvance true when rules have no where conditions", () => {
+            const result = evaluateSyncForStep("story", "success");
+            if (result && result.matched) {
+                // Rules without where conditions should set autoAdvance=true
+                const hasNoWhereRule = result.rules.some((r) => r.where === null);
+                if (hasNoWhereRule) {
+                    expect(result.autoAdvance).toBe(true);
+                }
+            }
+        });
+        it("should use concept name as fallback action for unknown concepts", () => {
+            // An unknown concept should use itself as the action
+            const result = evaluateSyncForStep("custom-concept", "success");
+            // Even if no match, the function returns undefined (no match)
+            // The important thing is it doesn't crash
+            expect(result === undefined || result.matched).toBeTruthy();
+        });
+    });
+});
+//# sourceMappingURL=sync-evaluator.test.js.map