edify-agents-cli 0.2.0__py3-none-any.whl

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 (102) hide show
  1. edify/__init__.py +19 -0
  2. edify/__main__.py +6 -0
  3. edify/_toml.py +286 -0
  4. edify/agents.py +261 -0
  5. edify/anim.py +499 -0
  6. edify/assets/commands/build.md +64 -0
  7. edify/assets/commands/plan.md +68 -0
  8. edify/assets/commands/spec.md +63 -0
  9. edify/assets/commands/tasks.md +65 -0
  10. edify/assets/commands/verify.md +67 -0
  11. edify/assets/formats/plan.example.md +455 -0
  12. edify/assets/formats/plan.format.md +128 -0
  13. edify/assets/formats/spec.example.md +483 -0
  14. edify/assets/formats/spec.format.md +116 -0
  15. edify/assets/formats/tasks.example.md +712 -0
  16. edify/assets/formats/tasks.format.md +199 -0
  17. edify/assets/harvest/harvest.md +91 -0
  18. edify/assets/harvest/sources.md +295 -0
  19. edify/assets/harvest/vocab.md +52 -0
  20. edify/assets/manifest.md +30 -0
  21. edify/assets/mcp/default-registry.md +66 -0
  22. edify/assets/skills/adversary.md +61 -0
  23. edify/assets/skills/debugger.md +64 -0
  24. edify/assets/skills/implementer-general.md +53 -0
  25. edify/assets/skills/implementer-go.md +63 -0
  26. edify/assets/skills/implementer-node.md +61 -0
  27. edify/assets/skills/implementer-postgres.md +63 -0
  28. edify/assets/skills/implementer-python.md +65 -0
  29. edify/assets/skills/implementer-react.md +65 -0
  30. edify/assets/skills/planner.md +58 -0
  31. edify/assets/skills/test-writer-node.md +64 -0
  32. edify/assets/skills/test-writer-python.md +60 -0
  33. edify/assets/skills/verifier.md +67 -0
  34. edify/assets/templates/CLAUDE.md +18 -0
  35. edify/assets.py +77 -0
  36. edify/cli.py +681 -0
  37. edify/commands/__init__.py +1 -0
  38. edify/commands/check_cmd.py +72 -0
  39. edify/commands/doctor_cmd.py +206 -0
  40. edify/commands/feedback_cmd.py +90 -0
  41. edify/commands/governance_cmd.py +65 -0
  42. edify/commands/graph_cmd.py +156 -0
  43. edify/commands/harvest_cmd.py +538 -0
  44. edify/commands/init_cmd.py +333 -0
  45. edify/commands/init_new_cmd.py +151 -0
  46. edify/commands/license_cmd.py +80 -0
  47. edify/commands/mcp_cmd.py +159 -0
  48. edify/commands/self_cmd.py +185 -0
  49. edify/commands/setup_cmd.py +79 -0
  50. edify/commands/skills_cmd.py +177 -0
  51. edify/commands/upgrade_cmd.py +178 -0
  52. edify/context.py +57 -0
  53. edify/conventions.py +275 -0
  54. edify/detect.py +313 -0
  55. edify/distribution.py +40 -0
  56. edify/errors.py +66 -0
  57. edify/feedback.py +207 -0
  58. edify/formats/__init__.py +11 -0
  59. edify/formats/check.py +573 -0
  60. edify/formats/document.py +238 -0
  61. edify/formats/finding.py +50 -0
  62. edify/formats/fix.py +114 -0
  63. edify/formats/mcp.py +126 -0
  64. edify/formats/plan.py +151 -0
  65. edify/formats/skill.py +139 -0
  66. edify/formats/spec.py +164 -0
  67. edify/formats/tasks.py +321 -0
  68. edify/governance.py +316 -0
  69. edify/graph/__init__.py +11 -0
  70. edify/graph/extract.py +351 -0
  71. edify/graph/ignore.py +107 -0
  72. edify/graph/langs/__init__.py +93 -0
  73. edify/graph/langs/ctags.py +145 -0
  74. edify/graph/langs/markdown.py +41 -0
  75. edify/graph/langs/patterns.py +361 -0
  76. edify/graph/langs/python_ast.py +154 -0
  77. edify/graph/langs/sqlish.py +86 -0
  78. edify/graph/model.py +102 -0
  79. edify/graph/queries.py +211 -0
  80. edify/graph/store.py +157 -0
  81. edify/harvest/__init__.py +28 -0
  82. edify/harvest/ledger.py +191 -0
  83. edify/harvest/screen.py +236 -0
  84. edify/harvest/sources.py +298 -0
  85. edify/host.py +345 -0
  86. edify/interview.py +354 -0
  87. edify/library.py +176 -0
  88. edify/licensing/__init__.py +30 -0
  89. edify/licensing/ed25519.py +154 -0
  90. edify/licensing/projects.py +223 -0
  91. edify/licensing/tier.py +172 -0
  92. edify/licensing/token.py +149 -0
  93. edify/paths.py +282 -0
  94. edify/selfinstall.py +244 -0
  95. edify/skills.py +108 -0
  96. edify/tsv.py +109 -0
  97. edify/ui.py +334 -0
  98. edify_agents_cli-0.2.0.dist-info/METADATA +408 -0
  99. edify_agents_cli-0.2.0.dist-info/RECORD +102 -0
  100. edify_agents_cli-0.2.0.dist-info/WHEEL +4 -0
  101. edify_agents_cli-0.2.0.dist-info/entry_points.txt +2 -0
  102. edify_agents_cli-0.2.0.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,408 @@
1
+ Metadata-Version: 2.5
2
+ Name: edify-agents-cli
3
+ Version: 0.2.0
4
+ Summary: A harness that makes an AI coding agent work reliably on large codebases: three documents and a map.
5
+ Project-URL: Homepage, https://github.com/EDIFY-agents/EDIFY
6
+ Project-URL: Documentation, https://github.com/EDIFY-agents/EDIFY#readme
7
+ Project-URL: Changelog, https://github.com/EDIFY-agents/EDIFY/blob/main/CHANGELOG.md
8
+ Project-URL: Issues, https://github.com/EDIFY-agents/EDIFY/issues
9
+ Author: EDIFY
10
+ License: MIT License
11
+
12
+ Copyright (c) 2026 Santiago
13
+
14
+ Permission is hereby granted, free of charge, to any person obtaining a copy
15
+ of this software and associated documentation files (the "Software"), to deal
16
+ in the Software without restriction, including without limitation the rights
17
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
18
+ copies of the Software, and to permit persons to whom the Software is
19
+ furnished to do so, subject to the following conditions:
20
+
21
+ The above copyright notice and this permission notice shall be included in all
22
+ copies or substantial portions of the Software.
23
+
24
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
25
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
27
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
28
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
29
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
30
+ SOFTWARE.
31
+ License-File: LICENSE
32
+ Keywords: agent,ai,codebase,codegen,graph,harness,spec
33
+ Classifier: Development Status :: 4 - Beta
34
+ Classifier: Environment :: Console
35
+ Classifier: Intended Audience :: Developers
36
+ Classifier: Programming Language :: Python :: 3
37
+ Classifier: Programming Language :: Python :: 3.10
38
+ Classifier: Programming Language :: Python :: 3.11
39
+ Classifier: Programming Language :: Python :: 3.12
40
+ Classifier: Programming Language :: Python :: 3.13
41
+ Classifier: Topic :: Software Development :: Build Tools
42
+ Requires-Python: >=3.10
43
+ Provides-Extra: dev
44
+ Requires-Dist: pytest>=8.0; extra == 'dev'
45
+ Provides-Extra: treesitter
46
+ Requires-Dist: tree-sitter-language-pack>=0.7; extra == 'treesitter'
47
+ Requires-Dist: tree-sitter>=0.23; extra == 'treesitter'
48
+ Description-Content-Type: text/markdown
49
+
50
+ <div align="center">
51
+
52
+ <img src="assets/motion/stage.webp" width="100%" alt="The EDIFY wordmark, flat white type with two pools of blue ink travelling through it">
53
+
54
+ # EDIFY
55
+
56
+ **Three documents and a map. Think hard once, then build without thinking.**
57
+
58
+ [Install](#install) · [The five commands](#the-five-commands-you-type) · [Runtimes](#edify-init-new--a-folder-from-zero-for-whichever-agent-you-open) · [Docs](docs/) · [Website](https://edify-agents.github.io/EDIFY/)
59
+
60
+ </div>
61
+
62
+ EDIFY is a harness that sits around an AI coding agent and makes it work reliably on
63
+ large, real codebases — the kind with a million lines, fifteen years of history, four
64
+ languages, and nobody left who remembers why the payments module is like that.
65
+
66
+ It is not a model, not an agent framework, and not a wrapper around a chat interface.
67
+
68
+ ---
69
+
70
+ ## The problem it closes
71
+
72
+ A frontier model with a plain setup writes excellent code and still fails on serious
73
+ projects. Not from lack of intelligence — from four structural gaps that no model
74
+ generation closes:
75
+
76
+ - **It cannot see a codebase it cannot fit in its context.** Every session starts blind
77
+ and re-derives the same map, expensively and slightly differently each time.
78
+ - **It fragments across sessions.** The same work done in parts, in different ways,
79
+ never as one whole.
80
+ - **It builds what was asked instead of what was meant.** An ambiguous brief produces a
81
+ confident, well-built, wrong thing.
82
+ - **It writes against the library it remembers instead of the one installed.**
83
+
84
+ EDIFY closes exactly those four and gets out of the way of everything else.
85
+
86
+ ## Install
87
+
88
+ macOS, Linux, and Windows, from the same artifact. Python 3.10 or newer is the whole
89
+ requirement — there are no dependencies, no compiler, and no runtime to install on a
90
+ build server.
91
+
92
+ ```bash
93
+ pipx install edify-agents-cli # or: uv tool install edify-agents-cli
94
+ brew install edify-dev/tap/edify # macOS, if you prefer brew
95
+
96
+ cd your-repository
97
+ edify init
98
+
99
+ edify init new ./service # or: a folder from zero, for every agent
100
+ ```
101
+
102
+ Per-platform detail, PATH fixes, and where EDIFY keeps its own files are in
103
+ [INSTALL.md](INSTALL.md).
104
+
105
+ <p align="center">
106
+ <img src="assets/motion/init.webp" width="720" alt="edify init, in flat grey type, filling with blue ink">
107
+ </p>
108
+
109
+ `init` does seven things and then stops: detect the stack, extract the graph, scrape
110
+ the conventions from your config files, install the skill entries your stack matches,
111
+ seed the server registry, write a fifteen-line `CLAUDE.md`, and record every file it
112
+ put there. No interview, no constitution, no governance level to choose.
113
+
114
+ <img src="assets/init.svg" width="100%" alt="edify init at a terminal: the wordmark with blue ink in it, then one line per step, ending on Next: /spec">
115
+
116
+ It asks exactly one question — which library entries to install, because those become
117
+ trusted instruction in every matching session and you should see the list first. With
118
+ no terminal it asks nothing and installs the matched set, so CI, a pipe, and a model
119
+ calling the binary all behave as they did before the question existed.
120
+
121
+ ```bash
122
+ edify init --yes # the whole matched set, no question
123
+ edify init --skills planner,verifier # exactly these
124
+ edify init --skills none # none; add them later with `edify skills add`
125
+ ```
126
+
127
+ Starting in a folder rather than joining a repository, use `setup` instead. `init` finds
128
+ its root by walking upward, so a new folder inside an existing checkout installs into the
129
+ parent; `setup` pins the root where you point it, creates the folder if it is missing,
130
+ and installs everything. `--fresh` clears EDIFY's own files first and leaves everything
131
+ else — including a skill or command you wrote by hand — exactly where it was.
132
+
133
+ ```bash
134
+ edify setup ./service --yes # a new folder, everything installed, root pinned
135
+ edify setup . --fresh --yes # reinstall the harness over this repository
136
+ ```
137
+
138
+ ### `edify init new` — a folder from zero, for whichever agent you open
139
+
140
+ `init` and `setup` write `CLAUDE.md` and `.claude/`. That install is invisible to the
141
+ five other tools your team has open. `edify init new` sets a folder up from nothing for
142
+ every agent runtime EDIFY knows: the root is pinned where you point it, EDIFY's own
143
+ files are cleared first, every library entry is installed, and the same block is written
144
+ into every instruction file each runtime actually reads.
145
+
146
+ | runtime | reads | commands land in |
147
+ |---|---|---|
148
+ | Claude Code | `CLAUDE.md` | `.claude/commands/`, `.claude/skills/`, `.claude/agents/` |
149
+ | OpenAI Codex | `AGENTS.md` | `.codex/prompts/` |
150
+ | Cursor | `AGENTS.md`, `.cursor/rules/edify.mdc` | `.cursor/commands/` |
151
+ | Gemini CLI | `GEMINI.md` | `.gemini/commands/` (TOML) |
152
+ | GitHub Copilot | `.github/copilot-instructions.md` | `.github/prompts/` |
153
+ | Windsurf | `.windsurf/rules/edify.md` | `.windsurf/workflows/` |
154
+ | anything else | `AGENTS.md` | — |
155
+
156
+ <table>
157
+ <tr>
158
+ <td><img src="assets/motion/rt-claude.webp" alt=".claude in ink"></td>
159
+ <td><img src="assets/motion/rt-codex.webp" alt=".codex in ink"></td>
160
+ <td><img src="assets/motion/rt-cursor.webp" alt=".cursor in ink"></td>
161
+ </tr>
162
+ <tr>
163
+ <td><img src="assets/motion/rt-gemini.webp" alt=".gemini in latex"></td>
164
+ <td><img src="assets/motion/rt-github.webp" alt=".github in blue latex"></td>
165
+ <td><img src="assets/motion/rt-windsurf.webp" alt=".windsurf in ink"></td>
166
+ </tr>
167
+ </table>
168
+
169
+ And it asks first. Detection reads your `pyproject.toml`; it cannot read that this is a
170
+ rewrite of something already in production or that nothing may touch migrations without
171
+ a plan. Eight short questions, before anything is written, because two of them decide
172
+ what gets installed — which runtimes, and what detection missed. The answers go to
173
+ `.edify/profile.md`, which every instruction file points at, and which is yours to edit.
174
+ Press enter to skip any of them.
175
+
176
+ ```bash
177
+ edify init new ./service # ask, then install for every runtime
178
+ edify init new . --agents claude,cursor # only these two
179
+ edify init new . --yes # ask nothing, install everything
180
+ edify init new . --no-interview --keep # reinstall, keep the profile as it is
181
+ ```
182
+
183
+ With no terminal — CI, a pipe, a model calling the binary — nothing is asked, no profile
184
+ is written, and the full install happens anyway. A question is never load-bearing.
185
+
186
+ A later `edify init` keeps every runtime already set up in the folder current, rather
187
+ than updating `CLAUDE.md` and leaving the other five stale.
188
+
189
+ It runs offline. Nothing here opens a socket except `edify upgrade`, which also has a
190
+ plain-archive path for air-gapped networks.
191
+
192
+ ## The five commands you type
193
+
194
+ | command | what it does | model | ends at |
195
+ |---|---|---|---|
196
+ | `/spec` | a brief becomes a specification | strongest | a human |
197
+ | `/plan` | spec → technology decisions and milestones | strongest | a human |
198
+ | `/tasks` | spec + plan + graph → a phased task list | strongest | a human |
199
+ | `/build` | task list → working software | cheapest that follows instructions | a diff and a green suite |
200
+ | `/verify` | the code → evidence | strong, and never a session that wrote code | a report anyone can read |
201
+
202
+ The first three are slow and expensive and end at a human. The fourth is fast and cheap
203
+ and ends at working software. `/verify` can be re-run by anyone at any time.
204
+
205
+ <table>
206
+ <tr>
207
+ <td width="50%"><img src="assets/motion/spec.webp" alt="spec, plan, tasks, read one after another"></td>
208
+ <td width="50%"><img src="assets/motion/build.webp" alt="A grid of failing red squares turning to passing blue, one by one"></td>
209
+ </tr>
210
+ <tr>
211
+ <td align="center"><sub><code>/spec</code> · <code>/plan</code> · <code>/tasks</code> — three reads, one after another</sub></td>
212
+ <td align="center"><sub><code>/build</code> — red to green</sub></td>
213
+ </tr>
214
+ </table>
215
+
216
+ They are installed to `.edify/commands/` with thin pointers under each runtime's own
217
+ command directory — `.claude/commands/`, `.codex/prompts/`, `.cursor/commands/`,
218
+ `.gemini/commands/`, `.github/prompts/`, `.windsurf/workflows/` — so `/spec` resolves in
219
+ whichever tool you are typing into while the methodology stays in one canonical place. The skill library is mirrored the same way — `.claude/skills/<name>/SKILL.md`
220
+ per entry, carrying the description the runtime matches on and pointing at
221
+ `.edify/skills/<name>.md` — so an installed entry is discoverable in the session you are
222
+ typing into and still exists in exactly one place. `edify skills sync` rewrites the
223
+ mirror if you add or remove an entry by hand.
224
+
225
+ ## The binary
226
+
227
+ <p align="center">
228
+ <img src="assets/infinity.svg" width="480" alt="An infinity traced dot by dot — the animation the EDIFY CLI paints while it works">
229
+ </p>
230
+
231
+ `edify` installs the harness, builds and queries the graph, resolves skills, and checks
232
+ formats. It is a pure function over files: every command reads files and writes files,
233
+ and none holds state or opens a socket while doing your work. (`edify upgrade` pulls a
234
+ skill library and has an archive path for an air-gapped machine; `edify self update`
235
+ replaces the binary and hands the fetching to uv, pipx, or pip, with `--offline` to
236
+ refuse. Those two, and nothing else.)
237
+
238
+ ```bash
239
+ edify graph build # full extraction
240
+ edify graph where isExpired # → src/auth/clock.ts:12 symbol isExpired
241
+ edify graph dependents createSession # everything that breaks if it changes
242
+ edify graph defines src/api/router.ts # what this file exports
243
+ edify graph overlap "a.ts b.ts" "c.ts"# can these two tasks run at once
244
+ edify graph references generate # who calls or imports this
245
+
246
+ edify init new ./service # a folder from zero, for every agent, asks first
247
+ edify check [--fix] [--exit-code] # report what is wrong with the documents
248
+ edify skills resolve implementer 4 # the one file a spawn loads
249
+ edify mcp for implementer 4 # what servers that spawn would load
250
+ edify governance list # every file edify installed, and where it came from
251
+ edify governance verify # is it still what was installed
252
+ edify doctor # does the install work here
253
+ edify feedback # four questions, written to a file on this machine
254
+
255
+ edify self where # which edify is this, and where did it come from
256
+ edify self update [--from PATH] # put an edited checkout behind the `edify` binary
257
+ edify license status # plan, entitlements, and limits
258
+ ```
259
+
260
+ Nothing blocks. `edify check` prints; a person or a CI job decides what that means. If
261
+ you need a hard block, that is `edify check --exit-code` or `/verify` in your own CI,
262
+ owned by you — and we say so rather than implying we ship one.
263
+
264
+ ## What lands in your repository
265
+
266
+ ```
267
+ CLAUDE.md # ~15 lines: what this repo is, the commands, where the graph is
268
+ AGENTS.md # the same block, for every runtime that reads this file
269
+ GEMINI.md # …and one per runtime — `init new` writes them all
270
+ .edify/
271
+ graph/ # nodes.tsv, edges.tsv, meta — mechanical, regenerable
272
+ skills/ # the subset your stack matched, plus index.tsv
273
+ commands/ # the five command files
274
+ formats/ # the three format contracts and their worked examples
275
+ mcp.md # the server registry: pinned, scoped per role and phase
276
+ conventions.md # scraped from lint/format/tsconfig/CI — no model call
277
+ profile.md # what you answered when `init new` asked — yours to edit
278
+ governance.tsv # every file above: origin, provenance, licence, hash
279
+ specs/
280
+ <feature>/
281
+ spec.md # what is being built and why
282
+ plan.md # when the feature needs one
283
+ tasks.md # exactly what changes, where, in what order
284
+ verification.md # written by /verify
285
+ ```
286
+
287
+ `.edify/graph/` is regenerable and may be committed or ignored by taste. Everything else
288
+ is source.
289
+
290
+ ## Governance you can read
291
+
292
+ A control counts as governance if a person can look at it and tell whether the work
293
+ complied: advisory means advisory, and a record means a readable record. So every file
294
+ EDIFY installs is recorded in `.edify/governance.tsv` — what it is, where it came
295
+ from, under what licence, and its hash at the moment it landed.
296
+
297
+ ```bash
298
+ edify governance list # 26 files · 11 shipped · 7 library · 1 scraped · 1 seeded …
299
+ edify governance verify # modified .edify/skills/planner.md changed since it was installed
300
+ edify governance rebuild # re-baseline after a deliberate change
301
+ ```
302
+
303
+ `verify` separates a file EDIFY owns being changed — `upgrade` will overwrite it —
304
+ from a file your repository owns being maintained, which is what `.edify/mcp.md` and
305
+ `.edify/conventions.md` are for. It prints; `--exit-code` is how you turn it into a
306
+ gate you own. The graph is deliberately not in the ledger: it is regenerated output
307
+ and carries its own checksums.
308
+
309
+ ## The graph
310
+
311
+ A mechanically extracted map: every file, module, exported symbol, route and table, with
312
+ the edges between them, as sorted checksummed text. A rebuild over unchanged source is
313
+ byte-identical, so a graph diff is a structural diff of the codebase.
314
+
315
+ **It is never written by a model** — not at install, not as a fallback, not for a
316
+ language the extractor does not cover. Where a language is not covered the graph has no
317
+ nodes for it and `meta.languages_uncovered` says which. A missing symbol is a visible
318
+ gap; an invented one is a guess wearing the costume of a fact.
319
+
320
+ Python is parsed with a real syntax tree. Everything else is covered by a declarative
321
+ line scanner, and `meta.method_<language>` records which, so a scan is never mistaken for
322
+ a parse. For parse-grade precision across the rest, install Universal Ctags and run
323
+ `edify graph build --extractor ctags`. The TSV contract is the asset; the extractor is
324
+ replaceable by construction.
325
+
326
+ ## Verification comes first
327
+
328
+ Phase 2 of every build turns each assertion in the spec into an executable test that
329
+ **fails**, before any core logic exists. Everything after that is making red go green.
330
+
331
+ That is what makes a cheap builder safe: it is not judging whether its work is correct,
332
+ it is hitting a target that already exists, and progress is a number anyone can watch
333
+ instead of a claim anyone has to trust.
334
+
335
+ ## Editions
336
+
337
+ <p align="center">
338
+ <img src="assets/motion/free.webp" width="720" alt="$0, filling with blue ink">
339
+ </p>
340
+
341
+ **The public edition is the whole product.** `edify-agents-cli` is MIT-licensed, free,
342
+ and needs no account: every command, every query, every check, the whole methodology
343
+ tree, on a repository of any size, in as many repositories as you like. It has no caps
344
+ except one — the MCP registry scopes a single server into spawns.
345
+
346
+ **The team edition is by licence.** `edify-agents-teams` adds the team commands, and a
347
+ team or partner licence lifts the one-server rule. `partner` plans are free for
348
+ University of Toronto design teams and researchers.
349
+
350
+ There is no payment and no price anywhere. A licence is issued on request.
351
+
352
+ ```bash
353
+ edify license status # which edition this machine runs, and what a licence adds
354
+ edify license activate <token> # the token you were sent
355
+ ```
356
+
357
+ The licence is a signed token verified locally with no phone-home. The source is
358
+ readable and the check is local: a licence is a contract, not a technical protection
359
+ measure, and we would rather say that than break offline operation pretending otherwise.
360
+
361
+ ## Feedback, and the absence of telemetry
362
+
363
+ **There is no telemetry. Not anonymous, not aggregate, not opt-out.** Nothing in this
364
+ tool reports what you ran, what repository you ran it in, or that you installed it.
365
+ The buyer here is frequently the person who has to explain to somebody external what
366
+ touched the source tree, and a tool that phones home loses that conversation.
367
+
368
+ So feedback works the other way round:
369
+
370
+ ```bash
371
+ edify feedback # four questions → a file under your config directory
372
+ edify feedback list # what you have written; none of it has been sent
373
+ edify feedback off # the one-line invitation never appears again
374
+ ```
375
+
376
+ The file stays on your machine. `edify feedback` prints a `gh issue create` command
377
+ and a URL, and sending it is something you do, having read it. The invitation itself
378
+ is one dim line on stderr, shown at most once per released version, only on a real
379
+ terminal, and never inside CI or a pipe.
380
+
381
+ ## What EDIFY does not do
382
+
383
+ It does not wrap the agent runtime, host a model, or route between providers. It does not
384
+ run a server, a daemon, or a database. It does not enforce anything at runtime. It does
385
+ not attempt to make a weak model competent — it makes a competent model efficient, and
386
+ the difference is the whole product.
387
+
388
+ It is also not for a solo developer on a small project. A frontier model in auto mode is
389
+ already excellent there. The value starts where the codebase stops fitting in the context
390
+ window.
391
+
392
+ ## Development
393
+
394
+ ```bash
395
+ git clone https://github.com/EDIFY-agents/EDIFY && cd EDIFY
396
+ pip install -e ".[dev]"
397
+ pytest
398
+ ```
399
+
400
+ The design reasoning behind these choices — the principles every decision here satisfies
401
+ and the buildable blueprint — is kept in the private repository. The test suite checks that this repository satisfies what it asks of yours —
402
+ every skill file valid and under budget, every command file short, and the worked
403
+ examples parsing against the formats they calibrate.
404
+
405
+ ## Licence
406
+
407
+ See [LICENSE](LICENSE). Skill files carry their own provenance and licence in
408
+ frontmatter; entries marked `provenance: adapted` are governed by their upstream licence.
@@ -0,0 +1,102 @@
1
+ edify/__init__.py,sha256=JVbZmCZgO8ROFQLhlYb0HXRR8PH6RvOrQdgCpmcCQ-4,624
2
+ edify/__main__.py,sha256=4uQQEdOZSLkBjwtIu2bGnJeGMQP6gb1WIAPysLQOh6Y,105
3
+ edify/_toml.py,sha256=BRZ39s2k-q2ZPFd3gRPvWY-1YeofJPYGYL_UkN2HH8c,9429
4
+ edify/agents.py,sha256=erfh3sPymHKA9QTiD1Rn-NJt-DwzbK5SIv2xy20gWOA,10198
5
+ edify/anim.py,sha256=8fxiyo6GZ0mHhenwxusEEpoPZ3vAFfH4uJKR12vdo80,18683
6
+ edify/assets.py,sha256=Rkyv7fDZM2HGnBa99UrsU7S5ndyJj-G0BHSAfiEmjn4,2585
7
+ edify/cli.py,sha256=vylsU6oxf3zDLf-K6RS7XeVYd4icB4TM_4RnbSRssm8,27928
8
+ edify/context.py,sha256=GMgIVszncnAqt8MP4bwo2uwLimbL7QoXfSBdvjO6x3o,1670
9
+ edify/conventions.py,sha256=ABCqFedT00SOY5iyW8k_rlJ_hfczWTxNvF-UVz20KXQ,9438
10
+ edify/detect.py,sha256=GAobev0vHARxD6M58ZBcV9FrvaEZ9xTsENzbGzPGW2w,10040
11
+ edify/distribution.py,sha256=b389uabS1HC_YATZ-D_N1k6dlbSOu8zBtKeCJHOeCj0,1258
12
+ edify/errors.py,sha256=pQGwOfJb7YUxYvnUbwE-1H9q_ZMyd-8L0KTrg8Urg7s,1990
13
+ edify/feedback.py,sha256=OJfTHLOxbYpMDgp8zdMH5YZO2Sb_RO5nRJUg24bIgQw,6226
14
+ edify/governance.py,sha256=J95ksPHxJdbLKCmfK2DtT629a51PkM4Zasq8NhrOCR4,11818
15
+ edify/host.py,sha256=SAoJPoiWksjU2Wh3btccnU2A8IghV65GOF83PWsBacA,15395
16
+ edify/interview.py,sha256=IbUZQODOPBdIWuCpfsAspja4_DNq5Tg8RKLEQWqx0aM,12817
17
+ edify/library.py,sha256=pMy5jU8Y92fSCSqcljQhMmjXMybXY67fR6jCfDDjKCU,6594
18
+ edify/paths.py,sha256=4P2qC6RE9Kos5g5axPYZRp12Jow-uKL4ml8HclIoAyU,9420
19
+ edify/selfinstall.py,sha256=IKggC1D55tJMZt4rAB7YzlsJlmvUYM2P3NOV9xoQDu0,8960
20
+ edify/skills.py,sha256=QwdTU1RYP6wxSxYnMNRF4nUSOM_hsBDxIGbjS59c6vk,3766
21
+ edify/tsv.py,sha256=zxm02tgaIDfJvPkvTS4aFV7XHOcClxQ7O3O2HN3Mxmc,3433
22
+ edify/ui.py,sha256=hJGsepL-A9WekVx7x0XCyy309JzjxncGcIsbPXUwkZY,13271
23
+ edify/commands/__init__.py,sha256=cqlIrBeELzcK35Wk8RNIkMDTdmN4sY0O0BDHTXC7mjs,89
24
+ edify/commands/check_cmd.py,sha256=xxKFTffOz3Nh0LNlLuTcYshlusigG1bd3DvadbSMRCc,2503
25
+ edify/commands/doctor_cmd.py,sha256=OeSLCg5hLo4SCMrvAMcg_doWuhGpPQPNwgqT8zfUoAQ,7849
26
+ edify/commands/feedback_cmd.py,sha256=Ku3T68o2qOA-7lG9gzy0OidlI_tw9aCaOdJYUeugri8,3155
27
+ edify/commands/governance_cmd.py,sha256=5E-5gwwFypq3TPE3HgJ2t98Y-rY-1rahA3SDYT1Wk_M,2397
28
+ edify/commands/graph_cmd.py,sha256=QC3fQabha55rUC_vPe1vLESRoD3fVnVgt3g7PZDidcY,5087
29
+ edify/commands/harvest_cmd.py,sha256=rW7E-i2ecdpGu-L0IH4rpbpNz2DAqIrHAMRwRb7J4og,20928
30
+ edify/commands/init_cmd.py,sha256=baXsqo4GhsWCSLWw5YdJOJ4u_C4j9ne48bzJxhh6JeU,14239
31
+ edify/commands/init_new_cmd.py,sha256=_RO6m8rP3MGnEWDRrQwfVaEtKgeitLTm4kJF8m5H8Jk,7059
32
+ edify/commands/license_cmd.py,sha256=TX1M8Y2KKUY-P13oDCviOBtMXkWxS3_o418o0QM8TqU,3036
33
+ edify/commands/mcp_cmd.py,sha256=gQL4eNKbKfpiXT-8WjRZ7EeNuWItWKhRuGlsttNraTg,5835
34
+ edify/commands/self_cmd.py,sha256=Px0rXgnEDFKGqrPcA5e_j4Gq7Mglq44JfDHnFIn6ChA,6993
35
+ edify/commands/setup_cmd.py,sha256=CF0c24550K4sMFcFgvqMPl7kLnjF3pOshmd7T8kleuk,3479
36
+ edify/commands/skills_cmd.py,sha256=9HfNq7JLD1cnv5Xa2OxMo6ws9KdsbQyDoB5ZFGKVUGo,6569
37
+ edify/commands/upgrade_cmd.py,sha256=nBrjUHWFiHzY2dCz6oPXbSEyOwo3oeC1xs6MfaAyskA,7163
38
+ edify/formats/__init__.py,sha256=dUAbAK7Ih6k_WEddZryFJXVGOiBhdsJB5YpV4nsPUyY,470
39
+ edify/formats/check.py,sha256=ARIKKzlhJGIBjwOXeqqfuDt93eOgr-z9iV1tIikSlaQ,22552
40
+ edify/formats/document.py,sha256=_PGiQMvzThs6WOqT5Sq1TOiS1ICnsk4esZjRVtzyEf0,7482
41
+ edify/formats/finding.py,sha256=GhoZ3HK_xTKGc0hV_FQ5xSYKHlIjbwclbF_Dz1yLi2k,1544
42
+ edify/formats/fix.py,sha256=tj-eS_gwKYvIhfPCNe0QCDSgnMCgsC3DmW329yavyQw,3896
43
+ edify/formats/mcp.py,sha256=H2DQDYahbwyu5OWy7lXmp20Ch6YVzr8U6yIByIvXSbY,4697
44
+ edify/formats/plan.py,sha256=wxLOlhfAD7tP1KS34K3k6rpQmQBS8gNmNQAlw6PWKkI,5246
45
+ edify/formats/skill.py,sha256=XvXCSxv5WYKwpnxZq4SHu7vgBYd_i34MjsNdXMGJm1E,5218
46
+ edify/formats/spec.py,sha256=9RlDgH3tG4CZqEYvYXtxIwPYEhXBINeNQUTmdkH0qCw,5478
47
+ edify/formats/tasks.py,sha256=DKItwGg1XhcLP9NdvsN3_mMd8dXz6178c1k4eUX1bfU,10640
48
+ edify/graph/__init__.py,sha256=GXH2PuLcU54VVSmdn62-aBRvoSkJvfAG4fBVjrgYTgg,471
49
+ edify/graph/extract.py,sha256=bHgsW0nZGiBQQMSMydAYI_cua0X9yQ_YMJpSdZ3f26I,12683
50
+ edify/graph/ignore.py,sha256=-JWpkNVgVQJbK_QKO2r7Y6EWk1ePNlCzQN4fVYIAer0,4363
51
+ edify/graph/model.py,sha256=7Q2nXNnJawDs7bByQE_uPWMcFVauHuY-gpIwtZhLGsI,3346
52
+ edify/graph/queries.py,sha256=TkYYFPnaKNd0l8Ejyy57HyNg5x4tRUZ7_AtQmZGE620,7478
53
+ edify/graph/store.py,sha256=bPbCSDnRohQROYmxUbI07s3iLlrHA8uoaFowcub1jRc,5738
54
+ edify/graph/langs/__init__.py,sha256=R37s3bKuqBjC85KUDKCVIDTNDz4Ro6f_39NlZ_lQx14,2721
55
+ edify/graph/langs/ctags.py,sha256=IAUHXjjRsp27FCUvo2PM_O-AmywQqy3T9e4R-OR39j8,4753
56
+ edify/graph/langs/markdown.py,sha256=tMYnzMo6T10kN-LOm3ZqgSKJAT0JWlcQ4jSYths3LPY,1360
57
+ edify/graph/langs/patterns.py,sha256=aVE8M1nkZOIY-5BWhnKhXO_O9m66lA02JOCfRIFoQSA,13245
58
+ edify/graph/langs/python_ast.py,sha256=C7u9NDicDqGtuS03Ax5QdrCqwTxOE7oWQIPOJF1VHPE,6663
59
+ edify/graph/langs/sqlish.py,sha256=n4hOSWviIK1SEhMvPlJ-Htsv1k5tfNoYMR62OUG6sIg,3228
60
+ edify/harvest/__init__.py,sha256=6LW35Wd0ejDLQEbNJ7kL-x-GaQ2LWDWKGCSE2_QdnWI,1157
61
+ edify/harvest/ledger.py,sha256=mNeWFFfyJ-ZdjxrWiXtwIzGR_zVVM33-1IEgpsyDdm8,7311
62
+ edify/harvest/screen.py,sha256=CnC879cvyZWLHUko8CT045cVJUqRywzKoi-E1HsN4Vk,9699
63
+ edify/harvest/sources.py,sha256=zVO9fAtU7Bzuin9B8NBQvSy0og7ee53ySGg-ZzQ1YcE,11312
64
+ edify/licensing/__init__.py,sha256=Db5Bgk5RE1Oeq_0tWmUc69wSH322ep6YgDJQuXw7n7I,621
65
+ edify/licensing/ed25519.py,sha256=RUoc-7I_dIMw13O10ZLLa8qqbR2Jn1RElRK0fFtN13Q,4621
66
+ edify/licensing/projects.py,sha256=xrlnfd62r6URKb3Tm4feTkM0tXqyGR_v1UNq7OJEB6o,7584
67
+ edify/licensing/tier.py,sha256=TAPqh_NtnAoS-b_tGoyUjljSuuQRsl339l-zQr05exQ,5522
68
+ edify/licensing/token.py,sha256=7w9yE35cl2WJXkv6pM7Ojd_5TDtMDr-63otgKj5vzpQ,4907
69
+ edify/assets/commands/build.md,sha256=enstCIQkX-zSpKpq0MXNp6iqv3NB80tQMtrLXaHjbh4,2484
70
+ edify/assets/commands/plan.md,sha256=dES0G5eEZtilsAP_4PWYHt0C39LXVVRHIm2OLPeoq4I,2982
71
+ edify/assets/commands/spec.md,sha256=c-XHN11vLV9itXW_bBTuzfyHoALxwYllUcYWyFCFMXk,3006
72
+ edify/assets/commands/tasks.md,sha256=vJXQfvix6IV9kvO_1vU6iNokswRdns6_Z-eVz3Tj_-E,2996
73
+ edify/assets/commands/verify.md,sha256=55DX2JMT1pQQGRWH2bG7eVAcNOVrDIaEWaLcoO6Ji9w,3129
74
+ edify/assets/formats/plan.example.md,sha256=AfAkHjE0-7r9cSAyYK_4KUh08phQPyTbP2OguT9cIcc,24920
75
+ edify/assets/formats/plan.format.md,sha256=5bY9rM9M7C2wbO--zyKwLOIizST1UW5USkn3r4JG5Bw,5330
76
+ edify/assets/formats/spec.example.md,sha256=16Flm6SfVSx-QoJOq_Tme7lj7wgJzuvNUAdFX6fkw-Y,12609
77
+ edify/assets/formats/spec.format.md,sha256=0t4h7EOc0O7MQ9rEBMt4aljiWzMHUttmlrCGm1zNsSU,4752
78
+ edify/assets/formats/tasks.example.md,sha256=GotgiVWMvH3wUk1idGq5bXhIhGFem78_17akUUP_Meo,30672
79
+ edify/assets/formats/tasks.format.md,sha256=ajbNFcUbfJvpnHX_CzbTo-LPvUjPNsNnQ3VkNmCiGvU,8522
80
+ edify/assets/harvest/harvest.md,sha256=xa3y9j1d9W2SrKhPhopzQXD9XqqaN8c75v2MgFvuXoA,4650
81
+ edify/assets/harvest/sources.md,sha256=IS9TtNW3s5QSU0DG4Q_1dfw0Vljnu87vU8V1Ae1tpRM,22060
82
+ edify/assets/harvest/vocab.md,sha256=bS19PFvpxfdpPt7Nt5zE4zIUB-nyqAh4wU6uGTt8M3w,1926
83
+ edify/assets/manifest.md,sha256=LhL4c0OJLQbglZrx3elQ2dhejqeE5MtHkOP8ZaoKJqk,1167
84
+ edify/assets/mcp/default-registry.md,sha256=ds3AU8sIbB_Hff3n52pTjg5RrUGOFEz5vMdNMgn6w9c,3168
85
+ edify/assets/skills/adversary.md,sha256=aQlKwSDvdNt3_YRtPrhJ2R8FXOp4MdbgfsW03GIBpqc,2830
86
+ edify/assets/skills/debugger.md,sha256=9Curbdt--qPrkRjAPxZP1uq3a3hn40XIvYhGWjOk-Zw,2787
87
+ edify/assets/skills/implementer-general.md,sha256=kSZO_bPfy2khT28f5VtHPwxJ_aZSB49Df_fSr8DasFE,2220
88
+ edify/assets/skills/implementer-go.md,sha256=HPePmknK1w4qXUE9NcoCV1X441zjCscx5ff-l-UvNLY,2491
89
+ edify/assets/skills/implementer-node.md,sha256=TcT2LIaPL0pIsb7GgeAIMyixutbMkjFmgL80ZiAuRIo,2748
90
+ edify/assets/skills/implementer-postgres.md,sha256=MpuwJ4EeeByUrMutoGfdsF61Zhr6fAIh1rwuBHLbO3U,2819
91
+ edify/assets/skills/implementer-python.md,sha256=Hsl0ZbM-X8Ppv0mHN0hyjqJDAhsXtulN_Kq046Z2GwI,2766
92
+ edify/assets/skills/implementer-react.md,sha256=eRLL9ByT9j2yfhydIbpX0aUU84UYbGtGsFv72sz4ZQ8,2637
93
+ edify/assets/skills/planner.md,sha256=mnybEKqwsK75IaBmGOtu1Rj57htfaQOaWoxFFuKzAvM,2713
94
+ edify/assets/skills/test-writer-node.md,sha256=SSB8liUWx_ooDYun0q0XXuM5hUh9T_4D1w_lNtH2ARA,2890
95
+ edify/assets/skills/test-writer-python.md,sha256=dz2xB0ngLz_lZiNe_wpjBION4b1cAWq1xKrO_eE6Ttc,2610
96
+ edify/assets/skills/verifier.md,sha256=wPWHtp2F0CxNpUADf_AaKMk5CmeucTt-q7j-QMzDdo4,3213
97
+ edify/assets/templates/CLAUDE.md,sha256=ar-ibdb0GeS8dnFBFrKYUDCWQO9IIuJ1s6XQXpesQHM,749
98
+ edify_agents_cli-0.2.0.dist-info/METADATA,sha256=Yoykeb9JGLmG3Thjh3l36iVBHm7DAwrFslLsArRRotY,20285
99
+ edify_agents_cli-0.2.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
100
+ edify_agents_cli-0.2.0.dist-info/entry_points.txt,sha256=CihQ03FqL0I0h7x5H3l2-iZBx9oH_UfhPxhZHc4QtsA,41
101
+ edify_agents_cli-0.2.0.dist-info/licenses/LICENSE,sha256=0sKxkSwRWzjHElbhw3Tn2p8bOw5Oim6uDUkftrahROQ,1065
102
+ edify_agents_cli-0.2.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.32.4
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ edify = edify.cli:main
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Santiago
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.