{"schemaVersion":"1.8.0","id":"https://veilpoint.ca/.well-known/agent-capabilities.json","name":"VeilPoint Opportunity Exchange","operator":"VeilPoint","description":"VeilPoint Opportunity Exchange is economic-intelligence infrastructure for businesses, places, industries, workforce, demand and supply, with governed public evidence, a structured economic graph, and AI-ready access. It connects municipal economies, industries, businesses, workforce demand, wages, housing, trade, facilities, training and emerging activity; job postings are analyzed as labour-demand evidence rather than marketplace inventory. The model is geographically extensible; Saskatchewan is the current evidence footprint, alongside national occupational, wage, vacancy and housing reference data.","documentation":"https://veilpoint.ca/use-with-ai","discovery":{"llmsText":"https://veilpoint.ca/llms.txt","llmsFullText":"https://veilpoint.ca/llms-full.txt","machineIndex":"https://veilpoint.ca/index.md","faq":"https://veilpoint.ca/faq.md","openapi":"https://veilpoint.ca/api/v1/openapi.json","jsonCatalog":"https://veilpoint.ca/api/v1/catalog","bulkCatalog":"https://veilpoint.ca/data/catalog.json","sourceStatus":"https://veilpoint.ca/api/v1/sources","providerStatus":"https://veilpoint.ca/api/v1/providers","publicServiceReadiness":"https://veilpoint.ca/api/public-service-readiness","publicLaunchStatus":"https://veilpoint.ca/api/public-launch-status","datasets":[{"id":"occupations","title":"Occupation catalogue","description":"Saskatchewan roles, NOC codes, wages, requirements and pathways.","html":"https://veilpoint.ca/role/%7Bid%7D","markdown":"https://veilpoint.ca/roles.md","api":"https://veilpoint.ca/api/v1/roles","bulk":"https://veilpoint.ca/data/occupations.json","mcpTools":["list_roles","get_role","compare_roles"]},{"id":"noc-2021","title":"NOC 2021","description":"All 516 Canadian occupational unit groups with bilingual titles and TEER.","markdown":"https://veilpoint.ca/noc.md","api":"https://veilpoint.ca/api/v1/noc","bulk":"https://veilpoint.ca/data/noc.json","mcpTools":["list_noc_groups"]},{"id":"municipalities","title":"Communities","description":"Saskatchewan municipality profiles, identifiers and business directories.","html":"https://veilpoint.ca/directory","markdown":"https://veilpoint.ca/directory.md","api":"https://veilpoint.ca/api/v1/municipalities","bulk":"https://veilpoint.ca/data/municipalities.json","mcpTools":["get_community_profile","compare_communities"]},{"id":"agent-knowledge-graph","title":"Agent knowledge graph","description":"Canonical entity resolution plus bounded fact and relationship traversal with truth state, confidence, period and provenance filters.","api":"https://veilpoint.ca/api/v1/graph/query","mcpTools":["investigate_economic_question","resolve_entity","get_entity","search_entities","query_knowledge_graph","get_knowledge_graph_status","compare_communities","traverse_relationships","find_connected_entities","check_comparability"]},{"id":"governed-knowledge-frontier","title":"Governed knowledge frontier","description":"For one subject: the registered questions OEX asked, what it could not conclude and why, the governed dependency in the way where naming it is safe, what class of evidence would resolve it, and which registered question follows. Typed governed values and fixed catalogue constants only.","api":"https://veilpoint.ca/api/v1/frontier","mcpTools":["inspect_knowledge_frontier"]},{"id":"citation-layer","title":"OEX citation layer","description":"Stable machine resolution from a public graph assertion id to its canonical entities, source, observation time, truth state, confidence, publication scope, methodology and provenance.","api":"https://veilpoint.ca/api/v1/citations/%7BcitationId%7D","mcpTools":["resolve_citation"]},{"id":"sectors","title":"Sectors","description":"Sector rollups derived from occupations and provider-qualified hiring records; response evidence identifies the current truth state.","html":"https://veilpoint.ca/sectors","markdown":"https://veilpoint.ca/sectors.md","api":"https://veilpoint.ca/api/v1/sectors","bulk":"https://veilpoint.ca/data/sectors.json","mcpTools":["list_sectors","get_sector"]},{"id":"hiring-activity","title":"Hiring activity evidence","description":"Source-attributed records with recordPurpose=hiring_activity_evidence, observation and verification dates, provenance, and isActionable=false. OEX does not host applications or other hiring transactions.","html":"https://veilpoint.ca/labour-demand","markdown":"https://veilpoint.ca/labour-demand.md","api":"https://veilpoint.ca/api/v1/jobs","bulk":"https://veilpoint.ca/data/jobs.json","mcpTools":["search_hiring_activity"]},{"id":"advertised-demand","title":"Measured advertised demand","description":"Monthly Job Bank aggregate evidence; real and measured, but neither current nor actionable.","bulk":"https://veilpoint.ca/data/advertised-demand.json"},{"id":"labour-demand-engine","title":"Labour-demand variables","description":"Observed SaskJobs opening marginals, Job Bank detail distributions, modelled sector variables and a GDP composition sensitivity scenario with low-opening sector tilts suppressed and unvalidated parameters identified.","html":"https://veilpoint.ca/labour-demand","api":"https://veilpoint.ca/api/v1/labour-demand","mcpTools":["get_labour_demand"]},{"id":"occupational-profiles","title":"Occupational profiles","description":"Published OaSIS skills, abilities, work activities and requirements on the NOC spine.","bulk":"https://veilpoint.ca/data/occupational-profiles.json"},{"id":"licensed-businesses","title":"Licensed businesses","description":"Named businesses holding a municipal licence on the snapshot reference date, with NAICS subsector and commercial address. Existence and industry only — never hiring, size or ownership. Home-based licences carry no address.","html":"https://veilpoint.ca/directory/%7Bid%7D","markdown":"https://veilpoint.ca/directory/saskatoon.md","api":"https://veilpoint.ca/api/v1/municipalities/saskatoon/businesses","mcpTools":["search_businesses","get_business_evidence"]},{"id":"industrial-facilities","title":"Industrial and mining facilities","description":"Named Saskatchewan industrial and mining sites with operator, sector, type, region and coordinates. Records roster membership, not current operating, permitting, production or hiring status.","html":"https://veilpoint.ca/facilities","markdown":"https://veilpoint.ca/facilities.md","api":"https://veilpoint.ca/api/v1/graph/query?type=industrial-facility","mcpTools":["query_knowledge_graph"]},{"id":"business-counts","title":"Community business counts","description":"Statistics Canada businesses-with-employees aggregates by geography and industry.","bulk":"https://veilpoint.ca/data/business-counts.json"},{"id":"cost-baskets","title":"Market Basket Measure costs","description":"Published Saskatchewan MBM regional components and household totals.","bulk":"https://veilpoint.ca/data/cost-baskets.json"},{"id":"housing-evidence","title":"Housing evidence","description":"Published housing value and supply observations used by community analysis.","bulk":"https://veilpoint.ca/data/housing-evidence.json"},{"id":"occupational-outlook","title":"Occupational outlook","description":"COPS 2024–2033 projections by NOC, explicitly published as Canada-wide context rather than Saskatchewan forecasts.","bulk":"https://veilpoint.ca/data/occupational-outlook.json"},{"id":"education-pipeline","title":"Education and apprenticeship pipeline","description":"Statistics Canada Saskatchewan enrolment, graduate and trade-certification aggregates; not seats or available workers.","bulk":"https://veilpoint.ca/data/education-pipeline.json"},{"id":"training-pathways","title":"Training pathways and crosswalks","description":"Published OaSIS requirements plus transparent empirical NOC–CIP and reviewed Saskatchewan trade links; not seats or eligibility rules.","bulk":"https://veilpoint.ca/data/training-pathways.json"},{"id":"procurement-activity","title":"Procurement activity evidence","description":"Official CanadaBuys buyer, notice, UNSPSC product/service, geography, lifecycle, amendment, and provenance observations. Current and historical records are non-actionable and do not imply supplier fit or award.","api":"https://veilpoint.ca/api/v1/procurement","mcpTools":["inspect_procurement_activity"]},{"id":"procurement-relevance","title":"Business procurement relevance","description":"Category overlap between the supply categories a business has published and the categories official buyers request. Compatibility only: it establishes no qualification, eligibility, supplier relationship, competitiveness, or likelihood of award.","api":"https://veilpoint.ca/api/v1/businesses/procurement-relevance","mcpTools":["assess_procurement_relevance"]},{"id":"workforce-demand","title":"Workforce demand, credentials and training routes","description":"Occupational demand, credential demand, training availability and a constraint indicator, reported separately. Never combined into a shortage claim: that needs a credential-holder denominator OEX does not hold.","api":"https://veilpoint.ca/api/v1/workforce-demand","mcpTools":["assess_workforce_demand"]},{"id":"supplier-compatibility","title":"Potential supplier compatibility","description":"Businesses whose published supply categories match what another business has published as things it buys. Compatibility between two published statements: no relationship is asserted, and nothing is matched on industry.","api":"https://veilpoint.ca/api/v1/businesses/suppliers","mcpTools":["find_potential_suppliers"]},{"id":"customer-compatibility","title":"Potential customer compatibility","description":"Businesses whose published purchasing categories match what another business says it can supply. Not a customer list: a business appearing in it has expressed no interest in anything.","api":"https://veilpoint.ca/api/v1/businesses/customers","mcpTools":["find_potential_customers"]},{"id":"open-source-signals","title":"Economic signals (OSINT)","description":"Governed official-source signal lifecycle; non-actionable and excluded from rankings.","html":"https://veilpoint.ca/signals","markdown":"https://veilpoint.ca/signals.md","api":"https://veilpoint.ca/api/v1/signals","bulk":"https://veilpoint.ca/data/signals.json","mcpTools":["list_economic_signals","get_economic_signal"]},{"id":"housing","title":"Housing","description":"Community housing views and the own-versus-rent model.","html":"https://veilpoint.ca/real-estate","markdown":"https://veilpoint.ca/real-estate.md","api":"https://veilpoint.ca/api/v1/real-estate","bulk":"https://veilpoint.ca/data/real-estate.json","mcpTools":["get_real_estate"]},{"id":"economy","title":"Saskatchewan economy and community GDP","description":"Official provincial headline indicators plus modeled community GDP reconciled to official Saskatchewan sector totals.","html":"https://veilpoint.ca/economy","markdown":"https://veilpoint.ca/economy.md","api":"https://veilpoint.ca/api/v1/economy","bulk":"https://veilpoint.ca/data/economy.json","mcpTools":["get_economy_overview","get_municipality_evidence_coverage","get_community_economy"]},{"id":"trade","title":"Trade","description":"Published Saskatchewan merchandise exports; restricted grain detail excluded.","html":"https://veilpoint.ca/trade","markdown":"https://veilpoint.ca/trade.md","api":"https://veilpoint.ca/api/v1/trade","bulk":"https://veilpoint.ca/data/trade.json","mcpTools":["get_trade_overview"]},{"id":"wages","title":"Wages and measured vacancies","description":"LFS wages and JVWS measured vacancy estimates on the NOC spine.","html":"https://veilpoint.ca/wages","markdown":"https://veilpoint.ca/wages.md","api":"https://veilpoint.ca/api/v1/wages","bulk":"https://veilpoint.ca/data/wages.json","mcpTools":["get_wage_evidence"]},{"id":"rents","title":"Rents","description":"CMHC measured rents and rental vacancy rates by surveyed centre.","html":"https://veilpoint.ca/rents","markdown":"https://veilpoint.ca/rents.md","api":"https://veilpoint.ca/api/v1/rents","bulk":"https://veilpoint.ca/data/rents.json","mcpTools":["get_rents"]},{"id":"sources","title":"Source registry","description":"Governed upstream publishers, datasets, licences, checked releases and materialization bindings.","html":"https://veilpoint.ca/about/data","markdown":"https://veilpoint.ca/sources.md","api":"https://veilpoint.ca/api/v1/sources","bulk":"https://veilpoint.ca/data/sources.json","mcpTools":["get_data_sources","get_source_provenance","get_evidence","explain_confidence","explain_truth_state"]},{"id":"providers","title":"Provider registry","description":"Runtime delivery contracts separated into evidence, preview, planned, first-party and derived providers.","html":"https://veilpoint.ca/about/data","markdown":"https://veilpoint.ca/sources.md","api":"https://veilpoint.ca/api/v1/providers","bulk":"https://veilpoint.ca/data/providers.json","mcpTools":["get_data_providers"]},{"id":"models","title":"Derived intelligence model registry","description":"Versioned formulas, inputs, assumptions, sensitivity limits, validation state and prohibited interpretations for published derived outputs.","html":"https://veilpoint.ca/about/models","markdown":"https://veilpoint.ca/models.md","api":"https://veilpoint.ca/api/v1/models","bulk":"https://veilpoint.ca/data/models.json"}]},"workflows":[{"id":"business-health-free-check","name":"Business Health — free public check","description":"Run the twenty-two Business Health checks against a real business from details supplied in the request. No account, no key, nothing stored, and no MCP client required — a single GET, which is what an AI assistant browsing on someone's behalf can actually issue. OEX holds no record of the business and asserts nothing about it; checks requiring stored or verified identity report that they could not run.","access":"keyless, no account, nothing stored","start":"https://veilpoint.ca/api/v1/business-health?name=Your+Business&website=yourdomain.ca","mcpTool":"check_business_health","nextStep":"explain_business_claim — what claiming involves, for someone who wants to act on the findings inside OEX. Claiming is gated on demonstrating a connection to the business, and no agent tool can perform it.","formats":["json","markdown (add &format=markdown)"],"parameters":{"name":"required","website":"optional but high value — nine checks available to the free run inspect the site","address":"optional","category":"optional","description":"optional","phone":"optional"}},{"id":"governed-knowledge-frontier","name":"Governed knowledge frontier — what OEX has not resolved, and what follows","description":"OEX answers registered questions and says, in typed governed terms, what it could not conclude and why. This returns the resolutions for one subject, the governed dependency standing in the way where every instance of its kind is public by nature, what class of evidence would resolve it, and which registered question logically follows. Every field is a typed value or a fixed catalogue constant — no model is invoked and nothing is derived from prose. Follow only nextInquiries. awaiting_evidence is an explicit pending state with typed evidenceRequirements: stop and resume only after admissible evidence changes. Already evaluated questions are not offered again. Not a task list: no identifiers to act on, no ordering that implies priority, and no way to report a dependency addressed. A dependency whose scope kind requires a per-instance publishability decision is not named, not counted and not acknowledged, so an empty list is never evidence that none exist.","access":"keyless, no account, no governed-state writes; standard request telemetry applies","start":"https://veilpoint.ca/api/v1/frontier?subjectKind=municipality&subjectId=warman","mcpTool":"inspect_knowledge_frontier","nextStep":"Submit a returned nextInquiries question verbatim to investigate_economic_question with its subject as an entity hint, then inspect the frontier. If progress.state is awaiting_evidence, stop: evidenceRequirements describe what must become admissible before rechecking. An unchanged frontier is not progress. The facts live in the evidence resources; this reports only what remains unresolved.","formats":["json"],"parameters":{"subjectKind":"required — kinds with a registered inquiry type are listed in the response","subjectId":"required — the canonical OEX identifier, such as a municipality slug"}},{"id":"business-health-capabilities","name":"Business Health — what OEX can actually do","description":"Every Business Health check, what evidence it reads, what identity it needs before it will run, and what it offers as a fix. Read this before telling a business what OEX can do for it: it is generated from the check registry itself rather than written down, so it cannot advertise a capability the runner refuses. It also distinguishes the checks that run for anyone from those needing a claim or a verified claim, which is what separates \"this passed\" from \"OEX was not allowed to look\".","access":"keyless, no account, no business required","start":"https://veilpoint.ca/api/v1/business-health/capabilities","mcpTool":"list_health_capabilities","nextStep":"check_business_health — run the checks this describes against a real business, or create_sandbox_business to walk the whole workflow on a synthetic subject.","formats":["json"],"parameters":{}},{"id":"business-study-free","name":"Guided Business Study — free public study","description":"Business Health and then three analytical instruments over the same evidence — Negative Space (what would be expected and is not observed), Boundary Fracture (a value the business's own website publishes that never crossed into its record) and Strategic Node Finder (the one change addressing several findings at once). One GET, no account, no key, nothing stored, no MCP client required. Every conclusion cites the evidence beneath it; a conclusion citing nothing is withheld rather than shown, and evidence OEX could not read is reported as unknown rather than as zero.","access":"keyless, no account, nothing stored","start":"https://veilpoint.ca/api/v1/business-study?name=Your+Business&website=yourdomain.ca&objective=what+you+are+trying+to+do","mcpTool":"run_business_study","nextStep":"The strategic node names what to do first, and each finding states what would overturn it. Acting inside OEX rather than on the business's own site requires claiming the record — explain_business_claim describes how.","formats":["json","markdown (add &format=markdown)"],"parameters":{"name":"required","website":"optional but highest value here — without it Boundary Fracture has no interface to assess and says so","objective":"optional — what the business is trying to accomplish, in its own words","address":"optional","category":"optional","description":"optional","phone":"optional"}},{"id":"business-health","name":"Business Health","description":"A diagnostic OEX runs for an individual business: what is wrong or missing in how it appears in public data, why each finding matters, what to do about it, and verification that a fix worked. Findings are either problems for the business or invitations where OEX itself needs an input — the second kind must state what the business gets back, never counts toward the total, and never affects the headline.","access":"keyless, against synthetic sandbox subjects","start":"create_sandbox_business","steps":["create_sandbox_business — mint a synthetic subject with whatever gaps you want to test","get_business_health — read the report (get_business_health_markdown for the hand-off form)","update_business_record / grant_business_consent / set_website_domain — act on a finding","start_health_action, report_health_action_complete — record progress on a finding","recheck_business_health — ask OEX to look again and verify","get_health_action_history — the auditable sequence of what changed when","run_business_study — the three-instrument analytical study over the same evidence (run_business_study_markdown for the document form)"],"guarantees":["No numeric score, in any cycle. The headline is categorical and progress is verified improvements.","A check that could not run reports unable-to-verify, never a pass. Absence is not zero.","Nothing reaches a resolved state except through a recheck that actually passed.","Real business records are unreachable from every public tool."],"humanEquivalent":"https://veilpoint.ca/business"}],"interfaces":{"rest":{"openapi":"https://veilpoint.ca/api/v1/openapi.json","baseUrl":"https://veilpoint.ca/api/v1/","authentication":"none","access":"keyless, CORS-open","investigation":{"endpoint":"https://veilpoint.ca/api/v1/investigate","method":"POST","cache":"no-store","behavior":"Deterministic question planning, entity resolution, and bounded governed evidence retrieval; prose synthesis remains external."}},"mcp":{"endpoint":"https://veilpoint.ca/mcp","transport":"streamable-http","protocolVersion":"2026-07-28","supportedProtocolVersions":["2026-07-28","2025-06-18"],"authentication":"none","setupDocumentation":"https://veilpoint.ca/use-with-ai#connect","clientConfiguration":{"mcpServers":{"opportunityExchange":{"type":"http","url":"https://veilpoint.ca/mcp"}}},"tools":["investigate_economic_question","inspect_knowledge_frontier","resolve_entities","get_entity_context","query_knowledge_graph","get_knowledge_graph_status","compare_municipalities","list_roles","get_role","compare_roles","search_hiring_activity","compare_outcomes","rank_communities","list_sectors","get_sector","summarize_credential_demand","search_employers","get_trade_overview","get_real_estate","search_licensed_businesses","get_wages","get_rents","list_noc_groups","evaluate_pathways","inspect_procurement_activity","assess_procurement_relevance","assess_workforce_demand","find_potential_suppliers","find_potential_customers","list_economic_signals","get_economic_signal","get_emerging_signals","get_data_sources","get_data_providers","get_source_provenance","resolve_citation","get_economy_overview","get_municipality_evidence_coverage","get_community_economy","resolve_entity","get_entity","search_entities","search_businesses","get_business_evidence","get_community_profile","compare_communities","get_labour_demand","get_wage_evidence","traverse_relationships","find_connected_entities","get_evidence","explain_confidence","explain_truth_state","check_comparability","check_business_health","explain_business_claim","list_health_capabilities","create_sandbox_business","list_sandbox_businesses","get_business_health","get_business_health_markdown","update_business_record","grant_business_consent","set_website_domain","get_generated_asset","start_health_action","report_health_action_complete","recheck_business_health","get_health_action_history","check_opportunity_readiness","run_business_study","run_business_study_markdown"]},"authenticatedMcp":{"endpoint":"https://veilpoint.ca/mcp/authorized","transport":"streamable-http","protocolVersion":"2026-07-28","authentication":"oauth2","protectedResourceMetadata":"https://veilpoint.ca/.well-known/oauth-protected-resource","tools":[{"name":"read_asset_passport","toolClass":"private_read","requiredScopes":["asset:read"]},{"name":"update_provider_business_profile","toolClass":"controlled_write","requiredScopes":["asset:write"]}]},"markdown":{"index":"https://veilpoint.ca/index.md","convention":"<canonical-html-path>.md"},"bulkJson":{"catalog":"https://veilpoint.ca/data/catalog.json","convention":"/data/{dataset}.json"}},"policies":{"publicReadOnly":false,"publicWriteScope":"Synthetic sandbox businesses only, created by the caller through create_sandbox_business. No public tool can modify a real business record, a published dataset or the knowledge graph.","apiKeyRequired":false,"accountRequired":false,"rendering":{"javascriptRequired":false,"html":"Server-rendered public content with native links and GET forms.","contentNegotiation":"Send Accept: text/markdown to a documented HTML route to receive its Markdown twin.","interactiveAlternatives":"Maps publish table equivalents; filters submit by GET; pathway evaluation is available through the no-store POST API."},"truthStates":{"field":"meta.evidence.truthState","vocabulary":{"preview":"Synthetic demonstration records — structurally realistic, never actionable.","snapshot":"Authoritative data published for a stated reporting period; real, dated, and not real-time.","measured_aggregate":"Statistical survey estimates — measurements of a market, not individual actionable records.","mixed":"Derived from inputs of differing strength; inherits the weakest material input.","live":"Current records from a production-backed provider. Read isActionable separately; live evidence can still be observational and non-transactional.","metadata":"Factual self-description of the platform or its governed contracts."}},"confidence":{"field":"meta.evidence.confidence","appliesTo":"Every envelope, and every graph fact and relationship.","scale":"A strongest to D weakest.","vocabulary":{"A":"Direct primary-source observation. Quote as measured fact, naming its reference period.","B":"Published reference or reported observation. Quote with its publisher and date; it is someone else’s measurement carried faithfully, not ours.","C":"Modeled estimate. Quote only as an estimate, with its bounds and method; never as a measurement.","D":"Synthetic placeholder. Never quote as market fact under any framing."},"derivedRule":"A derived value inherits the weakest confidence among its inputs; read meta.provenance for the contributing sources."},"communityEvidenceTier":{"field":"confidence_tier, a municipality metric in the knowledge graph","measures":"How mature a community’s evidence base is — not the quality of any single measurement.","distinctFrom":"meta.evidence.confidence. The two scales share the letters A–D and must not be conflated.","vocabulary":{"A":"Partner-validated","B":"Locally corroborated","C":"Public-source estimate","D":"Profile only"},"rubric":"https://veilpoint.ca/economy/coverage.md","companionFields":"Each community also publishes availableEvidence, missingEvidence and the next action required to reach the tier above."},"rateLimit":{"requestsPerWindow":300,"windowSeconds":60,"scope":["/api/v1","/data","/mcp"],"headers":["RateLimit-Limit","RateLimit-Remaining","RateLimit-Reset"],"onExceeded":"429 with Retry-After"},"citations":"Use meta.citeAs and the canonical URL returned with each resource. Public graph facts and relationships also carry citation.id and citation.resolver; resolve them through the REST citation route or resolve_citation.","evidence":"Read meta.evidence before quoting a figure; derived resources also include meta.provenance.","interpretation":{"rules":[{"id":"hiring-observation-boundary","appliesTo":["job-posting","posting-evidence","hiring-activity-observation"],"instruction":"Treat hiring records as dated evidence of advertised labour demand. They are not OEX application inventory, proof that a vacancy remains open, or proof that a hire occurred.","prohibitedInferences":["OEX application route","current vacancy without freshness evidence","completed hire"]},{"id":"licensed-business-presence","appliesTo":["licensed-business"],"instruction":"A licensed-business record establishes presence in the authorized municipal snapshot only.","prohibitedInferences":["current operating health","employment","ownership","hiring"]},{"id":"business-verification-scope","appliesTo":["business-verified-field"],"instruction":"A business-verified field was confirmed by the participating business under recorded consent; it does not override a stronger independent measurement when the concepts differ.","prohibitedInferences":["independent measurement","legal-registry status outside the verified field"]},{"id":"do-not-sum-unreconciled-populations","appliesTo":["posting-evidence","licensed-business-count"],"instruction":"Do not add posting-evidenced employers to licensed-business counts unless OEX marks the underlying entities reconciled.","prohibitedInferences":["combined business population"]},{"id":"comparison-boundary","appliesTo":["numeric-observation"],"instruction":"Do not compare or combine values whose periods, units, concepts, geographic levels, or boundaries differ unless OEX marks them comparable.","prohibitedInferences":["rankings from mismatched observations","time trends from incompatible vintages"]},{"id":"modelled-opportunity-boundary","appliesTo":["modelled-opportunity","derived-signal"],"instruction":"A modelled opportunity is a hypothesis for validation, not an observed fact or a purchasing commitment.","prohibitedInferences":["observed demand","confirmed buyer","investment recommendation"]}],"comparability":{"requiredMatches":["concept","unit","geographic level and boundary","reference period"],"missingRule":"A missing fact is unknown, never zero or false.","resultRule":"OEX marks a comparison comparable only when every material observation has compatible concepts, units, geography, and periods."},"citations":{"version":"1.0.0","requiredFields":["stable citation id and resolver","canonical entity identity","value and unit","geography","reference period","truth state","confidence","source or provenance","canonical URL and citeAs text"],"instruction":"Read meta.evidence before quoting a result, preserve material qualifications, and cite the canonical URL returned with the resource. Atomic public graph assertions also carry citation.id and citation.resolver; resolve either through /api/v1/citations/{citationId} or resolve_citation instead of reconstructing provenance from display text.","boundary":"The resolver is a projection of the governed graph assertion, not a second truth store or an immutable historical evidence lock. Private, aggregate-only, withdrawn and absent assertions are never disclosed."}},"crossLinks":"Traverse each entity through links[]. target.type + target.id + target.scheme are stable; strength distinguishes direct, mapped and derived relationships. Unresolved possibilities are not emitted as links.","privacy":"Pathway constraints are accepted only by POST, are not placed in URLs, and are not stored."}}