@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/config/typescript-preferences.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readWorkspaceTypeScriptPreferences = readWorkspaceTypeScriptPreferences;
+exports.resolveWorkspaceImportPreferences = resolveWorkspaceImportPreferences;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const LANGUAGE_IDS = [
+    "typescript",
+    "typescriptreact",
+    "javascript",
+    "javascriptreact"
+];
+const SPECIFIERS = new Set(["shortest", "project-relative", "relative", "non-relative"]);
+const ENDINGS = new Set(["auto", "minimal", "index", "js"]);
+function readWorkspaceTypeScriptPreferences(workspaceRoot) {
+    const file = path.join(workspaceRoot, ".vscode", "settings.json");
+    if (!isRegularFile(file))
+        return emptyPreferences();
+    try {
+        const parsed = typescript_1.default.parseConfigFileTextToJson(file, fs.readFileSync(file, "utf8"));
+        if (parsed.error || !isRecord(parsed.config))
+            return emptyPreferences();
+        return Object.fromEntries(LANGUAGE_IDS.map((language) => [
+            language,
+            readLanguagePreferences(parsed.config, language)
+        ]));
+    }
+    catch {
+        // Workspace editor preferences are optional hints and must never block a mutation.
+        return emptyPreferences();
+    }
+}
+function resolveWorkspaceImportPreferences(settings, file) {
+    return settings[languageIdForFile(file)];
+}
+function readLanguagePreferences(settings, language) {
+    let preferences = readPreferenceFields(settings, languageFamily(language));
+    for (const [key, value] of Object.entries(settings)) {
+        if (key === `[${language}]` || !languageBlockContains(key, language) || !isRecord(value))
+            continue;
+        preferences = { ...preferences, ...readPreferenceFields(value, languageFamily(language)) };
+    }
+    const exact = settings[`[${language}]`];
+    if (isRecord(exact))
+        preferences = { ...preferences, ...readPreferenceFields(exact, languageFamily(language)) };
+    return preferences;
+}
+function readPreferenceFields(settings, family) {
+    const specifier = settings[`${family}.preferences.importModuleSpecifier`];
+    const ending = settings[`${family}.preferences.importModuleSpecifierEnding`];
+    return {
+        ...(typeof specifier === "string" && SPECIFIERS.has(specifier)
+            ? { specifier: specifier }
+            : {}),
+        ...(typeof ending === "string" && ENDINGS.has(ending)
+            ? { ending: ending }
+            : {})
+    };
+}
+function languageBlockContains(key, language) {
+    return /^\[[^\]]+\](?:\[[^\]]+\])*$/.test(key) && key.split(/\]\[|\[|\]/).includes(language);
+}
+function languageFamily(language) {
+    return language.startsWith("typescript") ? "typescript" : "javascript";
+}
+function languageIdForFile(file) {
+    switch (path.extname(file).toLowerCase()) {
+        case ".tsx": return "typescriptreact";
+        case ".js":
+        case ".mjs":
+        case ".cjs": return "javascript";
+        case ".jsx": return "javascriptreact";
+        default: return "typescript";
+    }
+}
+function emptyPreferences() {
+    return {
+        typescript: {},
+        typescriptreact: {},
+        javascript: {},
+        javascriptreact: {}
+    };
+}
+function isRegularFile(file) {
+    try {
+        return fs.statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}

package/dist/config/workspace-root.js

@@ -1,3 +1,310 @@
-"use strict";var b=exports&&exports.__createBinding||(Object.create?(function(e,t,n,r){r===void 0&&(r=n);var s=Object.getOwnPropertyDescriptor(t,n);(!s||("get"in s?!t.__esModule:s.writable||s.configurable))&&(s={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,s)}):(function(e,t,n,r){r===void 0&&(r=n),e[r]=t[n]})),v=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),_=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var r=[];for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(r[r.length]=s);return r},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var r=e(t),s=0;s<r.length;s++)r[s]!=="default"&&b(n,t,r[s]);return v(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.MATERIALIZED_INSPECT_DEFAULTS=exports.AIB_CONFIG_FILE_NAME=void 0,exports.initWorkspaceRoot=D,exports.resolveWorkspaceRoot=g,exports.resolveRequiredWorkspaceRoot=C,exports.readWorkspaceNumberConfig=O,exports.readWorkspaceBooleanConfig=h,exports.readWorkspaceStringConfig=A,exports.updateWorkspaceConfig=w,exports.workspaceConfigSummary=k,exports.isPathInsideOrEqual=F;const l=_(require("node:fs")),o=_(require("node:path")),E=require("./env-vars"),M=require("../shared/errors");exports.AIB_CONFIG_FILE_NAME="aib.json",exports.MATERIALIZED_INSPECT_DEFAULTS={"inspect.code.maxNonEmptyLines":120,"inspect.usages.maxLocations":12,"inspect.usages.maxCodeBlocks":8,"inspect.members.maxItems":20};function D(e,t={}){const n=o.join(o.resolve(e),exports.AIB_CONFIG_FILE_NAME),r=l.existsSync(n),s=r?m(n):{},f=a(t.sessionDir)??a(s.sessionDir),d=i(s["session.ttlMinutes"]),p=i(s["session.ttlCleanMinutes"])??d??60,I=i(s["session.ttlDeleteMinutes"])??d??60,c={...s,"workspace.root":a(s["workspace.root"])??".",...f?{sessionDir:f}:{},"session.autoDelete":u(s["session.autoDelete"])??!0,"session.ttlDeleteMinutes":I,"session.autoClean":u(s["session.autoClean"])??!0,"session.ttlCleanMinutes":p,"runtime.managedIdeTtlMinutes":i(s["runtime.managedIdeTtlMinutes"])??15,"runtime.managedIdeWatchdogIntervalMs":i(s["runtime.managedIdeWatchdogIntervalMs"])??3e4,"runtime.autoStopManagedIde":u(s["runtime.autoStopManagedIde"])??!0,...r?{}:exports.MATERIALIZED_INSPECT_DEFAULTS};l.writeFileSync(n,`${JSON.stringify(c,null,2)}
-`,"utf8");const S=i(c["session.ttlCleanMinutes"])??60,y=i(c["runtime.managedIdeTtlMinutes"])??15,N=!r||JSON.stringify(s)!==JSON.stringify(c);return{status:r?N?"updated":"unchanged":"created",...r?{}:{created:exports.AIB_CONFIG_FILE_NAME},configPath:n,root:o.resolve(e),"workspace.root":a(c["workspace.root"])??".",...f?{sessionDir:f}:{},"session.autoClean":u(c["session.autoClean"])??!0,"session.ttlCleanMinutes":S,"session.autoDelete":u(c["session.autoDelete"])??!0,"session.ttlDeleteMinutes":i(c["session.ttlDeleteMinutes"])??60,"runtime.autoStopManagedIde":u(c["runtime.autoStopManagedIde"])??!0,"runtime.managedIdeTtlMinutes":y,...f?{}:{next:"Set the default session directory: aib config --session-dir .tmp/aib"}}}function g(e){const t=a(process.env[E.CLI_ENV.workspaceRoot]);if(t){const d=o.resolve(e,t),p=o.join(d,exports.AIB_CONFIG_FILE_NAME),I=l.existsSync(p)?m(p):{"workspace.root":"."};return{root:d,configPath:p,config:I}}const n=T(e);if(!n)return null;const r=m(n),s=o.dirname(n),f=a(r["workspace.root"])??".";return{root:o.resolve(s,f),configPath:n,config:r}}function C(e){const t=g(e);if(t)return t;const n=L(e,".git");throw new M.CliError("WORKSPACE_ROOT_NOT_INITIALIZED","Workspace root is not initialized.",{cwd:o.resolve(e),...n?{detectedGitRoot:n}:{},next:"Run aib help first-setup from the intended repository root."})}function O(e,t,n){const r=g(e);return(r?i(r.config[t]):null)??n}function h(e,t,n){const r=g(e);return(r?u(r.config[t]):null)??n}function A(e,t,n){const r=g(e);return(r?a(r.config[t]):null)??n}function w(e,t){const n=C(e),r={...n.config,...t};return l.writeFileSync(n.configPath,`${JSON.stringify(r,null,2)}
-`,"utf8"),r}function k(e){const t=i(e["session.ttlMinutes"]);return{"workspace.root":a(e["workspace.root"])??".",...a(e.sessionDir)?{sessionDir:a(e.sessionDir)}:{},"session.autoClean":u(e["session.autoClean"])??!0,"session.ttlCleanMinutes":i(e["session.ttlCleanMinutes"])??t??60,"session.autoDelete":u(e["session.autoDelete"])??!0,"session.ttlDeleteMinutes":i(e["session.ttlDeleteMinutes"])??t??60,"runtime.autoStopManagedIde":u(e["runtime.autoStopManagedIde"])??!0,"runtime.managedIdeTtlMinutes":i(e["runtime.managedIdeTtlMinutes"])??15}}function F(e,t){const n=o.resolve(e).toLowerCase(),r=o.resolve(t).toLowerCase();return r===n||r.startsWith(`${n}${o.sep}`)}function T(e){let t=o.resolve(e);const n=o.parse(t).root;for(;;){const r=o.join(t,exports.AIB_CONFIG_FILE_NAME);if(l.existsSync(r)&&l.statSync(r).isFile())return r;if(t===n)break;const s=o.dirname(t);if(s===t)break;t=s}return null}function L(e,t){let n=o.resolve(e);const r=o.parse(n).root;for(;;){if(l.existsSync(o.join(n,t)))return n;if(n===r)break;const s=o.dirname(n);if(s===n)break;n=s}return null}function m(e){try{const t=JSON.parse(l.readFileSync(e,"utf8"));return t&&typeof t=="object"&&!Array.isArray(t)?t:{}}catch(t){throw new M.CliError("AIB_CONFIG_INVALID","aib.json must be valid JSON.",{file:e,error:t instanceof Error?t.message:String(t)})}}function a(e){return typeof e=="string"&&e.trim()?e.trim():null}function i(e){if(typeof e=="number"&&Number.isFinite(e))return e;if(typeof e=="string"&&e.trim()){const t=Number(e);return Number.isFinite(t)?t:null}return null}function u(e){if(typeof e=="boolean")return e;if(typeof e!="string")return null;const t=e.trim().toLowerCase();return["1","true","yes","on"].includes(t)?!0:["0","false","no","off"].includes(t)?!1:null}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MATERIALIZED_TSC_DEFAULTS = exports.MATERIALIZED_INSPECT_DEFAULTS = exports.AIB_CONFIG_FILE_NAME = void 0;
+exports.initWorkspaceRoot = initWorkspaceRoot;
+exports.resolveWorkspaceRoot = resolveWorkspaceRoot;
+exports.resolveWorkspaceRootFromConfig = resolveWorkspaceRootFromConfig;
+exports.runWithWorkspaceRequestContext = runWithWorkspaceRequestContext;
+exports.resolveRequiredWorkspaceRoot = resolveRequiredWorkspaceRoot;
+exports.readWorkspaceNumberConfig = readWorkspaceNumberConfig;
+exports.readWorkspaceBooleanConfig = readWorkspaceBooleanConfig;
+exports.readWorkspaceStringConfig = readWorkspaceStringConfig;
+exports.updateWorkspaceConfig = updateWorkspaceConfig;
+exports.workspaceConfigSummary = workspaceConfigSummary;
+exports.isPathInsideOrEqual = isPathInsideOrEqual;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_async_hooks_1 = require("node:async_hooks");
+const env_vars_1 = require("./env-vars");
+const errors_1 = require("../shared/errors");
+exports.AIB_CONFIG_FILE_NAME = "aib.json";
+const requestWorkspaceRoot = new node_async_hooks_1.AsyncLocalStorage();
+exports.MATERIALIZED_INSPECT_DEFAULTS = {
+    "inspect.code.maxNonEmptyLines": 120,
+    "inspect.usages.maxLocations": 12,
+    "inspect.usages.maxCodeBlocks": 8,
+    "inspect.members.maxItems": 20
+};
+exports.MATERIALIZED_TSC_DEFAULTS = {
+    tsc: {
+        outputCapKb: 12,
+        default: {
+            mode: "project"
+        }
+    }
+};
+function initWorkspaceRoot(cwd, options = {}) {
+    const configPath = path.join(path.resolve(cwd), exports.AIB_CONFIG_FILE_NAME);
+    const existed = fs.existsSync(configPath);
+    const existing = existed ? readJsonObject(configPath) : {};
+    const sessionDir = readString(options.sessionDir) ?? readString(existing.sessionDir);
+    const legacySessionTtl = readNumber(existing["session.ttlMinutes"]);
+    const ttlCleanMinutes = readNumber(existing["session.ttlCleanMinutes"]) ?? legacySessionTtl ?? 60;
+    const ttlDeleteMinutes = readNumber(existing["session.ttlDeleteMinutes"]) ?? legacySessionTtl ?? 60;
+    const config = {
+        ...existing,
+        "workspace.root": readString(existing["workspace.root"]) ?? ".",
+        ...(sessionDir ? { sessionDir } : {}),
+        "session.autoDelete": readBoolean(existing["session.autoDelete"]) ?? true,
+        "session.ttlDeleteMinutes": ttlDeleteMinutes,
+        "session.autoClean": readBoolean(existing["session.autoClean"]) ?? true,
+        "session.ttlCleanMinutes": ttlCleanMinutes,
+        "runtime.managedIdeTtlMinutes": readNumber(existing["runtime.managedIdeTtlMinutes"]) ?? 15,
+        "runtime.managedIdeWatchdogIntervalMs": readNumber(existing["runtime.managedIdeWatchdogIntervalMs"]) ?? 30000,
+        "runtime.autoStopManagedIde": readBoolean(existing["runtime.autoStopManagedIde"]) ?? true,
+        ...(!existed ? exports.MATERIALIZED_INSPECT_DEFAULTS : {}),
+        ...(!existed && !Object.prototype.hasOwnProperty.call(existing, "tsc") ? exports.MATERIALIZED_TSC_DEFAULTS : {})
+    };
+    fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    const sessionTtlMinutes = readNumber(config["session.ttlCleanMinutes"]) ?? 60;
+    const runtimeTtlMinutes = readNumber(config["runtime.managedIdeTtlMinutes"]) ?? 15;
+    const changed = !existed || JSON.stringify(existing) !== JSON.stringify(config);
+    return {
+        status: !existed ? "created" : changed ? "updated" : "unchanged",
+        ...(!existed ? { created: exports.AIB_CONFIG_FILE_NAME } : {}),
+        configPath,
+        root: path.resolve(cwd),
+        "workspace.root": readString(config["workspace.root"]) ?? ".",
+        ...(sessionDir ? { sessionDir } : {}),
+        "session.autoClean": readBoolean(config["session.autoClean"]) ?? true,
+        "session.ttlCleanMinutes": sessionTtlMinutes,
+        "session.autoDelete": readBoolean(config["session.autoDelete"]) ?? true,
+        "session.ttlDeleteMinutes": readNumber(config["session.ttlDeleteMinutes"]) ?? 60,
+        "runtime.autoStopManagedIde": readBoolean(config["runtime.autoStopManagedIde"]) ?? true,
+        "runtime.managedIdeTtlMinutes": runtimeTtlMinutes,
+        ...(!sessionDir ? { next: "Set the default session directory: aib config --session-dir .tmp/aib" } : {})
+    };
+}
+function resolveWorkspaceRoot(cwd) {
+    const scoped = requestWorkspaceRoot.getStore();
+    if (scoped !== undefined) {
+        return scoped;
+    }
+    const envRoot = readString(process.env[env_vars_1.CLI_ENV.workspaceRoot]);
+    if (envRoot) {
+        const root = path.resolve(cwd, envRoot);
+        const configPath = path.join(root, exports.AIB_CONFIG_FILE_NAME);
+        const config = fs.existsSync(configPath) ? readJsonObject(configPath) : { "workspace.root": "." };
+        return {
+            root,
+            configPath,
+            config
+        };
+    }
+    return resolveWorkspaceRootFromConfig(cwd);
+}
+/** Resolve a request workspace from its cwd/config without process-level routing state. */
+function resolveWorkspaceRootFromConfig(cwd) {
+    const configPath = findWorkspaceConfig(cwd);
+    if (!configPath) {
+        return null;
+    }
+    const config = readJsonObject(configPath);
+    const configDir = path.dirname(configPath);
+    const configuredRoot = readString(config["workspace.root"]) ?? ".";
+    return {
+        root: path.resolve(configDir, configuredRoot),
+        configPath,
+        config
+    };
+}
+/** Scope workspace resolution to one daemon request and reject stale cross-workspace overrides. */
+function runWithWorkspaceRequestContext(cwd, requestedRoot, callback) {
+    const absoluteCwd = path.resolve(cwd);
+    const discovered = resolveWorkspaceRootFromConfig(absoluteCwd);
+    const explicitRoot = readString(requestedRoot);
+    const absoluteExplicitRoot = explicitRoot ? path.resolve(absoluteCwd, explicitRoot) : null;
+    if (absoluteExplicitRoot && discovered && !samePath(absoluteExplicitRoot, discovered.root)) {
+        throw workspaceContextMismatch(absoluteCwd, discovered, absoluteExplicitRoot);
+    }
+    const resolved = discovered ?? (absoluteExplicitRoot ? workspaceResolutionForExplicitRoot(absoluteExplicitRoot) : null);
+    if (resolved && !isPathInsideOrEqual(resolved.root, absoluteCwd)) {
+        throw workspaceContextMismatch(absoluteCwd, resolved, absoluteExplicitRoot ?? resolved.root);
+    }
+    return requestWorkspaceRoot.run(resolved, callback);
+}
+function resolveRequiredWorkspaceRoot(cwd) {
+    const resolved = resolveWorkspaceRoot(cwd);
+    if (resolved) {
+        return resolved;
+    }
+    const detectedGitRoot = findAncestorContaining(cwd, ".git");
+    throw new errors_1.CliError("WORKSPACE_ROOT_NOT_INITIALIZED", "Workspace root is not initialized.", {
+        cwd: path.resolve(cwd),
+        ...(detectedGitRoot ? { detectedGitRoot } : {}),
+        next: "Run aib help first-setup from the intended repository root."
+    });
+}
+function readWorkspaceNumberConfig(cwd, key, fallback) {
+    const resolved = resolveWorkspaceRoot(cwd);
+    const value = resolved ? readNumber(resolved.config[key]) : null;
+    return value ?? fallback;
+}
+function readWorkspaceBooleanConfig(cwd, key, fallback) {
+    const resolved = resolveWorkspaceRoot(cwd);
+    const value = resolved ? readBoolean(resolved.config[key]) : null;
+    return value ?? fallback;
+}
+function readWorkspaceStringConfig(cwd, key, fallback) {
+    const resolved = resolveWorkspaceRoot(cwd);
+    const value = resolved ? readString(resolved.config[key]) : null;
+    return value ?? fallback;
+}
+function updateWorkspaceConfig(cwd, updates) {
+    const resolved = resolveRequiredWorkspaceRoot(cwd);
+    const config = {
+        ...resolved.config,
+        ...updates
+    };
+    fs.writeFileSync(resolved.configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    return config;
+}
+function workspaceConfigSummary(config) {
+    const legacySessionTtl = readNumber(config["session.ttlMinutes"]);
+    return {
+        "workspace.root": readString(config["workspace.root"]) ?? ".",
+        ...(readString(config.sessionDir) ? { sessionDir: readString(config.sessionDir) } : {}),
+        "session.autoClean": readBoolean(config["session.autoClean"]) ?? true,
+        "session.ttlCleanMinutes": readNumber(config["session.ttlCleanMinutes"]) ?? legacySessionTtl ?? 60,
+        "session.autoDelete": readBoolean(config["session.autoDelete"]) ?? true,
+        "session.ttlDeleteMinutes": readNumber(config["session.ttlDeleteMinutes"]) ?? legacySessionTtl ?? 60,
+        "runtime.autoStopManagedIde": readBoolean(config["runtime.autoStopManagedIde"]) ?? true,
+        "runtime.managedIdeTtlMinutes": readNumber(config["runtime.managedIdeTtlMinutes"]) ?? 15
+    };
+}
+function isPathInsideOrEqual(parent, child) {
+    const normalizedParent = path.resolve(parent).toLowerCase();
+    const normalizedChild = path.resolve(child).toLowerCase();
+    return normalizedChild === normalizedParent || normalizedChild.startsWith(`${normalizedParent}${path.sep}`);
+}
+function findWorkspaceConfig(cwd) {
+    let current = path.resolve(cwd);
+    const parsedRoot = path.parse(current).root;
+    while (true) {
+        const candidate = path.join(current, exports.AIB_CONFIG_FILE_NAME);
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+            return candidate;
+        }
+        if (current === parsedRoot) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+function workspaceResolutionForExplicitRoot(root) {
+    const configPath = path.join(root, exports.AIB_CONFIG_FILE_NAME);
+    return {
+        root,
+        configPath,
+        config: fs.existsSync(configPath) ? readJsonObject(configPath) : { "workspace.root": "." }
+    };
+}
+function workspaceContextMismatch(cwd, discovered, requestedRoot) {
+    return new errors_1.CliError("WORKSPACE_CONTEXT_MISMATCH", "The request workspace does not match the workspace context selected for this command.", {
+        cwd,
+        requestedRoot,
+        resolvedRoot: discovered.root,
+        configPath: discovered.configPath,
+        writesPerformed: false
+    });
+}
+function samePath(left, right) {
+    return path.resolve(left).toLowerCase() === path.resolve(right).toLowerCase();
+}
+function findAncestorContaining(cwd, name) {
+    let current = path.resolve(cwd);
+    const parsedRoot = path.parse(current).root;
+    while (true) {
+        if (fs.existsSync(path.join(current, name))) {
+            return current;
+        }
+        if (current === parsedRoot) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+function readJsonObject(filePath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch (error) {
+        throw new errors_1.CliError("AIB_CONFIG_INVALID", "aib.json must be valid JSON.", {
+            file: filePath,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function readNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim()) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+function readBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized)) {
+        return true;
+    }
+    if (["0", "false", "no", "off"].includes(normalized)) {
+        return false;
+    }
+    return null;
+}