@agenticprimitives/ontology 1.0.0-alpha.4 → 1.0.0-alpha.41

package/tbox/familyoffice.ttl

@@ -0,0 +1,87 @@
+# T-box — FamilyOffice (apfo:): the family-office organization + its member
+# RELATIONSHIPS modeled as Situations (DnS, apsit:Situation). The codelists (the
+# concept values) live in cbox/familyoffice-vocabulary.ttl; this file declares what
+# a FAMILY OFFICE and each RELATIONSHIP are. New City AI domain ontology over the
+# neutral substrate — a family office is an OrganizationAgent whose members hold
+# typed, hashed, ontology-referenced relationships (never bare enums or edges).
+
+@prefix apfo:  <https://agenticprimitives.dev/ns/familyoffice#> .
+@prefix apsit: <https://agenticprimitives.dev/ns/situation#> .
+@prefix ap:    <https://agenticprimitives.dev/ns/core#> .
+@prefix aps:   <https://agenticprimitives.dev/ns/skill#> .
+@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl:   <http://www.w3.org/2002/07/owl#> .
+
+apfo: a owl:Ontology ;
+    rdfs:label "Agentic Primitives — FamilyOffice vocabulary" ;
+    owl:versionInfo "0.1.0" ;
+    rdfs:comment "The family-office organization + its member relationships as Situations: kinship, guardianship, ownership, trusteeship. A family office is an OrganizationAgent; each relationship is an apsit:Situation with agent role bindings + a typed body naming apfo: codelist concepts." .
+
+# ─── The organization ─────────────────────────────────────────────────────
+apfo:FamilyOffice a owl:Class ;
+    rdfs:subClassOf ap:OrganizationAgent ;
+    rdfs:label "Family Office" ;
+    rdfs:comment "The organization that stewards a family's wealth, entities, and relationships; its members are family members, advisors, and service providers. An OrganizationAgent (steward + member roster ride the aporg: membership Situations)." .
+
+# ─── Relationship situations (each ⊑ apsit:Situation) ─────────────────────
+apfo:FamilyOfficeRelation a owl:Class ;
+    rdfs:subClassOf apsit:Situation ;
+    rdfs:label "Family-office relationship" ;
+    rdfs:comment "Abstract base for a typed relationship between family-office members: a Situation with agent role bindings + a typed body. NOT a delegation and NOT a directory listing." .
+
+apfo:Kinship a owl:Class ;
+    rdfs:subClassOf apfo:FamilyOfficeRelation ;
+    rdfs:label "Kinship" ;
+    rdfs:comment "A family tie between two persons. Its kind (spouse/parent/child/sibling/…) is an apfo:kinshipKind concept in the body." .
+apfo:SpouseRelation a owl:Class ; rdfs:subClassOf apfo:Kinship ; rdfs:label "Spouse relation" ;
+    rdfs:comment "Symmetric — role slots apfo:spouseA and apfo:spouseB (canonical ordering for a stable hash)." .
+apfo:ParentChildRelation a owl:Class ; rdfs:subClassOf apfo:Kinship ; rdfs:label "Parent-child relation" ;
+    rdfs:comment "Directed — apfo:parent to apfo:child." .
+apfo:SiblingRelation a owl:Class ; rdfs:subClassOf apfo:Kinship ; rdfs:label "Sibling relation" ;
+    rdfs:comment "Symmetric — apfo:siblingA and apfo:siblingB." .
+
+apfo:Guardianship a owl:Class ;
+    rdfs:subClassOf apfo:FamilyOfficeRelation ;
+    rdfs:label "Guardianship" ;
+    rdfs:comment "A directed guardian→ward relationship (a legal guardian's oversight of a minor or dependent). The CANONICAL guardianship record — replaces the fragmented encoding (a kinship link in each person's vault plus a 0-bps custodial ownership edge). Role kind (e.g. LegalGuardian) is an apfo:roleKind concept in the body." .
+
+apfo:Ownership a owl:Class ;
+    rdfs:subClassOf apfo:FamilyOfficeRelation ;
+    rdfs:label "Ownership" ;
+    rdfs:comment "An owner's interest in an asset or entity — apfo:owner (agent) over apfo:ownedAsset (resource). Kind (sole/joint/beneficial/…) is an apfo:ownershipKind concept." .
+
+apfo:Trusteeship a owl:Class ;
+    rdfs:subClassOf apfo:FamilyOfficeRelation ;
+    rdfs:label "Trusteeship" ;
+    rdfs:comment "A trustee's fiduciary role over a trust entity — apfo:trustee (agent) over apfo:trust (resource). Role kind (trustee/successor-trustee) is an apfo:roleKind concept." .
+
+# ─── Role properties (the SituationRole slots; ranges are ap:Agent or resources) ──
+apfo:spouseA    a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "spouse A" .
+apfo:spouseB    a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "spouse B" .
+apfo:parent     a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "parent" .
+apfo:child      a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "child" .
+apfo:siblingA   a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "sibling A" .
+apfo:siblingB   a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "sibling B" .
+apfo:guardian   a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "guardian" ;
+    rdfs:comment "The guardian in an apfo:Guardianship." .
+apfo:ward       a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "ward" ;
+    rdfs:comment "The person under guardianship in an apfo:Guardianship." .
+apfo:owner      a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "owner" .
+apfo:ownedAsset a owl:ObjectProperty ; rdfs:label "owned asset" .
+apfo:trustee    a owl:ObjectProperty ; rdfs:range ap:Agent ; rdfs:label "trustee" .
+apfo:trust      a owl:ObjectProperty ; rdfs:label "trust" .
+
+# ─── Body annotation properties (ranges are the cbox concept schemes) ──────
+apfo:hasKinshipKind   a owl:ObjectProperty ; rdfs:label "has kinship kind" ;
+    rdfs:comment "The apfo:kinshipKind concept a Kinship situation names in its body." .
+apfo:hasRoleKind      a owl:ObjectProperty ; rdfs:label "has role kind" ;
+    rdfs:comment "The apfo:roleKind concept a Guardianship or Trusteeship names (e.g. apfo:LegalGuardian)." .
+apfo:hasOwnershipKind a owl:ObjectProperty ; rdfs:label "has ownership kind" ;
+    rdfs:comment "The apfo:ownershipKind concept an Ownership situation names in its body." .
+
+# ─── Bridge to the generic capability substrate (apfo ↔ aps) ───────────────
+apfo:advisoryCatalog a owl:ObjectProperty ;
+    rdfs:domain apfo:FamilyOffice ;
+    rdfs:range aps:CapabilityCatalog ;
+    rdfs:label "advisory catalog" ;
+    rdfs:comment "A family office's advisory catalog IS an aps:CapabilityCatalog — no new catalog type. Its advisors are aporg:OrganizationMembership members that aps:declaresCapability FROM it, so 'who advises on what' rides the generic capability plumbing (declared/claimed/demonstrated) rather than a bespoke advisor table." .

package/tbox/fulfillment.ttl

@@ -0,0 +1,140 @@
+# T-box — fulfillment vocabulary (spine Layers 10–12).
+# A2A Task + Message + Artifact aligned; spec 244 + spec 245.
+# Spec 225 §11.5.
+# Owning runtime SHACL: packages/fulfillment/src/shapes/fulfillment.shacl.ttl.
+
+@prefix apful:  <https://agenticprimitives.dev/ns/fulfillment#> .
+@prefix apagr:  <https://agenticprimitives.dev/ns/agreement#> .
+@prefix appay:  <https://agenticprimitives.dev/ns/payment#> .
+@prefix apvc:   <https://agenticprimitives.dev/ns/verifiable-credential#> .
+@prefix ap:     <https://agenticprimitives.dev/ns/core#> .
+@prefix rdfs:   <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl:    <http://www.w3.org/2002/07/owl#> .
+@prefix xsd:    <http://www.w3.org/2001/XMLSchema#> .
+@prefix prov:   <http://www.w3.org/ns/prov#> .
+
+apful: a owl:Ontology ;
+    rdfs:label "Agentic Primitives — fulfillment ontology" ;
+    owl:versionInfo "0.1.0" ;
+    rdfs:comment "Layers 10–12 of the spine. FulfillmentCase + Task + Message + Artifact + HandoffPolicy + IntentTraceSpan." .
+
+# ─── Operational containers (Layer 10) ────────────────────────────────
+
+apful:FulfillmentCase a owl:Class ;
+    rdfs:subClassOf prov:Activity ;
+    rdfs:label "FulfillmentCase" ;
+    rdfs:comment "Operational container per-Agreement. Lifecycle: drafted → clarified → expressed → acknowledged → proposed → accepted → committed → in_progress → fulfilled → validated → archived. FLF-INV-01: lifecycle synced with AgreementRegistry status." .
+
+apful:FulfillmentTopology a owl:Class ;
+    rdfs:label "FulfillmentTopology" ;
+    rdfs:comment "Task composition discriminator: 'linear' | 'parallel' | 'dag'." .
+
+# ─── Tasks (Layer 11; A2A-canonical) ──────────────────────────────────
+
+apful:Task a owl:Class ;
+    rdfs:subClassOf prov:Activity ;
+    rdfs:label "Task" ;
+    rdfs:comment "Executable unit of work inside a FulfillmentCase. A2A state machine: submitted | working | completed | failed | canceled | input-required | rejected | auth-required. Spec 245 + spec 244 §5." .
+
+apful:HandoffPolicy a owl:Class ;
+    rdfs:label "HandoffPolicy" ;
+    rdfs:comment "First-class authority binding for cross-agent handoffs. allowedTargets + allowedClasses + requiresUserApproval + preservePrivacyTier + allowedScopes + maxHopCount. FLF-6." .
+
+# ─── Communication vs deliverables (Layer 12 separation) ─────────────
+
+apful:Message a owl:Class ;
+    rdfs:label "Message" ;
+    rdfs:comment "A2A-style communication artifact. Bodies in JV per D-46.1. A2A-INV-04 + FLF-INV-04: NEVER in public registry." .
+
+apful:Artifact a owl:Class ;
+    rdfs:subClassOf prov:Entity ;
+    rdfs:label "Artifact" ;
+    rdfs:comment "A2A-style deliverable. Hash-anchored; body in vault. FLF-INV-05: bodies vault-resident; only hashes in registry. Promotable to EvidenceCredential." .
+
+apful:ArtifactKind a owl:Class ;
+    rdfs:label "ArtifactKind" ;
+    rdfs:comment "Kind discriminator: document | signed-tx | validation-report | receipt | summary | proof | generated-file | attestation | custom." .
+
+# ─── Provenance tree (cross-cutting, Decision 7 of ADR-0024) ─────────
+
+apful:IntentTraceSpan a owl:Class ;
+    rdfs:subClassOf prov:Activity ;
+    rdfs:label "IntentTraceSpan" ;
+    rdfs:comment "Typed trace span emitted on layer-cross transitions. Parent/child tree forms case audit (FLF-INV-15). spanType: parse | clarify | resolve | match | handoff | tool_call | wallet_simulation | user_approval | execution | validation | task_state_change | lifecycle_transition." .
+
+# ─── Properties ───────────────────────────────────────────────────────
+
+apful:hasParentAgreement a owl:ObjectProperty ;
+    rdfs:domain apful:FulfillmentCase ;
+    rdfs:range apagr:AgreementCommitment ;
+    rdfs:label "hasParentAgreement" .
+
+apful:topology a owl:DatatypeProperty ;
+    rdfs:domain apful:FulfillmentCase ;
+    rdfs:range xsd:string ;
+    rdfs:label "topology" .
+
+apful:taskState a owl:DatatypeProperty ;
+    rdfs:domain apful:Task ;
+    rdfs:range xsd:string ;
+    rdfs:label "taskState" ;
+    rdfs:comment "A2A canonical states. FLF-INV-13: no backward transitions except input-required→working and auth-required→submitted." .
+
+apful:assignee a owl:ObjectProperty ;
+    rdfs:domain apful:Task ;
+    rdfs:range ap:Agent ;
+    rdfs:label "assignee" .
+
+apful:assigneeKind a owl:DatatypeProperty ;
+    rdfs:domain apful:Task ;
+    rdfs:range xsd:string ;
+    rdfs:label "assigneeKind" ;
+    rdfs:comment "'person' | 'org' | 'agent' | 'oracle' | 'hybrid'." .
+
+apful:permissionGrantRef a owl:DatatypeProperty ;
+    rdfs:domain apful:Task ;
+    rdfs:range xsd:string ;
+    rdfs:label "permissionGrantRef" ;
+    rdfs:comment "FLF-INV-02: every Task has an authorizing delegation reference." .
+
+apful:paymentMandateRef a owl:ObjectProperty ;
+    rdfs:domain apful:Task ;
+    rdfs:range appay:PaymentMandate ;
+    rdfs:label "paymentMandateRef" ;
+    rdfs:comment "FLF-INV-11: payment mandate bound to this task via PMT-3 context binding (taskId)." .
+
+apful:sender a owl:ObjectProperty ;
+    rdfs:domain apful:Message ;
+    rdfs:range ap:Agent ;
+    rdfs:label "sender" .
+
+apful:bodyRef a owl:DatatypeProperty ;
+    rdfs:domain apful:Message ;
+    rdfs:range xsd:anyURI ;
+    rdfs:label "bodyRef" .
+
+apful:bodyHash a owl:DatatypeProperty ;
+    rdfs:domain apful:Artifact ;
+    rdfs:range xsd:hexBinary ;
+    rdfs:label "bodyHash" .
+
+apful:artifactKind a owl:DatatypeProperty ;
+    rdfs:domain apful:Artifact ;
+    rdfs:range xsd:string ;
+    rdfs:label "artifactKind" .
+
+apful:disclosurePolicy a owl:DatatypeProperty ;
+    rdfs:domain apful:Artifact ;
+    rdfs:range xsd:string ;
+    rdfs:label "disclosurePolicy" ;
+    rdfs:comment "Per-field DisclosurePolicy (D-42). JSON-encoded." .
+
+apful:spanType a owl:DatatypeProperty ;
+    rdfs:domain apful:IntentTraceSpan ;
+    rdfs:range xsd:string ;
+    rdfs:label "spanType" .
+
+apful:parentSpan a owl:ObjectProperty ;
+    rdfs:domain apful:IntentTraceSpan ;
+    rdfs:range apful:IntentTraceSpan ;
+    rdfs:label "parentSpan" .

package/tbox/geo.ttl

@@ -0,0 +1,28 @@
+# T-box — generic geo substrate (spec 251). The geo FEATURE is a public on-chain
+# definition (GeoFeatureRegistry; geometry hash + roots + coarse bbox, exact GeoJSON off
+# chain). The geo CLAIM (agent↔feature association) is an off-chain vault credential.
+# NEUTRAL public geography only — never operational/sensitivity data on chain; no on-chain
+# skill↔geo mapping.
+
+@prefix apg:  <https://agenticprimitives.dev/ns/geo#> .
+@prefix ap:   <https://agenticprimitives.dev/ns/core#> .
+@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+apg:GeoFeature a rdfs:Class ;
+    rdfs:label "GeoFeature" ;
+    rdfs:comment "A versioned, PUBLIC, generic geographic feature. Anchored on chain by GeoFeatureRegistry (geometryHash + coverage/source roots + coarse bbox; exact geometry off chain via metadataURI). Neutral public geography only." .
+
+apg:GeoClaim a rdfs:Class ;
+    rdfs:label "GeoClaim" ;
+    rdfs:comment "An OFF-CHAIN verifiable credential asserting a subject Smart Agent's relation to an apg:GeoFeature (pinned featureId+version). Private vault credential; the association is NEVER on chain (it would leak operational data)." .
+
+apg:featureId a rdf:Property ; rdfs:domain apg:GeoClaim ; rdfs:range apg:GeoFeature ;
+    rdfs:comment "The on-chain (featureId, version) this claim credential references." .
+apg:hasGeoKind a rdf:Property ; rdfs:domain apg:GeoFeature ;
+    rdfs:comment "An apg:geoKind value (C-box codelist; on-chain-bound)." .
+apg:geometryHash a rdf:Property ; rdfs:domain apg:GeoFeature ;
+    rdfs:comment "keccak256 of the canonical GeoJSON (which lives off chain)." .
+apg:claimSubject a rdf:Property ; rdfs:domain apg:GeoClaim ; rdfs:range ap:CanonicalAgentId .
+apg:claimRelation a rdf:Property ; rdfs:domain apg:GeoClaim ;
+    rdfs:comment "An apg:geoRelation value (C-box codelist)." .

package/tbox/governance.ttl

@@ -0,0 +1,67 @@
+@prefix apgov: <https://agenticprimitives.dev/ns/governance#> .
+@prefix ap:    <https://agenticprimitives.dev/ns/core#> .
+@prefix rdf:   <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl:   <http://www.w3.org/2002/07/owl#> .
+@prefix xsd:   <http://www.w3.org/2001/XMLSchema#> .
+@prefix prov:  <http://www.w3.org/ns/prov#> .
+@prefix skos:  <http://www.w3.org/2004/02/skos/core#> .
+
+<https://agenticprimitives.dev/ns/governance> a owl:Ontology ;
+    owl:versionInfo "0.1.0" ;
+    rdfs:label "Agentic Primitives — governance of the common model and of an estate (spec 410 §10)" ;
+    rdfs:comment "The twelfth principle's vocabulary: a shared term has a steward, a version and an adoption process; a participant may hold a LOCAL MEANING of a common term and both are recorded with their names; disputes have a path that does not run through the operator; who stewards what is public. Nothing here is authority — a steward record grants nothing, an adopted version is what a verifier binds, not who may act." .
+
+# ─── Versions and adoption ─────────────────────────────────────────────────────────────────────────
+
+apgov:AdoptedVersion a owl:Class ;
+    rdfs:subClassOf prov:Entity ;
+    rdfs:label "AdoptedVersion" ;
+    rdfs:comment "An ESTATE's adoption of one ontology manifest (spec 410 §5's `ONTOLOGY_MANIFEST_DIGEST`): which T-box set its verifiers bind into every mandate, adopted by a governance proposal (spec 410 §9) and anchored in the estate's public projection. A verifier redeeming a mandate reads the ESTATE's adopted manifest, never the package's latest — a T-box change is a proposal, not a deploy." .
+apgov:manifestDigest a owl:DatatypeProperty ;
+    rdfs:domain apgov:AdoptedVersion ; rdfs:range xsd:string ;
+    rdfs:label "manifestDigest" .
+apgov:adoptedAt a owl:DatatypeProperty ;
+    rdfs:domain apgov:AdoptedVersion ; rdfs:range xsd:dateTime ;
+    rdfs:label "adoptedAt" .
+apgov:proposalRef a owl:DatatypeProperty ;
+    rdfs:domain apgov:AdoptedVersion ; rdfs:range xsd:string ;
+    rdfs:label "proposalRef" ;
+    rdfs:comment "The governance proposal that adopted it (the timelock's operation id, spec 410 §9)." .
+
+# ─── Local meanings — two organizations, both right ───────────────────────────────────────────────
+
+apgov:LocalMeaning a owl:Class ;
+    rdfs:subClassOf skos:Concept ;
+    rdfs:label "LocalMeaning" ;
+    rdfs:comment "An organization's OWN meaning of a COMMON term, recorded as a SKOS mapping onto it — never a second class in the common T-box (ADR-0054: never a different semantic model per door). 'Member' may be a baptized adult to one organization and a household to another; both publish a LocalMeaning with skos:narrowMatch / skos:broadMatch / skos:relatedMatch to aporg:member and a scope note saying what differs; both are right; a grant issued by either names its own (the intent preimage's meaningRefs), so a third party reading the receipt sees which meaning the grant used. An organization with no LocalMeaning falls to the common term." .
+apgov:ofTerm a owl:ObjectProperty ;
+    rdfs:domain apgov:LocalMeaning ; rdfs:range rdfs:Resource ;
+    rdfs:label "ofTerm" ;
+    rdfs:comment "The COMMON term this is a local meaning of (an IRI of the shared T-box)." .
+apgov:heldBy a owl:ObjectProperty ;
+    rdfs:domain apgov:LocalMeaning ; rdfs:range ap:Agent ;
+    rdfs:label "heldBy" ;
+    rdfs:comment "The organization whose meaning it is — the record lives on ITS Smart Agent." .
+apgov:mappingRelation a owl:DatatypeProperty ;
+    rdfs:domain apgov:LocalMeaning ; rdfs:range xsd:string ;
+    rdfs:label "mappingRelation" ;
+    rdfs:comment "Which SKOS mapping predicate relates the local meaning to the common term: narrowMatch | broadMatch | relatedMatch. Never exactMatch (that would be no local meaning) and never a new class." .
+
+# ─── Stewardship of the model ─────────────────────────────────────────────────────────────────────
+
+apgov:Steward a owl:Class ;
+    rdfs:subClassOf prov:Entity ;
+    rdfs:label "Steward" ;
+    rdfs:comment "WHO STEWARDS WHAT, publicly: the Smart Agent named to resolve disagreements, manage versions and name exceptions for one term or module of the common model, registered through the term registry under the estate's governance and readable from the registry without a session (a steward's identity is public by construction, ADR-0040). A steward record grants nothing: a determination in a dispute (the dispute interaction profile) is evidence the run's provenance links, never a reversal." .
+apgov:stewards a owl:ObjectProperty ;
+    rdfs:domain apgov:Steward ; rdfs:range rdfs:Resource ;
+    rdfs:label "stewards" ;
+    rdfs:comment "The term or module IRI stewarded." .
+apgov:stewardAgent a owl:ObjectProperty ;
+    rdfs:domain apgov:Steward ; rdfs:range ap:Agent ;
+    rdfs:label "stewardAgent" .
+apgov:charterRef a owl:DatatypeProperty ;
+    rdfs:domain apgov:Steward ; rdfs:range xsd:string ;
+    rdfs:label "charterRef" ;
+    rdfs:comment "The estate charter (spec 410 §9) under which the steward was named — its hash as anchored." .

package/tbox/guidance.ttl

@@ -0,0 +1,40 @@
+# T-box — Agent Skill packages + repo guidance (spec 325 §2.1–2.2; ADR-0050, ADR-0051).
+# Agent Skills standard (SKILL.md) — NOT aps:CapabilityDefinition or A2A AgentSkill.
+
+@prefix apguide: <https://agenticprimitives.dev/ns/guidance#> .
+@prefix rdf:     <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs:    <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl:     <http://www.w3.org/2002/07/owl#> .
+
+apguide: a owl:Ontology ;
+    rdfs:label "Agentic Primitives — agent guidance ontology" ;
+    owl:versionInfo "0.2.0" ;
+    rdfs:comment "Agent Skill packages (SKILL.md) and repository guidance. Distinct from aps:CapabilityDefinition (ADR-0051)." .
+
+apguide:AgentGuidanceArtifact a owl:Class ;
+    rdfs:label "AgentGuidanceArtifact" ;
+    rdfs:comment "Markdown/file artifact steering a coding agent in IDE/CLI — not a signed runtime capability." .
+
+apguide:AgentSkillPackage a owl:Class ;
+    rdfs:subClassOf apguide:AgentGuidanceArtifact ;
+    rdfs:label "AgentSkillPackage" ;
+    rdfs:comment "Portable procedural package per Agent Skills standard (directory + SKILL.md). Runtime playbook — NOT A2A advertisement or OASF taxon." .
+
+apguide:AgentGuidanceSkill a owl:Class ;
+    owl:deprecated true ;
+    rdfs:subClassOf apguide:AgentSkillPackage ;
+    rdfs:label "AgentGuidanceSkill (deprecated)" ;
+    rdfs:comment "Deprecated alias for apguide:AgentSkillPackage (ADR-0051)." .
+
+apguide:RepositoryGuidanceDoc a owl:Class ;
+    rdfs:subClassOf apguide:AgentGuidanceArtifact ;
+    rdfs:label "RepositoryGuidanceDoc" ;
+    rdfs:comment "Repo-local agent context (CLAUDE.md, AGENTS.md). Not executable capability." .
+
+apguide:guidanceTarget a owl:ObjectProperty ;
+    rdfs:domain apguide:AgentGuidanceArtifact ;
+    rdfs:label "guidanceTarget" .
+
+apguide:hostedInRepository a owl:DatatypeProperty ;
+    rdfs:domain apguide:AgentGuidanceArtifact ;
+    rdfs:label "hostedInRepository" .

package/tbox/household.ttl

@@ -0,0 +1,142 @@
+# T-box — THE HOUSEHOLD (spec 363 W4).
+#
+# The smallest real domain that exercises every layer at once: classes (what a household IS), relation
+# axioms (how "my daughter's account" composes out of two links), and decisions (what a first name means
+# when it could be a person you live with or a stranger in a directory).
+#
+# WHY A HOUSEHOLD IS NOT AN AGENT. Every Smart Agent is a Person, an Organization or a Service
+# (ADR-0046), and a household is a body of people — so it is an Organization in the PROV sense, and it
+# MAY have an agent (a `.circle` or `.org` SA) exactly as any organization may. It need not: requiring
+# somebody to charter an agent, pay for its genesis and custody its keys before they can say who they
+# live with would be a tax on having a family. The household is a RECORD its members keep; an agent is
+# something a household may acquire when it starts acting as one.
+#
+# PRIVATE BY CONSTRUCTION. Who lives with whom is not on chain, is not derivable from chain state, and
+# therefore may never enter the discovery knowledge base (ADR-0040) — not hashed, not "temporarily", not
+# to make a lookup faster. It lives in each member's own vault (ADR-0025), which is also why this
+# ontology describes what a member RECORDS rather than a global fact: two people's households can
+# disagree, and the honest model says whose record you are reading.
+#
+# A FAMILY GRAPH IS EXACTLY THE DATA A PLATFORM SHOULD NOT HOLD. That is the reason for the tier, and it
+# is not a compliance posture: an estate that centralised this would not be worth using.
+
+@prefix aphh:  <https://agenticprimitives.dev/ns/household#> .
+@prefix ap:    <https://agenticprimitives.dev/ns/core#> .
+@prefix aporg: <https://agenticprimitives.dev/ns/org#> .
+@prefix skos:  <http://www.w3.org/2004/02/skos/core#> .
+@prefix rdf:   <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl:   <http://www.w3.org/2002/07/owl#> .
+@prefix xsd:   <http://www.w3.org/2001/XMLSchema#> .
+@prefix prov:  <http://www.w3.org/ns/prov#> .
+
+aphh: a owl:Ontology ;
+    rdfs:label "Agentic Primitives — Household" ;
+    rdfs:comment "The people someone lives with, as they record it: a private-tier body whose members may be agents, with roles and family relations that let a resolver understand 'my daughter' without a directory search (spec 363 W4)." .
+
+# ─── The body ─────────────────────────────────────────────────────────
+
+aphh:Household a owl:Class ;
+    rdfs:subClassOf prov:Organization ;
+    rdfs:label "Household" ;
+    rdfs:comment """A body of people who live as one — a family, a shared home, a house.
+
+      An ORGANIZATION in the PROV sense (a social entity with members), NOT a new agent class and not a
+      new kind of Smart Agent: the trichotomy stands (ADR-0046). It may be coordinated by an agent — a
+      `.circle` for a family that wants a shared inbox, an `.org` if it starts holding money — and it may
+      have none at all, which is the ordinary case and must stay free.
+
+      It is a RECORD ITS MEMBERS KEEP, not a global fact. Each member's vault holds their own household
+      record; two records may disagree, and the resolver always says whose it read.""" .
+
+aphh:HouseholdMembership a owl:Class ;
+    rdfs:subClassOf aporg:OrganizationMembership ;
+    rdfs:label "HouseholdMembership" ;
+    rdfs:comment """One person's place in one household, over a period, with a role.
+
+      A NODE, not an edge, for the same reason organization membership is one (ADR-0048): a role and a
+      period belong to the membership, not to the person. "Guardian" is not a property of somebody — it
+      is what they are IN this household, from a date, and possibly no longer.""" .
+
+aphh:memberOfHousehold a owl:ObjectProperty ;
+    rdfs:domain ap:Agent ; rdfs:range aphh:Household ;
+    rdfs:label "memberOfHousehold" ;
+    rdfs:comment """The households this agent belongs to — PLURAL, and meant so. A child between two
+      homes belongs to both; a carer's week is spent in one and their own life in another; a second home
+      is a household with people in it. A model that allowed only one would make somebody's second home
+      overwrite their first, which is a worse answer than not modelling it at all.
+
+      Private tier: never published, never indexed.""" .
+
+aphh:householdMember a owl:ObjectProperty ;
+    owl:inverseOf aphh:memberOfHousehold ;
+    rdfs:domain aphh:Household ; rdfs:range ap:Agent ;
+    rdfs:label "householdMember" ;
+    rdfs:comment "The agents in this household. The direction a resolver traverses to answer 'who do I live with'." .
+
+# ─── Roles and relations ──────────────────────────────────────────────
+#
+# A ROLE says what someone DOES in the household (who may decide for whom). A RELATION says how they are
+# KIN. They are different questions and conflating them is how a system decides that a spouse may act for
+# a spouse because the word sounded close enough. Neither is authority: a guardian's ability to act for a
+# dependent is a DELEGATION the dependent's custodian issued, and this vocabulary never substitutes for it.
+
+aphh:HouseholdRole a owl:Class ;
+    rdfs:subClassOf skos:Concept ;
+    rdfs:label "HouseholdRole" ;
+    rdfs:comment "What someone does in a household. NEVER authority — a guardian acts for a dependent only under a delegation, and this term is not one." .
+
+aphh:Guardian a aphh:HouseholdRole ;
+    skos:prefLabel "guardian" ;
+    rdfs:comment "Responsible for a dependent in this household. It does not grant the ability to act for them; it says who would be asked to." .
+
+aphh:Dependent a aphh:HouseholdRole ;
+    skos:prefLabel "dependent" ;
+    rdfs:comment "Cared for by a guardian of this household — a child, or an adult who has asked someone to hold that responsibility." .
+
+aphh:Member a aphh:HouseholdRole ;
+    skos:prefLabel "member" ;
+    rdfs:comment "An adult member with no dependency in either direction. The ordinary case, and the default." .
+
+aphh:householdRole a owl:ObjectProperty ;
+    rdfs:domain aphh:HouseholdMembership ; rdfs:range aphh:HouseholdRole ;
+    rdfs:label "householdRole" .
+
+aphh:KinRelation a owl:Class ;
+    rdfs:subClassOf skos:Concept ;
+    rdfs:label "KinRelation" ;
+    rdfs:comment """How one member is KIN to the person whose record this is.
+
+      DELIBERATELY SMALL. Kinship vocabularies are a well-known bottomless pit — step-, half-, in-law,
+      fostered, chosen, culture-specific — and a resolver needs exactly one thing from this: enough to
+      understand "my daughter" when somebody says it. So: the handful of words people actually use to
+      address a transfer, and `aphh:otherKin` with a free label for everything else, which is honest
+      about being a label rather than pretending to a taxonomy nobody agreed to.""" .
+
+aphh:spouse   a aphh:KinRelation ; skos:prefLabel "spouse" .
+aphh:child    a aphh:KinRelation ; skos:prefLabel "child" ;  skos:altLabel "daughter", "son" .
+aphh:parent   a aphh:KinRelation ; skos:prefLabel "parent" ; skos:altLabel "mother", "father" .
+aphh:sibling  a aphh:KinRelation ; skos:prefLabel "sibling" ; skos:altLabel "sister", "brother" .
+aphh:otherKin a aphh:KinRelation ; skos:prefLabel "relative" ;
+    rdfs:comment "Kin this vocabulary does not name. Carries the household's own label for the person, used verbatim and never re-interpreted." .
+
+aphh:kinRelation a owl:ObjectProperty ;
+    rdfs:domain aphh:HouseholdMembership ; rdfs:range aphh:KinRelation ;
+    rdfs:label "kinRelation" ;
+    rdfs:comment "How this member is kin to the record's owner. Absent for a housemate who is not kin, which is an ordinary household and not a gap." .
+
+# ─── The R-box: what composes out of the above ────────────────────────
+
+aphh:householdPayee a owl:ObjectProperty ;
+    owl:propertyChainAxiom ( aphh:householdMember ap:primaryPayee ) ;
+    rdfs:domain aphh:Household ; rdfs:range ap:Agent ;
+    rdfs:label "householdPayee" ;
+    rdfs:comment """The accounts a household's members want paid — a member, then the account that member
+      marked (ap:primaryPayee).
+
+      THIS IS WHY THE R-BOX EARNS ITS PLACE. "Send my daughter her allowance" is two links: the household
+      says who she is, her own mark says where her money goes. Written as an axiom, one traversal answers
+      it; written in code, every capability that ever needs it grows its own table and they drift.
+
+      IT COMPOSES TWO PREFERENCES AND NO PERMISSION. The chain says where money would LAND, never that
+      anyone may send it: the payment still needs a mandate the payer signs for that request.""" .