Skip to content

Latest commit

 

History

258 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kinbase

Kinbase is the company-memory member of a three-product Kindex system. Its site is kinbase.tools and it is a Wander project.

  • Kindex Personal remembers private conversations and personal context.
  • Kinbase / Kindex Company carries organization-wide architectural and operational knowledge into every authorized coding task.
  • Kindex Codebase carries repository-specific knowledge in Git under .kin/.

Kindex is the individual and codebase index and ships today. Kinbase is the corpus above it: a company's engineering direction, architecture, standards, ownership, and history, held by named authorities and composed into every coding session. Same engine, same protocol, physically separate stores.

A coding agent dropped into an unfamiliar repository lacks the constraints and rationale a long-tenured engineer carries. Kinbase captures that context from conversations, code, Git, tests, operations, and named authorities; keeps it current; and supplies the smallest decision-relevant set without copying private notes into Company or repository state.

This repository is a proof of the concept, not a boundary-shaped prototype. It passes only if the running system ingests heterogeneous evidence, maintains the three corpora, discriminates durable direction from recent noise, asks the proper human authority when evidence is insufficient, routes atoms without private-data leakage, and materially improves independently judged brownfield implementation quality to within the preregistered fully-informed oracle-spec margin—the valid operational test of the founder's greenfield-quality goal.

Current status: exact-byte specification ratified; isolated Coder and Tester dispatch in progress; the concept remains unproven. Two candidate amendments are in review and are not authority until ratified:

Reading order:

  1. spec/README.md — map, vocabulary, and authority order;
  2. source-request.md — what the founder actually asked;
  3. product.md — observable behavior and proof thresholds;
  4. architecture.md — ownership, boundaries, and mechanisms;
  5. threat-model.md — the finite, qualified disclosure claim;
  6. verification.md — independent tests and experiment;
  7. behavior-ledger.md — source-to-oracle traceability;
  8. cli.md — concrete user/configuration contract;
  9. glossary.md — terms;
  10. review-rubric.md — what reviewers optimize for;
  11. leak-runbook.md — containment and apology process;
  12. the candidate amendments above.

Public documentation lives in docs/, published by GitHub Pages: an overview, the proof conditions in plain words, the amendment register, and llms.txt for agents. The canonical marketing site and its privacy notice live in the separate Kinbase-Tools repository and are served at kinbase.tools; docs/ links to them and never duplicates them.

Status

The frozen black-box acceptance suite passes in full: 371 nodes, 0 failures, run 2026-09-09 against product f7696c5 and instrument f571517. Every product gate is green — V-1 through V-10, nonfunctional, and evidence.

The brownfield outcome experiment has not run. The terminal verdict is therefore not PROVEN. A green suite is necessary and insufficient: it shows the system does what the specification says, not that it helps anyone ship code. If the blinded brownfield experiment does not meet its outcome threshold, the concept is not proven.

Start with evidence/factory-run/validator-verdict-2026-09-09.md. It states what this run proves, what it does not, which gates the instrument itself fails, and where the independence between the building and certifying seats is real and where it is not.

Building and running

cargo build --release --offline --locked
./target/release/kinbase --help

Dependencies are exact-pinned; rust-version is set in the workspace manifest. The build is offline and lockfile-exact. It is not byte-reproducible across directories, because the release profile keeps debug info and so embeds absolute source paths.

tests/ is the acceptance suite — the oracle. It was authored by a separate lane that never saw the implementation, and it is published so the claim above is checkable rather than asserted. It carries its own answer key, which is the cost of making it checkable.

About

Kinbase (developed as Guildhall): the Company product of the Kindex system. Specification and proof of concept.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages