Functional Model Surfaces

Functional Model Surfaces is the SocioProphet standards spine for governed model, adapter, dataset, evaluation, guardrail, tool, agent, routing, promotion, and SourceOS carry contracts.

This repository defines contracts. It does not ship model weights, mutable adapters, runtime secrets, or SourceOS image state.

Role in the estate

The SocioProphet roadmap calls for AI/NLP collaboration, a community model zoo, prebuilt AI-as-a-Service models, reproducible project artifacts, knowledge engineering, and a central cloud-to-edge AI surface. This repository is the standards layer that lets those product surfaces become auditable software instead of disconnected experiments.

Plane	Repositories	Role
Standards	SocioProphet/functional-model-surfaces	Functional AI surface contracts and maturity gates.
Runtime	SocioProphet/prophet-platform	Graduated service implementation home.
CLI	SocioProphet/prophet-cli	User/operator command surface that consumes these contracts.
Governance	SocioProphet/model-governance-ledger, SocioProphet/guardrail-fabric, SocioProphet/model-router, SocioProphet/agent-registry	Promotion, policy, routing, guardrails, and agent authority.
OS carry	SourceOS-Linux/sourceos-model-carry	Carry-only references for SourceOS; no mutable model updates in OS images.
Labs	SociOS-Linux/*lab	Modality-specific workspaces that emit functional service manifests.
Workspace governance	SocioProphet/sociosphere, SocioProphet/workspace-inventory	Estate registration, validation, and maturity telemetry.

Doctrine

1. Foundation surfaces are organized by function first, then tuned for domain use.
2. Lab repos may train, tune, evaluate, and package evidence, but promotion requires governance.
3. SourceOS carries service references, launch profiles, cache policy, and refusal gates; it does not carry mutable model updates.
4. Every functional service must be auditable through datasets, adapters, evals, guardrails, routing policy, and ledger evidence.
5. Every active repo must emit a maturity record consumable by Sociosphere/workspace governance.

Contracts in this repo

Contract	Path	Purpose
Repository maturity	schemas/repo-maturity.schema.json	Standard scorecard for repo readiness.
Functional service	schemas/functional-service.schema.json	Manifest emitted by labs and consumed by runtime/governance.
Example maturity record	examples/repo.maturity.example.yaml	Copyable starting point for other repos.
This repo's maturity record	repo.maturity.yaml	Current maturity state for this standards repo.

Maturity gates

Level	Meaning
M0	Named repo only.
M1	README, purpose, ownership, license/status, roadmap.
M2	Schemas, examples, validation target, integration map.
M3	CI, tests, fixtures, security docs, integration evidence.
M4	Release artifacts, checksums, SBOM/provenance, signed releases.
M5	Operational readiness, upgrade/rollback, compatibility matrix, evidence export.

Local validation

make validate

First vertical slice

functional-model-surfaces -> lab repo -> model-governance-ledger -> model-router -> guardrail-fabric -> agent-registry -> sourceos-model-carry -> sociosphere

The proof condition is simple: a lab emits a functional service manifest, governance validates it, SourceOS carries the approved reference, and Sociosphere records maturity/evidence for the whole path.