Skip to content

Integrate Quartz for publishing the spec + spec content#1865

Merged
zah merged 8 commits into
mainfrom
spec
Jul 16, 2026
Merged

Integrate Quartz for publishing the spec + spec content#1865
zah merged 8 commits into
mainfrom
spec

Conversation

@zah

@zah zah commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Lands the specification-publishing work from the spec branch onto main.

What this adds (6 commits over main)

  • feat(nix-shell): Add repomix
  • feat(spec): Integrate Quartz for publishing the upcoming spec files
  • docs(spec): Add raw non-obsidian-ready markdown files on various topics
  • docs(spec): Organise and name the files in a more consistent way
  • docs(spec): Restore proper Markdown footnotes across all specification documents
  • Update README to reflect current directory structure and content

Notes

  • spec branched from main at 349a12c4 (2025-07-30); main has 70 commits since. Local merge preview (git merge-tree) shows no conflicts.
  • To be merged once CI is green.

zah and others added 8 commits July 16, 2026 09:07
This is an useful tool for preparing code listing for LLMs:
https://repomix.com/
…n documents

- Convert broken Google Docs export footnote references (e.g., .1, .2) to proper Markdown footnotes
- Update all 'Works cited' sections to use [^1]: format instead of numbered lists
- Ensure cross-references to blocksense-litepaper.md are properly formatted
- Improve readability and compatibility with GitHub and Quartz publishing
- Update directory structure to match actual current organization
- Add comprehensive content status section showing completed specifications
- Document planned future content areas
- Update setup instructions to use Nix flakes properly
- Add content guidelines for contributors
- Fix cross-references to use actual document names
- Maintain forward-looking structure for future additions
The spec branch registered `spec/website` as a yarn workspace, but that
path never existed (the spec content lives under `spec/` and is built
via Nix `specification-website`, not the yarn workspace build). Yarn
Berry's immutable install in CI failed on the unresolvable workspace,
breaking `build-and-test-ts-libs-and-apps` and `decoders-tests`.

Removes the `spec/website` workspace entry and the corresponding
yarn.lock stub, restoring yarn.lock to match origin/main (green CI).
isTokenValid() intends to return false when DFCG_ARTIFACTS_ACCESS_TOKEN
is invalid, so `describe.skipIf(!tokenValid)` skips the legacy config
decoding suite. But the 401 guard used `error instanceof RequestError`,
and Octokit throws a RequestError from a differently-resolved copy of
@octokit/request-error, so the instanceof check was false and the 401
re-threw — failing the suite instead of skipping it.

This only surfaces when the token is invalid/expired (the CI token
currently 401s); with a valid token the suite runs as before. Fall back
to the numeric `error.status` so a 401 is treated as an invalid token.

Pre-existing bug (file identical on origin/main); fixing it here unblocks
the spec PR's `build-and-test-ts-libs-and-apps` job.
@github-actions

Copy link
Copy Markdown

🚀 Deployment Links of Blocksense Network websites:

Website Latest Update Commit
🌱 Documentation 16.07.2026 06:32:20 4b45345
📖 Docs UI Components 16.07.2026 06:32:20 4b45345
📝 UI Components 16.07.2026 06:32:20 4b45345

@zah
zah merged commit 64d92bf into main Jul 16, 2026
12 checks passed
@zah
zah deleted the spec branch July 16, 2026 09:02
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