Repository navigation
docs: record product and technical gap baseline #999
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Draft
seonghobae
wants to merge
380
commits into
develop
Choose a base branch
from
docs/product-technical-gap-baseline
base: develop
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Draft
Changes from 39 commits
Commits
Show all changes
380 commits
Select commit
Hold shift + click to select a range
41ce157
docs: correct current dashboard predecessor evidence
seonghobae 7248e02
docs: record #1184 dart/flutter pub-publish successor
seonghobae 08ca324
docs: record #1184 dart/flutter pub-publish successor
seonghobae 73a5f4e
docs: record #1185 hex/conda publish successor
seonghobae b5d234f
docs: record assignment-context RCA and exact detector stack
seonghobae 09c7694
docs: align gap snapshot with assignment-context repair
seonghobae 441077c
docs: correct command-context probe counts
seonghobae b7e4731
docs: record #1186 cabal/mvn publish successor
seonghobae 9e02557
docs: record heredoc-safe #1173-#1186 stack
seonghobae e926e1d
docs: note heredoc command-context precision
seonghobae 946bc01
docs: record #1187 gradle/luarocks publish successor
seonghobae 6e6d2fc
docs: record #1188 sbt/conan publish successor
seonghobae 8f68dae
docs: record quoted sbt publish RCA
seonghobae 57e102b
docs: note quoted sbt publish detection
seonghobae 5b23676
docs: record #1189 deno/pod publish successor
seonghobae 03ca0d4
docs(gap): record quoted deno and pod detector repair
seonghobae 0b21816
docs(changelog): record quoted registry task repair
seonghobae f9e9cf7
docs: record quoted CLI and no-op parser evidence
seonghobae df82a52
docs: log plugin command-context regressions
seonghobae b2c0caa
docs(gap): record direct manifest argv repair
seonghobae 3a7aa51
docs(changelog): note bounded manifest argv detection
seonghobae bc8b563
docs(gap): record nested shell detector boundary
seonghobae 784e106
docs(changelog): note bounded nested shell detection
seonghobae 30c4c0b
docs(gap): record shell option execution boundaries
seonghobae bfea297
docs(changelog): document nested shell option semantics
seonghobae 8e31d4d
docs(gap): finalize Bash option execution evidence
seonghobae 36c39b8
docs(changelog): finalize shell option boundaries
seonghobae a8d2c4c
docs(gaps): record deployment parser owner integration
seonghobae e19180d
docs(changelog): note deployment parser boundary repair
seonghobae 481afb6
docs(gap): record GitHub command-context repair
seonghobae 1e10009
docs(changelog): note GitHub command-context repair
seonghobae a3a7c66
docs(gap): record dashboard regression restoration
seonghobae 0e0e46b
docs(changelog): note dashboard security regression
seonghobae a2c8ec0
docs(gap): bind dashboard evidence to final head
seonghobae 2bd73e5
docs(gap): bind dashboard and gateway failure evidence
seonghobae 7056b65
docs(changelog): record exact-head review-control failure
seonghobae 789cf4b
docs(gap): record browser prerequisite carryover
seonghobae e71828e
docs(changelog): record browser regression carryover
seonghobae 6ee8471
docs(gap): bind concurrent count and browser repair
seonghobae 58f2319
docs(changelog): record concurrent dashboard repair
seonghobae 029781c
docs: bind dashboard regression recovery evidence
seonghobae bd4cc4b
docs: bind responsive dashboard evidence
seonghobae 6d6d774
docs: record dashboard mobile overflow repair
seonghobae cdeb3dd
docs(gaps): bind scoped September 12 detector evidence
seonghobae 5b3dfc5
docs(gaps): bind cancelled positive-LSM owner evidence
seonghobae e9ed973
docs(gaps): bind terminal CodeQL owner failure
seonghobae 7e6f79d
docs(gaps): follow CodeQL owner repair head
seonghobae dc094e7
docs(gaps): bind invocation namespace regression
seonghobae b5bc38a
docs(gaps): refresh central CodeQL owner evidence
seonghobae 3b8d9e8
docs(gaps): bind command identity RED-GREEN
seonghobae 1f389bb
docs(gaps): preserve plugin detector successor stack
seonghobae c347541
docs(gaps): bind full plugin regression evidence
seonghobae 2f4ef67
docs(gap): record MCP detector precision repair
seonghobae 68dd4fb
docs(gap): record network secret precision repair
seonghobae ea4f958
docs(gap): record successor carryover through 1145
seonghobae 1bfa097
docs(gap): extend successor carryover through 1146
seonghobae 733207d
docs(gap): record detector carryover through 1161
seonghobae 90b875c
docs: extend security successor evidence through PR 1167
seonghobae 0677e84
docs: extend security successor evidence through PR 1168
seonghobae 8091fa7
docs: bind checksum path repair evidence
seonghobae 9db9b7c
docs: bind GitHub command detector successor evidence
seonghobae b555589
docs: correct historical review count
seonghobae 9c85172
docs: bind credential-store successor evidence
seonghobae 3479dc2
docs: bind deployment-write successor evidence
seonghobae b6b03f0
docs: bind Terraform and Helm successor evidence
seonghobae 791e2b5
docs: bind hosted-deploy successor evidence
seonghobae 56a55b3
docs: refresh security corpus through PR 1175
seonghobae 5a62e43
docs: correct historical review count
seonghobae 99c64ac
docs: refresh security corpus through PR 1176
seonghobae 71345ad
docs: advance security gap baseline through #1177
seonghobae 988e7cd
docs: advance security gap baseline through #1179
seonghobae 24dbe1b
docs: advance security gap baseline through #1180
seonghobae 0ddbf74
docs(gap): record console severity-map repair
seonghobae 0a42d57
docs(gap): align severity repair review admission
seonghobae c5187b1
docs(gap): bind severity repair workflow state
seonghobae 71566ab
docs(gap): record canonical webhook boundary repair
seonghobae f2d6ce7
docs(gap): record verified duplicate retirement
seonghobae b760a01
docs: record #1182 restack and #1217 regression repair
seonghobae 0610808
docs: record #1183 and #1184 successor restacks
seonghobae 32f8354
docs: record #1185 successor restack
seonghobae c69f134
docs: record #1186 successor restack
seonghobae 25b9ded
docs: advance security detector baseline through #1187
seonghobae b9308fa
docs: advance security detector baseline through #1188
seonghobae ff2ea88
docs: advance security gap baseline through PR 1189
seonghobae eeaa197
docs(gap): bind webhook DNS-pinning repair
seonghobae a01a2b4
docs(gap): record webhook Ready boundary
seonghobae 0dd2071
docs(security): record webhook successor retirements
seonghobae ec5073d
docs(security): preserve #1268 review gate
seonghobae b7b7245
docs(gap): record SARIF help URI repair
seonghobae e62ac73
docs(gap): record SARIF index successor
seonghobae 7a4213e
docs(gaps): record SARIF stack regression recovery
seonghobae eb534f5
docs(gaps): admit SARIF metadata repair to review
seonghobae f5a6643
docs(gaps): record bounded plugin inventory repair
seonghobae 328c6dd
docs(gap): bind PR 1129 exact repair evidence
seonghobae 1593502
docs: refresh issue detector exact-head evidence
seonghobae 2755c6d
docs(gap): bind Python shell-call detector evidence
seonghobae 8ae5b1a
docs(gap): bind exact detector successor evidence
seonghobae 1e11e01
docs(gap): record concurrent guard recovery
seonghobae fb8a268
docs(gaps): record repeated severity-guard recovery
seonghobae e4c21b7
docs(gaps): record writer conflict and owner restack
seonghobae 09a182b
docs(gaps): record Python detector regression recovery
seonghobae fa2d6e1
docs(gaps): bind current Python detector head
seonghobae 6e3d315
docs(gaps): bind source-neutral successor heads
seonghobae b992017
docs(gaps): bind malformed SARIF URI repair
seonghobae 80f3fca
docs(gaps): bind SARIF successor restack
seonghobae 4472ecf
docs(gaps): record console scalar boundary repair
seonghobae 8b796a2
docs: record console regression restoration
seonghobae c337069
docs(gap): bind workflow lifecycle review repair
seonghobae 026fcb2
docs(gap): record SARIF successor carryover
seonghobae c826101
docs(gap): bind workflow prefilter regression
seonghobae bc0ccc7
docs(gap): bind push prefilter regression
seonghobae 48b6674
docs(gap): bind console successor carryover
seonghobae 8b12626
docs(gap): bind inventory successor carryover
seonghobae 1e213f7
docs: record verified security predecessor carryovers
seonghobae e1e7668
docs: bind current webhook successor identity
seonghobae 86a38ea
docs: pin latest webhook owner identity
seonghobae 0230d81
docs: record reference extraction successor evidence
seonghobae 86cd94d
docs: record measured normalization successor evidence
seonghobae 537c1f8
docs: record reference-loop successor retirements
seonghobae c73311a
docs: record PR 1297 verified carryover
seonghobae e00c7c4
docs: record PR 1317 verified carryover
seonghobae 1a2d575
docs: record PR 1224 verified carryover
seonghobae faec22e
docs: record PR 1326 stale-child repair
seonghobae 23befc3
docs: record PR 1326 successor retirement
seonghobae e96d51d
docs: record source-neutral exact-head evidence
seonghobae 888870c
docs: bind Python detector live-head evidence
seonghobae dd6896b
docs: record performance-contract regression repair
seonghobae 6c8e294
docs: record CodeQL settlement diagnosis gap
seonghobae 0da65c4
docs: bind CodeQL terminal proof owner repair
seonghobae 60baefd
docs: bind exact CodeQL terminal evidence
seonghobae 3280f8b
docs: bind workflow lifecycle proof repairs
seonghobae cc7b7d3
docs: record SSRF claim boundary and protected merge
seonghobae 406e290
docs: record console and Python 3.14 gap evidence
seonghobae 2ad9891
docs: bind canonical console writer repair
seonghobae 9144713
docs: record console successor retirements
seonghobae d1b1e85
docs: bind Python 3.14 review and CI repair
seonghobae a8d8b52
docs: bind canonical SSRF incident carryover
seonghobae ded5277
docs: record canonical SSRF stale-writer recovery
seonghobae c21e155
docs: record SSRF owner successor retirement
seonghobae 1996cc7
docs: restack security gap baseline on protected develop
seonghobae 902b68d
docs: bind live SSRF successor review head
seonghobae bfe7b05
docs(gap): record deterministic SSRF resolver repair
seonghobae d2b1369
docs(gap): record SSRF concurrent-writer recovery
seonghobae 6dc7826
docs(gap): bind live SSRF successor head
seonghobae 7776afb
docs(gap): record terminal #1192 security evidence
seonghobae e28176c
docs(gap): record #1356 CodeQL settlement RCA
seonghobae 10b3d70
docs(gap): refresh live SSRF and Python 3.14 gates
seonghobae 9e6f708
docs(gap): record repeated source-neutral SSRF head
seonghobae 66621fc
docs(gap): record fourth source-neutral SSRF head
seonghobae cd8e1b5
docs(gap): refresh exact-head SSRF checks
seonghobae f189dbd
docs(gap): record fifth source-neutral SSRF head
seonghobae 5bfa787
docs(gap): record CodeQL settlement detector restack
seonghobae 6ef8f75
docs(gap): record XSS carryover and review admission
seonghobae 33ebbbb
docs(gap): record console review admission
seonghobae 0ecd87e
docs(gaps): record CodeQL evidence handoff repair
seonghobae ab93eca
docs(gap): record structured argv inventory repair
seonghobae bced53b
docs(gap): record escaped nested publish repair
seonghobae 753a2da
docs(gap): record console severity fallback
seonghobae a3dc308
docs(gap): record console review admission
seonghobae cf922f9
docs(gap): record console writer repair
seonghobae e1e3bbe
docs(gap): record console exact-head gates
seonghobae 6d63378
docs(gap): restore UTF-8 baseline integrity
seonghobae 94ad36b
docs(gaps): record SARIF rule-index repair evidence
seonghobae c543352
docs(gaps): record SARIF duplicate carryover
seonghobae f63e9be
docs(gaps): admit SARIF candidate for review
seonghobae 56ad7c1
docs(gaps): retire zero-delta experiment
seonghobae 9462879
docs(gap): record env argv and command-position corpus
seonghobae b133b80
docs: record exec wrapper and reject false XSS incident
seonghobae bb1b302
docs: record POSIX command wrapper regression
seonghobae 34fa46d
docs: record env terminator detector boundary
seonghobae 55a610a
docs: record live PR review boundaries
seonghobae eb496a9
docs: record detector restack and env bare-dash RCA
seonghobae af9184c
docs(gap): record GNU env diagnostic wrappers
seonghobae 05b32f5
docs: refresh PR 1189 GNU env corpus evidence
seonghobae f806954
docs: record DNS TOCTOU detector corpus
seonghobae 581576f
docs: correct DNS detector signal boundary
seonghobae a177e81
test: require public README license evidence in gap baseline
seonghobae f86d1bb
docs: bind public README and license writers in gap baseline
seonghobae 3d5c1e4
docs: record README license lane authority
seonghobae bdf60be
docs: refresh #1327 regression recovery evidence
seonghobae 96bded7
docs: bind #1327 recovery in baseline changelog
seonghobae 9d7e340
docs: refresh #998 and #1129 exact security evidence
seonghobae f1e7341
docs: record #998/#1129 detector propagation
seonghobae 81e2f91
docs: record DNS fail-open detector corpus
seonghobae 9769760
docs: bind #1327 DNS fail-open evidence
seonghobae 11fcd56
docs: record terminal SSRF detector checks
seonghobae 2fe2fd2
docs: settle SSRF detector gate evidence
seonghobae 0b7e054
docs: record third SSRF corpus recovery
seonghobae d967783
docs: settle recurrent SSRF recovery evidence
seonghobae 04f82bc
docs: restore baseline paragraph boundaries
seonghobae 7362f4b
docs: restore changelog paragraph boundaries
seonghobae f9c6372
docs: bind source-neutral SSRF review head
seonghobae 1ab311b
docs: record SSRF review-admission head
seonghobae 4ace042
docs: bind current SSRF exact head
seonghobae 411ba2a
docs: settle source-neutral SSRF head
seonghobae 03db6fe
docs: record PyPI release-source detector corpus
seonghobae a01d798
docs(gaps): record #1368 contract and #1369 retirement
seonghobae 63fb152
docs: refresh pending-row regression evidence
seonghobae dad301e
docs: retain EgressWeave local-policy corpus
seonghobae 18aa887
docs(gaps): record Issue 850 detector evidence
seonghobae a4dee3f
docs(gap): reconcile #850 and #1087 detector evidence
seonghobae 095415d
docs(gap): settle #1088 exact-head checks
seonghobae 357c71b
docs: bind issue 1299 to canonical test-context writer
seonghobae 2dd258f
docs: record non-vacuous test-context regression
seonghobae 6ade301
docs: record duplicate-writer carryover settlement
seonghobae 222cf02
docs: record protected-base integration for public surface
seonghobae ffe5904
docs: record canonical sidecar secret boundary
seonghobae a9a1321
docs: settle canonical owner security evidence
seonghobae f4d7a76
docs: align canonical owner gap references
seonghobae ec380c9
docs(gaps): record owner review repair
seonghobae 9b15c64
docs(gaps): keep owner lifecycle proposed
seonghobae 4b2e373
docs(gaps): settle owner security checks
seonghobae 262f528
docs(gap): refresh #1324 false-positive RCA
seonghobae d1f712b
docs(gap): bind #1324 Ready gate evidence
seonghobae bde3834
docs(gap): record #1324 AST resource-limit RCA
seonghobae 8579f3f
docs(gap): preserve #1324 concurrent recovery evidence
seonghobae c5ba836
docs(gaps): refresh Python shell detector recovery evidence
seonghobae aefc736
docs(gaps): record false literal shell regression
seonghobae 3bb49e3
test(gaps): verify retained history blob
seonghobae 285a29d
fix(gaps): restore binary integrity delimiters
seonghobae 1d184c4
docs(gaps): record dashboard category integrity defect
seonghobae 3a31113
docs(gap): record upload proxy regression carryover
seonghobae 15a6187
docs(gap): record concurrent upload-proxy replay
seonghobae 70cb89a
docs(gap): record SARIF help URI integration evidence
seonghobae 1b988f7
docs(gap): register hostname-less URL fail-open corpus
seonghobae a3d7c47
docs(gap): record console severity lookup repair
seonghobae 17f88c6
docs: record stacked console scalar boundary
seonghobae 2cfb770
docs: record SARIF duplicate-writer settlement
seonghobae faa6747
docs(gaps): record G-29 accessibility writer settlement
seonghobae 10036b3
docs(gaps): record dashboard map-key corpus settlement
seonghobae 16758c9
docs(gaps): bind second dashboard duplicate retirement
seonghobae be360e3
docs: record console scalar and identifier boundary
seonghobae 1cfc85d
docs: record external SSRF category boundary
seonghobae f9b0ad8
docs: correct SSRF implementation blob evidence
seonghobae 31b333e
docs: preserve SSRF adapter regression evidence
seonghobae 5e7b5ae
docs: bind compact SSRF adapter regression
seonghobae 19514d3
docs: reconcile upload proxy duplicate
seonghobae b807e9c
docs: reconcile upload proxy duplicates
seonghobae 8179a46
docs(gap): record hostname-guard detector boundary
seonghobae 11a75ab
docs(gaps): record imported finding redaction boundary
seonghobae 22d8528
docs(gaps): record runtime package integrity boundary
seonghobae c04d3e5
docs(gaps): normalize G-34 baseline ending
seonghobae afc01d9
docs(gap): correct G-34 trust boundary after review
seonghobae 66cb193
fix(docs): restore complete G-34 baseline after transport truncation
seonghobae cbe3f8b
docs(gap): bind G-34 to step-local detector evidence
seonghobae fa67856
docs(gap): record structural runtime package analyzer
seonghobae 28e4fb1
docs(gap): record compact step syntax coverage
seonghobae 9113079
docs(gap): record severity writer settlement
seonghobae fb8ded8
docs(gap): record privileged PR-head detector
seonghobae 27a8e68
docs: refresh exact security detector evidence
seonghobae File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,152 @@ | ||
| # AppGuardrail product and technical gap baseline | ||
|
|
||
| **Snapshot:** 2026-09-02 | ||
| **Authority:** protected `develop` documentation plus live exact-head GitHub evidence | ||
| **Status:** working baseline; not a release, certification, or protected-branch capability claim | ||
|
|
||
| ## Goal and evidence contract | ||
|
|
||
| AppGuardrail is the ContextualWisdomLab security-defect corpus and executable detection/remediation boundary. Buyer value is not a rule count: a retained incident becomes useful only when the causal failure is reproducible, its preconditions and observable signals are explicit, safe lookalikes and equivalent misses are tested, the canonical source owner is repaired when necessary, and exact-head evidence survives ordinary protected integration. | ||
|
|
||
| Issue text, registry rows, fixtures, predecessor checks, queued workflows, and model reviews are not detector truth. Executable scanner/analyzer evidence is authoritative. Runtime prevention and scanner detection are separate obligations. Missing, unavailable, stale, cancelled, failed, or inconclusive evidence never becomes `Clean Scan` by omission. | ||
|
|
||
| The development loop is: | ||
|
|
||
| ```text | ||
| security corpus → causal owner/root cause → RED regression → smallest safe repair | ||
| → exact-head Checks/current-head review → ordinary protected merge/release | ||
| → protected-owner oracle refresh → next corpus item / buyer-visible Gap | ||
| ``` | ||
|
|
||
| Review, check, deployment, or release waits are non-blocking across independent safe lanes. Force push, destructive rebase, self-approval, gate weakening, warning suppression, detection bypass, stale-check reuse, and admin protection bypass are prohibited. | ||
|
|
||
| ## PRD / TRD / architecture status | ||
|
|
||
| The protected PRD and `ARCHITECTURE.md` define four separable product planes: | ||
|
|
||
| ```text | ||
| scan built-in executable detectors + provenance-preserving external engines | ||
| remediate deterministic safe transforms + reviewable verification guidance | ||
| control tenant-isolated scan/history/drift/API-key/webhook behavior | ||
| assurance SARIF, reports, SBOM, CI/release provenance and buyer evidence | ||
| ``` | ||
|
|
||
| `docs/PRD.md` remains product authority; `docs/TRD.md` records technical contracts; root `ARCHITECTURE.md` and `docs/UML.md` remain component/control-flow authorities; `docs/TRACEABILITY.md` binds defect classes to executable evidence; `docs/THREAT_MODEL.md`, `docs/TEST_STRATEGY.md`, and `docs/OPERABILITY.md` define abuse, verification and operations. This baseline does not create a competing architecture. | ||
|
|
||
| **UML:** existing architecture/UML material remains authoritative; detector work that changes a component boundary must update it. | ||
| **ERD:** AppGuardrail detector fixtures and issue-corpus metadata are evidence artifacts, not a new transactional aggregate. Control-plane persistence remains the database authority; any new persisted evidence aggregate requires tenant ownership, lifecycle, retention/deletion, provenance, rollback and migration contracts before implementation. | ||
|
|
||
| ## Context Map | ||
|
|
||
| ```mermaid | ||
| flowchart LR | ||
| SRC[ContextualWisdomLab repositories/workflows\nsecurity defects] | ||
| CORPUS[AppGuardrail issue corpus\nincident + provenance] | ||
| OBL[Detection obligation\nroot cause + preconditions + signals] | ||
| DET[Executable detector/analyzer] | ||
| REG[Regression corpus\npositive / negative / inconclusive] | ||
| FIND[Finding / SARIF / remediation] | ||
| OWNER[Canonical causal owner\nsource/runtime/control-plane repair] | ||
| EVID[Exact-head checks + review + release] | ||
|
|
||
| SRC --> CORPUS | ||
| CORPUS --> OBL | ||
| OBL --> DET | ||
| REG --> DET | ||
| DET --> FIND | ||
| SRC --> OWNER | ||
| OWNER --> REG | ||
| OWNER --> EVID | ||
| DET --> EVID | ||
| ``` | ||
|
|
||
| Responsibility boundaries: | ||
|
|
||
| - **AppGuardrail** owns executable detection, normalized findings/SARIF, regression evidence, remediation and detector traceability. | ||
| - **The causal repository** owns vulnerable product/runtime behavior and must carry the source repair when AppGuardrail is not the defect owner. | ||
| - **ContextualWisdomLab/.github** owns organization CI/review/security/release control-plane behavior; leaf repositories must not copy or weaken a central control to bypass an owner defect. | ||
| - **External scanners** keep source/tool/version provenance. Normalization does not relabel their evidence as built-in AppGuardrail evidence. | ||
| - **Exact-head review/check infrastructure** is acceptance evidence, never a substitute for product truth. | ||
|
|
||
| ## Security-defect corpus — live 2026-09-02 snapshot | ||
|
|
||
| | Work / corpus item | Exact observed state | Root cause / reusable security meaning | Next safe action | | ||
| | --- | --- | --- | --- | | ||
| | AppGuardrail #1088 / Issue #1087, branch `sentinel/detect-transport-only-poll-bound-1087`, latest observed descendant `95d6afcb863a36660e0ee4191b284015c66bfaab` | open/mergeable; active review continues to expose regex control-flow/state FP/FN boundaries; predecessor Checks are not acceptance evidence | verified `ContextualWisdomLab/.github` required-review incident: a retry budget counted only transport failures, so healthy API/no-verdict iterations could hold a runner indefinitely relative to repository control flow | retain three current detector identities: historical transport-only, renamed causal transport-budget, and non-convergent bound-state mutation. The temporary shell-agnostic `break 0` HIGH companion was removed after review proved default Linux Actions fail-fast semantics can make it a blocker-class false positive. Repair remaining conditional-flow, reversed-declaration, quoted-command, and deadline-tightening findings before merge. | | ||
| | `ContextualWisdomLab/.github` protected wall-clock owner repair | protected repair `e29302c05eade7da7b0bdbb453e53980bc9d577b` | adds a 10,800-second total deadline to the original polling owner and fails closed | retain as prevention/control-plane evidence and pinned fixed oracle; it does not by itself satisfy AppGuardrail scanner coverage. | | ||
| | `ContextualWisdomLab/.github` #1706, stronger event-driven runner release, latest observed head `21bf1f79a00555fe0f4be797ebac4a426a059094` | open/mergeable but explicitly Proposed/non-merge-ready because connector draft transition failed; temporary v6 source-fix run is active on the current writer | stronger buyer-visible Gap: even bounded multi-hour waiting consumes required-review capacity. Previous source-fix exact logs showed focused event-driven GREEN followed by full-suite regression failures caused by stale/old wake-contract assumptions; current descendant repairs the temporary source writer and reruns RED→GREEN publication | do not merge the RED/source-fix machinery. Require durable one-shot/event reconciliation source, full-suite GREEN, temporary workflow/helper deletion, workflow-triggering publication credential, resulting exact-head central CI/security/current-head review, then ordinary merge. | | ||
| | AppGuardrail #1080 / Issue #892, Bearer DNS-rebinding TOCTOU, head `0a752c091489efd4dc7373230f1e242313e7cca6` | open/mergeable; current-head review remains authoritative | preflight URL/DNS validation can diverge from the later credential-bearing connection; family tracks destination/request/credential/reachability and mutation state | finish current-head provenance/control-flow repairs; no predecessor GREEN reuse. This family is also evidence for the structural-analyzer Gap below. | | ||
| | AppGuardrail #1068, empty-host / unresolved-DNS SSRF, head `62df0db1a831985fc34dbdc3565cfa2688facc98` | open/mergeable | malformed or unresolved destinations could cross a fail-open validation path | preserve runtime fail-closed repair plus `python-ssrf-empty-host-fail-open` vulnerable/fixed regression; merge only on unchanged exact-head evidence. | | ||
| | AppGuardrail #1036, shared-skill supply-chain detection, head `661d5138f1d6db5db0890b7c6ca14042440d6264` | open/mergeable | installable skill/agent manifests can hide mixed-script identifiers, prompt-injection/exfiltration directives, or unresolved placeholders; current grammar deliberately bounds YAML/JSON/prose scope | retain structural-key, flow-YAML and defensive-prose FP/FN oracles; require exact-head CI/review. | | ||
| | AppGuardrail #963 / Issue #550, discarded tenant authorization context, head `c656fe68cc616852f51a97e456cdf4e0b54fa168` | open/mergeable | tenant-admin authorization can be checked while returned tenant context is discarded before global reads or tenant-sensitive mutation | keep detector oracle pinned separately from live causal-owner candidate; refresh fixed oracle only after owner protected merge. | | ||
| | `ContextualWisdomLab/clearfolio` #541, causal owner for #550, live head `917b97d153196920da76f9ba4f0df761fdf7a4ac` | open/mergeable; descendant of non-destructive security restoration `1337efe45640740b338d021d64e41c045ecf7201` | concurrent `020c0ec...` reintroduced global/controller-local tenant filtering and keyless SHA-256 retry identity while deleting application/repository/HMAC contracts; restoration preserved history while reinstating tenant-scoped ports and keyed/domain-separated HMAC | require owner exact-head CI/security/review and protected merge; then update AppGuardrail #963 protected fixed-source oracle. | | ||
| | Issue #309, `naruon` OpenSSF Best Practices badge | open LOW governance/posture; no code location or reproducible source→sink path | security-program maturity signal, not an application vulnerability | do not manufacture a HIGH source detector; track as governance evidence. | | ||
| | Closed #310/#311, Code Scanning analysis-category visibility | closed configuration/assurance findings | GitHub could not compare current analysis categories with protected branch | retain as assurance/configuration corpus; only add detector logic when executable category/provenance drift evidence exists. | | ||
|
|
||
| Open `security` labels are not the whole corpus. Closed incidents, source-side fixes, review-discovered FP/FN boundaries, exact failed logs, and authenticated workflow evidence remain regression inputs when they encode a reproducible security failure class. | ||
|
|
||
| ## Detector-development contract | ||
|
|
||
| Every retained security defect must record: | ||
|
|
||
| 1. **Root cause** — security-relevant state transition or missing enforcement, never title/string identity. | ||
| 2. **Preconditions** — data/control-flow, configuration, dependency, permission, secret, workflow and environment conditions. | ||
| 3. **Observable signals** — evidence AppGuardrail can acquire independently. | ||
| 4. **False-positive boundary** — safe lookalikes, including runtime/shell/protocol semantics that make textual similarity non-causal. | ||
| 5. **False-negative boundary** — equivalent syntax/control-flow not yet modeled. | ||
| 6. **Causal owner** — AppGuardrail, product repository/runtime, or `.github` control plane. | ||
| 7. **Regression evidence** — historical vulnerable incident plus fixed/negative/inconclusive oracle. | ||
| 8. **Acceptance evidence** — unchanged exact-head tests/security checks, current-head review, protected merge, immutable owner release and consumer bump where a released owner contract is involved. | ||
|
|
||
| Where regex families need path reachability, mutable state, shell semantics, or increasingly incompatible adjacency exceptions, stop treating another regular expression as the default answer. Preserve existing rule IDs and corpus as migration oracles and move the shared causal state into an executable structural analyzer. | ||
|
|
||
| ## Buyer-visible Gap register | ||
|
|
||
| | ID | Buyer-visible Gap | Current evidence | Smallest valuable slice | Exit evidence | Status | | ||
| | --- | --- | --- | --- | --- | --- | | ||
| | G-01 | A buyer cannot always prove AppGuardrail observed the authoritative source condition instead of trusting a caller assertion. | PRD detector authority plus source-backed security PRs | one end-to-end source identity → executable assessment → immutable evidence/report slice | positive/negative/malformed/unavailable/stale/adversarial cases; exact source digest and black-box production path | **In progress** | | ||
| | G-02 | `0 findings` can overstate assurance when detectors/tools/scope/provenance are incomplete. | PRD typed evidence contract | propagate `clean`, `findings_present`, `incomplete`, `failed`, `untrusted` consistently | dashboard/JSON/SARIF/report/gate agree; missing evidence never renders clean | **Open** | | ||
| | G-03 | Enterprise buyers need defensible retention/deletion/audit/recovery for scan evidence. | control-plane schema and retention/audit work | tenant-owned retention/audit policy integrated into live store/API | migration rollback, backup/restore, authorization, immutable audit and release evidence | **Open** | | ||
| | G-04 | Acquisition reviewers lack one compact exact-head source/check/provenance/causal-repair package. | OPERABILITY/assurance contracts; evidence distributed | deterministic buyer-evidence package bound to SHA/run/artifact/release | recomputable digest, no raw secrets, failed vs unavailable distinction, protected-head smoke proof | **Open** | | ||
| | G-05 | Stateful regex detector families alternate between FP and FN repairs as control-flow/provenance complexity grows. | #1080 and #1088 current review histories; #1088 already needs job/run/loop identity, safety-state causality, mutation convergence, command execution and shell semantics | implement a bounded structural GitHub Actions + shell control-flow/state analyzer first for #1087, preserving current detector IDs and corpus; use the same analyzer pattern for #1080 only after its provenance model is stable | differential corpus against current rules; all historical positives retained; safe negatives stay negative; conditional branch reachability, command-vs-quoted text, declaration order, selected shell/fail-fast state, and realistic performance measured | **Proposed, now priority architecture Gap** | | ||
| | G-06 | Shared required-review/security capacity can be consumed by wait loops even after the original transport-only defect is bounded. | protected `.github` wall-clock repair plus Proposed #1706 event-driven one-shot work | canonical `.github` one-shot admission + exact-run/event reconciliation, no repository-authored polling/model timeout | RED prerequisite→production GREEN; no real sleeps; exact PR/head/run validation; temporary source-fix machinery deleted; full central suite and required security/review GREEN | **Proposed / active owner prerequisite** | | ||
| | G-07 | This baseline can become stale while the security corpus changes rapidly. | PR #999 is the single writer | refresh from live exact heads while never claiming open candidates as protected behavior | protected merge of current snapshot; subsequent material changes produce another explicit snapshot | **In progress in #999** | | ||
|
seonghobae marked this conversation as resolved.
Resolved
|
||
|
|
||
| ## Technical / TRD gaps | ||
|
|
||
| - Built-in regex rules are valid only for explicitly tested syntax/control-flow. Structural semantics not safely representable must move to an executable analyzer or remain an explicit gap. | ||
| - GitHub Actions polling analysis must distinguish per-request transport budgets from total control-flow bounds, preserve job/run/loop locality, model branch reachability, distinguish executable commands from quoted/comment text, and account for selected shell/fail-fast semantics before using shell errors as safety or vulnerability evidence. | ||
| - Safety state is causal, not nominal: initialization must precede the candidate loop; deadlines/limits/counters must converge; state in sibling/earlier loops cannot sanitize another loop. | ||
| - Missing/queued/failed/stale/cancelled/unavailable evidence are distinct typed states. | ||
| - AppGuardrail is security tooling, not mathematical-science code. Rust/native work requires measured isolation/performance justification and a versioned boundary rather than language preference alone. | ||
| - Any future database changes use normalized tenant ownership, descriptive identifiers, migration rollback and measured locking/partition strategy; this document introduces no schema. | ||
|
|
||
| ## Governance and next actions | ||
|
|
||
| ```text | ||
| re-fetch docs/issues/PRs/current heads | ||
| → inspect reviews, unresolved threads and exact logs | ||
| → RED regression on canonical writer | ||
| → smallest causal repair | ||
| → fresh exact-head Checks | ||
| → continue another independent safe lane while waiting | ||
| → ordinary protected merge/release only when current evidence is satisfied | ||
| → refresh owner oracle + corpus + this baseline | ||
| ``` | ||
|
|
||
| 1. Continue #1088 by repairing current review blockers; do not restore the removed shell-ambiguous `break 0` HIGH rule without an executable selected-shell/fail-fast model. | ||
| 2. Treat #1088's repeated regex-state divergence as the migration oracle for G-05 structural GitHub Actions/shell analysis rather than continuing unlimited regex growth. | ||
| 3. Let `.github` #1706 remain Proposed until its active source-fix run produces durable owner source, full-suite GREEN and self-removal of temporary machinery; then require the resulting exact-head central protection normally. | ||
| 4. Keep #1080, #1068, #1036 and #963 exact-head evidence independent; predecessor success never transfers. | ||
| 5. Keep `ContextualWisdomLab/clearfolio` #541 owner evidence separate from AppGuardrail #963 detector maturity until protected owner merge. | ||
| 6. Refresh this baseline after material exact-head changes, protected merges/releases, new reproducible security classes, or PRD/ADR/ARCHITECTURE boundary changes. | ||
|
|
||
| ## Standards and acceptance basis | ||
|
|
||
| These references guide control design; they are not a claim of CSAP, SOC 2, or another certification. | ||
|
|
||
| National Institute of Standards and Technology. (2022). *Secure software development framework (SSDF) version 1.1: Recommendations for mitigating the risk of software vulnerabilities* (NIST Special Publication 800-218). https://doi.org/10.6028/NIST.SP.800-218 | ||
|
|
||
| OWASP Foundation. (2025). *OWASP Application Security Verification Standard (ASVS) 5.0.0*. https://owasp.org/www-project-application-security-verification-standard/ | ||
|
|
||
| SLSA. (n.d.). *SLSA specification version 1.2*. Retrieved September 2, 2026, from https://slsa.dev/spec/v1.2/ | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.