mirror of
https://github.com/microsoft/BCQuality.git
synced 2026-08-06 17:36:53 +01:00
498055577e
Adds an optional 'effect' to routing signals. effect: suppress encodes 'this construct is NOT a violation of the domain' (the not-a-violation articles); the orchestrator subtracts a suppressor's weighted hits from the domain score (floored at 0) and does not route to it. Threaded through Build-RoutingIndex (registry now keyed by token+domain+effect so raise/suppress on the same token don't collide), routing-index.schema.json, and R24 (effect must be raise|suppress). Back-compatible: absent effect => raise. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
85 lines
4.9 KiB
JSON
85 lines
4.9 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"$id": "https://github.com/microsoft/BCQuality/tools/routing-index.schema.json",
|
|
"title": "BCQuality routing index",
|
|
"description": "Orchestrator-facing companion to knowledge-index.json. Maps deterministic PR-diff detection signals (AL tokens / regex) to their owning review domain and the knowledge articles that back them. Consumed by the PR-review orchestrator's manifest builder (Build-ReviewManifest, gated behind BCQ_INDEX_V2) to compute per-domain suspicion scores and shortlist candidate articles WITHOUT reading the hardcoded regex catalog that used to live in orchestrator code. Regenerated deterministically at authoring/CI time by tools/Build-RoutingIndex.ps1; never built in the token-paid path. This is NOT the lean agent-replayed knowledge index — it is not fed into the CLI prompt.",
|
|
"type": "object",
|
|
"required": ["version", "generatedAt", "generator", "articleCount", "signalCount", "domainNormalization", "objectKindDomain", "signals", "domains"],
|
|
"additionalProperties": true,
|
|
"properties": {
|
|
"$schema-note": { "type": "string" },
|
|
"version": { "type": "integer", "const": 1 },
|
|
"generatedAt": { "type": "string", "format": "date-time" },
|
|
"generator": { "type": "string" },
|
|
"enabledLayers": { "type": "array", "items": { "type": "string" } },
|
|
"articleCount": { "type": "integer", "minimum": 0 },
|
|
"signalCount": { "type": "integer", "minimum": 0 },
|
|
"domainNormalization": {
|
|
"description": "Front-matter domain (lowercase-hyphen) -> orchestrator domain label (TitleCase). Resolves the vocabulary mismatch between article front-matter (ui, error-handling), orchestrator $DomainMap (Accessibility, Error Handling), and feedback byDomain (lowercase).",
|
|
"type": "object",
|
|
"additionalProperties": { "type": "string" }
|
|
},
|
|
"objectKindDomain": {
|
|
"description": "AL object kind -> weak domain hint (applied once per changed object). Content-owned successor to the orchestrator's $BcqObjectKindDomain.",
|
|
"type": "object",
|
|
"additionalProperties": { "type": "string" }
|
|
},
|
|
"signals": {
|
|
"description": "Compiled detection signals. Each maps a regex over ADDED diff lines to a domain and the backing articles.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["token", "pattern", "domain", "source", "weight", "articles"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"token": {
|
|
"description": "Stable signal identifier (e.g. FindSet). Not necessarily an AL token verbatim.",
|
|
"type": "string"
|
|
},
|
|
"pattern": {
|
|
"description": "Regex matched (case-sensitively, as authored) against each added diff line. Escaped for JSON.",
|
|
"type": "string"
|
|
},
|
|
"domain": {
|
|
"description": "Owning review domain in the orchestrator's TitleCase taxonomy (post-normalization).",
|
|
"type": "string"
|
|
},
|
|
"source": {
|
|
"description": "Where the signal came from: 'seed' (legacy catalog migration), 'frontmatter-signal' (article-declared signals: block), or 'keyword' (soft keyword-derived, weight < 1).",
|
|
"type": "string",
|
|
"enum": ["seed", "frontmatter-signal", "keyword"]
|
|
},
|
|
"effect": {
|
|
"description": "Whether a hit RAISES the domain suspicion score (default) or SUPPRESSES it. Suppressors encode 'this construct is NOT a violation of the domain' (e.g. the not-a-violation articles); the orchestrator subtracts a suppressor's weighted hits from the domain score (floored at 0) and does not route to it. Optional for back-compat; absent means 'raise'.",
|
|
"type": "string",
|
|
"enum": ["raise", "suppress"]
|
|
},
|
|
"weight": {
|
|
"description": "Tier-1 confidence multiplier applied to signal hit counts in the domain-suspicion score. 1.0 for authored/seed signals; < 1 for soft keyword-derived signals. Tier-2 feedback weights (later) multiply on top of this.",
|
|
"type": "number",
|
|
"minimum": 0,
|
|
"maximum": 1
|
|
},
|
|
"articles": {
|
|
"description": "Repo-relative paths of the knowledge articles this signal routes to. Complete-by-construction: every article whose domain (and, for keyword signals, keyword) matches is attached, so recall is not limited by a hand-maintained catalog.",
|
|
"type": "array",
|
|
"items": { "type": "string" }
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"domains": {
|
|
"description": "Per-domain aggregates for quick orchestrator lookups.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "object",
|
|
"required": ["articleCount", "signalCount"],
|
|
"additionalProperties": true,
|
|
"properties": {
|
|
"articleCount": { "type": "integer", "minimum": 0 },
|
|
"signalCount": { "type": "integer", "minimum": 0 }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|