Skip to content

docs: AIP v0.5.0 output analysis, policy eval, OTel attrs#6

Open
alexgarden-mnemom wants to merge 3 commits intomainfrom
feat/aip-output-analysis-docs
Open

docs: AIP v0.5.0 output analysis, policy eval, OTel attrs#6
alexgarden-mnemom wants to merge 3 commits intomainfrom
feat/aip-output-analysis-docs

Conversation

@alexgarden-mnemom
Copy link
Copy Markdown
Member

Summary

  • Bumps AIP specification to v0.5.0 with new Section 7 (Output Analysis) covering analysis scope, output concern categories, verdict interaction rules, output_block_hash, and token budgets
  • Adds Output Analysis concept section to integrity-checkpoints page with updated checkpoint JSON example and new concern categories
  • Notes policy name fallback behavior in policy-engine Gateway Evaluation section
  • Adds 4 output analysis OTel attributes (aip.integrity.output_hash, output_tokens, output_truncated, analysis_scope) and marks policy.evaluate as Implemented
  • Adds policy evaluation span recording examples and Grafana dashboard panel to observability guide

Test plan

  • Verify Mintlify build passes (CI)
  • Review AIP spec section numbering is correct (7-20)
  • Confirm new OTel attributes table renders correctly
  • Check policy evaluation code examples compile conceptually

🤖 Generated with Claude Code

- Bump AIP spec to v0.5.0, add Section 7 (Output Analysis) covering
  analysis_scope, output concern categories, verdict interaction rules,
  output_block_hash, and token budget
- Add output_block_hash and analysis_scope to IntegrityCheckpoint type
- Renumber spec sections 8-20 to accommodate new section
- Add Output Analysis section to integrity-checkpoints concept page
  with updated checkpoint JSON, new concern categories table
- Note policy name fallback in policy-engine Gateway Evaluation tab
- Add 4 output analysis OTel attributes to aip.integrity_check span,
  mark policy.evaluate as Implemented
- Add policy evaluation span recording example and Grafana dashboard
  panel to observability guide

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Version bump 0.5.0→0.6.0, add changelog entry, output analysis section
in enforcement, policy identity resolution subsection, OTel output attr
notes, observability output traces section, token/timeout table and
sections 7.8-7.9 in spec, integrity-checkpoints tip.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Document recipe evaluation fields on checkpoints, adaptive detection
in the threat model, and recipe step in the request flow diagram.
Keeps operational details (metrics, tiers, timing, techniques) private.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant