Skip to content

Documentation

Welcome to the fishbowl documentation.

The Unix() entry point:

*
* Internal files MUST NOT import this barrel (cycle risk — the barrel
* imports `UnixBuilderImpl` from `builder.ts`, which would self-loop).
* Use direct module imports inside `src/`. Runtime symbols have moved
* to `@fishnet/runtime`; import boot helpers from there. See
* `docs/architecture/runtime/README.md`.

Extension Type (first 10 lines of types.ts)

Section titled “Extension Type (first 10 lines of types.ts)”
/**
* Fishbowl type system — every contract in the kernel and its direct protocol
* surface (fileservers, procs, signals, branded primitives).
*
* Types only — no runtime imports from implementation files. Consumer layers
* (fileservers, proc, runtime) implement these interfaces; public re-exports
* from `index.ts` flow through this file so the package's external surface
* stays one hop from this source of truth. Architecture specs under
* `docs/architecture` reference these definitions verbatim — keep names and
* invariants in sync when revising.