@deepseek-ai/dsh-app-boot 0.1.3-alpha.2 → 0.1.5-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/boot/app-boot/README.md
-README.md: e6afceaebf7fc94f5a6d708639de128cb9005d72
-README.zh.md: a98be1fd5d0624f971af5d0ce5a81fdc0cafab54
+README.md: 197ed81c1025f7211c3fb7a694547c52fb058ee8
+README.zh.md: 5e465a86f5e624380710cc8c73d5356c649522e4

package/README.md

@@ -47,7 +47,7 @@ With that entry point, success looks like a running app with every plugin active
 
 Import profile and bundle declaration types from [`@deepseek-ai/dsh-package-manifest`](../../util/package-manifest/README.md). App-boot owns profile loading, JSON validation, and resolved runtime data.
 
-A profile is how one dsh installation ships different app surfaces: `web`, `headless`, `acp`, `sdk`, and `sdk-minimal` start distinct compositions from the same launcher. A profile lives at `$DSH_HOME/profiles/<name>` and combines installable bundles, its own `cordis.patch.yml`, and `patchReload: live | startup`; omitted reload policy keeps the historical `live` default for custom profiles. The shipped `web` template uses live reload, while the other shipped templates apply patches only at startup. `sdk-minimal` names only its standalone bundle; the other templates retain base-plus-mode stacks. `dsh plugin` creates custom profiles, and a missing bundle or one without a patch declaration fails startup loudly.
+A profile is how one dsh installation ships different app surfaces: `web`, `headless`, `acp`, `sdk`, and `sdk-minimal` start distinct compositions from the same launcher. A profile lives at `$DSH_HOME/profiles/<name>` and combines installable bundles, its own `cordis.patch.yml`, and `patchReload: live | startup`; omitted reload policy keeps the historical `live` default for custom profiles. The shipped `web` template uses live reload, while the other shipped templates apply patches only at startup. `sdk-minimal` names only its standalone bundle; the other templates retain base-plus-mode stacks. `dsh --profile <name> --from-default-profile <template>` creates a custom profile at a new non-shipped name from one shipped template, while `dsh plugin` initializes a base-backed profile and manages its installed bundles. A missing bundle or one without a patch declaration fails startup loudly. Application-owned npm projects, such as Electron's reserved Desktop profile, use `loadProfileDirectory` to load an already initialized directory without exposing it through CLI profile lookup.
 
 Your machine-local preferences also live in the Harness home:
 

package/README.zh.md

@@ -47,7 +47,7 @@ const ctx = await boot('dsh', resolveConfigPath(argv[2], process.env.DSH_SNAPSHO
 
 Profile 与 bundle 的声明类型从 [`@deepseek-ai/dsh-package-manifest`](../../util/package-manifest/README.zh.md) 导入。App-boot 负责 profile 加载、JSON 校验和解析后的运行时数据。
 
-profile 是同一套 dsh 安装提供不同应用界面的方式：`web`、`headless`、`acp`、`sdk` 与 `sdk-minimal` 从同一 launcher 启动不同组合。profile 位于 `$DSH_HOME/profiles/<name>`，由可安装 bundle、自身 `cordis.patch.yml` 与 `patchReload: live | startup` 组成；自定义 profile 省略 reload 策略时保留历史 `live` 默认值。随产品交付的 `web` 模板实时重载，其他随附模板只在启动时应用 patch。`sdk-minimal` 只列出自身的独立 bundle，其他模板保留 base 加模式 bundle 的栈。`dsh plugin` 创建自定义 profile；缺失 bundle 或未声明 patch 的 bundle 会让启动明确失败。
+profile 是同一套 dsh 安装提供不同应用界面的方式：`web`、`headless`、`acp`、`sdk` 与 `sdk-minimal` 从同一 launcher 启动不同组合。profile 位于 `$DSH_HOME/profiles/<name>`，由可安装 bundle、自身 `cordis.patch.yml` 与 `patchReload: live | startup` 组成；自定义 profile 省略 reload 策略时保留历史 `live` 默认值。随产品交付的 `web` 模板实时重载，其他随附模板只在启动时应用 patch。`sdk-minimal` 只列出自身的独立 bundle，其他模板保留 base 加模式 bundle 的栈。`dsh --profile <name> --from-default-profile <template>` 从一个随附模板，在新的非内置名称处创建自定义 profile；`dsh plugin` 则初始化以 base 为基础的 profile，并管理其中安装的 bundle。缺失 bundle 或未声明 patch 的 bundle 会让启动明确失败。由应用持有的 npm 项目（例如 Electron 保留的 Desktop profile）通过 `loadProfileDirectory` 加载已经初始化的目录，而不会将它暴露给 CLI profile 查找。
 
 你的机器本地偏好同样位于 harness home 中：
 

package/lib/index.js

@@ -831,27 +831,17 @@ function resolveBundleDir(binName, packageName, installAnchor, profileDir) {
 	throw new Error(`${binName}: cannot resolve profile bundle ${JSON.stringify(packageName)} from the dsh installation or ${profileDir}; run 'dsh plugin --profile ${basename(profileDir)} install' if its dependency is not installed`);
 }
 /**
-* Load a profile: resolve every `dsh.profile.bundles` entry to its patch
-* layer and parse the profile's own patch file. A listed bundle without a
-* `dsh.bundle` manifest fails loud — naming a bundle-less package as a layer
-* is a misconfiguration, not "no patches".
+* Load an already initialized profile directory without resolving it through
+* the shared Harness home. This is used by application-owned profiles whose
+* package project and lifecycle belong to that application.
 * @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).
-* @param home - the Harness home; defaults to {@link resolveDshHome}.
-* @param options - `userLayer: false` skips reading `cordis.patch.yml`, so a
-* bundles-only consumer (`--dump-default-config`, a recovery diagnostic)
-* cannot fail on a broken user layer.
-* @returns the loaded profile (empty `patches` when the user layer is skipped).
+* @param dir - absolute profile package directory.
+* @param installAnchor - absolute path of the owning dsh app's package.json.
+* @param options - `userLayer: false` skips reading `cordis.patch.yml`.
+* @returns the resolved bundle layers and optional user patch layer.
 */
-function loadProfile(binName, name, installAnchor, home = resolveDshHome(), options = {}) {
-	const dir = resolveProfileDir(name, home);
-	if (!existsSync(join(dir, "package.json"))) {
-		const template = PROFILE_TEMPLATES[name];
-		if (template === void 0) throw new Error(`${binName}: profile ${JSON.stringify(name)} does not exist; create it with 'dsh plugin --profile ${name} add <package>'`);
-		initProfile(dir, template.bundles, template.patchReload);
-	}
-	const manifest = normalizeShippedProfile(name, dir, readProfileManifest(binName, dir));
+function loadProfileDirectory(binName, dir, installAnchor, options = {}) {
+	const manifest = readProfileManifest(binName, dir);
 	const bundles = manifest.dsh?.profile?.bundles ?? [];
 	const rawPatchReload = manifest.dsh?.profile?.patchReload;
 	if (rawPatchReload !== void 0 && rawPatchReload !== "live" && rawPatchReload !== "startup") throw new Error(`${binName}: profile manifest ${join(dir, "package.json")} dsh.profile.patchReload must be "live" or "startup"`);
@@ -869,16 +859,41 @@ function loadProfile(binName, name, installAnchor, home = resolveDshHome(), opti
 		};
 	});
 	const patchPath = join(dir, PROFILE_PATCH_FILENAME);
+	const patches = options.userLayer !== false && existsSync(patchPath) ? loadOverlayPatches(binName, patchPath) : [];
 	return {
-		name,
+		name: basename(dir),
 		dir,
 		layers,
 		patchPath,
-		patches: options.userLayer !== false && existsSync(patchPath) ? loadOverlayPatches(binName, patchPath) : [],
+		patches,
 		patchReload
 	};
 }
 /**
+* Load a profile: resolve every `dsh.profile.bundles` entry to its patch
+* layer and parse the profile's own patch file. A listed bundle without a
+* `dsh.bundle` manifest fails loud — naming a bundle-less package as a layer
+* is a misconfiguration, not "no patches".
+* @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).
+* @param home - the Harness home; defaults to {@link resolveDshHome}.
+* @param options - `userLayer: false` skips reading `cordis.patch.yml`, so a
+* bundles-only consumer (`--dump-default-config`, a recovery diagnostic)
+* cannot fail on a broken user layer.
+* @returns the loaded profile (empty `patches` when the user layer is skipped).
+*/
+function loadProfile(binName, name, installAnchor, home = resolveDshHome(), options = {}) {
+	const dir = resolveProfileDir(name, home);
+	if (!existsSync(join(dir, "package.json"))) {
+		const template = PROFILE_TEMPLATES[name];
+		if (template === void 0) throw new Error(`${binName}: profile ${JSON.stringify(name)} does not exist; create it with 'dsh plugin --profile ${name} add <package>'`);
+		initProfile(dir, template.bundles, template.patchReload);
+	}
+	normalizeShippedProfile(name, dir, readProfileManifest(binName, dir));
+	return loadProfileDirectory(binName, dir, installAnchor, options);
+}
+/**
 * Compose patch layers into the effective entry list over an empty root —
 * the same single `applyEntryPatches` call the boot include makes, so flag
 * derivation and config dumps see exactly what mounts.
@@ -1557,4 +1572,4 @@ function addHarnessSourceSection(ctx, sourceRoot) {
 	});
 }
 //#endregion
-export { DEFAULT_PROFILE_BUNDLES, DEFAULT_PROFILE_PATCH_RELOAD, FAIL_LOUD_RELEASE_TIMEOUT_MS, HARNESS_SOURCE_SECTION, PROFILES_DIR, PROFILE_PATCH_FILENAME, PROFILE_TEMPLATES, addHarnessSourceSection, assertEntriesActivated, assertEntriesLoaded, boot, composeEntries, healProfilesModuleFallback, initProfile, installFailLoud, loadEnv, loadLayeredEnv, loadOptionalPatches, loadOverlayPatches, loadProfile, mountRootInclude, readProfileManifest, renderConfigDump, resolveBundleDir, resolveConfigPath, resolveProfileDir, watchUserPatches, writeProfileManifest };
+export { DEFAULT_PROFILE_BUNDLES, DEFAULT_PROFILE_PATCH_RELOAD, FAIL_LOUD_RELEASE_TIMEOUT_MS, HARNESS_SOURCE_SECTION, PROFILES_DIR, PROFILE_PATCH_FILENAME, PROFILE_TEMPLATES, addHarnessSourceSection, assertEntriesActivated, assertEntriesLoaded, boot, composeEntries, healProfilesModuleFallback, initProfile, installFailLoud, loadEnv, loadLayeredEnv, loadOptionalPatches, loadOverlayPatches, loadProfile, loadProfileDirectory, mountRootInclude, readProfileManifest, renderConfigDump, resolveBundleDir, resolveConfigPath, resolveProfileDir, watchUserPatches, writeProfileManifest };

package/lib/types/index.d.ts

@@ -16,7 +16,7 @@ declare module '@deepseek-ai/cordis' {
         dshHomePath?: typeof dshHomePath;
     }
 }
-export { composeEntries, DEFAULT_PROFILE_BUNDLES, DEFAULT_PROFILE_PATCH_RELOAD, healProfilesModuleFallback, initProfile, loadProfile, PROFILE_PATCH_FILENAME, PROFILE_TEMPLATES, PROFILES_DIR, readProfileManifest, resolveBundleDir, resolveProfileDir, writeProfileManifest, type Profile, type ProfileLayer, type ProfileManifest, type ProfileModuleFallbackOptions, type ProfileTemplate, } from './profile.ts';
+export { composeEntries, DEFAULT_PROFILE_BUNDLES, DEFAULT_PROFILE_PATCH_RELOAD, healProfilesModuleFallback, initProfile, loadProfile, loadProfileDirectory, PROFILE_PATCH_FILENAME, PROFILE_TEMPLATES, PROFILES_DIR, readProfileManifest, resolveBundleDir, resolveProfileDir, writeProfileManifest, type Profile, type ProfileLayer, type ProfileManifest, type ProfileModuleFallbackOptions, type ProfileTemplate, } from './profile.ts';
 /**
  * Resolve the config to boot. Replay swaps a `cordis.yml` basename for
  * `cordis.snapshot.yml` in the same directory; every other mode keeps the path.

package/lib/types/profile.d.ts

@@ -139,6 +139,19 @@ export declare function writeProfileManifest(dir: string, manifest: ProfileManif
  * @returns the bundle package's absolute directory.
  */
 export declare function resolveBundleDir(binName: string, packageName: string, installAnchor: string, profileDir: string): string;
+/**
+ * Load an already initialized profile directory without resolving it through
+ * the shared Harness home. This is used by application-owned profiles whose
+ * package project and lifecycle belong to that application.
+ * @param binName - the diagnostic prefix on thrown errors.
+ * @param dir - absolute profile package directory.
+ * @param installAnchor - absolute path of the owning dsh app's package.json.
+ * @param options - `userLayer: false` skips reading `cordis.patch.yml`.
+ * @returns the resolved bundle layers and optional user patch layer.
+ */
+export declare function loadProfileDirectory(binName: string, dir: string, installAnchor: string, options?: {
+    userLayer?: boolean;
+}): Profile;
 /**
  * Load a profile: resolve every `dsh.profile.bundles` entry to its patch
  * layer and parse the profile's own patch file. A listed bundle without a

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.1.3-alpha.2",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -29,18 +29,18 @@
   "dependencies": {
     "js-yaml": "^4.2.0",
     "resolve.exports": "^2.0.3",
-    "@deepseek-ai/dsh-atomic-write": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-package-manifest": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-atomic-write": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-package-manifest": "^0.1.5-alpha.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis-plugin-group": "^1.0.2",
-    "@deepseek-ai/cordis-plugin-hmr": "^1.0.17",
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
+    "@deepseek-ai/cordis-plugin-hmr": "^1.0.17",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.3-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-launch-environment": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-alpha.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis-plugin-hmr": {
@@ -49,14 +49,14 @@
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
+    "@deepseek-ai/cordis-plugin-group": "^1.0.2",
     "@deepseek-ai/cordis-plugin-hmr": "^1.0.17",
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/cordis-plugin-group": "^1.0.2",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
     "@deepseek-ai/cordis-plugin-timer": "^1.1.4",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.3-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2"
   }
 }