@xdxer/dingtalk-agent 0.1.4-beta.18 → 0.1.4-beta.19

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to `@xdxer/dingtalk-agent` are documented here. The project follows semantic versioning; prerelease entries describe release candidates and do not imply that Live canaries or registry publication have completed.
 
+## 0.1.4-beta.19 - 2026-07-20
+
+### Added
+
+- `references/host-loading-contract.md`: the loading contract stated as four host-agnostic invariants — the Definition is loaded by the host's native project rule and must not also enter custom instructions; the Basic Skill's body is the single resolved forced instruction of every session, not merely "discoverable"; the Basic exposure must be materialized as a whole tree matching the canonical hash; Role Skills stay discoverable-and-authorized without joining the forced set. The three evidence classes are described in general form, with the binding fields (host name, host version, model, raw trace) supplied by each host adapter.
+- `references/hosts/claude-code.md`: Claude Code's mechanism differences, most importantly that it does **not** natively read `AGENTS.md` (the body must be referenced via `@AGENTS.md` in `CLAUDE.md` or a symlink) and that its skill exposure root `.claude/skills` is not shared with `.agents/skills`. The file states plainly that the adapter is unimplemented and that choosing Claude Code therefore caps the verdict at `partial`.
+- `src/host-detect.ts` and a `hosts` section in `doctor`: which coding agent CLIs are installed locally, with binary path, version, config roots (honoring `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `XDG_CONFIG_HOME`) and skill exposure root reported separately.
+
+### Changed
+
+- The minimal Agent directory is now harness-agnostic: `opencode.json` and `.agents/skills/` are no longer part of the core, matching what `examples/agents/*` have always contained. Host config and exposure directories are listed as "appended per chosen host, not part of the body". Compose gains a step for letting the user choose the Agent Host instead of defaulting silently.
+- OpenCode-specific material moved to `references/hosts/opencode.md` and `assets/hosts/opencode/`. OpenCode remains the only host with a complete adapter, and the documentation says so rather than implying broader support.
+- Not selecting a host is not an exemption: an unselected host, or one without an adapter, yields `partial` and never `ready`.
+- `doctor` no longer derives Codex and OpenCode status from one shared boolean. `cli.found` (binary on PATH) and skill visibility are separate fields, so a machine with neither client installed no longer reports both as `ok`. The `hosts` array is additive and does not participate in `ready`; the three existing client checks keep their level semantics.
+- `scripts/check-skill-versions.mjs` compares the baseline tree against the working tree instead of `base...HEAD`, which only saw committed changes and passed vacuously before a commit.
+- Host lists, per-host directory conventions and multi-host installation continue to be delegated to the upstream `skills` CLI rather than reimplemented; this repository only owns the loading contract and the loading evidence, which upstream does not provide.
+
+### Release boundary
+
+- Distribution is limited to the public npm `beta` dist-tag and a Git tag. No DingTalk write, robot binding, or Live canary was executed. The Claude Code adapter is documented but not implemented, and no evidence class is claimed for it. Verification used targeted contract scenarios (24/27/28/30/34/50/56/60/62).
+
 ## 0.1.4-beta.18 - 2026-07-20
 
 ### Added

package/dist/bin/dingtalk-agent.js

@@ -1562,12 +1562,32 @@ function printDoctor(out) {
         if (check.fix)
             console.log(`   修复: ${check.fix}`);
     }
+    if (out.hosts.length) {
+        // Host 面回答"本地能在哪跑"，不改变上面的 ready 结论。
+        console.log('\n本机 Coding Agent:');
+        const width = Math.max(...out.hosts.map((host) => displayWidth(host.label)));
+        for (const host of out.hosts) {
+            const label = host.label + ' '.repeat(width - displayWidth(host.label));
+            const where = host.cli.found
+                ? [host.cli.path, host.cli.version].filter(Boolean).join('  ')
+                : `未找到 ${host.cli.command}`;
+            console.log(`  ${host.cli.found ? '✅' : '❌'} ${label}  ${where}`);
+            console.log(`     Skill 可见性: ${host.skillExposure.exists ? '已暴露' : '未暴露'} · ${host.skillExposureRoot}`);
+        }
+    }
     if (out.nextSteps.length) {
         console.log('\n下一步:');
         for (const step of out.nextSteps)
             console.log(`  ${step}`);
     }
 }
+/** 全角字符按两列计宽，避免中英混排的 Host 列表错位。 */
+function displayWidth(text) {
+    let width = 0;
+    for (const char of text)
+        width += /[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹯＀-｠￠-￦]/.test(char) ? 2 : 1;
+    return width;
+}
 function printProjectInfo(out) {
     console.log(`dingtalk-agent Project · ${out.project.name}`);
     console.log(`   root=${out.root}`);