Skip to content

Add sourceosctl reasoning inspection and validation commands#24

Merged
mdheller merged 12 commits intomainfrom
superconscious-reasoning-cli
May 7, 2026
Merged

Add sourceosctl reasoning inspection and validation commands#24
mdheller merged 12 commits intomainfrom
superconscious-reasoning-cli

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

@mdheller mdheller commented May 6, 2026

Summary

Adds a read-only sourceosctl reasoning command group for Superconscious / SourceOS canonical reasoning artifacts.

Commands added:

sourceosctl reasoning validate <run-dir>
sourceosctl reasoning inspect <run-dir>
sourceosctl reasoning replay-plan <run-dir>
sourceosctl reasoning events <run-dir>

Included

  • sourceosctl/commands/reasoning.py
  • plugin routing in bin/sourceosctl
  • canonical reasoning fixture set under tests/fixtures/reasoning/deterministic/
  • tests/test_reasoning_cli.py
  • validate-reasoning-cli Makefile target wired into make validate

Boundaries

  • Read-only only.
  • No network, model provider, credential, browser automation, or host mutation.
  • Does not become the cognition loop.
  • Validates/inspects SourceOS canonical artifacts emitted by Superconscious:
    • reasoning-events.sourceos.jsonl
    • reasoning-run.sourceos.json
    • reasoning-receipt.json
    • reasoning-replay-plan.json
    • reasoning-benchmark.json

Validation

Expected validation:

make validate
python3 -m unittest discover -s tests -v
python3 bin/sourceosctl reasoning validate tests/fixtures/reasoning/deterministic
python3 bin/sourceosctl reasoning inspect tests/fixtures/reasoning/deterministic

Advances #22.

@mdheller mdheller merged commit 34dba0a into main May 7, 2026
2 checks passed
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