fenolite 0.0.1.dev0__tar.gz

fenolite-0.0.1.dev0/.gitignore

@@ -0,0 +1,32 @@
+# Claude Code local state
+.claude/*
+
+# Private planning material (never published)
+private/
+
+# Fenolite derived cache
+.fenolite/
+
+# Python / tooling
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.hypothesis/
+.coverage
+htmlcov/
+dist/
+build/
+*.egg-info/
+
+# Editor/OS
+.DS_Store
+.idea/
+.vscode/
+
+# Backups written by atomic saves
+*.bak
+
+# Temporary verification artefacts
+verify_results/*.tmp

fenolite-0.0.1.dev0/AGENTS.md

@@ -0,0 +1,47 @@
+# Guidance for AI agents working on Fenolite
+
+Read this file before changing anything. Humans: this is also the short version of `CONTRIBUTING.md`.
+
+## Workflow
+
+1. **OpenSpec first.** Every change lives in `openspec/changes/<id>/` with `proposal.md`,
+   `design.md`, `specs/` and `tasks.md`. Do not write code that no task asks for. Implement tasks
+   in order, tick `- [x]` only after the task's proof command passed.
+2. **One fix per iteration.** Make one focused change, run its proof, then move on.
+3. **Before finishing:** `make check` (ruff check, ruff format --check, pyright src, pytest) must pass.
+4. Update `CHANGELOG.md` under `## [Unreleased]` for every change.
+
+## Hard rules
+
+- **Clean-room.** Never add code, constants, seeds, fixtures, statistics, vocabularies, templates or
+  examples taken from an employer, a private project or any organisation. Test data is authored for
+  Fenolite or fetched from public sources declared in the corpus manifest.
+- **Format knowledge from public sources only.** Record each fact in `docs/formats/<backend>/*.md`
+  with its source (listed in `docs/evidence/sources.md`) and an evidence label. Never copy or
+  transcribe third-party parser code or grammar files, and never decompile vendor software.
+- **No runtime dependencies in the core.** `pyproject.toml` `dependencies` stays empty; third-party
+  packages go to an extra and are imported lazily.
+- **Copyleft only across a process boundary.** Run GPL/AGPL tools as subprocesses; never import them.
+- **Never commit** anything under `private/`, KiCad official library files, or absolute user paths.
+- Every `.py` file starts with the SPDX and copyright lines.
+
+## Conventions
+
+- The design model (entities, ids, units, canonical JSON) is described in `docs/design-model.md`.
+
+- Lengths: integer nanometres. Angles: integer microdegrees. No floats in the model.
+- Evidence labels: `KICAD-VERIFIED`, `ORACLE-VERIFIED(<tool>)`, `CORPUS-VERIFIED`,
+  `ALTIUM-VERIFIED(kit|author-report)`, `INFERRED`, `UNKNOWN`, `UNVERIFIED` (lowest wins).
+
+## Using the `fenolite` CLI (contract v0, `docs/cli-contract.md`)
+
+1. Start with `fenolite capabilities --json`: commands, extras, external tools and their versions.
+2. Output is JSON whenever stdout is not a terminal; pass `--json` anyway to be explicit. Use
+   `--fields a,b.c` to keep the reply small.
+3. Read the exit code first: 0 ok, 1 bug, 2 usage, 3 bad input, 4 confirmation required,
+   5 findings (read `issues`), 6 external tool missing, 7 lossy operation refused. On non-zero,
+   stderr holds one error object with `code`, `message`, `hint`, `retryable`.
+4. Writing commands never write by default: run with `--dry-run`, check `result.plan`, then re-run
+   with `--confirm`. The `receipt` lists every written file with its SHA-256.
+5. Pass `--seed` and `--timestamp` when you need byte-identical outputs.
+6. Every reply carries `evidence.level`; treat anything below `KICAD-VERIFIED` as unconfirmed.

fenolite-0.0.1.dev0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to Fenolite are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
+[Semantic Versioning](https://semver.org/) (pre-1.0: minor versions may break).
+
+## [Unreleased]
+
+## [0.0.1.dev0] - 2026-09-30
+
+Pre-alpha repository bootstrap; not usable for real boards yet.
+
+### Added
+
+- Repository bootstrap: package skeleton (`src/fenolite`, stdlib-only core, closed extras), Apache-2.0 licence with NOTICE and SPDX headers, `LEGAL.md`/`LEGAL-ANNEX.md`, DCO, ADR-0004, evidence registers and the `unit` CI baseline (ruff, pyright strict, pytest on ubuntu and macos).
+- CLI contract v0: JSON envelope (`schemas/fenolite.envelope.v0.json`) and typed stderr errors (`schemas/fenolite.error.v0.json`), exit codes 0–7, `--fields`, mutation protocol (`--dry-run`/`--confirm`, atomic writes with `.bak`, receipts), `--seed`/`--timestamp`, the `capabilities` command, a consistency test over every command and a package-layering test.
+- IP hygiene: ADR-0003 (clean-room and provenance), four explicit prohibitions in `LEGAL.md`, provenance rules and test, residue scan (`tools/residue/scan.py`: structural patterns, blob hashes, private token and hash lists kept outside the repository, UTF-16/cp1252/zip awareness, `--staged` and `--history` modes) with a pre-commit hook and CI step, copyleft-dependency and no-ported-code guards, corpus manifest with the embeddable rule and `tools/corpus_fetch.py`.
+- Design model v0: `fenolite.core` (integer nm/µdeg units with exact parsing and half-even conversion to 1/10 000 mil, ids, evidence levels, errors and issues, provenance, coordinates, atomic I/O) and `fenolite.model` (entity header with native ids, provenance and extension bags; circuit, board, rules, manufacturing and findings layers; `Design` with indexes, validation and entity replacement; canonical JSON with a validating decoder; JSON Schemas in `schemas/fenolite.model.v0/`), ADR-0001 and `docs/design-model.md`.
+- Name reservation: alias distribution `phenolite` (installs `fenolite`) and a release workflow that publishes both to PyPI with trusted publishing when a GitHub Release is published.

fenolite-0.0.1.dev0/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

fenolite-0.0.1.dev0/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to Fenolite
+
+Thank you for helping. Fenolite is spec-driven, agent-friendly and strict about provenance.
+
+## Workflow
+
+1. **One change per pull request.** Every change starts as an OpenSpec change under
+   `openspec/changes/<id>/` (`proposal.md`, `design.md`, `specs/`, `tasks.md`). No code lands
+   without one. See `openspec/README.md`.
+2. Implement the tasks in order; each task names the command that proves it.
+3. Run `make check` (ruff, ruff format, pyright, pytest) before pushing; CI runs the same steps.
+4. Commit messages follow [Conventional Commits](https://www.conventionalcommits.org/)
+   (`feat(model): …`, `fix(kicad): …`, `docs: …`, `test: …`, `chore: …`).
+
+## Developer Certificate of Origin
+
+Every commit MUST carry a `Signed-off-by:` trailer certifying the
+[Developer Certificate of Origin 1.1](https://developercertificate.org/):
+
+```bash
+git commit -s -m "feat(core): add integer length units"
+```
+
+By signing off you state that you wrote the contribution or have the right to submit it under
+the Apache License 2.0.
+
+## Provenance rules (read `LEGAL.md`)
+
+- Learn formats only from public documentation and from files you are entitled to read.
+- Never decompile vendor software; never copy, transcribe or compile third-party parser code
+  or grammar files into Fenolite. Reading public sources for facts is fine: record each fact in
+  `docs/formats/` with its source.
+- Never add files, values, names, templates or examples that belong to an employer or any other
+  organisation. Test data is authored for Fenolite or fetched from public sources listed in the
+  corpus manifest.
+- Copyleft tools run only as external processes; they never become dependencies.
+
+## Allowed vs forbidden derivation
+
+| Allowed | Forbidden |
+|---|---|
+| Reading a public format page and writing in `docs/formats/kicad/pcb.md`: "a `via` node carries `(at X Y)`, `(size D)`, `(drill D)`, `(layers A B)` — source S-0007", then implementing the parser from that page. | Opening a GPL parser's source, copying or paraphrasing its function that reads `via` nodes, or converting its grammar file into a Python parser. |
+| Measuring a record layout on a public, licence-compatible sample file and recording the offsets with the file's manifest id. | Measuring anything on files you are not entitled to share or use (for example an employer's boards) or reusing values measured on them earlier. |
+| Running a copyleft tool as a subprocess and comparing its output with Fenolite's (an oracle). | Adding that tool, or a library that links it, to `pyproject.toml`. |
+| Writing an example board from scratch for `examples/`. | Recreating a board, template, title block, rule set or part list you know from work. |
+
+## Code style
+
+- Python ≥ 3.11, stdlib-only core, full type hints (`pyright` strict on `src/`).
+- Every `.py` file starts with the SPDX and copyright lines (see any existing file).
+- Lengths are integer nanometres; angles are integer microdegrees; no floats in the model.

fenolite-0.0.1.dev0/LEGAL-ANNEX.md

@@ -0,0 +1,9 @@
+# Clean-room session log
+
+One row per working session that touches `src/fenolite/backends/` or `docs/formats/`: what was
+edited and which public sources were consulted. The prior proprietary work mentioned in
+`LEGAL.md` block B is never opened during these sessions.
+
+| date | area | files touched | public sources consulted | author |
+|---|---|---|---|---|
+| 2026-09-30 | docs/formats | docs/formats/units.md | S-0001, S-0002 | maintainer |

fenolite-0.0.1.dev0/LEGAL.md

@@ -0,0 +1,49 @@
+# Legal notes
+
+Fenolite is licensed under the Apache License, Version 2.0 (see `LICENSE` and `NOTICE`).
+This file explains where Fenolite's knowledge of third-party file formats comes from and how the
+project relates to earlier, non-public work in the same domain. It is a statement of project
+policy, not legal advice.
+
+## A. Format analysis
+
+Fenolite reads and writes files produced by other electronic design automation (EDA) tools.
+
+1. Knowledge of third-party file formats comes **only** from public documentation (official
+   documentation, published specifications, public developer documentation of open-source tools)
+   and from files the contributor is entitled to read (files they created themselves, or files
+   published under a licence that permits the use).
+2. Every format fact used by the code is recorded in `docs/formats/<backend>/*.md` with its public
+   source, listed in `docs/evidence/sources.md`, and carries an evidence label. Code is written
+   from those pages, never from third-party source code. Reading public copyleft sources to learn
+   a **fact** is allowed only when the fact is recorded there with its source.
+3. Copyleft software (GPL, AGPL and similar) is used only behind a process boundary (a
+   subprocess exchanging files or documented JSON) or through a plugin API that its project
+   publishes; it is never imported, vendored or transcribed (ADR-0004).
+
+The following are **forbidden** (ADR-0003):
+
+- **(P1)** decompiling, disassembling or otherwise reverse engineering vendor software — contributors
+  never decompile a tool to learn its format;
+- **(P2)** transcribing, compiling or converting GPL/AGPL parser sources or machine-readable grammar
+  files (for example Kaitai `.ksy` descriptions) into Fenolite code;
+- **(P3)** using files the contributor is not entitled to read (for example an employer's design
+  files, or files obtained under terms that do not allow this use);
+- **(P4)** using an employer's software licence to study or reverse engineer a tool for Fenolite.
+
+Opening a file one is entitled to read in a tool one is licensed to use, and reporting what the
+tool does with it, is ordinary use and may be recorded as a fact with evidence label
+`…(author-report)`; no file used in such a session enters the repository unless it is authored for
+Fenolite or published under a licence listed as embeddable in the corpus manifest.
+
+## B. Prior work
+
+The author of Fenolite has written proprietary software in the same domain, for professional use,
+before this project started. Fenolite is developed **clean-room** with respect to that work:
+
+- no code, constants, seeds, fixtures, test data, statistics, vocabularies, parameter sets,
+  templates or examples from that work, or from any organisation, are reused in Fenolite;
+- format facts that the prior work also relied on are re-derived from the public sources in
+  block A and recorded with those sources;
+- professional use of the prior work continues outside this repository and is declared here;
+  work sessions on format code are logged in `LEGAL-ANNEX.md`.

fenolite-0.0.1.dev0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

fenolite-0.0.1.dev0/Makefile

@@ -0,0 +1,30 @@
+# Private residue lists (gitignored) are picked up automatically when present.
+ifneq (,$(wildcard private/residue-tokens.txt))
+export FENOLITE_RESIDUE_TOKENS_FILE ?= private/residue-tokens.txt
+endif
+ifneq (,$(wildcard private/residue-blobs.sha256))
+export FENOLITE_RESIDUE_BLOBS_FILE ?= private/residue-blobs.sha256
+endif
+
+.PHONY: check lint format types test residue hooks
+
+check: lint format types test
+
+lint:
+	uv run ruff check .
+
+format:
+	uv run ruff format --check .
+
+types:
+	uv run pyright src
+
+test:
+	uv run pytest -q
+
+residue:
+	uv run python tools/residue/scan.py
+
+hooks:
+	ln -sf ../../tools/hooks/pre-commit .git/hooks/pre-commit
+	@echo "pre-commit hook installed"

fenolite-0.0.1.dev0/NOTICE

@@ -0,0 +1 @@
+Fenolite — Copyright (c) 2026 Fenolite contributors

fenolite-0.0.1.dev0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.5
+Name: fenolite
+Version: 0.0.1.dev0
+Summary: Headless, agent-first PCB design automation in Python: generate, open, verify, compare, convert and export KiCad (and later Altium) projects from code or the CLI.
+Author: Fenolite contributors
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: ai-agents,altium,cli,drc,eda,electronics,gerber,hardware-as-code,kicad,pcb
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: pyright>=1.1.390; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Provides-Extra: geo
+Requires-Dist: pyclipper>=1.3; extra == 'geo'
+Requires-Dist: shapely>=2.1; extra == 'geo'
+Provides-Extra: kicad-ipc
+Requires-Dist: kicad-python>=0.8; extra == 'kicad-ipc'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Provides-Extra: oracles
+Requires-Dist: gerbonara>=1.6; (python_version >= '3.12') and extra == 'oracles'
+Requires-Dist: pygerber>=2.4; extra == 'oracles'
+Provides-Extra: route
+Requires-Dist: freerouting-client>=2.3; extra == 'route'
+Description-Content-Type: text/markdown
+
+# Fenolite
+
+**Headless, agent-first PCB design automation in Python.** Fenolite lets an engineer — or an AI
+coding agent — generate, open, verify, compare, convert and export printed-circuit-board projects
+from Python code or a JSON-speaking command line, without a GUI. KiCad is the first backend (its
+files, with `kicad-cli` as the verification oracle); a second backend for another major commercial
+format family follows.
+
+> **Status: pre-alpha.** The repository is being bootstrapped. Nothing here is ready for real
+> boards yet. Follow `openspec/changes/` to see what is being built and in which order.
+
+*Fenolite* is the Portuguese word for phenolic board material — the laminate many of us etched our
+first circuit boards on.
+
+## Principles
+
+- **Agent-first CLI.** JSON on stdout when not attached to a terminal, a fixed envelope, typed
+  errors, a small exit-code vocabulary, and writes only with `--confirm` (`--dry-run` shows the plan).
+- **Evidence on every answer.** Each result says how it was verified (see below). Nothing is
+  claimed that was not checked.
+- **No silent information loss.** What Fenolite does not understand in a file is preserved, and a
+  lossy operation stops unless explicitly allowed.
+- **Small, exact model.** Integer nanometres and microdegrees, stable ids, canonical JSON that
+  diffs cleanly in Git.
+- **Stdlib-only core.** `pip install fenolite` installs no other package; heavier features are
+  optional extras.
+- **Your templates, not ours.** Sheet frames and title blocks are generated from your own spec;
+  Fenolite ships no organisation's templates, rules or libraries.
+
+The model is described in `docs/design-model.md`; the CLI contract in `docs/cli-contract.md`.
+
+## Evidence labels
+
+| Label | Meaning |
+|---|---|
+| `KICAD-VERIFIED` | accepted by `kicad-cli` of the stated version, and the claim confirmed by its output |
+| `ORACLE-VERIFIED(<tool>)` | an independent parser or tool agreed |
+| `CORPUS-VERIFIED` | round-trip holds on public files listed in the corpus manifest |
+| `ALTIUM-VERIFIED(kit)` | confirmed by a native-tool acceptance run with archived results |
+| `ALTIUM-VERIFIED(author-report)` | reported by the author from ordinary use; never enough for a release claim |
+| `INFERRED` | deduced from public documentation; a hypothesis in `docs/hypotheses.md` tracks it |
+| `UNKNOWN` | bytes or fields preserved without interpretation |
+| `UNVERIFIED` | default for anything new |
+
+A command's overall label is the lowest label of the steps it ran.
+
+## Install (development)
+
+```bash
+git clone <this repository>
+cd fenolite
+uv sync --extra dev
+uv run fenolite --version
+make check
+```
+
+Talk to it like an agent does:
+
+```bash
+uv run fenolite capabilities --json --fields tools          # what is installed here
+uv run fenolite capabilities --text                         # the same, for humans
+echo $?                                                     # 0 ok, 2 usage, 4 confirm, 5 findings …
+```
+
+Optional extras: `geo` (polygon booleans), `kicad-ipc` (live KiCad session), `route` (Freerouting
+client), `mcp` (MCP server), `oracles` (Gerber re-parsers used in tests), `dev`.
+
+## Licence and provenance
+
+Apache-2.0 (`LICENSE`, `NOTICE`). Format knowledge comes only from public sources; see `LEGAL.md`
+for the clean-room rules and `CONTRIBUTING.md` for how to contribute. Every CI run and every commit
+(after `make hooks`) passes a residue scan (`tools/residue/`) that blocks absolute paths, internal
+identifier shapes and known non-public files; see `docs/provenance.md` for the provenance rules. AI agents working in this
+repository: read `AGENTS.md` first.

fenolite-0.0.1.dev0/README.md

@@ -0,0 +1,74 @@
+# Fenolite
+
+**Headless, agent-first PCB design automation in Python.** Fenolite lets an engineer — or an AI
+coding agent — generate, open, verify, compare, convert and export printed-circuit-board projects
+from Python code or a JSON-speaking command line, without a GUI. KiCad is the first backend (its
+files, with `kicad-cli` as the verification oracle); a second backend for another major commercial
+format family follows.
+
+> **Status: pre-alpha.** The repository is being bootstrapped. Nothing here is ready for real
+> boards yet. Follow `openspec/changes/` to see what is being built and in which order.
+
+*Fenolite* is the Portuguese word for phenolic board material — the laminate many of us etched our
+first circuit boards on.
+
+## Principles
+
+- **Agent-first CLI.** JSON on stdout when not attached to a terminal, a fixed envelope, typed
+  errors, a small exit-code vocabulary, and writes only with `--confirm` (`--dry-run` shows the plan).
+- **Evidence on every answer.** Each result says how it was verified (see below). Nothing is
+  claimed that was not checked.
+- **No silent information loss.** What Fenolite does not understand in a file is preserved, and a
+  lossy operation stops unless explicitly allowed.
+- **Small, exact model.** Integer nanometres and microdegrees, stable ids, canonical JSON that
+  diffs cleanly in Git.
+- **Stdlib-only core.** `pip install fenolite` installs no other package; heavier features are
+  optional extras.
+- **Your templates, not ours.** Sheet frames and title blocks are generated from your own spec;
+  Fenolite ships no organisation's templates, rules or libraries.
+
+The model is described in `docs/design-model.md`; the CLI contract in `docs/cli-contract.md`.
+
+## Evidence labels
+
+| Label | Meaning |
+|---|---|
+| `KICAD-VERIFIED` | accepted by `kicad-cli` of the stated version, and the claim confirmed by its output |
+| `ORACLE-VERIFIED(<tool>)` | an independent parser or tool agreed |
+| `CORPUS-VERIFIED` | round-trip holds on public files listed in the corpus manifest |
+| `ALTIUM-VERIFIED(kit)` | confirmed by a native-tool acceptance run with archived results |
+| `ALTIUM-VERIFIED(author-report)` | reported by the author from ordinary use; never enough for a release claim |
+| `INFERRED` | deduced from public documentation; a hypothesis in `docs/hypotheses.md` tracks it |
+| `UNKNOWN` | bytes or fields preserved without interpretation |
+| `UNVERIFIED` | default for anything new |
+
+A command's overall label is the lowest label of the steps it ran.
+
+## Install (development)
+
+```bash
+git clone <this repository>
+cd fenolite
+uv sync --extra dev
+uv run fenolite --version
+make check
+```
+
+Talk to it like an agent does:
+
+```bash
+uv run fenolite capabilities --json --fields tools          # what is installed here
+uv run fenolite capabilities --text                         # the same, for humans
+echo $?                                                     # 0 ok, 2 usage, 4 confirm, 5 findings …
+```
+
+Optional extras: `geo` (polygon booleans), `kicad-ipc` (live KiCad session), `route` (Freerouting
+client), `mcp` (MCP server), `oracles` (Gerber re-parsers used in tests), `dev`.
+
+## Licence and provenance
+
+Apache-2.0 (`LICENSE`, `NOTICE`). Format knowledge comes only from public sources; see `LEGAL.md`
+for the clean-room rules and `CONTRIBUTING.md` for how to contribute. Every CI run and every commit
+(after `make hooks`) passes a residue scan (`tools/residue/`) that blocks absolute paths, internal
+identifier shapes and known non-public files; see `docs/provenance.md` for the provenance rules. AI agents working in this
+repository: read `AGENTS.md` first.