Skip to content

feat(cli): scaffold cli/calm-to-archify — CALM → Archify JSON IR transformer #120

Description

@MLKiiwy

Summary

Build a small CLI tool at cli/calm-to-archify/ that transforms CALM .arch.json files into the JSON IR format used by Archify (vendor/archify). This enables generating interactive system-map HTML presentations from CALM files.

Context

Archify does not natively support CALM. Its input format is a custom typed JSON IR (see vendor/archify/DESIGN.md). This transformer bridges the two. It is intentionally a thin conversion layer — not a general architecture analysis tool.

Acceptance criteria

  • CLI tool scaffolded with bash scripts/new-package.sh calm-to-archify (or equivalent)
  • calm-to-archify <input.arch.json> produces a valid Archify JSON IR file
  • Handles node types: actor, system, service, database
  • Handles relationship types: connects, deployed-in, composed-of
  • Covered by unit tests (Vitest)
  • Nx project.json with build/test/typecheck targets

Notes

  • Deferred from the initial epic PR — do not block on this for the architecture-as-code PR merge
  • Archify IR schema reference: vendor/archify/DESIGN.md and examples in vendor/archify/examples/

Epic: architecture-as-code (Issue #116)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions