@anarchitects/governance-core 0.0.2 → 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:
 
@@ -40,16 +40,28 @@ 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,
@@ -58,6 +70,8 @@ import {
   normalizeGovernanceException,
   normalizeGovernanceProfile,
   registerLoadedGovernanceExtensions,
+  scopeGovernanceDependencies,
+  sliceGovernancePayloadItems,
   type GovernanceWorkspaceAdapter,
   type GovernanceWorkspace,
   type GovernanceWorkspaceAdapterResult,
@@ -72,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`
@@ -109,6 +125,9 @@ Deterministic helpers include:
 - `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(...)`
@@ -206,6 +225,27 @@ Thin runtime hosts can consume the package in this order:
 - 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;

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

@@ -1,5 +1,5 @@
-import { AiAnalysisRequest, AiAnalysisResult, GovernanceAssessment, GovernanceDependency, MetricSnapshot, SnapshotComparison, SnapshotViolation } from './models.js';
-import { DeliveryImpactAssessment } from './delivery-impact.js';
+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;

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

@@ -1,11 +1,11 @@
-import { GovernanceCapability, GovernanceDiagnostic, GovernanceWorkspaceAdapterResult } from './adapter.js';
-import { GovernanceExceptionApplicationResult } from './exception-runtime.js';
-import { GovernanceExtensionDiagnostic, GovernanceExtensionHostContext, GovernanceExtensionRegistry } from '../extensions/index.js';
-import { GovernanceAssessment, GovernanceWorkspace, Measurement, Recommendation, Violation } from './models.js';
-import { GovernanceException } from './exceptions.js';
-import { GovernanceProfile } from './profile.js';
-import { GovernanceConformanceFinding, GovernanceGraphSnapshot } from './signal-builders.js';
-import { GovernanceSignal } from './signals.js';
+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;

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;
 };

package/dist/core/delivery-impact.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceAssessment, SnapshotComparison } from './models.js';
+import type { GovernanceAssessment, SnapshotComparison } from './models.js';
 export type GovernanceAudience = 'management' | 'technical-lead' | 'developer';
 export type GovernanceInsightCategory = 'cost-of-change' | 'time-to-market' | 'delivery-risk' | 'predictability' | 'maintainability' | 'ownership' | (string & {});
 export interface GovernanceInsightDriver {

package/dist/core/drift.d.ts

@@ -1,4 +1,4 @@
-import { DriftSignal, DriftSummary, MetricSnapshot, SnapshotComparison } from './models.js';
+import type { DriftSignal, DriftSummary, MetricSnapshot, SnapshotComparison } from './models.js';
 export declare function compareSnapshots(baseline: MetricSnapshot, current: MetricSnapshot): SnapshotComparison;
 export declare function summarizeDrift(comparison: SnapshotComparison, threshold?: number): DriftSignal[];
 export declare function buildDriftSummary(signals: DriftSignal[]): DriftSummary;

package/dist/core/exception-runtime.d.ts

@@ -1,6 +1,6 @@
-import { GovernanceExceptionReport, GovernanceExceptionStatus, Violation } from './models.js';
-import { GovernanceException } from './exceptions.js';
-import { GovernanceConformanceFinding } from './signal-builders.js';
+import type { GovernanceExceptionReport, GovernanceExceptionStatus, Violation } from './models.js';
+import { type GovernanceException } from './exceptions.js';
+import type { GovernanceConformanceFinding } from './signal-builders.js';
 export interface GovernanceExceptionLifecycle {
     exception: GovernanceException;
     status: GovernanceExceptionStatus;

package/dist/core/exceptions.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceConformanceCategory } from './signals.js';
+import type { GovernanceConformanceCategory } from './signals.js';
 export type GovernanceExceptionSource = 'policy' | 'conformance';
 export interface GovernanceExceptionReview {
     createdAt?: string;

package/dist/core/health.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceTopIssue, HealthScore, HealthStatusThresholds, Measurement, Recommendation, Violation } from './models.js';
+import type { GovernanceTopIssue, HealthScore, HealthStatusThresholds, Measurement, Recommendation, Violation } from './models.js';
 export type MetricWeights = Partial<Record<Measurement['id'], number>>;
 export interface GovernanceHealthExplainabilityInput {
     topIssues?: GovernanceTopIssue[];

package/dist/core/index.d.ts

@@ -1,5 +1,7 @@
 export * from './adapter.js';
 export * from './ai-analysis.js';
+export * from './ai-context.js';
+export * from './ai-payload.js';
 export * from './assessment.js';
 export * from './assessment-artifacts.js';
 export * from './ai.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/core/metrics.d.ts

@@ -1,5 +1,5 @@
-import { Measurement, GovernanceWorkspace } from './models.js';
-import { GovernanceSignal } from './signals.js';
+import type { Measurement, GovernanceWorkspace } from './models.js';
+import type { GovernanceSignal } from './signals.js';
 export interface CalculateGovernanceMetricsInput {
     workspace: GovernanceWorkspace;
     signals: GovernanceSignal[];

package/dist/core/models.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceSignalCategory, GovernanceSignalSeverity, GovernanceSignalSource, GovernanceSignalType } from './signals.js';
+import type { GovernanceSignalCategory, GovernanceSignalSeverity, GovernanceSignalSource, GovernanceSignalType } from './signals.js';
 export interface GovernanceWorkspace {
     id: string;
     name: string;

package/dist/core/rule-engine.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceRule, GovernanceRuleContext, GovernanceRuleExecutionResult, GovernanceRulePack } from './rules.js';
+import type { GovernanceRule, GovernanceRuleContext, GovernanceRuleExecutionResult, GovernanceRulePack } from './rules.js';
 export declare function evaluateRules<TOptions = unknown>(rules: GovernanceRule<TOptions>[], context: GovernanceRuleContext<TOptions>): Promise<GovernanceRuleExecutionResult>;
 export declare function evaluateRulePack<TOptions = unknown>(rulePack: GovernanceRulePack<TOptions>, context: GovernanceRuleContext<TOptions>): Promise<GovernanceRuleExecutionResult>;
 //# sourceMappingURL=rule-engine.d.ts.map

package/dist/core/rules.d.ts

@@ -1,7 +1,7 @@
-import { GovernanceCapability, GovernanceDiagnostic } from './adapter.js';
-import { Measurement, Violation, GovernanceWorkspace } from './models.js';
-import { GovernanceProfile } from './profile.js';
-import { GovernanceSignal } from './signals.js';
+import type { GovernanceCapability, GovernanceDiagnostic } from './adapter.js';
+import type { Measurement, Violation, GovernanceWorkspace } from './models.js';
+import type { GovernanceProfile } from './profile.js';
+import type { GovernanceSignal } from './signals.js';
 export type GovernanceRuleSeverity = Violation['severity'];
 export type GovernanceRuleCategory = Violation['category'] | 'convention' | 'metadata' | 'structure' | 'snapshot' | 'drift' | 'ai' | (string & {});
 export interface GovernanceRuleContext<TOptions = unknown> {

package/dist/core/signal-builders.d.ts

@@ -1,5 +1,5 @@
-import { Violation } from './models.js';
-import { GovernanceSignal, GovernanceSignalCategory, GovernanceSignalSeverity } from './signals.js';
+import type { Violation } from './models.js';
+import type { GovernanceSignal, GovernanceSignalCategory, GovernanceSignalSeverity } from './signals.js';
 export interface GovernanceGraphSnapshotProject {
     id: string;
     domain?: string;

package/dist/core/snapshots.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceAssessment, MetricSnapshot, SnapshotDeliveryImpactSummary } from './models.js';
+import type { GovernanceAssessment, MetricSnapshot, SnapshotDeliveryImpactSummary } from './models.js';
 export interface GovernanceSnapshotMetadata {
     timestamp: string;
     repo: string;

package/dist/extensions/capabilities.d.ts

@@ -1,4 +1,4 @@
-import { GovernanceCapability } from '../core/index.js';
+import type { GovernanceCapability } from '../core/index.js';
 export interface GovernanceCapabilityRegistry {
     has(id: string): boolean;
     get<TData = unknown>(id: string): GovernanceCapability<TData> | undefined;

package/dist/extensions/contracts.d.ts

@@ -1,6 +1,6 @@
-import { GovernanceProfile, GovernanceWorkspace, Measurement, Violation } from '../core/index.js';
-import { GovernanceSignal } from '../core/signals.js';
-import { GovernanceCapabilityRegistry } from './capabilities.js';
+import type { GovernanceProfile, GovernanceWorkspace, Measurement, Violation } from '../core/index.js';
+import type { GovernanceSignal } from '../core/signals.js';
+import type { GovernanceCapabilityRegistry } from './capabilities.js';
 export interface GovernanceExtensionHostContext {
     workspaceRoot: string;
     profileName: string;

package/dist/extensions/runtime.d.ts

@@ -1,7 +1,7 @@
-import { GovernanceWorkspace, Measurement, Violation } from '../core/index.js';
-import { GovernanceSignal } from '../core/signals.js';
-import { GovernanceExtensionDefinition, GovernanceExtensionHost as GovernanceExtensionHostContract, GovernanceExtensionHostContext, GovernanceMetricProvider, GovernanceMetricProviderInput, GovernanceExtensionRulePack, GovernanceRulePackInput, GovernanceSignalProvider, GovernanceSignalProviderInput, GovernanceWorkspaceEnricher, GovernanceWorkspaceEnricherInput } from './contracts.js';
-import { GovernanceExtensionDiagnostic } from './diagnostics.js';
+import type { GovernanceWorkspace, Measurement, Violation } from '../core/index.js';
+import type { GovernanceSignal } from '../core/signals.js';
+import type { GovernanceExtensionDefinition, GovernanceExtensionHost as GovernanceExtensionHostContract, GovernanceExtensionHostContext, GovernanceMetricProvider, GovernanceMetricProviderInput, GovernanceExtensionRulePack, GovernanceRulePackInput, GovernanceSignalProvider, GovernanceSignalProviderInput, GovernanceWorkspaceEnricher, GovernanceWorkspaceEnricherInput } from './contracts.js';
+import type { GovernanceExtensionDiagnostic } from './diagnostics.js';
 interface RegisteredGovernanceContribution<T> {
     pluginId: string;
     contribution: T;