dsh-super-code 0.2.1 → 0.3.1

package/docs/UsageGuide.md

@@ -10,6 +10,20 @@ The [three steps in the README](../README.md) will get you started. This page co
 
 If you already have a working model, there is nothing extra to configure for the plugin. Otherwise, add a provider under Harness “Settings” → “Models”, then choose a model and reasoning effort below the message input. Super Code uses the current session's choice rather than a separate model pool. Child Agents inherit the parent Agent's model by default, while Harness manages permissions and tools.
 
+## 批量工具调用 · Batched Tool Calls
+
+0.3.0 的 Super Code 预设使用 Harness 原生 PTC。Agent 可以在一次模型调用里组合几个工具操作，例如同时读取互不依赖的文件，拿到结果后再决定下一步。它不需要额外的 Agent，也不用另选模式。
+
+The Super Code preset in 0.3.0 uses Harness-native PTC. An Agent can compose several tool operations in one model call—for example, read independent files together before deciding what to do next. It needs neither an extra Agent nor a separate mode selection.
+
+默认指导要求独立读取按需并行，写入、测试、状态变更和依赖步骤依次执行；失败时保留已成功的结果，只重试失败或过期的读取。插件向宿主声明任务和记忆工具中哪些动作可以并行，未知动作默认独占。其他工具是否允许并行，由它们在 Harness 中的声明决定。权限确认、取消、结果保存和部分失败都由宿主管理。
+
+The default guidance calls for parallel reads when useful, ordered writes, tests, state changes, and dependent steps, and retries limited to failed or stale reads while retaining successful results. The plugin declares which task and memory actions are safe to overlap; unknown actions remain exclusive. Other tools use their own Harness concurrency declarations. Harness handles permissions, cancellation, result persistence, and partial failures.
+
+批量调用减少的是模型与工具之间的来回，不保证每项操作都会更快，也不改变模型、权限或记忆的设置。
+
+Batching reduces round trips between the model and tools. It does not guarantee that every operation runs faster or change model, permission, or memory settings.
+
 ## 找不到预设 · Can't Find the Preset?
 
 先确认插件已启用，并按[兼容矩阵](Compatibility.md)核对宿主版本与实际依赖。插件按宿主提供的预设机制选择以下两条路径。
@@ -18,13 +32,13 @@ First confirm the plugin is enabled and check the host version and installed dep
 
 ### Harness 0.1.7 / 0.2.0 / 0.2.1：声明式预设 · Declarative Presets
 
-在已验证的 0.1.7、0.2.0 和 0.2.1 版本上，Super Code 由插件 bundle 声明，宿主负责发现和加载；插件不会创建用户预设目录。设置页显示宿主报告的预设状态，不提供安装、重命名或重装目录副本的流程。若状态为缺失或损坏，检查插件是否启用、宿主组件是否混版，以及日志中的预设依赖错误，而不是反复点击安装。
+Super Code 由插件 bundle 声明，宿主负责加载。从 0.3.1 起，未安装时可以在“设置”→ **Super Code** 安装预设；已安装时提供“重新安装预设”，确认后按所填名称和标识符替换。声明保存在当前 profile 的补丁层，通过宿主公开接口加载，不需要用户预设目录。宿主未开放管理接口时，页面会明确提示。
 
-On the verified 0.1.7, 0.2.0, and 0.2.1 versions, the plugin bundle declares Super Code and the host discovers and loads it; the plugin does not create a user preset directory. Settings show the host's preset status rather than a workflow for installing, renaming, or reinstalling directory copies. If the preset is missing or broken, check plugin activation, mixed host versions, and preset dependency errors in the logs instead of retrying directory installation.
+The plugin bundle declares Super Code and the host loads it. From 0.3.1, use “Settings” → **Super Code** to install a missing preset or confirm reinstallation of an installed preset with the entered name and identifier. Declarations persist in the current profile's patch layer and load through public host APIs; no user preset directory is needed. Hosts without management APIs show an explicit notice.
 
-声明默认名称为 `Super Code`，描述为 `A faster, more efficient, smarter coding mode.`；插件不在此路径同步预设名称/描述的语言或改写用户 profile。定制应通过宿主支持的配置机制进行，本轮兼容冒烟不覆盖全部定制场景。插件界面本身仍支持中英文。
+声明式预设的默认名称和描述从 0.3.1 起跟随中英文设置，已自定义的字段保留。语言变化只调整展示字段，不更新旧预设的内容或版本；确认重装才使用当前插件随包的组合。
 
-The declaration defaults to the name `Super Code` and description `A faster, more efficient, smarter coding mode.` On this path, the plugin does not synchronize the preset name/description language or rewrite the user profile. Use the host's supported configuration mechanisms for customization; the smoke checks do not cover every customization scenario. The plugin interface itself still supports Chinese and English.
+From 0.3.1, default declarative preset names and descriptions follow Chinese/English settings while custom fields remain intact. Language changes update display fields only, retaining the older preset's content and version. Confirmed reinstallation uses the composition shipped with the current plugin.
 
 插件管理中的展示信息独立于预设声明：0.2.1 通过导出的语言资源提供 `Super Code 模式` / `Super Code` 和对应描述，支持新版宿主读取根路径及子路径的展示信息。
 
@@ -32,15 +46,25 @@ Plugin management metadata is separate from the preset declaration. Version 0.2.
 
 ### Harness 0.1.5/0.1.6：目录预设 · Directory Presets
 
-如果 Harness 没发现插件自带的 `super-code`，插件首次加载时会尝试安装一份用户预设。仍然没看到时，打开“设置”→ **Super Code**，展开卡片查看状态并手动安装。默认标识符 `super-code` 若已被占用，换一个即可；原有预设不会被覆盖。之后若主动删除这份用户副本，重启也不会自动重装，需要再次手动安装。0.2.0 以前的插件设置入口在“插件”→“插件配置”中。
+如果 Harness 没发现插件自带的 `super-code`，插件首次加载时会尝试安装一份用户预设。仍然没看到时，打开“设置”→ **Super Code**，查看状态并手动安装；0.3.1 起此页始终展开。默认标识符 `super-code` 若已被占用，换一个即可；原有预设不会被覆盖。之后若主动删除这份用户副本，重启也不会自动重装，需要再次手动安装。0.2.0 以前的插件设置入口在“插件”→“插件配置”中。
 
-If Harness doesn't find the bundled `super-code` preset, the plugin tries to install a user copy on first load. If it still isn't listed, open “Settings” → **Super Code** and expand the card to check its status or install it manually. If the default identifier `super-code` is taken, choose another; the existing preset won't be overwritten. If you later delete this copy, a restart won't reinstall it automatically. Plugin versions before 0.2.0 place this page under “Plugins” → “Plugin configuration”.
+If Harness doesn't find the bundled `super-code` preset, the plugin tries to install a user copy on first load. If it still isn't listed, open “Settings” → **Super Code** to check its status or install it manually; this page stays expanded from 0.3.1 onward. If the default identifier `super-code` is taken, choose another; the existing preset won't be overwritten. If you later delete this copy, a restart won't reinstall it automatically. Plugin versions before 0.2.0 place this page under “Plugins” → “Plugin configuration”.
+
+## 查看预设版本 · Checking the Preset Version
+
+0.3.1 起，“设置”→ **Super Code** 分别显示已加载的插件版本和当前预设版本。预设版本来自实际加载的预设组合；两者一致时表示预设与当前安装的插件同步，不代表 npm 上没有更新版本。旧预设没有版本记录时，会显示“未记录版本”，不会自动视为最新版。修改名称或切换语言不改变预设版本。
+
+From 0.3.1 onward, “Settings” → **Super Code** shows the loaded plugin version and the current preset version separately. The preset version comes from its actual composition. Matching versions mean the preset is in sync with the installed plugin, not that no newer npm release exists. Older presets without version metadata show “Version not recorded”. Renaming a preset or changing the language does not change its version.
+
+若版本不一致，先保留需要的自定义内容，再通过确认清单重装。目录式宿主替换用户副本，声明式宿主替换本插件拥有的声明，均保留恢复备份。重装后刷新仍不一致时，检查插件更新是否生效及宿主日志。
+
+If versions differ, save the custom content you need, then confirm reinstallation. Directory hosts replace the user copy; declarative hosts replace this plugin's owned declaration. Both retain recovery backups. If refreshed versions still differ, check that the plugin update took effect and inspect host logs.
 
 ## 名称与语言 · Names and Language
 
-本节的名称同步和自定义安装名称适用于旧宿主的目录预设，不适用于 0.1.7 / 0.2.0 / 0.2.1 的声明式预设。
+0.3.1 的名称同步和自定义安装名称同时支持目录式与声明式预设。
 
-The name synchronization and custom installation names in this section apply to directory presets on older hosts, not declarative presets on 0.1.7 / 0.2.0 / 0.2.1.
+Version 0.3.1 supports display-language synchronization and custom installation names for directory and declarative presets.
 
 标识符和显示名称是两回事：标识符用于选择预设，显示名称可以单独修改。默认名称会跟随 Harness 的中英文语言设置；自定义名称可以包含中文和空格，例如 `Super Code 模式`，最多 120 个字符。插件只更新仍保持默认值的名称和描述，不会改动你的自定义内容。
 
@@ -52,9 +76,9 @@ Older Harness versions cache the preset list, so the page refreshes once if the
 
 ## 重装与备份 · Reinstallation and Backup
 
-仅适用于插件在旧宿主上管理的用户目录副本；0.1.7 / 0.2.0 / 0.2.1 声明式预设没有此重装/备份流程。
+目录副本与声明式预设均支持此流程；插件只替换能够核实归属的预设。
 
-This applies only to user-directory copies managed by the plugin on older hosts. Declarative presets on 0.1.7 / 0.2.0 / 0.2.1 do not use this reinstallation/backup workflow.
+This workflow supports directory copies and declarative presets. The plugin replaces only presets whose ownership can be verified.
 
 已安装用户预设时，可以点“重新安装预设”。确认框会列出将被替换的预设及新名称、标识符，先核对再确认。可以从列表中移除条目，但全部移除后不能确认；取消或按 Escape 不会改动预设。重装会重置旧副本的内容，所以自定义内容请先自行留存。
 
@@ -64,6 +88,10 @@ If a user preset is already installed, you can choose “Reinstall preset”. Th
 
 To avoid removing the wrong files, the plugin replaces only copies whose installation record, UUID, path, and directory identity all match. It never automatically deletes unmarked legacy copies. The previous directory stays under `.super-code-backup-*/<old-id>` in the user preset root and won't appear in the preset list. An installation failure restores the old directory; after an unexpected interruption, you can recover it manually from the backup.
 
+声明式宿主通过 bundle 来源标记，或匹配的安装记录、声明标识符和 UUID 核实归属；同名的无标记声明不会自动认领。旧声明及原 profile 补丁保存在当前 profile 的 `.super-code-backup-*` 中，安装记录位于 `.super-code-presets.json`。失败时尝试恢复原补丁和记录；若进程中断，可从备份恢复。已有会话继续使用宿主保留的旧预设组合，新会话使用重装后的版本。
+
+Declarative hosts verify a bundle source marker or matching installation record, entry identity and UUID. Unmarked same-name declarations are not adopted automatically. The previous declaration and profile patch stay in `.super-code-backup-*` under the current profile; `.super-code-presets.json` stores ownership records. Failures attempt to restore the original patch and record; backups allow recovery after interruption. Existing sessions retain their old composition through the host; new sessions use the reinstalled version.
+
 ## Agent 执行树 · Agent Execution Tree
 
 右侧执行树显示当前会话中各 Agent 的状态、用量和缓存率。拖动空白处平移，滚轮或按钮缩放；点一个节点，就能在侧栏新标签查看详情，主对话不会切换。界面跟随 Harness 的中英文语言设置。

package/lib/core/batch-policy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Small, host-facing classification for calls assembled by one PTC program.
+ * The Harness owns scheduling; this module only declares whether an action is
+ * safe to overlap. Unknown actions stay exclusive by default.
+ */
+export type BatchActionKind = 'read' | 'write' | 'test' | 'unknown';
+export type BatchSafety = 'parallel' | 'exclusive';
+/** Classify task-ledger actions. Validation is a read of the current snapshot. */
+export declare function classifyTaskAction(action: string): BatchActionKind;
+/** Classify durable-memory actions. Unknown scopes/actions remain exclusive. */
+export declare function classifyMemoryAction(action: string): BatchActionKind;
+/** Only explicitly read-only calls may overlap in the host scheduler. */
+export declare function batchSafety(kind: BatchActionKind): BatchSafety;
+//# sourceMappingURL=batch-policy.d.ts.map

package/lib/core/batch-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-policy.d.ts","sourceRoot":"","sources":["../../src/core/batch-policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AACnE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAA;AASlD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAKlE;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAKpE;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAE9D"}

package/lib/core/batch-policy.js

@@ -0,0 +1,31 @@
+const TASK_READ_ACTIONS = new Set([
+    'list', 'read', 'delegate', 'validate_member', 'source', 'history', 'archives', 'evidence',
+]);
+const TASK_WRITE_ACTIONS = new Set(['create', 'update', 'focus', 'archive', 'restore']);
+const MEMORY_READ_ACTIONS = new Set(['topics', 'read']);
+const MEMORY_WRITE_ACTIONS = new Set(['remember', 'forget']);
+/** Classify task-ledger actions. Validation is a read of the current snapshot. */
+export function classifyTaskAction(action) {
+    if (TASK_READ_ACTIONS.has(action))
+        return 'read';
+    if (TASK_WRITE_ACTIONS.has(action))
+        return 'write';
+    if (/^(test|check|verify|assert)(?:_|$)/.test(action))
+        return 'test';
+    return 'unknown';
+}
+/** Classify durable-memory actions. Unknown scopes/actions remain exclusive. */
+export function classifyMemoryAction(action) {
+    if (MEMORY_READ_ACTIONS.has(action))
+        return 'read';
+    if (MEMORY_WRITE_ACTIONS.has(action))
+        return 'write';
+    if (/^(test|check|verify|assert)(?:_|$)/.test(action))
+        return 'test';
+    return 'unknown';
+}
+/** Only explicitly read-only calls may overlap in the host scheduler. */
+export function batchSafety(kind) {
+    return kind === 'read' ? 'parallel' : 'exclusive';
+}
+//# sourceMappingURL=batch-policy.js.map

package/lib/core/batch-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-policy.js","sourceRoot":"","sources":["../../src/core/batch-policy.ts"],"names":[],"mappings":"AAQA,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU;CAC3F,CAAC,CAAA;AACF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;AACvF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;AACvD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE5D,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IAChD,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAA;IAClD,IAAI,oCAAoC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACpE,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IAClD,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAA;IACpD,IAAI,oCAAoC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACpE,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC/C,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAA;AACnD,CAAC"}

package/lib/core/teams.d.ts

@@ -13,7 +13,7 @@ export type MethodName = 'investigation' | 'product' | 'bugfix' | 'architecture'
 export declare const METHODS: Readonly<Record<MethodName, string>>;
 export declare const TEAMS: Readonly<Record<TeamName, TeamDefinition>>;
 /** Stable, compact instructions; the host logs selected methods as tool results. */
-export declare const SUPER_CODE_INSTRUCTIONS = "You are super-code, completing the user's authorized coding work.\nChoose by deliverable: research, design, develop, verify, optimize. Teams are specialties, not stages. Use super_code_method when causes remain indistinguishable, failures repeat or state/recovery behavior is unclear; reuse loaded guidance. No mandatory routing or reflection loop.\nExplanation/design does not authorize edits; methods/teammates grant no permission. Ask only for decisions affecting correctness or scope. Diagnosis is not a fix.\nFor long/interleaved work, use super_code_task to preserve user-sourced requirements, acceptance, decisions/evidence and next dependency before switching or compaction, not each action. Corrections replace affected constraints only. Never truncate hard requirements. Resume from current context; read missing details and recheck mutable evidence. Status questions do not cancel work.\nBatch independent tools first. Delegate independent deliverables for time or verification value; reuse members for related scope, never recursively. Continue locally; one writer per file or isolated workspaces. For recorded tasks, delegate binds ownership/versions; validate_member precedes lead review. Neither starts workers nor enforces token budgets. Reject stale returns; count all attempts; unknown-stop is not success.\nResolve APIs from visible contracts and callers, never guessed tests or aliases. Before finishing, compare the diff with requirements and affected existing behavior. Check changed recovery/state paths, not just the happy path. An unresolved failure stays unresolved unless baseline evidence or an explicit contract change explains it; future tests cannot establish success. When stuck, change the hypothesis or reduce the reproduction before expanding scope.\nMinimize request cost: reuse context, read targeted ranges, batch independent checks. Keep full verbose logs in task files; report exit status, executed test counts, failure context and file references. Do not hide errors or skip required checks to save tokens. Inspect scaling and resource release. Report delivery, checks and gaps; no unmeasured gains.";
+export declare const SUPER_CODE_INSTRUCTIONS = "You are super-code, completing the user's authorized coding work.\nChoose by deliverable: research, design, develop, verify, optimize. Teams are specialties, not stages. Load super_code_method only for an unclear cause, repeated failure or recovery/state problem; reuse it.\nExplanation/design does not authorize edits; methods/teammates grant no permission. Ask only when correctness or scope needs a decision. Diagnosis is not a fix.\nFor long/interleaved work, use super_code_task before switching or compaction. Preserve user requirements, acceptance, decisions/evidence and the next dependency; corrections replace only affected constraints. Never truncate hard requirements. Resume from current context; status questions do not cancel work.\nBatch is dispatch-only: use one run_code program for independent reads when it changes the next step. The host preserves permissions, cancellation, result links and partial failures. Within that program, normalize identical tool+argument reads and share one promise/result; never cache across calls or bypass a permission/guard. Use Promise.allSettled to keep successes and failure reasons. Prefer decisive checks over speculative fan-out; retry only failed/stale reads; never replay successes, writes, tests or unknown side effects. Sequence writes, tests, state and dependency gates. Use a small per-run budget (usually <=8 calls); stop on cancellation and keep completed results. PTC is optional when native tool presentation is unavailable.\nDelegate only independent deliverables with clear ownership; reuse a settled member for related work, never recurse. One writer per file or isolated workspace. Reject stale returns, count every attempt and treat unknown-stop as unresolved. Resolve APIs from visible contracts and callers, never guessed aliases.\nBefore finishing, compare the diff with requirements and affected behavior, including recovery/state and resource release. Run named acceptance and affected tests; partial pass, zero tests, environment errors and future tests are not completion. Keep verbose logs in files, report exit status, counts, failure context and limits. Stop unrelated exploration after supported evidence; claim no unmeasured gains.";
 /** Read exactly the selected team/method; caller chooses using task meaning. */
 export declare function readTeamMethod(team: TeamName, method?: MethodName): string;
 //# sourceMappingURL=teams.d.ts.map

package/lib/core/teams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"teams.d.ts","sourceRoot":"","sources":["../../src/core/teams.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,UAAU,kEAAmE,CAAA;AAC1F,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;AAChD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;CACxC;AAED,sFAAsF;AACtF,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAA;AACtJ,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAU9C,CAAA;AAEX,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAM3D,CAAA;AAEF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,imEAM+T,CAAA;AAEnW,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAM1E"}
+{"version":3,"file":"teams.d.ts","sourceRoot":"","sources":["../../src/core/teams.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,UAAU,kEAAmE,CAAA;AAC1F,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;AAChD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;CACxC;AAED,sFAAsF;AACtF,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAA;AACtJ,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAU9C,CAAA;AAEX,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAM3D,CAAA;AAEF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,6qEAMsX,CAAA;AAE1Z,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAM1E"}

package/lib/core/teams.js

@@ -20,12 +20,12 @@ export const TEAMS = Object.freeze({
 });
 /** Stable, compact instructions; the host logs selected methods as tool results. */
 export const SUPER_CODE_INSTRUCTIONS = `You are super-code, completing the user's authorized coding work.
-Choose by deliverable: research, design, develop, verify, optimize. Teams are specialties, not stages. Use super_code_method when causes remain indistinguishable, failures repeat or state/recovery behavior is unclear; reuse loaded guidance. No mandatory routing or reflection loop.
-Explanation/design does not authorize edits; methods/teammates grant no permission. Ask only for decisions affecting correctness or scope. Diagnosis is not a fix.
-For long/interleaved work, use super_code_task to preserve user-sourced requirements, acceptance, decisions/evidence and next dependency before switching or compaction, not each action. Corrections replace affected constraints only. Never truncate hard requirements. Resume from current context; read missing details and recheck mutable evidence. Status questions do not cancel work.
-Batch independent tools first. Delegate independent deliverables for time or verification value; reuse members for related scope, never recursively. Continue locally; one writer per file or isolated workspaces. For recorded tasks, delegate binds ownership/versions; validate_member precedes lead review. Neither starts workers nor enforces token budgets. Reject stale returns; count all attempts; unknown-stop is not success.
-Resolve APIs from visible contracts and callers, never guessed tests or aliases. Before finishing, compare the diff with requirements and affected existing behavior. Check changed recovery/state paths, not just the happy path. An unresolved failure stays unresolved unless baseline evidence or an explicit contract change explains it; future tests cannot establish success. When stuck, change the hypothesis or reduce the reproduction before expanding scope.
-Minimize request cost: reuse context, read targeted ranges, batch independent checks. Keep full verbose logs in task files; report exit status, executed test counts, failure context and file references. Do not hide errors or skip required checks to save tokens. Inspect scaling and resource release. Report delivery, checks and gaps; no unmeasured gains.`;
+Choose by deliverable: research, design, develop, verify, optimize. Teams are specialties, not stages. Load super_code_method only for an unclear cause, repeated failure or recovery/state problem; reuse it.
+Explanation/design does not authorize edits; methods/teammates grant no permission. Ask only when correctness or scope needs a decision. Diagnosis is not a fix.
+For long/interleaved work, use super_code_task before switching or compaction. Preserve user requirements, acceptance, decisions/evidence and the next dependency; corrections replace only affected constraints. Never truncate hard requirements. Resume from current context; status questions do not cancel work.
+Batch is dispatch-only: use one run_code program for independent reads when it changes the next step. The host preserves permissions, cancellation, result links and partial failures. Within that program, normalize identical tool+argument reads and share one promise/result; never cache across calls or bypass a permission/guard. Use Promise.allSettled to keep successes and failure reasons. Prefer decisive checks over speculative fan-out; retry only failed/stale reads; never replay successes, writes, tests or unknown side effects. Sequence writes, tests, state and dependency gates. Use a small per-run budget (usually <=8 calls); stop on cancellation and keep completed results. PTC is optional when native tool presentation is unavailable.
+Delegate only independent deliverables with clear ownership; reuse a settled member for related work, never recurse. One writer per file or isolated workspace. Reject stale returns, count every attempt and treat unknown-stop as unresolved. Resolve APIs from visible contracts and callers, never guessed aliases.
+Before finishing, compare the diff with requirements and affected behavior, including recovery/state and resource release. Run named acceptance and affected tests; partial pass, zero tests, environment errors and future tests are not completion. Keep verbose logs in files, report exit status, counts, failure context and limits. Stop unrelated exploration after supported evidence; claim no unmeasured gains.`;
 /** Read exactly the selected team/method; caller chooses using task meaning. */
 export function readTeamMethod(team, method) {
     const definition = TEAMS[team];

package/lib/core/teams.js.map

@@ -1 +1 @@
-{"version":3,"file":"teams.js","sourceRoot":"","sources":["../../src/core/teams.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAA;AAa1F,MAAM,CAAC,MAAM,OAAO,GAAyC,MAAM,CAAC,MAAM,CAAC;IACzE,aAAa,EAAE,inBAAinB;IAChoB,OAAO,EAAE,iaAAia;IAC1a,MAAM,EAAE,4tBAA4tB;IACpuB,YAAY,EAAE,miBAAmiB;IACjjB,SAAS,EAAE,ykBAAykB;IACplB,OAAO,EAAE,00BAA00B;IACn1B,WAAW,EAAE,oeAAoe;IACjf,WAAW,EAAE,mjBAAmjB;IAChkB,OAAO,EAAE,8WAA8W;CAC/W,CAAC,CAAA;AAEX,MAAM,CAAC,MAAM,KAAK,GAA+C,MAAM,CAAC,MAAM,CAAC;IAC7E,QAAQ,EAAE,EAAE,OAAO,EAAE,mDAAmD,EAAE,QAAQ,EAAE,kFAAkF,EAAE,QAAQ,EAAE,0EAA0E,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE;IACzS,MAAM,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE,QAAQ,EAAE,8EAA8E,EAAE,QAAQ,EAAE,sFAAsF,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE;IAC5U,OAAO,EAAE,EAAE,OAAO,EAAE,iEAAiE,EAAE,QAAQ,EAAE,wFAAwF,EAAE,QAAQ,EAAE,sEAAsE,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE;IAC5U,MAAM,EAAE,EAAE,OAAO,EAAE,2DAA2D,EAAE,QAAQ,EAAE,iFAAiF,EAAE,QAAQ,EAAE,iFAAiF,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE;IAC/S,QAAQ,EAAE,EAAE,OAAO,EAAE,sEAAsE,EAAE,QAAQ,EAAE,sGAAsG,EAAE,QAAQ,EAAE,2FAA2F,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE;CACzX,CAAC,CAAA;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;mWAM4T,CAAA;AAEnW,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAc,EAAE,MAAmB;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAA;IACzD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAA;IACzG,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,OAAO,KAAK,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,CAAA;IAChG,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,QAAQ,eAAe,UAAU,CAAC,QAAQ,cAAc,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AAC9I,CAAC"}
+{"version":3,"file":"teams.js","sourceRoot":"","sources":["../../src/core/teams.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAA;AAa1F,MAAM,CAAC,MAAM,OAAO,GAAyC,MAAM,CAAC,MAAM,CAAC;IACzE,aAAa,EAAE,inBAAinB;IAChoB,OAAO,EAAE,iaAAia;IAC1a,MAAM,EAAE,4tBAA4tB;IACpuB,YAAY,EAAE,miBAAmiB;IACjjB,SAAS,EAAE,ykBAAykB;IACplB,OAAO,EAAE,00BAA00B;IACn1B,WAAW,EAAE,oeAAoe;IACjf,WAAW,EAAE,mjBAAmjB;IAChkB,OAAO,EAAE,8WAA8W;CAC/W,CAAC,CAAA;AAEX,MAAM,CAAC,MAAM,KAAK,GAA+C,MAAM,CAAC,MAAM,CAAC;IAC7E,QAAQ,EAAE,EAAE,OAAO,EAAE,mDAAmD,EAAE,QAAQ,EAAE,kFAAkF,EAAE,QAAQ,EAAE,0EAA0E,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE;IACzS,MAAM,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE,QAAQ,EAAE,8EAA8E,EAAE,QAAQ,EAAE,sFAAsF,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE;IAC5U,OAAO,EAAE,EAAE,OAAO,EAAE,iEAAiE,EAAE,QAAQ,EAAE,wFAAwF,EAAE,QAAQ,EAAE,sEAAsE,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE;IAC5U,MAAM,EAAE,EAAE,OAAO,EAAE,2DAA2D,EAAE,QAAQ,EAAE,iFAAiF,EAAE,QAAQ,EAAE,iFAAiF,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE;IAC/S,QAAQ,EAAE,EAAE,OAAO,EAAE,sEAAsE,EAAE,QAAQ,EAAE,sGAAsG,EAAE,QAAQ,EAAE,2FAA2F,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE;CACzX,CAAC,CAAA;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;0ZAMmX,CAAA;AAE1Z,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAc,EAAE,MAAmB;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAA;IACzD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAA;IACzG,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,OAAO,KAAK,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,CAAA;IAChG,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,QAAQ,eAAe,UAAU,CAAC,QAAQ,cAAc,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AAC9I,CAAC"}

package/lib/dsh/preset-declaration.d.ts

@@ -0,0 +1,75 @@
+import yaml from 'js-yaml';
+import { type DisplayBaseline } from './preset-metadata.js';
+import type { DeclaredPresetRegistry, PresetInstallationResult, PresetInstallationStatus } from './preset-installation.js';
+export declare const declarationSchema: yaml.Schema;
+export interface DeclarationConfig {
+    id: string;
+    name?: string;
+    description?: string;
+    order?: number;
+    plugins: Array<{
+        name?: string;
+        config?: Record<string, unknown>;
+        [key: string]: unknown;
+    }>;
+}
+export interface DeclarationEntry {
+    id: string;
+    disabled?: boolean;
+    options: {
+        name: string;
+        config?: DeclarationConfig;
+    };
+}
+export interface DeclarationHost {
+    patchPath: string;
+    entries(): readonly DeclarationEntry[];
+    reload(): Promise<void>;
+    exclusive<T>(run: () => Promise<T>): Promise<T>;
+}
+export interface DeclarationSettings {
+    declaration?: {
+        entryId: string;
+        id: string;
+        token: string;
+    };
+    declarationDisplay?: DisplayBaseline;
+}
+export interface DeclarationState {
+    get(): DeclarationSettings;
+    update(patch: Partial<DeclarationSettings>): Promise<void>;
+}
+/** Newer settings providers edit Loader forms; installation records stay local. */
+export declare class DeclarationStateFile implements DeclarationState {
+    private readonly path;
+    private value;
+    private constructor();
+    static open(path: string): Promise<DeclarationStateFile>;
+    get(): DeclarationSettings;
+    update(patch: Partial<DeclarationSettings>): Promise<void>;
+}
+/** Only marked bundle rows or UUID-matched manual installations may be replaced. */
+export declare class DeclaredPresetInstaller {
+    private readonly registry;
+    private readonly settings;
+    private readonly host;
+    private readonly bundlePath;
+    private tail;
+    constructor(registry: DeclaredPresetRegistry, settings: DeclarationState, host: DeclarationHost, bundlePath: string);
+    private entry;
+    private document;
+    status(): Promise<PresetInstallationStatus>;
+    install(id: unknown, name?: string): Promise<PresetInstallationResult>;
+    reinstall(previousId: string, id: unknown, name?: string): Promise<PresetInstallationResult>;
+    private reject;
+    private replace;
+    synchronize(language: string): Promise<{
+        changed: boolean;
+    }>;
+    /** Back up first, refuse a stale file, and restore only our own failed write. */
+    private save;
+    private readPatch;
+    private atomicWrite;
+    private enqueue;
+}
+//# sourceMappingURL=preset-declaration.d.ts.map

package/lib/dsh/preset-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-declaration.d.ts","sourceRoot":"","sources":["../../src/dsh/preset-declaration.ts"],"names":[],"mappings":"AAIA,OAAO,IAAI,MAAM,SAAS,CAAA;AAC1B,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAExE,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAO1H,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,MAKlC,CAAA;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAA;CAC5F;AACD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAA;CACtD;AACD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACtC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAChD;AACD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5D,kBAAkB,CAAC,EAAE,eAAe,CAAA;CACrC;AACD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,IAAI,mBAAmB,CAAA;IAC1B,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAED,mFAAmF;AACnF,qBAAa,oBAAqB,YAAW,gBAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAU,OAAO,CAAC,KAAK;IAAhE,OAAO;WACM,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkB9D,GAAG,IAAI,mBAAmB;IACpB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAcjE;AAUD,oFAAoF;AACpF,qBAAa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,IAAI,CAAsC;gBAE/B,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM;IAGrC,OAAO,CAAC,KAAK;YAUC,QAAQ;IAoBhB,MAAM,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAa3C,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOtE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;YAOpF,MAAM;YAIN,OAAO;IAgCf,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA0BlE,iFAAiF;YACnE,IAAI;YAuCJ,SAAS;YAKT,WAAW;IASzB,OAAO,CAAC,OAAO;CAKhB"}