@ccdd/core 3.0.0 → 3.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hyukjin LIM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -68,7 +68,9 @@ Artifact types act as plugin slots through explicit registration. Importing a to
 
 ## Try your first review
 
-You need **Node.js 24 or later**. For published packages, install:
+CCDD supports **Node.js 22 LTS (22.19.0 or later)**. Use the latest patch of a supported LTS release.
+
+For published packages, install:
 
 ```sh
 npm install --ignore-scripts @ccdd/core @ccdd/project
@@ -115,3 +117,7 @@ An optional local monitor shows current-input checks and saved reviews. Start it
 | `@ccdd/default-tools` | Optional ready-made Artifact tools. |
 
 The repository, examples, CLI, monitor, and built-in review instructions use English. See [Contributing](CONTRIBUTING.md) for setup and checks, [the context map](CONTEXT-MAP.md) for architecture, and [release instructions](docs/releases.md) for packaging and publication.
+
+## License
+
+Licensed under the [MIT License](LICENSE).

package/examples/artifact-groups/README.md

@@ -10,7 +10,7 @@ In a full Run, both group Critics must wait for the image review to pass because
 
 ## Running the example
 
-Install the three v3.0.0 packages on Node 24 or later. The following command works after npm publication; before that, use the local source build below. Start in the CCDD source repository and copy the example into a new project outside it.
+Install the three v3.1.0 packages on Node 22 LTS (22.19.0 or later). The following command works after npm publication; before that, use the local source build below. Start in the CCDD source repository and copy the example into a new project outside it.
 
 ```sh
 CCDD_EXAMPLE_ROOT=$(mktemp -d /tmp/ccdd-groups.XXXXXX)
@@ -18,7 +18,7 @@ cp -R examples/artifact-groups "$CCDD_EXAMPLE_ROOT/project"
 cd "$CCDD_EXAMPLE_ROOT/project"
 npm init -y
 npm pkg set type=module
-npm install --ignore-scripts @ccdd/core@3.0.0 @ccdd/project@3.0.0 @ccdd/default-tools@3.0.0
+npm install --ignore-scripts @ccdd/core@3.1.0 @ccdd/project@3.1.0 @ccdd/default-tools@3.1.0
 
 # Check group member tool readiness without calling a Provider.
 npx ccdd tools check --artifact explosion --for agent

package/examples/custom-text-reader/README.md

@@ -2,7 +2,7 @@
 
 This example directly registers `{ metadata, execute }` without the default tool library. `customTextReader()` creates a definition; actual file reading occurs when an Agent calls `read_spec` or `read_why`.
 
-Each project must include its own dependencies. Copy this folder into a new project outside the repository, then install core and Project. The commands below work after npm v3.0.0 publication; before that, use the local tarballs described below. The example is included in the source repository and the core package's `examples/custom-text-reader`. It does not rely on CCDD installed in a parent repository.
+Each project must include its own dependencies. Copy this folder into a new project outside the repository, then install core and Project. The commands below work after npm v3.1.0 publication; before that, use the local tarballs described below. The example is included in the source repository and the core package's `examples/custom-text-reader`. It does not rely on CCDD installed in a parent repository.
 
 ```sh
 # Copy the example from the CCDD source repository.
@@ -10,13 +10,13 @@ cp -R examples/custom-text-reader /tmp/ccdd-custom-reader
 cd /tmp/ccdd-custom-reader
 npm init -y
 npm pkg set type=module
-npm install --ignore-scripts @ccdd/core@3.0.0 @ccdd/project@3.0.0
+npm install --ignore-scripts @ccdd/core@3.1.0 @ccdd/project@3.1.0
 npx ccdd tools check --artifact spec --for agent --tool read
 npx ccdd tools check --artifact spec --for agent --tool read --execute --args '{"startLine":1,"lineCount":20}'
 npx ccdd run --copy --critic spec-why --codex-auth-file "$HOME/.codex/auth.json" --wait
 ```
 
-This example installs core and Project without the default tool library. Alternatively, in the source repository run `npm run release:npm -- --commit <40-character SHA> --dry-run` to verify and generate matching `ccdd-core-3.0.0.tgz` and `ccdd-project-3.0.0.tgz` files, then install with `npm install --ignore-scripts <core.tgz> <project.tgz>`. This local verification requires no GitHub authentication. If CCDD is already installed, change the first `cp` source to `node_modules/@ccdd/core/examples/custom-text-reader`.
+This example installs core and Project without the default tool library. Alternatively, in the source repository run `npm run release:npm -- --commit <40-character SHA> --dry-run` to verify and generate matching `ccdd-core-3.1.0.tgz` and `ccdd-project-3.1.0.tgz` files, then install with `npm install --ignore-scripts <core.tgz> <project.tgz>`. This local verification requires no GitHub authentication. If CCDD is already installed, change the first `cp` source to `node_modules/@ccdd/core/examples/custom-text-reader`.
 
 The tool omits `preflight`. The default check distinguishes confirmed registration from unverified execution; `--execute` actually reads the file. Agent review requires valid Provider authentication.
 

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@ccdd/core",
-  "version": "3.0.0",
+  "version": "3.1.0",
+  "license": "MIT",
   "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
   "repository": { "type": "git", "url": "git+https://github.com/lhj6102/ccdd.git" },
   "description": "Artifact, Critic, relationship and tool definitions for CCDD",
@@ -9,7 +10,7 @@
   "exports": { ".": { "types": "./dist/src/sdk.d.ts", "import": "./dist/src/sdk.js" } },
   "workspaces": ["packages/default-tools", "packages/project"],
   "engines": {
-    "node": ">=24"
+    "node": "^22.19.0"
   },
   "scripts": {
     "build": "node scripts/clean-build.mjs && npm run build:core && npm run build:tools && node node_modules/typescript/bin/tsc -p tsconfig.json && npm run build:ui && npm run build:project",
@@ -33,6 +34,7 @@
     "dist/src/sdk.*",
     "dist/src/definitions.*",
     "dist/src/tools/contracts.*",
+    "LICENSE",
     "README.md",
     "examples/"
   ],
@@ -45,7 +47,7 @@
     "elkjs": "0.12.0",
     "typebox": "1.3.7",
     "vue": "3.5.42",
-    "@types/node": "24.13.3",
+    "@types/node": "22.20.2",
     "@vitejs/plugin-vue": "6.0.8",
     "typescript": "7.0.2",
     "typescript-ui": "npm:typescript@6.0.3",