SftpTransport uses org.apache.sshd directly, but the artifact arrived only through qqq-backend-module-filesystem. A host that also gets that module from a dependency which excludes its SSH stack (qbit-object-storage does) resolved it without SSHD, and EdiQBitProducer.produce failed with NoClassDefFoundError: org/apache/sshd/common/session/SessionContext. Tests: 270 run, 0 failures, Checkstyle 0. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
11 KiB
Changelog
Following Keep a Changelog and Semantic Versioning.
[Unreleased]
Fixed
org.apache.sshd:sshd-sftpis declared (the SFTP transport imports it). It used to arrive only throughqqq-backend-module-filesystem; a host that also gets that module from a dependency which excludes its SSH stack (qbit-object-storagedoes) resolved it without SSHD, andEdiQBitProducer.producefailed withNoClassDefFoundError: org/apache/sshd/common/session/SessionContext.
Changed
-
EDI home is business-only: System, Dead letters, Certificates expiring and Setup status move to
EdiHome.ADMIN_WIDGET_NAMESfor the host's Admin home (gated toedi.admin.hasAccess, full width); every home widget now requiresedi.hasAccessand is hidden without it. A new "Inbound documents are delayed" alert links to the delayed inbound documents once the oldest is older thaninboundDelayedAfterMinutes(default 60). Setup counts that fail show "Unavailable" and are logged instead of -1. -
UI API extension edi 1.1.0 (requires QQQ 4.1.0-RC.15, UI API 1.6.0): operationIds, standard error responses with BasicErrorResponseV1, extension tags, and retained deprecated EdiErrorV1 schema.
-
Derive qbit metadata version from the Maven artifact version, keeping release metadata and help bundle versions in sync.
-
Require QQQ 4.1.0-RC.7 for core help-bundle registration and coverage validation.
-
X12 routing and sending honor identity
isActive, matching EDIFACT.
Added
-
Complete, host-neutral
help/qbit-edi.yamlbundle registered with QQQ core: app, tables, fields, actions, widgets and possible-value sources, with a coverage gate and HOST overrides. Table/app fallback remains available withouthelpContent. -
Setup status section on the EDI home (partner, identities, agreement, agreement documents, transport, certificates, guides, maps) with the next step; it counts only the active rows the runtime uses.
-
"Install sample maps" action on Maps: standard streamed ETL, insert-only by name, installs the 32 bundled synthetic maps as draft, unbound maps bound to the built-in guide.
-
EdiTablesGuardrailTest: every table is used at runtime, seeded or listed as starting empty, and has help. -
Phase f1
edi1.0.0 spec'd UI API: guide tree, map target/transform metadata, encrypted base64 sample preview with unsaved rule overrides, and per-rule validation under/qqq/v1/qbit/edi. -
Versioned
Edi...V1schemas and generated OpenAPI fragment with the RC.6 contract/compatibility checks; real HTTP strict-mode permission, PHI, upload, isolation and validation tests. -
Shared sandbox/record-action preview service, current/original guide selection, caller-session transforms, structured revision/expected diffs and value-free PHI diagnostics.
-
Transform registry argument schemas, including host-supplied schemas. Preview Map record actions now enforce the documented exact
edi.map.previewpermission through core's full-name permission checker. -
Phase g EDIFACT syntax 3/4 envelopes (UNA/UNB, optional UNG/UNE, UNH/UNT, UNZ), release escaping, native envelope findings, UNB identity routing, 14-digit UN control allocation and duplicate detection.
-
Original D96A/D01B ORDERS, ORDRSP, DESADV, INVOIC and CONTRL guides; ORDERS inbound and retail response outbound sample maps with composite fields and segment groups.
-
Standard-neutral document validation/mapping, mixed X12/EDIFACT inbox framing, CONTRL generation and reconciliation with overdue resolution and rejection alerts, native outbound envelopes and archived resend-as-new.
-
Lindqvist Retail AB demo partner with ORDERS application, ORDRSP/DESADV/INVOIC delivery and CONTRL in both directions; EDIFACT map preview and HTTPS media type.
-
Phase e original HIPAA baselines for 837P/I, 835, 270/271, 276/277 and 834; exact SNIP 3 balancing, occurrence-scoped SNIP 4 rules, SNIP 5 formats and a host
ExternalCodeSetProviderSPI. -
Test-only healthcare maps, classified sample tables, seeded synthetic fixtures, Cedar Health Clearinghouse demo traffic and a PHI canary scanner covering both ingress paths, 999s, apply/replay/resend, widgets, query exports, alerts and logs.
-
Permission-checked, session-bound Download Raw Document actions for inbox/interchange rows, with a value-free user audit event.
-
Phase d warehouse and logistics baseline guides for 940, 945, 214 and 204 in 004010 and 005010 (syntax notes, situational control-total and stop rules, AT7 pairing), inbound/outbound sample maps (940 in, 945 out/in, 214 in, 204 in/out), DATEPART/TIMEPART outbound transforms and
+-joined inbound paths for date/time pairs, and Harbor Logistics and Ridgeline Freight demo traffic. -
Phase c AS2:
As2Transportsend and receive (RFC 4130) with S/MIME signing (SHA-256/384/512; SHA1 flagged), encryption (AES-128/256 CBC or GCM; 3DES flagged), optional compression, synchronous and asynchronous signed MDNs with MIC verification, Test Connection, optional TLS pinning and VAN transports with no partner. Built on as2-lib 5.1.8 and BouncyCastle, entirely in memory (no keystore or temporary files). -
POST /qqq/hooks/edi/as2/{transport}and/{transport}/mdnroute provider: identity, decryption (ACTIVE or NEXT keys), signature and MIC checks, Message-ID dedupe returning the original MDN, error MDNs with no inbox row, and a queued, retried asynchronous MDN sender. -
Read-only
edi_as2_mdntable with "AS2 MDNs" child lists on outbound and inbound messages; raw MDNs in the encrypted payload store;edi_outbound_message.transport_mic;edi_transport.weak_crypto;EdiQBitConfig.publicBaseUrl. -
Certificates: parsed on save (private keys refused), keys from environment PEM PKCS#8 or base64 PKCS#12, ACTIVE/NEXT rollover, record actions Promote Certificate and Export Public Certificate, expiry alerts for ACTIVE and NEXT, and the
edi.mdn.overduealert. -
Demo: Pacific Wholesale over AS2 against an in-process BouncyCastle peer with in-memory certificates; AS2 acceptance tests in both directions against our own route and an independent peer.
-
Phase b retail baseline guides for 855/856/810/846/860 in 004010 and 005010; inbound/outbound sample maps and nested outbound associations with SEQUENCE/HL transforms.
-
Transactional RECORD_CHANGE and manual enqueue, host-wired ESB process, batch schedules, validated encrypted envelopes, send workers, retries and dead-letter alerts.
-
Instance transport registry, MINA SFTP streaming push/poll with pinned host keys, gateway OUTBOX stand-in/download delivery, and authenticated HTTPS ingress/egress using core Standard Webhooks.
-
Ack and certificate monitoring, functional-ack exception resolution, resend/re-envelope/cancel actions, transport tests and outbound queue home statistics.
-
Test-scope H2/Next UI demo with synthetic retail traffic, in-memory gateway and public self-signed certificates; local HTTP/SFTP and application acceptance tests.
-
Phase a2 inbound vertical slice: gateway intake, fenced inbox claims/retries, dead letters and core alerts; routing, validation, duplicates, safe events and exception occurrence counts.
-
Versioned inbound maps, wildcard associations, transforms, permission-enforced transactional upsert and original/current revision replay.
-
Queued enveloped TA1/997/999 and inbound acknowledgement reconciliation; outbound request/message tables for phase b.
-
Public-API-only encrypted object-storage adapter and marked file-gateway contract stand-in.
-
EDI app, typed home with permission-scoped counts, main-table search metadata, optional ESB events with identifier-only document payloads, and standard Review/Result actions.
-
Synthetic sample upload, preview comparisons and encrypted JSON downloads; guide overrides and guide/map activation.
-
Contingent possible values on existing/new tables, including actual filtered-search tests.
-
PostgreSQL schema additions and UTC zone-less timestamps matching RC.5 RDBMS bindings.
-
Phase a1 data model: 21 annotated entities, QQQ tables, enum/table value sources, joins, child lists, audit, permissions, partner locks, and PostgreSQL DDL with metadata-derived H2 integration tests.
-
StAEDI 1.26.4 X12 streaming envelopes, separator detection, bounded transaction buffers, structured envelope findings, and fixed-width ISA serialization.
-
Original 850/997/999 baseline guides, versioned database loading, SNIP 1–2 validation, syntax notes, and the documented situational rule language.
-
TA1, 997 and 999 builders with acknowledgement levels, positional situational context, reply envelopes, and inbound acknowledgement parsing.
-
Atomic RDBMS control-number allocation with first-use creation, wrap/exhaustion handling, and interchange/group/transaction duplicate detection.
-
Database payload storage with AES-256-GCM envelope encryption, SHA-256 integrity metadata, key rotation, and replaceable environment-secret resolution.
-
Per-instance runtime services and configuration, synthetic generators, exact acknowledgement fixtures, concurrent SQL tests, and payload tests that verify no temporary files are created.
-
Repository scaffold to the QRun qbit repository standard:
qbit-build-parent2.0.0, QQQ 4.1.0-RC.5, Maven wrapper, Checkstyle, JaCoCo gate, CircleCI qqq-orb 0.6.8, release-candidate workflow, Dependabot, community files. -
EdiQBitProducerandEdiQBitConfig(table prefixedi_, permission baseedi).
Changed
- QQQ baseline is now 4.1.0-RC.6. EDI tables/fields and healthcare test fixtures use core
DataClassificationthroughAiTableMetaData/AiFieldMetaData, preserving PHI, PII, CONFIDENTIAL and PHI AI-exposure restrictions. - Exception Assign and new/reopened partner rejection/dead-letter exceptions send value-free core notifications after commit, with capturing-sink and PHI canary coverage.
- Retain
PhiLogScopefor core #1147 until RC.7: RC.6 still logs RDBMS query filters and has no redaction hook orFieldAccessHelper. Contingent dependency-behavior APIs are also absent; shared-choice filters remain tested.
Removed
- Reflective
EdiClassificationsRC.5 stand-in. File-gateway stand-ins remain until its API is published; the object-storage API integration is unchanged.
Fixed
-
Shared-choice filters group partner-or-shared alternatives beneath an AND root, so core search criteria cannot admit another partner's transports.
-
999 now accepts SNIP 3+ findings with
Einstead of rejecting every ERROR. HIPAA acknowledgement selection follows the implementation version and enabled agreement expectation; outbound HIPAA ST carries its implementation identifier. -
Qualified HL/NM1 anchors distinguish healthcare hierarchy levels; repeated loop names under different parents retain separate occurrences. Situational rules inherit direct ancestor segments without borrowing values from sibling occurrences.
-
Review/Result records expose identifiers only. A marked RC.5 PHI logging bridge prevents core upsert query diagnostics from copying claim/member values into logs.
-
Inbound apply no longer fails with a null-pointer error on a target table that has no associations (flat tables such as the 214 status sample).