PlanMilestone
note

This rune is part of @refrakt-md/plan. Install with npm install @refrakt-md/plan and add "@refrakt-md/plan" to the plugins array in your refrakt.config.json.

Milestone

A named release target or goal. Not a sprint — no timebox, no velocity, no ceremonies. A milestone is a coherent set of capabilities that together deliver value. When all work items assigned to it are done, the milestone is complete.

Active milestone

A milestone currently in progress with goals.

{% milestone name="v0.5.0" target="2026-03-29" status="active" %}
# v0.5.0 — Layout & Tint

- Complete alignment system migration
- Ship tint rune with dark mode support
- Publish layout spec as site documentation
- Resolve showcase bleed overflow bug
{% /milestone %}
<section data-rune="milestone" data-rune-fields="{&quot;name&quot;:&quot;v0.5.0&quot;,&quot;target&quot;:&quot;2026-03-29&quot;,&quot;status&quot;:&quot;active&quot;,&quot;created&quot;:&quot;2026-06-14&quot;,&quot;modified&quot;:&quot;2026-06-14&quot;}">
  <header data-name="title">
    <h1 id="v0.5.0-—-layout-&amp;-tint">v0.5.0 — Layout &amp; Tint</h1>
  </header>
  <div data-name="body">
    <ul>
      <li>Complete alignment system migration</li>
      <li>Ship tint rune with dark mode support</li>
      <li>Publish layout spec as site documentation</li>
      <li>Resolve showcase bleed overflow bug</li>
    </ul>
  </div>
</section>
v0.5.0active

v0.5.0 — Layout & Tint

  • Complete alignment system migration
  • Ship tint rune with dark mode support
  • Publish layout spec as site documentation
  • Resolve showcase bleed overflow bug
<section class="rf-milestone rf-milestone--v0.5.0 rf-milestone--active" data-name="v0.5.0" data-status="active" data-target="2026-03-29" data-created="2026-06-14" data-modified="2026-06-14" data-rune="milestone" data-density="full">
  <div data-name="eyebrow" data-zone="eyebrow" data-zone-layout="bar" class="rf-milestone__eyebrow">
    <span data-meta-type="id">v0.5.0</span>
    <span class="rf-badge" data-meta-type="status" data-meta-sentiment="positive" data-align="end">active</span>
  </div>
  <header data-name="title" class="rf-milestone__title" data-section="title">
    <h1 id="v0.5.0-—-layout-&amp;-tint">v0.5.0 — Layout &amp; Tint</h1>
  </header>
  <dl data-name="metadata" data-zone="metadata" data-zone-layout="definition-list" class="rf-milestone__metadata">
    <div data-name="row" data-field="target" class="rf-milestone__row">
      <dt data-meta-label="">Target</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-03-29">2026-03-29</time>
      </dd>
    </div>
    <div data-name="row" data-field="created" class="rf-milestone__row">
      <dt data-meta-label="">Created</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-14">2026-06-14</time>
      </dd>
    </div>
    <div data-name="row" data-field="modified" class="rf-milestone__row">
      <dt data-meta-label="">Modified</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-14">2026-06-14</time>
      </dd>
    </div>
  </dl>
  <div data-name="body" class="rf-milestone__body" data-section="body">
    <ul>
      <li>Complete alignment system migration</li>
      <li>Ship tint rune with dark mode support</li>
      <li>Publish layout spec as site documentation</li>
      <li>Resolve showcase bleed overflow bug</li>
    </ul>
  </div>
</section>

Planning milestone

A future milestone still being scoped.

{% milestone name="v1.0" target="2026-06-01" status="planning" %}
# v1.0 — Stable Release

- Stabilise all public APIs
- Complete documentation for all runes
- Launch theme marketplace
- Publish migration guide from v0.x
{% /milestone %}
<section data-rune="milestone" data-rune-fields="{&quot;name&quot;:&quot;v1.0&quot;,&quot;target&quot;:&quot;2026-06-01&quot;,&quot;status&quot;:&quot;planning&quot;,&quot;created&quot;:&quot;2026-06-14&quot;,&quot;modified&quot;:&quot;2026-06-14&quot;}">
  <header data-name="title">
    <h1 id="v1.0-—-stable-release">v1.0 — Stable Release</h1>
  </header>
  <div data-name="body">
    <ul>
      <li>Stabilise all public APIs</li>
      <li>Complete documentation for all runes</li>
      <li>Launch theme marketplace</li>
      <li>Publish migration guide from v0.x</li>
    </ul>
  </div>
</section>
v1.0planning

v1.0 — Stable Release

  • Stabilise all public APIs
  • Complete documentation for all runes
  • Launch theme marketplace
  • Publish migration guide from v0.x
<section class="rf-milestone rf-milestone--v1.0 rf-milestone--planning" data-name="v1.0" data-status="planning" data-target="2026-06-01" data-created="2026-06-14" data-modified="2026-06-14" data-rune="milestone" data-density="full">
  <div data-name="eyebrow" data-zone="eyebrow" data-zone-layout="bar" class="rf-milestone__eyebrow">
    <span data-meta-type="id">v1.0</span>
    <span class="rf-badge" data-meta-type="status" data-meta-sentiment="neutral" data-align="end">planning</span>
  </div>
  <header data-name="title" class="rf-milestone__title" data-section="title">
    <h1 id="v1.0-—-stable-release">v1.0 — Stable Release</h1>
  </header>
  <dl data-name="metadata" data-zone="metadata" data-zone-layout="definition-list" class="rf-milestone__metadata">
    <div data-name="row" data-field="target" class="rf-milestone__row">
      <dt data-meta-label="">Target</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-01">2026-06-01</time>
      </dd>
    </div>
    <div data-name="row" data-field="created" class="rf-milestone__row">
      <dt data-meta-label="">Created</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-14">2026-06-14</time>
      </dd>
    </div>
    <div data-name="row" data-field="modified" class="rf-milestone__row">
      <dt data-meta-label="">Modified</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-14">2026-06-14</time>
      </dd>
    </div>
  </dl>
  <div data-name="body" class="rf-milestone__body" data-section="body">
    <ul>
      <li>Stabilise all public APIs</li>
      <li>Complete documentation for all runes</li>
      <li>Launch theme marketplace</li>
      <li>Publish migration guide from v0.x</li>
    </ul>
  </div>
</section>

Completed milestone

A milestone with all goals achieved.

{% milestone name="v0.4.0" status="complete" %}
# v0.4.0 — Foundation

- Core rune system operational
- Identity transform engine complete
- Lumina theme baseline shipped
{% /milestone %}
<section data-rune="milestone" data-rune-fields="{&quot;name&quot;:&quot;v0.4.0&quot;,&quot;target&quot;:&quot;&quot;,&quot;status&quot;:&quot;complete&quot;,&quot;created&quot;:&quot;2026-06-14&quot;,&quot;modified&quot;:&quot;2026-06-14&quot;}">
  <header data-name="title">
    <h1 id="v0.4.0-—-foundation">v0.4.0 — Foundation</h1>
  </header>
  <div data-name="body">
    <ul>
      <li>Core rune system operational</li>
      <li>Identity transform engine complete</li>
      <li>Lumina theme baseline shipped</li>
    </ul>
  </div>
</section>
v0.4.0complete

v0.4.0 — Foundation

  • Core rune system operational
  • Identity transform engine complete
  • Lumina theme baseline shipped
<section class="rf-milestone rf-milestone--v0.4.0 rf-milestone--complete" data-name="v0.4.0" data-status="complete" data-target="" data-created="2026-06-14" data-modified="2026-06-14" data-rune="milestone" data-density="full">
  <div data-name="eyebrow" data-zone="eyebrow" data-zone-layout="bar" class="rf-milestone__eyebrow">
    <span data-meta-type="id">v0.4.0</span>
    <span class="rf-badge" data-meta-type="status" data-meta-sentiment="positive" data-align="end">complete</span>
  </div>
  <header data-name="title" class="rf-milestone__title" data-section="title">
    <h1 id="v0.4.0-—-foundation">v0.4.0 — Foundation</h1>
  </header>
  <dl data-name="metadata" data-zone="metadata" data-zone-layout="definition-list" class="rf-milestone__metadata">
    <div data-name="row" data-field="created" class="rf-milestone__row">
      <dt data-meta-label="">Created</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-14">2026-06-14</time>
      </dd>
    </div>
    <div data-name="row" data-field="modified" class="rf-milestone__row">
      <dt data-meta-label="">Modified</dt>
      <dd data-meta-type="temporal">
        <time datetime="2026-06-14">2026-06-14</time>
      </dd>
    </div>
  </dl>
  <div data-name="body" class="rf-milestone__body" data-section="body">
    <ul>
      <li>Core rune system operational</li>
      <li>Identity transform engine complete</li>
      <li>Lumina theme baseline shipped</li>
    </ul>
  </div>
</section>

Attributes

AttributeTypeDefaultDescription
namestringMilestone name, e.g. v0.5.0 (required)
targetstringTarget date (aspirational, not a commitment)
statusstringplanningCurrent status: planning, active, complete
createdstring$file.createdCreation date (ISO 8601). Auto-populated from git history
modifiedstring$file.modifiedLast modified date (ISO 8601). Auto-populated from git history

Common attributes

All block runes share these attributes for layout and theming.

AttributeTypeDefaultDescription
widthstringcontentPage grid width: content, wide, or full
spacingstringVertical spacing: flush, tight, default, loose, or breathe
insetstringHorizontal padding: flush, tight, default, loose, or breathe
tintstringNamed colour tint from theme configuration
tint-modestringautoColour scheme override: auto, dark, or light
bgstringNamed background preset from theme configuration