Skip to content

feat: add .topos/ extensions directory with structured experimental work#46

Closed
bmorphism wants to merge 1 commit intomainfrom
consolidate/core-plus-topos
Closed

feat: add .topos/ extensions directory with structured experimental work#46
bmorphism wants to merge 1 commit intomainfrom
consolidate/core-plus-topos

Conversation

@bmorphism
Copy link

Summary

Adds .topos/ as a well-organized extensions directory containing experimental work, structured specifically to help AI agents navigate and understand the design space.

Directory Structure

.topos/
├── README.md           # Start here - directory overview
├── AGENTS.md           # Agent navigation guide with decision tree
│
├── syrup/              # OCapN/Syrup Protocol (Spritely-compatible)
│   ├── syrup.ts        # Core Syrup serialization
│   ├── ocapn-server.ts # OCapN capability server
│   ├── captp-session.ts
│   └── skill-capability.ts
│
├── src/                # Extended modules (not yet in core)
│   ├── fleet/          # Multi-VM coordination
│   ├── math/           # GF(3) algebra + formal verification
│   └── shared/         # Cross-module utilities
│
├── verification/       # Formal proofs
│   ├── *.dfy           # Dafny specs
│   └── rocq/           # Rocq/Coq proofs (SplitMix64, QuadBalancing)
│
├── docs/               # Design documents (26 files)
│   ├── ACP-*.md        # Protocol extensions
│   ├── CHELSEA-*.md    # VM integration
│   ├── DAFNY-*.md      # Verification mapping
│   └── GF3-*.md        # Triadic analysis
│
├── experiments/        # Runnable experiments
│   └── nbb/            # Node Babashka ClojureScript
│
├── dockerfiles/        # Extended Docker configs
├── fleet-config/       # Fleet deployment
└── polyglot/           # Multi-language GF(3) implementations

Agent Navigation

See .topos/AGENTS.md for:

  • Decision tree for finding relevant code
  • File importance ranking
  • Key patterns and integration status
  • Quick commands

Key Extensions

Module Purpose Status
syrup/ OCapN capability protocol Working, needs CapTP completion
src/fleet/ Multi-VM coordination Prototype
src/math/ GF(3) skill balancing Complete
verification/ Formal proofs Dafny done, Rocq WIP

Why Include This

  • Preserves context: Experimental work informs core development
  • Agent-friendly: Structured with README + AGENTS.md for navigation
  • Progressive integration: Extensions can be promoted to core as they stabilize

Closes previous PR #45 (superseded)

Introduces .topos/ as a well-organized extensions directory containing:

## Structure (see .topos/README.md and .topos/AGENTS.md for navigation)

### syrup/ - OCapN/Syrup Protocol Implementation
- syrup.ts: Core Syrup serialization (Scheme s-expressions)
- ocapn-server.ts: OCapN capability server
- captp-session.ts: CapTP session management
- skill-capability.ts: Capability-based skill access

### src/ - Extended Modules
- fleet/: Multi-VM fleet coordination
- math/: GF(3) algebra with formal verification
- shared/: Cross-module utilities

### verification/ - Formal Proofs
- Dafny specs for GF(3) conservation
- Rocq/Coq proofs for SplitMix64, QuadBalancing
- Multi-language test targets (Go, Python, C#)

### docs/ - Design Documents
- ACP protocol extensions
- Chelsea VM integration plans
- Security analysis (ReDoS, etc.)
- Multi-VM architecture

### experiments/ - Runnable Experiments
- nbb (Node Babashka) ClojureScript interop
- Polyglot GF(3) implementations

### dockerfiles/ & fleet-config/
- Chelsea, Flox, Security Docker images
- Fleet deployment configurations

This directory is structured specifically to help AI agents
navigate and understand the design space for vers-agent extensions.

Amp-Thread-ID: https://ampcode.com/threads/T-019bcf76-5f6b-70dd-861f-ba11af380a01
Co-authored-by: Amp <amp@ampcode.com>
@AlephNotation
Copy link
Contributor

No 36k line prs

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.

2 participants