@werk/loom (0.1.2)
Installation
@werk:registry=https://gitlab.amandy.love/api/packages/werk/npm/npm install @werk/loom@0.1.2"@werk/loom": "0.1.2"About this package
loom
Unified Bun workspace monorepo for the Loom, Facet, and Nerve ecosystem.
Structure
packages/loom/*: runtime/foundation packages (@loom/*)packages/facet/*: UI framework packages (@facet/*)packages/nerve/*: search/retrieval/memory packages (@nerve/*)apps/*: executable apps and integration shellstools/*: maintenance and migration utilitiesdocs/*: architecture and migration documentation
Run Deck (workbench)
bun install
bun run deck # http://localhost:10000
bun run deck:dev # watch mode
Deck lives in apps/deck and consumes workspace packages (@deck/runtime, @facet/*, @loom/* via runtime).
MCP / Agent Integration
@loom/mcp exposes workspace, analysis, Nerve, and Deck runtime tools over MCP stdio (read-only by default).
bun run mcp:start # MCP server (stdio)
bun run mcp:list # list tools
bun run mcp:config # client config snippets (Cursor, Gemini, generic)
bun run skills:sync --package @loom/mcp
See packages/loom/mcp/README.md for safety flags and tool reference.
Dependency Policy
This ecosystem strictly enforces dependency minimalism to ensure stability, fast cold starts, and easy migration:
- Prefer zero external runtime dependencies.
- Prefer Bun/Node built-ins whenever possible.
- Prefer workspace packages over external alternatives.
- External dependencies require explicit justification.
- Live AI/Network requests are never part of default tests.
- Generated tooling or agents must not casually add packages.
Migration notes
This repository is an incremental structural migration. Source systems were moved with minimal rewriting to preserve behavior, tests, and existing project identity.
The ecosystem now integrates core concepts from the legacy Fox-Issue project, providing file-centric guidance and enhanced issue lifecycle management for AI-driven development.
Dependencies
Dependencies
| ID | Version |
|---|---|
| blessed | ^0.1.81 |
Development Dependencies
| ID | Version |
|---|---|
| @types/node | latest |
| bun-types | latest |
| typescript | ^6.0.3 |