Skip to content

chore: introduce beads issue tracking with IR v4 implementation plan#10

Merged
DamianReeves merged 1 commit intomainfrom
chore/introduce-beads
Jan 20, 2026
Merged

chore: introduce beads issue tracking with IR v4 implementation plan#10
DamianReeves merged 1 commit intomainfrom
chore/introduce-beads

Conversation

@DamianReeves
Copy link
Member

Summary

  • Introduces beads workflow for local issue tracking and session management
  • Creates comprehensive implementation plan for Morphir IR v4 in Python
  • Adds session completion guidelines to AGENTS.md

IR v4 Implementation Plan

This PR establishes an epic with 12 child tasks for implementing the Morphir IR v4 specification:

Component Description
Naming Module Name, Path, QName, FQName types with canonical string format
Types Module Type expressions, specifications, and definitions
Values Module Literals, patterns, value expressions, and definitions
Modules Structure Module specification/definition, Documentation wrapper
Packages Structure Package specifications and definitions
Distributions Library, Specs, Application distributions + SemVer
Decorations System Layered metadata system for IR annotations
Document Type Schema-less JSON-like data type
Meta and Refs File metadata ($meta) and node references ($ref)
JSON Serialization Encoding/decoding with shorthand support
VFS File I/O VFS directory tree file operations
Unit Tests Comprehensive test coverage

Implementation Location

The IR types will be implemented in packages/morphir/src/morphir/ir/ as the default IR (no version subfolder needed - prior IR versions can be namespaced if needed later).

Reference Specification

Beads Workflow

Beads provides local issue tracking that:

  • Syncs via git (stored in .beads/)
  • Tracks dependencies between issues
  • Supports session-based workflow management

Run bd list or bd ready to see the implementation plan.

Test plan

  • Beads issues created and properly linked
  • Epic has all 12 child tasks as dependencies
  • bd ready shows 10 issues ready to work (no blockers)
  • bd stats shows correct counts

🤖 Generated with Claude Code

- Add beads workflow for local issue tracking and session management
- Create epic for Morphir IR v4 implementation (morphir-python-3a9)
- Add 12 child tasks covering all IR v4 components:
  - Naming module (Name, Path, QName, FQName)
  - Types module (Type expressions, specs, definitions)
  - Values module (Literals, patterns, expressions)
  - Modules structure (Documentation, ModuleSpec/Def)
  - Packages structure (PackageSpec/Def)
  - Distributions (Library, Specs, Application)
  - Decorations system (layered metadata)
  - Document type (schema-less JSON-like data)
  - Meta and Refs ($meta, $ref support)
  - JSON serialization (shorthand + canonical formats)
  - VFS file I/O (discrete distribution mode)
  - Unit tests

Reference specification: https://morphir.finos.org/docs/design/draft/
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@DamianReeves DamianReeves merged commit 2b59ec8 into main Jan 20, 2026
4 checks passed
@DamianReeves DamianReeves deleted the chore/introduce-beads branch January 20, 2026 15:08
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