@hongmaple0820/med-scale-research-os 0.43.0

package/dist/workflow/CommitDiscipline.d.ts

@@ -0,0 +1,68 @@
+export type ViolationType = 'too-many-files' | 'too-long-since-commit' | 'task-switch-without-commit';
+export type ViolationSeverity = 'warn' | 'block';
+export interface CommitDisciplineConfig {
+    maxUncommittedFiles: number;
+    maxUncommittedFilesBlock: number;
+    maxMinutesWithoutCommit: number;
+    maxMinutesBlock: number;
+    warnOnTaskSwitch: boolean;
+    projectDir?: string;
+    scaleDir?: string;
+}
+export interface CommitViolation {
+    type: ViolationType;
+    severity: ViolationSeverity;
+    message: string;
+    count?: number;
+    threshold?: number;
+}
+export interface CommitDisciplineStatus {
+    uncommittedFiles: number;
+    stagedFiles: number;
+    unstagedFiles: number;
+    untrackedFiles: number;
+    minutesSinceLastCommit: number;
+    commitsThisSession: number;
+    avgFilesPerCommit: number;
+    violations: CommitViolation[];
+    recommendations: string[];
+}
+export interface FileGroup {
+    name: string;
+    files: string[];
+    suggestedMessage: string;
+}
+export interface CommitRecord {
+    id: string;
+    sha: string;
+    timestamp: string;
+    fileCount: number;
+    message: string;
+    files: string[];
+}
+export interface TaskSwitchResult {
+    allowed: boolean;
+    violations: CommitViolation[];
+    uncommittedCount: number;
+    suggestion: string;
+}
+export declare class CommitDiscipline {
+    private config;
+    private records;
+    private statePath;
+    private stateDir;
+    private now;
+    constructor(config?: Partial<CommitDisciplineConfig>, now?: () => Date);
+    check(): CommitDisciplineStatus;
+    suggestGroups(taskDescription?: string): FileGroup[];
+    recordCommit(sha: string, message: string, files: string[]): CommitRecord;
+    enforceBeforeTaskSwitch(taskDescription?: string): TaskSwitchResult;
+    summarize(): string;
+    getRecords(): CommitRecord[];
+    private inspectGit;
+    private getUncommittedFiles;
+    private minutesSinceLastCommit;
+    private loadState;
+    private saveState;
+}
+export declare function summarizeCommitDiscipline(status: CommitDisciplineStatus): string;

package/dist/workflow/CommitDiscipline.js

@@ -0,0 +1,328 @@
+// SCALE Engine — Commit Discipline (v0.38.0)
+// Prevents agents from accumulating uncommitted changes. Monitors git state,
+// enforces thresholds, suggests logical commit groupings, tracks commit cadence.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+const SILENT_GIT_STDIO = ['ignore', 'pipe', 'ignore'];
+// ============================================================================
+// Defaults
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxUncommittedFiles: 10,
+    maxUncommittedFilesBlock: 25,
+    maxMinutesWithoutCommit: 30,
+    maxMinutesBlock: 60,
+    warnOnTaskSwitch: true,
+};
+// Group name rules: path prefix → group name
+const GROUP_RULES = [
+    { test: f => /^src\/workflow\//.test(f), name: 'workflow', commitPrefix: 'feat(workflow)' },
+    { test: f => /^src\/memory\//.test(f), name: 'memory', commitPrefix: 'feat(memory)' },
+    { test: f => /^src\/runtime\//.test(f), name: 'runtime', commitPrefix: 'feat(runtime)' },
+    { test: f => /^src\/governance\//.test(f), name: 'governance', commitPrefix: 'feat(governance)' },
+    { test: f => /^src\/tools\//.test(f), name: 'tools', commitPrefix: 'feat(tools)' },
+    { test: f => /^src\/skills\//.test(f), name: 'skills', commitPrefix: 'feat(skills)' },
+    { test: f => /^src\//.test(f), name: 'src-other', commitPrefix: 'feat' },
+    { test: f => /^tests\/workflow\//.test(f), name: 'tests-workflow', commitPrefix: 'test(workflow)' },
+    { test: f => /^tests\//.test(f), name: 'tests', commitPrefix: 'test' },
+    { test: f => /^docs\//.test(f), name: 'docs', commitPrefix: 'docs' },
+    { test: f => /\.md$/.test(f) && !f.includes('/'), name: 'docs-root', commitPrefix: 'docs' },
+    { test: f => /^package(-lock)?\.json$/.test(f), name: 'deps', commitPrefix: 'chore(deps)' },
+    { test: f => /^\.(eslint|prettier|gitignore|npmrc)/.test(f), name: 'config', commitPrefix: 'chore(config)' },
+];
+// ============================================================================
+// CommitDiscipline
+// ============================================================================
+export class CommitDiscipline {
+    constructor(config, now) {
+        this.records = [];
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.now = now ?? (() => new Date());
+        const projectDir = this.config.projectDir ?? process.cwd();
+        const scaleRoot = this.config.scaleDir ?? '.scale';
+        this.stateDir = join(projectDir, scaleRoot, 'commit-discipline');
+        this.statePath = join(this.stateDir, 'records.json');
+        this.loadState();
+    }
+    // --------------------------------------------------------------------------
+    // Core API
+    // --------------------------------------------------------------------------
+    check() {
+        const gitState = this.inspectGit();
+        const minutes = this.minutesSinceLastCommit();
+        const violations = [];
+        const recommendations = [];
+        // File count violations
+        const total = gitState.staged + gitState.unstaged + gitState.untracked;
+        if (total >= this.config.maxUncommittedFilesBlock) {
+            violations.push({
+                type: 'too-many-files',
+                severity: 'block',
+                message: `${total} uncommitted files exceeds block threshold (${this.config.maxUncommittedFilesBlock}). Commit or stash before continuing.`,
+                count: total,
+                threshold: this.config.maxUncommittedFilesBlock,
+            });
+            recommendations.push(`Split into logical commits by module. Use 'suggestGroups()' for grouping.`);
+        }
+        else if (total >= this.config.maxUncommittedFiles) {
+            violations.push({
+                type: 'too-many-files',
+                severity: 'warn',
+                message: `${total} uncommitted files exceeds warning threshold (${this.config.maxUncommittedFiles}). Consider committing soon.`,
+                count: total,
+                threshold: this.config.maxUncommittedFiles,
+            });
+            recommendations.push(`${total} files accumulating — commit before adding more changes.`);
+        }
+        // Time violations
+        if (minutes >= this.config.maxMinutesBlock) {
+            violations.push({
+                type: 'too-long-since-commit',
+                severity: 'block',
+                message: `${Math.round(minutes)} minutes since last commit exceeds block threshold (${this.config.maxMinutesBlock} min). Commit now.`,
+                count: Math.round(minutes),
+                threshold: this.config.maxMinutesBlock,
+            });
+        }
+        else if (minutes >= this.config.maxMinutesWithoutCommit) {
+            violations.push({
+                type: 'too-long-since-commit',
+                severity: 'warn',
+                message: `${Math.round(minutes)} minutes since last commit exceeds warning threshold (${this.config.maxMinutesWithoutCommit} min).`,
+                count: Math.round(minutes),
+                threshold: this.config.maxMinutesWithoutCommit,
+            });
+        }
+        // General recommendations
+        if (gitState.staged > 0 && gitState.unstaged > 0) {
+            recommendations.push('You have both staged and unstaged changes. Consider committing staged changes first.');
+        }
+        if (gitState.untracked > 5) {
+            recommendations.push(`${gitState.untracked} untracked files. Add new files intentionally with 'git add <file>'.`);
+        }
+        const totalCommitted = this.records.reduce((s, r) => s + r.fileCount, 0);
+        const avgFiles = this.records.length > 0 ? Math.round(totalCommitted / this.records.length) : 0;
+        return {
+            uncommittedFiles: total,
+            stagedFiles: gitState.staged,
+            unstagedFiles: gitState.unstaged,
+            untrackedFiles: gitState.untracked,
+            minutesSinceLastCommit: Math.round(minutes),
+            commitsThisSession: this.records.length,
+            avgFilesPerCommit: avgFiles,
+            violations,
+            recommendations,
+        };
+    }
+    suggestGroups(taskDescription) {
+        const files = this.getUncommittedFiles();
+        if (files.length === 0)
+            return [];
+        const groupMap = new Map();
+        for (const file of files) {
+            let matched = false;
+            for (const rule of GROUP_RULES) {
+                if (rule.test(file)) {
+                    const group = groupMap.get(rule.name) ?? [];
+                    group.push(file);
+                    groupMap.set(rule.name, group);
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                const group = groupMap.get('misc') ?? [];
+                group.push(file);
+                groupMap.set('misc', group);
+            }
+        }
+        const groups = [];
+        for (const [name, groupFiles] of groupMap) {
+            const rule = GROUP_RULES.find(r => r.name === name);
+            const prefix = rule?.commitPrefix ?? 'chore';
+            const desc = taskDescription ?? 'update';
+            groups.push({
+                name,
+                files: groupFiles,
+                suggestedMessage: `${prefix}: ${desc}`,
+            });
+        }
+        return groups;
+    }
+    recordCommit(sha, message, files) {
+        const record = {
+            id: `COMMIT-${Date.now()}-${randomUUID().slice(0, 8)}`,
+            sha,
+            timestamp: this.now().toISOString(),
+            fileCount: files.length,
+            message,
+            files,
+        };
+        this.records.push(record);
+        this.saveState();
+        return record;
+    }
+    enforceBeforeTaskSwitch(taskDescription) {
+        const status = this.check();
+        const violations = [];
+        if (status.uncommittedFiles > 0 && this.config.warnOnTaskSwitch) {
+            const severity = status.uncommittedFiles >= this.config.maxUncommittedFilesBlock ? 'block' : 'warn';
+            violations.push({
+                type: 'task-switch-without-commit',
+                severity,
+                message: `Switching tasks with ${status.uncommittedFiles} uncommitted files. Commit current work first.`,
+                count: status.uncommittedFiles,
+            });
+        }
+        const allowed = !violations.some(v => v.severity === 'block');
+        const groups = this.suggestGroups(taskDescription);
+        return {
+            allowed,
+            violations: [...status.violations, ...violations],
+            uncommittedCount: status.uncommittedFiles,
+            suggestion: groups.length > 0
+                ? `Suggested commit groups: ${groups.map(g => `${g.name} (${g.files.length} files)`).join(', ')}`
+                : 'No uncommitted files.',
+        };
+    }
+    summarize() {
+        const status = this.check();
+        const lines = [
+            '## Commit Discipline Status',
+            '',
+            `**Uncommitted Files:** ${status.uncommittedFiles} (staged: ${status.stagedFiles}, unstaged: ${status.unstagedFiles}, untracked: ${status.untrackedFiles})`,
+            `**Time Since Last Commit:** ${status.minutesSinceLastCommit} min`,
+            `**Commits This Session:** ${status.commitsThisSession}`,
+            `**Avg Files Per Commit:** ${status.avgFilesPerCommit}`,
+            '',
+        ];
+        if (status.violations.length > 0) {
+            lines.push('### Violations');
+            for (const v of status.violations) {
+                const icon = v.severity === 'block' ? '[BLOCK]' : '[WARN]';
+                lines.push(`- ${icon} ${v.message}`);
+            }
+            lines.push('');
+        }
+        if (status.recommendations.length > 0) {
+            lines.push('### Recommendations');
+            for (const r of status.recommendations)
+                lines.push(`- ${r}`);
+            lines.push('');
+        }
+        const groups = this.suggestGroups();
+        if (groups.length > 1) {
+            lines.push('### Suggested Commit Groups');
+            for (const g of groups) {
+                lines.push(`- **${g.name}** (${g.files.length} files): \`${g.suggestedMessage}\``);
+                for (const f of g.files)
+                    lines.push(`  - ${f}`);
+            }
+            lines.push('');
+        }
+        if (status.violations.length === 0 && status.uncommittedFiles === 0) {
+            lines.push('No issues detected. Working tree is clean.');
+        }
+        return lines.join('\n');
+    }
+    getRecords() {
+        return [...this.records];
+    }
+    // --------------------------------------------------------------------------
+    // Git Inspection
+    // --------------------------------------------------------------------------
+    inspectGit() {
+        try {
+            const projectDir = this.config.projectDir ?? process.cwd();
+            const staged = execSync('git diff --cached --name-only', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim().split('\n').filter(Boolean).length;
+            const unstaged = execSync('git diff --name-only', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim().split('\n').filter(Boolean).length;
+            const untracked = execSync('git ls-files --others --exclude-standard', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim().split('\n').filter(Boolean).length;
+            return { staged, unstaged, untracked };
+        }
+        catch {
+            return { staged: 0, unstaged: 0, untracked: 0 };
+        }
+    }
+    getUncommittedFiles() {
+        try {
+            const projectDir = this.config.projectDir ?? process.cwd();
+            const staged = execSync('git diff --cached --name-only', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim().split('\n').filter(Boolean);
+            const unstaged = execSync('git diff --name-only', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim().split('\n').filter(Boolean);
+            const untracked = execSync('git ls-files --others --exclude-standard', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim().split('\n').filter(Boolean);
+            return [...new Set([...staged, ...unstaged, ...untracked])];
+        }
+        catch {
+            return [];
+        }
+    }
+    minutesSinceLastCommit() {
+        try {
+            const projectDir = this.config.projectDir ?? process.cwd();
+            const ts = execSync('git log -1 --format=%ct', {
+                cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+            }).trim();
+            const lastCommitEpoch = parseInt(ts, 10) * 1000;
+            return (this.now().getTime() - lastCommitEpoch) / 60000;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // State Persistence
+    // --------------------------------------------------------------------------
+    loadState() {
+        if (!existsSync(this.statePath))
+            return;
+        try {
+            const raw = JSON.parse(readFileSync(this.statePath, 'utf-8'));
+            if (Array.isArray(raw.records))
+                this.records = raw.records;
+        }
+        catch { /* ignore corrupt state */ }
+    }
+    saveState() {
+        if (!existsSync(this.stateDir))
+            mkdirSync(this.stateDir, { recursive: true });
+        writeFileSync(this.statePath, JSON.stringify({ records: this.records }, null, 2), 'utf-8');
+    }
+}
+// ============================================================================
+// Summary Formatter (standalone)
+// ============================================================================
+export function summarizeCommitDiscipline(status) {
+    const lines = [
+        '## Commit Discipline',
+        '',
+        `**Uncommitted:** ${status.uncommittedFiles} files (staged: ${status.stagedFiles}, unstaged: ${status.unstagedFiles}, untracked: ${status.untrackedFiles})`,
+        `**Last Commit:** ${status.minutesSinceLastCommit} min ago`,
+        `**Session Commits:** ${status.commitsThisSession} (avg ${status.avgFilesPerCommit} files/commit)`,
+    ];
+    if (status.violations.length > 0) {
+        lines.push('', '### Violations');
+        for (const v of status.violations) {
+            lines.push(`- ${v.severity === 'block' ? '[BLOCK]' : '[WARN]'} ${v.message}`);
+        }
+    }
+    if (status.recommendations.length > 0) {
+        lines.push('', '### Recommendations');
+        for (const r of status.recommendations)
+            lines.push(`- ${r}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=CommitDiscipline.js.map

package/dist/workflow/CommitDiscipline.js.map

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

package/dist/workflow/ContextGovernance.d.ts

@@ -0,0 +1,51 @@
+export type ContextFindingSeverity = 'error' | 'warn' | 'info';
+export type ContextQuestionTopic = 'domain-language' | 'module-boundary' | 'acceptance-evidence' | 'risk-and-rollback';
+export interface ContextFinding {
+    code: string;
+    severity: ContextFindingSeverity;
+    message: string;
+    path?: string;
+}
+export interface ContextGrillQuestion {
+    id: string;
+    topic: ContextQuestionTopic;
+    question: string;
+    reason: string;
+    blocking: boolean;
+}
+export interface ModuleDocStatus {
+    moduleName: string;
+    productDocPath: string;
+    architectureDocPath: string;
+    productDocExists: boolean;
+    architectureDocExists: boolean;
+}
+export interface ContextGovernanceReport {
+    ok: boolean;
+    projectDir: string;
+    request: string;
+    contextPath?: string;
+    contextMapPath?: string;
+    terms: string[];
+    moduleDocs: ModuleDocStatus[];
+    findings: ContextFinding[];
+    questions: ContextGrillQuestion[];
+    requiredArtifacts: string[];
+}
+export interface AnalyzeContextGovernanceInput {
+    projectDir: string;
+    request: string;
+    changedFiles?: string[];
+}
+export interface WriteContextGovernanceTemplatesInput {
+    projectDir: string;
+    projectName?: string;
+    force?: boolean;
+}
+export interface WriteContextGovernanceTemplatesResult {
+    created: string[];
+    skipped: string[];
+}
+export declare function analyzeContextGovernance(input: AnalyzeContextGovernanceInput): ContextGovernanceReport;
+export declare function renderContextGrillPrompt(report: ContextGovernanceReport): string;
+export declare function writeContextGovernanceTemplates(input: WriteContextGovernanceTemplatesInput): WriteContextGovernanceTemplatesResult;