@avantf/dsh-plugin-base 0.4.1 → 0.5.1

package/dist/internal.js

@@ -7,8 +7,8 @@
  *  - the framework's own seams (fs, locks, archives, layout, lint, semver …), and
  *  - the **composition pieces** of the pieces `.` does export: the individual probes and evidence
  *    helpers `compat.gatherEvidence` is built from, the provisioner's policy helpers and constants,
- *    the npm-package provider, and the Typert symbol kit whose symbols/wire helpers the two plugins
- *    keep as LOCAL mirrors by design (they are assembled at module load, before any base can be
+ *    the npm-package provider, and the Typert symbol kit whose symbols/wire helpers every plugin
+ *    keeps as a LOCAL mirror by design (they are assembled at module load, before any base can be
  *    imported).
  *
  * Generation v3 moved exactly those zero-consumer names here (INTERFACE.md §9). `./internal` is NOT
@@ -32,7 +32,7 @@ export { candidateUrls, downloadBytes, fetchImplOf, platformKey, readCapped, rea
 export { CONTROL_DIR, assertSafeRelativePath, assertSafeRelativeRoot, controlRoot, declaredPath, layoutPath, lockPath, quarantineRoot, stagingDir, statusLockPath, statusPath, tempRoot, versionSegment, } from './layout.js';
 export { BOOTSTRAP_SUBPATH, FRAMEWORK_INLINING_BEACONS, FRAMEWORK_PACKAGE, MIN_INLINING_BEACONS, findFrameworkImports, findInliningBeacons, isBootstrapSpecifier, } from './artifact.js';
 // ── generation v3: the names `.` shed ────────────────────────────────────────────────────────────
-// Each of these has zero consumers across the two plugin trees' non-test source and scripts
+// Each of these has zero consumers across every discovered plugin tree's non-test source and scripts
 // (`test/public-surface.spec.ts` re-proves that mechanically). They are composition pieces of the
 // members `.` still exports, or kit mirrors the plugins keep locally on purpose — never a plugin's
 // entry point. Their canonical home is here; INTERFACE.md §9 records why each one moved.

package/dist/kit/typert.d.ts

@@ -9,7 +9,7 @@
  * of switches would be worse than the duplication it removes.
  *
  * The type-symbol convention is `<package>#<namespace>/<method>:<field>`; the probe, the runtime
- * registry and the report all key off it, so it must not drift between the two plugins.
+ * registry and the report all key off it, so it must not drift between plugin trees.
  *
  * @module @avantf/dsh-plugin-base/kit/typert
  */

package/dist/preset.d.ts

@@ -10,7 +10,7 @@ export interface EnvinitPresetOptions {
     readonly cwd?: string;
     /** Extra module names that must stay external (the plugin's own whitelist). */
     readonly external?: readonly string[];
-    /** The declared framework range; when given it must equal `peerDependencies`. */
+    /** The declared framework range; when given it must equal `dependencies`. */
     readonly range?: string;
     /** Assert against this framework copy instead of resolving one from `cwd`. */
     readonly frameworkDir?: string;
@@ -20,7 +20,7 @@ export interface EnvinitPreset {
     readonly frameworkDir: string;
     /** The framework package version found there. */
     readonly frameworkVersion: string;
-    /** The plugin's declared range (`peerDependencies`). */
+    /** The plugin's declared range (`dependencies`). */
     readonly declaredRange: string;
     /** Names the bundler must keep external. */
     readonly external: readonly string[];

package/dist/preset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAExD,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;CACrB;AAqED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAoH/E;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7C;AAED,gHAAgH;AAChH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,WAAW,EAAE,CAqD7F;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAI9E"}
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAExD,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;CACrB;AAqED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA0H/E;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7C;AAED,gHAAgH;AAChH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,WAAW,EAAE,CAqD7F;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAI9E"}

package/dist/preset.js

@@ -116,34 +116,40 @@ export function envinitPreset(options = {}) {
         out.fail('preset/framework-self-contained', `框架包必须自包含：dependencies 必须为空（现有 ${String(runtimeDeps)} 条）；peerDependencies 只允许 zod（现有多余 ${unexpectedPeers.join(', ') || '(无)'}）`);
     }
     // ── declared range ─────────────────────────────────────────────────────────
+    // The base is an ORDINARY dependency of a plugin, not a peer: the host provides only the DSH
+    // packages, and a dsh profile is written with `autoInstallPeers: false`, so a peer would simply
+    // never be installed. Installing the plugin must therefore bring the base along — the install-time
+    // range lives in `dependencies` (root `AGENTS.md` 「发布面」, `scripts/release-check.mjs`). The
+    // `devDependencies` entry carries the SAME range so the repo's own `pnpm install` links the
+    // workspace `base/`; the two must stay literally identical or pnpm can resolve a second copy.
     const pluginPkg = readJson(join(cwd, 'package.json'));
     if (pluginPkg === undefined) {
-        out.fail('preset/peer-range-declared', `${join(cwd, 'package.json')} 不可读`);
+        out.fail('preset/dependency-range-declared', `${join(cwd, 'package.json')} 不可读`);
         return { frameworkDir, frameworkVersion, declaredRange: '', external, noExternal, checks: out.checks, ok: false };
     }
-    const peer = pluginPkg['peerDependencies'];
-    const declaredRange = typeof peer === 'object' && peer !== null ? str(peer[FRAMEWORK_PACKAGE]) : undefined;
+    const deps = pluginPkg['dependencies'];
+    const declaredRange = typeof deps === 'object' && deps !== null ? str(deps[FRAMEWORK_PACKAGE]) : undefined;
     if (declaredRange === undefined) {
-        out.fail('preset/peer-range-declared', `插件必须在 peerDependencies 声明 ${FRAMEWORK_PACKAGE} 的区间`);
+        out.fail('preset/dependency-range-declared', `插件必须在 dependencies 声明 ${FRAMEWORK_PACKAGE} 的区间`);
         return { frameworkDir, frameworkVersion, declaredRange: '', external, noExternal, checks: out.checks, ok: false };
     }
     try {
         assertRange(declaredRange);
-        out.pass('preset/peer-range-declared', `peerDependencies["${FRAMEWORK_PACKAGE}"] = ${declaredRange}`);
+        out.pass('preset/dependency-range-declared', `dependencies["${FRAMEWORK_PACKAGE}"] = ${declaredRange}`);
     }
     catch (error) {
-        out.fail('preset/peer-range-declared', `区间不在支持的 semver 子集内：${declaredRange}（${error instanceof Error ? error.message : String(error)}）`);
+        out.fail('preset/dependency-range-declared', `区间不在支持的 semver 子集内：${declaredRange}（${error instanceof Error ? error.message : String(error)}）`);
     }
     const dev = pluginPkg['devDependencies'];
     const devRange = typeof dev === 'object' && dev !== null ? str(dev[FRAMEWORK_PACKAGE]) : undefined;
     const rangeProblems = [];
     if (devRange !== declaredRange)
-        rangeProblems.push(`devDependencies 是 ${devRange ?? '(缺失)'}，应与 peerDependencies 同区间`);
+        rangeProblems.push(`devDependencies 是 ${devRange ?? '(缺失)'}，应与 dependencies 同区间`);
     if (options.range !== undefined && options.range !== declaredRange) {
-        rangeProblems.push(`传入的 range 是 ${options.range}，应等于 peerDependencies`);
+        rangeProblems.push(`传入的 range 是 ${options.range}，应等于 dependencies`);
     }
     if (rangeProblems.length === 0) {
-        out.pass('preset/range-single-source', `peerDependencies ≡ devDependencies = ${declaredRange}`);
+        out.pass('preset/range-single-source', `dependencies ≡ devDependencies = ${declaredRange}`);
     }
     else {
         out.fail('preset/range-single-source', rangeProblems.join('；'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avantf/dsh-plugin-base",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "The @avantf family base for DSH plugins: startup environment initialisation (declare → probe → fetch → verify → report) plus the host compatibility gate (provision / verdictOf / probes / report / post-registration verification). One package, loaded by the plugins through the inlined bootstrap.",
   "keywords": [
     "dsh",