@anatomytool/validate 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +127 -0
  3. package/dist/canonical.d.ts +21 -0
  4. package/dist/canonical.d.ts.map +1 -0
  5. package/dist/canonical.js +76 -0
  6. package/dist/canonical.js.map +1 -0
  7. package/dist/checks/commands-no-test-warn.d.ts +6 -0
  8. package/dist/checks/commands-no-test-warn.d.ts.map +1 -0
  9. package/dist/checks/commands-no-test-warn.js +35 -0
  10. package/dist/checks/commands-no-test-warn.js.map +1 -0
  11. package/dist/checks/description-warn.d.ts +6 -0
  12. package/dist/checks/description-warn.d.ts.map +1 -0
  13. package/dist/checks/description-warn.js +23 -0
  14. package/dist/checks/description-warn.js.map +1 -0
  15. package/dist/checks/entry-point-alias-warn.d.ts +6 -0
  16. package/dist/checks/entry-point-alias-warn.d.ts.map +1 -0
  17. package/dist/checks/entry-point-alias-warn.js +25 -0
  18. package/dist/checks/entry-point-alias-warn.js.map +1 -0
  19. package/dist/checks/fingerprint-check.d.ts +6 -0
  20. package/dist/checks/fingerprint-check.d.ts.map +1 -0
  21. package/dist/checks/fingerprint-check.js +59 -0
  22. package/dist/checks/fingerprint-check.js.map +1 -0
  23. package/dist/checks/hash-check.d.ts +6 -0
  24. package/dist/checks/hash-check.d.ts.map +1 -0
  25. package/dist/checks/hash-check.js +36 -0
  26. package/dist/checks/hash-check.js.map +1 -0
  27. package/dist/checks/interface-form-check.d.ts +6 -0
  28. package/dist/checks/interface-form-check.d.ts.map +1 -0
  29. package/dist/checks/interface-form-check.js +66 -0
  30. package/dist/checks/interface-form-check.js.map +1 -0
  31. package/dist/checks/memory-dangling-ref-check.d.ts +6 -0
  32. package/dist/checks/memory-dangling-ref-check.d.ts.map +1 -0
  33. package/dist/checks/memory-dangling-ref-check.js +34 -0
  34. package/dist/checks/memory-dangling-ref-check.js.map +1 -0
  35. package/dist/checks/memory-fingerprint-check.d.ts +6 -0
  36. package/dist/checks/memory-fingerprint-check.d.ts.map +1 -0
  37. package/dist/checks/memory-fingerprint-check.js +20 -0
  38. package/dist/checks/memory-fingerprint-check.js.map +1 -0
  39. package/dist/checks/memory-supersession-check.d.ts +6 -0
  40. package/dist/checks/memory-supersession-check.d.ts.map +1 -0
  41. package/dist/checks/memory-supersession-check.js +61 -0
  42. package/dist/checks/memory-supersession-check.js.map +1 -0
  43. package/dist/checks/memory-verification-check.d.ts +6 -0
  44. package/dist/checks/memory-verification-check.d.ts.map +1 -0
  45. package/dist/checks/memory-verification-check.js +61 -0
  46. package/dist/checks/memory-verification-check.js.map +1 -0
  47. package/dist/checks/nested-path-escape.d.ts +6 -0
  48. package/dist/checks/nested-path-escape.d.ts.map +1 -0
  49. package/dist/checks/nested-path-escape.js +76 -0
  50. package/dist/checks/nested-path-escape.js.map +1 -0
  51. package/dist/checks/schema-check.d.ts +6 -0
  52. package/dist/checks/schema-check.d.ts.map +1 -0
  53. package/dist/checks/schema-check.js +32 -0
  54. package/dist/checks/schema-check.js.map +1 -0
  55. package/dist/checks/source-cross-check.d.ts +52 -0
  56. package/dist/checks/source-cross-check.d.ts.map +1 -0
  57. package/dist/checks/source-cross-check.js +473 -0
  58. package/dist/checks/source-cross-check.js.map +1 -0
  59. package/dist/checks/source-path-check.d.ts +6 -0
  60. package/dist/checks/source-path-check.d.ts.map +1 -0
  61. package/dist/checks/source-path-check.js +62 -0
  62. package/dist/checks/source-path-check.js.map +1 -0
  63. package/dist/checks/structure-path-check.d.ts +6 -0
  64. package/dist/checks/structure-path-check.d.ts.map +1 -0
  65. package/dist/checks/structure-path-check.js +31 -0
  66. package/dist/checks/structure-path-check.js.map +1 -0
  67. package/dist/checks/verify/ast-grep-verifier.d.ts +4 -0
  68. package/dist/checks/verify/ast-grep-verifier.d.ts.map +1 -0
  69. package/dist/checks/verify/ast-grep-verifier.js +153 -0
  70. package/dist/checks/verify/ast-grep-verifier.js.map +1 -0
  71. package/dist/checks/verify/detect-ast-grep.d.ts +9 -0
  72. package/dist/checks/verify/detect-ast-grep.d.ts.map +1 -0
  73. package/dist/checks/verify/detect-ast-grep.js +26 -0
  74. package/dist/checks/verify/detect-ast-grep.js.map +1 -0
  75. package/dist/checks/verify/detect-semgrep.d.ts +8 -0
  76. package/dist/checks/verify/detect-semgrep.d.ts.map +1 -0
  77. package/dist/checks/verify/detect-semgrep.js +36 -0
  78. package/dist/checks/verify/detect-semgrep.js.map +1 -0
  79. package/dist/checks/verify/glob-verifier.d.ts +5 -0
  80. package/dist/checks/verify/glob-verifier.d.ts.map +1 -0
  81. package/dist/checks/verify/glob-verifier.js +58 -0
  82. package/dist/checks/verify/glob-verifier.js.map +1 -0
  83. package/dist/checks/verify/semgrep-pattern-verifier.d.ts +4 -0
  84. package/dist/checks/verify/semgrep-pattern-verifier.d.ts.map +1 -0
  85. package/dist/checks/verify/semgrep-pattern-verifier.js +121 -0
  86. package/dist/checks/verify/semgrep-pattern-verifier.js.map +1 -0
  87. package/dist/checks/verify/semgrep-rule-file-verifier.d.ts +9 -0
  88. package/dist/checks/verify/semgrep-rule-file-verifier.d.ts.map +1 -0
  89. package/dist/checks/verify/semgrep-rule-file-verifier.js +151 -0
  90. package/dist/checks/verify/semgrep-rule-file-verifier.js.map +1 -0
  91. package/dist/checks/verify/types.d.ts +44 -0
  92. package/dist/checks/verify/types.d.ts.map +1 -0
  93. package/dist/checks/verify/types.js +6 -0
  94. package/dist/checks/verify/types.js.map +1 -0
  95. package/dist/checks/verify-check.d.ts +9 -0
  96. package/dist/checks/verify-check.d.ts.map +1 -0
  97. package/dist/checks/verify-check.js +67 -0
  98. package/dist/checks/verify-check.js.map +1 -0
  99. package/dist/discovery.d.ts +13 -0
  100. package/dist/discovery.d.ts.map +1 -0
  101. package/dist/discovery.js +82 -0
  102. package/dist/discovery.js.map +1 -0
  103. package/dist/errors.d.ts +38 -0
  104. package/dist/errors.d.ts.map +1 -0
  105. package/dist/errors.js +5 -0
  106. package/dist/errors.js.map +1 -0
  107. package/dist/index.d.ts +43 -0
  108. package/dist/index.d.ts.map +1 -0
  109. package/dist/index.js +81 -0
  110. package/dist/index.js.map +1 -0
  111. package/dist/memory.d.ts +19 -0
  112. package/dist/memory.d.ts.map +1 -0
  113. package/dist/memory.js +80 -0
  114. package/dist/memory.js.map +1 -0
  115. package/dist/parse.d.ts +17 -0
  116. package/dist/parse.d.ts.map +1 -0
  117. package/dist/parse.js +47 -0
  118. package/dist/parse.js.map +1 -0
  119. package/dist/schema-0.10.json +194 -0
  120. package/dist/schema-0.11.json +203 -0
  121. package/dist/schema-0.12.json +243 -0
  122. package/dist/schema-0.13.json +267 -0
  123. package/dist/schema-0.14.json +288 -0
  124. package/dist/schema-0.15.json +347 -0
  125. package/dist/schema-0.2.json +283 -0
  126. package/dist/schema-0.4.json +280 -0
  127. package/dist/schema-0.5.json +300 -0
  128. package/dist/schema-0.6.json +328 -0
  129. package/dist/schema-0.7.json +311 -0
  130. package/dist/schema-0.8.json +245 -0
  131. package/dist/schema-0.9.json +172 -0
  132. package/dist/schema-1.0.json +347 -0
  133. package/dist/schema-memory-0.1.json +43 -0
  134. package/dist/schema-memory-0.2.json +49 -0
  135. package/dist/schema-memory.d.ts +5 -0
  136. package/dist/schema-memory.d.ts.map +1 -0
  137. package/dist/schema-memory.js +16 -0
  138. package/dist/schema-memory.js.map +1 -0
  139. package/dist/schema.d.ts +6 -0
  140. package/dist/schema.d.ts.map +1 -0
  141. package/dist/schema.js +62 -0
  142. package/dist/schema.js.map +1 -0
  143. package/dist/schema.json +129 -0
  144. package/dist/types.d.ts +2 -0
  145. package/dist/types.d.ts.map +1 -0
  146. package/dist/types.generated.d.ts +1103 -0
  147. package/dist/types.generated.d.ts.map +1 -0
  148. package/dist/types.generated.js +7 -0
  149. package/dist/types.generated.js.map +1 -0
  150. package/dist/types.js +7 -0
  151. package/dist/types.js.map +1 -0
  152. package/dist/validate-tree.d.ts +20 -0
  153. package/dist/validate-tree.d.ts.map +1 -0
  154. package/dist/validate-tree.js +64 -0
  155. package/dist/validate-tree.js.map +1 -0
  156. package/package.json +48 -0
@@ -0,0 +1,243 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://anatomy.dev/spec/0.12/schema.json",
4
+ "title": "Anatomy",
5
+ "description": "Schema for .anatomy files (v0.12). Additive over v0.11: adds optional [[rules]].verify field that declares how to check the rule against source. Three discriminated verifier kinds: glob_exists, glob_only, ast_pattern. All verify clauses run during anatomy validate --strict (the default); violations elevate to errors. v0.11 files migrate to v0.12 with no data change.",
6
+ "type": "object",
7
+ "required": ["anatomy_version", "tagline", "identity", "generated"],
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "anatomy_version": { "type": "string", "const": "0.12" },
11
+ "tagline": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
12
+ "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
13
+ "identity": { "$ref": "#/$defs/identity" },
14
+ "generated": { "$ref": "#/$defs/generated" },
15
+ "generate": { "$ref": "#/$defs/generate" },
16
+ "operation": { "$ref": "#/$defs/operation" },
17
+ "structure": { "$ref": "#/$defs/structure" },
18
+ "environment": { "$ref": "#/$defs/environment" },
19
+ "rules": {
20
+ "type": "array", "minItems": 1, "maxItems": 20,
21
+ "items": { "$ref": "#/$defs/rule" }
22
+ },
23
+ "flows": {
24
+ "type": "array", "minItems": 1, "maxItems": 15,
25
+ "items": { "$ref": "#/$defs/flow" }
26
+ },
27
+ "decisions": {
28
+ "type": "array", "minItems": 1, "maxItems": 15,
29
+ "items": { "$ref": "#/$defs/decision" }
30
+ }
31
+ },
32
+ "$defs": {
33
+ "identity": {
34
+ "type": "object",
35
+ "required": ["stack", "form", "domain", "function", "fingerprint"],
36
+ "additionalProperties": false,
37
+ "properties": {
38
+ "stack": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
39
+ "form": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
40
+ "domain": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
41
+ "function": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
42
+ "fingerprint": { "type": "string", "pattern": "^[a-z0-9]{20}$" }
43
+ }
44
+ },
45
+ "rule": {
46
+ "type": "object",
47
+ "required": ["rule"],
48
+ "additionalProperties": false,
49
+ "properties": {
50
+ "rule": { "type": "string", "minLength": 1, "maxLength": 300 },
51
+ "why": { "type": "string", "minLength": 1, "maxLength": 200 },
52
+ "verify": { "$ref": "#/$defs/verify" }
53
+ }
54
+ },
55
+ "verify": {
56
+ "type": "object",
57
+ "required": ["kind"],
58
+ "oneOf": [
59
+ {
60
+ "additionalProperties": false,
61
+ "properties": {
62
+ "kind": { "const": "glob_exists" },
63
+ "path": { "type": "string", "minLength": 1, "description": "Glob (repo-root-relative). With should_not=false: ≥1 file must match. With should_not=true: 0 files must match." },
64
+ "should_not": { "type": "boolean", "description": "Invert: assert NO files match the glob. Default false." }
65
+ },
66
+ "required": ["kind", "path"]
67
+ },
68
+ {
69
+ "additionalProperties": false,
70
+ "properties": {
71
+ "kind": { "const": "glob_only" },
72
+ "match": { "type": "string", "minLength": 1, "description": "Glob of files to locate." },
73
+ "container": { "type": "string", "minLength": 1, "description": "Glob; every file from `match` must also match this." }
74
+ },
75
+ "required": ["kind", "match", "container"]
76
+ },
77
+ {
78
+ "additionalProperties": false,
79
+ "properties": {
80
+ "kind": { "const": "ast_pattern" },
81
+ "lang": { "enum": ["ts", "tsx", "js", "jsx", "py", "rs", "go", "java"], "description": "Language for ast-grep parser." },
82
+ "pattern": { "type": "string", "minLength": 1, "description": "ast-grep pattern (inline string)." },
83
+ "expect_in": { "type": "string", "minLength": 1, "description": "Glob: pattern must match in ≥1 file." },
84
+ "forbid_in": { "type": "string", "minLength": 1, "description": "Glob: pattern must match in 0 files." }
85
+ },
86
+ "required": ["kind", "lang", "pattern"],
87
+ "oneOf": [
88
+ { "required": ["expect_in"], "not": { "required": ["forbid_in"] } },
89
+ { "required": ["forbid_in"], "not": { "required": ["expect_in"] } }
90
+ ]
91
+ }
92
+ ]
93
+ },
94
+ "flow": {
95
+ "type": "object",
96
+ "required": ["name", "summary"],
97
+ "additionalProperties": false,
98
+ "properties": {
99
+ "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
100
+ "summary": { "type": "string", "minLength": 1, "maxLength": 300, "pattern": "^[^\\n\\r]+$" }
101
+ }
102
+ },
103
+ "decision": {
104
+ "type": "object",
105
+ "required": ["topic", "reason"],
106
+ "additionalProperties": false,
107
+ "properties": {
108
+ "topic": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
109
+ "reason": { "type": "string", "minLength": 1, "maxLength": 400 }
110
+ }
111
+ },
112
+ "generated": {
113
+ "type": "object",
114
+ "required": ["at", "by", "model", "schema"],
115
+ "additionalProperties": false,
116
+ "properties": {
117
+ "at": { "type": "string", "format": "date-time" },
118
+ "commit": { "type": "string", "pattern": "^[0-9a-f]{7,12}$" },
119
+ "by": { "type": "string", "minLength": 1 },
120
+ "model": { "type": "string", "minLength": 1 },
121
+ "schema": { "type": "string", "format": "uri" }
122
+ }
123
+ },
124
+ "generate": {
125
+ "type": "object",
126
+ "additionalProperties": false,
127
+ "description": "Per-repo render preferences. All fields optional with defaults. Holds human choice (uncapturable), not derivable content. v0.11 added per-tool emit flags (Cursor/Aider/Cline/Roo/Continue/Windsurf) plus a shared render_budget and render_memory_count for the new renderers.",
128
+ "properties": {
129
+ "agents_md": {
130
+ "type": "boolean",
131
+ "description": "Emit AGENTS.md on `anatomy render` (default true)."
132
+ },
133
+ "agents_md_budget": {
134
+ "type": "integer",
135
+ "minimum": 500,
136
+ "description": "Token cap for the emitted AGENTS.md (default 1500)."
137
+ },
138
+ "agents_md_memory_count": {
139
+ "type": "integer",
140
+ "minimum": 0,
141
+ "description": "Max recent-memory entries surfaced in AGENTS.md (default 10)."
142
+ },
143
+ "cursor_mdc": { "type": "boolean", "description": "Emit .cursor/rules/anatomy.mdc (default false)." },
144
+ "cursor_rules": { "type": "boolean", "description": "Emit .cursorrules (default false)." },
145
+ "aider_conventions": { "type": "boolean", "description": "Emit CONVENTIONS.md (default false)." },
146
+ "cline_rules": { "type": "boolean", "description": "Emit .clinerules (default false)." },
147
+ "roo_rules": { "type": "boolean", "description": "Emit .roorules (default false)." },
148
+ "continue_rules": { "type": "boolean", "description": "Emit .continuerules (default false)." },
149
+ "windsurf_rules": { "type": "boolean", "description": "Emit .windsurfrules (default false)." },
150
+ "render_budget": { "type": "integer", "minimum": 500, "description": "Token cap for all v0.11 renderers (default 1500)." },
151
+ "render_memory_count": { "type": "integer", "minimum": 0, "description": "Max memory entries for v0.11 renderers (default 10)." }
152
+ }
153
+ },
154
+ "operation": {
155
+ "type": "object",
156
+ "additionalProperties": false,
157
+ "properties": {
158
+ "entry_points": {
159
+ "type": "array", "maxItems": 10,
160
+ "items": { "$ref": "#/$defs/entry_point" }
161
+ },
162
+ "commands": {
163
+ "type": "object",
164
+ "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)?$" },
165
+ "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 200 },
166
+ "maxProperties": 25
167
+ },
168
+ "conventions": {
169
+ "type": "object",
170
+ "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
171
+ "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120 },
172
+ "maxProperties": 15
173
+ }
174
+ }
175
+ },
176
+ "entry_point": {
177
+ "type": "object",
178
+ "required": ["path", "role"],
179
+ "additionalProperties": false,
180
+ "not": { "required": ["description", "purpose"] },
181
+ "properties": {
182
+ "path": { "type": "string", "minLength": 1, "maxLength": 256 },
183
+ "role": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
184
+ "purpose": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" },
185
+ "description": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" }
186
+ }
187
+ },
188
+ "structure": {
189
+ "type": "object", "additionalProperties": false, "required": ["entries"],
190
+ "properties": {
191
+ "entries": {
192
+ "type": "array", "minItems": 1, "maxItems": 25,
193
+ "items": {
194
+ "type": "object", "required": ["path", "purpose", "kind"], "additionalProperties": false,
195
+ "properties": {
196
+ "path": { "type": "string", "minLength": 1, "maxLength": 256 },
197
+ "purpose": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
198
+ "kind": { "enum": ["source", "tests", "docs", "config", "build", "scripts", "examples", "generated", "other"] },
199
+ "convention": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\n\\r]+$" }
200
+ }
201
+ }
202
+ }
203
+ }
204
+ },
205
+ "environment": {
206
+ "type": "object", "additionalProperties": false,
207
+ "anyOf": [
208
+ { "required": ["language_version"] }, { "required": ["runtime"] },
209
+ { "required": ["os"] }, { "required": ["required_services"] }, { "required": ["required_env"] }
210
+ ],
211
+ "properties": {
212
+ "language_version": { "type": "string", "minLength": 1, "maxLength": 80 },
213
+ "runtime": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
214
+ "os": {
215
+ "oneOf": [
216
+ { "type": "array", "items": { "const": "any" }, "minItems": 1, "maxItems": 1 },
217
+ { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "enum": ["linux", "macos", "windows", "freebsd"] } }
218
+ ]
219
+ },
220
+ "required_services": {
221
+ "type": "array", "minItems": 1, "maxItems": 10,
222
+ "items": {
223
+ "type": "object", "required": ["name", "why"], "additionalProperties": false,
224
+ "properties": {
225
+ "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
226
+ "why": { "type": "string", "minLength": 1, "maxLength": 80 }
227
+ }
228
+ }
229
+ },
230
+ "required_env": {
231
+ "type": "array", "minItems": 1, "maxItems": 25,
232
+ "items": {
233
+ "type": "object", "required": ["name", "why"], "additionalProperties": false,
234
+ "properties": {
235
+ "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
236
+ "why": { "type": "string", "minLength": 1, "maxLength": 80 }
237
+ }
238
+ }
239
+ }
240
+ }
241
+ }
242
+ }
243
+ }
@@ -0,0 +1,267 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://anatomy.dev/spec/0.13/schema.json",
4
+ "title": "Anatomy",
5
+ "description": "Schema for .anatomy files (v0.13). Additive over v0.12: adds 4th verify.kind = \"semgrep\" variant with two sub-shapes (inline pattern + lang, or YAML rule_file). Mutually exclusive with each other via nested oneOf. v0.12 files migrate to v0.13 with no data change.",
6
+ "type": "object",
7
+ "required": ["anatomy_version", "tagline", "identity", "generated"],
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "anatomy_version": { "type": "string", "const": "0.13" },
11
+ "tagline": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
12
+ "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
13
+ "identity": { "$ref": "#/$defs/identity" },
14
+ "generated": { "$ref": "#/$defs/generated" },
15
+ "generate": { "$ref": "#/$defs/generate" },
16
+ "operation": { "$ref": "#/$defs/operation" },
17
+ "structure": { "$ref": "#/$defs/structure" },
18
+ "environment": { "$ref": "#/$defs/environment" },
19
+ "rules": {
20
+ "type": "array", "minItems": 1, "maxItems": 20,
21
+ "items": { "$ref": "#/$defs/rule" }
22
+ },
23
+ "flows": {
24
+ "type": "array", "minItems": 1, "maxItems": 15,
25
+ "items": { "$ref": "#/$defs/flow" }
26
+ },
27
+ "decisions": {
28
+ "type": "array", "minItems": 1, "maxItems": 15,
29
+ "items": { "$ref": "#/$defs/decision" }
30
+ }
31
+ },
32
+ "$defs": {
33
+ "identity": {
34
+ "type": "object",
35
+ "required": ["stack", "form", "domain", "function", "fingerprint"],
36
+ "additionalProperties": false,
37
+ "properties": {
38
+ "stack": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
39
+ "form": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
40
+ "domain": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
41
+ "function": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
42
+ "fingerprint": { "type": "string", "pattern": "^[a-z0-9]{20}$" }
43
+ }
44
+ },
45
+ "rule": {
46
+ "type": "object",
47
+ "required": ["rule"],
48
+ "additionalProperties": false,
49
+ "properties": {
50
+ "rule": { "type": "string", "minLength": 1, "maxLength": 300 },
51
+ "why": { "type": "string", "minLength": 1, "maxLength": 200 },
52
+ "verify": { "$ref": "#/$defs/verify" }
53
+ }
54
+ },
55
+ "verify": {
56
+ "type": "object",
57
+ "required": ["kind"],
58
+ "oneOf": [
59
+ {
60
+ "additionalProperties": false,
61
+ "properties": {
62
+ "kind": { "const": "glob_exists" },
63
+ "path": { "type": "string", "minLength": 1, "description": "Glob (repo-root-relative). With should_not=false: ≥1 file must match. With should_not=true: 0 files must match." },
64
+ "should_not": { "type": "boolean", "description": "Invert: assert NO files match the glob. Default false." }
65
+ },
66
+ "required": ["kind", "path"]
67
+ },
68
+ {
69
+ "additionalProperties": false,
70
+ "properties": {
71
+ "kind": { "const": "glob_only" },
72
+ "match": { "type": "string", "minLength": 1, "description": "Glob of files to locate." },
73
+ "container": { "type": "string", "minLength": 1, "description": "Glob; every file from `match` must also match this." }
74
+ },
75
+ "required": ["kind", "match", "container"]
76
+ },
77
+ {
78
+ "additionalProperties": false,
79
+ "properties": {
80
+ "kind": { "const": "ast_pattern" },
81
+ "lang": { "enum": ["ts", "tsx", "js", "jsx", "py", "rs", "go", "java"], "description": "Language for ast-grep parser." },
82
+ "pattern": { "type": "string", "minLength": 1, "description": "ast-grep pattern (inline string)." },
83
+ "expect_in": { "type": "string", "minLength": 1, "description": "Glob: pattern must match in ≥1 file." },
84
+ "forbid_in": { "type": "string", "minLength": 1, "description": "Glob: pattern must match in 0 files." }
85
+ },
86
+ "required": ["kind", "lang", "pattern"],
87
+ "oneOf": [
88
+ { "required": ["expect_in"], "not": { "required": ["forbid_in"] } },
89
+ { "required": ["forbid_in"], "not": { "required": ["expect_in"] } }
90
+ ]
91
+ },
92
+ {
93
+ "additionalProperties": false,
94
+ "properties": {
95
+ "kind": { "const": "semgrep" },
96
+ "lang": { "enum": ["py", "go", "java", "rb", "c", "cpp", "rs", "ts", "tsx", "js", "jsx"], "description": "Language for Semgrep parser. Required when using inline pattern; absent for rule_file (the YAML declares its own languages)." },
97
+ "pattern": { "type": "string", "minLength": 1, "description": "Inline Semgrep pattern. Mutually exclusive with rule_file." },
98
+ "rule_file": { "type": "string", "minLength": 1, "pattern": "\\.ya?ml$", "description": "Repo-root-relative path to a Semgrep YAML rule file. Mutually exclusive with pattern + lang. Path must resolve inside the repo." },
99
+ "expect_in": { "type": "string", "minLength": 1, "description": "Glob: pattern must match in >=1 file." },
100
+ "forbid_in": { "type": "string", "minLength": 1, "description": "Glob: pattern must match in 0 files." }
101
+ },
102
+ "required": ["kind"],
103
+ "oneOf": [
104
+ { "required": ["pattern", "lang"], "not": { "anyOf": [{ "required": ["rule_file"] }] } },
105
+ { "required": ["rule_file"], "not": { "anyOf": [{ "required": ["pattern"] }, { "required": ["lang"] }] } }
106
+ ],
107
+ "allOf": [
108
+ {
109
+ "oneOf": [
110
+ { "required": ["expect_in"], "not": { "required": ["forbid_in"] } },
111
+ { "required": ["forbid_in"], "not": { "required": ["expect_in"] } }
112
+ ]
113
+ }
114
+ ]
115
+ }
116
+ ]
117
+ },
118
+ "flow": {
119
+ "type": "object",
120
+ "required": ["name", "summary"],
121
+ "additionalProperties": false,
122
+ "properties": {
123
+ "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
124
+ "summary": { "type": "string", "minLength": 1, "maxLength": 300, "pattern": "^[^\\n\\r]+$" }
125
+ }
126
+ },
127
+ "decision": {
128
+ "type": "object",
129
+ "required": ["topic", "reason"],
130
+ "additionalProperties": false,
131
+ "properties": {
132
+ "topic": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
133
+ "reason": { "type": "string", "minLength": 1, "maxLength": 400 }
134
+ }
135
+ },
136
+ "generated": {
137
+ "type": "object",
138
+ "required": ["at", "by", "model", "schema"],
139
+ "additionalProperties": false,
140
+ "properties": {
141
+ "at": { "type": "string", "format": "date-time" },
142
+ "commit": { "type": "string", "pattern": "^[0-9a-f]{7,12}$" },
143
+ "by": { "type": "string", "minLength": 1 },
144
+ "model": { "type": "string", "minLength": 1 },
145
+ "schema": { "type": "string", "format": "uri" }
146
+ }
147
+ },
148
+ "generate": {
149
+ "type": "object",
150
+ "additionalProperties": false,
151
+ "description": "Per-repo render preferences. All fields optional with defaults. Holds human choice (uncapturable), not derivable content. v0.11 added per-tool emit flags (Cursor/Aider/Cline/Roo/Continue/Windsurf) plus a shared render_budget and render_memory_count for the new renderers.",
152
+ "properties": {
153
+ "agents_md": {
154
+ "type": "boolean",
155
+ "description": "Emit AGENTS.md on `anatomy render` (default true)."
156
+ },
157
+ "agents_md_budget": {
158
+ "type": "integer",
159
+ "minimum": 500,
160
+ "description": "Token cap for the emitted AGENTS.md (default 1500)."
161
+ },
162
+ "agents_md_memory_count": {
163
+ "type": "integer",
164
+ "minimum": 0,
165
+ "description": "Max recent-memory entries surfaced in AGENTS.md (default 10)."
166
+ },
167
+ "cursor_mdc": { "type": "boolean", "description": "Emit .cursor/rules/anatomy.mdc (default false)." },
168
+ "cursor_rules": { "type": "boolean", "description": "Emit .cursorrules (default false)." },
169
+ "aider_conventions": { "type": "boolean", "description": "Emit CONVENTIONS.md (default false)." },
170
+ "cline_rules": { "type": "boolean", "description": "Emit .clinerules (default false)." },
171
+ "roo_rules": { "type": "boolean", "description": "Emit .roorules (default false)." },
172
+ "continue_rules": { "type": "boolean", "description": "Emit .continuerules (default false)." },
173
+ "windsurf_rules": { "type": "boolean", "description": "Emit .windsurfrules (default false)." },
174
+ "render_budget": { "type": "integer", "minimum": 500, "description": "Token cap for all v0.11 renderers (default 1500)." },
175
+ "render_memory_count": { "type": "integer", "minimum": 0, "description": "Max memory entries for v0.11 renderers (default 10)." }
176
+ }
177
+ },
178
+ "operation": {
179
+ "type": "object",
180
+ "additionalProperties": false,
181
+ "properties": {
182
+ "entry_points": {
183
+ "type": "array", "maxItems": 10,
184
+ "items": { "$ref": "#/$defs/entry_point" }
185
+ },
186
+ "commands": {
187
+ "type": "object",
188
+ "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)?$" },
189
+ "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 200 },
190
+ "maxProperties": 25
191
+ },
192
+ "conventions": {
193
+ "type": "object",
194
+ "propertyNames": { "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
195
+ "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 120 },
196
+ "maxProperties": 15
197
+ }
198
+ }
199
+ },
200
+ "entry_point": {
201
+ "type": "object",
202
+ "required": ["path", "role"],
203
+ "additionalProperties": false,
204
+ "not": { "required": ["description", "purpose"] },
205
+ "properties": {
206
+ "path": { "type": "string", "minLength": 1, "maxLength": 256 },
207
+ "role": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
208
+ "purpose": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" },
209
+ "description": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\n\\r]+$" }
210
+ }
211
+ },
212
+ "structure": {
213
+ "type": "object", "additionalProperties": false, "required": ["entries"],
214
+ "properties": {
215
+ "entries": {
216
+ "type": "array", "minItems": 1, "maxItems": 25,
217
+ "items": {
218
+ "type": "object", "required": ["path", "purpose", "kind"], "additionalProperties": false,
219
+ "properties": {
220
+ "path": { "type": "string", "minLength": 1, "maxLength": 256 },
221
+ "purpose": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\n\\r]+$" },
222
+ "kind": { "enum": ["source", "tests", "docs", "config", "build", "scripts", "examples", "generated", "other"] },
223
+ "convention": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\n\\r]+$" }
224
+ }
225
+ }
226
+ }
227
+ }
228
+ },
229
+ "environment": {
230
+ "type": "object", "additionalProperties": false,
231
+ "anyOf": [
232
+ { "required": ["language_version"] }, { "required": ["runtime"] },
233
+ { "required": ["os"] }, { "required": ["required_services"] }, { "required": ["required_env"] }
234
+ ],
235
+ "properties": {
236
+ "language_version": { "type": "string", "minLength": 1, "maxLength": 80 },
237
+ "runtime": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$", "maxLength": 40 },
238
+ "os": {
239
+ "oneOf": [
240
+ { "type": "array", "items": { "const": "any" }, "minItems": 1, "maxItems": 1 },
241
+ { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "enum": ["linux", "macos", "windows", "freebsd"] } }
242
+ ]
243
+ },
244
+ "required_services": {
245
+ "type": "array", "minItems": 1, "maxItems": 10,
246
+ "items": {
247
+ "type": "object", "required": ["name", "why"], "additionalProperties": false,
248
+ "properties": {
249
+ "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
250
+ "why": { "type": "string", "minLength": 1, "maxLength": 80 }
251
+ }
252
+ }
253
+ },
254
+ "required_env": {
255
+ "type": "array", "minItems": 1, "maxItems": 25,
256
+ "items": {
257
+ "type": "object", "required": ["name", "why"], "additionalProperties": false,
258
+ "properties": {
259
+ "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
260
+ "why": { "type": "string", "minLength": 1, "maxLength": 80 }
261
+ }
262
+ }
263
+ }
264
+ }
265
+ }
266
+ }
267
+ }