@ai-sdlc/orchestrator 0.9.0 → 0.13.0

package/dist/index.d.ts

@@ -22,8 +22,12 @@ export { computePriority, rankWorkItems, type PriorityScore, type PriorityInput,
 export { checkAction, enforceAction, DEFAULT_BLOCKED_ACTIONS, type ActionEnforcementResult, } from './action-enforcement.js';
 export { scoreIssueForAdmission, mapIssueToPriorityInput, type AdmissionInput, type AdmissionThresholds, type IssueAdmissionResult, type AuthorAssociation, type DesignSystemContext, type AutonomyContext, type CodeAreaQuality, type DesignAuthoritySignal, type DesignAuthoritySignalType, type DesignQualityMetrics, } from './admission-score.js';
 export { enrichAdmissionInput, computeDesignSystemReadiness, computeReadinessFromDesignSystemContext, computeDefectRiskFactor, computeAutonomyFactor, computeDesignAuthorityWeight, complexityToAutonomyLevel, type EnrichmentContext, type LifecyclePhase, } from './admission-enrichment.js';
-export { computeAdmissionComposite, type AdmissionComposite } from './admission-composite.js';
-export { parseBacklogTask, loadBacklogTaskFromRoot, mapBacklogTaskToAdmissionInput, loadSoulTracks, loadMaintainers, type BacklogTaskSnapshot, type BacklogAcceptanceCriterion, type BacklogMappingOptions, type BacklogAdmissionMapping, } from './backlog-adapter.js';
+export { computeAdmissionComposite, type AdmissionComposite, type AdmissionCompositeOptions, } from './admission-composite.js';
+export { resolveAffectedSouls, applyCrossSoulRule, computeTessellatedScores, type DepGraphSoulEntry, type SoulScores, type TessellationContext, type TessellatedSaResult, } from './tessellation-admission.js';
+export { detectTessellationDrift, DEFAULT_DIVERGENCE_THRESHOLD, type TessellationDriftRule, type TessellationDriftDetectedEvent, type AstScanDetails, type AstScanFinding, type CrossSoulProvenanceDetails, type CrossSoulProvenanceFinding, type SubstrateFile, type ProvenanceAuditEntry, type TessellationDriftConfig, type TessellationDriftInput, type TessellationDriftResult, } from './tessellation-drift.js';
+export { parseTargetedVariantRef, resolveTargetedVariants, applyCrossVariantRule, computeVariantScopedScores, defaultCrossSoulVariantRule, type VariantOverlay, type VariantDesignOverridesFramework, type VariantDesignOverridesExt, type VariantScores, type VariantConfig, type VariantAggregationRule, type WorkItemVariantTargeting, type VariantContext, type ParsedVariantRef, type VariantScopedSaResult, } from './variant-admission.js';
+export { combineVariantSaForSoulAlignment } from './admission-composite.js';
+export { parseBacklogTask, loadBacklogTaskFromRoot, mapBacklogTaskToAdmissionInput, loadSoulTracks, loadMaintainers, extractCodeAreaFromReferences, parseBodyReferences, type BacklogTaskSnapshot, type BacklogAcceptanceCriterion, type BacklogMappingOptions, type BacklogAdmissionMapping, } from './backlog-adapter.js';
 export { computePillarBreakdown, detectTensions, pillarSignalScore, type PillarBreakdown, type PillarContribution, type PillarName, type SharedDimensions, type TensionFlag, type TensionFlagType, type HcChannelBreakdown, } from './pillar-breakdown.js';
 export { compileDid, validatePhase2bReadiness, hashDidSpec, canonicalJson, tokenize, serializeForStore, deserializeFromStore, type CompiledDid, type CompiledScopeLists, type CompiledScopeEntry, type CompiledConstraintRule, type CompiledAntiPattern, type CompiledAntiPatternLists, type CompiledMeasurableSignal, type Bm25Corpus, type Bm25Document, type PrincipleCorpora, type ReadinessResult, } from './sa-scoring/did-compiler.js';
 export { HttpDepparseClient, FakeDepparseClient, DepparseError, type DepparseClient, type DepparseMatch, type DepparseMatchRequest, type DepparseMatchResponse, type DepparseHealth, type DepparseErrorKind, } from './sa-scoring/depparse-client.js';
@@ -36,6 +40,7 @@ export { SAFeedbackStore, SA_FEEDBACK_LABELS, classifyLabel, recordOverrideFeedb
 export { computeCalibrationCoefficient, buildCategoryCoefficients, type CategoryFeedback, type BuildCategoryCoefficientsInput, } from './calibration.js';
 export { autoCalibratePhaseWeights, computePhase3Weights, decideCalibrationDirection, renderCalibrationDiff, WEIGHT_FLOOR, WEIGHT_CEILING, DEFAULT_SHIFT_SIZE, DEFAULT_WINDOW_DAYS, PRECISION_DELTA_THRESHOLD, type PrecisionPair, type CalibrationDecision, type ComputePhase3WeightsInput, type AutoCalibrateDeps, type AutoCalibrateResult, type DimensionDiff, } from './sa-scoring/auto-calibrate.js';
 export { detectSoulDrift, computeWindowStats, computeTrend, describeDriftSource, DEFAULT_MEAN_THRESHOLD, DEFAULT_STDDEV_THRESHOLD, DEFAULT_CONSECUTIVE_WINDOWS, DEFAULT_RECOVERY_MS, type SoulDriftDetectedEvent, type DriftTrend, type WindowStats, type DriftDetectorDeps, } from './sa-scoring/drift-monitor.js';
+export { classifyDrift, deriveApprovalPath, computeConfidence, evaluateRevisionProposal, triggerConditionMet, isFieldLocked, isProposalExpired, archiveExpiredProposals, recordRejection, computeRejectionPrecedentFactor, DEFAULT_DISMISS_THRESHOLD, DEFAULT_DEMAND_MISALIGNMENT_THRESHOLD, DEFAULT_DRIFT_EVENTS_THRESHOLD, DEFAULT_TRIGGER_WINDOW_DAYS, DEFAULT_PROPOSAL_EXPIRY_DAYS, HEALTHY_ICP_MATCH_MIN, UNHEALTHY_ICP_MATCH_MAX, type DriftClassification, type IdentityClass, type ApprovalPath, type ProposalStatus, type ProposalConfidence, type ClassificationEvidence, type TriggerEvidence, type TriggerConditions, type TriggerConfig, type CalibrationLockConfig, type DIDRevisionProposalEvent, type SoulHealthDiagnosticEvent, type DIDRevisionProposalExpiredEvent, type ProposalRejectionRecord, type EvaluateRevisionProposalInput, type EvaluateRevisionProposalResult, } from './sa-scoring/revision-proposal.js';
 export { handleCoreIdentityChanged, type CoreIdentityChangedEvent, type BacklogReshuffledEvent, type SoulGraphStaleFlag, type RescoreDeps, type HandleResult, } from './sa-scoring/rescore-orchestrator.js';
 export { scoreSoulAlignment, resolveSoulAlignmentOverride, type ScoreSoulAlignmentInput, type ScoreSoulAlignmentDeps, type SoulAlignmentScoringResult, } from './sa-scoring/index.js';
 export type { SaDimension, FeedbackSignal } from './state/types.js';
@@ -47,6 +52,10 @@ export { createPipelineAdapterRegistry, createPipelineWebhookBridge, resolveAdap
 export { createPipelineReconciler, createGateReconciler, createAutonomyReconciler, hasResourceChanged, fingerprintResource, } from './reconcilers.js';
 export { createFileAuditLog, verifyAuditIntegrity, loadAuditEntries, rotateAuditLog, computeAuditHash, } from './audit-extended.js';
 export { checkFrameworkCompliance, getControlCatalog, getFrameworkMappings, listSupportedFrameworks, } from './compliance-extended.js';
+export { HARD_REGULATORY_REGIME_PREFIXES, isHardRegulatoryRegime, validateComplianceRegimes, computeComplianceClearance, type ValidateComplianceRegimesResult, type ComplianceViolation, type ComplianceViolationEntry, type SoulComplianceRegimes, type ComplianceClearanceContext, type ComplianceClearanceResult, } from './compliance-clearance.js';
+export { loadCompliancePosture, DEFAULT_COMPLIANCE_MANIFEST_PATH, type LoadCompliancePostureOptions, } from './compliance/loader.js';
+export { MissingComplianceAttestation, MissingDerivedGateOverrideNotes, UnknownRegime, CompliancePostureValidationError, } from './compliance/errors.js';
+export { BASELINE_DERIVED_GATES, BASELINE_POSTURE, type CompliancePosture, type Regime, type DerivedGates, type PartialDerivedGatesOverrides, type AuditExportSpec, } from './compliance/types.js';
 export { createSilentLogger, withPipelineSpanSync, getPipelineTracer, validateResourceSchema, } from './telemetry-extended.js';
 export { ClaudeCodeRunner, ClaudeCodeRunner as GitHubActionsRunner, GenericLLMRunner, CopilotRunner, CursorRunner, CodexRunner, RunnerRegistry, createRunnerRegistry, SecurityTriageRunner, ReviewAgentRunner, REVIEW_PROMPTS, type AgentRunner, type AgentContext, type AgentResult, type AgentProgressEvent, type GenericLLMConfig, type RegisteredRunner, type SecurityTriageConfig, type TriageVerdict, type ReviewAgentConfig, type ReviewType, type ReviewFinding, type ReviewVerdict, } from './runners/index.js';
 export type { TokenUsage } from './runners/index.js';
@@ -98,6 +107,9 @@ export { WorktreePoolManager, WorktreePoolError, WorktreeOwnershipError, determi
 export { HarnessRegistry, UnknownHarnessError, ClaudeCodeAdapter, CodexAdapter, createDefaultHarnessRegistry, probeVersion, matchesRange, enforceIndependence, validateIndependenceGraph, CyclicIndependenceConstraintError, type HarnessAdapter, type HarnessAvailability, type HarnessCapabilities, type HarnessEvent, type HarnessInput, type HarnessName, type HarnessRequires, type HarnessResult, type HarnessResultStatus, type ClaudeCodeAdapterDeps, type CodexAdapterDeps, type IndependenceResult, type UpstreamRun, type ToolDefinition, } from './harness/index.js';
 export { SubscriptionLedger, validateTenantShares, evaluateSchedule, CalibrationStore, COLD_START_DEFAULT, buildBurnDownReport, analyzeTier, PLAN_COSTS_USD, isOffPeakAt, nextOffPeakStart, ageInDays, freshnessLevel, DEFAULT_TENANT, COLD_START_DEFAULT_INPUT, COLD_START_DEFAULT_OUTPUT, ESTIMATE_VARIANCE_THRESHOLD, ROLLING_WINDOW_SIZE, type SubscriptionPlan, type Schedule, type TokenEstimate, type LedgerKey, type WindowState, type AdmissionDecision, type BurnDownReport, type LedgerEvent, type BillingMode, type QuotaSource, type OffPeakSchedule, type BurnDownInput, type CalibrationStoreDeps, type LedgerDeps, type ScheduleDecision, type ScheduleEvaluationContext, type Confidence, type ContentionEvent, type TierAnalysisInput, type TierAnalysisResult, type FreshnessLevel, } from './scheduling/index.js';
 export { DatabaseAdapterRegistry, UnknownDatabaseAdapterError, SqliteCopyAdapter, NeonAdapter, PgSnapshotRestoreAdapter, ExternalAdapter, createDefaultDatabaseAdapterRegistry, buildInjectionOverrides, parsePostgresUrl, maskConnectionString, enforceTopologyGuard, buildMigrationDivergedEvent, DatabaseBranchAdapterError, BranchTopologyForbiddenError, type DatabaseBranchAdapter, type DatabaseBranchCapabilities, type DatabaseBranchHandle, type DatabaseAdapterName, type ResolvedDatabaseBranchPool, type DatabaseAccess, type SqliteCopyAdapterDeps, type NeonAdapterDeps, type PgSnapshotRestoreAdapterDeps, type ExternalAdapterDeps, type InjectedEnvOverrides, type KnownInFlightBranches, type MigrationDivergedEvent, } from './database/index.js';
+export { AdapterCredentialInvalid, CommunityThreadSignalSourceAdapter, ManualSignalIncomplete, ManualSignalSourceAdapter, SignalSourceRegistry, SignalSourceUnavailable, SupportTicketSignalSourceAdapter, UnknownSignalSource, createDefaultSignalSourceRegistry, fetchSignalsFromAvailableAdapters, getSignalSourceAdapter, type AdapterCredentialInvalidDecision, type CommunityThreadAdapterOptions, type CustomerTier, type ManualSignalIncompleteDecision, type ManualSignalInput, type RawSignal, type SignalFetchResult, type SignalSourceAdapter, type SignalSourceName, type SignalTier, type SupportTicketAdapterOptions, } from './signal-ingestion/index.js';
+export { classifySignals, computeRecencyDecay, computeSignalWeight, resolveCustomerTier, resolveIcpResonance, tokenize as tokenizeSignalPayload, DEFAULT_SIGNAL_INGESTION_CONFIG, DEFAULT_SIGNAL_INGESTION_CONFIG_PATH, SignalIngestionConfigError, loadSignalIngestionConfig, type ClassificationResult, type ClassifiedSignal, type ClassifySignalsOptions, type ClusteringConfig, type CustomerTierRegistry, type ICPResonance, type IcpResonanceWeights, type LoadSignalIngestionConfigOptions, type SaResonanceThresholds, type SignalIngestionConfig, type SignalLanguageUnsupportedDecision, type Tier2SignificanceThreshold, type TierMultipliers, } from './signal-ingestion/index.js';
+export { aggregateD1FromClusters, composeD1Inputs, computeClusterD1, enrichDemandSignalFromClusters, type AggregatedD1Result, type ClusterD1Score, type ClusterMatcher, type ComposeD1InputsArgs, type ComposedD1Result, type D1CompositionWeights, type EnrichDemandSignalArgs, type EnrichDemandSignalResult, } from './signal-ingestion/index.js';
 export { StateWriter, appendEvent, readEvents, atomicWriteJson, listActiveStates, HEARTBEAT_INTERVAL_MS, HEARTBEAT_STALE_MS, type RuntimeState, type ArtifactEvent, type StageStatus, } from './artifacts/index.js';
 export { runWorkerPool, withMergeGate, forceReleaseMergeGate, isBranchUpToDate, MergeGateLockTimeoutError, decideRequeue, appendTriageHistory, type WorkItem, type WorkerPoolDeps, type WorkerPoolEvent, type WorkerPoolResult, type FailureEvent, type RequeueTrigger, type RequeueDecision, type RequeueDecisionInput, type TriageHistoryEntry, type FailureClassification, type MergeGateDeps, } from './dispatch/index.js';
 export { ModelRegistry, ModelRemovedError, UnknownAliasError, DEFAULT_REGISTRY, decideFromRawOutput, decideFromInvocationFailure, validateClassifierOutput, defaultRulesetDecision, appendCalibrationEntry, ALL_REVIEWERS, type ModelEntry, type ResolutionContext, type ResolutionResult, type ResolutionEvent, type ReviewerName, type ClassifierOutput, type ClassifierDecision, type FellOpenReason, type CalibrationLogEntry, type DiffSummary, } from './models/index.js';

package/dist/index.js

@@ -35,8 +35,12 @@ export { checkAction, enforceAction, DEFAULT_BLOCKED_ACTIONS, } from './action-e
 // Issue admission scoring
 export { scoreIssueForAdmission, mapIssueToPriorityInput, } from './admission-score.js';
 export { enrichAdmissionInput, computeDesignSystemReadiness, computeReadinessFromDesignSystemContext, computeDefectRiskFactor, computeAutonomyFactor, computeDesignAuthorityWeight, complexityToAutonomyLevel, } from './admission-enrichment.js';
-export { computeAdmissionComposite } from './admission-composite.js';
-export { parseBacklogTask, loadBacklogTaskFromRoot, mapBacklogTaskToAdmissionInput, loadSoulTracks, loadMaintainers, } from './backlog-adapter.js';
+export { computeAdmissionComposite, } from './admission-composite.js';
+export { resolveAffectedSouls, applyCrossSoulRule, computeTessellatedScores, } from './tessellation-admission.js';
+export { detectTessellationDrift, DEFAULT_DIVERGENCE_THRESHOLD, } from './tessellation-drift.js';
+export { parseTargetedVariantRef, resolveTargetedVariants, applyCrossVariantRule, computeVariantScopedScores, defaultCrossSoulVariantRule, } from './variant-admission.js';
+export { combineVariantSaForSoulAlignment } from './admission-composite.js';
+export { parseBacklogTask, loadBacklogTaskFromRoot, mapBacklogTaskToAdmissionInput, loadSoulTracks, loadMaintainers, extractCodeAreaFromReferences, parseBodyReferences, } from './backlog-adapter.js';
 export { computePillarBreakdown, detectTensions, pillarSignalScore, } from './pillar-breakdown.js';
 // RFC-0008 Addendum B — SA scoring (Layer 1/2/3 + composite)
 export { compileDid, validatePhase2bReadiness, hashDidSpec, canonicalJson, tokenize, serializeForStore, deserializeFromStore, } from './sa-scoring/did-compiler.js';
@@ -50,6 +54,7 @@ export { SAFeedbackStore, SA_FEEDBACK_LABELS, classifyLabel, recordOverrideFeedb
 export { computeCalibrationCoefficient, buildCategoryCoefficients, } from './calibration.js';
 export { autoCalibratePhaseWeights, computePhase3Weights, decideCalibrationDirection, renderCalibrationDiff, WEIGHT_FLOOR, WEIGHT_CEILING, DEFAULT_SHIFT_SIZE, DEFAULT_WINDOW_DAYS, PRECISION_DELTA_THRESHOLD, } from './sa-scoring/auto-calibrate.js';
 export { detectSoulDrift, computeWindowStats, computeTrend, describeDriftSource, DEFAULT_MEAN_THRESHOLD, DEFAULT_STDDEV_THRESHOLD, DEFAULT_CONSECUTIVE_WINDOWS, DEFAULT_RECOVERY_MS, } from './sa-scoring/drift-monitor.js';
+export { classifyDrift, deriveApprovalPath, computeConfidence, evaluateRevisionProposal, triggerConditionMet, isFieldLocked, isProposalExpired, archiveExpiredProposals, recordRejection, computeRejectionPrecedentFactor, DEFAULT_DISMISS_THRESHOLD, DEFAULT_DEMAND_MISALIGNMENT_THRESHOLD, DEFAULT_DRIFT_EVENTS_THRESHOLD, DEFAULT_TRIGGER_WINDOW_DAYS, DEFAULT_PROPOSAL_EXPIRY_DAYS, HEALTHY_ICP_MATCH_MIN, UNHEALTHY_ICP_MATCH_MAX, } from './sa-scoring/revision-proposal.js';
 export { handleCoreIdentityChanged, } from './sa-scoring/rescore-orchestrator.js';
 export { scoreSoulAlignment, resolveSoulAlignmentOverride, } from './sa-scoring/index.js';
 // PR review orchestration
@@ -67,6 +72,12 @@ export { createPipelineReconciler, createGateReconciler, createAutonomyReconcile
 export { createFileAuditLog, verifyAuditIntegrity, loadAuditEntries, rotateAuditLog, computeAuditHash, } from './audit-extended.js';
 // Extended compliance
 export { checkFrameworkCompliance, getControlCatalog, getFrameworkMappings, listSupportedFrameworks, } from './compliance-extended.js';
+// RFC-0009 Phase 4.1 — Eρ₅ Compliance Clearance
+export { HARD_REGULATORY_REGIME_PREFIXES, isHardRegulatoryRegime, validateComplianceRegimes, computeComplianceClearance, } from './compliance-clearance.js';
+// RFC-0022 Phase 1 — CompliancePosture schema + loader
+export { loadCompliancePosture, DEFAULT_COMPLIANCE_MANIFEST_PATH, } from './compliance/loader.js';
+export { MissingComplianceAttestation, MissingDerivedGateOverrideNotes, UnknownRegime, CompliancePostureValidationError, } from './compliance/errors.js';
+export { BASELINE_DERIVED_GATES, BASELINE_POSTURE, } from './compliance/types.js';
 // Extended telemetry
 export { createSilentLogger, withPipelineSpanSync, getPipelineTracer, validateResourceSchema, } from './telemetry-extended.js';
 // Runners
@@ -124,6 +135,12 @@ export { HarnessRegistry, UnknownHarnessError, ClaudeCodeAdapter, CodexAdapter,
 export { SubscriptionLedger, validateTenantShares, evaluateSchedule, CalibrationStore, COLD_START_DEFAULT, buildBurnDownReport, analyzeTier, PLAN_COSTS_USD, isOffPeakAt, nextOffPeakStart, ageInDays, freshnessLevel, DEFAULT_TENANT, COLD_START_DEFAULT_INPUT, COLD_START_DEFAULT_OUTPUT, ESTIMATE_VARIANCE_THRESHOLD, ROLLING_WINDOW_SIZE, } from './scheduling/index.js';
 // RFC-0010 database branching (DatabaseBranchAdapter framework + 4 adapters)
 export { DatabaseAdapterRegistry, UnknownDatabaseAdapterError, SqliteCopyAdapter, NeonAdapter, PgSnapshotRestoreAdapter, ExternalAdapter, createDefaultDatabaseAdapterRegistry, buildInjectionOverrides, parsePostgresUrl, maskConnectionString, enforceTopologyGuard, buildMigrationDivergedEvent, DatabaseBranchAdapterError, BranchTopologyForbiddenError, } from './database/index.js';
+// RFC-0030 Phase 1 — signal ingestion source adapters
+export { AdapterCredentialInvalid, CommunityThreadSignalSourceAdapter, ManualSignalIncomplete, ManualSignalSourceAdapter, SignalSourceRegistry, SignalSourceUnavailable, SupportTicketSignalSourceAdapter, UnknownSignalSource, createDefaultSignalSourceRegistry, fetchSignalsFromAvailableAdapters, getSignalSourceAdapter, } from './signal-ingestion/index.js';
+// RFC-0030 Phase 2 — classification (tier + ICP resonance + recency + language gate)
+export { classifySignals, computeRecencyDecay, computeSignalWeight, resolveCustomerTier, resolveIcpResonance, tokenize as tokenizeSignalPayload, DEFAULT_SIGNAL_INGESTION_CONFIG, DEFAULT_SIGNAL_INGESTION_CONFIG_PATH, SignalIngestionConfigError, loadSignalIngestionConfig, } from './signal-ingestion/index.js';
+// RFC-0030 Phase 5 — D1 formula reformulation + RFC-0008 PPA integration
+export { aggregateD1FromClusters, composeD1Inputs, computeClusterD1, enrichDemandSignalFromClusters, } from './signal-ingestion/index.js';
 // RFC-0010 artifacts (heartbeat + event stream + atomic JSON + state listing)
 export { StateWriter, appendEvent, readEvents, atomicWriteJson, listActiveStates, HEARTBEAT_INTERVAL_MS, HEARTBEAT_STALE_MS, } from './artifacts/index.js';
 // RFC-0010 dispatch (worker pool + merge gate + requeue)

package/dist/journey/inheritance-validator.d.ts

@@ -0,0 +1,396 @@
+/**
+ * RFC-0018 Phase 1 — Journey Inheritance Validator.
+ *
+ * Implements RFC-0018 §5.3 bounded-inheritance enforcement for journey
+ * declarations on Soul DIDs and Variants. When a violation is detected the
+ * validator emits a `JourneyInheritanceViolation` event (RFC-0008 §C5).
+ *
+ * Covers the following AC items (AISDLC-465):
+ *   AC #5: JourneyInheritanceViolation event emitted for all 5 violation classes.
+ *   AC #7: Journey count thresholds emit Decisions (journey-count-soft-warning at >=10;
+ *           journey-count-hard-limit-exceeded at >=50).
+ *   AC #8: State count thresholds emit Decisions (journey-state-count-soft-warning at >=12
+ *           with v1-workaround message; journey-state-count-hard-limit-exceeded at >=100).
+ *   AC #9: Nested journeys[] rejected at schema validation (schema-enforced flat, OQ-3).
+ *  AC #10: Decision: journey-sub-flow-activation-request Stage A counter wired.
+ *
+ * ### Bounded inheritance (§5.3)
+ *
+ * Journeys MUST NOT attempt to override the following fields inherited from
+ * the parent Soul DID (or Variant when scope=variant):
+ *
+ *   1. `complianceRegimes`    — per-soul (locked at soul/variant level)
+ *   2. `targetAudience`       — inherits from soul or variant
+ *   3. `substrateInvariants`  — locked at soul level
+ *   4. `complianceFloor`      — when scope=variant, MUST be 'inherit' (never a custom value)
+ *   5. `wcagLevel` lowering   — journeys MAY raise WCAG above parent but NEVER lower it
+ *
+ * ### Count + state limits (OQ-1, OQ-2)
+ *
+ * Per-org configurable via `.ai-sdlc/journey-config.yaml`:
+ *   journey.limits.softWarnAt (default 10) / journey.limits.hardLimit (default 50)
+ *   journey.stateLimits.softWarnAt (default 12) / journey.stateLimits.hardLimit (default 100)
+ *
+ * ### Nested-journey rejection (OQ-3)
+ *
+ * Schema-enforced flat: a journey declaration MUST NOT contain a `journeys[]`
+ * field. Emits `NestedJourneyRejected` (blocking).
+ *
+ * ### Sub-flow activation counter (OQ-3)
+ *
+ * Tracks distinct adopter requests for journey-sub-flow activation. When a
+ * journey declaration contains a nested `journeys[]` field, the validator:
+ *   1. Emits `NestedJourneyRejected` (blocking).
+ *   2. Records the request in the sub-flow activation counter.
+ *   3. When distinctAdopterCount >= threshold (default 2), marks
+ *      `promotedToOperatorReview: true` in the counter result, signalling
+ *      that a follow-on RFC discussion should be surfaced.
+ *
+ * @see spec/rfcs/RFC-0018-in-soul-journey-pattern.md §5.3 + §10.1
+ * @see orchestrator/src/variant/inheritance-validator.ts — parallel RFC-0017 validator
+ */
+/**
+ * Field names that are INHERITED from the parent Soul DID and cannot be
+ * overridden by any journey declaration. Attempting to declare these on a
+ * journey triggers a `JourneyInheritanceViolation`.
+ *
+ * Note: `complianceFloor` is validated separately (it must be 'inherit' when
+ * scope=variant, not merely absent) — see `validateComplianceFloor`.
+ */
+export declare const JOURNEY_INHERITED_LOCKED_FIELDS: readonly ["complianceRegimes", "targetAudience", "substrateInvariants"];
+export type JourneyInheritedLockedField = (typeof JOURNEY_INHERITED_LOCKED_FIELDS)[number];
+/**
+ * Numeric ordering for WCAG levels. Higher = stricter.
+ * Used to detect lowering of WCAG level below parent.
+ */
+export declare const WCAG_LEVEL_ORDER: Record<string, number>;
+/**
+ * Discriminated event kind for journey-level events emitted to events.jsonl.
+ */
+export type JourneyEventKind = 'JourneyInheritanceViolation' | 'JourneyCountSoftWarning' | 'JourneyCountHardLimitExceeded' | 'JourneyStateCountSoftWarning' | 'JourneyStateCountHardLimitExceeded' | 'NestedJourneyRejected';
+/**
+ * The 5 violation classes per RFC-0018 §5.3 bounded inheritance.
+ *
+ * Each violation class corresponds to a field (or semantic constraint)
+ * that a journey may NOT override from its parent Soul DID or Variant.
+ */
+export type JourneyViolationClass = 'complianceRegimes' | 'targetAudience' | 'substrateInvariants' | 'complianceFloor' | 'wcagLevel-lowered-below-parent';
+/**
+ * Emitted when a journey attempts to override an inherited locked field per
+ * RFC-0018 §5.3. This is an Engineering vertex error (RFC-0008 §C5).
+ *
+ * The result is `blocking: true` — the declaring Soul DID is invalid until
+ * the offending override is removed.
+ */
+export interface JourneyInheritanceViolation {
+    readonly kind: 'JourneyInheritanceViolation';
+    /** Identifier of the Soul DID that contains the offending journey. */
+    readonly soulId: string;
+    /** The journey's `id` field value. */
+    readonly journeyId: string;
+    /** The violation class (which inheritance constraint was broken). */
+    readonly violationClass: JourneyViolationClass;
+    /** Human-readable description of the violation. */
+    readonly message: string;
+    /** Always true — inheritance violations are blocking errors. */
+    readonly blocking: true;
+    readonly timestamp: string;
+}
+/**
+ * Non-blocking warning emitted when a Soul DID's journey count reaches the
+ * soft-warn threshold (default 10 per OQ-1). Routes through Decision Catalog
+ * as `Decision: journey-count-soft-warning` for operator batch review.
+ */
+export interface JourneyCountSoftWarning {
+    readonly kind: 'JourneyCountSoftWarning';
+    readonly soulId: string;
+    readonly journeyCount: number;
+    readonly threshold: number;
+    readonly message: string;
+    readonly blocking: false;
+    readonly timestamp: string;
+}
+/**
+ * Hard-blocking rejection emitted when a Soul DID's journey count reaches the
+ * hard limit (default 50 per OQ-1). The Soul DID declaration is rejected.
+ * Routes through Decision Catalog as `Decision: journey-count-hard-limit-exceeded`
+ * plus a clarification task.
+ */
+export interface JourneyCountHardLimitExceeded {
+    readonly kind: 'JourneyCountHardLimitExceeded';
+    readonly soulId: string;
+    readonly journeyCount: number;
+    readonly limit: number;
+    readonly message: string;
+    readonly blocking: true;
+    readonly timestamp: string;
+}
+/**
+ * Non-blocking warning emitted when a journey's state count reaches the
+ * soft-warn threshold (default 12 per OQ-2). Includes concrete v1 workaround
+ * message pointing at the split-journeys pattern.
+ */
+export interface JourneyStateCountSoftWarning {
+    readonly kind: 'JourneyStateCountSoftWarning';
+    readonly soulId: string;
+    readonly journeyId: string;
+    readonly stateCount: number;
+    readonly threshold: number;
+    readonly message: string;
+    readonly v1WorkaroundMessage: string;
+    readonly blocking: false;
+    readonly timestamp: string;
+}
+/**
+ * Hard-blocking rejection emitted when a journey's state count reaches the
+ * hard limit (default 100 per OQ-2). This is a sanity guard (typo /
+ * runaway-loop), NOT an architectural constraint.
+ */
+export interface JourneyStateCountHardLimitExceeded {
+    readonly kind: 'JourneyStateCountHardLimitExceeded';
+    readonly soulId: string;
+    readonly journeyId: string;
+    readonly stateCount: number;
+    readonly limit: number;
+    readonly message: string;
+    readonly blocking: true;
+    readonly timestamp: string;
+}
+/**
+ * Emitted when a nested `journeys[]` field is detected inside a journey
+ * declaration. Schema-enforced flat per RFC-0018 OQ-3. Blocking.
+ */
+export interface NestedJourneyRejected {
+    readonly kind: 'NestedJourneyRejected';
+    readonly soulId: string;
+    readonly journeyId: string;
+    readonly message: string;
+    readonly blocking: true;
+    readonly timestamp: string;
+}
+export type JourneyEvent = JourneyInheritanceViolation | JourneyCountSoftWarning | JourneyCountHardLimitExceeded | JourneyStateCountSoftWarning | JourneyStateCountHardLimitExceeded | NestedJourneyRejected;
+/**
+ * Result of the sub-flow activation counter check (OQ-3).
+ *
+ * Tracks distinct adopter requests for journey-sub-flow activation.
+ * When `distinctAdopterCount >= threshold`, `promotedToOperatorReview` is
+ * set to `true` — a signal to surface the topic for follow-on RFC discussion.
+ */
+export interface SubFlowActivationCounterResult {
+    readonly decision: 'journey-sub-flow-activation-request';
+    readonly distinctAdopterCount: number;
+    readonly threshold: number;
+    readonly promotedToOperatorReview: boolean;
+    readonly adopters: readonly string[];
+    readonly recommendation: string;
+}
+/**
+ * Minimal representation of one state declaration as loaded from a journey.
+ */
+export interface JourneyStateInput {
+    /** State identifier (kebab-case). */
+    id: string;
+    /** Whether this state is a terminal state. */
+    terminal?: boolean;
+    /** Whether this terminal state is a success state. */
+    successState?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Minimal accessibility block as loaded from a journey.
+ */
+export interface JourneyAccessibilityInput {
+    /** WCAG level declared on this journey. */
+    wcagLevel?: string;
+    [key: string]: unknown;
+}
+/**
+ * Minimal representation of one journey declaration as loaded from a Soul DID
+ * or Variant. Mirrors the JSON Schema shape at
+ * `spec/schemas/journey.v1.schema.json`.
+ */
+export interface JourneyDeclarationInput {
+    /** Kebab-case journey id. */
+    id: string;
+    /** Scope — 'soul' or 'variant:<id>'. */
+    scope?: string;
+    /** State declarations. */
+    states?: JourneyStateInput[];
+    /** Accessibility block (for WCAG-level inheritance check). */
+    accessibility?: JourneyAccessibilityInput;
+    /**
+     * Any additional fields present in the raw declaration — used to detect
+     * attempts to override locked inherited fields and nested journeys.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Per-org journey count configuration. Loaded from
+ * `.ai-sdlc/journey-config.yaml` (`journey.limits`) with the defaults below.
+ */
+export interface JourneyLimitsConfig {
+    /** Non-blocking soft warn threshold for journey count. Default: 10. */
+    softWarnAt?: number;
+    /** Hard-blocking rejection limit for journey count. Default: 50. */
+    hardLimit?: number;
+}
+/**
+ * Per-org journey state count configuration. Loaded from
+ * `.ai-sdlc/journey-config.yaml` (`journey.stateLimits`) with the defaults below.
+ */
+export interface JourneyStateLimitsConfig {
+    /** Non-blocking soft warn threshold for state count per journey. Default: 12. */
+    softWarnAt?: number;
+    /** Hard-blocking rejection limit for state count per journey. Default: 100. */
+    hardLimit?: number;
+    /** Optional operator-actionable message shown with soft-warn Decision. */
+    softWarnMessage?: string;
+}
+/**
+ * Per-org sub-flow activation counter configuration.
+ * Loaded from `.ai-sdlc/journey-config.yaml` (`journey.subJourneys`).
+ */
+export interface SubFlowActivationConfig {
+    /** Auto-promote threshold. Default: 2 distinct adopter requests. */
+    distinctAdopterRequestsThreshold?: number;
+}
+/**
+ * Options for `validateJourneyDeclarations`.
+ */
+export interface ValidateJourneyDeclarationsOptions {
+    /** Identifier of the Soul DID being validated (for event attribution). */
+    soulId: string;
+    /** Raw journey declarations from the Soul DID's or Variant's `spec.journeys[]`. */
+    journeys: JourneyDeclarationInput[];
+    /** Per-org or per-Soul limit overrides for journey count. */
+    limits?: JourneyLimitsConfig;
+    /** Per-org or per-Soul limit overrides for state count per journey. */
+    stateLimits?: JourneyStateLimitsConfig;
+    /**
+     * Parent WCAG level. When set, journeys with wcagLevel BELOW this are in violation.
+     * Journeys may RAISE the WCAG level above parent but NEVER LOWER it (§5.3).
+     */
+    parentWcagLevel?: string;
+    /** ISO 8601 timestamp to stamp on emitted events. Defaults to now. */
+    now?: string;
+}
+/** OQ-1 default: soft warn at 10 journeys (Miller 7±2 + industry advisory). */
+export declare const DEFAULT_JOURNEY_SOFT_WARN_AT = 10;
+/** OQ-1 default: hard limit at 50 journeys (Salesforce-style enterprise ceiling). */
+export declare const DEFAULT_JOURNEY_HARD_LIMIT = 50;
+/** OQ-2 default: soft warn at 12 states (Miller 7±2 + XState advisory + IEEE readability). */
+export declare const DEFAULT_STATE_SOFT_WARN_AT = 12;
+/**
+ * OQ-2 default: hard limit at 100 states (sanity guard, NOT architectural constraint).
+ * Regulatory-submission journeys with 25-40 states are legitimate.
+ */
+export declare const DEFAULT_STATE_HARD_LIMIT = 100;
+/**
+ * OQ-2 default v1 workaround message: operator-actionable guidance when
+ * a journey's state count reaches the soft-warn threshold.
+ */
+export declare const DEFAULT_STATE_SOFT_WARN_MESSAGE: string;
+/** OQ-3 default: auto-promote sub-flow activation at 2 distinct adopter requests. */
+export declare const DEFAULT_SUB_FLOW_ACTIVATION_THRESHOLD = 2;
+/**
+ * Validate a Soul DID's (or Variant's) `journeys[]` declarations against
+ * RFC-0018 §5.3 rules.
+ *
+ * Returns all emitted events. Callers check `event.blocking` to determine
+ * whether the Soul DID should be rejected. Caller's responsibility to write
+ * events to events.jsonl via the artifact layer.
+ *
+ * Validation rules (in order):
+ *
+ *   1. **Hard-limit check (OQ-1)** — if `journeys.length >= hardLimit`, emit
+ *      `JourneyCountHardLimitExceeded` (blocking). Continue to check individual
+ *      journeys for completeness of the error report.
+ *
+ *   2. **Soft-warn check (OQ-1)** — if `journeys.length >= softWarnAt` AND
+ *      below hard limit, emit `JourneyCountSoftWarning` (non-blocking).
+ *
+ *   3. **Per-journey checks** — for each journey:
+ *      a. Nested-journey rejection (OQ-3) — if journey has `journeys` key,
+ *         emit `NestedJourneyRejected` (blocking).
+ *      b. Inheritance violation check (§5.3) — for each locked field
+ *         (`complianceRegimes`, `targetAudience`, `substrateInvariants`), if
+ *         present on the journey emit `JourneyInheritanceViolation` (blocking).
+ *      c. `complianceFloor` check — if scope=variant and complianceFloor is
+ *         present but not 'inherit', emit `JourneyInheritanceViolation` (blocking).
+ *      d. WCAG-level lowering check — if parentWcagLevel provided and journey's
+ *         wcagLevel is LOWER than parent, emit `JourneyInheritanceViolation`
+ *         (blocking).
+ *      e. State count checks (OQ-2) — per-journey state count against
+ *         stateLimits.hardLimit / stateLimits.softWarnAt.
+ */
+export declare function validateJourneyDeclarations(options: ValidateJourneyDeclarationsOptions): JourneyEvent[];
+/**
+ * Convenience predicate: returns true when any event in the list is blocking.
+ * Use to decide whether to reject the Soul DID declaration.
+ */
+export declare function hasBlockingJourneyViolations(events: JourneyEvent[]): boolean;
+/**
+ * Represents a single adopter request for journey sub-flow (nested journey)
+ * activation. Used by `trackSubFlowActivationRequest` to accumulate distinct
+ * adopter signals.
+ */
+export interface SubFlowActivationRequest {
+    /** Adopter identifier (e.g. org slug, soul id, adopter name). Used for deduplication. */
+    requestedBy: string;
+    /** Journey the request pertains to (for context; not used in deduplication). */
+    journeyId?: string;
+    /** Soul the request pertains to (for context; not used in deduplication). */
+    soulId?: string;
+}
+/**
+ * Track a stage-A counter of distinct adopter requests for journey sub-flow
+ * activation (RFC-0018 OQ-3 resolution, AISDLC-465 AC #10).
+ *
+ * v1 does NOT activate sub-flows — this is a pure counter. Its purpose is to
+ * accumulate demand signal until `threshold` distinct adopters have requested
+ * the capability, at which point `promotedToOperatorReview: true` signals that
+ * a follow-on RFC discussion should be opened.
+ *
+ * Adopter deduplication is based on `request.requestedBy`. Multiple requests
+ * from the same adopter count as one distinct request.
+ *
+ * All requests route through RFC-0035 G0 (non-blocking pipeline contract).
+ *
+ * ### Usage
+ *
+ * ```ts
+ * const result = trackSubFlowActivationRequests([
+ *   { requestedBy: 'adopter-acme', journeyId: 'onboarding', soulId: 'spry-engage' },
+ *   { requestedBy: 'adopter-beta' },
+ * ], { distinctAdopterRequestsThreshold: 2 });
+ *
+ * // result.distinctAdopterCount === 2
+ * // result.promotedToOperatorReview === true  (threshold reached)
+ * ```
+ *
+ * @param requests  Accumulated adopter activation requests (may include duplicates).
+ * @param config    Per-org counter configuration (threshold defaults to 2).
+ */
+export declare function trackSubFlowActivationRequests(requests: SubFlowActivationRequest[], config?: SubFlowActivationConfig): SubFlowActivationCounterResult;
+/**
+ * Parse a `targetedJourneys` URI entry per RFC-0018 §6.1.
+ *
+ * Two forms:
+ *   - Soul-scoped:    `<soul-id>/<journey-id>`
+ *   - Variant-scoped: `<soul-id>/<variant-id>/<journey-id>`
+ *
+ * Returns `null` when the URI does not match either form.
+ */
+export interface ParsedTargetedJourneyRef {
+    readonly soulId: string;
+    readonly variantId?: string;
+    readonly journeyId: string;
+}
+/**
+ * Parse a `targetedJourneys` URI entry into its component parts.
+ *
+ * @param raw  Raw URI string from the work item's `targetedJourneys[]` field.
+ * @returns    Parsed components or null if the URI is malformed.
+ */
+export declare function parseTargetedJourneyRef(raw: string): ParsedTargetedJourneyRef | null;
+//# sourceMappingURL=inheritance-validator.d.ts.map