@memberjunction/ng-dashboards 5.38.0 → 5.40.0

package/dist/AI/components/autotagging/shared/classify.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.types.js","sourceRoot":"","sources":["../../../../../src/AI/components/autotagging/shared/classify.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * @fileoverview Shared types & interfaces for the Classify (autotagging) sub-app.\n * Extracted verbatim from the former monolith so host, tabs, and dialogs share one contract.\n */\n\n// ── Tab type ──\n\nexport type TabName = 'pipeline' | 'sources' | 'types' | 'tags' | 'taxonomy' | 'inbox' | 'health' | 'history';\n\n// ── Interfaces ──\n\nexport interface NavItem {\n    Tab: TabName;\n    Icon: string;\n    Label: string;\n    BadgeText: string;\n    BadgeClass: string;\n}\n\nexport interface KPIMetric {\n    Label: string;\n    Value: number;\n    Icon: string;\n    Trend: string;\n    TrendUp: boolean;\n}\n\nexport interface PipelineStageInfo {\n    Name: string;\n    Icon: string;\n    Status: 'idle' | 'active' | 'complete';\n    Count: string;\n}\n\nexport interface FeedItem {\n    Name: string;\n    SourceName: string;\n    Tags: string[];\n    TimeAgo: string;\n    Status: 'complete' | 'processing' | 'error';\n}\n\nexport interface SourceMini {\n    ID: string;\n    Name: string;\n    Icon: string;\n    Meta: string;\n    StatusClass: 'active' | 'error' | 'inactive';\n}\n\nexport interface SourceCard {\n    ID: string;\n    Name: string;\n    SourceTypeName: string;\n    ContentTypeName: string;\n    FileTypeName: string;\n    Icon: string;\n    StatusClass: 'active' | 'error' | 'inactive';\n    StatusLabel: string;\n    URL: string;\n    ItemCount: number;\n    TagCount: number;\n    AvgTags: string;\n    LastRunAgo: string;\n    ContentSourceTypeID: string;\n    ContentTypeID: string;\n    ContentFileTypeID: string;\n    EmbeddingModelID: string;\n    VectorIndexID: string;\n    EntityID: string;\n    EntityDocumentID: string;\n    RequiresFileType: boolean;\n    /** FK to ScheduledAction entity, null if no schedule configured */\n    ScheduledActionID: string | null;\n    /** Denormalized name of the linked ScheduledAction */\n    ScheduledActionName: string | null;\n    /** Human-readable schedule description (parsed from cron) */\n    ScheduleDescription: string | null;\n}\n\nexport interface ContentTypeCard {\n    ID: string;\n    Name: string;\n    Description: string;\n    AIModelName: string;\n    AIModelID: string;\n    MinTags: number;\n    MaxTags: number;\n    SourcesUsing: number;\n    ItemsTagged: number;\n    RangeLeftPct: number;\n    RangeRightPct: number;\n    EmbeddingModelID: string;\n    VectorIndexID: string;\n}\n\nexport interface TagRow {\n    Tag: string;\n    UsageCount: number;\n    AvgWeight: number;\n    BarWidthPct: number;\n    TopSource: string;\n    FirstSeen: string;\n}\n\nexport interface TagCloudItem {\n    Tag: string;\n    AvgWeight: number;\n    SizeClass: 'large' | '' | 'small';\n}\n\nexport interface TagBySource {\n    SourceName: string;\n    Count: number;\n}\n\nexport interface RunHistoryRow {\n    ID: string;\n    Status: string;\n    StatusClass: string;\n    SourceName: string;\n    StartedDisplay: string;\n    Duration: string;\n    Items: string;\n    Tags: string;\n    Errors: string;\n    ErrorClass: string;\n}\n\nexport interface DropdownOption {\n    ID: string;\n    Name: string;\n}\n\n/** G3: Content item duplicate pair for review */\nexport interface ContentDuplicateRow {\n    ID: string;\n    ItemAName: string;\n    ItemASource: string;\n    ItemBName: string;\n    ItemBSource: string;\n    SimilarityScore: number;\n    DetectionMethod: string;\n    Status: 'Pending' | 'Confirmed' | 'Dismissed' | 'Merged';\n}\n\n/** D2/D3/D8: Per-source detail row for a specific pipeline run */\nexport interface RunDetailRow {\n    SourceName: string;\n    SourceType: string;\n    Status: string;\n    StatusClass: string;\n    ItemsProcessed: number;\n    ItemsTagged: number;\n    ItemsVectorized: number;\n    ErrorCount: number;\n    TotalTokens: number;\n    TotalCost: number;\n    Duration: string;\n}\n\n// ── Taxonomy Governance interfaces ──\n\nexport type TaxonomySubTab = 'tree' | 'duplicates' | 'orphans' | 'treemap' | 'audit';\n\nexport interface TaxTreeNode {\n    ID: string;\n    Name: string;\n    DisplayName: string;\n    Description: string;\n    ParentID: string | null;\n    Depth: number;\n    Children: TaxTreeNode[];\n    ItemCount: number;\n    AvgWeight: number;\n    HealthColor: 'green' | 'yellow' | 'red';\n    IsExpanded: boolean;\n    IsSelected: boolean;\n    FirstSeen: string;\n}\n\nexport interface TaxDuplicatePair {\n    TagA: string;\n    TagB: string;\n    TagAID: string;\n    TagBID: string;\n    Similarity: number;\n    SeverityClass: 'high' | 'moderate';\n    /** True when multiple Tag records share the same name (case-insensitive) */\n    IsExactDuplicate: boolean;\n    /** How many Tag records share this exact name (only set when IsExactDuplicate) */\n    ExactDuplicateCount: number;\n    /** All Tag IDs sharing the exact name (only set when IsExactDuplicate) */\n    AllIDs: string[];\n}\n\nexport interface TaxOrphanCard {\n    ID: string;\n    Name: string;\n    UsageCount: number;\n    AvgWeight: number;\n    FirstSeen: string;\n    LastSeen: string;\n    IsSelected: boolean;\n}\n\nexport interface TaxTreemapCell {\n    ID: string;\n    Name: string;\n    ItemCount: number;\n    ColorClass: string;\n    RowSpan: number;\n}\n\n/** Supported audit action types — matches DB Action values (lowercased) */\nexport type TaxAuditAction = 'created' | 'merged' | 'moved' | 'deleted' | 'renamed' | 'deprecated' | 'descriptionchanged' | 'reactivated' | 'split';\n\nexport interface TaxAuditEvent {\n    Type: TaxAuditAction;\n    Description: string;\n    TagRef: string;\n    User: string;\n    Timestamp: string;\n    DayHeader: string;\n}\n\nexport interface TaxHealthStat {\n    Total: number;\n    Healthy: number;\n    NeedAttention: number;\n    Orphaned: number;\n    Duplicates: number;\n}\n\nexport interface WeightedTag {\n    Tag: string;\n    Weight: number;\n}\n\n/** Status value for embedding or tagging pipeline phases */\nexport type ItemPipelineStatus = 'Complete' | 'Processing' | 'Failed' | 'Pending';\n\nexport interface ContentItemDetail {\n    ID: string;\n    Name: string;\n    SourceName: string;\n    SourceTypeName: string;\n    ContentTypeName: string;\n    FileTypeName: string;\n    URL: string;\n    TextContent: string;\n    Checksum: string;\n    Tags: WeightedTag[];\n    CreatedAt: string;\n    UpdatedAt: string;\n    ContentSourceID: string;\n    ContentSourceTypeID: string;\n    StatusDot: 'complete' | 'processing' | 'error';\n    TagCount: number;\n    /** Whether this source type uses content/file type (false for Entity sources) */\n    RequiresContentType: boolean;\n    /** Entity record ID if source is entity type (for direct entity navigation) */\n    EntityRecordID: string | null;\n    /** Entity name if source is entity type */\n    EntityName: string | null;\n    /** Embedding pipeline status for this content item */\n    EmbeddingStatus: ItemPipelineStatus;\n    /** Tagging pipeline status for this content item */\n    TaggingStatus: ItemPipelineStatus;\n}\n\nexport interface SourceDetailInfo {\n    ID: string;\n    Name: string;\n    SourceTypeName: string;\n    FileTypeName: string;\n    ContentTypeName: string;\n    RequiresFileType: boolean;\n    StatusClass: 'active' | 'error' | 'inactive';\n    StatusLabel: string;\n    Icon: string;\n    URL: string;\n    EmbeddingModelName: string;\n    VectorIndexName: string;\n    ItemCount: number;\n    TagCount: number;\n    AvgTags: string;\n    LastRunAgo: string;\n    ErrorCount: number;\n    ContentItems: ContentItemDetail[];\n    RunHistory: RunHistoryRow[];\n}\n\n// ── Phase 4: Audit / Analytics ──\n\n/**\n * A single content-item row shown in {@link ClassifyItemGridComponent}. Built from\n * a narrow `ResultType:'simple'` projection of `MJ: Content Items` — no BaseEntity.\n */\nexport interface ClassifyItemGridRow {\n    ID: string;\n    DisplayName: string;\n    SourceName: string;\n    TagCount: number;\n    EmbeddingStatus: string;\n    TaggingStatus: string;\n    UpdatedAt: string;\n    /** Raw ISO timestamp used for sorting (the grid renders UpdatedAt formatted). */\n    UpdatedAtRaw: string;\n}\n\n/**\n * A single tag on a content item, enriched with the LLM provenance fields\n * (Reasoning + AIPromptRunID) surfaced in {@link ClassifyItemDrilldownComponent}.\n */\nexport interface ClassifyDrilldownTag {\n    Tag: string;\n    Weight: number;\n    /** The LLM's justification for this tag, when captured at extraction time. */\n    Reasoning: string | null;\n    /** FK to the AI Prompt Run that produced this tag (provenance link). */\n    AIPromptRunID: string | null;\n    CreatedAt: string;\n}\n\n/** A single provenance fact shown in the drilldown's Provenance section. */\nexport interface ClassifyProvenanceFact {\n    Label: string;\n    Value: string;\n    Icon: string;\n    /** Optional record reference the user can open (entity + id). */\n    RecordEntity?: string;\n    RecordID?: string;\n}\n\n/** A single audit-trail entry shown in the drilldown's Audit section. */\nexport interface ClassifyAuditEntry {\n    Label: string;\n    Timestamp: string;\n    Icon: string;\n}\n\n// ── Slide-in form mode ──\n\nexport type FormMode = 'none' | 'add-source' | 'edit-source' | 'add-type' | 'edit-type';\n\n// ── Dry-run preview ──\n\n/** Per-disposition tally for the dry-run summary line. */\nexport interface DryRunDispositionCount {\n    AutoApply: number;\n    RouteToInbox: number;\n    CreateNew: number;\n    Reject: number;\n}\n\n/** Illustrative token/cost estimate shown on the dry-run preview banner. */\nexport interface DryRunEstimate {\n    ItemsSampled: number;\n    /** Rough total token estimate (clearly marked illustrative in the UI). */\n    EstimatedTokens: number;\n    /** Rough dollar cost estimate derived from EstimatedTokens. */\n    EstimatedCost: number;\n}\n"]}

package/dist/AI/components/autotagging/tabs/health-tab.component.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Classify · Tag Health tab.
+ *
+ * Self-contained sub-page that surfaces the REAL taxonomy-quality signals the
+ * server-side TagHealthJob produces as `MJ: Tag Suggestions` rows with
+ * `Reason ∈ {MergeCandidate, LowUsage, WideNode}`. The Suggestions Inbox tab
+ * deliberately EXCLUDES these 3 reasons; the Health tab OWNS them.
+ *
+ * NOTE: the underlying signals (which tags are merge candidates, which are
+ * low-usage, which are wide nodes) are computed SERVER-SIDE by the TagHealthJob
+ * — this tab does not recompute them. It triages the resulting suggestion rows:
+ * grouping them into the 3 signal buckets and applying human decisions
+ * (Merge / Deprecate / Review-in-Taxonomy / Dismiss) as client-side entity
+ * mutations on the suggestion (and, for Deprecate, on the subject Tag).
+ *
+ * Data is TRANSACTIONAL and grows over time — loaded via RunView (NOT cached),
+ * grouped into the 3 buckets in memory. Loads lazily on first activation.
+ */
+import { EventEmitter } from '@angular/core';
+import { BaseAngularComponent } from '@memberjunction/ng-base-types';
+import { MJTagSuggestionEntity } from '@memberjunction/core-entities';
+import * as i0 from "@angular/core";
+/** The three health-signal reasons this tab owns. */
+type HealthReason = 'MergeCandidate' | 'LowUsage' | 'WideNode';
+/** Static descriptor for one of the 3 signal cards. */
+interface SignalCardMeta {
+    Reason: HealthReason;
+    Title: string;
+    Icon: string;
+    /** Semantic status variant driving the card accent color. */
+    Variant: 'info' | 'warning' | 'error';
+    /** One-line explanation of what the signal means. */
+    Explanation: string;
+    /** Noun for the headline count (e.g. "pairs", "tags", "nodes"). */
+    CountNoun: string;
+}
+/** A signal card's live view-model: its meta + the suggestions in its bucket. */
+interface SignalCard {
+    Meta: SignalCardMeta;
+    Items: MJTagSuggestionEntity[];
+}
+export declare class ClassifyHealthTabComponent extends BaseAngularComponent {
+    private cdr;
+    readonly PreviewLimit = 5;
+    readonly HighConfidenceThreshold = 0.9;
+    private allSuggestions;
+    Cards: SignalCard[];
+    IsLoading: boolean;
+    private hasLoaded;
+    /** ID of the suggestion currently being acted on (disables its row controls). */
+    ActingID: string | null;
+    /** True while a bulk action is in flight. */
+    IsBulkActing: boolean;
+    /** Emitted after any action so the host can refresh its pending/health badge. */
+    Resolved: EventEmitter<void>;
+    /** Emitted with a tag ID so the host can switch to the Taxonomy tab for review. */
+    OpenInTaxonomyRequested: EventEmitter<string>;
+    /** Lazy-load on first activation (host calls this when the tab becomes active). */
+    EnsureLoaded(): Promise<void>;
+    /** Public refresh — re-pull the health suggestions and rebuild buckets. */
+    Refresh(): Promise<void>;
+    private ensureTagEngine;
+    private loadSuggestions;
+    /** Group the loaded suggestions into the 3 signal buckets, preserving card order. */
+    private buildCards;
+    FormatScore(score: number | null): string;
+    /** Count of high-confidence merge candidates eligible for the bulk merge. */
+    HighConfidenceCount(card: SignalCard): number;
+    /** Whether a given suggestion's row controls should be disabled. */
+    IsRowBusy(suggestion: MJTagSuggestionEntity): boolean;
+    private stampReviewFields;
+    /** Merge candidate → Merge: resolve the suggestion onto its best-match tag. */
+    Merge(suggestion: MJTagSuggestionEntity): Promise<void>;
+    /** Bulk: merge every high-confidence (score ≥ 0.9) merge candidate at once. */
+    MergeAllHighConfidence(card: SignalCard): Promise<void>;
+    /** Stamp + resolve a single merge suggestion. Returns Save() success. */
+    private resolveMerge;
+    /** Low usage → Deprecate: flip the subject Tag to Deprecated, then resolve. */
+    Deprecate(suggestion: MJTagSuggestionEntity): Promise<void>;
+    /**
+     * Resolve the subject Tag for a low-usage suggestion: prefer the best-match
+     * tag (that IS the low-usage tag here), else fall back to the already-resolved
+     * tag, else look up by proposed name via the cached TagEngineBase tags.
+     */
+    private resolveSubjectTag;
+    /** Case-insensitive name → tag ID lookup against the cached tag set. */
+    private lookupTagIDByName;
+    /**
+     * Wide node → Review in Taxonomy: bubble the tag ID up so the host can switch
+     * to the Taxonomy tab. The suggestion stays Pending — review happens there.
+     */
+    ReviewInTaxonomy(suggestion: MJTagSuggestionEntity): void;
+    /** Dismiss any signal: mark the suggestion Rejected. */
+    Dismiss(suggestion: MJTagSuggestionEntity): Promise<void>;
+    /** Remove a resolved suggestion, rebuild buckets, notify the host. */
+    private finishAction;
+    private notifyFailure;
+    private notifyError;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClassifyHealthTabComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClassifyHealthTabComponent, "classify-health-tab", never, {}, { "Resolved": "Resolved"; "OpenInTaxonomyRequested": "OpenInTaxonomyRequested"; }, never, never, false, never>;
+}
+export {};
+//# sourceMappingURL=health-tab.component.d.ts.map

package/dist/AI/components/autotagging/tabs/health-tab.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-tab.component.d.ts","sourceRoot":"","sources":["../../../../../src/AI/components/autotagging/tabs/health-tab.component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAgC,YAAY,EAAkB,MAAM,eAAe,CAAC;AAG3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAe,MAAM,+BAA+B,CAAC;;AAGnF,qDAAqD;AACrD,KAAK,YAAY,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AAK/D,uDAAuD;AACvD,UAAU,cAAc;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,iFAAiF;AACjF,UAAU,UAAU;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAiCD,qBAMa,0BAA2B,SAAQ,oBAAoB;IAChE,OAAO,CAAC,GAAG,CAA6B;IAExC,SAAgB,YAAY,KAAiB;IAC7C,SAAgB,uBAAuB,OAA6B;IAGpE,OAAO,CAAC,cAAc,CAA+B;IAC9C,KAAK,EAAE,UAAU,EAAE,CAAM;IAEzB,SAAS,UAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,iFAAiF;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACtC,6CAA6C;IACtC,YAAY,UAAS;IAE5B,iFAAiF;IACvE,QAAQ,qBAA4B;IAE9C,mFAAmF;IACzE,uBAAuB,uBAA8B;IAM/D,mFAAmF;IACtE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAM1C,2EAA2E;IAC9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIvB,eAAe;YAIf,eAAe;IAmB7B,qFAAqF;IACrF,OAAO,CAAC,UAAU;IAWX,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAIhD,6EAA6E;IACtE,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAKpD,oEAAoE;IAC7D,SAAS,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO;IAc5D,OAAO,CAAC,iBAAiB;IAKzB,+EAA+E;IAClE,KAAK,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBpE,+EAA+E;IAClE,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpE,yEAAyE;YAC3D,YAAY;IAW1B,+EAA+E;IAClE,SAAS,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCxE;;;;OAIG;YACW,iBAAiB;IAU/B,wEAAwE;IACxE,OAAO,CAAC,iBAAiB;IAQzB;;;OAGG;IACI,gBAAgB,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAUhE,wDAAwD;IAC3C,OAAO,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBtE,sEAAsE;IACtE,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;yCAhSV,0BAA0B;2CAA1B,0BAA0B;CAoStC"}