Vocabulary
The words spoken here, and exactly what they mean - and do not.
Its own words
canonical form
The one way a table's file is written - compact JSON lines, declared field order, empty as null, rows in their order - so a change reads as one line.
Not: pretty-printed JSON; sorted keys (each would turn one change into many lines)
declaration
A repository's tables as data in tables.toml: fields, types, rules across tables, and how pages read.
Not: schema (SQL's word: a schema in SQL needs a database to mean anything)
named statement
SQL a place keeps as a file beside its tables, with typed parameters declared in its leading comment - a query or a record.
Not: stored procedure (lives in the engine), prepared statement (a session's, not a file's), script, macro
presentation
How a repository's pages read, declared in tables.toml: the index, introductions, groups, order, labels, relations in words.
Not: template, theme (they suggest code or style, not what the page says)
query
A named statement that reads: queries/NAME.sql, run with tad query NAME (tad q); one that would change a table is refused.
Not: select, view (a view is stored in the engine; a query here is a file beside the data), report, lookup
record
A named statement that writes: records/NAME.sql, run with tad record NAME (tad r); what it writes is kept only if every rule still holds. The word is also what it leaves: a record in the data.
Not: command, mutation (GraphQL's word), procedure (stored in the engine), write, change, run, exec
rule across tables
A rule that needs more than one table: ids unique across tables, a reference that must resolve, every row cited, no mirrored relation.
Not: foreign key (SQL's word, and narrower: no citations, no mirrors)
The shared words (ocoeco)
about
The thing a line, a record or a decision speaks of.
action
What was done by hand, in a few words.
activity
What happened in a repository, day by day, as gathered there by its own work.
advances
What a record of work moves toward - an item, a milestone. More and more it is read off where the record was made, and not said.
after
What this follows: the turn before a turn.
allowed
The values a field may hold, where it may hold only some.
along
How far along a chain a line is: the first not at all, what follows it one further.
also
Other names the same one goes by.
always
Whether a part is shown whatever it brings, with no heading of its own.
answers
The reflection this one answers.
asks
What a person is asked for when making an entry: the fields only they know.
at
When it happened, to the second: a moment.
Not: A day alone: that is a date.
attention
Where the whole is weakest right now, read from every project's data, to choose the next piece of work.
Not: Whatever is loudest.
See: essence, observatory
automated_by
What does it now, where it is no longer done by hand.
backlog
The items of a place: what is to be done, is being done, was done.
beats
Each beat says a driver is still at work, and keeps their lease on the lab alive.
breaking
Whether a change breaks what relied on things as they were.
by
Who did it - a person, an agent, or a program acting by itself - by the name they go by.
bytes
How long a file is, in bytes.
chain
The two values of an answer that say which follows which: a part laid out as chains, each line beneath the one it follows.
change
One landed piece of work: a branch, one squash commit on main, and its record.
Not: changeset (a bundle in Knope, one file in changesets - two meanings); commit (git's unit; a change may take many)
changes
What will be done otherwise from now on.
commits
The changes to a place's repository, as git has them: each by its name, when, by whom, and what it says of itself.
concept
An idea a project rests on, with why it matters.
Not: What a word means: that is the vocabulary.
See: decision, vocabulary
concepts
The ideas a place works with, each said once.
conclusion
How a run ended: it succeeded, it failed, it was cancelled.
connection
How one thing bears on another, found by looking: this led to, needed, halted or repeats that - with why, and how it is known. It runs between two particular rows, of any tables, in any stars. Connections on one thread are a red line.
Not: relation (declared once for a whole table: a decision may refine a decision); link (how a row is pointed at, in any field); edge, arrow (words of the drawing, not of what is meant)
See: lens, projection
connections
What bears on what: one thing led to, needed, halted or repeats another - with how that is known.
considered
What was weighed, and not done.
constellation
A place of its own that keeps what holds between its stars: its mark says it is a constellation and what it gathers - stars by name, or every star of an owner; a star may be in many. Standing in it, the fulldome shows the constellation. The four stars once of kind lens are constellations: Linux Phones, Rhizome, Mnemonic Vocabulary, Linux package distribution.
Not: observatory (looking, not belonging); organization (GitHub's word); the earlier use of lens for a group of projects
conveyor
A shared process that carries work from one state to the next - built, tested, delivered - which projects call, not copy.
Not: A template to copy.
See: workings
count
How many times something has been done by hand so far.
countermeasure
A field of signs from before they were called signs: what was done about one. Not said now - what comes of a sign is drawn as a connection, and read off.
Not: How signs are spoken of: nothing is countered; the whole is refined.
criteria
What a milestone rests on: each a thing that must be so for it to be reached.
curated
Chosen by the observatory's keepers to stand in its navigation. Any lens can still be found without it.
Not: Approved or owned.
See: lens
cutting
An owned fork of someone else's code (Rhizoid's rhizcut): pinned to an exact upstream point, changed only as named patches each written to go home.
Not: A divergent copy.
See: conveyor
date
A day: year, month and day.
Not: A moment: that is at.
dated
Which of a table's fields says when a row happened.
decided
The decision in which a word was chosen over others.
decision
A choice taken, with why, and with what was rejected.
Not: A plan or a wish.
See: concept
decisions
What was decided, each with why, and what was weighed and not chosen.
depth
How deep a row is among lenses placed within lenses.
description
What a named thing is or asks, in a sentence: of a practice of the canon, what it says to do.
Not: A field nothing says: the canon's practices say it, and the lens of practices shows them beside the observatory's own.
documents
What a place has written down, as files meant to be read.
dome
What a star's shine can be focused onto: the one thing every surface must be able to do - lay out what a lens brought into focus. The core term; plain text, a terminal, Markdown, HTML and CSS, and whatever someone makes later are surfaces - each a dome made real. A lens knows of no surface.
Not: surface (a surface is one dome made real: the dome is what they share); screen, page, output (each names one surface); renderer (a graphics word, and it names a doer where this names what is done upon)
done
What was done.
driver
Who is doing it now: a person or an agent, by the name they go by.
edges
Every pointing between the things in view: from what, how, to what, and whether it holds.
effort
Minutes weighted by how draining they were (load 0-10, Borg CR10): five counts as one. A short heavy chore can outweigh a long light one.
Not: Time alone.
See: manual work
entry
A way to add a row by saying only what a person knows: the rest is supplied, and the row is held to its shape.
entry_date
The day a session wrote its log.
essence
A project's whole chain on one page: why it exists, what it must reach, how each step is delivered and proven, what is happening now.
Not: A summary.
See: idea, path, workings, work
evidence
What shows that a working works: where it was seen to.
extra_fields
Whether a row may carry more than its table declares: a table declared as a minimum.
field
One named value a row carries.
fills
The table an entry adds a row to.
first
The day something was first done by hand.
flow
What is happening, as one: everything in view that says when, in the order it happened - whatever kind of thing it is, wherever it is held.
Not: A list kept by someone: it is read off what each thing says of when.
focus
The second face of a lens, and the act: a lens lets data through and brings it into focus - ordered so it can be made out - as Markdown files, HTML and CSS, a terminal, anything. Nothing is made: the same data comes into focus. What is seen is on the fulldome.
Not: show, showing (a lens shows nothing: it lets light through); render (a graphics word, from outside the family); resolve (links resolve, and people resolve problems); image (already means a disk or system image here); project, projection (project is the word star replaced); reveal (plain, but not what a lens does)
for
Who something is for.
found
What a piece of research found - and what was taken from it, and what was not.
from
Where a pointing begins: the thing that points.
from_holds
For a pointing said by a connection: whether its near end is there as well.
from_id
The id of the thing a pointing begins at.
from_place
The place of the thing a pointing begins at.
from_star
The star of the thing a pointing begins at: its place, by its short name.
from_table
The table of the thing a pointing begins at.
from_written
For a pointing said by a connection: its near end, as written.
fulldome
Every lens, in focus, on a dome: the lens that focuses all lenses onto all their surfaces. The same at every scale - a star's, a constellation's, an observatory's - and on every surface; touched, not watched.
Not: board (one lens: the flow of work); room, wall; a lens beside the others (it holds them); a show to sit through
gatherer
A small daily job in each project that writes down what its work produced: commits, releases, test runs.
Not: A person keeping records.
glimpse
The part of a lens through which data is taken in: it says the data's place and relations, and how it is entered with ease - what is already there is not retyped, what the computer can supply is not asked. Also a thing so taken in: one row. ocoeco glimpse brings every lens's glimpse together - their subcommands and flags, declared, so that two cannot collide unnoticed: a collision is found when ocoeco is built, never in use. One lens has one glimpse, which may hold several kinds of entry. The word first named (2026-11-11) only the record of work done: that is the glimpse of the lens of work.
Not: note (the earlier way, table by table: one had to know the tables and fields); record (plain, but names nothing one can point at); form (says nothing of looking); pulse (oco-agent's sign of life)
glimpses
Records of work: each a moment of work done, in one line, with where it was made.
grew_from
The lens a lens grew out of.
guards
The tests of a program, each by what it says it holds.
handled
Whether a sign has come to something. Read off what came of it, where that is drawn.
harvest
The observatory's reading of every marked project's tables, every few hours.
Not: A copy of the projects.
See: observatory, mark
has
What a surface or a place has: what one finds on getting there.
heading
The few words a part of an idea goes under.
holds
Whether a pointing holds: what it points at is there, in a place in view.
horizon
One of the three stretches of a path: working (it does its job), perfection (as good as it should be), ongoing perfection (it stays so).
Not: A deadline.
See: path
how
The way one thing bears on another, in the words of the link itself - led to, needed, halted, repeats - or the name of the field that holds the pointing.
id
What a row goes by within its table. With where it is held and its table it names one thing: place/table:id.
Not: A number a machine hands out: an id is words one can say.
idea
Why a project exists, written by the project itself for someone who knows nothing about it.
Not: A feature list, or a summary for insiders.
See: essence
inset
Whether a line sits beneath a heading.
job
The job a row of the journal is about.
journal
What oco-agent wrote of each job, as it happened.
kept
What was found, in what the places keep, of the shapes that are to be kept out - and whether each is showing.
kept_out
What a place says is to be kept out of view, by the shape each is told by.
key
Which field names a row within its table.
kind
Which of a few named sorts a row is. Each table says its own sorts, and a row is of one.
known
How a connection is known: measured, recorded, or only said.
lacks
What is lacking for a surface to be read, or for a thing to be whole.
last
The day something was last done by hand.
lays_out
How each answer of a part is laid out as a line: words, with a name in braces where a value goes.
learned
What was understood from what was seen.
lens
A way of seeing, and the concrete mechanism for it, with two faces: its glimpse catches data - the data's place, its relations, and how it is entered with ease - and its focus brings it into view, as a structure of Markdown files, HTML and CSS, a terminal, anything. A lens shows nothing by itself: it lets the data through, ordered. It is made once and used by anyone in ocoeco, in their star or constellation: the data and its structure are known, so it just works. One lens defines a piece of data; many may read it. A lens may be made of lenses.
Not: view (SQL's word for one query); dashboard, report; plugin (it adds no code path of its own to a star)
See: observatory, curated
lens_entries
The entries the lenses declare, as rows: each a way to add a row by saying only what a person knows.
lens_fields
The fields of the tables the lenses declare, as rows.
lens_parts
The parts of the lenses, as rows: each a question and how its answers are laid out.
lens_relations
The relations the lenses declare, as rows: which fields hold pointings, to what, and what each is.
lens_routes
The routes the lenses declare, as rows: which tables are read from a surface, and how.
lens_tables
The tables the lenses declare, as rows: the language, read as data.
lenses
The lenses there are, each by what it says it shows.
level
What a pointing asks of the thing it points at, beyond that it is there - a feature at its best, say: written after a mark at the end of the link.
line
Which line of a file something is on.
lines
How long a file is, in lines.
load
How draining an action was this time, from 0 (nothing) through 5 (hard) to 10 (maximal), after Borg's CR10 scale of perceived exertion.
Not: How long it took: that is minutes.
See: effort, manual work
looks_from
Said by a lens that looks from a thing: the kinds of thing it looks from - their tables. From a thing of another kind it is not asked.
manual work
An action done by hand that a tool could do: counted with its minutes and load, and when it was done, until something automates it.
Not: Bad work: it is a measure of where a tool would help, not a judgment.
manual_events
Each time something was done by hand, and what it took.
manual_work
The kinds of work done by hand, each with how often it has been.
mark
The small file (oco.toml) by which a repository says: I am part of the commons, and here are my tables.
Not: A badge someone else gives.
may_run
How long a job may run once it is started, in seconds.
means
What a word means here: one meaning, said plainly.
measure
The value of an answer that says how much, of a whole. A meaning, shown by each surface its own way.
milestone
A step on a path, reached only when its evidence exists.
Not: A date or a promise.
milestones
What a place reaches for, each with what it rests on.
minutes
How long it took, in minutes.
moment
When something happened, to the second. A day is when to the day; both are words that sort in time.
name
What something is called by people. A place's name says what it is for, after its own name and a colon.
named
The name a part's shape goes by, for other parts and other lenses to ask of.
nature
What a pointing is, whatever its field is called: rests on, is for, follows, is about, places, is seen through, gathers, is part of, fills.
needed
Whether a row must say it.
next
The next step toward an item, in words: what to look at when it is taken up.
Not: A promise, or a state: working toward a step is not the step done.
not
What a word does not mean here, where it could be taken for it.
note
What is worth knowing of an item that its other fields do not say, added to as it goes.
nth
Where a line comes in its part: first, second - and a heading is the 0th.
observatory
A place for someone's looking: it gathers the constellations, stars and other observatories its owner cares to see. They do not belong to it and need not know of it. Anyone can have one.
Not: constellation (belonging, not looking); the one observatory (there are many); OCO (the ecosystem)
observer
The part of ocoeco that observes: it finds places by their marks and gathers what they keep - the same act whether a constellation gathers its stars or an observatory gathers constellations and other observatories. It brings the data and the names of the lenses; a render already made may be taken as it is.
Not: observatory (a place; the observer is an act of ocoeco); harvest, discover (its earlier names: a farm's word and a search's)
OCO
The ecosystem that lets anyone keep stars, show constellations and have an observatory: the agreement and its tools - ocoeco, tad, oco-agent, the lens tool. Not an observatory itself.
Not: the author's observatory (one of many, made with OCO); open commons (the principle, wider than OCO)
ocoeco
The commons' language and machinery: the tables, the mark, the gatherers and the checks - the blood and heart every project lives by.
Not: The observatory's website.
See: observatory, vocabulary
of
The whole a measure is of, where it is the same for every line.
of_all
The whole a measure is of: its other half.
of_every
Whether a lens was placed in a plane as one of every lens in view, and not by its name: what a place puts first it places by name, and every other follows.
of_lens
The lens placed within a plane that a row opens.
of_part
How many lines the part a row belongs to has.
of_table
The table a thing is a row of.
only
Which part of a placed lens is placed: the one under this heading.
opened
The day an item was first said.
ord
Where a row comes among its fellows: first, second, third.
ordinal
Where something comes among its fellows, said as a number: a field among the fields of its table, a part among the parts of its lens.
outcome
How a job ended.
over
What a reflection looks back over.
page
Where the page is for the thing a line is about, while a site is laid out.
part
One shape a lens brings into focus: a question asked of its tables, and how each answer is laid out as a line.
passes_over
The values a field of pointings may hold that are no pointing - a word such as none - and are passed over.
path
What a project must reach: its milestones on three horizons, each with the evidence that proves it.
Not: A plan of dates.
pattern
The shape a value must have, said as a regular expression.
people
Who takes part, each by the names they go by.
per
The value a part is laid out once for each of: once for each driver, each star, each thread.
places
The lens a part places within this one - all of it, or one of its parts.
plane
What a lens brings into focus, as rows in the order they are laid out: what a surface reads.
Not: A screen or a page: those are surfaces a plane is laid on.
practice
A way of working, said so that another can follow it.
practices
The ways of working, each said so that another can follow it.
problems
Signs: what was seen not to fit - stale, overlapping, lacking, unclear. The table keeps the name it had before they were called signs.
project
A repository with a mark. It keeps its own idea, path, workings and work, in its own data.
Not: A folder of code alone.
projection
The topmost shape of shapes: what a lens brings into focus, cut from the whole down to its places - fulldome, lens, part, line, place. Each piece has exactly one place because it was cut from there. It comes hand in hand with what it is projected onto, as a port with its adapters; it does not check what it projects, only its shape. What the world calls a project is one: what is thrown forward and lands on a surface, with what it came from left out of sight; a star is that source.
Not: the act of a lens (that is focus); a surface's text (the projection laid out, no longer a shape); a check of the data (the data's own, and observing's)
See: lens, dome, surface, focus
query
The question a part asks of its tables.
question
What a piece of research set out to find.
read
By which way in a surface is read - or that it is not yet.
readiness
How ready what a milestone is about is, as a number from 1 to 9: the higher, the nearer to being in use.
reads
The tables and shapes a lens reads that another lens defines.
record
The work done by hand that this is one more time of.
refines
The decision this one builds on, or makes finer.
reflection
A look back over a stretch of work by anyone - a person or a machine - saying what they saw, what they learned and what changes because of it; it touches what it is about and may answer another reflection.
Not: retrospective (a ceremony at an iteration's end); post-mortem (only after failures); lessons learned (only what went wrong); review (already means code review)
reflections
What someone saw looking back, what they learned from it, and what changes.
rejected
What was considered and not chosen, and why - so that it need not be weighed again blind.
relation
A field said to hold pointings: from a row of one table to things of others, with what the pointing is.
released
The release a change went out in.
releases
What a repository released, and when.
research
The look around before acting: the question asked, what was found in plain words, and the sources it rests on.
Not: A list of links.
room
The word first used on 2026-11-12 for what is now called the fulldome; with it went wall, which needs no replacement: a part of the whole is a lens.
Not: see fulldome
route
A lens at the edge: how a table's rows are read from a surface - which kind of surface, which part of it, and the shape taken from it.
run
Which run of the agent took a job: the moment that run of the agent began.
runs
What ran on GitHub: each run of a workflow, and how it ended.
said
What the voice told, and when.
saturated
Done by hand often enough (three times) or heavily enough (30 effort-minutes) that it asks for a tool.
Not: Bad, or forbidden: a saturated action is simply the next candidate for automation.
See: manual work, effort
saw
What was seen, as it was.
says
What a thing says of itself in its own words: a lens what it shows, a place what it is for, a row its few telling words.
screen
Text as a volume: so many columns of monospaced characters, unwrapped - a surface into which shapes are fitted, each by its own rule, so that nothing reaches past it. It says what it requires of whatever shows it. The terminal is a screen that is shown; a screen written out is a text file meant to be seen as one.
Not: text that flows (continuous lines, wrapped as the viewer likes: it promises nothing of how it looks); page (a page flows, and its browser fits it); window, display (the things that show a screen)
See: surface, dome, projection
see
Other words that are near a word, to be told apart from it.
seen
The day a sign was seen.
serves
What an item is a step toward: a milestone, a decision, or another item.
session_log
What each session did, by day: the log from before work was recorded as it was done.
shape
The form something is told by, said as a regular expression: what a route takes from a surface as a row, or what is to be kept out.
shown_in
Where a guideline is seen at work: the decision, the lens or the thing that shows it.
sign
Something that does not fit the whole, said by whoever sees it or read off the work: stale, overlapping, lacking or unclear. It is shown while nothing has come of it, and is answered by seeing what was lacking - not countered.
Not: problem, issue (a thing to be solved); mistake, error, being wrong (a failing of someone); bug, defect (a thing in a thing, not a misfit with the whole)
See: connection, lens
since
The day a thing came to stand as it does.
so_much
How much, of a whole: one half of a measure.
source
A work someone made that a project stands on - a book, a paper, a page - with what is taken from it.
Not: Research: a source is what was read, research is the reading and what came of it.
See: research
sources
What a finding or a decision rests on: each one a source that can be gone to and read.
star
A place that produces: one idea or project keeping its own ocoeco data, gathering nothing. A git repository today.
Not: project (only what has a repository and code); repository (a tool's word, and only where it lives today)
start_by
The moment by which a job is started, or not at all.
state
How a thing stands, read off and not said: of what is to be kept out, whether it is showing or kept out.
status
Where an item stands, as someone said: open, next, in progress, waiting, done, parked. More and more it is read off what is done, and not said.
step
Standing on a neighbour of where one stands.
steps
Where the drivers of a machine stood, each step with who and when.
stops
Said by a part of a lens: what it shows does not hold, and a place that shows any of it does not pass its check. The lens says it; the check carries it, deciding nothing.
subject
What a milestone is about: the device, the feature, the part of the whole.
summary
A concept's own text: what it is, in a sentence or two.
Not: statement (the word two projects used for the same role, retired 2026-11-11)
supplies
What an entry fills in by itself: the moment, who, a name for the row.
surface
Where a projection is laid out, and where what someone gives is read back: text, a screen, a page, a terminal, a line typed in a shell, the environment. A surface adds looks, never meaning; and what comes back off it enters through a lens again.
Not: view, render (one direction only); interface (says nothing of what it is)
See: dome, projection, lens
surfaces
Where everything lives: each surface with what it has, where it is, and by which way in it is read.
table
Rows of one shape - kept by a place, or read from a surface.
takes
What is taken from a source: the part of it that a finding or a decision rests on.
term
A word, as it is written.
text
Words as they were written or said, whole and unchanged.
thing
Anything one can stand on - a row, a place, a lens and what it is made of - known by where it is held, its table and its id.
things
Everything in view that one can stand on.
thread
The line of thought a connection belongs to: one name for all that follow one another.
through
The lens what a part places is seen through: one that reads a plane, and lays out - or leaves out - what the placed lens brings into focus. A lens behind a lens.
times
How many times something is found in the thing it was found in.
title
The few words a row is known by where many are listed.
titles
How each document begins, where it begins by saying what it is.
to
Where a pointing ends: the thing pointed at.
to_id
The id of the thing a pointing ends at.
to_place
The place of the thing a pointing ends at.
to_star
The star of the thing a pointing ends at.
to_table
The table of the thing a pointing ends at.
told_at
When something was told, by the voice or to a driver.
touches
The things a row speaks of, or changed.
trail
Where a driver stood, step by step, as it happened. A record of work reads from it where it was made.
transcript
Which kept transcript a turn was read from.
translations
Words said again in another language: of which row, and which of its fields.
turns
What was said in the conversation, turn by turn, each following the one before.
unless
What a shape to be kept out lets through all the same.
urgent
To be said at once, wherever its driver is - not when next looked at.
url
Where on the web something is: an address one can open.
uses
What a working uses to work: the tools and the parts it rests on.
via
What a pointing came through: the connection that says it, where one does.
via_id
The id of the connection a pointing came through.
via_star
The star of the connection a pointing came through.
vocabulary
The words a project speaks and exactly what they mean - and what they do not mean. ocoeco defines the shared words; a project adds its own.
Not: Jargon: a vocabulary translates words into plain language.
See: concept
waiting
Time spent on nothing while something else runs - a build, a reboot, CI - recorded by the tool that waits, with what was waited on.
Not: Manual work: that is effort spent; waiting is effort not spent.
See: manual work, effort
waits_on
What an item waits on, in words - where it is not yet drawn as what halts it.
Not: The halt itself: that is a connection, and is read off.
walk
Standing on one thing after another, each reached from the last by what it points at or what points at it. It belongs to no surface.
what
What was seen, said plainly: of a sign, what does not fit.
where
The thing one stood on: of a record of work, where it was made; of a sign, where it was seen.
which
Which part of a surface a route reads: the paths within a place - any folders, any names.
whole
The value of an answer that is the whole a measure is of, where each line has its own.
Not: The whole of everything in view: that is discovered, and is no value of an answer.
why
The reason, plainly: what would be lost or go unseen without it.
work
What actually happens: the backlog, the log, and what the gatherers record.
Not: The plan of it.
See: gatherer
workflow
Which workflow a run was a run of.
workings
How a project's steps are delivered and proven - its tools, checks, gatherers, tests and practices - each tied to the step it serves, with why we care. As in the workings of a clock.
Not: A task to do: that is the backlog.
written
A pointing as it was written, in the row that holds it.
year
The year something was made or said.