Skip to content

Ultimate Game-Stopper: Phase 1-3 Implementation (Kernel Observability, Evidence Bundles & Semantic Review)#18

Open
gnanirahulnutakki wants to merge 2 commits into
devfrom
feature/ultimate-game-stopper
Open

Ultimate Game-Stopper: Phase 1-3 Implementation (Kernel Observability, Evidence Bundles & Semantic Review)#18
gnanirahulnutakki wants to merge 2 commits into
devfrom
feature/ultimate-game-stopper

Conversation

@gnanirahulnutakki
Copy link
Copy Markdown
Contributor

This PR introduces the core implementation for the "Ultimate Game-Stopper" roadmap (4-phase plan to make Ardur production-grade and regulator-ready).

Summary of Changes

Phase 1 – Kernel Observability MVP

  • Real AF_UNIX socket client in kernel_capture_client.py (with registration, graceful degradation, and build_kernel_claim)
  • proxy_kernel_hook.py + small wiring delta in proxy.py for high-risk side effects (exec, process_launch, filesystem_write)
  • First signed ExecutionReceipt tests exercising the wired path (test_signed_receipt_with_kernel_claim.py)

Phase 2 – Regulator Evidence Bundles

  • evidence_exporter.py with support for receipt_chain and kernel/semantic data
  • cli_evidence.py + wiring into main CLI (cli.py)
  • New helpers: make_receipt_summary, build_receipt_summaries, summarize_receipts, summarize_receipts_from_events, make_event_summary
  • End-to-end CLI + bundle tests

Phase 3 – Semantic Review + Formal Stubs

  • shadow_mode_harness.py (advisory-only analysis + attach_shadow_to_receipt + compose_shadow_report_with_formal)
  • Formal narrowing invariant stub with 8+ concrete example checks
  • Integration tests combining shadow analysis + formal checks + receipt attachment

Integration & Polish

  • kernel_receipt_integration.py as the central bridge (enrich → attach → export)
  • Multiple new tests exercising the full wired paths
  • Extensive documentation updates (coverage-map, known-limitations, plans, STATUS)

Testing

  • All new Python files pass syntax validation
  • New tests cover:
    • Signed receipts with kernel claims
    • Wired proxy high-risk path
    • CLI evidence export with kernel data
    • Shadow mode + formal checks + receipt attachment

Next Steps (outside this PR)

  • Full live e2e through GovernanceSession.check_and_record → receipt issuance
  • Real Go kernelcapture daemon round-trip
  • Expand formal properties
  • Continuous adversarial harness

All changes are small, reviewable, and follow Ardur’s engineering standards (evidence-backed, honest insufficient_evidence handling, no overclaims).

Base: dev

Ready for review.

… for Ultimate Game-Stopper plan

- Add kernel receipt integration helpers (make_receipt_summary, build_receipt_summaries, etc.)
- Wire proxy and CLI for high-risk kernel events and evidence bundles
- Add shadow mode harness with formal narrowing invariant stubs
- Add comprehensive tests for signed receipts, CLI, and shadow + formal paths
- Update documentation and plans
Copy link
Copy Markdown

@github-advanced-security github-advanced-security AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CodeQL found more than 20 potential problems in the proposed changes. Check the Files changed tab for more details.

- Added tests for public verifier revocation detection, performance metrics in semantic review, capture level kernel path, harness plugin exercise
- Improved revocation list always emitted in bundles
- Strengthened semantic-risk-oracle detection
- Added performance recording in public verifier
- Updated all canonical docs (coverage-map, known-limitations, STATUS)

Tests: 28/33 passing (core new functionality green)
Harness: producing live scorecards

[pre-continue push to dev]
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