Skip to content

Add agentic graph contract validation and repo scanner#23

Merged
mdheller merged 6 commits intomainfrom
sourceos/manifest-scanner-m1
May 6, 2026
Merged

Add agentic graph contract validation and repo scanner#23
mdheller merged 6 commits intomainfrom
sourceos/manifest-scanner-m1

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

@mdheller mdheller commented May 6, 2026

Summary

Adds the first sourceosctl tooling slice for the SourceOS/SociOS local-first agentic graph foundation.

This is the M1 validator/scanner lane that downstream repos can use before runtime sync, policy, agent, browser, shell, or relay integrations begin.

Added

  • .sourceos/manifest.json
    • Declares sourceos-devtools as the tooling repo for the M1 contract validation lane.
  • sourceosctl/commands/contracts.py
    • Adds dependency-light manifest validation, repo scan, estate scan, graph doctor, sync doctor, and policy explain helpers.
  • bin/sourceosctl
    • Routes new command groups:
      • contract validate
      • repo scan
      • estate scan
      • graph doctor
      • sync doctor
      • policy explain
  • tests/test_contracts.py
    • Covers manifest validation, bad JSON handling, repo scan, and doctor commands.
  • docs/integration/agentic-graph-contract-validation.md
    • Documents commands, current limitations, statuses, and M1 acceptance criteria.

Commands

python3 bin/sourceosctl contract validate .sourceos/manifest.json
python3 bin/sourceosctl repo scan .
python3 bin/sourceosctl estate scan ~/dev
python3 bin/sourceosctl graph doctor
python3 bin/sourceosctl sync doctor
python3 bin/sourceosctl policy explain path/to/decision-or-audit.json

Notes

This first pass is intentionally local-only and dependency-light. It validates JSON parseability and minimum SourceOSRepoManifest shape. Full JSON Schema draft 2020-12 validation can follow once the schema mirror from SourceOS-Linux/sourceos-spec#94 is merged or vendored.

Related

@mdheller mdheller merged commit b1bd117 into main May 6, 2026
1 of 2 checks passed
mdheller added a commit to SocioProphet/policy-fabric that referenced this pull request May 6, 2026
Adds .sourceos/manifest.json so Policy Fabric is scanner-visible for SourceOS/SociOS governed local-first agentic graph M1.

Declares the policy domain, sourceos.sync.policy-fabric engine, critical policy class, strongest_policy_wins merge strategy, authority repos, audit events, and dangerous policy surfaces.

Related: SourceOS-Linux/sourceos-spec#86, SourceOS-Linux/sourceos-spec#94, SourceOS-Linux/sourceos-devtools#23, #50
mdheller added a commit to SocioProphet/agent-registry that referenced this pull request May 6, 2026
Adds .sourceos/manifest.json so Agent Registry is scanner-visible for SourceOS/SociOS governed local-first agentic graph M1.

Declares the agent domain, sourceos.sync.agent-registry engine, critical policy class, signed_authority_required merge strategy, authority repos, audit events, and dangerous agent surfaces.

Related: SourceOS-Linux/sourceos-spec#86, SourceOS-Linux/sourceos-spec#94, SourceOS-Linux/sourceos-devtools#23, #15
mdheller added a commit to SocioProphet/memory-mesh that referenced this pull request May 6, 2026
Adds .sourceos/manifest.json so Memory Mesh is scanner-visible for SourceOS/SociOS governed local-first agentic graph M1.

Declares the memory domain, sourceos.sync.memory-mesh engine, high policy class, manual_review merge strategy, authority repos, audit events, and dangerous memory surfaces.

Related: SourceOS-Linux/sourceos-spec#86, SourceOS-Linux/sourceos-spec#94, SourceOS-Linux/sourceos-devtools#23, #18
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