Decisions¶
The decisions that still shape this repository, each with the reasoning a reader would
otherwise have to reconstruct, one file per decision. Documents cite them by number
(Decision 660); new code does not, and states its invariant in its own words instead,
while a decision names the code it governs in its paths (Decision 882). The TUI's own
are in tui/ and the daemon's in daemon/, each
numbered on its own, so Decision 60 in the TUI's code and TUI Decision 60 elsewhere
are tui/0060-*.md.
Before changing a file¶
mix troupe.decisions --for apps/troupe_gateway/lib/troupe/gateway/private.ex
lists the decisions that govern the path, newest first: the number, a line saying what someone changing it must not undo, and the file. A superseded one says what replaced it. Read the ones that bear on the change; a change that undoes one says so.
Writing one¶
A decision is a new file here, <number, four digits>-<slug>.md, numbered above every
number this log has used and below the line that says which number is next. That line is
the first number not yet reserved: a chunk's coordinator reserves a block of numbers for
the chunk and moves the line past the block on the chunk's branch, and a fixer never
edits it, so two pull requests that each decide something touch no file in common:
A decision is short: what was decided, what was not chosen and why, and what breaks if it
is undone, in at most 40 lines that are not blank. It does not list the tests that prove
it, retell the issue's history or restate the code; the pull request and the code carry
those. Its paths are where it would be undone, at most eight globs of code; never a test,
which is not where a decision is undone, and a page under docs/ only when the decision is
about that page's own shape. It starts with a front matter:
---
number: 1025
title: A decision is at most forty lines and names at most eight paths of code, and a log's number is never taken twice
date: 2026-11-17
status: accepted
issue: 1011
supersedes: [790]
paths:
- apps/troupe_protocol/lib/mix/tasks/troupe.decisions.ex
- docs/decisions/README.md
- docs/decisions/tui/README.md
- docs/decisions/daemon/README.md
- docs/developer/conventions.md
- docs/developer/fixing-issues.md
gist: Body <= 40 non-blank lines, <= 8 paths, no test path, from 2026-11-18; each log's README says its next number
---
title: the decision, in one sentence.paths: globs, from the repository root, of the code where the decision would be undone. A glob that no longer matches anything fails CI, so a move or a rename breaks the decision's check rather than, silently, its meaning.gist: at most about 150 characters, what someone changing those paths must not undo. It is what--forprints, so an agent can tell without reading the body whether the decision matters to what it is about to change.status:accepted, orsupersededonce a later decision replaces this one whole; the later one sayssupersedes: [N], which it says too when it replaces only a part.- Optional:
issue,pr,symbols(modules and functions),supersedes.
A title or gist that starts with a backtick or holds : goes in double quotes, as
YAML wants.
A decision that is superseded or reversed, or whose reasoning now lives in the code it
governs, is marked superseded or deleted. Numbers are never reused, so a citation keeps
meaning what it meant: the next line stays above every number a file ever had. git log -p -- docs/decisions has every one ever written; the
three logs they were split from (DECISIONS.md, clients/tui/DECISIONS.md and
apps/troupe_daemon/DECISIONS.md) are in the history before Decision 790, and
elixir scripts/split-decisions.exs turns the entries a branch still appends to one into
files.
mix troupe.decisions --check, which CI runs on every pull request, fails on a front
matter YAML would read otherwise, a missing field, a number used twice in one log, a
number at or above its log's next, or a paths glob that matches nothing, and, for a
decision dated 2026-11-18 or later, a body over 40 lines, more than eight paths or a
test among them. --report lists the older ones over those limits, and the superseded.
The decisions¶
On the documentation site the list is below, newest first, read from the files as the site is built; in the repository, this directory is the list.
| No. | Decision | Date |
|---|---|---|
| 1074 | A Markdown artifact's image from another site is named at publish as an HTML page's is, and the rendered page shows in its place a sentence naming the site, never its address; the host's image policy stays its own files and data: | 2026-11-19 |
| 1073 | The plane keeps whether a call was priced: a pod's usage record says priced beside the cost, the ledger keeps it per row, and the profile's page, the overview and the desktop's rail say how many calls of the period had no price; budgets still count them as free |
2026-11-19 |
| 1072 | A session no pod holds is found and put to sleep: the sweep marks an active row on no pod dormant once it has been so for a minute, a pod's connection asks it what it holds every minute and puts to sleep what an answer does not name, and a rescue marks the row before it gives the slot back |
2026-11-19 |
| 1071 | The desktop app's artifacts gallery has no aside; a click on a card opens the artifact, Open and Info show over its picture on hover and on keyboard focus (Info alone in its corner where nothing hovers), and Info is a native modal dialog in four tabs, Overview, Access, Versions and Comments; Keep at the top stays in the dialog | 2026-11-19 |
| 1070 | The desktop's profile page takes its laid-out shape: a head with the name large, a rail with Start first then panels (room as a meter, at a glance, who, limits), a card per system whose body is its tools as lines and whose foot says whose credential and whether it asks, and one can't list of rows under its promise; hosts and tool names go under the hood or on hover | 2026-11-19 |
| 1065 | A gateway's cost reaches the ledger from the stream's usage.cost, which the OpenAI adapter asks a gateway for on every call, or from the cost header; where both say, the stream's counts. A LiteLLM gateway's streamed calls need no llm.prices |
2026-11-19 |
| 1064 | The desktop session's ⋯ menu leads with one control that folds every turn's working (quiet) and unfolds it (everything); it is /detail's per-session choice, so the two never disagree, and a turn opened or shut by hand keeps that until the next change | 2026-11-18 |
| 1063 | A bundle's author writes a profile's sentence, each server's subtitle and a line per tool (about, schema 1 still), checked at publish against the server's allowlist and passed through by profile.get for the desktop page |
2026-11-19 |
| 1062 | profile.get states the limits a session there is held to, Troupe's defaults included, from one protocol module the harness reads too; the desktop page says them in sentences and lists the harness's tools | 2026-11-19 |
| 1061 | The line that offers the desktop app is the app's own browser build's, not the console's; the browser build opens a session or an artifact from its address and writes where the person is back into it; a copied link names the web app beside the troupe:// line | 2026-11-18 |
| 1060 | The desktop app's profile page leads with what the profile can and cannot do, from profile.get as it is, with a rail of what a person checks before starting and Start; the configuration's tables fold away under the hood | 2026-11-18 |
| 1054 | The console opened signed out at an artifact's address or a link's goes to the plane's provider at once, once per tab until a sign-in holds, and draws its page only when there is something to say; the artifacts host's cookie slides, an hour from the viewer's last request | 2026-11-18 |
| 1053 | A dormant session whose root cannot replay its log is woken past each event the replay raises on, by whoever may send it input, with an appended log_repaired and never a rewrite; the failure is said once, and the clients offer the wake where the refusal is shown | 2026-11-18 |
| 1049 | A platform administrator reads every memory document the plane holds, a person's own included, and every artifact's page, a person's private one included, each read a row in the audit naming who read whose; a person's own memory stays theirs and their agents' to change, an administrator reading and, by removing the person, erasing it; and the console's first group, Oversee, is that whole view, with a person's own a filter beside everybody's | 2026-11-18 |
| 1048 | A published page, stylesheet or script is read on the plane for what the artifacts host's policy will block, from that policy's own lists, and is published all the same, the publish answer naming each blocked reference by file and the artifact's page in every client saying how many | 2026-11-17 |
| 1047 | A pod session's output cap is its profile's llm.maxTokens, carried as TROUPE_MAX_TOKENS and narrow-only along extends; the model's own limit still bounds it and the organisation's machine ceiling does not reach a pod; an agent's own max_tokens only lowers it; 8192 stays the default; the cut-off note names the cap in tokens | 2026-11-17 |
| 1043 | Every admin method is named on a page under docs/admin/ beside the task it serves, and a plane test fails naming any that is not | 2026-11-17 |
| 1042 | ARCHITECTURE.md is a map under 150 lines, the design is told once on two pages that do not overlap, and a component README says what its directory is and how to build and test it | 2026-11-17 |
| 1041 | The logs were trimmed once, by deletion only, to the live decisions; a trimmed body keeps every rule and reason and loses its history, tests and inventories, and its paths name at most eight globs of code | 2026-11-18 |
| 1040 | The client library owns the words both GUI apps say, one helper per thing, and the apps keep no copy of their own | 2026-11-17 |
| 1038 | A session's owner renames it and keeps it at the top from a row's ⋯ in the desktop list, the session's ⋯ and the palette's /rename and /keep, which are harness built-ins the terminal runs too; the word is Keep at the top, as an artifact's; and whoever may steer a session completes, cancels and adds a task in the Tasks pane | 2026-11-17 |
| 1037 | The plane's four budget rungs are served by one server, and each rung module says only where its ceiling and spend come from, what its summary names, and its own calls | 2026-11-17 |
| 1035 | PROTOCOL.md's admin method table is generated from the methods' declarations, in place between markers, and what no declaration says stays hand-written around it | 2026-11-17 |
| 1034 | Durations, counts, lists, byte cuts, globs and digests are written once, in the protocol app, and no app keeps a private copy | 2026-11-17 |
| 1033 | The user landing page is the first run in five steps and a line per page, each mechanism a person meets is explained on one user page, and a moved section leaves no stub behind | 2026-11-17 |
| 1032 | The admin pages explain each mechanism once, a moved section leaves no stub behind, and a step only one release needs is in that release's notes | 2026-11-17 |
| 1031 | A defect found in passing is a GitHub issue with its component label; the repository keeps no log of known defects | 2026-11-17 |
| 1029 | The protocol schema declares only the events something writes and the methods some client sends; acl_*, session_read_only, session_archived, session_erased and fleet.get go, and so do four telemetry events nothing attached to | 2026-11-17 |
| 1028 | The Stage 1 gate is an issue template and a script, with no runbook pages; the template carries the rows and the record's rules, and scripts/gate-check is the desk half | 2026-11-17 |
| 1026 | The console has no owed list and no not-built page; every administrative method the plane serves is called from a screen, and one the plane adds fails the console's coverage test until a screen calls it | 2026-11-17 |
| 1025 | A decision is at most forty lines and names at most eight paths of code, and a log's number is never taken twice | 2026-11-17 |
| 1024 | A prompt the provider refuses as too long even compacted is sent once more with every large tool result left for read_output, the turn's own included, and /compact (session.compact) compacts between turns |
2026-11-17 |
| 1023 | The owner archives a session out of the session list for everyone who sees it; it is kept whole and opens, and only session.unarchive brings it back | 2026-11-17 |
| 1022 | The desktop app's profile page lists only what a session gets, and each skill with what it does and its SKILL.md; profile.get carries skill_details |
2026-11-17 |
| 1021 | The desktop app folds a run of sleeping and waking notes to its latest line below everything |
2026-11-17 |
| 1020 | A gallery card shows the picture its publisher sent with the version, a PNG, JPEG or WebP of at most 256 KiB kept beside the version's files and served by the artifacts host at a signed address for the person whose row gave it; nothing on the plane or a worker renders a page into one in this slice | 2026-11-16 |
| 1019 | An administrator may set how long an artifact's old versions are kept (artifacts_keep_versions_days) and how long one nobody opens is kept (artifacts_keep_unopened_days), both off by default and the organisation's alone; an hourly pass removes what has run out, one artifact or version at a time under its row's lock, never the newest or the pinned version, each audited by system:retention with by: retention; and every row says when it goes (goes_at), which opening it moves | 2026-11-16 |
| 1018 | A person keeps an artifact at the top of their own gallery with artifact.keep {id, on}, a row of theirs on the plane that artifact.list says as kept on each row and never leaves out of its 500, not audited and nobody else's; the desktop app groups the kept ones above Today, This week and Earlier, and narrows the rest by team, with a second row of chips inside Your teams where it shows more than one, and by the days they were published, a choice of the app's alone | 2026-11-16 |
| 1017 | A new session on a profile more than one of the person's teams may use asks which team it is for: both clients ask before sending where the profile listing names several teams, and on the plane's choose a team refusal where it did not, from the names the refusal carries; the answer is remembered per profile in the client's own settings, shown as a chip at the end of the sentence and changeable there, and dropped when that team may no longer use the profile; troupe run --team says it for a script, which is never given the remembered one; the plane keeps the refusal and logs it |
2026-11-16 |
| 1016 | A comment in an artifact's thread is deleted by its author, the artifact's owners, or whoever may take the artifact down (artifact.comment.delete, its row removed with no tombstone), and edited by its author while they may write in the thread (artifact.comment.edit, marked with edited_at); both audited without the text, the thread says per comment who may do which, and neither is announced to the session | 2026-11-16 |
| 1015 | A comment on an artifact a laptop's session published reaches that session on its daemon's existing poll of me.memory, which asks for the comments written since the last answer on its person's artifacts from a session on their machine, beside the signed memory; the daemon writes each into its session's log as artifact_commented once, never as input, within one poll (five minutes) | 2026-11-16 |
| 1013 | troupe update from an install whose programs are not in the default place lists and updates only what is its own, and says the desktop app is the default install's | 2026-11-16 |
| 1012 | A worker profile may refuse its sessions' memory proposals with memoryProposals: false, read by the plane at each proposal from a pod and refused in the setting memory_proposals's sentence naming the profile; the field is restrict-only along extends, and a child's own value under a parent's restriction is said in the preview and the effective view | 2026-11-16 |
| 1011 | The wall clock counts working time, each turn from its start to its end with waits on a person left out; a restart forgives the time worked except what a question about it recorded | 2026-11-16 |
| 1010 | A pod session asks when its budget is spent, as a laptop session does, unless its terms set a turn or wall-clock limit; the platform's switches and approvals are not limits |
2026-11-16 |
| 1009 | PROTOCOL.md stays one contract on one page, the one hand-written file past 400 lines, until the schema can say what a field means | 2026-11-16 |
| 1007 | An artifact's owner shares it with picked people by name, each at view, comment or edit, with artifact.share naming a person instead of making a link, and a link may give comment too; every artifact has one thread of comments on the plane, read by whoever may open it and written by its owners and whoever holds comment or edit, which the session it came from hears as an artifact_commented event, never as input | 2026-11-16 |
| 1004 | An agent proposes an entry for its team's or the organisation's memory, and an administrator who may change that level accepts or declines it: remember takes level team and organisation as a proposal kept in memory_proposals and in no document; accepting writes it as an entry with the session and agent as its provenance, declining needs a sentence; the session is told either as one config_note; the setting memory_proposals switches proposals off; and a profile's extends changing tells its running sessions, the memory_changed line saying the chain moved | 2026-11-16 |
| 1003 | The desktop app asks where an Always allow rule goes, this workspace (the default) or everywhere, once per rule; an answered question names who answered where two or more people steer; a row a client types with other arguments carries that client's usages and examples, so /hq names no plane there; the start screen carries the brand once, the rail's; a session on this computer is owned by the signed-in person's name |
2026-11-16 |
| 1002 | A troupe:// link is an address and nothing more: three forms, refused whole when it carries anything else, a new plane confirmed in words before any request; and every web surface offers the desktop app, from the version the plane recommends | 2026-11-16 |
| 1001 | A profile's max_sessions is weighed against the most its pods could ever run (its registered hosts, or the cluster policy's maxReplicas, times the size class's sessions per pod), never the replicas running now, and saved either way with a sentence where it is above; admin.clients.put takes dry_run, which a console asks for only where discovery names it; a limit's refusal says its ceiling in the setting's unit; the audit page and profiles.list speak the units and gone pods the other pages do | 2026-11-15 |
| 1000 | The site's front page wears the product's palette, opens on what Troupe is beside a picture of it in both themes with the install and the downloads under them, the site draws in its own Figtree with nothing from a font service, a link to it shows a card drawn from the tokens, and llms.txt names what an assistant should read | 2026-11-15 |
| 999 | The desktop app highlights a code frame with lowlight from a built-in set of highlight.js grammars, loaded on first use, in the palette's roles; draws a Mermaid fence with Mermaid 11 at securityLevel strict as an SVG image; gives Afterglow dark's frame surface a step; sets transcript.detail on Appearance; and both clients draw a replayed reply's reasoning from the log | 2026-11-15 |
| 998 | In the desktop app a frame is as wide as what is in it, from the reading measure up to the session's column: prose keeps the 78ch measure, and a code block, a diff, a table and a call's output run to the column before they scroll sideways inside their frame | 2026-11-15 |
| 997 | A relayed laptop session is paused while its laptop is away, and said so on its stream; its approvals say the folder the call acts in; and somebody the owner let steer may allow a tool for the rest of the session from another device | 2026-11-15 |
| 996 | /dismiss, /merge, /discard, /observer and /worktree are availability tui, which the desktop app leaves out; a tui row keeps what the terminal client needs for it in availabilities, chosen by for_client/2 as a client's own words are; and /hq has the desktop's words |
2026-11-15 |
| 995 | The console answers a pod session's approval as the desktop does: Allow once, the session-wide answer in the shared calls' words (callScopedLabel), Deny, and Always allow only where the session's server names approval_allow_always, which a pod does not; a publication on a pod also offers letting it publish unasked for the session; a relayed laptop session keeps Allow once and Deny with the line saying why | 2026-11-15 |
| 994 | A pod the operator removed is forgotten: a pod row whose substrate no longer runs it (an ordinal at or above the profile's count, a host no longer registered, a profile the plane no longer has) is listed gone, since it was last heard, once it is quiet past its lease, and the sweep drops the row once it is quiet past the drain deadline and holds no active session; a gone pod offers no action and is nowhere a drained pod's sessions could go | 2026-11-15 |
| 993 | The harness, gateway, worker and plane write every sentence a client shows in the reader's words, so no client rewrites one; the console keeps the words of what an administrator runs and drops the ones a person has another word for | 2026-11-15 |
| 992 | Every event and row that names a person carries their name beside the subject: an event's actor its display_name from the connection (the plane's token on a pod, the link or the OS user on a laptop), session_created its owner_name, the plane's session and audit rows owner_name and actor_name filled from the identity record by one helper; a name that is only the subject is no name; the clients draw initials and the name and fall back to the subject | 2026-11-15 |
| 991 | A platform setting carries a label and a unit, written once in the plane's settings table; the console names the row by the label and asks for the value in the unit | 2026-11-15 |
| 990 | An artifact is attached to a message by fs.upload naming it in place of bytes: the session's server fetches the version's files from the plane as the person who asked, a pod over its control link for someone who steers the session and a daemon with its sign-in, so the bytes never pass through the client | 2026-11-15 |
| 989 | Always allow from an approval is approval.respond's allow_always: a daemon writes the person's own allow rule for the whole tool into their config.yaml or the workspace's config.local.yaml and allows the call; refused under managed_permission_rules_only and where an allow would change nothing; a pod offers none, its rules being its worker profile's | 2026-11-15 |
| 988 | The root agent says how full its context window is in an ephemeral context_status, after each call and before a turn on a model it has not yet said, with the window the model is known to have, or null where only the fallback is | 2026-11-15 |
| 987 | On a phone (below 720px) the desktop app draws a one-line top bar and a sheet instead of the rail, and the backstage and the scratchpad are sheets one at a time, so the conversation gets the screen | 2026-11-15 |
| 986 | The desktop session view reads as a chat: a one-line head, one centred column, cards at its foot, a one-box composer; the backstage under ⋯, the goal from /goal; what the backend lacks is drawn, with its reason, and waits on #920 | 2026-11-15 |
| 985 | A desktop screen entered before this computer's daemon was ready is drawn again by itself when the person has typed nothing on it; the banner with Refresh stays for a screen with a draft and for a session | 2026-11-15 |
| 984 | A command's row says what it does in words true in every client, with a client's own words beside them where it runs the command differently (summaries, details); availability tui marks the terminal client's own commands, which the desktop app leaves out; and an agent's row in the desktop palette switches the session by the head's rule |
2026-11-15 |
| 983 | An offer at a session's start (onboarding, the brief, your servers for a pod) is not work waiting for a person; its panel wears none of the reserved colour and nothing counts it as waiting | 2026-11-15 |
| 982 | The status lines of every loading and starting state are one file, docs/design/lines.json, read by the terminal client, the desktop app and the console through generated, committed readers that take a kind's lines in an order shuffled from a seed |
2026-11-15 |
| 981 | The desktop app's agent dialog offers only what it can do - the agent running now is marked as running, not offered as a switch; Edit is offered only for an agent whose file is this computer's to change, and otherwise the daemon's reason is said in its place; on the platform the dialog says in one line where the agents come from and offers no edit; a refusal is said on a line kept for it; and the platform's read-only sentence names no pod and sends nobody to the console | 2026-11-14 |
| 980 | A bundle's skill may say which agents may load it (agents, all or names, the built-ins included), an agent loading a skill its own skills: opens or one whose agents names it, a team's grant still narrowing after both; a draft naming an agent that is neither the bundle's nor Troupe's is refused, and admin.profile.agents says on each agent which skills it loads |
2026-11-13 |
| 979 | A session runs as an agent its profile offers - the plane resolves the default (build where offered, else the first offered) at create time and keeps it on the row, refuses a create naming an agent the profile lacks or on a profile that offers none, sends the row's agent on every activation including a wake, and parks a session whose pod will not run it as its agent instead of trying again; the clients send the default they show | 2026-11-13 |
| 978 | A worker's client assertion names its certificate as both x5t#S256 and kid, its iss and sub are the identity's optional subject (the client id when absent), its jti is a random UUID, and its token is renewed five minutes before it runs out |
2026-11-13 |
| 977 | The worker image carries Python's standard library, zip and unzip as what a skill's script may rely on on a pod; a skill names any other program it needs in its frontmatter's requires:, and where it is loaded one missing a program is kept and marked as unable to run here, never hidden |
2026-11-12 |
| 976 | The desktop app's Memory and Artifacts read and change the person's own straight from the plane it is signed in to, by its sign-in's gated rpc as the console does; this computer's daemon is asked only what this computer holds, and carries the person's own only where the app is not signed in; and a screen with neither says why in the daemon's actual state | 2026-11-12 |
| 975 | A session starts from a message: the new-session screens in the desktop app and the terminal put the message box first and the settings in one sentence of chips, pick the profile by a stated rule (the last used with room, else the first with room), read @profile, #agent, /local and /platform from the message and take them out before the agent reads it, queue on a full profile as the plane's existing pending wait made visible, turn On this computer on by itself when the daemon answers, title the session from the first line, and record the agent and the title on the session's row | 2026-11-12 |
| 974 | A key a person gives one of their own MCP servers is kept in the operating system's keychain and the entry holds a {secret:…} reference to it; a workspace's server reads only its own until trusted; a check and a session say what each tool is; the daemon finds other tools' folders of skills | 2026-11-11 |
| 973 | A person adds and edits their own MCP servers by hand in both clients, on the desktop app's Tools and skills and with the TUI's /mcp add and /mcp try; an edit writes only what changed, values never come back, and a local session's screen says how each server stands there | 2026-11-10 |
| 972 | troupe update and the desktop updater choose between two targets: the version the plane recommends, the default, and with --latest the newest release whose signed manifest says it supports the plane's version, still never one the plane blocks or holds below its minimum | 2026-10-29 |
| 971 | A direct plane lists the Trigger resources in its namespace and never acts on one by itself: an administrator copies one into a row, which records the resource and its generation, and copies it again when it moves; drift reads both ways, and a removed resource leaves its row running |
2026-10-29 |
| 970 | An agent of mode function is one the harness starts by name for its own job; no picker, delegation or session's agent offers it, the plane's built-in primaries are the shipped files' primaries, and a profile's agents rule still removes one | 2026-10-29 |
| 969 | A person reads what a profile gives a session before starting one, from the plane's own composition | 2026-10-29 |
| 968 | A worker profile says which agents exist on it in spec.agents, built-ins included and in every mode; the plane applies it before any team's grant, a child profile can only narrow it, and the pod drops every definition it excludes, subagents too | 2026-10-29 |
| 967 | A model request that sends nothing for a minute is given up on with a sentence naming the host, the daemon's log says where a turn is, and troupe doctor asks the model for one token |
2026-10-29 |
| 966 | A plane-light runs the plane, a worker registered to it as a machine, and what the two need on one box from one compose file, with the bundled Dex as the sign-in where there is no provider, OpenBao's unseal key on the same disk, and the gaps named on its own page | 2026-10-29 |
| 965 | A publication is aimed by the person at the gate: the agent proposes an audience only where the person named one, a call that names none must be asked whatever the rules say, and the approval's answer carries whom it is for and whose it is | 2026-10-28 |
| 964 | An artifact may be a team's, whose members and administrators own it together: one published to a team is the team's unless its publisher says owner: me, artifact.transfer gives a person's own to a team and lets the team's administrator take it back, and the person who published it stays on the row | 2026-10-28 |
| 963 | A desktop screen entered before this computer's daemon linked to the person, or before its socket opened again, says the daemon is ready now and offers a refresh that remounts that screen; the app never remounts a screen uninvited | 2026-10-28 |
| 962 | On Windows the daemon started at login runs detached from any console: the Startup entry runs troupe-daemon run --detached, which is erl -detached, the runtime's own way to run a daemon, so no window stays open and no script host is involved |
2026-10-28 |
| 961 | The console is the one administrative surface: break-glass is a plane token the console's sign-in screen asks for, the plane's LiveView app and its own OIDC flow are gone, and the registration needs no secret | 2026-10-28 |
| 960 | An organisation says, in its own words, where a person gets a key for local sessions, and may choose to hand one key to everybody who signs in; the clients show the word wherever a key is asked for, and troupe config key pastes one | 2026-10-27 |
| 959 | One update moves every component the installers put on a machine: troupe update replaces the desktop app and the VS Code extension after troupe and troupe-daemon, and the desktop app's update replaces troupe and the extension beside the daemon | 2026-10-27 |
| 958 | One sign-in for the terminal client, the desktop app and the daemon: the desktop app keeps its refresh token in the TUI's credentials.json under a shared lock, starts at that plane, and links a daemon nobody has linked when it connects | 2026-10-27 |
| 957 | A memory document's ## Topic sections are its entries, read by the plane off the text it keeps, each with who last changed it and in how many sessions it was used; on a topic two levels both have, the closest level's entry replaces the lower ones in the prompt and says so in one line, and what is in effect for a person in a team is one list, memory.in_effect; remember with level me writes under a topic, Notes by default; and the daemon sends memory.in_effect and admin.memory.get, preview and put on to the plane as its person | 2026-10-27 |
| 956 | A file the person asks for goes where the organisation keeps files, else it is published as an artifact, else it is made in the workspace for their client to save; what the person or an instruction says outright comes first, and when none of it is clear and more than one way is open the agent asks once: the harness says this to every root agent in a layer of its own, harness, before the organisation's memory, with what is open in that session; a tool that stores files is one its server's config marks stores: files, never one guessed from a name; and a deliverable is written with write_file's deliverable: true, said with file_ready, which both clients offer to save | 2026-10-27 |
| 955 | An artifact's owner moves who may open it with an artifact.put over its newest version that sends no files, a new version carrying every file, which the daemon forwards so the desktop app changes it in place; a pod sends a large version by an upload handle as a daemon does; and a path part past 255 bytes is refused before anything is written | 2026-10-27 |
| 954 | A person's artifacts and memory are theirs to see and change in their own app: the desktop app has an Artifacts gallery and a Memory view beside Sessions, read through this computer's daemon, which forwards the plane's artifact.get, artifact.open, artifact.share, artifact.unshare, artifact.rollback and artifact.pin and the person's me.memory.history and me.memory.rollback as them and refuses all of them under Local only; an artifact is shown from its own host in a child window of the shell's, granted nothing and kept on that host, never fetched into the app; and memory is read as entries, one per ## Topic, the closest level's replacing the lower ones | 2026-10-26 |
| 953 | An artifact may be a team's, which its members read and its admins may take down, or private, its owner's alone and the default, which only a platform admin may still take down; every row of artifact.list says the gallery tab it is under, and the administrators' table is admin.artifacts.list in the console's Operate area | 2026-10-26 |
| 952 | The owner may offer a private session for steering after saying yes to its passing through the plane unsealed while it is offered; the clients ask in one sentence first, the plane relays it to the people invited with control and keeps none of it, a control invitee steers it only while it is offered and their invitation stands, and withdrawing returns it to sealed-only | 2026-10-25 |
| 951 | Local only is a promise the daemon keeps for that client's sessions, no plane call while it is on: a client says it in initialize's client_info.local_only and again with client.mode, a session is under it from when such a client creates it or gives it work until a client not in it does, and for it remember level me is refused, an offer is refused, its turns leave the memory report and it says once in instructions_loaded what it reads; while every client attached is in it the daemon's polls wait; the terminal's switch is local_only in the person's own config; and who wrote each line of a memory document is derived from its versions and audit rows, never stored | 2026-10-25 |
| 950 | A republish is a new version at the same URL, with history, rollback and a pin the owner sets; the console edits a page's or a document's text with the artifacts host's own preview framed beside it; a share is a link that honours the plane's sign-in, giving view or edit to whoever the plane signs in through it, recorded per person and revoked by link or by person; and there is no public link unless an administrator switches them on | 2026-10-25 |
| 949 | A person invites another into a session by name, to observe or control: a pod session's invitation is its grant made visible, a private session's key goes from its owner's daemon into the invitee's own slot at the key manager, which the plane holds the path of and cannot read, taking one back re-keys the session forward, and everybody present is named | 2026-10-25 |
| 948 | An artifact is a versioned page on the plane, published to the organisation or to a profile's people, served from an origin that can touch nothing else: its rows in Postgres and its files in the object store under artifacts/ |
2026-10-25 |
| 947 | A turn records the memory versions it ran under; the console sees who is behind; a stale pod session re-reads before its next turn: instructions_loaded names each memory document's scope, name, version and hash; a pod's session asks the plane with session.memory.read as each turn begins and is answered with the documents in force where it is behind; a laptop's daemon says what each of its sessions read with its poll of me.memory; admin.memory.get and preview list the running sessions a document reaches with the version each read, admin.memory.nudge tells a pod's session again, the session list marks one behind; the editor rolls back to a version as a new version and sets two versions side by side; and troupe memory --status says where a machine stands | 2026-10-25 |
| 946 | The GitHub App's OpenBao grant is optional on a plane that has no App and required once one is set up, so a plane whose App would stop signing is not reported healthy | 2026-10-25 |
| 945 | An offer survives a reboot where the daemon starts at login, and says so where it does not: the listing's offer says whether it lasts across restarts or until this machine restarts and whether it came back after one, both clients say it in the same words and say the command once; a relayed approval offers only allow once and deny, since the laptop's rules are its own person's to loosen; the release keeps the versioned app archive alone, and the signing guide counts what a release signs | 2026-10-25 |
| 944 | A drain waits for the pod while the pod says how far it has got, up to a ceiling the audit names, and the operator acts on the plane's record of a finished drain at once; an egress entry's port means the same with Cilium as without, and an MCP identity's token endpoint is admitted and judged as a server is | 2026-10-25 |
| 943 | Each person has one memory document of their own on the plane, kept by their id, versioned and audited as the organisation's levels are and read by nobody else; every session they run reads it after the organisation's, team's and profile's and before the repository's; they change it with troupe memory, the desktop app's Instructions pane and the console's Mine; and it is the one level an agent may write, by remember with level me adding one entry under the day's heading, through the daemon's me.memory.put on a laptop and session.memory.put on a pod, the organisation's levels staying read-only to agents | 2026-10-25 |
| 942 | Anybody the plane knows signs in to the console, a person who administers nothing as a member shown only Mine (their offered laptop sessions, steered as themselves, their sessions, their clients' versions and their memory to read) and an administrative role adds the four groups; and the laptop sessions offered to a person, and who is steering one, are pushed to the desktop app and the console, never polled: a person's watch at /v1/relay/watch sends remote.changed with the whole list when a change concerns them, and a session's presence topic names who arrives and leaves | 2026-10-24 |
| 941 | The terminal unlinks this computer's daemon with /unlink, asked once: anyone who reaches the daemon as its owner may, it drops the link, the plane's token, the daemon's own sign-in and the memory copy, keeps the sessions and the pinned key, and whoever the terminal is signed in as, if somebody else, is linked next | 2026-10-24 |
| 940 | No hand-written page passes 400 lines, a page that would is split along its headings with its anchors kept, and a check in CI holds it | 2026-10-24 |
| 939 | A worker namespace is complete when the operator made it: the operator copies, by name, each Secret its pods mount from the plane's namespace (one a profile names only when the Secret is labelled for workers), labels the ingress controller's namespace where the installation names it and checks the label is somewhere where it does not, and the kind cluster's plane logs in to OpenBao under the documented policies alone | 2026-10-24 |
| 938 | OS code signing is in addition to the release key's, off until the release environment holds the certificates, and signs every executable a payload unpacks, before the manifest is made | 2026-10-24 |
| 937 | The plane records, per person and component, the version, platform and times of the client it last served at initialize, one row moved on and never a history, and an administrator reads it beside the policy; the credential stores are exercised on a real macOS keychain and Secret Service in CI, the daemon keeping a value too long for one security -i line in parts; session_tainted carries the person's display name beside their subject; and the desktop app asks again about a server signed in to while attached and offers only the servers ticked |
2026-10-24 |
| 936 | The cluster suite proves N-1 to N on every pull request into main that it runs on, and on every release | 2026-10-24 |
| 935 | On Windows a credential longer than one Credential Manager entry holds is kept in numbered parts, <target>/0 to <target>/<n-1>, with <target> holding troupe-parts:<n>; one that fits is one entry as before, and the desktop app and the daemon keep the same layout |
2026-10-24 |
| 934 | Every cluster-side step is the chart's or the operator's, and one they cannot own is a precondition the plane checks and prints the fix for: the operator labels each worker namespace with the lowest Pod Security level its pods need and the chart its own namespace (podSecurity), the operator replaces a pod that dials the control port in plaintext once TLS is required instead of waiting on a drain that cannot come, the plane checks its OpenBao grants look-only from one list that also writes docs/admin/openbao.md, and admin.groups.list says which groups seen in sign-ins no team links | 2026-10-24 |
| 932 | The console's agent builder starts from a profile's agents as its bundle in effect has them, with who may run each, and picks a model from the ones the plane has been told of or seen run; the App's test mints, uses and revokes a token for a chosen repository and shows what it could do; a fix loop's commit names who the run is for in a Requested-By trailer the plane writes; and the desktop manager is the picker's rows | 2026-10-23 |
| 931 | The desktop app's shell checks the plane's signed version policy itself, against the key the daemon pinned, before it takes a version or where releases are from it; a connected daemon asks the plane's initialize again every thirty seconds and fetches the signed answers when its policy revision moves, so a change reaches the clients and, at their next turn, the running sessions; initialize's update_required is signed and acted on only as signed; a release is mirrored into the plane's object store only once its manifest checks against the release keys; and /downloads answers a bare 404 whatever the policy says | 2026-10-23 |
| 930 | A run by hand and the console's "fix this" are the run of the same person's click less than a minute before, as a webhook's blind retry is, not the run of the clock's minute; a firing is admitted against its caps under the trigger's row lock (and, on a repository, one lock for every repository cap), a failed run's retry included; and a run that has had no session for ten minutes is ended failed, with the reason, and audited |
2026-10-23 |
| 929 | A save of an organisation's, a team's or a profile's memory reaches the sessions already running in its scope at their next turn, on a pod because the plane tells the pod and on a laptop through the daemon's signed poll of me.memory every five minutes, with a line saying what changed and to which version; a child profile reads its chain's memory, the one that extends nothing first; a deleted profile's memory is deleted with it; the desktop app lists every instruction layer; troupe config pull fetches memory; and signing out drops memory.json | 2026-10-23 |
| 928 | While a session is offered, the daemon keeps a sign-in of its own: a grant the plane gives the device at the first offer, asked with the client's token, kept in the OS credential store and exchanged for a token of the laptop's door alone; the last withdrawal, a sign-out or troupe logout releases it, the idle watch stays up for it, the TUI steers what is offered to its person, and a team's admins may forbid offering | 2026-10-23 |
| 927 | A POST to a trigger's URL without an Idempotency-Key is the run of a firing of the same trigger and revision less than a minute before it, decided under the trigger's row lock, not the run of the clock's minute; and a repeat that finds its run still making its session waits for that session, up to five seconds, then answers 409 naming the run |
2026-10-19 |
| 926 | Every request the desktop app makes to a plane goes through one gate, the fetch its sign-in is built with, which is shut while Local only is on and asks the setting at each request, so a call already on its way when the switch goes is refused rather than sent |
2026-10-19 |
| 924 | A person's MCP sign-in with no client id presents Troupe's client ID metadata document or registers a public client where the provider takes one, keeping it beside the tokens; and a call to a person's tool that left the session says whose it was | 2026-10-18 |
| 923 | Someone who may only watch a session is not shown what it runs on (the provider's address and the state directory read as set by the profile); no client call waits for its answer for good, and the terminal's first run goes by the daemon's record as the desktop's does | 2026-10-18 |
| 922 | The organisation's, each team's and each worker profile's memory documents are kept on the plane, every version with who saved it and audited, edited in the console by the administrators whose they are, each at most 8192 bytes; every session in a scope reads them as instructions from the organisation before the person's own file and the repository's, in that order, a pod's from the activation and a laptop's from the daemon's signed copy of me.memory, and no agent can change one | 2026-10-18 |
| 921 | A person offers one of their laptop sessions to the plane, shared at offer time with the people they name; the laptop dials one connection the plane relays protocol messages over, both ends hold each message to one table and the laptop to its own record of the share, the plane keeps no copy, and a withdrawal or a drop ends every remote view at once | 2026-10-18 |
| 920 | agents.list is the one list every agent picker reads, for a workspace or a session (a pod session's its bundle's), each row saying where it comes from in four words, what it stands in for and whether it may be changed; the desktop picker starts, switches and opens a file; and the plane checks a draft's agents with the daemon's rules, which the console's agent builder asks one at a time | 2026-10-18 |
| 919 | The plane signs its version policy and its organisation's document with an Ed25519 transit key of its own, made on first use and never exportable; the terminal, the daemon and through it the desktop app pin that key per plane at sign-in, take only what it signed, and take a changed key only when a person accepts its fingerprint; the plane names where releases are and can hand out their files itself, the release key still the check | 2026-10-18 |
| 918 | A running session explains what is in force in it, from the layers it started with, through config.get naming it, which a pod answers its session's own token too, troupe config --explain --session, the TUI's /settings and the desktop's Settings pane; a GUI test waits for a control as for words; and a trigger that stops taking a key loses it |
2026-10-18 |
| 917 | A trigger on a repository sweeps its open issues on a schedule and a person starts one from the console, each held to the trigger's policy; a comment on a run's draft resumes it as a review does; a sweep leaves an issue its runs have tried as often as allowed; and in GitOps mode a GitHubApp resource holds the App's settings and the teams' repositories, never its key | 2026-10-18 |
| 916 | No first-run screen in the desktop app waits on one reply: an answer late past a stated time says so and gives the buttons back, a lost answer or a reopened socket asks the daemon where the run stands, and a newer record means the run finished; a finished plane run lands where a start does, and a device-code sign-in opens the provider's page | 2026-10-18 |
| 915 | A test waits for what arrives after an async step rather than asserting it at once, sets no environment variable another test can read, runs against a plane test database of its checkout's own, and the GUI's client tests read nothing from outside clients/gui that the image is not given; the nightly runs every suite again and names each test that failed in any run |
2026-10-16 |
| 914 | Only a webhook that names no repository has a trigger key, and POST /trigger/<id> opens no other; a run by hand is one per caller per minute; a refused adoption is settled by a platform admin or by a later sign-in that agrees, folding the sign-in's row into SCIM's; a push the unique externalId refuses is a 409 naming the pair; and a manifest written after a removal names the tombstone until somebody new arrives under the subject |
2026-10-16 |
| 913 | A repository's WorkerProfile may name the profile it extends in spec.extends and say only what differs; the plane resolves it and writes the flat profile in effect into status.effective, which the operator and admission read, the operator creating nothing until it is there; and a profile's spec.permissions are an enforced scope on its pods, each profile of a chain its own, a parent's rules kept, and a shell deny refusing a person's own ! command there too | 2026-10-16 |
| 912 | The console runs a trigger now and rotates a webhook trigger's key, so it owes the plane no method; it edits the organisation's enforced permission rules as rules, checked as typed by a reading of PermissionRule held to the module by shared cases; and a profile created on a channel, or moved onto one, carries that channel's MCP servers from that write | 2026-10-16 |
| 911 | A fix-loop run names only a repository its team lists, pushes to a public one only where its profile allows, never carries a denied path or a mounted secret, stops at its caps as three red rounds stop it, and has its tokens revoked when its session goes dormant | 2026-10-16 |
| 910 | A profile that extends one on another channel loads one bundle the plane composes from the channels of its chain, added by name with override: true in the document to replace, published as a version of the plane's own profile: |
2026-10-16 |
| 909 | The plane reads no request body over four mebibytes on any route, refusing one by its declared length before reading it; a plane with a control certificate takes TLS only unless told false, and warns when it takes plaintext; removing the GitHub App deletes its key and webhook secret from transit; and the desktop app counts as running only a daemon that answers initialize with the file's token, started off the window's thread |
2026-10-16 |
| 908 | A worker profile may extend one other profile; the plane resolves the two by #655's merge rules into the flat profile it writes to the cluster, keeps what the child wrote beside it, and rewrites every child, after a preview, when the parent changes | 2026-10-16 |
| 907 | Per-tool permission rules are permissions.deny, ask and allow in any config file, each a tool with an optional pattern; every scope's are kept together rather than replaced, the most specific inside one file and the strictest across files deciding a call; the harness refuses on a deny, asks on an ask whatever auto_approve or an allow for the session says, and runs an allow unasked unless a person must answer, the branch of a saved comment, or managed_permission_rules_only holds it; an untrusted project's allow is held; an organisation enforces rules as a fourth kind, rules, that adds rather than holds |
2026-10-16 |
| 906 | A sign-in or a SCIM push adopts the row SCIM gave its subject as externalId only when that row's email or userName agrees, and otherwise merges nothing, audits it and lists the pair; a SCIM PUT replaces the person at its id; a push under removed: or svc: is refused; a removed person comes off notify lists and their spend goes to the tombstone; and the chart's control port takes TLS only by default, saying a plaintext refusal once a minute per address, with a PlaneCAMissing condition on a profile whose namespace has no CA |
2026-10-16 |
| 905 | The GitHub App's webhook, signed with a secret transit holds, starts a run of a trigger on a repository from a labelled issue or a member's command, with the issue fenced as data; a review on the draft that run opened resumes its session; and a new webhook trigger is made with its key | 2026-10-16 |
| 903 | A profile preview compares the stored profile with the write laid over it; enabling a team's group again changes none of its settings unless asked to link; the plane's own subjects are no person's; a removed person's sessions stay theirs through a rebuild; and a push GitHub took that the plane missed is recorded by the next one | 2026-10-14 |
| 902 | The operator copies the plane's control CA, its certificates alone, into every worker namespace on every pass and pods dial the control port with TLS against it; plane.controlTls.requireTls closes a plaintext connection after its first byte, off in 0.19 and on by default from 0.20; and the listener reads that byte and hands it to TLS through a transport of its own rather than putting it back with unrecv |
2026-10-14 |
| 901 | The console's Configure area draws worker profiles, configuration bundles and triggers; its profile editor writes only the paths it has fields for and carries the rest of the spec, each role is shown what the plane answers it, and every LiveView page stays until the last slice | 2026-10-14 |
| 900 | The plane's profile editor writes only the spec paths it has fields for, and carries everything else in the spec through a save as it was loaded | 2026-10-13 |
| 899 | A plane holds one row per person and per group: a push or a sign-in that finds nobody under its subject reuses the row SCIM gave that externalId, duplicates are merged into SCIM's row before users.external_id is made unique, and a SCIM DELETE removes a person behind a tombstone and a group with the team built on it alone |
2026-10-13 |
| 898 | A worker container runs under the chart's own Localhost AppArmor profile, containerd's default with bubblewrap's mounts and pivot_root allowed and more denied, loaded into every node's kernel by a container of the workers' profile DaemonSet with MAC_ADMIN alone and the host's securityfs; a worker under it is confined when it makes the sandbox's user namespace, so Ubuntu's restriction on unprivileged ones does not apply and the node's sysctl is left alone | 2026-10-13 |
| 897 | A sibling and a fork start on their parent's repository, checked again as a create checks one, and are refused rather than started without it | 2026-10-13 |
| 896 | An upload lands in session:/, the directory the session works in, which for a local session is the checkout, and says so; a path whose prefix names no mount is refused with the prefixes there are | 2026-10-13 |
| 895 | An agent revises a scratchpad document in place with patch, which replaces an exact span of it or adds to its end and is offered wherever show is, on every call; a document too long for one reply goes in parts, show its start and patch the rest on; a compaction leaves a long patch out for a pointer as it does a shown document; the live session that measures it runs under a window four times its first prompt; and, since that session cost more with the scratchpad, an agent uses it only when the person asks for a document or the answer would run past about 80 lines, and answers in the reply otherwise |
2026-10-13 |
| 894 | Every place a person picks a provider offers the provider types from one list in the protocol app, which the core, the plane and the daemon's answers to clients read, each asking only what its type needs, a WorkerProfile's llm settings refused without llm.endpoint rather than ignored; and every file of a person's own is in the one config directory, the two an older build kept under ~/.config on Windows moved in the first time they are asked for | 2026-10-13 |
| 893 | The plane's control port serves TLS with a certificate cert-manager issues for the control Service through the chart, beside plaintext told apart by the first byte; a registered machine is given the certificate's CA at registration, pins it, and enrols over TLS alone, its secret refused in plaintext before it is looked at and never sent without TLS; a pod may still enrol in plaintext on the pod network | 2026-10-13 |
| 892 | The console does a team admin's daily work, and the plane's index and the LiveView console's landing page point at it; the LiveView console stays as the way in when it cannot be used | 2026-10-13 |
| 891 | A pod session pushes its troupe/* branch through GitHub's API as the plane's App, opens a draft pull request and reads its CI with worker-owned tools whose token its profile narrows; three red CI rounds close its pushes, and nothing merges | 2026-10-13 |
| 890 | A worker container runs under the seccomp profile the chart chooses, by default the chart's own Localhost profile (the runtime's default plus the namespaces bubblewrap makes) put on every node by a DaemonSet that mounts that one directory, and a worker pod runs in a user namespace of its own with its /proc unmasked, so bubblewrap can mount the sandbox's own; kind uses Unconfined | 2026-10-12 |
| 889 | The cluster suite runs on a pull request that changes what it deploys, into main and into a chunk alike, and applies the CRDs and admission policy before it builds anything | 2026-10-12 |
| 888 | orchestrate is the one agent that orchestrates, a workflow is a plan it is started on, and the live bench compares it with build on the same tasks | 2026-10-12 |
| 887 | Provider types are one table that every reader takes them from; ollama, openrouter, azure_openai and gemini go through the OpenAI adapter with their differences in one module, Gemini through its OpenAI-compatible endpoint; a name that is no type is refused, and migrate rewrites the ones people mean another type by | 2026-10-12 |
| 886 | The administrative console is an app of its own in the GUI's workspace, built into the GUI's image and served at its own path on the plane's host by an Ingress of its own; it signs in with the plane's own sign-in and calls admin.* and me and nothing else |
2026-10-12 |
| 885 | A plane has one GitHub App whose key is in OpenBao transit; a session names one repository when it is created, and its pod clones it on the first activation with an installation token the plane mints for that repository alone, read-only, which only the pod's own git ever holds | 2026-10-12 |
| 884 | A worker pod admits no browser page whose origin is not listed; the desktop app's own origins and the GUI the chart serves are admitted without a list | 2026-10-12 |
| 883 | An egress entry is an exact name or a wildcard of one leading label; anything else is refused in the policy and in a profile, and a policy holding one admits nothing | 2026-10-12 |
| 882 | New code cites no decision by number; it states its invariant in its own words, and a check on each change keeps it so | 2026-10-12 |
| 881 | A folder inside another repository follows git, a tracked or addable one belonging to the repository and an ignored one being a workspace of its own, for worktrees, the brief and the desktop app's check; and worktree.list answers in bounded time, its status read for two seconds, the checkout first, or not at all with status false | 2026-10-12 |
| 880 | An organisation's enforced max_tokens holds every model call, the room a reasoning effort gives the thinking included: Anthropic's thinking is shortened to fit, is off below 1,024 tokens, and the session is told once on a config_note | 2026-10-12 |
| 879 | A worker profile's personalTools travels to the pod with each activation, a forbidding pod refuses before any challenge and logs it, and a client takes a forbidden refusal as the answer for the whole attachment | 2026-10-12 |
| 878 | A compaction leaves the words of each document show put on the scratchpad out of what it keeps, and out of what its summariser reads, for a pointer naming the document, its title, version and size and the read_file call that reads it back, and its summary lists every document on the scratchpad; read_file reads scratch:/<name>, read-only; nothing else changes the prefix |
2026-10-12 |
| 877 | The desktop app draws a turn in frames from docs/design/frames.md, its answer from marked's tokens as elements with raw HTML as text; quiet by default from transcript.detail, a click on the strip opens the turn, /detail sets it for a session; reasoning it saw stream is kept live only; a curtain line says what runs |
2026-10-12 |
| 876 | The skills a turn's first call finds are held to the turn's end as its MCP tools are, a call to one that went is told so, and what that call held is written on its llm_request and folded, so an agent restarted in the middle of a turn offers what the turn began with |
2026-10-12 |
| 875 | Every URL the daemon calls for a person's own MCP server and its sign-in is resolved, every address it answers is checked against Decision 856's list, and the request goes to the address checked; loopback and the private ranges stay allowed | 2026-10-12 |
| 874 | The desktop app updates itself and the daemon beside it only from a release the release key signed, follows the plane's recommended version and says its update_required, and asks before it restarts; the terminal says the plane's suggest in a line | 2026-10-12 |
| 873 | An install whose programs TROUPE_BIN_DIR moves is one of its own, and its uninstall and clean install remove and stop only what is in its directories or names them, leaving what every install shares to the default one | 2026-10-11 |
| 872 | A 403 insufficient_scope from a person's own MCP server is the sign_in_required answer with the scope it named, and the person's next sign-in asks for it on top of what was granted, at the same authorization server; signing out revokes the refresh token at the provider when it can be told, and forgets it whether or not | 2026-10-11 |
| 871 | An MCP server's or a person's client's tools that come or go change the tools at the next turn, never in the middle of one, on every model; on a model that binds its thinking goal_complete is offered on every call of the root agent and refused outside a loop; and binds_thinking says a model binds when its name hides it |
2026-10-11 |
| 870 | An agent shows a long answer on the session's scratchpad with show: a named document beside the session's log, addressed as scratch:/<name>, replaced under the same name, each write a durable scratch_updated; scratch.list folds them and fs.read reads one; the scratchpad is display only, so nothing in the conversation is replaced |
2026-10-11 |
| 869 | An organisation's document, from a plane's cached copy or a managed file at a fixed path, gives a machine defaults below the user file and an enforced set above the command line; only the keys the schema marks can be enforced, each a ceiling, and troupe config pull refreshes the cached copy rather than writing the user file | 2026-10-11 |
| 868 | A plane holds each kind of client to a version policy (recommended, minimum, blocked) kept in its database; its initialize over /rpc refuses a client below the minimum or on a blocked version with update_required, and troupe update installs the plane's recommended version, never a blocked one or one below the minimum, and moves back only when the person names the version | 2026-10-11 |
| 867 | On a model that binds its thinking to the conversation, an agent is offered the same tools on every call, the task list's from the first; a compaction keeps its tail without that thinking, and the summariser reads none | 2026-10-11 |
| 866 | A trigger's notify_url is refused at every address a worker's endpoint is, read from Reach's one list, and anywhere in 100.64.0.0/10, by literal or by a name that resolves there, and is posted to the address checked; every IPv6 spelling of a v4 address is judged as it | 2026-10-11 |
| 865 | A release's manifest is signed with one minisign key held by CI, every client is built with its public half, and troupe update installs only what that key signed, replacing the daemon between turns | 2026-10-11 |
| 863 | A session's system prompt is the same on every call by default, and what changes during it reaches the model as turn context, logged and folded so a restart sends the same prefix; per_turn is the old prompt by name, thinking_binding: drop_block an opt-in fallback, error the refusal asked for, and the API's mismatch header is kept on llm_response in its own words |
2026-10-11 |
| 862 | A worker profile may forbid people offering their own signed-in tools to its pods; allowed is the default, and a pod on a profile that forbids it refuses the offer with a sentence | 2026-10-11 |
| 861 | When a person's own tools go mid-turn, a call in flight waits the grace for them to come back and is otherwise told once that they went and that it may have run; later calls find no such tool | 2026-10-11 |
| 860 | Of #248's five options for repository memory, options 1 and 2 shipped in 0.10.0 and 0.11.0; deriving memory from the session log, symbol anchors, a co-change graph, vectors and the plane's shared levels are deferred, each with what it waits for | 2026-10-11 |
| 859 | On a pod, a role the plane narrows holds at the caller's next command: the guard answers the scopes that command runs with, the mirror's role intersected with the token's; it narrows and never widens | 2026-10-11 |
| 858 | Troupe's own git does not run in a repository whose objects lead out of its checkout, through an alternates entry or a link in .git/objects | 2026-10-11 |
| 857 | A config and the two MCP processes print through an Inspect of their own: model keys as :redacted, an MCP server's env and headers by name; the session goes on with the values |
2026-10-11 |
| 856 | A worker reaches no link-local or cloud metadata address by name or literal: with Cilium they are denied by address, except a NodeLocal DNSCache and the installation's own; without Cilium the public rule also leaves out 100.64.0.0/10 | 2026-10-11 |
| 855 | A session's files are under its own state directory everywhere, and the index reads every state directory it knows and keeps a dormant session's row until its log changes; a stop runs in its stopper's process; a command for a session being stopped waits up to five seconds and wakes it afresh, or is told it is stopping; an agent slow to answer the sweep is unknown, not gone | 2026-10-11 |
| 854 | A fact's anchor is held to what git tracks when it is read back too, cached by the index; remember's old form is gone; memory.get takes control and says whether a model can be asked; onboarding outside a repository is refused at a start; a file onboarding brought in says where it went, is found below the root, and counts as unchanged | 2026-10-11 |
| 853 | A parent starts a subagent in the background with delegate's wait false, reads it while it runs through read_branch's child, and stops it with stop_child, and each background subagent's end reaches its parent once, before its next model call or as its next turn | 2026-10-11 |
| 852 | agents.list lists the subagents when asked, a save names the hash of the file it replaces and is refused over one that changed, a file that does not parse is opened to mend through agents.get, and the desktop app's palette, watch box and transcript show what the daemon and the log say | 2026-10-11 |
| 851 | worktree.list asks each tree one git status --porcelain=v2 --branch, the checkout's branch its upstream for that call, worktree.remove answers a git that refused as merge and discard do, and read_branch says when no branch has finished |
2026-10-11 |
| 850 | A delegation asks the person first only for an agent they opted into, through delegation.ask in a config file or delegation ask in the agent's definition, at the session's approval gate with five answers, and orchestrate is a primary nobody gets unless they choose it | 2026-10-11 |
| 849 | troupe daemon open runs outside the reaper so the daemon it starts outlives it, a stdio MCP server gone before a write is given a status, clip is given UTF-16LE, /upload weighs a file before reading it, and a protocol client answers its pending calls as it stops |
2026-10-11 |
| 848 | The sessions index never waits on a session; its sweep asks from a task and decides from the answers, a stop runs in a task of its own, a session being stopped reads as dormant until its tree is gone, and a read is answered from a task | 2026-10-11 |
| 847 | A delegation has a contract both ways, a brief in five parts refused before any child starts when one is missing, and a finish in parts whose changes Troupe counts, with the full diff only through read_branch | 2026-10-11 |
| 846 | Every program the daemon, the worker and the TUI start by name is found on PATH alone, through Troupe.Executable, never in the current directory or a relative PATH entry, and a command given as a relative path is taken from the workspace | 2026-10-10 |
| 845 | A WebSocket says at initialize the largest message its socket takes and reads a frame as one message, the TUI sends nothing larger and outlives a dropped call, and on Windows it finds a program on PATH alone | 2026-10-10 |
| 844 | A saved AI! or AI? comment starts a quick or answer branch of the watching session, in its checkout, never a turn of its own agent; the branch asks before every write unless watch_auto_approve is on; watch state is on the protocol | 2026-10-10 |
| 843 | The branch commands do what their rows and TUI Decisions 39, 42 and 57 say over the daemon, a session's own window is not dismissed, and read_branch lists no parent | 2026-10-10 |
| 842 | The desktop app edits an agent's file as text, leaving every line its form did not change, asks once before a save that lets a tool run without asking that the replaced file did not, and switches a window among the agents its session could run | 2026-10-10 |
| 841 | An agent is read whole, checked as it is saved and written into the user or project scope through the daemon's agents.* methods and onboarding's confined writer, and a session's or branch's agent changes with profile.switch, read from its file at the switch, keeping the conversation | 2026-10-10 |
| 840 | worktree.list says how each worktree stands against the checkout, the commits ahead and behind and the lines it would bring, untracked files included | 2026-10-10 |
| 839 | remember and the librarian write facts anchored on the files they were read from, with evidence Troupe takes from the session, and memory.get, memory.forget and the TUI's /memory show and forget them one by one | 2026-10-10 |
| 838 | A repository's memory is facts kept one per line with what they rest on, their status worked out when read; the prompt carries the commands and conventions and names recall for the rest, and .troupe/memory.md is a view generated from them |
2026-10-10 |
| 837 | How a shell call's command ended is a field of its tool_call_completed, beside an ok that keeps its meaning, and the model reads the text it always did | 2026-10-10 |
| 835 | A session's start asks about onboarding first and starts the librarian only once that is answered, over onboard.plan, onboard.apply, onboard.decline and memory.decline; the librarian writes the brief only | 2026-10-10 |
| 834 | The offline bench onboards a repository for each other tool, accepting every proposal and a new AGENTS.md, then holds a task that only the onboarded instructions can make come out right | 2026-10-10 |
| 833 | Every git Troupe runs for itself in a workspace runs nothing the repository's own .git names and reads only the checkout's own repository, and the file tools never write under .git | 2026-10-10 |
| 832 | On a worker every command runs in the sandbox, whatever the session's mounts or bundle: the worker's own configuration sets it, the reaper wraps what it starts, and a worker that cannot start bubblewrap refuses the command with a sentence and says so once in its log; a local daemon is unchanged | 2026-10-10 |
| 831 | The project brief follows a worktree to its main checkout only when that checkout names the worktree back; otherwise it is the workspace's own | 2026-10-10 |
| 830 | A workspace's MCP server set to permission: auto runs its tools unasked only once the workspace is trusted; the start question grants starting it and says so; the workspace's layer reads nothing from outside the repository until trusted; a linked opencode.json gives its servers |
2026-10-10 |
| 829 | A workspace's .troupe/agents, commands, workflows and skills are read only where they really are inside it, and what its skills.json includes from outside the repository is read, and is a read root, only once the workspace is trusted |
2026-10-10 |
| 828 | A session reads no other tool's file at run time, CLAUDE.md, GEMINI.md, Copilot's and Cursor's rules and opencode's settings among them; each instruction file found is listed as not read, and Troupe's own rules are .troupe/rules/*.md |
2026-10-10 |
| 827 | Other tools' instruction files are onboarded once, their substance into the AGENTS.md beside them and their rules into .troupe/rules/, a new AGENTS.md is its own question, a session's start proposes and never writes, and onboarding and the brief carry a version | 2026-10-10 |
| 826 | On a pod the bundle's agents and skills, and Troupe's built-in agents, beat the working copy's of the same name unless the profile sets repositoryOverridesBundle; the losers are listed as skipped, onboarding refuses there, and a worktree reads its main checkout's committed files |
2026-10-09 |
| 825 | An MCP import copies no value written out, env as headers; a workspace's agent auto applies only once it is trusted; Codex's [mcp_servers] import |
2026-10-09 |
| 824 | Claude Code's and opencode's agents and commands are read once, as proposals for .troupe/agents/ and .troupe/commands/ files that Troupe's own loaders read back, with every key left out or changed said in the proposal's notes, rules for some uses never widened, and a model written only when it is not an alias |
2026-10-09 |
| 823 | Other tools' files are onboarded through one writer that reaches only the workspace's .troupe/ and the person's config directory, judged by real path, and every file it writes records where it came from, so troupe instructions check can say when that source changes | 2026-10-09 |
| 822 | Configuration is taken from the highest step of one ladder, built-ins, a pod's bundle, .agents/, AGENTS.md, the person's <config>/, the repository's .troupe/, and .agents/ is read as .agents/skills and .agents/AGENTS.md only |
2026-10-09 |
| 821 | troupe doctor --bench runs the offline bench's scenarios in troupe itself after the checks, a line each and one for the whole, holds them to the bench's own verdict, and --json is the same as one object |
2026-10-09 |
| 820 | An MCP server over HTTP is sent the headers its entry names, each written as it is or as an {env:VAR} read when the server starts; an import carries them and never copies a value written out; no keychain |
2026-10-09 |
| 818 | The installers offer to start the daemon at login once it is installed, Enter and -y meaning no, and an uninstall takes the entry back before it removes anything | 2026-10-09 |
| 817 | troupe setup walks the daemon's own first-run questions as one screen and writes nothing before its summary, and the daemon writes only what a person chose, so the same answers leave the same config.yaml as troupe config's questions |
2026-10-09 |
| 816 | troupe.openOnFolderOpen, off by default and a user or remote setting, opens Troupe as Troupe: Open does when a trusted window opens a folder, and not again after a reload, whose terminal is known by the process id the extension keeps for it; and "Troupe" is a terminal profile whose program is the TUI, a new terminal at Open's folder each time it is picked |
2026-10-08 |
| 815 | Issue #465's two ways out are settings, both off unless set, so a live bench can measure them before one is chosen; and every model call's log says what changed in front of what the agent had sent and what became of the thinking it handed back | 2026-10-08 |
| 814 | A command a file defines shows the prompt it sends in both palettes, and a workspace's asks once before it is first sent while auto_approve is on, its prompt in view |
2026-10-08 |
| 813 | A person's own command (shell.run, the TUI's !cmd) runs where the session runs, through the agent's own runner, for the session's owner or an admin holding control; what forbids the agent's shell forbids it; its output starts no turn and is given to the agent before its next model call unless !! kept it out |
2026-10-08 |
| 812 | /new and /back are built-ins; the daemon forks a session with session.fork, its log the parent's after session_forked; troupe resume takes latest, --private and --headless "message"; what another device holds or what is erased is refused, saying why and offering /new |
2026-10-08 |
| 811 | The plane destroys a team session's key itself, as it does a private one's; the session is erasure_pending and refused everything but a look and another erase until it has, a pod is recorded only once the key is gone, a pass every five minutes retries what the key manager refused, and the keys earlier erasures left are destroyed once on upgrade |
2026-10-07 |
| 810 | troupe instructions check reads the instruction files through the loader and reports contradictions between scopes, missing paths, missing programs and repeated rules, preferring a missed finding to a false one |
2026-10-07 |
| 809 | A repository's Cursor rules are read as Cursor reads them, an always rule in every prompt, a glob rule from the turn after a file it matches is worked on, a description-only rule listed by its description, and each says why | 2026-10-07 |
| 808 | The VS Code extension types troupe resume, troupe run, troupe doctor and troupe config into the folder's one terminal, never into one something runs in, and "Ask Troupe About This File" opens the TUI there with --prompt "@path "; a task's quotes are escaped for Windows PowerShell 5.1 and cmd.exe as each hands them on |
2026-10-07 |
| 807 | ui.theme is the theme both clients draw in and ui.blink whether what waits on a person blinks: the terminal UI acts on both, the daemon on neither, and a theme a client does not know is drawn as Afterglow |
2026-10-07 |
| 806 | Copilot's instruction file is read at the repository root only, and every instruction file left out says why, in words, in context.get and the session's log |
2026-10-06 |
| 805 | Anthropic's newest models think whether or not they are asked to, so their thinking goes back to them within a turn as it does when an effort turns it on; and a provider error the retries outlast, or one inside a stream, is said in the provider's words, trimmed and without the key | 2026-10-06 |
| 804 | An erasure reads every delete's answer and deletes a thousand versions to a request; a version the store keeps leaves the device or pod unrecorded and told again, and the plane answers a daemon's session.erased within its call and finishes a longer deletion after it |
2026-10-06 |
| 803 | Every response on the plane's host carries a Content-Security-Policy that runs only this release's own script files, set by the two servers that answer there, the plane's endpoint and the GUI image's nginx, not by the ingress; the app's connect-src is the plane, the daemon at 127.0.0.1 on any port, and other hosts only over TLS | 2026-10-06 |
| 802 | On Windows a daemon a client starts gets a console of its own, minimised, as the login entry's does, so closing the terminal it was started from leaves it running; and troupe-daemon open takes the web app's address from the plane's discovery document, plane.app |
2026-10-06 |
| 801 | A test waits for as long as what it waits on can honestly take, and a daemon a test starts in its own OS process loads the build through a cached code path, not a -pa for each directory | 2026-10-06 |
| 800 | A daemon sealing a private session names the epoch it holds in every write it asks the plane to sign, and the plane signs nothing for an epoch another device has claimed past, so a device that lost the session writes nothing more under its prefix | 2026-10-06 |
| 799 | A model its provider does not serve has no window in troupe models, as text or JSON, whether a role names it or not, and the VS Code extension's Settings view shows a config that does not load as the errors troupe config --explain --json prints |
2026-10-06 |
| 798 | A turn reads the instruction files once, as it begins, from the directories on the way to the workspace and to every file its conversation worked on, and follows a file's @imports five deep inside the repository | 2026-10-06 |
| 797 | troupe-daemon open starts the daemon and opens the web app with the loopback WebSocket's port and token after a #; the page takes them off its address bar and keeps them in localStorage, and the loopback admits the linked plane's origin and the page's |
2026-10-06 |
| 796 | Every CI job names its runner image, Ubuntu 26.04 where a trial ran it, and stops at about three times its usual length | 2026-10-06 |
| 795 | A release's generated notes no longer open with the one-line install of the daemon, the TUI and the VS Code extension | 2026-10-06 |
| 794 | The VS Code extension's Settings view has a Models group, what troupe models --json lists for the folder, each model with its window, its price and where they came from, the three roles marked, and one its provider does not serve said so and given no window; --refresh only from the group's own button. |
2026-10-05 |
| 793 | An agent with every tool is offered the task list only once its turn has made ten model calls or while there is a list, so a small task takes no calls for one; plan and workflow have it always. | 2026-10-05 |
| 792 | The task list in the system prompt is the one the turn began with, so a rewrite within the turn leaves the cached conversation alone, and the todo_write result says the list from then on. | 2026-10-05 |
| 791 | A provider's error reaches the adapter whatever the transport does with its body, so a context overflow over a real connection is compacted, and a person reads what the provider said, trimmed and without the key. | 2026-10-05 |
| 790 | A decision is a file of its own, naming the paths it governs and what must not be undone there | 2026-10-05 |
| 789 | Erasing a private session on the daemon erases it at the plane first, as an erasure started there goes, and erases nothing where the plane cannot be asked; a sealer whose report the plane refuses as stale stops | 2026-10-05 |
| 788 | A model call the agent gives up on is stopped, at its timeout in a turn or in a compaction and on a cancel alike, and what the provider had reported of it is counted as any call's figures are | 2026-10-05 |
| 787 | Every model call names Troupe to the provider: a User-Agent with the version, the client and the platform everywhere, LiteLLM's tags and spend-log metadata to a gateway, OpenRouter's app headers to OpenRouter. A local session names the software and nobody, and identify: false sends none of it |
2026-10-05 |
| 786 | An erasure deletes every version under a session's prefix, however many: the list it deletes from follows S3's markers to the last page | 2026-10-05 |
| 785 | A daemon's session.list says a private session is private and how its sealing stands here, and session.claim takes one another device sealed last over on this one, where this copy holds what the plane has |
2026-10-05 |
| 784 | A daemon carries on, registers and seals a private session only for the person it belongs to: somebody else's link leaves the first person's sessions alone and says so, and unlinking stops the sealing as signing out does | 2026-10-05 |
| 783 | troupe models --json prints what troupe models says as one JSON object for a program: the models with their prices as numbers, the roles, what the catalog fetched from where and when, and the named providers; never a key |
2026-10-05 |
| 782 | The desktop app and a headless run say what a turn cost, in the terminal UI's line, and @troupe/client writes the line |
2026-10-05 |
| 781 | A tool's result is cut at 32 KiB by default, not 60,000 bytes: what is cut is one read_output call away, and what is sent goes out again with every call after it |
2026-10-05 |
| 780 | A reasoning effort reaches an Anthropic model in the form the model takes: adaptive thinking with an effort level from Claude Opus 4.7 on, a thinking budget before it. And a gateway's cache writes over the OpenAI wire are cache writes, priced as such | 2026-10-05 |
| 779 | The compaction summariser reads the tool calls it summarises as text, and a summary that does not come within llm_timeout_ms is given up on |
2026-10-05 |
| 778 | The model catalog refreshes itself in the background, says what it fetched from where and when, and a model the configured provider does not serve fails doctor and is marked in troupe models, with the ones it does serve |
2026-10-04 |
| 777 | grep says how many lines matched in how many files before it lists them, and a task-list update goes with the call that does the work, not as a turn of its own |
2026-10-04 |
| 776 | On Windows the shell is Git for Windows' bash, never WSL's launcher; no command Troupe starts has the release's own runtime on its PATH; grep searches a file its path names; and a glob that matched nothing says so |
2026-10-04 |
| 775 | troupe bench --live is a benchmark: a standard suite of ten tasks beside the four-task smoke, each run's tool calls in its record, a score with its interval and a cost per success, and a run's directories kept on request |
2026-10-04 |
| 774 | A compaction never cuts between a tool call and its results, a summary that fails leaves the conversation as it was, and compacted keeps a large tool result as a blob |
2026-10-04 |
| 773 | troupe bench --live runs small tasks against the person's own model, under a cap it says before it starts, and keeps a history --compare reads |
2026-10-04 |
| 772 | troupe bench measures the harness offline against budgets kept in one file, and CI fails past one |
2026-10-04 |
| 771 | A large tool result a compaction left behind is sent from then on as one line naming the read_output call that returns it, not again in full on every call |
2026-10-04 |
| 770 | An agent's own model calls ask Anthropic to cache the prompt, with four marks: the last tool, the system prompt without its task list, and the last two user messages. An OpenAI-compatible provider caches by itself, and what either reports reaches the log | 2026-10-04 |
| 769 | What a turn cost is written on the event that ends it, and what each model call's prompt was made of on its llm_request, in bytes |
2026-10-04 |
| 768 | A build after VERSION changes writes the new version into every app's .app: each project that reads VERSION lists troupe_protocol's :troupe_version compiler after :app |
2026-10-04 |
| 767 | troupe --help and the command reference are written from two tables, the command lines beside troupe's parser and the harness's slash commands, and the TUI's suite fails when either drifts |
2026-10-04 |
| 766 | Signing out of a plane takes back the plane token the client handed the daemon, and the daemon seals nothing until somebody signs in again; the link stays | 2026-10-04 |
| 765 | VS Code reaches Troupe through a door, not a second client: the extension in clients/vscode has one command that opens anything, Troupe: Open, which types troupe --workspace <folder> into a terminal it opens at that folder, by default a tab in the editor area, one terminal per folder; its side bar shows the folder's settings as troupe config --explain --json reports them; and every release attaches it as troupe.vsix, which the installers' --vscode installs, on no marketplace yet |
2026-10-04 |
| 764 | A client signed in to a plane hands the daemon its plane token when it links it, when it reaches it, when the token is renewed and when the daemon restarted; a link that carries one is when the daemon carries on sealing what it could not; and both clients ask for a private session where the daemon reads it | 2026-10-04 |
| 763 | A command a person or a repository writes as a markdown file is a row of the command table, in a section of its own, and the harness runs it: the file's prompt, with what follows the name for $ARGUMENTS, goes to the session as input |
2026-10-03 |
| 762 | The daemon starts at login when a person says so: one module writes the platform's own per-user entry, removes it and says whether it is there, and a daemon started that way stays up until the person logs out | 2026-10-04 |
| 761 | The desktop app and the terminal UI share one set of settings: config.yaml at the ladder's scopes, served by the daemon with where each value came from, one key set into the scope a client names, and every client told when a file changed |
2026-10-04 |
| 760 | The desktop app shows a team session whose turn the harness stopped as failed, and says why in words | 2026-10-03 |
| 759 | A SCIM create answers 201 with where the resource is, a delete of an id the plane does not have answers 404, and a push with active: false deactivates a person the way a DELETE and a PATCH do |
2026-10-03 |
| 758 | With Cilium as without, a profile's endpoint at a loopback or link-local address is admitted by no rule and refused where it is set up, so the plane no longer needs to know which | 2026-10-03 |
| 757 | A session a newer credential replaced is ended when the new one is kept, a server a bundle drops has its sessions ended, and a 400 to a request in a session is a forgotten session, once |
2026-10-03 |
| 756 | Erasing a private session is final when the plane has destroyed its key, which it does itself and at once; the session is erasure_pending until then, and its objects and the device's copy go when the owner's daemon next connects |
2026-10-03 |
| 755 | A person's name at the key manager is a column of its own, fixed when the plane first knows them and left alone by a re-key, and whatever reaches the key manager for a person takes it from the plane | 2026-10-02 |
| 754 | The plane's SCIM endpoints answer a filter and take PATCH the way Microsoft Entra ID sends them, keep a user's userName beside the subject, and never move a person in a push |
2026-10-02 |
| 753 | A worker logs in to OpenBao under the role its pod is given and keeps the login until shortly before it runs out; the operator names a role per profile where the installation made them, and says a person-mode server's mode | 2026-10-02 |
| 752 | Without Cilium, a profile's own endpoints are admitted as the installation's are: a name on another port as the public rule's addresses on that port, an address as that one address on its port. One at a loopback or link-local address is admitted by nothing, and is what is still refused | 2026-10-02 |
| 751 | The person is the claim subject_claim names, sub by default and oid for Entra ID, and a plane switched to another claim moves each person it already knows once, at their next sign-in |
2026-10-02 |
| 750 | On a plane, a turn the harness stopped is a failed turn: the row says why, the run is failed and its target is told, and a pod whose session stopped under it puts it to sleep then | 2026-10-01 |
| 749 | Without Cilium, a profile's own endpoint its workers cannot reach is refused where it is set up, and reported on the profile where nothing could refuse it | 2026-10-01 |
| 748 | A person's own signed-in servers are offered to a pod session they open in the desktop app, as tools the app hosts, and the daemon makes every call with their sign-in | 2026-10-01 |
| 747 | A worker calls an MCP server as its profile's own identity, by OAuth client credentials with an assertion signed through OpenBao transit; the profile says who it is, and the bundle only that the server is called so | 2026-10-01 |
| 746 | An MCP server is opened with the lifecycle's handshake, and the session it issues is kept by whoever calls it, per server and credential, opened again once on a 404, and ended when the caller stops |
2026-10-01 |
| 745 | The desktop app shows a turn the root failed as a failure, and follows a daemon that restarted to where it is now | 2026-10-01 |
| 743 | A read writes nothing over a log an activation has, and a reader whose log has gone does not answer from it | 2026-10-01 |
| 742 | The chart keeps the namespace it makes and can be told not to make one, and a count the cluster did not take is sent again | 2026-10-01 |
| 741 | A person's own MCP server that wants them signed in, rather than a machine, is signed in to by the daemon, with PKCE and a loopback redirect, and its tokens never leave the person's machine | 2026-10-01 |
| 740 | The README is a front door, the quick start it points to is run by CI, and the product is shown with example data | 2026-09-30 |
| 739 | The documentation is one site, built from docs/ and the documents its nav names elsewhere, and each document stays where whatever reads it looks for it |
2026-09-30 |
| 738 | A profile whose workers are machines has nothing in the cluster: no WorkerProfile in direct mode, and a count of none on the one a repository holds |
2026-09-30 |
| 737 | In gitops mode a repository holds the triggers too, as Trigger resources the plane reads; a trigger's key, runs and revisions stay the plane's |
2026-09-30 |
| 736 | In gitops mode a repository holds the profiles and the policy, and the plane reads them from the cluster and never writes git | 2026-09-29 |
| 735 | A release publishes its images and its chart to ghcr.io, public, and deploys nothing |
2026-09-29 |
| 734 | This repository names no deployment of Troupe, and a check in CI keeps it so | 2026-09-29 |
| 733 | A reaper helper that will not start is an error its caller gets back, never a raise: the session answers, runs no command, and troupe doctor says why |
2026-09-29 |
| 732 | A reader takes the log it restored with it, and stays while a client reads the session; a fork whose parent's workspace listing fails makes no child | 2026-09-29 |
| 731 | A scale-down drains the pods it removes before it lowers the count, and finishes once it has started; a worker stopped by anything else drains itself | 2026-09-29 |
| 730 | On Windows the desktop app shows its notifications itself, so that a click on one opens its session, and it runs as one copy | 2026-09-29 |
| 729 | Dependabot moves Tauri's crates and its npm packages in one pull request, and keeps @types/node on the runtime's major |
2026-09-29 |
| 727 | A root agent that keeps crashing ends its turn saying why, and its session stops instead of starting it again | 2026-09-29 |
| 726 | A worker upgrade finishes by itself: the plane drains a pod behind once it holds no active session and records that on the profile, and the operator then deletes it | 2026-09-29 |
| 725 | An activation that fails takes away the log and the workspace it put on the pod, and leaves what it found there; a read and a fork name an unreachable store or key manager as an activation does | 2026-09-29 |
| 724 | Without Cilium, the operator admits the installation's own OpenBao and object store outside the cluster on the port they name: an address as that one address, a name on another port as the public rule's addresses on that port | 2026-09-29 |
| 723 | With Cilium, an allowed host that is an IP address is admitted as that one address, by a toCIDR rule |
2026-09-29 |
| 722 | A workspace is restored from what storage says it has, or the activation fails; a key manager the pod cannot reach is kms_unreachable; the worker image watches with inotifywait |
2026-09-29 |
| 721 | With Cilium, the operator admits the installation's own OpenBao and object store by name when they are outside the cluster; a pod that cannot reach its object store says object_store_unreachable |
2026-09-28 |
| 719 | On Windows the daemon's VM reads nothing of the console and has no break menu for Ctrl-C: -noinput and +Bc, and the null device for standard input |
2026-09-27 |
| 718 | A session starts without reading the workspace's ignore rules; watching reads them when it starts | 2026-09-27 |
| 717 | The desktop app's Tauri plugins move when tauri does, their Rust and JavaScript halves together | 2026-09-27 |
| 716 | The design tokens are one set of files, the GUI's; the plane's front page and the TUI are generated from them, and the front page stays in Signal | 2026-09-27 |
| 714 | A desktop notification leads back to its session, the launcher marks what was missed, and a first run's plane is signed in to without being asked for again | 2026-09-27 |
| 713 | A librarian's try at the brief is recorded when it starts, and one that built nothing holds off the next automatic refresh for memory_max_age_days |
2026-09-27 |
| 711 | A setting saved from a client changes its own line of config.yaml and nothing else; the file is edited, not rewritten |
2026-09-27 |
| 709 | The desktop app opens on the launcher, and a person who would rather start on the list says so once | 2026-09-27 |
| 708 | The desktop app shows a session's goal and its loop in the session's head, marks what happened while nobody was reading, and says it with the operating system's notification | 2026-09-27 |
| 707 | A session somebody is reading is never put to sleep, a call to a client's own tool outlives the connection that was serving it for a grace, and a session's row says what happened while nobody was reading it | 2026-09-27 |
| 706 | A repository's own instruction files are read into every prompt, from disk at every turn, in the order the other tools read them, and one table says what got in | 2026-09-27 |
| 705 | A first run's questions are one state machine in the harness, asked over the protocol, so both clients ask the same things and a run done in one is done in the other | 2026-09-27 |
| 704 | Every screen of the GUI is drawn in Afterglow, the launcher and the full-screen "new session" with them; a session doing nothing is idle, its own status with no colour, so queued can be the comp's amber |
2026-09-27 |
| 703 | The desktop app's icons are generated from the mask, in one fixed cut, and CI fails when the committed set is not what the design file says | 2026-09-26 |
| 702 | The GUI's design is Afterglow: its type, spacing and square corners in every theme, its palette as the default, and the three earlier palettes kept on the same contract | 2026-09-26 |
| 700 | A person's own MCP servers and skills live in two layers beside config.yaml, import from the files other tools keep, and a workspace's servers run only once somebody attached has said so |
2026-09-26 |
| 699 | The budget question is answered with how much more and for how long: a typed amount raises the limit that asked, for this run, this session or this workspace; an answer that cannot be read is asked back; a pod's terms are a ceiling | 2026-09-26 |
| 698 | The slash commands a client offers are one table in the harness, Troupe.Commands, published as commands.list; a client keeps only the code that runs each one, and the TUI's suite holds its set equal to the table |
2026-09-26 |
| 697 | A team's grant on a profile holds wherever one of its sessions could run or start: on the pod running it, in what that pod reports afterwards, when it is woken and when it is placed after a wait | 2026-09-26 |
| 696 | A librarian's run stamps the brief it checked, whether or not it rewrote any of it | 2026-09-26 |
| 695 | On Windows the desktop app installs into %LOCALAPPDATA%\Programs\troupe-desktop, and a setup moves an install out of the daemon's state directory |
2026-09-26 |
| 694 | A session that leaves its pod for good gives back its slot and its budget slice, each once, however it left | 2026-09-26 |
| 693 | A subagent is stopped once its parent has its result, and a restart closes what it leaves behind: the calls of a child nothing starts again, a turn's results already back, and a root's note about a failed request | 2026-09-26 |
| 692 | A user_input names the send it was taken from |
2026-09-26 |
| 691 | What troupe-daemon prints names troupe-daemon's commands, in ASCII, with paths as Windows writes them |
2026-09-26 |
| 690 | A pod's slot is given back before the session's row is marked, and a release that finds nothing to give back counts the profile again | 2026-09-26 |
| 689 | A model the catalog does not price is priced from models.prices, which a profile sets for its pods as llm.prices; the gateway's figure still wins, then the catalog's, and a model with no price anywhere is said once a session rather than counted as free in silence |
2026-09-25 |
| 688 | A delegation always comes back: a subagent whose model request fails hands its parent what it has, a child's path names one child for the life of the session, and a finish ends only the turn that called it |
2026-09-25 |
| 687 | A tool that keeps failing stops the turn and asks, whatever the budget says; always lifts only the limit it was asked about; and a delegate's turns are its own |
2026-09-25 |
| 686 | A config file has one key table, is read strictly, and says where each value came from; a workspace's own files set the keys that decide what may run only once the workspace is trusted | 2026-09-25 |
| 685 | The end of a turn is a durable event, turn_ended, beside the ephemeral agent_state |
2026-09-25 |
| 684 | A monthly budget is the calendar month in UTC, and it turns over because it is asked, not because a job runs |
2026-09-25 |
| 683 | A machine with no model settings is set up, not reported on, and opencode's can be copied | 2026-09-25 |
| 682 | An installer is downloaded, readable and pinned to its release, and it asks before it acts | 2026-09-24 |
| 681 | The installers take the same flags as scripts/install-local, and install the desktop app too |
2026-09-23 |
| 680 | A token with no groups claim says nothing about groups | 2026-09-22 |
| 679 | /loop runs its iterations as turns of the root agent, not as subagents; each ends with the agent's verdict as a tool call; and a loop the whole session came back from is stopped, not resumed |
2026-09-22 |
| 678 | A session has a goal: an event to set it, an event to clear it, and a section of the root agent's prompt on every turn in between | 2026-09-22 |
| 677 | A token with no groups claim says nothing about groups | 2026-09-22 |
| 676 | CI runs what a change can have broken; a release runs everything; a pre-release runs nothing | 2026-09-21 |
| 675 | A machine's model settings are the daemon's to read and write, and the plane never hands out a key | 2026-09-21 |
| 674 | A release is cut when a push changes VERSION, not whenever VERSION has no tag |
2026-09-21 |
| 673 | The clients in this repository get no private door, and four checks say so | 2026-09-21 |
| 672 | A profile's image may be release, and such profiles move with the platform |
2026-09-21 |
| 670 | charts/troupe serves the GUI, on by default, and plane.appUrl follows it |
2026-09-21 |
| 669 | A release is a merged change to VERSION |
2026-09-21 |
| 668 | One VERSION for everything this repository releases, and the TUI builds against the harness of its own commit |
2026-09-21 |
| 667 | The daemon is an application of this umbrella, released from its own directory | 2026-09-21 |
| 666 | This repository is the monorepo: the platform, the daemon, and the default GUI and TUI | 2026-09-21 |
| 665 | A team's name is an identifier, and the plane refuses one that is not | 2026-09-21 |
| 664 | The identity provider is configured from the console — issuer, client id, secret, endpoints, scopes — behind a check, with reset as the way back and break-glass as the reason it is safe | 2026-09-20 |
| 661 | A session whose tree a pod cannot put back is parked read-only, once, rather than left active for every client that opens it to fail on |
2026-09-20 |
| 660 | A spent budget is a question for the person attached, not a stop: allow buys the same slice again, always lifts that limit for the agent and its subagents, deny ends the agent; a budget the plane's terms set is a contract and stops; full_send never asks; an unattended session answers no itself |
2026-09-20 |
| 659 | A reply is looked at before it is acted on: a cut reply is asked again once, a cut tool call is answered rather than run, an empty reply is nudged once, a refusal ends the agent as refused, a prompt the provider refused as too long is compacted once and sent again, and a model error is a sentence somebody can act on | 2026-09-20 |
| 658 | A model's reasoning is a block of its own — opaque, provider-bound, replayed verbatim to the provider that made it and to no other — and a reasoning model gets the output cap it asks for | 2026-09-20 |
| 657 | Token usage is four disjoint figures — input_tokens, cache_read, cache_write, output_tokens — the budget charges what was billed, and compaction and the context gauge measure the prompt's whole length |
2026-09-20 |
| 655 | A limit is announced before it stops the agent, once, and a client can draw the gauge | 2026-09-20 |
| 654 | A workspace may name its own MCP servers, and a stdio one runs under the reaper like everything else | 2026-09-20 |
| 653 | The read tools may reach outside the workspace where the config says, and only the read tools | 2026-09-20 |
| 652 | Three read-only tools, in the core's shape | 2026-09-20 |
| 651 | A question is the other half of an approval, and it travels the same way | 2026-09-20 |
| 650 | What a tool had to cut is kept, and the marker says how to read the rest | 2026-09-20 |
| 649 | The project brief is a file the daemon reads into every prompt, and remember is the one tool that writes unasked |
2026-09-20 |
| 648 | A workflow is a prompt, and the daemon renders it | 2026-09-20 |
| 647 | A worktree ends in a merge or a discard, and a merge that cannot complete leaves no trace | 2026-09-20 |
| 646 | A branch is a session with a parent, and nothing more |
2026-09-20 |
| 643 | ezstd comes from the it-minds fork, because upstream does not build on Windows |
2026-09-20 |
| 637 | A projection must subscribe before it replays, and de-duplicate afterwards | 2026-09-19 |
| 635 | A root agent that finished is woken by the next input | 2026-09-19 |
| 634 | Runtime config names its atoms; it does not look them up | 2026-09-19 |
| 633 | A draining pod is handed out for nothing, and whether it is draining is the pod's own fact | 2026-09-19 |
| 593 | money/1 reads a zero as "no ceiling", so a spend is never rendered through it |
2026-09-17 |
| 592 | A rung with no ceiling never binds | 2026-09-17 |
| 591 | Budgets is a screen, and it does not set anything | 2026-09-17 |
| 514 | A rung with no ceiling is skipped, not consulted | 2026-09-16 |
| 498 | Budget is reserved before capacity, not after | 2026-09-16 |
| 497 | The plane holds the prompt while a session waits | 2026-09-16 |
| 475 | Setting a person's cap is a platform admin's, and it is done from the team page | 2026-09-16 |
| 474 | A session's slice is trimmed against the tightest ceiling, not only the team's | 2026-09-16 |
| 473 | A person's ceiling is Troupe's opinion, not the provider's | 2026-09-16 |
| 472 | A principal's spend counts against its sponsor | 2026-09-16 |
| 471 | A person's cap follows them between teams | 2026-09-16 |
| 470 | PersonBudget re-reads the ledger on every decision rather than caching what has been spent |
2026-09-16 |
| 469 | A rung that refuses unwinds the rungs that had already agreed | 2026-09-16 |
| 468 | One promise is one row, written by the ladder after every rung agrees | 2026-09-16 |
| 467 | The deployment's ceiling and the platform's are one rung | 2026-09-16 |
| 466 | A scope with no cap set does not participate | 2026-09-16 |
| 465 | A cap is a ceiling at any scope, and the tightest one refuses | 2026-09-16 |
| 461 | The target is checked at save and again at send, and the second check resolves the name | 2026-09-16 |
| 460 | An outbound notification target is absolute, off the loopback and on the egress allowlist | 2026-09-16 |
| 390 | session.presign checks the prefix rather than trusting it |
2026-09-15 |
| 383 | kms.assertion refuses a deactivated owner, and that is the door that mattered |
2026-09-15 |
| 382 | The harness checks on every call, not only at sign-in | 2026-09-15 |
| 381 | Signing in never reactivates somebody the provider deactivated | 2026-09-15 |
| 377 | The plane may see that a slot has a version, and nothing more | 2026-09-15 |
| 375 | me.connections.grant answers an assertion, not a token |
2026-09-15 |
| 322 | A release publishes the chart at its own version | 2026-09-14 |
| 301 | No rollup pipeline | 2026-09-13 |
| 300 | Ledger.Cache is ETS owned by a process, invalidated by the only writer |
2026-09-13 |
| 299 | A charge dated in the future is dated now | 2026-09-13 |
| 297 | A duplicate counts towards the watermark; a failed insert stops it | 2026-09-13 |
| 296 | usage.batch is a request, not a notification, and its answer is the watermark |
2026-09-13 |
| 290 | A call no gateway named gets seq:<session>:<n>, and reconciliation calls it unmetered |
2026-09-13 |
| 289 | Costs are parsed with integer arithmetic on the digits, never a float | 2026-09-13 |
| 288 | No price table | 2026-09-13 |
| 287 | Cost is a fold over the log, not a second write path | 2026-09-13 |
| 262 | A service principal's secret is a salted SHA-256, not argon2id | 2026-09-13 |
| 258 | Budget is reserved again on activation, since it is released on dormancy | 2026-09-13 |
| 257 | Terms are validated key by key, and budget_micros is trimmed rather than refused |
2026-09-13 |
| 256 | The prompt crosses the control channel once and is stored nowhere on the plane | 2026-09-13 |
| 253 | Terms become config overrides at the pod | 2026-09-13 |
| 196 | A latency measurement gives each of its five clients a session of its own | 2026-09-11 |
| 147 | Reconciling is by gateway request id and nothing else | 2026-09-11 |
| 146 | Reconciliation reports and never repairs | 2026-09-11 |
| 145 | Ledger.record/1 treats a repeat as a success, not an error |
2026-09-11 |
| 130 | Everything a client does goes through /rpc, and everything /rpc does goes through Troupe.Plane.Harness |
2026-09-11 |
| 125 | A bundle version is immutable and a session is pinned at creation | 2026-09-11 |
| 112 | A collaborator's input is billed to the owner's team budget | 2026-09-11 |
| 92 | The object store and the session layout live in troupe_protocol, not in troupe_worker |
2026-09-11 |
| 90 | The plane drives erasure but does not perform it | 2026-09-11 |
| 87 | A session nobody may see is not_found, not forbidden |
2026-09-11 |
| 79 | The plane signs session tokens through OpenBao transit and never holds a key | 2026-09-11 |
| 56 | Troupe.KMS lives in troupe_protocol |
2026-09-11 |
| 50 | Reservations are not spending | 2026-09-11 |
| 49 | A budget of zero means no limit, not no money | 2026-09-11 |
| 45 | Every reservation is written before it is granted | 2026-09-11 |
| 44 | Two things in the plane are decided by one process, not by a lock | 2026-09-11 |
| 37 | The operator is built on Bonny 1.5, not on hand-written watch-and-reconcile GenServers | 2026-09-11 |