dominds 1.3.1 → 1.4.2

package/dist/cli/enable.js

@@ -1,51 +1,29 @@
 #!/usr/bin/env node
 "use strict";
-/**
- * enable subcommand for dominds CLI (Apps)
- *
- * Usage:
- *   dominds enable <appId> [--port <port>]
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
-const assigned_port_1 = require("../apps/assigned-port");
-const resolution_file_1 = require("../apps/resolution-file");
+const configuration_file_1 = require("../apps/configuration-file");
+const manifest_1 = require("../apps/manifest");
+const workspace_app_state_1 = require("../apps/workspace-app-state");
 function printHelp() {
     console.log(`Usage:
-  dominds enable <appId> [--port <port>]
-
-Options:
-  --port <port>        Set frontend port (stored in ${resolution_file_1.APPS_RESOLUTION_REL_PATH}); use 0 to clear
+  dominds enable <appId>
 `);
 }
 function parseArgs(argv) {
     const positional = [];
-    let port = null;
-    for (let i = 0; i < argv.length; i += 1) {
-        const a = argv[i];
-        if (a === '--help' || a === '-h') {
+    for (const arg of argv) {
+        if (arg === '--help' || arg === '-h') {
             printHelp();
             process.exit(0);
         }
-        if (a === '--port') {
-            const v = argv[i + 1];
-            if (!v)
-                throw new Error('Missing value for --port');
-            const n = Number(v);
-            if (!Number.isFinite(n) || n < 0 || !Number.isInteger(n)) {
-                throw new Error(`Invalid --port value: ${v}`);
-            }
-            port = n;
-            i += 1;
-            continue;
-        }
-        if (a.startsWith('-'))
-            throw new Error(`Unknown option: ${a}`);
-        positional.push(a);
+        if (arg.startsWith('-'))
+            throw new Error(`Unknown option: ${arg}`);
+        positional.push(arg);
     }
     if (positional.length !== 1)
         throw new Error('enable requires exactly one <appId>');
-    return { appId: positional[0], port };
+    return { appId: positional[0] };
 }
 async function main() {
     let args;
@@ -59,40 +37,24 @@ async function main() {
         return;
     }
     const rtwsRootAbs = process.cwd();
-    const loaded = await (0, resolution_file_1.loadAppsResolutionFile)({ rtwsRootAbs });
-    if (loaded.kind === 'error') {
-        console.error(`Error: failed to read ${resolution_file_1.APPS_RESOLUTION_REL_PATH}: ${loaded.errorText}`);
+    if (!(await (0, manifest_1.hasRtwsDeclaredAppDependency)({ rtwsRootAbs, appId: args.appId }))) {
+        console.error(`Error: app '${args.appId}' is not declared in .minds/app.yaml dependencies`);
         process.exit(1);
         return;
     }
-    const found = (0, resolution_file_1.findResolvedApp)(loaded.file, args.appId);
-    if (!found) {
-        console.error(`Error: app '${args.appId}' not installed`);
+    const loadedConfig = await (0, configuration_file_1.loadAppsConfigurationFile)({ rtwsRootAbs });
+    if (loadedConfig.kind === 'error') {
+        console.error(`Error: failed to read .apps/configuration.yaml: ${loadedConfig.errorText}`);
         process.exit(1);
         return;
     }
-    let next = (0, resolution_file_1.setResolvedAppUserEnabled)({
-        existing: loaded.file,
+    const nextConfig = (0, configuration_file_1.setAppDisabledInConfiguration)({
+        existing: loadedConfig.file,
         appId: args.appId,
-        userEnabled: true,
+        disabled: false,
     });
-    if (args.port !== null) {
-        next = (0, resolution_file_1.setResolvedAppAssignedPort)({
-            existing: next,
-            appId: args.appId,
-            assignedPort: args.port === 0 ? null : args.port,
-        });
-    }
-    else {
-        const assignedPort = await (0, assigned_port_1.resolveStableAssignedPort)({
-            appId: found.id,
-            installJson: found.installJson,
-            existingApps: next.apps,
-            existingAssignedPort: found.assignedPort,
-        });
-        next = (0, resolution_file_1.setResolvedAppAssignedPort)({ existing: next, appId: args.appId, assignedPort });
-    }
-    await (0, resolution_file_1.writeAppsResolutionFile)({ rtwsRootAbs, file: next });
+    await (0, configuration_file_1.writeAppsConfigurationFileIfChanged)({ rtwsRootAbs, file: nextConfig });
+    await (0, workspace_app_state_1.refreshAppsDerivedState)({ rtwsRootAbs });
     console.log(`Enabled app '${args.appId}'`);
 }
 if (require.main === module) {

package/dist/cli/install.js

@@ -11,12 +11,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
-const promises_1 = __importDefault(require("fs/promises"));
-const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
 const app_lock_file_1 = require("../apps/app-lock-file");
-const assigned_port_1 = require("../apps/assigned-port");
-const resolution_file_1 = require("../apps/resolution-file");
+const configuration_file_1 = require("../apps/configuration-file");
+const manifest_1 = require("../apps/manifest");
 const run_app_json_1 = require("../apps/run-app-json");
+const workspace_app_state_1 = require("../apps/workspace-app-state");
 function printHelp() {
     console.log(`Usage:
   dominds install <spec|path> [--local] [--id <appId>] [--enable] [--force]
@@ -24,12 +25,12 @@ function printHelp() {
 Options:
   --local              Treat <spec|path> as a local package directory (dev package)
   --id <appId>         Require app id (must match app --json appId)
-  --enable             Enable immediately after install
-  --force              Replace existing installed entry with the same id
+  --enable             Remove the app from disabledApps after install
+  --force              Reserved for future use; currently ignored
 
 Notes:
-  - State is stored in ${resolution_file_1.APPS_RESOLUTION_REL_PATH} under the current rtws (process.cwd()).
-  - dominds installs apps by running '<app> --json' via npx or local package bin.
+  - install adds the app to .minds/app.yaml dependencies.
+  - app resolution source is determined dynamically via .apps/configuration.yaml resolutionStrategy.
 `);
 }
 function parseArgs(argv) {
@@ -39,45 +40,43 @@ function parseArgs(argv) {
     let local = false;
     let idOverride = null;
     for (let i = 0; i < argv.length; i += 1) {
-        const a = argv[i];
-        if (a === '--help' || a === '-h') {
+        const arg = argv[i];
+        if (arg === '--help' || arg === '-h') {
             printHelp();
             process.exit(0);
         }
-        if (a === '--force') {
+        if (arg === '--force') {
             force = true;
             continue;
         }
-        if (a === '--enable') {
+        if (arg === '--enable') {
             enable = true;
             continue;
         }
-        if (a === '--local') {
+        if (arg === '--local') {
             local = true;
             continue;
         }
-        if (a === '--id') {
-            const v = argv[i + 1];
-            if (!v)
+        if (arg === '--id') {
+            const value = argv[i + 1];
+            if (!value)
                 throw new Error('Missing value for --id');
-            idOverride = v.trim() || null;
+            idOverride = value.trim() || null;
             i += 1;
             continue;
         }
-        if (a.startsWith('-')) {
-            throw new Error(`Unknown option: ${a}`);
-        }
-        positional.push(a);
+        if (arg.startsWith('-'))
+            throw new Error(`Unknown option: ${arg}`);
+        positional.push(arg);
     }
-    if (positional.length !== 1) {
+    if (positional.length !== 1)
         throw new Error('install requires exactly one <spec|path>');
-    }
     return { specOrPath: positional[0], force, enable, local, idOverride };
 }
-async function pathIsDirectory(p) {
+async function pathIsDirectory(pathAbs) {
     try {
-        const st = await promises_1.default.stat(p);
-        return st.isDirectory();
+        const stat = await promises_1.default.stat(pathAbs);
+        return stat.isDirectory();
     }
     catch {
         return false;
@@ -101,14 +100,8 @@ async function main() {
         process.exit(1);
         return;
     }
-    const localAbs = path_1.default.resolve(rtwsRootAbs, specOrPath);
+    const localAbs = node_path_1.default.resolve(rtwsRootAbs, specOrPath);
     const shouldUseLocal = args.local || (await pathIsDirectory(localAbs));
-    const loadedResolution = await (0, resolution_file_1.loadAppsResolutionFile)({ rtwsRootAbs });
-    if (loadedResolution.kind === 'error') {
-        console.error(`Error: failed to read ${resolution_file_1.APPS_RESOLUTION_REL_PATH}: ${loadedResolution.errorText}`);
-        process.exit(1);
-        return;
-    }
     const installJson = shouldUseLocal
         ? await (0, run_app_json_1.runDomindsAppJsonViaLocalPackage)({ packageRootAbs: localAbs })
         : await (0, run_app_json_1.runDomindsAppJsonViaNpx)({ spec: specOrPath, cwdAbs: rtwsRootAbs });
@@ -117,62 +110,63 @@ async function main() {
         process.exit(1);
         return;
     }
-    const prev = loadedResolution.file.apps.find((a) => a.id === installJson.appId) ?? null;
-    if (prev && !args.force) {
-        console.error(`Error: app '${installJson.appId}' already installed. Use 'dominds update ${installJson.appId}' or 'dominds install ... --force'.`);
+    const loadedManifest = await (0, manifest_1.loadDomindsAppManifest)({
+        packageRootAbs: rtwsRootAbs,
+        manifestRelPath: manifest_1.DEFAULT_DOMINDS_APP_MANIFEST_REL_PATH,
+    });
+    const manifest = loadedManifest.kind === 'ok' ? loadedManifest.manifest : (0, manifest_1.makeDefaultRtwsAppManifest)();
+    const nextManifest = (0, manifest_1.upsertManifestDependency)({
+        manifest,
+        dependency: { id: installJson.appId },
+    });
+    await (0, manifest_1.writeDomindsAppManifestIfChanged)({
+        packageRootAbs: rtwsRootAbs,
+        manifestRelPath: manifest_1.DEFAULT_DOMINDS_APP_MANIFEST_REL_PATH,
+        manifest: nextManifest,
+    });
+    const loadedConfig = await (0, configuration_file_1.loadAppsConfigurationFile)({ rtwsRootAbs });
+    if (loadedConfig.kind === 'error') {
+        console.error(`Error: failed to read .apps/configuration.yaml: ${loadedConfig.errorText}`);
         process.exit(1);
         return;
     }
-    const userEnabled = args.enable || (prev ? prev.userEnabled : false);
-    const enabled = userEnabled;
-    const assignedPort = await (0, assigned_port_1.resolveStableAssignedPort)({
+    const nextConfig = (0, configuration_file_1.setAppDisabledInConfiguration)({
+        existing: loadedConfig.file,
         appId: installJson.appId,
-        installJson,
-        existingApps: loadedResolution.file.apps,
-        existingAssignedPort: prev?.assignedPort ?? null,
+        disabled: args.enable
+            ? false
+            : isAppCurrentlyDisabled(loadedConfig.file.disabledApps, installJson.appId),
     });
-    const entry = {
-        id: installJson.appId,
-        enabled,
-        userEnabled,
-        source: shouldUseLocal
-            ? { kind: 'local', pathAbs: localAbs }
-            : { kind: 'npx', spec: specOrPath },
-        assignedPort,
-        installJson,
-    };
-    const nextFile = (0, resolution_file_1.upsertResolvedApp)({ existing: loadedResolution.file, next: entry });
-    await (0, resolution_file_1.writeAppsResolutionFile)({ rtwsRootAbs, file: nextFile });
-    try {
-        const loadedLock = await (0, app_lock_file_1.loadAppLockFile)({ rtwsRootAbs });
-        if (loadedLock.kind === 'error') {
-            console.error(`Warning: failed to read .minds/app-lock.yaml: ${loadedLock.errorText}`);
-        }
-        else {
-            const nextLock = (0, app_lock_file_1.upsertLockedApp)({
-                existing: loadedLock.file,
-                next: {
-                    id: entry.id,
-                    source: entry.source,
-                    package: {
-                        name: entry.installJson.package.name,
-                        version: entry.installJson.package.version,
-                    },
-                },
-            });
-            await (0, app_lock_file_1.writeAppLockFileIfChanged)({ rtwsRootAbs, file: nextLock });
-        }
-    }
-    catch (err) {
-        console.error(`Warning: failed to update .minds/app-lock.yaml: ${err instanceof Error ? err.message : String(err)}`);
+    await (0, configuration_file_1.writeAppsConfigurationFileIfChanged)({ rtwsRootAbs, file: nextConfig });
+    const loadedLock = await (0, app_lock_file_1.loadAppLockFile)({ rtwsRootAbs });
+    if (loadedLock.kind === 'error') {
+        console.error(`Error: failed to read .minds/app-lock.yaml: ${loadedLock.errorText}`);
+        process.exit(1);
+        return;
     }
+    const nextLock = (0, app_lock_file_1.upsertLockedApp)({
+        existing: loadedLock.file,
+        next: {
+            id: installJson.appId,
+            package: {
+                name: installJson.package.name,
+                version: installJson.package.version,
+            },
+        },
+    });
+    await (0, app_lock_file_1.writeAppLockFileIfChanged)({ rtwsRootAbs, file: nextLock });
+    await (0, workspace_app_state_1.refreshAppsDerivedState)({ rtwsRootAbs });
+    void args.force;
     console.log(shouldUseLocal
-        ? `Installed app '${entry.id}' from local package: ${localAbs}`
-        : `Installed app '${entry.id}' via npx spec: ${specOrPath}`);
-    if (enabled) {
-        console.log(`Enabled app '${entry.id}'`);
+        ? `Installed app '${installJson.appId}' from local package: ${localAbs}`
+        : `Installed app '${installJson.appId}' via resolver strategy seed: ${specOrPath}`);
+    if (args.enable) {
+        console.log(`Enabled app '${installJson.appId}'`);
     }
 }
+function isAppCurrentlyDisabled(disabledApps, appId) {
+    return (disabledApps ?? []).includes(appId);
+}
 if (require.main === module) {
     main().catch((err) => {
         console.error('Unhandled error:', err);

package/dist/cli/uninstall.js

@@ -1,19 +1,16 @@
 #!/usr/bin/env node
 "use strict";
-/**
- * uninstall subcommand for dominds CLI (Apps)
- *
- * Usage:
- *   dominds uninstall <appId> [--purge]
- */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
-const promises_1 = __importDefault(require("fs/promises"));
-const path_1 = __importDefault(require("path"));
-const resolution_file_1 = require("../apps/resolution-file");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const app_lock_file_1 = require("../apps/app-lock-file");
+const configuration_file_1 = require("../apps/configuration-file");
+const manifest_1 = require("../apps/manifest");
+const workspace_app_state_1 = require("../apps/workspace-app-state");
 function printHelp() {
     console.log(`Usage:
   dominds uninstall <appId> [--purge]
@@ -25,18 +22,18 @@ Options:
 function parseArgs(argv) {
     const positional = [];
     let purge = false;
-    for (const a of argv) {
-        if (a === '--help' || a === '-h') {
+    for (const arg of argv) {
+        if (arg === '--help' || arg === '-h') {
             printHelp();
             process.exit(0);
         }
-        if (a === '--purge') {
+        if (arg === '--purge') {
             purge = true;
             continue;
         }
-        if (a.startsWith('-'))
-            throw new Error(`Unknown option: ${a}`);
-        positional.push(a);
+        if (arg.startsWith('-'))
+            throw new Error(`Unknown option: ${arg}`);
+        positional.push(arg);
     }
     if (positional.length !== 1)
         throw new Error('uninstall requires exactly one <appId>');
@@ -54,23 +51,49 @@ async function main() {
         return;
     }
     const rtwsRootAbs = process.cwd();
-    const loaded = await (0, resolution_file_1.loadAppsResolutionFile)({ rtwsRootAbs });
-    if (loaded.kind === 'error') {
-        console.error(`Error: failed to read ${resolution_file_1.APPS_RESOLUTION_REL_PATH}: ${loaded.errorText}`);
+    const loadedManifest = await (0, manifest_1.loadDomindsAppManifest)({
+        packageRootAbs: rtwsRootAbs,
+        manifestRelPath: manifest_1.DEFAULT_DOMINDS_APP_MANIFEST_REL_PATH,
+    });
+    const manifest = loadedManifest.kind === 'ok' ? loadedManifest.manifest : (0, manifest_1.makeDefaultRtwsAppManifest)();
+    const nextManifest = (0, manifest_1.removeManifestDependency)({
+        manifest,
+        dependencyId: args.appId,
+    });
+    if (nextManifest === manifest) {
+        console.error(`Error: app '${args.appId}' is not declared in .minds/app.yaml dependencies`);
         process.exit(1);
         return;
     }
-    const found = (0, resolution_file_1.findResolvedApp)(loaded.file, args.appId);
-    if (!found) {
-        console.error(`Error: app '${args.appId}' not installed`);
+    await (0, manifest_1.writeDomindsAppManifestIfChanged)({
+        packageRootAbs: rtwsRootAbs,
+        manifestRelPath: manifest_1.DEFAULT_DOMINDS_APP_MANIFEST_REL_PATH,
+        manifest: nextManifest,
+    });
+    const loadedConfig = await (0, configuration_file_1.loadAppsConfigurationFile)({ rtwsRootAbs });
+    if (loadedConfig.kind === 'error') {
+        console.error(`Error: failed to read .apps/configuration.yaml: ${loadedConfig.errorText}`);
+        process.exit(1);
+        return;
+    }
+    const nextConfig = (0, configuration_file_1.setAppDisabledInConfiguration)({
+        existing: loadedConfig.file,
+        appId: args.appId,
+        disabled: false,
+    });
+    await (0, configuration_file_1.writeAppsConfigurationFileIfChanged)({ rtwsRootAbs, file: nextConfig });
+    const loadedLock = await (0, app_lock_file_1.loadAppLockFile)({ rtwsRootAbs });
+    if (loadedLock.kind === 'error') {
+        console.error(`Error: failed to read .minds/app-lock.yaml: ${loadedLock.errorText}`);
         process.exit(1);
         return;
     }
-    const next = (0, resolution_file_1.removeResolvedApp)({ existing: loaded.file, appId: args.appId });
-    await (0, resolution_file_1.writeAppsResolutionFile)({ rtwsRootAbs, file: next });
+    const nextLock = (0, app_lock_file_1.removeLockedApp)({ existing: loadedLock.file, appId: args.appId });
+    await (0, app_lock_file_1.writeAppLockFileIfChanged)({ rtwsRootAbs, file: nextLock });
+    await (0, workspace_app_state_1.refreshAppsDerivedState)({ rtwsRootAbs });
     if (args.purge) {
-        const rtwsAppDirAbs = path_1.default.resolve(rtwsRootAbs, '.apps', args.appId);
-        await promises_1.default.rm(rtwsAppDirAbs, { recursive: true, force: true });
+        const appDirAbs = node_path_1.default.resolve(rtwsRootAbs, '.apps', args.appId);
+        await promises_1.default.rm(appDirAbs, { recursive: true, force: true });
         console.log(`Uninstalled app '${args.appId}' (purged rtws state: .apps/${args.appId}/)`);
     }
     else {

package/dist/cli/update.js

@@ -1,44 +1,33 @@
 #!/usr/bin/env node
 "use strict";
-/**
- * update subcommand for dominds CLI (Apps)
- *
- * Usage:
- *   dominds update [<appId>]
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
-const path_1 = __importDefault(require("path"));
 const app_lock_file_1 = require("../apps/app-lock-file");
-const assigned_port_1 = require("../apps/assigned-port");
-const resolution_file_1 = require("../apps/resolution-file");
-const run_app_json_1 = require("../apps/run-app-json");
+const manifest_1 = require("../apps/manifest");
+const workspace_app_state_1 = require("../apps/workspace-app-state");
 function printHelp() {
     console.log(`Usage:
   dominds update [<appId>]
 
 Notes:
-  - When <appId> is omitted, updates all installed apps by re-running their '<app> --json' handshake.
-  - Updates installJson and package root info as returned by the app.
+  - Re-runs dynamic app resolution using .minds/app.yaml + .apps/configuration.yaml.
+  - Refreshes .apps/resolution.yaml and .minds/app-lock.yaml.
 `);
 }
 function parseArgs(argv) {
     const positional = [];
-    for (const a of argv) {
-        if (a === '--help' || a === '-h') {
+    for (const arg of argv) {
+        if (arg === '--help' || arg === '-h') {
             printHelp();
             process.exit(0);
         }
-        if (a.startsWith('-'))
-            throw new Error(`Unknown option: ${a}`);
-        positional.push(a);
+        if (arg.startsWith('-'))
+            throw new Error(`Unknown option: ${arg}`);
+        positional.push(arg);
     }
     if (positional.length > 1)
         throw new Error('update accepts at most one <appId>');
-    return { appId: positional.length === 1 ? positional[0] : null };
+    return { appId: positional[0] ?? null };
 }
 async function main() {
     let args;
@@ -52,75 +41,42 @@ async function main() {
         return;
     }
     const rtwsRootAbs = process.cwd();
-    const loaded = await (0, resolution_file_1.loadAppsResolutionFile)({ rtwsRootAbs });
-    if (loaded.kind === 'error') {
-        console.error(`Error: failed to read ${resolution_file_1.APPS_RESOLUTION_REL_PATH}: ${loaded.errorText}`);
+    if (args.appId !== null &&
+        !(await (0, manifest_1.hasRtwsDeclaredAppDependency)({ rtwsRootAbs, appId: args.appId }))) {
+        console.error(`Error: app '${args.appId}' is not declared in .minds/app.yaml dependencies`);
         process.exit(1);
         return;
     }
+    const resolution = await (0, workspace_app_state_1.refreshAppsDerivedState)({ rtwsRootAbs });
     const loadedLock = await (0, app_lock_file_1.loadAppLockFile)({ rtwsRootAbs });
-    const shouldUpdateLock = loadedLock.kind === 'ok';
     if (loadedLock.kind === 'error') {
-        console.error(`Warning: failed to read .minds/app-lock.yaml: ${loadedLock.errorText}`);
+        console.error(`Error: failed to read .minds/app-lock.yaml: ${loadedLock.errorText}`);
+        process.exit(1);
+        return;
     }
-    let nextLock = loadedLock.kind === 'ok' ? loadedLock.file : null;
-    const targets = args.appId === null
-        ? [...loaded.file.apps]
-        : (() => {
-            const found = (0, resolution_file_1.findResolvedApp)(loaded.file, args.appId);
-            if (!found) {
-                console.error(`Error: app '${args.appId}' not installed`);
-                process.exit(1);
-                return [];
-            }
-            return [found];
-        })();
-    let nextFile = loaded.file;
-    for (const entry of targets) {
-        const installJson = entry.source.kind === 'npx'
-            ? await (0, run_app_json_1.runDomindsAppJsonViaNpx)({ spec: entry.source.spec, cwdAbs: rtwsRootAbs })
-            : await (0, run_app_json_1.runDomindsAppJsonViaLocalPackage)({
-                packageRootAbs: path_1.default.resolve(entry.source.pathAbs),
-            });
-        if (installJson.appId !== entry.id) {
-            throw new Error(`Update failed: appId mismatch for '${entry.id}': got '${installJson.appId}' from --json handshake`);
-        }
-        const assignedPort = await (0, assigned_port_1.resolveStableAssignedPort)({
-            appId: entry.id,
-            installJson,
-            existingApps: nextFile.apps,
-            existingAssignedPort: entry.assignedPort,
-        });
-        const updated = {
-            ...entry,
-            assignedPort,
-            installJson,
-        };
-        nextFile = (0, resolution_file_1.upsertResolvedApp)({ existing: nextFile, next: updated });
-        if (shouldUpdateLock && nextLock) {
-            nextLock = (0, app_lock_file_1.upsertLockedApp)({
-                existing: nextLock,
-                next: {
-                    id: updated.id,
-                    source: updated.source,
-                    package: {
-                        name: updated.installJson.package.name,
-                        version: updated.installJson.package.version,
-                    },
+    let nextLock = loadedLock.file;
+    for (const app of resolution.apps) {
+        if (args.appId !== null && app.id !== args.appId)
+            continue;
+        nextLock = (0, app_lock_file_1.upsertLockedApp)({
+            existing: nextLock,
+            next: {
+                id: app.id,
+                package: {
+                    name: app.installJson.package.name,
+                    version: app.installJson.package.version,
                 },
-            });
-        }
-        console.log(`Updated app '${entry.id}'`);
+            },
+        });
     }
-    await (0, resolution_file_1.writeAppsResolutionFile)({ rtwsRootAbs, file: nextFile });
-    if (shouldUpdateLock && nextLock) {
-        try {
-            await (0, app_lock_file_1.writeAppLockFileIfChanged)({ rtwsRootAbs, file: nextLock });
-        }
-        catch (err) {
-            console.error(`Warning: failed to update .minds/app-lock.yaml: ${err instanceof Error ? err.message : String(err)}`);
+    await (0, app_lock_file_1.writeAppLockFileIfChanged)({ rtwsRootAbs, file: nextLock });
+    if (args.appId === null) {
+        for (const app of resolution.apps) {
+            console.log(`Updated app '${app.id}'`);
         }
+        return;
     }
+    console.log(`Updated app '${args.appId}'`);
 }
 if (require.main === module) {
     main().catch((err) => {

package/dist/docs/app-constitution.md

@@ -56,7 +56,8 @@ Goal: close the loop for “dependency resolution + observability + regressabili
     - optional missing/disabled: silently skipped (must not block startup; Problems not required; debug logs allowed).
     - required missing/disabled: must not block startup; must be observable in WebUI Problems; related capability enters defunc/unavailable.
   - required disable propagation:
-    - `<rtws>/.apps/resolution.yaml` must represent both user intent (explicit user disable) and the propagated effective state.
+    - `<rtws>/.apps/configuration.yaml` must represent explicit user disables (`disabledApps`).
+    - `<rtws>/.apps/resolution.yaml` must only record the resolved effective enabled state.
     - when dependencies recover, propagated disables must auto-recover (without overriding explicit user disables).
   - Override precedence (documented contract): `rtws override > app override > app defaults`.
   - Lock semantics (design contract): `.minds/app-lock.yaml` freezes dependency versions only; enable/disable must not jitter the lock.
@@ -153,11 +154,12 @@ Analogy (intuition only):
 
 - `.minds/app.yaml`: like `package.json` (declares the dependency graph + app default config such as `frontend.defaultPort`).
 - `.minds/app-lock.yaml`: like `pnpm-lock.yaml` (freezes dependency versions; should not jitter due to enable/disable).
-- `<rtws>/.apps/resolution.yaml`: like `pnpm-workspace.yaml` (for a given rtws: “where each app actually comes from / whether it’s enabled / whether its port is already pinned”).
+- `<rtws>/.apps/configuration.yaml`: workspace user config (resolution strategy + explicit `disabledApps`).
+- `<rtws>/.apps/resolution.yaml`: per-rtws resolution snapshot (“where each app resolved from / whether it is effectively enabled / whether its port is already pinned”).
 
 Key semantics:
 
-- enable/disable operations must only affect `<rtws>/.apps/resolution.yaml`.
+- enable/disable operations must only affect `<rtws>/.apps/configuration.yaml.disabledApps`.
 - dependencies can be declared as `required` vs `optional`:
   - disabling a `required` dependency must transitively make dependents _effectively disabled_ (at minimum observable via UI/Problems).
   - disabling an `optional` dependency must not disable dependents.
@@ -180,14 +182,17 @@ Recommended principles:
 (Current: implemented) existing anchors:
 
 - JSON schema: `dominds/main/apps/app-json.ts` (`DomindsAppInstallJsonV1`).
+- Apps configuration file: `dominds/main/apps/configuration-file.ts`.
 - Apps resolution file: `dominds/main/apps/resolution-file.ts`.
 
-(Current: implemented) the kernel treats `<rtws>/.apps/resolution.yaml` as **overlay + strategy**:
+(Current: implemented) the kernel now splits `<rtws>/.apps/configuration.yaml` from `<rtws>/.apps/resolution.yaml`:
 
-- If the file exists: `apps[]` is the overlay (stores `enabled` / `assignedPort` / `source` / `installJson`), and `resolutionStrategy?` (if present) overrides the default strategy.
-- If the file is missing: the overlay is empty, and the strategy falls back to defaults (`order=['local']`, `localRoots=['dominds-apps']`).
+- `configuration.yaml` carries user config: `resolutionStrategy?` (if present) overrides the default strategy, and `disabledApps` records explicit disables.
+- `resolution.yaml` carries derived state only: `apps[]` stores `enabled` / `assignedPort` / `source` / `installJson`.
+- If `configuration.yaml` is missing, strategy falls back to defaults (`order=['local']`, `localRoots=['dominds-apps']`) and no explicit disables apply.
+- If `resolution.yaml` is missing, the snapshot starts empty and the kernel re-materializes it from the declared dependency graph.
 
-So even without `<rtws>/.apps/resolution.yaml`, as long as `.minds/app.yaml` declares dependencies, the kernel still resolves local apps via the default strategy; if the root manifest has no dependencies, the effective enabled apps set is empty.
+So even without `<rtws>/.apps/configuration.yaml` or `<rtws>/.apps/resolution.yaml`, as long as `.minds/app.yaml` declares dependencies, the kernel still resolves local apps via the default strategy; if the root manifest has no dependencies, the effective enabled apps set is empty.
 
 ## App-provided `.minds/**` assets