D-COMPASS

D-COMPASS

Version hub and development changelog · hub 1.4 · updated 2026-08-05

DefectClosureOverlapMesh PlaneAccessSeparationStability

Current working version: 0.9.3 — Rules-first Architecture

Moves editable clinical thresholds and decisions into rules.txt so that PHP remains the interpreter, geometry calculator and presentation layer.

Open current calculator Methodology & scientific background Open anatomical planning sketch
Hub 1.4 update: standalone releases 0.1 PL–0.4 retain their original PHP filenames. Integrated releases 0.8.0–0.9.3 are linked through their version directories, for example dcompas_093/dcompass/.

0.9.3 — Rules-first Architecture

Current working version
2026-08-04 · English · dcompas_093/dcompass/

Moves editable clinical thresholds and decisions into rules.txt so that PHP remains the interpreter, geometry calculator and presentation layer.

Open version

Changes

  • Added a PARAM block containing Closure, RDR, LoD, BMI, overlap, Plane, TAR, EHS and scar-geometry values.
  • Made the Closure boundary explicit: 8.0 cm remains directly closable by default, while 8.1 cm enters the difficult category.
  • Removed competing PHP reclassification of Closure and postoperative resetting of BTA/TAR decisions.
  • Moved preperitoneal selection, full versus segmental TAR and Separation prescriptions into the external ruleset.
  • Added regression tests proving that changes made only in rules.txt propagate to the final recommendation.

0.9.2 — Preperitoneal Fat-zone and TAR Extent

Archived
2026-08-04 · English · dcompas_092/dcompass/

Replaces the universal preperitoneal default with a geometry-driven fat-zone assessment and distinguishes segmental from full TAR.

Open version

Changes

  • Requires the complete implant to fit a modelled or CT-confirmed preperitoneal field.
  • Models a 5 + 5 cm central preperitoneal field and a broader infra-arcuate field.
  • Introduces tissue-plane modifiers instead of asking the surgeon to preselect the entire Plane decision.
  • Uses partial/segmental TAR for implant-space deficits and full TAR only for Closure or LoD indications.
  • Represents mixed full and segmental TAR laterality explicitly.

0.9.1 — Spatial Scar Matching

Archived
2026-08-04 · English · dcompas_091/dcompass/

Selects the Closure axis from a spatially related scar and removes location labels as hidden selectors of Closure, Plane and Access.

Open version

Changes

  • Converts previous open operations into schematic scar segments in patient coordinates.
  • Allows a scar to determine Closure only when it intersects the defect or lies within the editable proximity threshold.
  • Selects the nearest eligible scar and reports competing-axis ambiguity.
  • Uses the matched scar axis directly for longitudinal, transverse or oblique Closure.
  • Makes preperitoneal selection and Cooper fixation depend on geometry rather than suprapubic or post-appendectomy labels.

0.9.0 — Plane, RDR and Fixed Anchors

Archived
2026-08-04 · English · dcompas_090/dcompass/

Adds complete-pocket Plane assessment, automatic RDR, segmental/full TAR logic and fixed anatomical support points.

The release target is unavailable at this path.

File unavailable

Changes

  • Selects preperitoneal only when one continuous pocket can contain the complete required implant.
  • Calculates RDR automatically for longitudinal midline Closure and applies published strata conservatively.
  • Separates segmental TAR for implant deployment from full TAR for medialisation or LoD.
  • Treats Cooper and xiphoid as fixed patient coordinates.
  • Enlarges the implant when a selected support point lies outside its planned outline.

0.8.3 — Pauli Plane-selection Update

Archived
2026-08-04 · English · dcompas_083/dcompass/

Applies Pauli as a modifier to the reconstruction selected for the same defect without a stoma.

Open version

Changes

  • Plans the abdominal-wall reconstruction before applying the Pauli modifier.
  • Preserves the original Plane, Access, TAR extent and trocar concept.
  • Adds conduit lateralisation, tunnel construction and perfusion checks to the operative sequence.
  • Supports a mixed unilateral retrorectus/TAR and contralateral preperitoneal plane.
  • Prevents unilateral TAR from automatically triggering bilateral retrorectus dissection or eTEP.

0.8.2 — Planning Continuity

Archived
2026-08-04 · English · dcompas_082/

Keeps supported cases complete despite uncertainty and replaces unresolved branches with explicit surgical fallbacks.

Open version

Changes

  • Retains uncertainty in reasons and confidence instead of suppressing the whole plan.
  • Uses anatomical/geometric Closure fallback when no spatially related scar is available.
  • Routes multiple or unclear previous meshes to open reconstruction.
  • Adds a provisional Pauli plan while retaining parastomal cases as unsupported for validation.
  • Keeps Stability tied to planned defect closure and complete extraperitoneal support.

0.8.1 — Expert-validation Boundary

Archived
2026-08-04 · English · dcompas_081/dcompass/

Introduces explicit validation status, confidence, input validation and reproducible rule/input auditing.

Open version

Changes

  • Adds COMPLETE, MANUAL_REVIEW, BLOCKED and UNSUPPORTED result states.
  • Suppresses later domains after the first unresolved decision stage.
  • Adds validation of critical input ranges and inconsistent geometry.
  • Records rules and input SHA-256 hashes together with the complete decision trace.
  • Labels the operative output as an algorithmic plan requiring surgeon review.

0.8.0 — Readable Separation and Combined Effects

Archived
2026-08-04 · English · dcompas_080/dcompass/

First integrated multi-file release, with clearer Separation output and combined estimates for selected manoeuvres.

Open version

Changes

  • Displays Separation as a short prescription followed by one card per selected manoeuvre.
  • Emphasises only the recommended action and leaves reasons and effect ranges in regular text.
  • Adds a combined-effect panel for estimated fascial gain, volume preparation and omental reduction.
  • Removes manual abdominal-capacity and fascial-closure fields.
  • Derives Closure feasibility from the dimension perpendicular to the planned suture axis and reports Tanaka/LoD in Closure.

0.4 — Automatic Space Assessment

Archived
2026-08-01 · English · 77 KB · d_compass_en_v04_automatic_space.php

Removes the manual “Available space for the complete calculated mesh” section and calculates plane requirements automatically from defect anatomy and location.

Open version

Changes

  • Removed the entire manual “Available space for the complete calculated mesh” input section.
  • Removed all preperitoneal left, right, cranial and caudal pocket fields.
  • Removed manual cranial and caudal retrorectus pocket fields.
  • Derives lateral retrorectus capacity from defect position, linea alba width, rectus widths and semilunar-line distances.
  • Applies location-specific cranial and caudal extension rules automatically.
  • Keeps TAPP as the preferred preperitoneal option for midline, groin, suprapubic and iliac/appendectomy-site defects.
  • Selects retrorectus, unilateral TAR or bilateral TAR from side-specific anatomical deficits when a retromuscular route is required.
  • Reports a fallback TAR requirement when a preferred preperitoneal plan cannot be completed.
  • No longer reduces confidence merely because pocket dimensions were not entered.

0.3 — Core Algorithm

Archived
2026-08-01 · English · 75 KB · d_compass_en_v03_core_algorithm.php

First implementation of the full D-COMPASS clinical decision sequence.

Open version

Changes

  • Rebuilt the main decision engine around the sequence: Defect → Closure/reducibility → Overlap → Mesh → Plane/Position → Access → Separation → Stability.
  • Added defect position relative to the midline and available space toward each semilunar line.
  • Added sac size, abdominal-wall deformity, reducibility and loss-of-domain assessment.
  • Added closure pathways: no additional release, botulinum toxin A, ACR, unilateral TAR, bilateral TAR and combined methods.
  • Defined overlap as 3 cm for primary defects up to 4 cm, 5 cm for scar defects or defects >4–12 cm, and 7 cm for defects >12 cm.
  • Closed the previous 4–5 cm logical gap by assigning defects >4 cm to the 5 cm overlap rule.
  • Calculates mesh width, length and area for the entire reconstructed zone.
  • Assesses required margins separately medially, laterally, cranially and caudally.
  • Checks whether the complete calculated implant fits in the preperitoneal, retrorectus, unilateral-TAR or bilateral-TAR space.
  • TAR is determined by defect position, required overlap and available implant space—not by defect width alone.
  • Allows separation solely to create adequate mesh space even when fascial closure is possible.
  • Prefers MIS when reduction, closure, pocket creation and complete overlap are feasible.
  • Selects open access for major external deformity, giant sacs or required abdominal-wall/skin resection—not automatically for a wide defect.
  • Makes no fixation the default when the closed pocket, mesh size, overlap and flat deployment provide sufficient stability.

0.2 — TAR Revision

Archived
2026-08-01 · English · 57 KB · d_compass_en_v02_TAR_revision.php

Correction of TAR indications in the original English calculator.

Open version

Changes

  • Removed the incorrect statement that TAR should be driven mainly by medialization rather than mesh-space requirements.
  • Recognized required implant width and lateral overlap as independent indications for TAR.
  • Added posterior-layer closure and access to the pretransversalis/retroperitoneal plane as TAR objectives.
  • Clarified that fascial medialization is an additional benefit, not a prerequisite for TAR.

0.1 EN — English MVP

Deprecated
2026-08-01 · English · 56 KB · d_compass_en.php

English translation of the initial MVP with an information tooltip.

Open version

Changes

  • Translated the full interface, recommendations, warnings, explanations, report text and code comments into English.
  • Added the “About D-COMPASS” information tooltip in the header.
  • Retained the original threshold-based decision logic.
  • Known limitation: this version contains the superseded TAR statement corrected in version 0.2.

0.1 PL — Initial MVP

Archived
2026-08-01 · Polish · 54 KB · d_compass.php

First standalone PHP prototype of the educational calculator.

Open version

Changes

  • Created a single-file PHP 8+ application without a database or patient-data storage.
  • Introduced the eight D-COMPASS domains: Defect, Closure, Overlap, Mesh, Plane, Access, Separation and Stability.
  • Added editable thresholds in the $RULES array and a transparent rule-based decision engine.
  • Added structured recommendations, warnings, rationales, print/PDF, clipboard copy and JSON export.
To add the next integrated release, place it in dcompas_XXX/dcompass/ and add a new entry at the beginning of the $versions array in dcompass.php. Keep all earlier standalone files and release directories unchanged so that every clinical-logic revision remains auditable.