Skip to content

CI: integrate build workflow + Makefile, consolidate OEPL test, add audit docs - #5

Merged
Hoggormino merged 6 commits into
mainfrom
ci-consolidation
Sep 23, 2026
Merged

Hoggormino merged 6 commits into
mainfrom
ci-consolidation

Conversation

@Hoggormino

Copy link
Copy Markdown
Owner

Brings the CI build workflow and root Makefile onto main, folds the OpenEPaperLink host test into it, and commits the two audit reports.

Commits

  1. Merge ci-build-workflow-and-makefile — .github/workflows/build.yml (FAP release/dev SDK, Cloudflare worker, ESP32-S2 firmware, web-page syntax check, advisory ufbt lint) and the root Makefile. Merged cleanly; CONTRIBUTING.md, README.md, esp32-wifi-fw/sdkconfig.defaults auto-reconciled.
  2. Fold the OEPL test into build.yml — the standalone oepl-test.yml becomes an oepl job in build.yml (same banner style, checkout@v7), and the separate file is removed. One build workflow. The job compiles the real oepl/tagtinker_oepl.c against test/stubs with gcc and runs test/run_oepl_test.sh; blocking, unlike advisory lint.
  3. Add audit docs — docs/tagtinker-quality-audit.md (the read-only bug + dead-code audit) and the §3.7-updated docs/tag-interoperability-investigation.md.

Verification (local)

  • build.yml parses; jobs: fap, worker, esp32, web, oepl, lint.
  • OEPL host test 24/24; ufbt build clean (Target 7, API 87.1).

build.yml's fap/worker/esp32/web jobs run on GitHub for the first time here — the oepl job is the one this PR adds.

🤖 Generated with Claude Code

Hoggormino and others added 6 commits September 15, 2026 10:02
- .github/workflows/build.yml: build the Flipper FAP (ufbt, release + dev
  SDK channels), the Cloudflare Worker (tsc + wrangler dry-run bundle) and
  the ESP32-S2 firmware (ESP-IDF v5.2.8) on every push to main and every
  pull request; syntax-check the inline scripts of the web image-prep page;
  run `ufbt lint` as a non-blocking advisory job. No path filters, because
  the shared UART protocol header is compiled into both the FAP and the
  ESP firmware.
- Makefile: one entry point for developers (setup, build-all, build-fap,
  build-worker, build-esp, launch, flash-esp, serve-web, lint, clean).
  Works with the stock GNU Make 3.81 on macOS. Auto-detects the ESP-IDF
  Python virtualenv when export.sh would otherwise look for one matching
  a newer system python3.
- esp32-wifi-fw/sdkconfig.defaults: pin CONFIG_IDF_TARGET="esp32s2" so
  clean builds (CI, fresh clones) no longer fall back to plain esp32.
- cloud-plugins/package.json: add the `build` script (wrangler dry-run
  bundle) that the Makefile and CI rely on.
- README/CONTRIBUTING: document the make targets and CI; add a build badge.
- .gitignore: ignore .venv/ and the .clang-format generated by ufbt lint.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- Export IDF_TARGET=esp32s2 so ESP-IDF performs the same target consistency
  check locally that the CI action gets from its IDF_TARGET env: a stale
  sdkconfig generated for another chip is now refused instead of built.
- Print an absolute path in the export.sh failure hint; zsh does not
  tilde-expand VAR=~/path, so the old hint produced a literal "~".
- launch depends on build-fap and flash-esp on build-esp, so `make -j`
  cannot run two builders in the same tree.
- clean/distclean refuse to run outside the repository root (they delete
  cwd-relative paths).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…file

Brings .github/workflows/build.yml (FAP release/dev, Cloudflare worker, ESP32
firmware, web page, advisory lint) and the root Makefile onto main. Merged
cleanly; CONTRIBUTING.md, README.md and esp32-wifi-fw/sdkconfig.defaults were
changed on both sides and auto-reconciled.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Now that build.yml is on main, the OpenEPaperLink host unit test becomes an
`oepl` job there (listed in the header banner, same style, checkout@v7) and the
standalone .github/workflows/oepl-test.yml is removed, so there is one build
workflow. The job compiles the real oepl/tagtinker_oepl.c against test/stubs
with gcc and runs test/run_oepl_test.sh; it is blocking, unlike advisory lint.

Verified: test 24/24; ufbt build clean (Target 7, API 87.1); build.yml parses
with jobs fap, worker, esp32, web, oepl, lint.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…eport

- docs/tagtinker-quality-audit.md: the read-only bug + dead-code audit (adversarially
  verified findings, severity/confidence/file:line/evidence/remediation, plus the
  cross-branch status table).
- docs/tag-interoperability-investigation.md: refresh the copy on main with the §3.7
  update describing the current NFC classify()/url_host_is() code on this line of work.

Documentation only; no code behaviour changes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The release-SDK CI job failed FAP symbol resolution: `strpbrk` is present in the
firmware API table but disabled, so a FAP referencing it is flagged not runnable.
The config/allow-list loaders used strpbrk(line, "\r\n") to find line ends;
replace it with a tiny oepl_find_eol() hand-scan. No behaviour change.

It slipped past the locally-pinned SDK (1.4.3/API 87.1) but CI's fresh release
SDK enforces it. Host test still 24/24; ufbt build clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Hoggormino
Hoggormino merged commit a3b5914 into main Sep 23, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant