agent-cfml-check 0.1.0 → 0.1.1

package/README.md

@@ -4,7 +4,7 @@
 
 ## Current status
 
-Version `0.1.0` contains the first feasibility slice. The current implementation is locally verified for:
+Version `0.1.1` contains the first feasibility slice plus executable schema validation, package exports, and Agent onboarding. The prior `agent-cfml-check@0.1.0` publication predates these additions. The current implementation is verified for:
 
 - paired CFML tag nesting;
 - `cfelse` and `cfelseif` ownership and ordering;
@@ -17,14 +17,17 @@ Version `0.1.0` contains the first feasibility slice. The current implementation
 - explicit-root path safety, source stability checks, input validation, output limits, nesting limits, finding limits, and time limits;
 - deterministic JSON and text CLI output.
 
-Verification at repository commit `1d5c768`:
+Local verification before this documentation update:
 
-- `npm test`: 17/17 passed;
+- `npm test`: 22/22 passed;
 - `npm run typecheck`: passed;
 - `npm pack --dry-run --json`: passed;
-- capabilities, valid-fixture, and misnested-fixture CLI checks: passed.
+- capabilities, valid-fixture, and misnested-fixture CLI checks: passed;
+- temporary packed-install CLI and library import smoke checks: passed;
+- targeted Lucee `6.2.2.91` execution probe: passed;
+- Ubuntu WSL Node `18.19.1` `npm ci`, tests, and typecheck: passed.
 
-This is not yet a published package, a complete CFML parser, or evidence of Lucee/Adobe ColdFusion compatibility. Hub lifecycle and publication status remain outside this repository's locally verified implementation evidence.
+The prior npm publication of `agent-cfml-check@0.1.0` is immutable and predates this release's schema, package-export, and documentation updates. This release targets `agent-cfml-check@0.1.1`; authenticated registry publication/readback is the final release step. This is not a complete CFML parser or evidence of Adobe ColdFusion compatibility. A targeted Lucee `6.2.2.91` probe and an Ubuntu WSL Node `18.19.1` clean dependency install/test run pass; these do not establish a full engine matrix. Hub lifecycle, canonical ownership, admission, and Adobe compatibility remain outside the current verified evidence.
 
 ## Install and use
 
@@ -38,7 +41,7 @@ node dist/cli/index.js check --root . fixtures/valid.cfm --json
 node dist/cli/index.js check --root . fixtures/misnested.cfm --json
 ```
 
-The package requires Node.js `>=18.18.0`. It has no runtime npm dependencies; TypeScript and Node.js type definitions are development dependencies.
+The package requires Node.js `>=18.18.0`. It has no runtime npm dependencies; Ajv, TypeScript, and Node.js type definitions are development dependencies. The package exposes `dist/index.js` and `dist/index.d.ts` through `main`, `types`, and `exports`; temporary packed-install CLI and library import smoke checks pass.
 
 The CLI supports:
 
@@ -67,8 +70,10 @@ The supported profile is `cfml-structure-v1`. Unknown/custom/imported tags, opti
 - `src/cli/index.ts`: CLI argument parsing and rendering;
 - `schema/`: JSON Schema for result envelopes;
 - `fixtures/`: valid and misnested examples;
-- `test/`: implementation and CLI tests;
+- `test/`: implementation, CLI, and package-surface tests;
+- `skills/agent-cfml-check/SKILL.md`: repository-local Agent usage workflow;
+- `.github/workflows/ci.yml`: Node 18/20/22 CI and CLI smoke checks;
 - `dist/`: generated package output;
 - `DESIGN.md`, `EPIC.md`, `ROADMAP.md`, `TASK.md`, `GOAL.md`, `PROGRESS.md`, `GOAL_PROMPT.md`, `CHANGELOG.md`: repository design, planning, status, and maintenance documents.
 
-`package.json` currently publishes `dist`, `README.md`, `SPEC.md`, `schema`, and `fixtures`; the design, planning, progress, goal, prompt, and changelog documents remain repository-maintainer documentation. Although `src/index.ts` contains TypeScript exports, installed-package library imports are not documented as supported until `main`/`exports` are added and tested.
+`package.json` currently publishes `dist`, `README.md`, `SPEC.md`, `schema`, and `fixtures`; the design, planning, progress, goal, prompt, changelog, and Agent Skill documents remain repository-maintainer documentation. The repository exposes the TypeScript library through `main`, `types`, and `exports`, with package-surface and packed-install tests. The release package version is `0.1.1`.

package/SPEC.md

@@ -1,7 +1,7 @@
 # Agent CFML Check Specification
 
-**Status:** frozen feasibility contract for implementation baseline `1d5c768`
-**Tool version:** `0.1.0`
+**Status:** frozen feasibility contract for implementation baseline `c76b8be`, extended by release hardening
+**Tool version:** `0.1.1`
 **Profile:** `cfml-structure-v1`
 **Envelope schema:** `schema/agent-cfml-check-result-v1.schema.json`
 
@@ -22,11 +22,11 @@ agent-cfml-check check --root <directory> <file> [--json] [--pretty]
 
 `capabilities` reports the profile, operations, extensions, tag catalogue, effective default limits, and exclusions. The CLI does not accept a file, root, or check-limit override for this operation.
 
-`check` requires exactly one explicit root and one `.cfm` or `.cfc` file. `--pretty` requires `--json`. `--help` prints usage and `--version` prints `0.1.0`; neither may be combined with other options.
+`check` requires exactly one explicit root and one `.cfm` or `.cfc` file. `--pretty` requires `--json`. `--help` prints usage and `--version` prints `0.1.1`; neither may be combined with other options.
 
 ### TypeScript interface
 
-`src/index.ts` exports `capabilities`, `checkFile`, `DEFAULT_LIMITS`, `HARD_LIMITS`, `normalizeLimits`, and schema types. The source exports exist, but package metadata currently lacks `main`/`exports`; installed-package library imports are not yet a verified contract.
+`src/index.ts` exports `capabilities`, `checkFile`, `DEFAULT_LIMITS`, `HARD_LIMITS`, `normalizeLimits`, and schema types. Repository package metadata declares `main: "./dist/index.js"`, `types: "./dist/index.d.ts"`, and an import/types `exports` map. Package-surface tests and a temporary packed-install CLI/library smoke check verify the current `0.1.1` artifact.
 
 The TypeScript `capabilities(limitsInput)` API may receive limit overrides, while the CLI `capabilities` operation rejects them.
 
@@ -111,6 +111,6 @@ JSON mode emits one envelope on stdout; failure diagnostics are also written to
 
 ## 9. Evidence boundary
 
-The profile does not validate full CFML grammar, expression/type/runtime semantics, HTML, SQL, include expansion, directory/project context, Lucee/Adobe execution, unknown/custom/imported tags, or CFML tag islands inside `cfscript`. Package publication, Hub lifecycle, cross-platform compatibility, and installed-package library imports are also outside current verified evidence.
+The profile does not validate full CFML grammar, expression/type/runtime semantics, HTML, SQL, include expansion, directory/project context, Lucee/Adobe execution, unknown/custom/imported tags, or CFML tag islands inside `cfscript`. The `agent-cfml-check@0.1.1` CLI package is prepared for publication; authenticated npm registry readback remains required. Repository package export metadata, executable schema validation, and temporary packed-install verification are complete. A targeted Lucee `6.2.2.91` probe and Ubuntu WSL Node `18.19.1` verification pass, but they do not establish a full engine matrix. Adobe ColdFusion, Hub lifecycle, canonical ownership/admission, and registry parity remain outside current verified evidence.
 
-The repository tests cover CF-01 through CF-13, pure-script `.cfc` handling, and three CLI behaviors. Current local evidence is 17/17 tests, typecheck pass, package dry-run pass, and Windows CLI smoke checks. JSON Schema validation, engine comparison, non-Windows verification, and publication remain pending.
+The repository tests cover CF-01 through CF-13, pure-script `.cfc` handling, three CLI behaviors, and the package export surface. Current local evidence is 22/22 tests, typecheck pass, package dry-run pass, Windows CLI smoke checks, temporary packed-install CLI/library smoke checks, and JSON Schema validation. The prior immutable `0.1.0` artifact predates this release hardening; `0.1.1` registry readback remains required. Full Lucee/Adobe engine comparison, canonical Hub admission, and registry parity remain pending.

package/dist/cli/index.js

@@ -2,6 +2,7 @@
 import { capabilities, checkFile } from "../core/checker.js";
 import { DEFAULT_LIMITS } from "../core/limits.js";
 import { ToolFailure } from "../schema/errors.js";
+import { TOOL_ID, TOOL_VERSION } from "../schema/types.js";
 import { pathToFileURL } from "node:url";
 import path from "node:path";
 const HELP = `agent-cfml-check — deterministic, read-only structural checks for a bounded CFML subset
@@ -121,7 +122,7 @@ export function main(argv = process.argv.slice(2)) {
             return 0;
         }
         if (args.version) {
-            process.stdout.write(`${"0.1.0"}\n`);
+            process.stdout.write(`${TOOL_VERSION}\n`);
             return 0;
         }
         const result = args.operation === "capabilities"
@@ -140,7 +141,7 @@ export function main(argv = process.argv.slice(2)) {
         const failure = error instanceof ToolFailure ? error : new ToolFailure("INTERNAL_ERROR", "The CLI failed without a safe result", 1);
         const envelope = {
             schema_version: "1.0.0",
-            tool: { id: "agent-cfml-check", version: "0.1.0" },
+            tool: { id: TOOL_ID, version: TOOL_VERSION },
             status: "error",
             complete: false,
             data: null,

package/dist/schema/types.d.ts

@@ -1,5 +1,5 @@
 export declare const TOOL_ID: "agent-cfml-check";
-export declare const TOOL_VERSION: "0.1.0";
+export declare const TOOL_VERSION: "0.1.1";
 export declare const PROFILE_ID: "cfml-structure-v1";
 export interface Position {
     line: number;

package/dist/schema/types.js

@@ -1,3 +1,3 @@
 export const TOOL_ID = "agent-cfml-check";
-export const TOOL_VERSION = "0.1.0";
+export const TOOL_VERSION = "0.1.1";
 export const PROFILE_ID = "cfml-structure-v1";

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "agent-cfml-check",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Deterministic, read-only structural checks for a bounded CFML subset.",
   "type": "module",
   "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "engines": {
     "node": ">=18.18.0"
   },
@@ -20,11 +28,12 @@
   "scripts": {
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "build": "tsc -p tsconfig.build.json",
-    "test": "npm run build && tsc -p tsconfig.test.json && node --test .test-dist/test/check.test.js .test-dist/test/cli.test.js",
+    "test": "npm run build && tsc -p tsconfig.test.json && node --test .test-dist/test/check.test.js .test-dist/test/cli.test.js .test-dist/test/package.test.js .test-dist/test/schema.test.js",
     "prepack": "npm run build"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "ajv": "^8.20.0",
     "typescript": "^5.7.0"
   }
 }