Recording work see history edit this page

Talks about: , , , and

You record evidence. Stages follow.

Create a ticket

tik new support-request --title "login fails on Firefox"

The ticket pins the process definition’s content hash at creation, so it is judged by the rules it was minted under until somebody deliberately moves it with tik reprocess.

Created beneath a store, a ticket inherits its context as signed facts: repo=<name> from the enclosing git repository, plus any .tik-facts.edn maps on the way down, nearest winning, with anything explicit beating both.

Assert facts

tik set 3184 severity=:high resolution.ref=abc123def456

Dotted keys nest, so parked.reason="waiting on legal" writes the path [:parked :reason]. Values parse as EDN, and a bare word becomes a keyword — severity=high and severity=:high mean the same thing, which keeps facts out of the swamp of free-form strings.

Links are facts too:

tik set 3184 link.depends-on=9c21f0a4

tik next then holds 3184 back while 9c21 is unsettled, and tik status names the blocker.

Attach evidence

tik attach 3184 ./crash-repro.sh
tik comment 3184 reproduced on a clean profile, video attached

Artifacts are stored by hash. A comment is an artifact too — a text blob attached by its digest — which is why comments need no event type of their own.

Correct the record

Nothing is edited or deleted. Corrections are new events:

tik set 3184 severity=:critical              # supersedes; history retained
tik retract 3184 resolution.ref --reason "wrong commit"
tik dispute 3184 category --reason "this is billing"
tik dispute 3184 category --withdraw         # take back your own objection

A later assertion supersedes an earlier one. A retraction says the claim should not exist and offers no replacement. A dispute rejects the value that stood when it was raised, so only a different value answers it. In every case the stage regresses by derivation — there is no rollback step.

Signed claims and attestations

tik attest 3184 {:ci :green}

An attestation is a signed claim whose meaning the kernel does not interpret. Lenses read it, and the :attested-within guard checks that a fresh-enough one exists — a replayed “CI green” from last month is cryptographically valid and fails that guard honestly.

Review in one batch

tik review review.verdict=approved --list
tik review review.verdict=approved

A reviewer’s queue is mostly signatures over work somebody else already recorded: a merge commit an agent asserted, a definition nobody has published yet. tik review lists everything that waits on you alone and signs it after one confirmation, or without asking when you pass --yes.

A ticket is offered when every reason its next stage gives is either your signature on a fact already on record or a fact you pass as k=v. Approving re-asserts each recorded value exactly as it stands, so the signature names the commit or hash it covers, and the list shows every value before you confirm. A dry run must show the stage landing and no reached stage lost, otherwise the ticket is left for a manual tik set. A fact the ticket’s process does not declare is ignored, so one verdict can serve several processes at once.

Arguments without = narrow the batch to a process name or a ticket id prefix. Publishing a definition needs a key, given with --key or TIK_KEY.

Derive facts from the world

tik probe 3184

A probe is any executable that prints key=value lines. It runs with its working directory in the ticket’s [:repo] repository, and changed values land as ordinary signed facts, so a ticket regresses on its own when reality does. The environment carries TIK_TICKET, TIK_REPO, and every present fact as TIK_FACT_<PATH>, which is what lets one repository hold many subjects — a package, tenant, or workload per ticket.

Recurring and bulk work

tik recur weekly-review --period 2026-W32
tik rollout dependency-audit --parent-title "Q3 audit"

recur mints this period’s ticket exactly once: it creates only when no ticket already carries that period label. The schedule lives outside the log — run it from cron or a timer — and tik derives whether the period exists yet. rollout creates one ticket per git repository under the store, wired to a parent by link facts, so the parent is a checklist whose checkmarks derive from each child’s evidence.