agent-first-data 0.29.2 → 0.30.0

package/assets/cli-spec-v1.schema.json

@@ -35,6 +35,28 @@
     "lifecycle_output": {
       "$ref": "#/$defs/output"
     },
+    "exit_codes": {
+      "type": "array",
+      "description": "Exit codes this CLI returns beyond AFDATA's 0/1/2, rendered into the reference's exit-code table. 0/1/2 are AFDATA's own and may not be redeclared.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "code",
+          "meaning"
+        ],
+        "properties": {
+          "code": {
+            "type": "integer",
+            "minimum": 3,
+            "maximum": 255
+          },
+          "meaning": {
+            "$ref": "#/$defs/nonEmpty"
+          }
+        }
+      }
+    },
     "commands": {
       "type": "array",
       "minItems": 1,

package/dist/format.js

@@ -774,7 +774,13 @@ function redactSecrets(value, context = DEFAULT_CONTEXT, depth = 0) {
         for (const k of Object.keys(value)) {
             const v = value[k];
             if (isSecretKey(k, context.secretNames)) {
-                value[k] = REDACTED_MARKER;
+                // A null secret is an absent secret. Masking it would manufacture the
+                // appearance of a configured credential — readers cannot tell
+                // "***"-because-set from "***"-because-null. Redaction hides a value
+                // that exists; it does not invent one.
+                if (v !== null) {
+                    value[k] = REDACTED_MARKER;
+                }
             }
             else if (keyHasUrlSuffix(k)) {
                 if (typeof v === "string") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-first-data",
-  "version": "0.29.2",
+  "version": "0.30.0",
   "description": "A naming convention that lets AI agents understand your data without being told what it means, plus a CLI and library for reading Markdown structure and safely editing structured JSON, TOML, YAML, dotenv, and INI documents.",
   "license": "MIT",
   "repository": {