clauderipple 0.12.0 → 0.12.2

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.12.2 — 2026-10-22
+
+### Fixed
+
+- **Back on Wi-Fi only when a known Wi-Fi is in range.** After a hotspot failover, the way back
+  no longer drops the hotspot for a Wi-Fi that is not there, which cut the connection on the move.
+
+### Changed
+
+- **Naming a model on a delegation is now explained to the main chat.** `ripple:auto`'s
+  description says that `[[ripple: opus@high]]` (or a worker's name) on the first line runs that
+  model past every ClaudeRipple rule and still shows in the agents panel, so a session no longer
+  starts models outside it to get one. It also says what a brief should state, to check that the
+  report did what was asked, and to resume a worker only within 5 minutes of its last reply.
+
+## 0.12.1 — 2026-10-21
+
+### Changed
+
+- **One web setting covers page reading too.** WebFetch downloads a page and has the small, fast
+  model answer from it; that answer now comes from the model picked for web search, as WebSearch
+  already did, instead of Haiku on Claude quota. The Clients row is "Web search & page reading". If
+  that model fails before answering, the request goes where it went before.
+- **Design work takes the heavy level of the frontend + design ladder**, whatever tier it was
+  given: a task judged design runs on the heavy workers, since its result depends on the model's
+  taste rather than on difficulty. Frontend tasks still pick by tier.
+
 ## 0.12.0 — 2026-10-21
 
 ### Added

package/dist/app/package.json

@@ -1,5 +1,5 @@
 {
   "private": true,
-  "version": "0.12.0",
+  "version": "0.12.2",
   "type": "commonjs"
 }

package/dist/mod/hooks/register.tsx

@@ -8,7 +8,7 @@ import { rungOf } from './ladder'
 import { debugText, langFrom, t } from './i18n'
 import type { Lang } from './i18n'
 import { EFFORT_JUDGE_SYSTEM, finalEffort, isCacheSafeModel, isShortFollowUp, jevEffortRequest, jevFailure, jevUsage, jevWorkerRequest, judgeContext, parseEffortVerdict, parseJevEffort, parseJevKey, parseJevWorker, shouldJudge } from './judge'
-import { AUTO_DESCRIPTION, WORKER_JUDGE_SYSTEM, agentProvider, candidateUsable, chatgptUsable, claudeCandidates, ladderOptionsFrom, ladderPick, parseWorkerVerdict, readMarker, routerModelOptions, spawnModel, spawnTitle, takesOver, TIER_MARKERS, tierOf, workerJudgeInput, workerRule, zenJev } from './workers'
+import { AUTO_DESCRIPTION, WORKER_JUDGE_SYSTEM, agentProvider, candidateUsable, chatgptUsable, claudeCandidates, domainVerdict, ladderOptionsFrom, ladderPick, parseWorkerVerdict, readMarker, routerModelOptions, spawnModel, spawnTitle, takesOver, TIER_MARKERS, tierOf, workerJudgeInput, workerRule, zenJev } from './workers'
 import { MARKER, agentModel, fixSpawn } from './worker'
 import { activeModeOf, chatgptProviders, claudeWindow, eagerNote, gptLimitsFrom, modeKey, modeOver, quotaWindows, resetProvider, routingSettings } from './modes'
 import type { QuotaWindow } from './modes'
@@ -760,11 +760,15 @@ async function requestPick($: EngineInterface, e: AgentSpawnInput, s: Settings):
   const providers = options && options.until > now ? Object.fromEntries(Object.entries(options.providers ?? {}).filter(([, p]) => p.exhaustedUntil === undefined || p.exhaustedUntil > now)) : {}
   const explicitCandidate = target ? pinnedCandidates.find(c => c.target.agent === target!.agent) ?? (target.agent === 'general-purpose' ? { target, model: target.model ?? 'sonnet', provider: (await read($, routerModels)).find(m => m.value.toLowerCase() === target!.model)?.provider ?? 'anthropic' } : undefined) : undefined
   if (explicitCandidate && s.providers[explicitCandidate.provider] === false) return { deny: t(language, 'workers.disabled', { provider: explicitCandidate.provider }) }
-  // An active mode replaces the whole set; an explicit marker still names its own model.
+  // An active mode replaces the whole set; an explicit marker still names its own model. Design under
+  // the ui ladder takes the heavy level even past a tier marker: the main chat tiers by difficulty,
+  // and a design task is "standard" by that measure while its result depends on the model's taste.
   const { rule, ladder } = workerRule(verdict.domain, routing)
-  const resolved = explicitCandidate && candidateUsable(explicitCandidate, s, usable, providers)
+  const explicitUsable = !!explicitCandidate && candidateUsable(explicitCandidate, s, usable, providers)
+  const domained: ReturnType<typeof domainVerdict> = explicitUsable ? { verdict } : domainVerdict(verdict, rule)
+  const resolved = explicitUsable
     ? { target: target!, effort: verdict.effort }
-    : ladderPick(verdict, ladder, routing, pinnedCandidates, usable, language, routing.allow, providers, routing.allowKnown)
+    : ladderPick(domained.verdict, ladder, routing, pinnedCandidates, usable, language, routing.allow, providers, routing.allowKnown)
   const selected = resolved.target
   if (!selected) return { deny: t(language, 'workers.none') }
   const fallbackReason = resolved.fallbackReason
@@ -775,7 +779,7 @@ async function requestPick($: EngineInterface, e: AgentSpawnInput, s: Settings):
   const value: WorkerPick = { ...verdict, ...resolved, rule, target: selected, by, ms, id, ...(fallbackReason ? { fallbackReason } : {}) }
   // The verdict behind a pick is otherwise only in the agents panel; one debug line per pick keeps
   // it checkable: what the judge said, the rung it landed on and what ran.
-  const entry = { task: e.description.slice(0, 200), domain: value.domain, level: value.level, kind: value.kind ?? 'do', sure: value.sure, rule: value.rule, rung: value.rung, position: value.position, skipped: value.skipped, target: value.target, model: model ?? null, effort: value.effort, by, ...(mode ? { mode: mode.name } : {}), ...(fallbackReason ? { fallbackReason } : {}) }
+  const entry = { task: e.description.slice(0, 200), domain: value.domain, level: value.level, kind: value.kind ?? 'do', sure: value.sure, rule: value.rule, ...(domained.raised ? { raised: domained.raised } : {}), rung: value.rung, position: value.position, skipped: value.skipped, target: value.target, model: model ?? null, effort: value.effort, by, ...(mode ? { mode: mode.name } : {}), ...(fallbackReason ? { fallbackReason } : {}) }
   await $.ui.log('ClaudeRipple worker pick: ' + JSON.stringify(entry), { to: 'debug' })
   // The brief itself is never logged (it can hold anything); its length is. To re-judge a pick,
   // its brief is in the session's own transcript under the same description.

package/dist/mod/hooks/workers.ts

@@ -11,7 +11,11 @@ export const AUTO_DESCRIPTION = 'Delegate any task here; ClaudeRipple picks the
   'If you know how hard the task is, put [[ripple: light]], [[ripple: standard]], [[ripple: hard]] or [[ripple: max]] on the prompt\'s first line: ' +
   'light = lookups, mechanical edits, one small fix; standard = carry out a designed change (even across several files), research, summarize, read-only review; ' +
   'hard = subtle debugging, security review, or work where a wrong call is costly; max = planning, design or architecture where the deliverable is the decision itself. ' +
-  'Size, file count or the brief\'s warnings do not by themselves make a task hard. Leave the marker out when unsure, and ClaudeRipple judges it.'
+  'Size, file count or the brief\'s warnings do not by themselves make a task hard. Leave the marker out when unsure, and ClaudeRipple judges it. ' +
+  'To run one particular model instead (the user asked for it, or a comparison needs it), name it on the first line: [[ripple: opus@high]] for a Claude model (opus, sonnet, haiku), or [[ripple: <worker agent name>@<effort>]]. ' +
+  'It runs as named, past every ClaudeRipple rule, and still shows in the agents panel; never start a model another way, such as claude -p, to get around the rules. ' +
+  'A brief states the scope, what must not be touched, the done criteria and how to verify them. Read the report for whether it did what was asked before using it. ' +
+  'Continue a worker with SendMessage only within 5 minutes of its last reply; later its cache has lapsed, so start a new one with a summary of what is done and what is left.'
 
 /**
  * The tier markers the main chat may write on a ripple:auto prompt, as the judge's verdict they
@@ -171,6 +175,20 @@ export function workerRule(domain: Domain, settings: Settings): { rule: WorkerPi
   return ladder ? { rule: key, ladder } : { rule: 'general', ladder: settings.rules.general }
 }
 
+/**
+ * Visual design depends on the model's taste, not on how hard the task is (2026-10-21: a store
+ * screenshot redesign judged "design, standard" ran on the light pair). Under the ui ladder a design
+ * verdict on the light or standard rung is raised to the hard rung; frontend, other ladders and
+ * verdicts already on hard or plan are untouched.
+ */
+export function domainVerdict(verdict: WorkerVerdict, rule: WorkerPick['rule']): { verdict: WorkerVerdict; raised?: 'design' } {
+  if (rule !== 'ui' || verdict.domain !== 'design') return { verdict }
+  const rung = rungOf(verdict)
+  if (rung !== 'light' && rung !== 'standard') return { verdict }
+  const { sure: _sure, ...rest } = verdict
+  return { verdict: { ...rest, ...TIER_MARKERS.hard! }, raised: 'design' }
+}
+
 export type Resolution = { target?: TierTarget; effort: Effort; rung?: Rung; position?: number; skipped?: { rung: Rung; position: number; model: string; reason: string }[]; fallbackReason?: string }
 
 /** Claude Code's own agent with no model: the subagent runs on the session's model. */

package/dist/mod/tests/register.test.tsx

@@ -654,7 +654,7 @@ for (const [tier, rung, agent, model] of [
 
 for (const domain of ['design', 'frontend', 'backend', 'docs'] as const) test(`auto selects the ${domain} task's domain ladder or its own general fallback`, async ($, on) => {
   const b = boundaries(on, { domainRules: {
-    ui: { mode: 'ladder', rungs: { light: [{ target: { agent: 'gpt-6-astra' }, effort: 'high' }] } },
+    ui: { mode: 'ladder', rungs: { light: [{ target: { agent: 'gpt-6-astra' }, effort: 'high' }], hard: [{ target: { agent: 'gpt-6-1-sol' }, effort: 'high' }] } },
     backend: { mode: 'ladder', rungs: { light: [{ target: { agent: 'gpt-6-1-sol' }, effort: 'medium' }] } },
   } })
   http(on)
@@ -663,8 +663,24 @@ for (const domain of ['design', 'frontend', 'backend', 'docs'] as const) test(`a
   await start($)
   await $.agent.spawn(SPAWN)
   const rule = domain === 'design' || domain === 'frontend' ? 'ui' : domain === 'backend' ? 'backend' : 'general'
-  expect(sent[0]?.subagentType).toBe(rule === 'ui' ? 'gpt-6-astra' : rule === 'backend' ? 'gpt-6-1-sol' : 'deepseek-v4-1-flash')
-  expect(JSON.parse(b.files.get('/home/test/.clauderipple/logs/worker-picks.jsonl')!)).toMatchObject({ rule, domain, rung: 'light' })
+  // A light design verdict is raised to the heavy pair (visual taste, not difficulty); frontend keeps its level.
+  const raised = domain === 'design'
+  expect(sent[0]?.subagentType).toBe(rule === 'ui' ? (raised ? 'gpt-6-1-sol' : 'gpt-6-astra') : rule === 'backend' ? 'gpt-6-1-sol' : 'deepseek-v4-1-flash')
+  const row = JSON.parse(b.files.get('/home/test/.clauderipple/logs/worker-picks.jsonl')!)
+  expect(row).toMatchObject({ rule, domain, level: 'light', rung: raised ? 'hard' : 'light' })
+  expect(row.raised).toBe(raised ? 'design' : undefined)
+})
+
+test('a design task under the ui ladder takes the heavy level past a tier marker', async ($, on) => {
+  const b = boundaries(on, { domainRules: { ui: { mode: 'ladder', rungs: { light: [{ target: { agent: 'gpt-6-astra' }, effort: 'high' }], hard: [{ target: { agent: 'gpt-6-1-sol' }, effort: 'high' }] } } } })
+  http(on)
+  judgeStub(on, JSON.stringify({ domain: 'design', level: 'deep', kind: 'do', effort: 'high', sure: 0.9, why: 'domain' }))
+  const sent = spawnStub(on)
+  await start($)
+  await $.agent.spawn({ ...SPAWN, prompt: '[[ripple: light]]\nTweak a color.' })
+  expect(sent[0]?.subagentType).toBe('gpt-6-1-sol')
+  const row = JSON.parse(b.files.get('/home/test/.clauderipple/logs/worker-picks.jsonl')!.trim().split('\n').find(line => line.includes('"type":"pick"'))!)
+  expect(row).toMatchObject({ by: 'session', rule: 'ui', domain: 'design', rung: 'hard', raised: 'design' })
 })
 
 for (const domains of [false, true]) test(`tier marker ${domains ? 'awaits' : 'does not await'} one pending shadow judge with domain ladders ${domains ? 'on' : 'off'}`, async ($, on) => {