jfl 0.8.1 → 0.9.0

package/dist/lib/counterfactual-training-bridge.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Counterfactual Training Bridge
+ *
+ * Transforms CounterfactualScenario outputs into v2 training tuples
+ * and mixes them into the training buffer at Drew's recommended 70/30 ratio.
+ *
+ * Pipeline:
+ *   1. Read stored counterfactuals from WorldModelStore
+ *   2. For each counterfactual, create a synthetic training tuple:
+ *      - state = base transition's prior state
+ *      - action = counterfactual's alternative action
+ *      - reward = counterfactual's predicted outcome
+ *      - source = "counterfactual" (tagged for 70/30 mix tracking)
+ *   3. Write to training buffer with counterfactual metadata
+ *   4. Optionally generate v2 format for direct PolicyHead training
+ *
+ * Drew's recommendation (section 8.2):
+ *   - 70% real transitions + 30% synthetic counterfactuals in training batches
+ *   - Counterfactuals provide: paths not taken, diverse scenarios, faster convergence
+ *   - Weight real transitions higher than counterfactuals
+ *
+ * @purpose Bridge counterfactual scenarios to PolicyHead training data
+ * @spec knowledge/DREW-RESPONSE-ANSWERS.md
+ * @decision drew-counterfactual-training
+ */
+export interface CounterfactualBridgeConfig {
+    /** Target ratio of real to synthetic in training buffer (default: 0.3 = 30% synthetic) */
+    syntheticRatio: number;
+    /** Minimum probability mass to include a counterfactual (default: 0.2) */
+    minProbabilityMass: number;
+    /** Minimum confidence in counterfactual prediction (default: 0.3) */
+    minPredictionConfidence: number;
+    /** Whether to deduplicate against existing buffer entries (default: true) */
+    deduplicateAgainstBuffer: boolean;
+    /** Maximum synthetic entries to add per run (default: 500) */
+    maxSyntheticPerRun: number;
+    /** Whether to generate v2 format files for direct training (default: true) */
+    generateV2Format: boolean;
+    /** Output directory for v2 format data (default: .jfl/v2-data) */
+    v2OutputDir: string;
+}
+export interface BridgeResult {
+    /** Total counterfactuals processed */
+    counterfactualsProcessed: number;
+    /** Counterfactuals that passed quality filters */
+    passedFilters: number;
+    /** New tuples added to training buffer */
+    tuplesAdded: number;
+    /** Tuples skipped (duplicates) */
+    duplicatesSkipped: number;
+    /** Current buffer composition */
+    bufferComposition: {
+        totalEntries: number;
+        realEntries: number;
+        syntheticEntries: number;
+        syntheticRatio: number;
+        targetRatio: number;
+    };
+    /** V2 format files generated (if enabled) */
+    v2FilesGenerated: string[];
+}
+export declare class CounterfactualTrainingBridge {
+    private store;
+    private trainingBuffer;
+    private config;
+    private projectRoot;
+    constructor(projectRoot?: string, config?: Partial<CounterfactualBridgeConfig>);
+    /**
+     * Main pipeline: read counterfactuals → filter → transform → write to buffer
+     *
+     * @param since - Only process counterfactuals generated after this timestamp
+     * @returns Summary of what was processed
+     */
+    run(since?: number): Promise<BridgeResult>;
+    /**
+     * Transform a counterfactual scenario into a training buffer entry
+     */
+    private counterfactualToTuple;
+    /**
+     * Score a synthetic tuple for quality/priority ranking
+     * Higher = better quality, more informative for training
+     */
+    private scoreSyntheticTuple;
+    /**
+     * Check if a training buffer entry is synthetic (counterfactual-derived)
+     */
+    private isSynthetic;
+    /**
+     * Generate v2 format data file for direct PolicyHead training
+     * Outputs JSONL with {current_state, goal, correct_tool, source} format
+     */
+    private generateV2Data;
+    /**
+     * Format RLState as text for v2 training format (matches transform_buffer.py)
+     */
+    private formatStateForV2;
+    /**
+     * Derive a goal string from a training tuple
+     */
+    private deriveGoal;
+    /**
+     * Get current buffer composition stats
+     */
+    getBufferStats(): {
+        total: number;
+        real: number;
+        synthetic: number;
+        ratio: number;
+        targetRatio: number;
+        needsMore: boolean;
+    };
+}
+export declare function createCounterfactualBridge(projectRoot?: string, config?: Partial<CounterfactualBridgeConfig>): CounterfactualTrainingBridge;
+//# sourceMappingURL=counterfactual-training-bridge.d.ts.map

package/dist/lib/counterfactual-training-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counterfactual-training-bridge.d.ts","sourceRoot":"","sources":["../../src/lib/counterfactual-training-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAoBH,MAAM,WAAW,0BAA0B;IACzC,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAA;IACtB,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,CAAA;IAC/B,6EAA6E;IAC7E,wBAAwB,EAAE,OAAO,CAAA;IACjC,8DAA8D;IAC9D,kBAAkB,EAAE,MAAM,CAAA;IAC1B,8EAA8E;IAC9E,gBAAgB,EAAE,OAAO,CAAA;IACzB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;CACpB;AAgBD,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,wBAAwB,EAAE,MAAM,CAAA;IAChC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAA;IACzB,iCAAiC;IACjC,iBAAiB,EAAE;QACjB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,gBAAgB,EAAE,MAAM,CAAA;QACxB,cAAc,EAAE,MAAM,CAAA;QACtB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAyBD,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAQ;gBAEf,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAO9E;;;;;OAKG;IACG,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyGhD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;;OAGG;YACW,cAAc;IAkC5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,cAAc,IAAI;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,OAAO,CAAA;KACnB;CAeF;AAMD,wBAAgB,0BAA0B,CACxC,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC3C,4BAA4B,CAE9B"}

package/dist/lib/counterfactual-training-bridge.js

@@ -0,0 +1,322 @@
+/**
+ * Counterfactual Training Bridge
+ *
+ * Transforms CounterfactualScenario outputs into v2 training tuples
+ * and mixes them into the training buffer at Drew's recommended 70/30 ratio.
+ *
+ * Pipeline:
+ *   1. Read stored counterfactuals from WorldModelStore
+ *   2. For each counterfactual, create a synthetic training tuple:
+ *      - state = base transition's prior state
+ *      - action = counterfactual's alternative action
+ *      - reward = counterfactual's predicted outcome
+ *      - source = "counterfactual" (tagged for 70/30 mix tracking)
+ *   3. Write to training buffer with counterfactual metadata
+ *   4. Optionally generate v2 format for direct PolicyHead training
+ *
+ * Drew's recommendation (section 8.2):
+ *   - 70% real transitions + 30% synthetic counterfactuals in training batches
+ *   - Counterfactuals provide: paths not taken, diverse scenarios, faster convergence
+ *   - Weight real transitions higher than counterfactuals
+ *
+ * @purpose Bridge counterfactual scenarios to PolicyHead training data
+ * @spec knowledge/DREW-RESPONSE-ANSWERS.md
+ * @decision drew-counterfactual-training
+ */
+import { writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { worldStateToRLState, agentActionToRLAction } from "../types/world-model.js";
+import { WorldModelStore } from "./world-model-store.js";
+import { TrainingBuffer } from "./training-buffer.js";
+const DEFAULT_CONFIG = {
+    syntheticRatio: 0.3,
+    minProbabilityMass: 0.2,
+    minPredictionConfidence: 0.3,
+    deduplicateAgainstBuffer: true,
+    maxSyntheticPerRun: 500,
+    generateV2Format: true,
+    v2OutputDir: ".jfl/v2-data",
+};
+// ============================================================================
+// Action Type Mapping (matches domain.json + transform_buffer.py)
+// ============================================================================
+const AGENT_ACTION_TO_TOOL = {
+    "fix": "fix_bug",
+    "refactor": "refactor_code",
+    "feature": "add_feature",
+    "test": "add_tests",
+    "config": "update_config",
+    "experiment": "run_experiment",
+    "eval": "run_eval",
+    "autoresearch": "run_experiment",
+    "research": "Read",
+    "skip": "skip",
+    "commit": "update_config",
+    "scheduled": "run_experiment",
+};
+// ============================================================================
+// Counterfactual Training Bridge
+// ============================================================================
+export class CounterfactualTrainingBridge {
+    store;
+    trainingBuffer;
+    config;
+    projectRoot;
+    constructor(projectRoot, config) {
+        this.projectRoot = projectRoot || process.cwd();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.store = new WorldModelStore(this.projectRoot);
+        this.trainingBuffer = new TrainingBuffer(this.projectRoot);
+    }
+    /**
+     * Main pipeline: read counterfactuals → filter → transform → write to buffer
+     *
+     * @param since - Only process counterfactuals generated after this timestamp
+     * @returns Summary of what was processed
+     */
+    async run(since) {
+        // Step 1: Read all counterfactuals
+        const allCounterfactuals = this.store.getAllCounterfactuals();
+        const counterfactuals = since
+            ? allCounterfactuals.filter(cf => cf.generatedAt > since)
+            : allCounterfactuals;
+        // Step 2: Get current buffer composition for ratio targeting
+        const existingBuffer = this.trainingBuffer.read();
+        const realEntries = existingBuffer.filter(e => e.metadata.source !== "mined" || !this.isSynthetic(e));
+        const syntheticEntries = existingBuffer.filter(e => this.isSynthetic(e));
+        const existingIds = new Set(existingBuffer.map(e => e.id));
+        // Calculate how many synthetic entries we need to hit target ratio
+        const currentTotal = existingBuffer.length;
+        const targetSynthetic = Math.floor(currentTotal * this.config.syntheticRatio / (1 - this.config.syntheticRatio));
+        const syntheticDeficit = Math.max(0, targetSynthetic - syntheticEntries.length);
+        // Step 3: Filter counterfactuals by quality
+        const qualityFiltered = counterfactuals.filter(cf => cf.probabilityMass >= this.config.minProbabilityMass);
+        // Step 4: Get base transitions for context
+        const transitionMap = new Map();
+        const transitions = this.store.getTransitions({ limit: 10000 });
+        for (const t of transitions) {
+            transitionMap.set(t.id, t);
+        }
+        // Step 5: Transform counterfactuals into training tuples
+        const syntheticTuples = [];
+        for (const cf of qualityFiltered) {
+            const baseTransition = transitionMap.get(cf.baseTransitionId);
+            if (!baseTransition)
+                continue;
+            const tuple = this.counterfactualToTuple(cf, baseTransition);
+            if (!tuple)
+                continue;
+            // Score for prioritization (higher = better quality)
+            const score = this.scoreSyntheticTuple(cf, baseTransition);
+            syntheticTuples.push({ tuple, score });
+        }
+        // Step 6: Rank by quality and cap at limits
+        syntheticTuples.sort((a, b) => b.score - a.score);
+        const maxToAdd = Math.min(syntheticTuples.length, this.config.maxSyntheticPerRun, syntheticDeficit > 0 ? syntheticDeficit : this.config.maxSyntheticPerRun);
+        // Step 7: Write to training buffer
+        let added = 0;
+        let duplicates = 0;
+        for (let i = 0; i < maxToAdd; i++) {
+            const { tuple } = syntheticTuples[i];
+            // Deduplication check
+            if (this.config.deduplicateAgainstBuffer) {
+                const candidateId = `tb_cf_${cf_hash(tuple)}`;
+                if (existingIds.has(candidateId)) {
+                    duplicates++;
+                    continue;
+                }
+            }
+            this.trainingBuffer.append(tuple);
+            added++;
+        }
+        // Step 8: Generate v2 format if enabled
+        const v2Files = [];
+        if (this.config.generateV2Format && added > 0) {
+            const v2Path = await this.generateV2Data(syntheticTuples.slice(0, maxToAdd).map(s => s.tuple));
+            if (v2Path)
+                v2Files.push(v2Path);
+        }
+        // Step 9: Compute final buffer composition
+        const finalBuffer = this.trainingBuffer.read();
+        const finalReal = finalBuffer.filter(e => !this.isSynthetic(e));
+        const finalSynthetic = finalBuffer.filter(e => this.isSynthetic(e));
+        return {
+            counterfactualsProcessed: counterfactuals.length,
+            passedFilters: qualityFiltered.length,
+            tuplesAdded: added,
+            duplicatesSkipped: duplicates,
+            bufferComposition: {
+                totalEntries: finalBuffer.length,
+                realEntries: finalReal.length,
+                syntheticEntries: finalSynthetic.length,
+                syntheticRatio: finalBuffer.length > 0 ? finalSynthetic.length / finalBuffer.length : 0,
+                targetRatio: this.config.syntheticRatio,
+            },
+            v2FilesGenerated: v2Files,
+        };
+    }
+    /**
+     * Transform a counterfactual scenario into a training buffer entry
+     */
+    counterfactualToTuple(cf, baseTransition) {
+        const rlState = worldStateToRLState(baseTransition.priorState);
+        const rlAction = agentActionToRLAction(cf.alternativeAction);
+        // Compute reward from counterfactual predicted outcome
+        const predictedDelta = cf.predictedOutcome.immediate.evalScoreChange ?? 0;
+        const actualDelta = baseTransition.outcome.immediate.evalScoreChange ?? 0;
+        // The counterfactual tells us: "if you'd done X instead of Y, the outcome would be Z"
+        // For training: the action is X, the reward signal is the predicted delta
+        const improved = predictedDelta > actualDelta;
+        return {
+            agent: cf.alternativeAction.agentId,
+            state: rlState,
+            action: rlAction,
+            reward: {
+                composite_delta: predictedDelta,
+                dimension_deltas: {},
+                tests_added: 0,
+                quality_score: improved ? 1 : 0,
+                improved,
+                prediction_error: undefined,
+            },
+            metadata: {
+                branch: "counterfactual",
+                source: "mined", // Use "mined" since TrainingBufferEntry requires specific sources
+                mine_source: "counterfactual_engine",
+                prediction_id: cf.baseTransitionId,
+                hypothesis: `Counterfactual ${cf.counterfactualType}: ${cf.alternativeAction.actionType} instead of original (prob=${cf.probabilityMass.toFixed(2)})`,
+            },
+        };
+    }
+    /**
+     * Score a synthetic tuple for quality/priority ranking
+     * Higher = better quality, more informative for training
+     */
+    scoreSyntheticTuple(cf, baseTransition) {
+        let score = 0;
+        // Higher probability mass = more confident prediction
+        score += cf.probabilityMass * 3;
+        // Larger difference from actual outcome = more informative
+        const actualDelta = baseTransition.outcome.immediate.evalScoreChange ?? 0;
+        const cfDelta = cf.predictedOutcome.immediate.evalScoreChange ?? 0;
+        const deltaGap = Math.abs(cfDelta - actualDelta);
+        score += Math.min(deltaGap * 10, 3); // Cap at 3
+        // Action type diversity bonus
+        if (cf.alternativeAction.actionType !== baseTransition.action.actionType) {
+            score += 1;
+        }
+        // Agent diversity bonus (scheduling counterfactuals)
+        if (cf.alternativeAction.agentId !== baseTransition.action.agentId) {
+            score += 0.5;
+        }
+        // Baseline (skip) counterfactuals are always valuable
+        if (cf.counterfactualType === "baseline") {
+            score += 1;
+        }
+        // Penalize very low probability mass
+        if (cf.probabilityMass < 0.3) {
+            score -= 1;
+        }
+        return score;
+    }
+    /**
+     * Check if a training buffer entry is synthetic (counterfactual-derived)
+     */
+    isSynthetic(entry) {
+        return (entry.metadata.mine_source === "counterfactual_engine" ||
+            entry.metadata.branch === "counterfactual" ||
+            entry.metadata.hypothesis?.includes("Counterfactual") === true);
+    }
+    /**
+     * Generate v2 format data file for direct PolicyHead training
+     * Outputs JSONL with {current_state, goal, correct_tool, source} format
+     */
+    async generateV2Data(tuples) {
+        if (tuples.length === 0)
+            return null;
+        const outputDir = join(this.projectRoot, this.config.v2OutputDir);
+        mkdirSync(outputDir, { recursive: true });
+        const outputPath = join(outputDir, "counterfactual.jsonl");
+        // Transform to v2 format
+        const v2Lines = [];
+        for (const tuple of tuples) {
+            const toolName = AGENT_ACTION_TO_TOOL[tuple.action.type] || "run_experiment";
+            const v2Entry = {
+                current_state: this.formatStateForV2(tuple.state),
+                goal: this.deriveGoal(tuple),
+                correct_tool: toolName,
+                source: "counterfactual",
+                agent: tuple.agent,
+                improved: tuple.reward.improved,
+                reward_delta: tuple.reward.composite_delta,
+                counterfactual_type: tuple.metadata.hypothesis?.match(/Counterfactual (\w+)/)?.[1] || "unknown",
+                probability_mass: parseFloat(tuple.metadata.hypothesis?.match(/prob=([\d.]+)/)?.[1] || "0"),
+            };
+            v2Lines.push(JSON.stringify(v2Entry));
+        }
+        writeFileSync(outputPath, v2Lines.join("\n") + "\n");
+        return outputPath;
+    }
+    /**
+     * Format RLState as text for v2 training format (matches transform_buffer.py)
+     */
+    formatStateForV2(state) {
+        const dims = state.dimension_scores;
+        const dimsStr = Object.entries(dims)
+            .map(([k, v]) => `${k}=${v.toFixed(4)}`)
+            .join(", ") || "none";
+        const deltasStr = state.recent_deltas
+            .map(d => `${d >= 0 ? "+" : ""}${d.toFixed(4)}`)
+            .join(", ") || "none";
+        return [
+            `Agent: ${state.agent}`,
+            `Composite: ${state.composite_score.toFixed(4)}`,
+            `Tests: ${state.tests_passing}/${state.tests_total}`,
+            `Trajectory: ${state.trajectory_length}`,
+            `Dimensions: ${dimsStr}`,
+            `Recent deltas: ${deltasStr}`,
+        ].join("\n");
+    }
+    /**
+     * Derive a goal string from a training tuple
+     */
+    deriveGoal(tuple) {
+        const actionDesc = tuple.action.description;
+        if (actionDesc && actionDesc.length > 10) {
+            return actionDesc.slice(0, 200);
+        }
+        return `Improve codebase quality via ${tuple.action.type}`;
+    }
+    /**
+     * Get current buffer composition stats
+     */
+    getBufferStats() {
+        const buffer = this.trainingBuffer.read();
+        const synthetic = buffer.filter(e => this.isSynthetic(e));
+        const real = buffer.filter(e => !this.isSynthetic(e));
+        const ratio = buffer.length > 0 ? synthetic.length / buffer.length : 0;
+        return {
+            total: buffer.length,
+            real: real.length,
+            synthetic: synthetic.length,
+            ratio,
+            targetRatio: this.config.syntheticRatio,
+            needsMore: ratio < this.config.syntheticRatio,
+        };
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+export function createCounterfactualBridge(projectRoot, config) {
+    return new CounterfactualTrainingBridge(projectRoot, config);
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function cf_hash(tuple) {
+    const { createHash } = require("crypto");
+    const key = `cf-${tuple.agent}-${tuple.action.type}-${tuple.action.description.slice(0, 50)}-${tuple.reward.composite_delta}`;
+    return createHash("sha256").update(key).digest("hex").slice(0, 12);
+}
+//# sourceMappingURL=counterfactual-training-bridge.js.map

package/dist/lib/counterfactual-training-bridge.js.map

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

package/dist/lib/discovery-agent.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @purpose Discovery Agent - Manages progressive feature disclosure in Tenet IDE
+ *
+ * This agent decides when and how to reveal advanced capabilities to users.
+ * Goal: Gradually introduce powerful features without overwhelming users.
+ */
+export interface UserEngagement {
+    sessionsCount: number;
+    totalTimeMinutes: number;
+    featuresUsed: string[];
+    positiveSignals: string[];
+    confusionSignals: string[];
+    lastSeen: Date;
+    installDate: Date;
+}
+export interface FeatureReveal {
+    feature: string;
+    trigger: 'time_based' | 'usage_based' | 'engagement_based';
+    message: string;
+    subtitle?: string;
+    demoCommand?: string;
+    urgency: 'low' | 'normal' | 'high';
+}
+export declare class DiscoveryAgent {
+    private engagement;
+    constructor(engagement: UserEngagement);
+    /**
+     * Decide what feature to reveal next based on user readiness
+     */
+    decideNextReveal(): FeatureReveal | null;
+    /**
+     * Adjust revelation timeline based on user response
+     */
+    adjustTimeline(feature: string, response: 'positive' | 'negative' | 'confused'): void;
+    /**
+     * Check if user has been introduced to a feature
+     */
+    private hasSeenFeature;
+    /**
+     * Calculate days since a date
+     */
+    private daysSince;
+    /**
+     * User archetype detection for timeline customization
+     */
+    getUserArchetype(): 'power_user' | 'casual' | 'enterprise' | 'beginner';
+}
+//# sourceMappingURL=discovery-agent.d.ts.map

package/dist/lib/discovery-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-agent.d.ts","sourceRoot":"","sources":["../../src/lib/discovery-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,QAAQ,EAAE,IAAI,CAAA;IACd,WAAW,EAAE,IAAI,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,YAAY,GAAG,aAAa,GAAG,kBAAkB,CAAA;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;CACnC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAgB;gBAEtB,UAAU,EAAE,cAAc;IAItC;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAkExC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI;IAQrF;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,gBAAgB,IAAI,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU;CAQxE"}

package/dist/lib/discovery-agent.js

@@ -0,0 +1,111 @@
+/**
+ * @purpose Discovery Agent - Manages progressive feature disclosure in Tenet IDE
+ *
+ * This agent decides when and how to reveal advanced capabilities to users.
+ * Goal: Gradually introduce powerful features without overwhelming users.
+ */
+export class DiscoveryAgent {
+    engagement;
+    constructor(engagement) {
+        this.engagement = engagement;
+    }
+    /**
+     * Decide what feature to reveal next based on user readiness
+     */
+    decideNextReveal() {
+        const daysSinceInstall = this.daysSince(this.engagement.installDate);
+        const sessionCount = this.engagement.sessionsCount;
+        const isEngaged = this.engagement.positiveSignals.length > this.engagement.confusionSignals.length;
+        // Week 1: Basic automation hints
+        if (daysSinceInstall >= 1 && daysSinceInstall < 7 && sessionCount >= 3) {
+            return {
+                feature: 'automation_hints',
+                trigger: 'time_based',
+                message: 'I noticed some patterns in your workflow...',
+                subtitle: 'Want me to automate these repeated tasks?',
+                urgency: 'normal'
+            };
+        }
+        // Week 2: Show automation opportunities
+        if (daysSinceInstall >= 7 && isEngaged && !this.hasSeenFeature('automation_hints')) {
+            return {
+                feature: 'automation_hints',
+                trigger: 'engagement_based',
+                message: 'I\'ve been analyzing your workflow patterns...',
+                subtitle: 'Want to set up automated testing and optimization?',
+                demoCommand: 'tenet setup --advanced',
+                urgency: 'normal'
+            };
+        }
+        // Week 3: Show self-driving capabilities  
+        if (daysSinceInstall >= 14 && isEngaged && !this.hasSeenFeature('self_driving')) {
+            return {
+                feature: 'self_driving',
+                trigger: 'engagement_based',
+                message: 'Your project has active AI assistants working',
+                subtitle: 'Check the Project Automation panel to see what they\'re doing',
+                demoCommand: 'tenet ide add agents',
+                urgency: 'normal'
+            };
+        }
+        // Month 1: Advanced platform revelation
+        if (daysSinceInstall >= 21 && isEngaged && !this.hasSeenFeature('advanced_reveal')) {
+            return {
+                feature: 'advanced_reveal',
+                trigger: 'time_based',
+                message: 'Ready for the full intelligent development platform?',
+                subtitle: 'TLA+ verification, RL optimization, and CI automation await...',
+                demoCommand: 'tenet setup --full',
+                urgency: 'high'
+            };
+        }
+        // Month 2: Full revelation - you have an agentic platform
+        if (daysSinceInstall >= 30 && isEngaged && !this.hasSeenFeature('full_reveal')) {
+            return {
+                feature: 'full_reveal',
+                trigger: 'time_based',
+                message: 'You\'ve been using an agentic platform this whole time',
+                subtitle: 'Here\'s how the AI agents have been learning your workflow...',
+                urgency: 'high'
+            };
+        }
+        return null;
+    }
+    /**
+     * Adjust revelation timeline based on user response
+     */
+    adjustTimeline(feature, response) {
+        if (response === 'positive') {
+            this.engagement.positiveSignals.push(`feature_${feature}_accepted`);
+        }
+        else if (response === 'confused') {
+            this.engagement.confusionSignals.push(`feature_${feature}_rejected`);
+        }
+    }
+    /**
+     * Check if user has been introduced to a feature
+     */
+    hasSeenFeature(feature) {
+        return this.engagement.featuresUsed.includes(feature);
+    }
+    /**
+     * Calculate days since a date
+     */
+    daysSince(date) {
+        return Math.floor((Date.now() - date.getTime()) / (1000 * 60 * 60 * 24));
+    }
+    /**
+     * User archetype detection for timeline customization
+     */
+    getUserArchetype() {
+        const { sessionsCount, totalTimeMinutes, featuresUsed } = this.engagement;
+        if (sessionsCount > 20 && featuresUsed.length > 8)
+            return 'power_user';
+        if (totalTimeMinutes > 300 && featuresUsed.includes('portfolio'))
+            return 'enterprise';
+        if (sessionsCount < 5 && totalTimeMinutes < 60)
+            return 'beginner';
+        return 'casual';
+    }
+}
+//# sourceMappingURL=discovery-agent.js.map

package/dist/lib/discovery-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-agent.js","sourceRoot":"","sources":["../../src/lib/discovery-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,MAAM,OAAO,cAAc;IACjB,UAAU,CAAgB;IAElC,YAAY,UAA0B;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;QACpE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAA;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAA;QAElG,iCAAiC;QACjC,IAAI,gBAAgB,IAAI,CAAC,IAAI,gBAAgB,GAAG,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,kBAAkB;gBAC3B,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,6CAA6C;gBACtD,QAAQ,EAAE,2CAA2C;gBACrD,OAAO,EAAE,QAAQ;aAClB,CAAA;QACH,CAAC;QAED,wCAAwC;QACxC,IAAI,gBAAgB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,kBAAkB;gBAC3B,OAAO,EAAE,kBAAkB;gBAC3B,OAAO,EAAE,gDAAgD;gBACzD,QAAQ,EAAE,oDAAoD;gBAC9D,WAAW,EAAE,wBAAwB;gBACrC,OAAO,EAAE,QAAQ;aAClB,CAAA;QACH,CAAC;QAED,2CAA2C;QAC3C,IAAI,gBAAgB,IAAI,EAAE,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,CAAC;YAChF,OAAO;gBACL,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,kBAAkB;gBAC3B,OAAO,EAAE,+CAA+C;gBACxD,QAAQ,EAAE,+DAA+D;gBACzE,WAAW,EAAE,sBAAsB;gBACnC,OAAO,EAAE,QAAQ;aAClB,CAAA;QACH,CAAC;QAED,wCAAwC;QACxC,IAAI,gBAAgB,IAAI,EAAE,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,iBAAiB;gBAC1B,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,sDAAsD;gBAC/D,QAAQ,EAAE,gEAAgE;gBAC1E,WAAW,EAAE,oBAAoB;gBACjC,OAAO,EAAE,MAAM;aAChB,CAAA;QACH,CAAC;QAED,0DAA0D;QAC1D,IAAI,gBAAgB,IAAI,EAAE,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/E,OAAO;gBACL,OAAO,EAAE,aAAa;gBACtB,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,wDAAwD;gBACjE,QAAQ,EAAE,+DAA+D;gBACzE,OAAO,EAAE,MAAM;aAChB,CAAA;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,OAAe,EAAE,QAA8C;QAC5E,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,OAAO,WAAW,CAAC,CAAA;QACrE,CAAC;aAAM,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,OAAO,WAAW,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAe;QACpC,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,IAAU;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAEzE,IAAI,aAAa,GAAG,EAAE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,YAAY,CAAA;QACtE,IAAI,gBAAgB,GAAG,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,YAAY,CAAA;QACrF,IAAI,aAAa,GAAG,CAAC,IAAI,gBAAgB,GAAG,EAAE;YAAE,OAAO,UAAU,CAAA;QACjE,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF"}

package/dist/lib/flow-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-engine.d.ts","sourceRoot":"","sources":["../../src/lib/flow-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAA2B,aAAa,EAAY,MAAM,mBAAmB,CAAA;AAGzG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,YAAY,CAA2E;IAC/F,OAAO,CAAC,aAAa,CAA4B;gBAErC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM;IAKtD,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAIrC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAuB9B,IAAI,IAAI,IAAI;IAeZ,QAAQ,IAAI,cAAc,EAAE;IAI5B,aAAa,IAAI,aAAa,EAAE;IAIhC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI;IA2B5D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsD3F,OAAO,CAAC,iBAAiB;IAyCzB,OAAO,CAAC,iBAAiB;YAQX,gBAAgB;IAkD9B,OAAO,CAAC,SAAS;YAkEH,WAAW;YA6GX,aAAa;IAqL3B,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,YAAY;IA+BpB,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrF,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IA0BzB,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAOhF"}
+{"version":3,"file":"flow-engine.d.ts","sourceRoot":"","sources":["../../src/lib/flow-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAA2B,aAAa,EAAY,MAAM,mBAAmB,CAAA;AAGzG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,YAAY,CAA2E;IAC/F,OAAO,CAAC,aAAa,CAA4B;gBAErC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM;IAKtD,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAIrC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAuB9B,IAAI,IAAI,IAAI;IAeZ,QAAQ,IAAI,cAAc,EAAE;IAI5B,aAAa,IAAI,aAAa,EAAE;IAIhC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI;IA2B5D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsD3F,OAAO,CAAC,iBAAiB;IAyCzB,OAAO,CAAC,iBAAiB;YAQX,gBAAgB;IAkD9B,OAAO,CAAC,SAAS;YA8EH,WAAW;YA6GX,aAAa;IAmM3B,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,YAAY;IA+BpB,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrF,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,iBAAiB;IA0BzB,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAOhF"}