@archpilotlabs/archpilot 0.2.2 → 0.2.4

package/dist/core/src/validationSuppressions.js

@@ -0,0 +1,231 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSuppressionPathMatch = isSuppressionPathMatch;
+exports.findMatchingSuppression = findMatchingSuppression;
+exports.readValidationSuppressions = readValidationSuppressions;
+exports.getSuppressionsFilePathLabel = getSuppressionsFilePathLabel;
+exports.getSuppressionScopeLabel = getSuppressionScopeLabel;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const suppressionsRelativePath = '.archpilot/suppressions.json';
+function normalizePath(value) {
+    let normalized = value.replace(/\\/g, '/').trim();
+    while (normalized.startsWith('./')) {
+        normalized = normalized.slice(2);
+    }
+    return normalized;
+}
+function toDeterministicSuppressionConfigError(message) {
+    return {
+        id: 'AP-ARCH-009',
+        severity: 'error',
+        passed: false,
+        message,
+    };
+}
+function escapeRegex(value) {
+    return value.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+}
+function globToRegex(pattern) {
+    let expression = '^';
+    for (let index = 0; index < pattern.length; index += 1) {
+        const char = pattern[index];
+        const nextChar = index + 1 < pattern.length ? pattern[index + 1] : '';
+        if (char === '*' && nextChar === '*') {
+            expression += '.*';
+            index += 1;
+            continue;
+        }
+        if (char === '*') {
+            expression += '[^/]*';
+            continue;
+        }
+        expression += escapeRegex(char);
+    }
+    expression += '$';
+    return new RegExp(expression, 'u');
+}
+function isSuppressionPathMatch(pattern, findingPath) {
+    const normalizedPattern = normalizePath(pattern);
+    const normalizedFindingPath = normalizePath(findingPath);
+    if (!normalizedPattern || !normalizedFindingPath) {
+        return false;
+    }
+    if (!normalizedPattern.includes('*')) {
+        return normalizedPattern === normalizedFindingPath;
+    }
+    if (normalizedPattern.endsWith('/**')) {
+        const prefix = normalizedPattern.slice(0, -3);
+        return (normalizedFindingPath === prefix ||
+            normalizedFindingPath.startsWith(`${prefix}/`));
+    }
+    return globToRegex(normalizedPattern).test(normalizedFindingPath);
+}
+function findMatchingSuppression(ruleId, findingPath, suppressions) {
+    for (const suppression of suppressions) {
+        if (suppression.ruleId !== ruleId) {
+            continue;
+        }
+        if (!suppression.scope) {
+            return suppression;
+        }
+        if (findingPath && isSuppressionPathMatch(suppression.scope, findingPath)) {
+            return suppression;
+        }
+    }
+    return undefined;
+}
+async function readValidationSuppressions(workspaceRoot, knownRuleIds) {
+    const suppressionsPath = path.join(workspaceRoot, '.archpilot', 'suppressions.json');
+    let contents;
+    try {
+        contents = await node_fs_1.promises.readFile(suppressionsPath, { encoding: 'utf8' });
+    }
+    catch {
+        return {
+            suppressions: [],
+            ignored: [],
+            configResults: [],
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch {
+        return {
+            suppressions: [],
+            ignored: [],
+            configResults: [
+                toDeterministicSuppressionConfigError('ArchPilot suppression configuration is invalid JSON. Please fix .archpilot/suppressions.json.'),
+            ],
+        };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return {
+            suppressions: [],
+            ignored: [],
+            configResults: [
+                toDeterministicSuppressionConfigError('ArchPilot suppression configuration is invalid: .archpilot/suppressions.json must be a JSON object with a suppressions array.'),
+            ],
+        };
+    }
+    if (!Array.isArray(parsed.suppressions)) {
+        return {
+            suppressions: [],
+            ignored: [],
+            configResults: [
+                toDeterministicSuppressionConfigError('ArchPilot suppression configuration is invalid: .archpilot/suppressions.json must define a suppressions array.'),
+            ],
+        };
+    }
+    const suppressions = [];
+    const ignored = [];
+    for (let index = 0; index < parsed.suppressions.length; index += 1) {
+        const rawEntry = parsed.suppressions[index];
+        if (!rawEntry || typeof rawEntry !== 'object' || Array.isArray(rawEntry)) {
+            ignored.push({
+                index,
+                reason: 'Suppression entry must be an object.',
+            });
+            continue;
+        }
+        const ruleId = typeof rawEntry.ruleId === 'string' ? rawEntry.ruleId : undefined;
+        const entryScopeValue = typeof rawEntry.scope === 'string'
+            ? rawEntry.scope
+            : typeof rawEntry.path === 'string'
+                ? rawEntry.path
+                : undefined;
+        const reason = typeof rawEntry.reason === 'string' ? rawEntry.reason.trim() : undefined;
+        const expiresOn = typeof rawEntry.expiresOn === 'string' ? rawEntry.expiresOn.trim() : undefined;
+        if (!ruleId) {
+            ignored.push({
+                index,
+                scope: entryScopeValue,
+                reason: 'Suppression entry is missing ruleId.',
+                ...(expiresOn ? { expiresOn } : {}),
+            });
+            continue;
+        }
+        if (!knownRuleIds.has(ruleId)) {
+            ignored.push({
+                index,
+                ruleId,
+                ...(entryScopeValue ? { scope: normalizePath(entryScopeValue) } : {}),
+                reason: 'Unknown rule ID. Entry was ignored.',
+                ...(expiresOn ? { expiresOn } : {}),
+            });
+            continue;
+        }
+        suppressions.push({
+            index,
+            ruleId: ruleId,
+            ...(entryScopeValue ? { scope: normalizePath(entryScopeValue) } : {}),
+            ...(reason ? { reason } : {}),
+            ...(expiresOn ? { expiresOn } : {}),
+        });
+    }
+    return {
+        suppressions: suppressions.sort((left, right) => {
+            const ruleCompare = left.ruleId.localeCompare(right.ruleId);
+            if (ruleCompare !== 0) {
+                return ruleCompare;
+            }
+            const scopeCompare = (left.scope ?? '').localeCompare(right.scope ?? '');
+            if (scopeCompare !== 0) {
+                return scopeCompare;
+            }
+            const reasonCompare = (left.reason ?? '').localeCompare(right.reason ?? '');
+            if (reasonCompare !== 0) {
+                return reasonCompare;
+            }
+            const expiryCompare = (left.expiresOn ?? '').localeCompare(right.expiresOn ?? '');
+            if (expiryCompare !== 0) {
+                return expiryCompare;
+            }
+            return left.index - right.index;
+        }),
+        ignored: ignored.sort((left, right) => left.index - right.index),
+        configResults: [],
+    };
+}
+function getSuppressionsFilePathLabel() {
+    return suppressionsRelativePath;
+}
+function getSuppressionScopeLabel(entry) {
+    return entry.scope ?? '(rule-wide)';
+}
+//# sourceMappingURL=validationSuppressions.js.map

package/dist/core/src/validationSuppressions.js.map

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

package/dist/core/src/validationTypeScriptAstCache.js

@@ -0,0 +1,82 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createValidationTypeScriptAstCache = createValidationTypeScriptAstCache;
+const path = __importStar(require("node:path"));
+const ts = __importStar(require("typescript"));
+function normalizeAbsolutePath(value) {
+    const resolved = path.resolve(value);
+    return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+}
+function createValidationTypeScriptAstCache(options) {
+    const createSourceFile = options?.createSourceFile ?? ts.createSourceFile;
+    const now = options?.now ?? (() => Date.now());
+    const astCache = new Map();
+    const stats = {
+        cacheHits: 0,
+        cacheMisses: 0,
+        physicalParses: 0,
+        entries: 0,
+        parseTimeMs: 0,
+    };
+    const buildParserKey = (request) => JSON.stringify({
+        filePath: normalizeAbsolutePath(request.filePath),
+        scriptTarget: request.scriptTarget,
+        scriptKind: request.scriptKind ?? null,
+        setParentNodes: request.setParentNodes,
+    });
+    return {
+        parseSourceFile(request) {
+            const key = buildParserKey(request);
+            const compatibleEntries = astCache.get(key) ?? [];
+            const cached = compatibleEntries.find((entry) => entry.sourceText === request.sourceText);
+            if (cached) {
+                stats.cacheHits += 1;
+                return cached.sourceFile;
+            }
+            stats.cacheMisses += 1;
+            stats.physicalParses += 1;
+            const started = now();
+            const sourceFile = createSourceFile(request.filePath, request.sourceText, request.scriptTarget, request.setParentNodes, request.scriptKind);
+            stats.parseTimeMs += Math.max(0, now() - started);
+            compatibleEntries.push({ sourceText: request.sourceText, sourceFile });
+            astCache.set(key, compatibleEntries);
+            stats.entries += 1;
+            return sourceFile;
+        },
+        getStats: () => ({ ...stats }),
+    };
+}
+//# sourceMappingURL=validationTypeScriptAstCache.js.map

package/dist/core/src/validationTypeScriptAstCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationTypeScriptAstCache.js","sourceRoot":"","sources":["../../../../core/src/validationTypeScriptAstCache.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,gFAkDC;AAnFD,gDAAkC;AAClC,+CAAiC;AA2BjC,SAAS,qBAAqB,CAAC,KAAa;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzE,CAAC;AAED,SAAgB,kCAAkC,CAAC,OAGlD;IACA,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,EAAE,CAAC,gBAAgB,CAAC;IAC1E,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoE,CAAC;IAC7F,MAAM,KAAK,GAAsC;QAChD,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;KACd,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,OAAkC,EAAU,EAAE,CACrE,IAAI,CAAC,SAAS,CAAC;QACd,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC;QACjD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,cAAc,EAAE,OAAO,CAAC,cAAc;KACtC,CAAC,CAAC;IAEJ,OAAO;QACN,eAAe,CAAC,OAAO;YACtB,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1F,IAAI,MAAM,EAAE,CAAC;gBACZ,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;gBACrB,OAAO,MAAM,CAAC,UAAU,CAAC;YAC1B,CAAC;YACD,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;YACvB,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,gBAAgB,CAClC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,UAAU,CAClB,CAAC;YACF,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;YAClD,iBAAiB,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;YACvE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YACrC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YACnB,OAAO,UAAU,CAAC;QACnB,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;KAC9B,CAAC;AACH,CAAC"}

package/dist/core/src/validationWorkflow.js

@@ -0,0 +1,222 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStandardValidationWorkflowForWorkspace = runStandardValidationWorkflowForWorkspace;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const architectureValidation_1 = require("./architectureValidation");
+const remediationEngine_1 = require("./remediation/remediationEngine");
+const architectureReviewReporter_1 = require("./reporting/architectureReviewReporter");
+const discoverAdrs_1 = require("./discoverAdrs");
+const impactAnalysisEngine_1 = require("./impactAnalysisEngine");
+const riskPolicyConfig_1 = require("./policy/riskPolicyConfig");
+const config_1 = require("./config");
+const safetyControlsDetection_1 = require("./reporting/safetyControlsDetection");
+const architectureGovernanceBaseline_1 = require("./architectureGovernanceBaseline");
+const riskPolicyEnforcement_1 = require("./policy/riskPolicyEnforcement");
+const adrRequirementStatus_1 = require("./adrRequirementStatus");
+const architecturePrCommentReporter_1 = require("./reporting/architecturePrCommentReporter");
+const operationalLogging_1 = require("./operationalLogging");
+const governanceGitMetadata_1 = require("./governance/governanceGitMetadata");
+const architectureReportArtifacts_1 = require("./reporting/architectureReportArtifacts");
+function applyCanonicalValidationSummary(reviewSummary, validationSummary) {
+    reviewSummary.healthScore = validationSummary.healthScore;
+    reviewSummary.categoryScores = validationSummary.categoryScores;
+    reviewSummary.readinessScore = validationSummary.readinessScore;
+    reviewSummary.readinessCategoryScores = validationSummary.readinessCategoryScores;
+    reviewSummary.setupGaps = validationSummary.setupGaps;
+    reviewSummary.guidanceFindings = validationSummary.guidanceFindings;
+    reviewSummary.qualityFindings = validationSummary.qualityFindings;
+}
+function buildEnforcementResult(risk, policyConfig, policyConfigSource, baselineComparison, policyConfigError) {
+    const enforcementFromPolicy = (0, riskPolicyEnforcement_1.evaluateRiskPolicy)(risk, policyConfig, {
+        thresholdSource: policyConfigSource === 'policy-file'
+            ? 'policy-file'
+            : policyConfigSource === 'fallback-default'
+                ? 'fallback-default'
+                : 'default',
+        ...(baselineComparison ? { baselineStatus: baselineComparison.status } : {}),
+    });
+    if (policyConfigSource === 'default' && !policyConfigError) {
+        return {
+            ...enforcementFromPolicy,
+            reasons: [
+                'No local .archpilot/policy.json found. Using deterministic default policy configuration.',
+                ...enforcementFromPolicy.reasons,
+            ],
+        };
+    }
+    if (!policyConfigError) {
+        return enforcementFromPolicy;
+    }
+    return {
+        ...enforcementFromPolicy,
+        action: 'fail',
+        policyLevel: 'fail',
+        enforcementDecision: 'FAIL',
+        ciExitBehavior: {
+            blocking: true,
+            exitCode: 1,
+            reason: 'Policy configuration is invalid; enforcement falls back to blocking FAIL.',
+        },
+        reasons: [policyConfigError, ...enforcementFromPolicy.reasons],
+        requiredActions: [
+            'Fix .archpilot/policy.json to restore deterministic policy enforcement.',
+            ...(enforcementFromPolicy.requiredActions ?? []),
+        ],
+    };
+}
+function buildAdrRequirementResult(reviewSummary, validationResults, workspaceRoot) {
+    return (0, adrRequirementStatus_1.evaluateAdrRequirementStatus)(reviewSummary.enforcement, reviewSummary.risk, validationResults, workspaceRoot);
+}
+async function runStandardValidationWorkflowForWorkspace(input) {
+    const phase = async (label, run) => {
+        const started = Date.now();
+        (0, operationalLogging_1.emitOperationalMessage)(input.onOperationalMessage, 'info', `${label}...`);
+        try {
+            return await run();
+        }
+        finally {
+            (0, operationalLogging_1.emitOperationalMessage)(input.onOperationalMessage, 'info', `${label} completed in ${Date.now() - started}ms.`);
+        }
+    };
+    (0, operationalLogging_1.emitOperationalMessage)(input.onOperationalMessage, 'info', 'Starting shared validation workflow.');
+    const runResult = await phase('Running core architecture validation', () => (0, architectureValidation_1.runArchitectureValidationForWorkspace)(input.workspaceRoot, {
+        openReportInEditor: input.openReportInEditor,
+        onOperationalMessage: input.onOperationalMessage,
+    }));
+    const remediation = await phase('Building remediation suggestions', async () => ({
+        fixSuggestions: (0, remediationEngine_1.buildFixSuggestions)(runResult.results),
+        appliedFixes: [],
+        remainingViolationsCount: runResult.results.filter((result) => !result.passed).length,
+    }));
+    const impactAnalysis = await phase('Generating impact analysis', async () => (0, impactAnalysisEngine_1.analyzeImpact)({
+        graph: {
+            modules: runResult.status.dependencyGraphSummary.modules
+                .map((moduleSummary) => moduleSummary.module)
+                .sort((left, right) => left.localeCompare(right)),
+            edges: runResult.status.dependencyGraphSummary.modules.flatMap((moduleSummary) => (moduleSummary.actualDependencies.length > 0
+                ? moduleSummary.actualDependencies
+                : moduleSummary.declaredDependencies).map((target) => ({
+                source: moduleSummary.module,
+                target,
+            }))),
+        },
+    }));
+    const [riskPolicyLoad, discoveredAdrs, projectIdentityLoad, gitMetadata] = await phase('Loading report inputs', () => Promise.all([
+        (0, riskPolicyConfig_1.readRiskPolicyConfig)(input.workspaceRoot),
+        (0, discoverAdrs_1.discoverAdrs)(input.workspaceRoot),
+        (0, config_1.readProjectIdentity)(input.workspaceRoot),
+        (0, governanceGitMetadata_1.resolveGovernanceGitMetadata)(input.workspaceRoot),
+    ]));
+    const reviewSummary = (0, architectureReviewReporter_1.buildArchitectureReviewSummary)({
+        projectName: runResult.config.projectName,
+        results: runResult.results,
+        suppressedResults: runResult.status.suppressedResults,
+        ignoredSuppressionsCount: runResult.status.summary.ignoredSuppressions,
+        changeSignals: {
+            diffContextAvailable: false,
+            impactAnalysis,
+        },
+    });
+    const governanceBaseline = await phase('Loading governance baseline', () => (0, architectureGovernanceBaseline_1.readGovernanceBaseline)(input.workspaceRoot));
+    const baselineComparison = (0, architectureGovernanceBaseline_1.compareWithGovernanceBaseline)(reviewSummary, governanceBaseline);
+    reviewSummary.enforcement = buildEnforcementResult(reviewSummary.risk, riskPolicyLoad.config, riskPolicyLoad.source, baselineComparison, riskPolicyLoad.configError);
+    reviewSummary.adrRequirement = buildAdrRequirementResult(reviewSummary, runResult.results, input.workspaceRoot);
+    reviewSummary.safetyControls = await phase('Checking deployment safety controls', () => (0, safetyControlsDetection_1.detectMissingSafetyControls)({
+        workspaceRoot: input.workspaceRoot,
+        context: reviewSummary,
+    }));
+    reviewSummary.baselineComparison = baselineComparison;
+    applyCanonicalValidationSummary(reviewSummary, runResult.status.summary);
+    let baselineComparisonPath;
+    try {
+        baselineComparisonPath = await (0, architectureGovernanceBaseline_1.writeBaselineComparisonReport)(input.workspaceRoot, baselineComparison);
+    }
+    catch {
+        baselineComparisonPath = undefined;
+    }
+    const reportArtifacts = await phase('Generating review and governance artifacts', () => (0, architectureReportArtifacts_1.writeArchitectureReportArtifacts)({
+        workspaceRoot: input.workspaceRoot,
+        reviewSummary,
+        remediation,
+        discoveredAdrs,
+        suppressionSummary: runResult.status.suppressionSummary,
+        healthTrend: runResult.status.summary.healthTrend,
+        projectIdentity: projectIdentityLoad.identity
+            ? {
+                repositoryId: projectIdentityLoad.identity.repositoryId,
+                ...(projectIdentityLoad.identity.organizationId
+                    ? { organizationId: projectIdentityLoad.identity.organizationId }
+                    : {}),
+                ...(projectIdentityLoad.identity.team
+                    ? { team: projectIdentityLoad.identity.team }
+                    : {}),
+                ...(projectIdentityLoad.identity.system
+                    ? { system: projectIdentityLoad.identity.system }
+                    : {}),
+            }
+            : undefined,
+        dependencyGraphSummary: runResult.status.dependencyGraphSummary,
+        driftDetected: runResult.status.drift.detected,
+        commitSha: gitMetadata.commitSha,
+    }));
+    const impactAnalysisPath = path.join(input.workspaceRoot, '.archpilot', 'impact-analysis.json');
+    await phase('Writing impact analysis artifact', async () => {
+        await node_fs_1.promises.mkdir(path.dirname(impactAnalysisPath), { recursive: true });
+        await node_fs_1.promises.writeFile(impactAnalysisPath, `${JSON.stringify(reviewSummary.impactAnalysis, null, 2)}\n`, { encoding: 'utf8' });
+    });
+    let prCommentPath;
+    if (input.ciMode) {
+        const prCommentMarkdown = (0, architecturePrCommentReporter_1.renderArchitecturePrCommentMarkdown)({
+            summary: reviewSummary,
+            healthTrend: runResult.status.summary.healthTrend,
+            driftComparison: runResult.status.driftComparison,
+        });
+        prCommentPath = await (0, architecturePrCommentReporter_1.writeArchitecturePrCommentMarkdown)(input.workspaceRoot, prCommentMarkdown);
+    }
+    (0, operationalLogging_1.emitOperationalMessage)(input.onOperationalMessage, 'info', 'Validation workflow finished and canonical validation/review artifacts were refreshed.');
+    return {
+        runResult,
+        reviewSummary,
+        remediation,
+        reportArtifacts,
+        impactAnalysisPath,
+        baselineComparison,
+        ...(baselineComparisonPath ? { baselineComparisonPath } : {}),
+        ...(prCommentPath ? { prCommentPath } : {}),
+    };
+}
+//# sourceMappingURL=validationWorkflow.js.map

package/dist/core/src/validationWorkflow.js.map

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

package/dist/core/src/workspaceRoot.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findArchpilotWorkspaceRoot = findArchpilotWorkspaceRoot;
+exports.requireArchpilotWorkspaceRoot = requireArchpilotWorkspaceRoot;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const initializationState_1 = require("./initializationState");
+function hasArchitectureMarker(directoryPath) {
+    return fs.existsSync((0, initializationState_1.getArchitectureConfigPath)(directoryPath));
+}
+function findArchpilotWorkspaceRoot(startDir) {
+    let currentDirectory = path.resolve(startDir ?? process.cwd());
+    while (true) {
+        if (hasArchitectureMarker(currentDirectory)) {
+            return currentDirectory;
+        }
+        const parentDirectory = path.dirname(currentDirectory);
+        if (parentDirectory === currentDirectory) {
+            return undefined;
+        }
+        currentDirectory = parentDirectory;
+    }
+}
+function requireArchpilotWorkspaceRoot(startDir) {
+    const resolvedStartDir = path.resolve(startDir ?? process.cwd());
+    const workspaceRoot = findArchpilotWorkspaceRoot(resolvedStartDir);
+    if (workspaceRoot) {
+        return workspaceRoot;
+    }
+    throw new Error((0, initializationState_1.renderInitializationBlockedMessage)({
+        kind: 'not_initialized',
+        configPath: (0, initializationState_1.getArchitectureConfigPath)(resolvedStartDir),
+    }));
+}
+//# sourceMappingURL=workspaceRoot.js.map

package/dist/core/src/workspaceRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceRoot.js","sourceRoot":"","sources":["../../../../core/src/workspaceRoot.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,gEAcC;AAED,sEAaC;AAxCD,4CAA8B;AAC9B,gDAAkC;AAClC,+DAG+B;AAE/B,SAAS,qBAAqB,CAAC,aAAqB;IACnD,OAAO,EAAE,CAAC,UAAU,CAAC,IAAA,+CAAyB,EAAC,aAAa,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,0BAA0B,CAAC,QAAiB;IAC3D,IAAI,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE/D,OAAO,IAAI,EAAE,CAAC;QACb,IAAI,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC7C,OAAO,gBAAgB,CAAC;QACzB,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACvD,IAAI,eAAe,KAAK,gBAAgB,EAAE,CAAC;YAC1C,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,gBAAgB,GAAG,eAAe,CAAC;IACpC,CAAC;AACF,CAAC;AAED,SAAgB,6BAA6B,CAAC,QAAiB;IAC9D,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;IACnE,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,KAAK,CACd,IAAA,wDAAkC,EAAC;QAClC,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,IAAA,+CAAyB,EAAC,gBAAgB,CAAC;KACvD,CAAC,CACF,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archpilotlabs/archpilot",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Executable architecture governance CLI for Smart Init, validation, drift detection, and CI.",
   "homepage": "https://archpilot.org",
   "bugs": {
@@ -12,7 +12,8 @@
   },
   "main": "./dist/archpilot-cli.js",
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "architecture",