@avantf/dsh-plugin-base 0.3.1

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAQA,qDAAqD;AACrD,eAAO,MAAM,WAAW,aAAa,CAAA;AAErC,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AACD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AACD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQzD;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQzD;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAyB,GACvC,MAAM,CAOR"}

package/dist/layout.js

@@ -0,0 +1,84 @@
+/**
+ * Disk layout: control-plane and resource directories under `<home>`.
+ * @module layout
+ */
+import { createHash } from 'node:crypto';
+import { join, relative, sep } from 'node:path';
+import { ProvisionError } from './errors.js';
+/** The control-plane directory name under `home`. */
+export const CONTROL_DIR = '.envinit';
+/** Default path budget before the version segment switches to a short hash. */
+export const DEFAULT_MAX_PATH = 200;
+export function controlRoot(home) {
+    return join(home, CONTROL_DIR);
+}
+export function lockPath(home) {
+    return join(controlRoot(home), '.lock');
+}
+export function statusLockPath(home) {
+    return join(controlRoot(home), '.status.lock');
+}
+export function layoutPath(home) {
+    return join(controlRoot(home), '.layout.json');
+}
+export function statusPath(home) {
+    return join(controlRoot(home), 'status.json');
+}
+export function declaredPath(home) {
+    return join(controlRoot(home), 'declared.json');
+}
+export function tempRoot(home) {
+    return join(controlRoot(home), '.tmp');
+}
+export function quarantineRoot(home) {
+    return join(controlRoot(home), '.quarantine');
+}
+/**
+ * A staging directory for one install attempt under {@link tempRoot}.
+ * `sequence` must be monotonic per process.
+ */
+export function stagingDir(home, itemId, sequence) {
+    const safe = itemId.replaceAll(/[^A-Za-z0-9._-]/g, '-');
+    return join(tempRoot(home), `${safe}-${String(process.pid)}-${String(sequence)}`);
+}
+/** A quarantine directory for one bad version directory. */
+export function quarantineDir(home, sequence) {
+    return join(quarantineRoot(home), `${String(Date.now())}-${String(process.pid)}-${String(sequence)}`);
+}
+/** Is `child` inside `parent` (or equal to it)? Both are absolute and already normalised. */
+export function isInside(parent, child) {
+    const rel = relative(parent, child);
+    return rel === '' || (!rel.startsWith('..') && !rel.startsWith(`..${sep}`));
+}
+/** Reject a `target.root` that is absolute or escapes `home` (`invalid-option`). */
+export function assertSafeRelativeRoot(root) {
+    if (root === '' || root.startsWith('/') || /^[a-zA-Z]:[\\/]/.test(root) || root.includes('\0')) {
+        throw new ProvisionError('invalid-option', `target.root 必须是 home 下的相对路径：${JSON.stringify(root)}`);
+    }
+    const parts = root.replaceAll('\\', '/').split('/');
+    if (parts.some(part => part === '..')) {
+        throw new ProvisionError('invalid-option', `target.root 不得跳出 home：${JSON.stringify(root)}`);
+    }
+}
+/** Reject a provider-supplied relative path that is absolute or escapes its root. */
+export function assertSafeRelativePath(path) {
+    if (path === '' || path.startsWith('/') || /^[a-zA-Z]:[\\/]/.test(path) || path.includes('\0')) {
+        throw new ProvisionError('invalid-option', `provider 给出的相对路径不安全：${JSON.stringify(path)}`);
+    }
+    const parts = path.replaceAll('\\', '/').split('/');
+    if (parts.some(part => part === '..')) {
+        throw new ProvisionError('invalid-option', `provider 给出的相对路径跳出目标根：${JSON.stringify(path)}`);
+    }
+}
+/** The version segment: the version, or a short hash when the path is too long. */
+export function versionSegment(home, targetRoot, name, version, maxPathLength = DEFAULT_MAX_PATH) {
+    const candidate = join(home, targetRoot, ...name.split('/'), version);
+    if (candidate.length <= maxPathLength)
+        return version;
+    const digest = createHash('sha256').update(`${name}@${version}`).digest('hex');
+    const short8 = digest.slice(0, 8);
+    if (join(home, targetRoot, ...name.split('/'), short8).length <= maxPathLength)
+        return short8;
+    return digest.slice(0, 12);
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAA;AAErC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAEnC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;AAChC,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;AACzC,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAA;AAChD,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAA;AAChD,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAA;AAC/C,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,CAAA;AACjD,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;AACxC,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAA;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc,EAAE,QAAgB;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAA;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AACnF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB;IAC1D,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AACvG,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAa;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACnC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnG,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC7F,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC7F,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,UAAkB,EAClB,IAAY,EACZ,OAAe,EACf,gBAAwB,gBAAgB;IAExC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;IACrE,IAAI,SAAS,CAAC,MAAM,IAAI,aAAa;QAAE,OAAO,OAAO,CAAA;IACrD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACjC,IAAI,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,IAAI,aAAa;QAAE,OAAO,MAAM,CAAA;IAC7F,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC5B,CAAC"}

package/dist/lint.d.ts

@@ -0,0 +1,33 @@
+/** The built-in kinds whose names are reserved. */
+export declare const BUILTIN_KINDS: readonly string[];
+/** Item policy keys the core reads. */
+export declare const IMPLEMENTED_POLICY_KEYS: readonly string[];
+/** Item policy keys the surface declares but this build does not read. */
+export declare const UNIMPLEMENTED_POLICY_KEYS: readonly string[];
+/** Provision-policy keys the surface declares but this build does not read. */
+export declare const UNIMPLEMENTED_PROVISION_POLICY_KEYS: readonly string[];
+/** The fields a manifest may carry; anything else is `ignored-field` at runtime. */
+export declare const MANIFEST_FIELDS: readonly string[];
+/** The fields an item may carry. */
+export declare const ITEM_FIELDS: readonly string[];
+/** The manifest keys this build does not know; empty when the surface matches exactly. */
+export declare function unknownFields(value: unknown, known: readonly string[]): readonly string[];
+export interface LintFinding {
+    /** A rule id, stable enough to assert on (`lint/id-prefix`, …). */
+    readonly rule: string;
+    readonly itemId?: string;
+    readonly message: string;
+}
+export interface LintResult {
+    readonly ok: boolean;
+    readonly findings: readonly LintFinding[];
+}
+/** Does any `||` branch contain a bare `*` token (or consist only of `*`)? */
+export declare function hasStarBranch(range: string): boolean;
+/** A third-party kind must be namespaced (`@scope/…` or `plugin:…`). */
+export declare function isNamespacedKind(kind: string): boolean;
+/** Lint a manifest value (already parsed JSON, or a typed object). */
+export declare function lintManifest(manifest: unknown): LintResult;
+/** Lint a manifest file's text; a JSON parse failure is itself a finding. */
+export declare function lintManifestText(text: string): LintResult;
+//# sourceMappingURL=lint.d.ts.map

package/dist/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"AASA,mDAAmD;AACnD,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAsF,CAAA;AAEjI,uCAAuC;AACvC,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAgB,CAAA;AAErE,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAA8C,CAAA;AAErG,+EAA+E;AAC/E,eAAO,MAAM,mCAAmC,EAAE,SAAS,MAAM,EAMhE,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAoC,CAAA;AAEjF,oCAAoC;AACpC,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAUxC,CAAA;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAGzF;AAED,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CAC1C;AAUD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIpD;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAqDD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAgJ1D;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CASzD"}

package/dist/lint.js

@@ -0,0 +1,271 @@
+/**
+ * `provision lint` — the offline, purely static manifest check.
+ * @module lint
+ */
+import { ProvisionError } from './errors.js';
+import { assertPackageName } from './package-name.js';
+import { assertRange } from './semver.js';
+/** The built-in kinds whose names are reserved. */
+export const BUILTIN_KINDS = ['npm-package', 'binary-archive', 'model-cache'];
+/** Item policy keys the core reads. */
+export const IMPLEMENTED_POLICY_KEYS = ['mirrors'];
+/** Item policy keys the surface declares but this build does not read. */
+export const UNIMPLEMENTED_POLICY_KEYS = ['concurrency', 'timeoutMs', 'platforms'];
+/** Provision-policy keys the surface declares but this build does not read. */
+export const UNIMPLEMENTED_PROVISION_POLICY_KEYS = [
+    'packumentMirrors',
+    'quotaBytes',
+    'trashGraceMs',
+    'gc',
+    'preloaded',
+];
+/** The fields a manifest may carry; anything else is `ignored-field` at runtime. */
+export const MANIFEST_FIELDS = ['plugin', 'items', 'requires'];
+/** The fields an item may carry. */
+export const ITEM_FIELDS = [
+    'id',
+    'kind',
+    'spec',
+    'target',
+    'onMissing',
+    'startup',
+    'needs',
+    'policy',
+    'schemaVersion',
+];
+/** The manifest keys this build does not know; empty when the surface matches exactly. */
+export function unknownFields(value, known) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return [];
+    return Object.keys(value).filter(key => !known.includes(key));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+/** Does any `||` branch contain a bare `*` token (or consist only of `*`)? */
+export function hasStarBranch(range) {
+    return range
+        .split('||')
+        .some(branch => branch.split(/[\s,]+/).filter(token => token !== '').includes('*') || branch.trim() === '*');
+}
+/** A third-party kind must be namespaced (`@scope/…` or `plugin:…`). */
+export function isNamespacedKind(kind) {
+    return /^@[^/]+\/.+/.test(kind) || /^plugin:.+/.test(kind);
+}
+function checkSpec(kind, spec, itemId, findings) {
+    if (kind === 'npm-package') {
+        if (!isRecord(spec)) {
+            findings.push({ rule: 'lint/spec-shape', itemId, message: 'npm-package 的 spec 必须是 {name, range}' });
+            return;
+        }
+        const name = str(spec['name']);
+        if (name === undefined) {
+            findings.push({ rule: 'lint/spec-shape', itemId, message: 'npm-package 缺少 spec.name' });
+        }
+        else {
+            try {
+                assertPackageName(name);
+            }
+            catch (error) {
+                findings.push({ rule: 'lint/spec-shape', itemId, message: error instanceof ProvisionError ? error.message : `非法的包名：${name}` });
+            }
+        }
+        const range = str(spec['range']);
+        if (range === undefined) {
+            findings.push({ rule: 'lint/spec-shape', itemId, message: 'npm-package 缺少 spec.range' });
+        }
+        else if (hasStarBranch(range)) {
+            findings.push({
+                rule: 'lint/range-star',
+                itemId,
+                message: '清单区间不得含 `*`（会匹配一切：既可能跨大版本，也会让"未知版本"通过校验）',
+            });
+        }
+        else {
+            try {
+                assertRange(range);
+            }
+            catch (error) {
+                findings.push({
+                    rule: 'lint/range-subset',
+                    itemId,
+                    message: error instanceof ProvisionError ? error.message : `无法解析区间 ${range}`,
+                });
+            }
+        }
+        return;
+    }
+    if (kind === 'binary-archive') {
+        if (!isRecord(spec) || str(spec['id']) === undefined || str(spec['version']) === undefined || !isRecord(spec['packs'])) {
+            findings.push({ rule: 'lint/spec-shape', itemId, message: 'binary-archive 的 spec 必须是 {id, version, packs}' });
+        }
+        return;
+    }
+    if (kind === 'model-cache') {
+        if (!isRecord(spec) || str(spec['repo']) === undefined) {
+            findings.push({ rule: 'lint/spec-shape', itemId, message: 'model-cache 的 spec 必须是 {repo, revision?}' });
+        }
+    }
+}
+/** Lint a manifest value (already parsed JSON, or a typed object). */
+export function lintManifest(manifest) {
+    const findings = [];
+    if (!isRecord(manifest)) {
+        return { ok: false, findings: [{ rule: 'lint/manifest-shape', message: 'manifest 必须是对象' }] };
+    }
+    for (const key of unknownFields(manifest, MANIFEST_FIELDS)) {
+        findings.push({ rule: 'lint/unknown-field', message: `manifest 携带框架不认识的字段：${key}` });
+    }
+    const plugin = str(manifest['plugin']);
+    if (plugin === undefined)
+        findings.push({ rule: 'lint/plugin-missing', message: 'Manifest.plugin 缺失' });
+    const items = manifest['items'];
+    if (!Array.isArray(items)) {
+        findings.push({ rule: 'lint/manifest-shape', message: 'Manifest.items 必须是数组' });
+        return { ok: findings.length === 0, findings };
+    }
+    const ids = new Set();
+    const needsOf = new Map();
+    for (const raw of items) {
+        if (!isRecord(raw)) {
+            findings.push({ rule: 'lint/item-shape', message: 'item 必须是对象' });
+            continue;
+        }
+        const id = str(raw['id']);
+        if (id === undefined) {
+            findings.push({ rule: 'lint/item-shape', message: 'item.id 缺失' });
+            continue;
+        }
+        for (const key of unknownFields(raw, ITEM_FIELDS)) {
+            findings.push({ rule: 'lint/unknown-field', itemId: id, message: `item 携带框架不认识的字段：${key}` });
+        }
+        if (ids.has(id))
+            findings.push({ rule: 'lint/id-duplicate', itemId: id, message: `item id 重复：${id}` });
+        ids.add(id);
+        if (plugin !== undefined && !id.startsWith(`${plugin}:`)) {
+            findings.push({ rule: 'lint/id-prefix', itemId: id, message: `item id 必须以 "${plugin}:" 前缀化` });
+        }
+        const kind = str(raw['kind']);
+        if (kind === undefined) {
+            findings.push({ rule: 'lint/item-shape', itemId: id, message: 'item.kind 缺失' });
+        }
+        else {
+            if (!BUILTIN_KINDS.includes(kind) && !isNamespacedKind(kind)) {
+                findings.push({ rule: 'lint/kind-namespace', itemId: id, message: `自定义 kind "${kind}" 必须带 @scope/ 或 plugin: 前缀` });
+            }
+            checkSpec(kind, raw['spec'], id, findings);
+        }
+        if (typeof raw['schemaVersion'] !== 'number') {
+            findings.push({ rule: 'lint/item-shape', itemId: id, message: 'item.schemaVersion 必须是数字' });
+        }
+        const target = raw['target'];
+        if (!isRecord(target)) {
+            findings.push({ rule: 'lint/target-root', itemId: id, message: 'item.target 必须是 {root}' });
+        }
+        else {
+            const root = target['root'];
+            if (typeof root !== 'string' || root === '') {
+                findings.push({ rule: 'lint/target-root', itemId: id, message: 'item.target.root 缺失' });
+            }
+            else if (root.startsWith('/') || /^[a-zA-Z]:[\\/]/.test(root) || root.replaceAll('\\', '/').split('/').includes('..')) {
+                findings.push({ rule: 'lint/target-root', itemId: id, message: `target.root 必须是 home 下的相对路径：${root}` });
+            }
+            for (const forbidden of ['version', 'layout']) {
+                if (forbidden in target) {
+                    findings.push({ rule: 'lint/target-forbidden', itemId: id, message: `target 不得携带 ${forbidden}` });
+                }
+            }
+        }
+        const onMissing = raw['onMissing'];
+        if (onMissing !== undefined) {
+            if (!isRecord(onMissing)) {
+                findings.push({ rule: 'lint/on-missing', itemId: id, message: 'onMissing 必须是对象' });
+            }
+            else {
+                const atStartup = onMissing['atStartup'];
+                if (atStartup !== undefined && atStartup !== 'degrade' && atStartup !== 'refuse') {
+                    findings.push({ rule: 'lint/on-missing', itemId: id, message: `onMissing.atStartup 非法：${String(atStartup)}` });
+                }
+                const atUse = onMissing['atUse'];
+                if (atUse !== undefined && atUse !== 'degrade' && atUse !== 'error') {
+                    findings.push({ rule: 'lint/on-missing', itemId: id, message: `onMissing.atUse 非法：${String(atUse)}` });
+                }
+            }
+        }
+        const startup = raw['startup'];
+        if (startup !== undefined && startup !== 'blocking' && startup !== 'background') {
+            findings.push({ rule: 'lint/startup', itemId: id, message: `item.startup 非法：${String(startup)}（只能是 blocking / background）` });
+        }
+        const policy = raw['policy'];
+        if (policy !== undefined && isRecord(policy)) {
+            for (const key of Object.keys(policy)) {
+                if (IMPLEMENTED_POLICY_KEYS.includes(key))
+                    continue;
+                if (UNIMPLEMENTED_POLICY_KEYS.includes(key)) {
+                    findings.push({ rule: 'lint/policy-unimplemented', itemId: id, message: `policy.${key} 本实现不读取，设置它不会生效` });
+                    continue;
+                }
+                if (!isNamespacedKind(key)) {
+                    findings.push({ rule: 'lint/policy-key', itemId: id, message: `policy 的 provider 私有键必须带前缀：${key}` });
+                }
+            }
+        }
+        const needs = raw['needs'];
+        if (needs !== undefined) {
+            if (!Array.isArray(needs) || needs.some(need => typeof need !== 'string')) {
+                findings.push({ rule: 'lint/needs-shape', itemId: id, message: 'needs 必须是字符串数组' });
+            }
+            else {
+                needsOf.set(id, needs);
+            }
+        }
+    }
+    // Check needs for existence, cross-plugin references and cycles.
+    for (const [id, needs] of needsOf) {
+        for (const need of needs) {
+            if (!ids.has(need)) {
+                if (plugin !== undefined && need.includes(':') && !need.startsWith(`${plugin}:`)) {
+                    findings.push({ rule: 'lint/needs-cross-plugin', itemId: id, message: `needs 不得跨插件引用：${need}` });
+                }
+                else {
+                    findings.push({ rule: 'lint/needs-missing', itemId: id, message: `needs 引用了不存在的 id：${need}` });
+                }
+            }
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (id, path) => {
+        if (visited.has(id))
+            return;
+        if (visiting.has(id)) {
+            findings.push({ rule: 'lint/needs-cycle', itemId: id, message: `needs 成环：${[...path, id].join(' → ')}` });
+            return;
+        }
+        visiting.add(id);
+        for (const need of needsOf.get(id) ?? [])
+            if (ids.has(need))
+                visit(need, [...path, id]);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const id of needsOf.keys())
+        visit(id, []);
+    return { ok: findings.length === 0, findings };
+}
+/** Lint a manifest file's text; a JSON parse failure is itself a finding. */
+export function lintManifestText(text) {
+    try {
+        return lintManifest(JSON.parse(text));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            findings: [{ rule: 'lint/json', message: `manifest 不是合法 JSON：${error instanceof Error ? error.message : String(error)}` }],
+        };
+    }
+}
+//# sourceMappingURL=lint.js.map

package/dist/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"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"}

package/dist/lock.d.ts

@@ -0,0 +1,12 @@
+import type { ProvisionLock } from './types.js';
+/** `true` when the pid exists; `EPERM` counts as alive. */
+export declare function pidIsAlive(pid: number): boolean;
+export interface DefaultLockOptions {
+    /** Clock source; defaults to `Date.now`. */
+    readonly clock?: () => number;
+    /** Poll interval while waiting; defaults to 25 ms. */
+    readonly pollMs?: number;
+}
+/** The default {@link ProvisionLock}. */
+export declare function defaultLock(options?: DefaultLockOptions): ProvisionLock;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,YAAY,CAAA;AAO3D,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAoBD,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CA2D3E"}

package/dist/lock.js

@@ -0,0 +1,93 @@
+/**
+ * The default control-plane lock at `<home>/.envinit/.lock`.
+ * @module lock
+ */
+import { mkdir, open, readFile, stat, unlink } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { ProvisionError } from './errors.js';
+/** `true` when the pid exists; `EPERM` counts as alive. */
+export function pidIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+async function readHolder(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return undefined;
+        const record = parsed;
+        const pid = record['pid'];
+        const startedAt = record['startedAt'];
+        if (typeof pid !== 'number' || typeof startedAt !== 'number')
+            return undefined;
+        return { pid, startedAt };
+    }
+    catch {
+        return undefined;
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/** The default {@link ProvisionLock}. */
+export function defaultLock(options = {}) {
+    const clock = options.clock ?? Date.now;
+    const pollMs = options.pollMs ?? 25;
+    return {
+        async acquire(path, { timeoutMs, staleMs }) {
+            // Ensure the control-plane directory exists.
+            await mkdir(dirname(path), { recursive: true });
+            const deadline = clock() + timeoutMs;
+            for (;;) {
+                const mine = { pid: process.pid, startedAt: clock() };
+                try {
+                    const handle = await open(path, 'wx');
+                    await handle.writeFile(JSON.stringify(mine), 'utf8');
+                    await handle.close();
+                    return {
+                        dispose: () => {
+                            // Remove the lock only while it is still ours.
+                            void (async () => {
+                                const holder = await readHolder(path);
+                                if (holder?.pid === mine.pid && holder.startedAt === mine.startedAt) {
+                                    await unlink(path).catch(() => undefined);
+                                }
+                            })();
+                        },
+                    };
+                }
+                catch (error) {
+                    // Only EEXIST is contention; any other error is rethrown.
+                    if (error.code !== 'EEXIST') {
+                        throw new ProvisionError('unknown-error', `无法创建锁 ${path}：${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+                const holder = await readHolder(path);
+                if (holder === undefined) {
+                    // A missing or unreadable holder still honours the timeout budget.
+                    if (clock() >= deadline) {
+                        throw new ProvisionError('lock/timeout', `等待发布锁超时（${String(timeoutMs)} ms）：${path} 存在但不是可读的锁文件`);
+                    }
+                    const stillThere = await stat(path).then(() => true, () => false);
+                    if (stillThere)
+                        await sleep(pollMs);
+                    continue;
+                }
+                if (!pidIsAlive(holder.pid) && clock() - holder.startedAt > staleMs) {
+                    await unlink(path).catch(() => undefined);
+                    continue;
+                }
+                if (clock() >= deadline) {
+                    throw new ProvisionError('lock/timeout', `等待发布锁超时（${String(timeoutMs)} ms）：${path} 由 pid ${String(holder.pid)} 持有`);
+                }
+                await sleep(pollMs);
+            }
+        },
+    };
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,12 @@
+import type { InstallManifest } from './types.js';
+export declare const INSTALL_MANIFEST_FILE = "install.json";
+export declare const MANIFEST_SCHEMA_VERSION = 1;
+/** Map a legacy manifest onto today's field names. */
+export declare function aliasLegacyManifest(raw: Record<string, unknown>, kind?: string): Record<string, unknown>;
+/** Parse a manifest, applying the alias table; `undefined` when it is not a usable manifest. */
+export declare function readInstallManifest(raw: unknown, kind?: string): InstallManifest | undefined;
+/** Serialise a manifest to JSON bytes. */
+export declare function encodeInstallManifest(manifest: InstallManifest): Uint8Array;
+/** Decode bytes that are expected to be JSON; `undefined` when they are not. */
+export declare function decodeJson(bytes: Uint8Array): unknown;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAA;AAEjE,eAAO,MAAM,qBAAqB,iBAAiB,CAAA;AACnD,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAYxC,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAaxG;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAyB5F;AAED,0CAA0C;AAC1C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAE3E;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMrD"}

package/dist/manifest.js

@@ -0,0 +1,75 @@
+/**
+ * `install.json` — the per-version-directory manifest.
+ * @module manifest
+ */
+import { sriOfSha256 } from './integrity.js';
+export const INSTALL_MANIFEST_FILE = 'install.json';
+export const MANIFEST_SCHEMA_VERSION = 1;
+const SOURCES = ['resolved', 'managed', 'installed', 'system', 'explicit'];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+/** Map a legacy manifest onto today's field names. */
+export function aliasLegacyManifest(raw, kind) {
+    const aliased = { ...raw };
+    if (aliased['name'] === undefined && raw['id'] !== undefined)
+        aliased['name'] = raw['id'];
+    if (aliased['integrity'] === undefined && raw['sha256'] !== undefined) {
+        // Hex digests are stored as SRI base64.
+        aliased['integrity'] = sriOfSha256(String(raw['sha256']));
+    }
+    if (aliased['tarball'] === undefined && raw['url'] !== undefined)
+        aliased['tarball'] = raw['url'];
+    if (aliased['entry'] === undefined && raw['binary'] !== undefined && kind === 'binary-archive') {
+        aliased['entry'] = `bin/${String(raw['binary'])}`;
+    }
+    if (aliased['schemaVersion'] === undefined)
+        aliased['schemaVersion'] = 0;
+    return aliased;
+}
+/** Parse a manifest, applying the alias table; `undefined` when it is not a usable manifest. */
+export function readInstallManifest(raw, kind) {
+    if (!isRecord(raw))
+        return undefined;
+    const aliased = aliasLegacyManifest(raw, kind);
+    const name = str(aliased['name']);
+    const version = str(aliased['version']);
+    const dir = str(aliased['dir']) ?? version;
+    if (name === undefined || version === undefined || dir === undefined)
+        return undefined;
+    const source = str(aliased['source']);
+    const integrity = str(aliased['integrity']);
+    const tarball = str(aliased['tarball']);
+    const entry = str(aliased['entry']);
+    const entryDir = str(aliased['entryDir']);
+    return {
+        schemaVersion: typeof aliased['schemaVersion'] === 'number' ? aliased['schemaVersion'] : 0,
+        name,
+        version,
+        dir,
+        ...(integrity === undefined ? {} : { integrity }),
+        ...(tarball === undefined ? {} : { tarball }),
+        ...(entry === undefined ? {} : { entry }),
+        ...(entryDir === undefined ? {} : { entryDir }),
+        installed_at: str(aliased['installed_at']) ?? '',
+        source: source !== undefined && SOURCES.includes(source) ? source : 'managed',
+        layout: str(aliased['layout']) ?? '',
+    };
+}
+/** Serialise a manifest to JSON bytes. */
+export function encodeInstallManifest(manifest) {
+    return new TextEncoder().encode(`${JSON.stringify(manifest, null, 2)}\n`);
+}
+/** Decode bytes that are expected to be JSON; `undefined` when they are not. */
+export function decodeJson(bytes) {
+    try {
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=manifest.js.map