Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .modonome/snapshot/badge.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"color":"blue","label":"snapshot","message":"1026 files, 135721 tok","schemaVersion":1}
{"color":"blue","label":"snapshot","message":"1028 files, 135721 tok","schemaVersion":1}
2 changes: 1 addition & 1 deletion .modonome/snapshot/map.json

Large diffs are not rendered by default.

126 changes: 63 additions & 63 deletions .modonome/snapshot/map.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

Modonome snapshot. Read this before reading the repo. Tier 0 (signature.json) is the fingerprint: if merkle_root matches your last read, nothing changed. Tier 1 (map.json / map.md) lists modules, public API signatures, import edges, and attention ranking. Cite anchors (F: for files, S: for symbols); each resolves to a path and line so you can act without re-reading the whole repo.

Merkle root: sha256:2d551f3b4c5441c133dcc41f3a913c7c05ecca7ede10efde376b39d4b9302393
Files: 1026 Bytes: 3797840 Map tokens: 135721/120000
Merkle root: sha256:62a6e870efbe7c63703b73f821d612775640a9ee75f8943294157dd250b4acef
Files: 1028 Bytes: 3801669 Map tokens: 135721/120000

## Modules

Expand Down Expand Up @@ -1584,17 +1584,17 @@ Files: 1026 Bytes: 3797840 Map tokens: 135721/120000
- S:3c2bad87be function snapshotDir `function snapshotDir(root) { return join(root, ".modonome", "snapshot"); }` L40
- S:5353762af1 function loadCommittedSignature `function loadCommittedSignature(root)` L42
- S:d5719588cb function llmsText `function llmsText(signature)` L48
- S:88bd705d3f function badgeJson `function badgeJson(signature, map)` L62
- S:bc3262b829 function writeArtifact `function writeArtifact(root, built)` L71
- S:3466f40801 function buildOptions `function buildOptions(root, argv, now)` L81
- S:6584162247 function nowIso `function nowIso() { return new Date().toISOString(); }` L95
- S:383c03d511 function incrementalInputs `function incrementalInputs(root, argv)` L100 : Resolve incremental build inputs. --full forces a from-scratch rebuild. Otherwise load the cache and ask git what changed; a missing cache or unusable git yields a full rebuild that produces identical
- S:df5cb6eb12 function recomputeMerkle `function recomputeMerkle(root)` L108 : Recompute file hashes and the Merkle root directly from disk. Used by --verify.
- S:8d131c2429 function isSafeGitRevision `function isSafeGitRevision(value)` L119 : A --since ref is free-form git revision syntax (branch, tag, HEAD~N, a SHA), so it cannot be restricted to a fixed pattern the way a cache-internal SHA can. The one property that must hold is that it
- S:2a5511d42c function gitDelta `function gitDelta(root, ref)` L123
- S:2ce7a5bbe7 function positional `function positional(argv)` L144
- S:ecd0da924a function maybeRegisterParser `async function maybeRegisterParser(root, argv)` L156 : Register the tree-sitter parser when requested via --parser or config, with a graceful fallback to the heuristic default when tree-sitter is not installed.
- S:68308360b1 function main `async function main(argv)` L164
- S:88bd705d3f function badgeJson `function badgeJson(signature, map)` L64
- S:bc3262b829 function writeArtifact `function writeArtifact(root, built)` L73
- S:3466f40801 function buildOptions `function buildOptions(root, argv, now)` L83
- S:6584162247 function nowIso `function nowIso() { return new Date().toISOString(); }` L97
- S:383c03d511 function incrementalInputs `function incrementalInputs(root, argv)` L102 : Resolve incremental build inputs. --full forces a from-scratch rebuild. Otherwise load the cache and ask git what changed; a missing cache or unusable git yields a full rebuild that produces identical
- S:df5cb6eb12 function recomputeMerkle `function recomputeMerkle(root)` L110 : Recompute file hashes and the Merkle root directly from disk. Used by --verify.
- S:8d131c2429 function isSafeGitRevision `function isSafeGitRevision(value)` L121 : A --since ref is free-form git revision syntax (branch, tag, HEAD~N, a SHA), so it cannot be restricted to a fixed pattern the way a cache-internal SHA can. The one property that must hold is that it
- S:2a5511d42c function gitDelta `function gitDelta(root, ref)` L125
- S:2ce7a5bbe7 function positional `function positional(argv)` L146
- S:ecd0da924a function maybeRegisterParser `async function maybeRegisterParser(root, argv)` L158 : Register the tree-sitter parser when requested via --parser or config, with a graceful fallback to the heuristic default when tree-sitter is not installed.
- S:68308360b1 function main `async function main(argv)` L166
### scripts/lib/message-catalog/gate/test-prompt-behavior.mjs [F:a104667369]
- S:f6264503e8 const MESSAGES `export const MESSAGES =` L1
### fixtures/negative-controls/app-syntax-error.js [F:a1411f1423]
Expand Down Expand Up @@ -2717,54 +2717,54 @@ Files: 1026 Bytes: 3797840 Map tokens: 135721/120000

## Attention (centrality + pagerank)

1. scripts/lib/messages.mjs centrality=63 pagerank=0.039239
2. scripts/lib/message-catalog/index.mjs centrality=58 pagerank=0.011822
3. design-system/src/lib/cx.ts centrality=32 pagerank=0.026768
4. design-system/src/components/Icon/Icon.tsx centrality=23 pagerank=0.017353
5. design-system/src/index.ts centrality=48 pagerank=0.000704
6. scripts/lib/yaml-lite.mjs centrality=21 pagerank=0.017035
7. scripts/lib/jsonschema.mjs centrality=15 pagerank=0.019842
8. scripts/agent/run-cycle.mjs centrality=25 pagerank=0.00516
9. scripts/validate-config.mjs centrality=16 pagerank=0.005003
10. apps/control-panel/src/state/types.ts centrality=13 pagerank=0.006806
11. design-system/src/components/HelpHint/HelpHint.tsx centrality=12 pagerank=0.005905
12. design-system/src/components/StatusPill/StatusPill.tsx centrality=12 pagerank=0.00421
13. scripts/lib/learnings.mjs centrality=11 pagerank=0.004629
14. scripts/agent/resolve-role.mjs centrality=11 pagerank=0.003592
15. scripts/lib/canonical-json.mjs centrality=10 pagerank=0.003571
16. scripts/lib/snapshot-core.mjs centrality=13 pagerank=0.001177
17. design-system/src/components/Button/Button.tsx centrality=9 pagerank=0.003395
18. scripts/lib/detect-attribution.mjs centrality=7 pagerank=0.003865
19. scripts/validate-work-item.mjs centrality=9 pagerank=0.002618
20. scripts/lib/config-validate.mjs centrality=7 pagerank=0.003553
21. design-system/src/components/IconButton/IconButton.tsx centrality=6 pagerank=0.003939
22. scripts/validate-knowledge-packet.mjs centrality=8 pagerank=0.00248
23. apps/control-panel/src/App.tsx centrality=10 pagerank=0.001003
24. scripts/agent/render-prompt.mjs centrality=7 pagerank=0.002764
25. design-system/src/components/WorkItemCard/WorkItemCard.tsx centrality=8 pagerank=0.002056
26. apps/control-panel/server/modonomeWriter.mjs centrality=8 pagerank=0.001791
27. design-system/src/tokens/tokens.ts centrality=6 pagerank=0.00246
28. scripts/lib/lang-adapters/index.mjs centrality=8 pagerank=0.001178
29. scripts/agent/providers.mjs centrality=3 pagerank=0.004272
30. scripts/lib/graph.mjs centrality=5 pagerank=0.002893
31. scripts/lib/branch-name.mjs centrality=4 pagerank=0.003372
32. design-system/src/components/Tooltip/Tooltip.tsx centrality=3 pagerank=0.003822
33. scripts/snapshot.mjs centrality=8 pagerank=0.000704
34. design-system/src/components/WorkItemDrawer/WorkItemDrawer.tsx centrality=7 pagerank=0.001313
35. apps/control-panel/src/lib/confirm.tsx centrality=6 pagerank=0.001783
36. scripts/lib/secret-patterns.mjs centrality=4 pagerank=0.002987
37. apps/control-panel/src/lib/messages.ts centrality=6 pagerank=0.001688
38. design-system/src/components/Card/Card.tsx centrality=5 pagerank=0.002056
39. design-system/src/lib/format.ts centrality=5 pagerank=0.002055
40. scripts/agent/openai-client.mjs centrality=5 pagerank=0.002027
41. design-system/src/components/LeaseTable/LeaseTable.tsx centrality=6 pagerank=0.001313
42. scripts/lib/commit-identity.mjs centrality=3 pagerank=0.003144
43. scripts/agent/review-diff.mjs centrality=5 pagerank=0.001579
44. scripts/lib/work-item-validate.mjs centrality=4 pagerank=0.002121
45. apps/control-panel/src/screens/SettingsScreen.tsx centrality=6 pagerank=0.000798
46. apps/control-panel/src/state/adapter.ts centrality=6 pagerank=0.000798
47. examples/demo-app/src/index.js centrality=6 pagerank=0.000704
48. scripts/build-policy-attestation.mjs centrality=6 pagerank=0.000704
49. design-system/src/components/ActivationLadder/ActivationLadder.tsx centrality=5 pagerank=0.001313
50. design-system/src/components/CostPanel/CostPanel.tsx centrality=5 pagerank=0.001313
1. scripts/lib/messages.mjs centrality=63 pagerank=0.039184
2. scripts/lib/message-catalog/index.mjs centrality=58 pagerank=0.011805
3. design-system/src/lib/cx.ts centrality=32 pagerank=0.02673
4. design-system/src/components/Icon/Icon.tsx centrality=23 pagerank=0.017328
5. design-system/src/index.ts centrality=48 pagerank=0.000703
6. scripts/lib/yaml-lite.mjs centrality=21 pagerank=0.017011
7. scripts/lib/jsonschema.mjs centrality=15 pagerank=0.019814
8. scripts/agent/run-cycle.mjs centrality=25 pagerank=0.005153
9. scripts/validate-config.mjs centrality=16 pagerank=0.004996
10. apps/control-panel/src/state/types.ts centrality=13 pagerank=0.006797
11. design-system/src/components/HelpHint/HelpHint.tsx centrality=12 pagerank=0.005897
12. design-system/src/components/StatusPill/StatusPill.tsx centrality=12 pagerank=0.004204
13. scripts/lib/learnings.mjs centrality=11 pagerank=0.004622
14. scripts/agent/resolve-role.mjs centrality=11 pagerank=0.003587
15. scripts/lib/canonical-json.mjs centrality=10 pagerank=0.003566
16. scripts/lib/snapshot-core.mjs centrality=13 pagerank=0.001176
17. design-system/src/components/Button/Button.tsx centrality=9 pagerank=0.00339
18. scripts/lib/detect-attribution.mjs centrality=7 pagerank=0.00386
19. scripts/validate-work-item.mjs centrality=9 pagerank=0.002614
20. scripts/lib/config-validate.mjs centrality=7 pagerank=0.003548
21. design-system/src/components/IconButton/IconButton.tsx centrality=6 pagerank=0.003934
22. scripts/validate-knowledge-packet.mjs centrality=8 pagerank=0.002477
23. apps/control-panel/src/App.tsx centrality=10 pagerank=0.001001
24. scripts/agent/render-prompt.mjs centrality=7 pagerank=0.00276
25. design-system/src/components/WorkItemCard/WorkItemCard.tsx centrality=8 pagerank=0.002053
26. apps/control-panel/server/modonomeWriter.mjs centrality=8 pagerank=0.001788
27. design-system/src/tokens/tokens.ts centrality=6 pagerank=0.002457
28. scripts/lib/lang-adapters/index.mjs centrality=8 pagerank=0.001176
29. scripts/agent/providers.mjs centrality=3 pagerank=0.004266
30. scripts/lib/graph.mjs centrality=5 pagerank=0.002889
31. scripts/lib/branch-name.mjs centrality=4 pagerank=0.003367
32. design-system/src/components/Tooltip/Tooltip.tsx centrality=3 pagerank=0.003817
33. scripts/snapshot.mjs centrality=8 pagerank=0.000703
34. design-system/src/components/WorkItemDrawer/WorkItemDrawer.tsx centrality=7 pagerank=0.001311
35. apps/control-panel/src/lib/confirm.tsx centrality=6 pagerank=0.00178
36. scripts/lib/secret-patterns.mjs centrality=4 pagerank=0.002983
37. apps/control-panel/src/lib/messages.ts centrality=6 pagerank=0.001686
38. design-system/src/components/Card/Card.tsx centrality=5 pagerank=0.002053
39. design-system/src/lib/format.ts centrality=5 pagerank=0.002052
40. scripts/agent/openai-client.mjs centrality=5 pagerank=0.002024
41. design-system/src/components/LeaseTable/LeaseTable.tsx centrality=6 pagerank=0.001311
42. scripts/lib/commit-identity.mjs centrality=3 pagerank=0.00314
43. scripts/agent/review-diff.mjs centrality=5 pagerank=0.001576
44. scripts/lib/work-item-validate.mjs centrality=4 pagerank=0.002118
45. apps/control-panel/src/screens/SettingsScreen.tsx centrality=6 pagerank=0.000797
46. apps/control-panel/src/state/adapter.ts centrality=6 pagerank=0.000797
47. examples/demo-app/src/index.js centrality=6 pagerank=0.000703
48. scripts/build-policy-attestation.mjs centrality=6 pagerank=0.000703
49. design-system/src/components/ActivationLadder/ActivationLadder.tsx centrality=5 pagerank=0.001311
50. design-system/src/components/CostPanel/CostPanel.tsx centrality=5 pagerank=0.001311

2 changes: 1 addition & 1 deletion .modonome/snapshot/signature.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"commands":{"build":"","lint":"","test":"npm test"},"entrypoints":["bin/modonome.mjs"],"generated_at":"2026-07-08T15:07:00.713Z","generated_for":"modonome","governance":{"armed":false,"autonomy_enabled":false,"dry_run":true},"instructions":["AGENTS.md","CLAUDE.md","CODEX.md","CONTRIBUTING.md","README.md"],"language_mix":{"(none)":11,"css":50,"diff":18,"html":9,"js":19,"json":138,"jsonl":8,"md":144,"mjs":351,"patch":40,"png":5,"py":4,"sh":1,"svg":2,"tf":4,"toml":2,"ts":61,"tsx":98,"txt":18,"webmanifest":1,"webp":1,"woff2":9,"xml":1,"yaml":9,"yml":22},"merkle_root":"sha256:2d551f3b4c5441c133dcc41f3a913c7c05ecca7ede10efde376b39d4b9302393","preamble":"Modonome snapshot. Read this before reading the repo. Tier 0 (signature.json) is the fingerprint: if merkle_root matches your last read, nothing changed. Tier 1 (map.json / map.md) lists modules, public API signatures, import edges, and attention ranking. Cite anchors (F: for files, S: for symbols); each resolves to a path and line so you can act without re-reading the whole repo.","protected_paths":[".github",".github/CODEOWNERS","package-lock.json"],"schema_version":1,"size":{"bytes":3797840,"files":1026},"snapshot_version":25,"stack":{"name":"Node or TypeScript","pm":"npm"},"tier_hashes":{"map":"sha256:c9ada30408651a6e175fc79155d67334939175aa032a0a6923e51214327edbef","map_md":"sha256:c77ccd1dd1ffb846ab7ac85c78b854fb7ab59ab99a0eba1ca4813ef998a02c0f"}}
{"commands":{"build":"","lint":"","test":"npm test"},"entrypoints":["bin/modonome.mjs"],"generated_at":"2026-07-08T16:55:44.941Z","generated_for":"modonome","governance":{"armed":false,"autonomy_enabled":false,"dry_run":true},"instructions":["AGENTS.md","CLAUDE.md","CODEX.md","CONTRIBUTING.md","README.md"],"language_mix":{"(none)":12,"cff":1,"css":50,"diff":18,"html":9,"js":19,"json":138,"jsonl":8,"md":144,"mjs":351,"patch":40,"png":5,"py":4,"sh":1,"svg":2,"tf":4,"toml":2,"ts":61,"tsx":98,"txt":18,"webmanifest":1,"webp":1,"woff2":9,"xml":1,"yaml":9,"yml":22},"merkle_root":"sha256:62a6e870efbe7c63703b73f821d612775640a9ee75f8943294157dd250b4acef","preamble":"Modonome snapshot. Read this before reading the repo. Tier 0 (signature.json) is the fingerprint: if merkle_root matches your last read, nothing changed. Tier 1 (map.json / map.md) lists modules, public API signatures, import edges, and attention ranking. Cite anchors (F: for files, S: for symbols); each resolves to a path and line so you can act without re-reading the whole repo.","protected_paths":[".github",".github/CODEOWNERS","package-lock.json"],"schema_version":1,"size":{"bytes":3801669,"files":1028},"snapshot_version":47,"stack":{"name":"Node or TypeScript","pm":"npm"},"tier_hashes":{"map":"sha256:b96657a3bac92cf922d26b72444bd89ed1b01392f401971e6d3a22dd559ad2df","map_md":"sha256:e89b6166557a4346be076a1e91ae6a98b124cab126aad0595c6e6217b6b44554"}}
18 changes: 18 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
cff-version: 1.2.0
message: "If you use Modonome or reference its gate-integrity mechanism, please cite it as below and link the canonical repository."
title: "Modonome"
abstract: "A governed autonomous engineering loop with a deterministic CI gate-integrity check that blocks the known structural ways coding agents weaken tests: removed assertions, injected skips, type escapes, and lowered coverage. Maker, checker, and merge authority are structurally separate."
type: software
authors:
- name: "nateshpp and the Modonome contributors"
website: "https://github.com/nateshpp"
license: MIT
repository-code: "https://github.com/enumind/modonome"
url: "https://modonome.com"
keywords:
- autonomous-agents
- ci
- gate-integrity
- agent-guardrails
- ai-safety
- code-review
3 changes: 2 additions & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
MIT License

Copyright (c) 2026 nateshpp
Copyright (c) 2026 nateshpp and the Modonome contributors
Modonome — https://modonome.com — https://github.com/enumind/modonome

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
28 changes: 28 additions & 0 deletions NOTICE
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
Modonome
Copyright (c) 2026 nateshpp and the Modonome contributors

Canonical sources
Website: https://modonome.com
Repository: https://github.com/enumind/modonome
npm: https://www.npmjs.com/package/modonome

License and attribution
This software is licensed under the MIT License (see LICENSE). The MIT
License requires that the above copyright notice and the permission notice
in LICENSE be included in all copies or substantial portions of the
Software. If you redistribute Modonome, in source or modified form, you
must retain the LICENSE file and this NOTICE file.

Trademarks
"Modonome" and the Modonome logo identify the original project published
at the canonical sources above. The MIT License grants rights to the code;
it does not grant any right to use the Modonome name or logo. Forks and
derivative works must not present themselves as the original Modonome
project or as endorsed by it, and should use a different name for any
publicly distributed derivative. Factual references ("based on Modonome",
"compatible with Modonome") are welcome and encouraged, with a link back
to the canonical repository.

Provenance
If you found this code elsewhere without this NOTICE, the authoritative,
maintained version lives at https://github.com/enumind/modonome.
27 changes: 24 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -201,6 +201,27 @@ self-application, work items, tests, AgentProof) with no network or secrets.
| Roadmap and milestones | [ROADMAP.md](ROADMAP.md) |
| Contributing, support, and what a merge commits us to | [CONTRIBUTING.md](CONTRIBUTING.md) · [SUPPORT.md](SUPPORT.md) |

## License

MIT. See [LICENSE](LICENSE).
## License, attribution, and trademarks

Modonome is © 2026 nateshpp and the Modonome contributors, released under the
[MIT License](LICENSE). The license is permissive on purpose: use it, fork it,
ship it, sell it. It carries two conditions worth stating plainly:

- **Attribution is required, not optional.** The MIT License requires the
copyright notice and permission notice to be included in all copies or
substantial portions of the software. If you redistribute Modonome or a
derivative, keep the [LICENSE](LICENSE) and [NOTICE](NOTICE) files intact.
- **The name is not part of the grant.** "Modonome" and the Modonome logo
identify the original project. The MIT License covers the code, not the
brand: forks must not present themselves as the original project or use the
name for a publicly distributed derivative. Factual references ("based on
Modonome") with a link back to
[github.com/enumind/modonome](https://github.com/enumind/modonome) are
welcome.

Citing Modonome in writing or research? Use the repository's
[CITATION.cff](CITATION.cff) (GitHub's "Cite this repository" button). The
canonical home of this project is
**[github.com/enumind/modonome](https://github.com/enumind/modonome)**; the
maintained releases are published to
[npm as `modonome`](https://www.npmjs.com/package/modonome).
4 changes: 3 additions & 1 deletion llms.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# modonome

> Machine-readable repository snapshot for LLM context, generated by Modonome.
> Machine-readable repository snapshot for LLM context, generated by Modonome
> (https://github.com/enumind/modonome, MIT licensed). Attribute and link the
> canonical source when referencing the generator.

## Modonome snapshot
- [Repo signature](.modonome/snapshot/signature.json): Tier 0 fingerprint. If merkle_root is unchanged, the repo is unchanged.
Expand Down
9 changes: 9 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,8 @@
"prepublishOnly": "node --test tests/*.test.mjs"
},
"files": [
"NOTICE",
"CITATION.cff",
"bin",
"prompts",
"templates",
Expand All @@ -55,10 +57,17 @@
"registry": "https://registry.npmjs.org"
},
"license": "MIT",
"author": {
"name": "nateshpp",
"url": "https://github.com/nateshpp"
},
"repository": {
"type": "git",
"url": "git+https://github.com/enumind/modonome.git"
},
"bugs": {
"url": "https://github.com/enumind/modonome/issues"
},
"homepage": "https://modonome.com",
"keywords": [
"autonomous",
Expand Down
Loading
Loading