@lucern/contracts 0.1.0-alpha.3 → 0.1.1-alpha.1

package/dist/context-pack.contract.d.ts

@@ -1,495 +0,0 @@
-/**
- * Context-Pack Contract v1
- *
- * Canonical TypeScript types and constants for the context-pack output schema.
- * This is the external contract consumed by:
- *   - MCP tool `compile_context` (canonical compiler read)
- *   - SDK/HTTP consumers that read compiled context packs programmatically
- *   - Benchmark harnesses (context-pack-ab)
- *
- * BREAKING CHANGE RULES:
- *   - Adding optional fields to ContextPackV1 is NON-breaking
- *   - Removing fields or changing types is BREAKING (bump CONTEXT_PACK_SCHEMA_VERSION)
- *   - Changing section budget ratios or ranking weights is NON-breaking (tuning)
- *   - Changing the version string is BREAKING (consumers check it)
- */
-/** Canonical version string. Consumers MUST check this field for compatibility. */
-export declare const CONTEXT_PACK_SCHEMA_VERSION: "1.0.0";
-/**
- * Available ranking profiles for context-pack assembly.
- *
- * - `baseline_v1`: Simple token-hit counting. Items with zero query hits are excluded.
- * - `weighted_v1`: Multi-signal scoring combining query relevance, recency, confidence,
- *    belief type, priority, and severity with section-specific weight vectors.
- */
-export type ContextRankingProfile = "baseline_v1" | "weighted_v1";
-export declare const CONTEXT_RANKING_PROFILES: readonly ContextRankingProfile[];
-export declare const DEFAULT_RANKING_PROFILE: ContextRankingProfile;
-/**
- * Context compilation mode.
- *
- * - `standard`: Default — ranked beliefs, questions, evidence, contradictions.
- * - `delta`: Diff-aware — adds failure context, verification obligations,
- *    and worktree ledger analysis to the standard context pack.
- */
-export type ContextCompilationMode = "standard" | "delta";
-export declare const DEFAULT_COMPILATION_MODE: ContextCompilationMode;
-/**
- * The five canonical sections of a context pack.
- * Order matters: invariants are injected first, contradictions last.
- */
-export type ContextPackSectionKey = "invariants" | "activeBeliefs" | "openQuestions" | "recentEvidence" | "contradictions";
-export declare const CONTEXT_PACK_SECTION_KEYS: readonly ContextPackSectionKey[];
-/**
- * Token budget allocation ratios per section.
- * These sum to 1.0 and determine how the total tokenBudget is divided.
- *
- * Rationale:
- * - invariants (0.28): Highest-priority constraints, injected first
- * - activeBeliefs (0.30): Largest section, carries domain knowledge
- * - openQuestions (0.17): Unresolved work items guide agent behavior
- * - recentEvidence (0.17): Implementation context for grounding
- * - contradictions (0.08): Tension signals, smallest section
- */
-export declare const SECTION_BUDGET_RATIOS: Readonly<Record<ContextPackSectionKey, number>>;
-/** Minimum allowed token budget. Below this, context packs lose utility. */
-export declare const MIN_TOKEN_BUDGET = 400;
-/** Maximum allowed token budget. Above this, context packs bloat prompts. */
-export declare const MAX_TOKEN_BUDGET = 8000;
-/** Default token budget when caller does not specify. */
-export declare const DEFAULT_TOKEN_BUDGET = 1800;
-/** Default max items per section. */
-export declare const DEFAULT_SECTION_LIMIT = 8;
-/** Hard ceiling on items per section. */
-export declare const MAX_SECTION_LIMIT = 25;
-/** Minimum contradiction section budget floor (tokens). */
-export declare const MIN_CONTRADICTION_BUDGET = 40;
-/**
- * Weight vectors for the weighted_v1 ranking profile.
- * Each section has a different signal mix:
- *
- * - query: How many query tokens appear in the candidate text
- * - recency: Exponential decay from updatedAt (half-life = 30 days)
- * - confidence: Belief confidence score [0,1]
- * - beliefType: Bonus for invariant > tenet > principle > other
- * - priority: Question priority (critical > high > medium > low)
- * - severity: Contradiction severity (critical > high > medium > low)
- */
-export type RankingWeightVector = {
-    query: number;
-    recency: number;
-    confidence?: number;
-    beliefType?: number;
-    priority?: number;
-    severity?: number;
-};
-export declare const RANKING_WEIGHTS: Readonly<Record<ContextPackSectionKey, RankingWeightVector>>;
-/** Recency decay half-life in days. After 30 days, recency score = 0.5. */
-export declare const RECENCY_HALF_LIFE_DAYS = 30;
-/**
- * Ranking weight vector for the relatedEntities section.
- * Entities are ranked by query relevance and connectivity (bridge edge count).
- * Separate from RANKING_WEIGHTS because entities are not part of the
- * token-budgeted injection plan.
- */
-export declare const ENTITY_RANKING_WEIGHTS: {
-    readonly query: 0.4;
-    readonly connectivity: 0.6;
-};
-/** Default max entities to include in the context pack. */
-export declare const DEFAULT_ENTITY_LIMIT = 10;
-/** Hard ceiling on entities per context pack. */
-export declare const MAX_ENTITY_LIMIT = 50;
-/**
- * Bonus multiplier for belief types in ranking.
- * Invariants get 1.0, unknown types get 0.4.
- */
-export declare const BELIEF_TYPE_BONUS: Readonly<Record<string, number>>;
-export declare const DEFAULT_BELIEF_TYPE_BONUS = 0.4;
-export declare const PRIORITY_SCORES: Readonly<Record<string, number>>;
-export declare const DEFAULT_PRIORITY_SCORE = 0.5;
-export declare const SEVERITY_SCORES: Readonly<Record<string, number>>;
-export declare const DEFAULT_SEVERITY_SCORE = 0.5;
-/** A ranked belief in the invariants or activeBeliefs section. */
-export type ContextPackBelief = {
-    nodeId: string;
-    canonicalText: string;
-    confidence: number | null;
-    beliefType: string | null;
-    score: number;
-    /** Present in activeBeliefs, absent in invariants */
-    status?: string;
-    updatedAt?: number | null;
-    /** Human-readable explanation of why this item was ranked here (RS-2). */
-    justification?: string;
-};
-/** A ranked question in the openQuestions section. */
-export type ContextPackQuestion = {
-    questionId: string;
-    text: string;
-    status: string;
-    priority: string;
-    updatedAt?: number | null;
-    score: number;
-    /** Human-readable explanation of why this item was ranked here (RS-2). */
-    justification?: string;
-};
-/** A ranked evidence item in the recentEvidence section. */
-export type ContextPackEvidence = {
-    nodeId: string;
-    canonicalText: string;
-    sourceUrl: string | null;
-    kind: string;
-    createdAt: number | null;
-    score: number;
-    /** Human-readable explanation of why this item was ranked here (RS-2). */
-    justification?: string;
-};
-/** A ranked contradiction in the contradictions section. */
-export type ContextPackContradiction = {
-    contradictionId: string;
-    severity: string;
-    status: string;
-    description: string;
-    score: number;
-    /** Human-readable explanation of why this item was ranked here (RS-2). */
-    justification?: string;
-};
-/**
- * An entity from the ontological layer surfaced in the context pack.
- * Entities are domain objects (companies, people, functions, etc.) connected
- * to beliefs via bridge edges. They provide the "reality anchor" that makes
- * the reasoning graph domain-aware.
- */
-export type ContextPackEntity = {
-    /** Convex document ID of the entity node. */
-    nodeId: string;
-    /** Entity type (e.g., "company", "person", "function"). */
-    entityType: string;
-    /** Human-readable title/name of the entity. */
-    title: string;
-    /** Number of beliefs connected to this entity via bridge edges. */
-    connectedBeliefCount: number;
-    /** Number of evidence items referencing this entity. */
-    connectedEvidenceCount: number;
-    /** Relevance score from ranking algorithm. */
-    score: number;
-    /** Entity metadata (structured per ontology schema). */
-    metadata?: Record<string, unknown>;
-};
-/**
- * A lattice seed entry representing a belief that was auto-generated
- * to cover an ontology entity type within a topic scope.
- */
-export type BeliefLatticeSeed = {
-    /** The belief node ID that was created or already existed. */
-    beliefNodeId: string;
-    /** The entity type this seed belief covers. */
-    entityType: string;
-    /** Whether this seed was newly created or already existed. */
-    created: boolean;
-    /** The canonical text of the seed belief. */
-    canonicalText: string;
-};
-/** Counts and scoped health signals for the context pack. */
-export type ContextPackSummary = {
-    totalBeliefs: number;
-    invariants: number;
-    openQuestions: number;
-    evidenceItems: number;
-    contradictions: number;
-    /** Number of ontological entities in scope (optional, present when entity graph is active). */
-    relatedEntities?: number;
-    scopedTopics: number;
-    descendantDepth: number;
-    query: string | null;
-};
-/** A failed approach surfaced from the failure log for anti-repetition. */
-export type ContextPackFailure = {
-    /** Lucern attempt/evidence node ID. */
-    attemptId: string;
-    /** What was tried. */
-    approach: string;
-    /** Why it failed. */
-    outcome: string;
-    /** When the attempt was recorded (ms since epoch). */
-    recordedAt: number;
-    /** Relevance score from ranking algorithm. */
-    score: number;
-};
-/** Failure context section appended to context packs in delta mode. */
-export type ContextPackFailureContext = {
-    /** Ranked failed approaches relevant to the current query. */
-    failures: ContextPackFailure[];
-    /** IDs of items suppressed from other sections due to anti-repetition. */
-    suppressedIds: string[];
-};
-/** A verification obligation surfaced by delta compilation. */
-export type VerificationObligation = {
-    /** What must be verified. */
-    description: string;
-    /** Source of the obligation (e.g., "belief:xyz confidence drop"). */
-    source: string;
-    /** Severity: how important it is to verify. */
-    severity: "critical" | "high" | "medium" | "low";
-};
-/** Delta report appended to context packs when mode = "delta". */
-export type ContextPackDeltaReport = {
-    /** Items that changed since the reference point (new, updated, removed). */
-    changedItems: Array<{
-        id: string;
-        section: ContextPackSectionKey;
-        changeType: "added" | "updated" | "removed" | "confidence_changed";
-        summary: string;
-    }>;
-    /** Obligations the consuming session must verify. */
-    verificationObligations: VerificationObligation[];
-    /** Reference point for the delta (worktree ID, timestamp, or commit SHA). */
-    referencePoint: string;
-};
-/**
- * Per-section weight overrides that domain packs can apply.
- * Overrides merge with RANKING_WEIGHTS — only specified fields replace defaults.
- */
-export type PackWeightOverride = {
-    /** Which section to override weights for. */
-    section: ContextPackSectionKey;
-    /** Partial weight vector — only specified fields replace defaults. */
-    weights: Partial<RankingWeightVector>;
-};
-/** Token-budgeted section selections for prompt injection. */
-export type ContextPackInjectionPolicy = {
-    /** Total token budget for the entire context pack. */
-    tokenBudget: number;
-    /** Estimated tokens consumed across all sections. */
-    estimatedTokens: number;
-    /** Per-section token budgets derived from SECTION_BUDGET_RATIOS. */
-    sectionBudgets: Record<ContextPackSectionKey, number>;
-    /** Actual token usage per section after greedy fill. */
-    sectionUsage: Record<ContextPackSectionKey, number>;
-    /** Node/question IDs selected for injection, per section. */
-    selected: Record<ContextPackSectionKey, string[]>;
-    /** Items that were scored but excluded from injection, with reason (RS-2). */
-    excludedItems?: Array<{
-        id: string;
-        section: ContextPackSectionKey;
-        reason: "budget_exceeded" | "anti_repetition" | "below_threshold";
-        score: number;
-    }>;
-};
-/** Telemetry for context pack assembly. */
-export type ContextPackDiagnostics = {
-    /** Total candidates scored across all sections. */
-    itemsScored: number;
-    /** Ratio of estimatedTokens / tokenBudget. Range [0, 1+]. */
-    tokenBudgetUtilization: number;
-};
-/**
- * Public context surface returned by the SDK-facing context client.
- *
- * This preserves the existing external shape while the canonical compiler
- * contract evolves in parallel as ContextPackV1.
- */
-export type PublicContextBelief = {
-    beliefId: string;
-    text: string;
-    confidence: number | null;
-    beliefType?: string | null;
-    status?: string;
-    updatedAt?: number | null;
-    score: number;
-    justification?: string;
-};
-export type PublicContextQuestion = {
-    questionId: string;
-    text: string;
-    status: string;
-    priority: string;
-    updatedAt?: number | null;
-    score: number;
-    justification?: string;
-};
-export type PublicContextEvidence = {
-    evidenceId: string;
-    text: string;
-    sourceUrl?: string | null;
-    kind: string;
-    createdAt?: number | null;
-    score: number;
-    justification?: string;
-};
-export type PublicContextContradiction = {
-    contradictionId: string;
-    severity: string;
-    status: string;
-    description: string;
-    score: number;
-    justification?: string;
-};
-export type PublicContextEntity = {
-    entityId: string;
-    entityType: string;
-    title: string;
-    text?: string;
-    connectedBeliefCount: number;
-    connectedEvidenceCount: number;
-    score: number;
-    metadata?: Record<string, unknown>;
-};
-export type PublicContextInjectionPolicy = {
-    tokenBudget: number;
-    estimatedTokens: number;
-    sectionBudgets: Record<string, number>;
-    sectionUsage: Record<string, number>;
-    selected: Record<string, string[]>;
-    excludedItems?: Array<{
-        id: string;
-        section: string;
-        reason: "budget_exceeded" | "anti_repetition" | "below_threshold";
-        score: number;
-    }>;
-};
-export type PublicCompiledContext = {
-    schemaVersion: string;
-    topicId: string;
-    topicName: string;
-    scopedTopicIds: string[];
-    generatedAt: number;
-    ranking: ContextRankingProfile;
-    summary: Record<string, unknown>;
-    invariants: PublicContextBelief[];
-    activeBeliefs: PublicContextBelief[];
-    openQuestions: PublicContextQuestion[];
-    recentEvidence: PublicContextEvidence[];
-    contradictions: PublicContextContradiction[];
-    relatedEntities?: PublicContextEntity[];
-    contextNarrative: string[];
-    injectionPolicy: PublicContextInjectionPolicy;
-    diagnostics: Record<string, unknown>;
-    compilationMode?: string;
-    failureContext?: {
-        failures: Array<{
-            attemptId: string;
-            approach: string;
-            outcome: string;
-            recordedAt: number;
-            score: number;
-        }>;
-        suppressedIds: string[];
-    };
-    deltaReport?: {
-        changedItems: Array<{
-            id: string;
-            section: string;
-            changeType: string;
-            summary: string;
-        }>;
-        verificationObligations: Array<{
-            description: string;
-            source: string;
-            severity: "critical" | "high" | "medium" | "low";
-        }>;
-        referencePoint: string;
-    };
-    appliedWeightOverrides?: unknown[];
-};
-/**
- * The canonical output schema for context compilation responses.
- *
- * This is the contract that consumers depend on. All fields are required
- * in the output. Adding optional fields is non-breaking; removing or
- * changing types is breaking (requires version bump).
- */
-export type ContextPackV1 = {
-    /** Schema version for compatibility checking. */
-    schemaVersion: typeof CONTEXT_PACK_SCHEMA_VERSION;
-    /** Deprecated compatibility alias for the requested scope ID. */
-    projectId?: string;
-    /** Resolved topic ID after scope resolution. */
-    topicId: string;
-    /** Human-readable topic name. */
-    topicName: string;
-    /** All topic IDs included in the neighborhood expansion. */
-    scopedTopicIds: string[];
-    /** Deterministic freshness watermark for this pack (ms since epoch). */
-    generatedAt: number;
-    /** Which ranking profile was used. */
-    rankingProfile: ContextRankingProfile;
-    /** Aggregate counts and health signals. */
-    summary: ContextPackSummary;
-    /** High-confidence invariant beliefs (beliefType = "invariant"). */
-    invariants: ContextPackBelief[];
-    /** Active beliefs ranked by query relevance. */
-    activeBeliefs: ContextPackBelief[];
-    /** Open questions ranked by relevance and priority. */
-    openQuestions: ContextPackQuestion[];
-    /** Recent evidence ranked by relevance and recency. */
-    recentEvidence: ContextPackEvidence[];
-    /** Active contradictions ranked by severity. */
-    contradictions: ContextPackContradiction[];
-    /**
-     * Ontological entities connected to beliefs in scope, ranked by connectivity.
-     * Optional — present when entity graph substrate is active for this topic.
-     * NON-BREAKING addition per contract rules.
-     */
-    relatedEntities?: ContextPackEntity[];
-    /** Concise instructions for agent context injection. */
-    contextNarrative: string[];
-    /** Token-budgeted injection selections. */
-    injectionPolicy: ContextPackInjectionPolicy;
-    /** Assembly telemetry. */
-    diagnostics: ContextPackDiagnostics;
-    /** Compilation mode used to generate this pack (RS-2). Default: "standard". */
-    compilationMode?: ContextCompilationMode;
-    /** Failure context for anti-repetition (RS-2). Present when failures are relevant. */
-    failureContext?: ContextPackFailureContext;
-    /** Delta report (RS-2). Present only when compilationMode = "delta". */
-    deltaReport?: ContextPackDeltaReport;
-    /** Pack weight overrides applied during ranking (RS-2). */
-    appliedWeightOverrides?: PackWeightOverride[];
-};
-/**
- * The canonical input schema for `compile_context`.
- * `topicId` is canonical. `projectId` remains an optional compatibility alias.
- */
-export type ContextPackRequestV1 = {
-    /** Topic scope ID (required). */
-    topicId: string;
-    /** Deprecated compatibility alias for older callers. */
-    projectId?: string;
-    /** Focus query for relevance ranking. */
-    query?: string;
-    /** Max items per section. Default: DEFAULT_SECTION_LIMIT. */
-    limit?: number;
-    /** Ranking profile. Default: DEFAULT_RANKING_PROFILE. */
-    rankingProfile?: ContextRankingProfile;
-    /** Total token budget. Default: DEFAULT_TOKEN_BUDGET. */
-    tokenBudget?: number;
-    /** Descendant topic depth for neighborhood expansion. */
-    maxDepth?: number;
-    /** Include ontological entities connected to beliefs in scope. Default: true. */
-    includeEntities?: boolean;
-    /** Compilation mode (RS-2). Default: "standard". */
-    mode?: ContextCompilationMode;
-    /** Include failure log context for anti-repetition (RS-2). Default: false. */
-    includeFailures?: boolean;
-    /** Active worktree ID for delta mode reference point (RS-2). */
-    worktreeId?: string;
-    /** Session ID for anti-repetition dedup (RS-2). */
-    sessionId?: string;
-    /** Pack weight overrides from domain pack binding (RS-2). */
-    packWeightOverrides?: PackWeightOverride[];
-};
-/**
- * Question statuses that are considered "resolved" (not open).
- * Used to filter which questions appear in the openQuestions section.
- */
-export declare const RESOLVED_QUESTION_STATUSES: readonly string[];
-/**
- * Tokens-per-word multiplier for rough token estimation.
- * Conservative estimate: ~1.35 tokens per whitespace-delimited word.
- */
-export declare const TOKENS_PER_WORD = 1.35;
-/** Minimum token estimate for any non-empty string. */
-export declare const MIN_TOKEN_ESTIMATE = 8;
-//# sourceMappingURL=context-pack.contract.d.ts.map

package/dist/context-pack.contract.d.ts.map

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

package/dist/context-pack.contract.js

@@ -1,170 +0,0 @@
-/**
- * Context-Pack Contract v1
- *
- * Canonical TypeScript types and constants for the context-pack output schema.
- * This is the external contract consumed by:
- *   - MCP tool `compile_context` (canonical compiler read)
- *   - SDK/HTTP consumers that read compiled context packs programmatically
- *   - Benchmark harnesses (context-pack-ab)
- *
- * BREAKING CHANGE RULES:
- *   - Adding optional fields to ContextPackV1 is NON-breaking
- *   - Removing fields or changing types is BREAKING (bump CONTEXT_PACK_SCHEMA_VERSION)
- *   - Changing section budget ratios or ranking weights is NON-breaking (tuning)
- *   - Changing the version string is BREAKING (consumers check it)
- */
-// =============================================================================
-// SCHEMA VERSION
-// =============================================================================
-/** Canonical version string. Consumers MUST check this field for compatibility. */
-export const CONTEXT_PACK_SCHEMA_VERSION = "1.0.0";
-export const CONTEXT_RANKING_PROFILES = [
-    "baseline_v1",
-    "weighted_v1",
-];
-export const DEFAULT_RANKING_PROFILE = "weighted_v1";
-export const DEFAULT_COMPILATION_MODE = "standard";
-export const CONTEXT_PACK_SECTION_KEYS = [
-    "invariants",
-    "activeBeliefs",
-    "openQuestions",
-    "recentEvidence",
-    "contradictions",
-];
-// =============================================================================
-// SECTION BUDGET RATIOS
-// =============================================================================
-/**
- * Token budget allocation ratios per section.
- * These sum to 1.0 and determine how the total tokenBudget is divided.
- *
- * Rationale:
- * - invariants (0.28): Highest-priority constraints, injected first
- * - activeBeliefs (0.30): Largest section, carries domain knowledge
- * - openQuestions (0.17): Unresolved work items guide agent behavior
- * - recentEvidence (0.17): Implementation context for grounding
- * - contradictions (0.08): Tension signals, smallest section
- */
-export const SECTION_BUDGET_RATIOS = {
-    invariants: 0.28,
-    activeBeliefs: 0.3,
-    openQuestions: 0.17,
-    recentEvidence: 0.17,
-    contradictions: 0.08,
-};
-// =============================================================================
-// TOKEN BUDGET CONSTRAINTS
-// =============================================================================
-/** Minimum allowed token budget. Below this, context packs lose utility. */
-export const MIN_TOKEN_BUDGET = 400;
-/** Maximum allowed token budget. Above this, context packs bloat prompts. */
-export const MAX_TOKEN_BUDGET = 8000;
-/** Default token budget when caller does not specify. */
-export const DEFAULT_TOKEN_BUDGET = 1800;
-/** Default max items per section. */
-export const DEFAULT_SECTION_LIMIT = 8;
-/** Hard ceiling on items per section. */
-export const MAX_SECTION_LIMIT = 25;
-/** Minimum contradiction section budget floor (tokens). */
-export const MIN_CONTRADICTION_BUDGET = 40;
-export const RANKING_WEIGHTS = {
-    invariants: {
-        query: 0.35,
-        recency: 0.1,
-        confidence: 0.4,
-        beliefType: 0.15,
-    },
-    activeBeliefs: {
-        query: 0.5,
-        recency: 0.2,
-        confidence: 0.2,
-        beliefType: 0.1,
-    },
-    openQuestions: {
-        query: 0.55,
-        recency: 0.2,
-        priority: 0.25,
-    },
-    recentEvidence: {
-        query: 0.6,
-        recency: 0.4,
-    },
-    contradictions: {
-        query: 0.4,
-        recency: 0.2,
-        severity: 0.4,
-    },
-};
-/** Recency decay half-life in days. After 30 days, recency score = 0.5. */
-export const RECENCY_HALF_LIFE_DAYS = 30;
-/**
- * Ranking weight vector for the relatedEntities section.
- * Entities are ranked by query relevance and connectivity (bridge edge count).
- * Separate from RANKING_WEIGHTS because entities are not part of the
- * token-budgeted injection plan.
- */
-export const ENTITY_RANKING_WEIGHTS = {
-    query: 0.4,
-    connectivity: 0.6,
-};
-/** Default max entities to include in the context pack. */
-export const DEFAULT_ENTITY_LIMIT = 10;
-/** Hard ceiling on entities per context pack. */
-export const MAX_ENTITY_LIMIT = 50;
-// =============================================================================
-// BELIEF TYPE BONUS MAP
-// =============================================================================
-/**
- * Bonus multiplier for belief types in ranking.
- * Invariants get 1.0, unknown types get 0.4.
- */
-export const BELIEF_TYPE_BONUS = {
-    invariant: 1.0,
-    tenet: 0.8,
-    principle: 0.6,
-};
-export const DEFAULT_BELIEF_TYPE_BONUS = 0.4;
-// =============================================================================
-// PRIORITY / SEVERITY SCORE MAPS
-// =============================================================================
-export const PRIORITY_SCORES = {
-    critical: 1.0,
-    high: 0.85,
-    medium: 0.55,
-    low: 0.35,
-};
-export const DEFAULT_PRIORITY_SCORE = 0.5;
-export const SEVERITY_SCORES = {
-    critical: 1.0,
-    high: 0.85,
-    medium: 0.6,
-    low: 0.35,
-};
-export const DEFAULT_SEVERITY_SCORE = 0.5;
-// =============================================================================
-// RESOLVED QUESTION STATUSES
-// =============================================================================
-/**
- * Question statuses that are considered "resolved" (not open).
- * Used to filter which questions appear in the openQuestions section.
- */
-export const RESOLVED_QUESTION_STATUSES = [
-    "answered",
-    "archived",
-    "closed",
-    "resolved",
-    "resolved_support",
-    "resolved_contra",
-    "belief_forked",
-];
-// =============================================================================
-// TOKEN ESTIMATION
-// =============================================================================
-/**
- * Tokens-per-word multiplier for rough token estimation.
- * Conservative estimate: ~1.35 tokens per whitespace-delimited word.
- */
-export const TOKENS_PER_WORD = 1.35;
-/** Minimum token estimate for any non-empty string. */
-export const MIN_TOKEN_ESTIMATE = 8;
-//# sourceMappingURL=context-pack.contract.js.map