@audiofool/moondog 0.1.0 → 0.2.0-beta.2

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,28 +1,30 @@
 <p align="center">
-  <img src="assets/brand/moondog-lunar-record/moondog-logo-1x1.png" width="144" alt="Moondog lunar record logo">
+  <img src="assets/brand/moondog-lunar-record/moondog-logo-1x1.png" width="156" alt="Moondog lunar record">
 </p>
 
 <h1 align="center">Moondog</h1>
 
-<p align="center"><strong>A personal music agent that shows its work.</strong></p>
+<p align="center">Source candidate 0.2.0-beta.2</p>
 
-<p align="center">Your listening history. Your say in what it means.</p>
+<p align="center"><strong>A listening room that shows its work.</strong></p>
 
 <p align="center">
-  <img src="assets/demo/moondog-tui-home.png" width="1000" alt="Moondog's terminal listening room: a lunar record drawn in characters, a short menu, a Pink Floyd lyric, and a message box">
+  <img src="assets/demo/moondog-tui-home.png" width="1000" alt="Moondog's listening room in charcoal: a lunar record beside the wordmark, a four-line tracklist, and the line Is there anybody out there">
 </p>
 
-<p align="center"><sub>The real terminal app, shown with fictional listening data.</sub></p>
+<p align="center"><sub>The real TUI, in charcoal, with fictional listening data.</sub></p>
 
-Moondog reads the history your music services already keep and turns it into a profile you can open, question, and correct.
-It tells you what it found, shows the evidence behind every reading, and is honest about what play counts can never know.
-When you want company, an agent can use that profile to talk music, find songs you haven't heard, and shape a playlist with you.
+Moondog is a listening room in your terminal.
+It reads the history your music services already keep, and turns it into a profile you can open, question, and correct.
+The profile works without a model, an API key, or a music-service login.
+When you want company, an agent can talk music with you, find songs you have not heard, and shape a playlist.
+Your data stays on your machine.
+The room is built on [Pi](https://github.com/earendil-works/pi).
 
-It runs in your terminal, keeps your data on your machine, and is built on [Pi](https://github.com/earendil-works/pi).
+## Open the room
 
-## Start listening
-
-You need Node.js **22.19.0 or newer** on macOS or Linux.
+You need Node.js 22.19.0 or newer, on macOS or Linux.
+Install from this checkout to run the room shown here.
 
 ```bash
 git clone https://github.com/Audiofool934/moondog.git
@@ -31,95 +33,178 @@ npm ci
 npm start
 ```
 
-Your profile works without a model, an API key, or a music-service login.
-To see the agent at work with fictional data and no sign-in at all, run `npm run demo`.
+[@audiofool/moondog](https://www.npmjs.com/package/@audiofool/moondog) 0.1.0 is the published package.
+To see the agent work through fictional data, with no sign-in at all, run `npm run demo` from the checkout.
+
+The source version supports `moondog update` and `/update`, with stable (`latest`) and preview (`beta`) channels.
+Startup checks show a quiet notification; installation happens only when you request it.
+See [updating and release channels](docs/UPDATES.md), including the one-time upgrade needed for the older npm 0.1.0 package.
+
+## Other ways in
+
+[Moondog for Mac](app/README.md) is a native window on the same core as the terminal room.
+It shares your profile, settings, sign-ins, and conversations with `moondog`, and draws its own conversation, now playing, and up next.
+Run it from this checkout with `cd app && npm ci && npm start`.
+
+The [project page](site/README.md) runs the real room in a browser on fictional listening data.
+
+## The sleeve
+
+The opening is a record sleeve drawn in characters.
+Nothing in the terminal is a picture.
+On a wide screen the record sits beside the title, with the wordmark level with the dog's eye.
+On a tall or narrow screen the record stacks above the title.
+Moondog uses whichever arrangement leaves the record larger.
+A lyric rests midway between the record and the input box, with room on both sides.
+The input asks what you have been listening to.
+
+Until your library has a line of its own, the sleeve rotates three short ones: "Where have you been?", "Is there anybody out there?", and "Wish you were here."
+When a matching line from music you have played is available, that line takes the place.
+Moondog asks [LRCLIB](https://lrclib.net/) for the original words only, and does not send your profile, your history, or the conversation.
+
+The room is black and white, like the moon.
+Paper is black ink on white.
+Charcoal is moonlight on a black sky.
+`/theme terminal` keeps your own colors.
+The only other colors are the six from the prism on *The Dark Side of the Moon*.
+Red means a step failed, orange is a caution, green confirms, and the spectrum shows while Moondog is working.
+
+Press Tab on an empty input to step onto the tracklist, then use the arrow keys and Enter.
+
+| On the sleeve | Command |
+| --- | --- |
+| Listening profile | `/taste` |
+| Import your music | `/import` |
+| Appearance | `/theme` |
+| Help & commands | `/help` |
+
+While the room is idle, lunar marks travel the record, a highlight follows the groove, and the needle pulses.
+The dog and the wordmark stay still.
+`/motion off` holds the sleeve.
+`/art ascii` switches the drawing.
+`/home` returns here and leaves the conversation where it was.
 
 ## Bring your history
 
-Type `/import` and pick **Spotify**, **Apple Music**, **YouTube Music**, **QQ Music**, or **NetEase Cloud Music**.
-Moondog walks you through getting your data, then shows you what's inside before anything is added.
+Type `/import` and pick a service.
+Moondog shows you what is inside before anything is saved.
+When the import finishes, your profile opens in the same TUI session.
 
-- **Spotify:** your latest plays in a minute, or your whole history from the ZIP Spotify emails you.
-- **Apple Music:** the `Library.xml` you export from Music on a Mac.
-- **YouTube Music:** a Google Takeout export.
-- **QQ Music and NetEase:** any public playlist, from its share link.
-- **ListenBrainz:** a saved listens file.
+| Service | What you can bring |
+| --- | --- |
+| Spotify | Recent plays after you connect, or the whole history from the ZIP Spotify emails you. |
+| Apple Music | The Library.xml you export from Music on a Mac. |
+| YouTube Music | A Google Takeout export. |
+| Last.fm | Your scrobbles and loved tracks, read by username. |
+| QQ Music and NetEase | Any public playlist, from its share link. |
+| ListenBrainz | A saved listens file. |
 
-A Spotify ZIP can also go straight in:
+A Spotify ZIP can also go straight in.
 
 ```text
 /import "/path/to/spotify-history.zip"
 ```
 
-When the import finishes, your profile opens right there in the same TUI session, with the full report kept in the conversation above it.
 Importing the same file twice changes nothing, and your original files are never touched.
-Some sources aren't supported yet, such as Apple's privacy download and full QQ or NetEase listening history; the import guide says so where it matters.
-The [terminal guide](docs/TERMINAL_GUIDE.md#import-and-inspect-listening-history) covers every format in detail.
+Apple's privacy download, and full QQ or NetEase listening history, are not supported yet.
+The [terminal guide](docs/TERMINAL_GUIDE.md#import-and-inspect-listening-history) has every format.
 
-## See what it says, and tell it what it got wrong
+With a connected model, `/profile build` writes a reading of everything you imported, usually in a few minutes.
+It names the threads in your listening, keeps what you played apart from what you saved, and marks its interpretations as interpretations.
+A second pass checks the draft for contradictions and invented claims, and the build fixes what it finds before saving.
+Use `/profile saved` to read it and `/profile explain 1` to trace a finding to its evidence, including after restarting.
+New imports or corrections mark it for an update; a cancelled build keeps its draft and your previous reading.
+The builder sends a compact summary of your music evidence to your configured model when you ask for it.
 
-| In your profile | What you can do |
-| --- | --- |
-| **Find a song or artist** | Type to filter, then open the one you want. |
-| **See why it's there** | Read what you played, what that can't prove, and what you told Moondog, each on its own. |
-| **Make a choice** | Choose **I like this** (Like) or **Keep it out** (Avoid), and watch the profile update. |
-| **Change your mind** | **Undo my choice** at any time; you can retract anything, and the original listening history never changes. |
-| **Find more like this** | Start an editable request for three songs, seeded from the track you picked. |
+## Your profile
+
+The profile says what you played, and what that cannot prove.
+Playing a song a lot does not, on its own, establish how much it matters to you.
 
 <p align="center">
-  <img src="assets/demo/moondog-tui-profile.png" width="1000" alt="Moondog's listening profile showing the fictional track Midnight Lines, why it is there, and what that evidence cannot tell">
+  <img src="assets/demo/moondog-tui-profile.png" width="1000" alt="The listening profile for the fictional track Midnight Lines by Mara Vale, with the plays on one side and the limit of that evidence on the other">
 </p>
 
-<p align="center"><sub>The profile with fictional data. Playing a song a lot shows you know it, not that you love it.</sub></p>
+<p align="center"><sub>Fictional data, with the evidence and the limit of that evidence.</sub></p>
 
-Type `/taste report` for the whole picture on one page.
-It walks through your years one song at a time, finds songs that went quiet and songs that came back, and ends with the dark side of the moon: what your listening data can't tell anyone.
-You can also save it as a private web page that works offline.
-
-## Getting around
-
-| Command or key | What it does |
+| In the profile | What you can do |
 | --- | --- |
-| `/taste` | Open your profile. |
-| Type, ↑ ↓, Enter | Filter, pick, and see why something is there, or make a choice. |
-| Tab in the profile | Switch between All, Tracks, Artists, and Your choices. |
-| Esc | Go back; whatever you were typing stays put. |
-| Ctrl+P | Search every command. |
-| `/resume` · `/new` | Pick up a saved conversation, or start a fresh one. |
-| `/home` | Back to the record sleeve, without clearing the conversation. |
+| Find a song or artist | Type to filter, then open it. |
+| See why it is there | Read what you played, what that cannot prove, and what you told Moondog, each on its own. |
+| Make a choice | Choose **I like this** (Like) or **Keep it out** (Avoid), and the profile updates in place. |
+| Change your mind | Choose **Undo my choice**, and the original listening history never changes. |
+| Find more like this | Start an editable request for three songs, from the track you picked. |
 
-Each launch starts a new conversation, while your profile and anything Moondog remembers carry over.
-Change the look with `/theme paper` or `/theme charcoal`, switch the artwork with `/art ascii`, or keep it still with `/motion off`.
+Type `/taste report` for the long view.
+It walks the years one song at a time, names songs that went quiet and songs that came back, and ends on the dark side of the moon: what play counts can never tell anyone.
+You can save that report as a private page that works offline.
 
-## Add an agent when you want one
+## An agent, when you want one
 
-Sign in with `/auth` to GLM, Kimi, DeepSeek, Grok, GPT, Claude, Gemini, or OpenRouter, then pick a model with `/model`.
+Sign in with `/auth`, then pick a model with `/model`.
+GLM, Kimi, DeepSeek, Grok, GPT, Claude, Gemini, and OpenRouter are there.
 `openai-codex` uses your ChatGPT sign-in.
-You can switch models mid-conversation; the [model setup guide](docs/TERMINAL_GUIDE.md#enable-agent-conversation) lists provider IDs and environment variables.
-
-Ask for a route through your own history, reshuffle what it suggests, or reach past your library.
-Every song the agent picks has to come from a real list it looked up, and what it read about the wider music world stays separate from what it knows about you.
+You can switch models in the middle of a conversation.
+The [model setup guide](docs/TERMINAL_GUIDE.md#enable-agent-conversation) lists each provider and the environment variable it reads.
+
+While an answer is on the way, each step appears in the conversation as it starts.
+The steps stay above the reply, with a count of what finished, what failed, and what was not confirmed.
+The agent can use musical knowledge and web research to find candidates, then verify the recordings on Spotify before playing or queueing them.
+Without Spotify, it plays 30-second Apple Music previews from the terminal instead, each next to a link to the full song.
+It also sees what you already play: the song and playlist in the Music app on a Mac, or on Spotify's active device, so “more like this playlist” needs no names.
+macOS asks once before Moondog may read the Music app.
+For example, “Pon doce de salsa clásica a la cola” asks it to add up to twelve verified songs directly; your history guides the choice without limiting it to your library.
+What it reads about the wider music world stays separate from what it knows about you.
 
 | Optional connection | What it adds |
 | --- | --- |
-| **A model through Pi** | Conversation, discovery, and building playlists together. |
-| **Codex CLI** | `/web` lookups with links to their sources, using your own signed-in Codex CLI. |
-| **Spotify sign-in** | Playback control, and private playlists made only when you ask. |
+| A model through Pi | Conversation, discovery, and playlists built together. |
+| A web search service | `/web` lookups with links to their sources, through DeepSeek (`/auth deepseek`, which also reads pages), Brave Search (`/auth brave`), or your own signed-in Codex CLI. |
+| Spotify sign-in | Playback, and private playlists made only when you ask. |
 
 Your profile never touches the network.
-The agent and connected features talk to the services you set up; `/web` sends only the question or link you give it, never your profile, history, or files.
-Importing a Spotify ZIP doesn't need a Spotify sign-in.
+The agent talks only to the services you set up.
+`/web` sends the question or the link you give it, and nothing from your profile, history, or files.
+A Spotify ZIP does not need a Spotify sign-in.
 Read the [connection and data details](docs/TERMINAL_GUIDE.md) before you connect anything.
 
-## Explore further
+## Getting around
+
+| Command or key | What it does |
+| --- | --- |
+| `/taste` | Open your profile. |
+| Type, arrow keys, Enter | Filter, pick a row, and see why it is there, or make a choice. |
+| Tab in the profile | Switch between All, Tracks, Artists, and Your choices. |
+| Tab on the sleeve | Step onto the tracklist, then press Escape to return to the line you were writing. |
+| Esc | Go back, and the draft stays put. |
+| Ctrl+P | Search every command. |
+| Page Up, Page Down | Move through the conversation while the header, the draft, and the status line stay put. |
+| Up and Down in the draft | Recall what you typed in this conversation. |
+| Enter while Moondog is working | Queue the next message. It sends when this one finishes. |
+| `/resume`, `/new` | Pick up a saved conversation, or start a fresh one. |
+| `/home` | Back to the sleeve, without clearing the conversation. |
+| `/skip`, `/stop` | Skip to the next song preview, or stop the previews. |
+| `/lyrics` | See which line is on the sleeve, and which song it came from. |
+| `/theme paper` | Black ink on white. |
+| `/theme charcoal` | Moonlight on a black sky. |
+| `/theme terminal` | Your terminal's own colors. |
+| `/language` | Choose the language Moondog replies in: English, 简体中文, 繁體中文, 日本語, 한국어, Español, Français, Deutsch, Português (Brasil), or Italiano. Screens follow in English, Español, Português (Brasil), 日本語, and 简体中文. |
+
+Each launch starts a new conversation.
+Your profile, and anything Moondog remembers, carry over.
+
+## Further
 
 - [Terminal guide](docs/TERMINAL_GUIDE.md): import formats, commands, appearance, models, Spotify, memory, and your local data.
 - [Private Tasteprint](docs/PRIVATE_TASTEPRINT.md): what the evidence can support, and what a report reveals about you.
-- [Product charter](docs/PRODUCT_CHARTER.md) and [public roadmap](docs/ROADMAP.md): where Moondog is headed, and what it won't do.
+- [Product charter](docs/PRODUCT_CHARTER.md) and [public roadmap](docs/ROADMAP.md): where Moondog is headed, and what it will not do.
 - [Voice](docs/VOICE.md): how Moondog talks, and where Pink Floyd shows up.
 - [Runtime architecture](docs/ADR_0001_AGENT_RUNTIME_AND_CLI.md) and [data contracts](contracts/README.md): how the pieces fit together.
-- [Contribution guide](CONTRIBUTING.md) and [release readiness](docs/PUBLIC_RELEASE_READINESS.md): local setup, checks, and how private data is kept out.
+- [Contribution guide](CONTRIBUTING.md): local setup, checks, and how private data is kept out.
+- [Release status](docs/PUBLIC_RELEASE_READINESS.md): what is published, and what the checks cover.
+- [Translating Moondog](docs/TRANSLATING.md): how replies choose a language, and how to add one.
+
+## License
 
-Moondog is early, and the Pi-based TUI is where the work happens.
-GUI and Studio development is paused; the earlier [browser prototypes](docs/TERMINAL_GUIDE.md#archived-gui-prototypes-paused) are still there for reference.
-There is no open-source license yet.
+Moondog is open source under the [Apache License 2.0](LICENSE).
+Copyright 2026 Audiofool.