Skip to manual
gluon

GOL language

Validation diagnostics

Every registered GLN diagnostic with its cause, fix and example.

Model author or developer

Each diagnostic names a code, a file, a line and a column. In the designer, click the code badge for the same explanation. An error blocks validation. The conventions block in gluon.yaml can raise a warning to an error, and errors stay errors.

All diagnostics

GLN-E001

severity: error

meaning: YAML does not parse

pass: 0 Syntax

lowerable: false

cause: A file is not valid YAML: an indent that does not line up, an unclosed bracket or quote, a tab, or a key written twice in one mapping.

fix: Fix the text at the line and column shown. The designer keeps your text and the canvas keeps the last saved state until the file parses.

example:

Console / text
spec:
  properties:
    name: string
     title: string   # one space too many

GLN-E002

severity: error

meaning: Document is not a mapping

pass: 0 Syntax

lowerable: false

cause: A document in the file is a list or a plain value instead of a mapping with apiVersion, kind, metadata and spec.

fix: Make each document a mapping; separate documents with a line of three dashes.

example:

Console / text
- kind: ObjectType   # a list, not a document

GLN-E003

severity: error

meaning: File is not UTF-8

pass: 0 Syntax

lowerable: false

cause: The file is saved in an encoding other than UTF-8 (Latin-1 from an old editor, UTF-16).

fix: Save the file as UTF-8 without a byte order mark.

example:

Console / text
(bytes such as 0xE9 on their own)

GLN-E005

severity: error

meaning: YAML 1.1 boolean word used as a key or bare value

pass: 0 Syntax

lowerable: false

cause: A YAML 1.1 boolean word (yes, no, on, off, y, n) is used as a key or a bare value; parsers disagree on whether it is text or a boolean.

fix: Quote it when you mean text, or write true or false when you mean a boolean.

example:

Console / text
values:
  on: {title: On}      # write "on": {title: On}

GLN-E010

severity: error

meaning: Resource does not match the JSON Schema for its kind

pass: 1 Schema

lowerable: false

cause: The resource does not match the JSON Schema of its kind: a misspelt key, a missing required key or a value of the wrong shape.

fix: Read the pointer in the message; the YAML editor offers the keys the kind allows.

example:

Console / text
spec:
  propertes:        # properties
    name: string

GLN-E012

severity: error

meaning: metadata.domain contradicts the directory

pass: 1 Schema

lowerable: false

cause: metadata.domain names a different domain than the folder the file sits in.

fix: Move the file under domains// or drop metadata.domain; the folder decides.

example:

Console / text
# domains/sales/objects/order.yaml
metadata: {name: Order, domain: finance}

GLN-E013

severity: error

meaning: Duplicate name

pass: 1 Schema

lowerable: false

cause: Two elements of the same kind family share a name in one domain (or two flat resources share one).

fix: Rename one of them; names are unique per domain so references never need a search.

example:

Console / text
# two files both declaring
metadata: {name: Contract}

GLN-E014

severity: error

meaning: Dependency alias equals a local domain name

pass: 1 Schema

lowerable: false

cause: A dependency alias in gluon.yaml has the same name as a local domain, so references would be ambiguous.

fix: Choose another alias for the dependency.

example:

Console / text
dependencies:
  - {package: acme/core, alias: core}   # a local domain is called core

GLN-E015

severity: error

meaning: A convention tries to lower an error that cannot be lowered

pass: 1 Schema

lowerable: false

cause: Package conventions try to lower the severity of an error that may not be lowered: passes 0 to 2 and the security errors stay errors.

fix: Remove the entry from conventions and fix the cause instead.

example:

Console / text
conventions:
  GLN-E101: warning   # not allowed

GLN-E101

severity: error

meaning: Unresolved reference

pass: 2 References

lowerable: false

cause: A reference names an element that does not exist, usually a typo or an element renamed elsewhere.

fix: Apply the quick fix when it suggests the name you meant, or create the element.

example:

Console / text
from: {type: party.Suplier}   # Did you mean party.Supplier?

GLN-E102

severity: error

meaning: Alias is not a declared dependency

pass: 2 References

lowerable: false

cause: A reference uses an alias that is not declared as a dependency in gluon.yaml.

fix: Declare the dependency with that alias, or use a local name.

example:

Console / text
type: acme::party.Customer

GLN-E103

severity: error

meaning: Reference cycle

pass: 2 References

lowerable: false

cause: References form a cycle that cannot be resolved (a type extending itself, segments requiring each other).

fix: Break the cycle at one of the elements the message lists.

example:

Console / text
spec:
  extends: [Agreement]   # in Agreement itself

GLN-E105

severity: error

meaning: Reference in text has an unknown modifier or one its kind does not take

pass: 2 References

lowerable: false

cause: A {{ref}} in a skill's text has a modifier that does not exist or that its target does not take.

fix: Use description on anything, properties on an object, interface or struct, values on an enum or an enum-typed member.

example:

Console / text
prompt: Use {{procurement.Contract | values}}   # Contract is not an enum

GLN-E201

severity: error

meaning: CEL expression does not parse or calls an unknown function

pass: 3 Types

lowerable: true

cause: A CEL expression does not parse, or calls a function Gluon does not provide.

fix: Check brackets and quotes; the functions are listed in the GOL spec (gluon.today(), has(), ...).

example:

Console / text
expr: "self.value > "   # incomplete

GLN-E202

severity: error

meaning: CEL type mismatch

pass: 3 Types

lowerable: true

cause: A CEL expression compares or combines values of types that do not fit (a date with a string).

fix: Convert one side, or compare the right property.

example:

Console / text
expr: "self.expiryDate > 'soon'"

GLN-E203

severity: error

meaning: CEL expression reads a member that does not exist

pass: 3 Types

lowerable: true

cause: A CEL expression reads a member that the type does not have.

fix: Use an existing property name; the expression path in the message shows where.

example:

Console / text
expr: "self.noSuchProp > 0"

GLN-E204

severity: error

meaning: Type referenced outside the domain's context map

pass: 3 Types

lowerable: true

cause: A domain uses a type from another domain that its context map does not allow.

fix: Add the domain to the context map, or use a type of your own domain.

example:

Console / text
type: finance.Invoice   # finance is not in procurement's contextMap

GLN-E205

severity: error

meaning: Value is not a member of the enum

pass: 3 Types

lowerable: true

cause: A value is not one of the enum's members.

fix: Use a declared member, or add it to the enum.

example:

Console / text
default: pending   # ContractState has draft, active, expiring, expired

GLN-E207

severity: error

meaning: Default does not match the property type

pass: 3 Types

lowerable: true

cause: A property's default does not match its type.

fix: Give a default of the declared type.

example:

Console / text
amount: {type: decimal, default: "none"}

GLN-E211

severity: error

meaning: Primary key type not allowed

pass: 3 Types

lowerable: true

cause: A primary key property has a type keys may not have (a struct, a list, a float).

fix: Use a string, uuid, integer or an identifier value type.

example:

Console / text
identity: {primaryKey: [price]}

GLN-E212

severity: error

meaning: Foreign key type differs from the referenced key

pass: 3 Types

lowerable: true

cause: A foreign key property has a different type than the key it references.

fix: Give the holder property the key's type.

example:

Console / text
backing: {kind: foreignKey, holder: to, property: supplierCode}   # Supplier's key is a uuid

GLN-E213

severity: error

meaning: Identity names a property that does not exist

pass: 3 Types

lowerable: true

cause: identity names a property the type does not declare.

fix: Name an existing property, or add it.

example:

Console / text
identity: {primaryKey: [contractNo]}   # the property is contractNumber

GLN-E214

severity: error

meaning: Derived property traverses more than 3 link hops

pass: 3 Types

lowerable: true

cause: A derived property follows more than three link hops, which Gluon will not compute at query time.

fix: Shorten the path, or store the value through a source.

example:

Console / text
derived: {from: self.supplier.parent.country.region.name}

GLN-E221

severity: error

meaning: Interface member not mapped

pass: 3 Types

lowerable: true

cause: A type implements an interface but leaves one of its properties unmapped.

fix: Map the property in the Interfaces tab, or add a local property of the same name.

example:

Console / text
implements:
  - interface: core.Agreement
    map: {endsOn: expiryDate}   # startsOn missing

GLN-E222

severity: error

meaning: Interface mapping type mismatch

pass: 3 Types

lowerable: true

cause: An interface property is mapped to a local property of another type.

fix: Map it to a property of the interface's type.

example:

Console / text
map: {endsOn: ownerId}   # date expected, string

GLN-E223

severity: error

meaning: Interface link constraint not satisfied

pass: 3 Types

lowerable: true

cause: A link the interface requires is missing or points at the wrong type.

fix: Map the interface link role to a link of the right target and multiplicity.

example:

Console / text
links: {counterparty: owner}   # must reach party.LegalEntity

GLN-E231

severity: error

meaning: Aggregate member key does not include the root key

pass: 3 Types

lowerable: true

cause: An aggregate member's key does not include its root's key, so members cannot be found from the root.

fix: Add the root key to the member's primary key.

example:

Console / text
aggregate: {role: member, root: Contract}
identity: {primaryKey: [eventId]}   # add contractId

GLN-E233

severity: error

meaning: Composition link crosses aggregates

pass: 3 Types

lowerable: true

cause: A composition link joins two aggregates; composition only lives inside one aggregate.

fix: Use an association between aggregates.

example:

Console / text
semantics: composition   # Contract to Supplier

GLN-E242

severity: error

meaning: Lifecycle transition to an unknown state

pass: 3 Types

lowerable: true

cause: A lifecycle transition names a state its enum does not have.

fix: Use a declared state; the designer's pickers offer only those.

example:

Console / text
- {from: active, to: archived}

GLN-E251

severity: error

meaning: Action effect touches a missing or non-editable member

pass: 3 Types

lowerable: true

cause: An action effect sets a property that the target does not have, or one that is not editable.

fix: Set an existing, editable property.

example:

Console / text
set: {expiryDat: params.newExpiry}   # expiryDate

GLN-E252

severity: error

meaning: Interface effect not permitted by an implementer

pass: 3 Types

lowerable: true

cause: An interface action's effect is not allowed by one of the types implementing the interface.

fix: Make the implementer's property editable, or narrow the interface effect.

example:

Console / text
actions: [Renew]   # an implementer's endsOn is immutable

GLN-E261

severity: error

meaning: Extension removes or retypes a member

pass: 3 Types

lowerable: true

cause: An Extension removes or changes the type of a member of the type it extends.

fix: Extensions only add; change the base type through a proposal instead.

example:

Console / text
kind: Extension
spec: {target: Contract, properties: {state: string}}

GLN-E271

severity: error

meaning: Output skill carries a key only an answer skill takes

pass: 3 Types

lowerable: true

cause: A skill of use: output carries a key only an answer skill takes (triggers, evidence, checks, runs and so on).

fix: Keep prompt, output, pii and tests on the output skill; move the rest to an answer skill.

example:

Console / text
kind: Skill
spec: {use: output, prompt: Write a brief., evidence: [{search: true}]}

GLN-E272

severity: error

meaning: Evidence argument is not a literal, $entity. or $question.

pass: 3 Types

lowerable: true

cause: An evidence argument is something other than a literal, $entity. or $question., so it could carry text from elsewhere to a remote tool.

fix: Use a literal, the plan's entity of a type, or a named question input.

example:

Console / text
args: {customerId: $history.lastCustomer}

GLN-E273

severity: error

meaning: Capability output names a skill that is not an output skill

pass: 3 Types

lowerable: true

cause: A Capability's output names a skill whose use is answer.

fix: Point output at a skill of use: output, or change that skill's use.

example:

Console / text
output: "skill:assess-renewal-risk"   # an answer skill

GLN-E274

severity: error

meaning: Source is named by more than one ExtractionProfile

pass: 3 Types

lowerable: true

cause: Two ExtractionProfiles list the same source in spec.sources, so which profile its content is read under would depend on file order.

fix: Keep the source in one profile's sources, or merge the two profiles' focus into one.

example:

Console / text
sources: ["source:shared-drive"]   # already in extraction-profile:procurement-documents

GLN-E401

severity: error

meaning: Source mapping targets a property that does not exist

pass: 5 Sources

lowerable: true

cause: A source mapping writes to a property the type does not have.

fix: Map to an existing property or add the property.

example:

Console / text
map: {totalValue: TOTAL}   # property is value

GLN-E402

severity: error

meaning: Record link names a property the type does not have

pass: 5 Sources

lowerable: true

cause: A source mapping's recordUrl has a {placeholder} that is not a property of the type, so the link to the record in its source system cannot be filled.

fix: Name a property of the type in the braces, usually its key, or add the property.

example:

Console / text
recordUrl: "https://erp.example/contracts/{contractNo}"   # property is contractnummer

GLN-E411

severity: error

meaning: Conversational source populates a property without acceptConversational

pass: 5 Sources

lowerable: true

cause: A conversational source (mail, chat) fills a property without acceptConversational, so hearsay would become fact.

fix: Map it from a system of record, or set acceptConversational: true, which the proposal's access-widening report then shows to a security approver.

example:

Console / text
sources:
  - {source: "source:outlook-mail", map: {title: SUBJECT}}

GLN-E412

severity: error

meaning: Resolution key does not exist

pass: 5 Sources

lowerable: true

cause: An entity resolution rule names a key the type does not have.

fix: Use an existing property.

example:

Console / text
resolution: {keys: [[vatNo]]}   # the property is vatNumber

GLN-E461

severity: error

meaning: Query reads a column its return type does not map

pass: 5 Sources

lowerable: true

cause: A Query selects a column that its return type does not map from the Query's source, so the column would reach a reader with no property, policy or mask on it.

fix: Map the column on the type's sources[] entry for that source, or drop it from the select list.

example:

Console / text
sql: select CONTRACT_NO, SECRET_NOTE from PROC.CONTRACTS   # SECRET_NOTE is not mapped

GLN-E462

severity: error

meaning: Query placeholder has no input

pass: 5 Sources

lowerable: true

cause: A :placeholder in a Query's sql has no input of that name.

fix: Add the input, or fix the placeholder's spelling.

example:

Console / text
inputs: {supplierId: uuid}
sql: ... where SUPPLIER_ID = :supplier

GLN-E463

severity: error

meaning: Query input is never used and not optional

pass: 5 Sources

lowerable: true

cause: A Query input is never used in its sql and is not declared optional.

fix: Use it as :name, remove it, or declare it required: false or give it a default.

example:

Console / text
inputs: {supplierId: uuid, region: string}   # :region never appears

GLN-E465

severity: error

meaning: Query returning a struct reads a table no type maps

pass: 5 Sources

lowerable: false

cause: A Query that returns a struct is an aggregate, and its SQL reads a table that no ObjectType maps from the Query's source, or SQL that cannot be parsed. A table no type maps has no policy and no mask.

fix: Map the table: name it in a type's sources[].table as schema.table. Or read a table a type already maps.

example:

Console / text
sql: select count(*) as value from hr.payroll   # no type maps hr.payroll from source:erp-live

GLN-E501

severity: error

meaning: Proposed element in a deployment

pass: 6 Security

lowerable: false

cause: An element with status proposed is inside a deployed segment; proposals are never served.

fix: Make it active through a proposal, or keep it out of deployed segments.

example:

Console / text
metadata: {name: Issue, status: proposed}

GLN-E521

severity: error

meaning: Segment closure broken under hide

pass: 6 Security

lowerable: false

cause: A segment includes a type whose link target is in no included or required segment, and the segment hides cross-segment links, so the model would be broken for its audience.

fix: Include the target, require the segment that has it, or switch to crossSegmentLinks: stub.

example:

Console / text
crossSegmentLinks: hide
include: [procurement.*]   # links to comms.Message

GLN-E531

severity: error

meaning: Policy references an unknown audience or marking

pass: 6 Security

lowerable: false

cause: A policy names an audience or marking that does not exist.

fix: Use a declared one.

example:

Console / text
who: ["audience:emea-procurment"]

GLN-E541

severity: error

meaning: PII property with no masking obligation on an allow path

pass: 6 Security

lowerable: false

cause: A property marked as personal data has no masking obligation on some allow path, so it could be read in the clear.

fix: Add masking to the property or an obligation to every policy that allows reading it.

example:

Console / text
ownerEmail: {type: string, sensitivity: {pii: contact}}   # no masking

GLN-E542

severity: error

meaning: Aggregate member drops a root marking

pass: 6 Security

lowerable: false

cause: An aggregate member drops a marking its root carries, so the member leaks what the root protects.

fix: Carry the root's markings on the member.

example:

Console / text
security: {markings: []}   # root has marking:legal

GLN-E561

severity: error

meaning: MCP-exposed action without an authorization policy

pass: 6 Security

lowerable: false

cause: An action is exposed over MCP without an authorization policy.

fix: Name a policy in spec.authorization.

example:

Console / text
expose: {mcp: {tool: renew_contract}}

GLN-E571

severity: error

meaning: neverExpose property used in an AI template

pass: 6 Security

lowerable: false

cause: A property listed in ai.neverExpose is used in an AI template.

fix: Remove it from the template.

example:

Console / text
ai: {neverExpose: [negotiatedRate]}

GLN-E581

severity: error

meaning: Tier C action without approval, idempotency key, compensate or full audit

pass: 6 Security

lowerable: false

cause: A risk tier C action lacks an approval, an idempotency key, a compensate step or full audit.

fix: Add the missing part in the action's Execution and Approval sections.

example:

Console / text
riskTier: C
execution: {timeout: PT30S}   # no idempotencyKey

GLN-E582

severity: error

meaning: Tier D action deployed above L2

pass: 6 Security

lowerable: false

cause: A tier D action is deployed with an autonomy above L2.

fix: Lower maxAutonomy for it in the deployment, or lower the action's risk.

example:

Console / text
maxAutonomy: L3   # RenewContract is tier D

GLN-E583

severity: error

meaning: L4 action without rate limit or compensate

pass: 6 Security

lowerable: false

cause: An action that may run at L4 has no rate limit or no compensate.

fix: Add execution.rateLimit and execution.compensate.

example:

Console / text
execution: {idempotencyKey: ...}

GLN-E585

severity: error

meaning: lifecycle.expires has passed

pass: 6 Security

lowerable: false

cause: An element's lifecycle.expires date has passed; it blocks publishing.

fix: Renew or retire the element.

example:

Console / text
lifecycle: {expires: 2026-01-31}

GLN-E591

severity: error

meaning: Model falls back to an entry approved for fewer markings

pass: 6 Security

lowerable: false

cause: A Model's fallback names an entry that may not receive every marking the Model may receive, so a failed request could carry marked evidence to a model never approved for it.

fix: Fall back only to an entry whose markings include all of this Model's, or approve the fallback for them (a security officer approves that widening).

example:

Console / text
kind: Model
metadata: {name: eu-large}
spec:
  markings: ["marking:pii"]
  fallback: ["model:us-small"]   # us-small may receive no markings

GLN-E592

severity: error

meaning: Model falls back to itself or to another kind of model

pass: 6 Security

lowerable: false

cause: A Model's fallback names itself, or an entry of another kind (a chat model falling back to an embedding model), which could never answer the same request.

fix: Name only other entries of the same kind.

example:

Console / text
kind: Model
metadata: {name: eu-large}
spec:
  kind: chat
  fallback: ["model:embed-small"]

GLN-E601

severity: error

meaning: Version bump smaller than the change requires

pass: 7 Compatibility

lowerable: true

cause: The version bump is smaller than the change needs (a removal with only a minor bump).

fix: Bump the major version, or keep the change compatible.

example:

Console / text
version: 2.4.0   # from 2.3.1, removes a property

GLN-E602

severity: error

meaning: Breaking change without a Migration

pass: 7 Compatibility

lowerable: true

cause: A breaking change has no Migration, so existing data and clients cannot follow.

fix: Use the guided rename, or add a Migration step.

example:

Console / text
(property removed, no migrations/*.yaml step)

GLN-E603

severity: error

meaning: Breaking migration step not supported in the first release

pass: 7 Compatibility

lowerable: true

cause: A migration step Gluon cannot run in the first release (a link role rename, a rule that also covers other types), or a proposal that changes a property's type or a key directly: it is blocked at merge, not deferred to deployment.

fix: Split the policy rule first, or make the change in two releases.

example:

Console / text
renameProperty on region   # a policy rule also covers other types

GLN-E604

severity: error

meaning: Rename alias collides with an existing member

pass: 7 Compatibility

lowerable: true

cause: A rename's new name, or its alias, collides with an existing member.

fix: Choose another name.

example:

Console / text
rename expiryDate -> state   # state exists

GLN-E611

severity: error

meaning: Dependents broken by a change

pass: 7 Compatibility

lowerable: true

cause: A change breaks elements that depend on the changed one (views, actions, policies, other packages).

fix: Update the dependents listed in the report in the same proposal.

example:

Console / text
(view ContractsRenewingSoon reads the removed property)

GLN-E701

severity: error

meaning: Access test failed

pass: 8 Tests

lowerable: true

cause: An access test's expectation does not hold: the policy lets someone in or keeps someone out against the test.

fix: Fix the policy, or the test when the intent changed; expected and actual are in the message.

example:

Console / text
expect: {discover: false}   # bob can now discover Contract

GLN-E702

severity: error

meaning: Competency question cannot be answered by the model

pass: 8 Tests

lowerable: true

cause: A competency question cannot be answered from the model (its path uses a missing link).

fix: Add the link or property the question needs.

example:

Console / text
path: Contract -> supplier -> country

GLN-E703

severity: error

meaning: Invariant test failed

pass: 8 Tests

lowerable: true

cause: An invariant test fails on its fixtures.

fix: Fix the invariant or the fixture data.

example:

Console / text
invariant: "self.expiryDate > self.effectiveDate"

GLN-E704

severity: error

meaning: Answer test failed

pass: 8 Tests

lowerable: true

cause: An answer test failed in gluon eval: a neverMentions value leaked, or an expect: refuse question was answered.

fix: Tighten the policy or the Capability; the answer text is in the report.

example:

Console / text
neverMentions: [negotiatedRate]

GLN-W011

severity: warning

meaning: Unknown key preserved as unmanaged

pass: 1 Schema

lowerable: true

cause: A key the schema does not define is kept because the package preserves unknown keys (defaults.unknownProperties: preserve).

fix: Nothing breaks: the designer shows it as unmanaged and keeps it byte for byte. Remove it or move it under annotations when it is yours.

example:

Console / text
spec:
  xAcme: {keep: me}   # unmanaged

GLN-W014

severity: warning

meaning: Unquoted string with , : or # split inside a flow mapping

pass: 0 Syntax

lowerable: true

cause: An unquoted string with a comma, colon or hash sits inside a flow mapping, so YAML splits it.

fix: Quote the string.

example:

Console / text
metadata: {name: Contract, description: Signed, dated}   # quote the text

GLN-W206

severity: warning

meaning: Optional property compared without a has() guard

pass: 3 Types

lowerable: true

cause: An optional property is compared without has(), so the expression fails when the value is absent.

fix: Guard it: has(self.x) && self.x > 0.

example:

Console / text
expr: "params.contract.value.amount > 100000.0"

GLN-W207

severity: warning

meaning: Renamed property used by its old name (an alias until removeIn)

pass: 3 Types

lowerable: true

cause: An expression uses a property by the name it had before a guided rename. It still works as an alias until the migration's removeIn version.

fix: Use the new name before that version.

example:

Console / text
expr: "self.renewalDate < gluon.today()"   # now renewsOn

GLN-W232

severity: warning

meaning: Link from outside the aggregate targets a member

pass: 3 Types

lowerable: true

cause: A link from outside an aggregate points at one of its members instead of the root.

fix: Point the link at the root, or make the member a root.

example:

Console / text
to: {type: ContractEvent}

GLN-W234

severity: warning

meaning: Action modifies more than one aggregate without saga

pass: 3 Types

lowerable: true

cause: One action modifies more than one aggregate without a saga, so a failure can leave them apart.

fix: Split the action, or declare the saga that compensates.

example:

Console / text
effects:
  - modify: {object: params.contract}
  - modify: {object: params.supplier}

GLN-W241

severity: warning

meaning: Lifecycle state unreachable

pass: 3 Types

lowerable: true

cause: No transition reaches a lifecycle state from the initial state.

fix: Add a transition into it, or mark the state terminal or deprecated in its enum.

example:

Console / text
transitions:
  - {from: draft, to: active}   # nothing reaches void

GLN-W301

severity: warning

meaning: Type has no description

pass: 4 Completeness

lowerable: true

cause: A type has no description, so people and models do not know what it means.

fix: Write one sentence in metadata.description.

example:

Console / text
metadata: {name: Renewal}

GLN-W302

severity: warning

meaning: Object type has no title property

pass: 4 Completeness

lowerable: true

cause: An object type names no title property, so lists show raw ids.

fix: Set identity.title to a readable property.

example:

Console / text
identity: {primaryKey: [contractId]}

GLN-W303

severity: warning

meaning: Type has no owner

pass: 4 Completeness

lowerable: true

cause: A type has no owner, so nobody is asked to review changes to it.

fix: Add metadata.owners, or rely on the domain's owners.

example:

Console / text
metadata: {name: Issue}

GLN-W304

severity: warning

meaning: Object type has no source

pass: 4 Completeness

lowerable: true

cause: An object type has no source, so no data will ever be ingested for it.

fix: Map it from a Source in spec.sources, or mark it as derived.

example:

Console / text
spec: {properties: {...}}

GLN-W305

severity: warning

meaning: Prominent type has no synonyms

pass: 4 Completeness

lowerable: true

cause: A prominent type has no synonyms, so search and chat miss the words people use.

fix: Add metadata.synonyms.

example:

Console / text
display: {visibility: prominent}

GLN-W306

severity: warning

meaning: Object type has no links

pass: 4 Completeness

lowerable: true

cause: An object type has no links; it is an island nobody can navigate to.

fix: Link it to the types it belongs with.

example:

Console / text
(no LinkType names it)

GLN-W307

severity: warning

meaning: Enum has no default value

pass: 4 Completeness

lowerable: true

cause: An enum declares no default value.

fix: Mark one value default: true.

example:

Console / text
values:
  draft: {title: Draft}
  active: {title: Active}

GLN-W308

severity: warning

meaning: Interface has no implementers

pass: 4 Completeness

lowerable: true

cause: An interface has no implementers yet.

fix: Implement it on a type, or remove it.

example:

Console / text
kind: Interface
metadata: {name: Billable}

GLN-W421

severity: warning

meaning: PII detected in sample but no sensitivity declared

pass: 5 Sources

lowerable: true

cause: Sample data looks like personal data but the property declares no sensitivity.

fix: Add sensitivity: {pii: ...} with a masking obligation.

example:

Console / text
ownerEmail: string

GLN-W464

severity: warning

meaning: Query columns not checked: the return type maps nothing from its source

pass: 5 Sources

lowerable: true

cause: A Query returns an object type that maps nothing from the Query's source, so its columns were not checked.

fix: Add a sources[] entry for that source on the return type.

example:

Console / text
returns: {type: procurement.Contract}   # Contract has no mapping for source:erp-live

GLN-W511

severity: warning

meaning: Type is in no segment

pass: 6 Security

lowerable: true

cause: A type is in no segment, so nobody can see it once deployed.

fix: Include it in a segment, or leave it as internal modelling.

example:

Console / text
(no Segment includes Renewal)

GLN-W512

severity: warning

meaning: Law types nobody may traverse

pass: 6 Security

lowerable: true

cause: The package declares the law fragment (law.Law, law.Article) but no allow policy grants traverse on those types. Readers then see the links between articles (refersTo, amends) only as stubs, and Explain and Open lineage show no relationship paths.

fix: Add traverse to the actions of the policy that lets readers read the law domain.

example:

Console / text
actions: [discover, read, search]   # add traverse
resources:
  - select: {domain: law}

GLN-W522

severity: warning

meaning: Segment deployed to no audience

pass: 6 Security

lowerable: true

cause: A segment is deployed to no audience.

fix: Deploy it, or remove it.

example:

Console / text
(no Deployment names it)

GLN-W523

severity: warning

meaning: Segment closure broken under stub

pass: 6 Security

lowerable: true

cause: Like GLN-E521 under crossSegmentLinks: stub: the link shows as a withheld stub.

fix: Include the target when the audience should see it.

example:

Console / text
crossSegmentLinks: stub

GLN-W551

severity: warning

meaning: Allow policy shadowed by a deny

pass: 6 Security

lowerable: true

cause: An allow policy is fully shadowed by a deny, so it never takes effect.

fix: Narrow the deny or remove the allow.

example:

Console / text
(deny-contractors covers every subject of the allow)

GLN-W584

severity: warning

meaning: reviewBy date within 30 days

pass: 6 Security

lowerable: true

cause: An element's lifecycle.reviewBy date is less than 30 days away.

fix: Review it and move reviewBy on.

example:

Console / text
lifecycle: {reviewBy: 2026-10-01}

GLN-W651

severity: warning

meaning: Access widened

pass: 7 Compatibility

lowerable: true

cause: A change lets someone see or do more than before; the report names who gains what.

fix: Nothing to fix if intended: a security approver signs it off in the proposal.

example:

Console / text
who: ["group:security-office"]   # added to an allow policy

GLN-W652

severity: warning

meaning: Access possibly widened

pass: 7 Compatibility

lowerable: true

cause: A change may widen access (a condition was loosened); the report names who may gain.

fix: Check the condition; a security approver signs it off.

example:

Console / text
when: "subject.clearance >= 1"   # was 2

GLN-W653

severity: warning

meaning: Tool access possibly widened

pass: 7 Compatibility

lowerable: true

cause: A change may widen what tools can read: a new tools entry or Capability with tools, a new Query, or a changed Query sql or returns.

fix: Nothing to fix if intended: a security approver signs it off in the proposal.

example:

Console / text
tools: ["tool:erp-live/*"]   # added
The designer's help page for GLN-E101, with its cause and fix.
The designer's help page for GLN-E101, with its cause and fix.
The designer's help page for GLN-W512 with its meaning, cause, fix and the example policy that adds traverse.
The designer's help page for GLN-W512: law types nobody may traverse, with the cause and the policy fix.