frontend/src/utils/labels.js

/**
 * Human-readable label mappings.
 * Backend enums stay stable; frontend shows domain-appropriate terms.
 */

export const PROPOSAL_TYPE_LABELS = {
    CREATE: "New Discovery",
    UPDATE: "Contradiction",
    DELETE: "Retraction",
    MERGE: "Consolidation",
    SPLIT: "Refinement",
};

export const WORKFLOW_STATUS_LABELS = {
    PENDING: "Queued",
    RUNNING: "Processing",
    WAITING_FOR_REVIEW: "Needs Review",
    COMPLETED: "Completed",
    FAILED: "Failed",
    CANCELLED: "Cancelled",
};

export const KNOWLEDGE_STATUS_LABELS = {
    ACTIVE: "Active",
    PENDING: "Pending",
    CONFLICTED: "Conflicted",
    SUPERSEDED: "Superseded",
    ARCHIVED: "Archived",
    REJECTED: "Rejected",
};

export const KNOWLEDGE_TYPE_LABELS = {
    ENTITY: "Entity",
    CLAIM: "Claim",
    METHOD: "Method",
    METRIC: "Metric",
    DATASET: "Dataset",
    OBSERVATION: "Observation",
    DATE: "Date",
};

/** Glossary definitions per page */
export const GLOSSARY = {
    dashboard: [
        { term: "Documents", description: "Files uploaded to this workspace for analysis." },
        { term: "Processing", description: "Workflows currently extracting knowledge from documents." },
        { term: "Needs Review", description: "Workflows paused because proposals need human approval." },
        { term: "Knowledge Items", description: "Atomic facts extracted and stored in the knowledge register." },
        { term: "Pending Proposals", description: "Changes the system wants to make that haven't been approved yet." },
    ],
    documents: [
        { term: "Queued", description: "Document is waiting to be processed." },
        { term: "Processing", description: "Extraction, chunking, embedding, and reconciliation are running." },
        { term: "Needs Review", description: "The system found something requiring human judgment." },
        { term: "Completed", description: "Document fully processed and knowledge committed." },
        { term: "Failed", description: "An error occurred during processing." },
    ],
    documentWorkspace: [
        { term: "New Discovery", description: "A new fact found that doesn't exist in the register yet." },
        { term: "Contradiction", description: "New information that conflicts with what the register already contains." },
        { term: "Retraction", description: "Evidence suggests an existing fact should be removed." },
        { term: "Consolidation", description: "Two separate items are the same concept and should be merged." },
        { term: "Refinement", description: "One item is too broad and should be split into specifics." },
        { term: "Approve", description: "Accept this proposed change — it will be committed to the register." },
        { term: "Reject", description: "Decline this change — the register stays unchanged." },
    ],
    knowledge: [
        { term: "Entity", description: "A named thing: person, organization, concept, or object." },
        { term: "Claim", description: "A factual assertion made by a source document." },
        { term: "Method", description: "A procedure, technique, or process described in a document." },
        { term: "Metric", description: "A quantitative measurement or score." },
        { term: "Observation", description: "A qualitative finding or pattern noted in sources." },
        { term: "Active", description: "Verified and committed to the knowledge register." },
        { term: "Pending", description: "Extracted but not yet approved." },
        { term: "Conflicted", description: "Multiple sources disagree on this fact." },
        { term: "Superseded", description: "This extracted item has been incorporated into another knowledge item and is retained for provenance." },
        { term: "Archived", description: "This knowledge item has been removed from the active register but retained for audit history." },
        { term: "Rejected", description: "This proposed knowledge item was rejected during review and is retained for audit history." },
        { term: "Evidence", description: "The exact quote from a source document that supports this knowledge." },
    ],
    search: [
        { term: "Hybrid Search", description: "Combines keyword matching and semantic understanding to find relevant knowledge." },
        { term: "Confidence", description: "How certain the system is about this extraction (0-100%)." },
    ],
    workflows: [
        { term: "Workflow", description: "The end-to-end processing pipeline for one document upload." },
        { term: "Processing", description: "Document is being parsed, chunked, embedded, and analyzed." },
        { term: "Needs Review", description: "Validation rules flagged something that requires human judgment." },
        { term: "Completed", description: "All stages finished and knowledge committed to the register." },
    ],
    activity: [
        { term: "Document Uploaded", description: "A file was added to the workspace." },
        { term: "Workflow Started", description: "Processing began for a document." },
        { term: "Review Requested", description: "The system paused and asked for human input." },
        { term: "Proposal Approved", description: "A human accepted a proposed knowledge change." },
        { term: "Proposal Rejected", description: "A human declined a proposed change." },
        { term: "Proposal Archived", description: "A proposal was deferred for later review." },
        { term: "Commit Created", description: "An approved change was written to the knowledge register." },
    ],
    settings: [
        { term: "Minimum Confidence", description: "Proposals below this confidence threshold require human review." },
        { term: "Required Evidence", description: "Proposals must include a source quote or they require review." },
        { term: "Allowed Proposal Types", description: "Only these types of changes can be auto-approved." },
        { term: "Topic Relevance", description: "Proposals must be semantically related to existing workspace knowledge. Off-topic content requires review." },
        { term: "Enabled", description: "This rule is actively checked during validation." },
        { term: "Disabled", description: "This rule is stored but not enforced." },
    ],
};