@alan512/experienceengine 0.3.6 → 0.4.0

package/dist/cli/commands/maintenance.js

@@ -11,6 +11,8 @@ import { bootstrapDatabase, openDatabase } from "../../store/sqlite/db.js";
 import { CandidateRepository } from "../../store/sqlite/repositories/candidate-repo.js";
 import { NodeRepository } from "../../store/sqlite/repositories/node-repo.js";
 import { resetManagedEmbeddingCache } from "../../store/vector/local-provider.js";
+import { VectorMigrationPipeline } from "../../maintenance/vector-migrator.js";
+import { embedQueryText } from "../../store/vector/embeddings.js";
 const parseGovernanceDrainArgs = (args) => {
     if (args[0] !== "drain") {
         return null;
@@ -36,6 +38,38 @@ const parseGovernanceDrainArgs = (args) => {
     }
     return parsed;
 };
+const parseMigrateArgs = (args) => {
+    const parsed = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        const next = args[index + 1];
+        if (value === "--batch-size" && next) {
+            const batchSize = Number(next);
+            if (Number.isInteger(batchSize) && batchSize > 0) {
+                parsed.batchSize = batchSize;
+                index += 1;
+                continue;
+            }
+        }
+        if (value === "--throttle-gap" && next) {
+            const throttleGap = Number(next);
+            if (Number.isInteger(throttleGap) && throttleGap >= 0) {
+                parsed.throttleGapMs = throttleGap;
+                index += 1;
+                continue;
+            }
+        }
+        if (value === "--max-total" && next) {
+            const maxTotal = Number(next);
+            if (Number.isInteger(maxTotal) && maxTotal > 0) {
+                parsed.maxTotal = maxTotal;
+                index += 1;
+                continue;
+            }
+        }
+    }
+    return parsed;
+};
 export const runMaintenanceCommand = async (action, argsOrDeps = [], maybeDeps = {}) => {
     const args = Array.isArray(argsOrDeps) ? argsOrDeps : [];
     const deps = Array.isArray(argsOrDeps) ? maybeDeps : argsOrDeps;
@@ -151,7 +185,7 @@ export const runMaintenanceCommand = async (action, argsOrDeps = [], maybeDeps =
         const [sourceScopeId, targetScopeId] = args;
         if (!sourceScopeId || !targetScopeId) {
             console.log("[ExperienceEngine] merge-scope requires <sourceScopeId> <targetScopeId>.");
-            console.log("Usage: ee maintenance embeddings-reset|embedding-smoke|governance drain|redistill-rule-nodes|claude-validate-print|merge-scope <sourceScopeId> <targetScopeId>");
+            console.log("Usage: ee maintenance embeddings-reset|embedding-smoke|governance drain|redistill-rule-nodes|claude-validate-print|merge-scope <sourceScopeId> <targetScopeId>|migrate [--batch-size <n>] [--throttle-gap <ms>] [--max-total <n>]");
             return;
         }
         const report = (deps.mergeScopesWithConfig ?? mergeScopesWithConfig)(config, sourceScopeId, targetScopeId);
@@ -160,6 +194,50 @@ export const runMaintenanceCommand = async (action, argsOrDeps = [], maybeDeps =
         console.log(`[ExperienceEngine] Merged aggregates: taskStats=${report.merged.taskStats}`);
         return;
     }
-    console.log("Usage: ee maintenance embeddings-reset|embedding-smoke|governance drain|redistill-rule-nodes|claude-validate-print|merge-scope <sourceScopeId> <targetScopeId>");
+    if (action === "migrate") {
+        const parsed = parseMigrateArgs(args);
+        console.log("[ExperienceEngine] Detecting active embedding space...");
+        let currentSpace;
+        try {
+            const probeResult = await embedQueryText("migration_probe", { config });
+            currentSpace = probeResult.space;
+            console.log(`[ExperienceEngine] Active space: ${currentSpace.provider}/${currentSpace.model} (${currentSpace.dimensions}d, manifest=${currentSpace.manifestId || "none"})`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(`[ExperienceEngine] Failed to resolve active space: ${msg}`);
+            return;
+        }
+        const db = openDatabase(config);
+        bootstrapDatabase(db);
+        try {
+            const pipeline = new VectorMigrationPipeline();
+            console.log("[ExperienceEngine] Discovering nodes needing migration...");
+            const pendingCount = pipeline.discoverPendingNodes(db, currentSpace);
+            console.log(`[ExperienceEngine] Discovered ${pendingCount} pending nodes.`);
+            if (pendingCount === 0) {
+                console.log("[ExperienceEngine] All vectors are up-to-date in active space. No migration needed.");
+                return;
+            }
+            console.log("[ExperienceEngine] Running vector migration pipeline...");
+            const report = await pipeline.runMigration(db, currentSpace, {
+                config,
+                batchSize: parsed.batchSize,
+                throttleGapMs: parsed.throttleGapMs,
+                maxTotalToProcess: parsed.maxTotal
+            });
+            console.log("[ExperienceEngine] Vector migration finished!");
+            console.log(`[ExperienceEngine] Total discovered: ${report.totalDiscovered} | Processed: ${report.processed} | Succeeded: ${report.succeeded} | Failed: ${report.failed}`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.stack || error.message : String(error);
+            console.error(`[ExperienceEngine] Fatal migration error: ${msg}`);
+        }
+        finally {
+            db.close();
+        }
+        return;
+    }
+    console.log("Usage: ee maintenance embeddings-reset|embedding-smoke|governance drain|redistill-rule-nodes|claude-validate-print|merge-scope <sourceScopeId> <targetScopeId>|migrate [--batch-size <n>] [--throttle-gap <ms>] [--max-total <n>]");
 };
 //# sourceMappingURL=maintenance.js.map

package/dist/cli/commands/maintenance.js.map

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

package/dist/compiler/command-normalizer.d.ts

@@ -0,0 +1,27 @@
+import type { ToolEvent, NormalizedToolEvent } from "../types/domain.js";
+export declare class CommandNormalizer {
+    /**
+     * Redacts volatile components like UUIDs, absolute/relative paths, ports, and branch names.
+     */
+    static redactVolatileTokens(input: string): string;
+    /**
+     * Helper to extract the basename from a file path.
+     */
+    static getBasename(pathStr: string): string;
+    /**
+     * Helper to extract the file extension.
+     */
+    static getExtension(pathStr: string): string;
+    /**
+     * Normalizes a raw shell command string to extract commandFamily, subcommand, and redacted inputs.
+     */
+    static normalizeCommand(rawCommand: string): {
+        commandFamily?: string;
+        subcommand?: string;
+        normalizedInput: string;
+    };
+    /**
+     * Transforms a raw ToolEvent into a NormalizedToolEvent.
+     */
+    static normalizeToolEvent(event: ToolEvent): NormalizedToolEvent;
+}

package/dist/compiler/command-normalizer.js

@@ -0,0 +1,263 @@
+export class CommandNormalizer {
+    /**
+     * Redacts volatile components like UUIDs, absolute/relative paths, ports, and branch names.
+     */
+    static redactVolatileTokens(input) {
+        if (!input)
+            return "";
+        let redacted = input;
+        // 1. Redact UUIDs
+        const uuidRegex = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+        redacted = redacted.replace(uuidRegex, "[UUID]");
+        // 2. Redact absolute Windows and Unix paths
+        // Windows paths like C:\Users\...\file.ext or d:/project/...
+        const winPathRegex = /[a-zA-Z]:\\[^\s"']+/g;
+        redacted = redacted.replace(winPathRegex, "[PATH]");
+        const winForwardPathRegex = /[a-zA-Z]:\/(?!\/)[^\s"']+/g;
+        redacted = redacted.replace(winForwardPathRegex, "[PATH]");
+        // Unix paths like /home/user/... or /tmp/...
+        // Avoid redacting commands starting with slash or generic patterns, so we only match longer path-like strings
+        const unixPathRegex = /(?:^|[\s"'\(=])(\/(?:home|Users|tmp|usr|opt|var|etc|bin|projects?|workspace|app)[a-zA-Z0-9_\-\.\/]+)/gi;
+        redacted = redacted.replace(unixPathRegex, (match, p1) => {
+            return match.replace(p1, "[PATH]");
+        });
+        // 3. Redact port numbers (e.g. :3000 or :8080)
+        const portRegex = /:([0-9]{4,5})\b/g;
+        redacted = redacted.replace(portRegex, ":[PORT]");
+        // 4. Redact branch names in git checkout command, or any feature/issue branch patterns
+        // E.g., feature/issue-102 or bugfix/abc
+        const branchRegex = /\b(feature|bugfix|release|hotfix|origin)\/[a-zA-Z0-9_\-\.]+/gi;
+        redacted = redacted.replace(branchRegex, "[BRANCH]");
+        // Also redact the specific git branch argument in checkout/switch commands
+        const gitCheckoutRegex = /(git\s+(?:checkout|switch)\s+(-b\s+)?)([a-zA-Z0-9_\-\.\/]+)/gi;
+        redacted = redacted.replace(gitCheckoutRegex, (match, p1, p2, p3) => {
+            // If p3 is not an option (starts with -), redact it
+            if (p3 && !p3.startsWith("-")) {
+                return `${p1}[BRANCH]`;
+            }
+            return match;
+        });
+        return redacted;
+    }
+    /**
+     * Helper to extract the basename from a file path.
+     */
+    static getBasename(pathStr) {
+        const normalized = pathStr.replace(/\\/g, "/");
+        const parts = normalized.split("/");
+        return parts[parts.length - 1] || "";
+    }
+    /**
+     * Helper to extract the file extension.
+     */
+    static getExtension(pathStr) {
+        const basename = this.getBasename(pathStr);
+        const dotIndex = basename.lastIndexOf(".");
+        if (dotIndex === -1 || dotIndex === 0)
+            return "";
+        return basename.slice(dotIndex + 1);
+    }
+    /**
+     * Normalizes a raw shell command string to extract commandFamily, subcommand, and redacted inputs.
+     */
+    static normalizeCommand(rawCommand) {
+        const redacted = this.redactVolatileTokens(rawCommand.trim());
+        if (!redacted) {
+            return { normalizedInput: "" };
+        }
+        // Split into tokens
+        const tokens = redacted.split(/\s+/);
+        let rawExecutable = tokens[0] || "";
+        // Normalize executable path (e.g. .\node_modules\.bin\tsc -> tsc)
+        let executable = this.getBasename(rawExecutable).replace(/\.(exe|cmd|bat|sh)$/i, "").toLowerCase();
+        // Group common executables/aliases
+        if (["pnpm", "npm", "yarn", "bun", "npx"].includes(executable)) {
+            // Package managers
+            let subcommand = "";
+            // Find first non-option token after package manager
+            let subIdx = 1;
+            while (subIdx < tokens.length && tokens[subIdx]?.startsWith("-")) {
+                subIdx++;
+            }
+            const primarySub = tokens[subIdx] || "";
+            if (primarySub && !primarySub.startsWith("-")) {
+                subcommand = primarySub.toLowerCase();
+                if (subcommand === "run" || subcommand === "exec") {
+                    // If "run" or "exec", try to capture the next script name (e.g. pnpm run build -> run_build, pnpm exec tsc -> exec_tsc)
+                    let scriptIdx = subIdx + 1;
+                    while (scriptIdx < tokens.length && tokens[scriptIdx]?.startsWith("-")) {
+                        scriptIdx++;
+                    }
+                    const scriptName = tokens[scriptIdx] || "";
+                    if (scriptName && !scriptName.startsWith("-")) {
+                        subcommand = `${subcommand}_${scriptName.toLowerCase()}`;
+                    }
+                }
+            }
+            return {
+                commandFamily: executable,
+                subcommand,
+                normalizedInput: redacted
+            };
+        }
+        if (executable === "git") {
+            let subcommand = "";
+            let subIdx = 1;
+            while (subIdx < tokens.length && tokens[subIdx]?.startsWith("-")) {
+                subIdx++;
+            }
+            const primarySub = tokens[subIdx] || "";
+            if (primarySub && !primarySub.startsWith("-")) {
+                subcommand = primarySub.toLowerCase();
+            }
+            return {
+                commandFamily: "git",
+                subcommand,
+                normalizedInput: redacted
+            };
+        }
+        // Other known build/test tools
+        if (["tsc", "vitest", "jest", "mocha", "eslint", "prettier", "vite", "next"].includes(executable)) {
+            return {
+                commandFamily: executable,
+                subcommand: "run",
+                normalizedInput: redacted
+            };
+        }
+        // Fallback for general executables
+        return {
+            commandFamily: executable || undefined,
+            normalizedInput: redacted
+        };
+    }
+    /**
+     * Transforms a raw ToolEvent into a NormalizedToolEvent.
+     */
+    static normalizeToolEvent(event) {
+        const status = event.status;
+        const normalizedOutput = event.output_summary ? this.redactVolatileTokens(event.output_summary) : undefined;
+        // Handle command executions
+        const isCmdToolName = /^(run_command|bash|execute_command|terminal|sh)$/i.test(event.tool_name);
+        if (isCmdToolName && event.input_summary) {
+            const normalizedCmd = this.normalizeCommand(event.input_summary);
+            return {
+                toolName: event.tool_name,
+                commandFamily: normalizedCmd.commandFamily,
+                subcommand: normalizedCmd.subcommand,
+                normalizedInput: normalizedCmd.normalizedInput,
+                normalizedOutput,
+                status
+            };
+        }
+        // Handle host-native file tools
+        const isFileToolName = /^(write_to_file|replace_file_content|multi_replace_file_content|write_file|read_file|view_file|apply_patch)$/i.test(event.tool_name);
+        if (isFileToolName && event.input_summary) {
+            const trimmed = event.input_summary.trim();
+            const pathsSet = new Set();
+            const addPath = (p) => {
+                if (p && typeof p === "string") {
+                    let cleaned = p.trim();
+                    cleaned = cleaned.replace(/^['"]|['"]$/g, "").trim();
+                    if (cleaned) {
+                        pathsSet.add(cleaned.replace(/\\/g, "/"));
+                    }
+                }
+            };
+            const extractPathsFromString = (text) => {
+                // Regex to match:
+                // *** Update File: path
+                // *** Add File: path
+                // *** Delete File: path
+                // Stop at any double quote, backslash, or comma which might demarcate JSON fields.
+                const patchPattern = /\*\*\*\s+(?:Update|Add|Delete)\s+File:\s*([^\r\n"\\,]+)/gi;
+                let match;
+                while ((match = patchPattern.exec(text)) !== null) {
+                    if (match[1]) {
+                        addPath(match[1]);
+                    }
+                }
+                // Regex to match git/standard diff headers:
+                // --- a/path
+                // +++ b/path
+                // Support optional quotes that may prefix/suffix headers in JSON formatting
+                const diffPattern = /^(?:"?--- a\/|"?\+\+\+ b\/)([^\r\n\t "]+)/gm;
+                let diffMatch;
+                while ((diffMatch = diffPattern.exec(text)) !== null) {
+                    if (diffMatch[1]) {
+                        addPath(diffMatch[1]);
+                    }
+                }
+            };
+            const walkJson = (val) => {
+                if (!val)
+                    return;
+                if (typeof val === "string") {
+                    extractPathsFromString(val);
+                }
+                else if (Array.isArray(val)) {
+                    for (const item of val) {
+                        walkJson(item);
+                    }
+                }
+                else if (typeof val === "object") {
+                    for (const key of Object.keys(val)) {
+                        const lowKey = key.toLowerCase();
+                        const isPathProp = lowKey === "path" ||
+                            lowKey === "filepath" ||
+                            lowKey === "targetfile" ||
+                            lowKey === "filename" ||
+                            lowKey === "file";
+                        if (isPathProp && typeof val[key] === "string") {
+                            addPath(val[key]);
+                        }
+                        walkJson(val[key]);
+                    }
+                }
+            };
+            // Unescape escaped newline structures and replace double backslashes
+            let normalizedText = trimmed
+                .replace(/\\r\\n/g, "\n")
+                .replace(/\\n/g, "\n")
+                .replace(/\\r/g, "\n")
+                .replace(/\\\\/g, "/");
+            // 1. Try parsing normalizedText as JSON
+            if (normalizedText.startsWith("{") || normalizedText.startsWith("[")) {
+                try {
+                    const parsed = JSON.parse(normalizedText);
+                    walkJson(parsed);
+                }
+                catch {
+                    // ignore parsing error, fallback to raw string extraction
+                }
+            }
+            // 2. Also run regex on normalized text directly
+            extractPathsFromString(normalizedText);
+            // 3. Fallback if no paths were resolved
+            if (pathsSet.size === 0) {
+                addPath(trimmed);
+            }
+            const paths = Array.from(pathsSet);
+            const primaryPath = paths[0] || "";
+            const basename = this.getBasename(primaryPath);
+            const extension = this.getExtension(primaryPath);
+            return {
+                toolName: event.tool_name,
+                artifactName: basename || undefined,
+                artifactExtension: extension || undefined,
+                artifactPath: primaryPath || undefined,
+                artifactPaths: paths,
+                normalizedInput: this.redactVolatileTokens(trimmed),
+                normalizedOutput,
+                status
+            };
+        }
+        // Default normalization
+        return {
+            toolName: event.tool_name,
+            normalizedInput: event.input_summary ? this.redactVolatileTokens(event.input_summary) : undefined,
+            normalizedOutput,
+            status
+        };
+    }
+}
+//# sourceMappingURL=command-normalizer.js.map

package/dist/compiler/command-normalizer.js.map

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

package/dist/compiler/trajectory-compiler.d.ts

@@ -0,0 +1,12 @@
+import type { TrajectoryExpectation, CompiledTrajectoryExpectations, TrajectoryExpectationType } from "../types/domain.js";
+export declare class TrajectoryCompiler {
+    static cleanStepProse(step: string): string;
+    /**
+     * Compiles a single step prose into a TrajectoryExpectation structure.
+     */
+    static compileStep(stepProse: string, type: TrajectoryExpectationType): TrajectoryExpectation;
+    /**
+     * Compiles recommended_steps, avoid_steps, success_signal, stop_condition, and escalation_condition of an ExperienceNode into CompiledTrajectoryExpectations.
+     */
+    static compileNodeExpectations(recommendedSteps?: string[], avoidSteps?: string[], successSignal?: string, stopCondition?: string, escalationCondition?: string): CompiledTrajectoryExpectations;
+}

package/dist/compiler/trajectory-compiler.js

@@ -0,0 +1,179 @@
+import { createId } from "../utils/ids.js";
+import { CommandNormalizer } from "./command-normalizer.js";
+export class TrajectoryCompiler {
+    static cleanStepProse(step) {
+        if (!step)
+            return "";
+        return step
+            .replace(/^[\s\-\*\u2022\d\.\)]+/, "")
+            .trim();
+    }
+    /**
+     * Compiles a single step prose into a TrajectoryExpectation structure.
+     */
+    static compileStep(stepProse, type) {
+        const originalStep = stepProse.trim();
+        const cleanStep = this.cleanStepProse(originalStep);
+        const id = createId("exp");
+        // 1. Check for command features
+        // Match package manager followed by run/exec
+        const pkgManagerRegex = /\b(pnpm|npm|yarn|bun|npx)\s+(run|exec)\s+([a-zA-Z0-9_\-\.\/]+)/i;
+        const pkgManagerMatch = cleanStep.match(pkgManagerRegex);
+        let commandMatch = pkgManagerMatch;
+        let isPkgManager = false;
+        if (pkgManagerMatch) {
+            isPkgManager = true;
+        }
+        else {
+            // Match common executables (pnpm, npm, git, tsc, vitest, docker, etc.)
+            const commandRegex = /\b(pnpm|npm|yarn|bun|npx|git|tsc|vitest|jest|mocha|eslint|prettier|vite|next|docker)\b\s*([a-zA-Z0-9_\-\.\/]+)?/i;
+            commandMatch = cleanStep.match(commandRegex);
+        }
+        if (commandMatch) {
+            const exe = commandMatch[1]?.toLowerCase();
+            const sub = commandMatch[2]?.toLowerCase() || "";
+            const rawExtracted = commandMatch[0];
+            const norm = CommandNormalizer.normalizeCommand(rawExtracted);
+            const commandFamily = norm.commandFamily || exe;
+            const subcommand = norm.subcommand || (sub && !sub.startsWith("-") ? sub : undefined);
+            const commandPattern = subcommand
+                ? `${commandFamily} ${subcommand}`
+                : commandFamily;
+            return {
+                id,
+                type,
+                actionType: "command",
+                toolNamePattern: "run_command|bash|execute_command|terminal|sh",
+                commandPattern,
+                originalStep,
+                ordered: type === "recommend" // Recommended commands are ordered; avoid commands check globally
+            };
+        }
+        // 2. Check for file / artifact manipulation features
+        // Match file extensions or edit verbs + files
+        const fileVerbRegex = /\b(edit|modify|write|create|touch|update|delete|remove|read|view|inspect)\s+([a-zA-Z0-9_\-\.\/\\\*]+\.[a-zA-Z0-9]+)/i;
+        const fileVerbMatch = cleanStep.match(fileVerbRegex);
+        const genericFileRegex = /\b([a-zA-Z0-9_\-\.\/\\\*]+\.([a-zA-Z0-9]+))\b/;
+        const genericFileMatch = cleanStep.match(genericFileRegex);
+        if (fileVerbMatch) {
+            const filePath = fileVerbMatch[2] || "";
+            const verb = (fileVerbMatch[1] || "").toLowerCase();
+            let artifactAction = "any";
+            if (["read", "view", "inspect"].includes(verb)) {
+                artifactAction = "read";
+            }
+            else if (["edit", "modify", "write", "create", "touch", "update", "delete", "remove"].includes(verb)) {
+                artifactAction = "write";
+            }
+            return {
+                id,
+                type,
+                actionType: "artifact",
+                artifactPattern: filePath,
+                artifactAction,
+                originalStep,
+                ordered: false // Artifact touches can happen in any order
+            };
+        }
+        else if (genericFileMatch) {
+            const filePath = genericFileMatch[1] || "";
+            const ext = genericFileMatch[2] || "";
+            // Exclude false positives like common words (e.g. e.g. or i.e.)
+            if (ext && !["eg", "ie", "md", "txt"].includes(ext.toLowerCase())) {
+                return {
+                    id,
+                    type,
+                    actionType: "artifact",
+                    artifactPattern: filePath,
+                    artifactAction: "any",
+                    originalStep,
+                    ordered: false
+                };
+            }
+        }
+        // 3. Fallback to generic action type
+        return {
+            id,
+            type,
+            actionType: "generic",
+            originalStep,
+            ordered: false
+        };
+    }
+    /**
+     * Compiles recommended_steps, avoid_steps, success_signal, stop_condition, and escalation_condition of an ExperienceNode into CompiledTrajectoryExpectations.
+     */
+    static compileNodeExpectations(recommendedSteps, avoidSteps, successSignal, stopCondition, escalationCondition) {
+        const orderedExpectations = [];
+        const unorderedExpectations = [];
+        // Compile recommended steps
+        if (recommendedSteps && Array.isArray(recommendedSteps)) {
+            for (const step of recommendedSteps) {
+                if (!step.trim())
+                    continue;
+                const exp = {
+                    ...this.compileStep(step, "recommend"),
+                    sourceField: "recommended_steps",
+                    requiredForAdoption: true
+                };
+                if (exp.ordered) {
+                    orderedExpectations.push(exp);
+                }
+                else {
+                    unorderedExpectations.push(exp);
+                }
+            }
+        }
+        // Compile avoid steps
+        if (avoidSteps && Array.isArray(avoidSteps)) {
+            for (const step of avoidSteps) {
+                if (!step.trim())
+                    continue;
+                const exp = this.compileStep(step, "avoid");
+                // Avoid step expectations are ALWAYS unordered because they trigger non-adoption violations globally
+                unorderedExpectations.push({
+                    ...exp,
+                    ordered: false,
+                    sourceField: "avoid_steps",
+                    requiredForAdoption: false
+                });
+            }
+        }
+        // Compile success_signal
+        if (successSignal && successSignal.trim()) {
+            const exp = this.compileStep(successSignal, "recommend");
+            unorderedExpectations.push({
+                ...exp,
+                id: exp.id.replace("exp_", "success_"),
+                ordered: false,
+                sourceField: "success_signal",
+                requiredForAdoption: false
+            });
+        }
+        // Compile stop_condition
+        if (stopCondition && stopCondition.trim()) {
+            const exp = this.compileStep(stopCondition, "avoid");
+            unorderedExpectations.push({
+                ...exp,
+                ordered: false,
+                sourceField: "stop_condition",
+                requiredForAdoption: false
+            });
+        }
+        // Compile escalation_condition
+        if (escalationCondition && escalationCondition.trim()) {
+            const exp = this.compileStep(escalationCondition, "avoid");
+            unorderedExpectations.push({
+                ...exp,
+                ordered: false,
+                sourceField: "escalation_condition",
+                requiredForAdoption: false
+            });
+        }
+        return {
+            orderedExpectations,
+            unorderedExpectations
+        };
+    }
+}
+//# sourceMappingURL=trajectory-compiler.js.map