@hongmaple0820/scale-engine 0.27.0 → 0.27.1

package/dist/runtime/AiOsRuntime.d.ts

@@ -17,6 +17,16 @@ export interface AiOsRuntimeInput {
     memoryTopK?: number;
     knowledgeBase?: Pick<IKnowledgeBase, 'recall' | 'recallByVector'>;
 }
+export type AiOsRunMode = 'dry-run' | 'guarded';
+export type AiOsRunStatus = 'ready' | 'blocked';
+export type AiOsRunStepKind = 'plan' | 'context' | 'memory' | 'skill' | 'gate' | 'evidence' | 'learning';
+export type AiOsRunStepStatus = 'passed' | 'planned' | 'blocked' | 'skipped';
+export interface AiOsRunInput extends AiOsRuntimeInput {
+    mode?: AiOsRunMode;
+    verificationCommands?: string[];
+    commandTimeoutMs?: number;
+    allowShell?: boolean;
+}
 export interface AiOsMemoryRuntimeSummary {
     providerOrder: string[];
     selectedProviders: string[];
@@ -50,4 +60,210 @@ export interface AiOsRuntimePlan {
     roi: GovernanceRoiReport;
     recommendations: string[];
 }
+export interface AiOsRunStep {
+    id: string;
+    kind: AiOsRunStepKind;
+    title: string;
+    status: AiOsRunStepStatus;
+    required: boolean;
+    summary: string;
+    evidence: string[];
+    dependsOn?: string[];
+}
+export interface AiOsRunFailureLearningCandidate {
+    id: string;
+    source: 'failed-step' | 'missing-evidence';
+    title: string;
+    summary: string;
+    recommendedAction: 'resolve-before-promotion' | 'record-evidence';
+    evidenceRefs: string[];
+    promotable: boolean;
+}
+export interface AiOsVerificationCommandReport {
+    command: string;
+    status: 'passed' | 'failed';
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    evidenceId: string;
+}
+export interface AiOsRunReport {
+    version: string;
+    generatedAt: string;
+    mode: AiOsRunMode;
+    dryRun: boolean;
+    status: AiOsRunStatus;
+    plan: AiOsRuntimePlan;
+    steps: AiOsRunStep[];
+    evidence: {
+        required: string[];
+        produced: string[];
+        pending: string[];
+    };
+    verification: {
+        commands: AiOsVerificationCommandReport[];
+        allPassed: boolean;
+    };
+    failureLearning: {
+        status: 'idle' | 'candidate-created';
+        candidates: AiOsRunFailureLearningCandidate[];
+    };
+    artifacts: {
+        runReport: string;
+    };
+    nextActions: string[];
+}
+export interface AiOsDashboardInput {
+    projectDir?: string;
+    scaleDir?: string;
+    limit?: number;
+}
+export interface AiOsDashboardRunSummary {
+    taskId?: string;
+    task: string;
+    mode: AiOsRunMode;
+    status: AiOsRunStatus;
+    generatedAt: string;
+    runReport: string;
+    verificationCommands: number;
+    failedVerificationCommands: number;
+    pendingEvidence: number;
+    failureLearningCandidates: number;
+}
+export interface AiOsDashboardReport {
+    version: string;
+    generatedAt: string;
+    runsDir: string;
+    summary: {
+        totalRuns: number;
+        readyRuns: number;
+        blockedRuns: number;
+        dryRunRuns: number;
+        guardedRuns: number;
+        verificationCommands: number;
+        failedVerificationCommands: number;
+        pendingEvidence: number;
+        failureLearningCandidates: number;
+    };
+    health: {
+        status: 'empty' | 'healthy' | 'attention' | 'blocked';
+        score: number;
+        reasons: string[];
+    };
+    latestRuns: AiOsDashboardRunSummary[];
+    recommendations: string[];
+    warnings: string[];
+}
+export interface AiOsBenchmarkInput {
+    projectDir?: string;
+    scaleDir?: string;
+    budget?: number;
+}
+export interface AiOsBenchmarkScenarioInput {
+    id: string;
+    task: string;
+    level: SkillTaskLevel;
+    files: string[];
+    services?: string[];
+    budget?: number;
+}
+export interface AiOsBenchmarkScenarioResult {
+    id: string;
+    task: string;
+    level: SkillTaskLevel;
+    governanceMode: GovernanceMode;
+    metrics: {
+        estimatedTokens: number;
+        budget: number;
+        estimatedTokenSavings: number;
+        memoryItems: number;
+        selectedProviders: string[];
+        skillSteps: number;
+        requiredSkillSteps: number;
+        gates: number;
+        roiModules: number;
+    };
+}
+export interface AiOsBenchmarkReport {
+    version: string;
+    generatedAt: string;
+    scenarios: AiOsBenchmarkScenarioResult[];
+    summary: {
+        scenarios: number;
+        totalEstimatedTokens: number;
+        totalBudget: number;
+        totalEstimatedTokenSavings: number;
+        totalMemoryItems: number;
+        totalSkillSteps: number;
+        requiredSkillSteps: number;
+        governanceModes: GovernanceMode[];
+        averageTokenUtilization: number;
+    };
+    dashboard: AiOsDashboardReport;
+    artifacts: {
+        benchmarkReport: string;
+    };
+    recommendations: string[];
+}
+export interface AiOsMigrationInput {
+    projectDir?: string;
+    scaleDir?: string;
+}
+export interface AiOsMigrationReport {
+    version: string;
+    generatedAt: string;
+    status: 'migrated' | 'compatible';
+    scaleRoot: string;
+    created: string[];
+    existing: string[];
+    files: {
+        migrationReport: string;
+    };
+    warnings: string[];
+    nextActions: string[];
+}
+export interface AiOsDoctorInput {
+    projectDir?: string;
+    scaleDir?: string;
+    benchmarkMaxAgeHours?: number;
+    lang?: 'zh' | 'en';
+}
+export type AiOsDoctorStatus = 'ready' | 'warning' | 'blocked';
+export type AiOsDoctorCheckStatus = 'passed' | 'warning' | 'blocked';
+export interface AiOsDoctorCheck {
+    id: string;
+    title: string;
+    status: AiOsDoctorCheckStatus;
+    summary: string;
+    evidence: string[];
+}
+export interface AiOsDoctorReport {
+    version: string;
+    generatedAt: string;
+    status: AiOsDoctorStatus;
+    projectDir: string;
+    scaleRoot: string;
+    dashboard: AiOsDashboardReport;
+    benchmark: {
+        status: 'missing' | 'fresh' | 'stale' | 'invalid';
+        reportPath: string;
+        generatedAt?: string;
+        ageHours?: number;
+        scenarios?: number;
+    };
+    checks: AiOsDoctorCheck[];
+    summary: {
+        totalChecks: number;
+        passedChecks: number;
+        warningChecks: number;
+        blockedChecks: number;
+    };
+    warnings: string[];
+    nextActions: string[];
+}
 export declare function createAiOsPlan(input: AiOsRuntimeInput): Promise<AiOsRuntimePlan>;
+export declare function createAiOsRun(input: AiOsRunInput): Promise<AiOsRunReport>;
+export declare function createAiOsDashboard(input?: AiOsDashboardInput): AiOsDashboardReport;
+export declare function createAiOsBenchmark(input?: AiOsBenchmarkInput): Promise<AiOsBenchmarkReport>;
+export declare function createAiOsMigration(input?: AiOsMigrationInput): AiOsMigrationReport;
+export declare function createAiOsDoctor(input?: AiOsDoctorInput): AiOsDoctorReport;