skill-teqfw-esm-validator

Validate TeqFW-compatible ES modules with a deterministic JSON CLI.

Current package version: 0.6.0.

What It Does

The validator checks TeqFW source files against the profile/rule model documented in ctx/:

• the base profile for all modules
• the type-regular profile for regular TeqFW components
• the type-config-runtime profile for runtime configuration components
• atomic AST, JSDoc, and runtime rules owned by those profiles

The CLI accepts either:

• a single .mjs or .js file
• a directory, which is scanned recursively for matching .mjs and .js files

By default, the CLI runs the base profile. Use --profile to select a different documented profile.

Install

npm install -g @flancer32/skill-teqfw-esm-validator

The package installs the agent skill automatically during postinstall.

Update

Update the installed package the same way you installed it:

npm install -g @flancer32/skill-teqfw-esm-validator@latest

If you already have the package installed globally, this refreshes the CLI and reinstalls the bundled agent skill during postinstall.

Usage

Validate one file:

teqfw-esm-validator src/Rules/Ast/RequireDefaultExport.mjs

Validate a directory recursively:

teqfw-esm-validator src

Validate with an explicit profile:

teqfw-esm-validator --profile type-config-runtime src/Profiles/Type/Config/Runtime.mjs

The CLI prints strict JSON and exits with:

• 0 when validation succeeds
• 1 when validation fails or the CLI encounters an error

Output

Successful validation:

{
  "valid": true,
  "violations": []
}

When validating a directory, violations include the affected fileName so you can see which file failed.

CLI errors are also reported as JSON violations, for example:

• cli.missing-argument
• cli.missing-file
• cli.unknown-profile
• cli.runtime-error

Agent Skill

The packaged skill lives in skill/SKILL.md.

Development

npm install
npm test

Release notes are tracked in CHANGELOG.md.