@anatomytool/validate 1.0.0

package/dist/parse.js

@@ -0,0 +1,47 @@
+// src/parse.ts
+// TOML parsing with TomlDate → ISO string normalization (so AJV's
+// format: date-time validates the parsed JSON-equivalent model per
+// the design Section 5).
+import { parse as parseToml } from "smol-toml";
+/**
+ * Parse a TOML string into its JSON-equivalent object model.
+ * smol-toml returns TomlDate (subclass of Date) for native datetimes;
+ * we normalize via Date.prototype.toISOString() so AJV's format:date-time
+ * validates the string representation. Returns a structured error on
+ * parse failure rather than throwing.
+ */
+export function parseAnatomyToml(text) {
+    try {
+        const raw = parseToml(text);
+        return { ok: true, doc: normalizeDates(raw) };
+    }
+    catch (err) {
+        // smol-toml throws TomlError with `line` and `column` properties (1-based).
+        const e = err;
+        return {
+            ok: false,
+            error: {
+                code: "toml-parse-error",
+                message: e.message ?? String(err),
+                pointer: "",
+                source: typeof e.line === "number" && typeof e.column === "number"
+                    ? { line: e.line, column: e.column }
+                    : undefined,
+            },
+        };
+    }
+}
+function normalizeDates(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(normalizeDates);
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = normalizeDates(v);
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,kEAAkE;AAClE,mEAAmE;AACnE,yBAAyB;AAEzB,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAO/C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,CAA4B,EAAE,CAAC;IAC3E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4EAA4E;QAC5E,MAAM,CAAC,GAAG,GAA2D,CAAC;QACtE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;gBACjC,OAAO,EAAE,EAAE;gBACX,MAAM,EACJ,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;oBACxD,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;oBACpC,CAAC,CAAC,SAAS;aAChB;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/schema-0.10.json

@@ -0,0 +1,194 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://anatomy.dev/spec/0.10/schema.json",
+    "title": "Anatomy",
+    "description": "Schema for .anatomy files (v0.10). Additive over v0.9: adds optional [generate] top-level section for per-repo render preferences (AGENTS.md emission, token budget, memory count). All [generate] fields are optional with defaults; v0.9 files migrate to v0.10 with no data change. The optional section conforms to the 'no derivable fields' rule — it holds per-repo human choices about rendering, not content an LLM could re-derive from source.",
+    "type": "object",
+    "required": ["anatomy_version", "tagline", "identity", "generated"],
+    "additionalProperties": false,
+    "properties": {
+        "anatomy_version": { "type": "string", "const": "0.10" },
+        "tagline": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
+        "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
+        "identity": { "$ref": "#/$defs/identity" },
+        "generated": { "$ref": "#/$defs/generated" },
+        "generate": { "$ref": "#/$defs/generate" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "structure": { "$ref": "#/$defs/structure" },
+        "environment": { "$ref": "#/$defs/environment" },
+        "rules": {
+            "type": "array", "minItems": 1, "maxItems": 20,
+            "items": { "$ref": "#/$defs/rule" }
+        },
+        "flows": {
+            "type": "array", "minItems": 1, "maxItems": 15,
+            "items": { "$ref": "#/$defs/flow" }
+        },
+        "decisions": {
+            "type": "array", "minItems": 1, "maxItems": 15,
+            "items": { "$ref": "#/$defs/decision" }
+        }
+    },
+    "$defs": {
+        "identity": {
+            "type": "object",
+            "required": ["stack", "form", "domain", "function", "fingerprint"],
+            "additionalProperties": false,
+            "properties": {
+                "stack": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "form": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "domain": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "function": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "fingerprint": { "type": "string", "pattern": "^[a-z0-9]{20}$" }
+            }
+        },
+        "rule": {
+            "type": "object",
+            "required": ["rule"],
+            "additionalProperties": false,
+            "properties": {
+                "rule": { "type": "string", "minLength": 1, "maxLength": 300 },
+                "why": { "type": "string", "minLength": 1, "maxLength": 200 }
+            }
+        },
+        "flow": {
+            "type": "object",
+            "required": ["name", "summary"],
+            "additionalProperties": false,
+            "properties": {
+                "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "summary": { "type": "string", "minLength": 1, "maxLength": 300, "pattern": "^[^\\n\\r]+$" }
+            }
+        },
+        "decision": {
+            "type": "object",
+            "required": ["topic", "reason"],
+            "additionalProperties": false,
+            "properties": {
+                "topic": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
+                "reason": { "type": "string", "minLength": 1, "maxLength": 400 }
+            }
+        },
+        "generated": {
+            "type": "object",
+            "required": ["at", "by", "model", "schema"],
+            "additionalProperties": false,
+            "properties": {
+                "at": { "type": "string", "format": "date-time" },
+                "commit": { "type": "string", "pattern": "^[0-9a-f]{7,12}$" },
+                "by": { "type": "string", "minLength": 1 },
+                "model": { "type": "string", "minLength": 1 },
+                "schema": { "type": "string", "format": "uri" }
+            }
+        },
+        "generate": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Per-repo render preferences. All fields optional with defaults. Holds human choice (uncapturable), not derivable content.",
+            "properties": {
+                "agents_md": {
+                    "type": "boolean",
+                    "description": "Emit AGENTS.md on `anatomy render` (default true)."
+                },
+                "agents_md_budget": {
+                    "type": "integer",
+                    "minimum": 500,
+                    "description": "Token cap for the emitted AGENTS.md (default 1500)."
+                },
+                "agents_md_memory_count": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "Max recent-memory entries surfaced in AGENTS.md (default 10)."
+                }
+            }
+        },
+        "operation": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "entry_points": {
+                    "type": "array", "maxItems": 10,
+                    "items": { "$ref": "#/$defs/entry_point" }
+                },
+                "commands": {
+                    "type": "object",
+                    "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)?$" },
+                    "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 200 },
+                    "maxProperties": 25
+                },
+                "conventions": {
+                    "type": "object",
+                    "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+                    "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120 },
+                    "maxProperties": 15
+                }
+            }
+        },
+        "entry_point": {
+            "type": "object",
+            "required": ["path", "role"],
+            "additionalProperties": false,
+            "not": { "required": ["description", "purpose"] },
+            "properties": {
+                "path": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "role": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+                "purpose": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" },
+                "description": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" }
+            }
+        },
+        "structure": {
+            "type": "object", "additionalProperties": false, "required": ["entries"],
+            "properties": {
+                "entries": {
+                    "type": "array", "minItems": 1, "maxItems": 25,
+                    "items": {
+                        "type": "object", "required": ["path", "purpose", "kind"], "additionalProperties": false,
+                        "properties": {
+                            "path": { "type": "string", "minLength": 1, "maxLength": 256 },
+                            "purpose": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
+                            "kind": { "enum": ["source", "tests", "docs", "config", "build", "scripts", "examples", "generated", "other"] },
+                            "convention": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\n\\r]+$" }
+                        }
+                    }
+                }
+            }
+        },
+        "environment": {
+            "type": "object", "additionalProperties": false,
+            "anyOf": [
+                { "required": ["language_version"] }, { "required": ["runtime"] },
+                { "required": ["os"] }, { "required": ["required_services"] }, { "required": ["required_env"] }
+            ],
+            "properties": {
+                "language_version": { "type": "string", "minLength": 1, "maxLength": 80 },
+                "runtime": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "os": {
+                    "oneOf": [
+                        { "type": "array", "items": { "const": "any" }, "minItems": 1, "maxItems": 1 },
+                        { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "enum": ["linux", "macos", "windows", "freebsd"] } }
+                    ]
+                },
+                "required_services": {
+                    "type": "array", "minItems": 1, "maxItems": 10,
+                    "items": {
+                        "type": "object", "required": ["name", "why"], "additionalProperties": false,
+                        "properties": {
+                            "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+                            "why": { "type": "string", "minLength": 1, "maxLength": 80 }
+                        }
+                    }
+                },
+                "required_env": {
+                    "type": "array", "minItems": 1, "maxItems": 25,
+                    "items": {
+                        "type": "object", "required": ["name", "why"], "additionalProperties": false,
+                        "properties": {
+                            "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+                            "why": { "type": "string", "minLength": 1, "maxLength": 80 }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

package/dist/schema-0.11.json

@@ -0,0 +1,203 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://anatomy.dev/spec/0.11/schema.json",
+    "title": "Anatomy",
+    "description": "Schema for .anatomy files (v0.11). Additive over v0.10: adds optional per-tool emit flags in [generate] for Cursor (.cursor/rules/anatomy.mdc + .cursorrules), Aider (CONVENTIONS.md), Cline (.clinerules), Roo Code (.roorules), Continue.dev (.continuerules), and Windsurf (.windsurfrules); plus shared render_budget and render_memory_count fields. All new fields are optional with default false / 1500 / 10. v0.10 files migrate to v0.11 with no data change.",
+    "type": "object",
+    "required": ["anatomy_version", "tagline", "identity", "generated"],
+    "additionalProperties": false,
+    "properties": {
+        "anatomy_version": { "type": "string", "const": "0.11" },
+        "tagline": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
+        "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
+        "identity": { "$ref": "#/$defs/identity" },
+        "generated": { "$ref": "#/$defs/generated" },
+        "generate": { "$ref": "#/$defs/generate" },
+        "operation": { "$ref": "#/$defs/operation" },
+        "structure": { "$ref": "#/$defs/structure" },
+        "environment": { "$ref": "#/$defs/environment" },
+        "rules": {
+            "type": "array", "minItems": 1, "maxItems": 20,
+            "items": { "$ref": "#/$defs/rule" }
+        },
+        "flows": {
+            "type": "array", "minItems": 1, "maxItems": 15,
+            "items": { "$ref": "#/$defs/flow" }
+        },
+        "decisions": {
+            "type": "array", "minItems": 1, "maxItems": 15,
+            "items": { "$ref": "#/$defs/decision" }
+        }
+    },
+    "$defs": {
+        "identity": {
+            "type": "object",
+            "required": ["stack", "form", "domain", "function", "fingerprint"],
+            "additionalProperties": false,
+            "properties": {
+                "stack": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "form": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "domain": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "function": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "fingerprint": { "type": "string", "pattern": "^[a-z0-9]{20}$" }
+            }
+        },
+        "rule": {
+            "type": "object",
+            "required": ["rule"],
+            "additionalProperties": false,
+            "properties": {
+                "rule": { "type": "string", "minLength": 1, "maxLength": 300 },
+                "why": { "type": "string", "minLength": 1, "maxLength": 200 }
+            }
+        },
+        "flow": {
+            "type": "object",
+            "required": ["name", "summary"],
+            "additionalProperties": false,
+            "properties": {
+                "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "summary": { "type": "string", "minLength": 1, "maxLength": 300, "pattern": "^[^\\n\\r]+$" }
+            }
+        },
+        "decision": {
+            "type": "object",
+            "required": ["topic", "reason"],
+            "additionalProperties": false,
+            "properties": {
+                "topic": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
+                "reason": { "type": "string", "minLength": 1, "maxLength": 400 }
+            }
+        },
+        "generated": {
+            "type": "object",
+            "required": ["at", "by", "model", "schema"],
+            "additionalProperties": false,
+            "properties": {
+                "at": { "type": "string", "format": "date-time" },
+                "commit": { "type": "string", "pattern": "^[0-9a-f]{7,12}$" },
+                "by": { "type": "string", "minLength": 1 },
+                "model": { "type": "string", "minLength": 1 },
+                "schema": { "type": "string", "format": "uri" }
+            }
+        },
+        "generate": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Per-repo render preferences. All fields optional with defaults. Holds human choice (uncapturable), not derivable content. v0.11 adds per-tool emit flags (Cursor/Aider/Cline/Roo/Continue/Windsurf) plus a shared render_budget and render_memory_count for the new renderers.",
+            "properties": {
+                "agents_md": {
+                    "type": "boolean",
+                    "description": "Emit AGENTS.md on `anatomy render` (default true)."
+                },
+                "agents_md_budget": {
+                    "type": "integer",
+                    "minimum": 500,
+                    "description": "Token cap for the emitted AGENTS.md (default 1500)."
+                },
+                "agents_md_memory_count": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "Max recent-memory entries surfaced in AGENTS.md (default 10)."
+                },
+                "cursor_mdc": { "type": "boolean", "description": "Emit .cursor/rules/anatomy.mdc (default false)." },
+                "cursor_rules": { "type": "boolean", "description": "Emit .cursorrules (default false)." },
+                "aider_conventions": { "type": "boolean", "description": "Emit CONVENTIONS.md (default false)." },
+                "cline_rules": { "type": "boolean", "description": "Emit .clinerules (default false)." },
+                "roo_rules": { "type": "boolean", "description": "Emit .roorules (default false)." },
+                "continue_rules": { "type": "boolean", "description": "Emit .continuerules (default false)." },
+                "windsurf_rules": { "type": "boolean", "description": "Emit .windsurfrules (default false)." },
+                "render_budget": { "type": "integer", "minimum": 500, "description": "Token cap for all v0.11 renderers (default 1500)." },
+                "render_memory_count": { "type": "integer", "minimum": 0, "description": "Max memory entries for v0.11 renderers (default 10)." }
+            }
+        },
+        "operation": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "entry_points": {
+                    "type": "array", "maxItems": 10,
+                    "items": { "$ref": "#/$defs/entry_point" }
+                },
+                "commands": {
+                    "type": "object",
+                    "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)?$" },
+                    "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 200 },
+                    "maxProperties": 25
+                },
+                "conventions": {
+                    "type": "object",
+                    "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+                    "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120 },
+                    "maxProperties": 15
+                }
+            }
+        },
+        "entry_point": {
+            "type": "object",
+            "required": ["path", "role"],
+            "additionalProperties": false,
+            "not": { "required": ["description", "purpose"] },
+            "properties": {
+                "path": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "role": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+                "purpose": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" },
+                "description": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" }
+            }
+        },
+        "structure": {
+            "type": "object", "additionalProperties": false, "required": ["entries"],
+            "properties": {
+                "entries": {
+                    "type": "array", "minItems": 1, "maxItems": 25,
+                    "items": {
+                        "type": "object", "required": ["path", "purpose", "kind"], "additionalProperties": false,
+                        "properties": {
+                            "path": { "type": "string", "minLength": 1, "maxLength": 256 },
+                            "purpose": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
+                            "kind": { "enum": ["source", "tests", "docs", "config", "build", "scripts", "examples", "generated", "other"] },
+                            "convention": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\n\\r]+$" }
+                        }
+                    }
+                }
+            }
+        },
+        "environment": {
+            "type": "object", "additionalProperties": false,
+            "anyOf": [
+                { "required": ["language_version"] }, { "required": ["runtime"] },
+                { "required": ["os"] }, { "required": ["required_services"] }, { "required": ["required_env"] }
+            ],
+            "properties": {
+                "language_version": { "type": "string", "minLength": 1, "maxLength": 80 },
+                "runtime": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
+                "os": {
+                    "oneOf": [
+                        { "type": "array", "items": { "const": "any" }, "minItems": 1, "maxItems": 1 },
+                        { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "enum": ["linux", "macos", "windows", "freebsd"] } }
+                    ]
+                },
+                "required_services": {
+                    "type": "array", "minItems": 1, "maxItems": 10,
+                    "items": {
+                        "type": "object", "required": ["name", "why"], "additionalProperties": false,
+                        "properties": {
+                            "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+                            "why": { "type": "string", "minLength": 1, "maxLength": 80 }
+                        }
+                    }
+                },
+                "required_env": {
+                    "type": "array", "minItems": 1, "maxItems": 25,
+                    "items": {
+                        "type": "object", "required": ["name", "why"], "additionalProperties": false,
+                        "properties": {
+                            "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+                            "why": { "type": "string", "minLength": 1, "maxLength": 80 }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}