@kitelev/exocortex-cli 16.170.3 → 16.170.4

package/README.md

@@ -54,6 +54,7 @@ The following v15 verbs were **removed**: `batch`, `batch-repair`, `command`, `d
 | [`resolve`](#resolve)                     | Resolve a UUID (full or partial) to a file path                                    |
 | [`workflow`](#workflow)                   | List / show / validate workflow definitions                                        |
 | [`recover`](#recover)                     | Detect and recover orphaned claude-child tmux sessions                             |
+| [`scaffold`](#scaffold)                   | Scaffold homoiconic configuration assets (validation-check settings)               |
 | [`audit`](#audit)                         | Regression-pattern audits (`co-location`, `ontology-imports`)                      |
 | [`apply-profile`](#apply-profile)         | Apply an `exo__Profile` (mount-state filesystem mutation)                          |
 | [`bootstrap`](#bootstrap)                 | Bootstrap a vault with the SDK floor AssetSpace                                    |
@@ -62,6 +63,7 @@ The following v15 verbs were **removed**: `batch`, `batch-repair`, `command`, `d
 | [`exosync`](#exosync)                     | Sync / pull / push the materialized AssetSpace set over the GitHub REST API        |
 | [`exosync-parity`](#exosync-parity)       | Read-only ExoSync divergence report (M1/M2 parity check)                           |
 | [`resolve-deps`](#resolve-deps)           | Resolve an AssetSpace's transitive `dependsOn` closure from the registry (CI gate) |
+| [`requirements`](#requirements)           | Requirements↔test traceability checker (RFC 0003)                                  |
 
 ---
 
@@ -385,6 +387,22 @@ npx @kitelev/exocortex-cli recover --apply --vault ~/vault-2025
 | `--dry-run`      | —                                    | List orphans without applying changes (default behavior) |
 | `--apply`        | off                                  | Apply recovery: set Failed + kill the tmux session       |
 
+### scaffold
+
+Scaffold homoiconic configuration assets. Currently exposes one subcommand, `validation-settings`, which materializes the four validation-check `setting__Setting` instances (`uid-uniqueness=true`, the rest `false`) co-located in the chosen ontology's folder, so `validate vault` has an enabled-set to read (RFC f402002b).
+
+```bash
+npx @kitelev/exocortex-cli scaffold validation-settings \
+  --vault ~/vault-2025 \
+  --ontology <ontology-uid>
+```
+
+| Option             | Default      | Description                                                           |
+| ------------------ | ------------ | --------------------------------------------------------------------- |
+| `--vault <path>`   | **required** | Vault root directory                                                  |
+| `--ontology <uid>` | **required** | UID of the ontology whose folder the check settings are co-located in |
+| `--output <type>`  | `text`       | Response format: `text` \| `json`                                     |
+
 ---
 
 ## Vault Management Commands
@@ -548,6 +566,24 @@ npx @kitelev/exocortex-cli resolve-deps \
 | `--format <type>`   | `urls`       | Output format: `urls` (one clone URL per line) or `json` (full diagnostics)                                                    |
 | `--strict`          | off          | Exit non-zero (`2`) when `self` is not registered, instead of validating standalone                                            |
 
+### requirements
+
+Requirements-management tooling (RFC 0003). The `requirements audit` subcommand checks requirement↔test traceability — orphan requirements, dangling `@req:<uid>` tags, duplicate bindings, the binding-class floor, coverage, and P0 ramp-readiness. Used by the `requirements-trace` CI job.
+
+```bash
+npx @kitelev/exocortex-cli requirements audit \
+  --reqs ./exoas-exo-reqs \
+  --tests .
+```
+
+| Option            | Default      | Description                                                                            |
+| ----------------- | ------------ | -------------------------------------------------------------------------------------- |
+| `--reqs <path>`   | **required** | Directory tree containing `req__Requirement` assets (a vault or a reqs assetspace)     |
+| `--tests <path>`  | `.`          | Test-corpus root scanned for `@req:<uid>` tags                                         |
+| `--output <type>` | `text`       | Response format: `text` \| `json`                                                      |
+| `--strict`        | off          | Also exit `1` on orphan requirements                                                   |
+| `--gate <mode>`   | `soft`       | Gate mode: `soft` (warn only) \| `hard` (also block when the P0 checklist isn't ready) |
+
 ---
 
 ## Exit Codes

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// @kitelev/exocortex-cli v16.170.3
+// @kitelev/exocortex-cli v16.170.4
 // CLI tool for Exocortex knowledge management system - SPARQL queries, task management, and more
 // License: MIT
 
@@ -637,7 +637,7 @@ Duplicate bindings (${n.duplicates.length}) \u2014 uid claimed by >1 test (warni
 Skipped floor check for ${n.unknownPriority} requirement(s) with unparseable priority (fail-open).`),n.clean?e==="hard"&&!n.rampReady?console.error(`
 FAIL (hard gate): ramp not ready \u2014 ${n.p0Orphans} P0 requirement(s) unbound`+(n.p0Total===0?" (no P0 requirements found)":"")+"."):console.log(`
 OK: no hard findings (dangling tags + binding-class floor are clean).`):console.error(`
-FAIL: ${n.dangling.length} dangling + ${n.floorViolations.length} floor violation(s) + ${n.activeViolations.length} active-requirement invariant violation(s) + ${n.danglingEvidence.length} dangling evidence link(s).`)}a(noe,"renderText");function ioe(n,e,t){return!n.clean||t&&n.orphans.length>0||e==="hard"&&!n.rampReady}a(ioe,"isHardFail");function w9(){return new ke("audit").description("Audit requirement\u2194test traceability: orphans, dangling @req tags, duplicate bindings, binding-class floor, coverage, P0 ramp-readiness").requiredOption("--reqs <path>","Directory tree containing req__Requirement assets (a vault or a reqs assetspace clone)").option("--tests <path>","Test-corpus root scanned for @req:<uid> tags",".").option("--output <type>","Response format: text|json","text").option("--strict","Also exit 1 on orphan requirements",!1).option("--gate <mode>","Gate mode: soft (warn only on hard findings) | hard (also block when the P0 checklist is not ramp-ready)","soft").action(async n=>{let e=n.output??"text";Se.setFormat(e);let t=n.gate==="hard"?"hard":"soft";try{let r=(0,Ba.resolve)(n.reqs);if(!(0,Va.existsSync)(r)||!(0,Va.statSync)(r).isDirectory())throw new Ze(r);let i=(0,Ba.resolve)(n.tests??".");if(!(0,Va.existsSync)(i)||!(0,Va.statSync)(i).isDirectory())throw new Ze(i);let[s,o]=await Promise.all([Jse(r),eoe(i)]),c=toe(s,o);e==="json"?console.log(JSON.stringify({...c,gate:t},null,2)):noe(c,t),ioe(c,t,n.strict===!0)&&(process.exitCode=1)}catch(r){Se.handle(r)}})}a(w9,"requirementsAuditCommand");function v9(){let n=new ke("requirements").description("Requirements-management tooling (RFC 0003): traceability checker");return n.addCommand(w9()),n}a(v9,"requirementsCommand");function I_(n){let e=new ke;return e.name("exocortex").description("CLI tool for Exocortex knowledge management system").version(n??"16.170.3"),e.addCommand(gj()),e.addCommand(Ij()),e.addCommand(h4()),e.addCommand(y4()),e.addCommand($4()),e.addCommand(_4()),e.addCommand(V4()),e.addCommand(X4()),e.addCommand(Z4()),e.addCommand(hj()),e.addCommand(Vj()),e.addCommand(Wj()),e.addCommand(a9()),e.addCommand(l9()),e.addCommand(d9()),e.addCommand(h9()),e.addCommand(y9()),e.addCommand(Jj()),e.addCommand(i9()),e.addCommand(v9()),e}a(I_,"createProgram");I_().parse();0&&(module.exports={createProgram});
+FAIL: ${n.dangling.length} dangling + ${n.floorViolations.length} floor violation(s) + ${n.activeViolations.length} active-requirement invariant violation(s) + ${n.danglingEvidence.length} dangling evidence link(s).`)}a(noe,"renderText");function ioe(n,e,t){return!n.clean||t&&n.orphans.length>0||e==="hard"&&!n.rampReady}a(ioe,"isHardFail");function w9(){return new ke("audit").description("Audit requirement\u2194test traceability: orphans, dangling @req tags, duplicate bindings, binding-class floor, coverage, P0 ramp-readiness").requiredOption("--reqs <path>","Directory tree containing req__Requirement assets (a vault or a reqs assetspace clone)").option("--tests <path>","Test-corpus root scanned for @req:<uid> tags",".").option("--output <type>","Response format: text|json","text").option("--strict","Also exit 1 on orphan requirements",!1).option("--gate <mode>","Gate mode: soft (warn only on hard findings) | hard (also block when the P0 checklist is not ramp-ready)","soft").action(async n=>{let e=n.output??"text";Se.setFormat(e);let t=n.gate==="hard"?"hard":"soft";try{let r=(0,Ba.resolve)(n.reqs);if(!(0,Va.existsSync)(r)||!(0,Va.statSync)(r).isDirectory())throw new Ze(r);let i=(0,Ba.resolve)(n.tests??".");if(!(0,Va.existsSync)(i)||!(0,Va.statSync)(i).isDirectory())throw new Ze(i);let[s,o]=await Promise.all([Jse(r),eoe(i)]),c=toe(s,o);e==="json"?console.log(JSON.stringify({...c,gate:t},null,2)):noe(c,t),ioe(c,t,n.strict===!0)&&(process.exitCode=1)}catch(r){Se.handle(r)}})}a(w9,"requirementsAuditCommand");function v9(){let n=new ke("requirements").description("Requirements-management tooling (RFC 0003): traceability checker");return n.addCommand(w9()),n}a(v9,"requirementsCommand");function I_(n){let e=new ke;return e.name("exocortex").description("CLI tool for Exocortex knowledge management system - SPARQL queries, task management, and more").version(n??"16.170.4"),e.addCommand(gj()),e.addCommand(Ij()),e.addCommand(h4()),e.addCommand(y4()),e.addCommand($4()),e.addCommand(_4()),e.addCommand(V4()),e.addCommand(X4()),e.addCommand(Z4()),e.addCommand(hj()),e.addCommand(Vj()),e.addCommand(Wj()),e.addCommand(a9()),e.addCommand(l9()),e.addCommand(d9()),e.addCommand(h9()),e.addCommand(y9()),e.addCommand(Jj()),e.addCommand(i9()),e.addCommand(v9()),e}a(I_,"createProgram");I_().parse();0&&(module.exports={createProgram});
 /*! Bundled license information:
 
 reflect-metadata/Reflect.js:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitelev/exocortex-cli",
-  "version": "16.170.3",
+  "version": "16.170.4",
   "description": "CLI tool for Exocortex knowledge management system - SPARQL queries, task management, and more",
   "main": "dist/index.js",
   "bin": {