Repository navigation
Open
Labels
P2SoonSooncompilerParser, IR, CASParser, IR, CASdesignNeeds a design decisionNeeds a design decision
Description
Epic. A use path says where a schema comes from, every compiled schema records where it came from, and a package's dependencies can be grouped and imported in a consistent order. Accepted proposal: ComlineProject/docs#178 and docs#181 (Own schemas, provenance and dependency groups).
Decided
- Own schemas use relative paths only. A package reaches its own schemas only as
package::…,parent::…orself::…, so an absolute first segment always meansstdor a dependency.- A bare path to an own schema is an error at once, with a quick fix and
comline fixrewriting it topackage::…. There is no edition and no deprecation period, since Comline is before 1.0. - The word stays
parent, with nosupersynonym. std,package,parentandselfstay reserved as dependency names.
- A bare path to an own schema is an error at once, with a quick fix and
- Provenance, not names. Each compiled schema records the package it came from (the package itself, a named dependency, or
std) in the frozen IR, the generation request and the facts. The tools stop inferring "dependency" from a namespace's spelling, and requests and facts use one canonical namespace form.- This is an IR format bump under core#268. It rides with format 4 or comes after it as format 5, whichever is ready.
- The shadowing guard stays as it is (Fail closed on imports a build can't check (#248, #249, #250) #256).
- Dependency groups. An optional
group = "<name>"field on each dependency entry inconfig.idp.- The table stays flat, names stay unique, and a group never appears in a
usepath. - A group is presentation only: it is excluded from the frozen config's hash, from dependency pins, and from compat and config diffs.
- The table stays flat, names stay unique, and a group never appears in a
- Import order:
std, then the package's own, then dependencies. Within the dependencies, groups come in first-declared order, then ungrouped dependencies, alphabetical within each tier.- A group orders dependencies only, never
std. - It's configurable in a
[format]table incomline.toml(imports.order), with no per-user override. - Core hosts the ordering function, so the language server and any
comline fmtagree.
- A group orders dependencies only, never
Work
- Conformance cases: own-schema paths, provenance, groups, import formatting specification#11: conformance cases first
- Own schemas only through package::, parent:: or self:: #282: own schemas only through
package::,parent::orself:: - Provenance: each compiled schema records the package it came from #283: provenance in the frozen IR (format bump under IR migrations: migrate every stored format accurately and provably #268)
- Dependency groups and the import order #284: dependency groups and the import order
- Read schema provenance instead of the namespace's spelling generation#150: read provenance
- Dependency groups, comline fix for own-schema paths, [format] cli#162:
--group,comline fix,[format] - Own-schema path error with quick fix, import ordering, groups language-server#122: the error's quick fix, import ordering, groups
- Document own-schema paths, provenance, groups and [format] docs#182: guides and references
Related: #277 (reach recorded in the facts), #268 (IR migrations), #222 (format 4), #245, generation#146, generation#148.
Metadata
Metadata
Assignees
Labels
P2SoonSooncompilerParser, IR, CASParser, IR, CASdesignNeeds a design decisionNeeds a design decision
Type
Projects
- StatusShow more project fieldsDesign
Activity
imports: own schemas only through package::, parent:: or self:: (#285)
Kinflou commentedon Nov 15, 2026
Added 2026-11-15: qualified references follow the Rust model (docs#189, merged
c8288e8).comline fixapplies it too (commented there)useguideRelated: #289 (compat and the sizer resolving names by suffix and first match).
Kinflou commentedon Nov 15, 2026
Audit 2026-11-16: ticked #282, which is closed by core#285 (14ce546, 2026-11-14: own schemas only through package::, parent:: or self::). specification#11 is partly done (specification#12 merged some of the cases) and stays unticked. The rest of the list is open as written.
references: qualified references follow the Rust model (#290, #286) (#…