Design: where should semantic context evaluation live?

Open
#73 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Quiet
Tech stack
go
Domain
backend

Research direction

Read the existing reference/context-agent and the closed PR #10 for prior design context. Compare the three proposed homes against the listed deciding factors; the issue is done when a decision is recorded before implementation begins.

Written by the indexing model from the issue text.

Description

claude-triaged enhancement

The current reference/context-agent is scoped to property-registry lookup + bitmap-based property targeting. Six semantic evaluation concerns are unbuilt on main:

  1. EmbeddingMatch — cosine similarity between query embedding and content embedding
  2. KeywordMatch — set intersection of required/blocked keywords
  3. BrandSafety — category blocklist
  4. GeoFilter — allow/block lists
  5. DaypartFilter — day-of-week + hour ranges
  6. CatalogMatch — product catalog to content topics

Prior design lived in closed PR #10. Before rebuilding, decide the home.

Options

  • (A) Expand context-agent to carry a pluggable evaluator registry alongside the property registry
  • (B) New reference/semantic-agent as a separate reference service
  • (C) Move these into targeting/ as configurable predicates

Deciding factors

  • Whether context-agent stays a lightweight registry lookup or grows into an evaluator
  • Whether semantic matching is latency-critical (argues for colocating with targeting)
  • Whether these need to be independently versioned and deployed

Decision needed before any implementation. Suggested owner: @bokelley.

Dominant language
Go
Stars
4
Forks
2
Avg merge
1d 15h
Merged PRs (30d)
25

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from adcontextprotocol/adcp-go

All issues in adcontextprotocol/adcp-go

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.