@hongmaple0820/med-scale-research-os 0.43.0

package/dist/workflow/TaskScoreEngine.js

@@ -0,0 +1,181 @@
+import { isAbsolute, resolve } from 'node:path';
+import { inspectCodeIntelligence } from '../codegraph/CodeIntelligence.js';
+import { inspectMemoryProviders } from '../memory/MemoryProviders.js';
+import { collectGovernanceRoi } from './GovernanceRoi.js';
+import { doctorEngineeringStandards } from './EngineeringStandards.js';
+import { EvidenceStore } from './EvidenceStore.js';
+import { createGateStatusReport } from './GateCatalog.js';
+export function createTaskScoreReport(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const scaleDir = resolveScaleRoot(projectDir, options.scaleDir);
+    const level = options.level ?? 'M';
+    const changedFiles = uniquePaths(options.changedFiles ?? []);
+    const gateEvidence = new EvidenceStore(scaleDir).listGateResults(50);
+    const standards = doctorEngineeringStandards({
+        projectDir,
+        scaleDir,
+        changedFiles: changedFiles.length > 0 ? changedFiles : undefined,
+    });
+    const governanceRoi = collectGovernanceRoi({ projectDir, scaleDir });
+    const codeIntelligence = inspectCodeIntelligence({ projectDir, scaleDir });
+    const memory = inspectMemoryProviders({ projectDir, scaleDir });
+    const gateStatus = createGateStatusReport({ projectDir, scaleDir });
+    const dimensions = [
+        verificationDimension(gateEvidence),
+        architectureDimension(standards.ok, standards.findings),
+        evidenceDimension(gateEvidence),
+        contextDimension(codeIntelligence.availableProviderCount, codeIntelligence.projectIndexExists, memory.availableProviderCount),
+        efficiencyDimension(governanceRoi),
+        riskDimension(level, standards.findings, gateStatus.summary.blockingExtensions),
+    ];
+    const totalScore = clampScore(dimensions.reduce((sum, dimension) => sum + dimension.score, 0));
+    const blockers = dimensions
+        .filter(dimension => dimension.status === 'fail')
+        .flatMap(dimension => dimension.evidence.map(item => `${dimension.name}: ${item}`));
+    const recommendations = uniqueStrings(dimensions.flatMap(dimension => dimension.recommendations));
+    const grade = gradeForScore(totalScore, blockers.length > 0);
+    return {
+        projectDir,
+        scaleDir,
+        generatedAt: new Date().toISOString(),
+        taskId: options.taskId,
+        level,
+        totalScore,
+        maxScore: 100,
+        grade,
+        passed: blockers.length === 0 && totalScore >= thresholdForLevel(level),
+        dimensions,
+        blockers,
+        recommendations,
+        inputs: {
+            changedFiles,
+            recentGateEvidence: gateEvidence.length,
+        },
+        references: {
+            governanceRoi,
+            gateStatus: {
+                summary: gateStatus.summary,
+                verificationProfile: gateStatus.verificationProfile,
+                policy: gateStatus.policy,
+                extensions: gateStatus.extensions,
+                warnings: gateStatus.warnings,
+            },
+        },
+    };
+}
+function verificationDimension(records) {
+    if (records.length === 0) {
+        return dimension('verification', 'Verification', 0, 30, 'fail', ['No persisted gate evidence was found.'], ['Run the required preflight or task verification gates before scoring.']);
+    }
+    const passed = records.filter(record => record.passed).length;
+    const passRate = passed / records.length;
+    const score = Math.round(passRate * 30);
+    return dimension('verification', 'Verification', score, 30, passRate >= 0.9 ? 'pass' : passRate >= 0.7 ? 'warn' : 'fail', [`${passed}/${records.length} recent gate records passed.`], passRate < 0.9 ? ['Fix failed gates and rerun verification before release.'] : []);
+}
+function architectureDimension(ok, findings) {
+    const blocking = findings.filter(finding => finding.severity === 'fail');
+    const warnings = findings.filter(finding => finding.severity === 'warn');
+    if (blocking.length > 0) {
+        return dimension('architecture', 'Architecture standards', 0, 20, 'fail', [`${blocking.length} blocking standards finding(s).`], ['Fix blocking architecture or engineering standards findings.']);
+    }
+    const score = ok && warnings.length === 0 ? 20 : Math.max(10, 20 - Math.min(10, warnings.length));
+    return dimension('architecture', 'Architecture standards', score, 20, warnings.length === 0 ? 'pass' : 'warn', warnings.length === 0 ? ['Standards doctor passed.'] : [`${warnings.length} advisory standards finding(s).`], warnings.length > 0 ? ['Review advisory standards findings before hardening the gate.'] : []);
+}
+function evidenceDimension(records) {
+    const withEvidence = records.filter(record => record.evidenceItems.length > 0 || record.evidence.trim().length > 0).length;
+    const ratio = records.length > 0 ? withEvidence / records.length : 0;
+    const score = Math.round(ratio * 15);
+    return dimension('evidence', 'Evidence completeness', score, 15, ratio >= 0.9 ? 'pass' : ratio >= 0.5 ? 'warn' : 'fail', records.length > 0 ? [`${withEvidence}/${records.length} gate records include evidence.`] : ['No evidence records found.'], ratio < 0.9 ? ['Persist command and gate evidence instead of relying on narrative claims.'] : []);
+}
+function contextDimension(codeProviders, codeIndexExists, memoryProviders) {
+    let score = 0;
+    const evidence = [];
+    if (codeProviders > 0) {
+        score += 4;
+        evidence.push(`${codeProviders} code intelligence provider(s) available.`);
+    }
+    else {
+        evidence.push('No code intelligence provider is available.');
+    }
+    if (codeIndexExists) {
+        score += 3;
+        evidence.push('Project code index exists.');
+    }
+    else {
+        evidence.push('Project code index is missing.');
+    }
+    if (memoryProviders > 0) {
+        score += 3;
+        evidence.push(`${memoryProviders} memory provider(s) available.`);
+    }
+    else {
+        evidence.push('No memory provider is available.');
+    }
+    return dimension('context', 'Context and memory use', score, 10, score >= 8 ? 'pass' : score >= 3 ? 'warn' : 'fail', evidence, score < 8 ? ['Initialize CodeGraph and memory providers so deterministic recall can reduce model context.'] : []);
+}
+function efficiencyDimension(roi) {
+    const savings = roi.cost.contextCompilerSavings + roi.cost.cacheHitSavings;
+    const hasSavings = savings > 0;
+    const hasUsage = roi.cost.totalTokensUsed > 0;
+    const score = hasSavings ? 10 : hasUsage ? 5 : 4;
+    return dimension('efficiency', 'Cost efficiency', score, 10, hasSavings ? 'pass' : 'warn', [
+        `Governance ROI score is ${roi.roi.overallScore}/100.`,
+        `Recorded context/cache savings: ${savings}.`,
+    ], hasSavings ? [] : ['Record model usage and cache savings to prove token reduction instead of estimating it.']);
+}
+function riskDimension(level, findings, blockingExtensions) {
+    const blockingFindings = findings.filter(finding => finding.severity === 'fail').length;
+    const highRiskLevel = level === 'L' || level === 'CRITICAL';
+    const score = blockingFindings > 0
+        ? 0
+        : highRiskLevel && blockingExtensions === 0
+            ? 5
+            : 15;
+    return dimension('risk', 'Risk control', score, 15, score >= 12 ? 'pass' : score >= 5 ? 'warn' : 'fail', [
+        `Task level: ${level}.`,
+        `${blockingExtensions} blocking extension gate(s) configured.`,
+        `${blockingFindings} blocking standards finding(s).`,
+    ], score < 12 ? ['Use stricter gate profiles for L/CRITICAL work and resolve blocking standards findings.'] : []);
+}
+function dimension(id, name, score, maxScore, status, evidence, recommendations) {
+    return {
+        id,
+        name,
+        score: Math.max(0, Math.min(maxScore, score)),
+        maxScore,
+        status,
+        evidence,
+        recommendations,
+    };
+}
+function thresholdForLevel(level) {
+    if (level === 'CRITICAL')
+        return 90;
+    if (level === 'L')
+        return 85;
+    if (level === 'M')
+        return 75;
+    return 65;
+}
+function gradeForScore(score, blocked) {
+    if (blocked)
+        return 'blocked';
+    if (score >= 90)
+        return 'excellent';
+    if (score >= 75)
+        return 'good';
+    return 'needs-work';
+}
+function clampScore(score) {
+    return Math.max(0, Math.min(100, Math.round(score)));
+}
+function resolveScaleRoot(projectDir, scaleDir = '.scale') {
+    return isAbsolute(scaleDir) ? scaleDir : resolve(projectDir, scaleDir);
+}
+function uniquePaths(paths) {
+    return uniqueStrings(paths.map(path => path.replace(/\\/g, '/').trim()).filter(Boolean));
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values));
+}
+//# sourceMappingURL=TaskScoreEngine.js.map

package/dist/workflow/TaskScoreEngine.js.map

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

package/dist/workflow/TddLoop.d.ts

@@ -0,0 +1,49 @@
+/** Hephaestus mode: build with quality gates at every step */
+export declare const HEPHAESTUS_MODE = true;
+export interface TddCommandEvidence {
+    command: string;
+    exitCode: number;
+    outputSummary: string;
+}
+export interface TddSliceInput {
+    taskId: string;
+    behavior: string;
+    publicInterface: string;
+    failingTestCommand: string;
+    testFile: string;
+    implementationFiles: string[];
+    redEvidence?: TddCommandEvidence;
+    greenEvidence?: TddCommandEvidence;
+    refactorEvidence?: TddCommandEvidence;
+}
+export interface TddSlice {
+    taskId: string;
+    behavior: string;
+    publicInterface: string;
+    testFile: string;
+    implementationFiles: string[];
+    red: {
+        command: string;
+        expected: 'non-zero-before-implementation';
+    };
+    green: {
+        command: string;
+        expected: 'zero-after-minimal-implementation';
+    };
+    refactor: {
+        command: string;
+        expected: 'zero-after-cleanup';
+    };
+    redEvidence?: TddCommandEvidence;
+    greenEvidence?: TddCommandEvidence;
+    refactorEvidence?: TddCommandEvidence;
+}
+export interface TddSliceEvaluation {
+    readyForImplementation: boolean;
+    readyForCompletion: boolean;
+    blockers: string[];
+    warnings: string[];
+}
+export declare function createTddSlice(input: TddSliceInput): TddSlice;
+export declare function evaluateTddSlice(slice: TddSlice): TddSliceEvaluation;
+export declare function renderTddSliceMarkdown(slice: TddSlice): string;

package/dist/workflow/TddLoop.js

@@ -0,0 +1,78 @@
+/** Hephaestus mode: build with quality gates at every step */
+export const HEPHAESTUS_MODE = true;
+export function createTddSlice(input) {
+    return {
+        taskId: input.taskId,
+        behavior: input.behavior,
+        publicInterface: input.publicInterface,
+        testFile: input.testFile,
+        implementationFiles: input.implementationFiles,
+        red: {
+            command: input.failingTestCommand,
+            expected: 'non-zero-before-implementation',
+        },
+        green: {
+            command: input.failingTestCommand,
+            expected: 'zero-after-minimal-implementation',
+        },
+        refactor: {
+            command: input.failingTestCommand,
+            expected: 'zero-after-cleanup',
+        },
+        redEvidence: input.redEvidence,
+        greenEvidence: input.greenEvidence,
+        refactorEvidence: input.refactorEvidence,
+    };
+}
+export function evaluateTddSlice(slice) {
+    const blockers = [];
+    const warnings = [];
+    if (!slice.publicInterface.trim())
+        blockers.push('Missing public interface; a vertical slice must name the user-visible or callable contract.');
+    if (!slice.testFile.trim())
+        blockers.push('Missing test file; TDD requires a durable failing test location.');
+    if (slice.implementationFiles.length === 0)
+        blockers.push('Missing implementation files; scope must be explicit before editing.');
+    if (!slice.redEvidence) {
+        blockers.push('Missing RED evidence; run the failing test before implementation.');
+    }
+    else if (slice.redEvidence.exitCode === 0) {
+        blockers.push('RED evidence already passed; the test cannot prove the behavior changed.');
+    }
+    const readyForImplementation = blockers.length === 0;
+    const completionBlockers = [...blockers];
+    if (!slice.greenEvidence || slice.greenEvidence.exitCode !== 0) {
+        completionBlockers.push('Missing GREEN evidence with exit code 0.');
+    }
+    if (!slice.refactorEvidence || slice.refactorEvidence.exitCode !== 0) {
+        completionBlockers.push('Missing REFACTOR evidence with exit code 0 after cleanup.');
+    }
+    if (slice.implementationFiles.length > 5) {
+        warnings.push('The vertical slice touches more than five implementation files; consider splitting it.');
+    }
+    return {
+        readyForImplementation,
+        readyForCompletion: completionBlockers.length === 0,
+        blockers,
+        warnings,
+    };
+}
+export function renderTddSliceMarkdown(slice) {
+    const lines = [];
+    lines.push(`# TDD Vertical Slice: ${slice.taskId}`);
+    lines.push('');
+    lines.push(`Behavior: ${slice.behavior}`);
+    lines.push(`Public interface: ${slice.publicInterface}`);
+    lines.push(`Test file: ${slice.testFile}`);
+    lines.push('');
+    lines.push('## Vertical Slice');
+    lines.push(`- RED: ${slice.red.command} -> ${slice.red.expected}`);
+    lines.push(`- GREEN: ${slice.green.command} -> ${slice.green.expected}`);
+    lines.push(`- REFACTOR: ${slice.refactor.command} -> ${slice.refactor.expected}`);
+    lines.push('');
+    lines.push('## Scope');
+    for (const file of slice.implementationFiles)
+        lines.push(`- ${file}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=TddLoop.js.map

package/dist/workflow/TddLoop.js.map

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

package/dist/workflow/UpgradeManager.d.ts

@@ -0,0 +1,178 @@
+import { type ToolCapabilityCategory } from '../tools/ToolCapabilityRegistry.js';
+import { type AiOsDoctorReport } from '../runtime/AiOsRuntime.js';
+import { type GovernanceDriftReport } from './GovernanceLock.js';
+import { type GovernancePackId } from './GovernanceTemplatePacks.js';
+export type UpgradeStatus = 'missing-lock' | 'clean' | 'updates-available' | 'local-changes';
+export type UpgradeApplyMode = 'safe' | 'manual-review';
+export type UpgradeRisk = 'low' | 'medium' | 'high';
+export type ThirdPartyTrust = 'trusted' | 'community' | 'high-risk';
+export type ThirdPartyUpdatePolicy = 'check-only' | 'manual-review' | 'blocked';
+export interface UpgradeManagerOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    targetScaleVersion?: string;
+}
+export interface UpgradeApplyOptions extends UpgradeManagerOptions {
+    confirm?: boolean;
+}
+export interface UpgradeCheckReport {
+    version: 1;
+    projectDir: string;
+    status: UpgradeStatus;
+    scaleEngine: {
+        currentVersion: string | null;
+        latestVersion: string;
+        upToDate: boolean;
+    };
+    governanceLock: {
+        exists: boolean;
+        path: string;
+    };
+    governancePack: {
+        id: GovernancePackId | null;
+        currentVersion: number | null;
+        latestVersion: number | null;
+        upToDate: boolean;
+    };
+    generatedFiles: {
+        total: number;
+        clean: number;
+        changed: number;
+        missing: number;
+    };
+    drift: GovernanceDriftReport;
+    thirdParty: ThirdPartyUpdateReport;
+    aiOsRuntime: AiOsDoctorReport;
+    recommendedCommands: string[];
+}
+export interface ThirdPartyUpdateReport {
+    version: 1;
+    policy: 'check-only';
+    summary: {
+        total: number;
+        trusted: number;
+        community: number;
+        highRisk: number;
+        reviewRequired: number;
+        blocked: number;
+    };
+    reviewRequired: number;
+    entries: ThirdPartyUpdateEntry[];
+}
+export interface ThirdPartyUpdateEntry {
+    id: string;
+    name: string;
+    category: ToolCapabilityCategory;
+    source?: string;
+    trust: ThirdPartyTrust;
+    updatePolicy: ThirdPartyUpdatePolicy;
+    installPolicy: 'never-auto-install';
+    latestVersion: 'unknown';
+    reason: string;
+}
+export interface UpgradePlanReport {
+    version: 1;
+    projectDir: string;
+    status: UpgradeStatus;
+    applyMode: UpgradeApplyMode;
+    blockers: UpgradePlanBlocker[];
+    steps: UpgradePlanStep[];
+    check: UpgradeCheckReport;
+    recommendedCommands: string[];
+}
+export interface UpgradePlanBlocker {
+    code: 'missing-governance-lock' | 'local-generated-file-changed';
+    path?: string;
+    message: string;
+}
+export interface UpgradePlanStep {
+    action: 'initialize-governance-lock' | 'upgrade-scale-engine' | 'upgrade-governance-pack' | 'refresh-managed-generated-files' | 'restore-missing-generated-file' | 'review-local-change' | 'review-third-party-capability' | 'adopt-ai-os-runtime' | 'migrate-ai-os-runtime' | 'check-ai-os-runtime' | 'run-preflight' | 'deprecation-warning';
+    path?: string;
+    risk: UpgradeRisk;
+    reason: string;
+    command?: string;
+}
+export interface DeprecationWarning {
+    feature: string;
+    deprecatedSince: string;
+    removedIn: string;
+    replacement: string;
+    message: string;
+}
+export declare const DEPRECATION_REGISTRY: DeprecationWarning[];
+export interface UpgradeBackupManifest {
+    version: 1;
+    id: string;
+    createdAt: string;
+    projectDir: string;
+    files: UpgradeBackupEntry[];
+}
+export interface UpgradeBackupEntry {
+    path: string;
+    existed: boolean;
+    backupPath?: string;
+}
+export interface UpgradeApplyReport {
+    version: 1;
+    projectDir: string;
+    ok: boolean;
+    applied: boolean;
+    reason: string;
+    changedFiles: string[];
+    backup?: {
+        id: string;
+        dir: string;
+        manifestPath: string;
+    };
+    plan: UpgradePlanReport;
+}
+export interface UpgradeRollbackReport {
+    version: 1;
+    projectDir: string;
+    ok: boolean;
+    applied: boolean;
+    reason: string;
+    backup?: {
+        id: string;
+        dir: string;
+        manifestPath: string;
+    };
+    restoredFiles: string[];
+}
+export declare function createUpgradeCheckReport(options?: UpgradeManagerOptions): UpgradeCheckReport;
+export type UpgradeDiffStatus = 'changed' | 'missing' | 'clean';
+export interface UpgradeDiffFileEntry {
+    path: string;
+    status: UpgradeDiffStatus;
+    /** Best-effort line-level diff (template expected vs local actual) for changed files. */
+    diff?: string;
+}
+export interface UpgradeDiffReport {
+    version: 1;
+    projectDir: string;
+    lockExists: boolean;
+    pack: GovernancePackId | null;
+    entries: UpgradeDiffFileEntry[];
+    summary: {
+        changed: number;
+        missing: number;
+        clean: number;
+    };
+}
+/**
+ * Compute the local-vs-SCALE-template diff for managed governance files.
+ * Status (changed/missing/clean) is taken from the authoritative governance
+ * lock; the textual diff is a best-effort hint derived from the template pack.
+ */
+export declare function createUpgradeDiffReport(options?: UpgradeManagerOptions): UpgradeDiffReport;
+export declare function createUpgradePlanReport(options?: UpgradeManagerOptions): UpgradePlanReport;
+export declare function applyUpgradePlan(options?: UpgradeApplyOptions): UpgradeApplyReport;
+export declare function rollbackLatestUpgrade(options?: UpgradeManagerOptions): UpgradeRollbackReport;
+export declare function createThirdPartyUpdateReport(category?: ToolCapabilityCategory | ToolCapabilityCategory[]): ThirdPartyUpdateReport;
+export type UpgradePlanHtmlLanguage = 'zh' | 'en';
+export declare function writeUpgradePlanHtml(report: UpgradePlanReport, outputPath?: string, lang?: UpgradePlanHtmlLanguage): string;
+export declare function listAvailableGovernancePackVersions(): Array<{
+    id: GovernancePackId;
+    version: number;
+}>;
+export declare function getApplicableDeprecations(currentVersion: string | null): DeprecationWarning[];