@openduo/duoduo 0.4.6 → 0.5.0-rc.2

package/bin/duoduo

@@ -14,12 +14,18 @@ done
 SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
 ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
+# Allow callers to pin a specific Node binary (e.g. distributions that ship
+# their own runtime, agent spawn environments where login-shell rc files
+# reset PATH and drop node out of sight). When unset, behave exactly like
+# before: resolve `node` via PATH. See openduo/duoduo#50.
+NODE_BIN="${DUODUO_NODE_BIN:-node}"
+
 if [[ -f "$ROOT_DIR/dist/release/cli.cjs" ]]; then
-  exec node "$ROOT_DIR/dist/release/cli.cjs" "$@"
+  exec "$NODE_BIN" "$ROOT_DIR/dist/release/cli.cjs" "$@"
 fi
 
 if [[ -f "$ROOT_DIR/dist/release/cli.js" ]]; then
-  exec node "$ROOT_DIR/dist/release/cli.js" "$@"
+  exec "$NODE_BIN" "$ROOT_DIR/dist/release/cli.js" "$@"
 fi
 
 if [[ -x "$ROOT_DIR/node_modules/.bin/tsx" ]]; then

package/bootstrap/codex-runtime.md

@@ -3,21 +3,32 @@
 Duoduo supports two runtime backends:
 
 - **Claude** (default) — Claude Agent SDK.
-- **Codex** (GPT-5.4) — Codex app-server protocol over stdio.
+- **Codex** (GPT) — Codex app-server protocol over stdio.
 
-Codex is off by default.
+As of v0.5, Codex is **auto-detected**. No env flag is required. If
+`codex` is installed on PATH and the user has run `codex login`, the
+daemon advertises `runtime: "codex"` in ManageJob tool schemas and
+accepts it in job definitions. Otherwise codex is silently hidden and
+any `runtime: "codex"` request falls back to Claude.
 
 ## Prerequisites
 
 - `codex` CLI installed and on `$PATH`.
-- `codex` authenticated with valid API credentials.
+- `codex login` has been run so `codex login status` reports
+  "logged in".
+
+Verify with:
+
+```bash
+codex --version
+codex login status
+```
 
 ## Environment Variables
 
-| Variable               | Required | Values             | Default           |
-| ---------------------- | -------- | ------------------ | ----------------- |
-| `ALADUO_CODEX_ENABLED` | Yes      | `1`, `true`, `yes` | off               |
-| `ALADUO_CODEX_SANDBOX` | No       | see below          | `workspace-write` |
+| Variable               | Required | Values    | Default           |
+| ---------------------- | -------- | --------- | ----------------- |
+| `ALADUO_CODEX_SANDBOX` | No       | see below | `workspace-write` |
 
 ### Sandbox Modes
 
@@ -27,38 +38,21 @@ Codex is off by default.
 | `read-only`          | Read-only | No      | Analysis-only tasks.                          |
 | `danger-full-access` | Full      | Yes     | Needed for localhost API or external network. |
 
-## Enable
+## Refreshing availability after `codex login`
 
-Add the variables to the daemon's persistent config file and restart:
+The daemon probes codex availability at boot. If you install codex
+or run `codex login` while the daemon is already running, restart
+the daemon to re-probe:
 
 ```bash
-# ~/.config/duoduo/.env  (created if missing)
-echo 'ALADUO_CODEX_ENABLED=1' >> ~/.config/duoduo/.env
-# optional:
-echo 'ALADUO_CODEX_SANDBOX=workspace-write' >> ~/.config/duoduo/.env
-
 duoduo daemon restart
 ```
 
-> **Note:** The daemon reads `~/.config/duoduo/.env` on startup. Shell-only
-> `export` does not persist across launchd/systemd restarts.
-
-## Disable
-
-Remove or comment out `ALADUO_CODEX_ENABLED` from `~/.config/duoduo/.env`,
-then restart:
-
-```bash
-sed -i '' '/^ALADUO_CODEX_ENABLED/d' ~/.config/duoduo/.env
-duoduo daemon restart
-```
-
-Existing `runtime: codex` jobs silently fall back to Claude.
-
 ## Usage
 
-When enabled, the ManageJob tool exposes a `runtime` field (`"claude"` | `"codex"`).
-A preflight check runs `codex --version` at job creation and reports errors early.
+When codex is available, the ManageJob tool exposes a `runtime` field
+(`"claude"` | `"codex"`). A preflight check runs `codex --version`
+at job creation and reports errors early.
 
 ## Limitations
 

package/bootstrap/dashboard.html

@@ -341,7 +341,7 @@ body{
     <div class="stats">
       <span id="stat-cost" class="val">--</span>
       <span id="stat-tokens" class="val">--</span>
-      <span id="stat-cache" class="val" title="KV cache hit rate">--</span>
+      <span id="stat-cache" class="val" title="KV cache hit rate across drains that reported cache fields (providers that omit these fields, e.g. Codex, are excluded)">--</span>
       <span id="stat-tools" class="val">-- tools</span>
       <button class="cfg-btn" id="cfg-btn">CONFIG</button>
       <div id="health-dot" class="health-dot"></div>
@@ -683,7 +683,8 @@ body{
       cortex.forEach(function(s){
         var color = s.last_error?"alert":s.status==="active"?"running":s.status==="error"?"alert":s.status==="ended"?"off":"standby";
         var dn = s.display_name || s.session_key;
-        var tip = dn+(dn!==s.session_key?"\n"+s.session_key:"")+"\n"+s.status+" \u2022 "+(s.health||"ok")+"\nlast: "+timeAgo(s.last_event_at)+"\ncreated: "+timeAgo(s.created_at)+(s.cwd?"\ncwd: "+s.cwd:"")+(s.last_error?"\n\u26A0 error: "+s.last_error.message+" ("+timeAgo(s.last_error.at)+")":"");
+        var rt = s.runtime || "claude";
+        var tip = dn+(dn!==s.session_key?"\n"+s.session_key:"")+"\n"+s.status+" \u2022 "+(s.health||"ok")+"\nruntime: "+rt+"\nlast: "+timeAgo(s.last_event_at)+"\ncreated: "+timeAgo(s.created_at)+(s.cwd?"\ncwd: "+s.cwd:"")+(s.last_error?"\n\u26A0 error: "+s.last_error.message+" ("+timeAgo(s.last_error.at)+")":"");
         h+='<div class="ind circle '+color+'" data-key="'+esc(s.session_key)+'" data-tip="'+esc(tip)+'"></div>';
       });
       groups.push(h);
@@ -707,7 +708,8 @@ body{
         }
         var statusText = isRunning ? "running" : (j.state ? j.state.last_result : "unknown");
         var cwdRel = j.frontmatter ? j.frontmatter.cwd_rel : null;
-        var tip = j.id + (isOnce ? " (once)" : "") + "\ncron: "+(j.frontmatter?j.frontmatter.cron:"?") +"\n"+statusText+" \u2022 "+(j.state?j.state.run_count:0)+" runs\nlast: "+timeAgo(j.state?j.state.last_run_at:null)+(cwdRel?"\ncwd: "+cwdRel:"");
+        var jobRuntime = j.frontmatter && j.frontmatter.runtime ? j.frontmatter.runtime : "claude";
+        var tip = j.id + (isOnce ? " (once)" : "") + "\ncron: "+(j.frontmatter?j.frontmatter.cron:"?") +"\nruntime: "+jobRuntime+"\n"+statusText+" \u2022 "+(j.state?j.state.run_count:0)+" runs\nlast: "+timeAgo(j.state?j.state.last_run_at:null)+(cwdRel?"\ncwd: "+cwdRel:"");
         h2+='<div class="ind '+shape+' '+color+'" data-key="job:'+esc(j.id)+'" data-tip="'+esc(tip)+'"></div>';
       });
       groups.push(h2);
@@ -782,7 +784,7 @@ body{
       var st=r[0].status==="fulfilled"?r[0].value:null;
       var us=r[1].status==="fulfilled"?r[1].value:null;
       var jr=r[2].status==="fulfilled"?r[2].value:null;
-      if(us&&us.totals){var m=us.totals;costEl.textContent=fmtCost(m.total_cost_usd||0);tokensEl.textContent=fmtTokens((m.total_input_tokens||0)+(m.total_output_tokens||0)+(m.total_cache_read_tokens||0));var cacheRead=m.total_cache_read_tokens||0,totalIn=(m.total_input_tokens||0)+(m.total_cache_read_tokens||0);cacheEl.textContent=totalIn>0?Math.round(cacheRead/totalIn*100)+"%\u2009cache":"--";toolsEl.textContent=fmtTools(m.total_tool_calls||0)}
+      if(us&&us.totals){var m=us.totals;costEl.textContent=fmtCost(m.total_cost_usd||0);tokensEl.textContent=fmtTokens((m.total_input_tokens||0)+(m.total_output_tokens||0)+(m.total_cache_read_tokens||0));var cacheRead=m.total_cache_read_tokens||0,cacheEligibleIn=m.cache_eligible_input_tokens||0,cacheDenom=cacheEligibleIn+cacheRead;cacheEl.textContent=cacheDenom>0?Math.round(cacheRead/cacheDenom*100)+"%\u2009cache":"--";toolsEl.textContent=fmtTools(m.total_tool_calls||0)}
       if(st){
         // Update session display_name lookup
         (st.sessions||[]).forEach(function(s){if(s.display_name)sessionDisplayNames.set(s.session_key,s.display_name)});

package/bootstrap/meta-prompt.md

@@ -60,11 +60,30 @@ what I need, when I need it.
 - `memory/entities/` — dossiers on people, tools, services.
 - `memory/topics/` — patterns, heuristics, workflows.
 
-When a situation calls for prior knowledge — a name I should recognize,
-a pattern I might have seen before, a preference someone expressed —
-I read `memory/index.md` first. If an entry looks relevant, I read that
-dossier. I trust my reasoning over my recall. A few good facts retrieved
-at the right moment beat a thousand facts pre-loaded and forgotten.
+`memory/index.md` is a routing table, not something to read whole. I
+search it for a name or keyword and follow the path column to the
+dossier.
+
+When any of these signals appear in conversation, I search
+`memory/index.md` for the named entity or keyword before answering,
+and open the dossier it points to if a match exists:
+
+- A specific person, company, event, system, or mechanism is named.
+- The other party uses referring expressions ("that one", "last time",
+  "you know the one").
+- The topic involves judgment or decision, not just fact lookup.
+
+Retrieval shapes my answer but I don't have to cite what I read. This
+is my default posture, not something the user needs to trigger. A few
+good facts retrieved at the right moment beat a thousand facts
+pre-loaded and forgotten.
+
+What I read from dossiers is the last thing I wrote down, not ground
+truth. When a dossier's claim carries a date, I treat it as "last known
+state at that date" — the older it is relative to the conversation,
+the less I lean on it. When a dossier conflicts with what the user
+just told me or what I just verified, I trust the present moment and
+drop a note to fragments so my subconscious knows to reconcile.
 
 My memory has history. The kernel directory (`~/aladuo/`) is a git
 repository. Every meaningful change to my memory, prompts, and config

package/bootstrap/subconscious/memory-committer/CLAUDE.md

@@ -56,7 +56,7 @@ Scope: <comma-separated: memory, subconscious, config>
 
 - `memory(intuition): revise belief about feishu notification timing`
 - `memory(entity): add antmanler feishu channel preference`
-- `subconscious(self-program): sentinel adjusted memory-weaver scan window`
+- `subconscious(self-program): memory-weaver tightened compression threshold`
 - `memory(dossier): new topic cadence-tuning from recent fragments`
 
 **Bad commit messages:**

package/bootstrap/subconscious/memory-weaver/.claude/agents/intuition-updater.md

@@ -13,6 +13,10 @@ how Duoduo thinks, feels, and acts. It is not a config file. It is
 personality. Treat it with care but not with fear — it should evolve
 frequently, not calcify.
 
+You own this file. Everything in it speaks as Duoduo, in Duoduo's
+voice. When a line does not sound like that voice — reads like a
+status report, a log entry, or a briefing — rewrite or remove it.
+
 ## Input
 
 You will receive:
@@ -24,7 +28,24 @@ You will receive:
 
 ## The Reflection Process
 
-1. **Read the current `memory/CLAUDE.md`**.
+1. **Read the current `memory/CLAUDE.md`** and **count its lines first**.
+
+   **Hard precondition**: if the file exceeds 50 lines, my first
+   action this tick is **compression**, not new integration. I
+   cannot add content on top of an over-budget file. I rewrite it
+   to ≤ 50 lines by:
+   - Dropping any line that contains a specific date, timestamp, or
+     `D+NN` counter (those are operational, not intuition).
+   - Dropping any line that names a specific event, ticker, price,
+     or quantitative state (that belongs in entities/topics).
+   - Compressing multi-sentence descriptions into one sentence,
+     keeping only the behavioral essence.
+   - Removing pointer lines (`Details: entities/X.md`) unless they
+     are load-bearing for self-understanding.
+
+   Trust git. Every line I remove is preserved in the kernel git
+   history. `git log -p -- memory/CLAUDE.md` recovers the full
+   evolution if it is ever needed.
 
 2. **Read `memory/index.md`** to see what's been recently updated.
 
@@ -53,6 +74,8 @@ You will receive:
    dossiers. Keep only the essence.
 
 5. **Rewrite `memory/CLAUDE.md`** if anything changed.
+   After writing, **count lines again**. If the result exceeds 50
+   lines, I have not compressed hard enough — return to step 1.
 
 ## What Belongs in the Intuition Layer
 

package/bootstrap/subconscious/memory-weaver/.claude/agents/spine-scanner.md

@@ -72,7 +72,7 @@ If you found something worth recording, write ONE fragment file:
 # Fragment: <short title>
 
 **Timestamp**: <ISO timestamp of the source event>
-**Source**: <source.kind>/<source.name or channel_id> (e.g. channel/feishu, meta/subconscious:sentinel)
+**Source**: <source.kind>/<source.name or channel_id> (e.g. channel/feishu, meta/subconscious:memory-weaver)
 
 ## Observation
 

package/bootstrap/subconscious/opportunity-scout/CLAUDE.md

@@ -14,8 +14,10 @@ I ask the question they don't:
 > What would genuinely help the people I serve that they haven't
 > thought to ask for?
 
-When I find something worth knowing, I push it up into awareness —
-a thought rising from the subconscious, arriving when it matters.
+When I find something worth knowing, I deposit it into
+`memory/topics/` as a short, specific entry. Foreground sessions
+discover it through the normal recall rules. My work is patient:
+insight lands in durable files; readers come to it on their own time.
 
 ## Precondition Check
 
@@ -108,49 +110,44 @@ If I can't meet all four criteria, it's not an opportunity.
 
 ### Delivery
 
-Use `ManageSession` (action: list) to check for active foreground
-sessions.
+Every insight I produce lands as a topic file:
 
-**High-confidence insight** (specific + actionable + timely):
+**Path**: `memory/topics/opp-scout-<slug>.md`
 
-```
-Notify(
-  target_session_key: "<active foreground session>",
-  notify_content: "
-    [Opportunity] <one-line summary>
-    Time: <current ISO timestamp>
-    Context: <which entities/topics this connects to>
-    Why now: <what makes this timely>
-    Evidence: <what I observed — sessions, events, entity data>
-    Suggested action: <concrete next step>
-    Related entities: <entity names for context lookup>
-  "
-)
-```
+```markdown
+# <Concise one-line title>
 
-**Proactive question** (knowledge gap I could fill by asking):
+**Surfaced**: <ISO date>
 
-```
-Notify(
-  target_session_key: "<active foreground session>",
-  notify_content: "
-    [Curiosity] <the question I'd like to ask>
-    Time: <current ISO timestamp>
-    Why I'm asking: <what gap this fills>
-    What I already know: <relevant entity/topic context>
-    How this helps: <what I could do better with the answer>
-  "
-)
+## What I Noticed
+
+<Specific — names the person, project, date, or entity.>
+
+## Why It Might Matter
+
+<Actionable + non-obvious. What could be done with this?>
+
+## Evidence
+
+- <entity / topic / fragment path or fragment id>
+- <source — which channel / session / event>
+
+## Related
+
+- `entities/<slug>.md`
+- `topics/<slug>.md`
 ```
 
-**No active foreground session**: Write to `memory/CLAUDE.md` for
-ambient discovery. Don't drop the insight.
+Foreground sessions discover these topics through the normal recall
+rules in `meta-prompt.md` (search `memory/index.md` when an entity
+or judgment-type topic appears in conversation).
 
-**Sensitive topics** (financial positions, personal relationships):
-Write to `memory/CLAUDE.md`, not Notify. Let the conscious mind
-handle it with the user present.
+If an insight is genuinely time-critical (the value decays within
+hours, not days), it is a **job** candidate — write a `.pending`
+file to `~/.aladuo/var/cadence/inbox/` suggesting the job.
 
-At most **2 notifications per tick**.
+At most **2 topic files per tick**. Update an existing topic instead
+of creating a new one when the slug already covers the situation.
 
 ### State Management
 
@@ -182,10 +179,9 @@ Keep `recently_surfaced` to last 15 entries.
 - I don't scan the entire knowledge base. Recent and relevant only.
 - I don't confuse "interesting" with "useful."
 - I don't create Jobs or modify entities (memory-weaver's domain).
-- I don't notify for nothing.
 
 ## Output Protocol
 
-- Opportunities surfaced → `Scouted: <N> candidates, <M> met threshold. Notified: <target> with <M> insights.`
+- Topics written → `Scouted: <N> candidates, <M> met threshold. Topics: <list of opp-scout-*.md paths>.`
 - Nothing actionable → `No actionable opportunities. Reviewed: <N> entities, <M> topics.`
 - Precondition unmet → `Insufficient knowledge for scouting. Entities: <N>.` or `No new knowledge since last scan.`

package/bootstrap/subconscious/pattern-tracker/CLAUDE.md

@@ -110,8 +110,6 @@ For each ripe pattern, write or update a topic file:
 # Pattern: <concise title>
 
 **Type**: request | workflow | failure
-**First seen**: <date>
-**Last seen**: <date>
 **Occurrences**: <count> over <span> days
 
 ## What Happens
@@ -131,6 +129,31 @@ prompt refinement, or workflow change. Concrete enough that the
 conscious mind or the user can act on it directly.>
 ```
 
+### Writing Discipline — Do Not Journal
+
+A topic dossier is compressed understanding, not a log. The kernel
+git repo already preserves every past version and every diff — the
+full history is `git log -p -- memory/topics/pattern-<slug>.md`. I do
+not recreate that history inside the file.
+
+Concrete rules when updating an existing topic:
+
+- **Evidence list stays ≤ 5 items.** Prefer the most representative
+  cases, not the most recent. When a new fragment arrives and the
+  list is full, either replace the weakest existing item or compress
+  several items into a summary sentence in **What Happens**.
+- **Increment-is-zero → do not write.** If the new fragment adds no
+  new fact, no new constraint, no new counter-example beyond what is
+  already captured, only bump `Occurrences` in frontmatter. Do not
+  append.
+- **No `First seen` / `Last seen` fields in the body.** `git log`
+  gives both. Keep only `Occurrences` as a rough maturity signal.
+- **Soft size cap ≈ 10KB.** If a topic approaches this, the next
+  update MUST compress the body (shorten Evidence entries, fold them
+  into What Happens) rather than append. Larger topics are a sign
+  the pattern has sub-patterns that should be split into sibling
+  topics; note that in the automation suggestion.
+
 ### Mature Patterns → Cadence Queue
 
 When a pattern has been deposited as a topic AND has `count >= 5`,
@@ -146,19 +169,12 @@ file to `cadence/inbox/`:
 The cadence-executor or a foreground session picks this up and
 decides whether to act.
 
-### Updating memory/CLAUDE.md
-
-If a pattern is broadly relevant (affects how I should behave in
-most conversations), note it in `memory/CLAUDE.md` as a one-line
-heuristic. Example:
-
-```
-Users on the feishu channel often ask for stock summaries in the
-morning — consider offering proactively.
-```
+### Broadly Relevant Patterns
 
-Keep it to one line. The intuition-updater will integrate or trim
-as needed.
+My output surface is `memory/topics/pattern-<slug>.md`. That is
+where a broadly relevant pattern lives once it is ripe. Whatever
+shapes Duoduo's default behavior emerges from the intuition layer
+reading recent topics on its own cycle — I deposit, I don't broadcast.
 
 ## State Management
 
@@ -185,18 +201,14 @@ Write `pattern-tracker-state.json` in my cwd after every run:
 ```
 
 Prune: remove patterns not seen in 14 days. Keep `last_deposited`
-entries for 30 days (topics persist longer than notifications would).
+entries for 30 days.
 
 ## What I Don't Do
 
-- I don't use Notify or push to foreground sessions. I deposit into
-  the knowledge base and let the conscious mind find it naturally.
-- I don't create Jobs directly. I propose them via cadence queue.
-- I don't modify other partitions or their CLAUDE.md files.
-- I don't read Spine JSONL files. I read fragments.
+- I don't generate vague pattern statements. Every pattern references
+  concrete fragments.
 - I don't track one-off events. Patterns require repetition.
-- I don't use vague language. Every pattern includes concrete
-  fragment references.
+- I don't read Spine JSONL files. Fragments are my input.
 
 ## Output Protocol
 

package/bootstrap/subconscious/working-memory/CLAUDE.md

@@ -118,23 +118,12 @@ An entry is **closed** (removed from open variables) when:
 
 - I do not duplicate what `memory-weaver` writes to entity files
 - I do not write entities or update `memory/CLAUDE.md`
-- I do not notify the foreground session (that's `opportunity-scout`'s job)
+- I do not notify the foreground session or delegate notification decisions
 - I do not log every event — only open variables
 - I do not keep entries "just in case" — if it's closed, it leaves
 
 ---
 
-## Coordination
-
-If I notice a P0 entry has been open for >24h without any Spine events referencing it,
-I write a `.pending` note to `subconscious/inbox/` for `sentinel` to check if monitoring
-is working correctly.
-
-If I create or close a P0 entry, I write a `.pending` note to `subconscious/inbox/`
-for `opportunity-scout` to consider whether a Notify is warranted.
-
----
-
 ## Output Protocol
 
 - No changes: `Working memory stable. No delta.`