@ai-sdlc/orchestrator 0.10.0 → 0.13.0

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