Skip to content

fix(ctx): use okf:none marker for type-less imports to avoid collision#439

Merged
eris-ths merged 1 commit into
mainfrom
fix/ctx-okf-none-marker
Jun 17, 2026
Merged

fix(ctx): use okf:none marker for type-less imports to avoid collision#439
eris-ths merged 1 commit into
mainfrom
fix/ctx-okf-none-marker

Conversation

@eris-ths

Copy link
Copy Markdown
Owner

Problem

#435 introduced the okf:untyped tag to mark type-less docs on ctx import so a stray non-concept .md is auditable via ctx list --tag okf:untyped. But the marker collides: a real OKF type literally named Untyped slugs to okf:untyped too. A present-but-named type and a genuinely type-less doc become indistinguishable, defeating the audit.

Fix

Marker changed to okf:none — not a plausible OKF concept type, so it stays unambiguous. A real Untyped type still tags okf:untyped (correct provenance) and no longer shadows the gap marker.

Changes

  • OkfCtxMapper.ts — push okf:none for missing/empty/unusable type; docstring explains none over untyped.
  • new test — asserts a real type "Untyped" tags okf:untyped and does NOT collide with the okf:none gap marker.
  • interface/index.ts help, docs/verbs.md, AGENT.md updated.
  • changelog fragment renamed (untyped-tag -> none-marker) with the collision rationale.

Tests

npm run test:passages 346/346, npm run test:domain 145/145 green.

Follow-up to #435.

The missing-type marker was okf:untyped, but a real OKF type literally
named "Untyped" slugs to the same okf:untyped tag — so a present-but-
named type and a genuinely type-less doc became indistinguishable,
defeating the audit (`ctx list --tag` could no longer isolate stray
non-concept .md files). Changed the marker to okf:none, which is not a
plausible OKF concept type and stays unambiguous.

Follow-up to #435 (which introduced the okf:untyped tag).

- OkfCtxMapper: push okf:none for missing/empty/unusable type; docstring
  explains why none over untyped
- new test asserts a real type "Untyped" tags okf:untyped and does NOT
  collide with the okf:none gap marker
- help / docs/verbs.md / AGENT.md updated
- changelog fragment renamed and given the collision rationale
@eris-ths eris-ths merged commit 850a2cc into main Jun 17, 2026
5 checks passed
@eris-ths eris-ths deleted the fix/ctx-okf-none-marker branch June 17, 2026 07:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant