Keep bundled workflows aligned with package version

[adampoit]

Closes #46

Summary

• generate checked-in workflow examples and skill assets from the runtime renderers and package version
• synchronize the package-lock root version with package.json
• fail CI and npm publication when generated artifacts are stale

Validation

• npm run artifacts:check
• npm run format:check
• npm test

[not-adam]

Mira PR Walkthrough

This PR introduces an automated artifact synchronization system to keep bundled workflow YAML examples and skill assets in sync with the package version. A new script (scripts/sync-skill-assets.ts) regenerates these files from runtime template renderers using the version in package.json and also aligns package-lock.json's root version. CI and publish workflows now run an artifacts freshness check to fail when generated files are stale, preventing version mismatches from shipping.

graph LR
  pkg["package.json"]
  templates["src/workflow-templates.ts"]
  sync["scripts/sync-skill-assets.ts"]
  ci["ci.yml"]
  publish["publish.yml"]
  artifacts["examples/*.yml + skills/*.yml"]

  pkg -->|version| sync
  templates -->|renderers| sync
  sync -->|writes| artifacts
  ci -->|runs artifacts:check| sync
  publish -->|runs artifacts:check| sync

Loading

Confidence: 4/5   ◉◉◉◉○   Safe with minor fixes

• The logic is sound and the generated YAML diffs look consistent, but the sync script uses Node's experimental --experimental-strip-types flag which may warrant a note about Node version compatibility.

Blast Radius — 2 dependent repositories, 3 total references

adampoit/mira — 1 reference
adampoit/wezterm — 2 references

8 files reviewed

---

Comment @not-adam help to get the list of available commands and usage tips.