@osovv/grace-cli 3.1.0 → 3.2.0

package/README.md

@@ -10,13 +10,13 @@ This repository packages GRACE as reusable skills for coding agents. The current
 - knowledge-graph synchronization
 - controller-managed sequential or multi-agent implementation
 
-Current packaged version: `3.1.0`
+Current packaged version: `3.2.0`
 
 ## What Changed In This Version
 
-- Added `grace-refactor` for safe rename/move/split/merge/extract workflows with graph and verification synchronization.
-- Added `docs/operational-packets.xml` as the canonical reference for execution packets, graph deltas, verification deltas, and failure packets.
-- Added a Bun-based `grace-lint` CLI built on `citty` for GRACE semantic markup and XML integrity checks.
+- Documented the published Bun-powered `grace` CLI more explicitly across skills and repo context.
+- Added `grace lint` guidance as a fast integrity preflight alongside reviewer, refresh, and status workflows.
+- Updated the public install example to use `bun add -g @osovv/grace-cli`.
 
 ## Repository Layout
 
@@ -189,6 +189,43 @@ bun install
 bun run grace lint --path /path/to/grace-project
 ```
 
+The lint command is role-aware and adapter-aware:
+
+- structural checks stay language-agnostic
+- export-map parity uses language adapters where available
+- file behavior is driven by semantic roles instead of filename masks
+
+Optional `MODULE_CONTRACT` fields for linting:
+
+```text
+ROLE: RUNTIME | TEST | BARREL | CONFIG | TYPES | SCRIPT
+MAP_MODE: EXPORTS | LOCALS | SUMMARY | NONE
+```
+
+Default behavior:
+
+- `RUNTIME` => strict export parity when a language adapter is available
+- `TEST` => `MODULE_MAP` describes important locals, fixtures, and helpers instead of exports
+- `BARREL` => `MODULE_MAP` can summarize aggregated exports
+- `CONFIG` => export parity is skipped by default
+- `TYPES` => type export surfaces are checked when the adapter supports them
+- `SCRIPT` => `MODULE_MAP` describes important local entry points and helpers instead of exports
+
+Optional repository config file:
+
+```json
+{
+  "profile": "auto",
+  "ignoredDirs": ["tmp"]
+}
+```
+
+Profiles:
+
+- `auto` => require `docs/verification-plan.xml` only when the repo already looks verification-aware
+- `current` => require current GRACE artifacts
+- `legacy` => allow older GRACE repos without a verification plan
+
 The validator checks marketplace/plugin metadata sync, version consistency, required fields, `.claude-plugin` structure, and hardcoded absolute paths. In branch or PR context it scopes validation to changed plugins via `git diff origin/main...HEAD`; otherwise it validates all plugins.
 
 ## Origin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osovv/grace-cli",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "GRACE CLI for linting semantic markup, contracts, and GRACE XML artifacts with a Bun-powered grace binary.",
   "license": "MIT",
   "homepage": "https://github.com/osovv/grace-marketplace#readme",
@@ -25,6 +25,7 @@
   "files": [
     "src/grace.ts",
     "src/grace-lint.ts",
+    "src/lint",
     "README.md",
     "LICENSE"
   ],
@@ -45,6 +46,7 @@
     "grace": "./src/grace.ts"
   },
   "dependencies": {
-    "citty": "^0.2.2"
+    "citty": "^0.2.2",
+    "typescript": "^6.0.2"
   }
 }