ai-code-map 0.0.0-stage → 0.1.0-alpha.3

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 (34) hide show
  1. package/AGENTS.md +26 -0
  2. package/CHANGELOG.md +54 -0
  3. package/CONTRIBUTING.md +43 -0
  4. package/LICENSE +21 -0
  5. package/README.md +369 -2
  6. package/SECURITY.md +18 -0
  7. package/config.schema.json +130 -0
  8. package/dist/cli.d.ts +4 -0
  9. package/dist/cli.js +7690 -0
  10. package/dist/cli.js.map +1 -0
  11. package/dist/compiler-worker.d.ts +2 -0
  12. package/dist/compiler-worker.js +4395 -0
  13. package/dist/compiler-worker.js.map +1 -0
  14. package/dist/index.d.ts +1339 -0
  15. package/dist/index.js +7426 -0
  16. package/dist/index.js.map +1 -0
  17. package/docs/api.md +152 -0
  18. package/docs/architecture/ADR-0001-hybrid-syntax-and-semantics.md +140 -0
  19. package/docs/artifacts.md +156 -0
  20. package/docs/backlog.md +43 -0
  21. package/docs/limitations.md +82 -0
  22. package/docs/post-alpha-roadmap.md +341 -0
  23. package/docs/schema.md +133 -0
  24. package/examples/cli-workflow.sh +9 -0
  25. package/examples/programmatic-scan.ts +33 -0
  26. package/package.json +79 -3
  27. package/schemas/code-map.schema.json +1078 -0
  28. package/schemas/diagnostics.schema.json +60 -0
  29. package/schemas/file.schema.json +247 -0
  30. package/schemas/manifest.schema.json +307 -0
  31. package/schemas/project.schema.json +192 -0
  32. package/schemas/relation.schema.json +142 -0
  33. package/schemas/symbol.schema.json +165 -0
  34. package/skills/ai-code-map/SKILL.md +39 -0
package/schemas/diagnostics.schema.json ADDED
@@ -0,0 +1,60 @@
1
+ {
2
+ "$id": "urn:ai-code-map:diagnostics:4",
3
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
4
+ "items": {
5
+ "additionalProperties": false,
6
+ "properties": {
7
+ "code": {
8
+ "enum": [
9
+ "parse-error",
10
+ "unresolved-import",
11
+ "invalid-config",
12
+ "unsupported-file",
13
+ "analysis-error",
14
+ "parser-fallback",
15
+ "compiler-config"
16
+ ],
17
+ "type": "string"
18
+ },
19
+ "column": {
20
+ "exclusiveMinimum": 0,
21
+ "maximum": 9007199254740991,
22
+ "type": "integer"
23
+ },
24
+ "file": {
25
+ "minLength": 1,
26
+ "type": "string"
27
+ },
28
+ "line": {
29
+ "exclusiveMinimum": 0,
30
+ "maximum": 9007199254740991,
31
+ "type": "integer"
32
+ },
33
+ "message": {
34
+ "minLength": 1,
35
+ "type": "string"
36
+ },
37
+ "schemaVersion": {
38
+ "const": 4,
39
+ "type": "number"
40
+ },
41
+ "severity": {
42
+ "enum": [
43
+ "info",
44
+ "warning",
45
+ "error"
46
+ ],
47
+ "type": "string"
48
+ }
49
+ },
50
+ "required": [
51
+ "schemaVersion",
52
+ "code",
53
+ "severity",
54
+ "message"
55
+ ],
56
+ "type": "object"
57
+ },
58
+ "title": "ai-code-map diagnostics artifact",
59
+ "type": "array"
60
+ }
package/schemas/file.schema.json ADDED
@@ -0,0 +1,247 @@
1
+ {
2
+ "$defs": {
3
+ "__schema0": {
4
+ "minLength": 1,
5
+ "type": "string"
6
+ }
7
+ },
8
+ "$id": "urn:ai-code-map:file:4",
9
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
10
+ "additionalProperties": false,
11
+ "properties": {
12
+ "compilerUnit": {
13
+ "minLength": 1,
14
+ "type": "string"
15
+ },
16
+ "env": {
17
+ "items": {
18
+ "type": "string"
19
+ },
20
+ "type": "array"
21
+ },
22
+ "exports": {
23
+ "items": {
24
+ "additionalProperties": false,
25
+ "properties": {
26
+ "default": {
27
+ "type": "boolean"
28
+ },
29
+ "line": {
30
+ "exclusiveMinimum": 0,
31
+ "maximum": 9007199254740991,
32
+ "type": "integer"
33
+ },
34
+ "local": {
35
+ "type": "string"
36
+ },
37
+ "name": {
38
+ "type": "string"
39
+ },
40
+ "source": {
41
+ "type": "string"
42
+ },
43
+ "typeOnly": {
44
+ "type": "boolean"
45
+ }
46
+ },
47
+ "required": [
48
+ "name",
49
+ "default",
50
+ "line"
51
+ ],
52
+ "type": "object"
53
+ },
54
+ "type": "array"
55
+ },
56
+ "frameworks": {
57
+ "items": {
58
+ "enum": [
59
+ "typescript",
60
+ "node",
61
+ "react",
62
+ "nextjs",
63
+ "nestjs"
64
+ ],
65
+ "type": "string"
66
+ },
67
+ "type": "array"
68
+ },
69
+ "hash": {
70
+ "pattern": "^[a-f0-9]{64}$",
71
+ "type": "string"
72
+ },
73
+ "id": {
74
+ "minLength": 1,
75
+ "type": "string"
76
+ },
77
+ "imports": {
78
+ "items": {
79
+ "additionalProperties": false,
80
+ "properties": {
81
+ "external": {
82
+ "type": "boolean"
83
+ },
84
+ "kind": {
85
+ "enum": [
86
+ "esm",
87
+ "commonjs"
88
+ ],
89
+ "type": "string"
90
+ },
91
+ "line": {
92
+ "exclusiveMinimum": 0,
93
+ "maximum": 9007199254740991,
94
+ "type": "integer"
95
+ },
96
+ "resolved": {
97
+ "$ref": "#/$defs/__schema0"
98
+ },
99
+ "source": {
100
+ "minLength": 1,
101
+ "type": "string"
102
+ },
103
+ "specifiers": {
104
+ "items": {
105
+ "additionalProperties": false,
106
+ "properties": {
107
+ "imported": {
108
+ "type": "string"
109
+ },
110
+ "local": {
111
+ "type": "string"
112
+ },
113
+ "typeOnly": {
114
+ "type": "boolean"
115
+ }
116
+ },
117
+ "required": [
118
+ "imported",
119
+ "local"
120
+ ],
121
+ "type": "object"
122
+ },
123
+ "type": "array"
124
+ }
125
+ },
126
+ "required": [
127
+ "source",
128
+ "specifiers",
129
+ "external",
130
+ "kind",
131
+ "line"
132
+ ],
133
+ "type": "object"
134
+ },
135
+ "type": "array"
136
+ },
137
+ "language": {
138
+ "enum": [
139
+ "ts",
140
+ "tsx",
141
+ "js",
142
+ "jsx",
143
+ "mts",
144
+ "cts",
145
+ "mjs",
146
+ "cjs"
147
+ ],
148
+ "type": "string"
149
+ },
150
+ "lines": {
151
+ "maximum": 9007199254740991,
152
+ "minimum": 0,
153
+ "type": "integer"
154
+ },
155
+ "operations": {
156
+ "items": {
157
+ "additionalProperties": false,
158
+ "properties": {
159
+ "api": {
160
+ "minLength": 1,
161
+ "type": "string"
162
+ },
163
+ "kind": {
164
+ "enum": [
165
+ "filesystem",
166
+ "http",
167
+ "database",
168
+ "queue"
169
+ ],
170
+ "type": "string"
171
+ },
172
+ "line": {
173
+ "exclusiveMinimum": 0,
174
+ "maximum": 9007199254740991,
175
+ "type": "integer"
176
+ }
177
+ },
178
+ "required": [
179
+ "kind",
180
+ "api",
181
+ "line"
182
+ ],
183
+ "type": "object"
184
+ },
185
+ "type": "array"
186
+ },
187
+ "path": {
188
+ "$ref": "#/$defs/__schema0"
189
+ },
190
+ "schemaVersion": {
191
+ "const": 4,
192
+ "type": "number"
193
+ },
194
+ "symbolIds": {
195
+ "items": {
196
+ "minLength": 1,
197
+ "type": "string"
198
+ },
199
+ "type": "array"
200
+ },
201
+ "syntax": {
202
+ "additionalProperties": false,
203
+ "properties": {
204
+ "factCount": {
205
+ "maximum": 9007199254740991,
206
+ "minimum": 0,
207
+ "type": "integer"
208
+ },
209
+ "fallbackFrom": {
210
+ "minLength": 1,
211
+ "type": "string"
212
+ },
213
+ "hadErrors": {
214
+ "type": "boolean"
215
+ },
216
+ "parser": {
217
+ "minLength": 1,
218
+ "type": "string"
219
+ }
220
+ },
221
+ "required": [
222
+ "parser",
223
+ "factCount",
224
+ "hadErrors"
225
+ ],
226
+ "type": "object"
227
+ }
228
+ },
229
+ "required": [
230
+ "schemaVersion",
231
+ "id",
232
+ "compilerUnit",
233
+ "path",
234
+ "language",
235
+ "frameworks",
236
+ "hash",
237
+ "lines",
238
+ "imports",
239
+ "exports",
240
+ "symbolIds",
241
+ "env",
242
+ "operations",
243
+ "syntax"
244
+ ],
245
+ "title": "ai-code-map file record",
246
+ "type": "object"
247
+ }
package/schemas/manifest.schema.json ADDED
@@ -0,0 +1,307 @@
1
+ {
2
+ "$defs": {
3
+ "__schema0": {
4
+ "additionalProperties": false,
5
+ "properties": {
6
+ "name": {
7
+ "minLength": 1,
8
+ "type": "string"
9
+ },
10
+ "version": {
11
+ "minLength": 1,
12
+ "type": "string"
13
+ }
14
+ },
15
+ "required": [
16
+ "name",
17
+ "version"
18
+ ],
19
+ "type": "object"
20
+ },
21
+ "__schema1": {
22
+ "minLength": 1,
23
+ "type": "string"
24
+ }
25
+ },
26
+ "$id": "urn:ai-code-map:manifest:4",
27
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
28
+ "additionalProperties": false,
29
+ "properties": {
30
+ "analyzerVersion": {
31
+ "minLength": 1,
32
+ "type": "string"
33
+ },
34
+ "analyzers": {
35
+ "items": {
36
+ "$ref": "#/$defs/__schema0"
37
+ },
38
+ "type": "array"
39
+ },
40
+ "artifacts": {
41
+ "items": {
42
+ "additionalProperties": false,
43
+ "properties": {
44
+ "hash": {
45
+ "pattern": "^[a-f0-9]{64}$",
46
+ "type": "string"
47
+ },
48
+ "path": {
49
+ "enum": [
50
+ "overview.md",
51
+ "project.json",
52
+ "files.jsonl",
53
+ "symbols.jsonl",
54
+ "relations.jsonl",
55
+ "diagnostics.json"
56
+ ],
57
+ "type": "string"
58
+ }
59
+ },
60
+ "required": [
61
+ "path",
62
+ "hash"
63
+ ],
64
+ "type": "object"
65
+ },
66
+ "type": "array"
67
+ },
68
+ "configHash": {
69
+ "pattern": "^[a-f0-9]{64}$",
70
+ "type": "string"
71
+ },
72
+ "integrityHash": {
73
+ "pattern": "^[a-f0-9]{64}$",
74
+ "type": "string"
75
+ },
76
+ "producer": {
77
+ "additionalProperties": false,
78
+ "properties": {
79
+ "fingerprint": {
80
+ "pattern": "^[a-f0-9]{64}$",
81
+ "type": "string"
82
+ },
83
+ "id": {
84
+ "minLength": 1,
85
+ "type": "string"
86
+ },
87
+ "kind": {
88
+ "enum": [
89
+ "built-in",
90
+ "custom"
91
+ ],
92
+ "type": "string"
93
+ }
94
+ },
95
+ "required": [
96
+ "id",
97
+ "kind",
98
+ "fingerprint"
99
+ ],
100
+ "type": "object"
101
+ },
102
+ "schemaVersion": {
103
+ "const": 4,
104
+ "type": "number"
105
+ },
106
+ "semanticInputs": {
107
+ "items": {
108
+ "oneOf": [
109
+ {
110
+ "additionalProperties": false,
111
+ "properties": {
112
+ "hash": {
113
+ "pattern": "^[a-f0-9]{64}$",
114
+ "type": "string"
115
+ },
116
+ "kind": {
117
+ "const": "file",
118
+ "type": "string"
119
+ },
120
+ "path": {
121
+ "$ref": "#/$defs/__schema1"
122
+ }
123
+ },
124
+ "required": [
125
+ "path",
126
+ "kind",
127
+ "hash"
128
+ ],
129
+ "type": "object"
130
+ },
131
+ {
132
+ "additionalProperties": false,
133
+ "properties": {
134
+ "exists": {
135
+ "type": "boolean"
136
+ },
137
+ "kind": {
138
+ "const": "resolution-probe",
139
+ "type": "string"
140
+ },
141
+ "path": {
142
+ "$ref": "#/$defs/__schema1"
143
+ },
144
+ "scope": {
145
+ "enum": [
146
+ "project",
147
+ "toolchain"
148
+ ],
149
+ "type": "string"
150
+ },
151
+ "targetKind": {
152
+ "enum": [
153
+ "file",
154
+ "directory",
155
+ "readable-file"
156
+ ],
157
+ "type": "string"
158
+ }
159
+ },
160
+ "required": [
161
+ "path",
162
+ "kind",
163
+ "scope",
164
+ "targetKind",
165
+ "exists"
166
+ ],
167
+ "type": "object"
168
+ },
169
+ {
170
+ "additionalProperties": false,
171
+ "properties": {
172
+ "hash": {
173
+ "pattern": "^[a-f0-9]{64}$",
174
+ "type": "string"
175
+ },
176
+ "kind": {
177
+ "const": "directory-listing",
178
+ "type": "string"
179
+ },
180
+ "path": {
181
+ "$ref": "#/$defs/__schema1"
182
+ },
183
+ "scope": {
184
+ "enum": [
185
+ "project",
186
+ "toolchain"
187
+ ],
188
+ "type": "string"
189
+ }
190
+ },
191
+ "required": [
192
+ "path",
193
+ "kind",
194
+ "scope",
195
+ "hash"
196
+ ],
197
+ "type": "object"
198
+ },
199
+ {
200
+ "additionalProperties": false,
201
+ "properties": {
202
+ "kind": {
203
+ "const": "symlink",
204
+ "type": "string"
205
+ },
206
+ "path": {
207
+ "$ref": "#/$defs/__schema1"
208
+ },
209
+ "scope": {
210
+ "enum": [
211
+ "project",
212
+ "toolchain"
213
+ ],
214
+ "type": "string"
215
+ },
216
+ "target": {
217
+ "$ref": "#/$defs/__schema1"
218
+ }
219
+ },
220
+ "required": [
221
+ "path",
222
+ "kind",
223
+ "scope",
224
+ "target"
225
+ ],
226
+ "type": "object"
227
+ },
228
+ {
229
+ "additionalProperties": false,
230
+ "properties": {
231
+ "hash": {
232
+ "pattern": "^[a-f0-9]{64}$",
233
+ "type": "string"
234
+ },
235
+ "kind": {
236
+ "const": "toolchain-file",
237
+ "type": "string"
238
+ },
239
+ "path": {
240
+ "$ref": "#/$defs/__schema1"
241
+ }
242
+ },
243
+ "required": [
244
+ "path",
245
+ "kind",
246
+ "hash"
247
+ ],
248
+ "type": "object"
249
+ }
250
+ ]
251
+ },
252
+ "type": "array"
253
+ },
254
+ "semanticResolver": {
255
+ "$ref": "#/$defs/__schema0"
256
+ },
257
+ "sourceFiles": {
258
+ "items": {
259
+ "additionalProperties": false,
260
+ "properties": {
261
+ "compilerUnit": {
262
+ "minLength": 1,
263
+ "type": "string"
264
+ },
265
+ "hash": {
266
+ "pattern": "^[a-f0-9]{64}$",
267
+ "type": "string"
268
+ },
269
+ "lines": {
270
+ "maximum": 9007199254740991,
271
+ "minimum": 0,
272
+ "type": "integer"
273
+ },
274
+ "path": {
275
+ "$ref": "#/$defs/__schema1"
276
+ }
277
+ },
278
+ "required": [
279
+ "path",
280
+ "hash",
281
+ "compilerUnit",
282
+ "lines"
283
+ ],
284
+ "type": "object"
285
+ },
286
+ "type": "array"
287
+ },
288
+ "syntaxParser": {
289
+ "$ref": "#/$defs/__schema0"
290
+ }
291
+ },
292
+ "required": [
293
+ "schemaVersion",
294
+ "analyzerVersion",
295
+ "producer",
296
+ "semanticResolver",
297
+ "syntaxParser",
298
+ "analyzers",
299
+ "configHash",
300
+ "sourceFiles",
301
+ "semanticInputs",
302
+ "artifacts",
303
+ "integrityHash"
304
+ ],
305
+ "title": "ai-code-map manifest record",
306
+ "type": "object"
307
+ }