mdkg 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -6,7 +6,96 @@ This project follows a pragmatic changelog style inspired by Keep a Changelog. V
 
 mdkg is pre-v1 public alpha software. Command, graph, cache, bundle, and DAL contracts may change quickly while the project converges on a stable v1 surface.
 
-## 0.3.0 - Unreleased
+## Unreleased
+
+### Planned
+
+- No changes yet.
+
+## 0.3.2 - 2026-06-16
+
+### Added
+
+- Added first-class research spike work-node support with `mdkg new spike`,
+  `spike-#` ids, `.mdkg/work/` storage, and compatibility with existing
+  `mdkg task start/update/done` lifecycle commands.
+- Added spike participation in `mdkg next`, `mdkg goal next`, `mdkg goal claim`,
+  list/search/show structured exports, deterministic packs, goal-root pack
+  closure, and generated command contract metadata.
+- Added a default spike template for research question, context, search plan,
+  findings, options/tradeoffs, recommendation, follow-up nodes, skill
+  candidates, domain notes, mdkg.dev launch implications, and evidence/sources.
+- Added packed `smoke:spike` coverage that installs mdkg from a tarball in a
+  temp prefix, creates a fresh repo, exercises spike lifecycle and goal routing,
+  verifies structured exports and pack formats, creates follow-up task/test
+  nodes, and confirms no automatic skill generation occurs.
+- Added mdkg.dev dogfood research spike nodes and follow-up roadmap nodes so
+  launch planning can proceed from evidence-backed spikes after this release.
+
+### Changed
+
+- Updated README, `CLI_COMMAND_MATRIX.md`, init assets, help text, command docs,
+  and publish-readiness assertions to describe spikes as actionable research
+  work nodes, not autonomous web-search or file-generation agents.
+- Hardened init and upgrade compatibility so fresh and upgraded repos receive
+  the bundled spike template while customized spike templates are preserved.
+- Hardened spike pack/export behavior across JSON, Markdown, XML, and toon
+  pack formats plus public visibility filtering for spike archive references.
+- Hardened validation and fix-plan UX for malformed spikes: invalid ids,
+  statuses, priorities, missing refs, duplicate spike ids, and missing spike
+  body sections now have explicit test coverage and read-only repair guidance
+  where existing fix-plan families apply.
+- Extended `mdkg fix plan refs` to inspect indexed `links`, `artifacts`, and
+  `refs` fields in addition to custom attributes, so missing archive refs in
+  normal node metadata appear in repair plans.
+
+### Security
+
+- Kept spikes as human/agent-authored Markdown work nodes only. This release
+  does not add a `mdkg spike ...` namespace, automatic web search, automatic
+  follow-up node creation, automatic `SKILL.md` generation, or repair apply
+  behavior.
+- Preserved dry-run-only repair planning: spike-related fix guidance remains
+  receipt-shaped, non-mutating, and `apply_supported: false`.
+
+## 0.3.1 - 2026-06-11
+
+### Added
+
+- Added `mdkg status --json` as a read-only operator health summary covering
+  package/release metadata, Git state, graph/index freshness, selected-goal
+  state, project DB verification state, and generated cache health.
+- Added strict typed doctor checks with `mdkg doctor --strict --json`,
+  including stable check ids, status/severity fields, remediation text, selected
+  goal stale/achieved detection, and enabled project DB verification failures.
+- Added dry-run-only `mdkg fix plan --json` with receipt-shaped repair plans for
+  generated index/cache state, missing graph references, and duplicate local ids.
+- Added read-only `mdkg subgraph audit` and `mdkg subgraph upgrade-plan`
+  receipts for child graph source-path health, root-owned bundle safety,
+  materialized-tree safety, dirty child repo refusal, and downstream sync/verify
+  planning.
+- Added generated `dist/command-contract.json` metadata and `npm run
+  cli:contract` so command docs can be generated from mdkg-native command
+  policy metadata before `mdkg.dev` launch.
+
+### Changed
+
+- Hardened mutating command paths with mutation locks and atomic writes for
+  format, skill, and workspace updates.
+- Extended prepublish readiness with operator-health, fix-plan,
+  branch-conflict, and command-docs packed smoke coverage.
+- Updated README, `CLI_COMMAND_MATRIX.md`, init assets, help snapshots, and
+  publish-readiness assertions for the new operator-health, fix-planning,
+  subgraph safety, branch safety, generated command contract, and docs
+  readiness surfaces.
+
+### Security
+
+- Kept repair planning, subgraph upgrade planning, and operator health commands
+  read-only by default; apply behavior, child repo mutation, worker execution,
+  and public event/reducer/lease/materializer CLI remain deferred.
+
+## 0.3.0 - 2026-06-06
 
 ### Added