mixdog 0.9.121 → 0.9.122

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mixdog",
-  "version": "0.9.121",
+  "version": "0.9.122",
   "private": false,
   "type": "module",
   "description": "Standalone mixdog coding-agent CLI/TUI workspace.",

package/src/rules/shared/01-tool.md

@@ -12,58 +12,55 @@
   (`shell.cwd` is call-local and never changes the Project);
   explicit user-requested conversation reset→`session_manage`.
   Use only named tools present in the current tool surface.
-- Act only on verified identities (task/cwd/project/user/tool-returned) — paths,
-  module specifiers, symbols, data/record shapes alike; verify a guessed
-  identity with one lookup or sample before the first call or edit that
-  relies on it. Within the current project, pass
-  project-relative paths and omit optional scopes equal to its root; explicit
-  paths may be outside cwd only for targets outside the project.
+- Act only on verified identities (task/cwd/project/user/tool-returned) —
+  paths, module specifiers, symbols, data/record shapes alike; verify a
+  guessed identity with one lookup or sample before the first call or edit
+  that relies on it. Within the current project, pass project-relative
+  paths and omit optional scopes equal to its root; explicit paths may be
+  outside cwd only for targets outside the project.
 - Plan the fewest dependent rounds, then the fewest calls. Known state —
   anything the task supplied, a tool returned (applied patches and envelope
-  hints included), or a check already proved —
-  is never re-found, re-derived, or re-verified; a change to its subject
-  re-opens it. Batch calls iff none needs
-  another's output or can change another's inputs/state; otherwise
-  serialize. Before each batch, deduplicate the facets still required by the request,
-  route each once to the cheapest sufficient tool with all required
-  variants/scopes — every distinct sample/format in the same batch —
-  and launch every independent call together — never
-  split or duplicate a facet across tools, mutate merely to widen
-  retrieval, reserve known work, or cap fanout. Each round asks everything
-  it can and keeps everything it gets: guesses go wide in one batch, scopes
-  narrow only on verified cues — returned siblings/conventions or known
-  literals — and returned output is fully mined before the next round.
-  Symbol relations end at
+  hints included), or a check already proved — is never re-found,
+  re-derived, or re-verified; a change to its subject re-opens it. Batch
+  calls iff none needs another's output or can change another's
+  inputs/state; otherwise serialize. Before each batch, deduplicate the
+  facets still required by the request, route each once to the cheapest
+  sufficient tool with all required variants/scopes, and launch every
+  independent call together — never split or duplicate a facet across
+  tools, mutate merely to widen retrieval, reserve known work, or cap
+  fanout. Guesses go wide in one batch, scopes narrow only on verified
+  cues — returned siblings/conventions or known literals — and returned
+  output is fully mined before the next round. Symbol relations end at
   `code_graph`; values/locations end at the context grep returns; `read`
   covers only what returned spans cannot, as an anchored offset/limit
   window. A conclusive result ends its facet; evidence that determines the
   answer, edit, or deliverable ends retrieval — patch if needed.
-- Inspect read-only; writable handles, repair, or cleanup only when the
-  deliverable requires them, copying what they could destroy. Never clear
-  an obstacle or unexpected state by mutating it; unrecoverably lost
-  evidence ends its search — report best effort.
+- If inspection can change evidence or durable state, use read-only means;
+  mutate only when the deliverable requires it, first preserving evidence
+  at risk. Never mutate merely to clear an obstacle or unexpected state;
+  unrecoverably lost evidence ends its search — report best effort.
 - Once the edit or deliverable is determined, finish in one assistant turn:
-  before `apply_patch`, obtain every target hunk's exact current content and
-  anchor from `grep`, `code_graph`, `read`, or a prior successful patch
-  envelope; never infer patch context from
-  another file, a sample, or expected text. Then issue `apply_patch` calls
-  serially, never in parallel; use one cohesive call with one file section per
-  target, all patches first, then their one batched verification `shell` in
-  the same turn — the runtime runs it after every patch and only if all
-  succeeded, so verification never needs its own turn. It runs the real
-  required postconditions on every changed file and produced artifact,
-  never echoing a claim; changes made through `shell` verify under the same
+  before `apply_patch`, obtain every target hunk's exact current content
+  and anchor from `grep`, `code_graph`, `read`, or a prior successful patch
+  envelope; never infer patch context from another file, a sample, or
+  expected text. Then issue `apply_patch` calls serially, never in
+  parallel; use one cohesive call with one file section per target, all
+  patches first, then their one batched verification `shell` in the same
+  turn — the runtime runs it after every patch and only if all succeeded,
+  so verification never needs its own turn. It runs the real required
+  postconditions on every changed file and produced artifact, never
+  echoing a claim; changes made through `shell` verify under the same
   one-batch contract — one script proving every postcondition, value-level
-  included, never one check per round; a postcondition that did not actually run is
-  unresolved, not passed. Retry only failed envelopes; rerun a failed check only
-  after a change that can alter its outcome — commands alike; else switch
-  route or report it unresolved.
+  included, never one check per round; a postcondition that did not
+  actually run is unresolved, not passed. Retry only failed envelopes;
+  rerun a failed check only after a change that can alter its outcome —
+  commands alike; else switch route or report it unresolved.
   Hand-authored text is edited only with `apply_patch`; computed artifacts
   (data/reports/derived values) come from `shell` computation, never
   hand-transcribed numbers. Earlier `shell` is only for runtime/state
-  evidence unavailable to file tools—an independent facet, batched with
-  the rest; independent probes are parallel shell calls, never one
-  serial script per round.
+  evidence unavailable to file tools — an independent facet, batched with
+  the rest; independent probes are parallel shell calls, never one serial
+  script per round.
 - A long or uncertain command runs async — never nohup — and its
   `task_id` ends the turn; completion resumes work. Never poll in any
   form — sleep/status probes included; task control is for recovery or a

package/src/runtime/agent/orchestrator/tools/builtin/builtin-tools.mjs

@@ -62,7 +62,7 @@ export const BUILTIN_TOOLS = [
                             minItems: 1,
                         },
                     ],
-                    description: 'Project-relative file path, string[] files, [path,offset,limit?] range, or range[]; absolute only outside the project.',
+                    description: 'File path, string[] files, [path,offset,limit?] range, or range[].',
                 },
                 offset: { type: 'number', minimum: 0, description: 'Lines to skip.' },
                 limit: { type: 'number', minimum: 1, description: 'Max lines; default 2000.' },
@@ -128,7 +128,7 @@ export const BUILTIN_TOOLS = [
                         { type: 'string' },
                         { type: 'array', items: { type: 'string' }, minItems: 1 },
                     ],
-                    description: 'Project-relative file/dir scope(s); omit for project root; absolute only outside.',
+                    description: 'File/dir scope(s).',
                 },
                 glob: {
                     anyOf: [
@@ -169,7 +169,7 @@ export const BUILTIN_TOOLS = [
                         { type: 'string' },
                         { type: 'array', items: { type: 'string' }, minItems: 1 },
                     ],
-                    description: 'Project-relative base dir(s); omit for project root; path[] batches; absolute only outside.',
+                    description: 'Base dir(s); path[] batches.',
                 },
                 limit: { type: 'number', description: 'Max entries; default 100; 0 unlimited.' },
                 offset: { type: 'number', minimum: 0, description: 'Entry offset.' },
@@ -193,7 +193,7 @@ export const BUILTIN_TOOLS = [
                     ],
                     description: 'Filename or directory path fragments matched against path strings; query[] batches.',
                 },
-                path: { type: 'string', description: 'Project-relative base; omit for project root; absolute only outside.' },
+                path: { type: 'string', description: 'Base path.' },
                 limit: { type: 'number', description: 'Max paths; default 25; 0 unlimited.' },
                 include_noise: { type: 'boolean', description: 'Also search gitignored/dependency trees.' },
             },
@@ -214,7 +214,7 @@ export const BUILTIN_TOOLS = [
                         { type: 'string' },
                         { type: 'array', items: { type: 'string' }, minItems: 1 },
                     ],
-                    description: 'Project-relative directory; omit for project root; path[] batches; absolute only outside.',
+                    description: 'Directory; path[] batches.',
                 },
                 hidden: { type: 'boolean', description: 'Include dotfiles.' },
                 meta: { type: 'boolean', description: 'Per-entry size bytes, UTC mtime, octal mode.' },

package/src/runtime/agent/orchestrator/tools/code-graph-tool-defs.mjs

@@ -8,7 +8,7 @@ export const CODE_GRAPH_TOOL_DEFS = [
       type: 'object',
       properties: {
         mode: { type: 'string', enum: ['overview', 'imports', 'dependents', 'related', 'impact', 'symbols', 'find_symbol', 'symbol_search', 'search', 'references', 'callers', 'callees'], description: 'File modes: overview/imports/dependents/related/impact. symbols with files[] gives a file outline; others are symbol modes.' },
-        files: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' }, minItems: 1 }], description: 'Project-relative source file path(s); absolute only outside the project; supported targets only.' },
+        files: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' }, minItems: 1 }], description: 'Project-relative source file path(s).' },
         symbols: { anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' }, minItems: 1 }], description: 'Exact identifiers or keywords (symbol-index terms); batch multiple in one symbols[] call.' },
         body: { type: 'boolean', description: 'Include body.' },
         limit: { type: 'number', minimum: 1, description: 'Max results.' },

package/src/runtime/agent/orchestrator/tools/patch-tool-defs.mjs

@@ -47,8 +47,7 @@ const APPLY_PATCH_JSON_DESCRIPTION = [
   'Each section starts with exactly one: *** Add File: <path> (+ lines), *** Delete File: <path> (header only), or *** Update File: <path> (optional *** Move to: <new path>).',
   'Hunks start with @@ or @@ <symbol|1-based line>; lines start space, -, or +; every Update hunk needs >=1 +/- line; optional *** End of File.',
   'Use 3 verbatim context lines from newest output (post-patch body after edits); avoid overlap; stack @@ only if ambiguous.',
-  'Project-relative paths; explicit absolute paths only outside the project; + every added line. Never send compacted-history markers; re-read first.',
-  'A same-turn shell runs after all patches succeed.',
+  '+ prefixes every added line. Never send compacted-history markers; re-read first.',
 ].join('\n');
 
 export const PATCH_TOOL_DEFS = [