kwant

Docs

Truth Ledger: one list of facts, and you settle the conflicts

Bots remember things: a server's size, where the release checklist lives, which branch deploys. When two of those notes disagree, a bot can't know which one is right. With the Truth Ledger on, kwant notices the conflict, labels both sides, and asks you to decide.

On, or off

The Truth Ledger is new in 0.6 and on from 0.6.5, also on installs that never changed it. A choice you saved is kept. With it off, bots see exactly what 0.5.1 showed them, byte for byte. There's no switch in Settings yet: change it from the computer kwant runs on, with the address and port you use for kwant:

curl -X POST http://127.0.0.1:8799/api/settings \
  -H 'content-type: application/json' \
  -d '{"truth_ledger": "on"}'

From another machine, or with Docker, also send your token: add -H "Authorization: Bearer YOUR_TOKEN", where kwnt token --raw on the kwant computer prints the token. Only you can change it: a bot is refused. Send "off" to switch it off. Facts and open conflicts are kept for when you turn it back on.

The facts list and conflicts show on the Mission board, so switch that on too.

What bots read

  • Their own notes, as before, but only notes still in force: a note you rejected, or one that was replaced, drops out.
  • What your team knows: facts shared with a bot's team or the whole space, once you've accepted them.
  • Labels. A note a bot wrote after reading a web page, a file or another tool is Unconfirmed until you confirm it. A note in a conflict is Disputed. Bots see the label next to the note, so they know to treat it with care.

Bots can propose a fact for their team or the whole space. It waits as Unconfirmed until you confirm it, and a bot can't propose one in a turn where it read outside text.

When two facts disagree

kwant compares facts as they're written: two facts about the same thing that carry different numbers ("4 GB" vs "16 GB" of RAM), or where one says the opposite of the other, are flagged. The board shows both side by side, with why they clash.

The Mission board's Facts section: "Needs you: one dispute to settle". Two facts disagree: "The production server has 16 GB of RAM." and "The production server has 4 GB of RAM.", each with a Keep this one button, and a Not a conflict button. Below, the facts list with In force, Unconfirmed and Disputed filters.
Until you choose, bots see both facts, labelled disputed.
  • Keep this one keeps that fact; the other is replaced by it.
  • Not a conflict keeps both, and that pair isn't raised again.
  • A task that relies on a disputed or changed fact moves to Needs you and says so.
  • If one side is backed by a check kwant ran and passed, and the other isn't, kwant can settle it on that evidence. Evidence never overrules a fact you wrote or a decision you made.

The check is simple and fast, not an AI judgement: it misses conflicts said in different words ("Deploys happen on Fridays" vs "We never ship on Friday"), and can flag two facts that don't really clash. Dismiss those once with Not a conflict.

The facts list

Under the conflicts, Show facts lists the facts in force. Filter by Unconfirmed or Disputed, and open Details to see the tasks that rely on a fact, its evidence and, if it expires, when bots stop reading it. Unconfirmed facts have Confirm and Reject.

Only you can confirm, reject or settle facts. See also Memory.