All notable changes to this project will be documented in this file.
The format is inspired by Keep a Changelog, and this project follows Semantic Versioning.
This changelog currently starts at 1.3.0. Earlier history is available in the git log.
- Added
grace verification find/showso verification-plan entries are queryable without manual XML scanning. - Added
grace module healthplus optional module health summaries ingrace status --with modules. - Added
grace lint --explain <code>, remediation-aware text output, and configurable--fail-onpolicies for CI. - Added release hygiene assets:
RELEASING.md,scripts/release-checklist.ts,.github/workflows/validate.yml, and CLI examples underexamples/cli/.
- Strengthened the autonomy gate with technology-artifact checks, packet checkpoint requirements, module-implementation checks, test-file linkage checks, and marker-to-block validation.
- Enriched
grace lintandgrace statusJSON output with schema/version metadata and summary counts for machine-readable automation. - Extended marketplace validation to verify
package.jsonversion sync and require a matchingCHANGELOG.mdentry for the current version.
- Added
grace lint --profile autonomousas a cheap autonomy-readiness gate before long autonomous runs. - Added
grace statusfor project health, autonomy blockers, and next-action guidance.
- Reframed the marketplace, CLI docs, and GRACE skills around process-first execution, semantic anchoring, approved stacks, checkpoint reports, and operational packets.
- Updated
grace-inittemplates so technology, development-plan, verification-plan, and operational-packets examples explicitly model autonomy policy and checkpoint handoff.
- Added
grace-cli, a dedicated skill for using the optionalgracebinary as a GRACE-aware lint and artifact-query layer.
- Updated skill trigger wording to use agent-neutral
Use when you ...phrasing instead of Claude-specific wording. - Reworked the README install guidance so GRACE skills are the primary surface, the CLI is a strongly recommended companion, and requirements/technology artifacts are designed together with the agent.
- Added a schema-aware GRACE query layer with
grace module find,grace module show, andgrace file show. - Added artifact indexing that merges shared XML module records, module verification entries, implementation steps, and linked file-local markup.
- Expanded the CLI surface from integrity-only linting into read/query navigation for public shared-doc context and private file-local context.
- Updated the shipped GRACE skills and README so agents know when to use
grace lint,grace module find,grace module show, andgrace file show.
- Clarified across the marketplace skills that
docs/development-plan.xmlanddocs/knowledge-graph.xmlshould describe only public module contracts and public module interfaces. - Kept private helpers, internal types, and implementation-only orchestration details in file-local markup, local contracts, and semantic blocks instead of shared XML artifacts.
- Updated planning, refresh, reviewer, execution, refactor, explainer, init templates, and packaged mirrors to follow that boundary consistently.
- Added a rich Python adapter without
pyright, while keeping TypeScript/JavaScript on the TypeScript compiler API for exact export analysis. - Made adapter failures non-fatal so linting can continue with structural checks and warnings.
- Removed profile selection from
grace lint; it now validates only against the current GRACE artifact set. - Limited
.grace-lint.jsonto the current schema and reject unknown keys instead of carrying compatibility paths for unused legacy config.
- Refactored
grace lintinto a role-aware core plus language-adapter architecture with a JS/TS AST adapter. - Added
ROLEandMAP_MODEsupport for governed files so tests, barrels, configs, types, and scripts are linted by semantics instead of filename masks. - Added
auto/current/legacyprofile support and.grace-lint.jsonrepository configuration.
- Documented the optional
graceCLI insidegrace-explainer,grace-reviewer,grace-refresh, andgrace-statusas a fast integrity preflight. - Updated
CLAUDE.mdso future sessions treat the published@osovv/grace-clipackage andgrace lintworkflow as part of the repo context. - Switched the published CLI install example in
README.mdtobun add -g @osovv/grace-cli.
- Added
grace-refactorfor safe rename, move, split, merge, and extract workflows with synchronized contracts, graph entries, and verification refs. - Added
docs/operational-packets.xmltemplates tograce-initso projects get canonicalExecutionPacket,GraphDelta,VerificationDelta, andFailurePacketshapes. - Added a Bun-based
graceCLI oncittywith alintsubcommand for unique XML tags, graph/plan/verification drift, and semantic markup integrity.
- Updated execution, verification, ask, fix, status, and explainer skills to recognize
docs/operational-packets.xmlwhen present. - Prepared the published CLI as the scoped npm package
@osovv/grace-cliwith a Bun-poweredgracebinary and prepublish verification checks.
- Improved worker commit message format in
grace-multiagent-execute: requires concrete file/function/export listing and descriptive body instead of generic "harden X" phrases. - Improved controller meta-sync commit format: lists which artifacts were updated and per-module delta description instead of bare module list.
- Replaced the
plugins/grace/skillssymlink with real packaged skill files so OpenPackage can install the plugin foropencode. - Added validator coverage for drift between canonical
skills/grace/*content and the packaged copy insideplugins/grace.
- Re-aligned the Claude Code marketplace layout with the official docs by serving the
graceplugin from./plugins/grace. - Restored the plugin manifest to
plugins/grace/.claude-plugin/plugin.jsonand removed the unsupported root plugin manifest. - Updated marketplace validation to enforce relative plugin sources and to verify component paths inside each plugin source directory.
- Restored Claude Code marketplace packaging to use the repository root as the plugin source so bundled skill paths resolve inside the installed plugin.
- Added a root
.claude-plugin/plugin.jsonmanifest and removed the broken nestedplugins/gracepackaging layout. - Updated validation to catch missing component paths inside the declared plugin source before release.
- Added
docs/verification-plan.xmlas a first-class GRACE artifact template. - Added richer
grace-inittemplates for requirements, technology, development plan, and knowledge graph. - Added GRACE explainer reference material for verification-driven and log-driven development.
- Reframed
grace-verificationaround maintained testing, traces, and log-driven evidence. - Updated
grace-planto produce verification references and populateverification-plan.xml. - Updated
grace-executeandgrace-multiagent-executeto consume verification-plan excerpts in execution packets and sync verification deltas centrally. - Updated
grace-reviewer,grace-status,grace-refresh,grace-ask, andgrace-fixto treat verification as part of GRACE integrity. - Refreshed README, packaging metadata, and installation paths for the nested
skills/grace/*layout.
- Removed
grace-generatefrom the public skill set in favor of the execution-centric workflow throughgrace-executeandgrace-multiagent-execute.
- Workers now commit their implementation immediately after verification passes, rather than waiting for controller.
- Controller commits only shared artifacts (graph, plan), not implementation files.
- Updated
grace-executeandgrace-multiagent-executewith explicit commit timing guidance.
- Reorganized skills directory structure: all GRACE skills moved to
skills/grace/subfolder for better organization and namespacing.
- Added
safe,balanced, andfastexecution profiles tograce-multiagent-execute. - Added controller-built execution packets to reduce repeated plan and graph reads during execution.
- Added targeted graph refresh guidance for wave-level reconciliation.
- Added explicit verification levels for module, wave, and phase checks.
- Added this
CHANGELOG.mdfile.
- Aligned
grace-executewith the newer packet-driven, controller-managed execution model. - Updated
grace-generateto support controller-friendly graph delta proposals in multi-agent workflows. - Updated
grace-reviewerto supportscoped-gate,wave-audit, andfull-integrityreview modes. - Updated
grace-refreshto distinguish betweentargetedandfullrefresh modes. - Updated GRACE subagent role prompts to match scoped reviews, controller-owned shared artifact updates, and level-based verification.
- Updated
README.mdand package metadata for the1.3.0release.
- Resolved the workflow conflict where
grace-generatepreviously implied directknowledge-graph.xmledits even whengrace-multiagent-executerequired controller-owned graph synchronization.