interlatch 0.27.3__tar.gz → 0.27.4__tar.gz

{interlatch-0.27.3 → interlatch-0.27.4}/CHANGELOG.md

@@ -3,6 +3,23 @@
 <!-- Don't add lines here: a pull request puts its line in a new file in changelog.d/ (see changelog.d/README.md),
      and each release moves the files it took into a dated section below. -->
 
+## 0.27.3 (2026-10-18)
+
+- **Windows in Japanese (and other languages):** Task Scheduler's and PowerShell's own messages now read in Windows'
+  language instead of coming out garbled, and a `claude.cmd` (npm) or another tool that reports an error in the console's
+  code page no longer ends `interlatch install` in a traceback. The tasks name your account by its SID, so a PC joined to
+  Microsoft Entra ID registers them too; a folder name with a full-width space works in hooks; an npm-installed Claude
+  Code gets the whole analysis prompt; the shared log no longer prints "Logging error" when another process holds it;
+  and the dashboard's scripts keep their type where Windows' registry calls .js plain text, which left the page blank.
+  The old console window prints `+` and `>` for ✓ and ›, the dashboard says Ctrl for ⌘ off a Mac, and the install steps
+  set PATH in the same window, where uv's installer left "uv is not recognized" ([Windows](docs/install.md#windows)).
+- **Adventure, rebuilt for learning:** the Adventure opens on a field to walk around in, one region at a time, its
+  roadmap modules as zones and your lessons worth studying as monsters (main quest first, your agents' own setup traps
+  left out). A battle is now a question from your own sessions: four answers written for the lesson, choose one and
+  Answer. Right beats the monster and fills your readiness for that module; wrong shows why, the answer and the
+  principle, and the lesson comes back tomorrow. Lessons you got right come back as you'd forget them (3, 10, 30, 90
+  days). Your answers stay on your own computer ([Adventure](docs/party.md#adventure)).
+
 ## 0.27.2 (2026-10-16)
 
 - **One row per browser on Team › People:** opening the hub from your own dashboard again no longer leaves the

{interlatch-0.27.3 → interlatch-0.27.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: interlatch
-Version: 0.27.3
+Version: 0.27.4
 Summary: Shared memory for your coding agents: records every session (Claude Code, Codex, Copilot, Bob, Antigravity, OpenCode) locally and keeps what they learned, each lesson linked to the session it came from.
 Project-URL: Homepage, https://interlatch.com
 Project-URL: Documentation, https://interlatch.com/docs/

{interlatch-0.27.3 → interlatch-0.27.4}/ROADMAP.ja.md

@@ -56,6 +56,11 @@ Interlatch にこれから入るものを、おおよそ取り組む順に並べ
   作りません）。エージェントには今までどおりすべての教訓を渡します。効果は、尋ねるのではなく、思い出せたかと、同じ gotcha が
   あなたのセッションでまた起きるかで測り、一人ひとりの指標はすべてあなたのコンピューターに残します
   （[設計](docs/design/ja/learning.md)）。
+- **モジュールでのあなた自身のレベルを、実際の仕事から。** Innerlatch の冒険では、学びの戦闘で正解した教訓が、すでに
+  各ロードマップのモジュールの準備度として数えられ、あなたのコンピューターに残っています。これから: 5 つ理解すると
+  そのモジュールのゲートが開き、あなた自身のプルリクエストかコミットを結びつけて、それがモジュールの確認にどう合うかを
+  2〜3 文で書きます。分析モデルが判定し、合格するとそのモジュールに「あなたが示した」と印がつきます。エージェントの
+  レベルとは別です（[設計](docs/design/ja/innerlatch.md#6-次-ゲートのボス)）。
 - **人の名前で、並べて見るチームメイトの教訓。** チームメイトの教訓は、プロジェクトのページと **All knowledge** に、
   どのコンピューターから来たかを示して表示されます。これから: コンピューター名ではなく人の名前で示すこと、週次レビューに
   チームメイトの教訓を入れること、2 人が述べた教訓を両方の事件として見せること（[設計](docs/design/ja/learning.md#4-チーム)）。

{interlatch-0.27.3 → interlatch-0.27.4}/ROADMAP.md

@@ -60,6 +60,11 @@ carefully.
   getting every lesson. Whether it works is measured by recall and by whether the same gotcha comes back in your
   sessions, not by asking, and every per-person measure stays on your computer
   ([design](docs/design/learning.md)).
+- **Your own level in a module, from real work.** In Innerlatch's Adventure, the lessons you answer right in study
+  battles already count toward your readiness in each roadmap module, kept on your computer. Still to come: five
+  understood open the module's gate, where you link one of your own pull requests or commits and say in two or three
+  sentences how it meets the module's check. The analysis model judges it, and passing marks the module as shown by
+  you, apart from your agents' levels ([design](docs/design/innerlatch.md#6-next-gate-bosses)).
 - **Teammates' lessons, by person and side by side.** They show on project pages and in **All knowledge**, marked
   with the computers they came from. Still to come: the person's name instead of the computer's, teammates' lessons
   in the weekly review, and a lesson two people stated shown as both their cases

interlatch-0.27.4/changelog.d/analysis-queue-dialog.md

@@ -0,0 +1,3 @@
+- **See the analysis queue:** click "N sessions queued for analysis" in the status bar to see which sessions are
+  waiting, why each one waits, and about when the background runs will analyze it. **Analyze now** in the same window
+  runs them at once.

interlatch-0.27.4/docs/design/innerlatch.md

@@ -0,0 +1,166 @@
+# Design: Innerlatch, learning from your own past
+
+[← Roadmap](../../ROADMAP.md) · 日本語: [ja/innerlatch.md](ja/innerlatch.md) · Related: [lessons people learn from](learning.md)
+
+Status: built in 0.27.3 (2026-10-18), except the gate bosses (section 6). The user guide is
+[Adventure](../party.md#adventure).
+
+Innerlatch is the game behind the door at the bottom of the dashboard's rail: the coding agents as a party of pixel
+characters, the Adventure, towns, formations and the arena. This page records what its Adventure is for, what a lesson
+and a battle mean in it, and why each part works the way it does, including what was tried and dropped on the way.
+
+## 1. The goal
+
+**You learn from your own past work and move along your career path.**
+
+Your agents learned these lessons in your sessions; the Adventure is where you make them yours. That sets three
+meters apart, and nothing ever moves one from another:
+
+| Meter | What it says | Where it comes from |
+| --- | --- | --- |
+| Your agents' levels | How much of each roadmap module their lessons cover | Lessons only (unchanged since the Party began) |
+| Your readiness | How many of a module's lessons you have shown you understand | Study battles you answered right |
+| Your level in a module | That you can do it | A gate passed with real work (section 6, planned) |
+
+Gold, gear and the arena stay a game around these: they change battle numbers, never a level, a readiness or XP.
+
+## 2. What a lesson and a battle mean
+
+**A lesson is a worked example from your own past**, filed under the roadmap module it speaks to. Until you show you
+understand it, it is study material your agents collected for you, not something you know.
+
+**A battle is one study rep on that example.** It opens on the scene (the moment as it was met, with the answer left
+out) and a question, with four answers to choose from. The lesson's title stays hidden until it is answered: titles
+often state the answer. You choose one, then **Answer**:
+
+- **Right** is the finishing blow: the monster is beaten, the first win pays gold, and the lesson counts toward your
+  readiness in its module.
+- **Wrong** lets it slip away. The end screen says why that answer is wrong, then shows the right one and the principle
+  behind it, the part that holds beyond that project.
+
+**Run** (or Esc) leaves at any time. There is no Attack, Skill, Item or Defend in a study battle: the knowledge is the
+only move.
+
+## 3. Decisions and why
+
+### What you explore: one region at a time
+
+The world map used to put every counted lesson on one continent as a monster: over a thousand of them on one archive.
+A map covered in icons reads as a checklist to clear, not a place (games call it "chickenpoxing"). The Adventure now
+opens on a **field**: one region, each roadmap module a zone joined by paths, a few monsters per zone, walked like a
+handheld RPG. The world map stays, without creatures, as an overview.
+
+### Which lessons become monsters: the ones worth studying
+
+- **Your main quest first.** Zones of the main quest's track hold four monsters, other zones two.
+- **Study material first.** Lessons with a case file's question or a principle come before the rest.
+- **Never your agents' own friction.** A gotcha that applies everywhere and keeps recurring, or one tagged as shell or
+  agent tooling (an aliased `rm`, zsh word splitting, where screenshots land), is a trap for the agents' rules, not
+  something for your career. On one archive that kept 97 lessons off the field.
+
+### How understanding is checked: multiple choice written for each lesson
+
+This took four tries:
+
+1. **Number fights.** The first battles were stat and dice fights with the lesson as decoration. Replacing every
+   lesson's text in 300 simulated fights changed none of them: nothing the person knew went in, nothing came out.
+2. **A pick from the case file with borrowed wrong answers** (the Diagnose experiment, closed unmerged). Only about one
+   lesson in ten had a case file, and 63% of the playable ones had no recorded dead ends, so their wrong answers were other
+   lessons' answers: easy to rule out. In about one case in five the title, shown first, held most of the answer, and a
+   wrong pick could simply be followed by the next one.
+3. **A typed answer judged by the model.** Honest and flexible, but it asked for writing in the middle of a game, and
+   it didn't land.
+4. **Multiple choice written for the lesson** (what shipped). The analysis model writes the scene, the question and
+   four answers once per lesson, from the lesson itself: the leads its session ruled out first, then likely
+   misconceptions, each with why it is wrong. The set is checked (exactly one right, no two alike, the right one never
+   the longest) and kept with the lesson. The first pick of a fight counts, and the server checks it, so no model call
+   is needed to answer.
+
+### When a lesson comes back: spaced, never overdue
+
+- **Right:** it rests and comes back for another look as you would start to forget it: 3 days, then 10, 30 and 90 as
+  you keep getting it right, marked ↻ on the field. Right on two separate days in a row, it is **owned**.
+- **Not right:** it stays off the field until tomorrow, whatever the result (a wrong answer, a win without one, Run).
+  Trying again right after seeing the answer is copying, not remembering.
+- **Never overdue.** No counts of what is due; a lesson that is back just waits on the field, and time away builds no
+  backlog ([learning design, rules](learning.md#rules-for-every-part-below)).
+
+### Where your answers are kept: on your computer
+
+Per-person learning data stays on the person's own computer ([learning design](learning.md)). Your answers are kept in
+your archive on this computer. Signed in to a hub, battles are the plain turn-based kind and nothing about your answers
+is kept there. The questions themselves belong to the lessons, not to anyone, and are kept with them.
+
+## 4. What the evidence says
+
+A research pass in October 2026 looked at boot.dev and two dozen other learning products, games laid over real work and
+AI-agent activity, game patterns that make knowledge part of the world, and the learning research. What carried the
+decisions above:
+
+- **The knowledge has to be the move that decides the encounter.** Children learned more, and chose to play about
+  seven times longer, when the maths was the combat itself rather than quizzes between levels
+  ([Habgood & Ainsworth, 2011](https://shura.shu.ac.uk/3556/)). It is not a blanket rule: separating the exercise from
+  play did better in one study with adults ([Nidd & Muldner, 2019](https://escholarship.org/content/qt8453p0gf/qt8453p0gf.pdf)).
+  The reading that holds: integration pays when the winning move forces the relevant thinking.
+- **Recalling beats rereading,** and the rereaders feel more confident: 56% against 42% remembered after a week
+  ([Roediger & Karpicke, 2006](https://psychology.ecu.edu/wp-content/pv-uploads/sites/216/2019/03/Roediger-Karpicke-2006.pdf)).
+  Multiple-choice practice with feedback works well
+  ([Adesope et al., 2017](https://journals.sagepub.com/doi/10.3102/0034654316689306)), and spacing helps it stick;
+  Duolingo's spaced review raised daily engagement 12% ([Settles & Meeder, 2016](https://aclanthology.org/P16-1174/)).
+- **A level means something only when a check stands behind it.** Boot.dev pays out only for work a machine has checked,
+  and in April 2026 replaced even its self-marked lessons with multiple-choice checks
+  ([Boot.dev, April 2026](https://www.boot.dev/blog/news/bootdev-beat-2026-04)). Codewars raises rank only for problems
+  never solved before ([Codewars](https://docs.codewars.com/gamification/ranks/)); WaniKani unlocks items only once
+  their prerequisites are remembered, and lets them fall back
+  ([WaniKani](https://knowledge.wanikani.com/wanikani/srs-stages/)). Hence readiness from answers and levels only from
+  gates.
+- **Rewards for taking part lower the wish to do the task; feedback raises it**
+  ([Deci, Koestner & Ryan, 1999](https://depts.washington.edu/techdocs/papers/deciExtrinsicRewardsAndIntrinsicMotivation99.pdf)).
+  Points, levels and leaderboards raise how much people do, not how well
+  ([Mekler et al., 2017](https://glassmanlab.seas.harvard.edu/annotated_works/mekler17.pdf)). Hence gold only on a
+  right answer, and the end screen's feedback, answer and principle as the real reward.
+- **Counters steer behaviour.** When GitHub removed its streak counters, weekend work and keep-alive commits fell
+  ([Moldon et al., 2021](https://ar5iv.labs.arxiv.org/html/2006.02371)), and a broken streak lowers later engagement
+  even when the work behind it is the same
+  ([Silverman & Barasch, 2023](https://www.colorado.edu/business/faculty-research/2023/04/19/or-track-how-broken-streaks-affect-consumer-decisions)).
+  Hence no streaks and no overdue counts.
+- **Gamified learning helps moderately on average and varies a lot with the design.** Only its effect on learning held
+  up in the most rigorous studies, not the one on motivation
+  ([Sailer & Homner, 2020](https://link.springer.com/article/10.1007/s10648-019-09498-w)), and most of the evidence
+  comes from classrooms, often with children. So each part ships as a small experiment, judged on what is remembered later
+  and on whether you come back, not on how effective it feels.
+
+## 5. What the parts are
+
+- `src/interlatch/knowledge/study.py`: which lessons are worth studying, the written question and answers
+  (`ask`), the first pick (`pick`), the record, readiness and when a lesson comes back (`schedule`).
+- `src/interlatch/web/field.js`: the region's field (its layout is pure and tested), walking, the monsters, the HUD.
+- `src/interlatch/web/battle.js`: the battle; a study battle's rules are pure and tested in Node.
+- `GET /api/party/ask` sends the scene, the question and the answers' texts, never which is right;
+  `POST /api/party/pick` checks the first pick on the server.
+
+## 6. Next: gate bosses
+
+The last meter: your level in a module, moved only by real work.
+
+- **When a gate opens.** Five lessons understood in a module open its gate. The zone's sign becomes the gate, with its
+  boss standing there.
+- **What the gate asks.** The module's practice task and its pass check from the roadmap, such as "explain why the fix
+  works and when it would not".
+- **How you pass.** Link one of your own pull requests, commits or documents that Interlatch already found, and write
+  two or three sentences on how it meets the check. The analysis model judges the explanation against the check's text:
+  passed, or not yet with what is missing.
+- **What passing does.** The module is marked as shown by you on your career map, kept on this computer, apart from
+  your agents' levels. A "You" card on the Party page shows your readiness and the modules you have passed.
+
+## Measuring it
+
+On your own computer only: delayed recall (right answers when a lesson comes back after days), how often you run from
+a question, how often you come back, and whether a lesson's trap stops recurring in your later sessions.
+
+## Not doing
+
+- Raising an agent's level from your answers, or your level from your agents' lessons.
+- Streaks, overdue counts, or anything that punishes time away.
+- Ranking people by what they understood, on a hub or anywhere else.
+- Sending your answers to a hub.

interlatch-0.27.4/docs/design/ja/innerlatch.md

@@ -0,0 +1,162 @@
+# 設計: Innerlatch、自分の過去から学ぶ
+
+[← ロードマップ](../../../ROADMAP.ja.md) · English: [innerlatch.md](../innerlatch.md) · 関連: [人が学べる教訓](learning.md)
+
+状態: 0.27.3（2026-10-18）でできています。ゲートのボス（6 節）はまだです。使い方は[冒険](../../ja/party.md#冒険)に
+あります。
+
+Innerlatch は、ダッシュボードのレールのいちばん下にある扉の奥のゲームです。コーディングエージェントがドット絵の
+キャラクターのパーティーになり、冒険、町、編成、アリーナがあります。このページには、冒険が何のためにあるのか、そこで教訓と
+戦闘が何を意味するのか、各部分がなぜそう動くのかを、途中で試してやめたことも含めて記録します。
+
+## 1. 目標
+
+**あなたが自分の過去の仕事から学び、キャリアの道を進むこと。**
+
+教訓は、あなたのセッションでエージェントが学んだものです。冒険は、それをあなたのものにする場所です。そのため 3 つの
+メーターを分けておき、どれかが別のどれかを動かすことはありません。
+
+| メーター | 示すこと | どこから来るか |
+| --- | --- | --- |
+| エージェントのレベル | 各ロードマップのモジュールを、エージェントの教訓がどれだけカバーしているか | 教訓だけ（パーティーができたときから変わりません） |
+| あなたの準備度 | モジュールの教訓のうち、理解していると示せたものの数 | 正解した学びの戦闘 |
+| モジュールでのあなたのレベル | あなたがそれをできること | 実際の仕事で通ったゲート（6 節、予定） |
+
+ゴールド、装備、アリーナは、これらのまわりのゲームのままです。変わるのは戦闘の数値だけで、レベル、準備度、経験値は
+変わりません。
+
+## 2. 教訓と戦闘の意味
+
+**教訓は、あなた自身の過去から取り出した例題です。** いちばん関係するロードマップのモジュールに分類されています。
+理解していると示すまでは、エージェントがあなたのために集めた学習材料であって、あなたが知っていることではありません。
+
+**戦闘は、その例題での 1 回の練習です。** 場面（そのとき出会ったままの状況で、答えは伏せてあります）と問いで始まり、
+4 つの答えから選びます。教訓の題名は答えるまで隠れています。題名が答えを言ってしまうことが多いからです。1 つ選んで
+**答える**を押します。
+
+- **正解**はとどめの一撃です。モンスターは倒れ、初めて勝つとゴールドが入り、その教訓はモジュールの準備度に数えられます。
+- **不正解**ならモンスターは逃げていきます。終わりの画面で、その答えがなぜ違うのかが出て、続いて正しい答えと、その裏に
+  ある原則（そのプロジェクトの外でも通じる部分）が出ます。
+
+**にげる**（または Esc）でいつでも抜けられます。学びの戦闘には、たたかう、スキル、どうぐ、ぼうぎょはありません。
+使える手は知識だけです。
+
+## 3. 決めたことと理由
+
+### 何を歩くか: 一度に 1 つの地方
+
+以前のワールドマップは、数えられる教訓をすべて 1 つの大陸にモンスターとして置いていました。あるアーカイブでは 1,000 体を
+超えました。アイコンで埋まった地図は、場所ではなく、片づけるチェックリストに見えます（ゲームでは「chickenpoxing」と
+呼ばれます）。今の冒険は**フィールド**で始まります。1 つの地方で、ロードマップのモジュールがそれぞれ道でつながったゾーンに
+なり、ゾーンごとにモンスターが数体いて、携帯ゲーム機の RPG のように歩きます。ワールドマップは、モンスターのいない全体図
+として残っています。
+
+### どの教訓がモンスターになるか: 学ぶ価値のあるもの
+
+- **メインクエストが先。** メインクエストのトラックのゾーンにはモンスターが 4 体、ほかのゾーンには 2 体います。
+- **学習材料が先。** 事件簿の問いか原則のある教訓が、ほかより先に出ます。
+- **エージェント自身の摩擦は出さない。** どこにでも当てはまってくり返し起きる落とし穴や、シェルやエージェントの道具の
+  タグがついたもの（エイリアスされた `rm`、zsh の単語分割、スクリーンショットの保存先）は、エージェントのルールのための
+  罠で、あなたのキャリアのものではありません。あるアーカイブでは、これで 97 件がフィールドから外れました。
+
+### 理解をどう確かめるか: 教訓ごとに書いた選択問題
+
+ここに来るまでに 4 回試しました。
+
+1. **数値の戦闘。** 最初の戦闘は、教訓を飾りにしたステータスとサイコロの戦いでした。300 回の模擬戦闘で教訓の文章を
+   すべて入れ替えても、結果は 1 つも変わりませんでした。人が知っていることは何も入らず、何も出てきませんでした。
+2. **事件簿からの選択と、借りてきた間違いの答え**（「診断」の試み。マージせずに閉じました）。事件簿のある教訓は 10 件に
+   1 件ほどで、遊べるもののうち 63% には外れた手がかりの記録がなく、間違いの答えはほかの教訓の答えでした。簡単に除外
+   できます。5 件に 1 件ほどは、最初に出る題名が答えのほとんどを含んでいました。間違えても、次の選択肢を選べば済みました。
+3. **自由記述をモデルが判定する。** 正直で柔軟ですが、ゲームの途中で文章を書くことを求め、手応えがありませんでした。
+4. **教訓のために書いた選択問題**（出荷したもの）。分析モデルが教訓ごとに一度、教訓そのものから場面、問い、4 つの答えを
+   書きます。間違いの答えは、まずそのセッションで外れた手がかり、次にありがちな思い違いで、それぞれになぜ違うのかが
+   つきます。セットは確かめられ（正解はちょうど 1 つ、同じような答えはなし、正解がいちばん長くはならない）、教訓と一緒に
+   残ります。数えるのは戦闘での最初の選択で、サーバーが確かめるので、答えるときにモデルを呼ぶ必要はありません。
+
+### 教訓がいつ戻るか: 間隔をあけて、期限切れはなし
+
+- **正解:** 休んでから、忘れかけるころにもう一度見に戻ってきます。3 日後、正解を続けるごとに 10 日、30 日、90 日後で、
+  フィールドでは ↻ の印がつきます。別々の日に続けて 2 回正解すると、**あなたのもの**です。
+- **正解しなかった:** 結果にかかわらず（間違えた、答えずに勝った、にげた）、明日までフィールドに出ません。答えを見た直後に
+  もう一度挑むのは、思い出すのではなく写すことです。
+- **期限切れはなし。** 期限の来た数は出しません。戻った教訓はフィールドで待っているだけで、離れていた時間が溜まることは
+  ありません（[学びの設計、ルール](learning.md#すべての部分に共通するルール)）。
+
+### 答えをどこに残すか: あなたのコンピューター
+
+人ごとの学びのデータは、その人のコンピューターに残します（[学びの設計](learning.md)）。答えは、このコンピューターの
+あなたのアーカイブに残ります。ハブにサインインしているときは、戦闘はふつうのターン制で、答えについてはハブに何も残り
+ません。問いそのものは教訓のもので、だれかのものではないので、教訓と一緒に残ります。
+
+## 4. 根拠
+
+2026 年 10 月の調査では、boot.dev とほか 20 余りの学習プロダクト、実際の作業や AI エージェントの活動に重ねたゲーム、知識を
+世界の一部にするゲームの型、学習の研究を見ました。上の決定を支えたのは次の点です。
+
+- **知識が、戦いを決める手でなければならない。** 算数がレベルの合間のクイズではなく戦闘そのものだったとき、子どもは
+  よりよく学び、自分から約 7 倍長く遊びました（[Habgood & Ainsworth, 2011](https://shura.shu.ac.uk/3556/)）。ただし
+  一律のルールではなく、大人を対象にしたある研究では、練習を遊びから切り離したほうがよい結果でした
+  （[Nidd & Muldner, 2019](https://escholarship.org/content/qt8453p0gf/qt8453p0gf.pdf)）。成り立つ読み方は、勝つ手が
+  関係する考えを強いるときに、組み込むことが報われる、というものです。
+- **思い出すほうが読み返すより効き、**しかも読み返した人のほうが自信を持ちます。1 週間後に覚えていたのは 56% 対 42% でした
+  （[Roediger & Karpicke, 2006](https://psychology.ecu.edu/wp-content/pv-uploads/sites/216/2019/03/Roediger-Karpicke-2006.pdf)）。
+  フィードバックつきの選択問題の練習はよく効き
+  （[Adesope et al., 2017](https://journals.sagepub.com/doi/10.3102/0034654316689306)）、間隔をあけると定着します。
+  Duolingo の間隔をあけた復習は、毎日の利用を 12% 増やしました（[Settles & Meeder, 2016](https://aclanthology.org/P16-1174/)）。
+- **レベルに意味があるのは、確認が裏にあるときだけ。** Boot.dev は機械が確かめた作業にだけ報酬を払い、2026 年 4 月には
+  自己申告のレッスンまで選択問題の確認に置き換えました
+  （[Boot.dev, April 2026](https://www.boot.dev/blog/news/bootdev-beat-2026-04)）。Codewars は初めて解いた問題でだけ
+  ランクが上がり（[Codewars](https://docs.codewars.com/gamification/ranks/)）、WaniKani は前提を覚えてから項目を開き、
+  忘れれば戻します（[WaniKani](https://knowledge.wanikani.com/wanikani/srs-stages/)）。だから準備度は答えから、レベルは
+  ゲートからだけ得られます。
+- **参加への報酬はその作業をしたい気持ちを下げ、フィードバックは上げる**
+  （[Deci, Koestner & Ryan, 1999](https://depts.washington.edu/techdocs/papers/deciExtrinsicRewardsAndIntrinsicMotivation99.pdf)）。
+  ポイント、レベル、リーダーボードが増やすのはやる量で、質ではありません
+  （[Mekler et al., 2017](https://glassmanlab.seas.harvard.edu/annotated_works/mekler17.pdf)）。だからゴールドは正解の
+  ときだけで、本当の報酬は終わりの画面のフィードバック、答え、原則です。
+- **カウンターは行動を動かす。** GitHub が連続記録のカウンターを外すと、週末の作業と、記録をつなぐためだけのコミットが
+  減りました（[Moldon et al., 2021](https://ar5iv.labs.arxiv.org/html/2006.02371)）。連続記録が途切れると、その裏の作業が
+  同じでも、その後の利用が下がります
+  （[Silverman & Barasch, 2023](https://www.colorado.edu/business/faculty-research/2023/04/19/or-track-how-broken-streaks-affect-consumer-decisions)）。
+  だから連続記録も、期限の来た数もありません。
+- **ゲーム化した学習の効果は平均では中くらいで、設計しだいで大きく変わる。** 最も厳密な研究で残ったのは学習への効果
+  だけで、意欲への効果は残りませんでした
+  （[Sailer & Homner, 2020](https://link.springer.com/article/10.1007/s10648-019-09498-w)）。根拠のほとんどは教室からで、
+  子どもが対象のことも多いです。だから各部分は小さな実験として出し、効いている感じではなく、あとで覚えているかと、また
+  戻ってくるかで判断します。
+
+## 5. 各部分
+
+- `src/interlatch/knowledge/study.py`: どの教訓が学ぶ価値があるか、書いた問いと答え（`ask`）、最初の選択（`pick`）、
+  記録、準備度、教訓がいつ戻るか（`schedule`）。
+- `src/interlatch/web/field.js`: 地方のフィールド（配置は純粋な関数で、テストがあります）、歩くこと、モンスター、HUD。
+- `src/interlatch/web/battle.js`: 戦闘。学びの戦闘のルールは純粋な関数で、Node でテストしています。
+- `GET /api/party/ask` は場面、問い、答えの文だけを送り、どれが正解かは送りません。`POST /api/party/pick` が最初の
+  選択をサーバーで確かめます。
+
+## 6. 次: ゲートのボス
+
+最後のメーター、モジュールでのあなたのレベルです。動かせるのは実際の仕事だけです。
+
+- **ゲートが開くとき。** モジュールの教訓を 5 つ理解すると、そのゲートが開きます。ゾーンの看板がゲートになり、ボスが
+  立ちます。
+- **ゲートが求めること。** ロードマップにある、そのモジュールの練習課題と合格の確認です。たとえば「修正がなぜ効くのか、
+  どんなときは効かないのかを説明できる」。
+- **通り方。** Interlatch がすでに見つけた、あなた自身のプルリクエスト、コミット、ドキュメントのどれかを結びつけ、それが
+  確認にどう合うかを 2〜3 文で書きます。分析モデルが、確認の文に照らして説明を判定します。合格か、何が足りないかを
+  添えた「まだ」です。
+- **合格すると。** そのモジュールには、キャリアマップで「あなたが示した」と印がつきます。このコンピューターに残り、
+  エージェントのレベルとは別です。パーティーのページの「あなた」のカードに、準備度と合格したモジュールが出ます。
+
+## 効果の測り方
+
+あなたのコンピューターの中だけで測ります。遅れて思い出せるか（数日たって教訓が戻ったときに正解するか）、問いからどれだけ
+にげるか、どれだけ戻ってくるか、教訓の罠がその後のセッションでくり返されなくなるか、です。
+
+## やらないこと
+
+- あなたの答えでエージェントのレベルを上げること、エージェントの教訓であなたのレベルを上げること。
+- 連続記録、期限の来た数、離れていた時間を罰するもの。
+- 理解したことで人を順位づけること。ハブでも、ほかのどこでも。
+- あなたの答えをハブに送ること。

{interlatch-0.27.3 → interlatch-0.27.4}/docs/ja/party.md

@@ -58,18 +58,44 @@ Innerlatch の扉は、Google でサインインするまで開きません。
 
 ## 冒険
 
-**冒険**は、数えられる教訓をすべて載せたワールドマップです。6 つの属性がそれぞれ地方になり（技巧は鍛冶の町、データは湖と運河、
-運用は山とサーバーの塔、守護は城壁と砦、秘術は魔法使いの塔、伝承は図書館のある古い森）、ロードマップのモジュールはその地方の
-領地になります。教訓は、いちばんよく当てはまるモジュールの領地に、種類ごとのモンスターとして立っています（修正はバグの
-Glitch、落とし穴は Mal、など）。まだ教訓が届いていない領地は霧に包まれています。パーティーはいちばん新しい教訓を学んだ場所に
-立ち、メインクエストのマイルストーンはボスとして地方の門を守ります。ドラッグで見回し、スクロールかピンチで拡大縮小し、
-ミニマップやサイドバーの地方で移動します。**リスト**では同じ遭遇を一覧にして、地方、種類、エージェントで絞り込めます。
-
-モンスターをクリックすると、ターン制の戦闘になります。その教訓を学んだエージェントが先頭に立ち、ほかに最大 2 人が加わります。
-毎ターン**たたかう**、**スキル**（教訓のロードマップのモジュールのひとつ。そのエージェントのレベルが高いほど強い）、**ぼうぎょ**、
-**にげる**から選びます。モンスターの強さは教訓の経験値と信頼の段階で決まります。勝つと遭遇はクリア済みになり、マップの旗に
-変わります（このパーティーのアーカイブに記録されます）。負けても**もう一度**でサイコロを振り直せます。戦闘でレベルや経験値が
-変わることはありません。それらは教訓からだけ得られます。ボスとも戦えますが、倒れるのは**クエスト**でそのマイルストーンを
+**冒険**を開くと、歩き回れるフィールドが出ます。一度に 1 つの地方を、携帯ゲーム機の RPG のように上から見下ろします。
+最後に歩いた地方（初めてなら、パーティーが立っている地方）が開き、ほかの地方はサイドバーの**地方**から開けます。地方の
+ロードマップのモジュールがそれぞれ看板のあるゾーンになり、ゾーンどうしは土の道でつながり、木の列で区切られ、真ん中に地方の
+町があります。歩きたい場所をクリックかタップするか、矢印キーか WASD で動きます。パーティーは先頭について歩きます。上の
+ゾーンの見出しには、いまいるモジュール、戦う教訓があといくつ残っているか、いくつ理解したかが出ます。★ はメインクエストの
+ゾーンです。隅のミニマップには、いまいる場所と近くのモンスターが出ます。
+
+モンスターは、学ぶ価値のある教訓です。各ゾーンで学べることの多いもの（事件簿か原則のあるもの）が先に出て、メインクエストの
+ゾーンでは一度に 4 体、ほかのゾーンでは 2 体です。エージェントがあなたの環境でくり返しはまる罠（エイリアスされた `rm`、
+zsh、スクリーンショットの保存先）は出てきません。それはエージェントのルールに入れるもので、あなたのキャリアのものでは
+ありません。モンスターにぶつかると戦闘に、町の門に入ると買い物になります。
+
+サイドバーの**ワールドマップ**には大陸全体が出ます。すべての地方とその領地で、まだ教訓が届いていないところは霧に包まれて
+います。**遭遇リスト**には教訓が一覧で出て、地方、種類、エージェントで絞り込めます。
+
+### 学びの戦闘
+
+戦闘は、あなた自身のセッションの教訓を 1 つ、問いにしたものです。場面と問いが出て、4 つの答えから選びます。教訓の題名は
+隠れています。題名が答えを言ってしまうことが多いからです。1 つ選び（クリックするか、1〜4 のキー。矢印キーで選択が動きます）、
+**答える**（または Enter）を押します。**にげる**（または Esc）でいつでも抜けられます。
+
+- **正解**: あなたの答えがとどめの一撃です。モンスターは倒れ、初めて勝つとゴールドが入り、その教訓はモジュールの準備度に
+  数えられます。
+- **不正解**: モンスターは逃げていきます。終わりの画面で、その答えがなぜ違うのかが出て、続いて正しい答えとその裏にある
+  原則が出ます。
+
+問いと答えは、教訓ごとに一度だけ、分析モデルが教訓そのものから書きます。間違いの答えは、そのセッションで外れた手がかりと、
+ありがちな思い違いです。初めて出会う教訓では数秒かかり、そのあとは残ります。
+
+今日戦って正解しなかった教訓は、明日までフィールドに出ません。もう一度挑むときは、見たばかりの答えを写すのではなく、
+思い出すことになります。正解した教訓は休んでから、忘れかけるころにもう一度見に戻ってきます。3 日後、正解を続けるごとに
+10 日、30 日、90 日後で、フィールドでは ↻ の印がつきます。別々の 2 日に正解すれば、あなたのものです。期限切れは
+ありません。戻ってきた教訓はフィールドで待っているだけです。
+
+答えはあなた自身の準備度にだけ数えられ、エージェントのレベルには入りません。エージェントのレベルは教訓からだけ得られます。
+答えはあなたのコンピューターにだけ残ります。ハブにサインインしているときは、戦闘はふつうのターン制（**たたかう**、
+**スキル**、**どうぐ**、**ぼうぎょ**、**にげる**）で、答えについては何も残りません。問いが書けないとき（分析モデルに
+つながらないとき）も、同じふつうの戦闘になります。ボスとも戦えますが、倒れるのは**クエスト**でそのマイルストーンを
 完了にしたときだけです。
 
 ## 町と装備

{interlatch-0.27.3 → interlatch-0.27.4}/src/interlatch/analysis/queue.py

@@ -7,7 +7,7 @@ from datetime import datetime, timedelta
 
 from ..core.config import Config
 from ..core.i18n import tr
-from ..core.util import local_str, one_line, to_iso, utcnow
+from ..core.util import local_str, one_line, parse_ts, to_iso, utcnow
 from ..storage.kv import kv_get
 from .runners.base import Runner
 from .runners.factory import make_runner
@@ -130,3 +130,72 @@ def queued_ids(conn, cfg: Config, code: str, limit: int) -> list[str]:
             if len(ids) >= limit:
                 break
     return ids
+
+
+RUN_INTERVAL_S = 900  # the background agent: `interlatch sync --work` every 15 minutes (runtime/install.py)
+
+
+def typical_analysis_s(conn) -> float:
+    """How long one session's analysis takes on this computer: the median of the last 20 that got through."""
+    took = sorted(r[0] for r in conn.execute(
+        "SELECT (julianday(finished_at) - julianday(started_at)) * 86400 FROM analyses WHERE kind = 'session' "
+        "AND status = 'done' AND started_at IS NOT NULL AND finished_at IS NOT NULL ORDER BY id DESC LIMIT 20")
+        if r[0] and r[0] > 0)
+    return round(took[len(took) // 2], 1) if took else 60.0
+
+
+def queue_list(conn, cfg: Config, limit: int = 200) -> dict:
+    """The sessions queued for analysis (the ones the status bar counts), each with its reason and `eta`: when it
+    should be analyzed. The background runs are played forward: one every RUN_INTERVAL_S after the last sync, each
+    taking max_per_run sessions in pending_sessions() order, a session joining the first run after it is ready.
+    No eta while the whole queue is stopped by something that needs a change (automatic analysis off, no agent)."""
+    now = utcnow()
+    block = queue_block(conn, cfg)
+    paused = kv_get(conn, PAUSE_KEY)
+    paused = parse_ts(paused) if paused and paused > to_iso(now) else None
+    each = typical_analysis_s(conn)
+    items = []
+    for s in conn.execute(
+            "SELECT id, title, project_name, project_path, agent, analysis_status, source, analysis_attempts, analysis_reason, "
+            "analysis_not_before, n_prompts, started_at, ended_at, ended_flag FROM sessions WHERE source NOT IN ('history', 'remote') "
+            "AND analysis_status IN ('pending','stale','error') ORDER BY ended_flag DESC, ended_at DESC"):
+        got = waiting_reason(conn, cfg, s)
+        if not got or got[0] not in QUEUED_CODES:
+            continue
+        code, why = got
+        ready_at = (parse_ts(s["analysis_not_before"]) if code == "retry"
+                    else (parse_ts(s["ended_at"]) or now) + timedelta(minutes=cfg.analysis.idle_minutes) if code == "active"
+                    else now)
+        items.append({"id": s["id"], "title": s["title"], "project": s["project_name"], "agent": s["agent"],
+                      "prompts": s["n_prompts"], "ended_at": s["ended_at"], "code": code,
+                      "label": tr(QUEUE_REASON_LABEL[code]), "why": why, "stale": s["analysis_status"] == "stale",
+                      "ready_at": max(ready_at or now, now), "eta": None})
+
+    next_run = None
+    if not cfg.sends_files and (not block or paused):  # a pause ends by itself; the other blocks need a change
+        last = parse_ts(kv_get(conn, "last_sync"))
+        slot = max(last + timedelta(seconds=RUN_INTERVAL_S), now) if last else now + timedelta(seconds=RUN_INTERVAL_S)
+        while paused and slot < paused:
+            slot += timedelta(seconds=RUN_INTERVAL_S)
+        next_run = slot
+        left, per_run = list(items), max(1, cfg.analysis.max_per_run)
+        for _ in range(2000):  # a guard: a few thousand queued sessions is weeks of runs
+            if not left:
+                break
+            due = [x for x in left if x["ready_at"] <= slot][:per_run]
+            if not due:  # nothing ready by this run: skip to the first run after the next one is
+                first = min(x["ready_at"] for x in left)
+                while slot < first:
+                    slot += timedelta(seconds=RUN_INTERVAL_S)
+                continue
+            for i, x in enumerate(due):
+                x["eta"] = to_iso(slot + timedelta(seconds=each * (i + 1)))
+            left = [x for x in left if x["eta"] is None]
+            slot += timedelta(seconds=RUN_INTERVAL_S)
+        items.sort(key=lambda x: x["eta"] or "~")  # stable: the worker's order within one run
+    for x in items:
+        x["ready_at"] = to_iso(x["ready_at"])
+    return {"sessions": items[:limit], "total": len(items), "ready": sum(x["code"] == "ready" for x in items),
+            "active": sum(x["code"] == "active" for x in items), "each_s": each, "per_run": cfg.analysis.max_per_run,
+            "interval_s": RUN_INTERVAL_S, "next_run": to_iso(next_run), "block": block,
+            "paused_until": to_iso(paused), "on_hub": bool(cfg.sends_files)}

{interlatch-0.27.3 → interlatch-0.27.4}/src/interlatch/interfaces/web/api/status.py

@@ -237,6 +237,13 @@ def action_sync(ctx: Context) -> bool:
     return ctx.jobs.start("sync", job)
 
 
+def analysis_queue(ctx: Context) -> dict:
+    """What the status bar's queue line opens: the queued sessions with their reasons and when each is analyzed."""
+    from ....analysis.queue import queue_list
+
+    return queue_list(ctx.conn, ctx.cfg)
+
+
 def action_analyze(ctx: Context, sid: str) -> bool:
     from ....application.workflows import run_worker
     from ...exports.vault import export_markdown

{interlatch-0.27.3 → interlatch-0.27.4}/src/interlatch/interfaces/web/routes.py

@@ -247,6 +247,7 @@ GET: list[Route] = [
     Route("/api/systems", ANYONE, lambda h, ctx, m, q: h._json(api.knowledge.systems(ctx))),
     Route("/api/system", ANYONE, _system),
     Route("/api/jobs", ANYONE, lambda h, ctx, m, q: h._json(api.status.status_small(ctx, limited=h.limited))),
+    Route("/api/analysis/queue", ANYONE, lambda h, ctx, m, q: h._json(api.status.analysis_queue(ctx))),
     Route("/api/update", ANYONE, lambda h, ctx, m, q: h._json(api.settings.update_info(ctx, remote=False))),
     Route("/api/imports", ANYONE, lambda h, ctx, m, q: h._json(api.sources.imports(ctx))),
     Route("/api/devices", ANYONE, _devices),

{interlatch-0.27.3 → interlatch-0.27.4}/src/interlatch/web/app.css

@@ -2316,6 +2316,26 @@ td.pg-cell { width: 1%; text-align: right; }
 .gd-rule { display: flex; align-items: center; gap: 8px; padding: 4px 4px 4px 8px; border: 1px solid var(--border); border-radius: 6px; background: var(--surface-2); }
 .gd-rule .icon { width: 14px; height: 14px; color: var(--muted); flex: none; }
 .gd-rule .mono { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-family: var(--mono); font-size: 12px; }
+/* the analysis queue: what the status bar's queue line opens */
+.qd { width: min(640px, 100%); }
+.qd-body { display: flex; flex-direction: column; gap: 10px; min-height: 0; font-size: 13px; }
+.qd-body p { margin: 0; }
+.qd-run .queue-run { margin: 0; }
+.qd-took { margin-top: 4px; font-size: 12px; }
+.qd-list { list-style: none; margin: 0; padding: 0; max-height: min(52vh, 460px); overflow-y: auto; border-top: 1px solid var(--grid); }
+.qd-row { display: grid; grid-template-columns: minmax(0, 1fr) auto auto; align-items: center; gap: 4px 12px; padding: 8px 2px; border-bottom: 1px solid var(--grid); }
+.qd-main { min-width: 0; }
+.qd-main a { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: 600; }
+.qd-meta { font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.qd-code { white-space: nowrap; }
+.qd-code.ready { color: var(--accent-ink); }
+.qd-code.retry { color: var(--warning-ink); }
+.qd-eta { display: grid; justify-items: end; min-width: 76px; font-variant-numeric: tabular-nums; font-size: 12px; }
+@media (max-width: 560px) {
+  .qd-row { grid-template-columns: minmax(0, 1fr) auto; }
+  .qd-code { grid-row: 2; justify-self: start; }
+  .qd-eta { grid-row: 1 / span 2; grid-column: 2; }
+}
 .gd-rule .icon-btn { width: 24px; height: 24px; }
 .gd-none { font-size: 12px; }
 .gd-add { display: flex; gap: 6px; }