Domain Model

Domain model

This page lists the exact schema shapes for gloria.dev’s core domain objects. Tool actions live on the MCP reference pages: Canary MCP Reference, Skills MCP Reference, and Health Checks. For the shared vocabulary, see Reference.

Dependency

Dependencies are defined as a discriminated union on kind.

Dependency definition (`DependencyDefinitionSchema`)

Field	Type	Required	Notes
kind	`external_saas` \| `internal_system`	yes	Discriminant.
slug	string	yes	Kebab-case identifier.
name	string	yes	Non-empty.
category	`Category`	yes	Dependency category enum.
purpose	string	yes	Non-empty.
endpoints	`Endpoint[]`	yes	Array of endpoint records.
healthCheck	`Probe`	no	Optional embedded probe.
details	object	yes	Shape depends on `kind`.

Dependency details by kind

`external_saas`

Field	Type	Required	Notes
webhooks	`Webhook[]`	yes	Array of webhook records.
provider	string	no	Optional provider identifier.

`internal_system`

Field	Type	Required	Notes
reachability	`Reachability`	yes	One of `public`, `vpc_internal`, `link_local`, `in_task_only`, `localhost_dev`.
addressEnv	string	no	Optional environment-variable name.

Webhook (`WebhookSchema`)

Field	Type	Required	Notes
event	string	yes	Non-empty.
direction	`inbound`	yes	Fixed literal.

Endpoint (`EndpointSchema`)

Field	Type	Required	Notes
label	string	yes	Non-empty.
url	string	yes	Non-empty.

Dependency row (`DependencyRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
projectId	string	yes	Owning project id.
kind	`external_saas` \| `internal_system`	yes	Discriminant.
slug	string	yes	Kebab-case identifier.
name	string	yes	Non-empty.
category	`Category`	yes	Same enum used by the definition.
purpose	string	yes	Non-empty.
endpoints	`Endpoint[]`	yes	Parsed from JSON.
details	object	yes	Kind-specific details object.
healthCheck	`Probe`	no	Optional embedded probe.
createdAt	number	yes	Unix seconds.
updatedAt	number	yes	Unix seconds.

Dependency summary (`DependencySummarySchema`)

Field	Type	Required	Notes
slug	string	yes	Public lookup key.
name	string	yes	Non-empty.
kind	`external_saas` \| `internal_system`	yes	Discriminant.
category	`Category`	yes	Same enum used by the definition.
purpose	string	yes	Non-empty.
healthCheck	`Probe`	no	Optional embedded probe.
status	`up` \| `degraded` \| `down` \| `unknown` \| `needs_config`	yes	Derived dependency status.
statusPage	`{ url: string; reachable: boolean \| null }`	no	Optional vendor status-page join.

Dependency enums

`kind`

Value	Notes
`external_saas`	External SaaS dependency.
`internal_system`	Internal system dependency.

`category`

Value	Notes
`auth_identity`	Auth & Identity.
`git_hosting`	Git Hosting.
`issue_tracking`	Issue Tracking.
`communication`	Communication.
`cloud_storage`	Cloud Storage.
`llm_ai`	LLM / AI.
`observability`	Observability.
`datastore`	Datastore.
`llm_gateway`	LLM Gateway.
`aws_platform`	AWS Platform.
`app_service`	App Service.
`dev_tooling`	Dev Tooling.

Health Check

Health checks are dependency-embedded probes, plus the stored result and rollup rows.

Secret value (`SecretValueSchema`)

Field	Type	Required	Notes
kind	`literal` \| `secret`	yes	Discriminant.
value	string	conditional	Present only when `kind` is `literal`.
ref	string	conditional	Present only when `kind` is `secret`.
hint	string	conditional	Present only when `kind` is `secret`.
configured	boolean	conditional	Present only when `kind` is `secret`.

Dependency health check (`ProbeSchema`)

Field	Type	Required	Notes
type	enum	yes	See probe types below.
enabled	boolean	yes	Defaults to `true`.
timeoutMs	integer	yes	Positive integer; defaults to `5000`.
method	`GET` \| `HEAD` \| `POST`	conditional	`http` and `http-bearer`.
url	string	conditional	`http` and `http-bearer`.
expectedStatus	`{ min: number; max: number }`	conditional	`http` and `http-bearer`; defaults to `{ min: 200, max: 299 }`.
token	`SecretValue`	conditional	`http-bearer`, `github`, `gitlab`, `bitbucket`, `notion`, `slack`.
apiKey	`SecretValue`	conditional	`openai`, `anthropic`, `linear`.
secretKey	`SecretValue`	conditional	`clerk`.
region	`SecretValue`	conditional	`aws`, `aws-kms`, `aws-bedrock`, `aws-cloudwatch-logs`, `aws-secrets-manager`.
accessKeyId	`SecretValue`	conditional	`aws`, `aws-kms`, `aws-bedrock`, `aws-cloudwatch-logs`, `aws-secrets-manager`.
secretAccessKey	`SecretValue`	conditional	`aws`, `aws-kms`, `aws-bedrock`, `aws-cloudwatch-logs`, `aws-secrets-manager`.
keyId	`SecretValue`	conditional	Optional on `aws-kms`.
host	string	conditional	`atlassian`.
email	`SecretValue`	conditional	`atlassian`.

Probe types

Value	Notes
`http`	Plain HTTP probe.
`http-bearer`	HTTP probe with secret token.
`github`	GitHub credential check.
`aws`	AWS credential check.
`openai`	OpenAI credential check.
`anthropic`	Anthropic credential check.
`notion`	Notion credential check.
`gitlab`	GitLab credential check.
`bitbucket`	Bitbucket credential check.
`clerk`	Clerk credential check.
`linear`	Linear credential check.
`slack`	Slack credential check.
`atlassian`	Atlassian Cloud credential check.
`aws-kms`	AWS KMS check.
`aws-bedrock`	AWS Bedrock check.
`aws-cloudwatch-logs`	AWS CloudWatch Logs check.
`aws-secrets-manager`	AWS Secrets Manager check.

Health-check result (`HealthCheckResultRowSchema`)

Field	Type	Required	Notes
id	string	yes	Result id.
projectId	string	yes	Owning project id.
dependencyId	string	yes	Owning dependency id.
status	`up` \| `degraded` \| `down`	yes	Result status.
httpStatus	integer	no	Nullable HTTP status code.
latencyMs	integer	no	Nullable latency in milliseconds.
error	string	no	Nullable error text.
checkedAt	integer	yes	Unix seconds.

Health-check rollup (`HealthCheckRollupRowSchema`)

Field	Type	Required	Notes
dependencyId	string	yes	Owning dependency id.
granularity	`hourly`	yes	`RollupGranularitySchema` currently only permits `hourly`.
bucketStart	integer	yes	Unix seconds at bucket start.
projectId	string	yes	Owning project id.
countUp	integer	yes	Count of `up` results.
countDegraded	integer	yes	Count of `degraded` results.
countDown	integer	yes	Count of `down` results.
latencyCount	integer	yes	Count of latency samples.
latencySum	integer	yes	Sum of latency samples.
latencyMin	integer	no	Nullable minimum latency.
latencyMax	integer	no	Nullable maximum latency.
updatedAt	integer	yes	Unix seconds.

Feature map

Feature map records capture the product features a project tracks, the files and symbols that implement them, and the commit that last analyzed each feature.

Feature definition (`FeatureDefinitionSchema`)

Field	Type	Required	Notes
slug	string	yes	Kebab-case identifier.
name	string	yes	Non-empty.
description	string	yes	Non-empty.
layer	string	yes	Non-empty.
userFacing	boolean	yes	Public-facing feature flag.
aliases	string[]	yes	Non-empty strings.
files	string[]	yes	Non-empty strings.
symbols	string[]	yes	Non-empty strings.
docUrls	string[]	yes	Non-empty strings.
analyzedCommit	string	yes	Commit SHA last used to analyze the feature.

Feature detail (`FeatureDetail`)

Field	Type	Required	Notes
slug	string	yes	Kebab-case identifier.
name	string	yes	Non-empty.
description	string	yes	Non-empty.
layer	string	yes	Non-empty.
userFacing	boolean	yes	Public-facing feature flag.
aliases	string[]	yes	Non-empty strings.
files	string[]	yes	Non-empty strings.
symbols	string[]	yes	Non-empty strings.
docUrls	string[]	yes	Non-empty strings.
analyzedCommit	string	yes	Commit SHA last used to analyze the feature.
createdAt	number	yes	Unix seconds.
updatedAt	number	yes	Unix seconds.

Feature index entry (`FeatureIndexEntry`)

Field	Type	Required	Notes
slug	string	yes	Public lookup key.
name	string	yes	Non-empty.
description	string	yes	Non-empty.
layer	string	yes	Non-empty.
userFacing	boolean	yes	Public-facing feature flag.
aliases	string[]	yes	Non-empty strings.

Coding standards

Coding standards records group rules, reusable snippets, check runs, findings, and notices around a project.

Rule authority (`RuleAuthoritySchema`)

Value	Notes
`enforced`	Violations fail the check.
`stated`	The rule records documented intent.
`observed`	The rule matches current code and allows documented divergence.

Standards entity status (`StandardsEntityStatusSchema`)

Value	Notes
`active`	The record is current.
`stale`	The record needs review.
`retired`	The record no longer applies.

Check kind (`CheckKindSchema`)

Value	Notes
`diff`	Diff-based check.
`audit`	Audit check.
`metadata`	Metadata-based check.

Check trigger (`CheckTriggerSchema`)

Value	Notes
`pr`	Pull request trigger.
`manual`	Manual trigger.
`cron`	Scheduled trigger.

Finding type (`FindingTypeSchema`)

Value	Notes
`rule_violation`	A rule does not match the code.
`rule_stale`	A rule needs refresh.
`render_stale`	The rendered standards stamp lags the current version.
`snippet_stale`	A snippet needs refresh.
`unattributed_duplication`	Code duplicates a snippet without attribution.

Finding status (`FindingStatusSchema`)

Value	Notes
`open`	The finding still applies.
`resolved`	The finding no longer applies.
`dismissed`	The finding stays ignored.

Standards notice event (`StandardsNoticeEventSchema`)

Value	Notes
`standards.check_overdue`	The last check ran too long ago.
`standards.drift_threshold`	Drift crossed the notice threshold.

Standard row (`StandardRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
projectId	string	yes	Owning project id.
version	number	yes	Standards version.
renderedStamp	number	no	Nullable version last rendered into `CLAUDE.md` or `AGENTS.md`.
createdAt	number	yes	Unix seconds.
updatedAt	number	yes	Unix seconds.

Rule scope (`RuleScopeSchema`)

Field	Type	Required	Notes
globs	string[]	no	Optional glob list.
packages	string[]	no	Optional package list.

Rule evidence (`RuleEvidenceSchema`)

Field	Type	Required	Notes
sources	string[]	yes	Evidence source list.

Rule row (`RuleRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
projectId	string	yes	Owning project id.
ruleId	string	yes	Stable kebab-case slug, unique per project.
instruction	string	yes	Rule text.
authority	`RuleAuthority`	yes	Rule binding level.
scope	`RuleScope`	yes	Optional scope details.
evidence	`RuleEvidence`	yes	Evidence sources.
status	`StandardsEntityStatus`	yes	Lifecycle status.
createdAt	number	yes	Unix seconds.
updatedAt	number	yes	Unix seconds.

Snippet row (`SnippetRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
projectId	string	yes	Owning project id.
snippetId	string	yes	Stable kebab-case slug, unique per project.
language	string	yes	Target language.
name	string	yes	Snippet name.
description	string	yes	Snippet description.
code	string	yes	Placeholder-ized canonical code.
placeholders	string[]	yes	Placeholder names.
status	`StandardsEntityStatus`	yes	Lifecycle status.
createdAt	number	yes	Unix seconds.
updatedAt	number	yes	Unix seconds.

Check scope detail (`CheckScopeDetailSchema`)

Field	Type	Required	Notes
diffRange	string	no	Optional diff range.
prRef	string	no	Optional pull request reference.

Check run row (`CheckRunRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
projectId	string	yes	Owning project id.
kind	`CheckKind`	yes	Check type.
triggeredBy	`CheckTrigger`	yes	Trigger source.
standardsVersionChecked	number	yes	Standards version under check.
scopeDetail	`CheckScopeDetail`	yes	Diff or PR scope detail.
startedAt	number	yes	Unix seconds.
completedAt	number	no	Nullable completion time.

Check finding row (`CheckFindingRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
checkRunId	string	yes	Owning check run id.
projectId	string	yes	Owning project id.
type	`FindingType`	yes	Finding type.
ruleId	string	no	Rule slug for rule findings.
snippetId	string	no	Snippet slug for snippet findings.
file	string	no	File path under review.
line	number	no	Line number in the file.
detail	string	yes	Human-readable finding detail.
status	`FindingStatus`	yes	Finding lifecycle status.
createdAt	number	yes	Unix seconds.
resolvedAt	number	no	Nullable resolution time.

Standards notice row (`StandardsNoticeRowSchema`)

Field	Type	Required	Notes
id	string	yes	Storage id.
projectId	string	yes	Owning project id.
event	`StandardsNoticeEvent`	yes	Notice event name.
detail	string	yes	Human-readable detail.
createdAt	number	yes	Unix seconds.

Skill

Skills are versioned bundles of files plus frontmatter, with related marketplace and installation records.

Skill file (`SkillFileSchema`)

Field	Type	Required	Notes
path	string	yes	Safe relative path.
content	string	yes	File content.

Skill frontmatter (`SkillFrontmatterSchema`)

Field	Type	Required	Notes
name	string	yes	Non-empty.
description	string	yes	Non-empty.
tags	string \| string[]	no	Optional; parsed from a scalar or array. Unknown keys are stripped.

Skill bundle (`SkillBundleSchema`)

Field	Type	Required	Notes
files	`SkillFile[]`	yes	At least one file; the bundle must include a root `SKILL.md`.

Parsed skill bundle (`ParsedBundle`)

Field	Type	Required	Notes
name	string	yes	Parsed from root frontmatter.
description	string	yes	Parsed from root frontmatter.
slug	string	yes	Derived from `name`.
tags	string[]	yes	Normalized, deduplicated, and capped at 10.
files	`SkillFile[]`	yes	The bundle files.

Skill manifest entry (`ManifestEntry`)

Field	Type	Required	Notes
path	string	yes	Relative file path.
size	number	yes	UTF-8 byte length.
hash	string	yes	Deterministic file hash.

Skill summary (`SkillSummary`)

Field	Type	Required	Notes
slug	string	yes	Skill slug.
name	string	yes	Skill name.
description	string	yes	Skill description.
latestVersion	number	yes	Latest published version.
updatedAt	integer	yes	Unix seconds.
author	string	yes	Stored author label.
tags	string[]	yes	Normalized tags.
source	string	no	Marketplace source id in the form `marketplace:<id>`.
marketplace	string	no	Marketplace id when present.
plugin	string	no	Marketplace plugin id when present.
supportedAgents	string[]	no	Agents that can install the skill when sourced from a marketplace.

Skill version detail (`SkillVersionDetail`)

Field	Type	Required	Notes
version	number	yes	Version number.
name	string	yes	Skill name.
description	string	yes	Skill description.
contentHash	string	yes	Bundle hash.
manifest	`ManifestEntry[]`	yes	Parsed manifest array.
createdBy	string	yes	Creator id.
createdAt	integer	yes	Unix seconds.

Marketplace agent (`MarketplaceAgent`)

Value	Notes
`claude-code`	Supported marketplace agent.
`codex`	Supported marketplace agent.

Marketplace status (`MarketplaceStatus`)

Value	Notes
`syncing`	Subscription is still indexing.
`active`	Subscription is indexed.
`error`	Last sync failed.

Marketplace (`Marketplace`)

Field	Type	Required	Notes
id	string	yes	Storage id.
orgId	string	yes	Owning org id.
name	string	yes	Marketplace name.
repoUrl	string	yes	Canonical GitHub repository URL.
manifestName	string	no	Manifest `name`; may be null until the first index resolves it.
supportedAgents	`MarketplaceAgent[]`	yes	Supported agent subset.
status	`MarketplaceStatus`	yes	Sync lifecycle.
lastSyncedAt	integer	no	Nullable Unix seconds.
lastError	string	no	Nullable last error text.
createdAt	integer	yes	Unix seconds.
updatedAt	integer	yes	Unix seconds.

Marketplace skill (`MarketplaceSkill`)

Field	Type	Required	Notes
id	string	yes	Storage id.
marketplaceId	string	yes	Owning marketplace id.
plugin	string	yes	Plugin name.
slug	string	yes	Skill slug.
name	string	yes	Skill name.
description	string	yes	Skill description.
tags	string[]	yes	Parsed tag list.
upstreamPath	string	yes	Path in the upstream repo.
updatedAt	integer	yes	Unix seconds.

Skill installation (`SkillInstallation`)

Field	Type	Required	Notes
id	string	yes	Storage id.
orgId	string	yes	Owning org id.
skillId	string	yes	Installed skill id.
version	number	yes	Installed version number.
userId	string	yes	Installing user id.
installedAt	integer	yes	Unix seconds.

Want to go deeper? Head over to Reference.

Domain model

Dependency

Dependency definition (DependencyDefinitionSchema)

Dependency details by kind

external_saas

internal_system

Webhook (WebhookSchema)

Endpoint (EndpointSchema)

Dependency row (DependencyRowSchema)

Dependency summary (DependencySummarySchema)

Dependency enums

kind

category

Health Check

Secret value (SecretValueSchema)

Dependency health check (ProbeSchema)

Probe types

Health-check result (HealthCheckResultRowSchema)

Health-check rollup (HealthCheckRollupRowSchema)

Feature map

Feature definition (FeatureDefinitionSchema)

Feature detail (FeatureDetail)

Feature index entry (FeatureIndexEntry)

Coding standards

Rule authority (RuleAuthoritySchema)

Standards entity status (StandardsEntityStatusSchema)

Check kind (CheckKindSchema)

Check trigger (CheckTriggerSchema)

Finding type (FindingTypeSchema)

Finding status (FindingStatusSchema)

Standards notice event (StandardsNoticeEventSchema)

Standard row (StandardRowSchema)

Rule scope (RuleScopeSchema)

Rule evidence (RuleEvidenceSchema)

Rule row (RuleRowSchema)

Snippet row (SnippetRowSchema)

Check scope detail (CheckScopeDetailSchema)

Check run row (CheckRunRowSchema)

Check finding row (CheckFindingRowSchema)

Standards notice row (StandardsNoticeRowSchema)