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:
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:
- 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:
(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:
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:
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:
# 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:
# 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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
- {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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
(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:
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:
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:
(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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
(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:
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:
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:
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:
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:
(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:
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:
(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:
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:
(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:
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:
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:
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:
tools: ["tool:erp-live/*"] # added

