Skip to content

First-class Epic/Story/Task/Subtask/Bug and Branch types - #54

Merged
RichardHightower merged 1 commit into
mainfrom
feat/work-item-types
Aug 14, 2026
Merged

First-class Epic/Story/Task/Subtask/Bug and Branch types#54
RichardHightower merged 1 commit into
mainfrom
feat/work-item-types

Conversation

@RichardHightower

Copy link
Copy Markdown
Contributor

Adds the three remaining schema items from the second-brain plan, without breaking existing bundles.

Types

Type Catalog Notes
Epic / Story / Task / Subtask / Bug epics/ stories/ tasks/ subtasks/ bugs/ First-class work items
Branch branches/ Source-control node; Bug/CodeChange use on_branch
TicketLink tickets/ Still valid. Preferred for new writes: the specialized type

Per-type fields

required stays type + title only. Extra fields live in:

  • x-recommended (e.g. DecisionRecord status)
  • x-recommended-any (TicketLink / work items: worklog_id or external_id)
  • x-recommended-link-rels (Bug: affects / on_branch / …)

Soft by default (warn). --strict promotes them to errors.

Compat

  • sample-okf: 0 errors
  • existing TicketLink files unchanged
  • mixed fixture includes a Bug + Branch

TicketLink stays valid. Per-type extras are x-recommended (warn, --strict
errors). BaseConcept required fields remain type + title.
@RichardHightower
RichardHightower merged commit b0b6e9f into main Aug 14, 2026
2 checks passed
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.

2 participants