brigid library

Agricultural-mechanization engineering for Ghana (Phase 59.14), barrel at agricultural-mech/src/index.ts. Four modules: irrigation.ts (irrigation & water management), post-harvest.ts (post-harvest handling, the largest at ~1018 LOC), greenhouse.ts (controlled-environment automation), and livestock-aquaculture.ts. Fully implemented with a ~1218-LOC test suite.

The largest library in the area (~13K LOC), industrial AI under Phase 59.5/59.22/59.23. Modules include computer-vision.ts (CNN defect detection, sub-pixel dimensional measurement, Delta-E color inspection via CIE76/CIEDE2000, GR&R measurement-system analysis), predictive-maint.ts (bearing fault frequencies BPFO/BPFI/BSF/FTF, MCSA, RUL via Wiener/Paris/Weibull, Mahalanobis anomaly scoring), process-optim.ts, robotics-ai.ts, edge-ai.ts, and sota.ts. api-types.ts defines application-architecture interfaces for FactoryOS, EnergyMgmt, MaintenanceMgmt, TrainingAcademy and the BrigidAPI routes. Honest note: some computer-vision/SOTA elements are documented approximations (the source itself labels an "autoencoder simulation" and "isolation forest concept") where a full trained ML runtime would otherwise be required — the surrounding metrology and signal-processing math is real.

The shared base every other Brigid library builds on (core/src/index.ts barrels eleven modules). It owns industrial type taxonomies (equipment.ts, maintenance.ts, energy.ts, robotics.ts, security.ts, business.ts), an SI unit-conversion module (units.ts), runtime Zod validators (validators.ts, schemas.ts — e.g. EquipmentLevelSchema, ISODateStringSchema), and a curated industrial-standards registry (standards.ts: IEC/ISO/ANSI/NFPA/API/ASME entries plus Ghana EPA / Energy Commission / Minerals Commission / GSA references, each with keyRequirements and ghanaRelevance). Tagged type:domain.

Brigid's outbound integration layer (cross-domain/src/index.ts). Provides adapter classes per partner domain — asase-integration.ts (food processing, cold chain, HACCP/CIP), freya-integration.ts (textile/cosmetics/garment lines), cybele-integration.ts (prefab housing, building materials, data-center power), saraswati-integration.ts, and maat-integration.ts (factory telemetry, OEE, equipment-utilization analytics) — plus api-contracts.ts, the Zod request/response schemas (BrigidEquipmentProvisioningRequestSchema, BrigidEnergyIntegrationRequestSchema) that gate cross-domain calls. Tagged type:domain.

OT/ICS cybersecurity (Phase 59.10, ~10.5K LOC) implementing IEC 62443. Four modules with explicit named exports in cybersecurity/src/index.ts: assessment.ts (zone-and-conduit modeling, Purdue levels, foundational- requirement scoring, the ALARP_RISK_MATRIX, vulnerability scanning, asset inventory), network-security.ts (Purdue segmentation, firewall ACL/DMZ/data- diode design, remote-access design), threat-detection.ts (industrial IDS over Modbus/DNP3/S7Comm/OPC-UA packets, CUSUM anomaly detection, MITRE ICS ATT&CK mapping, SIEM-for-OT correlation), and access-control.ts (OT RBAC, patch management, change tracking, backup verification, pen-test methodology).

The Brigid persistence layer, type:data (db/src/index.ts). schema.ts (~1033 LOC) is a Drizzle ORM schema for PostgreSQL using pgTable/pgEnum (brigidEquipmentStatus, brigidEquipmentLevel, …) with money columns at numeric(12,2). migrations.ts carries post-migration SQL for TimescaleDB hypertable conversion of brigid_sensor_telemetry (1-day chunks) and pgvector, keyed off BRIGID_DATABASE_URL. seed.ts provides seed data. A small schema.test.ts accompanies it.

Industrial digital twin / virtual commissioning (Phase 59.9, digital-twin/src/index.ts). Modules: factory-twin.ts (ISA-95 hierarchy nodes, real-time sensor binding, flow visualization, energy-allocation tree, historical playback), equipment-twin.ts, process-simulation.ts, and virtual-commissioning.ts (the largest at ~975 LOC, operator-training support). Fully implemented with a ~1753-LOC test.

Energy solutions, Ghana-optimized (Phase 59.6, energy/src/index.ts). solar.ts implements PV design from real Ghana irradiance data (GHANA_MONTHLY_PSH, harmattan dust-soiling rates), Hay-Davies plane-of-array irradiance, and PR-methodology yield. Companions: bess.ts (battery storage), grid-hybrid.ts (grid-tie / diesel hybrid), power-quality.ts, and ghana-energy.ts (ECG grid context, ~1027 LOC).

Factory automation (Phase 59.3, factory/src/index.ts). Seven modules: production.ts, plc.ts (IEC 61131-3 program generation for Siemens S7-1200/1500, Allen-Bradley ControlLogix, Beckhoff TwinCAT, with a typed PLCDataType/PLCVendor model and a PLC simulator), scada.ts, communications.ts, motion.ts, safety.ts, and batch.ts. Each is a substantial codegen/engineering module (scada ~1300 LOC, plc ~1173 LOC).

Financial models for all 24 business units (Phase 59.20, financials/src/index.ts). bu-models.ts (~1358 LOC) defines ~36 named BU-specific revenue/cost/EBITDA model classes (FactoryAutomationFinancialModel, EnergyFinancialModel, MiningFinancialModel, …) computing margins in GHS via a shared buildResult helper and GHS_PER_USD/GHS_PER_EUR constants. portfolio-analysis.ts does portfolio-level analysis; pricing-costing.ts does project pricing/costing.

Refrigeration, cold-chain & HVAC engineering (Phase 59.16, version 1.0.0, hvac/src/index.ts). refrigeration.ts implements cold-room heat-load calculation, blast-freezer design via Plank's equation, a REFRIGERANT_DATABASE with GWP/Kigali/safety classification, compressor and evaporator (LMTD) sizing. hvac-design.ts (load calc, chillers, AHUs, ductwork), energy-compliance.ts (Kigali/F-gas), and pharma-cold-storage.ts (GDP-compliant) round it out, with Ghana 35-38°C ambient context throughout.

Custom machine-building intelligence (Phase 59.4, machines/src/index.ts). design-workflow.ts (~1512 LOC) implements a phase-gate process (concept → commissioning), FDS generation, ECO impact analysis, and CPM Gantt scheduling. mechanical.ts, electrical.ts, bom-assembly.ts, and compliance.ts cover the engineering disciplines and CE/standards compliance.

Predictive / condition-based maintenance (Phase 59.7, maintenance/src/index.ts). condition-monitoring.ts implements weighted multi-parameter health scoring, the Weibull reliability function R(t)=exp(-(t/η)^β), MTTF via the gamma function, and a multi-level alert engine with hysteresis. cmms.ts (work orders, PM scheduling, asset hierarchy), spare-parts.ts (EOQ, safety stock, criticality), kpi-analytics.ts (MTBF/MTTR, downtime Pareto), and remote-iot.ts (IoT ingestion, SLA, warranty, AR guidance) complete it.

Ghana industrial-automation market intelligence (Phase 59.19, market-intel/src/index.ts). market-analysis.ts provides GhanaManufacturingAnalyzer (sector sizing/TAM, automation-adoption scoring), CompetitorTracker (win/loss, Porter's Five Forces), TechnologyAdoptionTracker (Rogers' S-curve diffusion, TRL), and GovernmentPolicyTracker (1D1F, AfCFTA, local content) backed by real constants (SECTOR_PROFILES, KNOWN_COMPETITORS). sector-demand.ts and business-dev.ts (lead scoring, proposals, tenders) add demand and BD analytics.

Industrial-materials production (Phase 59.18, materials/src/index.ts). Three modules: welding-consumables.ts (AWS/ISO electrode classification — E6010/E7018/E316L etc., IIW flux basicity index, coating extrusion, baking profiles, carbon-equivalent QA), industrial-gases.ts (nitrogen/oxygen/argon/ acetylene production), and plastics-recycling.ts (collection, processing, compounding).

Mining-automation intelligence for Ghana operations (Phase 59.11, mining/src/index.ts). process-automation.ts implements expert mining-process math — Langefors burden/spacing, Kuz-Ram fragmentation, Bond work index and CSS product sizing, Hogg & Fuerstenau SAG mill power, flotation recovery kinetics, and CIL/heap-leach kinetics with cyanide/pH control. fleet-logistics.ts (haulage/shovel allocation, grade control) and safety-environment.ts (gas detection, tailings, ventilation, ~1386 LOC) complete it.

Oil & gas process automation across upstream/midstream/downstream (Phase 59.12, oil-gas/src/index.ts), targeting Ghana's TEN, Jubilee and Sankofa fields plus GNGC/Atuabo/Tema infrastructure. upstream.ts (~1577 LOC) implements Vogel IPR and AOF (calculateVogelIPR/calculateVogelAOF), Horner build-up analysis, wellhead ESD logic (WELLHEAD_ESD_MATRIX), and production allocation. midstream.ts (pipeline SCADA, leak detection, custody transfer, compressor/ pump stations), downstream.ts, and safety-compliance.ts (API 14C / ISO 13703) follow.

Packaging automation (Phase 59.13, packaging/src/index.ts). primary-packaging.ts covers form-fill-seal (VFFS/HFFS) configuration, Torricelli/Bernoulli orifice nozzle-flow for liquid filling, bottling-line balancing, and SEMI-E10 / Nakajima OEE. secondary-packaging.ts, inspection.ts, line-optimization.ts, and packaging-materials.ts complete the line, with West African film-material constants.

Collaborative and warehouse robotics (Phase 59.8, robotics/src/index.ts). cobot.ts implements use-case scoring, ROI (NPV/IRR/payback with Ghana labor costs), ISO/TS 15066 power-and-force-limit contact thresholds per body region, and speed-and-separation-monitoring distances. robot-programming.ts, agv-warehouse.ts (AGV/AMR fleet, WMS), and robot-safety.ts (~1676 LOC, human-robot interaction) round it out.

State-of-the-art enhancements (Phase 59.23, sota-enhancements/src/index.ts): human-centric.ts (Industry 5.0, RULA ergonomics), edge-ai.ts (TinyML, multi-sensor Kalman fusion), 5g-remote-ops.ts, ar-vr.ts, generative-ai.ts, reinforcement-learning.ts, federated-learning.ts, and digital-thread-quantum.ts. Honest note: several of these are real but simplified algorithms — e.g. reinforcement-learning.ts is a genuine tabular Q-learning controller (RLProcessController with a 4000-cell qTable, learning rate 0.1, γ 0.95) rather than a deep-RL runtime, and the generative/quantum modules are conceptual/heuristic implementations, not wrappers over external SOTA models. The digital-thread module does real SHA-256 hash chaining.

Supply-chain optimization (Phase 59.25, supply-chain/src/index.ts). planning.ts implements Holt-Winters demand forecasting, MRP lot-sizing, ABC/XYZ classification, Clark-Scarf multi-echelon optimization, supplier scorecards, and S&OP orchestration, with statistical helpers (inverseNormalCDF/normalCDF). logistics.ts adds nearest-neighbor route optimization, a Ghana ImportDutyCalculator (ECOWAS levy, VAT, NHIL, GET Fund), warehouse slotting/S-shape pick paths, and a P×I risk heat map.

Technical Training Academy (Phase 59.17, version 1.0.0, training/src/index.ts). curriculum.ts (~2095 LOC) implements Bloom's-taxonomy detection (BLOOM_VERBS, detectBloomLevel), credit-hour calculation, prerequisite-graph validation, and named curricula (PLC, robotics, electrical, instrumentation with calibration-uncertainty, energy, water, cybersecurity). assessment.ts covers Rasch-IRT competency assessment and Ghana NVQ certification; delivery.ts adds ROI calculation, spaced repetition, and apprenticeship tracking.

Water & waste-treatment plant design, control and compliance (Phase 59.15, water/src/index.ts). water-treatment.ts implements coagulation/flocculation/ sedimentation, Carman-Kozeny filter head-loss with backwash logic, CT-concept chlorination/UV disinfection, UF/MF/NF/RO membrane flux and salt rejection, and Hazen-Williams distribution hydraulics. wastewater.ts and industrial-effluent.ts (~1485 LOC, Ghana EPA compliance) complete it.

Weighing and calibration metrology (Phase 59.24, version 1.0.0, weighing/src/index.ts). weighing-systems.ts designs weighbridges, batch weighing, checkweighers, tank weighing and belt weighers per OIML R 76/R 50/R 51 classes. calibration.ts (~1055 LOC) implements ISO 17025 calibration management (CalibrationManagementSystem with current/due/overdue status), GUM measurement-uncertainty budgets (MeasurementUncertaintyCalculator, ISO/IEC Guide 98-3, distribution divisors for rectangular/triangular/U-shaped), procedure libraries, certificate generation, and drift analysis.