@jinn-network/client 0.2.0-canary.0b79cd5d → 0.2.0-canary.31247316

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "clientGitSha": "0b79cd5d1ec59cbf714a4d3814412d57fd7f7173",
+  "clientGitSha": "312473165a5618f5f3e45a0b94532b63788916e1",
   "codeDigest": "sha256:205201da01ad74e3474acce6b6c454c5e9aeab73ca0cba86124cd8547e057171",
-  "builtAt": "2026-07-24T11:40:59.161Z",
-  "implVersion": "0.2.0-canary.0b79cd5d"
+  "builtAt": "2026-07-24T09:04:59.282Z",
+  "implVersion": "0.2.0-canary.31247316"
 }

package/dist/build-meta.json

@@ -1,3 +1,3 @@
 {
-  "commit": "0b79cd5d1ec59cbf714a4d3814412d57fd7f7173"
+  "commit": "312473165a5618f5f3e45a0b94532b63788916e1"
 }

package/dist/vendor/@jinn-network/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinn-network/core",
-  "version": "0.1.1",
+  "version": "0.1.0",
   "description": "Domain core for Jinn — evidence/contribution stores, scrub, trajectory parsing, and corpus reads. Independent of client/src.",
   "type": "module",
   "license": "MIT",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@huggingface/transformers": "^4.2.0",
-    "@jinn-network/plugin": "0.1.1",
+    "@jinn-network/plugin": "0.1.0",
     "@lmoe/gliner-onnx": "0.1.0",
     "@noble/hashes": "^2.2.0",
     "@secretlint/core": "^13.0.2",

package/dist/vendor/@jinn-network/plugin/dist/index.d.ts

@@ -19,7 +19,7 @@ export type { ContributionPort, ContributionLedgerEntry, ContributionLocalState,
 export type { LocalLearningPort, LocalLearningRun, LocalLearningSkill, } from './ports/local-learning-port.js';
 export type { SkillsPort, SkillRecord } from './ports/skills-port.js';
 export { createJinnPlugin, JINN_PLUGIN_CONTRACT_VERSION, PluginSession } from './plugin.js';
-export type { CompleteSessionEligibilityInputs, CompleteSessionInput, JinnPlugin, JinnPluginDeps, SessionMeta, FirstTurnPickupOptions, FirstTurnPickupResult, ToolCallEvent, SessionOutcome, SessionEndResult, ContributionCompletionReceipt, ContributionPreview, } from './plugin.js';
+export type { CompleteSessionEligibilityInputs, CompleteSessionInput, JinnPlugin, JinnPluginDeps, SessionMeta, FirstTurnPickupResult, ToolCallEvent, SessionOutcome, SessionEndResult, ContributionCompletionReceipt, ContributionPreview, } from './plugin.js';
 export { PickupConfigSchema, DEFAULT_PICKUP_CONFIG, parsePickupConfig, TIER_ORDER } from './schemas/pickup-config.js';
 export type { PickupConfig, Tier } from './schemas/pickup-config.js';
 export { deriveRepositorySearchTerms, discriminatingTerms, deriveSearchTerms, classifyPayload, dedupeKnowledgeHits, scoreKnowledgeHit, selectKnowledgeHits, rankKnowledgeHits, MAX_SELECTED_PACKETS, } from './pickup.js';

package/dist/vendor/@jinn-network/plugin/dist/pickup.d.ts

@@ -62,15 +62,7 @@ export declare function scoreKnowledgeHit(hit: KnowledgeHit, terms: string[]): n
  * cannot manufacture relevance.
  */
 export declare function scoreKnowledgeRecord(hit: KnowledgeHit, record: CorpusRecord, terms: string[]): number;
-/**
- * Return a copied, deterministically ranked scored-candidate list.
- *
- * Recency is a group property, not a pairwise comparator: within each equal
- * score+tier group, use recency only when every hit declares the same domain
- * (including the all-omitted legacy group). A mixed-domain group preserves
- * its stable score/tier input order rather than comparing incomparable
- * recency values or inventing a source priority.
- */
+/** Return a copied, deterministically ranked scored-candidate list. */
 export declare function rankScoredKnowledgeHits(candidates: ScoredKnowledgeHit[]): ScoredKnowledgeHit[];
 /**
  * Eligible, deduplicated candidates that have at least one metadata match.
@@ -81,9 +73,8 @@ export declare function rankKnowledgeCandidates(hits: KnowledgeHit[], terms: str
 /**
  * Full ranked candidate pool (rescope §3.3 selection policy): drop skill
  * hits, dedup, score, apply the relevance floor (honest nothing-found below
- * it), rank score desc → tier desc → comparable-domain recency desc (or ref
- * for a mixed-domain tie group) — every candidate that clears the floor, not
- * sliced to `MAX_SELECTED_PACKETS`.
+ * it), rank score desc → tier desc → recency desc — every candidate that
+ * clears the floor, not sliced to `MAX_SELECTED_PACKETS`.
  *
  * Content-level guards that can only run after a candidate's content is
  * fetched (mono #1782: post-fetch skill-payload classification, empty-packet

package/dist/vendor/@jinn-network/plugin/dist/pickup.js

@@ -293,52 +293,17 @@ function tierRank(tier) {
         return -1;
     return TIER_ORDER.indexOf(tier);
 }
-function compareScoreAndTier(a, b) {
+function compareScoredKnowledgeHits(a, b) {
     if (b.score !== a.score)
         return b.score - a.score;
-    return tierRank(b.hit.tier) - tierRank(a.hit.tier);
+    const tierDiff = tierRank(b.hit.tier) - tierRank(a.hit.tier);
+    if (tierDiff !== 0)
+        return tierDiff;
+    return (b.hit.publishedAt ?? 0) - (a.hit.publishedAt ?? 0);
 }
-function compareRef(a, b) {
-    if (a.hit.ref < b.hit.ref)
-        return -1;
-    if (a.hit.ref > b.hit.ref)
-        return 1;
-    return 0;
-}
-/**
- * Return a copied, deterministically ranked scored-candidate list.
- *
- * Recency is a group property, not a pairwise comparator: within each equal
- * score+tier group, use recency only when every hit declares the same domain
- * (including the all-omitted legacy group). A mixed-domain group preserves
- * its stable score/tier input order rather than comparing incomparable
- * recency values or inventing a source priority.
- */
+/** Return a copied, deterministically ranked scored-candidate list. */
 export function rankScoredKnowledgeHits(candidates) {
-    const grouped = [...candidates].sort(compareScoreAndTier);
-    const ranked = [];
-    let start = 0;
-    while (start < grouped.length) {
-        let end = start + 1;
-        while (end < grouped.length
-            && compareScoreAndTier(grouped[start], grouped[end]) === 0) {
-            end += 1;
-        }
-        const tieGroup = grouped.slice(start, end);
-        const recencyDomain = tieGroup[0].hit.recencyDomain;
-        const comparableRecency = tieGroup.every((candidate) => candidate.hit.recencyDomain === recencyDomain);
-        if (comparableRecency) {
-            tieGroup.sort((a, b) => {
-                const recencyDiff = (b.hit.publishedAt ?? 0) - (a.hit.publishedAt ?? 0);
-                if (recencyDiff !== 0)
-                    return recencyDiff;
-                return compareRef(a, b);
-            });
-        }
-        ranked.push(...tieGroup);
-        start = end;
-    }
-    return ranked;
+    return [...candidates].sort(compareScoredKnowledgeHits);
 }
 /**
  * Eligible, deduplicated candidates that have at least one metadata match.
@@ -355,9 +320,8 @@ export function rankKnowledgeCandidates(hits, terms) {
 /**
  * Full ranked candidate pool (rescope §3.3 selection policy): drop skill
  * hits, dedup, score, apply the relevance floor (honest nothing-found below
- * it), rank score desc → tier desc → comparable-domain recency desc (or ref
- * for a mixed-domain tie group) — every candidate that clears the floor, not
- * sliced to `MAX_SELECTED_PACKETS`.
+ * it), rank score desc → tier desc → recency desc — every candidate that
+ * clears the floor, not sliced to `MAX_SELECTED_PACKETS`.
  *
  * Content-level guards that can only run after a candidate's content is
  * fetched (mono #1782: post-fetch skill-payload classification, empty-packet

package/dist/vendor/@jinn-network/plugin/dist/plugin.d.ts

@@ -50,14 +50,10 @@ export interface FirstTurnPickupResult {
     retrievalFired: boolean;
     eligibleRefs: string[];
     deliveredRefs: string[];
-    deliveredCanonicalEpisodeIds: string[];
     deliveryMode: 'delivered' | 'disabled' | 'degraded' | 'withheld';
     deliveredContentHash?: string;
     degraded?: string;
 }
-export interface FirstTurnPickupOptions {
-    excludeCanonicalEpisodeIds?: readonly string[];
-}
 export interface ToolCallEvent {
     spanId: string;
     parentSpanId: string | null;
@@ -140,7 +136,7 @@ export declare class PluginSession {
     private deliveredContentHash;
     private readonly capturedAt;
     constructor(deps: JinnPluginDeps, meta: SessionMeta);
-    firstTurnPickup(firstMessage: string, options?: FirstTurnPickupOptions): Promise<FirstTurnPickupResult>;
+    firstTurnPickup(firstMessage: string): Promise<FirstTurnPickupResult>;
     noteUserTurn(content: string): void;
     noteAssistantTurn(content: string): void;
     private pushTurn;

package/dist/vendor/@jinn-network/plugin/dist/plugin.js

@@ -227,8 +227,7 @@ export class PluginSession {
         this.deps = deps;
         this.meta = meta;
     }
-    async firstTurnPickup(firstMessage, options = {}) {
-        const excludedCanonicalEpisodeIds = new Set(options.excludeCanonicalEpisodeIds ?? []);
+    async firstTurnPickup(firstMessage) {
         const config = parsePickupConfig(this.meta.pickup);
         if (!config.enabled) {
             return {
@@ -238,7 +237,6 @@ export class PluginSession {
                 retrievalFired: false,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: 'disabled',
             };
         }
@@ -259,7 +257,6 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
             };
         }
@@ -286,19 +283,7 @@ export class PluginSession {
                     byRef.set(hit.ref, hit);
             }
         }
-        // Only the production local search adapter exposes this hit-level hint in
-        // this release. Federated search is stable local-then-public, so the first
-        // hit for an identity is the deterministic local form to prefer once a
-        // fetched public record reveals that same identity.
-        const preferredHitByCanonicalEpisodeId = new Map();
-        for (const hit of byRef.values()) {
-            if (hit.canonicalEpisodeId !== undefined
-                && !preferredHitByCanonicalEpisodeId.has(hit.canonicalEpisodeId)) {
-                preferredHitByCanonicalEpisodeId.set(hit.canonicalEpisodeId, hit);
-            }
-        }
-        const candidates = rankKnowledgeCandidates([...byRef.values()].filter((hit) => hit.canonicalEpisodeId === undefined
-            || !excludedCanonicalEpisodeIds.has(hit.canonicalEpisodeId)), scoringTerms);
+        const candidates = rankKnowledgeCandidates([...byRef.values()], scoringTerms);
         if (candidates.length === 0) {
             this.deliveryMode = degradedReason === undefined ? 'withheld' : 'degraded';
             return {
@@ -308,7 +293,6 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
@@ -323,78 +307,25 @@ export class PluginSession {
         // floor and records an honest degraded reason (fail open).
         const fetchedRefs = [];
         const prefetchedByRef = new Map();
-        const fetchRecord = (hit) => {
-            const prefetched = prefetchedByRef.get(hit.ref);
-            if (prefetched !== undefined)
-                return prefetched;
-            fetchedRefs.push(hit.ref);
-            const pending = this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
-            prefetchedByRef.set(hit.ref, pending);
-            return pending;
-        };
-        const resolvePreferredRecord = async (hit, fetchedRecord) => {
-            let selectedHit = hit;
-            let record = fetchedRecord;
-            let preferredFailureReason;
-            const canonicalEpisodeId = record.canonicalEpisodeId;
-            const preferredHit = canonicalEpisodeId === undefined
-                ? undefined
-                : preferredHitByCanonicalEpisodeId.get(canonicalEpisodeId);
-            if (preferredHit !== undefined && preferredHit.ref !== hit.ref) {
-                const preferredResult = await fetchRecord(preferredHit);
-                if (preferredResult.status === 'unavailable') {
-                    preferredFailureReason = preferredResult.reason;
-                }
-                else {
-                    if (preferredResult.status === 'degraded') {
-                        preferredFailureReason = preferredResult.reason;
-                    }
-                    const preferredRecord = valueOr(preferredResult, null);
-                    if (preferredRecord !== null) {
-                        selectedHit = preferredHit;
-                        record = preferredRecord;
-                    }
-                }
-            }
-            return {
-                selectedHit,
-                record,
-                ...(preferredFailureReason !== undefined ? { preferredFailureReason } : {}),
-            };
-        };
         const directCandidates = candidates.filter((candidate) => candidate.score >= RELEVANCE_FLOOR);
         const nearMisses = candidates
             .filter((candidate) => candidate.score < RELEVANCE_FLOOR)
             .slice(0, MAX_CONTENT_RESCORE_CANDIDATES);
-        const nearMissResults = await Promise.all(nearMisses.map(async ({ hit }) => {
-            const result = await fetchRecord(hit);
-            if (result.status === 'unavailable') {
-                return { result, selectedHit: hit, record: null };
-            }
-            const fetchedRecord = valueOr(result, null);
-            if (fetchedRecord === null)
-                return { result, selectedHit: hit, record: null };
-            if (fetchedRecord.canonicalEpisodeId !== undefined
-                && excludedCanonicalEpisodeIds.has(fetchedRecord.canonicalEpisodeId)) {
-                return { result, selectedHit: hit, record: null };
-            }
-            const preferred = await resolvePreferredRecord(hit, fetchedRecord);
-            return { result, ...preferred };
+        const nearMissResults = await Promise.all(nearMisses.map(({ hit }) => {
+            fetchedRefs.push(hit.ref);
+            return this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
         }));
         const promotedCandidates = [];
         for (let index = 0; index < nearMisses.length; index += 1) {
             const candidate = nearMisses[index];
-            const nearMissResult = nearMissResults[index];
-            if (nearMissResult.result.status === 'unavailable') {
+            const result = nearMissResults[index];
+            prefetchedByRef.set(candidate.hit.ref, result);
+            if (result.status !== 'ok') {
                 if (degradedReason === undefined)
-                    degradedReason = nearMissResult.result.reason;
+                    degradedReason = result.reason;
                 continue;
             }
-            if (nearMissResult.result.status === 'degraded') {
-                degradedReason ??= nearMissResult.result.reason;
-            }
-            degradedReason ??= nearMissResult.preferredFailureReason;
-            const record = nearMissResult.record;
+            const record = result.value;
             if (record === null)
                 continue;
             if (record.isSkillPayload === true)
@@ -419,55 +350,40 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
         }
         // Fetch full content for ranked candidates and project packets, walking
         // down the ranked list until MAX_SELECTED_PACKETS valid packets are
-        // found or candidates are exhausted (mono #1782). Post-fetch guards can
-        // disqualify a candidate without spending its slot, promoting the
-        // next-ranked one: (1) canonical exclusion/dedup; (2) content-level
-        // skill classification — which excludes a legacy skill-shaped record
-        // (skill.md step attribute) or a jinn.skill.v1-backed record that slipped
-        // the wire kind filter, exactly as a wire kind:'skill' hit is excluded at
-        // selection time; (3) retrieval-visibility content verification (#1824,
-        // W2) — fail-closed where the other guards are fail-open; (4)
-        // empty-packet honesty — a projection with zero excerpts and no synthesis
-        // is not evidence. A projection failure degrades that one ref to
-        // nothing-found rather than throwing into the caller (§3.5).
+        // found or candidates are exhausted (mono #1782). Three post-fetch
+        // guards can disqualify a candidate without spending its slot, promoting
+        // the next-ranked one: (1) content-level skill classification — excludes
+        // a legacy skill-shaped record (skill.md step attribute) or a
+        // jinn.skill.v1-backed record that slipped the wire kind filter, exactly
+        // as a wire kind:'skill' hit is excluded at selection time; (2)
+        // retrieval-visibility content verification (#1824, W2) — fail-closed
+        // where the other two are fail-open; (3) empty-packet honesty — a
+        // projection with zero excerpts and no synthesis is not evidence. A
+        // projection failure degrades that one ref to nothing-found rather than
+        // throwing into the caller (§3.5).
         const packets = [];
-        const deliveredCanonicalEpisodeIds = [];
-        const deliveredCanonicalSet = new Set();
         for (const hit of ranked) {
             if (packets.length >= MAX_SELECTED_PACKETS)
                 break;
-            const result = await fetchRecord(hit);
-            if (result.status === 'unavailable') {
+            let result = prefetchedByRef.get(hit.ref);
+            if (result === undefined) {
+                fetchedRefs.push(hit.ref);
+                result = await this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
+            }
+            if (result.status !== 'ok') {
                 if (degradedReason === undefined)
                     degradedReason = result.reason;
                 continue;
             }
-            if (result.status === 'degraded')
-                degradedReason ??= result.reason;
-            const fetchedRecord = valueOr(result, null);
-            if (fetchedRecord === null)
-                continue;
-            const fetchedCanonicalEpisodeId = fetchedRecord.canonicalEpisodeId;
-            if (fetchedCanonicalEpisodeId !== undefined
-                && (excludedCanonicalEpisodeIds.has(fetchedCanonicalEpisodeId)
-                    || deliveredCanonicalSet.has(fetchedCanonicalEpisodeId))) {
-                continue;
-            }
-            const { selectedHit, record, preferredFailureReason, } = await resolvePreferredRecord(hit, fetchedRecord);
-            degradedReason ??= preferredFailureReason;
-            const canonicalEpisodeId = record.canonicalEpisodeId;
-            if (canonicalEpisodeId !== undefined
-                && (excludedCanonicalEpisodeIds.has(canonicalEpisodeId)
-                    || deliveredCanonicalSet.has(canonicalEpisodeId))) {
+            const record = result.value;
+            if (record === null)
                 continue;
-            }
             if (record.isSkillPayload === true)
                 continue;
             // Post-fetch content guard (#1824, W2): content is the truth, the
@@ -481,16 +397,12 @@ export class PluginSession {
                 packet = projectKnowledgePacket(record);
             }
             catch (error) {
-                degradedReason ??= `packet projection failed for ${selectedHit.ref}: ${errorReason(error)}`;
+                degradedReason ??= `packet projection failed for ${hit.ref}: ${errorReason(error)}`;
                 continue;
             }
             if (packet.excerpts.length === 0 && packet.synthesis === undefined)
                 continue;
             packets.push(packet);
-            if (canonicalEpisodeId !== undefined) {
-                deliveredCanonicalSet.add(canonicalEpisodeId);
-                deliveredCanonicalEpisodeIds.push(canonicalEpisodeId);
-            }
         }
         this.fetchedRefs = fetchedRefs;
         this.providedRefs = packets.map((packet) => packet.ref);
@@ -505,7 +417,6 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: this.eligibleRefs,
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
@@ -520,7 +431,6 @@ export class PluginSession {
             retrievalFired: true,
             eligibleRefs: this.eligibleRefs,
             deliveredRefs: this.providedRefs,
-            deliveredCanonicalEpisodeIds,
             deliveryMode: this.deliveryMode,
             deliveredContentHash: this.deliveredContentHash,
             ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
@@ -626,7 +536,8 @@ function renderKnowledgePacket(packet) {
     for (const excerpt of packet.excerpts)
         lines.push(`- ${excerpt.label}: ${excerpt.text}`);
     const capturedDate = packet.attribution.capturedAt.slice(0, 10);
-    lines.push(`  source: ${packet.ref} · ${packet.attribution.origin} · captured ${capturedDate}`);
+    lines.push(`  source: ${packet.ref} · ${packet.attribution.origin} · captured ${capturedDate} · `
+        + `full episode: corpus_fetch ${packet.ref}`);
     return lines.join('\n');
 }
 function renderKnowledgePackets(packets) {

package/dist/vendor/@jinn-network/plugin/dist/ports/corpus-port.d.ts

@@ -19,11 +19,6 @@ export interface CorpusRecordStep {
  */
 export interface CorpusRecord {
     ref: string;
-    /**
-     * Canonical EpisodeV1 episodeId, or the legacy trace sessionId used as its
-     * read-compatible identity. Application metadata for deduplication only.
-     */
-    canonicalEpisodeId?: string;
     task: {
         summary: string;
         repositorySlug?: string;

package/dist/vendor/@jinn-network/plugin/dist/schemas/knowledge-hit.d.ts

@@ -2,7 +2,6 @@
 import { z } from 'zod';
 export declare const KnowledgeHitSchema: z.ZodObject<{
     ref: z.ZodString;
-    canonicalEpisodeId: z.ZodOptional<z.ZodString>;
     kind: z.ZodEnum<{
         seed: "seed";
         trace: "trace";
@@ -23,7 +22,6 @@ export declare const KnowledgeHitSchema: z.ZodObject<{
     tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
     origin: z.ZodOptional<z.ZodString>;
     publishedAt: z.ZodOptional<z.ZodNumber>;
-    recencyDomain: z.ZodOptional<z.ZodString>;
     retrievalVisible: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type KnowledgeHit = z.infer<typeof KnowledgeHitSchema>;

package/dist/vendor/@jinn-network/plugin/dist/schemas/knowledge-hit.js

@@ -3,7 +3,6 @@ import { z } from 'zod';
 import { TIER_ORDER } from './pickup-config.js';
 export const KnowledgeHitSchema = z.strictObject({
     ref: z.string().min(1),
-    canonicalEpisodeId: z.string().min(1).optional(),
     kind: z.enum(['seed', 'trace', 'skill']),
     title: z.string().min(1).optional(),
     snippet: z.string().min(1).optional(),
@@ -15,15 +14,8 @@ export const KnowledgeHitSchema = z.strictObject({
     /** Trustworthy content-dedup identity: on-chain agentId when known, otherwise
      *  the record ref. Never a manifest-supplied safeAddress. */
     origin: z.string().min(1).optional(),
-    /** Adapter-native recency value — comparable only within `recencyDomain`. */
+    /** Unix-ms publish time — the selection policy's recency tiebreaker (rescope §3.3). */
     publishedAt: z.number().int().nonnegative().optional(),
-    /**
-     * Adapter-declared comparison domain for `publishedAt` (for example,
-     * `unix-ms` or `block-number`). Recency is comparable only within one
-     * explicit domain. When both hits omit this additive field, ranking keeps
-     * the legacy raw-number behavior.
-     */
-    recencyDomain: z.string().min(1).optional(),
     /** Computed by the adapter from the wire hit's tags (issue #1824) — presence
      *  of RETRIEVAL_VISIBLE_TAG. Absent = treat as not visible (fail-closed at
      *  ranking). */

package/dist/vendor/@jinn-network/plugin/dist/schemas/knowledge-packet.d.ts

@@ -65,12 +65,11 @@ export interface KnowledgePacketBudget {
     maxChars?: number;
 }
 /**
- * Line-boundary-aware truncation ending with a neutral marker. The `ref`
- * parameter remains required for source compatibility with the public helper.
- * Returns an empty string when the budget cannot fit both meaningful source
- * text and the complete tail.
+ * Line-boundary-aware truncation ending with an explicit, pointer-bearing
+ * tail. Returns an empty string when the budget cannot fit both meaningful
+ * source text and the complete tail.
  */
-export declare function truncateLineBoundary(text: string, maxChars: number, _ref: string): string;
+export declare function truncateLineBoundary(text: string, maxChars: number, ref: string): string;
 /**
  * Pure deterministic projection of a `CorpusRecord` into a `KnowledgePacket`
  * (rescope §3.2). Selects and truncates; never paraphrases. Enforces the

package/dist/vendor/@jinn-network/plugin/dist/schemas/knowledge-packet.js

@@ -60,9 +60,6 @@ function stepDiff(step) {
 function stepNote(step) {
     return attrString(step.attributes, 'note') ?? attrString(step.attributes, 'turn.text');
 }
-function isAssistantTurn(step) {
-    return attrString(step.attributes, 'role') === 'assistant';
-}
 const EXCERPT_LABELS = new Set([
     'failure', 'fix', 'command', 'diff', 'note',
 ]);
@@ -93,9 +90,7 @@ function seedStepExcerpt(step) {
  * output, the next command after it that is not itself a failure (the
  * correction), the last passing command overall (the final backstop), and a
  * diff step when present. Falls back to a single free-form note when
- * nothing command-shaped is found, preferring an assistant turn so a
- * conversational episode supplies the retained answer rather than merely
- * repeating the user's prompt. Selects only — never paraphrases.
+ * nothing command-shaped is found. Selects only — never paraphrases.
  */
 function selectExcerpts(steps) {
     const seedExcerpts = steps
@@ -140,23 +135,21 @@ function selectExcerpts(steps) {
     if (diffStep !== undefined)
         excerpts.push({ label: 'diff', text: stepDiff(diffStep) });
     if (excerpts.length === 0) {
-        const noteStep = steps.find((step) => isAssistantTurn(step) && stepNote(step) !== undefined)
-            ?? steps.find((step) => stepNote(step) !== undefined);
+        const noteStep = steps.find((step) => stepNote(step) !== undefined);
         if (noteStep !== undefined)
             excerpts.push({ label: 'note', text: stepNote(noteStep) });
     }
     return excerpts;
 }
 /**
- * Line-boundary-aware truncation ending with a neutral marker. The `ref`
- * parameter remains required for source compatibility with the public helper.
- * Returns an empty string when the budget cannot fit both meaningful source
- * text and the complete tail.
+ * Line-boundary-aware truncation ending with an explicit, pointer-bearing
+ * tail. Returns an empty string when the budget cannot fit both meaningful
+ * source text and the complete tail.
  */
-export function truncateLineBoundary(text, maxChars, _ref) {
+export function truncateLineBoundary(text, maxChars, ref) {
     if (text.length <= maxChars)
         return text;
-    const tail = '\n[truncated]';
+    const tail = `\n[truncated — full episode: corpus_fetch ${ref}]`;
     const budget = maxChars - tail.length;
     if (budget <= 0)
         return '';

package/dist/vendor/@jinn-network/plugin/dist/testing/in-memory-corpus.d.ts

@@ -6,7 +6,7 @@ import type { KnowledgeHit } from '../schemas/knowledge-hit.js';
  * search would return for it (kind/title/tier/payloadKind/publishedAt — the
  * fields not derivable from `CorpusRecord` alone).
  */
-export type InMemoryCorpusSeed = CorpusRecord & Pick<KnowledgeHit, 'kind'> & Partial<Pick<KnowledgeHit, 'title' | 'tier' | 'payloadKind' | 'publishedAt' | 'recencyDomain'>>;
+export type InMemoryCorpusSeed = CorpusRecord & Pick<KnowledgeHit, 'kind'> & Partial<Pick<KnowledgeHit, 'title' | 'tier' | 'payloadKind' | 'publishedAt'>>;
 /** Map/array-backed, seedable — architecture spec §8. Seeds carry full
  *  content (`CorpusRecord`) so `get()` can return it directly; `search()`
  *  derives the lightweight `KnowledgeHit` view. */
@@ -17,7 +17,6 @@ export declare class InMemoryCorpusPort implements CorpusPort {
         ref: string;
         kind: "seed" | "trace" | "skill";
         tags: string[];
-        canonicalEpisodeId?: string | undefined;
         title?: string | undefined;
         snippet?: string | undefined;
         score?: number | undefined;
@@ -25,7 +24,6 @@ export declare class InMemoryCorpusPort implements CorpusPort {
         payloadKind?: "unknown" | "skill" | undefined;
         origin?: string | undefined;
         publishedAt?: number | undefined;
-        recencyDomain?: string | undefined;
         retrievalVisible?: boolean | undefined;
     }[]>>;
     get(ref: string): Promise<{

package/dist/vendor/@jinn-network/plugin/dist/testing/in-memory-corpus.js

@@ -2,9 +2,6 @@ import { ok } from '../outcome.js';
 function toKnowledgeHit(seed) {
     return {
         ref: seed.ref,
-        ...(seed.canonicalEpisodeId !== undefined
-            ? { canonicalEpisodeId: seed.canonicalEpisodeId }
-            : {}),
         kind: seed.kind,
         ...(seed.title !== undefined ? { title: seed.title } : {}),
         snippet: seed.task.summary,
@@ -13,7 +10,6 @@ function toKnowledgeHit(seed) {
         tags: seed.tags,
         origin: seed.origin,
         ...(seed.publishedAt !== undefined ? { publishedAt: seed.publishedAt } : {}),
-        ...(seed.recencyDomain !== undefined ? { recencyDomain: seed.recencyDomain } : {}),
         retrievalVisible: seed.retrievalVisible,
     };
 }
@@ -52,7 +48,7 @@ export class InMemoryCorpusPort {
         if (!record)
             return ok(null);
         // Strip the KnowledgeHit-only fields — get() returns the CorpusRecord shape.
-        const { kind: _kind, title: _title, tier: _tier, payloadKind: _payloadKind, publishedAt: _publishedAt, recencyDomain: _recencyDomain, ...corpusRecord } = record;
+        const { kind: _kind, title: _title, tier: _tier, payloadKind: _payloadKind, publishedAt: _publishedAt, ...corpusRecord } = record;
         return ok(corpusRecord);
     }
 }

package/dist/vendor/@jinn-network/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinn-network/plugin",
-  "version": "0.1.1",
+  "version": "0.1.0",
   "description": "Product core for the Jinn Plugin — ports, product schemas, and the createJinnPlugin factory. Stage 1 foundation package (contracts + in-memory kit only).",
   "type": "module",
   "license": "MIT",

package/node_modules/@jinn-network/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinn-network/core",
-  "version": "0.1.1",
+  "version": "0.1.0",
   "description": "Domain core for Jinn — evidence/contribution stores, scrub, trajectory parsing, and corpus reads. Independent of client/src.",
   "type": "module",
   "packageManager": "yarn@4.13.0",

package/node_modules/@jinn-network/plugin/dist/index.d.ts

@@ -19,7 +19,7 @@ export type { ContributionPort, ContributionLedgerEntry, ContributionLocalState,
 export type { LocalLearningPort, LocalLearningRun, LocalLearningSkill, } from './ports/local-learning-port.js';
 export type { SkillsPort, SkillRecord } from './ports/skills-port.js';
 export { createJinnPlugin, JINN_PLUGIN_CONTRACT_VERSION, PluginSession } from './plugin.js';
-export type { CompleteSessionEligibilityInputs, CompleteSessionInput, JinnPlugin, JinnPluginDeps, SessionMeta, FirstTurnPickupOptions, FirstTurnPickupResult, ToolCallEvent, SessionOutcome, SessionEndResult, ContributionCompletionReceipt, ContributionPreview, } from './plugin.js';
+export type { CompleteSessionEligibilityInputs, CompleteSessionInput, JinnPlugin, JinnPluginDeps, SessionMeta, FirstTurnPickupResult, ToolCallEvent, SessionOutcome, SessionEndResult, ContributionCompletionReceipt, ContributionPreview, } from './plugin.js';
 export { PickupConfigSchema, DEFAULT_PICKUP_CONFIG, parsePickupConfig, TIER_ORDER } from './schemas/pickup-config.js';
 export type { PickupConfig, Tier } from './schemas/pickup-config.js';
 export { deriveRepositorySearchTerms, discriminatingTerms, deriveSearchTerms, classifyPayload, dedupeKnowledgeHits, scoreKnowledgeHit, selectKnowledgeHits, rankKnowledgeHits, MAX_SELECTED_PACKETS, } from './pickup.js';

package/node_modules/@jinn-network/plugin/dist/pickup.d.ts

@@ -62,15 +62,7 @@ export declare function scoreKnowledgeHit(hit: KnowledgeHit, terms: string[]): n
  * cannot manufacture relevance.
  */
 export declare function scoreKnowledgeRecord(hit: KnowledgeHit, record: CorpusRecord, terms: string[]): number;
-/**
- * Return a copied, deterministically ranked scored-candidate list.
- *
- * Recency is a group property, not a pairwise comparator: within each equal
- * score+tier group, use recency only when every hit declares the same domain
- * (including the all-omitted legacy group). A mixed-domain group preserves
- * its stable score/tier input order rather than comparing incomparable
- * recency values or inventing a source priority.
- */
+/** Return a copied, deterministically ranked scored-candidate list. */
 export declare function rankScoredKnowledgeHits(candidates: ScoredKnowledgeHit[]): ScoredKnowledgeHit[];
 /**
  * Eligible, deduplicated candidates that have at least one metadata match.
@@ -81,9 +73,8 @@ export declare function rankKnowledgeCandidates(hits: KnowledgeHit[], terms: str
 /**
  * Full ranked candidate pool (rescope §3.3 selection policy): drop skill
  * hits, dedup, score, apply the relevance floor (honest nothing-found below
- * it), rank score desc → tier desc → comparable-domain recency desc (or ref
- * for a mixed-domain tie group) — every candidate that clears the floor, not
- * sliced to `MAX_SELECTED_PACKETS`.
+ * it), rank score desc → tier desc → recency desc — every candidate that
+ * clears the floor, not sliced to `MAX_SELECTED_PACKETS`.
  *
  * Content-level guards that can only run after a candidate's content is
  * fetched (mono #1782: post-fetch skill-payload classification, empty-packet

package/node_modules/@jinn-network/plugin/dist/pickup.js

@@ -293,52 +293,17 @@ function tierRank(tier) {
         return -1;
     return TIER_ORDER.indexOf(tier);
 }
-function compareScoreAndTier(a, b) {
+function compareScoredKnowledgeHits(a, b) {
     if (b.score !== a.score)
         return b.score - a.score;
-    return tierRank(b.hit.tier) - tierRank(a.hit.tier);
+    const tierDiff = tierRank(b.hit.tier) - tierRank(a.hit.tier);
+    if (tierDiff !== 0)
+        return tierDiff;
+    return (b.hit.publishedAt ?? 0) - (a.hit.publishedAt ?? 0);
 }
-function compareRef(a, b) {
-    if (a.hit.ref < b.hit.ref)
-        return -1;
-    if (a.hit.ref > b.hit.ref)
-        return 1;
-    return 0;
-}
-/**
- * Return a copied, deterministically ranked scored-candidate list.
- *
- * Recency is a group property, not a pairwise comparator: within each equal
- * score+tier group, use recency only when every hit declares the same domain
- * (including the all-omitted legacy group). A mixed-domain group preserves
- * its stable score/tier input order rather than comparing incomparable
- * recency values or inventing a source priority.
- */
+/** Return a copied, deterministically ranked scored-candidate list. */
 export function rankScoredKnowledgeHits(candidates) {
-    const grouped = [...candidates].sort(compareScoreAndTier);
-    const ranked = [];
-    let start = 0;
-    while (start < grouped.length) {
-        let end = start + 1;
-        while (end < grouped.length
-            && compareScoreAndTier(grouped[start], grouped[end]) === 0) {
-            end += 1;
-        }
-        const tieGroup = grouped.slice(start, end);
-        const recencyDomain = tieGroup[0].hit.recencyDomain;
-        const comparableRecency = tieGroup.every((candidate) => candidate.hit.recencyDomain === recencyDomain);
-        if (comparableRecency) {
-            tieGroup.sort((a, b) => {
-                const recencyDiff = (b.hit.publishedAt ?? 0) - (a.hit.publishedAt ?? 0);
-                if (recencyDiff !== 0)
-                    return recencyDiff;
-                return compareRef(a, b);
-            });
-        }
-        ranked.push(...tieGroup);
-        start = end;
-    }
-    return ranked;
+    return [...candidates].sort(compareScoredKnowledgeHits);
 }
 /**
  * Eligible, deduplicated candidates that have at least one metadata match.
@@ -355,9 +320,8 @@ export function rankKnowledgeCandidates(hits, terms) {
 /**
  * Full ranked candidate pool (rescope §3.3 selection policy): drop skill
  * hits, dedup, score, apply the relevance floor (honest nothing-found below
- * it), rank score desc → tier desc → comparable-domain recency desc (or ref
- * for a mixed-domain tie group) — every candidate that clears the floor, not
- * sliced to `MAX_SELECTED_PACKETS`.
+ * it), rank score desc → tier desc → recency desc — every candidate that
+ * clears the floor, not sliced to `MAX_SELECTED_PACKETS`.
  *
  * Content-level guards that can only run after a candidate's content is
  * fetched (mono #1782: post-fetch skill-payload classification, empty-packet

package/node_modules/@jinn-network/plugin/dist/plugin.d.ts

@@ -50,14 +50,10 @@ export interface FirstTurnPickupResult {
     retrievalFired: boolean;
     eligibleRefs: string[];
     deliveredRefs: string[];
-    deliveredCanonicalEpisodeIds: string[];
     deliveryMode: 'delivered' | 'disabled' | 'degraded' | 'withheld';
     deliveredContentHash?: string;
     degraded?: string;
 }
-export interface FirstTurnPickupOptions {
-    excludeCanonicalEpisodeIds?: readonly string[];
-}
 export interface ToolCallEvent {
     spanId: string;
     parentSpanId: string | null;
@@ -140,7 +136,7 @@ export declare class PluginSession {
     private deliveredContentHash;
     private readonly capturedAt;
     constructor(deps: JinnPluginDeps, meta: SessionMeta);
-    firstTurnPickup(firstMessage: string, options?: FirstTurnPickupOptions): Promise<FirstTurnPickupResult>;
+    firstTurnPickup(firstMessage: string): Promise<FirstTurnPickupResult>;
     noteUserTurn(content: string): void;
     noteAssistantTurn(content: string): void;
     private pushTurn;

package/node_modules/@jinn-network/plugin/dist/plugin.js

@@ -227,8 +227,7 @@ export class PluginSession {
         this.deps = deps;
         this.meta = meta;
     }
-    async firstTurnPickup(firstMessage, options = {}) {
-        const excludedCanonicalEpisodeIds = new Set(options.excludeCanonicalEpisodeIds ?? []);
+    async firstTurnPickup(firstMessage) {
         const config = parsePickupConfig(this.meta.pickup);
         if (!config.enabled) {
             return {
@@ -238,7 +237,6 @@ export class PluginSession {
                 retrievalFired: false,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: 'disabled',
             };
         }
@@ -259,7 +257,6 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
             };
         }
@@ -286,19 +283,7 @@ export class PluginSession {
                     byRef.set(hit.ref, hit);
             }
         }
-        // Only the production local search adapter exposes this hit-level hint in
-        // this release. Federated search is stable local-then-public, so the first
-        // hit for an identity is the deterministic local form to prefer once a
-        // fetched public record reveals that same identity.
-        const preferredHitByCanonicalEpisodeId = new Map();
-        for (const hit of byRef.values()) {
-            if (hit.canonicalEpisodeId !== undefined
-                && !preferredHitByCanonicalEpisodeId.has(hit.canonicalEpisodeId)) {
-                preferredHitByCanonicalEpisodeId.set(hit.canonicalEpisodeId, hit);
-            }
-        }
-        const candidates = rankKnowledgeCandidates([...byRef.values()].filter((hit) => hit.canonicalEpisodeId === undefined
-            || !excludedCanonicalEpisodeIds.has(hit.canonicalEpisodeId)), scoringTerms);
+        const candidates = rankKnowledgeCandidates([...byRef.values()], scoringTerms);
         if (candidates.length === 0) {
             this.deliveryMode = degradedReason === undefined ? 'withheld' : 'degraded';
             return {
@@ -308,7 +293,6 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
@@ -323,78 +307,25 @@ export class PluginSession {
         // floor and records an honest degraded reason (fail open).
         const fetchedRefs = [];
         const prefetchedByRef = new Map();
-        const fetchRecord = (hit) => {
-            const prefetched = prefetchedByRef.get(hit.ref);
-            if (prefetched !== undefined)
-                return prefetched;
-            fetchedRefs.push(hit.ref);
-            const pending = this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
-            prefetchedByRef.set(hit.ref, pending);
-            return pending;
-        };
-        const resolvePreferredRecord = async (hit, fetchedRecord) => {
-            let selectedHit = hit;
-            let record = fetchedRecord;
-            let preferredFailureReason;
-            const canonicalEpisodeId = record.canonicalEpisodeId;
-            const preferredHit = canonicalEpisodeId === undefined
-                ? undefined
-                : preferredHitByCanonicalEpisodeId.get(canonicalEpisodeId);
-            if (preferredHit !== undefined && preferredHit.ref !== hit.ref) {
-                const preferredResult = await fetchRecord(preferredHit);
-                if (preferredResult.status === 'unavailable') {
-                    preferredFailureReason = preferredResult.reason;
-                }
-                else {
-                    if (preferredResult.status === 'degraded') {
-                        preferredFailureReason = preferredResult.reason;
-                    }
-                    const preferredRecord = valueOr(preferredResult, null);
-                    if (preferredRecord !== null) {
-                        selectedHit = preferredHit;
-                        record = preferredRecord;
-                    }
-                }
-            }
-            return {
-                selectedHit,
-                record,
-                ...(preferredFailureReason !== undefined ? { preferredFailureReason } : {}),
-            };
-        };
         const directCandidates = candidates.filter((candidate) => candidate.score >= RELEVANCE_FLOOR);
         const nearMisses = candidates
             .filter((candidate) => candidate.score < RELEVANCE_FLOOR)
             .slice(0, MAX_CONTENT_RESCORE_CANDIDATES);
-        const nearMissResults = await Promise.all(nearMisses.map(async ({ hit }) => {
-            const result = await fetchRecord(hit);
-            if (result.status === 'unavailable') {
-                return { result, selectedHit: hit, record: null };
-            }
-            const fetchedRecord = valueOr(result, null);
-            if (fetchedRecord === null)
-                return { result, selectedHit: hit, record: null };
-            if (fetchedRecord.canonicalEpisodeId !== undefined
-                && excludedCanonicalEpisodeIds.has(fetchedRecord.canonicalEpisodeId)) {
-                return { result, selectedHit: hit, record: null };
-            }
-            const preferred = await resolvePreferredRecord(hit, fetchedRecord);
-            return { result, ...preferred };
+        const nearMissResults = await Promise.all(nearMisses.map(({ hit }) => {
+            fetchedRefs.push(hit.ref);
+            return this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
         }));
         const promotedCandidates = [];
         for (let index = 0; index < nearMisses.length; index += 1) {
             const candidate = nearMisses[index];
-            const nearMissResult = nearMissResults[index];
-            if (nearMissResult.result.status === 'unavailable') {
+            const result = nearMissResults[index];
+            prefetchedByRef.set(candidate.hit.ref, result);
+            if (result.status !== 'ok') {
                 if (degradedReason === undefined)
-                    degradedReason = nearMissResult.result.reason;
+                    degradedReason = result.reason;
                 continue;
             }
-            if (nearMissResult.result.status === 'degraded') {
-                degradedReason ??= nearMissResult.result.reason;
-            }
-            degradedReason ??= nearMissResult.preferredFailureReason;
-            const record = nearMissResult.record;
+            const record = result.value;
             if (record === null)
                 continue;
             if (record.isSkillPayload === true)
@@ -419,55 +350,40 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
         }
         // Fetch full content for ranked candidates and project packets, walking
         // down the ranked list until MAX_SELECTED_PACKETS valid packets are
-        // found or candidates are exhausted (mono #1782). Post-fetch guards can
-        // disqualify a candidate without spending its slot, promoting the
-        // next-ranked one: (1) canonical exclusion/dedup; (2) content-level
-        // skill classification — which excludes a legacy skill-shaped record
-        // (skill.md step attribute) or a jinn.skill.v1-backed record that slipped
-        // the wire kind filter, exactly as a wire kind:'skill' hit is excluded at
-        // selection time; (3) retrieval-visibility content verification (#1824,
-        // W2) — fail-closed where the other guards are fail-open; (4)
-        // empty-packet honesty — a projection with zero excerpts and no synthesis
-        // is not evidence. A projection failure degrades that one ref to
-        // nothing-found rather than throwing into the caller (§3.5).
+        // found or candidates are exhausted (mono #1782). Three post-fetch
+        // guards can disqualify a candidate without spending its slot, promoting
+        // the next-ranked one: (1) content-level skill classification — excludes
+        // a legacy skill-shaped record (skill.md step attribute) or a
+        // jinn.skill.v1-backed record that slipped the wire kind filter, exactly
+        // as a wire kind:'skill' hit is excluded at selection time; (2)
+        // retrieval-visibility content verification (#1824, W2) — fail-closed
+        // where the other two are fail-open; (3) empty-packet honesty — a
+        // projection with zero excerpts and no synthesis is not evidence. A
+        // projection failure degrades that one ref to nothing-found rather than
+        // throwing into the caller (§3.5).
         const packets = [];
-        const deliveredCanonicalEpisodeIds = [];
-        const deliveredCanonicalSet = new Set();
         for (const hit of ranked) {
             if (packets.length >= MAX_SELECTED_PACKETS)
                 break;
-            const result = await fetchRecord(hit);
-            if (result.status === 'unavailable') {
+            let result = prefetchedByRef.get(hit.ref);
+            if (result === undefined) {
+                fetchedRefs.push(hit.ref);
+                result = await this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
+            }
+            if (result.status !== 'ok') {
                 if (degradedReason === undefined)
                     degradedReason = result.reason;
                 continue;
             }
-            if (result.status === 'degraded')
-                degradedReason ??= result.reason;
-            const fetchedRecord = valueOr(result, null);
-            if (fetchedRecord === null)
-                continue;
-            const fetchedCanonicalEpisodeId = fetchedRecord.canonicalEpisodeId;
-            if (fetchedCanonicalEpisodeId !== undefined
-                && (excludedCanonicalEpisodeIds.has(fetchedCanonicalEpisodeId)
-                    || deliveredCanonicalSet.has(fetchedCanonicalEpisodeId))) {
-                continue;
-            }
-            const { selectedHit, record, preferredFailureReason, } = await resolvePreferredRecord(hit, fetchedRecord);
-            degradedReason ??= preferredFailureReason;
-            const canonicalEpisodeId = record.canonicalEpisodeId;
-            if (canonicalEpisodeId !== undefined
-                && (excludedCanonicalEpisodeIds.has(canonicalEpisodeId)
-                    || deliveredCanonicalSet.has(canonicalEpisodeId))) {
+            const record = result.value;
+            if (record === null)
                 continue;
-            }
             if (record.isSkillPayload === true)
                 continue;
             // Post-fetch content guard (#1824, W2): content is the truth, the
@@ -481,16 +397,12 @@ export class PluginSession {
                 packet = projectKnowledgePacket(record);
             }
             catch (error) {
-                degradedReason ??= `packet projection failed for ${selectedHit.ref}: ${errorReason(error)}`;
+                degradedReason ??= `packet projection failed for ${hit.ref}: ${errorReason(error)}`;
                 continue;
             }
             if (packet.excerpts.length === 0 && packet.synthesis === undefined)
                 continue;
             packets.push(packet);
-            if (canonicalEpisodeId !== undefined) {
-                deliveredCanonicalSet.add(canonicalEpisodeId);
-                deliveredCanonicalEpisodeIds.push(canonicalEpisodeId);
-            }
         }
         this.fetchedRefs = fetchedRefs;
         this.providedRefs = packets.map((packet) => packet.ref);
@@ -505,7 +417,6 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: this.eligibleRefs,
                 deliveredRefs: [],
-                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
@@ -520,7 +431,6 @@ export class PluginSession {
             retrievalFired: true,
             eligibleRefs: this.eligibleRefs,
             deliveredRefs: this.providedRefs,
-            deliveredCanonicalEpisodeIds,
             deliveryMode: this.deliveryMode,
             deliveredContentHash: this.deliveredContentHash,
             ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
@@ -626,7 +536,8 @@ function renderKnowledgePacket(packet) {
     for (const excerpt of packet.excerpts)
         lines.push(`- ${excerpt.label}: ${excerpt.text}`);
     const capturedDate = packet.attribution.capturedAt.slice(0, 10);
-    lines.push(`  source: ${packet.ref} · ${packet.attribution.origin} · captured ${capturedDate}`);
+    lines.push(`  source: ${packet.ref} · ${packet.attribution.origin} · captured ${capturedDate} · `
+        + `full episode: corpus_fetch ${packet.ref}`);
     return lines.join('\n');
 }
 function renderKnowledgePackets(packets) {

package/node_modules/@jinn-network/plugin/dist/ports/corpus-port.d.ts

@@ -19,11 +19,6 @@ export interface CorpusRecordStep {
  */
 export interface CorpusRecord {
     ref: string;
-    /**
-     * Canonical EpisodeV1 episodeId, or the legacy trace sessionId used as its
-     * read-compatible identity. Application metadata for deduplication only.
-     */
-    canonicalEpisodeId?: string;
     task: {
         summary: string;
         repositorySlug?: string;

package/node_modules/@jinn-network/plugin/dist/schemas/knowledge-hit.d.ts

@@ -2,7 +2,6 @@
 import { z } from 'zod';
 export declare const KnowledgeHitSchema: z.ZodObject<{
     ref: z.ZodString;
-    canonicalEpisodeId: z.ZodOptional<z.ZodString>;
     kind: z.ZodEnum<{
         seed: "seed";
         trace: "trace";
@@ -23,7 +22,6 @@ export declare const KnowledgeHitSchema: z.ZodObject<{
     tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
     origin: z.ZodOptional<z.ZodString>;
     publishedAt: z.ZodOptional<z.ZodNumber>;
-    recencyDomain: z.ZodOptional<z.ZodString>;
     retrievalVisible: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type KnowledgeHit = z.infer<typeof KnowledgeHitSchema>;

package/node_modules/@jinn-network/plugin/dist/schemas/knowledge-hit.js

@@ -3,7 +3,6 @@ import { z } from 'zod';
 import { TIER_ORDER } from './pickup-config.js';
 export const KnowledgeHitSchema = z.strictObject({
     ref: z.string().min(1),
-    canonicalEpisodeId: z.string().min(1).optional(),
     kind: z.enum(['seed', 'trace', 'skill']),
     title: z.string().min(1).optional(),
     snippet: z.string().min(1).optional(),
@@ -15,15 +14,8 @@ export const KnowledgeHitSchema = z.strictObject({
     /** Trustworthy content-dedup identity: on-chain agentId when known, otherwise
      *  the record ref. Never a manifest-supplied safeAddress. */
     origin: z.string().min(1).optional(),
-    /** Adapter-native recency value — comparable only within `recencyDomain`. */
+    /** Unix-ms publish time — the selection policy's recency tiebreaker (rescope §3.3). */
     publishedAt: z.number().int().nonnegative().optional(),
-    /**
-     * Adapter-declared comparison domain for `publishedAt` (for example,
-     * `unix-ms` or `block-number`). Recency is comparable only within one
-     * explicit domain. When both hits omit this additive field, ranking keeps
-     * the legacy raw-number behavior.
-     */
-    recencyDomain: z.string().min(1).optional(),
     /** Computed by the adapter from the wire hit's tags (issue #1824) — presence
      *  of RETRIEVAL_VISIBLE_TAG. Absent = treat as not visible (fail-closed at
      *  ranking). */

package/node_modules/@jinn-network/plugin/dist/schemas/knowledge-packet.d.ts

@@ -65,12 +65,11 @@ export interface KnowledgePacketBudget {
     maxChars?: number;
 }
 /**
- * Line-boundary-aware truncation ending with a neutral marker. The `ref`
- * parameter remains required for source compatibility with the public helper.
- * Returns an empty string when the budget cannot fit both meaningful source
- * text and the complete tail.
+ * Line-boundary-aware truncation ending with an explicit, pointer-bearing
+ * tail. Returns an empty string when the budget cannot fit both meaningful
+ * source text and the complete tail.
  */
-export declare function truncateLineBoundary(text: string, maxChars: number, _ref: string): string;
+export declare function truncateLineBoundary(text: string, maxChars: number, ref: string): string;
 /**
  * Pure deterministic projection of a `CorpusRecord` into a `KnowledgePacket`
  * (rescope §3.2). Selects and truncates; never paraphrases. Enforces the

package/node_modules/@jinn-network/plugin/dist/schemas/knowledge-packet.js

@@ -60,9 +60,6 @@ function stepDiff(step) {
 function stepNote(step) {
     return attrString(step.attributes, 'note') ?? attrString(step.attributes, 'turn.text');
 }
-function isAssistantTurn(step) {
-    return attrString(step.attributes, 'role') === 'assistant';
-}
 const EXCERPT_LABELS = new Set([
     'failure', 'fix', 'command', 'diff', 'note',
 ]);
@@ -93,9 +90,7 @@ function seedStepExcerpt(step) {
  * output, the next command after it that is not itself a failure (the
  * correction), the last passing command overall (the final backstop), and a
  * diff step when present. Falls back to a single free-form note when
- * nothing command-shaped is found, preferring an assistant turn so a
- * conversational episode supplies the retained answer rather than merely
- * repeating the user's prompt. Selects only — never paraphrases.
+ * nothing command-shaped is found. Selects only — never paraphrases.
  */
 function selectExcerpts(steps) {
     const seedExcerpts = steps
@@ -140,23 +135,21 @@ function selectExcerpts(steps) {
     if (diffStep !== undefined)
         excerpts.push({ label: 'diff', text: stepDiff(diffStep) });
     if (excerpts.length === 0) {
-        const noteStep = steps.find((step) => isAssistantTurn(step) && stepNote(step) !== undefined)
-            ?? steps.find((step) => stepNote(step) !== undefined);
+        const noteStep = steps.find((step) => stepNote(step) !== undefined);
         if (noteStep !== undefined)
             excerpts.push({ label: 'note', text: stepNote(noteStep) });
     }
     return excerpts;
 }
 /**
- * Line-boundary-aware truncation ending with a neutral marker. The `ref`
- * parameter remains required for source compatibility with the public helper.
- * Returns an empty string when the budget cannot fit both meaningful source
- * text and the complete tail.
+ * Line-boundary-aware truncation ending with an explicit, pointer-bearing
+ * tail. Returns an empty string when the budget cannot fit both meaningful
+ * source text and the complete tail.
  */
-export function truncateLineBoundary(text, maxChars, _ref) {
+export function truncateLineBoundary(text, maxChars, ref) {
     if (text.length <= maxChars)
         return text;
-    const tail = '\n[truncated]';
+    const tail = `\n[truncated — full episode: corpus_fetch ${ref}]`;
     const budget = maxChars - tail.length;
     if (budget <= 0)
         return '';

package/node_modules/@jinn-network/plugin/dist/testing/in-memory-corpus.d.ts

@@ -6,7 +6,7 @@ import type { KnowledgeHit } from '../schemas/knowledge-hit.js';
  * search would return for it (kind/title/tier/payloadKind/publishedAt — the
  * fields not derivable from `CorpusRecord` alone).
  */
-export type InMemoryCorpusSeed = CorpusRecord & Pick<KnowledgeHit, 'kind'> & Partial<Pick<KnowledgeHit, 'title' | 'tier' | 'payloadKind' | 'publishedAt' | 'recencyDomain'>>;
+export type InMemoryCorpusSeed = CorpusRecord & Pick<KnowledgeHit, 'kind'> & Partial<Pick<KnowledgeHit, 'title' | 'tier' | 'payloadKind' | 'publishedAt'>>;
 /** Map/array-backed, seedable — architecture spec §8. Seeds carry full
  *  content (`CorpusRecord`) so `get()` can return it directly; `search()`
  *  derives the lightweight `KnowledgeHit` view. */
@@ -17,7 +17,6 @@ export declare class InMemoryCorpusPort implements CorpusPort {
         ref: string;
         kind: "seed" | "trace" | "skill";
         tags: string[];
-        canonicalEpisodeId?: string | undefined;
         title?: string | undefined;
         snippet?: string | undefined;
         score?: number | undefined;
@@ -25,7 +24,6 @@ export declare class InMemoryCorpusPort implements CorpusPort {
         payloadKind?: "unknown" | "skill" | undefined;
         origin?: string | undefined;
         publishedAt?: number | undefined;
-        recencyDomain?: string | undefined;
         retrievalVisible?: boolean | undefined;
     }[]>>;
     get(ref: string): Promise<{

package/node_modules/@jinn-network/plugin/dist/testing/in-memory-corpus.js

@@ -2,9 +2,6 @@ import { ok } from '../outcome.js';
 function toKnowledgeHit(seed) {
     return {
         ref: seed.ref,
-        ...(seed.canonicalEpisodeId !== undefined
-            ? { canonicalEpisodeId: seed.canonicalEpisodeId }
-            : {}),
         kind: seed.kind,
         ...(seed.title !== undefined ? { title: seed.title } : {}),
         snippet: seed.task.summary,
@@ -13,7 +10,6 @@ function toKnowledgeHit(seed) {
         tags: seed.tags,
         origin: seed.origin,
         ...(seed.publishedAt !== undefined ? { publishedAt: seed.publishedAt } : {}),
-        ...(seed.recencyDomain !== undefined ? { recencyDomain: seed.recencyDomain } : {}),
         retrievalVisible: seed.retrievalVisible,
     };
 }
@@ -52,7 +48,7 @@ export class InMemoryCorpusPort {
         if (!record)
             return ok(null);
         // Strip the KnowledgeHit-only fields — get() returns the CorpusRecord shape.
-        const { kind: _kind, title: _title, tier: _tier, payloadKind: _payloadKind, publishedAt: _publishedAt, recencyDomain: _recencyDomain, ...corpusRecord } = record;
+        const { kind: _kind, title: _title, tier: _tier, payloadKind: _payloadKind, publishedAt: _publishedAt, ...corpusRecord } = record;
         return ok(corpusRecord);
     }
 }

package/node_modules/@jinn-network/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinn-network/plugin",
-  "version": "0.1.1",
+  "version": "0.1.0",
   "description": "Product core for the Jinn Plugin — ports, product schemas, and the createJinnPlugin factory. Stage 1 foundation package (contracts + in-memory kit only).",
   "type": "module",
   "packageManager": "yarn@4.13.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinn-network/client",
-  "version": "0.2.0-canary.0b79cd5d",
+  "version": "0.2.0-canary.31247316",
   "description": "Jinn protocol client — headless daemon for the restoration training loop",
   "type": "module",
   "packageManager": "yarn@4.13.0",