@jinn-network/plugin 0.1.0 → 0.1.1-canary.25281242

package/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, FirstTurnPickupResult, ToolCallEvent, SessionOutcome, SessionEndResult, ContributionCompletionReceipt, ContributionPreview, } from './plugin.js';
+export type { CompleteSessionEligibilityInputs, CompleteSessionInput, JinnPlugin, JinnPluginDeps, SessionMeta, FirstTurnPickupOptions, 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/pickup.d.ts

@@ -62,7 +62,15 @@ 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. */
+/**
+ * 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.
+ */
 export declare function rankScoredKnowledgeHits(candidates: ScoredKnowledgeHit[]): ScoredKnowledgeHit[];
 /**
  * Eligible, deduplicated candidates that have at least one metadata match.
@@ -73,8 +81,9 @@ 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 → recency desc — every candidate that
- * clears the floor, not sliced to `MAX_SELECTED_PACKETS`.
+ * 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`.
  *
  * 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/pickup.js

@@ -293,17 +293,52 @@ function tierRank(tier) {
         return -1;
     return TIER_ORDER.indexOf(tier);
 }
-function compareScoredKnowledgeHits(a, b) {
+function compareScoreAndTier(a, b) {
     if (b.score !== a.score)
         return b.score - a.score;
-    const tierDiff = tierRank(b.hit.tier) - tierRank(a.hit.tier);
-    if (tierDiff !== 0)
-        return tierDiff;
-    return (b.hit.publishedAt ?? 0) - (a.hit.publishedAt ?? 0);
+    return tierRank(b.hit.tier) - tierRank(a.hit.tier);
 }
-/** Return a copied, deterministically ranked scored-candidate list. */
+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.
+ */
 export function rankScoredKnowledgeHits(candidates) {
-    return [...candidates].sort(compareScoredKnowledgeHits);
+    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;
 }
 /**
  * Eligible, deduplicated candidates that have at least one metadata match.
@@ -320,8 +355,9 @@ 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 → recency desc — every candidate that
- * clears the floor, not sliced to `MAX_SELECTED_PACKETS`.
+ * 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`.
  *
  * 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/plugin.d.ts

@@ -50,10 +50,14 @@ 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;
@@ -136,7 +140,7 @@ export declare class PluginSession {
     private deliveredContentHash;
     private readonly capturedAt;
     constructor(deps: JinnPluginDeps, meta: SessionMeta);
-    firstTurnPickup(firstMessage: string): Promise<FirstTurnPickupResult>;
+    firstTurnPickup(firstMessage: string, options?: FirstTurnPickupOptions): Promise<FirstTurnPickupResult>;
     noteUserTurn(content: string): void;
     noteAssistantTurn(content: string): void;
     private pushTurn;

package/dist/plugin.js

@@ -227,7 +227,8 @@ export class PluginSession {
         this.deps = deps;
         this.meta = meta;
     }
-    async firstTurnPickup(firstMessage) {
+    async firstTurnPickup(firstMessage, options = {}) {
+        const excludedCanonicalEpisodeIds = new Set(options.excludeCanonicalEpisodeIds ?? []);
         const config = parsePickupConfig(this.meta.pickup);
         if (!config.enabled) {
             return {
@@ -237,6 +238,7 @@ export class PluginSession {
                 retrievalFired: false,
                 eligibleRefs: [],
                 deliveredRefs: [],
+                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: 'disabled',
             };
         }
@@ -257,6 +259,7 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
+                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
             };
         }
@@ -283,7 +286,19 @@ export class PluginSession {
                     byRef.set(hit.ref, hit);
             }
         }
-        const candidates = rankKnowledgeCandidates([...byRef.values()], scoringTerms);
+        // 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);
         if (candidates.length === 0) {
             this.deliveryMode = degradedReason === undefined ? 'withheld' : 'degraded';
             return {
@@ -293,6 +308,7 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: [],
                 deliveredRefs: [],
+                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
@@ -307,25 +323,78 @@ 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(({ hit }) => {
-            fetchedRefs.push(hit.ref);
-            return this.deps.corpus.get(hit.ref).catch((error) => degraded(`corpus get rejected for ${hit.ref}: ${errorReason(error)}`));
+        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 promotedCandidates = [];
         for (let index = 0; index < nearMisses.length; index += 1) {
             const candidate = nearMisses[index];
-            const result = nearMissResults[index];
-            prefetchedByRef.set(candidate.hit.ref, result);
-            if (result.status !== 'ok') {
+            const nearMissResult = nearMissResults[index];
+            if (nearMissResult.result.status === 'unavailable') {
                 if (degradedReason === undefined)
-                    degradedReason = result.reason;
+                    degradedReason = nearMissResult.result.reason;
                 continue;
             }
-            const record = result.value;
+            if (nearMissResult.result.status === 'degraded') {
+                degradedReason ??= nearMissResult.result.reason;
+            }
+            degradedReason ??= nearMissResult.preferredFailureReason;
+            const record = nearMissResult.record;
             if (record === null)
                 continue;
             if (record.isSkillPayload === true)
@@ -350,40 +419,55 @@ 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). 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).
+        // 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).
         const packets = [];
+        const deliveredCanonicalEpisodeIds = [];
+        const deliveredCanonicalSet = new Set();
         for (const hit of ranked) {
             if (packets.length >= MAX_SELECTED_PACKETS)
                 break;
-            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') {
+            const result = await fetchRecord(hit);
+            if (result.status === 'unavailable') {
                 if (degradedReason === undefined)
                     degradedReason = result.reason;
                 continue;
             }
-            const record = result.value;
-            if (record === null)
+            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))) {
                 continue;
+            }
             if (record.isSkillPayload === true)
                 continue;
             // Post-fetch content guard (#1824, W2): content is the truth, the
@@ -397,12 +481,16 @@ export class PluginSession {
                 packet = projectKnowledgePacket(record);
             }
             catch (error) {
-                degradedReason ??= `packet projection failed for ${hit.ref}: ${errorReason(error)}`;
+                degradedReason ??= `packet projection failed for ${selectedHit.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);
@@ -417,6 +505,7 @@ export class PluginSession {
                 retrievalFired: true,
                 eligibleRefs: this.eligibleRefs,
                 deliveredRefs: [],
+                deliveredCanonicalEpisodeIds: [],
                 deliveryMode: this.deliveryMode,
                 ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
             };
@@ -431,6 +520,7 @@ export class PluginSession {
             retrievalFired: true,
             eligibleRefs: this.eligibleRefs,
             deliveredRefs: this.providedRefs,
+            deliveredCanonicalEpisodeIds,
             deliveryMode: this.deliveryMode,
             deliveredContentHash: this.deliveredContentHash,
             ...(degradedReason !== undefined ? { degraded: degradedReason } : {}),
@@ -536,8 +626,7 @@ 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} · `
-        + `full episode: corpus_fetch ${packet.ref}`);
+    lines.push(`  source: ${packet.ref} · ${packet.attribution.origin} · captured ${capturedDate}`);
     return lines.join('\n');
 }
 function renderKnowledgePackets(packets) {

package/dist/ports/corpus-port.d.ts

@@ -19,6 +19,11 @@ 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/schemas/knowledge-hit.d.ts

@@ -2,6 +2,7 @@
 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";
@@ -22,6 +23,7 @@ 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/schemas/knowledge-hit.js

@@ -3,6 +3,7 @@ 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(),
@@ -14,8 +15,15 @@ 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(),
-    /** Unix-ms publish time — the selection policy's recency tiebreaker (rescope §3.3). */
+    /** Adapter-native recency value — comparable only within `recencyDomain`. */
     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/schemas/knowledge-packet.d.ts

@@ -65,11 +65,12 @@ export interface KnowledgePacketBudget {
     maxChars?: number;
 }
 /**
- * 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.
+ * 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.
  */
-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/schemas/knowledge-packet.js

@@ -60,6 +60,9 @@ 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',
 ]);
@@ -90,7 +93,9 @@ 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. Selects only — never paraphrases.
+ * 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.
  */
 function selectExcerpts(steps) {
     const seedExcerpts = steps
@@ -135,21 +140,23 @@ function selectExcerpts(steps) {
     if (diffStep !== undefined)
         excerpts.push({ label: 'diff', text: stepDiff(diffStep) });
     if (excerpts.length === 0) {
-        const noteStep = steps.find((step) => stepNote(step) !== undefined);
+        const noteStep = steps.find((step) => isAssistantTurn(step) && stepNote(step) !== undefined)
+            ?? steps.find((step) => stepNote(step) !== undefined);
         if (noteStep !== undefined)
             excerpts.push({ label: 'note', text: stepNote(noteStep) });
     }
     return excerpts;
 }
 /**
- * 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.
+ * 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.
  */
-export function truncateLineBoundary(text, maxChars, ref) {
+export function truncateLineBoundary(text, maxChars, _ref) {
     if (text.length <= maxChars)
         return text;
-    const tail = `\n[truncated — full episode: corpus_fetch ${ref}]`;
+    const tail = '\n[truncated]';
     const budget = maxChars - tail.length;
     if (budget <= 0)
         return '';

package/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'>>;
+export type InMemoryCorpusSeed = CorpusRecord & Pick<KnowledgeHit, 'kind'> & Partial<Pick<KnowledgeHit, 'title' | 'tier' | 'payloadKind' | 'publishedAt' | 'recencyDomain'>>;
 /** 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,6 +17,7 @@ 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;
@@ -24,6 +25,7 @@ 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/testing/in-memory-corpus.js

@@ -2,6 +2,9 @@ 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,
@@ -10,6 +13,7 @@ function toKnowledgeHit(seed) {
         tags: seed.tags,
         origin: seed.origin,
         ...(seed.publishedAt !== undefined ? { publishedAt: seed.publishedAt } : {}),
+        ...(seed.recencyDomain !== undefined ? { recencyDomain: seed.recencyDomain } : {}),
         retrievalVisible: seed.retrievalVisible,
     };
 }
@@ -48,7 +52,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, ...corpusRecord } = record;
+        const { kind: _kind, title: _title, tier: _tier, payloadKind: _payloadKind, publishedAt: _publishedAt, recencyDomain: _recencyDomain, ...corpusRecord } = record;
         return ok(corpusRecord);
     }
 }

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@jinn-network/plugin",
-  "version": "0.1.0",
+  "version": "0.1.1-canary.25281242",
   "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",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jinn-Network/mono.git",
+    "directory": "packages/plugin"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [