Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
d390ba5
Check doc behavior instead of doc wording
Deicyde Oct 21, 2026
0c8deed
Delete tests that only pin skill and doc sentences
Deicyde Oct 21, 2026
16f7a5a
Trim wording and config pins from the kept example tests
Deicyde Oct 21, 2026
45f4cfb
Fix the product before pinning a skill sentence
Deicyde Oct 21, 2026
aead840
Correct init's row in AGENTS.md's exit table
Deicyde Oct 21, 2026
4e7833d
Take the dashboard out of the README's four publishing steps
Deicyde Oct 21, 2026
d5c3638
Merge main, with #90, into the doc-behavior tests
Deicyde Oct 21, 2026
0df905f
Read composed audit codes and the warning: prefix in the doc checks
Deicyde Oct 21, 2026
75612a5
Merge main, with #407 and #397, into the doc-behavior tests
Deicyde Oct 21, 2026
9c669f1
Correct the runtime schema id in the changelog, and skip version output
Deicyde Oct 21, 2026
a85cf5a
Keep the tests of the generated workflows' safety steps
Deicyde Oct 21, 2026
40a32c3
Apply the review's notes on the new checks and rules
Deicyde Oct 21, 2026
dab7e80
Merge main, with #399 and #438, into the doc-behavior tests
Deicyde Oct 22, 2026
f8028e4
Skip the generated workflow's name in the command check
Deicyde Oct 22, 2026
9b0d9fa
Merge main, with #378, #411, #437 and #440, into the doc-behavior tests
Deicyde Oct 22, 2026
6cce5e3
Merge main, with the 0.6.0 release, into the doc-behavior tests
Deicyde Oct 22, 2026
6946d7c
Trim the command reference's internals and planning notes
Deicyde Oct 22, 2026
df24f0b
Move skeleton probe internals into skeleton.py
Deicyde Oct 22, 2026
b20c797
Condense coverage, MathJax and validation internals
Deicyde Oct 22, 2026
956fd5e
Condense audit, search and library index internals
Deicyde Oct 22, 2026
cb6b22e
Point CONTRIBUTING at tests.yml for the CI job layout
Deicyde Oct 22, 2026
41ad184
Restore what the README cuts dropped or got wrong
Deicyde Oct 22, 2026
b82d382
Trim the Roadmap skill
Deicyde Oct 22, 2026
e9b4004
Trim the Formalize skill and its references
Deicyde Oct 22, 2026
72c76be
Trim the review skills
Deicyde Oct 22, 2026
e8f9c71
Shorten Setup's library catalog section
Deicyde Oct 22, 2026
220bac5
Leave the import policy to Formalize
Deicyde Oct 22, 2026
182660e
Restore what the skill cuts dropped or got wrong
Deicyde Oct 22, 2026
04400bd
Merge main, with #446 and #449, into the doc-behavior tests
Deicyde Oct 22, 2026
399140b
Give fixed-choice options a valid sample in the command check
Deicyde Oct 22, 2026
609d8e3
Merge #424, with main's #446 and #449, into the docs cuts
Deicyde Oct 22, 2026
4a37104
Merge main, with #450, into the doc-behavior tests
Deicyde Oct 22, 2026
a1bf20d
Merge #424, with main's #450, into the docs cuts
Deicyde Oct 22, 2026
d9880c7
Name the TeX packages the site loads
Deicyde Oct 22, 2026
9c40a15
Apply the review's notes on the docs cuts
Deicyde Oct 22, 2026
2ca340c
Merge pull request #451 from facebookresearch/cleanup/docs-cuts
Deicyde Oct 22, 2026
fecc193
Merge main, with #284 and #443, into the doc-behavior tests
Deicyde Oct 22, 2026
7e1324e
Recognize the review policy marker the verify workflow checks by hash
Deicyde Oct 22, 2026
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
11 changes: 4 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,12 +31,9 @@ workflow and cross-file maintenance.
files under `blueprint/.implementation-notes/`; they are not mathematics or
graph state. Rendered sites, the vault's dependency summary, dashboards, and
runtime projections are derived views, not another durable scheduler or graph.
- In consumer formalization work, Lean imports are allowed. Follow Formalize's
`autoform work import-impact` policy: baseline the affected articles and
repeat that evidence after rebuilding, check them for active conflicts, and
expand ownership only for validated downstream changes; when using claims,
also claim the article/module and check reported claim keys. Never replace
that evidence boundary with a blanket import ban.
- In consumer formalization work, Lean imports are allowed;
[Formalize](skills/formalize/SKILL.md#import-edits) owns that policy. Never
replace it with a blanket import ban.
- Public CLI and JSON shapes are contracts. Lean server work requires an
explicit project root, bounded time and output, verified descendant cleanup,
and no retry after dispatch with an unknown outcome. A project root is not an
Expand Down Expand Up @@ -73,4 +70,4 @@ The [CLI reference](autoform_cli/README.md) gives each command's exact rules.
| `work`, `search` | invalid usage (2); bytes changed since the graph loaded; a refused library; under `--module-scope import-closure`, a file outside the captured sources that may import the closure | none; they leave out values they cannot represent, which `check` warns about |
| `library index` | a missing or stale build (2); a stale index under `--check` (1) | none |
| `project`, `doctor` | an inspection or catalog error, a failed diagnosis | a release pairing it cannot resolve |
| `init` | an existing entry that differs from one it manages, without `--force` | the entries it left alone |
| `init` | an input or target it cannot use safely: a case or Unicode variant of a path it manages (even with `--force`), a link or unusable root `.gitignore` in the way, a directory it cannot list, an invalid option or pinned Autoform tree | the existing entries it left alone; CI it skips when there is no Autoform ref to pin |
39 changes: 16 additions & 23 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,29 +22,22 @@ dependency explorer regressions` installs the `browser` extra and WebKit and
runs `tests/test_dag_viewer_browser.py` with `AUTOFORM_REQUIRE_BROWSER_TESTS=1`,
so a missing browser fails the job instead of skipping its tests; locally they
skip without the extra, and `make test-browser` installs both and runs them as
CI does. `MathJax read-back cards (Node)` downloads the npm tarball of MathJax
3.2.2, checks its sha256, and runs `tests/test_site_mathjax_node.py` in Node
with `AUTOFORM_REQUIRE_MATHJAX_TESTS=1`; locally those tests skip unless `node`
is on `PATH` and `AUTOFORM_MATHJAX_DIR` names an unpacked MathJax 3.2.2
package. `real Lean
(fixture toolchain)` builds and audits a project from the bundled Mathlib
release and runs
the real-Lean suites other than the skeleton suite, which `real Lean skeleton
suite` runs with one `tests/test_project_inspect.py` test. Another job runs the
inspection, bounded-subprocess, and transactional-output tests on Windows, and
the last builds
`tests/fixtures/repl-smoke` and runs `tests/test_real_repl.py` against the
pinned upstream REPL, also checking the header parser on the oldest Lean release
Autoform supports. Locally, tests that need Lean skip when
`lake` is not on `PATH`. Those in `tests/test_skeleton.py`, `test_impact.py`,
`test_contract.py`, `test_lake_artifact_audit.py`, `test_lsp_protocol.py` and
`test_batch_diagnostics.py` also skip when elan is installed but the
toolchain pinned in `tests/fixtures/skeleton-project/lean-toolchain` is
missing; only the real-Lake test in `tests/test_project_inspect.py` lets elan
download it. The `tests/test_library_generate.py`
ones that run Lean build a fixture that clones Batteries from GitHub, so they
run only when `AUTOFORM_REQUIRE_REAL_LIBRARY_TESTS=1` is set, as their CI job
does; a missing toolchain or a failed download then fails them. Run
CI does. The `MathJax read-back cards (Node)` tests skip locally unless `node`
is on `PATH` and `AUTOFORM_MATHJAX_DIR` names an unpacked MathJax 3.2.2 package;
`AUTOFORM_REQUIRE_MATHJAX_TESTS=1`, which CI sets, makes that a failure. The
other jobs, which build and audit a project from the bundled Mathlib release,
run the real-Lean suites, run the inspection, subprocess, and publication tests
on Windows, and run `tests/test_real_repl.py` against the pinned upstream REPL,
are listed with the tests each runs in
[`tests.yml`](.github/workflows/tests.yml). Locally, tests that need Lean skip
when `lake` is not on `PATH`, and most also skip when elan is installed but the
toolchain pinned in `tests/fixtures/skeleton-project/lean-toolchain` is missing;
only the real-Lake test in `tests/test_project_inspect.py` lets elan download
it. `AUTOFORM_REQUIRE_REAL_LEAN_TESTS=1`, which CI sets, makes a missing
toolchain a failure instead. The `tests/test_library_generate.py` tests that run
Lean clone Batteries from GitHub, so they run only with
`AUTOFORM_REQUIRE_REAL_LIBRARY_TESTS=1`, and then a missing toolchain or a
failed download fails them. Run
`lake build` in `skills/setup/assets/cabannes-thesis-project` when you change
the example's Lean sources or declarations.

Expand Down
Loading
Loading