@deepseek-ai/dsh-app-boot 0.2.1-rc.5 → 0.2.2-alpha.3

package/lib/types/bundle-platform.d.ts

@@ -0,0 +1,17 @@
+/** Host operating-system admission for optional bundle layers. */
+/** A valid bundle declaration excludes the operating system running DSH. */
+export declare class UnsupportedBundlePlatformError extends Error {
+    /**
+     * @param platforms Node platform names supported by the bundle.
+     * @param platform Operating system of the DSH Host.
+     */
+    constructor(platforms: readonly string[], platform: string);
+}
+/**
+ * Validate package metadata and reject an unsupported Host before selecting or composing a bundle.
+ * @param platforms The optional `dsh.bundle.platforms` field read from package.json.
+ * @param platform Operating system of the DSH Host, from Node's `process.platform`.
+ * @throws When the declaration is malformed or excludes the Host; omission allows every platform.
+ */
+export declare function assertBundlePlatform(platforms: unknown, platform: string): void;
+//# sourceMappingURL=bundle-platform.d.ts.map

package/lib/types/index.d.ts

@@ -5,6 +5,8 @@
  * config expressions, and drive the Cordis Loader against a leaf `cordis.yml` until the tree settles.
  * @module @deepseek-ai/dsh-app-boot
  */
+import { type StartupCompositionDiagnostic } from './startup-diagnostics.ts';
+export type { StartupCompositionDiagnostic, StartupPluginState, StartupServiceState } from './startup-diagnostics.ts';
 import { Context, type FiberState } from '@deepseek-ai/cordis';
 import { type Entry } from '@deepseek-ai/cordis-plugin-loader';
 import { type PatchOptions } from '@deepseek-ai/cordis-plugin-include';
@@ -13,10 +15,9 @@ import { type LaunchEnvironmentSnapshot } from '@deepseek-ai/dsh-launch-environm
 export { readBundlePatches, readProfilePatches, resolveTelemetryPatch, type ProfileContext, type ProfilePnpmInvocation } from './profile-context.ts';
 export { sanitizeProfile } from './profile-sanitize.ts';
 export { getDshRuntimeVersion, evaluatePluginCompatibility, pluginCompatibilityWarning, type PluginCompatibility } from './plugin-compatibility.ts';
-export { PROFILE_COMPATIBILITY_FILENAME, readProfileCompatibility, readProfileVersionExemptions, setProfileVersionExemption, type ProfileCompatibility, } from './profile-compatibility.ts';
+export { PROFILE_COMPATIBILITY_FILENAME, readProfileCompatibility, readProfileVersionExemptions, setProfileVersionExemption, validatePluginVersionExemption, type ProfileCompatibility, } from './profile-compatibility.ts';
 export { prepareProfileEntries, prepareProfilePatches } from './compatibility-preflight.ts';
 export { readPluginMeta, resolvePluginResource } from './package-meta.ts';
-export { ON_DEMAND_BUNDLES, OFFICIAL_ON_DEMAND_CATALOG, type OfficialBundleCatalogEntry } from './official-bundles.ts';
 export { generateConfigSchema, type ConfigSchemaDump, type NativeConfigSchema } from './config-schema/index.ts';
 export { createConfigProjector, LOADER_EXPRESSION_SCHEMA, type ConfigProjection } from './config-schema/projector.ts';
 export { isNativeConfigSchema } from './config-schema/native.ts';
@@ -35,7 +36,8 @@ declare module '@deepseek-ai/cordis' {
         'app-boot/config-reload'(): void;
     }
 }
-export { composeEntries, createRuntimeResolution, ProfileRuntimeResolution, DEFAULT_PROFILE_BUNDLES, OPTIONAL_BUNDLES, bundlePatchFiles, bundlePatchPaths, initProfile, removeLinkProjections, loadProfile, loadProfileDirectory, PROFILE_PATCH_FILENAME, PROFILE_TEMPLATES, PROFILES_DIR, readProfileManifest, reportSkippedBundles, resolveBundleDir, resolveProfileDir, writeProfileManifest, type Profile, type ProfileLayer, type SkippedBundle, type ProfileManifest, type LinkedRoot, type RuntimeResolutionOptions, type RuntimeResolutionEntry, type RuntimeResolution, type ProfileTemplate, } from './profile.ts';
+export { assertBundlePlatform, UnsupportedBundlePlatformError } from './bundle-platform.ts';
+export { composeEntries, createRuntimeResolution, ProfileRuntimeResolution, bundlePatchFiles, bundlePatchPaths, initProfile, removeLinkProjections, loadProfile, loadProfileDirectory, PROFILE_PATCH_FILENAME, PROFILES_DIR, readProfileManifest, reportSkippedBundles, resolveBundleDir, resolveProfileDir, writeProfileManifest, type Profile, type ProfileLayer, type SkippedBundle, type ProfileManifest, type LinkedRoot, type RuntimeResolutionOptions, type RuntimeResolutionEntry, type RuntimeResolution, } from './profile.ts';
 export { PluginPackages, type PluginPackage, type PluginPackagesConfig, } from './profile-resolution/service.ts';
 export { ResolutionRestartRequired } from './profile-resolution/resolver.ts';
 /**
@@ -285,6 +287,8 @@ interface StartupLogRecord {
 /** Startup audit failure with non-enumerable metadata and original failures as its cause. */
 export declare class StartupError extends Error {
     readonly entries: readonly StartupEntryDiagnostic[];
+    /** Plugin states captured before disposal, excluding configuration values. */
+    composition?: StartupCompositionDiagnostic;
     /** Root configuration and startup logs, attached by boot after disposal. */
     startup?: {
         configurationPath: string;

package/lib/types/profile-plugins.d.ts

@@ -52,6 +52,8 @@ export declare function writeProfileBundles(profileDir: string, manifest: Profil
  * template entries retain their order and duplicates. New bundle dependencies activate automatically.
  * @param options - location, inventory captured before pnpm, and whether explicitly disabled bundles remain disabled.
  * @returns updated inventory and newly added ordinary dependencies for caller-owned warnings.
+ * @throws If a new selection has invalid platform metadata or excludes the Host. Installed dependencies
+ * remain; no bundle selection changes are written.
  */
 export declare function reconcileProfilePlugins(options: ProfilePluginLocation & {
     readonly before: ProfilePluginInventory;

package/lib/types/profile.d.ts

@@ -27,11 +27,6 @@ import type { DshBundleManifest, DshPackageManifest } from '@deepseek-ai/dsh-pac
 export declare const PROFILES_DIR = "profiles";
 /** The user patch layer inside a profile directory (hot-reloaded on long-lived surfaces). */
 export declare const PROFILE_PATCH_FILENAME = "cordis.patch.yml";
-/** Installation-owned defaults used when a shipped profile is first opened. */
-export interface ProfileTemplate {
-    /** Ordered bundle layer list. */
-    bundles: readonly string[];
-}
 /** Package metadata accepted by the profile reader; local profiles need no published identity. */
 export type ProfileManifest = Partial<DshPackageManifest>;
 /**
@@ -132,19 +127,6 @@ export interface RuntimeResolution {
  * @returns the absolute profile directory (which may not exist yet).
  */
 export declare function resolveProfileDir(name: string, home?: string): string;
-/** The shipped profile templates auto-initialized on first use, by name. */
-export declare const PROFILE_TEMPLATES: Record<string, ProfileTemplate>;
-/** The bundle list a `dsh plugin` init uses for a name with no shipped template. */
-export declare const DEFAULT_PROFILE_BUNDLES: readonly string[];
-/**
- * The bundles the dsh installation ships for a person to switch on: each a
- * runtime dependency of the installation that declares `dsh.bundle.patch`,
- * an `icon`, and `./locale/*.json` display metadata, selected by no shipped
- * template, and offered switched off by the plugin manager
- * ([rationale](../../../../.agents/notes/implemented/process/2026-09-15-shipped-optional-bundles.md),
- * [admission](../../../../.agents/notes/implemented/architecture/2026-09-21-experimental-capabilities-as-optional-bundles.md)).
- */
-export declare const OPTIONAL_BUNDLES: readonly string[];
 /**
  * Initialize a profile directory: manifest, empty user patch layer, and the
  * pnpm settings out-of-tree plugins need. Existing files are never touched,
@@ -237,7 +219,8 @@ export declare function resolveBundleDir(binName: string, packageName: string, i
  * the shared Harness home. This is used by application-owned profiles whose
  * package project and lifecycle belong to that application.
  * Retired bundles are removed from the stored bundle list first, rewriting the
- * manifest when it listed one. Unreadable bundles, and bundles whose own dsh requirements the profile does not exempt, are skipped
+ * manifest when it listed one. Unreadable bundles, unsupported Host platforms, and bundles whose own dsh requirements
+ * the profile does not exempt are skipped
  * without changing the manifest and listed in `skippedBundles`; nothing is printed.
  * @param binName - the diagnostic prefix on thrown errors.
  * @param dir - absolute profile package directory.
@@ -250,8 +233,8 @@ export declare function loadProfileDirectory(binName: string, dir: string, insta
 }): Profile;
 /**
  * Load a profile: resolve every `dsh.profile.bundles` entry to its patch
- * layer and parse the profile's own patch file. Unreadable or incompatible bundles
- * are skipped and listed in `skippedBundles`; profile manifest and user patch errors still throw.
+ * layer and parse the profile's own patch file. Unreadable bundles, unsupported Host platforms,
+ * and incompatible bundles are skipped and listed in `skippedBundles`; profile manifest and user patch errors still throw.
  * @param binName - the diagnostic prefix on thrown errors.
  * @param name - the profile name.
  * @param installAnchor - absolute path of the dsh app's package.json (first resolution anchor).

package/lib/types/startup-diagnostics.d.ts

@@ -0,0 +1,38 @@
+/** Configuration-free snapshots captured before a failed startup disposes its plugins. */
+import { Context } from '@deepseek-ai/cordis';
+/** One configured entry at the time startup failed. */
+export interface StartupPluginState {
+    readonly id: string;
+    readonly module: string;
+    readonly version: string;
+    readonly state: 'disabled' | 'active' | 'pending' | 'failed' | 'disposed' | 'loading' | 'unloading';
+    /** Loader source URL; individual overlay ownership may be unavailable. */
+    readonly source: string;
+    readonly missing: readonly string[];
+}
+/** Observed registrations for one service missing from a consumer. */
+export interface StartupServiceState {
+    readonly consumer: string;
+    readonly service: string;
+    /** Empty means no registration was observed, not that no configured plugin can provide it. */
+    readonly providers: readonly {
+        readonly entry: string;
+        readonly state: string;
+        readonly visibility: 'same-scope' | 'other-scope';
+    }[];
+}
+/** Bounded startup state without plugin config, service values, or logger arguments. */
+export interface StartupCompositionDiagnostic {
+    readonly plugins: readonly StartupPluginState[];
+    readonly services: readonly StartupServiceState[];
+    readonly omittedPlugins: number;
+    readonly omittedServices: number;
+}
+/**
+ * Capture Loader state and registered service ownership before teardown.
+ * Providers that never registered cannot be inferred from their package names.
+ * @param ctx - Live application context with its Loader still mounted.
+ * @returns At most 256 plugin rows and 256 missing-service observations, with omission counts.
+ */
+export declare function captureStartupComposition(ctx: Context): StartupCompositionDiagnostic;
+//# sourceMappingURL=startup-diagnostics.d.ts.map

package/lib/worker/profile-resolution-bootstrap.js

@@ -569,7 +569,7 @@ function internalModules() {
 	const esmResolve = addon.requireBuiltin("internal/modules/esm/resolve");
 	const esm = esmModule.getOrInitializeCascadedLoader();
 	const modern = "getOrCreateModuleJob" in esm;
-	/* v8 ignore start -- the supported Node 22/24/26 matrix validates each available Internal interface */
+	/* v8 ignore start -- the supported Node 24/26 matrix validates each available Internal interface */
 	if (typeof esm.resolveSync !== "function" || typeof Reflect.get(esm, modern ? "getOrCreateModuleJob" : "getModuleJobForImport") !== "function" || !modern && typeof Reflect.get(esm, "resolve") !== "function" || typeof cjsModule.Module._resolveFilename !== "function" || typeof cjsHelpers.getCjsConditions !== "function" || typeof esmUtils.getDefaultConditions !== "function" || typeof esmResolve.defaultResolve !== "function") throw new Error("profile resolution: unsupported Node module loader");
 	/* v8 ignore stop */
 	return {
@@ -645,7 +645,7 @@ function installRuntimeInterception(resolution) {
 				let expected;
 				try {
 					expected = adapted(target.specifier, target.parentURL, attributes);
-					/* v8 ignore next -- Node 24+ resolves synchronously; the Node 22 matrix covers its Promise result */
+					/* v8 ignore next -- the current loader resolves synchronously; the private interface also permits Promise results */
 					if (expected instanceof Promise) expected = expected.catch(restoreImporter);
 				} catch (error) {
 					return restoreImporter(error);
@@ -674,7 +674,7 @@ function installRuntimeInterception(resolution) {
 				} catch (error) {
 					return restoreImporter(error);
 				}
-				/* v8 ignore next -- Node 24+ resolves synchronously; the Node 22 matrix covers its Promise result */
+				/* v8 ignore next -- the current loader resolves synchronously; the private interface also permits Promise results */
 				if (result instanceof Promise) return result.catch(restoreImporter);
 				if (cacheable) state.esm = result;
 				return result;
@@ -696,12 +696,12 @@ function installRuntimeInterception(resolution) {
 		};
 		return (request, parent, attributes) => {
 			const result = adapted(request, parent, attributes);
-			/* v8 ignore next -- Node 24+ resolves synchronously; the Node 22 matrix covers its Promise result */
+			/* v8 ignore next -- the current loader resolves synchronously; the private interface also permits Promise results */
 			return result instanceof Promise ? result.then((resolved) => relocate(resolved, parent)) : relocate(result, parent);
 		};
 	};
 	let restoreEsm;
-	/* v8 ignore else -- CI coverage runs Node 24 v2; the Node 22 matrix exercises the v1 adapter */
+	/* v8 ignore else -- CI coverage runs Node 24 v2; the Node 24.0 matrix exercises the v1 adapter */
 	if (modern) {
 		const loader = esm;
 		const original = Reflect.get(loader, "resolveSync");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-app-boot",
   "description": "Shared boot glue for the app bins: .env loading, fail-loud Loader guards, snapshot-aware config resolution, and the Loader boot sequence",
-  "version": "0.2.1-rc.5",
+  "version": "0.2.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -32,8 +32,9 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-atomic-write": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-package-manifest": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-atomic-write": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-official-bundles": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-package-manifest": "0.2.2-alpha.3",
     "@eslint-community/regexpp": "^4.12.2",
     "ajv": "^8.20.0",
     "js-yaml": "^4.3.2",
@@ -42,24 +43,24 @@
     "semver": "^7.8.5"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis-plugin-group": "~1.0.5",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.10",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6",
-    "@deepseek-ai/dsh-launch-environment": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-home-paths": "0.2.1-rc.5",
-    "@deepseek-ai/cordis": "~4.0.5"
+    "@deepseek-ai/cordis-plugin-group": "~1.0.6-alpha.2",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.11-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.7-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-home-paths": "0.2.2-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.6-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/schemastery": "~3.18.5",
-    "@deepseek-ai/cordis-plugin-group": "~1.0.5",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.10",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6",
-    "@deepseek-ai/cordis-plugin-timer": "~1.1.7",
-    "@deepseek-ai/dsh-launch-environment": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-home-paths": "0.2.1-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.5",
+    "@deepseek-ai/schemastery": "~3.18.6-alpha.2",
+    "@deepseek-ai/cordis-plugin-group": "~1.0.6-alpha.2",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.11-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.7-alpha.2",
+    "@deepseek-ai/cordis-plugin-timer": "~1.1.8-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-home-paths": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.3",
     "@types/js-yaml": "^4.0.9",
     "@types/semver": "^7.8.0",
-    "@deepseek-ai/cordis": "~4.0.5"
+    "@deepseek-ai/cordis": "~4.0.6-alpha.2"
   }
 }

package/lib/types/official-bundle-packages.d.ts

@@ -1,4 +0,0 @@
-/** Package admission shared by offline catalog generation and release ordering. */
-/** Public DSH release members available through the ordinary on-demand bundle installer. */
-export declare const ON_DEMAND_BUNDLES: readonly string[];
-//# sourceMappingURL=official-bundle-packages.d.ts.map

package/lib/types/official-bundles.d.ts

@@ -1,12 +0,0 @@
-/** Official bundles offered without installing their provider runtimes in the DSH distribution. */
-import type { PluginLocalizedMeta } from '@deepseek-ai/dsh-package-manifest';
-export { ON_DEMAND_BUNDLES } from './official-bundle-packages.ts';
-/** Offline discovery metadata; installation state and the requested version belong to the running host. */
-export interface OfficialBundleCatalogEntry {
-    /** Exact npm package name accepted by the existing bundle installer. */
-    readonly packageName: string;
-    /** Package-owned localized text and a self-contained icon, embedded without provider code. */
-    readonly meta: Required<Pick<PluginLocalizedMeta, 'title' | 'description' | 'icon'>>;
-}
-export { OFFICIAL_ON_DEMAND_CATALOG } from './official-bundles.generated.ts';
-//# sourceMappingURL=official-bundles.d.ts.map

package/lib/types/official-bundles.generated.d.ts

@@ -1,5 +0,0 @@
-/** Generated offline Official bundle metadata. Run pnpm gen-official-bundle-catalog; do not edit. */
-import type { OfficialBundleCatalogEntry } from './official-bundles.ts';
-/** Official on-demand entries, independent of installed packages and registry availability. */
-export declare const OFFICIAL_ON_DEMAND_CATALOG: readonly OfficialBundleCatalogEntry[];
-//# sourceMappingURL=official-bundles.generated.d.ts.map