@hongmaple0820/med-scale-research-os 0.43.0

package/dist/workflow/ContextGovernance.js

@@ -0,0 +1,233 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, normalize } from 'node:path';
+const CONTEXT_CANDIDATES = ['CONTEXT.md', 'docs/CONTEXT.md'];
+const CONTEXT_MAP_CANDIDATES = ['CONTEXT-MAP.md', 'docs/CONTEXT-MAP.md'];
+export function analyzeContextGovernance(input) {
+    const projectDir = input.projectDir;
+    const contextPath = firstExisting(projectDir, CONTEXT_CANDIDATES);
+    const contextMapPath = firstExisting(projectDir, CONTEXT_MAP_CANDIDATES);
+    const findings = [];
+    const terms = contextPath ? parseContextTerms(readFileSync(contextPath, 'utf-8')) : [];
+    const contextMap = contextMapPath ? parseContextMap(readFileSync(contextMapPath, 'utf-8')) : new Map();
+    const moduleDocs = resolveModuleDocs(projectDir, input.changedFiles ?? [], contextMap);
+    if (!contextPath) {
+        findings.push({
+            code: 'missing-context-doc',
+            severity: 'error',
+            message: 'Missing CONTEXT.md. Domain language, aliases, and rejected meanings are not durable.',
+        });
+    }
+    if (!contextMapPath) {
+        findings.push({
+            code: 'missing-context-map',
+            severity: 'error',
+            message: 'Missing CONTEXT-MAP.md. Module ownership and product/architecture document links are not durable.',
+        });
+    }
+    for (const doc of moduleDocs) {
+        if (!doc.productDocExists || !doc.architectureDocExists) {
+            findings.push({
+                code: 'missing-module-doc',
+                severity: 'error',
+                path: doc.moduleName,
+                message: `Module ${doc.moduleName} is touched but product or architecture docs are missing.`,
+            });
+        }
+    }
+    const questions = buildContextQuestions(input.request, findings, moduleDocs);
+    const requiredArtifacts = unique([
+        !contextPath ? 'CONTEXT.md' : undefined,
+        !contextMapPath ? 'CONTEXT-MAP.md' : undefined,
+        ...moduleDocs.flatMap(doc => [
+            doc.productDocExists ? undefined : doc.productDocPath,
+            doc.architectureDocExists ? undefined : doc.architectureDocPath,
+        ]),
+    ].filter(Boolean));
+    return {
+        ok: !findings.some(finding => finding.severity === 'error'),
+        projectDir,
+        request: input.request,
+        contextPath,
+        contextMapPath,
+        terms,
+        moduleDocs,
+        findings,
+        questions,
+        requiredArtifacts,
+    };
+}
+export function renderContextGrillPrompt(report) {
+    const lines = [];
+    lines.push('# Context Grill');
+    lines.push('');
+    lines.push(`Request: ${report.request}`);
+    lines.push(`Status: ${report.ok ? 'ready' : 'blocked'}`);
+    lines.push('');
+    lines.push('## Evidence');
+    lines.push(`- CONTEXT.md: ${report.contextPath ?? 'missing'}`);
+    lines.push(`- CONTEXT-MAP.md: ${report.contextMapPath ?? 'missing'}`);
+    if (report.terms.length > 0)
+        lines.push(`- Terms: ${report.terms.join(', ')}`);
+    for (const finding of report.findings) {
+        lines.push(`- [${finding.severity.toUpperCase()}] ${finding.code}: ${finding.message}`);
+    }
+    lines.push('');
+    lines.push('## Questions');
+    for (const question of report.questions) {
+        const marker = question.blocking ? 'BLOCKING' : 'CHECK';
+        lines.push(`- [${marker}] ${question.question}`);
+        lines.push(`  Reason: ${question.reason}`);
+    }
+    return lines.join('\n');
+}
+export function writeContextGovernanceTemplates(input) {
+    const projectName = input.projectName ?? 'Project';
+    const files = new Map([
+        ['CONTEXT.md', contextTemplate(projectName)],
+        ['docs/CONTEXT-MAP.md', contextMapTemplate(projectName)],
+    ]);
+    const created = [];
+    const skipped = [];
+    for (const [relativePath, content] of files) {
+        const filePath = join(input.projectDir, relativePath);
+        if (existsSync(filePath) && !input.force) {
+            skipped.push(filePath);
+            continue;
+        }
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, content, 'utf-8');
+        created.push(filePath);
+    }
+    return { created, skipped };
+}
+function firstExisting(projectDir, candidates) {
+    return candidates.map(candidate => join(projectDir, candidate)).find(path => existsSync(path));
+}
+function parseContextTerms(content) {
+    const terms = [];
+    for (const line of content.split(/\r?\n/)) {
+        if (!line.trim().startsWith('|'))
+            continue;
+        if (/\|\s*Term\s*\|/i.test(line) || /^\|\s*-+/.test(line.trim()))
+            continue;
+        const parts = line.split('|').map(part => part.trim()).filter(Boolean);
+        if (parts.length >= 2 && parts[0] !== '---')
+            terms.push(parts[0]);
+    }
+    return unique(terms);
+}
+function parseContextMap(content) {
+    const map = new Map();
+    for (const line of content.split(/\r?\n/)) {
+        if (!line.trim().startsWith('|'))
+            continue;
+        if (/\|\s*Module\s*\|/i.test(line) || /^\|\s*-+/.test(line.trim()))
+            continue;
+        const parts = line.split('|').map(part => part.trim()).filter(Boolean);
+        if (parts.length < 4 || parts[0] === '---')
+            continue;
+        map.set(parts[0], {
+            moduleName: parts[0],
+            productDocPath: parts[2],
+            architectureDocPath: parts[3],
+        });
+    }
+    return map;
+}
+function resolveModuleDocs(projectDir, changedFiles, contextMap) {
+    const modules = unique(changedFiles.map(inferModuleName).filter(Boolean));
+    return modules.map(moduleName => {
+        const mapped = contextMap.get(moduleName);
+        const productDocPath = mapped?.productDocPath ?? `docs/modules/${moduleName}/product.md`;
+        const architectureDocPath = mapped?.architectureDocPath ?? `docs/modules/${moduleName}/architecture.md`;
+        return {
+            moduleName,
+            productDocPath,
+            architectureDocPath,
+            productDocExists: existsSync(join(projectDir, productDocPath)),
+            architectureDocExists: existsSync(join(projectDir, architectureDocPath)),
+        };
+    });
+}
+function inferModuleName(filePath) {
+    const normalized = normalize(filePath).replace(/\\/g, '/');
+    const parts = normalized.split('/').filter(Boolean);
+    const roots = new Set(['src', 'app', 'lib', 'services', 'packages', 'modules']);
+    if (parts.length >= 2 && roots.has(parts[0]))
+        return parts[1];
+    return parts[0];
+}
+function buildContextQuestions(request, findings, moduleDocs) {
+    const questions = [];
+    if (findings.some(finding => finding.code === 'missing-context-doc')) {
+        questions.push({
+            id: 'context-domain-language',
+            topic: 'domain-language',
+            question: 'Which domain terms, aliases, and forbidden meanings must be captured before implementation?',
+            reason: 'Without a project glossary, agents can invent inconsistent product language.',
+            blocking: true,
+        });
+    }
+    if (findings.some(finding => finding.code === 'missing-context-map' || finding.code === 'missing-module-doc')) {
+        questions.push({
+            id: 'context-module-boundary',
+            topic: 'module-boundary',
+            question: `Which module owns ${moduleDocs.map(doc => doc.moduleName).join(', ') || 'this change'}, and which product/architecture docs must be updated?`,
+            reason: 'Module ownership and document links prevent stale specs and cross-module conflicts.',
+            blocking: true,
+        });
+    }
+    if (/\btenant|auth|permission|security|token|quota|delete|payment|migration\b/i.test(request)) {
+        questions.push({
+            id: 'context-risk-boundary',
+            topic: 'risk-and-rollback',
+            question: 'What tenant/user isolation, authorization, rollback, and audit evidence is required?',
+            reason: 'The request touches a security or data-boundary concern.',
+            blocking: true,
+        });
+    }
+    questions.push({
+        id: 'context-acceptance-evidence',
+        topic: 'acceptance-evidence',
+        question: 'Which command output, test report, screenshot, or product artifact will prove this is done?',
+        reason: 'Completion claims must be tied to durable evidence.',
+        blocking: false,
+    });
+    return questions;
+}
+function contextTemplate(projectName) {
+    return [
+        '# CONTEXT.md',
+        '',
+        `Project: ${projectName}`,
+        '',
+        '| Term | Definition | Examples | Aliases | Source |',
+        '|------|------------|----------|---------|--------|',
+        '| User | Person or service account using the product | login user | account | product |',
+        '',
+        '## Rejected Meanings',
+        '',
+        '- Record terms that agents must not reinterpret.',
+        '',
+    ].join('\n');
+}
+function contextMapTemplate(projectName) {
+    return [
+        '# CONTEXT-MAP.md',
+        '',
+        `Project: ${projectName}`,
+        '',
+        '| Module | Owner | Product Doc | Architecture Doc |',
+        '| --- | --- | --- | --- |',
+        '| example | team | docs/modules/example/product.md | docs/modules/example/architecture.md |',
+        '',
+        '## Cross-Module Rules',
+        '',
+        '- Record ownership, upstream/downstream dependencies, and document update triggers here.',
+        '',
+    ].join('\n');
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+//# sourceMappingURL=ContextGovernance.js.map

package/dist/workflow/ContextGovernance.js.map

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

package/dist/workflow/CrossRepoOrchestrator.d.ts

@@ -0,0 +1,92 @@
+export type RepoChangeStatus = 'planned' | 'in-progress' | 'ready' | 'merged' | 'shipped';
+export interface CrossRepoChange {
+    repoName: string;
+    branch: string;
+    files: string[];
+    commitShas: string[];
+    dependsOn: string[];
+    description: string;
+    status: RepoChangeStatus;
+    startedAt: string;
+    mergedAt?: string;
+    shippedAt?: string;
+}
+export interface CrossRepoBranch {
+    name: string;
+    repos: string[];
+    createdAt: string;
+    createdBy: string;
+}
+export interface CrossRepoMergePlan {
+    changes: CrossRepoChange[];
+    mergeOrder: string[];
+    testOrder: string[];
+    deployOrder: string[];
+    blockers: string[];
+}
+export interface CrossRepoMergeStep {
+    repoName: string;
+    action: 'merge' | 'test' | 'tag' | 'push' | 'deploy';
+    status: 'pending' | 'passed' | 'failed' | 'skipped';
+    duration: number;
+    error?: string;
+    evidence?: string;
+}
+export interface CrossRepoShipResult {
+    success: boolean;
+    steps: CrossRepoMergeStep[];
+    totalDuration: number;
+    warnings: string[];
+}
+export interface CrossRepoStatus {
+    topology: string;
+    managedBranches: CrossRepoBranch[];
+    activeChanges: CrossRepoChange[];
+    repoStates: Array<{
+        name: string;
+        path: string;
+        branch: string;
+        clean: boolean;
+        ahead: number;
+        behind: number;
+    }>;
+    recommendations: string[];
+}
+export interface CrossRepoOrchestratorInput {
+    projectDir?: string;
+    scaleDir?: string;
+}
+export declare class CrossRepoOrchestrator {
+    private projectDir;
+    private scaleRoot;
+    private stateDir;
+    private statePath;
+    private branches;
+    private changes;
+    private repositories;
+    constructor(input?: CrossRepoOrchestratorInput);
+    createCoordinatedBranch(branchName: string, repoNames: string[], options?: {
+        createdBy?: string;
+        fromBranch?: string;
+    }): CrossRepoBranch;
+    deleteCoordinatedBranch(branchName: string): void;
+    getManagedBranches(): CrossRepoBranch[];
+    registerChange(change: Omit<CrossRepoChange, 'status' | 'startedAt'>): CrossRepoChange;
+    updateChangeStatus(repoName: string, branch: string, status: RepoChangeStatus): void;
+    buildMergePlan(branchName: string): CrossRepoMergePlan;
+    shipCoordinated(branchName: string, options?: {
+        remote?: string;
+        baseBranch?: string;
+        dryRun?: boolean;
+        skipRepos?: string[];
+    }): Promise<CrossRepoShipResult>;
+    getCrossRepoStatus(): CrossRepoStatus;
+    private loadTopology;
+    private loadState;
+    private saveState;
+    private resolveMergeOrder;
+    private execGit;
+    private getRepoGitState;
+    private buildRecommendations;
+}
+export declare function summarizeCrossRepoStatus(status: CrossRepoStatus): string;