Research-Stack/4-Infrastructure/packaging/substack-local-preview/README.md
Brandon Schneider 0cf775c80e collapse: prover orchestration layers, FAMM verilator harness, swarm topological prober, spec sheets, virtual FPGA system tests, merge conflict resolution
- Prover-Integrated Orchestration Layers (L0-L3): Goedel-Prover-V2 watchdog, BFS-Prover-V2 swarm consensus, bf4prover topology adaptation
- FAMM Verilator benchmark: uniform vs preshaped delay comparison (4.4x speedup)
- Swarm topological device prober: 11 agents probing traces, caps, delays, errors, vias, PDN
- Spec sheet puller: 10 components with key params and topological relevance
- Virtual FPGA system tests: 6/6 passed, 134K ops/s throughput
- Fixed merge conflicts in AI-Newton test_experiment.ipynb
2026-05-06 23:42:01 -05:00

51 lines
1.7 KiB
Markdown

# substack-local-preview
Local native helper for Research Stack article bundles.
This package wraps the repo-local Substack connector scripts:
- build `substack_bundle/post.md`
- build `substack_bundle/post.html`
- refresh `substack_bundle/manifest.json`
- run local Harper and Vale checks
- serve a local browser preview
- prepare a manual Substack editor handoff
- update an existing Substack draft through
`plugins/substack-connector/scripts/update_existing_post.py`
- optionally publish that updated draft with `send=False`
## Build
```sh
makepkg -f
```
## Install
```sh
yay -U --noconfirm substack-local-preview-0.1.0-1-any.pkg.tar.zst
```
## Use
```sh
substack-local-preview build 6-Documentation/articles/meme-math-that-pays-rent
substack-local-preview check 6-Documentation/articles/meme-math-that-pays-rent
substack-local-preview open 6-Documentation/articles/meme-math-that-pays-rent
substack-local-preview preview --open 6-Documentation/articles/meme-math-that-pays-rent
substack-local-preview publish-prep 6-Documentation/articles/meme-math-that-pays-rent
substack-local-preview update 6-Documentation/articles/babbage-to-babcock --post-id 196596937
substack-local-preview publish 6-Documentation/articles/babbage-to-babcock --post-id 196596937
```
`publish-prep` rebuilds the bundle, runs local checks, and copies the post
Markdown to the clipboard when `wl-copy` or `xclip` is available.
## Authenticated Update Boundary
Authenticated update/publish uses `/home/allaun/.substack.env` by default and
expects `COOKIES_STRING` there. Credentials stay outside the repo.
The `publish` command delegates to the existing Python script and uses its
current behavior: prepublish, then publish with `send=False` and
`share_automatically=False`.