nodedex 0.1.0

package/dist/middleware/reflect/types.d.ts

@@ -0,0 +1,261 @@
+export interface Pass0Result {
+    input_type: string;
+    projects: Array<{
+        name: string;
+        scope: string;
+    }>;
+    scope_project: {
+        name: string;
+        scope: string;
+    };
+    people: Array<{
+        name: string;
+        role: string;
+        signal_type: string;
+    }>;
+    actor_actions: Array<{
+        actor: string;
+        action: string;
+        object: string;
+        outcome?: string;
+    }>;
+    technologies: Array<{
+        name: string;
+        project?: string;
+        context?: string;
+    }>;
+    in_flight: string[];
+    causal_links: Array<{
+        cause: string;
+        effect: string;
+    }>;
+    replacements: Array<{
+        predecessor: string;
+        replacement: string;
+        function: string;
+    }>;
+    unchanged: string[];
+    scene_card_reasoning?: string;
+}
+export interface Pass1Item {
+    id: string;
+    text: string;
+    source: string;
+    excerpt: string;
+    provisional_type: string;
+    extends_id?: string;
+    uncertain?: boolean;
+    extraction_reasoning?: string;
+}
+export interface Pass1Result {
+    items: Pass1Item[];
+}
+export interface Pass2Item {
+    id: string;
+    text: string;
+    type: string;
+    project?: string;
+    unique?: Record<string, string>;
+    schema?: Record<string, string>;
+    triggered_by_items: string[];
+    based_on_items: string[];
+    extends_item?: string;
+    supersedes_ref?: string;
+    resolved_ref?: string;
+    relations?: Array<{
+        type: string;
+        target: string;
+        reasoning?: string;
+    }>;
+    note?: string;
+    review_reason?: string;
+    classification_reasoning?: string;
+    keep_reason?: string;
+    type_reasoning?: string;
+    source_type?: string;
+    excerpt?: string;
+}
+export interface Pass2CausalWiring {
+    item_id: string;
+    triggered_by: string[];
+    based_on: string[];
+}
+export interface Pass2Result {
+    skipped: Array<{
+        id: string;
+        reason: string;
+    }>;
+    classified: Pass2Item[];
+    causal_wiring?: Pass2CausalWiring[];
+}
+export interface Pass5Chain {
+    chain_label: string;
+    chain_essence: string;
+    arc: string;
+    conclusion: string;
+    members: string[];
+    reasoning: string;
+}
+export interface Pass5Result {
+    chains: Pass5Chain[];
+}
+export interface ArcEntityMention {
+    turn_id: string;
+    turn_number: number;
+    scope_project_name: string;
+    item_ids: string[];
+}
+export interface ArcEntityCluster {
+    canonical_name: string;
+    mentions: ArcEntityMention[];
+    evidence: {
+        shared_technologies: string[];
+        shared_entities: string[];
+        shared_concepts: string[];
+    };
+    reasoning: string;
+}
+export interface ArcEntityResolveResult {
+    clusters: ArcEntityCluster[];
+    unresolved_mentions?: ArcEntityMention[];
+    arc_resolve_reasoning?: string;
+    model?: string;
+    attempts?: Array<{
+        model: string;
+        outcome: string;
+    }>;
+}
+export type PipelineFlagType = 'project_dup_candidate' | 'atomic_dup_candidate' | 'scope_disagreement' | 'island_candidate' | 'block_dup_candidate' | 'cross_arc_dup_candidate' | 'entity_unresolved' | 'provenance_mismatch';
+export type ScopeCheck = 'same' | 'different' | 'unknown';
+export type PipelineFlagWriter = 'stage_flag_dedup' | 'stage_audit_islands' | 'stage_audit_scope' | 'stage_audit_project_dup' | 'stage_audit_block_dup' | 'inline_dedup' | 'stage_d_resolve' | 'stage_c_entity_resolve' | 'provenance_check';
+export type ReviewVerdict = 'merge' | 'leave' | 'split' | 'pending_clarification' | 'corrected' | 'demoted' | null;
+/** What the reviewer actually DID to the graph (audit trail). Per flag_type:
+ *  dup → archived_loser… · provenance → corrected_excerpt | demoted_unprovenanced. */
+export type FlagActionTaken = 'archived_loser_and_wired_superseded_by' | 'corrected_excerpt' | 'demoted_unprovenanced' | 'none' | null;
+export interface PipelineFlag {
+    id: string;
+    flag_type: PipelineFlagType;
+    block_id_a: string;
+    block_id_b: string | null;
+    criteria: Record<string, unknown>;
+    scope_check: ScopeCheck;
+    origin_writer: PipelineFlagWriter;
+    origin_range_id: string | null;
+    created_at: string;
+    reviewed_at: string | null;
+    review_verdict: ReviewVerdict;
+    review_reason: string | null;
+    action_taken: FlagActionTaken;
+    action_at: string | null;
+    winning_block_id: string | null;
+}
+export interface PipelineCheckpoint {
+    resumeFrom: 'pass1' | 'pass2' | 'pass3' | 'pass4';
+    pass0?: {
+        sceneCard: string | undefined;
+        raw: any;
+    };
+    pass1Items?: Pass1Item[];
+    pass2Classified?: Pass2Item[];
+    p3PendingBlockIds?: string[];
+    v2WallMs?: Record<string, number>;
+    v2FrontCostUsd?: Record<string, number>;
+    arcEntityResolution?: ArcEntityResolveResult;
+}
+export interface ReflectCreatedBlock {
+    label: string;
+    type: string;
+    quality: number;
+    project: string;
+}
+export interface ReflectUpdatedBlock {
+    label: string;
+    type: string;
+}
+export interface ReflectResult {
+    saved: number;
+    updated: number;
+    skipped: number;
+    saved_labels: string[];
+    uncertain_count: number;
+    created_blocks: ReflectCreatedBlock[];
+    updated_blocks: ReflectUpdatedBlock[];
+    checkpoint?: PipelineCheckpoint;
+}
+export type ReviewerConfidence = 'high' | 'medium' | 'low';
+/** Subset of database.ts Block that the reviewer prompt + merge action need.
+ *  Kept lean so the reviewer's input surface is auditable — adding a field
+ *  here means deliberately expanding what the LLM sees.  */
+export interface BlockReviewSnapshot {
+    id: string;
+    label: string;
+    type: string;
+    essence: string;
+    content: string;
+    concepts: string[];
+    project_id: string | null;
+    source: string | null;
+    primary_value: string;
+}
+export interface ReviewerContext {
+    flag: PipelineFlag;
+    block_a: BlockReviewSnapshot;
+    block_b: BlockReviewSnapshot | null;
+    scope_a_chain: string[];
+    scope_b_chain: string[] | null;
+}
+export interface ReviewerVerdictOutput {
+    verdict: ReviewVerdict;
+    reason: string;
+    winning_block_id?: string;
+    confidence: ReviewerConfidence;
+}
+export interface FlagReviewerTickResult {
+    reviewed: number;
+    verdicts: {
+        merge: number;
+        leave: number;
+        split: number;
+    };
+    actions_executed: number;
+    routed_to_agent: number;
+    errors: number;
+    cost_usd: number | null;
+}
+export interface StageAuditTickResult {
+    scanned_pairs: number;
+    flags_written: {
+        project_dup_candidate: number;
+        scope_disagreement: number;
+        island_candidate: number;
+        block_dup_candidate: number;
+    };
+    flags_skipped_already_pending: number;
+    errors: number;
+    wall_ms: number;
+}
+export interface FlagListFilters {
+    flag_type?: PipelineFlagType;
+    origin_writer?: PipelineFlagWriter;
+    reviewed?: boolean;
+    block_id?: string;
+    limit?: number;
+}
+/** Single-flag detail returned by GET /api/flags/:id — includes the two
+ *  blocks' content so the operator can SEE what was flagged without a
+ *  follow-up call. Mirrors quarantine.ts/single-entry shape. */
+export interface FlagDetailWithBlocks {
+    flag: PipelineFlag;
+    block_a: BlockReviewSnapshot | null;
+    block_b: BlockReviewSnapshot | null;
+}
+/** Body of POST /api/flags/:id/review — manual operator override.
+ *  When `execute=true` AND `verdict='merge'`, the route runs executeMerge
+ *  synchronously (charter Rule 2: archive loser, write supersedes relation). */
+export interface ManualReviewInput {
+    verdict: ReviewVerdict;
+    reason: string;
+    execute?: boolean;
+    winning_block_id?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/middleware/reflect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/types.ts"],"names":[],"mappings":"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"}

package/dist/middleware/reflect/types.js

@@ -0,0 +1,3 @@
+// ─── Pass 0 types ──────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/middleware/reflect/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/middleware/reflect/types.ts"],"names":[],"mappings":"AAAA,kFAAkF"}

package/dist/middleware/reflect/v2-integrate.d.ts

@@ -0,0 +1,120 @@
+import type { WorkspaceDB } from "../../store/database.js";
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { Pass2Item, PipelineCheckpoint } from "./types.js";
+import { type KnownRoot, type RecognizeRootsResult } from "./recognize-root.js";
+import { type JustifyResult } from "./justify-decisions.js";
+/** Existing project ROOTS as recognizer fuel: {label, essence}. essence is the
+ *  root's surface description (domain + owner), maintained by the describer —
+ *  the recognizer judges the new cluster against THIS, not the label string. */
+export declare function loadKnownRoots(db: WorkspaceDB): KnownRoot[];
+export interface IntegrateV2RootsResult {
+    /** items with .project remapped to an existing root label on a confident attach;
+     *  otherwise the input items unchanged. */
+    items: Pass2Item[];
+    /** true ⇔ the recognizer actually ran (flag ON AND >=1 existing root to match). */
+    ran: boolean;
+    /** the recognizer's batch outcome (candidates/attached/llm_calls), or null when skipped. */
+    recognition: RecognizeRootsResult | null;
+    /** number of items whose .project was rewritten to an existing root. */
+    rewritten: number;
+}
+/**
+ * v2 INTEGRATE — STEP 1: root recognition.
+ *
+ * For each NEW-root candidate cluster in the v2 fragment (an item.project that is
+ * not already an existing root), ask the recognizer "does this belong to an
+ * EXISTING root — same domain AND same owner?" On a confident attach, rewrite the
+ * cluster's items' .project to that root's EXACT label. Pass 3 (downstream) then
+ * finds it in KNOWN PROJECT ROOTS and attaches — no fork. Anything short of a
+ * confident same-owner fit keeps the new root (a fork is the safe failure; the
+ * post-hoc AUDIT-heal pass surfaces fork-pairs for the agent/user).
+ *
+ * Reuses the validated recognizer wholesale: recognizeRootsForArc (LLM judgment +
+ * the 5 guards + bias-to-fork) and applyRootRemap (pure remap). This function is
+ * the thin v2-side glue (load roots → recognize → apply). Default OFF →
+ * passthrough.
+ */
+export declare function integrateV2Roots(db: WorkspaceDB, provider: LLMProvider, items: Pass2Item[]): Promise<IntegrateV2RootsResult>;
+export interface V2FrontHalfResult {
+    /** resumeFrom:pass3 checkpoint, or NULL → the caller must fall back to the v1
+     *  path (COMPREHEND failed, SEAM 1 invalid, or no residue worth saving). */
+    checkpoint: PipelineCheckpoint | null;
+    reason?: "comprehend_failed" | "seam1_invalid" | "empty" | "insufficient_credit";
+    groups: number;
+    blocks: number;
+    filled: number;
+    recognizer: {
+        ran: boolean;
+        attached: number;
+        rewritten: number;
+    };
+    crossLinks: number;
+    selector?: {
+        ran: boolean;
+        dropped: number;
+        rescued: number;
+    };
+    merged?: number;
+    justify?: JustifyResult;
+}
+/**
+ * Run the v2 TRANSFORM front-half over a raw arc transcript:
+ *   COMPREHEND → SEAM 1 → convert → Pass 2b unique{}-fill (parallel) →
+ *   INTEGRATE (recognizer, default-OFF passthrough) → resumeFrom:pass3 checkpoint.
+ *
+ * Graph-aware only via the recognizer (COMPREHEND itself is graph-blind — it reads
+ * the transcript only). Returns checkpoint=null on any path where v2 should not
+ * produce a graph, so the caller can degrade to v1 (mirrors the arc path's
+ * graceful-degrade contract). Never throws on a bad fragment.
+ */
+export declare function mergeCrossGroupDupsEnabled(): boolean;
+/** Run the cross-group linker BEFORE the SELECTOR instead of after JUSTIFY (default OFF,
+ *  NODEDEX_V2_CROSSLINK_FIRST). Cross-link needs only id/type/text (not the filled
+ *  unique{}), so it can run right after convert — giving the judge each block's
+ *  cross-thread role before it decides keep/drop (its rescue then protects cross-group
+ *  deps, not just within-group), and pre-computing the cross-group links so they wire
+ *  across Pass-3 batches. The expensive 2b fill still runs AFTER the judge, so dropped
+ *  blocks never pay it. Off → cross-link runs in its original slot, byte-identical. */
+export declare function v2CrossLinkFirstEnabled(): boolean;
+/** Transcript size (chars) up to which ONE COMPREHEND call is the default.
+ *  Per-group exists ONLY to survive output-truncation on a BIG arc (the 307s
+ *  truncate-retry root cause); on input that fits one call it over-splits and
+ *  its N blind parallel PRODUCE calls re-extract shared claims → cross-group
+ *  dups + ~3× wall time (measured 2026-06-11: 1 group=175s vs 7 groups=554s on
+ *  comparable single turns). Env-tunable: NODEDEX_V2_HOLISTIC_MAX_CHARS. */
+export declare function holisticMaxChars(): number;
+/** Which COMPREHEND mode for this input — the size discriminator is structural,
+ *  so code decides (charter rule 3); `forced` (a caller's explicit opts.holistic)
+ *  always wins. Pure / testable. */
+export declare function chooseHolistic(transcriptLength: number, forced?: boolean): boolean;
+/**
+ * Collapse CROSS-GROUP DUPLICATES — the same residue extracted by multiple PRODUCE
+ * groups (per-group PRODUCE runs each group in isolation, so a claim relevant to
+ * several threads gets written once PER group → N copies of one block; the dup we
+ * proved via provenance: 3 "Leaky Bucket" blocks citing the identical source line).
+ *
+ * Keep ONE survivor; re-point every reference (causal fields + relations[].target)
+ * from the dropped copies → the survivor, and UNION the survivor's links so it stays
+ * connected to all the threads its copies touched. (This is "one block, many threads"
+ * — realized by links, because v2 groups are an extraction scaffold, not persisted
+ * graph entities; final chains come from causal edges.)
+ *
+ * KEY = type + unique{} primary_value (via extractPrimaryValueFromUnique — the SAME
+ * identity the block-dedup layer uses). Essence AND even the source excerpt DRIFT
+ * across per-group PRODUCE calls (each phrases its own summary, "AGENT:"-prefix vs
+ * not), but the primary_value — the approach / choice / limit — is STABLE, so it's
+ * what actually catches the real dups (validated against the dup run: excerpt+essence
+ * caught 0; primary_value catches them). Within one extraction, same type + same
+ * primary_value = the same claim → safe to merge (the established identity rule).
+ * MUST run AFTER 2b fill (primary_value is empty before that). Default OFF
+ * (NODEDEX_V2_MERGE_DUPS).
+ */
+export declare function mergeCrossGroupDups(items: Pass2Item[]): {
+    items: Pass2Item[];
+    merged: number;
+};
+export declare function runComprehendFrontHalf(db: WorkspaceDB, provider: LLMProvider, transcript: string, opts?: {
+    fillConcurrency?: number;
+    holistic?: boolean;
+}): Promise<V2FrontHalfResult>;
+//# sourceMappingURL=v2-integrate.d.ts.map

package/dist/middleware/reflect/v2-integrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-integrate.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/v2-integrate.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAa,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAMnF;;gFAEgF;AAChF,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,EAAE,CAK3D;AAED,MAAM,WAAW,sBAAsB;IACrC;+CAC2C;IAC3C,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mFAAmF;IACnF,GAAG,EAAE,OAAO,CAAC;IACb,4FAA4F;IAC5F,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACzC,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,SAAS,EAAE,GACjB,OAAO,CAAC,sBAAsB,CAAC,CAYjC;AAYD,MAAM,WAAW,iBAAiB;IAChC;gFAC4E;IAC5E,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,EAAE,mBAAmB,GAAG,eAAe,GAAG,OAAO,GAAG,qBAAqB,CAAC;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAGpD;AAED;;;;;;uFAMuF;AACvF,wBAAgB,uBAAuB,IAAI,OAAO,CAGjD;AAED;;;;;4EAK4E;AAC5E,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;oCAEoC;AACpC,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAGlF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA4C9F;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1D,OAAO,CAAC,iBAAiB,CAAC,CAmM5B"}