@dotdotgod/hermes 0.0.0-stage → 0.6.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 (26) hide show
  1. package/LICENSE +94 -0
  2. package/README.md +126 -2
  3. package/__init__.py +48 -0
  4. package/mcp/bridge-entry.mjs +41 -0
  5. package/mcp/bridge.mjs +16217 -0
  6. package/mcp/cli.mjs +5842 -0
  7. package/mcp/server.mjs +23573 -0
  8. package/mcp/tools.json +749 -0
  9. package/package.json +37 -3
  10. package/plugin.yaml +18 -0
  11. package/policy.py +78 -0
  12. package/proxy.py +95 -0
  13. package/runtime.py +239 -0
  14. package/skills/document-clarify/SKILL.md +41 -0
  15. package/skills/impact-review/SKILL.md +31 -0
  16. package/skills/project-initializer/SKILL.md +37 -0
  17. package/skills/project-initializer/references/agent-docs.md +41 -0
  18. package/skills/project-initializer/scripts/init_project.sh +525 -0
  19. package/skills/project-initializer/templates/case-and-evidence.json +224 -0
  20. package/skills/project-initializer/templates/dotdotgod.config.json +239 -0
  21. package/skills/project-initializer/templates/policy.json +246 -0
  22. package/skills/project-initializer/templates/portfolio.json +260 -0
  23. package/skills/project-initializer/templates/publication.json +270 -0
  24. package/skills/project-initializer/templates/research.json +292 -0
  25. package/skills/project-initializer/templates/software.json +239 -0
  26. package/skills/project-load/SKILL.md +31 -0
package/mcp/tools.json ADDED
@@ -0,0 +1,749 @@
1
+ [
2
+ {
3
+ "name": "execute",
4
+ "description": "Run 1..100 labeled local commands with bounded concurrency. Group independent known commands; separate commands dependent on earlier results. Inspect every results entry status and indexed.id. Do not bypass permissions or safety gates.",
5
+ "inputSchema": {
6
+ "type": "object",
7
+ "properties": {
8
+ "commands": {
9
+ "type": "array",
10
+ "items": {
11
+ "type": "object",
12
+ "properties": {
13
+ "label": {
14
+ "type": "string"
15
+ },
16
+ "command": {
17
+ "type": "string"
18
+ },
19
+ "executable": {
20
+ "type": "string"
21
+ },
22
+ "args": {
23
+ "type": "array",
24
+ "items": {
25
+ "type": "string"
26
+ }
27
+ },
28
+ "shell": {
29
+ "type": "boolean"
30
+ },
31
+ "cwd": {
32
+ "type": "string"
33
+ },
34
+ "timeoutMs": {
35
+ "type": "integer",
36
+ "exclusiveMinimum": 0
37
+ },
38
+ "outputLimit": {
39
+ "type": "integer",
40
+ "exclusiveMinimum": 0
41
+ },
42
+ "directLimit": {
43
+ "type": "integer",
44
+ "exclusiveMinimum": 0
45
+ },
46
+ "outputMode": {
47
+ "type": "string",
48
+ "enum": [
49
+ "auto",
50
+ "direct",
51
+ "indexed",
52
+ "discard"
53
+ ]
54
+ },
55
+ "scope": {
56
+ "type": "string",
57
+ "enum": [
58
+ "transient",
59
+ "session",
60
+ "project"
61
+ ]
62
+ },
63
+ "ttlMs": {
64
+ "type": "integer",
65
+ "minimum": 0
66
+ },
67
+ "env": {
68
+ "type": "object",
69
+ "additionalProperties": {
70
+ "type": [
71
+ "string",
72
+ "null"
73
+ ]
74
+ }
75
+ },
76
+ "environmentMode": {
77
+ "type": "string",
78
+ "enum": [
79
+ "inherit-filtered-v1",
80
+ "allowlist-v1"
81
+ ]
82
+ },
83
+ "allowedEnv": {
84
+ "type": "array",
85
+ "items": {
86
+ "type": "string"
87
+ },
88
+ "maxItems": 100
89
+ }
90
+ },
91
+ "additionalProperties": false
92
+ },
93
+ "minItems": 1,
94
+ "maxItems": 100
95
+ },
96
+ "concurrency": {
97
+ "type": "integer",
98
+ "minimum": 1,
99
+ "maximum": 8
100
+ },
101
+ "cwd": {
102
+ "type": "string"
103
+ },
104
+ "timeoutMs": {
105
+ "type": "integer",
106
+ "exclusiveMinimum": 0
107
+ }
108
+ },
109
+ "required": [
110
+ "commands"
111
+ ],
112
+ "additionalProperties": false,
113
+ "$schema": "http://json-schema.org/draft-07/schema#"
114
+ },
115
+ "annotations": {
116
+ "destructiveHint": true,
117
+ "openWorldHint": true
118
+ },
119
+ "execution": {
120
+ "taskSupport": "forbidden"
121
+ }
122
+ },
123
+ {
124
+ "name": "execute_file",
125
+ "description": "Process a local file in an isolated child process; only bounded stdout/stderr is returned.",
126
+ "inputSchema": {
127
+ "type": "object",
128
+ "properties": {
129
+ "path": {
130
+ "type": "string"
131
+ },
132
+ "language": {
133
+ "type": "string",
134
+ "enum": [
135
+ "javascript",
136
+ "python",
137
+ "shell"
138
+ ],
139
+ "default": "javascript"
140
+ },
141
+ "code": {
142
+ "type": "string"
143
+ },
144
+ "label": {
145
+ "type": "string"
146
+ },
147
+ "command": {
148
+ "type": "string"
149
+ },
150
+ "executable": {
151
+ "type": "string"
152
+ },
153
+ "args": {
154
+ "type": "array",
155
+ "items": {
156
+ "type": "string"
157
+ }
158
+ },
159
+ "shell": {
160
+ "type": "boolean"
161
+ },
162
+ "cwd": {
163
+ "type": "string"
164
+ },
165
+ "timeoutMs": {
166
+ "type": "integer",
167
+ "exclusiveMinimum": 0
168
+ },
169
+ "outputLimit": {
170
+ "type": "integer",
171
+ "exclusiveMinimum": 0
172
+ },
173
+ "directLimit": {
174
+ "type": "integer",
175
+ "exclusiveMinimum": 0
176
+ },
177
+ "outputMode": {
178
+ "type": "string",
179
+ "enum": [
180
+ "auto",
181
+ "direct",
182
+ "indexed",
183
+ "discard"
184
+ ]
185
+ },
186
+ "scope": {
187
+ "type": "string",
188
+ "enum": [
189
+ "transient",
190
+ "session",
191
+ "project"
192
+ ]
193
+ },
194
+ "ttlMs": {
195
+ "type": "integer",
196
+ "minimum": 0
197
+ },
198
+ "env": {
199
+ "type": "object",
200
+ "additionalProperties": {
201
+ "type": [
202
+ "string",
203
+ "null"
204
+ ]
205
+ }
206
+ },
207
+ "environmentMode": {
208
+ "type": "string",
209
+ "enum": [
210
+ "inherit-filtered-v1",
211
+ "allowlist-v1"
212
+ ]
213
+ },
214
+ "allowedEnv": {
215
+ "type": "array",
216
+ "items": {
217
+ "type": "string"
218
+ },
219
+ "maxItems": 100
220
+ }
221
+ },
222
+ "required": [
223
+ "path",
224
+ "code"
225
+ ],
226
+ "additionalProperties": false,
227
+ "$schema": "http://json-schema.org/draft-07/schema#"
228
+ },
229
+ "annotations": {
230
+ "destructiveHint": true,
231
+ "openWorldHint": false
232
+ },
233
+ "execution": {
234
+ "taskSupport": "forbidden"
235
+ }
236
+ },
237
+ {
238
+ "name": "index",
239
+ "description": "Index a local text file or bounded directory into the project-local FTS5 store without returning raw bytes.",
240
+ "inputSchema": {
241
+ "type": "object",
242
+ "properties": {
243
+ "path": {
244
+ "type": "string"
245
+ },
246
+ "root": {
247
+ "type": "string"
248
+ },
249
+ "source": {
250
+ "type": "string"
251
+ },
252
+ "scope": {
253
+ "type": "string",
254
+ "enum": [
255
+ "transient",
256
+ "session",
257
+ "project"
258
+ ]
259
+ },
260
+ "ttlMs": {
261
+ "type": "integer",
262
+ "minimum": 0
263
+ },
264
+ "maxBytes": {
265
+ "type": "integer",
266
+ "exclusiveMinimum": 0
267
+ },
268
+ "includeExtensions": {
269
+ "type": "array",
270
+ "items": {
271
+ "type": "string"
272
+ },
273
+ "maxItems": 100
274
+ },
275
+ "excludePaths": {
276
+ "type": "array",
277
+ "items": {
278
+ "type": "string"
279
+ },
280
+ "maxItems": 500
281
+ },
282
+ "followFileSymlinks": {
283
+ "type": "boolean"
284
+ },
285
+ "maxDepth": {
286
+ "type": "integer",
287
+ "minimum": 0
288
+ },
289
+ "maxVisitedEntries": {
290
+ "type": "integer",
291
+ "minimum": 0
292
+ },
293
+ "maxFiles": {
294
+ "type": "integer",
295
+ "minimum": 0
296
+ },
297
+ "maxAggregateBytes": {
298
+ "type": "integer",
299
+ "minimum": 0
300
+ }
301
+ },
302
+ "required": [
303
+ "path"
304
+ ],
305
+ "additionalProperties": false,
306
+ "$schema": "http://json-schema.org/draft-07/schema#"
307
+ },
308
+ "annotations": {
309
+ "readOnlyHint": true
310
+ },
311
+ "execution": {
312
+ "taskSupport": "forbidden"
313
+ }
314
+ },
315
+ {
316
+ "name": "search",
317
+ "description": "Search indexed content for bounded excerpts. For failure diagnostics try fail OR error OR reason. Query * browses bounded excerpts with the same source/scope/session filters and limit; neither no matches nor partial excerpts prove diagnostics are absent.",
318
+ "inputSchema": {
319
+ "type": "object",
320
+ "properties": {
321
+ "query": {
322
+ "type": "string",
323
+ "minLength": 1
324
+ },
325
+ "scope": {
326
+ "type": "string",
327
+ "enum": [
328
+ "transient",
329
+ "session",
330
+ "project"
331
+ ]
332
+ },
333
+ "source": {
334
+ "type": "string"
335
+ },
336
+ "limit": {
337
+ "type": "integer",
338
+ "minimum": 1,
339
+ "maximum": 50
340
+ },
341
+ "sessionOnly": {
342
+ "type": "boolean"
343
+ }
344
+ },
345
+ "required": [
346
+ "query"
347
+ ],
348
+ "additionalProperties": false,
349
+ "$schema": "http://json-schema.org/draft-07/schema#"
350
+ },
351
+ "annotations": {
352
+ "readOnlyHint": true
353
+ },
354
+ "execution": {
355
+ "taskSupport": "forbidden"
356
+ }
357
+ },
358
+ {
359
+ "name": "fetch_and_index",
360
+ "description": "Fetch an HTTP(S) URL locally, index bounded text, and return metadata only.",
361
+ "inputSchema": {
362
+ "type": "object",
363
+ "properties": {
364
+ "url": {
365
+ "type": "string",
366
+ "format": "uri"
367
+ },
368
+ "source": {
369
+ "type": "string"
370
+ },
371
+ "scope": {
372
+ "type": "string",
373
+ "enum": [
374
+ "transient",
375
+ "session",
376
+ "project"
377
+ ]
378
+ },
379
+ "ttlMs": {
380
+ "type": "integer",
381
+ "minimum": 0
382
+ },
383
+ "timeoutMs": {
384
+ "type": "integer",
385
+ "exclusiveMinimum": 0
386
+ },
387
+ "maxBytes": {
388
+ "type": "integer",
389
+ "exclusiveMinimum": 0
390
+ },
391
+ "browser": {
392
+ "type": "boolean"
393
+ }
394
+ },
395
+ "required": [
396
+ "url"
397
+ ],
398
+ "additionalProperties": false,
399
+ "$schema": "http://json-schema.org/draft-07/schema#"
400
+ },
401
+ "annotations": {
402
+ "readOnlyHint": true,
403
+ "openWorldHint": true
404
+ },
405
+ "execution": {
406
+ "taskSupport": "forbidden"
407
+ }
408
+ },
409
+ {
410
+ "name": "session_resume",
411
+ "description": "Use an explicit opaque session ID for subsequent context operations; historical sessions are not listed.",
412
+ "inputSchema": {
413
+ "type": "object",
414
+ "properties": {
415
+ "sessionId": {
416
+ "type": "string",
417
+ "minLength": 1,
418
+ "maxLength": 128,
419
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$"
420
+ }
421
+ },
422
+ "required": [
423
+ "sessionId"
424
+ ],
425
+ "additionalProperties": false,
426
+ "$schema": "http://json-schema.org/draft-07/schema#"
427
+ },
428
+ "execution": {
429
+ "taskSupport": "forbidden"
430
+ }
431
+ },
432
+ {
433
+ "name": "ingestion_job_start",
434
+ "description": "Queue one durable bounded background index or strict-fetch ingestion job.",
435
+ "inputSchema": {
436
+ "type": "object",
437
+ "properties": {
438
+ "kind": {
439
+ "type": "string",
440
+ "enum": [
441
+ "index",
442
+ "fetch"
443
+ ]
444
+ },
445
+ "input": {
446
+ "type": "object",
447
+ "additionalProperties": {}
448
+ }
449
+ },
450
+ "required": [
451
+ "kind",
452
+ "input"
453
+ ],
454
+ "additionalProperties": false,
455
+ "$schema": "http://json-schema.org/draft-07/schema#"
456
+ },
457
+ "execution": {
458
+ "taskSupport": "forbidden"
459
+ }
460
+ },
461
+ {
462
+ "name": "ingestion_job_status",
463
+ "description": "Return bounded status for one background ingestion job.",
464
+ "inputSchema": {
465
+ "type": "object",
466
+ "properties": {
467
+ "id": {
468
+ "type": "string",
469
+ "format": "uuid"
470
+ }
471
+ },
472
+ "required": [
473
+ "id"
474
+ ],
475
+ "additionalProperties": false,
476
+ "$schema": "http://json-schema.org/draft-07/schema#"
477
+ },
478
+ "annotations": {
479
+ "readOnlyHint": true
480
+ },
481
+ "execution": {
482
+ "taskSupport": "forbidden"
483
+ }
484
+ },
485
+ {
486
+ "name": "ingestion_job_cancel",
487
+ "description": "Cancel one queued or running background ingestion job.",
488
+ "inputSchema": {
489
+ "type": "object",
490
+ "properties": {
491
+ "id": {
492
+ "type": "string",
493
+ "format": "uuid"
494
+ }
495
+ },
496
+ "required": [
497
+ "id"
498
+ ],
499
+ "additionalProperties": false,
500
+ "$schema": "http://json-schema.org/draft-07/schema#"
501
+ },
502
+ "annotations": {
503
+ "destructiveHint": true
504
+ },
505
+ "execution": {
506
+ "taskSupport": "forbidden"
507
+ }
508
+ },
509
+ {
510
+ "name": "context_heal",
511
+ "description": "Explicitly back up and migrate only a recognized recoverable context database.",
512
+ "inputSchema": {
513
+ "type": "object",
514
+ "properties": {
515
+ "confirm": {
516
+ "type": "boolean",
517
+ "const": true
518
+ }
519
+ },
520
+ "required": [
521
+ "confirm"
522
+ ],
523
+ "additionalProperties": false,
524
+ "$schema": "http://json-schema.org/draft-07/schema#"
525
+ },
526
+ "annotations": {
527
+ "destructiveHint": true
528
+ },
529
+ "execution": {
530
+ "taskSupport": "forbidden"
531
+ }
532
+ },
533
+ {
534
+ "name": "stats",
535
+ "description": "Report local context store counts and location.",
536
+ "inputSchema": {
537
+ "type": "object",
538
+ "properties": {},
539
+ "$schema": "http://json-schema.org/draft-07/schema#"
540
+ },
541
+ "annotations": {
542
+ "readOnlyHint": true
543
+ },
544
+ "execution": {
545
+ "taskSupport": "forbidden"
546
+ }
547
+ },
548
+ {
549
+ "name": "doctor",
550
+ "description": "Run local read-only Node.js, SQLite FTS5, storage, schema, and fetch-policy checks without network or repair actions.",
551
+ "inputSchema": {
552
+ "type": "object",
553
+ "properties": {},
554
+ "$schema": "http://json-schema.org/draft-07/schema#"
555
+ },
556
+ "annotations": {
557
+ "readOnlyHint": true
558
+ },
559
+ "execution": {
560
+ "taskSupport": "forbidden"
561
+ }
562
+ },
563
+ {
564
+ "name": "purge",
565
+ "description": "Permanently delete one explicit context scope, session, or source.",
566
+ "inputSchema": {
567
+ "type": "object",
568
+ "properties": {
569
+ "confirm": {
570
+ "type": "boolean",
571
+ "const": true
572
+ },
573
+ "scope": {
574
+ "type": "string",
575
+ "enum": [
576
+ "transient",
577
+ "session",
578
+ "project"
579
+ ]
580
+ },
581
+ "sessionId": {
582
+ "type": "string"
583
+ },
584
+ "sourceId": {
585
+ "type": "string"
586
+ }
587
+ },
588
+ "required": [
589
+ "confirm"
590
+ ],
591
+ "additionalProperties": false,
592
+ "$schema": "http://json-schema.org/draft-07/schema#"
593
+ },
594
+ "annotations": {
595
+ "destructiveHint": true
596
+ },
597
+ "execution": {
598
+ "taskSupport": "forbidden"
599
+ }
600
+ },
601
+ {
602
+ "name": "dotdotgod_project_load",
603
+ "description": "Load a bounded documentation map and optional semantic project query.",
604
+ "inputSchema": {
605
+ "type": "object",
606
+ "properties": {
607
+ "root": {
608
+ "type": "string"
609
+ },
610
+ "focus": {
611
+ "type": "string",
612
+ "maxLength": 500
613
+ },
614
+ "limit": {
615
+ "type": "integer",
616
+ "minimum": 1,
617
+ "maximum": 30
618
+ },
619
+ "maxDepth": {
620
+ "type": "integer",
621
+ "minimum": 1,
622
+ "maximum": 5
623
+ }
624
+ },
625
+ "additionalProperties": false,
626
+ "$schema": "http://json-schema.org/draft-07/schema#"
627
+ },
628
+ "annotations": {
629
+ "readOnlyHint": true
630
+ },
631
+ "execution": {
632
+ "taskSupport": "forbidden"
633
+ }
634
+ },
635
+ {
636
+ "name": "dotdotgod_embedding_status",
637
+ "description": "Inspect the optional persistent embedding runtime without installing or contacting a registry.",
638
+ "inputSchema": {
639
+ "type": "object",
640
+ "properties": {
641
+ "root": {
642
+ "type": "string"
643
+ }
644
+ },
645
+ "additionalProperties": false,
646
+ "$schema": "http://json-schema.org/draft-07/schema#"
647
+ },
648
+ "annotations": {
649
+ "readOnlyHint": true
650
+ },
651
+ "execution": {
652
+ "taskSupport": "forbidden"
653
+ }
654
+ },
655
+ {
656
+ "name": "dotdotgod_embedding_install",
657
+ "description": "After explicit user approval, install the fixed optional embedding runtime persistently. Uses network and dependency install scripts.",
658
+ "inputSchema": {
659
+ "type": "object",
660
+ "properties": {
661
+ "root": {
662
+ "type": "string"
663
+ },
664
+ "confirm": {
665
+ "type": "boolean",
666
+ "const": true
667
+ }
668
+ },
669
+ "required": [
670
+ "confirm"
671
+ ],
672
+ "additionalProperties": false,
673
+ "$schema": "http://json-schema.org/draft-07/schema#"
674
+ },
675
+ "annotations": {
676
+ "destructiveHint": true,
677
+ "openWorldHint": true
678
+ },
679
+ "execution": {
680
+ "taskSupport": "forbidden"
681
+ }
682
+ },
683
+ {
684
+ "name": "dotdotgod_project_impact",
685
+ "description": "Run bounded graph impact for up to 20 changed paths.",
686
+ "inputSchema": {
687
+ "type": "object",
688
+ "properties": {
689
+ "root": {
690
+ "type": "string"
691
+ },
692
+ "paths": {
693
+ "type": "array",
694
+ "items": {
695
+ "type": "string"
696
+ },
697
+ "minItems": 1,
698
+ "maxItems": 20
699
+ }
700
+ },
701
+ "required": [
702
+ "paths"
703
+ ],
704
+ "additionalProperties": false,
705
+ "$schema": "http://json-schema.org/draft-07/schema#"
706
+ },
707
+ "annotations": {
708
+ "readOnlyHint": true
709
+ },
710
+ "execution": {
711
+ "taskSupport": "forbidden"
712
+ }
713
+ },
714
+ {
715
+ "name": "dotdotgod_project_initialize",
716
+ "description": "Initialize project memory; dry-run is default and writes require explicit confirmation.",
717
+ "inputSchema": {
718
+ "type": "object",
719
+ "properties": {
720
+ "root": {
721
+ "type": "string"
722
+ },
723
+ "dryRun": {
724
+ "type": "boolean"
725
+ },
726
+ "confirmWrite": {
727
+ "type": "boolean"
728
+ },
729
+ "projectName": {
730
+ "type": "string"
731
+ },
732
+ "template": {
733
+ "type": "string"
734
+ },
735
+ "dotdotSetting": {
736
+ "type": "boolean"
737
+ }
738
+ },
739
+ "additionalProperties": false,
740
+ "$schema": "http://json-schema.org/draft-07/schema#"
741
+ },
742
+ "annotations": {
743
+ "destructiveHint": true
744
+ },
745
+ "execution": {
746
+ "taskSupport": "forbidden"
747
+ }
748
+ }
749
+ ]