@anarchitects/governance-core 0.0.1 → 0.0.3

package/README.md

@@ -4,7 +4,7 @@ Canonical Governance contracts, deterministic evaluation logic, and portable ext
 
 ## Overview
 
-`@anarchitects/governance-core` is the package that defines the Governance model layer for the Community-owned Governance package family. It owns the public contracts that adapters, hosts, and extensions normalize into, plus the deterministic logic that evaluates those contracts.
+`@anarchitects/governance-core` is the package that defines the Governance model layer for the Anarchitects Governance package family. It owns the public contracts that adapters, hosts, and extensions normalize into, plus the deterministic logic that evaluates those contracts.
 
 Use this package when you need:
 
@@ -39,15 +39,39 @@ The package has a single public entrypoint:
 
 ```ts
 import {
+  buildDeliveryImpactAssessment,
+  buildCognitiveLoadContext,
+  buildDriftInterpretationAnalysis,
   buildGovernanceAssessment,
+  buildGovernanceAssessmentArtifacts,
+  buildGovernancePayloadTruncationMetadata,
+  buildGovernanceConformanceSignals,
+  buildGovernanceGraphSignals,
+  buildGovernancePolicySignals,
+  buildGovernanceRecommendations,
+  buildOnboardingContext,
+  buildPersistentSmellSignals,
+  buildPrImpactContext,
+  buildRecommendationsTrendContext,
+  buildRefactoringSuggestionsContext,
   buildGovernanceWorkspace,
   buildMetricSnapshot,
+  buildScopedDriftRequest,
+  buildScopedRootCauseRequest,
+  buildScopedScorecardRequest,
+  calculateGovernanceHealth,
+  calculateGovernanceMetrics,
+  compareGovernanceViolationsForPriority,
   compareSnapshots,
   coreBuiltInRulePack,
+  evaluateGovernancePolicies,
   evaluateRulePack,
+  buildManagementInsightsAiRequest,
   normalizeGovernanceException,
   normalizeGovernanceProfile,
   registerLoadedGovernanceExtensions,
+  scopeGovernanceDependencies,
+  sliceGovernancePayloadItems,
   type GovernanceWorkspaceAdapter,
   type GovernanceWorkspace,
   type GovernanceWorkspaceAdapterResult,
@@ -62,6 +86,8 @@ The root export currently re-exports these API groups:
 - `built-in-rule-pack`
 - `built-in-rules`
 - `drift`
+- `ai-context`
+- `ai-payload`
 - `models`
 - `exceptions`
 - `profile`
@@ -90,6 +116,18 @@ Core contracts include:
 Deterministic helpers include:
 
 - `buildGovernanceAssessment(...)`
+- `buildGovernanceAssessmentArtifacts(...)`
+- `buildGovernanceWorkspace(...)`, `buildGovernanceInventory(...)`, and `buildGovernanceWorkspaceFromAdapterResult(...)`
+- `buildGovernanceGraphSignals(...)`, `buildGovernanceConformanceSignals(...)`, `buildGovernancePolicySignals(...)`, and `mergeGovernanceSignals(...)`
+- `calculateGovernanceMetrics(...)`
+- `calculateGovernanceHealth(...)`
+- `buildGovernanceRecommendations(...)`
+- `applyGovernanceExceptions(...)`, `evaluateGovernanceExceptionLifecycle(...)`, and `buildGovernanceExceptionReport(...)`
+- `buildDeliveryImpactAssessment(...)` and `summarizeDeliveryImpact(...)`
+- deterministic AI request builders and summarizers such as `buildRootCauseRequest(...)`, `buildPrImpactRequest(...)`, `buildScorecardRequest(...)`, `buildOnboardingRequest(...)`, `buildManagementInsightsAiRequest(...)`, `summarizeRootCause(...)`, `summarizePrImpact(...)`, `summarizeScorecard(...)`, `summarizeOnboarding(...)`, and `summarizeManagementInsights(...)`
+- deterministic payload-scope helpers such as `buildGovernancePayloadTruncationMetadata(...)`, `sliceGovernancePayloadItems(...)`, `scopeGovernanceDependencies(...)`, and `compareGovernanceViolationsForPriority(...)`
+- scoped AI handoff request helpers such as `buildScopedRootCauseRequest(...)`, `buildScopedDriftRequest(...)`, and `buildScopedScorecardRequest(...)`
+- deterministic AI context builders such as `buildPrImpactContext(...)`, `buildCognitiveLoadContext(...)`, `buildRecommendationsTrendContext(...)`, `buildPersistentSmellSignals(...)`, `buildRefactoringSuggestionsContext(...)`, `buildOnboardingContext(...)`, and `buildDriftInterpretationAnalysis(...)`
 - `evaluateRules(...)` and `evaluateRulePack(...)`
 - `normalizeGovernanceProfile(...)`
 - `normalizeGovernanceException(...)`
@@ -105,6 +143,7 @@ Built-in Governance rule content includes:
 - `coreBuiltInRulePacks`
 - `coreBuiltInPolicyRules`
 - `evaluateCoreBuiltInPolicyViolations(...)`
+- `evaluateGovernancePolicies(...)`
 
 ### Extension APIs
 
@@ -137,24 +176,22 @@ The package is designed to sit between concrete adapters and higher-level hosts:
 
 ```ts
 import {
-  buildGovernanceAssessment,
-  coreBuiltInRulePack,
-  evaluateRulePack,
+  buildGovernanceAssessmentArtifacts,
   normalizeGovernanceProfile,
-  type GovernanceWorkspace,
+  type GovernanceWorkspaceAdapterResult,
 } from '@anarchitects/governance-core';
 
-const workspace: GovernanceWorkspace = {
-  id: 'demo',
-  name: 'demo',
-  root: '.',
+const adapterResult: GovernanceWorkspaceAdapterResult = {
+  workspaceId: 'demo',
+  workspaceName: 'demo',
+  workspaceRoot: '.',
   projects: [],
   dependencies: [],
 };
 
 const profile = normalizeGovernanceProfile({
   name: 'default',
-  boundaryPolicySource: 'governance',
+  boundaryPolicySource: 'profile',
   layers: ['app', 'domain', 'data'],
   allowedDomainDependencies: {},
   ownership: { required: false, metadataField: 'team' },
@@ -167,55 +204,48 @@ const profile = normalizeGovernanceProfile({
   metrics: {},
 });
 
-const ruleResult = await evaluateRulePack(coreBuiltInRulePack, {
-  workspace,
+const artifacts = await buildGovernanceAssessmentArtifacts({
+  workspaceAdapterResult: adapterResult,
   profile,
+  exceptions: [],
 });
 
-const assessment = buildGovernanceAssessment({
-  workspace,
-  profile: profile.name,
-  violations: ruleResult.violations,
-  measurements: [],
-  signals: [],
-  warnings: [],
-  exceptions: {
-    summary: {
-      declaredCount: 0,
-      matchedCount: 0,
-      suppressedPolicyViolationCount: 0,
-      suppressedConformanceFindingCount: 0,
-      unusedExceptionCount: 0,
-      activeExceptionCount: 0,
-      staleExceptionCount: 0,
-      expiredExceptionCount: 0,
-      reactivatedPolicyViolationCount: 0,
-      reactivatedConformanceFindingCount: 0,
-    },
-    used: [],
-    unused: [],
-    suppressedFindings: [],
-    reactivatedFindings: [],
-  },
-  health: {
-    score: 100,
-    status: 'good',
-    grade: 'A',
-    reasons: [],
-    hotspots: {
-      metrics: [],
-      projects: [],
-    },
-    explainability: {
-      topIssues: [],
-      metrics: [],
-      projects: [],
-    },
-  },
-  recommendations: [],
-});
+console.log(artifacts.assessment.health.status);
 ```
 
+## Host Consumption Surface
+
+Thin runtime hosts can consume the package in this order:
+
+- normalize adapter output with `buildGovernanceWorkspace(...)` or `buildGovernanceAssessmentArtifacts(...)`
+- evaluate built-in policies with `evaluateGovernancePolicies(...)`
+- build canonical signals with `buildGovernanceGraphSignals(...)`, `buildGovernanceConformanceSignals(...)`, `buildGovernancePolicySignals(...)`, and `mergeGovernanceSignals(...)`
+- calculate metrics and health with `calculateGovernanceMetrics(...)` and `calculateGovernanceHealth(...)`
+- build recommendations with `buildGovernanceRecommendations(...)`
+- apply exception lifecycle and suppression with `evaluateGovernanceExceptionLifecycle(...)`, `applyGovernanceExceptions(...)`, and `buildGovernanceExceptionReport(...)`
+- build higher-level delivery and AI artifacts with `buildDeliveryImpactAssessment(...)`, `buildManagementInsightsAiRequest(...)`, `summarizeManagementInsights(...)`, and the other deterministic AI request/summarizer helpers
+
+## AI Host Helpers
+
+Thin host packages can now keep AI handoff shaping in Core by composing:
+
+- `scopeGovernanceDependencies(...)`
+- `sliceGovernancePayloadItems(...)`
+- `compareGovernanceViolationsForPriority(...)`
+- `buildScopedRootCauseRequest(...)`
+- `buildScopedDriftRequest(...)`
+- `buildScopedScorecardRequest(...)`
+- `buildDriftInterpretationAnalysis(...)`
+- `buildPrImpactContext(...)`
+- `buildCognitiveLoadContext(...)`
+- `buildRecommendationsTrendContext(...)`
+- `buildPersistentSmellSignals(...)`
+- `buildRefactoringSuggestionsContext(...)`
+- `buildOnboardingContext(...)`
+
+These helpers are deterministic and host-independent. Hosts still own file IO,
+git diffing, workspace-root path resolution, output rendering, and persistence.
+
 ## Package Boundaries
 
 `@anarchitects/governance-core` is platform-independent.

package/dist/core/adapter.d.ts

@@ -1,5 +1,5 @@
-import { GovernanceWorkspace } from './models.js';
-import { ProfileOverrides } from './profile.js';
+import type { GovernanceWorkspace } from './models.js';
+import type { ProfileOverrides } from './profile.js';
 export interface GovernanceWorkspaceAdapterResult {
     workspace?: GovernanceWorkspace;
     workspaceId?: string;
@@ -62,4 +62,7 @@ export interface GovernanceDiagnostic {
     details?: Record<string, unknown>;
 }
 export declare function buildGovernanceWorkspace(adapterResult: GovernanceWorkspaceAdapterResult, overrides?: ProfileOverrides): GovernanceWorkspace;
+export declare const buildGovernanceInventory: typeof buildGovernanceWorkspace;
+export declare const normalizeGovernanceWorkspace: typeof buildGovernanceWorkspace;
+export declare const buildGovernanceWorkspaceFromAdapterResult: typeof buildGovernanceWorkspace;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/core/adapter.d.ts.map

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

package/dist/core/ai-analysis.d.ts

@@ -0,0 +1,74 @@
+import type { AiAnalysisRequest, AiAnalysisResult, GovernanceAssessment, GovernanceDependency, MetricSnapshot, SnapshotComparison, SnapshotViolation } from './models.js';
+import type { DeliveryImpactAssessment } from './delivery-impact.js';
+export interface BuildManagementInsightsAiRequestInput {
+    deliveryImpact: DeliveryImpactAssessment;
+    assessment?: GovernanceAssessment;
+    comparison?: SnapshotComparison;
+    generatedAt?: string;
+    profile?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function buildRootCauseRequest(params: {
+    profile: string;
+    snapshot: MetricSnapshot;
+    dependencies: GovernanceDependency[];
+    topViolations?: SnapshotViolation[];
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildPrImpactRequest(params: {
+    profile: string;
+    affectedProjects: string[];
+    dependencies: GovernanceDependency[];
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildScorecardRequest(params: {
+    profile: string;
+    snapshot: MetricSnapshot;
+    comparison?: SnapshotComparison;
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildOnboardingRequest(params: {
+    profile: string;
+    dependencies: GovernanceDependency[];
+    topViolations?: SnapshotViolation[];
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildCognitiveLoadRequest(params: {
+    profile: string;
+    affectedProjects: string[];
+    dependencies: GovernanceDependency[];
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildArchitectureRecommendationsRequest(params: {
+    profile: string;
+    dependencies: GovernanceDependency[];
+    topViolations?: SnapshotViolation[];
+    comparison?: SnapshotComparison;
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildSmellClustersRequest(params: {
+    profile: string;
+    dependencies: GovernanceDependency[];
+    topViolations?: SnapshotViolation[];
+    comparison?: SnapshotComparison;
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildRefactoringSuggestionsRequest(params: {
+    profile: string;
+    dependencies: GovernanceDependency[];
+    topViolations?: SnapshotViolation[];
+    comparison?: SnapshotComparison;
+    metadata?: Record<string, unknown>;
+}): AiAnalysisRequest;
+export declare function buildManagementInsightsAiRequest(input: BuildManagementInsightsAiRequestInput): AiAnalysisRequest;
+export declare function rankTopViolations(violations: SnapshotViolation[], limit?: number): SnapshotViolation[];
+export declare function summarizeRootCause(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizePrImpact(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeScorecard(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeOnboarding(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeManagementInsights(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeArchitectureRecommendations(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeCognitiveLoad(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeSmellClusters(request: AiAnalysisRequest): AiAnalysisResult;
+export declare function summarizeRefactoringSuggestions(request: AiAnalysisRequest): AiAnalysisResult;
+//# sourceMappingURL=ai-analysis.d.ts.map

package/dist/core/ai-analysis.d.ts.map

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

package/dist/core/ai-context.d.ts

@@ -0,0 +1,125 @@
+import type { AiAnalysisRequest, AiAnalysisResult, DriftSignal, DriftSummary, GovernanceDependency, GovernanceProject, MetricSnapshot, SnapshotViolation } from './models.js';
+export interface GovernancePrImpactContext {
+    changedFilesCount: number;
+    affectedProjects: string[];
+    affectedProjectsCount: number;
+    affectedDomains: string[];
+    affectedDomainCount: number;
+    scopedDependencyCount: number;
+    crossDomainDependencyEdges: number;
+}
+export interface FanoutProjectSummary {
+    project: string;
+    fanout: number;
+}
+export interface GovernanceCognitiveLoadContext {
+    scope: string;
+    selectedProjects: string[];
+    selectedProjectsCount: number;
+    affectedDomains: string[];
+    affectedDomainCount: number;
+    scopedDependencyCount: number;
+    crossDomainDependencyEdges: number;
+    averageFanout: number;
+    maxFanout: number;
+    topFanoutProjects: FanoutProjectSummary[];
+    project?: string;
+    domain?: string;
+}
+export interface GovernanceRecommendationsTrendContext {
+    overallTrend: DriftSignal['status'];
+    worseningSignalCount: number;
+    improvingSignalCount: number;
+    stableSignalCount: number;
+    signalCount: number;
+    snapshotCount: number;
+    trendWindowInsufficient: boolean;
+}
+export interface GovernancePersistentSmellSignal {
+    type: string;
+    source: string;
+    count: number;
+}
+export interface HotspotProjectSummary {
+    project: string;
+    count: number;
+}
+export interface GovernanceRefactoringSuggestionsContext {
+    analyzedViolations: number;
+    totalViolations: number;
+    hotspotProjects: HotspotProjectSummary[];
+    highFanoutProjects: HotspotProjectSummary[];
+    hotspotDomains: string[];
+    persistentSmellSignals: GovernancePersistentSmellSignal[];
+    snapshotCount: number;
+    sampledSnapshotCount: number;
+}
+export interface DomainCountSummary {
+    domain: string;
+    count: number;
+}
+export interface LayerCountSummary {
+    layer: string;
+    count: number;
+}
+export interface GovernanceOnboardingContext {
+    projectCount: number;
+    dependencyCount: number;
+    ownershipCoverage: number;
+    domainSummary: DomainCountSummary[];
+    layerSummary: LayerCountSummary[];
+    topFanoutProjects: HotspotProjectSummary[];
+    analyzedViolations: number;
+    totalViolations: number;
+}
+export interface BuildPrImpactContextInput {
+    affectedProjects: readonly string[] | readonly GovernanceProject[];
+    dependencies: readonly GovernanceDependency[];
+    projects?: readonly GovernanceProject[];
+    changedFiles?: readonly string[];
+    changedFilesCount?: number;
+}
+export interface BuildCognitiveLoadContextInput {
+    selectedProjects: readonly string[] | readonly GovernanceProject[];
+    dependencies: readonly GovernanceDependency[];
+    projects?: readonly GovernanceProject[];
+    scope?: string;
+    project?: string;
+    domain?: string;
+    topProjectsLimit?: number;
+}
+export interface BuildRecommendationsTrendContextInput {
+    signals: readonly DriftSignal[];
+    summary?: DriftSummary;
+    snapshotCount?: number;
+}
+export interface BuildPersistentSmellSignalsInput {
+    recentSnapshots: readonly MetricSnapshot[];
+    minimumOccurrences?: number;
+}
+export interface BuildRefactoringSuggestionsContextInput {
+    violations: readonly SnapshotViolation[];
+    dependencies: readonly GovernanceDependency[];
+    projects: readonly GovernanceProject[];
+    recentSnapshots?: readonly MetricSnapshot[];
+    topProjectsLimit?: number;
+    analyzedViolationsLimit?: number;
+    minimumPersistentOccurrences?: number;
+}
+export interface BuildOnboardingContextInput {
+    projects: readonly GovernanceProject[];
+    dependencies: readonly GovernanceDependency[];
+    topViolations?: readonly SnapshotViolation[];
+    topProjectsLimit?: number;
+    totalViolationsCount?: number;
+}
+export declare function summarizeDriftInterpretation(request: AiAnalysisRequest, signals: readonly DriftSignal[], summary: DriftSummary): AiAnalysisResult;
+export declare const buildDriftInterpretationAnalysis: typeof summarizeDriftInterpretation;
+export declare function buildPrImpactContext(input: BuildPrImpactContextInput): GovernancePrImpactContext;
+export declare function buildCognitiveLoadContext(input: BuildCognitiveLoadContextInput): GovernanceCognitiveLoadContext;
+export declare function countWorseningDriftSignals(signals: readonly DriftSignal[]): number;
+export declare function buildRecommendationsTrendContext(input: BuildRecommendationsTrendContextInput): GovernanceRecommendationsTrendContext;
+export declare function buildPersistentSmellSignals(input: BuildPersistentSmellSignalsInput): GovernancePersistentSmellSignal[];
+export declare function buildRefactoringSuggestionsContext(input: BuildRefactoringSuggestionsContextInput): GovernanceRefactoringSuggestionsContext;
+export declare function buildOnboardingContext(input: BuildOnboardingContextInput): GovernanceOnboardingContext;
+//# sourceMappingURL=ai-context.d.ts.map

package/dist/core/ai-context.d.ts.map

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

package/dist/core/ai-payload.d.ts

@@ -0,0 +1,64 @@
+import type { AiAnalysisRequest, DriftSignal, DriftSummary, GovernanceDependency, MetricSnapshot, SnapshotComparison, SnapshotViolation } from './models.js';
+export interface GovernancePayloadTruncationMetadata {
+    totalCount: number;
+    selectedCount: number;
+    limit: number;
+    truncated: boolean;
+}
+export interface GovernancePayloadSliceResult<T> {
+    items: T[];
+    truncation: GovernancePayloadTruncationMetadata;
+}
+export interface RootCausePayloadScope {
+    projectScopeCount: number;
+    dependencies: GovernancePayloadTruncationMetadata;
+    violations: GovernancePayloadTruncationMetadata;
+}
+export interface DriftPayloadScope {
+    signals: GovernancePayloadTruncationMetadata;
+    metricDeltas: GovernancePayloadTruncationMetadata;
+    scoreDeltas: GovernancePayloadTruncationMetadata;
+    newViolations: GovernancePayloadTruncationMetadata;
+    resolvedViolations: GovernancePayloadTruncationMetadata;
+}
+export interface ScorecardPayloadScope {
+    snapshotViolations: GovernancePayloadTruncationMetadata;
+    metricDeltas: GovernancePayloadTruncationMetadata;
+    scoreDeltas: GovernancePayloadTruncationMetadata;
+}
+export interface ScopedGovernanceAiRequestResult<TScope> {
+    request: AiAnalysisRequest;
+    payloadScope: TScope;
+}
+export interface BuildScopedRootCauseRequestInput {
+    request: AiAnalysisRequest;
+    dependencies?: GovernanceDependency[];
+    topViolations?: SnapshotViolation[];
+    projectScope?: Iterable<string>;
+    dependencyLimit?: number;
+    topViolationsLimit?: number;
+}
+export interface BuildScopedDriftRequestInput {
+    request: AiAnalysisRequest;
+    comparison?: SnapshotComparison;
+    signals?: DriftSignal[];
+    summary?: DriftSummary;
+    signalLimit?: number;
+    deltaLimit?: number;
+    violationLimit?: number;
+}
+export interface BuildScopedScorecardRequestInput {
+    request: AiAnalysisRequest;
+    snapshot?: MetricSnapshot;
+    comparison?: SnapshotComparison;
+    violationLimit?: number;
+    deltaLimit?: number;
+}
+export declare function buildGovernancePayloadTruncationMetadata(totalCount: number, selectedCount: number, limit: number): GovernancePayloadTruncationMetadata;
+export declare function sliceGovernancePayloadItems<T>(items: readonly T[], limit: number | undefined, compare: (left: T, right: T) => number): GovernancePayloadSliceResult<T>;
+export declare function scopeGovernanceDependencies(dependencies: readonly GovernanceDependency[], projectScope: Iterable<string>, limit?: number): GovernancePayloadSliceResult<GovernanceDependency>;
+export declare function compareGovernanceViolationsForPriority(left: SnapshotViolation, right: SnapshotViolation): number;
+export declare function buildScopedRootCauseRequest(input: BuildScopedRootCauseRequestInput): ScopedGovernanceAiRequestResult<RootCausePayloadScope>;
+export declare function buildScopedDriftRequest(input: BuildScopedDriftRequestInput): ScopedGovernanceAiRequestResult<DriftPayloadScope>;
+export declare function buildScopedScorecardRequest(input: BuildScopedScorecardRequestInput): ScopedGovernanceAiRequestResult<ScorecardPayloadScope>;
+//# sourceMappingURL=ai-payload.d.ts.map

package/dist/core/ai-payload.d.ts.map

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

package/dist/core/ai.d.ts

@@ -1,4 +1,4 @@
-import { AiAnalysisRequest, AiAnalysisResult } from './models.js';
+import type { AiAnalysisRequest, AiAnalysisResult } from './models.js';
 export type AiHandoffUseCase = Extract<AiAnalysisRequest['kind'], 'root-cause' | 'drift' | 'pr-impact' | 'scorecard' | 'management-insights'>;
 export interface GovernanceAiHandoffPayload<TRequest = Record<string, unknown>, TAnalysis = AiAnalysisResult> {
     useCase: AiHandoffUseCase;

package/dist/core/assessment-artifacts.d.ts

@@ -0,0 +1,37 @@
+import type { GovernanceCapability, GovernanceDiagnostic, GovernanceWorkspaceAdapterResult } from './adapter.js';
+import { type GovernanceExceptionApplicationResult } from './exception-runtime.js';
+import { type GovernanceExtensionDiagnostic, type GovernanceExtensionHostContext, type GovernanceExtensionRegistry } from '../extensions/index.js';
+import type { GovernanceAssessment, GovernanceWorkspace, Measurement, Recommendation, Violation } from './models.js';
+import type { GovernanceException } from './exceptions.js';
+import type { GovernanceProfile } from './profile.js';
+import { type GovernanceConformanceFinding, type GovernanceGraphSnapshot } from './signal-builders.js';
+import type { GovernanceSignal } from './signals.js';
+export interface BuildGovernanceAssessmentArtifactsInput {
+    profile: GovernanceProfile;
+    workspaceAdapterResult?: GovernanceWorkspaceAdapterResult;
+    workspace?: GovernanceWorkspace;
+    warnings?: string[];
+    exceptions?: GovernanceException[];
+    conformanceFindings?: GovernanceConformanceFinding[];
+    graphSnapshot?: GovernanceGraphSnapshot;
+    capabilities?: GovernanceCapability[];
+    diagnostics?: GovernanceDiagnostic[];
+    extensionRegistry?: GovernanceExtensionRegistry;
+    extensionContext?: GovernanceExtensionHostContext;
+    extensionDiagnostics?: GovernanceExtensionDiagnostic[];
+    asOf?: Date;
+}
+export interface GovernanceAssessmentArtifacts {
+    workspace: GovernanceWorkspace;
+    assessment: GovernanceAssessment;
+    violations: Violation[];
+    signals: GovernanceSignal[];
+    measurements: Measurement[];
+    recommendations: Recommendation[];
+    exceptionApplication: GovernanceExceptionApplicationResult;
+    extensionDiagnostics: GovernanceExtensionDiagnostic[];
+    capabilities: GovernanceCapability[];
+    diagnostics: GovernanceDiagnostic[];
+}
+export declare function buildGovernanceAssessmentArtifacts(input: BuildGovernanceAssessmentArtifactsInput): Promise<GovernanceAssessmentArtifacts>;
+//# sourceMappingURL=assessment-artifacts.d.ts.map

package/dist/core/assessment-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-artifacts.d.ts","sourceRoot":"","sources":["../../src/core/assessment-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gCAAgC,EACjC,MAAM,cAAc,CAAC;AAGtB,OAAO,EAIL,KAAK,oCAAoC,EAC1C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAKL,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAMhC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAKL,KAAK,4BAA4B,EAEjC,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,sBAAsB,CAAC,EAAE,gCAAgC,CAAC;IAC1D,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,mBAAmB,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACrD,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IAChD,gBAAgB,CAAC,EAAE,8BAA8B,CAAC;IAClD,oBAAoB,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACvD,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,oBAAoB,EAAE,oCAAoC,CAAC;IAC3D,oBAAoB,EAAE,6BAA6B,EAAE,CAAC;IACtD,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,6BAA6B,CAAC,CAkIxC"}

package/dist/core/assessment.d.ts

@@ -1,5 +1,5 @@
-import { GovernanceAssessment, GovernanceExceptionReport, GovernanceTopIssue, Measurement, MetricBreakdown, Recommendation, SignalBreakdown, Violation, GovernanceWorkspace, HealthScore } from './models.js';
-import { GovernanceSignal } from './signals.js';
+import type { GovernanceAssessment, GovernanceExceptionReport, GovernanceTopIssue, Measurement, MetricBreakdown, Recommendation, SignalBreakdown, Violation, GovernanceWorkspace, HealthScore } from './models.js';
+import type { GovernanceSignal } from './signals.js';
 export type GovernanceAssessmentReportType = 'health' | 'boundaries' | 'ownership' | 'architecture';
 export interface GovernanceAssessmentInput {
     workspace: GovernanceWorkspace;

package/dist/core/built-in-rule-pack.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceRulePack } from './rules.js';
+import type { GovernanceRulePack } from './rules.js';
 export declare const CORE_BUILT_IN_RULE_PACK_ID = "core";
 export declare const coreBuiltInRulePack: GovernanceRulePack;
 export declare const coreBuiltInRulePacks: GovernanceRulePack[];

package/dist/core/built-in-rules.d.ts

@@ -1,5 +1,5 @@
-import { Violation } from './models.js';
-import { GovernanceRule, GovernanceRuleContext, GovernanceRuleResult } from './rules.js';
+import type { Violation } from './models.js';
+import type { GovernanceRule, GovernanceRuleContext, GovernanceRuleResult } from './rules.js';
 type SynchronousGovernanceRule<TOptions = unknown> = GovernanceRule<TOptions> & {
     evaluate(context: GovernanceRuleContext<TOptions>): GovernanceRuleResult;
 };
@@ -12,5 +12,8 @@ export declare const missingDomainRule: SynchronousGovernanceRule;
 export declare const missingLayerRule: SynchronousGovernanceRule;
 export declare const coreBuiltInPolicyRules: GovernanceRule[];
 export declare function evaluateCoreBuiltInPolicyViolations(context: GovernanceRuleContext): Violation[];
+export declare function evaluateGovernancePolicies(workspace: GovernanceRuleContext['workspace'], profile: GovernanceRuleContext['profile']): Violation[];
+export declare function evaluateGovernancePolicies(context: GovernanceRuleContext): Violation[];
+export declare const evaluateBuiltInGovernancePolicies: typeof evaluateGovernancePolicies;
 export {};
 //# sourceMappingURL=built-in-rules.d.ts.map

package/dist/core/built-in-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-rules.d.ts","sourceRoot":"","sources":["../../src/core/built-in-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,aAAa,CAAC;AAYhE,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,KAAK,yBAAyB,CAAC,QAAQ,GAAG,OAAO,IAC/C,cAAc,CAAC,QAAQ,CAAC,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC;CAC1E,CAAC;AAEJ,eAAO,MAAM,kBAAkB,EAAE,yBAuChC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,yBA+C/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,yBAqCnC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,yBAgCvC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,yBAmC/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,yBA2B/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,yBA2B9B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAQlD,CAAC;AAEF,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,qBAAqB,GAC7B,SAAS,EAAE,CAwFb"}
+{"version":3,"file":"built-in-rules.d.ts","sourceRoot":"","sources":["../../src/core/built-in-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,aAAa,CAAC;AAYhE,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,KAAK,yBAAyB,CAAC,QAAQ,GAAG,OAAO,IAC/C,cAAc,CAAC,QAAQ,CAAC,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC;CAC1E,CAAC;AAEJ,eAAO,MAAM,kBAAkB,EAAE,yBAuChC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,yBA+C/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,yBAqCnC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,yBAgCvC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,yBAmC/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,yBA2B/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,yBA2B9B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAQlD,CAAC;AAEF,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,qBAAqB,GAC7B,SAAS,EAAE,CAwFb;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,EAC7C,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACxC,SAAS,EAAE,CAAC;AACf,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,GAC7B,SAAS,EAAE,CAAC;AAiBf,eAAO,MAAM,iCAAiC,mCAA6B,CAAC"}