@winspan/claude-forge 8.41.0 → 8.50.6

package/dist/engine/dsl/types.d.ts

@@ -1,139 +0,0 @@
-/**
- * Convention DSL type definitions
- *
- * Core concepts:
- * - Convention: a collection of governance rules
- * - Rule: a single rule (forbidden / escalation)
- * - RuleContext: runtime context for rule evaluation
- * - GovernanceDecision: rule evaluation result
- */
-export type DecisionLevel = 'allow' | 'warn' | 'confirm' | 'block';
-export interface GovernanceDecision {
-    level: DecisionLevel;
-    rule_id?: string;
-    reason?: string;
-    suggestion?: string;
-}
-export interface RuleMetadata {
-    operator_guidance?: string;
-    doc_ref?: string;
-    tags?: string[];
-}
-export interface MatchedRule extends RuleMetadata {
-    id: string;
-    level: DecisionLevel;
-    reason: string;
-    suggestion?: string;
-    source_convention: string;
-}
-export interface RuleEvaluationResult {
-    decision: GovernanceDecision;
-    matches: MatchedRule[];
-}
-export interface Convention {
-    id: string;
-    name: string;
-    version: string;
-    description?: string;
-    triggers?: string[];
-    extends?: string[];
-    variables: Record<string, unknown>;
-    forbidden: Rule[];
-    escalation: EscalationRule[];
-    deliverables: Deliverable[];
-    overrides: RuleOverride[];
-    principles: string;
-}
-export interface Rule {
-    id: string;
-    when: string;
-    level: DecisionLevel;
-    message: string;
-    suggestion?: string;
-    operator_guidance?: string;
-    doc_ref?: string;
-    tags?: string[];
-    enabled?: boolean;
-}
-export interface EscalationRule {
-    id: string;
-    when: string;
-    action: DecisionLevel;
-    message: string;
-    suggestion?: string;
-    operator_guidance?: string;
-    doc_ref?: string;
-    tags?: string[];
-    enabled?: boolean;
-}
-export interface Deliverable {
-    name: string;
-    pattern?: string;
-    command?: string;
-    required: boolean;
-    check_at: 'session_end' | 'before_commit' | 'on_demand' | 'ci';
-    condition?: string;
-}
-export interface RuleOverride {
-    rule_id: string;
-    level?: DecisionLevel;
-    message?: string;
-    enabled?: boolean;
-}
-export interface ConventionBinding {
-    convention_id: string;
-    project_path: string;
-    enabled: boolean;
-    disabled_rules: string[];
-    overrides: RuleOverride[];
-    created_at: number;
-}
-export interface ToolEvent {
-    tool: string;
-    args: Record<string, unknown>;
-    result?: Record<string, unknown>;
-    success: boolean;
-    error?: string;
-    timestamp: number;
-}
-export interface RuleContext {
-    tool: string;
-    args: Record<string, unknown>;
-    file_path: string | null;
-    file_ext: string | null;
-    file_dir: string | null;
-    session: {
-        id: string;
-        phase: string;
-        duration_minutes: number;
-    };
-    git: {
-        branch: string;
-        has_uncommitted: boolean;
-    };
-    history: {
-        last(n: number): ToolEvent[];
-        consecutive_failures: number;
-        file_changes: string[];
-        tool_calls: number;
-    };
-    vars: Record<string, unknown>;
-}
-export type CompiledExpression = (ctx: RuleContext) => boolean;
-export interface CompiledRule {
-    id: string;
-    level: DecisionLevel;
-    message: string;
-    suggestion?: string;
-    operator_guidance?: string;
-    doc_ref?: string;
-    tags?: string[];
-    evaluate: CompiledExpression;
-    render: (ctx: RuleContext) => string;
-    source_convention: string;
-}
-export interface RuleIndex {
-    byTool: Map<string, CompiledRule[]>;
-    global: CompiledRule[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/engine/dsl/types.d.ts.map

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

package/dist/engine/dsl/types.js

@@ -1,11 +0,0 @@
-/**
- * Convention DSL type definitions
- *
- * Core concepts:
- * - Convention: a collection of governance rules
- * - Rule: a single rule (forbidden / escalation)
- * - RuleContext: runtime context for rule evaluation
- * - GovernanceDecision: rule evaluation result
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/engine/dsl/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/dsl/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/engine/evidence-store.d.ts

@@ -1,44 +0,0 @@
-/**
- * EvidenceStore — evidence storage
- *
- * Records tool calls and governance decisions, provides history queries.
- * In-memory implementation with optional persistence callback.
- */
-import type { ToolEvent, GovernanceDecision } from './dsl/types.js';
-export interface DecisionRecord {
-    decision: GovernanceDecision;
-    event: ToolEvent;
-    user_choice?: string;
-    timestamp: number;
-}
-export interface SessionStats {
-    tool_calls: number;
-    file_changes: string[];
-    consecutive_failures: number;
-    total_failures: number;
-    total_blocks: number;
-    total_warns: number;
-}
-/** Optional persistence interface — implement to persist evidence to DB */
-export interface EvidencePersistence {
-    insertEvent(sessionId: string, event: ToolEvent): Promise<string>;
-    insertDecision(sessionId: string, eventId: string, decision: GovernanceDecision, userChoice?: string): Promise<void>;
-    updateStats(sessionId: string, stats: SessionStats): Promise<void>;
-}
-export declare class EvidenceStore {
-    private events;
-    private decisions;
-    private stats;
-    private persistence?;
-    constructor(persistence?: EvidencePersistence);
-    recordEvent(sessionId: string, event: ToolEvent): void;
-    recordDecision(sessionId: string, decision: GovernanceDecision, event: ToolEvent, userChoice?: string): void;
-    getEvents(sessionId: string): ToolEvent[];
-    getLastEvents(sessionId: string, n: number): ToolEvent[];
-    getDecisions(sessionId: string): DecisionRecord[];
-    getStats(sessionId: string): SessionStats;
-    clearSession(sessionId: string): void;
-    private updateStats;
-    private getOrCreateStats;
-}
-//# sourceMappingURL=evidence-store.d.ts.map

package/dist/engine/evidence-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"evidence-store.d.ts","sourceRoot":"","sources":["../../src/engine/evidence-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,WAAW,CAAC,CAAsB;gBAE9B,WAAW,CAAC,EAAE,mBAAmB;IAI7C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAkBtD,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IA+BP,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE;IAIzC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAKxD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAIjD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAIzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMrC,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/engine/evidence-store.js

@@ -1,109 +0,0 @@
-/**
- * EvidenceStore — evidence storage
- *
- * Records tool calls and governance decisions, provides history queries.
- * In-memory implementation with optional persistence callback.
- */
-export class EvidenceStore {
-    events = new Map();
-    decisions = new Map();
-    stats = new Map();
-    persistence;
-    constructor(persistence) {
-        this.persistence = persistence;
-    }
-    recordEvent(sessionId, event) {
-        if (!this.events.has(sessionId)) {
-            this.events.set(sessionId, []);
-        }
-        this.events.get(sessionId).push(event);
-        this.updateStats(sessionId, event);
-        if (this.persistence) {
-            const stats = this.getOrCreateStats(sessionId);
-            Promise.all([
-                this.persistence.insertEvent(sessionId, event),
-                this.persistence.updateStats(sessionId, stats),
-            ]).catch(err => {
-                console.error('[EvidenceStore] Persist event failed:', err);
-            });
-        }
-    }
-    recordDecision(sessionId, decision, event, userChoice) {
-        if (decision.level === 'allow' && !decision.rule_id) {
-            return;
-        }
-        if (!this.decisions.has(sessionId)) {
-            this.decisions.set(sessionId, []);
-        }
-        this.decisions.get(sessionId).push({
-            decision,
-            event,
-            user_choice: userChoice,
-            timestamp: Date.now(),
-        });
-        const stats = this.getOrCreateStats(sessionId);
-        if (decision.level === 'block')
-            stats.total_blocks++;
-        if (decision.level === 'warn')
-            stats.total_warns++;
-        if (this.persistence) {
-            this.persistence.insertEvent(sessionId, event).then(eventId => {
-                return Promise.all([
-                    this.persistence.insertDecision(sessionId, eventId, decision, userChoice),
-                    this.persistence.updateStats(sessionId, stats),
-                ]);
-            }).catch(err => {
-                console.error('[EvidenceStore] Persist decision failed:', err);
-            });
-        }
-    }
-    getEvents(sessionId) {
-        return this.events.get(sessionId) ?? [];
-    }
-    getLastEvents(sessionId, n) {
-        const events = this.getEvents(sessionId);
-        return events.slice(-n);
-    }
-    getDecisions(sessionId) {
-        return this.decisions.get(sessionId) ?? [];
-    }
-    getStats(sessionId) {
-        return this.getOrCreateStats(sessionId);
-    }
-    clearSession(sessionId) {
-        this.events.delete(sessionId);
-        this.decisions.delete(sessionId);
-        this.stats.delete(sessionId);
-    }
-    updateStats(sessionId, event) {
-        const stats = this.getOrCreateStats(sessionId);
-        stats.tool_calls++;
-        if (!event.success) {
-            stats.consecutive_failures++;
-            stats.total_failures++;
-        }
-        else {
-            stats.consecutive_failures = 0;
-        }
-        if (event.tool === 'Write' || event.tool === 'Edit') {
-            const filePath = event.args.file_path;
-            if (filePath && !stats.file_changes.includes(filePath)) {
-                stats.file_changes.push(filePath);
-            }
-        }
-    }
-    getOrCreateStats(sessionId) {
-        if (!this.stats.has(sessionId)) {
-            this.stats.set(sessionId, {
-                tool_calls: 0,
-                file_changes: [],
-                consecutive_failures: 0,
-                total_failures: 0,
-                total_blocks: 0,
-                total_warns: 0,
-            });
-        }
-        return this.stats.get(sessionId);
-    }
-}
-//# sourceMappingURL=evidence-store.js.map

package/dist/engine/evidence-store.js.map

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

package/dist/engine/experiment-router.d.ts

@@ -1,102 +0,0 @@
-/**
- * ExperimentRouter — wraps AgentRouter with A/B-testing capability.
- *
- * Responsibilities:
- *   - Load ~/.claude-forge/routing-experiments.yaml
- *   - Assign incoming requests to one of N experiment groups via a sticky,
- *     session-scoped consistent hash
- *   - Delegate the actual routing decision to a per-group AgentRouter built
- *     from the group's inline rules
- *   - Fall back to a provided defaultRouter when the experiment is disabled,
- *     concluded, or misconfigured
- *
- * Stickiness is persisted in the `experiment_assignments` table so group
- * assignment stays stable across hot reloads and daemon restarts. The hash
- * input mixes experiment.id so switching to a new experiment reshuffles.
- */
-import { AgentRouter, type RouteDecision, type RouteInput, type RoutingRule, type IsRuleDisabled } from './agent-router.js';
-import type { SQLiteStorage } from '../core/storage/sqlite.js';
-export interface ExperimentGroup {
-    id: string;
-    name: string;
-    weight: number;
-    rules: RoutingRule[];
-}
-export interface ExperimentMeta {
-    id: string;
-    name: string;
-    startedAt: string;
-    endedAt: string | null;
-    groups: ExperimentGroup[];
-}
-export interface ExperimentConfig {
-    enabled: boolean;
-    experiment: ExperimentMeta | null;
-}
-export interface ExperimentDecision extends RouteDecision {
-    experimentId: string | null;
-    groupId: string | null;
-}
-interface ExperimentsYaml {
-    schemaVersion?: string;
-    enabled?: boolean;
-    experiment?: {
-        id?: string;
-        name?: string;
-        startedAt?: string;
-        endedAt?: string | null;
-        groups?: Array<{
-            id?: string;
-            name?: string;
-            weight?: number;
-            rules?: RoutingRule[];
-        }>;
-    };
-}
-export declare class ExperimentRouter {
-    private storage;
-    private defaultRouter;
-    private experimentsPath;
-    private config;
-    private groupRouters;
-    private watcher;
-    private isRuleDisabled;
-    constructor(opts: {
-        storage: SQLiteStorage;
-        defaultRouter: AgentRouter;
-        experimentsPath?: string;
-        isRuleDisabled?: IsRuleDisabled;
-    });
-    /**
-     * Make a routing decision. If the experiment is active, assigns the session
-     * to a group (sticky) and uses that group's rules. Otherwise delegates to
-     * the default router.
-     */
-    decide(input: RouteInput, sessionId: string): ExperimentDecision;
-    getConfigSnapshot(): ExperimentConfig;
-    enableHotReload(): void;
-    disableHotReload(): void;
-    /** Rebuild config and per-group routers from disk. Idempotent. */
-    private load;
-    private tryReadConfig;
-    private isExperimentActive;
-    private assignGroup;
-}
-/**
- * Deterministic bucket selection using murmur3_32 of `sessionId:experimentId`.
- * Mixing the experiment id ensures that starting a new experiment does not
- * leave a given session permanently stuck on the first bucket.
- */
-export declare function pickGroup(sessionId: string, exp: ExperimentMeta): string;
-/**
- * murmur3_32 — a small, self-contained hash. Public-domain reference impl.
- * We avoid adding a dependency for ~30 lines of code.
- */
-export declare function murmur3_32(str: string, seed?: number): number;
-/**
- * Validate raw YAML shape. Returns null on any structural error; logs details.
- * Exported so the Web API can reject invalid PUTs with the same rules.
- */
-export declare function validateConfig(raw: ExperimentsYaml | null | undefined): ExperimentConfig | null;
-export {};
-//# sourceMappingURL=experiment-router.d.ts.map

package/dist/engine/experiment-router.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"experiment-router.d.ts","sourceRoot":"","sources":["../../src/engine/experiment-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5H,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,UAAU,eAAe;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE;QACX,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,CAAC,EAAE,KAAK,CAAC;YACb,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;SACvB,CAAC,CAAC;KACJ,CAAC;CACH;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAA0D;IACxE,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,cAAc,CAA+B;gBAEzC,IAAI,EAAE;QAChB,OAAO,EAAE,aAAa,CAAC;QACvB,aAAa,EAAE,WAAW,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC;IAQD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB;IAahE,iBAAiB,IAAI,gBAAgB;IAYrC,eAAe,IAAI,IAAI;IAoBvB,gBAAgB,IAAI,IAAI;IAOxB,kEAAkE;IAClE,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,WAAW;CAapB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CASxE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CA0CxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAoE/F"}