@lesliechan721/aw 0.1.0-beta.10

package/dist/src/commands/catalog-store.js

@@ -0,0 +1,348 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { CATALOG_STORE_DIRECTORY } from '../constants.js';
+import { withAwHomeMutationLock } from '../utils/aw-home-mutation-lock.js';
+import { createCatalogStoreKey, readCatalogStoreEntry } from '../utils/catalog-generation-store.js';
+import { readCatalogGenerationState } from '../utils/catalog-generation-state.js';
+import { resolveAwHome } from '../utils/state-paths.js';
+const FORMAL_RETENTION_MS = 30 * 24 * 60 * 60 * 1000;
+const TEMP_RETENTION_MS = 24 * 60 * 60 * 1000;
+const HEX_SEGMENT = /^[0-9a-f]{64}$/u;
+const TEMP_SEGMENT = /^\.(staging|replacement|quarantine)-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.tmp$/u;
+function opaqueForeignKey(parent, name) {
+    const digest = crypto.createHash('sha256').update(name).digest('hex').slice(0, 12);
+    return `${parent === '' ? '' : `${parent}/`}<foreign-${digest}>`;
+}
+async function inspectTree(root, nowMs) {
+    let newestMtimeMs = Number.NEGATIVE_INFINITY;
+    let bytes = 0;
+    const pending = [root];
+    try {
+        while (pending.length > 0) {
+            const current = pending.pop();
+            const stat = await fs.lstat(current);
+            newestMtimeMs = Math.max(newestMtimeMs, stat.mtimeMs);
+            if (stat.isSymbolicLink()) {
+                return { ageMs: null, bytes: null, safe: false, reason: 'unsafeSymlink' };
+            }
+            if (stat.isFile()) {
+                bytes += stat.size;
+                continue;
+            }
+            if (!stat.isDirectory()) {
+                return { ageMs: null, bytes: null, safe: false, reason: 'unsafeNode' };
+            }
+            const children = await fs.readdir(current);
+            for (const child of children)
+                pending.push(path.join(current, child));
+        }
+        return {
+            ageMs: Math.max(0, nowMs - newestMtimeMs),
+            bytes,
+            safe: true,
+        };
+    }
+    catch {
+        return { ageMs: null, bytes: null, safe: false, reason: 'unreadable' };
+    }
+}
+async function readEntryIdentity(entryDir) {
+    try {
+        const value = await fs.readJson(path.join(entryDir, 'metadata.json'));
+        if (typeof value.logicalIdentity !== 'string'
+            || typeof value.snapshotDigest !== 'string'
+            || !/^sha256:[0-9a-f]{64}$/u.test(value.snapshotDigest))
+            return null;
+        return { logicalIdentity: value.logicalIdentity, snapshotDigest: value.snapshotDigest };
+    }
+    catch {
+        return null;
+    }
+}
+function retainedEntry(options) {
+    return {
+        storeKey: options.storeKey,
+        category: options.category,
+        status: options.evidence.safe ? 'retained' : 'error',
+        ageMs: options.evidence.ageMs,
+        reclaimableBytes: null,
+        reason: options.evidence.reason ?? options.reason,
+        absolutePath: options.absolutePath,
+    };
+}
+async function inspectFormalEntry(options) {
+    const storeKey = `${options.identitySegment}/${options.digestSegment}`;
+    if (!options.evidence.safe)
+        return retainedEntry({
+            storeKey, category: 'entry', absolutePath: options.entryDir,
+            evidence: options.evidence, reason: 'unsafeEntry',
+        });
+    const identity = await readEntryIdentity(options.entryDir);
+    if (!identity)
+        return retainedEntry({
+            storeKey, category: 'entry', absolutePath: options.entryDir,
+            evidence: options.evidence, reason: 'validationFailed',
+        });
+    try {
+        if (createCatalogStoreKey(identity.logicalIdentity, identity.snapshotDigest) !== storeKey) {
+            throw new Error('store key mismatch');
+        }
+        await readCatalogStoreEntry({ ...identity, env: options.env });
+    }
+    catch {
+        return retainedEntry({
+            storeKey, category: 'entry', absolutePath: options.entryDir,
+            evidence: options.evidence, reason: 'validationFailed',
+        });
+    }
+    if (options.activeKeys.has(storeKey))
+        return {
+            storeKey,
+            category: 'entry',
+            status: 'active',
+            ageMs: options.evidence.ageMs,
+            reclaimableBytes: null,
+            reason: 'active',
+            absolutePath: options.entryDir,
+        };
+    const reclaimable = options.evidence.ageMs !== null && options.evidence.ageMs > FORMAL_RETENTION_MS;
+    return {
+        storeKey,
+        category: 'entry',
+        status: reclaimable ? 'reclaimable' : 'retained',
+        ageMs: options.evidence.ageMs,
+        reclaimableBytes: reclaimable ? options.evidence.bytes : null,
+        reason: reclaimable ? 'inactiveOlderThan30Days' : 'inactiveWithin30Days',
+        absolutePath: options.entryDir,
+    };
+}
+async function inspectTempEntry(options) {
+    const match = TEMP_SEGMENT.exec(options.name);
+    const category = match[1];
+    const storeKey = `${options.identitySegment}/${options.name}`;
+    const rootStat = await fs.lstat(options.entryDir).catch(() => null);
+    if (!rootStat?.isDirectory() || rootStat.isSymbolicLink())
+        return retainedEntry({
+            storeKey, category, absolutePath: options.entryDir,
+            evidence: { ...options.evidence, safe: false, reason: 'unsafeTemporaryRoot' },
+            reason: 'unsafeTemporaryRoot',
+        });
+    if (!options.evidence.safe)
+        return retainedEntry({
+            storeKey, category, absolutePath: options.entryDir,
+            evidence: options.evidence, reason: 'unsafeTemporaryEntry',
+        });
+    if (options.evidence.ageMs === null || options.evidence.ageMs <= TEMP_RETENTION_MS) {
+        return retainedEntry({
+            storeKey, category, absolutePath: options.entryDir,
+            evidence: options.evidence, reason: 'temporaryWithin24Hours',
+        });
+    }
+    if (category === 'quarantine') {
+        const identity = await readEntryIdentity(options.entryDir);
+        if (!identity)
+            return retainedEntry({
+                storeKey, category, absolutePath: options.entryDir,
+                evidence: options.evidence, reason: 'quarantineCanonicalUnknown',
+            });
+        try {
+            const canonicalKey = createCatalogStoreKey(identity.logicalIdentity, identity.snapshotDigest);
+            if (!canonicalKey.startsWith(`${options.identitySegment}/`))
+                throw new Error('identity mismatch');
+            await readCatalogStoreEntry({ ...identity, env: options.env });
+        }
+        catch {
+            return retainedEntry({
+                storeKey, category, absolutePath: options.entryDir,
+                evidence: options.evidence, reason: 'quarantineCanonicalUnhealthy',
+            });
+        }
+    }
+    return {
+        storeKey,
+        category,
+        status: 'reclaimable',
+        ageMs: options.evidence.ageMs,
+        reclaimableBytes: options.evidence.bytes,
+        reason: 'temporaryOlderThan24Hours',
+        absolutePath: options.entryDir,
+    };
+}
+async function activeStoreKeys(env) {
+    const state = await readCatalogGenerationState(env);
+    return new Set(Object.values(state.sources)
+        .flatMap((source) => source.active
+        ? [createCatalogStoreKey(source.active.logicalIdentity, source.active.snapshotDigest)]
+        : []));
+}
+async function inspectCatalogStore(options) {
+    const activeKeys = await activeStoreKeys(options.env);
+    const storeRoot = path.join(resolveAwHome(options.env), CATALOG_STORE_DIRECTORY);
+    const rootStat = await fs.lstat(storeRoot).catch((error) => {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    });
+    if (!rootStat)
+        return [];
+    if (!rootStat.isDirectory() || rootStat.isSymbolicLink()) {
+        return [retainedEntry({
+                storeKey: '.', category: 'foreign', absolutePath: storeRoot,
+                evidence: { ageMs: null, bytes: null, safe: false, reason: 'unsafeStoreRoot' },
+                reason: 'unsafeStoreRoot',
+            })];
+    }
+    const entries = [];
+    const identityNames = await fs.readdir(storeRoot).then((names) => names.sort()).catch(() => null);
+    if (!identityNames)
+        return [retainedEntry({
+                storeKey: '.', category: 'foreign', absolutePath: storeRoot,
+                evidence: { ageMs: null, bytes: null, safe: false, reason: 'unreadableStoreRoot' },
+                reason: 'unreadableStoreRoot',
+            })];
+    for (const identityName of identityNames) {
+        const identityDir = path.join(storeRoot, identityName);
+        const identityStat = await fs.lstat(identityDir).catch(() => null);
+        if (!HEX_SEGMENT.test(identityName) || !identityStat?.isDirectory() || identityStat.isSymbolicLink()) {
+            const evidence = await inspectTree(identityDir, options.nowMs);
+            entries.push(retainedEntry({
+                storeKey: opaqueForeignKey('', identityName), category: 'foreign', absolutePath: identityDir,
+                evidence, reason: 'unrecognizedIdentityNode',
+            }));
+            continue;
+        }
+        const childNames = await fs.readdir(identityDir).then((names) => names.sort()).catch(() => null);
+        if (!childNames) {
+            entries.push(retainedEntry({
+                storeKey: `${identityName}/<unreadable>`, category: 'foreign', absolutePath: identityDir,
+                evidence: { ageMs: null, bytes: null, safe: false, reason: 'unreadableIdentityDirectory' },
+                reason: 'unreadableIdentityDirectory',
+            }));
+            continue;
+        }
+        for (const childName of childNames) {
+            const entryDir = path.join(identityDir, childName);
+            const evidence = await inspectTree(entryDir, options.nowMs);
+            if (HEX_SEGMENT.test(childName)) {
+                entries.push(await inspectFormalEntry({
+                    identitySegment: identityName,
+                    digestSegment: childName,
+                    entryDir,
+                    activeKeys,
+                    evidence,
+                    env: options.env,
+                }));
+            }
+            else if (TEMP_SEGMENT.test(childName)) {
+                entries.push(await inspectTempEntry({
+                    identitySegment: identityName,
+                    name: childName,
+                    entryDir,
+                    evidence,
+                    env: options.env,
+                }));
+            }
+            else {
+                entries.push(retainedEntry({
+                    storeKey: opaqueForeignKey(identityName, childName), category: 'foreign', absolutePath: entryDir,
+                    evidence, reason: 'unrecognizedStoreNode',
+                }));
+            }
+        }
+    }
+    return entries;
+}
+function publicEntries(entries) {
+    return entries.map(({ absolutePath: _absolutePath, ...entry }) => entry);
+}
+function reclaimableTotal(entries) {
+    if (entries.some((entry) => entry.status === 'error'))
+        return null;
+    const reclaimable = entries.filter((entry) => entry.status === 'reclaimable');
+    if (reclaimable.some((entry) => entry.reclaimableBytes === null))
+        return null;
+    return reclaimable.reduce((sum, entry) => sum + entry.reclaimableBytes, 0);
+}
+export async function catalogStoreStatus(options = {}) {
+    const entries = publicEntries(await inspectCatalogStore({
+        env: options.env ?? process.env,
+        nowMs: (options.now ?? new Date()).getTime(),
+    }));
+    return {
+        catalogStoreSchemaVersion: 1,
+        command: 'catalog:store:status',
+        ok: true,
+        entries,
+        totals: {
+            entries: entries.length,
+            reclaimableEntries: entries.filter((entry) => entry.status === 'reclaimable').length,
+            reclaimableBytes: reclaimableTotal(entries),
+        },
+    };
+}
+async function executePrune(options) {
+    const inspected = await inspectCatalogStore({ env: options.env, nowMs: options.nowMs });
+    const deleted = [];
+    const errors = [];
+    const retainedAfterError = new Set();
+    if (!options.dryRun) {
+        for (const entry of inspected.filter((candidate) => candidate.status === 'reclaimable')) {
+            try {
+                await options.remove(entry.absolutePath);
+                deleted.push({ storeKey: entry.storeKey, bytes: entry.reclaimableBytes });
+            }
+            catch {
+                const stillExists = await fs.lstat(entry.absolutePath)
+                    .then(() => true)
+                    .catch(() => false);
+                if (stillExists)
+                    retainedAfterError.add(entry.storeKey);
+                errors.push({
+                    storeKey: entry.storeKey,
+                    code: 'catalogStoreDeleteFailed',
+                    message: `Could not safely complete deletion of Catalog store item ${entry.storeKey}. Retry prune.`,
+                });
+            }
+        }
+    }
+    const entries = publicEntries(inspected);
+    const deletedKeys = new Set(deleted.map((entry) => entry.storeKey));
+    const retained = entries
+        .filter((entry) => !deletedKeys.has(entry.storeKey)
+        && (options.dryRun || entry.status !== 'reclaimable' || retainedAfterError.has(entry.storeKey)))
+        .map((entry) => ({
+        storeKey: entry.storeKey,
+        reason: errors.some((error) => error.storeKey === entry.storeKey)
+            ? 'deleteFailed'
+            : entry.reason,
+    }));
+    return {
+        catalogStoreSchemaVersion: 1,
+        command: 'catalog:store:prune',
+        ok: errors.length === 0,
+        overallState: errors.length === 0 ? 'succeeded' : 'partial',
+        dryRun: options.dryRun,
+        entries,
+        deleted,
+        retained,
+        errors,
+        reclaimableBytes: reclaimableTotal(entries),
+        deletedBytes: deleted.reduce((sum, entry) => sum + entry.bytes, 0),
+    };
+}
+export async function catalogStorePrune(options = {}) {
+    const env = options.env ?? process.env;
+    const nowMs = (options.now ?? new Date()).getTime();
+    const dryRun = options.dryRun !== false;
+    const action = () => executePrune({
+        env,
+        nowMs,
+        dryRun,
+        remove: options.remove ?? ((target) => fs.remove(target)),
+    });
+    if (dryRun)
+        return action();
+    return withAwHomeMutationLock({ env, action });
+}
+//# sourceMappingURL=catalog-store.js.map

package/dist/src/commands/catalog-store.js.map

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

package/dist/src/commands/catalog-workspace-resolution.d.ts

@@ -0,0 +1,13 @@
+export type CatalogWorkspaceResolvedFrom = 'explicit' | 'workspace-marker' | 'git-worktree' | 'cwd';
+export interface CatalogWorkspaceResolution {
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
+}
+export type CatalogWorkspaceGitRootRunner = (cwd: string, env: NodeJS.ProcessEnv) => Promise<string | null>;
+export declare function resolveCatalogWorkspaceRoot(options: {
+    cwd: string;
+    explicitRoot?: string;
+    mode: 'existing' | 'initialize';
+    env?: NodeJS.ProcessEnv;
+    gitRootRunner?: CatalogWorkspaceGitRootRunner;
+}): Promise<CatalogWorkspaceResolution>;

package/dist/src/commands/catalog-workspace-resolution.js

@@ -0,0 +1,42 @@
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import fs from 'fs-extra';
+import { findNearestCatalogWorkspaceRoot, readCatalogWorkspaceMarker, } from '@lesliechan721/aw-plugin-core';
+import { sanitizedGitEnvironment } from './catalog-publication-inspection.js';
+const execFileAsync = promisify(execFile);
+async function findGitWorktreeRoot(cwd, env) {
+    try {
+        const result = await execFileAsync('git', ['rev-parse', '--show-toplevel'], {
+            cwd,
+            env: { ...sanitizedGitEnvironment(env), GIT_OPTIONAL_LOCKS: '0' },
+            encoding: 'utf8',
+        });
+        const root = result.stdout.trim();
+        return root === '' ? null : fs.realpath(root);
+    }
+    catch {
+        return null;
+    }
+}
+export async function resolveCatalogWorkspaceRoot(options) {
+    if (options.explicitRoot !== undefined) {
+        const workspaceRoot = path.resolve(options.cwd, options.explicitRoot);
+        if (options.mode === 'existing')
+            await readCatalogWorkspaceMarker(workspaceRoot);
+        return { workspaceRoot, workspaceRootResolvedFrom: 'explicit' };
+    }
+    const ancestor = await findNearestCatalogWorkspaceRoot({ from: options.cwd });
+    if (ancestor !== null) {
+        return { workspaceRoot: ancestor, workspaceRootResolvedFrom: 'workspace-marker' };
+    }
+    if (options.mode === 'existing') {
+        throw new Error(`Catalog Workspace marker not found from: ${path.resolve(options.cwd)}`);
+    }
+    const gitRoot = await (options.gitRootRunner ?? findGitWorktreeRoot)(path.resolve(options.cwd), options.env ?? process.env);
+    if (gitRoot !== null) {
+        return { workspaceRoot: gitRoot, workspaceRootResolvedFrom: 'git-worktree' };
+    }
+    return { workspaceRoot: path.resolve(options.cwd), workspaceRootResolvedFrom: 'cwd' };
+}
+//# sourceMappingURL=catalog-workspace-resolution.js.map

package/dist/src/commands/catalog-workspace-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-workspace-resolution.js","sourceRoot":"","sources":["../../../src/commands/catalog-workspace-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,MAAM,UAAU,CAAA;AACzB,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAA;AAE7E,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAczC,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,GAAsB;IACpE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;YAC1E,GAAG;YACH,GAAG,EAAE,EAAE,GAAG,uBAAuB,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE;YACjE,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;QACjC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAMjD;IACC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QACrE,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,MAAM,0BAA0B,CAAC,aAAa,CAAC,CAAA;QAChF,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,UAAU,EAAE,CAAA;IACjE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,+BAA+B,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC7E,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,CAAA;IACnF,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1F,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,mBAAmB,CAAC,CAClE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EACzB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAC3B,CAAA;IACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,CAAA;IAC9E,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,yBAAyB,EAAE,KAAK,EAAE,CAAA;AACvF,CAAC"}

package/dist/src/commands/console.d.ts

@@ -0,0 +1,3 @@
+import { type CliExecutionContext } from './runtime.js';
+export declare function formatInteractiveConsoleUnavailableMessage(context: Pick<CliExecutionContext, 'isCi' | 'isTty'>): string;
+export declare function runConsoleController(context: CliExecutionContext): Promise<number>;

package/dist/src/commands/console.js

@@ -0,0 +1,44 @@
+import { createElement } from 'react';
+import { withCommandReporterSession, } from './runtime.js';
+import { createRebuildProgressFeed } from '../output/rebuild-progress.js';
+import { ConsoleAppV4 } from '../tui/console-app-v4.js';
+import { createConsoleTuiV4Controller } from '../tui/controller-runtime.js';
+export function formatInteractiveConsoleUnavailableMessage(context) {
+    const reasons = [
+        context.isCi ? 'CI 环境默认禁用交互控制台。' : undefined,
+        !context.isTty ? '当前 stdin/stdout 不是可交互终端。' : undefined,
+    ].filter(Boolean);
+    return [
+        '当前运行环境不可交互，不能进入 aw 控制台。',
+        ...reasons,
+        '',
+        '可用命令：',
+        '- `aw status`',
+        '- `aw install <plugin> --platform codex --scope user`',
+        '- `aw status --json`',
+    ].join('\n');
+}
+export async function runConsoleController(context) {
+    const progressFeed = createRebuildProgressFeed();
+    const controller = createConsoleTuiV4Controller(context, progressFeed);
+    const sessionReporter = {
+        event: (event) => progressFeed.addEvent(event),
+        notice: (notice) => progressFeed.addNotice(notice),
+    };
+    try {
+        const result = await withCommandReporterSession(context.reporter, sessionReporter, () => context.tuiRunner.launch({
+            input: context.stdin,
+            output: context.tuiOutput,
+            render: (complete) => createElement(ConsoleAppV4, {
+                controller,
+                ownsController: false,
+                onExit: ({ code } = { code: 0, reason: 'user' }) => complete({ exitCode: code }),
+            }),
+        }));
+        return result.exitCode;
+    }
+    finally {
+        controller.dispose();
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/src/commands/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/commands/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAGL,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,UAAU,0CAA0C,CACxD,OAAoD;IAEpD,MAAM,OAAO,GAAG;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;QAC5C,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS;KACxD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO;QACL,yBAAyB;QACzB,GAAG,OAAO;QACV,EAAE;QACF,OAAO;QACP,eAAe;QACf,uDAAuD;QACvD,sBAAsB;KACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA4B;IACrE,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACvE,MAAM,eAAe,GAAoB;QACvC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC9C,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC;KACnD,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,CACtF,OAAO,CAAC,SAAS,CAAC,MAAM,CAAuB;YAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,SAAS;YACzB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE;gBAChD,UAAU;gBACV,cAAc,EAAE,KAAK;gBACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;aACjF,CAAC;SACH,CAAC,CAAC,CAAC;QACN,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/commands/dependency-operation-plan.d.ts

@@ -0,0 +1,58 @@
+import type { DependencyScopeOverride, DependencyScopeSelector, PlatformName, Scope } from '../types.js';
+export type { DependencyScopeOverride } from '../types.js';
+export type DependencyAssignmentSource = 'root' | 'default' | 'existingWiderTarget' | 'userOverride' | 'consumerPromotion' | 'platformRequirement';
+export interface DependencyPlacementTarget {
+    pluginId: string;
+    pluginName: string;
+    platform: PlatformName;
+    relation: 'requested' | 'dependency';
+    depth: number;
+    requiredBy: string[];
+    rootScope: Scope;
+    minimumScope: Scope;
+    resolvedScope: Scope;
+    allowedScopes: Scope[];
+    assignmentSource: DependencyAssignmentSource;
+    locked: boolean;
+    lockReason?: string;
+    affectsOtherProjects: boolean;
+    placementErrorCode?: string;
+}
+export interface DependencyPlacementPlan {
+    requestedPluginIds: string[];
+    resolvedPluginIds: string[];
+    dependencyEdges: Array<{
+        from: string;
+        to: string;
+        platform: PlatformName;
+    }>;
+    scopeOverrides: DependencyScopeOverride[];
+    targets: DependencyPlacementTarget[];
+}
+export interface DependencyPlacementNodeInput {
+    pluginId: string;
+    pluginName: string;
+    platform: PlatformName;
+    relation: 'requested' | 'dependency';
+    depth: number;
+    allowedScopes: Scope[];
+    preferredScope?: Scope;
+    preferredScopeReason?: 'existingWiderTarget';
+}
+export interface DependencyPlacementRootInput {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+}
+export interface DependencyPlacementPlanInput {
+    requestedPluginIds: string[];
+    nodes: DependencyPlacementNodeInput[];
+    roots: DependencyPlacementRootInput[];
+    dependencyEdges: Array<{
+        from: string;
+        to: string;
+        platform: PlatformName;
+    }>;
+    scopeOverrides?: DependencyScopeSelector[];
+}
+export declare function createDependencyPlacementPlan(input: DependencyPlacementPlanInput): DependencyPlacementPlan;