Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

126 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

Packages

Contributors

Languages