docs: ext-feedback agent derivation + sensor->ai-agent matrix pair#270
Merged
Conversation
- Unify derived vs declared labels (playbook->secret authenticates-with, playbook->playbook runs) so redundant links: tags can't relabel edges - ext-playbook request parameter is 'name' (ext-feedback uses 'playbook_name') - Outputs are not Hive-backed: add output/payload to the Reservation list and rewrite both examples without output nodes - Reservation: links:sensor drops at the matrix gate, not dangling-edge - Clarify edge labels are slugs in the API payload, humanized at render - Clarify membership semantics across drop rules 1-3 - Add migration note for pre-matrix declared pairs - Structural extractors: three, dr-rule members only; fp 'op: is' exact - Fix CLI examples to the real 'hive set --tag-add' syntax - LABEL_SLUG regex matches the implementation (no trailing separator) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Two gaps found validating a real human-in-the-loop story (rule -> ext-feedback approval -> AI agent): - The dr-rule -> ai-agent edge now also derives from an extension request to ext-feedback with feedback_destination: ai_agent carrying an ai_agent_name (previously only the start ai agent action derived). - sensor/cloud-sensor/adapter -> ai-agent (triggers) joins the allowed-pair matrix so a feedback/webhook mediator sensor can declare the edge to the agent it triggers. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
extension_subscription is an internal hive and must never be tagged, so extension nodes cannot legitimately surface. Mark the slug reserved, note that dr-rule -> extension derived edges drop, and document the visible-component modeling for extension-mediated flows. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
21b6550 to
9c3a815
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Validating the deployed edge ontology against a real org's story (a human-in-the-loop pipeline: D&R rule → ext-feedback Slack approval → AI agent) exposed two gaps and one modeling rule:
feedback_destination: ai_agent+ai_agent_name:) produced no derived edge — only the directstart ai agentaction did. The derived-table row fordr-rule → ai-agent(starts) now covers both mechanisms.sensor/cloud-sensor/adapter→ai-agent(triggers) joins the allowed-pair matrix (the label already exists in the canonical vocabulary).extensionis reserved: its backing hive (extension_subscription) is internal and must never be tagged, so extension nodes can't surface anddr-rule → extensionderived edges drop. Extension-mediated flows are modeled through their visible components (the mediator sensor + the derived rule→agent edge above).Also carries the review-fix commit that missed the #269 merge (#269 was merged from a pre-review state): unified derived/declared labels, ext-playbook
name:parameter, output/payload reservation + example rewrites without output nodes, slug-form edge labels in the API payload, membership semantics across drop rules, migration note, realhive set --tag-addCLI syntax, and the exactLABEL_SLUGregex.The assembler and AI-prompt changes implementing this land separately.
🤖 Generated with Claude Code