@anarchitects/governance-core 0.0.3 → 0.0.4

package/README.md

@@ -22,6 +22,7 @@ This package is responsible for:
 - defining adapter-facing input contracts such as `GovernanceProjectInput`, `GovernanceDependencyInput`, and `GovernanceWorkspaceAdapterResult`
 - defining profile, rule, signal, exception, measurement, health, assessment, snapshot, and drift contracts
 - providing deterministic helpers such as profile normalization, rule evaluation, assessment assembly, snapshot comparison, and AI handoff payload builders
+- providing host-independent helpers that map changed files onto canonical `GovernanceProject` models and shape snapshot delivery-impact summaries
 - providing portable extension contracts and runtime helpers that stay independent from Nx
 
 This package is not responsible for:
@@ -40,6 +41,7 @@ The package has a single public entrypoint:
 ```ts
 import {
   buildDeliveryImpactAssessment,
+  buildSnapshotDeliveryImpactSummary,
   buildCognitiveLoadContext,
   buildDriftInterpretationAnalysis,
   buildGovernanceAssessment,
@@ -53,6 +55,7 @@ import {
   buildPersistentSmellSignals,
   buildPrImpactContext,
   buildRecommendationsTrendContext,
+  resolveAffectedGovernanceProjects,
   buildRefactoringSuggestionsContext,
   buildGovernanceWorkspace,
   buildMetricSnapshot,
@@ -91,6 +94,7 @@ The root export currently re-exports these API groups:
 - `models`
 - `exceptions`
 - `profile`
+- `project-matching`
 - `rule-engine`
 - `rules`
 - `signals`
@@ -124,10 +128,12 @@ Deterministic helpers include:
 - `buildGovernanceRecommendations(...)`
 - `applyGovernanceExceptions(...)`, `evaluateGovernanceExceptionLifecycle(...)`, and `buildGovernanceExceptionReport(...)`
 - `buildDeliveryImpactAssessment(...)` and `summarizeDeliveryImpact(...)`
+- `buildSnapshotDeliveryImpactSummary(...)`
 - 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(...)`
+- `resolveAffectedGovernanceProjects(...)`
 - `evaluateRules(...)` and `evaluateRulePack(...)`
 - `normalizeGovernanceProfile(...)`
 - `normalizeGovernanceException(...)`
@@ -225,6 +231,18 @@ 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
 
+Hosts remain responsible for:
+
+- collecting changed files from git or another host runtime
+- resolving refs, workspace roots, and process execution
+- discovering snapshot files and choosing baseline/current snapshot inputs
+- persisting snapshots and other host-owned artifacts
+
+Core also provides two small host-independent handoff helpers:
+
+- `resolveAffectedGovernanceProjects(...)` maps host-supplied repo-relative changed file paths onto canonical `GovernanceProject` records. It normalizes Windows separators, trims trailing slashes from project roots, ignores empty changed-file entries, and treats `'.'` or `''` project roots as root-level projects that match any non-empty changed file.
+- `buildSnapshotDeliveryImpactSummary(...)` shapes a `DeliveryImpactAssessment` into a `SnapshotDeliveryImpactSummary` by sorting indices by `id` and copying the first five delivery-impact drivers into the snapshot-safe summary contract.
+
 ## AI Host Helpers
 
 Thin host packages can now keep AI handoff shaping in Core by composing:

package/dist/core/index.d.ts

@@ -15,6 +15,7 @@ export * from './exceptions.js';
 export * from './health.js';
 export * from './metrics.js';
 export * from './profile.js';
+export * from './project-matching.js';
 export * from './rule-engine.js';
 export * from './rules.js';
 export * from './signal-builders.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,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"}
+{"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,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/core/project-matching.d.ts

@@ -0,0 +1,7 @@
+import type { GovernanceProject } from './models.js';
+export interface ResolveAffectedGovernanceProjectsOptions {
+    projects: readonly GovernanceProject[];
+    changedFiles: readonly string[];
+}
+export declare function resolveAffectedGovernanceProjects(options: ResolveAffectedGovernanceProjectsOptions): GovernanceProject[];
+//# sourceMappingURL=project-matching.d.ts.map

package/dist/core/project-matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-matching.d.ts","sourceRoot":"","sources":["../../src/core/project-matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,wCAAwC;IACvD,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,iBAAiB,EAAE,CAiBrB"}

package/dist/core/snapshots.d.ts

@@ -1,4 +1,5 @@
 import type { GovernanceAssessment, MetricSnapshot, SnapshotDeliveryImpactSummary } from './models.js';
+import type { DeliveryImpactAssessment } from './delivery-impact.js';
 export interface GovernanceSnapshotMetadata {
     timestamp: string;
     repo: string;
@@ -9,4 +10,5 @@ export interface GovernanceSnapshotMetadata {
     deliveryImpact?: SnapshotDeliveryImpactSummary;
 }
 export declare function buildMetricSnapshot(assessment: GovernanceAssessment, metadata: GovernanceSnapshotMetadata): MetricSnapshot;
+export declare function buildSnapshotDeliveryImpactSummary(deliveryImpact: DeliveryImpactAssessment): SnapshotDeliveryImpactSummary;
 //# sourceMappingURL=snapshots.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/core/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;CAChD;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,cAAc,CA2ChB"}
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/core/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,6BAA6B,EAE9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAIrE,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;CAChD;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,cAAc,CA2ChB;AAED,wBAAgB,kCAAkC,CAChD,cAAc,EAAE,wBAAwB,GACvC,6BAA6B,CAoB/B"}