create-refrakt plugin scaffold

SPEC-116 §2 — --type plugin emits a package implementing Plugin (packages/types/src/package.ts) with one example rune that builds and renders under the identity transform out of the box.

changeset-release/main View source

Criteria completion

Tracking started Jun 24 — check back for trends.

Relationships

ID:SPEC-116Status:accepted

Authoring scaffolds for distributable extensions

ID:ADR-023Status:accepted

Versioning and compatibility for distributed extensions

Date:2026-06-18

ID:WORK-448Status:done

Bake ADR-023 peerDeps, compat range, devDeps and build wiring into scaffolds

Priority:highComplexity:moderateMilestone:v0.25.0

ID:WORK-447Status:done

create-refrakt --type plugin|template|preset-pack dispatch

Priority:highComplexity:simpleMilestone:v0.25.0

ID:WORK-464Status:done

Authoring docs for distributables (template, theme, plugin, preset-pack)

Priority:mediumComplexity:simpleMilestone:v0.25.0

changeset-release/main current done

claude/milestone-v0-28-0-llvtfa done main done claude/v0.25.0-impl-2 done claude/v0.25.0-workitems ready

Jun 24, 07:10 PM2264093
Created (done)by github-actions[bot]
Jun 24, 06:51 AMb5d4fcd
Content editedby Claude
feat(create-refrakt): plugin scaffold (WORK-449); close ADR-023 wiring (
Jun 23, 07:22 PMa6bdcba
Content editedby Claude
plan(v0.25.0): accept specs/ADRs and decompose into 21 work items

Acceptance Criteria

--type plugin emits a Plugin package: a runes/ dir with one example rune (createContentModelSchema + createComponentRenderable) and its theme.runes config entry
Includes a fixture and the package.json exports (plus a cli-plugin entry stub where relevant)
The example rune builds and renders under the identity transform with no hand-editing
Inherits the ADR-023 deps + day-one build wiring (WORK-448)

Approach

Add scaffoldPlugin dispatched from WORK-447. Model the example rune on a simple existing plugin rune (e.g. a definition-style block). Wire theme.runes so the engine styles it.

Dependencies

WORK-447 — --type dispatch
WORK-448 — deps + build wiring

References

SPEC-116 §2; packages/types/src/package.ts; plugin authoring guide

Resolution

Completed: 2026-06-24

Branch: claude/v0.25.0-impl-2

What was done

scaffoldPlugin (SPEC-116 §2) emits a Plugin package: src/tags/callout.ts (an example rune via createContentModelSchema + createComponentRenderable, modeled on the working lore rune — title attr + body, aside with data-rune="callout"), src/config.ts (RuneConfig for Callout: block + tone modifier + autoLabel), src/index.ts (Plugin export wiring runes.callout + theme.runes), styles/callout.css, README.md, tsconfig.json. ADR-023 wiring: @refrakt-md/* peers (minor range) mirrored to devDeps; @markdoc/markdoc dep. Snippet + fixture included.

Verified

Scaffolded @acme/my-plugin, linked the workspace node_modules, ran tsc → exit 0 with dist/ output. Loaded the built plugin: name set, runes.callout.transform is a valid Markdoc tag schema, theme.runes.Callout present, fixture present. Builds and renders out of the box.