Template Lineage

Template lineage is the system that lets HaloStack be more than a one-time starter. It records reusable changes with enough metadata for downstream projects to decide whether and how to port them.

The pieces

• .template/changes/next/*.ts — unreleased change entries.
• .template/changes/<version>/*.ts — released entries.
• tools/template — validation, changelog, release, and sync-status implementation.
• .template-sync.json — the ledger seeded into renamed child projects.

Workflow

Copybun run template:validate
bun run template:changelog
bun run template:release --dry-run
bun run template:sync-status --template=<template-checkout>

Change entries are not patches. They are migration instructions for agents and maintainers porting the template's intent into a project that may have diverged.

Generated changelogs should always come from bun run template:changelog.