Skip to content

Commit df10911

Browse files
author
Scott Senkeresty
committed
fix: Update content for Bell Labs structure consistency
Critical fixes for staging site quality: 1. Homepage (docs/pages/index.md) - Fixed 5 broken links from old structure - /canonical/* → /foundations/* - /tools/* → /systems/* - /innovations/* → /systems/* 2. Research routing (src/sif_web/routes/pages.py) - Added subdirectory search for research papers - Papers in agent-infrastructure/, information-architecture/, standards/ now accessible - Maintains backwards compatibility with flat structure 3. Dead code removal (src/sif_web/routes/pages.py) - Removed /innovations routes (lines 400-440) - Fixed /founders-letter to point to foundations/ 4. About page (docs/pages/about.md) - Fixed broken /canonical link - Updated to reference both /manifesto and /foundations 5. Systems README (docs/systems/README.md) - Updated title: "SIL Tools" → "SIL Systems" - Removed broken /innovations links - Added comprehensive system listings - Fixed internal links to /systems/* All changes maintain backwards compatibility via 301 redirects. No breaking changes for users.
1 parent 4f5a091 commit df10911

4 files changed

Lines changed: 67 additions & 79 deletions

File tree

docs/pages/about.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,8 @@ If an agent contributes insight, structure, or decomposition, that provenance ge
139139
**Read our research:**
140140
- [Essays](/essays) — technical essays on semantic infrastructure
141141
- [Research](/research) — deep technical papers
142-
- [Canonical Documents](/canonical) — manifesto, principles, charter
142+
- [Manifesto](/manifesto) — YOLO and soul documents
143+
- [Foundations](/foundations) — principles, architecture, charter
143144

144145
**Collaborate:**
145146
- [Contact us](/contact) for research collaboration

docs/pages/index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,13 @@ SIL develops **semantic infrastructure**—a substrate where:
2525
- **Reasoning is inspectable** — you can see how conclusions were reached
2626
- **Composition works** — systems combine correctly across domains
2727

28-
This is the [Semantic Operating System](/canonical/semantic-os-architecture): persistent memory, unified representations, deterministic engines, multi-agent orchestration, and interfaces where every cognitive layer remains visible.
28+
This is the [Semantic Operating System](/foundations/semantic-os-architecture): persistent memory, unified representations, deterministic engines, multi-agent orchestration, and interfaces where every cognitive layer remains visible.
2929

3030
## Production Systems
3131

3232
These aren't demos. They're working infrastructure proving the architecture:
3333

34-
### [Reveal](/tools/reveal) — Progressive Code Exploration
34+
### [Reveal](/systems/reveal) — Progressive Code Exploration
3535
`pip install reveal-cli` · v0.23.1 · 2K+ downloads/month
3636

3737
Structure-first code exploration with 10-150x token reduction. See file structure before reading content. Extract specific functions without loading entire files.
@@ -42,12 +42,12 @@ reveal app.py # File structure (functions, classes)
4242
reveal app.py main # Extract specific function
4343
```
4444

45-
### [Morphogen](/innovations/morphogen) — Cross-Domain Computation
45+
### [Morphogen](/systems/morphogen) — Cross-Domain Computation
4646
v0.11 · 1,600+ tests · 85% coverage
4747

4848
Unified computational substrate spanning 40+ domains. MLIR-based deterministic execution with cryptographic provenance.
4949

50-
### [GenesisGraph](/innovations/genesisgraph) — Verifiable Provenance
50+
### [GenesisGraph](/systems/genesisgraph) — Verifiable Provenance
5151
v0.3.0 · Cryptographic audit trails
5252

5353
Every transformation produces a provenance record. Selective disclosure lets you verify without revealing everything.
@@ -80,7 +80,7 @@ SIL is the research division of the [Semantic Infrastructure Foundation](https:/
8080

8181
- **Use the tools:** `pip install reveal-cli` and try progressive disclosure
8282
- **Read the research:** [Essays](/essays) and [Research Papers](/research)
83-
- **Explore the architecture:** [Canonical Documents](/canonical)
83+
- **Explore the architecture:** [Foundations](/foundations)
8484
- **Collaborate:** [Contact us](/contact) or visit [GitHub](https://github.com/Semantic-Infrastructure-Lab)
8585

8686
---

docs/systems/README.md

Lines changed: 46 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# SIL Tools - Stop Wasting Money on Agent Loops
1+
# SIL Systems
22

3-
Production-ready tools demonstrating SIL principles. Use them today.
3+
Production-ready systems demonstrating SIL principles. Use them today.
44

55
## The Problem
66

@@ -11,9 +11,9 @@ AI agents waste billions of tokens (and dollars) on inefficient exploration patt
1111

1212
**Global impact:** Estimated $110M+ wasted annually on preventable agent inefficiency.
1313

14-
## Our Solution: Agent-Native Tools
14+
## Our Solution: Agent-Native Systems
1515

16-
Tools designed for agents from day one, with:
16+
Systems designed for agents from day one, with:
1717
- **Progressive disclosure** - Structure before detail (10x token reduction)
1818
- **Strategic guidance** - When to use this vs alternatives
1919
- **Composable design** - Pipes, JSON output, unix philosophy
@@ -26,20 +26,6 @@ Tools designed for agents from day one, with:
2626

2727
---
2828

29-
## Tools → Innovations Mapping
30-
31-
Some tools implement specific SIL innovations:
32-
33-
- **Reveal** → Implements [Progressive Disclosure](/innovations/progressive-disclosure) innovation
34-
- **Beth** (TIA integrated) → Knowledge graph + PageRank for documentation
35-
- **TIA** → Application workspace applying multiple SIL innovations
36-
37-
Some tools are applications (not innovations themselves) that demonstrate SIL principles in production.
38-
39-
**See also:** [Innovations](/innovations) for innovation descriptions and the inverse mapping
40-
41-
---
42-
4329
## reveal - Semantic Code Explorer ⭐
4430

4531
**The simplest way to understand code.** Point it at a directory, file, or function. Get exactly what you need.
@@ -79,19 +65,54 @@ This pattern will extend across all SIL systems:
7965
- Provenance chains (GenesisGraph)
8066
- Multi-agent reasoning (Agent Ether)
8167

82-
**[Learn more about Reveal](/tools/reveal)** | **[Try it now](https://pypi.org/project/reveal-cli/)**
68+
**[Full Reveal documentation](/systems/reveal)** | **[Try it now](https://pypi.org/project/reveal-cli/)**
8369

8470
---
8571

86-
## More Tools Coming Soon
72+
## More Systems
73+
74+
### Morphogen — Cross-Domain Computation
75+
**Status:** v0.11 | 1,600+ tests | 85% coverage
76+
77+
Unified computational substrate spanning 40+ domains (audio, physics, circuits, CAD). MLIR-based deterministic execution with cryptographic provenance.
78+
79+
**[→ Learn more](/systems/morphogen)**
80+
81+
---
82+
83+
### TiaCAD — Declarative Parametric CAD
84+
**Status:** ✅ Production v3.1.2 | [GitHub](https://github.com/Semantic-Infrastructure-Lab/tiacad)
85+
86+
Parametric CAD in YAML. Semantic constraints, not just geometry. Proof that semantic infrastructure works for physical design.
87+
88+
**[→ Learn more](/systems/tiacad)**
89+
90+
---
91+
92+
### GenesisGraph — Verifiable Provenance
93+
**Status:** ✅ Production v0.3.0 | [GitHub](https://github.com/Semantic-Infrastructure-Lab/genesisgraph)
94+
95+
Cryptographic provenance for every transformation. Selective disclosure lets you verify without revealing everything.
96+
97+
**[→ Learn more](/systems/genesisgraph)**
98+
99+
---
100+
101+
### Beth — Semantic Documentation Search
102+
**Status:** Integrated with TIA
103+
104+
Knowledge graph + PageRank for documentation discovery. Semantic search with relevance ranking.
105+
106+
**[→ Learn more](/systems/beth)**
107+
108+
---
87109

88-
As SIL projects mature, more production tools will be featured here:
110+
### Pantheon — Universal Semantic IR
111+
**Status:** Active research
89112

90-
- **morphogen** - Cross-domain computation (audio, physics, circuits) - *active development*
91-
- **tiacad** - Declarative parametric CAD in YAML - [Production v3.1.2](https://github.com/Semantic-Infrastructure-Lab/tiacad)
92-
- **genesisgraph** - Verifiable process provenance - [Production v0.3.0](https://github.com/Semantic-Infrastructure-Lab/genesisgraph)
113+
Universal Semantic Intermediate Representation (USIR) for cross-domain semantic operations.
93114

94-
See all **[Innovations →](/innovations)**
115+
**[→ Learn more](/systems/pantheon)**
95116

96117
---
97118

src/sif_web/routes/pages.py

Lines changed: 14 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -331,11 +331,23 @@ async def research(request: Request) -> Response:
331331

332332
@router.get("/research/{name}", response_class=HTMLResponse)
333333
async def research_paper(request: Request, name: str) -> Response:
334-
"""Individual research paper."""
334+
"""Individual research paper - handles both flat and subdirectory structure."""
335335
# Map URL name to filename
336336
filename = name.upper().replace("-", "_") + ".md"
337+
338+
# Try root level first
337339
paper_path = Path("docs/research") / filename
338340

341+
# If not found, search in subdirectories
342+
if not paper_path.exists():
343+
research_dir = Path("docs/research")
344+
for subdir in research_dir.iterdir():
345+
if subdir.is_dir():
346+
candidate = subdir / filename
347+
if candidate.exists():
348+
paper_path = candidate
349+
break
350+
339351
if not paper_path.exists():
340352
raise HTTPException(status_code=404, detail=f"Research paper not found: {name}")
341353

@@ -393,52 +405,6 @@ async def canonical_doc_redirect(request: Request, name: str) -> Response:
393405
else:
394406
return RedirectResponse(url=f"/foundations/{name}", status_code=301)
395407

396-
# =========================================================================
397-
# End Routes
398-
# =========================================================================
399-
400-
@router.get("/innovations", response_class=HTMLResponse)
401-
async def innovations_index(request: Request) -> Response:
402-
"""Innovations index - Major projects and systems."""
403-
return render_markdown_page(
404-
request,
405-
Path("docs/innovations/README.md"),
406-
"Innovations - Semantic Infrastructure Lab",
407-
"/innovations",
408-
)
409-
410-
@router.get("/innovations/{name}", response_class=HTMLResponse)
411-
async def innovation_page(request: Request, name: str) -> Response:
412-
"""Individual innovation/project page."""
413-
# Map URL name to filename
414-
filename = name.upper().replace("-", "_") + ".md"
415-
doc_path = Path("docs/innovations") / filename
416-
417-
if not doc_path.exists():
418-
raise HTTPException(status_code=404, detail=f"Innovation not found: {name}")
419-
420-
content = doc_path.read_text()
421-
422-
# Extract title from first H1
423-
title = f"{name.replace('-', ' ').title()} - SIL"
424-
for line in content.split("\n"):
425-
if line.startswith("# "):
426-
title = line[2:].strip() + " - SIL"
427-
break
428-
429-
html_content = markdown_renderer.render(content)
430-
431-
return templates.TemplateResponse(
432-
"page.html",
433-
{
434-
"request": request,
435-
"title": title,
436-
"content": html_content,
437-
"nav_items": nav_items,
438-
"current_page": "/innovations",
439-
},
440-
)
441-
442408
# =========================================================================
443409
# Founder's Letter (Legacy URL support)
444410
# =========================================================================
@@ -448,7 +414,7 @@ async def founders_letter(request: Request) -> Response:
448414
"""Founder's Letter - direct access."""
449415
return render_markdown_page(
450416
request,
451-
Path("docs/canonical/FOUNDERS_LETTER.md"),
417+
Path("docs/foundations/FOUNDERS_LETTER.md"),
452418
"Founder's Letter - Semantic Infrastructure Lab",
453419
"/",
454420
)

0 commit comments

Comments
 (0)