Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
d0526af
docs: link the live demo from the README and Docker Hub
BattermanZ Oct 25, 2026
a5a3ed2
docs: say where Meaning Search is first turned on
BattermanZ Oct 25, 2026
25ffb90
Merge pull request #467 from BatterWorks/docs/409-link-the-demo
BattermanZ Oct 25, 2026
3559447
Settings grouped by whose a thing is, and Kitchen invites as links
BattermanZ Oct 26, 2026
b5e2147
Merge pull request #470 from BatterWorks/feature/469-settings-grouped
BattermanZ Oct 26, 2026
7d415cb
docs: publish the Shortcut that names Save from your phone
BattermanZ Oct 27, 2026
a0f1e6b
Merge pull request #471 from BatterWorks/docs/469-shortcut-save-from-…
BattermanZ Oct 27, 2026
26ef1f8
docs: retire the hand-run issue copy script
BattermanZ Oct 27, 2026
a561a01
Merge pull request #474 from BatterWorks/docs/retire-tracker-copy-script
BattermanZ Oct 27, 2026
1acd6be
Several Tags in one set_recipe_tag call; a Translation starts with it…
BattermanZ Oct 27, 2026
ac3d463
Merge pull request #475 from BatterWorks/feature/472-several-tags
BattermanZ Oct 27, 2026
d75b451
A Demo takes its public address from KAMOSU_DEMO_PUBLIC_ADDRESS
BattermanZ Oct 28, 2026
7e188f7
Merge pull request #476 from BatterWorks/fix/468-demo-public-address
BattermanZ Oct 28, 2026
b33cfa3
A list of everything sent to the agent, and how each one ended
BattermanZ Oct 28, 2026
6cc7d0e
Merge pull request #478 from BatterWorks/feature/463-agent-list
BattermanZ Oct 28, 2026
7b7b0ed
fix: rebuild the agent image for Alpine's python3 fix
BattermanZ Oct 29, 2026
0e0269d
Merge pull request #479 from BatterWorks/fix/agent-python-cve
BattermanZ Oct 29, 2026
4893296
fix: move the distroless base to the build with OpenSSL's fix
BattermanZ Oct 29, 2026
a8db27f
Merge pull request #480 from BatterWorks/fix/distroless-openssl
BattermanZ Oct 29, 2026
e1fa179
docs: prepare the v0.5.0 release
BattermanZ Oct 29, 2026
acd66fa
docs: bring the README level with v0.5.0
BattermanZ Oct 29, 2026
c2614b3
docs: name the two image fixes in the v0.5.0 changelog
BattermanZ Oct 29, 2026
26212e1
Merge pull request #481 from BatterWorks/docs/release-v0.5.0
BattermanZ Oct 29, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -399,6 +399,9 @@ src/core/ the Core, one file per area, all adding to one `Core`:
0048, #260, #262, #263, #264, #266, #268, #344)
shelves.rs the home shelves, and the shelf entry every list shows
translation.rs translation and a Branch's Language
sent_to_agent.rs everything a Person sent the agent, in one list: what
was sent as far as Kamosu holds it, how it ended, and
what to do next where it failed (#463)
reading_again.rs a Co-author asking for an agent to read a recipe again
from its kept Original, a file handed over again, or
its Source's link, and whether one can (#272, #273)
Expand All @@ -410,6 +413,9 @@ src/core/ the Core, one file per area, all adding to one `Core`:
several pictures as the pages of one recipe (#452),
kept under originals/ for its Job's Job Key alone and
in no Backup, and deleted 30 days after its Job ended.
A small copy of a picture and a PDF's first words are
kept beside it for the list of sends, and go with it
(#463).
The same file handed over again is known by its
contents, and a Job that failed on one is asked
again from it (#269, #270, #271, #273)
Expand Down Expand Up @@ -543,7 +549,7 @@ src/mcp_door.rs MCP endpoint generated by walking the Catalogue
src/browser_policy.rs
the three safety headers every answer carries: CSP,
nosniff and Referrer-Policy (#139)
src/config.rs the seven optional environment variables
src/config.rs the eight optional environment variables
src/http_min.rs dependency-free HTTP client for the self-run healthcheck
src/design_tokens.rs embeds and serves the generated stylesheet, fonts and icons
src/interface.rs embeds and serves the built Svelte app; owns the fallback
Expand Down
30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,36 @@

## Unreleased

## v0.5.0 - 2026-10-29

### After upgrading

- A Kitchen invite code made before this version can no longer be pasted anywhere: make a new invite, which is now a link. [#469]

### Added

- An Operator's invite can bring the newcomer into one of the Operator's own Kitchens, chosen beside *Make the invite link* in Settings › People, so a housemate needs one link for their account and their Kitchen. Agents pass `kitchen_id` to `mint_invite`. [#469]
- Agents put several Tags on a recipe, or take them off, in one `set_recipe_tag` call by naming them in `tag_ids`. They go on or come off together: if one cannot, none does and the recipe is left as it was. [#472]
- Settings › Add recipes › *Sent to the AI agent* lists everything you handed Kamosu's AI agent, newest first: the link, the first words of a text or PDF, or a small copy of a photo, then the recipe it made, or, for one that failed, the agent's reason on the row with a button to send it again, choose another photo or PDF, read it again or paste the text instead. Before, a failure was one tap down on its Report in *What has been brought in*, under the source it came in by. Agents read the same list with `list_agent_jobs`. [#463]

### Changed

- Settings is grouped by whose a thing is: *You*, *Your household*, *Add recipes*, and *This instance* for an Operator alone, with your name at the top and one short page for each job, each row saying what is inside. The Operator page is gone: its people, Backups, Runner, House Notes, public address and upkeep are pages of *This instance*. On a tablet or a computer the menu stays beside the page that is open. Every page says what it is in a line, a warning is said when its button is pressed, and the list of what Kamosu does not protect moved out of Settings to `SECURITY.md`. *Share from your phone* is now *Save from your phone*, and so is the page the iPhone Shortcut names when it asks for the setup code. An old address of a Settings page or of the Operator page opens its new page. [#469]
- A Kitchen invite is a link to send, which shows the Kitchen, who is in it and whose recipes it holds before the person joins, and can be cancelled until it is used. Before, it was a code the other person pasted into a field in Settings. Agents read a link with `read_kitchen_invite` and cancel one with `cancel_kitchen_invite`. [#469]
- A new Translation in the same Cookbook as its original starts filed under every Tag the original carries, each shown by its name in the reader's language where it has one. Before, a Translation started with no Tags. Taking a Tag off one afterwards leaves the other as it is. [#472]

### Fixed

- Kamosu's image is built on a newer distroless base, whose OpenSSL has the fix for CVE-2026-84782, and the agent's image is built again with Alpine's Python 3.14.10, which has the fix for CVE-2026-115557. Kamosu itself never loads OpenSSL. [#479] [#480]
- A demo's shared recipe shows its link. A demo takes its public address from the new `KAMOSU_DEMO_PUBLIC_ADDRESS` at every start, where before it had no way to learn one, and a shared recipe on an instance with no address says the address is not set instead of telling the visitor to end the link. [#468]

[#463]: https://github.com/BatterWorks/Kamosu/issues/463
[#468]: https://github.com/BatterWorks/Kamosu/issues/468
[#469]: https://github.com/BatterWorks/Kamosu/issues/469
[#472]: https://github.com/BatterWorks/Kamosu/issues/472
[#479]: https://github.com/BatterWorks/Kamosu/pull/479
[#480]: https://github.com/BatterWorks/Kamosu/pull/480

## v0.4.0 - 2026-10-25

### After upgrading
Expand Down
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "kamosu"
version = "0.4.0"
version = "0.5.0"
edition = "2024"
license = "AGPL-3.0-only"
repository = "https://github.com/BatterWorks/Kamosu"
Expand Down
2 changes: 1 addition & 1 deletion Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ RUN printf '%s\n%s\n' "$VERSION" "$GIT_SHA" > /stamp
# digest deliberately, the way a dependency is upgraded. `nonroot` runs Kamosu
# as uid 65532 rather than root, so an escape from the process lands in an
# account that owns nothing but /data.
FROM gcr.io/distroless/cc-debian13:nonroot@sha256:54df941ed0d06a1bd95ef5e0ce391fd8d9f94b64782dc9a60062727849ee3f97
FROM gcr.io/distroless/cc-debian13:nonroot@sha256:3ee00291cf386ec52a552e6a858d555debd74776eb4bfa53fa3df2cd6677515e
COPY --from=build /kamosu /app/kamosu
# /data exists in the image, owned by the user who writes it, so a fresh named
# volume mounted there starts out writable. A bind-mounted host folder brings
Expand Down
6 changes: 3 additions & 3 deletions GLOSSARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ The unguessable address at which a recipe can be read by anyone holding it — t
_Avoid_: Public URL, guest access, token link, published recipe

**Invite**:
A one-use link that turns a stranger into a Person, adds a Person to a Kitchen, or joins another Person's Cookbook to yours — a **Cookbook Invite**, which only somebody who already has an account can open, and which says how many recipes on each side become one before anything happens. Where either Cookbook has other Co-authors, accepting one joins nothing until each of them has said yes too (#135). Kamosu has no signup: every account begins with an Invite, and the first is the Operator's own, minted when the instance first runs.
A one-use link that turns a stranger into a Person, adds a Person to a Kitchen, or joins another Person's Cookbook to yours — a **Cookbook Invite**, which only somebody who already has an account can open, and which says how many recipes on each side become one before anything happens. A **Kitchen Invite** is opened the same way, by somebody who already has an account, and shows the Kitchen as its members see it before they join; the Invite that makes an account can name one of the Operator's own Kitchens for its newcomer to arrive in (#469). Where either Cookbook has other Co-authors, accepting one joins nothing until each of them has said yes too (#135). Kamosu has no signup: every account begins with an Invite, and the first is the Operator's own, minted when the instance first runs.
_Avoid_: Signup, registration, join code, magic link

**Access Key**:
Expand Down Expand Up @@ -137,15 +137,15 @@ Bringing recipes into Kamosu from elsewhere — another app's export, a web page
_Avoid_: Migration, sync, ingest

**Shortcut**:
The Apple Shortcut *Add to Kamosu*, which puts Kamosu in an iPhone's Share menu. It holds as little as it can: it sends whatever was shared to `add_this` with an **Add-only key** and shows the message Kamosu answers with, so every rule stays in Kamosu. It is set up once by pasting a *setup code*, shown once in Settings › Share from your phone, which holds the instance's address and a new Add-only key. Android needs none, since Kamosu installed from Chrome is in the Share menu itself (ADR 0055).
The Apple Shortcut *Add to Kamosu*, which puts Kamosu in an iPhone's Share menu. It holds as little as it can: it sends whatever was shared to `add_this` with an **Add-only key** and shows the message Kamosu answers with, so every rule stays in Kamosu. It is set up once by pasting a *setup code*, shown once in Settings › Save from your phone, which holds the instance's address and a new Add-only key. Android needs none, since Kamosu installed from Chrome is in the Share menu itself (ADR 0055).
_Avoid_: Shortcut key, iOS app, share extension, integration

**Import Report**:
What an **Import** made, as a person reads it — and it does not go away when the screen does. It says what arrived, including which recipes came as a bare name and a link; what is waiting for a tap, which is where a recipe the Import has seen before and found changed is offered rather than written over, and where **Related Recipe** candidates sharing a **Source** are ticked; and what could not be read at all, named with the reason, a damaged **Bundle** among them. It is read through ordinary Operations, so an agent asking how an import went is answered from the same place. Where an agent made a recipe, the Report says so, with what the agent left undone or was unsure of.
_Avoid_: Log, error list, summary, receipt, job output

**Original**:
What an agent's **Job** reads when that is not a link: a PDF, pasted text, or one or more pictures of one recipe, in order. It is kept for 30 days so the recipe can be read again, and it is never part of the recipe. It is read and never shown, which is what sets it apart from a **Photograph**.
What an agent's **Job** reads when that is not a link: a PDF, pasted text, or one or more pictures of one recipe, in order. It is kept for 30 days so the recipe can be read again, and it is never part of the recipe. It is read and never shown, which is what sets it apart from a **Photograph**. The one exception is a small copy of a picture's first page, shown to the Person who handed it over in the list of what they sent the agent.
_Avoid_: Attachment, upload, source file, scan

**Read Again**:
Expand Down
Loading
Loading