bilmem 0.1.0 → 0.2.0

package/dist/{types-Nxq5Gzay.d.ts → types-DNlvHsj9.d.ts}

@@ -3,7 +3,7 @@
  * A lightweight, language-independent knowledge and learning runtime for AI agents.
  */
 type Scope = 'global' | 'user' | 'organization' | 'project' | string;
-type KnowledgeType = 'lesson' | 'fact' | 'decision' | 'convention' | 'rule' | 'architecture' | 'question' | 'failure' | 'heuristic';
+type KnowledgeType = 'lesson' | 'fact' | 'decision' | 'convention' | 'rule' | 'architecture' | 'question' | 'failure' | 'heuristic' | 'unknown';
 type KnowledgeStatus = 'active' | 'candidate' | 'probation' | 'needs_revalidation' | 'stale' | 'contradicted' | 'superseded' | 'invalid' | 'invalidated';
 type KnowledgeStage = 'candidate' | 'probation' | 'active';
 type ConfidenceTier = 'low' | 'medium' | 'high';
@@ -116,6 +116,11 @@ interface Knowledge {
     outcomesSummary?: KnowledgeOutcomesSummary;
     history?: KnowledgeHistoryEntry[];
     value?: number;
+    lesson?: string;
+    failure_details?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    contradicts?: string[];
+    blocking?: boolean;
     createdAt: string;
     updatedAt: string;
 }
@@ -124,7 +129,7 @@ interface Knowledge {
  */
 type ResolutionState = 'KNOWN' | 'PARTIALLY_KNOWN' | 'UNKNOWN' | 'CONFLICTED' | 'STALE';
 type ResolutionReason = 'NOT_OBSERVED' | 'INSUFFICIENT_EVIDENCE' | 'CONFLICTING_EVIDENCE' | 'STALE_EVIDENCE' | 'UNRESOLVABLE_LOCALLY' | 'CONTEXT_MISMATCH';
-type ActionType = 'USE_KNOWLEDGE' | 'INSPECT_FILE' | 'INSPECT_SYMBOL' | 'INSPECT_TEST' | 'SEARCH_REPOSITORY' | 'CHECK_GIT' | 'CHECK_DOCUMENTATION' | 'ASK_USER' | 'STOP';
+type ActionType = 'USE_KNOWLEDGE' | 'REVALIDATE' | 'INSPECT_FILE' | 'INSPECT_SYMBOL' | 'INSPECT_TEST' | 'SEARCH_REPOSITORY' | 'CHECK_GIT' | 'CHECK_DOCUMENTATION' | 'ASK_USER' | 'STOP';
 interface NextEvidenceAction {
     type: ActionType;
     target?: string;
@@ -182,6 +187,114 @@ interface ResolutionResult {
     };
     receiptId?: string;
 }
+/**
+ * Preflight readiness classification:
+ * Answers "What must I know before I start this work?"
+ */
+type ReadinessStatus = 'READY' | 'NEEDS_CLARIFICATION' | 'NEEDS_REVALIDATION' | 'CONFLICTED' | 'INSUFFICIENT_KNOWLEDGE';
+type UnknownClassification = 'BLOCKING' | 'IMPORTANT' | 'NON_BLOCKING';
+interface PreflightUnknown {
+    id: string;
+    statement?: string;
+    question?: string;
+    classification: UnknownClassification;
+    blocking: boolean;
+    reason?: string;
+}
+interface PreflightConstraint {
+    id: string;
+    statement: string;
+    type?: KnowledgeType;
+    confidence?: number;
+    confidenceTier?: ConfidenceTier;
+    source?: string;
+}
+interface PreflightLesson {
+    id: string;
+    statement: string;
+    confidence?: number;
+    domain?: string;
+    evidence?: string[];
+}
+interface PreflightFailure {
+    id: string;
+    statement: string;
+    context?: {
+        positive?: string[];
+        negative?: string[];
+    };
+    failure?: string;
+    lesson?: string;
+    evidence?: string[];
+}
+interface PreflightStale {
+    id: string;
+    statement: string;
+    reason: string;
+    changedSources?: string[];
+}
+interface PreflightMissing {
+    type: 'evidence' | 'decision';
+    subject: string;
+    question?: string;
+    reason: string;
+}
+interface PreflightQuestion {
+    question: string;
+    reason: string;
+    targetTopic?: string;
+    expectedResolutionValue?: number;
+    interactionCost?: number;
+    priorityScore?: number;
+}
+interface PreflightKnowledgeImpact {
+    relevantKnowledge: number;
+    validated: number;
+    needsRevalidation: number;
+    conflicted: number;
+    blockingUnknowns: number;
+    relevantFailures: number;
+}
+interface PreflightAlreadyInvestigated {
+    source: string;
+    result: string;
+    nextSuggestion?: string;
+}
+interface PreflightOptions {
+    goal: string;
+    positive?: string[];
+    negative?: string[];
+    scope?: Scope;
+    deep?: boolean;
+    maxCandidates?: number;
+}
+interface PreflightResult {
+    goal: string;
+    readiness: ReadinessStatus;
+    known: Array<{
+        id: string;
+        statement: string;
+        confidence: number | string;
+        confidenceTier?: ConfidenceTier;
+        stage?: KnowledgeStage;
+    }>;
+    constraints: PreflightConstraint[];
+    lessons: PreflightLesson[];
+    past_failures: PreflightFailure[];
+    unknowns: PreflightUnknown[];
+    stale: PreflightStale[];
+    missing: PreflightMissing[];
+    questions: PreflightQuestion[];
+    likely_domains: string[];
+    similar_work?: Array<{
+        topic: string;
+        lesson?: string;
+        failure?: string;
+    }>;
+    already_investigated?: PreflightAlreadyInvestigated[];
+    knowledge_impact: PreflightKnowledgeImpact;
+    next: NextEvidenceAction[];
+}
 /**
  * First-class Unknown representation.
  */
@@ -197,6 +310,10 @@ interface UnknownRecord {
     state: UnknownState;
     reason?: UnknownReason;
     statement?: string;
+    question?: string;
+    blocking?: boolean;
+    positive?: string[];
+    negative?: string[];
     checked: string[];
     next?: UnknownNextAction;
     scope: Scope;
@@ -387,4 +504,4 @@ interface RevisionSnapshot {
     changesSummary?: string;
 }
 
-export type { ActionType as A, BilmemConfig as B, ConfidenceTier as C, TrajectoryEvent as D, EvaluatedRule as E, TrajectoryEventType as F, UnknownNextAction as G, UnknownReason as H, InvestigationReceipt as I, JevResult as J, Knowledge as K, UnknownState as L, NextEvidenceAction as N, OutcomeType as O, Provenance as P, ResolveOptions as R, Scope as S, TaskTrajectory as T, UnknownRecord as U, ResolutionResult as a, BilmemMetrics as b, Evidence as c, EvidenceRelation as d, JevExplanation as e, JevMatchStatus as f, KnowledgeBudgetConfig as g, KnowledgeDiff as h, KnowledgeHistoryEntry as i, KnowledgeMetrics as j, KnowledgeOutcomesSummary as k, KnowledgeStage as l, KnowledgeStatus as m, KnowledgeType as n, Observation as o, OutcomeRecord as p, ReconciliationAction as q, ReconciliationResult as r, RelationType as s, ResolutionReason as t, ResolutionState as u, RevisionSnapshot as v, RuleCondition as w, RuleDefinition as x, RuleSet as y, TemporalMetadata as z };
+export type { TrajectoryEventType as $, ActionType as A, BilmemConfig as B, ConfidenceTier as C, PreflightUnknown as D, EvaluatedRule as E, ReadinessStatus as F, ReconciliationAction as G, ReconciliationResult as H, InvestigationReceipt as I, JevResult as J, Knowledge as K, RelationType as L, ResolutionReason as M, NextEvidenceAction as N, OutcomeType as O, Provenance as P, ResolutionState as Q, ResolveOptions as R, Scope as S, TaskTrajectory as T, UnknownRecord as U, RevisionSnapshot as V, RuleCondition as W, RuleDefinition as X, RuleSet as Y, TemporalMetadata as Z, TrajectoryEvent as _, ResolutionResult as a, UnknownClassification as a0, UnknownNextAction as a1, UnknownReason as a2, UnknownState as a3, PreflightOptions as b, PreflightResult as c, BilmemMetrics as d, Evidence as e, EvidenceRelation as f, JevExplanation as g, JevMatchStatus as h, KnowledgeBudgetConfig as i, KnowledgeDiff as j, KnowledgeHistoryEntry as k, KnowledgeMetrics as l, KnowledgeOutcomesSummary as m, KnowledgeStage as n, KnowledgeStatus as o, KnowledgeType as p, Observation as q, OutcomeRecord as r, PreflightAlreadyInvestigated as s, PreflightConstraint as t, PreflightFailure as u, PreflightKnowledgeImpact as v, PreflightLesson as w, PreflightMissing as x, PreflightQuestion as y, PreflightStale as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bilmem",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Lightweight, language-independent knowledge and learning runtime for AI agents and developer tooling",
   "type": "module",
   "main": "./dist/index.js",