@tyroneross/build-loop 0.30.3

package/dist/src/types.d.ts

@@ -0,0 +1,495 @@
+/**
+ * Debugging Memory System - Type Definitions
+ *
+ * Defines the structure of incidents, patterns, and memory operations.
+ */
+/**
+ * Memory Configuration
+ */
+export interface MemoryConfig {
+    storageMode: 'local' | 'shared';
+    memoryPath: string;
+    autoMine: boolean;
+    defaultSimilarityThreshold: number;
+    defaultMaxResults: number;
+}
+export interface Incident {
+    incident_id: string;
+    timestamp: number;
+    session_id?: string;
+    symptom: string;
+    symptom_type?: string;
+    root_cause: RootCause;
+    fix: Fix;
+    verification: Verification;
+    tags: string[];
+    files_changed: string[];
+    agent_used?: string;
+    quality_gates: QualityGates;
+    completeness: Completeness;
+    similarity_score?: number;
+    pattern_id?: string;
+    quality_score?: number;
+    embedding?: number[];
+    patternized?: boolean;
+    durability?: DurabilityTracking;
+}
+export interface RootCause {
+    description: string;
+    file?: string;
+    line_range?: [number, number];
+    code_snippet?: string;
+    category: string;
+    confidence: number;
+}
+export interface Fix {
+    approach: string;
+    changes: FileChange[];
+    pattern_used?: string;
+    time_to_fix?: number;
+}
+export interface FileChange {
+    file: string;
+    lines_changed: number;
+    change_type: 'add' | 'modify' | 'delete' | 'refactor';
+    summary: string;
+}
+export interface Verification {
+    status: 'verified' | 'partial' | 'unverified';
+    regression_tests_passed: boolean;
+    user_journey_tested: boolean;
+    tests_run?: string[];
+    success_criteria_met: boolean;
+}
+export interface QualityGates {
+    guardian_validated: boolean;
+    tested_e2e: boolean;
+    tested_from_ui: boolean;
+    security_reviewed: boolean;
+    architect_reviewed: boolean;
+}
+export interface Completeness {
+    symptom: boolean;
+    root_cause: boolean;
+    fix: boolean;
+    verification: boolean;
+    quality_score: number;
+}
+export interface DurabilityTracking {
+    fixed_at: number;
+    last_checked: number;
+    still_working: boolean;
+    days_stable: number;
+    recurrence_count: number;
+}
+/**
+ * Fix Pattern - Reusable solution template
+ */
+export interface Pattern {
+    pattern_id: string;
+    name: string;
+    description: string;
+    detection_signature: string[];
+    applicable_to: string[];
+    solution_template: string;
+    code_example?: string;
+    before_after?: BeforeAfter;
+    tags: string[];
+    related_patterns: string[];
+    usage_history: UsageHistory;
+    success_rate: number;
+    last_used: number;
+    caveats?: string[];
+    requires_validation?: string[];
+}
+export interface BeforeAfter {
+    before: string;
+    after: string;
+    explanation: string;
+}
+export interface UsageHistory {
+    total_uses: number;
+    successful_uses: number;
+    by_agent: Record<string, number>;
+    recent_incidents: string[];
+}
+/**
+ * Memory Retrieval Configuration
+ */
+export interface RetrievalConfig {
+    similarity_threshold: number;
+    max_results: number;
+    temporal_preference?: number;
+    tags_filter?: string[];
+    agent_filter?: string;
+    include_unvalidated?: boolean;
+}
+/**
+ * Memory Retrieval Result
+ */
+export interface RetrievalResult {
+    incidents: Incident[];
+    patterns: Pattern[];
+    confidence: number;
+    retrieval_method: 'pattern' | 'incident' | 'hybrid';
+    tokens_used: number;
+}
+/**
+ * Session State (temporary during debugging)
+ */
+export interface DebugSession {
+    session_id: string;
+    started_at: number;
+    symptom: string;
+    retrieved_context: RetrievalResult;
+    current_hypothesis?: string;
+    status: 'active' | 'completed' | 'abandoned';
+}
+/**
+ * Storage Options
+ */
+export interface StorageOptions {
+    validate_schema?: boolean;
+    extract_pattern?: boolean;
+    calculate_similarity?: boolean;
+    mark_for_review?: boolean;
+}
+/**
+ * Verification Result
+ */
+export interface VerificationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Compact Incident - Token-efficient representation (~200 tokens vs ~550)
+ *
+ * Uses short keys to minimize token usage in LLM context.
+ * Full incident can be loaded on-demand via incident_id.
+ */
+export interface CompactIncident {
+    id: string;
+    ts: number;
+    sym: string;
+    rc: {
+        d: string;
+        cat: string;
+        conf: number;
+    };
+    fix: {
+        a: string;
+        n: number;
+    };
+    v: 'V' | 'P' | 'U';
+    t: string[];
+    q: number;
+    sim?: number;
+}
+/**
+ * Compact Pattern - Token-efficient representation (~120 tokens vs ~250)
+ */
+export interface CompactPattern {
+    id: string;
+    n: number;
+    desc: string;
+    sig: string[];
+    fix: string;
+    sr: number;
+    cat: string;
+    t: string[];
+    last: number;
+    sim?: number;
+}
+/**
+ * Incident Summary - Minimal representation for quick scans (~100 tokens)
+ */
+export interface IncidentSummary {
+    incident_id: string;
+    symptom_preview: string;
+    root_cause_preview: string;
+    fix_preview: string;
+    category: string;
+    confidence: number;
+    quality: number;
+}
+/**
+ * Token Budget Configuration
+ *
+ * Controls how many tokens are allocated to different context sections.
+ * Total default: 2500 tokens (leaving room for user prompt and response)
+ */
+export interface TokenBudget {
+    total: number;
+    allocated: {
+        patterns: number;
+        incidents: number;
+        metadata: number;
+    };
+    perItem: {
+        pattern: number;
+        incident: number;
+        summary: number;
+    };
+}
+/**
+ * Default token budget configuration
+ */
+export declare const DEFAULT_TOKEN_BUDGET: TokenBudget;
+/**
+ * Field importance for selective serialization
+ */
+export type FieldImportance = 'critical' | 'secondary' | 'tertiary';
+/**
+ * Field configuration for selective inclusion
+ */
+export interface FieldConfig {
+    field: string;
+    importance: FieldImportance;
+    maxLength?: number;
+}
+/**
+ * Tiered Retrieval Configuration
+ */
+export interface TieredRetrievalConfig extends RetrievalConfig {
+    tier: 'summary' | 'compact' | 'full';
+    token_budget?: number;
+}
+/**
+ * Tiered Retrieval Result
+ */
+export interface TieredRetrievalResult {
+    summaries?: IncidentSummary[];
+    pattern_summaries?: {
+        id: string;
+        name: string;
+        success_rate: number;
+    }[];
+    incidents?: CompactIncident[];
+    patterns?: CompactPattern[];
+    confidence: number;
+    tokens_used: number;
+    has_more_details?: boolean;
+    truncated?: {
+        incidents: number;
+        patterns: number;
+    };
+}
+/**
+ * Assessment domains for parallel diagnosis
+ */
+export type AssessmentDomain = 'database' | 'frontend' | 'api' | 'performance';
+/**
+ * Domain Assessment Result
+ */
+export interface DomainAssessment {
+    domain: string;
+    symptom_classification: string;
+    confidence: number;
+    probable_causes: string[];
+    recommended_actions: string[];
+    related_incidents: string[];
+    search_tags: string[];
+    execution_time_ms?: number;
+}
+/**
+ * Assessment summary for orchestration result
+ */
+export interface AssessmentSummary {
+    domain: string;
+    confidence: number;
+    summary: string;
+}
+/**
+ * Orchestration Result from parallel assessments
+ */
+export interface OrchestrationResult {
+    symptom: string;
+    domains_assessed: string[];
+    assessments: AssessmentSummary[];
+    priority_ranking: PriorityRank[];
+    recommended_sequence: string[];
+    total_execution_time_ms?: number;
+    parallel_efficiency?: number;
+}
+/**
+ * Priority ranking entry
+ */
+export interface PriorityRank {
+    rank: number;
+    domain: string;
+    action: string;
+    confidence?: number;
+}
+/**
+ * Parallel search result
+ */
+export interface ParallelSearchResult {
+    incident: Incident;
+    score: number;
+    matchType: 'exact' | 'tag' | 'fuzzy' | 'category' | 'semantic';
+    highlights: string[];
+}
+/**
+ * Parallel retrieval result
+ */
+export interface ParallelRetrievalResult {
+    results: ParallelSearchResult[];
+    strategies_used: string[];
+    execution_time_ms: number;
+    parallel_speedup: number;
+}
+/**
+ * Scored item from result aggregation
+ */
+export interface ScoredItem {
+    type: 'assessment' | 'incident' | 'pattern';
+    id: string;
+    score: number;
+    domain?: string;
+    summary: string;
+    actions: string[];
+    tags: string[];
+    rawData: DomainAssessment | CompactIncident | CompactPattern;
+}
+/**
+ * Aggregated result from multiple sources
+ */
+export interface AggregatedResult {
+    items: ScoredItem[];
+    total_count: number;
+    domains_involved: string[];
+    aggregate_confidence: number;
+    recommended_actions: string[];
+    search_tags: string[];
+}
+/**
+ * Ranked results after aggregation
+ */
+export interface RankedResults {
+    top_recommendations: AggregatedResult[];
+    by_domain: Record<string, AggregatedResult[]>;
+    by_confidence: AggregatedResult[];
+    summary: ResultsSummary;
+}
+/**
+ * Results summary statistics
+ */
+export interface ResultsSummary {
+    total_results: number;
+    domains_covered: string[];
+    highest_confidence: number;
+    has_verified_fix: boolean;
+}
+/**
+ * Verdict for search results - actionable classification
+ */
+export type SearchVerdict = 'KNOWN_FIX' | 'LIKELY_MATCH' | 'WEAK_SIGNAL' | 'NO_MATCH';
+/**
+ * Verdict-wrapped search result
+ */
+export interface VerdictResult {
+    verdict: SearchVerdict;
+    summary: string;
+    confidence: number;
+    incidents: CompactIncident[];
+    patterns: CompactPattern[];
+    tokens_used: number;
+    action: string;
+}
+/**
+ * Memory index for O(1) lookups without loading all files
+ */
+export interface MemoryIndex {
+    version: number;
+    last_updated: number;
+    stats: {
+        total_incidents: number;
+        total_patterns: number;
+        categories: Record<string, number>;
+        tags: Record<string, number>;
+        quality_distribution: {
+            excellent: number;
+            good: number;
+            fair: number;
+        };
+        oldest_timestamp: number;
+        newest_timestamp: number;
+    };
+    by_category: Record<string, string[]>;
+    by_tag: Record<string, string[]>;
+    by_file: Record<string, string[]>;
+    by_quality: {
+        excellent: string[];
+        good: string[];
+        fair: string[];
+    };
+    recent: string[];
+}
+/**
+ * Incident JSONL entry for append-only log
+ */
+export interface IncidentLogEntry {
+    incident_id: string;
+    timestamp: number;
+    symptom: string;
+    category: string;
+    tags: string[];
+    quality_score: number;
+    verification_status: string;
+    files_changed: string[];
+}
+/**
+ * Archive metadata for evicted incidents
+ */
+export interface ArchiveManifest {
+    archived_at: number;
+    incident_count: number;
+    oldest_timestamp: number;
+    newest_timestamp: number;
+    reason: string;
+}
+/**
+ * A single match in progressive retrieval — one-liner with drill-down reference
+ */
+export interface ProgressiveMatch {
+    id: string;
+    type: 'incident' | 'pattern';
+    one_liner: string;
+    verdict: SearchVerdict;
+    confidence: number;
+    detail_command: string;
+}
+/**
+ * Progressive retrieval result — compact matches with drill-down
+ */
+export interface ProgressiveResult {
+    verdict: SearchVerdict;
+    summary: string;
+    matches: ProgressiveMatch[];
+    total_matches: number;
+    tokens_used: number;
+    action: string;
+}
+/**
+ * Inverted keyword index for O(1) candidate lookup
+ */
+export interface KeywordIndex {
+    version: number;
+    last_updated: number;
+    keywords: Record<string, string[]>;
+    total_incidents: number;
+    total_keywords: number;
+}
+/**
+ * Records whether a verdict/fix suggestion actually resolved the issue
+ */
+export interface VerdictOutcome {
+    incident_id: string;
+    session_id?: string;
+    verdict_given: SearchVerdict;
+    outcome: 'worked' | 'failed' | 'modified';
+    recorded_at: number;
+    notes?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,0BAA0B,EAAE,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IAEvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,SAAS,CAAC;IAGtB,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,YAAY,CAAC;IAG3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,aAAa,EAAE,YAAY,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAG3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;IAC9C,uBAAuB,EAAE,OAAO,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IAEtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAGpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;IAGxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,WAAW,CAAC;IAG3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAG3B,aAAa,EAAE,YAAY,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,eAAe,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE;QACF,CAAC,EAAE,MAAM,CAAC;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,GAAG,EAAE;QACH,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAYlC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAEpC,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAGzE,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAG5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAC/D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,cAAc,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC9C,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,aAAa,GAAG,UAAU,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,oBAAoB,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACxE,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/types.js

@@ -0,0 +1,27 @@
+"use strict";
+// SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Debugging Memory System - Type Definitions
+ *
+ * Defines the structure of incidents, patterns, and memory operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOKEN_BUDGET = void 0;
+/**
+ * Default token budget configuration
+ */
+exports.DEFAULT_TOKEN_BUDGET = {
+    total: 2500,
+    allocated: {
+        patterns: 750,
+        incidents: 1500,
+        metadata: 250,
+    },
+    perItem: {
+        pattern: 120,
+        incident: 200,
+        summary: 100,
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,mGAAmG;AACnG,sCAAsC;AACtC;;;;GAIG;;;AAwRH;;GAEG;AACU,QAAA,oBAAoB,GAAgB;IAC/C,KAAK,EAAE,IAAI;IACX,SAAS,EAAE;QACT,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,GAAG;KACd;IACD,OAAO,EAAE;QACP,OAAO,EAAE,GAAG;QACZ,QAAQ,EAAE,GAAG;QACb,OAAO,EAAE,GAAG;KACb;CACF,CAAC"}

package/docs/agent-surface-policy.md

@@ -0,0 +1,45 @@
+# Agent Surface Policy
+
+Build Loop exposes a small public entrypoint set and keeps implementation
+helpers internal.
+
+## Public Entry Points
+
+These are the only skills that should appear as user-facing Build Loop choices:
+
+- `build-loop` — main multi-step code workflow
+- `debug-loop` — root-cause debugging workflow
+- `optimize` — metric-driven optimization
+- `research` — repo-grounded pre-build research
+- `knowledge` — durable decisions and lessons
+- `handoff` — compose a durable handoff from build-loop run state (BL-4)
+
+## Host Rules
+
+Codex and ChatGPT use `.codex-plugin/plugin.json`, which points at
+`./codex-skills`. That directory contains wrapper skills for the public
+entrypoints only. The full `./skills` tree still ships in the package for
+internal references.
+
+Claude Code keeps `.claude-plugin/plugin.json` pointed at `./skills` because
+commands and orchestrator agents load internal skills by qualified name. Helper
+skills must set `user-invocable: false`; the public entrypoints set
+`user-invocable: true`.
+
+Cursor and other AGENTS.md-style tools should treat `AGENTS.md` plus this file
+as the routing contract. Start from the public entrypoints above. Read helper
+files under `skills/` only when the active entrypoint, a command, or an
+orchestrator instruction explicitly references them.
+
+## Cache Hygiene
+
+Plugin cache pruning is explicit and auditable:
+
+```bash
+python3 scripts/prune_plugin_cache.py --source . --apply
+```
+
+The command keeps the current host manifest version and deletes older verified
+cache directories for the same plugin. It checks both `.codex-plugin/plugin.json`
+and `.claude-plugin/plugin.json` by default. Use `--host codex` or
+`--host claude` for a single host.