@anarchitects/governance-core 0.0.1 → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +43 -53
- package/dist/core/adapter.d.ts +3 -0
- package/dist/core/adapter.d.ts.map +1 -1
- package/dist/core/ai-analysis.d.ts +74 -0
- package/dist/core/ai-analysis.d.ts.map +1 -0
- package/dist/core/assessment-artifacts.d.ts +37 -0
- package/dist/core/assessment-artifacts.d.ts.map +1 -0
- package/dist/core/built-in-rules.d.ts +3 -0
- package/dist/core/built-in-rules.d.ts.map +1 -1
- package/dist/core/delivery-impact.d.ts +47 -0
- package/dist/core/delivery-impact.d.ts.map +1 -0
- package/dist/core/exception-runtime.d.ts +46 -0
- package/dist/core/exception-runtime.d.ts.map +1 -0
- package/dist/core/health.d.ts +11 -0
- package/dist/core/health.d.ts.map +1 -0
- package/dist/core/index.d.ts +7 -0
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/metrics.d.ts +9 -0
- package/dist/core/metrics.d.ts.map +1 -0
- package/dist/core/signal-builders.d.ts +42 -0
- package/dist/core/signal-builders.d.ts.map +1 -0
- package/dist/index.js +2710 -975
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -39,12 +39,22 @@ The package has a single public entrypoint:
|
|
|
39
39
|
|
|
40
40
|
```ts
|
|
41
41
|
import {
|
|
42
|
+
buildDeliveryImpactAssessment,
|
|
42
43
|
buildGovernanceAssessment,
|
|
44
|
+
buildGovernanceAssessmentArtifacts,
|
|
45
|
+
buildGovernanceConformanceSignals,
|
|
46
|
+
buildGovernanceGraphSignals,
|
|
47
|
+
buildGovernancePolicySignals,
|
|
48
|
+
buildGovernanceRecommendations,
|
|
43
49
|
buildGovernanceWorkspace,
|
|
44
50
|
buildMetricSnapshot,
|
|
51
|
+
calculateGovernanceHealth,
|
|
52
|
+
calculateGovernanceMetrics,
|
|
45
53
|
compareSnapshots,
|
|
46
54
|
coreBuiltInRulePack,
|
|
55
|
+
evaluateGovernancePolicies,
|
|
47
56
|
evaluateRulePack,
|
|
57
|
+
buildManagementInsightsAiRequest,
|
|
48
58
|
normalizeGovernanceException,
|
|
49
59
|
normalizeGovernanceProfile,
|
|
50
60
|
registerLoadedGovernanceExtensions,
|
|
@@ -90,6 +100,15 @@ Core contracts include:
|
|
|
90
100
|
Deterministic helpers include:
|
|
91
101
|
|
|
92
102
|
- `buildGovernanceAssessment(...)`
|
|
103
|
+
- `buildGovernanceAssessmentArtifacts(...)`
|
|
104
|
+
- `buildGovernanceWorkspace(...)`, `buildGovernanceInventory(...)`, and `buildGovernanceWorkspaceFromAdapterResult(...)`
|
|
105
|
+
- `buildGovernanceGraphSignals(...)`, `buildGovernanceConformanceSignals(...)`, `buildGovernancePolicySignals(...)`, and `mergeGovernanceSignals(...)`
|
|
106
|
+
- `calculateGovernanceMetrics(...)`
|
|
107
|
+
- `calculateGovernanceHealth(...)`
|
|
108
|
+
- `buildGovernanceRecommendations(...)`
|
|
109
|
+
- `applyGovernanceExceptions(...)`, `evaluateGovernanceExceptionLifecycle(...)`, and `buildGovernanceExceptionReport(...)`
|
|
110
|
+
- `buildDeliveryImpactAssessment(...)` and `summarizeDeliveryImpact(...)`
|
|
111
|
+
- deterministic AI request builders and summarizers such as `buildRootCauseRequest(...)`, `buildPrImpactRequest(...)`, `buildScorecardRequest(...)`, `buildOnboardingRequest(...)`, `buildManagementInsightsAiRequest(...)`, `summarizeRootCause(...)`, `summarizePrImpact(...)`, `summarizeScorecard(...)`, `summarizeOnboarding(...)`, and `summarizeManagementInsights(...)`
|
|
93
112
|
- `evaluateRules(...)` and `evaluateRulePack(...)`
|
|
94
113
|
- `normalizeGovernanceProfile(...)`
|
|
95
114
|
- `normalizeGovernanceException(...)`
|
|
@@ -105,6 +124,7 @@ Built-in Governance rule content includes:
|
|
|
105
124
|
- `coreBuiltInRulePacks`
|
|
106
125
|
- `coreBuiltInPolicyRules`
|
|
107
126
|
- `evaluateCoreBuiltInPolicyViolations(...)`
|
|
127
|
+
- `evaluateGovernancePolicies(...)`
|
|
108
128
|
|
|
109
129
|
### Extension APIs
|
|
110
130
|
|
|
@@ -137,24 +157,22 @@ The package is designed to sit between concrete adapters and higher-level hosts:
|
|
|
137
157
|
|
|
138
158
|
```ts
|
|
139
159
|
import {
|
|
140
|
-
|
|
141
|
-
coreBuiltInRulePack,
|
|
142
|
-
evaluateRulePack,
|
|
160
|
+
buildGovernanceAssessmentArtifacts,
|
|
143
161
|
normalizeGovernanceProfile,
|
|
144
|
-
type
|
|
162
|
+
type GovernanceWorkspaceAdapterResult,
|
|
145
163
|
} from '@anarchitects/governance-core';
|
|
146
164
|
|
|
147
|
-
const
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
165
|
+
const adapterResult: GovernanceWorkspaceAdapterResult = {
|
|
166
|
+
workspaceId: 'demo',
|
|
167
|
+
workspaceName: 'demo',
|
|
168
|
+
workspaceRoot: '.',
|
|
151
169
|
projects: [],
|
|
152
170
|
dependencies: [],
|
|
153
171
|
};
|
|
154
172
|
|
|
155
173
|
const profile = normalizeGovernanceProfile({
|
|
156
174
|
name: 'default',
|
|
157
|
-
boundaryPolicySource: '
|
|
175
|
+
boundaryPolicySource: 'profile',
|
|
158
176
|
layers: ['app', 'domain', 'data'],
|
|
159
177
|
allowedDomainDependencies: {},
|
|
160
178
|
ownership: { required: false, metadataField: 'team' },
|
|
@@ -167,55 +185,27 @@ const profile = normalizeGovernanceProfile({
|
|
|
167
185
|
metrics: {},
|
|
168
186
|
});
|
|
169
187
|
|
|
170
|
-
const
|
|
171
|
-
|
|
188
|
+
const artifacts = await buildGovernanceAssessmentArtifacts({
|
|
189
|
+
workspaceAdapterResult: adapterResult,
|
|
172
190
|
profile,
|
|
191
|
+
exceptions: [],
|
|
173
192
|
});
|
|
174
193
|
|
|
175
|
-
|
|
176
|
-
workspace,
|
|
177
|
-
profile: profile.name,
|
|
178
|
-
violations: ruleResult.violations,
|
|
179
|
-
measurements: [],
|
|
180
|
-
signals: [],
|
|
181
|
-
warnings: [],
|
|
182
|
-
exceptions: {
|
|
183
|
-
summary: {
|
|
184
|
-
declaredCount: 0,
|
|
185
|
-
matchedCount: 0,
|
|
186
|
-
suppressedPolicyViolationCount: 0,
|
|
187
|
-
suppressedConformanceFindingCount: 0,
|
|
188
|
-
unusedExceptionCount: 0,
|
|
189
|
-
activeExceptionCount: 0,
|
|
190
|
-
staleExceptionCount: 0,
|
|
191
|
-
expiredExceptionCount: 0,
|
|
192
|
-
reactivatedPolicyViolationCount: 0,
|
|
193
|
-
reactivatedConformanceFindingCount: 0,
|
|
194
|
-
},
|
|
195
|
-
used: [],
|
|
196
|
-
unused: [],
|
|
197
|
-
suppressedFindings: [],
|
|
198
|
-
reactivatedFindings: [],
|
|
199
|
-
},
|
|
200
|
-
health: {
|
|
201
|
-
score: 100,
|
|
202
|
-
status: 'good',
|
|
203
|
-
grade: 'A',
|
|
204
|
-
reasons: [],
|
|
205
|
-
hotspots: {
|
|
206
|
-
metrics: [],
|
|
207
|
-
projects: [],
|
|
208
|
-
},
|
|
209
|
-
explainability: {
|
|
210
|
-
topIssues: [],
|
|
211
|
-
metrics: [],
|
|
212
|
-
projects: [],
|
|
213
|
-
},
|
|
214
|
-
},
|
|
215
|
-
recommendations: [],
|
|
216
|
-
});
|
|
194
|
+
console.log(artifacts.assessment.health.status);
|
|
217
195
|
```
|
|
218
196
|
|
|
197
|
+
## Host Consumption Surface
|
|
198
|
+
|
|
199
|
+
Thin runtime hosts can consume the package in this order:
|
|
200
|
+
|
|
201
|
+
- normalize adapter output with `buildGovernanceWorkspace(...)` or `buildGovernanceAssessmentArtifacts(...)`
|
|
202
|
+
- evaluate built-in policies with `evaluateGovernancePolicies(...)`
|
|
203
|
+
- build canonical signals with `buildGovernanceGraphSignals(...)`, `buildGovernanceConformanceSignals(...)`, `buildGovernancePolicySignals(...)`, and `mergeGovernanceSignals(...)`
|
|
204
|
+
- calculate metrics and health with `calculateGovernanceMetrics(...)` and `calculateGovernanceHealth(...)`
|
|
205
|
+
- build recommendations with `buildGovernanceRecommendations(...)`
|
|
206
|
+
- apply exception lifecycle and suppression with `evaluateGovernanceExceptionLifecycle(...)`, `applyGovernanceExceptions(...)`, and `buildGovernanceExceptionReport(...)`
|
|
207
|
+
- build higher-level delivery and AI artifacts with `buildDeliveryImpactAssessment(...)`, `buildManagementInsightsAiRequest(...)`, `summarizeManagementInsights(...)`, and the other deterministic AI request/summarizer helpers
|
|
208
|
+
|
|
219
209
|
## Package Boundaries
|
|
220
210
|
|
|
221
211
|
`@anarchitects/governance-core` is platform-independent.
|
package/dist/core/adapter.d.ts
CHANGED
|
@@ -62,4 +62,7 @@ export interface GovernanceDiagnostic {
|
|
|
62
62
|
details?: Record<string, unknown>;
|
|
63
63
|
}
|
|
64
64
|
export declare function buildGovernanceWorkspace(adapterResult: GovernanceWorkspaceAdapterResult, overrides?: ProfileOverrides): GovernanceWorkspace;
|
|
65
|
+
export declare const buildGovernanceInventory: typeof buildGovernanceWorkspace;
|
|
66
|
+
export declare const normalizeGovernanceWorkspace: typeof buildGovernanceWorkspace;
|
|
67
|
+
export declare const buildGovernanceWorkspaceFromAdapterResult: typeof buildGovernanceWorkspace;
|
|
65
68
|
//# sourceMappingURL=adapter.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/core/adapter.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/core/adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { AiAnalysisRequest, AiAnalysisResult, GovernanceAssessment, GovernanceDependency, MetricSnapshot, SnapshotComparison, SnapshotViolation } from './models.js';
|
|
2
|
+
import { DeliveryImpactAssessment } from './delivery-impact.js';
|
|
3
|
+
export interface BuildManagementInsightsAiRequestInput {
|
|
4
|
+
deliveryImpact: DeliveryImpactAssessment;
|
|
5
|
+
assessment?: GovernanceAssessment;
|
|
6
|
+
comparison?: SnapshotComparison;
|
|
7
|
+
generatedAt?: string;
|
|
8
|
+
profile?: string;
|
|
9
|
+
metadata?: Record<string, unknown>;
|
|
10
|
+
}
|
|
11
|
+
export declare function buildRootCauseRequest(params: {
|
|
12
|
+
profile: string;
|
|
13
|
+
snapshot: MetricSnapshot;
|
|
14
|
+
dependencies: GovernanceDependency[];
|
|
15
|
+
topViolations?: SnapshotViolation[];
|
|
16
|
+
metadata?: Record<string, unknown>;
|
|
17
|
+
}): AiAnalysisRequest;
|
|
18
|
+
export declare function buildPrImpactRequest(params: {
|
|
19
|
+
profile: string;
|
|
20
|
+
affectedProjects: string[];
|
|
21
|
+
dependencies: GovernanceDependency[];
|
|
22
|
+
metadata?: Record<string, unknown>;
|
|
23
|
+
}): AiAnalysisRequest;
|
|
24
|
+
export declare function buildScorecardRequest(params: {
|
|
25
|
+
profile: string;
|
|
26
|
+
snapshot: MetricSnapshot;
|
|
27
|
+
comparison?: SnapshotComparison;
|
|
28
|
+
metadata?: Record<string, unknown>;
|
|
29
|
+
}): AiAnalysisRequest;
|
|
30
|
+
export declare function buildOnboardingRequest(params: {
|
|
31
|
+
profile: string;
|
|
32
|
+
dependencies: GovernanceDependency[];
|
|
33
|
+
topViolations?: SnapshotViolation[];
|
|
34
|
+
metadata?: Record<string, unknown>;
|
|
35
|
+
}): AiAnalysisRequest;
|
|
36
|
+
export declare function buildCognitiveLoadRequest(params: {
|
|
37
|
+
profile: string;
|
|
38
|
+
affectedProjects: string[];
|
|
39
|
+
dependencies: GovernanceDependency[];
|
|
40
|
+
metadata?: Record<string, unknown>;
|
|
41
|
+
}): AiAnalysisRequest;
|
|
42
|
+
export declare function buildArchitectureRecommendationsRequest(params: {
|
|
43
|
+
profile: string;
|
|
44
|
+
dependencies: GovernanceDependency[];
|
|
45
|
+
topViolations?: SnapshotViolation[];
|
|
46
|
+
comparison?: SnapshotComparison;
|
|
47
|
+
metadata?: Record<string, unknown>;
|
|
48
|
+
}): AiAnalysisRequest;
|
|
49
|
+
export declare function buildSmellClustersRequest(params: {
|
|
50
|
+
profile: string;
|
|
51
|
+
dependencies: GovernanceDependency[];
|
|
52
|
+
topViolations?: SnapshotViolation[];
|
|
53
|
+
comparison?: SnapshotComparison;
|
|
54
|
+
metadata?: Record<string, unknown>;
|
|
55
|
+
}): AiAnalysisRequest;
|
|
56
|
+
export declare function buildRefactoringSuggestionsRequest(params: {
|
|
57
|
+
profile: string;
|
|
58
|
+
dependencies: GovernanceDependency[];
|
|
59
|
+
topViolations?: SnapshotViolation[];
|
|
60
|
+
comparison?: SnapshotComparison;
|
|
61
|
+
metadata?: Record<string, unknown>;
|
|
62
|
+
}): AiAnalysisRequest;
|
|
63
|
+
export declare function buildManagementInsightsAiRequest(input: BuildManagementInsightsAiRequestInput): AiAnalysisRequest;
|
|
64
|
+
export declare function rankTopViolations(violations: SnapshotViolation[], limit?: number): SnapshotViolation[];
|
|
65
|
+
export declare function summarizeRootCause(request: AiAnalysisRequest): AiAnalysisResult;
|
|
66
|
+
export declare function summarizePrImpact(request: AiAnalysisRequest): AiAnalysisResult;
|
|
67
|
+
export declare function summarizeScorecard(request: AiAnalysisRequest): AiAnalysisResult;
|
|
68
|
+
export declare function summarizeOnboarding(request: AiAnalysisRequest): AiAnalysisResult;
|
|
69
|
+
export declare function summarizeManagementInsights(request: AiAnalysisRequest): AiAnalysisResult;
|
|
70
|
+
export declare function summarizeArchitectureRecommendations(request: AiAnalysisRequest): AiAnalysisResult;
|
|
71
|
+
export declare function summarizeCognitiveLoad(request: AiAnalysisRequest): AiAnalysisResult;
|
|
72
|
+
export declare function summarizeSmellClusters(request: AiAnalysisRequest): AiAnalysisResult;
|
|
73
|
+
export declare function summarizeRefactoringSuggestions(request: AiAnalysisRequest): AiAnalysisResult;
|
|
74
|
+
//# sourceMappingURL=ai-analysis.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ai-analysis.d.ts","sourceRoot":"","sources":["../../src/core/ai-analysis.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { GovernanceCapability, GovernanceDiagnostic, GovernanceWorkspaceAdapterResult } from './adapter.js';
|
|
2
|
+
import { GovernanceExceptionApplicationResult } from './exception-runtime.js';
|
|
3
|
+
import { GovernanceExtensionDiagnostic, GovernanceExtensionHostContext, GovernanceExtensionRegistry } from '../extensions/index.js';
|
|
4
|
+
import { GovernanceAssessment, GovernanceWorkspace, Measurement, Recommendation, Violation } from './models.js';
|
|
5
|
+
import { GovernanceException } from './exceptions.js';
|
|
6
|
+
import { GovernanceProfile } from './profile.js';
|
|
7
|
+
import { GovernanceConformanceFinding, GovernanceGraphSnapshot } from './signal-builders.js';
|
|
8
|
+
import { GovernanceSignal } from './signals.js';
|
|
9
|
+
export interface BuildGovernanceAssessmentArtifactsInput {
|
|
10
|
+
profile: GovernanceProfile;
|
|
11
|
+
workspaceAdapterResult?: GovernanceWorkspaceAdapterResult;
|
|
12
|
+
workspace?: GovernanceWorkspace;
|
|
13
|
+
warnings?: string[];
|
|
14
|
+
exceptions?: GovernanceException[];
|
|
15
|
+
conformanceFindings?: GovernanceConformanceFinding[];
|
|
16
|
+
graphSnapshot?: GovernanceGraphSnapshot;
|
|
17
|
+
capabilities?: GovernanceCapability[];
|
|
18
|
+
diagnostics?: GovernanceDiagnostic[];
|
|
19
|
+
extensionRegistry?: GovernanceExtensionRegistry;
|
|
20
|
+
extensionContext?: GovernanceExtensionHostContext;
|
|
21
|
+
extensionDiagnostics?: GovernanceExtensionDiagnostic[];
|
|
22
|
+
asOf?: Date;
|
|
23
|
+
}
|
|
24
|
+
export interface GovernanceAssessmentArtifacts {
|
|
25
|
+
workspace: GovernanceWorkspace;
|
|
26
|
+
assessment: GovernanceAssessment;
|
|
27
|
+
violations: Violation[];
|
|
28
|
+
signals: GovernanceSignal[];
|
|
29
|
+
measurements: Measurement[];
|
|
30
|
+
recommendations: Recommendation[];
|
|
31
|
+
exceptionApplication: GovernanceExceptionApplicationResult;
|
|
32
|
+
extensionDiagnostics: GovernanceExtensionDiagnostic[];
|
|
33
|
+
capabilities: GovernanceCapability[];
|
|
34
|
+
diagnostics: GovernanceDiagnostic[];
|
|
35
|
+
}
|
|
36
|
+
export declare function buildGovernanceAssessmentArtifacts(input: BuildGovernanceAssessmentArtifactsInput): Promise<GovernanceAssessmentArtifacts>;
|
|
37
|
+
//# sourceMappingURL=assessment-artifacts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -12,5 +12,8 @@ export declare const missingDomainRule: SynchronousGovernanceRule;
|
|
|
12
12
|
export declare const missingLayerRule: SynchronousGovernanceRule;
|
|
13
13
|
export declare const coreBuiltInPolicyRules: GovernanceRule[];
|
|
14
14
|
export declare function evaluateCoreBuiltInPolicyViolations(context: GovernanceRuleContext): Violation[];
|
|
15
|
+
export declare function evaluateGovernancePolicies(workspace: GovernanceRuleContext['workspace'], profile: GovernanceRuleContext['profile']): Violation[];
|
|
16
|
+
export declare function evaluateGovernancePolicies(context: GovernanceRuleContext): Violation[];
|
|
17
|
+
export declare const evaluateBuiltInGovernancePolicies: typeof evaluateGovernancePolicies;
|
|
15
18
|
export {};
|
|
16
19
|
//# sourceMappingURL=built-in-rules.d.ts.map
|
|
@@ -1 +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"}
|
|
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;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"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { GovernanceAssessment, SnapshotComparison } from './models.js';
|
|
2
|
+
export type GovernanceAudience = 'management' | 'technical-lead' | 'developer';
|
|
3
|
+
export type GovernanceInsightCategory = 'cost-of-change' | 'time-to-market' | 'delivery-risk' | 'predictability' | 'maintainability' | 'ownership' | (string & {});
|
|
4
|
+
export interface GovernanceInsightDriver {
|
|
5
|
+
id: string;
|
|
6
|
+
label: string;
|
|
7
|
+
value?: number | string;
|
|
8
|
+
score?: number;
|
|
9
|
+
unit?: 'ratio' | 'count' | 'score';
|
|
10
|
+
trend?: 'improving' | 'stable' | 'worsening';
|
|
11
|
+
explanation?: string;
|
|
12
|
+
}
|
|
13
|
+
export interface GovernanceInsight {
|
|
14
|
+
id: string;
|
|
15
|
+
audience: GovernanceAudience;
|
|
16
|
+
category: GovernanceInsightCategory;
|
|
17
|
+
severity: 'low' | 'medium' | 'high';
|
|
18
|
+
title: string;
|
|
19
|
+
summary: string;
|
|
20
|
+
drivers: GovernanceInsightDriver[];
|
|
21
|
+
relatedMeasurements: string[];
|
|
22
|
+
relatedSignals: string[];
|
|
23
|
+
relatedViolations: string[];
|
|
24
|
+
}
|
|
25
|
+
export interface DeliveryImpactIndex {
|
|
26
|
+
id: string;
|
|
27
|
+
name: string;
|
|
28
|
+
score: number;
|
|
29
|
+
risk: 'low' | 'medium' | 'high';
|
|
30
|
+
trend?: 'improving' | 'stable' | 'worsening';
|
|
31
|
+
drivers: GovernanceInsightDriver[];
|
|
32
|
+
}
|
|
33
|
+
export interface DeliveryImpactAssessment {
|
|
34
|
+
generatedAt: string;
|
|
35
|
+
profile: string;
|
|
36
|
+
indices: DeliveryImpactIndex[];
|
|
37
|
+
insights: GovernanceInsight[];
|
|
38
|
+
drivers: GovernanceInsightDriver[];
|
|
39
|
+
}
|
|
40
|
+
export interface BuildDeliveryImpactAssessmentInput {
|
|
41
|
+
assessment: GovernanceAssessment;
|
|
42
|
+
comparison?: SnapshotComparison;
|
|
43
|
+
}
|
|
44
|
+
export declare function buildDeliveryImpactAssessment(input: BuildDeliveryImpactAssessmentInput): DeliveryImpactAssessment;
|
|
45
|
+
export declare const calculateDeliveryImpact: typeof buildDeliveryImpactAssessment;
|
|
46
|
+
export declare function summarizeDeliveryImpact(assessment: DeliveryImpactAssessment): string;
|
|
47
|
+
//# sourceMappingURL=delivery-impact.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"delivery-impact.d.ts","sourceRoot":"","sources":["../../src/core/delivery-impact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAIpB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAE/E,MAAM,MAAM,yBAAyB,GACjC,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACnC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,kCAAkC;IACjD,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAYD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,kCAAkC,GACxC,wBAAwB,CAqB1B;AAED,eAAO,MAAM,uBAAuB,sCAAgC,CAAC;AAErE,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,wBAAwB,GACnC,MAAM,CAiBR"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { GovernanceExceptionReport, GovernanceExceptionStatus, Violation } from './models.js';
|
|
2
|
+
import { GovernanceException } from './exceptions.js';
|
|
3
|
+
import { GovernanceConformanceFinding } from './signal-builders.js';
|
|
4
|
+
export interface GovernanceExceptionLifecycle {
|
|
5
|
+
exception: GovernanceException;
|
|
6
|
+
status: GovernanceExceptionStatus;
|
|
7
|
+
}
|
|
8
|
+
export interface GovernanceExceptionMatch {
|
|
9
|
+
exceptionId: string;
|
|
10
|
+
scopeKey: string;
|
|
11
|
+
specificity: number;
|
|
12
|
+
}
|
|
13
|
+
export interface GovernanceAppliedFinding<T> {
|
|
14
|
+
finding: T;
|
|
15
|
+
outcome: 'active' | 'suppressed';
|
|
16
|
+
matchedExceptionId?: string;
|
|
17
|
+
matchedExceptionStatus?: GovernanceExceptionStatus;
|
|
18
|
+
}
|
|
19
|
+
export interface GovernanceSuppressedFinding<T> {
|
|
20
|
+
finding: T;
|
|
21
|
+
outcome: 'suppressed';
|
|
22
|
+
matchedExceptionId: string;
|
|
23
|
+
}
|
|
24
|
+
export interface GovernanceExceptionApplicationResult {
|
|
25
|
+
declaredExceptions: GovernanceException[];
|
|
26
|
+
exceptionStatuses: Record<string, GovernanceExceptionStatus>;
|
|
27
|
+
policyViolations: GovernanceAppliedFinding<Violation>[];
|
|
28
|
+
conformanceFindings: GovernanceAppliedFinding<GovernanceConformanceFinding>[];
|
|
29
|
+
activePolicyViolations: Violation[];
|
|
30
|
+
suppressedPolicyViolations: GovernanceSuppressedFinding<Violation>[];
|
|
31
|
+
reactivatedPolicyViolations: GovernanceAppliedFinding<Violation>[];
|
|
32
|
+
activeConformanceFindings: GovernanceConformanceFinding[];
|
|
33
|
+
suppressedConformanceFindings: GovernanceSuppressedFinding<GovernanceConformanceFinding>[];
|
|
34
|
+
reactivatedConformanceFindings: GovernanceAppliedFinding<GovernanceConformanceFinding>[];
|
|
35
|
+
}
|
|
36
|
+
export interface ApplyGovernanceExceptionsInput {
|
|
37
|
+
exceptions: GovernanceException[];
|
|
38
|
+
policyViolations: Violation[];
|
|
39
|
+
conformanceFindings: GovernanceConformanceFinding[];
|
|
40
|
+
asOf: Date;
|
|
41
|
+
}
|
|
42
|
+
export declare function evaluateGovernanceExceptionLifecycle(exception: GovernanceException, asOf: Date): GovernanceExceptionLifecycle;
|
|
43
|
+
export declare function applyGovernanceExceptions(input: ApplyGovernanceExceptionsInput): GovernanceExceptionApplicationResult;
|
|
44
|
+
export declare function buildGovernanceExceptionReport(application: GovernanceExceptionApplicationResult): GovernanceExceptionReport;
|
|
45
|
+
export declare function createEmptyGovernanceExceptionReport(): GovernanceExceptionReport;
|
|
46
|
+
//# sourceMappingURL=exception-runtime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"exception-runtime.d.ts","sourceRoot":"","sources":["../../src/core/exception-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EACzB,yBAAyB,EAEzB,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,mBAAmB,EAKzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEzE,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,QAAQ,GAAG,YAAY,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,yBAAyB,CAAC;CACpD;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oCAAoC;IACnD,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAC7D,gBAAgB,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAAE,CAAC;IACxD,mBAAmB,EAAE,wBAAwB,CAAC,4BAA4B,CAAC,EAAE,CAAC;IAC9E,sBAAsB,EAAE,SAAS,EAAE,CAAC;IACpC,0BAA0B,EAAE,2BAA2B,CAAC,SAAS,CAAC,EAAE,CAAC;IACrE,2BAA2B,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAAE,CAAC;IACnE,yBAAyB,EAAE,4BAA4B,EAAE,CAAC;IAC1D,6BAA6B,EAAE,2BAA2B,CAAC,4BAA4B,CAAC,EAAE,CAAC;IAC3F,8BAA8B,EAAE,wBAAwB,CAAC,4BAA4B,CAAC,EAAE,CAAC;CAC1F;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,gBAAgB,EAAE,SAAS,EAAE,CAAC;IAC9B,mBAAmB,EAAE,4BAA4B,EAAE,CAAC;IACpD,IAAI,EAAE,IAAI,CAAC;CACZ;AAaD,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,IAAI,GACT,4BAA4B,CAsB9B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,oCAAoC,CAgDtC;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,oCAAoC,GAChD,yBAAyB,CA0E3B;AAED,wBAAgB,oCAAoC,IAAI,yBAAyB,CAShF"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { GovernanceTopIssue, HealthScore, HealthStatusThresholds, Measurement, Recommendation, Violation } from './models.js';
|
|
2
|
+
export type MetricWeights = Partial<Record<Measurement['id'], number>>;
|
|
3
|
+
export interface GovernanceHealthExplainabilityInput {
|
|
4
|
+
topIssues?: GovernanceTopIssue[];
|
|
5
|
+
projectHotspotLimit?: number;
|
|
6
|
+
}
|
|
7
|
+
export declare function calculateGovernanceHealth(measurements: Measurement[], metricWeights?: MetricWeights, statusThresholds?: Partial<HealthStatusThresholds>, explainabilityInput?: GovernanceHealthExplainabilityInput): HealthScore;
|
|
8
|
+
export declare const calculateHealthScore: typeof calculateGovernanceHealth;
|
|
9
|
+
export declare function buildGovernanceRecommendations(violations: Violation[], measurements: Measurement[]): Recommendation[];
|
|
10
|
+
export declare const buildRecommendations: typeof buildGovernanceRecommendations;
|
|
11
|
+
//# sourceMappingURL=health.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAGlB,WAAW,EAEX,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,SAAS,EACV,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,mCAAmC;IAClD,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,WAAW,EAAE,EAC3B,aAAa,GAAE,aAAkB,EACjC,gBAAgB,GAAE,OAAO,CAAC,sBAAsB,CAAoC,EACpF,mBAAmB,GAAE,mCAAwC,GAC5D,WAAW,CAiCb;AAED,eAAO,MAAM,oBAAoB,kCAA4B,CAAC;AAE9D,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,SAAS,EAAE,EACvB,YAAY,EAAE,WAAW,EAAE,GAC1B,cAAc,EAAE,CAwClB;AAED,eAAO,MAAM,oBAAoB,uCAAiC,CAAC"}
|
package/dist/core/index.d.ts
CHANGED
|
@@ -1,14 +1,21 @@
|
|
|
1
1
|
export * from './adapter.js';
|
|
2
|
+
export * from './ai-analysis.js';
|
|
2
3
|
export * from './assessment.js';
|
|
4
|
+
export * from './assessment-artifacts.js';
|
|
3
5
|
export * from './ai.js';
|
|
4
6
|
export * from './built-in-rule-pack.js';
|
|
5
7
|
export * from './built-in-rules.js';
|
|
8
|
+
export * from './delivery-impact.js';
|
|
6
9
|
export * from './drift.js';
|
|
10
|
+
export * from './exception-runtime.js';
|
|
7
11
|
export * from './models.js';
|
|
8
12
|
export * from './exceptions.js';
|
|
13
|
+
export * from './health.js';
|
|
14
|
+
export * from './metrics.js';
|
|
9
15
|
export * from './profile.js';
|
|
10
16
|
export * from './rule-engine.js';
|
|
11
17
|
export * from './rules.js';
|
|
18
|
+
export * from './signal-builders.js';
|
|
12
19
|
export * from './signals.js';
|
|
13
20
|
export * from './snapshots.js';
|
|
14
21
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/core/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}
|
|
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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { Measurement, GovernanceWorkspace } from './models.js';
|
|
2
|
+
import { GovernanceSignal } from './signals.js';
|
|
3
|
+
export interface CalculateGovernanceMetricsInput {
|
|
4
|
+
workspace: GovernanceWorkspace;
|
|
5
|
+
signals: GovernanceSignal[];
|
|
6
|
+
}
|
|
7
|
+
export declare function calculateGovernanceMetrics(input: CalculateGovernanceMetricsInput): Measurement[];
|
|
8
|
+
export declare const calculateMetrics: typeof calculateGovernanceMetrics;
|
|
9
|
+
//# sourceMappingURL=metrics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/core/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQrD,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,WAAW,EAAE,CA0Ef;AAED,eAAO,MAAM,gBAAgB,mCAA6B,CAAC"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { Violation } from './models.js';
|
|
2
|
+
import { GovernanceSignal, GovernanceSignalCategory, GovernanceSignalSeverity } from './signals.js';
|
|
3
|
+
export interface GovernanceGraphSnapshotProject {
|
|
4
|
+
id: string;
|
|
5
|
+
domain?: string;
|
|
6
|
+
}
|
|
7
|
+
export interface GovernanceGraphSnapshotDependency {
|
|
8
|
+
sourceProjectId: string;
|
|
9
|
+
targetProjectId: string;
|
|
10
|
+
type?: string;
|
|
11
|
+
}
|
|
12
|
+
export interface GovernanceGraphSnapshot {
|
|
13
|
+
extractedAt: string;
|
|
14
|
+
projects: GovernanceGraphSnapshotProject[];
|
|
15
|
+
dependencies: GovernanceGraphSnapshotDependency[];
|
|
16
|
+
}
|
|
17
|
+
export interface GovernanceConformanceFinding {
|
|
18
|
+
ruleId?: string;
|
|
19
|
+
projectId?: string;
|
|
20
|
+
relatedProjectIds: string[];
|
|
21
|
+
category: GovernanceSignalCategory;
|
|
22
|
+
severity: GovernanceSignalSeverity;
|
|
23
|
+
message: string;
|
|
24
|
+
metadata?: Record<string, unknown>;
|
|
25
|
+
}
|
|
26
|
+
export interface GovernanceConformanceSnapshot {
|
|
27
|
+
extractedAt: string;
|
|
28
|
+
findings: GovernanceConformanceFinding[];
|
|
29
|
+
}
|
|
30
|
+
export interface BuildGovernanceSignalsOptions {
|
|
31
|
+
graphSnapshot: GovernanceGraphSnapshot;
|
|
32
|
+
conformanceSnapshot?: GovernanceConformanceSnapshot;
|
|
33
|
+
policyViolations?: Violation[];
|
|
34
|
+
}
|
|
35
|
+
export declare function buildGovernanceGraphSignals(snapshot: GovernanceGraphSnapshot): GovernanceSignal[];
|
|
36
|
+
export declare function buildGovernanceConformanceSignals(snapshot: GovernanceConformanceSnapshot): GovernanceSignal[];
|
|
37
|
+
export declare function buildGovernancePolicySignals(violations: Violation[], options?: {
|
|
38
|
+
createdAt?: string;
|
|
39
|
+
}): GovernanceSignal[];
|
|
40
|
+
export declare function buildGovernanceSignals(options: BuildGovernanceSignalsOptions): GovernanceSignal[];
|
|
41
|
+
export declare function mergeGovernanceSignals(...signalGroups: GovernanceSignal[][]): GovernanceSignal[];
|
|
42
|
+
//# sourceMappingURL=signal-builders.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"signal-builders.d.ts","sourceRoot":"","sources":["../../src/core/signal-builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EAGzB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,8BAA8B,EAAE,CAAC;IAC3C,YAAY,EAAE,iCAAiC,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,uBAAuB,CAAC;IACvC,mBAAmB,CAAC,EAAE,6BAA6B,CAAC;IACpD,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;CAChC;AA8BD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,uBAAuB,GAChC,gBAAgB,EAAE,CA2EpB;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,6BAA6B,GACtC,gBAAgB,EAAE,CAMpB;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,gBAAgB,EAAE,CAMpB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,gBAAgB,EAAE,CAYpB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,YAAY,EAAE,gBAAgB,EAAE,EAAE,GACpC,gBAAgB,EAAE,CAUpB"}
|