@lesliechan721/aw 0.1.0-beta.10

package/dist/src/output/command-receipt.js

@@ -0,0 +1,302 @@
+export function requestedIntentAction(command) {
+    if (command === 'install')
+        return 'add';
+    if (command === 'uninstall')
+        return 'remove';
+    return 'keep';
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+function recoveryForTarget(state, errorCode) {
+    if (state === 'completed')
+        return [];
+    if (errorCode === 'exclusiveOwnerEvidenceInvalid'
+        || errorCode === 'forceCleanupPathUnavailable')
+        return [];
+    if (errorCode === 'codexProjectPluginVersionTooLow'
+        || errorCode === 'codexProjectPluginUnsupported'
+        || errorCode === 'codexSystemCliUnsupported') {
+        return ['upgrade or repair the official system Codex CLI, then retry the original operation'];
+    }
+    if (errorCode === 'sourceMissing' || errorCode === 'catalogSourceUnavailable'
+        || errorCode === 'codexIntentSourceUnavailable') {
+        return ['refresh the Catalog source and run sync', 'run cleanup for AW-owned residue'];
+    }
+    if (errorCode === 'codexSharedNativeForeign') {
+        return [
+            'remove or rename the foreign Codex plugin, then run sync; cleanup preserves foreign content and does not delete this collision',
+        ];
+    }
+    return ['run sync', 'run reinstall', 'run cleanup for AW-owned residue'];
+}
+function rebuildErrorCode(message) {
+    for (const code of [
+        'legacyStateUnsupported',
+        'sourceChanged',
+        'sourceMissing',
+        'artifactCollision',
+        'dependencyNotReady',
+        'dependencyScopeTooNarrow',
+        'dependencyScopeConflict',
+        'dependencyTargetUnsupported',
+        'dependencyInstallFailed',
+        'dependencyStillRequired',
+    ]) {
+        if (message.includes(code))
+            return code;
+    }
+    if (message.startsWith('Cannot resolve required catalog sources:')) {
+        return 'catalogSourceUnavailable';
+    }
+    const prefix = message.split(':', 1)[0];
+    return /^[A-Za-z][A-Za-z0-9]*$/u.test(prefix) ? prefix : 'writeFailed';
+}
+function earlyFailureRecovery(command, errorCode) {
+    if (errorCode === 'codexProjectPluginVersionTooLow'
+        || errorCode === 'codexProjectPluginUnsupported'
+        || errorCode === 'codexSystemCliUnsupported') {
+        return ['upgrade or repair the official system Codex CLI, then retry the original operation'];
+    }
+    if (errorCode === 'syncSelectorConflict') {
+        return ['remove either plugin selectors or --all, then rerun sync'];
+    }
+    if (errorCode === 'syncSelectionRequired') {
+        return ['specify desired plugin selectors or --all, then rerun sync'];
+    }
+    return [`correct the ${command} request and retry`];
+}
+function sameTarget(left, right) {
+    return left.platform === right.platform
+        && left.scope === right.scope
+        && (left.pluginId !== undefined && right.pluginId !== undefined
+            ? left.pluginId === right.pluginId
+            : left.pluginName === right.pluginName);
+}
+function receiptTargetFromRebuild(result) {
+    return {
+        pluginName: result.target.pluginName,
+        ...(result.target.pluginId ? { pluginId: result.target.pluginId } : {}),
+        ...(result.target.marketplaceName ? { marketplaceName: result.target.marketplaceName } : {}),
+        ...(result.target.sourceId ? { sourceId: result.target.sourceId } : {}),
+        ...(result.target.sourceIdentity ? { sourceIdentity: result.target.sourceIdentity } : {}),
+        platform: result.target.platform,
+        scope: result.target.scope,
+    };
+}
+function sourceTargetResults(command, result, errors) {
+    const targetResults = [...(result.targetResults ?? [])];
+    for (const rebuild of result.rebuildResults ?? []) {
+        const target = receiptTargetFromRebuild(rebuild);
+        if (targetResults.some((candidate) => sameTarget(candidate.target, target)))
+            continue;
+        targetResults.push({
+            target,
+            action: rebuild.command,
+            state: rebuild.status === 'succeeded' ? 'completed' : 'failed',
+            ...(rebuild.status === 'failed' ? {
+                message: rebuild.error.message,
+                errorCode: rebuildErrorCode(rebuild.error.message),
+            } : {}),
+        });
+    }
+    if (targetResults.length > 0)
+        return targetResults;
+    const earlyError = errors[0];
+    return (result.receiptTargets ?? []).map((target) => ({
+        target,
+        action: command,
+        state: result.overallState === 'succeeded' ? 'completed' : 'failed',
+        ...(result.overallState === 'succeeded' ? {} : {
+            message: earlyError?.message ?? 'The write command did not run.',
+            errorCode: earlyError?.code ?? 'writeCommandFailed',
+        }),
+    }));
+}
+function findRebuildResult(target, rebuildResults) {
+    return rebuildResults.find((candidate) => sameTarget(target, receiptTargetFromRebuild(candidate)));
+}
+function plannedTargetChanges(target, operationPlan) {
+    if (!operationPlan || !target.pluginId)
+        return [];
+    const exactPrefix = `${target.pluginId}:${target.platform}:${target.scope}:`;
+    const exact = operationPlan.changes.filter((change) => change.startsWith(exactPrefix));
+    if (exact.length > 0)
+        return exact;
+    const hasTargetAction = operationPlan.actions.some((action) => action.pluginId === target.pluginId
+        && action.platform === target.platform
+        && action.scope === target.scope);
+    return hasTargetAction
+        ? operationPlan.changes.filter((change) => change.startsWith(`${target.pluginId}:`))
+        : [];
+}
+const MUTATING_REBUILD_ACTIONS = new Set([
+    'stale.cleanup',
+    'native.write',
+    'artifacts.write',
+    'marketplace.commit',
+    'marketplace.rollback',
+    'recovery.cleanup',
+    'cleanup.owned',
+]);
+function observableTargetChanges(targetResult, rebuildResult) {
+    const changes = rebuildResult?.actions
+        .filter((action) => action.status === 'succeeded' && MUTATING_REBUILD_ACTIONS.has(action.name))
+        .map((action) => action.name) ?? [];
+    changes.push(...(rebuildResult?.removed ?? []).map((entry) => `removed:${entry}`));
+    if (changes.length === 0
+        && targetResult.state === 'completed'
+        && targetResult.action !== 'keep'
+        && targetResult.action !== 'skipped') {
+        changes.push(targetResult.action);
+    }
+    return unique(changes);
+}
+function receiptTargetResult(targetResult, result) {
+    const rebuild = findRebuildResult(targetResult.target, result.rebuildResults ?? []);
+    const target = rebuild
+        ? { ...receiptTargetFromRebuild(rebuild), ...targetResult.target }
+        : targetResult.target;
+    const planned = result.dependencyPlan?.targets.find((candidate) => candidate.pluginId === target.pluginId
+        && candidate.platform === target.platform
+        && candidate.resolvedScope === target.scope);
+    const message = targetResult.message
+        ?? (rebuild?.status === 'failed' ? rebuild.error.message : undefined);
+    const errorCode = targetResult.errorCode
+        ?? (message && (targetResult.state === 'failed' || targetResult.action === 'skipped')
+            ? rebuildErrorCode(message)
+            : undefined);
+    const planChanges = plannedTargetChanges(target, result.operationPlan);
+    const changes = planChanges.length > 0
+        ? planChanges
+        : observableTargetChanges(targetResult, rebuild);
+    const recoveryActions = unique([
+        ...(targetResult.recoveryActions ?? []),
+        ...recoveryForTarget(targetResult.action === 'skipped' ? 'failed' : targetResult.state, errorCode),
+    ]);
+    const sharedNative = target.platform === 'codex' && target.pluginId
+        ? result.codexReconcilePlans?.flatMap((plan) => plan.desiredTargets.some((desired) => desired.pluginId === target.pluginId && desired.scopes.includes(target.scope))
+            ? plan.sharedNativeActions
+            : [])
+            .find((action) => action.pluginId === target.pluginId && action.action !== 'none')
+        : undefined;
+    return {
+        target,
+        action: targetResult.action,
+        state: targetResult.state,
+        ...(message ? { message } : {}),
+        ...(errorCode ? { errorCode } : {}),
+        relation: planned?.relation ?? targetResult.relation ?? 'requested',
+        requiredBy: planned?.requiredBy ?? targetResult.requiredBy ?? [],
+        changes,
+        recoveryActions,
+        cleanupAttempted: rebuild?.cleanupAttempted ?? false,
+        actions: rebuild?.actions ?? [],
+        removed: rebuild?.removed ?? [],
+        absent: rebuild?.absent ?? [],
+        residual: rebuild?.residual ?? [],
+        quarantined: rebuild?.quarantined ?? [],
+        failures: rebuild?.failures ?? [],
+        ...(sharedNative ? {
+            sharedNative: {
+                codexPluginId: sharedNative.codexPluginId,
+                action: sharedNative.action,
+            },
+        } : {}),
+    };
+}
+function overallState(targetResults, fallback) {
+    if (targetResults.length === 0)
+        return fallback ?? 'succeeded';
+    const successful = targetResults.filter((target) => target.state === 'completed' && target.action !== 'skipped').length;
+    if (successful === targetResults.length)
+        return 'succeeded';
+    const successfulRequested = targetResults.some((target) => target.relation === 'requested'
+        && target.state === 'completed'
+        && target.action !== 'skipped');
+    return successfulRequested ? 'partial' : 'failed';
+}
+export function buildRebuildReceiptJson(command, result) {
+    const hasCoreEvidence = (result.targetResults?.length ?? 0) > 0
+        || (result.rebuildResults?.length ?? 0) > 0
+        || (result.receiptTargets?.length ?? 0) > 0;
+    const errors = result.errors ?? (!hasCoreEvidence && result.overallState !== 'succeeded'
+        ? [{
+                code: result.warnings[0]?.split(':', 1)[0] || 'writeCommandFailed',
+                message: result.warnings[0] ?? 'The write command did not run.',
+            }]
+        : []);
+    const targetResults = sourceTargetResults(command, result, errors)
+        .map((target) => receiptTargetResult(target, result));
+    const state = overallState(targetResults, result.overallState);
+    const changes = result.operationPlan?.changes ?? unique(targetResults.flatMap((target) => target.changes));
+    const recoveryActions = unique(targetResults.flatMap((target) => target.recoveryActions));
+    if (state !== 'succeeded' && targetResults.length === 0) {
+        recoveryActions.push(...earlyFailureRecovery(command, errors[0]?.code));
+    }
+    return {
+        ok: state === 'succeeded',
+        command,
+        receiptSchemaVersion: 6,
+        ...(result.dependencyPlan ? {
+            dependencyPlanSchemaVersion: 2,
+            requestedPluginIds: result.dependencyPlan.requestedPluginIds,
+            resolvedPluginIds: result.dependencyPlan.resolvedPluginIds,
+            dependencyEdges: result.dependencyPlan.dependencyEdges,
+        } : {}),
+        overallState: state,
+        changes,
+        targetResults,
+        warnings: unique([
+            ...result.warnings,
+            ...(result.operationPlan?.warnings ?? []),
+        ]),
+        recoveryActions: unique(recoveryActions),
+        ...(result.operationPlan ? { planFingerprint: result.operationPlan.planFingerprint } : {}),
+        errors,
+    };
+}
+export function renderRebuildReceipt(command, result) {
+    const receipt = buildRebuildReceiptJson(command, result);
+    const stateLabel = {
+        succeeded: '完成',
+        partial: '部分完成',
+        failed: '失败',
+    };
+    return [
+        `${command} ${stateLabel[receipt.overallState]}：${receipt.targetResults.length} 个目标。`,
+        ...receipt.changes.map((change) => `变更：${change}`),
+        ...receipt.warnings.map((warning) => `警告：${warning}`),
+        ...receipt.errors.map((error) => error.message),
+        ...receipt.targetResults.flatMap((target) => {
+            const pluginId = target.target.pluginId ?? target.target.pluginName;
+            return [
+                `- ${pluginId} / ${target.target.platform} / ${target.target.scope}: ${target.state}`,
+                ...(target.sharedNative
+                    ? [`  shared native ${target.sharedNative.codexPluginId}: ${target.sharedNative.action}`]
+                    : []),
+                ...(target.message ? [`  ${target.message}`] : []),
+                ...target.failures
+                    .filter((failure) => failure.message !== target.message)
+                    .map((failure) => `  ${failure.phase}: ${failure.message}`),
+            ];
+        }),
+        ...receipt.recoveryActions.map((recovery) => `恢复：${recovery}`),
+    ];
+}
+export function buildInitReceiptJson(result) {
+    return {
+        command: 'init',
+        receiptSchemaVersion: 6,
+        receiptKind: 'catalogReadiness',
+        ...result,
+    };
+}
+export function renderInitReceipt(result) {
+    return [
+        `Catalog Active sources ${result.ok ? 'ready' : 'not ready'}.`,
+        ...result.sources.map((source) => `- ${source.id}: ${source.activeReady ? 'ready' : source.error}`),
+        ...result.recovery.map((recovery) => `Recovery: ${recovery}`),
+    ];
+}
+//# sourceMappingURL=command-receipt.js.map

package/dist/src/output/command-receipt.js.map

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

package/dist/src/output/debug-log.d.ts

@@ -0,0 +1,4 @@
+import type { CommandDiagnostics } from '../commands/runtime.js';
+import type { DebugLogger } from './model.js';
+export declare function createNoopDebugLogger(): DebugLogger;
+export declare function createFileDebugLogger(diagnostics: CommandDiagnostics): DebugLogger;

package/dist/src/output/debug-log.js

@@ -0,0 +1,97 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { redactValue } from './redact.js';
+const MAX_LOG_FILES = 20;
+const MAX_LOG_AGE_MS = 14 * 24 * 60 * 60 * 1000;
+export function createNoopDebugLogger() {
+    return {
+        log: () => { },
+    };
+}
+async function appendJsonLine(logFile, payload) {
+    await fs.ensureDir(path.dirname(logFile));
+    await fs.appendFile(logFile, `${JSON.stringify(redactValue(payload))}\n`, 'utf8');
+}
+async function cleanupOldLogs(logFile, diagnostics) {
+    if (diagnostics.commandName === 'status' || diagnostics.logFileSource !== 'default') {
+        return;
+    }
+    const dir = path.dirname(logFile);
+    try {
+        const entries = await fs.readdir(dir);
+        const now = Date.now();
+        const candidates = await Promise.all(entries
+            .filter((entry) => entry.startsWith('aw-') && entry.endsWith('.log'))
+            .map(async (entry) => {
+            const filePath = path.join(dir, entry);
+            const stat = await fs.stat(filePath);
+            return {
+                filePath,
+                mtimeMs: stat.mtimeMs,
+            };
+        }));
+        const sorted = candidates.sort((left, right) => right.mtimeMs - left.mtimeMs);
+        await Promise.all(sorted
+            .filter((entry, index) => index >= MAX_LOG_FILES || now - entry.mtimeMs > MAX_LOG_AGE_MS)
+            .map((entry) => fs.remove(entry.filePath)));
+    }
+    catch (error) {
+        await appendJsonLine(logFile, {
+            time: new Date().toISOString(),
+            runId: diagnostics.runId,
+            commandName: diagnostics.commandName,
+            event: {
+                type: 'debug-log:cleanup-error',
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
+    }
+}
+export function createFileDebugLogger(diagnostics) {
+    if (!diagnostics.debug || !diagnostics.logFile) {
+        return createNoopDebugLogger();
+    }
+    const logFile = diagnostics.logFile;
+    let initialized = false;
+    async function ensureInitialized() {
+        if (initialized) {
+            return;
+        }
+        initialized = true;
+        await appendJsonLine(logFile, {
+            time: new Date().toISOString(),
+            runId: diagnostics.runId,
+            commandName: diagnostics.commandName,
+            event: {
+                type: 'run:metadata',
+                data: {
+                    nodeVersion: process.version,
+                    platform: process.platform,
+                    arch: process.arch,
+                    logFile,
+                    commandName: diagnostics.commandName,
+                    runId: diagnostics.runId,
+                    cliVersion: process.env.npm_package_version,
+                    ...diagnostics.metadata,
+                },
+            },
+        });
+        await cleanupOldLogs(logFile, diagnostics);
+    }
+    return {
+        logFile,
+        log: async (event) => {
+            if (initialized && !(await fs.pathExists(logFile))) {
+                initialized = false;
+            }
+            await ensureInitialized();
+            await appendJsonLine(logFile, {
+                time: new Date().toISOString(),
+                runId: diagnostics.runId,
+                commandName: diagnostics.commandName,
+                event,
+            });
+        },
+    };
+}
+//# sourceMappingURL=debug-log.js.map

package/dist/src/output/debug-log.js.map

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

package/dist/src/output/equivalent-command.d.ts

@@ -0,0 +1,9 @@
+export type ShellKind = 'posix' | 'powershell';
+export interface EquivalentCommandDisplay {
+    kind: ShellKind | 'argv';
+    label: 'POSIX shell 命令' | 'PowerShell 命令' | '参数列表';
+    text: string;
+    replayable: boolean;
+}
+export declare function renderShellCommand(tokens: readonly string[], shell: ShellKind): string;
+export declare function renderEquivalentCommandDisplays(tokens: readonly string[], platform?: NodeJS.Platform): EquivalentCommandDisplay[];

package/dist/src/output/equivalent-command.js

@@ -0,0 +1,39 @@
+function quotePosixToken(value) {
+    return /^[A-Za-z0-9_./:@+-]+$/.test(value)
+        ? value
+        : `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function quotePowerShellToken(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+export function renderShellCommand(tokens, shell) {
+    if (shell === 'powershell') {
+        return `& ${tokens.map(quotePowerShellToken).join(' ')}`;
+    }
+    return tokens.map(quotePosixToken).join(' ');
+}
+export function renderEquivalentCommandDisplays(tokens, platform = process.platform) {
+    if (platform === 'win32') {
+        return [
+            {
+                kind: 'powershell',
+                label: 'PowerShell 命令',
+                text: renderShellCommand(tokens, 'powershell'),
+                replayable: true,
+            },
+            {
+                kind: 'argv',
+                label: '参数列表',
+                text: JSON.stringify(tokens),
+                replayable: false,
+            },
+        ];
+    }
+    return [{
+            kind: 'posix',
+            label: 'POSIX shell 命令',
+            text: renderShellCommand(tokens, 'posix'),
+            replayable: true,
+        }];
+}
+//# sourceMappingURL=equivalent-command.js.map

package/dist/src/output/equivalent-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equivalent-command.js","sourceRoot":"","sources":["../../../src/output/equivalent-command.ts"],"names":[],"mappings":"AASA,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC;QACxC,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAyB,EAAE,KAAgB;IAC5E,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAC3B,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAAyB,EACzB,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO;YACL;gBACE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC;gBAC9C,UAAU,EAAE,IAAI;aACjB;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAC5B,UAAU,EAAE,KAAK;aAClB;SACF,CAAC;IACJ,CAAC;IACD,OAAO,CAAC;YACN,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,gBAAgB;YACvB,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC;YACzC,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/output/model.d.ts

@@ -0,0 +1,76 @@
+import type { CommandAction, PlatformName, RebuildActionEvent as SharedRebuildActionEvent, RebuildActionEventData as SharedRebuildActionEventData, Scope } from '../types.js';
+export type OutputLevel = 'success' | 'info' | 'notice' | 'warning' | 'debug';
+export type OutputTarget = 'stdout' | 'stderr' | 'debugLog';
+export type NativeEventPhase = 'start' | 'success' | 'error';
+export interface NativeMarketplaceEventData {
+    platform: PlatformName;
+    scope: Scope;
+    plugin: string;
+    marketplaceName: string;
+    marketplacePath: string;
+    operation: 'add' | 'list' | 'remove' | 'verify';
+    phase: NativeEventPhase;
+    errorCategory?: string;
+    suggestion?: string;
+}
+export interface NativeRpcEventData {
+    platform: PlatformName;
+    scope: Scope;
+    plugin: string;
+    pluginId: string;
+    method: 'plugin/install' | 'plugin/uninstall' | 'codex plugin add' | 'codex plugin remove';
+    phase: NativeEventPhase;
+    durationMs: number;
+    nativeWriteSucceeded?: boolean;
+    errorCategory?: string;
+    suggestion?: string;
+}
+export interface NativePostCheckEventData {
+    platform: PlatformName;
+    scope: Scope;
+    plugin: string;
+    pluginId: string;
+    operation: 'install' | 'uninstall';
+    phase: NativeEventPhase;
+    pluginEnabled: boolean | null;
+    configEntryPresent: boolean | null;
+    pluginInstalled: boolean | null;
+    activeCachePath: string | null;
+    errorCategory?: string;
+    suggestion?: string;
+}
+export type RebuildActionEventData = SharedRebuildActionEventData;
+export type RebuildActionEvent = SharedRebuildActionEvent;
+export type CommandEventType = 'native:marketplace' | 'native:rpc' | 'native:post-check' | string;
+export type CommandEventData = Record<string, unknown> | RebuildActionEventData | NativeMarketplaceEventData | NativeRpcEventData | NativePostCheckEventData;
+export interface CommandOutputSource {
+    platform?: PlatformName;
+    plugin?: string;
+    scope?: Scope;
+    action?: CommandAction | string;
+}
+export interface CommandEvent {
+    type: CommandEventType;
+    commandName?: string;
+    message?: string;
+    data?: CommandEventData;
+    source?: CommandOutputSource;
+    level?: OutputLevel;
+    target?: OutputTarget;
+}
+export interface CommandNotice {
+    level: OutputLevel;
+    message: string;
+    identity?: string;
+    target?: OutputTarget;
+    source?: CommandOutputSource;
+}
+export interface CommandReporter {
+    event: (event: CommandEvent) => void | Promise<void>;
+    notice: (notice: CommandNotice) => void | Promise<void>;
+}
+export interface DebugLogger {
+    readonly logFile?: string;
+    log: (event: CommandEvent) => void | Promise<void>;
+    flush?: () => void | Promise<void>;
+}

package/dist/src/output/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/src/output/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/output/model.ts"],"names":[],"mappings":""}

package/dist/src/output/rebuild-progress.d.ts

@@ -0,0 +1,21 @@
+import type { CommandEvent, CommandNotice } from './model.js';
+export declare function projectTuiNotice(notice: CommandNotice): string;
+export interface RebuildProgressCurrent {
+    target: string;
+    phase: string;
+}
+export interface RebuildProgressSnapshot {
+    current?: RebuildProgressCurrent;
+    messages: string[];
+    startedAtMs?: number;
+    elapsedMs?: number;
+}
+export interface RebuildProgressFeed {
+    addEvent: (event: CommandEvent) => void;
+    addNotice: (notice: CommandNotice) => void;
+    setCurrent: (current: RebuildProgressCurrent, message?: string) => void;
+    clearCurrent: () => void;
+    get: () => RebuildProgressSnapshot;
+    subscribe: (listener: (snapshot: RebuildProgressSnapshot) => void) => () => void;
+}
+export declare function createRebuildProgressFeed(limit?: number): RebuildProgressFeed;