Skip to content

Add RationalGRL and open artifact compiler semantics to civic-stack ontology #81

Description

@mdheller

Purpose

Extend the civic-stack ontology work in #80 with two additional semantic tracks from the latest design input:

  1. RationalGRL-style intentional/rationale modeling: Actor, Goal, Softgoal, Task, Resource, Contribution, Decomposition, Dependency, Argument, Assumption, Defeater, Satisfaction.
  2. Open replacement for Bento-style packaging: OQL → Open Artifact Compiler / Open Artifact Specification with provenance instrumentation.

This keeps the architecture ontology-first while making intention, execution, deployment, and provenance mechanically traceable.

Source concepts to capture

RationalGRL / GRL

  • Actor and actor boundary
  • Goal and softgoal
  • Task and resource
  • Positive contribution
  • Negative contribution
  • Decomposition
  • Dependency
  • Argumentation-aware justification
  • Satisfaction propagation / denial propagation
  • Trade-off analysis and defeasible rationale

OQL / Open Artifact Ecosystem

  • OQL as semantic intent/query/plan language
  • Open Artifact Specification / Open Artifact Manifest as JSON-LD artifact recipe
  • OQL-to-OAC compiler as translation layer
  • Translation index / adapter registry
  • Provenance instrumentation using PROV-O, in-toto, SLSA, Sigstore, SBOM, OpenLineage
  • Federation placement and status concepts
  • Evidence vault / content-addressed artifacts

Acceptance criteria

  • Add or extend ontology module(s) for GRL intentional elements and relationships.
  • Add or extend ontology module(s) for OQL plan, Open Artifact Manifest, compiler, adapter, artifact, deployment, and evidence concepts.
  • Add SHACL constraints for rationale graphs: goals/tasks/resources must have owners; dependency edges must identify source and target; contribution edges must type polarity.
  • Add SHACL constraints for artifacts: manifest id, source OQL plan, provenance, policy, signature/evidence refs.
  • Add a worked example connecting: NLQ/OQL intent → GRL rationale → OAC manifest → federated placement → provenance/evidence → Delivery Excellence score.
  • Cross-reference Add seven-model civic organizational alignment for ORG/FOAF/vCard #80 so civic organization semantics and intentional artifact semantics remain one stack.

Downstream consumers

  • SocioSphere: rationale governance and board routing.
  • Delivery Excellence: rationale coverage and artifact evidence completeness scoring.
  • AgentPlane: task execution and compiler invocation.
  • PolicyFabric: artifact admission and placement policy.
  • HellGraph: query over rationale/evidence graph.
  • Standards repos: OQL/OAC schemas and contexts.
  • Cluster registry: federation placement/status mapping.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions