helix 1.8.0

The DNA engine - resolves DNA packages declared as dev-dependencies, merges their dna folders and instantiates configs, docs, scripts and agent skills into the target repo.

Changelog

1.8.0 - 2026-09-15

Added

• Add a --workspace build mode to helix so a bare workspace only gets .claude/ and CLAUDE.md, splicing referenced docs in via a new include marker; drop dna_gg's external cleanup script in favor of inline git steps

Changed

• Also pass --workspace to gg dna add, whose own internal build previously ignored it and instantiated the full package output before the explicit build --workspace step ran

1.7.1 - 2026-09-10

Changed

• Warn about a stray package-lock.json or yarn.lock only when the target declares a package.json

1.7.0 - 2026-09-10

Changed

• gg dna init suggests git init -b main when the target folder is no git repository, ahead of the gg dna add hint
• The DNA test no longer fails when LICENSE is missing - a license is the project's choice, not the engine's

1.6.1 - 2026-09-09

Fixed

• The managed CLAUDE.md block sets its content off from the markers by blank lines, the form prettier produces. Before, prettier inserted the blank line itself and the next DNA run refused the "edited" file.

1.6.0 - 2026-09-09

Added

• A dna/CLAUDE.md shipped by a DNA layer is written into the managed block of the project's CLAUDE.md instead of being skipped as a forbidden instance target. Content outside the block stays with the project; the claudeMdInclude imports follow the layer content.

Removed

• Remove the stray ticket.json from the repository root

1.5.1 - 2026-09-08

Deprecated

• Replace the deprecated dna_base in docs, comments and test fixtures

1.5.0 - 2026-09-07

Changed

• Stop shipping the hello world doc in the base DNA
• Merge main and move the change to Unreleased

1.4.0 - 2026-09-07

Added

• helix init asks whether a folder without manifest is a Dart or a TypeScript project instead of falling back to npm init; --language answers for headless runs

1.3.1 - 2026-09-03

Fixed

• Point repository at ggdna, the org this repo actually lives in

1.3.0 - 2026-09-02

Changed

• Resolve transitive DNA layers installed by pnpm into its isolated store

1.2.1 - 2026-09-02

Changed

• Never use /tmp as test dir base on Windows - Dart and git resolve it to different paths

Fixed

• Fix Windows-specific test failures that blocked the review

1.2.0 - 2026-08-25

Changed

• JSON override merging moved to gg_json (jsonMergePatch, joinArrays, encodeJsonPretty); lib/src/util/json_merge.dart is gone
• Carry the base DNA in the engine and run git through gg_process
• Adjust versioning

Removed

• Remove json merge directly and use from ggjson instead

1.1.1 - 2026-08-25

1.1.0 - 2026-08-20

Changed

• DnaHost.uncommittedPaths and DnaHost.commitPaths are asynchronous, and instantiateDna returns a Future. Running git through the embedder can only be answered with a future. runDnaTest — what the placed DNA test calls — is unchanged.

Fixed

• gg dna build and gg dna add crashed under a WebAssembly build of gg (e.g. via @tssuite/ggwsm), where 1.0.2 had only got gg dna init through. Two more dart:io operations that dart compile wasm does not support were on the path:
• Isolate.resolvePackageUri, used to locate the engine's own package folder and read the base DNA from it. The base DNA is now carried in the engine as source and written out through the host, so it needs no package folder at all — and no embedder has to bundle one.
• Process.runSync, used to run git. It now goes through package:gg_process, the same seam gg itself uses.

1.0.2 - 2026-08-20

Fixed

• helix init and helix add crashed under gg dna init/gg dna add when gg runs compiled to WebAssembly (e.g. via @tssuite/ggwsm): Unsupported operation: Platform._operatingSystem. Process execution now routes through package:gg_process's GgProcessDelegate and GgPlatformDelegate — the same seam gg itself uses for wasm support — instead of calling dart:io's Process.runSync and Platform.isWindows directly.

1.0.1 - 2026-08-19

Fixed

• Resolve hosted layers on Windows. pub records an absolute file:// URI for every hosted package; decoding it yields /C:/…, and the leading slash before the drive letter makes the path invalid for dart:io. Every layer coming from the pub cache failed with FileSystemException: Exists failed — which only surfaced once layers were consumed from the registry instead of by path.

1.0.0 - 2026-08-19

Changed

• Section tags lose their brackets: ## @tag Heading instead of ## [@tag] Heading. The bracketed form is still detected and reported.
• Make the helix tests platform proof

Removed

• The role key in dna/_dna.json. Every dna/ folder is hand-authored source now, and a package becomes a layer by being listed in the consumer's layers — no flag permits it. A leftover role is ignored, with a hint for your own config.
• The generated dna/ mode that came with role: "project". Helix never writes into dna/; the merged result is instantiated into the project root only. dna/_generated.json loses its now meaningless hash field.
• Markdown string placeholders {{@tag:default}}, the string form of X.overrides.md blocks, and global.overrides.md. Per-value substitution is what the dna variables in dna/_vars.json are for. The retired notation is still detected and reported.

0.2.0 - 2026-08-18

Added

• Add »gg dna init« and »gg dna test«
• Add a »helix add« command.

Changed

• Improve help of gg dna
• Rename »gg dna test« into »gg dna build«
• Complain about adding non dna repos
• Improve error messages
• Improve messages

0.1.0 - 2026-08-14

Changed

• Rework copyright headers

Fixed

• Cleanup copy right headers. Update to dart 3.13. Auto fixes.
• Cleanup copy right headers. Update to dart 3.13. Auto fixes. Setup quick-check pipeline.

0.0.4 - 2026-08-12

Changed

• Rename base_dna into dna_base
• A generated file that was changed locally is no longer an error: the local content is copied to a folder below the system temp directory, the DNA content is written, and the backup path is printed
• Restoring a locally changed instance can leave the file identical to HEAD; the path-limited commit is then skipped instead of reporting a git failure
• Generated files that could not be committed no longer fail the run — they are reported ("Generated files need a commit:" is gone)
• Overwrite files generated by DNA. Backup modified files.

Fixed

• Fix invalid release header format

0.0.2 - 2026-08-12

• First version take from gg_dna

Changed

• Rename gg_dna to helix