knowledge: refresh OKF catalog — activate network-flows claims (#39)#40
Conversation
Full `hyrule-knowledge ingest` against current source-repo HEADs, the first refresh since 2026-07-03. This is the catalog-refresh step tracked in #39: it re-projects every source repo, so the network-flows enrichment merged in #38 (net-ops#430's `host_meta` + `network_flows.yml`) finally lands in the shipped concepts + `exports/knowledge.sqlite`. The feature is now live: `hyrule-knowledge firewall --port 9100`, `hyrule-knowledge claims --predicate allows_port --object 22`, and the four `knowledge_*` MCP tools return real rows (previously 0 — the committed concepts predated the flow frontmatter). Host concepts now carry `os`/`role`/ `network_flows` frontmatter and resolved `allows_from`/`connects_to` claims. Scope notes for review: - Cross-repo drift is expected (#39 action item 2): 8 days of source movement — ~177 hyrule-cloud API-endpoint concepts re-pinned to new line-anchored ids, source-docs, GitHub issues, and okf/curated source_ref SHAs advanced to HEAD. - The A4 LLM-enrichment tranche (`okf/generated/enriched/{services, infrastructure}.md`) is restored unchanged: `ingest`'s `reset_generated` wipes it (it is only ever regenerated by the separate `enrich` workflow), so it is checked back out from main rather than dropped. Closes #39. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The catalog refresh moved a few source-line-anchored concept ids and bumped the
deployed-SHA pins in net-ops host_vars. Update the golden assertions to the new
(verified) values — no behavioural change, just tracking real source drift:
- hyrule-cloud POST /v1/vm/create: `routes-py-671` → `routes-py-763`
- GET /v1/mail/accounts: `mail-py-117` → `mail-py-96`;
POST /v1/mail/accounts: `mail-py-107` → `mail-py-90`
- knowledge-mcp / noc-knowledge deployment pin: `48684c9…` → `a68f974…`
(the git_sha pinned in host_vars/{loop,noc}.yml, bumped since the last ingest)
- 3 eval cases (retrieval / grounding / engineering-loop vm-create) retargeted
to `routes-py-763`
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
PR Reviewer Guide 🔍Here are some key observations to aid the review process:
|
PR Code Suggestions ✨No code suggestions found for the PR. |
💡 Codex Reviewhttps://github.com/AS215932/knowledge/blob/bfe7e4e32c5e872e452cf5f84ab418c4c729f3ea/exports/claims.jsonl#L1169 For A0 flow queries against This eval case now expects the renamed This new workflow summary records a secret named ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
What
First full
hyrule-knowledge ingestsince 2026-07-03 — the catalog-refresh steptracked in #39. Re-projects every source repo so the network-flows enrichment
merged in #38 (net-ops#430's
host_meta+network_flows.yml) lands in theshipped concepts and
exports/knowledge.sqlite.Activation confirmed — previously these returned 0 rows:
Host concepts now carry
os/role/network_flowsfrontmatter and resolvedallows_from/connects_toclaims; the fourknowledge_*MCP tools returnreal data.
Scope / review notes
movement: ~177 hyrule-cloud API-endpoint concepts re-pinned to new
line-anchored ids, source-docs, GitHub issues, and
okf/curatedsource_refSHAs advanced to HEAD.
okf/curatedbodies are unchanged — only pinnedsource SHAs.
ingest'sreset_generatedwipes
okf/generated/enriched/*(regenerated only by the separateenrichworkflow), so
enriched/{services,infrastructure}.mdare checked back outfrom
mainrather than dropped.bumped deploy-SHA pins — verified against the refreshed catalog, no
behavioural change.
Gates (all green locally)
ruff·mypy --strict·pytest(175) ·validate okf·quality --check·
export --check·eval --check·ledger --check·ledger lifecycle --check·scan-secrets.Closes #39.
🤖 Generated with Claude Code