Skip to content

Say where the source lives: x-source, llms Source: and sameAs - #3

Draft
AgenteLabs wants to merge 1 commit into
mainfrom
source-fields
Draft

AgenteLabs wants to merge 1 commit into
mainfrom
source-fields

Conversation

@AgenteLabs

Copy link
Copy Markdown
Collaborator

Every served property points machine readers at its source, three ways: x-source in the flashyos/1 handshake (a convention the v1 contract ignores, like developers), a Source: line in llms.txt, and the GitHub organisation and repository in the page's Organization sameAs. The value is the CURRENT GitHub owner (AgenteLabs) as flashyos's estate.register.json names it — a URL that 404s is worse than none — and the org sameAs is omitted where the organisation the master plan moves this repository to does not exist on GitHub yet. flashyos's tools/estate-source.mjs (AgenteLabs/flashyos#233) fetches and checks all three against the register.

One constant per property; a test holds the three surfaces to it and compares it with the register when a flashyos checkout sits beside this repository (reported unknown, never passed, when it does not).

Only two of the three fields apply here: this site emits no Organization JSON-LD (FAQPage is its only structured data), so there is no sameAs to carry. The value is links.repo from site.config.json, which still names FlashyLabs on main (a GitHub rename redirect, not a 404) until the rename-sweep PR #1 lands; this PR reads it rather than typing a second copy.


Generated by Claude Code

site.config.json's `links.repo` is the one place this repository already
declares itself, so the build threads it into the derived handshake as
`x-source` (a convention the flashyos/1 contract ignores; a handshake
derived without a source carries no field rather than a guess) and into
llms.txt as a `Source:` line. `site/` is regenerated. There is no
Organization JSON-LD on this site — the FAQPage node is its only
structured data — so there is no `sameAs` to carry. test/source.test.mjs
holds the two built surfaces to the config and the config to flashyos's
estate register when that checkout is beside this one.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T2LtjRauY7RENs18aztY6V
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.

2 participants