kiokuko-dsh 0.1.0

package/dist/context/nudges.js

@@ -0,0 +1,131 @@
+import { KiokukoError } from '../errors.js';
+import { canonicalContentHash, compareCanonicalStrings } from '../serialization/validate.js';
+import { MAX_EVIDENCE_EVENT_IDS, MAX_REFERENCE_IDS, } from './recommendations.js';
+export const NUDGE_POLICY_VERSION = 'nudges.v1';
+export function assertNudgePolicyVersion(value) {
+    if (value !== NUDGE_POLICY_VERSION) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Unsupported nudge policy version');
+    }
+}
+export function isNudgePolicyVersion(value) {
+    return value === NUDGE_POLICY_VERSION;
+}
+export const NUDGE_CODES = [
+    'SIDE_EFFECT_OUTCOME_UNKNOWN',
+    'UNRESOLVED_FAILURE',
+    'VERIFY_AFTER_MUTATION',
+];
+export const NUDGE_PRIORITY = Object.freeze({
+    SIDE_EFFECT_OUTCOME_UNKNOWN: 2,
+    UNRESOLVED_FAILURE: 3,
+    VERIFY_AFTER_MUTATION: 4,
+});
+export const NUDGE_MESSAGES = Object.freeze({
+    SIDE_EFFECT_OUTCOME_UNKNOWN: 'A side effect has no known outcome. Consider verifying its result before relying on subsequent work.',
+    UNRESOLVED_FAILURE: 'Unresolved failures remain. Consider resolving or explicitly carrying them forward before finishing.',
+    VERIFY_AFTER_MUTATION: 'The latest passing verification predates the most recent mutation. Consider re-running the affected verification before finishing.',
+});
+export const DEFAULT_NUDGE_RATE_LIMIT = Object.freeze({
+    maxPerResponse: 1,
+    maxPerRun: 3,
+    minSequenceDistancePerCode: 3,
+});
+const NUDGE_CODE_SET = new Set(NUDGE_CODES);
+function isNudgeCode(value) {
+    return NUDGE_CODE_SET.has(value);
+}
+function sortedBoundedIds(values, maximum) {
+    return [...new Set(values)].sort(compareCanonicalStrings).slice(0, maximum);
+}
+function canonicalIdentityIds(values) {
+    const ids = [...new Set(values)].sort(compareCanonicalStrings);
+    return { count: ids.length, hash: canonicalContentHash(ids) };
+}
+function occurrenceId(code, occurrence) {
+    return canonicalContentHash({
+        policyVersion: NUDGE_POLICY_VERSION,
+        code,
+        occurrence,
+    });
+}
+function candidate(code, occurrence, recommendation) {
+    return {
+        code,
+        occurrenceId: occurrenceId(code, occurrence),
+        priority: NUDGE_PRIORITY[code],
+        message: NUDGE_MESSAGES[code],
+        evidenceEventIds: sortedBoundedIds(recommendation.evidenceEventIds, MAX_EVIDENCE_EVENT_IDS),
+        referenceIds: sortedBoundedIds(recommendation.metadata.referenceIds, MAX_REFERENCE_IDS),
+    };
+}
+function compareNudgeCandidates(left, right) {
+    return left.priority - right.priority
+        || compareCanonicalStrings(left.code, right.code)
+        || compareCanonicalStrings(left.occurrenceId, right.occurrenceId);
+}
+function recommendationByCode(recommendations) {
+    const result = new Map();
+    for (const recommendation of recommendations) {
+        if (!isNudgeCode(recommendation.code))
+            continue;
+        const current = result.get(recommendation.code);
+        if (current === undefined || canonicalContentHash(recommendation) < canonicalContentHash(current)) {
+            result.set(recommendation.code, recommendation);
+        }
+    }
+    return result;
+}
+export function deriveNudgeCandidates(projection, recommendations) {
+    const byCode = recommendationByCode(recommendations);
+    const candidates = [];
+    const unknownOutcome = byCode.get('SIDE_EFFECT_OUTCOME_UNKNOWN');
+    if (unknownOutcome !== undefined && projection.unknownOutcomeEventIds.length > 0) {
+        candidates.push(candidate('SIDE_EFFECT_OUTCOME_UNKNOWN', {
+            unknownOutcomeEventIds: canonicalIdentityIds(projection.unknownOutcomeEventIds),
+        }, unknownOutcome));
+    }
+    const failure = byCode.get('UNRESOLVED_FAILURE');
+    if (failure !== undefined && projection.unresolvedFailureEventIds.length > 0) {
+        candidates.push(candidate('UNRESOLVED_FAILURE', {
+            unresolvedFailureEventIds: canonicalIdentityIds(projection.unresolvedFailureEventIds),
+        }, failure));
+    }
+    const verification = byCode.get('VERIFY_AFTER_MUTATION');
+    if (verification !== undefined
+        && projection.evidenceState === 'stale'
+        && projection.latestMutationSequence !== null) {
+        candidates.push(candidate('VERIFY_AFTER_MUTATION', {
+            latestMutationSequence: projection.latestMutationSequence,
+            latestMutationEventIds: canonicalIdentityIds(projection.latestMutationEventIds),
+        }, verification));
+    }
+    return candidates.sort(compareNudgeCandidates);
+}
+export function selectNudge(candidates, history, throughSequence, policy = DEFAULT_NUDGE_RATE_LIMIT) {
+    if (policy.maxPerResponse < 1 || history.runDeliveryCount >= policy.maxPerRun)
+        return null;
+    const eligible = candidates
+        .filter((candidateValue) => !history.deliveredOccurrenceIds.has(candidateValue.occurrenceId))
+        .filter((candidateValue) => {
+        const previous = history.lastSequenceByCode.get(candidateValue.code);
+        return previous === undefined || throughSequence - previous >= policy.minSequenceDistancePerCode;
+    })
+        .sort(compareNudgeCandidates);
+    return eligible[0] ?? null;
+}
+export function buildDeliveredNudge(candidateValue) {
+    return {
+        occurrenceId: candidateValue.occurrenceId,
+        code: candidateValue.code,
+        message: candidateValue.message,
+        evidenceEventIds: [...candidateValue.evidenceEventIds],
+        referenceIds: [...candidateValue.referenceIds],
+        priority: candidateValue.priority,
+        policyVersion: NUDGE_POLICY_VERSION,
+    };
+}
+export function assertNudgeCode(value) {
+    if (!isNudgeCode(value))
+        throw new KiokukoError('VALIDATION_ERROR', 'Invalid nudge code');
+}
+//# sourceMappingURL=nudges.js.map

package/dist/context/nudges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudges.js","sourceRoot":"","sources":["../../src/context/nudges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC7F,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAoB,CAAC;AAEzD,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,IAAI,KAAK,KAAK,oBAAoB,EAAE,CAAC;QACnC,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,kCAAkC,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,KAAK,oBAAoB,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,6BAA6B;IAC7B,oBAAoB;IACpB,uBAAuB;CACf,CAAC;AA6BX,MAAM,CAAC,MAAM,cAAc,GAAwC,MAAM,CAAC,MAAM,CAAC;IAC/E,2BAA2B,EAAE,CAAC;IAC9B,kBAAkB,EAAE,CAAC;IACrB,qBAAqB,EAAE,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAwC,MAAM,CAAC,MAAM,CAAC;IAC/E,2BAA2B,EAAE,sGAAsG;IACnI,kBAAkB,EAAE,sGAAsG;IAC1H,qBAAqB,EAAE,oIAAoI;CAC5J,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAyB,MAAM,CAAC,MAAM,CAAC;IAC1E,cAAc,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC;IACZ,0BAA0B,EAAE,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,WAAW,CAAC,CAAC;AAEpD,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAyB,EAAE,OAAe;IAClE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAyB;IACrD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC/D,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,IAAe,EAAE,UAAmC;IACxE,OAAO,oBAAoB,CAAC;QAC1B,aAAa,EAAE,oBAAoB;QACnC,IAAI;QACJ,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAChB,IAAe,EACf,UAAmC,EACnC,cAA8B;IAE9B,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC;QAC5C,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC;QAC9B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;QAC7B,gBAAgB,EAAE,gBAAgB,CAAC,cAAc,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;QAC3F,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;KACxF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAoB,EAAE,KAAqB;IACzE,OAAO,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ;WAChC,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;WAC9C,uBAAuB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,oBAAoB,CAAC,eAA0C;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IACpD,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC;YAAE,SAAS;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,OAAO,KAAK,SAAS,IAAI,oBAAoB,CAAC,cAAc,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YAClG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAA4B,EAC5B,eAA0C;IAE1C,MAAM,MAAM,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IACjE,IAAI,cAAc,KAAK,SAAS,IAAI,UAAU,CAAC,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,6BAA6B,EAAE;YACvD,sBAAsB,EAAE,oBAAoB,CAAC,UAAU,CAAC,sBAAsB,CAAC;SAChF,EAAE,cAAc,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,SAAS,IAAI,UAAU,CAAC,yBAAyB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7E,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE;YAC9C,yBAAyB,EAAE,oBAAoB,CAAC,UAAU,CAAC,yBAAyB,CAAC;SACtF,EAAE,OAAO,CAAC,CAAC,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACzD,IAAI,YAAY,KAAK,SAAS;WACzB,UAAU,CAAC,aAAa,KAAK,OAAO;WACpC,UAAU,CAAC,sBAAsB,KAAK,IAAI,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,uBAAuB,EAAE;YACjD,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;YACzD,sBAAsB,EAAE,oBAAoB,CAAC,UAAU,CAAC,sBAAsB,CAAC;SAChF,EAAE,YAAY,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,UAAqC,EACrC,OAAqB,EACrB,eAAuB,EACvB,SAA+B,wBAAwB;IAEvD,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,IAAI,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE3F,MAAM,QAAQ,GAAG,UAAU;SACxB,MAAM,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;SAC5F,MAAM,CAAC,CAAC,cAAc,EAAE,EAAE;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACrE,OAAO,QAAQ,KAAK,SAAS,IAAI,eAAe,GAAG,QAAQ,IAAI,MAAM,CAAC,0BAA0B,CAAC;IACnG,CAAC,CAAC;SACD,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAEhC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,cAA8B;IAChE,OAAO;QACL,YAAY,EAAE,cAAc,CAAC,YAAY;QACzC,IAAI,EAAE,cAAc,CAAC,IAAI;QACzB,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,gBAAgB,EAAE,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC;QACtD,YAAY,EAAE,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC;QAC9C,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,aAAa,EAAE,oBAAoB;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AAC5F,CAAC"}

package/dist/context/origin.d.ts

@@ -0,0 +1,9 @@
+export declare const CONTEXT_ENTRY_ORIGINS: readonly ["project", "ecosystem", "global"];
+export type ContextEntryOrigin = (typeof CONTEXT_ENTRY_ORIGINS)[number];
+export declare function isContextEntryOrigin(value: unknown): value is ContextEntryOrigin;
+export declare function entryOriginMatchesWorkspace(input: {
+    origin: ContextEntryOrigin;
+    runWorkspace: string;
+    entryWorkspace: string;
+}): boolean;
+//# sourceMappingURL=origin.d.ts.map

package/dist/context/origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../../src/context/origin.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,6CAA8C,CAAC;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CASV"}

package/dist/context/origin.js

@@ -0,0 +1,15 @@
+export const CONTEXT_ENTRY_ORIGINS = ['project', 'ecosystem', 'global'];
+export function isContextEntryOrigin(value) {
+    return typeof value === 'string' && CONTEXT_ENTRY_ORIGINS.includes(value);
+}
+export function entryOriginMatchesWorkspace(input) {
+    switch (input.origin) {
+        case 'project':
+            return input.entryWorkspace === input.runWorkspace;
+        case 'global':
+            return input.entryWorkspace === 'global';
+        case 'ecosystem':
+            return input.entryWorkspace !== 'global' && input.entryWorkspace !== input.runWorkspace;
+    }
+}
+//# sourceMappingURL=origin.js.map

package/dist/context/origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.js","sourceRoot":"","sources":["../../src/context/origin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGjF,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,QAAQ,CAAC,KAA2B,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAI3C;IACC,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,YAAY,CAAC;QACrD,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,CAAC;QAC3C,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,YAAY,CAAC;IAC5F,CAAC;AACH,CAAC"}

package/dist/context/ranking.d.ts

@@ -0,0 +1,92 @@
+import { type EntryKind, type EntryStatus, type TrustLevel } from '../serialization/validate.js';
+export declare const CONTEXT_RANKING_VERSION: "context-ranking-v1";
+/** Integer score weights. Components are additive and deliberately bounded. */
+export declare const CONTEXT_RANKING_WEIGHTS: Readonly<{
+    readonly statusVerified: 100;
+    readonly statusCandidate: 40;
+    readonly trustSystemVerified: 30;
+    readonly trustSourceVerified: 25;
+    readonly trustUserAsserted: 15;
+    readonly confidence: 20;
+    readonly taskAffinity: 12;
+    readonly recommendedTag: 10;
+    readonly pathOverlap: 12;
+    readonly errorSignature: 15;
+    readonly feedbackHelpful: 3;
+    readonly feedbackIrrelevant: -3;
+    readonly feedbackStale: -4;
+    readonly feedbackConflicting: -4;
+    readonly recency: 5;
+    readonly contradiction: 0;
+}>;
+export declare const CONTEXT_RANKING_COMPONENTS: readonly ["status", "trust", "confidence", "taskAffinity", "recommendedTags", "pathOverlap", "errorSignature", "feedback", "recency", "contradiction"];
+/** Additive v2 delivery components; v1 rows continue to use the list above. */
+export declare const CONTEXT_RANKING_COMPONENTS_V2: readonly ["status", "trust", "confidence", "retrieval", "taskAffinity", "recommendedTags", "scopeAffinity", "applicability", "pathOverlap", "errorSignature", "exactSignal", "feedback", "recency", "contradiction"];
+export declare const CONTEXT_SELECTION_REASON_ORDER: readonly ["project_origin", "ecosystem_origin", "global_origin", "scope_affinity", "applicability_match", "applicability_unknown", "applicability_mismatch", "unscoped_global_prior", "exact_signal_match", "word_match", "semantic_match", "lexical_match", "cjk_window_match", "substring_match", "literal_fallback_match", "tag_match", "verified", "candidate", "system_verified_trust", "source_verified_trust", "user_asserted_trust", "confidence", "task_kind_affinity", "task_tag_affinity", "recommended_tag_match", "target_match", "changed_path_match", "error_signature_match", "helpful_feedback", "irrelevant_feedback", "stale_feedback", "conflicting_feedback", "recent", "contradiction_warning", "revision_changed"];
+export type ContextRankingComponent = (typeof CONTEXT_RANKING_COMPONENTS)[number];
+export type ContextRankingV2Component = (typeof CONTEXT_RANKING_COMPONENTS_V2)[number];
+export type FeedbackVerdict = 'helpful' | 'irrelevant' | 'stale' | 'conflicting';
+export interface ContextCandidateSnapshot {
+    id: string;
+    revision: number;
+    kind: EntryKind;
+    status: EntryStatus;
+    trustLevel: TrustLevel;
+    confidence: number;
+    title: string;
+    summary: string | null;
+    body: string;
+    tags: string[];
+    scope: Record<string, unknown>;
+    updatedAt: string;
+    selectionReasons?: string[];
+    contradiction?: boolean;
+    origin?: 'project' | 'ecosystem' | 'global';
+}
+export interface PriorDeliveredEntry {
+    entryId: string;
+    revision: number;
+}
+export interface ContextFeedback {
+    entryId: string;
+    verdict: FeedbackVerdict;
+}
+export interface RankedScoreComponents {
+    status: number;
+    trust: number;
+    confidence: number;
+    taskAffinity: number;
+    recommendedTags: number;
+    pathOverlap: number;
+    errorSignature: number;
+    feedback: number;
+    recency: number;
+    contradiction: number;
+}
+export interface RankedCandidateContent {
+    title: string;
+    summary: string | null;
+    bodyPreview: string;
+    characterCount: number;
+    truncated: boolean;
+}
+export interface RankedCandidate {
+    entryId: string;
+    revision: number;
+    kind: EntryKind;
+    status: EntryStatus;
+    trustLevel: TrustLevel;
+    confidence: number;
+    tags: string[];
+    scope: Record<string, unknown>;
+    updatedAt: string;
+    totalScore: number;
+    scoreComponents: RankedScoreComponents;
+    selectionReasons: string[];
+    content: RankedCandidateContent;
+    origin?: 'project' | 'ecosystem' | 'global';
+}
+export declare const CONTEXT_RANKING_DEFAULT_CHARACTER_BUDGET = 8000;
+export declare const CONTEXT_RANKING_MAX_CHARACTER_BUDGET = 100000;
+export declare function rankContextCandidates(input: unknown): RankedCandidate[];
+//# sourceMappingURL=ranking.d.ts.map

package/dist/context/ranking.d.ts.map

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