contextsynapse 1.0.0__py3-none-any.whl

contextsynapse/config/schemas/database.yaml

@@ -0,0 +1,74 @@
+# Database Extraction Schema
+# Used when ingesting database documentation, SQL schemas, ERD descriptions,
+# and data dictionaries into a database context.
+
+name: database
+
+node_types:
+  Table:
+    fields: [name, description, schema, row_count, engine]
+    required: [name]
+    description: "A database table or collection"
+
+  Column:
+    fields: [name, data_type, nullable, default_value, description, is_primary_key]
+    required: [name]
+    description: "A column or field within a table"
+
+  Schema:
+    fields: [name, description, owner, database]
+    required: [name]
+    description: "A database schema or namespace"
+
+  Index:
+    fields: [name, type, columns, unique, description]
+    required: [name]
+    description: "A database index (type: btree, hash, gin, gist)"
+
+  View:
+    fields: [name, description, definition, materialized]
+    required: [name]
+    description: "A database view or materialized view"
+
+  StoredProcedure:
+    fields: [name, parameters, return_type, description, language]
+    required: [name]
+    description: "A stored procedure, function, or trigger"
+
+  ForeignKey:
+    fields: [name, source_column, target_table, target_column, on_delete, on_update]
+    required: [name]
+    description: "A foreign key relationship between tables"
+
+edge_types:
+  BELONGS_TO:
+    source: Table
+    target: Schema
+  HAS_COLUMN:
+    source: Table
+    target: Column
+  REFERENCES:
+    source: ForeignKey
+    target: Table
+  INDEXES:
+    source: Index
+    target: Table
+  DEPENDS_ON:
+    source: View
+    target: Table
+  CALLS:
+    source: StoredProcedure
+    target: StoredProcedure
+
+fact_types:
+  - type: Constraint
+    fields: [name, type, table, expression, source_text]
+    description: "A check constraint, unique constraint, or validation rule"
+
+  - type: Migration
+    fields: [version, description, date, changes, source_text]
+    description: "A schema migration or DDL change"
+
+  - type: Performance
+    fields: [table, metric, value, recommendation, source_text]
+    description: "A performance observation or optimization recommendation"

contextsynapse/config/schemas/decision.yaml

@@ -0,0 +1,72 @@
+# Decision Extraction Schema
+# Used when ingesting architecture decisions, ADRs, trade-off analyses,
+# and rationale documents into a decision context.
+
+name: decision
+
+node_types:
+  Decision:
+    fields: [title, status, date, decided_by, description, context]
+    required: [title]
+    description: "An architecture or technical decision (status: proposed, accepted, deprecated, superseded)"
+
+  ADR:
+    fields: [number, title, status, date, context, decision, consequences]
+    required: [title]
+    description: "An Architecture Decision Record"
+
+  TradeOff:
+    fields: [name, description, pros, cons, chosen_option]
+    required: [name]
+    description: "A trade-off analysis comparing alternatives"
+
+  Alternative:
+    fields: [name, description, pros, cons, rejected_reason]
+    required: [name]
+    description: "A considered alternative that was evaluated"
+
+  Criterion:
+    fields: [name, weight, description, category]
+    required: [name]
+    description: "An evaluation criterion used to compare alternatives (category: cost, performance, maintainability, security)"
+
+  Stakeholder:
+    fields: [name, role, concern, influence]
+    required: [name]
+    description: "A person or team with stake in the decision outcome"
+
+edge_types:
+  DECIDED_BY:
+    source: Decision
+    target: Stakeholder
+  SUPERSEDES:
+    source: Decision
+    target: Decision
+  CONSIDERS:
+    source: Decision
+    target: Alternative
+  EVALUATED_BY:
+    source: Alternative
+    target: Criterion
+  TRADES_OFF:
+    source: TradeOff
+    target: Alternative
+  DOCUMENTED_IN:
+    source: Decision
+    target: ADR
+  IMPACTS:
+    source: Decision
+    target: Decision
+
+fact_types:
+  - type: Assumption
+    fields: [statement, confidence, impact_if_wrong, source_text]
+    description: "An assumption underlying a decision that may need validation"
+
+  - type: Outcome
+    fields: [decision, result, measured_date, description, source_text]
+    description: "A measured outcome or consequence of a past decision"
+
+  - type: Constraint
+    fields: [statement, type, imposed_by, source_text]
+    description: "A constraint that influenced the decision (type: technical, business, regulatory)"

contextsynapse/config/schemas/ecommerce.yaml

@@ -0,0 +1,56 @@
+# E-Commerce Extraction Schema
+# Used when ingesting product listings, marketplace data, reviews, and catalog content.
+
+name: ecommerce
+
+node_types:
+  Product:
+    fields: [name, sku, description, price, currency, stock_status, url, images]
+    required: [name]
+    description: "A product listed for sale on an e-commerce platform"
+
+  Review:
+    fields: [title, body, rating, author, date, verified_purchase, helpful_count]
+    required: [body]
+    description: "A customer review or rating for a product"
+
+  Seller:
+    fields: [name, rating, location, fulfillment_type, reviews_count]
+    required: [name]
+    description: "A seller or merchant offering products"
+
+  Brand:
+    fields: [name, description, country, website]
+    required: [name]
+    description: "A product brand or manufacturer"
+
+  Category:
+    fields: [name, path, description, parent_category]
+    required: [name]
+    description: "A product category or classification"
+
+edge_types:
+  SOLD_BY:
+    source: Product
+    target: Seller
+  REVIEWED:
+    source: Product
+    target: Review
+  MADE_BY:
+    source: Product
+    target: Brand
+  BELONGS_TO:
+    source: Product
+    target: Category
+  PARENT_OF:
+    source: Category
+    target: Category
+
+fact_types:
+  - type: PriceChange
+    fields: [product, old_price, new_price, currency, date, source_text]
+    description: "A price change or discount event for a product"
+
+  - type: Specification
+    fields: [attribute, value, unit, source_text]
+    description: "A product specification or technical attribute"

contextsynapse/config/schemas/education.yaml

@@ -0,0 +1,42 @@
+name: education
+description: "Education domain — courses, students, instructors, assessments"
+
+node_types:
+  Course:
+    fields: [name, code, level, credits, department, description]
+    required: [name]
+    description: "Course, class, or training program"
+  Student:
+    fields: [name, id, level, major, enrollment_status]
+    required: [name]
+    description: "Student or learner"
+  Instructor:
+    fields: [name, department, title, specialization]
+    required: [name]
+    description: "Teacher, professor, or trainer"
+  Assessment:
+    fields: [name, type, weight, due_date, description]
+    required: [name]
+    description: "Exam, assignment, project, or evaluation"
+  LearningObjective:
+    fields: [description, bloom_level, measurable]
+    required: [description]
+    description: "Learning outcome or competency"
+  Resource:
+    fields: [name, type, url, author, description]
+    required: [name]
+    description: "Textbook, article, video, or learning material"
+
+edge_types:
+  TEACHES:
+    source: Instructor
+    target: Course
+  ENROLLED_IN:
+    source: Student
+    target: Course
+  ASSESSES:
+    source: Assessment
+    target: LearningObjective
+  REQUIRES:
+    source: Course
+    target: Course

contextsynapse/config/schemas/healthcare.yaml

@@ -0,0 +1,133 @@
+name: healthcare
+version: "2.0"
+description: "Healthcare domain — patients, conditions, treatments, providers"
+
+node_types:
+  Patient:
+    fields:
+      name: {type: string, required: true, indexed: true}
+      age: {type: int, range_min: 0, range_max: 150}
+      gender: {type: enum, values: [male, female, other, unknown]}
+      condition: {type: string}
+      insurance: {type: string}
+    dedup: {key: [name], merge: latest_wins}
+    min_confidence: 0.0
+    description: "A patient or subject"
+  Condition:
+    fields:
+      name: {type: string, required: true, indexed: true}
+      category: {type: string, indexed: true}
+      severity: {type: enum, values: [mild, moderate, severe, critical]}
+      icd_code: {type: string, pattern: "^[A-Z]\\d"}
+      description: {type: string}
+    dedup: {key: [name], merge: merge_properties}
+    min_confidence: 0.3
+    description: "Medical condition, disease, or diagnosis"
+  Treatment:
+    fields:
+      name: {type: string, required: true, indexed: true}
+      type: {type: enum, values: [medication, therapy, procedure, surgery, lifestyle]}
+      dosage: {type: string}
+      duration: {type: string}
+      effectiveness: {type: string}
+      evidence_level: {type: enum, values: [meta_analysis, clinical_trial, case_study, expert_opinion, anecdotal]}
+    dedup: {key: [name], merge: merge_properties}
+    min_confidence: 0.2
+    description: "Treatment, medication, therapy, or procedure"
+  Provider:
+    fields:
+      name: {type: string, required: true, indexed: true}
+      specialty: {type: string, indexed: true}
+      facility: {type: string}
+      credentials: {type: string}
+    dedup: {key: [name], merge: latest_wins}
+    min_confidence: 0.0
+    description: "Doctor, nurse, therapist, or healthcare facility"
+  Protocol:
+    fields:
+      name: {type: string, required: true, indexed: true}
+      version: {type: string}
+      authority: {type: string}
+      description: {type: string}
+    dedup: {key: [name], merge: merge_properties}
+    min_confidence: 0.3
+    description: "Clinical protocol, guideline, or standard of care"
+  Outcome:
+    fields:
+      description: {type: string, required: true}
+      metric: {type: string}
+      value: {type: string}
+      timeframe: {type: string}
+    dedup: {key: [description], merge: latest_wins}
+    min_confidence: 0.0
+    description: "Treatment outcome or clinical result"
+
+edge_types:
+  DIAGNOSED_WITH:
+    source: Patient
+    target: Condition
+  TREATED_WITH:
+    source: Condition
+    target: Treatment
+    properties:
+      efficacy: {type: float, range_min: 0.0, range_max: 1.0}
+      start_date: {type: date}
+  PROVIDED_BY:
+    source: Treatment
+    target: Provider
+  FOLLOWS:
+    source: Provider
+    target: Protocol
+  RESULTS_IN:
+    source: Treatment
+    target: Outcome
+    properties:
+      measured_at: {type: date}
+  CONTRAINDICATED_WITH:
+    source: Treatment
+    target: Treatment
+    properties:
+      severity: {type: enum, values: [mild, moderate, severe, absolute]}
+      reason: {type: string}
+
+derivation_rules:
+  - when: {node: Condition, has_edge: TREATED_WITH, count: ">3"}
+    action: create_cu
+    params: {topic_from: Condition.name}
+  - when: {node: Treatment, property: evidence_level, equals: meta_analysis}
+    action: boost
+    params: {priority: 1.5}
+  - when: {node: Treatment, shares_field: condition_name, with: Treatment}
+    action: create_edge
+    params: {edge_type: ALTERNATIVE_TO, confidence: 0.6}
+
+fact_types:
+  - type: ClinicalFinding
+    fields: [statement, evidence_level, source_text]
+    description: "Clinical observation, lab result, or diagnostic finding"
+  - type: Contraindication
+    fields: [statement, severity, affected_treatments]
+    description: "Known contraindication or adverse interaction"
+  - type: Guideline
+    fields: [statement, authority, version]
+    description: "Clinical guideline or standard-of-care recommendation"
+
+context_unit:
+  confidence_weights:
+    clinical_trial: 0.30
+    meta_analysis: 0.35
+    case_study: 0.15
+    expert_opinion: 0.10
+    guideline: 0.25
+    anecdotal: 0.05
+  priority_labels: [Condition, Treatment, Protocol, Contraindication]
+  claim_template: "{topic}: {claim} (evidence: {evidence_type}, n={fact_count})"
+  domain_questions:
+    - "What are the contraindications for this treatment?"
+    - "What is the recommended dosage and duration?"
+    - "What outcomes have been observed?"
+    - "Which clinical protocols apply?"
+  zoom_levels:
+    headline: "{topic} ({confidence:.0%}): {claim_short}"
+    summary: "{topic} ({confidence:.0%}): {claim} | Evidence: {evidence_count} sources"
+    full: "{topic} ({confidence:.0%}): {claim} | Answers: {questions} | Clues: {clues} | Evidence: {evidence_ids}"

contextsynapse/config/schemas/hr_document.yaml

@@ -0,0 +1,48 @@
+# HR Document Extraction Schema
+# Used when ingesting HR policies, job descriptions, employee handbooks, and onboarding docs.
+
+name: hr_document
+
+node_types:
+  Employee:
+    fields: [name, employee_id, department, location, start_date, employment_type]
+    required: [name]
+    description: "An employee or staff member referenced in the document"
+
+  Role:
+    fields: [title, level, department, responsibilities, requirements]
+    required: [title]
+    description: "A job role or position defined in the document"
+
+  Policy:
+    fields: [name, category, description, effective_date, version]
+    required: [name]
+    description: "An HR policy, rule, or guideline"
+
+  Benefit:
+    fields: [name, type, description, eligibility, value]
+    required: [name]
+    description: "An employee benefit, perk, or compensation item"
+
+edge_types:
+  HOLDS_ROLE:
+    source: Employee
+    target: Role
+  GOVERNED_BY:
+    source: Employee
+    target: Policy
+  ELIGIBLE_FOR:
+    source: Employee
+    target: Benefit
+  REPORTS_TO:
+    source: Role
+    target: Role
+
+fact_types:
+  - type: Requirement
+    fields: [statement, category, source_text]
+    description: "A stated requirement or expectation from the HR document"
+
+  - type: Entitlement
+    fields: [description, amount, unit, conditions, source_text]
+    description: "A specific employee entitlement such as leave days or allowances"

contextsynapse/config/schemas/invoice.yaml

@@ -0,0 +1,40 @@
+# Invoice Extraction Schema
+# Used when ingesting invoices, purchase orders, receipts, and billing documents.
+
+name: invoice
+
+node_types:
+  Vendor:
+    fields: [name, address, tax_id, email, phone, bank_account]
+    required: [name]
+    description: "The vendor or seller issuing the invoice"
+
+  Buyer:
+    fields: [name, address, tax_id, email, phone, account_number]
+    required: [name]
+    description: "The buyer or customer receiving the invoice"
+
+  LineItem:
+    fields: [description, quantity, unit_price, total, unit, sku, tax_rate]
+    required: [description]
+    description: "A single line item or product/service on the invoice"
+
+edge_types:
+  SOLD_BY:
+    source: LineItem
+    target: Vendor
+  PURCHASED_BY:
+    source: LineItem
+    target: Buyer
+  BILLED_TO:
+    source: Vendor
+    target: Buyer
+
+fact_types:
+  - type: total
+    fields: [subtotal, tax, discount, grand_total, currency, due_date]
+    description: "The financial totals and payment details for the invoice"
+
+  - type: PaymentTerm
+    fields: [terms, due_date, late_fee, source_text]
+    description: "Payment terms and conditions stated on the invoice"

contextsynapse/config/schemas/knowledge_base.yaml

@@ -0,0 +1,75 @@
+# Knowledge Base Extraction Schema
+# Used when ingesting documents, research, specs, meeting notes into a knowledge_base context.
+# The LLM extracts structured entities instead of generic text chunks.
+
+name: knowledge_base
+
+node_types:
+  Person:
+    fields: [name, role, department, email, expertise]
+    required: [name]
+    description: "A person — employee, stakeholder, customer, author"
+
+  Organization:
+    fields: [name, type, industry, location, size]
+    required: [name]
+    description: "A company, team, department, or external organization"
+
+  Concept:
+    fields: [name, definition, domain, importance]
+    required: [name]
+    description: "An abstract concept, methodology, theory, or domain term"
+
+  Topic:
+    fields: [name, description, category]
+    required: [name]
+    description: "A subject area or theme discussed in the documents"
+
+  Technology:
+    fields: [name, category, version, license, description]
+    required: [name]
+    description: "A tool, framework, platform, language, or protocol"
+
+  Document:
+    fields: [title, author, date, type, summary]
+    required: [title]
+    description: "A referenced document, paper, report, or specification"
+
+edge_types:
+  WORKS_AT:
+    source: Person
+    target: Organization
+  AUTHORED:
+    source: Person
+    target: Document
+  DISCUSSES:
+    source: Document
+    target: Topic
+  RELATED_TO:
+    source: Concept
+    target: Concept
+  USES:
+    source: Organization
+    target: Technology
+  EXPERT_IN:
+    source: Person
+    target: Concept
+  MENTIONS:
+    source: Document
+    target: Person
+  PART_OF:
+    source: Topic
+    target: Topic
+
+fact_types:
+  - type: Claim
+    fields: [statement, confidence, source_text]
+    description: "A verifiable statement or assertion from the source material"
+
+  - type: Metric
+    fields: [name, value, unit, period, source_text]
+    description: "A quantitative measurement, KPI, or statistic"
+
+  - type: Date
+    fields: [event, date, description, source_text]
+    description: "A significant date, deadline, or timeline event"

contextsynapse/config/schemas/legal.yaml

@@ -0,0 +1,42 @@
+name: legal
+description: "Legal domain — cases, parties, clauses, precedents"
+
+node_types:
+  Case:
+    fields: [name, number, court, jurisdiction, status, date_filed]
+    required: [name]
+    description: "Legal case, lawsuit, or proceeding"
+  Party:
+    fields: [name, role, type, representation]
+    required: [name]
+    description: "Party to a case — plaintiff, defendant, witness"
+  Clause:
+    fields: [name, text, section, contract]
+    required: [name]
+    description: "Contract clause, provision, or term"
+  Statute:
+    fields: [name, code, section, jurisdiction, description]
+    required: [name]
+    description: "Law, statute, regulation, or ordinance"
+  Precedent:
+    fields: [name, citation, court, year, ruling]
+    required: [name]
+    description: "Legal precedent or prior ruling"
+  Obligation:
+    fields: [description, deadline, penalty, responsible_party]
+    required: [description]
+    description: "Legal obligation, requirement, or compliance duty"
+
+edge_types:
+  PARTY_TO:
+    source: Party
+    target: Case
+  CITES:
+    source: Case
+    target: Precedent
+  GOVERNS:
+    source: Statute
+    target: Obligation
+  BOUND_BY:
+    source: Party
+    target: Clause

contextsynapse/config/schemas/marketing_content.yaml

@@ -0,0 +1,48 @@
+# Marketing Content Extraction Schema
+# Used when ingesting marketing briefs, campaign plans, ad copy, and brand documents.
+
+name: marketing_content
+
+node_types:
+  Campaign:
+    fields: [name, type, channel, start_date, end_date, budget, status, objective]
+    required: [name]
+    description: "A marketing campaign or initiative"
+
+  Audience:
+    fields: [name, description, demographics, interests, size, region]
+    required: [name]
+    description: "A target audience or customer segment"
+
+  Metric:
+    fields: [name, value, unit, period, benchmark, goal]
+    required: [name]
+    description: "A marketing performance metric or KPI"
+
+  Brand:
+    fields: [name, industry, tagline, values, voice, colors]
+    required: [name]
+    description: "A brand entity with associated identity attributes"
+
+edge_types:
+  TARGETS:
+    source: Campaign
+    target: Audience
+  MEASURES:
+    source: Campaign
+    target: Metric
+  PROMOTES:
+    source: Campaign
+    target: Brand
+  COMPETES_WITH:
+    source: Brand
+    target: Brand
+
+fact_types:
+  - type: Insight
+    fields: [statement, confidence, source_text]
+    description: "A marketing insight or strategic conclusion"
+
+  - type: PerformanceFact
+    fields: [metric_name, value, unit, period, comparison, source_text]
+    description: "A specific campaign or channel performance data point"

contextsynapse/config/schemas/meeting_notes.yaml

@@ -0,0 +1,51 @@
+# Meeting Notes Extraction Schema
+# Used when ingesting meeting minutes, standup summaries, and discussion transcripts.
+
+name: meeting_notes
+
+node_types:
+  Attendee:
+    fields: [name, role, team, email]
+    required: [name]
+    description: "A person who attended or participated in the meeting"
+
+  Decision:
+    fields: [title, description, rationale, date, status]
+    required: [title]
+    description: "A decision made during the meeting"
+
+  ActionItem:
+    fields: [title, description, owner, due_date, priority, status]
+    required: [title]
+    description: "A task or follow-up action assigned during the meeting"
+
+  Topic:
+    fields: [title, description, duration_minutes, outcome]
+    required: [title]
+    description: "A topic or agenda item discussed in the meeting"
+
+edge_types:
+  DECIDED:
+    source: Attendee
+    target: Decision
+  ASSIGNED_TO:
+    source: ActionItem
+    target: Attendee
+  DISCUSSED:
+    source: Attendee
+    target: Topic
+  RAISED:
+    source: Attendee
+    target: ActionItem
+  RELATED_TO:
+    source: Decision
+    target: Topic
+
+fact_types:
+  - type: Summary
+    fields: [statement, topic, source_text]
+    description: "A key point or summary from the meeting discussion"
+
+  - type: Blocker
+    fields: [description, owner, impact, source_text]
+    description: "An impediment or blocker raised during the meeting"