Skip to content

foundryside-dev/weft

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

97 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Weft

Weft is one product, positioned as one seam supported by a suite of products (owner ruling, 2026-06-15). The seam — the shared SEI identity spine + the honest, hub-blessed joins between members — is the hero; the members are a supporting, open-ended suite. The value is the glue: that identity spine, the seams (the joins — the crown jewels), and the cross-cutting quality conventions, chief of them provenance-honesty. The suite currently comprises Loomweave, Filigree, Wardline, Legis, and Warpline — a roster snapshot, not the identity: it is designed to grow (weft-the-app and daughter members are coming, PDR-0024). The count is never the thesis; the seam is.

This README is orientation, not canon. It is the "what do you need to know" onboarding standard — it gets you to the right authoritative doc fast. doctrine.md is the authoritative federation canon (the roster, the composition law, the seam-governance posture, and the honesty invariant); when this README and doctrine.md ever differ, doctrine.md wins. This folder (~/weft) is the source of truth for federation-wide interoperability — but the authority for each topic lives in its named domain owner (below), not in this entry page. It is documentation only: no code, no runtime, no store. There is nothing called "Weft" to install or run.

The federation is the product (PDR-0023, 2026-06-15). The unit of value is the federation, not the member; the members are components/proof-points. The seams are the crown jewels — a broken join is the product broken. Provenance-honesty is a protected invariant and a hard admission gate (no result without its cause + reason_class + fix — the weft-reason contract, owner-blessed 2026-06-15; doctrine.md §10, federation-sdk.md I-4). The federation framing is hub blesses every seam: members keep autonomy over their own jobs, but every cross-member interaction is hub-authored — "enrich-only" is now a per-seam property, not the headline. (Candidate, not yet canon: PDR-0024's fleet-OS frame — doctrine.md §11.)

Canon is split by domain (resolved 2026-06-06 — conflict-register.md §B-6): doctrine.md owns the roster/membership/composition-law and the honesty invariant (§10), SHIPPING.md owns release posture/gate, contracts-index.md owns the contract index. This README, federation-map.md, and compatibility.md are derived views that point to the domain owner, not competing canon.

As of 2026-06-05 this hub was rebuilt to be authoritative. It previously drifted badly (wrong roster, stale versions, wrong identity model). The fix is structural — see The authority model below — and every conflict found is recorded in conflict-register.md.

The roster

Member Repo Lang Domain authority Briefing
Loomweave ~/loomweave Rust Code structure + identity authority (SEI) members/loomweave.md
Filigree ~/filigree Python Work state / issue lifecycle members/filigree.md
Wardline ~/wardline Python Trust-boundary analysis members/wardline.md
Legis ~/legis Python Git/CI governance & attestations members/legis.md
Warpline ~/warpline Python Temporal / change-impact authority members/warpline.md

Planned integration: Charter (~/charter, Python — requirements, traceability, verification) has a realized local core and a read-only MCP surface, but its federation adapters are still pending, so it is not yet a full member (see doctrine.md §1 and members/charter.md).

Not members, but part of the story:

  • Shuttle — a roadmap thought-bubble for a future change-execution authority. No repo; lowest priority; displaceable by any better idea.
  • Lacuna — the deliberately-flawed demonstration specimen the suite is run against.
  • roadmap-ideas.md — a bench of speculative sub-app candidates (incl. Shuttle). Ideas only; none are members until they pass the go/no-go test.

Excluded entirely: wardline-watcher, wardline.old, weft.old (the defunct heavier builds).

The authority model (why this hub stays accurate)

The hub drifted because it restated project-internal facts that move (versions, tool counts, rule lists, routes). The rule that prevents recurrence:

Audit invariant: weft contains no restated project-internal fact without a pointer; every federation-pattern doc in every member repo resolves to weft.

Where to look

  • New here? doctrine.md (the federation law) → federation-map.md (how they compose) → the member briefing you care about.
  • Building a cross-tool integration? contracts-index.md (points to the authoritative schema in the owning repo) + sei-standard.md (identity is the spine).
  • Building your own tool to drop into the federation? federation-sdk.md — the member-builder's interface contract: the conformance spine, every interface surface, and the oracle gate.
  • Pre-release conflict flush? conflict-register.md — walk Class B before any point release.
  • Shared vocabulary? glossary.md. Documented axiom violations? asterisk-register.md.
  • How it ships / launch & go-to-market? SHIPPING.md (PM-decided 2026-06-05) + compatibility.md (integration-liveness now; version matrix at 1.0).
  • How this doc set is organized & governed? MANIFEST.md.

Federation axiom (the one sentence)

Each member is authoritative for one domain, solo-useful, meaningfully composable pairwise, and enrich-only — never load-bearing — when composed. (doctrine.md §5.)

About

Weft Federation — agent-first family of small, local-first developer tools (filigree · clarion · wardline · legis · charter)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors