Commit graph

8 commits

Author SHA1 Message Date
Scott Scoble
6121fd6a8f Whitepaper v2 Section 8: Future Work & Roadmap (~2,900 words)
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 1s
Completes the whitepaper. Covers:
- 8.1 Compiler completeness (record types, action bodies, in operator, Map ops, host binding, TigerBeetle E2E)
- 8.2 Language extensions (temporal properties, function types, modules, parametric types)
- 8.3 Tooling ecosystem (LSP, IDE plugins, package registry, CI/CD)
- 8.4 Strategic roadmap (Open Standard → Consulting → SaaS → Compliance API)
- 8.5 What Will Not Change (small language, mandatory provenance, MIT, evidence over proof)
- Conclusion: the case for accountable software

All 8 sections complete. ~19,000 words total.
2026-05-07 01:14:24 -07:00
Scott Scoble
940b959efb Whitepaper v2 Section 7: Related Work (~2,500 words)
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 2s
Comprehensive comparison of SpeckDL against:
- TLA+/PlusCal (model checking vs. runtime compilation)
- Alloy (structural vs. behavioral modeling)
- Coq/Rocq (static proofs vs. dynamic enforcement)
- Dafny (verified code vs. spec-as-code)
- Event-B, UML/SysML, P (Microsoft), OpenAPI/gRPC
- SBOM tools: Syft/Grype, SLSA, in-toto

Includes positioning table across 7 tools on 6 dimensions.
Defines niche: specification language with compiler-level provenance,
designed for teams that need evidence of correctness more than proof.
2026-05-07 00:18:59 -07:00
Scott Scoble
627c46235c whitepaper: Section 6 — Compliance & Supply Chain Security (~2,800 words)
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 2s
Covers: regulatory landscape (EO 14028, CRA, DORA, FedRAMP), NIST SA-11 control
mapping (sub-controls 2/4/6/7), the evidence problem, compliance automation workflow,
judgement transport model, 4 real-world use cases (FDA, CISA, DORA, SLSA), clear
boundaries on what Speckl does not do, and cost equation with before/after comparison.
Completes the bridge between provenance (S4) and practical regulatory value.
2026-05-06 22:07:06 -07:00
Scott Scoble
2ede8445e4 whitepaper v2: Section 5 - Consensus Protocols in SpeckDL (~2,800 words)
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 2s
- 2PC, Paxos, Raft case studies with full protocol descriptions
- Why consensus protocols are ideal SpeckDL case studies
- Per-protocol: state model, action breakdown, safety invariants
- TLA+ vs SpeckDL side-by-side comparison table
- Raft bridging from academic consensus to production (etcd/Consul)
- Natural progression: 2PC → Paxos → Raft → TigerBeetle curriculum
- Sections complete: 1-5 of 8
2026-05-06 21:14:57 -07:00
Scott Scoble
322d54781a whitepaper v2: Section 4 — Embedded Provenance (~2,000 words)
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 2s
Covers: supply chain blind spot problem, provenance-by-construction approach,
PROV-O audit trail (Turtle example), CycloneDX SBOM (JSON example),
SPDX license metadata (JSON example), NIST SA-11 control mapping,
5 design implications of provenance as first-class compiler concern.
2026-05-06 20:08:18 -07:00
Scott Scoble
fa896dec77 whitepaper v2: Section 3 - Compiler Architecture (~2,500 words)
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 2s
Covers full compilation pipeline: parser (~850 lines), AST design, all 5
generators (PROV-O, CycloneDX, SPDX, TypeScript, WASM), WASM host runtime,
test infrastructure (41 tests, 3 suites), and architectural design decisions
(TypeScript throughout, zero external services, independent generators,
text-first WASM, DIST DESYNC guard, CLI-first).

Sections 1-3 complete; 4-8 remain.
2026-05-06 19:07:12 -07:00
Scott Scoble
66ecdd69b9 whitepaper v2: Section 2 - SpeckDL language specification
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 2s
Full technical writeup covering:
- Design philosophy (spec as source of truth, state machines, type-safe, emit)
- Structure of a speck (types, state, init, invariant, action, next)
- Type system (Bool, Nat, Int, String, Set, Map, List, Records, Optional)
- Actions (require, assignments, let bindings, if, emit, return, forall)
- Invariants (documentation + runtime verification, quantified, logical ops)
- Action composition (next: non-deterministic interleaving)
- Complete Two-Phase Commit example (48-line spec)
- What SpeckDL deliberately omits (no functions, no loops, no concurrency, no I/O, no error handling)
- ~2,000 words
2026-05-06 18:07:53 -07:00
Scott Scoble
2ed6c13026 whitepaper v2: Section 1 (The Spec-Code Gap) with executable specs framing
Some checks failed
Deploy Landing Page to Storj / deploy (push) Failing after 3s
Rewrites the whitepaper from the old 'Dark Provenance' concept to reflect
what Speckl actually is now: specifications that compile to software.

Section 1 covers:
- The Archaeology Problem (specs that rot in docs)
- The Formal Methods Gap (verified spec ≠ running system)
- The SpeckDL Approach (compile spec directly to code + provenance)
- Concrete ToggleSwitch example (14 lines → 5 artifacts)

Whitepaper outline restructured around current compiler capabilities
(TypeScript, WASM, PROV-O, CycloneDX, SPDX generators).
2026-05-06 17:07:50 -07:00