@hongmaple0820/scale-engine 0.19.0 → 0.20.0

package/dist/governance/ProgressiveGovernance.js

@@ -0,0 +1,159 @@
+const MODE_ORDER = ['minimal', 'standard', 'expanded', 'critical'];
+export function normalizeGovernanceMode(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === 'minimal' || normalized === 'standard' || normalized === 'expanded' || normalized === 'critical')
+        return normalized;
+    throw new Error(`Invalid governance mode "${String(value)}"; expected minimal, standard, expanded, or critical.`);
+}
+export function evaluateProgressiveGovernance(input = {}) {
+    const task = input.task ?? '';
+    const changedFiles = (input.changedFiles ?? []).map(normalizePath).filter(Boolean);
+    const signals = detectSignals(task, changedFiles);
+    const recommendedMode = highestMode(signals.map(signal => signal.mode), changedFiles.length > 0 || task ? 'standard' : 'minimal');
+    const requestedMode = input.requestedMode;
+    const effectiveMode = highestMode([recommendedMode, requestedMode].filter(Boolean), recommendedMode);
+    return {
+        requestedMode,
+        recommendedMode,
+        effectiveMode,
+        escalated: Boolean(requestedMode && modeRank(recommendedMode) > modeRank(requestedMode)),
+        signals,
+        requiredBehaviors: requiredBehaviors(effectiveMode, signals),
+    };
+}
+function detectSignals(task, changedFiles) {
+    const haystack = `${task} ${changedFiles.join(' ')}`.toLowerCase();
+    const signals = [];
+    if (changedFiles.length === 0 && !task.trim()) {
+        signals.push({
+            id: 'no-task-context',
+            mode: 'minimal',
+            reason: 'No task text or changed files were provided.',
+            evidence: [],
+        });
+        return signals;
+    }
+    const lowRiskDocsOnly = isDocsOnly(changedFiles) && !/api|auth|security|release|deploy|database|migration|permission/.test(haystack);
+    if (lowRiskDocsOnly) {
+        signals.push({
+            id: 'docs-only-low-risk',
+            mode: 'minimal',
+            reason: 'Only low-risk documentation files were provided.',
+            evidence: changedFiles,
+        });
+    }
+    if (!lowRiskDocsOnly && (changedFiles.length > 0 || task.trim())) {
+        signals.push({
+            id: 'normal-engineering-work',
+            mode: 'standard',
+            reason: 'Task has implementation or verification context.',
+            evidence: changedFiles.slice(0, 8),
+        });
+    }
+    if (changedFiles.length >= 6 || topLevelCount(changedFiles) >= 3) {
+        signals.push({
+            id: 'cross-module-scope',
+            mode: 'expanded',
+            reason: 'Changed files span enough paths to require broader impact analysis.',
+            evidence: changedFiles.slice(0, 12),
+        });
+    }
+    if (/ui|ux|frontend|browser|e2e|playwright|desktop|cua|screenshot|visual/.test(haystack)) {
+        signals.push({
+            id: 'interactive-or-visual-flow',
+            mode: 'expanded',
+            reason: 'Task touches UI, browser, E2E, desktop, or visual verification.',
+            evidence: matchingEvidence(changedFiles, /ui|frontend|browser|e2e|playwright|desktop|visual/i),
+        });
+    }
+    if (/public api|new api|contract|schema|sdk|breaking/.test(haystack)) {
+        signals.push({
+            id: 'public-interface-change',
+            mode: 'expanded',
+            reason: 'Task mentions public API, contract, schema, SDK, or breaking behavior.',
+            evidence: matchingEvidence(changedFiles, /api|contract|schema|sdk/i),
+        });
+    }
+    if (/auth|permission|secret|token|password|private key|database|migration|production|deploy|release|destructive|delete|drop table|truncate/.test(haystack)) {
+        signals.push({
+            id: 'critical-risk-domain',
+            mode: 'critical',
+            reason: 'Task touches auth, permissions, secrets, database, production, release, or destructive operations.',
+            evidence: matchingEvidence(changedFiles, /auth|permission|secret|token|database|migration|config|deploy|release|delete/i),
+        });
+    }
+    if (changedFiles.some(file => /\.(env|pem|key|crt)$/i.test(file) || /(^|\/)(migration|migrations|schema|auth|permission|config|deploy|release)(\/|\.|-|_)/i.test(file))) {
+        signals.push({
+            id: 'critical-file-path',
+            mode: 'critical',
+            reason: 'Changed file paths include critical config, auth, schema, migration, or secret-like files.',
+            evidence: matchingEvidence(changedFiles, /\.(env|pem|key|crt)$/i),
+        });
+    }
+    if (changedFiles.some(file => /\.(html|png|jpg|jpeg|gif|mp4|mov|zip|tar|gz)$/i.test(file) || /docs\/worklog|tmp|report|screenshot|artifact/i.test(file))) {
+        signals.push({
+            id: 'resource-lifecycle',
+            mode: 'standard',
+            reason: 'Generated reports, media, temporary files, or task artifacts require resource governance.',
+            evidence: matchingEvidence(changedFiles, /\.(html|png|jpg|jpeg|gif|mp4|mov|zip|tar|gz)$/i),
+        });
+    }
+    return dedupeSignals(signals);
+}
+function requiredBehaviors(mode, signals) {
+    const behaviors = new Set();
+    if (mode === 'minimal') {
+        behaviors.add('run relevant validation only');
+        return Array.from(behaviors);
+    }
+    behaviors.add('record verification evidence');
+    behaviors.add('summarize context budget');
+    if (mode === 'expanded' || mode === 'critical') {
+        behaviors.add('attempt code intelligence or explain fallback');
+        behaviors.add('run skill radar when tool, browser, UI, or external CLI signals apply');
+    }
+    if (mode === 'critical') {
+        behaviors.add('run security review');
+        behaviors.add('record rollback or disable strategy');
+        behaviors.add('require human review for destructive, data, auth, or production changes');
+    }
+    if (signals.some(signal => signal.id === 'resource-lifecycle')) {
+        behaviors.add('settle resource lifecycle');
+    }
+    if (signals.some(signal => signal.id === 'interactive-or-visual-flow')) {
+        behaviors.add('collect browser, screenshot, or visual evidence');
+    }
+    return Array.from(behaviors);
+}
+function highestMode(modes, fallback) {
+    if (modes.length === 0)
+        return fallback;
+    return modes.reduce((current, next) => modeRank(next) > modeRank(current) ? next : current, modes[0]);
+}
+function modeRank(mode) {
+    return mode ? MODE_ORDER.indexOf(mode) : -1;
+}
+function isDocsOnly(files) {
+    return files.length > 0 && files.every(file => /\.(md|mdx|txt)$/i.test(file) && /^(readme|docs\/|changelog|license)/i.test(file));
+}
+function topLevelCount(files) {
+    return new Set(files.map(file => file.split('/')[0]).filter(Boolean)).size;
+}
+function matchingEvidence(files, pattern) {
+    return files.filter(file => pattern.test(file)).slice(0, 12);
+}
+function dedupeSignals(signals) {
+    const seen = new Set();
+    return signals.filter(signal => {
+        if (seen.has(signal.id))
+            return false;
+        seen.add(signal.id);
+        return true;
+    });
+}
+function normalizePath(path) {
+    return path.replace(/\\/g, '/').trim();
+}
+//# sourceMappingURL=ProgressiveGovernance.js.map

package/dist/governance/ProgressiveGovernance.js.map

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

package/dist/memory/MemoryBrain.d.ts

@@ -0,0 +1,135 @@
+export type MemoryNodeType = 'fact' | 'decision' | 'incident' | 'relation' | 'contradiction';
+export type MemoryNodeSource = 'runtime-evidence' | 'task-artifact' | 'docs' | 'git' | 'manual';
+export type MemoryNodeScope = 'project' | 'workspace' | 'global-candidate';
+export type MemoryNodeStatus = 'candidate' | 'active' | 'stale' | 'rejected';
+export interface MemoryNode {
+    id: string;
+    type: MemoryNodeType;
+    title: string;
+    summary: string;
+    entities: string[];
+    source: MemoryNodeSource;
+    evidencePaths: string[];
+    confidence: number;
+    scope: MemoryNodeScope;
+    status: MemoryNodeStatus;
+    createdAt: string;
+    updatedAt: string;
+    lastVerifiedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoryBrainOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    dbPath?: string;
+    now?: () => Date;
+}
+export interface MemoryIngestOptions {
+    from: 'evidence' | 'candidate' | 'failure';
+    taskId?: string;
+    sessionId?: string;
+    candidateId?: string;
+    failureId?: string;
+    type?: MemoryNodeType;
+    scope?: MemoryNodeScope;
+}
+export interface MemoryIngestReport {
+    ok: boolean;
+    source: MemoryIngestOptions['from'];
+    created: number;
+    skipped: number;
+    nodes: MemoryNode[];
+    warnings: string[];
+}
+export interface MemoryQueryReport {
+    query: string;
+    count: number;
+    nodes: MemoryNode[];
+}
+export interface MemoryContradiction {
+    id: string;
+    title: string;
+    summary: string;
+    nodeIds: string[];
+    entities: string[];
+    evidencePaths: string[];
+    confidence: number;
+}
+export interface MemoryContradictionReport {
+    ok: boolean;
+    count: number;
+    contradictions: MemoryContradiction[];
+}
+export interface MemoryDreamReport {
+    ok: boolean;
+    generatedAt: string;
+    summary: {
+        total: number;
+        active: number;
+        candidate: number;
+        stale: number;
+        missingEvidence: number;
+        duplicateGroups: number;
+        contradictions: number;
+    };
+    promotionCandidates: Array<{
+        id: string;
+        title: string;
+        confidence: number;
+        evidencePaths: string[];
+    }>;
+    staleCandidates: Array<{
+        id: string;
+        title: string;
+        reason: string;
+    }>;
+    duplicateGroups: Array<{
+        fingerprint: string;
+        nodeIds: string[];
+        title: string;
+    }>;
+    contradictions: MemoryContradiction[];
+    suggestedDocs: string[];
+}
+export interface MemoryPromoteReport {
+    ok: boolean;
+    node?: MemoryNode;
+    warnings: string[];
+}
+export declare class MemoryBrain {
+    private projectDir;
+    private scaleRoot;
+    private dbPath;
+    private db;
+    private now;
+    constructor(options?: MemoryBrainOptions);
+    addNode(input: Partial<MemoryNode> & Pick<MemoryNode, 'type' | 'title' | 'summary' | 'source'>): MemoryNode;
+    ingest(options: MemoryIngestOptions): MemoryIngestReport;
+    query(query: string, options?: {
+        limit?: number;
+        status?: MemoryNodeStatus;
+    }): MemoryQueryReport;
+    contradictions(): MemoryContradictionReport;
+    dream(): MemoryDreamReport;
+    promote(id: string, options?: {
+        scope?: MemoryNodeScope;
+    }): MemoryPromoteReport;
+    exportJsonl(): string;
+    importJsonl(filePath: string): {
+        ok: boolean;
+        imported: number;
+        skipped: number;
+        warnings: string[];
+    };
+    list(filter?: {
+        status?: MemoryNodeStatus;
+        scope?: MemoryNodeScope;
+    }): MemoryNode[];
+    get(id: string): MemoryNode | null;
+    private ingestEvidence;
+    private ingestCandidate;
+    private ingestFailureReplay;
+    private readLearningCandidate;
+    private upsert;
+    private writeManifest;
+}