context-probe 0.1.0

package/dist/src/core/contracts/architecture-pattern-runtime.d.ts

@@ -0,0 +1,69 @@
+import type { TelemetryNormalizationRule } from "./architecture-normalization.js";
+export type ArchitecturePatternFamily = "layered" | "clean" | "hexagonal" | "modular-monolith" | "microservices" | "cqrs" | "event-driven";
+export interface LayeredPatternRuntimeObservationSet {
+    FailureContainmentScore?: number;
+    DependencyIsolationScore?: number;
+}
+export interface ServiceBasedPatternRuntimeObservationSet {
+    PartialFailureContainmentScore?: number;
+    RetryAmplificationScore?: number;
+    SyncHopDepthScore?: number;
+}
+export interface CqrsPatternRuntimeObservationSet {
+    ProjectionFreshnessScore?: number;
+    ReplayDivergenceScore?: number;
+    StaleReadAcceptabilityScore?: number;
+}
+export interface EventDrivenPatternRuntimeObservationSet {
+    DeadLetterHealthScore?: number;
+    ConsumerLagScore?: number;
+    ReplayRecoveryScore?: number;
+}
+export interface LayeredPatternRuntimeRawObservationSet {
+    FailureContainment?: number;
+    DependencyIsolation?: number;
+}
+export interface ServiceBasedPatternRuntimeRawObservationSet {
+    PartialFailureContainment?: number;
+    RetryAmplification?: number;
+    SyncHopDepth?: number;
+}
+export interface CqrsPatternRuntimeRawObservationSet {
+    ProjectionFreshness?: number;
+    ReplayDivergence?: number;
+    StaleReadAcceptability?: number;
+}
+export interface EventDrivenPatternRuntimeRawObservationSet {
+    DeadLetterHealth?: number;
+    ConsumerLag?: number;
+    ReplayRecovery?: number;
+}
+export interface ArchitecturePatternRuntimeObservationSet {
+    version: string;
+    patternFamily?: ArchitecturePatternFamily;
+    layeredRuntime?: LayeredPatternRuntimeObservationSet;
+    serviceBasedRuntime?: ServiceBasedPatternRuntimeObservationSet;
+    cqrsRuntime?: CqrsPatternRuntimeObservationSet;
+    eventDrivenRuntime?: EventDrivenPatternRuntimeObservationSet;
+    score?: number;
+    metrics?: Record<string, number>;
+    source?: string;
+    note?: string;
+}
+export interface ArchitecturePatternRuntimeRawObservationSet {
+    version: string;
+    patternFamily?: ArchitecturePatternFamily;
+    layeredRuntime?: LayeredPatternRuntimeRawObservationSet;
+    serviceBasedRuntime?: ServiceBasedPatternRuntimeRawObservationSet;
+    cqrsRuntime?: CqrsPatternRuntimeRawObservationSet;
+    eventDrivenRuntime?: EventDrivenPatternRuntimeRawObservationSet;
+    source?: string;
+    note?: string;
+}
+export interface ArchitecturePatternRuntimeNormalizationProfile {
+    version: string;
+    layeredRuntime?: Partial<Record<"FailureContainment" | "DependencyIsolation", TelemetryNormalizationRule>>;
+    serviceBasedRuntime?: Partial<Record<"PartialFailureContainment" | "RetryAmplification" | "SyncHopDepth", TelemetryNormalizationRule>>;
+    cqrsRuntime?: Partial<Record<"ProjectionFreshness" | "ReplayDivergence" | "StaleReadAcceptability", TelemetryNormalizationRule>>;
+    eventDrivenRuntime?: Partial<Record<"DeadLetterHealth" | "ConsumerLag" | "ReplayRecovery", TelemetryNormalizationRule>>;
+}

package/dist/src/core/contracts/architecture-pattern-runtime.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/architecture-scenarios.d.ts

@@ -0,0 +1,62 @@
+export type ScenarioDirection = "lower_is_better" | "higher_is_better";
+export interface ArchitectureScenario {
+    scenarioId: string;
+    name?: string;
+    qualityAttribute?: string;
+    stimulus?: string;
+    environment?: string;
+    response?: string;
+    responseMeasure?: {
+        metric?: string;
+        unit?: string;
+    };
+    direction: ScenarioDirection;
+    priority: number;
+    target: number;
+    worstAcceptable: number;
+}
+export interface ArchitectureScenarioCatalog {
+    version: string;
+    scenarios: ArchitectureScenario[];
+}
+export interface ArchitectureScenarioObservationTemplateEntry {
+    scenarioId: string;
+    name?: string;
+    qualityAttribute?: string;
+    priority: number;
+    measurementStatus: "needs_measurement";
+    note: string;
+}
+export interface ArchitectureScenarioObservationTemplate {
+    version: string;
+    scenarios: ArchitectureScenarioObservationTemplateEntry[];
+}
+export interface ScenarioObservation {
+    scenarioId: string;
+    observed: number;
+    source?: string;
+    note?: string;
+}
+export interface ScenarioObservationSet {
+    version: string;
+    observations: ScenarioObservation[];
+}
+export interface ArchitectureScenarioQualitySummary {
+    totalScenarios: number;
+    observedScenarios: number;
+    missingObservationScenarioIds: string[];
+    missingTopPriorityObservationIds: string[];
+    duplicateScenarioIds: string[];
+    findings: string[];
+}
+export type ArchitectureSourceType = "file" | "command";
+export interface ArchitectureCanonicalSourceConfig {
+    version: string;
+    sourceType: ArchitectureSourceType;
+    path?: string;
+    command?: string;
+    cwd?: string;
+    note?: string;
+}
+export interface ArchitectureScenarioObservationSourceConfig extends ArchitectureCanonicalSourceConfig {
+}

package/dist/src/core/contracts/architecture-scenarios.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/architecture-telemetry.d.ts

@@ -0,0 +1,47 @@
+import type { TelemetryNormalizationRule } from "./architecture-normalization.js";
+import type { ArchitecturePatternRuntimeObservationSet } from "./architecture-pattern-runtime.js";
+import type { ArchitectureCanonicalSourceConfig } from "./architecture-scenarios.js";
+export interface ArchitectureTelemetryBandObservation {
+    bandId: string;
+    trafficWeight: number;
+    LatencyScore?: number;
+    ErrorScore?: number;
+    SaturationScore?: number;
+}
+export interface ArchitectureTelemetryObservationSet {
+    version: string;
+    bands: ArchitectureTelemetryBandObservation[];
+}
+export interface ArchitectureTelemetryRawBandObservation {
+    bandId: string;
+    trafficWeight: number;
+    latencyP95?: number;
+    errorRate?: number;
+    saturationRatio?: number;
+}
+export interface ArchitectureTelemetryRawObservationSet {
+    version: string;
+    bands: ArchitectureTelemetryRawBandObservation[];
+}
+export interface ArchitectureTelemetryExportBand {
+    bandId: string;
+    trafficWeight: number;
+    latencyP95?: number;
+    errorRate?: number;
+    saturationRatio?: number;
+    source?: string;
+    window?: string;
+}
+export interface ArchitectureTelemetryExportBundle {
+    version: string;
+    sourceSystem?: string;
+    bands: ArchitectureTelemetryExportBand[];
+    patternRuntime?: ArchitecturePatternRuntimeObservationSet;
+    note?: string;
+}
+export interface ArchitectureTelemetrySourceConfig extends ArchitectureCanonicalSourceConfig {
+}
+export interface ArchitectureTelemetryNormalizationProfile {
+    version: string;
+    signals: Partial<Record<"LatencyScore" | "ErrorScore" | "SaturationScore", TelemetryNormalizationRule>>;
+}

package/dist/src/core/contracts/architecture-telemetry.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/architecture-topology.d.ts

@@ -0,0 +1,35 @@
+export interface ArchitectureTopologyNode {
+    nodeId: string;
+    kind: "service" | "datastore" | "queue" | "cache" | "gateway" | "worker" | "unknown";
+    isolationBoundary?: string;
+}
+export interface ArchitectureTopologyEdge {
+    source: string;
+    target: string;
+    kind: "sync_call" | "async_message" | "shared_resource" | "runtime_dependency";
+    shared?: boolean;
+}
+export interface ArchitectureTopologyModel {
+    version: string;
+    nodes: ArchitectureTopologyNode[];
+    edges: ArchitectureTopologyEdge[];
+}
+export interface TopologyRuntimeObservation {
+    nodeId?: string;
+    failureContainmentRatio?: number;
+    runtimeContainment?: number;
+    sharedDependencyIncidentRate?: number;
+    note?: string;
+}
+export interface TopologyRuntimeObservationSet {
+    version: string;
+    observations: TopologyRuntimeObservation[];
+}
+export interface ArchitectureBoundaryDefinition {
+    name: string;
+    pathGlobs: string[];
+}
+export interface ArchitectureBoundaryMap {
+    version: string;
+    boundaries: ArchitectureBoundaryDefinition[];
+}

package/dist/src/core/contracts/architecture-topology.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/architecture.d.ts

@@ -0,0 +1,9 @@
+export * from "./architecture-complexity.js";
+export * from "./architecture-constraints.js";
+export * from "./architecture-contract-baseline.js";
+export * from "./architecture-delivery.js";
+export * from "./architecture-normalization.js";
+export * from "./architecture-pattern-runtime.js";
+export * from "./architecture-scenarios.js";
+export * from "./architecture-telemetry.js";
+export * from "./architecture-topology.js";

package/dist/src/core/contracts/architecture.js

@@ -0,0 +1,9 @@
+export * from "./architecture-complexity.js";
+export * from "./architecture-constraints.js";
+export * from "./architecture-contract-baseline.js";
+export * from "./architecture-delivery.js";
+export * from "./architecture-normalization.js";
+export * from "./architecture-pattern-runtime.js";
+export * from "./architecture-scenarios.js";
+export * from "./architecture-telemetry.js";
+export * from "./architecture-topology.js";

package/dist/src/core/contracts/common.d.ts

@@ -0,0 +1,87 @@
+export declare const OUTPUT_VERSION = "1.0";
+export type CommandStatus = "ok" | "warning" | "error";
+export interface ProvenanceRef {
+    artifactId?: string;
+    path?: string;
+    line?: number;
+    fragmentId?: string;
+    revision?: string;
+    note?: string;
+}
+export interface Evidence {
+    evidenceId: string;
+    type: string;
+    statement: string;
+    confidence: number;
+    linkedEntities?: string[];
+    source: Record<string, unknown>;
+}
+export interface ProgressUpdate {
+    phase: string;
+    message: string;
+    elapsedMs?: number;
+}
+export type DecisionRiskLevel = "low" | "medium" | "high";
+export interface MeasurementQualitySummary {
+    unknownsCount: number;
+    metricUnknownCounts: Record<string, number>;
+    proxyMetrics: string[];
+    proxyRate: number;
+    approximationNotes: string[];
+    decisionRisk: DecisionRiskLevel;
+}
+export interface RuntimeStageSummary {
+    inputLoadMs?: number;
+    extractionMs?: number;
+    historyMs?: number;
+    analysisMs?: number;
+    renderMs?: number;
+    reviewMs?: number;
+    gateMs?: number;
+}
+export interface RuntimeSummary {
+    totalMs: number;
+    stages: RuntimeStageSummary;
+}
+export interface CommandResponseMeta {
+    measurementQuality?: MeasurementQualitySummary;
+    runtime?: RuntimeSummary;
+}
+export type ExtractionKind = "glossary" | "rules" | "invariants";
+export type ExtractionBackend = "heuristic" | "cli";
+export type ExtractionProviderName = "codex" | "claude";
+export interface ExtractionMetadata {
+    extractor: ExtractionBackend;
+    provider?: ExtractionProviderName;
+    promptProfile: string;
+    fallback: "heuristic" | "none";
+}
+export interface CommandResponse<T = unknown> {
+    status: CommandStatus;
+    result: T;
+    evidence: Evidence[];
+    confidence: number;
+    unknowns: string[];
+    diagnostics: string[];
+    progress: ProgressUpdate[];
+    provenance: ProvenanceRef[];
+    meta?: CommandResponseMeta;
+    version: string;
+}
+export interface Artifact {
+    artifactId: string;
+    type: "document" | "source_code" | "history" | "config" | "unknown";
+    path: string;
+    size: number;
+    hash: string;
+    collectedAt: string;
+}
+export interface Fragment {
+    fragmentId: string;
+    artifactId: string;
+    kind: "paragraph" | "heading";
+    text: string;
+    path: string;
+    lineStart: number;
+    lineEnd: number;
+}

package/dist/src/core/contracts/common.js

@@ -0,0 +1 @@
+export const OUTPUT_VERSION = "1.0";

package/dist/src/core/contracts/domain-design-score.d.ts

@@ -0,0 +1,14 @@
+import type { BoundaryLeakFinding, CochangeAnalysis, EvolutionLocalityModelComparison } from "./analysis.js";
+import type { DomainDesignPilotAnalysis, MetricScore } from "./governance.js";
+export interface DomainDesignShadowAnalysis {
+    localityModels: EvolutionLocalityModelComparison;
+}
+export interface DomainDesignScoreResult {
+    domainId: "domain_design";
+    metrics: MetricScore[];
+    leakFindings: BoundaryLeakFinding[];
+    history: CochangeAnalysis | null;
+    crossContextReferences: number;
+    shadow?: DomainDesignShadowAnalysis;
+    pilot?: DomainDesignPilotAnalysis;
+}

package/dist/src/core/contracts/domain-design-score.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/domain-design-shadow-rollout-batch.d.ts

@@ -0,0 +1,58 @@
+import type { CommandStatus } from "./common.js";
+export interface DomainDesignShadowRolloutBatchSpecEntry {
+    repoId: string;
+    repo: string;
+    model: string;
+    label?: string;
+    category?: string;
+    modelSource?: "repo_owned" | "versioned_manifest";
+    policy?: string;
+    tieTolerance?: number;
+}
+export interface DomainDesignShadowRolloutBatchSpec {
+    version: string;
+    policy?: string;
+    tieTolerance?: number;
+    entries: DomainDesignShadowRolloutBatchSpecEntry[];
+}
+export interface DomainDesignShadowRolloutBatchObservation {
+    repoId: string;
+    label?: string;
+    category: string;
+    modelSource: "repo_owned" | "versioned_manifest";
+    repoPath: string;
+    modelPath: string;
+    policyPath: string;
+    status: CommandStatus;
+    elsMetric: number;
+    persistenceLocalityScore: number;
+    policyDelta: number;
+    modelDelta: number;
+    driftCategory: "aligned" | "candidate_higher" | "candidate_lower";
+    relevantCommitCount: number;
+    confidence: number;
+    unknowns: string[];
+}
+export interface DomainDesignShadowRolloutBatchAggregate {
+    repoCount: number;
+    averageDelta: number;
+    weightedAverageDelta: number;
+    minDelta: number;
+    maxDelta: number;
+    deltaRange: number;
+    driftCounts: {
+        aligned: number;
+        candidateHigher: number;
+        candidateLower: number;
+    };
+}
+export interface DomainDesignShadowRolloutBatchCategorySummary {
+    category: string;
+    repoIds: string[];
+    summary: DomainDesignShadowRolloutBatchAggregate;
+}
+export interface DomainDesignShadowRolloutBatchResult {
+    observations: DomainDesignShadowRolloutBatchObservation[];
+    categories: DomainDesignShadowRolloutBatchCategorySummary[];
+    overall: DomainDesignShadowRolloutBatchAggregate;
+}

package/dist/src/core/contracts/domain-design-shadow-rollout-batch.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/domain-design-shadow-rollout-gate.d.ts

@@ -0,0 +1,46 @@
+export interface DomainDesignShadowRolloutGateObservation {
+    repoId: string;
+    category: string;
+    modelSource: "repo_owned" | "versioned_manifest";
+    modelPath?: string;
+    relevantCommitCount: number;
+    delta: number;
+}
+export interface DomainDesignShadowRolloutGateAggregate {
+    repoCount: number;
+    averageDelta: number;
+    weightedAverageDelta: number;
+    medianDelta: number;
+    minDelta: number;
+    maxDelta: number;
+    deltaRange: number;
+    positiveDeltaCount: number;
+    negativeDeltaCount: number;
+}
+export interface DomainDesignShadowRolloutGateCategorySummary {
+    category: string;
+    repoIds: string[];
+    summary: DomainDesignShadowRolloutGateAggregate;
+    gate: {
+        reasons: string[];
+        replacementVerdict: "go" | "no_go";
+        rolloutDisposition: "replace" | "shadow_only";
+    };
+}
+export interface DomainDesignShadowRolloutGateEvaluation {
+    observations: DomainDesignShadowRolloutGateObservation[];
+    repoCount: number;
+    repoOwnedCount: number;
+    versionedManifestCount: number;
+    overall: DomainDesignShadowRolloutGateAggregate;
+    categories: DomainDesignShadowRolloutGateCategorySummary[];
+    reasons: string[];
+    replacementVerdict: "go" | "no_go";
+    rolloutDisposition: "replace" | "shadow_only";
+}
+export interface DomainDesignShadowRolloutGateResult {
+    source: "registry" | "batch_spec";
+    registryPath?: string;
+    batchSpecPath?: string;
+    evaluation: DomainDesignShadowRolloutGateEvaluation;
+}

package/dist/src/core/contracts/domain-design-shadow-rollout-gate.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/domain-design-shadow-rollout-observation.d.ts

@@ -0,0 +1,17 @@
+import type { CochangeAnalysis } from "./analysis.js";
+import type { DomainDesignShadowAnalysis } from "./domain-design-score.js";
+import type { MetricScore } from "./governance.js";
+export interface DomainDesignShadowRolloutObservation {
+    domainId: "domain_design";
+    metricId: "ELS";
+    elsMetric: MetricScore;
+    shadow: DomainDesignShadowAnalysis;
+    observation: {
+        policyDelta: number;
+        modelDelta: number;
+        driftCategory: "aligned" | "candidate_higher" | "candidate_lower";
+        tieTolerance: number;
+    };
+    history: CochangeAnalysis | null;
+    crossContextReferences: number;
+}

package/dist/src/core/contracts/domain-design-shadow-rollout-observation.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/domain-design-shadow-rollout-registry.d.ts

@@ -0,0 +1,15 @@
+export interface DomainDesignShadowRolloutRegistryEntry {
+    repoId: string;
+    label?: string;
+    category: string;
+    modelSource: "repo_owned" | "versioned_manifest";
+    manifestPath?: string;
+    observation: {
+        relevantCommitCount: number;
+        delta: number;
+    };
+}
+export interface DomainDesignShadowRolloutRegistry {
+    version: string;
+    repos: DomainDesignShadowRolloutRegistryEntry[];
+}

package/dist/src/core/contracts/domain-design-shadow-rollout-registry.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/domain-design.d.ts

@@ -0,0 +1,5 @@
+export * from "./domain-design-score.js";
+export * from "./domain-design-shadow-rollout-batch.js";
+export * from "./domain-design-shadow-rollout-gate.js";
+export * from "./domain-design-shadow-rollout-observation.js";
+export * from "./domain-design-shadow-rollout-registry.js";

package/dist/src/core/contracts/domain-design.js

@@ -0,0 +1,5 @@
+export * from "./domain-design-score.js";
+export * from "./domain-design-shadow-rollout-batch.js";
+export * from "./domain-design-shadow-rollout-gate.js";
+export * from "./domain-design-shadow-rollout-observation.js";
+export * from "./domain-design-shadow-rollout-registry.js";

package/dist/src/core/contracts/domain-model.d.ts

@@ -0,0 +1,35 @@
+import type { Evidence } from "./common.js";
+export interface ContextDefinition {
+    name: string;
+    pathGlobs: string[];
+    contractGlobs?: string[];
+    internalGlobs?: string[];
+}
+export interface AggregateDefinition {
+    name: string;
+    context: string;
+    aliases?: string[];
+}
+export interface DomainModel {
+    version: string;
+    contexts: ContextDefinition[];
+    aggregates?: AggregateDefinition[];
+}
+export interface DomainContextCandidate {
+    definition: ContextDefinition;
+    confidence: number;
+    evidence: Evidence[];
+    unknowns: string[];
+}
+export interface DomainAggregateCandidate {
+    definition: AggregateDefinition;
+    confidence: number;
+    evidence: Evidence[];
+    unknowns: string[];
+}
+export interface DomainModelScaffoldResult {
+    model: DomainModel;
+    yaml: string;
+    contexts: DomainContextCandidate[];
+    aggregates: DomainAggregateCandidate[];
+}

package/dist/src/core/contracts/domain-model.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/governance-extraction.d.ts

@@ -0,0 +1,65 @@
+import type { Evidence, ExtractionProviderName } from "./common.js";
+export interface GlossaryTerm {
+    termId: string;
+    canonicalTerm: string;
+    aliases: string[];
+    count: number;
+    collision: boolean;
+    confidence: number;
+    evidence: Evidence[];
+    unknowns: string[];
+    fragmentIds: string[];
+}
+export interface RuleCandidate {
+    ruleId: string;
+    type: string;
+    statement: string;
+    confidence: number;
+    evidence: Evidence[];
+    unknowns: string[];
+    fragmentIds: string[];
+    relatedTerms?: string[];
+}
+export interface InvariantCandidate {
+    invariantId: string;
+    type: string;
+    statement: string;
+    confidence: number;
+    evidence: Evidence[];
+    unknowns: string[];
+    fragmentIds: string[];
+    relatedTerms?: string[];
+}
+export interface ExtractionProviderResult<T> {
+    items: T[];
+    confidence: number;
+    unknowns: string[];
+    diagnostics: string[];
+    provider: ExtractionProviderName;
+}
+export interface TraceLinkOccurrence {
+    kind: "document" | "code";
+    path: string;
+    fragmentId?: string;
+    matchCount: number;
+}
+export interface TermTraceLink {
+    termId: string;
+    canonicalTerm: string;
+    occurrences: TraceLinkOccurrence[];
+    coverage: {
+        documentHits: number;
+        codeHits: number;
+    };
+    confidence: number;
+}
+export interface ModelCodeLink {
+    context: string;
+    files: string[];
+    counts: {
+        contract: number;
+        internal: number;
+        unclassified: number;
+    };
+    coverage: number;
+}

package/dist/src/core/contracts/governance-extraction.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/contracts/governance-policy.d.ts

@@ -0,0 +1,23 @@
+export interface MetricThresholds {
+    warn?: number;
+    fail?: number;
+}
+export interface MetricPolicy {
+    formula: string;
+    thresholds?: MetricThresholds;
+}
+export interface DomainPolicy {
+    metrics: Record<string, MetricPolicy>;
+    review?: {
+        require_human_if?: string[];
+    };
+}
+export interface PolicyConfig {
+    profiles: Record<string, {
+        domains: Record<string, DomainPolicy>;
+        history_filters?: {
+            ignore_commit_patterns?: string[];
+            ignore_paths?: string[];
+        };
+    }>;
+}

package/dist/src/core/contracts/governance-policy.js

@@ -0,0 +1 @@
+export {};