helix 1.2.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.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