Skip to content

feat: retain semantic-span prototype as TEPP implementation evidence - #82

Closed
seonghobae wants to merge 1 commit into
mainfrom
agent/language-agnostic-semantic-spans
Closed

feat: retain semantic-span prototype as TEPP implementation evidence#82
seonghobae wants to merge 1 commit into
mainfrom
agent/language-agnostic-semantic-spans

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Superseded by the TEPP-owned semantic-evidence contract

This prototype is useful test and algorithm evidence, but it is not the correct production owner or evidence contract for Milestone 2.

TEPP PR #83 establishes the canonical responsibility boundary: TEPP owns immutable documentary evidence, exact source spans, multilingual semantic measurement inputs, model-profile token budgets, hierarchical context, and embedding-space provenance. LineageWeave should consume that versioned import/REST contract and retain only a thin product adapter to its existing lineage candidate path.

The current implementation cannot be merged as the canonical layer because it:

  • stores micro-unit indices rather than exact source offsets and source digests;
  • normalizes and strips source text before lineage binding;
  • allows a token-window decoder to return an empty string and silently drops that source segment in a passing regression;
  • reconstructs spans with inserted separators rather than preserving a lossless source projection;
  • lacks document/section/DOM/image hierarchy, model-profile and embedding_space_id persistence, policy-versioned reindexing, and 3NF migrations;
  • duplicates the semantic-unit algorithm that TEPP feat: retain analysis-run registry prototype as superseded evidence #83 is explicitly defining for cross-product reuse.

Preserve this branch read-only. Port only the useful mixed-script, punctuation, exact-token-budget, dense-boundary, cache, and provider-absence tests into TEPP after ADR 0017 is accepted, while replacing data-loss behavior with exact source-span invariants. Then add a small LineageWeave adapter that consumes TEPP semantic-span artifacts and maps them to Chunk/lineage candidates without reimplementing measurement semantics.

Closing this PR prevents two incompatible semantic-unit engines from becoming product truth. It does not discard the prototype or its focused 100% coverage evidence.

Superseded by ContextualWisdomLab/TEPP#83 and LineageWeave issue #79.

Add a provider-neutral semantic-span engine that combines authored structure,
exact model token budgets, and optional dense adjacency similarity without
language routing, translation, or TF-IDF. Include a final metadata payload
guard, an adapter for the existing Chunk contract, mixed-script adversarial
tests, an accepted ADR, and a phased implementation plan.
@coderabbitai

coderabbitai Bot commented Aug 15, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 37dccbbc-520d-4ae8-b470-a74d9c3a4c56

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

class TokenCodec(Protocol):
"""Encode and decode text exactly as the selected embedding model does."""

def encode(self, text: str) -> list[int]: ...

def encode(self, text: str) -> list[int]: ...

def decode(self, tokens: Sequence[int]) -> str: ...
class VectorEmbedder(Protocol):
"""Minimal adapter implemented by LineageWeave embedding clients."""

def embed(self, text: str) -> list[float]: ...
@seonghobae seonghobae changed the title feat: add language-agnostic semantic span embedding feat: retain semantic-span prototype as TEPP implementation evidence Aug 15, 2026
@seonghobae seonghobae closed this Aug 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant