release-orchestrator

Use when writing Haklex articles with Markdown plus LiteXML, choosing the appropriate Haklex node for content, authoring LiteXML fragments, or converting a LightXML/LiteXML string or file into Lexical SerializedEditorState JSON, Markdown, or Static Render HTML via the `litexml` CLI.

2026-06-1229

demo-ui-components

Use when creating or modifying demo/ UI components — buttons, cards, panels, pills, inputs, badges. Reference for all component CSS classes and their exact specs.

demo-ui-direction

Use when modifying demo/ UI — adding pages, components, or styles. Defines the monochrome visual system, layout patterns, and component conventions for the haklex demo site.

demo-ui-tokens

Use when adding or modifying colors, spacing, typography, or layout values in demo/ CSS. Complete token reference for the monochrome design system.

md-to-lexical

Convert Shiroi Markdown to Haklex Lexical JSON. Use when the user wants to convert a markdown file or string to rich text editor JSON format.

references/repo-layout.md

Release Orchestrator

End-to-end release procedure for the shared-version @haklex/* package family. This skill supersedes .claude/commands/release.md.

Operating Contract

Rule

Requirement

Autonomy

Infer release metadata from repository state. Do not ask for package lists, semver level, downstream branch, or confirmation unless a stop condition is reached.

Versioning

All @haklex/* packages share one version, read from packages/rich-editor/package.json.

Default mode

Use incremental unless invocation text contains full, 全量, or standalone all, or unless semver classification reaches major.

Publish set

In incremental, publish the tri-directional closure of changed packages, not merely CHANGED_PKGS.

Peer safety

Treat duplicate runtime copies of lexical, React, lucide-react, shiki, and @lexical/* as release-blocking defects.

Downstream

Update downstream default branches directly after validation. Do not open PRs unless direct push is blocked and the user confirms the fallback.

Destructive actions

Do not discard, reset, restore, force-remove, or silently overwrite user-owned changes. Preserve state and ask before destructive recovery.

Required Reading Order

Read the relevant reference files before acting. If performing a full release, read all of them.

Stage

Reference

Repository and downstream layout

Release mode, change detection, semver, peer audit

references/release-analysis.md

Publish-set closure, build, publish, registry polling, CLI smoke

references/publish-pipeline.md

GitHub release, downstream propagation, third-party pin reconciliation, smoke tests

references/downstream-propagation.md

Stop conditions, safe recovery, common mistakes, real-world anchors

references/failure-recovery-and-anchors.md

Execution Flow

flowchart TD A[Clean haklex worktree] --> B[Find last release] B --> C[Detect mode and changed packages] C --> D{No releasable trigger?} D -->|Yes| Z[Stop: report no package diff] D -->|No| E[Classify shared semver bump] E --> F{Major bump?} F -->|Yes| G[Switch to full mode] F -->|No| H[Keep selected mode] G --> I[Peer dependency audit] H --> I I --> J[Compute publish set] J --> K[Bump and build all packages] K --> L[Publish selected set in topo order] L --> M[Registry poll and CLI smoke] M --> N[Commit, tag, push haklex] N --> O[Publish GitHub release] O --> P[Update downstream worktrees] P --> Q[Install, dedup gate, typecheck, build, smoke] Q --> R{All downstream green?} R -->|Yes| S[Push downstream default branches] R -->|No| T[Stop with preserved failure state]

Helper Scripts

Scripts are advisory automation for repeatable checks. They do not replace judgment, and they do not edit files destructively.

Script

Purpose

scripts/release-context.sh

Derive LAST, local version, source changes, peer-drift triggers, catch-up triggers, and CHANGED_PKGS.

scripts/peer-audit.sh

Detect always-peer libraries under dependencies, internal @haklex/* peer pins using workspace:*, and divergent third-party peer floors.

scripts/publish-set.sh

Compute PUBLISH_SET for full or tri-directional incremental mode.

scripts/registry-peer-floors.sh

Aggregate non-@haklex/* peer floors from published registry manifests.

scripts/downstream-dispatch.sh

Emit downstream manifest rewrite rows for @haklex/* pins and third-party peer-floor reconciliation.

scripts/duplicate-runtime-invariant.sh

Assert a single resolved version for runtime-anchored libraries in a downstream worktree.

Phase Index

Phase

Action

Primary Reference

0.5

Detect incremental vs full mode

Pre-flight and releasable trigger detection

Shared semver classification

Peer dependency audit