@10et/cli 1.0.0

package/dist/types/world-model.d.ts

@@ -0,0 +1,478 @@
+/**
+ * World Model Type Definitions
+ *
+ * Core interfaces for the Agent World Model dynamics learning module.
+ * Captures system state, agent actions, predicted outcomes, state transitions,
+ * invariant violations, and counterfactual scenarios.
+ *
+ * Compatible with existing EvalEntry, RLState, and RLAction types.
+ *
+ * @purpose Type definitions for world model dynamics learning — state, actions, outcomes, transitions
+ * @spec world-model-roadmap.md
+ */
+import type { RLState, RLAction } from "../lib/training-buffer.js";
+import type { EvalEntry } from "./eval.js";
+/**
+ * Current schema version for world model types.
+ * Increment when making breaking changes to enable JSONL migrations.
+ */
+export declare const WORLD_MODEL_SCHEMA_VERSION = 1;
+/**
+ * Embedding metadata structure for similarity computation.
+ * Includes model provenance to prevent breakage when embedding model changes.
+ */
+export interface EmbeddingMetadata {
+    /** The embedding vector */
+    vector: number[];
+    /** Embedding dimension */
+    dim: number;
+    /** Model ID that generated this embedding (e.g., "stratus-x1ac-base-claude-sonnet-4-5") */
+    modelId: string;
+    /** Model version string (e.g., "2026-03-18") */
+    modelVersion: string;
+}
+/**
+ * Environment version for tracking codebase state.
+ * Prevents mis-attributing regressions to agent actions when codebase changed.
+ */
+export interface EnvironmentVersion {
+    /** Git SHA of HEAD commit */
+    gitSha: string;
+    /** Current branch name */
+    branch: string;
+}
+/**
+ * WorldState captures a complete snapshot of the system at a point in time.
+ * Used as the "prior state" and "posterior state" in state transitions.
+ */
+export interface WorldState {
+    /**
+     * Schema version for migration support
+     */
+    schemaVersion?: number;
+    /**
+     * Timestamp when this state was captured (Unix ms)
+     */
+    timestamp: number;
+    /**
+     * The agent ID whose perspective this state represents.
+     * Different agents may see slightly different views due to scope restrictions.
+     */
+    agentId: string;
+    /**
+     * Environment version tracking codebase state
+     */
+    environmentVersion?: EnvironmentVersion;
+    /**
+     * Core system state: agents, worktrees, hub, builds, locks, pending work
+     */
+    systemState: {
+        /**
+         * List of currently active agent IDs
+         */
+        activeAgents: string[];
+        /**
+         * Map of agent ID to allocated worktree path (or "none" if not allocated)
+         */
+        worktreeAllocation: Record<string, string>;
+        /**
+         * Number of active hub WebSocket connections
+         */
+        hubConnections: number;
+        /**
+         * Build status per target repo
+         */
+        buildStatus: Record<string, "idle" | "building" | "failed" | "success">;
+        /**
+         * Currently locked file paths (exclusive access)
+         */
+        fileLocks: string[];
+        /**
+         * Number of eval runs pending completion
+         */
+        pendingEvals: number;
+    };
+    /**
+     * Context state: repo activity, PRs, tests, human presence
+     */
+    contextState: {
+        /**
+         * Number of commits in the last 24 hours
+         */
+        recentCommits: number;
+        /**
+         * Number of open pull requests
+         */
+        openPRs: number;
+        /**
+         * Number of currently failing tests
+         */
+        failingTests: number;
+        /**
+         * Lines of code changed in last 24 hours (churn metric)
+         */
+        codeChurn: number;
+        /**
+         * Whether a human is currently active in the IDE
+         */
+        humanActivity: boolean;
+    };
+    /**
+     * Agent-specific state: scores, trends, history
+     */
+    agentState: {
+        /**
+         * Most recent eval composite score for this agent
+         */
+        lastEvalScore: number;
+        /**
+         * Exponential moving average of rewards
+         */
+        rewardEMA: number;
+        /**
+         * Recent action types taken by this agent (last 10)
+         */
+        actionHistory: string[];
+        /**
+         * Number of consecutive rounds without positive reward
+         */
+        consecutiveFailures: number;
+    };
+    /**
+     * Optional embedding for state similarity computation.
+     * Generated lazily when needed for distance calculations.
+     * Includes model provenance to handle embedding model changes.
+     */
+    stateEmbedding?: EmbeddingMetadata;
+}
+/**
+ * Enumeration of valid agent action types.
+ * Matches states from PeterParker.tla with additional orchestration actions.
+ */
+export type AgentActionType = "eval" | "autoresearch" | "commit" | "skip" | "research" | "scheduled" | "fix" | "refactor" | "feature" | "test" | "config" | "experiment";
+/**
+ * AgentAction represents an action taken by an agent in the system.
+ */
+export interface AgentAction {
+    /**
+     * Schema version for migration support
+     */
+    schemaVersion?: number;
+    /**
+     * ID of the agent taking this action
+     */
+    agentId: string;
+    /**
+     * Type of action being performed
+     */
+    actionType: AgentActionType;
+    /**
+     * Action-specific payload (varies by type)
+     */
+    actionPayload: Record<string, unknown>;
+    /**
+     * Model's confidence in this action (0-1)
+     */
+    confidence?: number;
+    /**
+     * Stratus-specific metadata when action was selected via reasoning
+     */
+    stratusMetadata?: {
+        /**
+         * Stratus model used for selection
+         */
+        model: string;
+        /**
+         * Time spent in planning phase (ms)
+         */
+        planningTimeMs: number;
+        /**
+         * Brain signal from Stratus (reasoning trace summary)
+         */
+        brainSignal: string;
+    };
+}
+/**
+ * WorldOutcome captures the effects of an action at different time horizons.
+ */
+export interface WorldOutcome {
+    /**
+     * Schema version for migration support
+     */
+    schemaVersion?: number;
+    /**
+     * Timestamp when outcome was observed (Unix ms)
+     */
+    timestamp: number;
+    /**
+     * Immediate effects (observable within seconds of action completion)
+     */
+    immediate: {
+        /**
+         * Change in composite eval score (can be positive or negative)
+         */
+        evalScoreChange?: number;
+        /**
+         * Build status after action
+         */
+        buildStatus?: "success" | "failed";
+        /**
+         * Test results after action
+         */
+        testResults?: {
+            passed: number;
+            failed: number;
+        };
+        /**
+         * Whether a commit was created
+         */
+        commitCreated: boolean;
+    };
+    /**
+     * Medium-term effects (observable within hours)
+     */
+    mediumTerm?: {
+        /**
+         * Impact on downstream agent eval scores
+         */
+        downstreamEvalImpact: Record<string, number>;
+        /**
+         * Whether human intervention was required to fix issues
+         */
+        humanInterventionRequired: boolean;
+        /**
+         * System stability metric (0-1, higher is more stable)
+         */
+        systemStability: number;
+    };
+    /**
+     * Long-term effects (observable over days/weeks)
+     */
+    longTerm?: {
+        /**
+         * Changes to product-level metrics
+         */
+        productMetricDelta: Record<string, number>;
+        /**
+         * Technical debt change (-1 to 1, positive = more debt)
+         */
+        technicalDebt: number;
+    };
+}
+/**
+ * StateTransition records a complete (state, action, outcome) tuple.
+ * This is the fundamental unit of experience for dynamics learning.
+ */
+export interface StateTransition {
+    /**
+     * Schema version for migration support
+     */
+    schemaVersion?: number;
+    /**
+     * Unique transition ID (hash of prior state + action)
+     */
+    id: string;
+    /**
+     * System state before the action was taken
+     */
+    priorState: WorldState;
+    /**
+     * The action that was taken
+     */
+    action: AgentAction;
+    /**
+     * System state after the action completed
+     */
+    posteriorState: WorldState;
+    /**
+     * Observed outcome of the action
+     */
+    outcome: WorldOutcome;
+    /**
+     * IDs of related transitions (for causal tracing)
+     */
+    causalLinks: string[];
+    /**
+     * Any invariants violated during this transition
+     */
+    invariantViolations: InvariantViolation[];
+}
+/**
+ * Enumeration of invariant IDs from TLA+ specifications.
+ */
+export type InvariantId = "NoAgentStranding" | "HumanAgentIsolation" | "HubAvailability" | "WorktreeExclusivity" | "TrainingBufferBounded" | "ScopeIsolation" | "LockRequired" | "EvalBeforeCommit";
+/**
+ * Severity levels for invariant violations
+ */
+export type InvariantSeverity = "warning" | "error" | "critical";
+/**
+ * InvariantViolation records when a runtime invariant check fails.
+ */
+export interface InvariantViolation {
+    /**
+     * Which invariant was violated
+     */
+    invariantId: InvariantId;
+    /**
+     * How severe is this violation
+     */
+    severity: InvariantSeverity;
+    /**
+     * Human-readable description of what went wrong
+     */
+    description: string;
+    /**
+     * The portion of state that violates the invariant
+     */
+    violatingState: Partial<WorldState>;
+    /**
+     * Suggested recovery action
+     */
+    suggestedRecovery?: string;
+    /**
+     * Timestamp when violation was detected
+     */
+    detectedAt?: number;
+}
+/**
+ * CounterfactualScenario explores "what if" alternative actions.
+ */
+export interface CounterfactualScenario {
+    /**
+     * ID of the base transition being analyzed
+     */
+    baseTransitionId: string;
+    /**
+     * The alternative action that could have been taken
+     */
+    alternativeAction: AgentAction;
+    /**
+     * Predicted outcome if alternative had been taken
+     */
+    predictedOutcome: WorldOutcome;
+    /**
+     * Probability mass assigned to this scenario (0-1)
+     */
+    probabilityMass: number;
+    /**
+     * Stratus reasoning explaining the prediction
+     */
+    stratusReasoning: string;
+    /**
+     * Type of counterfactual
+     */
+    counterfactualType: "baseline" | "scheduling" | "action";
+    /**
+     * Timestamp when counterfactual was generated
+     */
+    generatedAt: number;
+}
+/**
+ * PredictionResult is returned by the dynamics model.
+ */
+export interface PredictionResult {
+    /**
+     * Predicted outcome
+     */
+    outcome: WorldOutcome;
+    /**
+     * Confidence in the prediction (0-1)
+     */
+    confidence: number;
+    /**
+     * Explanation of the prediction
+     */
+    reasoning: string;
+    /**
+     * Source of the prediction
+     */
+    source: "historical_aggregation" | "stratus_inference" | "fallback";
+    /**
+     * Number of similar transitions found (if any)
+     */
+    similarTransitionsUsed?: number;
+    /**
+     * Stratus execution metadata (if used)
+     */
+    stratusMetadata?: {
+        model: string;
+        executionTimeMs: number;
+        brainSignal?: string;
+    };
+}
+/**
+ * WorldModelStorageConfig for customizing storage behavior
+ */
+export interface WorldModelStorageConfig {
+    /**
+     * Root directory for world model data (default: <projectRoot>/world-model-data)
+     */
+    dataDir: string;
+    /**
+     * Maximum transitions per day file before rotation
+     */
+    maxTransitionsPerFile: number;
+    /**
+     * How long to keep cached predictions (ms)
+     */
+    predictionCacheTtl: number;
+    /**
+     * Maximum size of training buffer
+     */
+    maxBufferSize: number;
+}
+/**
+ * StateSnapshot for hourly state captures
+ */
+export interface StateSnapshot {
+    /**
+     * Snapshot ID
+     */
+    id: string;
+    /**
+     * Timestamp
+     */
+    timestamp: number;
+    /**
+     * The captured state
+     */
+    state: WorldState;
+    /**
+     * What triggered this snapshot
+     */
+    trigger: "hourly" | "event" | "manual";
+}
+/**
+ * CachedPrediction for dynamics cache
+ */
+export interface CachedPrediction {
+    /**
+     * Cache key (hash of state + action)
+     */
+    key: string;
+    /**
+     * The prediction
+     */
+    prediction: PredictionResult;
+    /**
+     * When this was cached
+     */
+    cachedAt: number;
+    /**
+     * Number of times this cache entry was hit
+     */
+    hitCount: number;
+}
+/**
+ * Convert WorldState to RLState for policy head compatibility
+ */
+export declare function worldStateToRLState(ws: WorldState): RLState;
+/**
+ * Convert AgentAction to RLAction for policy head compatibility
+ */
+export declare function agentActionToRLAction(aa: AgentAction): RLAction;
+/**
+ * Create an EvalEntry from a StateTransition for eval-store compatibility
+ */
+export declare function transitionToEvalEntry(transition: StateTransition, runId: string): EvalEntry;
+//# sourceMappingURL=world-model.d.ts.map

package/dist/types/world-model.d.ts.map

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

package/dist/types/world-model.js

@@ -0,0 +1,87 @@
+/**
+ * World Model Type Definitions
+ *
+ * Core interfaces for the Agent World Model dynamics learning module.
+ * Captures system state, agent actions, predicted outcomes, state transitions,
+ * invariant violations, and counterfactual scenarios.
+ *
+ * Compatible with existing EvalEntry, RLState, and RLAction types.
+ *
+ * @purpose Type definitions for world model dynamics learning — state, actions, outcomes, transitions
+ * @spec world-model-roadmap.md
+ */
+// ============================================================================
+// Schema Version
+// ============================================================================
+/**
+ * Current schema version for world model types.
+ * Increment when making breaking changes to enable JSONL migrations.
+ */
+export const WORLD_MODEL_SCHEMA_VERSION = 1;
+// ============================================================================
+// Compatibility Types
+// ============================================================================
+/**
+ * Convert WorldState to RLState for policy head compatibility
+ */
+export function worldStateToRLState(ws) {
+    // Map to dimension names the v2 PolicyHead was trained on
+    const buildStatuses = Object.values(ws.systemState.buildStatus);
+    const buildHealth = buildStatuses.length > 0
+        ? (buildStatuses.filter(s => s === "success").length / buildStatuses.length)
+        : 0.9;
+    const testsTotal = Math.max(1, ws.contextState.failingTests > 0 ? 20 : 25);
+    const testsPassing = Math.max(0, testsTotal - ws.contextState.failingTests);
+    return {
+        composite_score: ws.agentState.lastEvalScore,
+        dimension_scores: {
+            test_pass_rate: testsTotal > 0 ? testsPassing / testsTotal : 1.0,
+            build_health: buildHealth,
+            code_quality: Math.max(0.5, 1.0 - ws.contextState.codeChurn * 0.02),
+            hub_health: ws.systemState.hubConnections > 0 ? 0.9 : 0.3,
+        },
+        tests_passing: testsPassing,
+        tests_total: testsTotal,
+        trajectory_length: ws.agentState.actionHistory.length,
+        recent_deltas: ws.agentState.rewardEMA !== 0 ? [ws.agentState.rewardEMA] : [],
+        agent: ws.agentId,
+    };
+}
+/**
+ * Convert AgentAction to RLAction for policy head compatibility
+ */
+export function agentActionToRLAction(aa) {
+    const validTypes = ["fix", "refactor", "feature", "test", "config", "experiment"];
+    const actionType = validTypes.includes(aa.actionType)
+        ? aa.actionType
+        : "experiment";
+    return {
+        type: actionType,
+        description: JSON.stringify(aa.actionPayload),
+        files_affected: aa.actionPayload.files || [],
+        scope: "medium",
+        branch: aa.actionPayload.branch || "main",
+    };
+}
+/**
+ * Create an EvalEntry from a StateTransition for eval-store compatibility
+ */
+export function transitionToEvalEntry(transition, runId) {
+    return {
+        v: 1,
+        ts: new Date(transition.posteriorState.timestamp).toISOString(),
+        agent: transition.action.agentId,
+        run_id: runId,
+        metrics: {
+            evalScoreChange: transition.outcome.immediate.evalScoreChange ?? 0,
+            buildSuccess: transition.outcome.immediate.buildStatus === "success" ? 1 : 0,
+            testsPassed: transition.outcome.immediate.testResults?.passed ?? 0,
+            testsFailed: transition.outcome.immediate.testResults?.failed ?? 0,
+        },
+        composite: transition.posteriorState.agentState.lastEvalScore,
+        delta: {
+            score: transition.outcome.immediate.evalScoreChange ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=world-model.js.map

package/dist/types/world-model.js.map

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

package/dist/ui/banner.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JFL Banner & Taglines
+ * Beautiful ASCII art banner with rotating taglines (Clawdbot-style)
+ */
+export declare function getTagline(): string;
+export declare function getBannerArt(): string[];
+export interface BannerOptions {
+    version?: string;
+    tagline?: string;
+    showTagline?: boolean;
+    centered?: boolean;
+}
+export declare function renderBanner(options?: BannerOptions): string;
+export declare function showBanner(version?: string): void;
+export declare function showStatus(message: string): void;
+export declare function showSection(title: string): void;
+export declare function showHowItWorksNotice(): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/ui/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiNH,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAWvC;AAmCD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoDhE;AAMD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAEjD;AAGD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK/C;AAMD,wBAAgB,oBAAoB,IAAI,IAAI,CA2B3C"}