You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<metaname="description" content="A7 is a statically-typed, procedural language with array programming capabilities, generics, and manual memory management. Compiles to Zig." />
15
+
<metaname="description" content="A7 is a small systems language compiler with explicit control flow, no source recursion, clear diagnostics, and Zig/C output." />
For curl.md or other agent fetch workflows, start with:
6
+
7
+
```text
8
+
https://code5717.github.io/a7-py/llms.txt
9
+
https://code5717.github.io/a7-py/docs/index.md
10
+
https://code5717.github.io/a7-py/llms-full.txt
11
+
```
12
+
13
+
Use `llms.txt` for routing, `docs/index.md` for the navigation tree, and `llms-full.txt` when a single combined context file is more useful than many small fetches.
14
+
15
+
## Local Source of Truth
16
+
17
+
-`README.md`: user-facing overview and commands.
18
+
-`docs/SPEC.md`: language specification.
19
+
-`MISSING_FEATURES.md`: current gaps.
20
+
-`TODO.md`: tracked implementation backlog.
21
+
-`RELEASE.md`: release workflow and artifact gates.
22
+
-`AGENTS.md`: repo workflow for coding agents.
23
+
24
+
## Preferred Commands
25
+
26
+
```bash
27
+
uv sync
28
+
uv run a7 examples/001_hello.a7
29
+
PYTHONPATH=. uv run pytest --tb=no -q
30
+
uv run python scripts/verify_examples_e2e.py
31
+
uv run python scripts/verify_examples_e2e_c.py
32
+
uv run python scripts/verify_backend_parity.py
33
+
./run_all_tests.sh
34
+
```
35
+
36
+
## Rules For Generated Changes
37
+
38
+
- Do not write recursive A7 examples or tests.
39
+
- Keep `llms.txt`, `llms-full.txt`, and `site/public/docs/` aligned when public docs change.
40
+
- Update `CHANGELOG.md`, `README.md`, `docs/SPEC.md`, `MISSING_FEATURES.md`, and `TODO.md` when language behavior changes.
41
+
- Treat tests as evidence, not a substitute for reading the code and current hosted workflow state.
42
+
43
+
## Trust Boundaries
44
+
45
+
A7 is not a sandbox. Do not compile and run untrusted A7 source on a sensitive host.
The canonical changelog is [`CHANGELOG.md`](https://github.com/code5717/a7-py/blob/master/CHANGELOG.md).
4
+
5
+
## Current Unreleased Focus
6
+
7
+
- Source recursion is rejected during semantic validation.
8
+
- Runnable examples were expanded and rewritten to avoid recursive A7 source.
9
+
- Public curl.md-friendly docs and `llms.txt` are available for agents.
10
+
- Zig/C backend parity checks were added and expanded.
11
+
- Release artifact checksum generation and verification were added.
12
+
- The docs site was simplified, dark mode was revised, and fake testimonial content was removed.
13
+
14
+
## Current Release
15
+
16
+
`0.3.0` documents release/debug artifact checks, the installed `a7` CLI entrypoint, C backend improvements, example verification, and the current language-core gap list.
17
+
18
+
## Release Status
19
+
20
+
Tag-created draft GitHub releases are configured. PyPI Trusted Publishing wiring exists, but final PyPI project trust setup is still required before first publish.
0 commit comments