Skip to content
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 Sep 8, 2026
7248e02
docs: record #1184 dart/flutter pub-publish successor
seonghobae Sep 8, 2026
08ca324
docs: record #1184 dart/flutter pub-publish successor
seonghobae Sep 8, 2026
73a5f4e
docs: record #1185 hex/conda publish successor
seonghobae Sep 8, 2026
b5d234f
docs: record assignment-context RCA and exact detector stack
seonghobae Sep 8, 2026
09c7694
docs: align gap snapshot with assignment-context repair
seonghobae Sep 8, 2026
441077c
docs: correct command-context probe counts
seonghobae Sep 8, 2026
b7e4731
docs: record #1186 cabal/mvn publish successor
seonghobae Sep 8, 2026
9e02557
docs: record heredoc-safe #1173-#1186 stack
seonghobae Sep 8, 2026
e926e1d
docs: note heredoc command-context precision
seonghobae Sep 8, 2026
946bc01
docs: record #1187 gradle/luarocks publish successor
seonghobae Sep 8, 2026
6e6d2fc
docs: record #1188 sbt/conan publish successor
seonghobae Sep 8, 2026
8f68dae
docs: record quoted sbt publish RCA
seonghobae Sep 8, 2026
57e102b
docs: note quoted sbt publish detection
seonghobae Sep 8, 2026
5b23676
docs: record #1189 deno/pod publish successor
seonghobae Sep 8, 2026
03ca0d4
docs(gap): record quoted deno and pod detector repair
seonghobae Sep 8, 2026
0b21816
docs(changelog): record quoted registry task repair
seonghobae Sep 8, 2026
f9e9cf7
docs: record quoted CLI and no-op parser evidence
seonghobae Sep 8, 2026
df82a52
docs: log plugin command-context regressions
seonghobae Sep 8, 2026
b2c0caa
docs(gap): record direct manifest argv repair
seonghobae Sep 8, 2026
3a7aa51
docs(changelog): note bounded manifest argv detection
seonghobae Sep 8, 2026
bc8b563
docs(gap): record nested shell detector boundary
seonghobae Sep 8, 2026
784e106
docs(changelog): note bounded nested shell detection
seonghobae Sep 8, 2026
30c4c0b
docs(gap): record shell option execution boundaries
seonghobae Sep 8, 2026
bfea297
docs(changelog): document nested shell option semantics
seonghobae Sep 8, 2026
8e31d4d
docs(gap): finalize Bash option execution evidence
seonghobae Sep 8, 2026
36c39b8
docs(changelog): finalize shell option boundaries
seonghobae Sep 8, 2026
a8d2c4c
docs(gaps): record deployment parser owner integration
seonghobae Sep 8, 2026
e19180d
docs(changelog): note deployment parser boundary repair
seonghobae Sep 8, 2026
481afb6
docs(gap): record GitHub command-context repair
seonghobae Sep 8, 2026
1e10009
docs(changelog): note GitHub command-context repair
seonghobae Sep 8, 2026
a3a7c66
docs(gap): record dashboard regression restoration
seonghobae Sep 8, 2026
0e0e46b
docs(changelog): note dashboard security regression
seonghobae Sep 8, 2026
a2c8ec0
docs(gap): bind dashboard evidence to final head
seonghobae Sep 8, 2026
2bd73e5
docs(gap): bind dashboard and gateway failure evidence
seonghobae Sep 8, 2026
7056b65
docs(changelog): record exact-head review-control failure
seonghobae Sep 8, 2026
789cf4b
docs(gap): record browser prerequisite carryover
seonghobae Sep 8, 2026
e71828e
docs(changelog): record browser regression carryover
seonghobae Sep 8, 2026
6ee8471
docs(gap): bind concurrent count and browser repair
seonghobae Sep 8, 2026
58f2319
docs(changelog): record concurrent dashboard repair
seonghobae Sep 8, 2026
029781c
docs: bind dashboard regression recovery evidence
seonghobae Sep 8, 2026
bd4cc4b
docs: bind responsive dashboard evidence
seonghobae Sep 8, 2026
6d6d774
docs: record dashboard mobile overflow repair
seonghobae Sep 8, 2026
cdeb3dd
docs(gaps): bind scoped September 12 detector evidence
seonghobae Sep 12, 2026
5b3dfc5
docs(gaps): bind cancelled positive-LSM owner evidence
seonghobae Sep 12, 2026
e9ed973
docs(gaps): bind terminal CodeQL owner failure
seonghobae Sep 12, 2026
7e6f79d
docs(gaps): follow CodeQL owner repair head
seonghobae Sep 12, 2026
dc094e7
docs(gaps): bind invocation namespace regression
seonghobae Sep 12, 2026
b5bc38a
docs(gaps): refresh central CodeQL owner evidence
seonghobae Sep 12, 2026
3b8d9e8
docs(gaps): bind command identity RED-GREEN
seonghobae Sep 12, 2026
1f389bb
docs(gaps): preserve plugin detector successor stack
seonghobae Sep 12, 2026
c347541
docs(gaps): bind full plugin regression evidence
seonghobae Sep 12, 2026
2f4ef67
docs(gap): record MCP detector precision repair
seonghobae Sep 12, 2026
68dd4fb
docs(gap): record network secret precision repair
seonghobae Sep 12, 2026
ea4f958
docs(gap): record successor carryover through 1145
seonghobae Sep 12, 2026
1bfa097
docs(gap): extend successor carryover through 1146
seonghobae Sep 12, 2026
733207d
docs(gap): record detector carryover through 1161
seonghobae Sep 12, 2026
90b875c
docs: extend security successor evidence through PR 1167
seonghobae Sep 12, 2026
0677e84
docs: extend security successor evidence through PR 1168
seonghobae Sep 12, 2026
8091fa7
docs: bind checksum path repair evidence
seonghobae Sep 12, 2026
9db9b7c
docs: bind GitHub command detector successor evidence
seonghobae Sep 12, 2026
b555589
docs: correct historical review count
seonghobae Sep 12, 2026
9c85172
docs: bind credential-store successor evidence
seonghobae Sep 12, 2026
3479dc2
docs: bind deployment-write successor evidence
seonghobae Sep 12, 2026
b6b03f0
docs: bind Terraform and Helm successor evidence
seonghobae Sep 12, 2026
791e2b5
docs: bind hosted-deploy successor evidence
seonghobae Sep 12, 2026
56a55b3
docs: refresh security corpus through PR 1175
seonghobae Sep 19, 2026
5a62e43
docs: correct historical review count
seonghobae Sep 19, 2026
99c64ac
docs: refresh security corpus through PR 1176
seonghobae Sep 19, 2026
71345ad
docs: advance security gap baseline through #1177
seonghobae Sep 19, 2026
988e7cd
docs: advance security gap baseline through #1179
seonghobae Sep 19, 2026
24dbe1b
docs: advance security gap baseline through #1180
seonghobae Sep 19, 2026
0ddbf74
docs(gap): record console severity-map repair
seonghobae Sep 19, 2026
0a42d57
docs(gap): align severity repair review admission
seonghobae Sep 19, 2026
c5187b1
docs(gap): bind severity repair workflow state
seonghobae Sep 19, 2026
71566ab
docs(gap): record canonical webhook boundary repair
seonghobae Sep 19, 2026
f2d6ce7
docs(gap): record verified duplicate retirement
seonghobae Sep 19, 2026
b760a01
docs: record #1182 restack and #1217 regression repair
seonghobae Sep 19, 2026
0610808
docs: record #1183 and #1184 successor restacks
seonghobae Sep 19, 2026
32f8354
docs: record #1185 successor restack
seonghobae Sep 19, 2026
c69f134
docs: record #1186 successor restack
seonghobae Sep 19, 2026
25b9ded
docs: advance security detector baseline through #1187
seonghobae Sep 19, 2026
b9308fa
docs: advance security detector baseline through #1188
seonghobae Sep 19, 2026
ff2ea88
docs: advance security gap baseline through PR 1189
seonghobae Sep 19, 2026
eeaa197
docs(gap): bind webhook DNS-pinning repair
seonghobae Sep 19, 2026
a01a2b4
docs(gap): record webhook Ready boundary
seonghobae Sep 19, 2026
0dd2071
docs(security): record webhook successor retirements
seonghobae Sep 19, 2026
ec5073d
docs(security): preserve #1268 review gate
seonghobae Sep 19, 2026
b7b7245
docs(gap): record SARIF help URI repair
seonghobae Sep 19, 2026
e62ac73
docs(gap): record SARIF index successor
seonghobae Sep 19, 2026
7a4213e
docs(gaps): record SARIF stack regression recovery
seonghobae Sep 19, 2026
eb534f5
docs(gaps): admit SARIF metadata repair to review
seonghobae Sep 19, 2026
f5a6643
docs(gaps): record bounded plugin inventory repair
seonghobae Sep 19, 2026
328c6dd
docs(gap): bind PR 1129 exact repair evidence
seonghobae Sep 19, 2026
1593502
docs: refresh issue detector exact-head evidence
seonghobae Sep 20, 2026
2755c6d
docs(gap): bind Python shell-call detector evidence
seonghobae Sep 26, 2026
8ae5b1a
docs(gap): bind exact detector successor evidence
seonghobae Sep 26, 2026
1e11e01
docs(gap): record concurrent guard recovery
seonghobae Sep 26, 2026
fb8a268
docs(gaps): record repeated severity-guard recovery
seonghobae Sep 26, 2026
e4c21b7
docs(gaps): record writer conflict and owner restack
seonghobae Sep 26, 2026
09a182b
docs(gaps): record Python detector regression recovery
seonghobae Sep 26, 2026
fa2d6e1
docs(gaps): bind current Python detector head
seonghobae Sep 26, 2026
6e3d315
docs(gaps): bind source-neutral successor heads
seonghobae Sep 26, 2026
b992017
docs(gaps): bind malformed SARIF URI repair
seonghobae Sep 26, 2026
80f3fca
docs(gaps): bind SARIF successor restack
seonghobae Sep 26, 2026
4472ecf
docs(gaps): record console scalar boundary repair
seonghobae Sep 26, 2026
8b796a2
docs: record console regression restoration
seonghobae Sep 26, 2026
c337069
docs(gap): bind workflow lifecycle review repair
seonghobae Sep 26, 2026
026fcb2
docs(gap): record SARIF successor carryover
seonghobae Sep 26, 2026
c826101
docs(gap): bind workflow prefilter regression
seonghobae Sep 26, 2026
bc0ccc7
docs(gap): bind push prefilter regression
seonghobae Sep 26, 2026
48b6674
docs(gap): bind console successor carryover
seonghobae Sep 26, 2026
8b12626
docs(gap): bind inventory successor carryover
seonghobae Sep 26, 2026
1e213f7
docs: record verified security predecessor carryovers
seonghobae Sep 26, 2026
e1e7668
docs: bind current webhook successor identity
seonghobae Sep 26, 2026
86a38ea
docs: pin latest webhook owner identity
seonghobae Sep 26, 2026
0230d81
docs: record reference extraction successor evidence
seonghobae Sep 26, 2026
86cd94d
docs: record measured normalization successor evidence
seonghobae Sep 26, 2026
537c1f8
docs: record reference-loop successor retirements
seonghobae Sep 26, 2026
c73311a
docs: record PR 1297 verified carryover
seonghobae Sep 26, 2026
e00c7c4
docs: record PR 1317 verified carryover
seonghobae Sep 26, 2026
1a2d575
docs: record PR 1224 verified carryover
seonghobae Sep 26, 2026
faec22e
docs: record PR 1326 stale-child repair
seonghobae Sep 27, 2026
23befc3
docs: record PR 1326 successor retirement
seonghobae Sep 27, 2026
e96d51d
docs: record source-neutral exact-head evidence
seonghobae Sep 27, 2026
888870c
docs: bind Python detector live-head evidence
seonghobae Sep 27, 2026
dd6896b
docs: record performance-contract regression repair
seonghobae Sep 27, 2026
6c8e294
docs: record CodeQL settlement diagnosis gap
seonghobae Sep 27, 2026
0da65c4
docs: bind CodeQL terminal proof owner repair
seonghobae Sep 27, 2026
60baefd
docs: bind exact CodeQL terminal evidence
seonghobae Sep 27, 2026
3280f8b
docs: bind workflow lifecycle proof repairs
seonghobae Sep 27, 2026
cc7b7d3
docs: record SSRF claim boundary and protected merge
seonghobae Sep 30, 2026
406e290
docs: record console and Python 3.14 gap evidence
seonghobae Sep 30, 2026
2ad9891
docs: bind canonical console writer repair
seonghobae Sep 30, 2026
9144713
docs: record console successor retirements
seonghobae Sep 30, 2026
d1b1e85
docs: bind Python 3.14 review and CI repair
seonghobae Sep 30, 2026
a8d8b52
docs: bind canonical SSRF incident carryover
seonghobae Sep 30, 2026
ded5277
docs: record canonical SSRF stale-writer recovery
seonghobae Sep 30, 2026
c21e155
docs: record SSRF owner successor retirement
seonghobae Sep 30, 2026
1996cc7
docs: restack security gap baseline on protected develop
seonghobae Sep 30, 2026
902b68d
docs: bind live SSRF successor review head
seonghobae Sep 30, 2026
bfe7b05
docs(gap): record deterministic SSRF resolver repair
seonghobae Sep 30, 2026
d2b1369
docs(gap): record SSRF concurrent-writer recovery
seonghobae Sep 30, 2026
6dc7826
docs(gap): bind live SSRF successor head
seonghobae Sep 30, 2026
7776afb
docs(gap): record terminal #1192 security evidence
seonghobae Sep 30, 2026
e28176c
docs(gap): record #1356 CodeQL settlement RCA
seonghobae Sep 30, 2026
10b3d70
docs(gap): refresh live SSRF and Python 3.14 gates
seonghobae Sep 30, 2026
9e6f708
docs(gap): record repeated source-neutral SSRF head
seonghobae Sep 30, 2026
66621fc
docs(gap): record fourth source-neutral SSRF head
seonghobae Sep 30, 2026
cd8e1b5
docs(gap): refresh exact-head SSRF checks
seonghobae Sep 30, 2026
f189dbd
docs(gap): record fifth source-neutral SSRF head
seonghobae Sep 30, 2026
5bfa787
docs(gap): record CodeQL settlement detector restack
seonghobae Sep 30, 2026
6ef8f75
docs(gap): record XSS carryover and review admission
seonghobae Sep 30, 2026
33ebbbb
docs(gap): record console review admission
seonghobae Sep 30, 2026
0ecd87e
docs(gaps): record CodeQL evidence handoff repair
seonghobae Sep 30, 2026
ab93eca
docs(gap): record structured argv inventory repair
seonghobae Sep 30, 2026
bced53b
docs(gap): record escaped nested publish repair
seonghobae Sep 30, 2026
753a2da
docs(gap): record console severity fallback
seonghobae Sep 30, 2026
a3dc308
docs(gap): record console review admission
seonghobae Sep 30, 2026
cf922f9
docs(gap): record console writer repair
seonghobae Sep 30, 2026
e1e3bbe
docs(gap): record console exact-head gates
seonghobae Sep 30, 2026
6d63378
docs(gap): restore UTF-8 baseline integrity
seonghobae Oct 1, 2026
94ad36b
docs(gaps): record SARIF rule-index repair evidence
seonghobae Oct 1, 2026
c543352
docs(gaps): record SARIF duplicate carryover
seonghobae Oct 1, 2026
f63e9be
docs(gaps): admit SARIF candidate for review
seonghobae Oct 1, 2026
56ad7c1
docs(gaps): retire zero-delta experiment
seonghobae Oct 1, 2026
9462879
docs(gap): record env argv and command-position corpus
seonghobae Oct 1, 2026
b133b80
docs: record exec wrapper and reject false XSS incident
seonghobae Oct 1, 2026
bb1b302
docs: record POSIX command wrapper regression
seonghobae Oct 1, 2026
34fa46d
docs: record env terminator detector boundary
seonghobae Oct 1, 2026
55a610a
docs: record live PR review boundaries
seonghobae Oct 1, 2026
eb496a9
docs: record detector restack and env bare-dash RCA
seonghobae Oct 1, 2026
af9184c
docs(gap): record GNU env diagnostic wrappers
seonghobae Oct 1, 2026
05b32f5
docs: refresh PR 1189 GNU env corpus evidence
seonghobae Oct 1, 2026
f806954
docs: record DNS TOCTOU detector corpus
seonghobae Oct 1, 2026
581576f
docs: correct DNS detector signal boundary
seonghobae Oct 1, 2026
a177e81
test: require public README license evidence in gap baseline
seonghobae Oct 1, 2026
f86d1bb
docs: bind public README and license writers in gap baseline
seonghobae Oct 1, 2026
3d5c1e4
docs: record README license lane authority
seonghobae Oct 1, 2026
bdf60be
docs: refresh #1327 regression recovery evidence
seonghobae Oct 1, 2026
96bded7
docs: bind #1327 recovery in baseline changelog
seonghobae Oct 1, 2026
9d7e340
docs: refresh #998 and #1129 exact security evidence
seonghobae Oct 1, 2026
f1e7341
docs: record #998/#1129 detector propagation
seonghobae Oct 1, 2026
81e2f91
docs: record DNS fail-open detector corpus
seonghobae Oct 1, 2026
9769760
docs: bind #1327 DNS fail-open evidence
seonghobae Oct 1, 2026
11fcd56
docs: record terminal SSRF detector checks
seonghobae Oct 1, 2026
2fe2fd2
docs: settle SSRF detector gate evidence
seonghobae Oct 1, 2026
0b7e054
docs: record third SSRF corpus recovery
seonghobae Oct 1, 2026
d967783
docs: settle recurrent SSRF recovery evidence
seonghobae Oct 1, 2026
04f82bc
docs: restore baseline paragraph boundaries
seonghobae Oct 1, 2026
7362f4b
docs: restore changelog paragraph boundaries
seonghobae Oct 1, 2026
f9c6372
docs: bind source-neutral SSRF review head
seonghobae Oct 1, 2026
1ab311b
docs: record SSRF review-admission head
seonghobae Oct 1, 2026
4ace042
docs: bind current SSRF exact head
seonghobae Oct 1, 2026
411ba2a
docs: settle source-neutral SSRF head
seonghobae Oct 1, 2026
03db6fe
docs: record PyPI release-source detector corpus
seonghobae Oct 1, 2026
a01d798
docs(gaps): record #1368 contract and #1369 retirement
seonghobae Oct 1, 2026
63fb152
docs: refresh pending-row regression evidence
seonghobae Oct 1, 2026
dad301e
docs: retain EgressWeave local-policy corpus
seonghobae Oct 1, 2026
18aa887
docs(gaps): record Issue 850 detector evidence
seonghobae Oct 1, 2026
a4dee3f
docs(gap): reconcile #850 and #1087 detector evidence
seonghobae Oct 1, 2026
095415d
docs(gap): settle #1088 exact-head checks
seonghobae Oct 1, 2026
357c71b
docs: bind issue 1299 to canonical test-context writer
seonghobae Oct 1, 2026
2dd258f
docs: record non-vacuous test-context regression
seonghobae Oct 1, 2026
6ade301
docs: record duplicate-writer carryover settlement
seonghobae Oct 1, 2026
222cf02
docs: record protected-base integration for public surface
seonghobae Oct 1, 2026
ffe5904
docs: record canonical sidecar secret boundary
seonghobae Oct 1, 2026
a9a1321
docs: settle canonical owner security evidence
seonghobae Oct 1, 2026
f4d7a76
docs: align canonical owner gap references
seonghobae Oct 1, 2026
ec380c9
docs(gaps): record owner review repair
seonghobae Oct 1, 2026
9b15c64
docs(gaps): keep owner lifecycle proposed
seonghobae Oct 1, 2026
4b2e373
docs(gaps): settle owner security checks
seonghobae Oct 1, 2026
262f528
docs(gap): refresh #1324 false-positive RCA
seonghobae Oct 1, 2026
d1f712b
docs(gap): bind #1324 Ready gate evidence
seonghobae Oct 1, 2026
bde3834
docs(gap): record #1324 AST resource-limit RCA
seonghobae Oct 1, 2026
8579f3f
docs(gap): preserve #1324 concurrent recovery evidence
seonghobae Oct 1, 2026
c5ba836
docs(gaps): refresh Python shell detector recovery evidence
seonghobae Oct 2, 2026
aefc736
docs(gaps): record false literal shell regression
seonghobae Oct 2, 2026
3bb49e3
test(gaps): verify retained history blob
seonghobae Oct 2, 2026
285a29d
fix(gaps): restore binary integrity delimiters
seonghobae Oct 2, 2026
1d184c4
docs(gaps): record dashboard category integrity defect
seonghobae Oct 2, 2026
3a31113
docs(gap): record upload proxy regression carryover
seonghobae Oct 3, 2026
15a6187
docs(gap): record concurrent upload-proxy replay
seonghobae Oct 3, 2026
70cb89a
docs(gap): record SARIF help URI integration evidence
seonghobae Oct 3, 2026
1b988f7
docs(gap): register hostname-less URL fail-open corpus
seonghobae Oct 3, 2026
a3d7c47
docs(gap): record console severity lookup repair
seonghobae Oct 3, 2026
17f88c6
docs: record stacked console scalar boundary
seonghobae Oct 3, 2026
2cfb770
docs: record SARIF duplicate-writer settlement
seonghobae Oct 3, 2026
faa6747
docs(gaps): record G-29 accessibility writer settlement
seonghobae Oct 3, 2026
10036b3
docs(gaps): record dashboard map-key corpus settlement
seonghobae Oct 7, 2026
16758c9
docs(gaps): bind second dashboard duplicate retirement
seonghobae Oct 7, 2026
be360e3
docs: record console scalar and identifier boundary
seonghobae Oct 7, 2026
1cfc85d
docs: record external SSRF category boundary
seonghobae Oct 7, 2026
f9b0ad8
docs: correct SSRF implementation blob evidence
seonghobae Oct 7, 2026
31b333e
docs: preserve SSRF adapter regression evidence
seonghobae Oct 7, 2026
5e7b5ae
docs: bind compact SSRF adapter regression
seonghobae Oct 7, 2026
19514d3
docs: reconcile upload proxy duplicate
seonghobae Oct 7, 2026
b807e9c
docs: reconcile upload proxy duplicates
seonghobae Oct 7, 2026
8179a46
docs(gap): record hostname-guard detector boundary
seonghobae Oct 7, 2026
11a75ab
docs(gaps): record imported finding redaction boundary
seonghobae Oct 9, 2026
22d8528
docs(gaps): record runtime package integrity boundary
seonghobae Oct 9, 2026
c04d3e5
docs(gaps): normalize G-34 baseline ending
seonghobae Oct 9, 2026
afc01d9
docs(gap): correct G-34 trust boundary after review
seonghobae Oct 9, 2026
66cb193
fix(docs): restore complete G-34 baseline after transport truncation
seonghobae Oct 9, 2026
cbe3f8b
docs(gap): bind G-34 to step-local detector evidence
seonghobae Oct 9, 2026
fa67856
docs(gap): record structural runtime package analyzer
seonghobae Oct 9, 2026
28e4fb1
docs(gap): record compact step syntax coverage
seonghobae Oct 9, 2026
9113079
docs(gap): record severity writer settlement
seonghobae Oct 9, 2026
fb8ded8
docs(gap): record privileged PR-head detector
seonghobae Oct 9, 2026
27a8e68
docs: refresh exact security detector evidence
seonghobae Oct 9, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
152 changes: 152 additions & 0 deletions docs/product-technical-gap-baseline.md
Comment thread
seonghobae marked this conversation as resolved.
Resolved
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** |
Comment thread
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/
Loading