Changelog

v0.3.0 - 2026-05-12

Breaking changes — v0.3 changes the top-level shape. All four sections are now required.

• Schema shape changed to four-property structure: manual, generated, agents, health
• Canonical write path: .agents/agents.workspace.json
• Top-level version field removed; schema version now lives at generated.specVersion = "0.3"
• Per-file fragility data at generated.fileIndex.{path} (not files.{path})
• Framework detection at generated.frameworkManifest
• health.intelligenceState enum: INSUFFICIENT_DATA | OBSERVING | CONFIDENT
• Field names match jnuyens/gsd-plugin v2.42.3 SessionStart read paths (first shipped consumer)
• validate() and validateLegacy() exported from @workspacejson/spec
• JSON Schema published at https://www.workspacejson.dev/schema/v1.json

Migration: check generated.specVersion === "0.3" to detect v0.3 documents. Fall back to v0.1 shape if specVersion is absent.

v0.1.0 - 2026-05-05

Initial public release.

• Core spec stable: file index, framework manifest, agent file references, stable health signals
• Experimental fields: structuralPhase, llmContextStaleness, packageDensity, testCoverageRatio, bootstrapOverride
• Reference CLI agents-audit published to npm
• JSON Schema published as @workspacejson/spec
• Rule library published as @workspacejson/rules
• Five v0.1.1 audit rules: missing-file-reference, pattern-zero-match, framework-drift, section-staleness, convention-mismatch
• Apache 2.0 across all artifacts