@harness-engineering/core 0.23.8 → 0.24.0

package/dist/architecture/matchers.mjs

@@ -2,7 +2,7 @@ import {
   archMatchers,
   archModule,
   architecture
-} from "../chunk-CE225WRK.mjs";
+} from "../chunk-NC4RPKD4.mjs";
 export {
   archMatchers,
   archModule,

package/dist/{chunk-CE225WRK.mjs → chunk-NC4RPKD4.mjs}

@@ -1,3 +1,9 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
 // src/architecture/types.ts
 import { z } from "zod";
 var ArchMetricCategorySchema = z.enum([
@@ -2848,6 +2854,7 @@ var archMatchers = {
 };
 
 export {
+  __export,
   createError,
   createEntropyError,
   Ok,

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { Result, LoadingLevel, SkillContextBudget, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerComment, TrackerSyncConfig, CINotifyOptions, Roadmap, FeatureStatus, SyncResult, ModelPricing, UsageRecord, DailyUsage, SessionUsage, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent, SolutionCategory, SanitizedResult, PulseConfig, PulseAdapter, PulseWindow } from '@harness-engineering/types';
+import { Result, LoadingLevel, SkillContextBudget, SessionSectionName, SessionEntry, SessionSections, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport, RoadmapFeature, ExternalTicket, ExternalTicketState, TrackerComment, TrackerSyncConfig, CINotifyOptions, Roadmap, FeatureStatus, SyncResult, Priority, ModelPricing, UsageRecord, DailyUsage, SessionUsage, SkillInvocationRecord, SkillAdoptionSummary, StabilityTier, TelemetryIdentity, TelemetryConfig, ConsentState, TelemetryEvent, SolutionCategory, SanitizedResult, PulseConfig, PulseAdapter, PulseWindow } from '@harness-engineering/types';
 export * from '@harness-engineering/types';
-export { BugTrackCategory, KnowledgeTrackCategory, PulseAdapter, PulseConfig, PulseDbSource, PulseRunStatus, PulseRunStatusType, PulseSources, PulseWindow, SanitizeFn, SanitizedResult, SolutionCategory, SolutionDocFrontmatter, SolutionTrack } from '@harness-engineering/types';
+export { BlockerRef, BugTrackCategory, Issue, IssueTrackerClient, KnowledgeTrackCategory, PulseAdapter, PulseConfig, PulseDbSource, PulseRunStatus, PulseRunStatusType, PulseSources, PulseWindow, SanitizeFn, SanitizedResult, SolutionCategory, SolutionDocFrontmatter, SolutionTrack, TrackerConfig } from '@harness-engineering/types';
 import { z } from 'zod';
 import { C as Collector, A as ArchConfig, a as ConstraintRule, M as MetricResult, b as ArchMetricCategory, c as ArchBaseline, d as ArchDiffResult, T as ThresholdConfig, V as ViolationHistory, e as Violation, f as ViolationSnapshot, E as EmergenceResult } from './matchers-DSibUtbV.mjs';
 export { g as ArchBaselineSchema, h as ArchConfigSchema, i as ArchDiffResultSchema, j as ArchHandle, k as ArchMetricCategorySchema, l as ArchitectureOptions, m as CategoryBaseline, n as CategoryBaselineSchema, o as CategoryRegression, p as CategoryRegressionSchema, q as ConstraintRuleSchema, r as EmergenceConfidence, s as EmergenceConfidenceSchema, t as EmergenceResultSchema, u as EmergentConstraintSuggestion, v as EmergentConstraintSuggestionSchema, w as MetricResultSchema, x as ThresholdConfigSchema, y as ViolationHistorySchema, z as ViolationSchema, B as ViolationSnapshotSchema, D as archMatchers, F as archModule, G as architecture } from './matchers-DSibUtbV.mjs';
@@ -29,7 +29,7 @@ interface BaseError {
  */
 interface ValidationError extends BaseError {
     /** Validation-specific error codes. */
-    code: 'INVALID_TYPE' | 'MISSING_FIELD' | 'VALIDATION_FAILED' | 'PARSE_ERROR';
+    code: 'INVALID_TYPE' | 'MISSING_FIELD' | 'VALIDATION_FAILED' | 'PARSE_ERROR' | 'ROADMAP_MODE_MISSING_TRACKER' | 'ROADMAP_MODE_FILE_PRESENT';
 }
 /**
  * Error type for context-related issues.
@@ -260,7 +260,7 @@ interface StructureValidation {
     conformance: number;
 }
 interface ConfigError extends ValidationError {
-    code: 'INVALID_TYPE' | 'MISSING_FIELD' | 'VALIDATION_FAILED';
+    code: 'INVALID_TYPE' | 'MISSING_FIELD' | 'VALIDATION_FAILED' | 'ROADMAP_MODE_MISSING_TRACKER' | 'ROADMAP_MODE_FILE_PRESENT';
     details: {
         zodError?: unknown;
         path?: string[];
@@ -374,6 +374,82 @@ declare function runFallbackRules(cwd: string): Promise<AgentConfigFinding[]>;
  */
 declare function validateAgentConfigs(cwd: string, options?: AgentConfigOptions): Promise<AgentConfigValidation>;
 
+/**
+ * Roadmap storage mode.
+ *
+ * - `file-backed` — `docs/roadmap.md` is canonical (today's behavior).
+ * - `file-less` — the configured external tracker is canonical; `docs/roadmap.md`
+ *   must not exist. Activated explicitly via `roadmap.mode: "file-less"` in
+ *   `harness.config.json` and validated by `validateRoadmapMode`.
+ *
+ * @see docs/changes/roadmap-tracker-only/proposal.md (Decision D5)
+ */
+type RoadmapMode = 'file-backed' | 'file-less';
+/**
+ * Narrow shape this helper inspects. Accepts any object that may have a
+ * `roadmap.mode` field; tolerates `undefined`, `null`, missing fields, and
+ * malformed values without throwing. The full Zod schema lives in CLI
+ * (`RoadmapConfigSchema` in `packages/cli/src/config/schema.ts`); this
+ * helper is intentionally tolerant so it can be called from any layer
+ * (orchestrator, dashboard, MCP tools) without re-validating.
+ */
+interface RoadmapModeConfig {
+    roadmap?: {
+        mode?: string | undefined;
+    } | null | undefined;
+}
+/**
+ * Returns the roadmap storage mode for a given Harness config.
+ *
+ * The canonical source of the `'file-backed'` default is
+ * `RoadmapConfigSchema.mode.default('file-backed')` in
+ * `packages/cli/src/config/schema.ts`. After Zod parses a config, the
+ * `roadmap.mode` field is always populated, and this helper returns it
+ * directly. This helper exists for pre-parse or unvalidated config shapes
+ * (e.g. handlers that accept partial configs from external callers) where
+ * the field may still be absent.
+ *
+ * Returns `'file-backed'` (the default) when:
+ *   - `config` is undefined or null
+ *   - `config.roadmap` is absent or null
+ *   - `config.roadmap.mode` is absent
+ *   - `config.roadmap.mode` is the string `'file-backed'`
+ *   - `config.roadmap.mode` is any other value (defensive — should never
+ *     happen if the config has been Zod-validated, but tolerated here)
+ *
+ * Returns `'file-less'` only when `config.roadmap.mode === 'file-less'`.
+ *
+ * @param config - A Harness config (or any shape with optional `roadmap.mode`).
+ * @returns `'file-backed'` or `'file-less'`.
+ */
+declare function getRoadmapMode(config: RoadmapModeConfig | undefined | null): RoadmapMode;
+
+/**
+ * Shape inspected by validateRoadmapMode. A superset of RoadmapModeConfig
+ * because we also need to detect tracker presence.
+ */
+interface RoadmapModeValidationConfig extends RoadmapModeConfig {
+    roadmap?: {
+        mode?: string | undefined;
+        tracker?: unknown;
+    } | null | undefined;
+}
+/**
+ * Validates the cross-cutting roadmap-mode invariants that Zod cannot express:
+ *
+ * Rule A: when `roadmap.mode === "file-less"`, `roadmap.tracker` MUST be configured.
+ * Rule B: when `roadmap.mode === "file-less"`, `docs/roadmap.md` MUST NOT exist.
+ *
+ * Rule A is checked first (structural error; file presence is recoverable).
+ *
+ * @param config - The loaded Harness config (post-Zod-parse).
+ * @param projectRoot - Absolute path to the project root (for `docs/roadmap.md` lookup).
+ * @returns Ok(undefined) if all rules pass; Err(ConfigError) on the first violation.
+ *
+ * @see docs/changes/roadmap-tracker-only/proposal.md (§Config schema)
+ */
+declare function validateRoadmapMode(config: RoadmapModeValidationConfig, projectRoot: string): Result<void, ConfigError>;
+
 interface AgentMapLink {
     text: string;
     path: string;
@@ -8081,6 +8157,392 @@ declare function scoreRoadmapCandidates(roadmap: Roadmap, options?: PilotScoring
  * Mutates roadmap in-place.
  */
 declare function assignFeature(roadmap: Roadmap, feature: RoadmapFeature, assignee: string, date: string): void;
+/**
+ * Mode-aware wrapper around `scoreRoadmapCandidates`. The roadmap-pilot skill
+ * (and any caller that needs to honor `roadmap.mode`) should call this instead
+ * of `scoreRoadmapCandidates` directly.
+ *
+ * Phase 4 behavior:
+ *   - `file-backed` (default) — delegates to `scoreRoadmapCandidates` unchanged.
+ *   - `file-less` — D4 sort: delegates to `scoreRoadmapCandidatesFileLess` which
+ *     orders eligible features by Priority then `createdAt` ascending.
+ *     The caller is expected to pass a `Roadmap` whose milestones' features
+ *     carry tracker fields (constructed from `RoadmapTrackerClient.fetchAll()`).
+ *
+ * @param roadmap - The roadmap (file-backed: parsed from docs/roadmap.md;
+ *                  file-less: synthesized from tracker fetchAll output).
+ * @param options - Pilot scoring options (currentUser etc.).
+ * @param config  - The Harness config (or any object with optional `roadmap.mode`);
+ *                  use `getRoadmapMode(config)` to resolve.
+ * @returns Scored candidates. Note: file-less results have zeroed
+ *          positionScore/dependentsScore/affinityScore/weightedScore — the
+ *          D4 sort is by `priorityTier` then issue creation order.
+ */
+declare function scoreRoadmapCandidatesForMode(roadmap: Roadmap, options: PilotScoringOptions, config: RoadmapModeConfig | undefined | null): ScoredCandidate[];
+
+/**
+ * Phase 2 wide tracker interface (file-less roadmap mode).
+ * See docs/changes/roadmap-tracker-only/proposal.md §"IssueTrackerClient interface".
+ *
+ * Named `RoadmapTrackerClient` (not `IssueTrackerClient`) to avoid colliding
+ * with the small interface lifted in Phase 1 (decision D-P2-A).
+ */
+
+interface TrackedFeature {
+    externalId: string;
+    name: string;
+    status: FeatureStatus;
+    summary: string;
+    spec: string | null;
+    plans: string[];
+    /**
+     * Feature **names** (NOT externalIds) authored in the body-meta `blocked_by:`
+     * field. The body-meta block is the canonical source for blockers per spec
+     * §"Body metadata block" — the adapter reads the names verbatim and writes
+     * them verbatim. Translation to externalIds (when needed) is a caller concern.
+     */
+    blockedBy: string[];
+    assignee: string | null;
+    priority: Priority | null;
+    milestone: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+}
+interface NewFeatureInput {
+    name: string;
+    summary: string;
+    status?: FeatureStatus;
+    spec?: string | null;
+    plans?: string[];
+    blockedBy?: string[];
+    priority?: Priority | null;
+    milestone?: string | null;
+    assignee?: string | null;
+}
+type FeaturePatch = Partial<Omit<TrackedFeature, 'externalId' | 'createdAt' | 'updatedAt'>>;
+type HistoryEventType = 'created' | 'claimed' | 'released' | 'completed' | 'updated' | 'reopened';
+interface HistoryEvent {
+    type: HistoryEventType;
+    actor: string;
+    at: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * ConflictError signals that a write would clobber an external change.
+ * Synthesized via refetch-and-compare on writes (D-P2-B); GitHub REST does
+ * not natively return 412 on issue PATCH.
+ *
+ * `serverUpdatedAt` carries the server-side `updatedAt` from the refetched
+ * state when available (null when the server omits it or when the adapter
+ * cannot determine it). Callers can use this to decide merge-vs-abort by
+ * recency (e.g. a recent server change favors abort; a stale one favors
+ * merge after a fresh refetch).
+ */
+declare class ConflictError extends Error {
+    readonly code: "TRACKER_CONFLICT";
+    readonly externalId: string;
+    readonly diff: Record<string, {
+        ours: unknown;
+        theirs: unknown;
+    }>;
+    readonly serverUpdatedAt: string | null;
+    constructor(externalId: string, diff: Record<string, {
+        ours: unknown;
+        theirs: unknown;
+    }>, serverUpdatedAt?: string | null, message?: string);
+}
+interface RoadmapTrackerClient {
+    fetchAll(): Promise<Result<{
+        features: TrackedFeature[];
+        etag: string | null;
+    }, Error>>;
+    fetchById(externalId: string): Promise<Result<{
+        feature: TrackedFeature;
+        etag: string;
+    } | null, Error>>;
+    fetchByStatus(statuses: FeatureStatus[]): Promise<Result<TrackedFeature[], Error>>;
+    create(feature: NewFeatureInput): Promise<Result<TrackedFeature, Error>>;
+    update(externalId: string, patch: FeaturePatch, ifMatch?: string): Promise<Result<TrackedFeature, ConflictError | Error>>;
+    claim(externalId: string, assignee: string, ifMatch?: string): Promise<Result<TrackedFeature, ConflictError | Error>>;
+    release(externalId: string, ifMatch?: string): Promise<Result<TrackedFeature, ConflictError | Error>>;
+    complete(externalId: string, ifMatch?: string): Promise<Result<TrackedFeature, ConflictError | Error>>;
+    appendHistory(externalId: string, event: HistoryEvent): Promise<Result<void, Error>>;
+    fetchHistory(externalId: string, limit?: number): Promise<Result<HistoryEvent[], Error>>;
+}
+
+/**
+ * Per-process LRU ETag cache. No cross-process invalidation.
+ * See spec §"ETag store" and decision D-P2-E (no third-party LRU).
+ *
+ * Key shapes used by the current GitHub adapter:
+ * - `feature:<externalId>` — set by fetchById on 200 with ETag (e.g. `feature:github:o/r#42`)
+ * - `list:all` — set by fetchAll on 200 with the last-page ETag
+ *
+ * The `list:` prefix is reserved for future per-status or per-filter list
+ * caches; today only `list:all` is written. invalidatePrefix('list:') wipes
+ * any `list:*` keys so future scoped-list caches will participate without
+ * additional plumbing in the adapter's write paths.
+ */
+declare class ETagStore {
+    private readonly max;
+    private readonly cache;
+    constructor(max?: number);
+    get(key: string): {
+        etag: string;
+        data: unknown;
+    } | null;
+    set(key: string, etag: string, data: unknown): void;
+    invalidate(key: string): void;
+    invalidateAll(): void;
+    /** Invalidate all keys matching a prefix. Used when writes invalidate `list:*`. */
+    invalidatePrefix(prefix: string): void;
+    get size(): number;
+}
+
+interface TrackerClientConfig {
+    kind: 'github-issues';
+    repo: string;
+    token?: string;
+    apiBase?: string;
+    selectorLabel?: string;
+    etagStore?: ETagStore;
+}
+declare function createTrackerClient(config: TrackerClientConfig): Result<RoadmapTrackerClient, Error>;
+
+/**
+ * Shared TRACKER_CONFLICT HTTP 409 body shape.
+ *
+ * Three endpoints emit this body when a `ConflictError` propagates from
+ * `RoadmapTrackerClient` writes (REV-P7-S5):
+ *
+ *   - S3 dashboard claim:         POST /api/actions/roadmap/claim
+ *   - S5 dashboard roadmap-status: POST /api/actions/roadmap-status
+ *   - S6 orchestrator append:      POST /api/roadmap/append
+ *
+ * Lifting the constructor here keeps the wire shape pinned in one place;
+ * the dashboard's `TrackerConflictBody` type and `isTrackerConflictBody`
+ * guard (in `packages/dashboard/src/shared/types.ts`) form the matching
+ * client-side contract. Drift between server emitters and the guard is
+ * what this helper exists to prevent.
+ */
+
+/**
+ * Public shape of the body emitted by `makeTrackerConflictBody`. Mirrors
+ * the dashboard's `TrackerConflictBody` type — the two MUST stay in
+ * lock-step. `conflictedWith` is `unknown` at the type level because the
+ * underlying `ConflictError.diff` is intentionally schemaless (the diff
+ * shape varies by adapter and by which field conflicted).
+ */
+interface TrackerConflictBody {
+    error: string;
+    code: 'TRACKER_CONFLICT';
+    externalId: string;
+    /** Server-side diff payload from ConflictError (shape varies). */
+    conflictedWith?: unknown;
+    refreshHint: 'reload-roadmap';
+}
+interface MakeTrackerConflictBodyOptions {
+    /**
+     * Override the value placed at `conflictedWith`. When omitted, the
+     * helper uses `err.diff` (the canonical server-side payload). Callers
+     * that want to surface a user-facing identity ("claimed by Bob") can
+     * pass a string here.
+     */
+    conflictedWith?: unknown;
+}
+/**
+ * Build the HTTP 409 TRACKER_CONFLICT response body from a ConflictError.
+ *
+ * @param err  - The `ConflictError` thrown by a `RoadmapTrackerClient` write.
+ * @param opts - Optional overrides. By default `conflictedWith` is `err.diff`.
+ * @returns The wire body, ready to be JSON-stringified.
+ */
+declare function makeTrackerConflictBody(err: ConflictError, opts?: MakeTrackerConflictBodyOptions): TrackerConflictBody;
+
+interface FileLessScoredCandidate {
+    feature: TrackedFeature;
+    priorityTier: number | null;
+}
+/**
+ * Local mirror of `PilotScoringOptions` to avoid an import cycle with
+ * `pilot-scoring.ts` (which imports this module's `scoreRoadmapCandidatesFileLess`).
+ * Keep this shape in sync with the canonical definition.
+ */
+interface FileLessScoringOptions {
+    currentUser?: string;
+}
+/**
+ * D4: Drop positional ordering in file-less mode; sort by Priority then issue
+ * creation order (createdAt ascending). Only `planned` and `backlog` features
+ * are eligible (parity with file-backed `isEligibleCandidate`). `blockedBy`
+ * filtering: a feature is excluded if any blocker name is in the input set
+ * AND that blocker is not 'done'. Caller is responsible for passing the full
+ * feature set so the function can compute this.
+ */
+declare function scoreRoadmapCandidatesFileLess(features: TrackedFeature[], _options: FileLessScoringOptions): FileLessScoredCandidate[];
+
+/**
+ * Resolve the project's roadmap mode from `<projectRoot>/harness.config.json`.
+ * Returns 'file-backed' on any error (missing file, invalid JSON, unreadable).
+ *
+ * D-P4-D: consolidates the four near-identical helpers across cli, dashboard,
+ * and orchestrator. Per-request reads are kept (tracker setup cost dwarfs fs I/O).
+ */
+declare function loadProjectRoadmapMode(projectRoot: string): RoadmapMode;
+
+/**
+ * Build a `TrackerClientConfig` from `<projectRoot>/harness.config.json`.
+ *
+ * REV-P4-5 consolidation (D-P5-G): single source of truth for the previously
+ * triplicated helper in cli (`mcp/tools/roadmap.ts`), dashboard
+ * (`server/routes/actions.ts`), and orchestrator
+ * (`server/routes/roadmap-actions.ts`).
+ *
+ * Maps `roadmap.tracker.kind === 'github'` (file-backed sync engine
+ * namespace) to the client-side `kind: 'github-issues'`. See
+ * `packages/cli/src/config/schema.ts:265` for the long-form note on the
+ * two namespaces.
+ */
+declare function loadTrackerClientConfigFromProject(projectRoot: string): Result<TrackerClientConfig, Error>;
+
+interface MigrationPlan {
+    /** Features to create via client.create(). */
+    toCreate: Array<{
+        name: string;
+        input: NewFeatureInput;
+    }>;
+    /** Features whose body-block differs from canonical; will be updated via client.update(). */
+    toUpdate: Array<{
+        externalId: string;
+        name: string;
+        patch: FeaturePatch;
+        diff: string;
+    }>;
+    /** Features whose body already matches; no-op at step 4. */
+    unchanged: Array<{
+        externalId: string;
+        name: string;
+    }>;
+    /** History events to append, deduplicated by hash against existing comments. */
+    historyToAppend: Array<{
+        externalId: string;
+        event: HistoryEvent;
+        hash: string;
+    }>;
+    /** Features in `roadmap.md` with no External-ID AND a same-titled existing issue (D-P5-E). */
+    ambiguous: Array<{
+        name: string;
+        existingIssueRef: string;
+    }>;
+}
+interface MigrationOptions {
+    /** Project root containing harness.config.json + docs/. */
+    projectRoot: string;
+    /** When true, run plan-only (steps 1-4 in-memory; no writes; no archive; no config rewrite). */
+    dryRun: boolean;
+}
+interface MigrationReport {
+    created: number;
+    updated: number;
+    unchanged: number;
+    historyAppended: number;
+    archivedFrom: string | null;
+    archivedTo: string | null;
+    configBackup: string | null;
+    mode: 'dry-run' | 'applied' | 'already-migrated' | 'aborted';
+    abortReason?: string;
+    /**
+     * Features that WERE created (with their new externalIds) when an abort
+     * happened during step 3 (create). Empty in the happy path. Operators use
+     * this to hand-record partial state.
+     */
+    createdSoFar?: Array<{
+        name: string;
+        externalId: string;
+    }>;
+}
+
+/**
+ * Build a migration plan from a parsed roadmap and the current tracker state.
+ *
+ * Inputs:
+ * - `roadmap` — parsed local `docs/roadmap.md`.
+ * - `existingFeatures` — `client.fetchAll().value.features` from the tracker.
+ * - `fetchHistoryHashes` — given an externalId, returns the set of `harness-history`
+ *   comment hashes already on that issue. Used for history-event dedup (D-P5-C).
+ * - `getRawBodyForExternalId` — given an externalId, returns the live raw issue body
+ *   (so we can parse the live BodyMeta for diff). Return null when the body is not
+ *   available; the feature will be treated as toUpdate to be safe.
+ */
+declare function buildMigrationPlan(roadmap: Roadmap, existingFeatures: TrackedFeature[], fetchHistoryHashes: (externalId: string) => Promise<Set<string>>, getRawBodyForExternalId: (externalId: string) => Promise<string | null>): Promise<MigrationPlan>;
+
+interface RunDeps {
+    readonly client: RoadmapTrackerClient;
+    readonly readFile: (p: string) => string;
+    readonly writeFile: (p: string, b: string) => void;
+    readonly renameFile: (from: string, to: string) => void;
+    readonly existsFile: (p: string) => boolean;
+}
+/**
+ * Execute a migration plan. Steps 3-7 from the migration spec:
+ *
+ *   3. Create features that lack External-IDs.
+ *   4. Update features whose body-meta diverges from canonical.
+ *   5. Append assignment-history events that lack a hash comment.
+ *   6. Archive `docs/roadmap.md` → `docs/roadmap.md.archived`.
+ *   7. Backup `harness.config.json` → `.pre-migration`, then rewrite
+ *      `roadmap.mode = 'file-less'`.
+ *
+ * Invariants:
+ * - Any abort in steps 1-5 short-circuits the run BEFORE archive (6) or config
+ *   rewrite (7). The report names which features were already created so the
+ *   operator can hand-recover.
+ * - `dryRun: true` runs steps 1-4 against the client but the test fixture wires
+ *   them so write methods throw; CLI dry-run uses a different plan-only path.
+ *   This core helper interprets `dryRun` as "skip steps 5-7": archive + config
+ *   are never touched, and the report is `mode: 'dry-run'`.
+ *   In tests we additionally route the client's write methods to fail, but that
+ *   is a test-only assertion: this helper simply does not invoke create/update/
+ *   appendHistory at all in dry-run.
+ * - Ambiguous entries → instant abort (D-P5-E).
+ * - Archive collision (`roadmap.md.archived` exists) → abort with reason
+ *   `archive-collision` (D-P5-D).
+ * - Config rewrite is byte-identical backup + `JSON.stringify(parsed, null, 2) + '\n'`
+ *   (D-P5-F).
+ */
+declare function runMigrationPlan(plan: MigrationPlan, deps: RunDeps, opts: MigrationOptions): Promise<Result<MigrationReport, Error>>;
+
+/** Short, deterministic, content-addressed hash of a history event. */
+declare function hashHistoryEvent(event: HistoryEvent): string;
+/** Returns the 8-hex hash embedded in a harness-history comment body, or null. */
+declare function parseHashFromCommentBody(commentBody: string): string | null;
+/** Build the canonical comment envelope for a history event. */
+declare function buildHistoryCommentBody(event: HistoryEvent): string;
+
+interface BodyMeta {
+    spec?: string | null;
+    plan?: string | null;
+    blocked_by?: string[];
+    priority?: Priority | null;
+    milestone?: string | null;
+}
+
+/** Field-by-field canonical comparison. Treats null/undefined/missing as equivalent. */
+declare function bodyMetaMatches(a: BodyMeta, b: BodyMeta): boolean;
+
+type index_MigrationOptions = MigrationOptions;
+type index_MigrationPlan = MigrationPlan;
+type index_MigrationReport = MigrationReport;
+type index_RunDeps = RunDeps;
+declare const index_bodyMetaMatches: typeof bodyMetaMatches;
+declare const index_buildHistoryCommentBody: typeof buildHistoryCommentBody;
+declare const index_buildMigrationPlan: typeof buildMigrationPlan;
+declare const index_hashHistoryEvent: typeof hashHistoryEvent;
+declare const index_parseHashFromCommentBody: typeof parseHashFromCommentBody;
+declare const index_runMigrationPlan: typeof runMigrationPlan;
+declare namespace index {
+  export { type index_MigrationOptions as MigrationOptions, type index_MigrationPlan as MigrationPlan, type index_MigrationReport as MigrationReport, type index_RunDeps as RunDeps, index_bodyMetaMatches as bodyMetaMatches, index_buildHistoryCommentBody as buildHistoryCommentBody, index_buildMigrationPlan as buildMigrationPlan, index_hashHistoryEvent as hashHistoryEvent, index_parseHashFromCommentBody as parseHashFromCommentBody, index_runMigrationPlan as runMigrationPlan };
+}
 
 declare const InteractionTypeSchema: z.ZodEnum<["question", "confirmation", "transition"]>;
 declare const QuestionSchema: z.ZodObject<{
@@ -9203,4 +9665,4 @@ declare function assembleCandidateReport(input: AssembleInput): string;
 
 declare const VERSION = "0.23.3";
 
-export { AGENT_DESCRIPTORS, AGREEMENT_LINE_GAP, ALLOWED_FIELD_KEYS, ALL_SOLUTION_CATEGORIES, ARCHITECTURE_DESCRIPTOR, type AST, type AcquireOptions, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentConfigFallbackReason, type AgentConfigFinding, type AgentConfigOptions, type AgentConfigSeverity, type AgentConfigValidation, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, type AnnotationIssue, type AnnotationIssueType, AnthropicCacheAdapter, type AppendLearningResult, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, type AssembleInput, BUG_DETECTION_DESCRIPTOR, BUG_TRACK_CATEGORIES, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, CINotifier, COMPLIANCE_DESCRIPTOR, CORROBORATED_AGREEMENT, type CacheAdapter, type CategoryForecast, CategoryForecastSchema, CategorySnapshotSchema, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodeSymbol, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, CompactionPipeline, type CompactionStrategy, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type CompoundLockHandle, CompoundLockHeldError, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, ContributingFeatureSchema, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_LOADER_CONFIG, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, DOMAIN_BASELINES, type DailyAdoption, type DataPoint, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type Direction$1 as Direction, DirectionSchema$1 as DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EMPTY_SUPPLY_CHAIN, EVIDENCE_SATURATION, EXTENSION_MAP, type EligibilityResult, EmergenceResult, type EmitEventInput, type EmitEventOptions, type EmitEventResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type EstimatorCoefficients, type EventType, type EvidenceCoverageReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type ExternalSyncOptions, FACTOR_WEIGHTS, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type FindingLifecycle, FindingLifecycleSchema, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, GeminiCacheAdapter, type GenerateRubricOptions, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GitScanOptions, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type GraphNode, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Hotspot$1 as Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type IsoWeek, type JSDocComment, KNOWLEDGE_TRACK_CATEGORIES, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type LoaderConfig, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, MOCK_ADAPTER_NAME, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, OpenAICacheAdapter, type OrchestratorResult, type OrphanedDep, type OutlineResult, type OverlapDimensions, type OverlapResult, PII_FIELD_DENYLIST, PII_LINE_RE, PII_TOKENS, type PackedEnvelope, type PaginatedSlice, type PaginationMeta, type ParallelGroups, type ParseError, type ParsedFile, type ParsedSection, type ParserLookup, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PilotScoringOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, PredictionEngine, type PredictionOptions, PredictionOptionsSchema, type RegressionResult as PredictionRegressionResult, RegressionResultSchema as PredictionRegressionResultSchema, type PredictionResult, PredictionResultSchema, type PredictionWarning, PredictionWarningSchema, type PricingCacheFile, type PricingDataset, type PriorReview, ProjectScanner, type PromoteResult, type ProtectedRegion, type ProtectedRegionMap, type ProtectionScope, type ProviderDefaults, type ProviderSystemBlock, type ProviderToolBlock, type PruneResult, PulseAdapterAlreadyRegisteredError, PulseConfigSchema, type PulseConfigValidation, PulseDbSourceSchema, PulseSourcesSchema, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionFit, type RegressionReport, type RegressionResult$1 as RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStage, type ReviewStrength, type Rubric, type RubricItem, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STANDALONE_AGREEMENT, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type Hotspot as ScanHotspot, type HotspotOptions as ScanHotspotOptions, type ScanResult, type ScannedCommit, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityCategorySnapshot, SecurityCategorySnapshotSchema, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type Direction as SecurityDirection, DirectionSchema as SecurityDirectionSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SecurityTimelineFile, SecurityTimelineFileSchema, SecurityTimelineManager, type SecurityTimelineSnapshot, SecurityTimelineSnapshotSchema, type SecurityTrendLine, SecurityTrendLineSchema, type SecurityTrendResult, SecurityTrendResultSchema, type SeedOptions, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SkillLoadPlan, SolutionDocFrontmatterSchema, type SolutionsDirValidation, type SourceFile, type Span, type SpanEvent, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StabilityTaggedBlock, type StaleConstraint, type StalenessEntry, type StalenessReport, type StepExecutor, type StrategySeed, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, type StructureValidation, type Suggestion, type SuggestionReport, type SupplyChainSnapshot, SupplyChainSnapshotSchema, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TimeToFixResult, TimeToFixResultSchema, type TimeToFixStats, TimeToFixStatsSchema, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type ToolDefinition, type Trace, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendAttribution, TrendAttributionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TrustScoreOptions, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VALIDATION_SCORES, VALID_SCOPES, VERSION, type ValidateFindingsOptions, type ValidationError, Violation, type ViolationCluster, ViolationHistory, ViolationHistoryManager, ViolationSnapshot, type WorkflowPhase, type WritePulseConfigOptions, acquireCompoundLock, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assembleCandidateReport, assembleReport, assertSanitized, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCacheSavings, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkOverlap, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearPulseAdapters, clearTaint, clusterViolations, collectEvents, computeContentHash, computeHotspots, computeLexicalSimilarity, computeLoadPlan, computeOverallSeverity, computeScanExitCode, computeTrustScores, computeWindow, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createRegionMap, createSelfReview, createStream, crossReferenceUndocumentedFixes, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectEmergentConstraints, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, detectStaleLearnings, determineAssessment, diff, emitEvent, estimateTokens, executeWorkflow, expressRules, extractBundle, extractDirectoryScope, extractFileReferences, extractHeadlines, extractIndexEntry, extractLevel, extractMarkdownLinks, extractSections, fanOutReview, findParallelGroups, formatCIReportAsMarkdown, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatIsoWeek, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateRubric, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, getOutline, getParser, getPhaseCategories, getPulseAdapter, getStreamForBranch, getTaintFilePath, getTrustLevel, getUpdateNotification, gitScan, goRules, injectionRules, insecureDefaultsRules, isDuplicateFinding, isRegression, isSanitizedResult, isSmallSuggestion, isUpdateCheckEnabled, isoWeek, listActiveSessions, listPulseAdapters, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, loadTrackerSyncConfig, logAgentAction, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, markProtectedFindings, mcpRules, migrateToStreams, networkRules, nodeRules, normalizeLearningContent, normalizeViolationPattern, paginate, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFileRegions, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseLookback, parseManifest, parseProtectedRegions, parseRoadmap, parseSections, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, registerMockAdapter, registerPulseAdapter, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runFallbackRules as runAgentConfigFallbackRules, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runPulse, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, searchSymbols, secretRules, securityFindingId, seedFromStrategy, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, splitBundlesByStage, stageDomains, suggestCategory, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentConfigs, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, validatePulseConfig, validateSolutionsDir, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writePulseConfig, writeSessionSummary, writeTaint, xssRules };
+export { AGENT_DESCRIPTORS, AGREEMENT_LINE_GAP, ALLOWED_FIELD_KEYS, ALL_SOLUTION_CATEGORIES, ARCHITECTURE_DESCRIPTOR, type AST, type AcquireOptions, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AdjustedForecast, AdjustedForecastSchema, type AgentAction, AgentActionEmitter, type AgentConfigFallbackReason, type AgentConfigFinding, type AgentConfigOptions, type AgentConfigSeverity, type AgentConfigValidation, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentReviewResult, type AgentType, type AgentsMapConfig, type AnnotationIssue, type AnnotationIssueType, AnthropicCacheAdapter, type AppendLearningResult, ArchBaseline, ArchBaselineManager, ArchConfig, ArchDiffResult, ArchMetricCategory, type AssembleInput, BUG_DETECTION_DESCRIPTOR, BUG_TRACK_CATEGORIES, type BaseError, type Baseline, BaselineManager, type BaselinesFile, type BenchmarkResult, type BenchmarkRunOptions, BenchmarkRunner, type BlueprintData, BlueprintGenerator, type BlueprintModule, type BlueprintOptions, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type BudgetedLearningsOptions, type Bundle, type BundleConstraints, BundleConstraintsSchema, BundleSchema, CACHE_TTL_MS, CINotifier, COMPLIANCE_DESCRIPTOR, CORROBORATED_AGREEMENT, type CacheAdapter, type CategoryForecast, CategoryForecastSchema, CategorySnapshotSchema, type ChangeType, type ChangedFile, ChecklistBuilder, type CircularDependency, CircularDepsCollector, type CircularDepsResult, type CleanupFinding, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodeSymbol, type CodebaseSnapshot, Collector, type CommentedCodeBlock, type CommitFormat, type CommitHistoryEntry, type CommitValidation, CompactionPipeline, type CompactionStrategy, ComplexityCollector, type ComplexityConfig, type ComplexityReport, type ComplexityThresholds, type ComplexityViolation, type CompoundLockHandle, CompoundLockHeldError, type ConfidenceTier, ConfidenceTierSchema, type ConfigError, type ConfigPattern, type Confirmation, ConfirmationSchema, ConflictError, type ConflictReport, ConsoleSink, type ConstraintError, type ConstraintNodeStore, ConstraintRule, type Content, type ContextBundle, type ContextError, type ContextFile, type ContextFilterResult, type ContextScopeOptions, ContributingFeatureSchema, type Contributions, ContributionsSchema, type Convention, CouplingCollector, type CouplingConfig, type CouplingReport, type CouplingThresholds, type CouplingViolation, type CoverageOptions, type CoverageReport, type CriticalPathEntry, CriticalPathResolver, type CriticalPathSet, type CustomRule, type CustomRuleResult, DEFAULT_LOADER_CONFIG, DEFAULT_PROVIDER_TIERS, DEFAULT_SECURITY_CONFIG, DEFAULT_STABILITY_THRESHOLDS, DEFAULT_STATE, DEFAULT_STREAM_INDEX, DEFAULT_TOKEN_BUDGET, DESTRUCTIVE_BASH, DOMAIN_BASELINES, type DailyAdoption, type DataPoint, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DeduplicateFindingsOptions, DepDepthCollector, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DetectStaleResult, type DiffInfo, type Direction$1 as Direction, DirectionSchema$1 as DirectionSchema, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EMPTY_SUPPLY_CHAIN, ETagStore, EVIDENCE_SATURATION, EXTENSION_MAP, type EligibilityResult, EmergenceResult, type EmitEventInput, type EmitEventOptions, type EmitEventResult, type EmitInteractionInput, EmitInteractionInputSchema, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type EstimatorCoefficients, type EventType, type EvidenceCoverageReport, ExclusionSet, type ExecutorHealth, type Export, type ExportMap, type ExternalSyncOptions, FACTOR_WEIGHTS, type FailureEntry, FailureEntrySchema, type FallbackPricingFile, type FanOutOptions, type FeaturePatch, type FeedbackAgentConfig, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, type FileLessScoredCandidate, FileSink, type FindingLifecycle, FindingLifecycleSchema, type FindingSeverity, type Fix, type FixConfig, type FixResult, type FixType, ForbiddenImportCollector, type ForbiddenImportViolation, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, GeminiCacheAdapter, type GenerateRubricOptions, type GenerationSection, type GitHubInlineComment, GitHubIssuesSyncAdapter, type GitScanOptions, type GraphAdapter, type GraphComplexityData, type GraphCouplingData, type GraphCoverageData, type GraphCriticalPathData, type GraphDependencyData, type GraphHarnessCheckData, type GraphImpactData, type GraphNode, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type HistoryEvent, type HistoryEventType, type Hotspot$1 as Hotspot, type HotspotContext, type Import, type InjectionFinding, type InjectionPattern, type InjectionSeverity, type InlineReference, type IntegrityReport, type InteractionType, InteractionTypeSchema, type InternalSymbol, type IsoWeek, type JSDocComment, KNOWLEDGE_TRACK_CATEGORIES, LITELLM_PRICING_URL, type LanguageParser, type Layer, type LayerConfig, LayerViolationCollector, type LearningPattern, type LearningsFrontmatter, type LearningsIndexEntry, type LiteLLMModelEntry, type LiteLLMPricingData, type LoadEventsOptions, type LoaderConfig, type Lockfile, type LockfilePackage, LockfilePackageSchema, LockfileSchema, type LogEntry, type LogFilter, MOCK_ADAPTER_NAME, type MakeTrackerConflictBodyOptions, type Manifest, ManifestSchema, type MechanicalCheckOptions, type MechanicalCheckResult, type MechanicalCheckStatus, type MechanicalFinding, type MergeResult, type Metric, MetricResult, type ModelProvider, type ModelTier, type ModelTierConfig, type ModuleDependency, ModuleSizeCollector, type NewFeatureInput, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, OpenAICacheAdapter, type OrchestratorResult, type OrphanedDep, type OutlineResult, type OverlapDimensions, type OverlapResult, PII_FIELD_DENYLIST, PII_LINE_RE, PII_TOKENS, type PackedEnvelope, type PaginatedSlice, type PaginationMeta, type ParallelGroups, type ParseError, type ParsedFile, type ParsedSection, type ParserLookup, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PilotScoringOptions, type PipelineContext, type PipelineFlags, type PipelineOptions, type PipelineResult, type PrMetadata, PredictionEngine, type PredictionOptions, PredictionOptionsSchema, type RegressionResult as PredictionRegressionResult, RegressionResultSchema as PredictionRegressionResultSchema, type PredictionResult, PredictionResultSchema, type PredictionWarning, PredictionWarningSchema, type PricingCacheFile, type PricingDataset, type PriorReview, ProjectScanner, type PromoteResult, type ProtectedRegion, type ProtectedRegionMap, type ProtectionScope, type ProviderDefaults, type ProviderSystemBlock, type ProviderToolBlock, type PruneResult, PulseAdapterAlreadyRegisteredError, PulseConfigSchema, type PulseConfigValidation, PulseDbSourceSchema, PulseSourcesSchema, type Question, QuestionSchema, REQUIRED_SECTIONS, type ReachabilityNode, RegressionDetector, type RegressionFit, type RegressionReport, type RegressionResult$1 as RegressionResult, type ReviewAgentDescriptor, type ReviewAssessment, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewDomain, type ReviewFinding, type ReviewItem, type ReviewOutputOptions, type ReviewPipelineResult, type ReviewStage, type ReviewStrength, type RoadmapMode, type RoadmapModeConfig, type RoadmapModeValidationConfig, type RoadmapTrackerClient, type Rubric, type RubricItem, type RuleOverride, RuleRegistry, type RunCIChecksInput, type RunPipelineOptions, SECURITY_DESCRIPTOR, STALENESS_WARNING_DAYS, STANDALONE_AGREEMENT, STATUS_RANK, type SafetyLevel, type ScanConfigFileResult, type ScanConfigFinding, type ScanConfigResult, type Hotspot as ScanHotspot, type HotspotOptions as ScanHotspotOptions, type ScanResult, type ScannedCommit, type ScoredCandidate, type SearchMatch, type SearchResult, type SecurityCategory, type SecurityCategorySnapshot, SecurityCategorySnapshotSchema, type SecurityConfidence, type SecurityConfig, SecurityConfigSchema, type Direction as SecurityDirection, DirectionSchema as SecurityDirectionSchema, type SecurityFinding, type SecurityRule, SecurityScanner, type SecuritySeverity, type SecurityTimelineFile, SecurityTimelineFileSchema, SecurityTimelineManager, type SecurityTimelineSnapshot, SecurityTimelineSnapshotSchema, type SecurityTrendLine, SecurityTrendLineSchema, type SecurityTrendResult, SecurityTrendResultSchema, type SeedOptions, type SelfReviewConfig, type SessionSummaryData, SharableBoundaryConfigSchema, SharableForbiddenImportSchema, SharableLayerSchema, SharableSecurityRulesSchema, type SizeBudgetConfig, type SizeBudgetReport, type SizeBudgetViolation, type SkillEvent, SkillEventSchema, type SkillExecutor, type SkillLoadPlan, SolutionDocFrontmatterSchema, type SolutionsDirValidation, type SourceFile, type Span, type SpanEvent, type SpecImpactEstimate, SpecImpactEstimateSchema, SpecImpactEstimator, SpecImpactSignalsSchema, type StabilityForecast, StabilityForecastSchema, type StabilityTaggedBlock, type StaleConstraint, type StalenessEntry, type StalenessReport, type StepExecutor, type StrategySeed, type StreamIndex, StreamIndexSchema, type StreamInfo, StreamInfoSchema, StructuralStrategy, type StructureValidation, type Suggestion, type SuggestionReport, type SupplyChainSnapshot, SupplyChainSnapshotSchema, type SupportedLanguage, type SuppressionRecord, type SymbolKind, type SyncChange, type SyncOptions, type TaintCheckResult, type TaintFinding, type TaintState, type TelemetryAdapter, type TelemetryHealth, ThresholdConfig, type TimeRange, type TimeToFixResult, TimeToFixResultSchema, type TimeToFixStats, TimeToFixStatsSchema, type CategorySnapshot as TimelineCategorySnapshot, type TimelineFile, TimelineFileSchema, TimelineManager, type TimelineSnapshot, TimelineSnapshotSchema, type TokenBudget, type TokenBudgetOverrides, type ToolDefinition, type Trace, type TrackedFeature, type TrackerClientConfig, type TrackerConflictBody, type TrackerSyncAdapter, type Transition, TransitionSchema, type TrendAttribution, TrendAttributionSchema, type TrendLine, TrendLineSchema, type TrendResult, TrendResultSchema, TruncationStrategy, type TrustScoreOptions, type TurnExecutor, TypeScriptParser, type UnfoldResult, type UnusedImport, type UpdateCheckState, VALIDATION_SCORES, VALID_SCOPES, VERSION, type ValidateFindingsOptions, type ValidationError, Violation, type ViolationCluster, ViolationHistory, ViolationHistoryManager, ViolationSnapshot, type WorkflowPhase, type WritePulseConfigOptions, acquireCompoundLock, addProvenance, agentConfigRules, aggregateByDay as aggregateAdoptionByDay, aggregateByDay$1 as aggregateByDay, aggregateBySession, aggregateBySkill, analyzeDiff, analyzeLearningPatterns, appendFailure, appendLearning, appendSessionEntry, applyFixes, applyHotspotDowngrade, applyRecencyWeights, applySyncChanges, archiveFailures, archiveLearnings, archiveSession, archiveStream, assembleCandidateReport, assembleReport, assertSanitized, assignFeature, buildDependencyGraph, buildExclusionSet, buildSnapshot, calculateCacheSavings, calculateCost, checkDocCoverage, checkEligibility, checkEvidenceCoverage, checkOverlap, checkTaint, classifyConfidence, classifyFinding, clearEventHashCache, clearFailuresCache, clearLearningsCache, clearPulseAdapters, clearTaint, clusterViolations, collectEvents, computeContentHash, computeHotspots, computeLexicalSimilarity, computeLoadPlan, computeOverallSeverity, computeScanExitCode, computeTrustScores, computeWindow, configureFeedback, constraintRuleId, contextBudget, contextFilter, countLearningEntries, createBoundaryValidator, createCommentedCodeFixes, createError, createFixes, createForbiddenImportFixes, createOrphanedDepFixes, createParseError, createRegionMap, createSelfReview, createStream, createTrackerClient, crossReferenceUndocumentedFixes, cryptoRules, deduplicateCleanupFindings, deduplicateFindings, deepMergeConstraints, defaultCollectors, defineLayer, deserializationRules, detectChangeType, detectCircularDeps, detectCircularDepsInFiles, detectComplexityViolations, detectCouplingViolations, detectDeadCode, detectDocDrift, detectEmergentConstraints, detectLanguage, detectPatternViolations, detectSizeBudgetViolations, detectStack, detectStaleConstraints, detectStaleLearnings, determineAssessment, diff, emitEvent, estimateTokens, executeWorkflow, expressRules, extractBundle, extractDirectoryScope, extractFileReferences, extractHeadlines, extractIndexEntry, extractLevel, extractMarkdownLinks, extractSections, fanOutReview, findParallelGroups, formatCIReportAsMarkdown, formatEventTimeline, formatFindingBlock, formatGitHubComment, formatGitHubSummary, formatIsoWeek, formatOutline, formatTerminalOutput, fullSync, generateAgentsMap, generateRubric, generateSuggestions, getActionEmitter, getExitCode, getFeedbackConfig, getInjectionPatterns, getModelPrice, getOrCreateInstallId, getOutline, getParser, getPhaseCategories, getPulseAdapter, getRoadmapMode, getStreamForBranch, getTaintFilePath, getTrustLevel, getUpdateNotification, gitScan, goRules, injectionRules, insecureDefaultsRules, isDuplicateFinding, isRegression, isSanitizedResult, isSmallSuggestion, isUpdateCheckEnabled, isoWeek, listActiveSessions, listPulseAdapters, listStreams, listTaintedSessions, loadBudgetedLearnings, loadEvents, loadFailures, loadHandoff, loadIndexEntries, loadPricingData, loadProjectRoadmapMode, loadRelevantLearnings, loadSessionSummary, loadState, loadStreamIndex, loadTrackerClientConfigFromProject, loadTrackerSyncConfig, logAgentAction, makeTrackerConflictBody, mapInjectionFindings, mapSecurityFindings, mapSecuritySeverity, markProtectedFindings, mcpRules, index as migrate, migrateToStreams, networkRules, nodeRules, normalizeLearningContent, normalizeViolationPattern, paginate, parseCCRecords, parseDateFromEntry, parseDiff, parseFile, parseFileRegions, parseFrontmatter, parseHarnessIgnore, parseLiteLLMData, parseLookback, parseManifest, parseProtectedRegions, parseRoadmap, parseSections, parseSecurityConfig, parseSize, pathTraversalRules, previewFix, projectValue, promoteSessionLearnings, pruneLearnings, reactRules, readAdoptionRecords, readCheckState, readCostRecords, readIdentity, readLockfile, readSessionSection, readSessionSections, readTaint, registerMockAdapter, registerPulseAdapter, removeContributions, removeProvenance, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resetParserCache, resolveConsent, resolveFileToLayer, resolveModelTier, resolveReverseStatus, resolveRuleSeverity, resolveSessionDir, resolveStability, resolveStreamPath, resolveThresholds, runFallbackRules as runAgentConfigFallbackRules, runAll, runArchitectureAgent, runBugDetectionAgent, runCIChecks, runComplianceAgent, runMechanicalChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, runPulse, runReviewPipeline, runSecurityAgent, saveHandoff, saveState, saveStreamIndex, scanForInjection, scopeContext, scoreRoadmapCandidates, scoreRoadmapCandidatesFileLess, scoreRoadmapCandidatesForMode, searchSymbols, secretRules, securityFindingId, seedFromStrategy, send, serializeEnvelope, serializeRoadmap, setActiveStream, sharpEdgesRules, shouldRunCheck, spawnBackgroundCheck, splitBundlesByStage, stageDomains, suggestCategory, syncConstraintNodes, syncFromExternal, syncRoadmap, syncToExternal, tagUncitedFindings, topSkills, touchStream, trackAction, unfoldRange, unfoldSymbol, updateSessionEntryStatus, updateSessionIndex, validateAgentConfigs, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateFindings, validateKnowledgeMap, validatePatternConfig, validatePulseConfig, validateRoadmapMode, validateSolutionsDir, violationId, weeksUntilThreshold, weightedLinearRegression, writeConfig, writeLockfile, writePulseConfig, writeSessionSummary, writeTaint, xssRules };