Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
123 commits
Select commit Hold shift + click to select a range
139cd01
Rule records: one per applicable FedRAMP rule, none claiming more tha…
sam-aydlette Nov 5, 2026
caed675
Rule records: every MAY rule says why it was or wasn't exercised
sam-aydlette Nov 5, 2026
618dfaf
Rule records: Not Applicable where FedRAMP's scoping says so
sam-aydlette Nov 5, 2026
ff9336e
CR26 vulnerability reports: rating history, decision-led fields, evid…
sam-aydlette Nov 5, 2026
bc86e2d
docs(frr): records state the state after a successful deploy
sam-aydlette Nov 5, 2026
efbf8d8
feat(frr): deploy gate — every rule Implemented or Not Applicable; si…
sam-aydlette Nov 5, 2026
0f5e4fb
KSI catalog: FedRAMP's current KSI-to-control mappings, from the pinn…
sam-aydlette Nov 5, 2026
f189643
feat(sdr): Security Decision Record in FedRAMP's SDR schema
sam-aydlette Nov 5, 2026
1db3a03
feat(frr): SDR records state what the schema-shaped SDR delivers on d…
sam-aydlette Nov 5, 2026
f8ffd97
SCN: explicit evaluation gate, append-only evaluation log, published …
sam-aydlette Nov 5, 2026
e911b5b
SCN log: accept only a full commit SHA from the published log (CodeGu…
sam-aydlette Nov 5, 2026
c3016be
SCN-ADP-NTF: record the post-deploy state; disclose the five late his…
sam-aydlette Nov 5, 2026
c8480a8
Incident evaluation and reporting: register, IIR/OIR/FIR, clocks, IRI…
sam-aydlette Nov 5, 2026
e563966
Incident reports: deploy preflight and proof of the publisher; record…
sam-aydlette Nov 5, 2026
15d59e7
FedRAMP Security Inbox, simulated (AFC-CSO-*)
sam-aydlette Nov 5, 2026
3709afb
Incident reports: simulated delivery, publisher role proved before th…
sam-aydlette Nov 5, 2026
4c492c4
feat(assessor): simulated assessor signs a keyless set on every deplo…
sam-aydlette Nov 5, 2026
ffa67a7
test(decisions): migration assertions cover DEC-001..099; later recor…
sam-aydlette Nov 5, 2026
567109b
test(decisions): migration assertions cover DEC-001..099; later recor…
sam-aydlette Nov 5, 2026
d37b6fa
CR26 vulnerability reports: rating history, decision-led fields, evid…
sam-aydlette Nov 5, 2026
be1c7bd
Decision register: DEC-010 scoped to the Lambdas it covers; detection…
sam-aydlette Nov 5, 2026
bb5a9fb
KEV: a gate before apply, and the catalog's due dates in the VDR and …
sam-aydlette Nov 5, 2026
fb68655
Evaluation: N0, groups, early acceptance, evaluation time, factors an…
sam-aydlette Nov 5, 2026
f4e7f97
Merge remote-tracking branch 'origin/feat/frr-records' into feat/sdr-…
sam-aydlette Nov 5, 2026
e390c0a
feat(mas): Minimum Assessment Scope generated and gated on every depl…
sam-aydlette Nov 5, 2026
6781424
CR26 reports: stamp the offering's FedRAMP ID on the VDT, AVI and MRH
sam-aydlette Nov 5, 2026
8fa18ee
feat(trust): agency access register, denial clock and exercise; shari…
sam-aydlette Nov 5, 2026
c8ceaa6
Check vectors in force through DEC-180; exploitation (DEC-181) and di…
sam-aydlette Nov 5, 2026
6de6236
feat(trust): independent availability monitor, private access logging…
sam-aydlette Nov 5, 2026
5f7723e
feat(scg,cmu): secure configuration guide as data, live comparison, p…
sam-aydlette Nov 5, 2026
ff5903a
feat(trust): policy index covers procedures, concrete practices, publ…
sam-aydlette Nov 5, 2026
4078bb6
Merge remote-tracking branch 'origin/feat/sdr-schema' into feat/trust…
sam-aydlette Nov 5, 2026
bc54354
Merge branch 'feat/g5-mas' into feat/trust-scope-assessor
sam-aydlette Nov 5, 2026
b93adb9
Merge branch 'feat/g5-edge' into feat/trust-scope-assessor
sam-aydlette Nov 5, 2026
3601772
Merge branch 'feat/g5-scg' into feat/trust-scope-assessor
sam-aydlette Nov 5, 2026
8d03b63
Failures are vulnerabilities; agency-effect rationale per finding; a …
sam-aydlette Nov 5, 2026
ae9be0b
feat(vdr): ingest CodeQL alerts and the authenticated ZAP API scan
sam-aydlette Nov 5, 2026
6c56bfb
ci: CodeQL SAST and daily, post-deploy, authenticated ZAP DAST
sam-aydlette Nov 5, 2026
f56f938
feat(detection): gate CodeQL and the API scan; 3-day DAST window
sam-aydlette Nov 5, 2026
9c03ca3
Non-machine V&V every 3 months: register, DEC-190, deploy check (VDR-…
sam-aydlette Nov 5, 2026
66b4edd
Monthly VDR activity report, all activity types (VER-TFR-MHR, VER-RPT…
sam-aydlette Nov 5, 2026
5c0215a
Detection follow-ups: the new runbook in the non-machine register; ZA…
sam-aydlette Nov 5, 2026
036a720
Trust manifest, human views, trust page data and access section
sam-aydlette Nov 5, 2026
d34d77e
Detection coverage per component, and unresolved components recorded …
sam-aydlette Nov 5, 2026
4f21d9e
Rule records: detection and evaluation records Implemented with their…
sam-aydlette Nov 5, 2026
9250b30
KEV gate: scanner text is cleaned before it reaches the Actions log (…
sam-aydlette Nov 5, 2026
dd7e0b7
Merge the pre-rebase feat/vdr-followups (superseded: its W2 commit is…
sam-aydlette Nov 5, 2026
bb81522
Bring the W8/W10 trust-center, scope and assessor records to Implemented
sam-aydlette Nov 5, 2026
1f0a029
Lint: zip strict in the manifest test
sam-aydlette Nov 5, 2026
f219a96
Simulated assessor: fetch only https from the site; sign in a job tha…
sam-aydlette Nov 5, 2026
002a4db
Certification package and quarterly cycle in FedRAMP's schemas (group…
sam-aydlette Nov 5, 2026
29ebab4
fix(published): no IAM user name in published decision text; ignore a…
sam-aydlette Nov 5, 2026
04c58ef
chore: stop tracking a worktree's .venv symlink
sam-aydlette Nov 5, 2026
fd67f27
Merge remote-tracking branch 'origin/feat/frr-records' into feat/sdr-…
sam-aydlette Nov 5, 2026
dcf866e
Merge origin/feat/sdr-schema (group 2's schema-shaped CPO) into feat/…
sam-aydlette Nov 5, 2026
b89a577
policy: privilege, trust, identity, key, logging, API and package rul…
sam-aydlette Nov 5, 2026
2e83120
policy: certificate horizon from a computed days_to_expiry; alarm rul…
sam-aydlette Nov 5, 2026
9a906b8
inventory: credit plan results to every component type a rule evaluates
sam-aydlette Nov 5, 2026
fb638ca
runtime: bounded, signed run history (VER-RPT-PER)
sam-aydlette Nov 5, 2026
36b4b81
runtime: re-validate every machine component live against the gate po…
sam-aydlette Nov 5, 2026
3e6aa61
reconcile: invariant (m) runtime V&V coverage within 72h (VDR-TFR-MVX)
sam-aydlette Nov 5, 2026
4a2edc8
Period reports count every retained runtime run (VER-RPT-PER)
sam-aydlette Nov 5, 2026
2ecb0c1
Rule records: runtime V&V, drift and sample detection, persistent rep…
sam-aydlette Nov 5, 2026
7e87ff0
CPO: trust center, secure configuration guidance, third parties and t…
sam-aydlette Nov 5, 2026
4572d0b
Merge remote-tracking branch 'origin/feat/trust-scope-assessor' into …
sam-aydlette Nov 5, 2026
fa31507
Merge origin/feat/notifications into feat/integration
sam-aydlette Nov 5, 2026
b600325
Merge origin/feat/vdr-followups into feat/integration
sam-aydlette Nov 5, 2026
a02cf13
Stamp the FedRAMP ID on every published report (CDS-CSO-FID)
sam-aydlette Nov 5, 2026
846eaf7
Count dependency scanning and the training attestation as SDR methods…
sam-aydlette Nov 5, 2026
efc2581
Inventory the bootstrap group policies and policy attachments
sam-aydlette Nov 5, 2026
2a9daea
Records: CDS-CSO-FID and FRC-CSX-VVK Implemented; FRC-CSO-JSN covers …
sam-aydlette Nov 5, 2026
ad89848
SDR step: pass the VDR signer identity through the environment (CodeG…
sam-aydlette Nov 5, 2026
87fd2f6
build-ocr.py: declare --incidents once; every workflow script builds …
sam-aydlette Nov 5, 2026
9838a70
Withhold IAM user names from published decision scopes; the publicati…
sam-aydlette Nov 5, 2026
f69f469
VVK holds at deploy: staged runtime re-validation, two methods requir…
sam-aydlette Nov 5, 2026
2221e31
deploy: replace the runtime-signal fetch with the staged emitter run;…
sam-aydlette Nov 5, 2026
25c2ab6
No GitHub run ID in published output; the publication gate checks for…
sam-aydlette Nov 5, 2026
982eba4
Publish the operator's LinkedIn profile as the security contact
sam-aydlette Nov 6, 2026
404ea4c
Record the rule-completeness change as adaptive (SCN-2026-007)
sam-aydlette Nov 6, 2026
00af685
Merge pull request #509 from sam-aydlette/feat/trust-scope-assessor
sam-aydlette Nov 6, 2026
6f4cd3d
Merge pull request #503 from sam-aydlette/feat/sdr-schema
sam-aydlette Nov 6, 2026
59eb6d8
Merge pull request #510 from sam-aydlette/feat/integration
sam-aydlette Nov 6, 2026
ef706ac
Clear the four high CodeQL alerts on the rule-completeness change
sam-aydlette Nov 6, 2026
5bdb1a4
Merge pull request #511 from sam-aydlette/fix/codeql-alerts
sam-aydlette Nov 6, 2026
84d3aed
Compare the unplaced CSP host by equality in the MAS test
sam-aydlette Nov 6, 2026
fad0355
Restore the named-host set in the MAS test
sam-aydlette Nov 6, 2026
cc9e183
Merge pull request #512 from sam-aydlette/fix/codeql-mas
sam-aydlette Nov 6, 2026
9a1d435
Fix deploy and nightly blockers: signers, views, boundary, IAM reader…
sam-aydlette Nov 6, 2026
85d2568
Automate the people-run processes; zero real engagement (DEC-194)
sam-aydlette Nov 6, 2026
3342663
Make record, decision and doc text say what the repository does
sam-aydlette Nov 6, 2026
3b0de74
Drop the CMMC, GovRAMP and TX-RAMP figures and the files only they used
sam-aydlette Nov 6, 2026
600ec43
Merge pull request #514 from sam-aydlette/fix/automate-and-truth
sam-aydlette Nov 6, 2026
be75273
Merge pull request #515 from sam-aydlette/fix/text-truth-rebased
sam-aydlette Nov 6, 2026
66bf760
Merge pull request #516 from sam-aydlette/chore/drop-frameworks
sam-aydlette Nov 6, 2026
dd9077e
Merge feat/frr-records (#514, #516) into the deploy-blockers branch
sam-aydlette Nov 6, 2026
7921ef4
Merge pull request #513 from sam-aydlette/fix/deploy-blockers
sam-aydlette Nov 6, 2026
e4531e6
Merge pull request #517 from sam-aydlette/fix/automate-and-truth
sam-aydlette Nov 6, 2026
8a28f34
DEC-101: cite the operator's direction, not DEC-194, for no recurring…
sam-aydlette Nov 6, 2026
3d56c91
Bind assessments to what they covered; enforce histories, FRC and NOC
sam-aydlette Nov 6, 2026
4249f5d
Carry the not-certified status on the SDR and trust center from one s…
sam-aydlette Nov 6, 2026
64792e6
SCN-2026-007: record the compliance-engine changes of #518
sam-aydlette Nov 6, 2026
bc21903
Merge pull request #518 from sam-aydlette/fix/assessment-binding
sam-aydlette Nov 6, 2026
124a06d
DEC-181: exploitation assessment rests on automated sources only
sam-aydlette Nov 6, 2026
69e12a7
Fix two first-deploy blockers: assessor cosign, incident-role trust i…
sam-aydlette Nov 6, 2026
f0e4aef
Final-review fixes: fail-closed package history, notify on tests, sta…
sam-aydlette Nov 6, 2026
32f101e
Human-readable view of every JSON each workflow publishes
sam-aydlette Nov 6, 2026
a997cc5
AFC-CSO-NOC: notice clock runs from the deploy that publishes the change
sam-aydlette Nov 6, 2026
71a10ac
Publication redaction gate: no email address outside the site's domain
sam-aydlette Nov 6, 2026
1d99b75
DEC-194 statement on every simulated output
sam-aydlette Nov 6, 2026
79fd1cf
Corroboration: expected signer from the publisher table, not the cadence
sam-aydlette Nov 6, 2026
cd0f329
SCN-2026-007: record this branch's compliance-engine changes
sam-aydlette Nov 6, 2026
5aa9942
Merge pull request #519 from sam-aydlette/fix/dec181-automated
sam-aydlette Nov 6, 2026
a2593f8
Automate the audit-log review (KSI-MLA-RVL, KSI-CMT-RVP)
sam-aydlette Nov 6, 2026
f172385
Hold the security review and recovery exercise on their dates
sam-aydlette Nov 6, 2026
dcc0ecb
Publish, sign and gate the scheduled-review artifacts
sam-aydlette Nov 6, 2026
06eab94
Count the scheduled reviews as SDR methods; test every mechanism
sam-aydlette Nov 6, 2026
064b169
DEC-195: three recurring human acts remain; reword the rest
sam-aydlette Nov 6, 2026
caceda7
Describe each recurring review by its mechanism
sam-aydlette Nov 6, 2026
ecf6735
Relapse gate: no text may commit a person to recurring manual work
sam-aydlette Nov 6, 2026
bbf334f
SCN-2026-007: record the scheduled reviews
sam-aydlette Nov 6, 2026
3bd29a9
Merge pull request #520 from sam-aydlette/feat/automated-reviews
sam-aydlette Nov 6, 2026
98b0fbb
CLAUDE.md: proof-of-concept latitude (statuses, stand-ins, who approves)
sam-aydlette Nov 6, 2026
dc17f6d
Merge pull request #521 from sam-aydlette/docs/poc-latitude
sam-aydlette Nov 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
88 changes: 88 additions & 0 deletions .github/workflows/availability-probe.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
# =============================================================================
# Availability probe (CDS-CSO-AVR, CDS-TRC-USH)
# =============================================================================
# An availability monitor on infrastructure independent of the offering: it
# runs on GitHub Actions, not AWS, probes the core services over HTTPS every 15
# minutes (scripts/availability-probe.py), keeps 35 days of history, derives
# availability incidents, and publishes JSON + Markdown to the repository's
# `availability-status` branch. GitHub serves that branch, so the status stays
# readable when the offering's CloudFront or S3 is down:
# https://raw.githubusercontent.com/sam-aydlette/samaydlette.com/availability-status/availability-status.json
# https://github.com/sam-aydlette/samaydlette.com/blob/availability-status/availability-status.md
#
# The branch holds one commit, replaced on every run (history lives in the
# JSON), so the repository does not grow by a commit every 15 minutes. The
# workflow's token can write contents (no narrower scope exists); the job only
# ever pushes refs/heads/availability-status, and main is protected by its own
# branch rules. The deploy reads this feed and fails when it is missing or more
# than 2 hours old, so the published package never cites a monitor that has
# stopped (scripts/availability-probe.py --check-fresh).
#
# Caveats stated in the feed: history begins at the first run; GitHub may delay
# a scheduled run under load, and disables schedules on a repository with no
# activity for 60 days (the deploy's freshness check then fails).
# =============================================================================
name: Availability probe

on:
schedule:
- cron: '*/15 * * * *'
push:
branches: [main]
workflow_dispatch:

permissions: {}

concurrency:
group: availability-probe
cancel-in-progress: false

jobs:
probe:
name: Probe the core services from outside AWS
runs-on: ubuntu-latest
timeout-minutes: 10
permissions:
contents: write # push the status branch; nothing else
steps:
- name: Checkout the probe
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: main
persist-credentials: false

- name: Read the previous status feed
run: |
set -euo pipefail
# Public repository: an anonymous fetch. No branch yet means a first run.
if git fetch --depth 1 --quiet origin availability-status 2>/dev/null; then
git show FETCH_HEAD:availability-status.json > previous-status.json || echo '{}' > previous-status.json
else
echo '{}' > previous-status.json
fi

- name: Probe the core services
run: python3 scripts/availability-probe.py --previous previous-status.json --out-dir status-out

- name: Publish the status feed to the availability-status branch
env:
GH_TOKEN: ${{ github.token }}
REPO: ${{ github.repository }}
run: |
set -euo pipefail
cd status-out
git init --quiet
git checkout --quiet --orphan availability-status
git add availability-status.json availability-status.md
git -c user.name="availability-probe" -c user.email="availability-probe@users.noreply.github.com" \
commit --quiet -m "Availability status $(jq -r .generated_at availability-status.json)"
auth=$(printf 'x-access-token:%s' "$GH_TOKEN" | base64 -w0)
echo "::add-mask::$auth"
git -c http.extraheader="AUTHORIZATION: basic $auth" \
push --quiet --force "https://github.com/${REPO}.git" HEAD:refs/heads/availability-status

# After publishing: an ongoing incident fails the run, and GitHub notifies
# the operator of the failed scheduled run (email). The status is already
# published either way.
- name: Alert on an ongoing availability incident
run: python3 scripts/availability-probe.py --fail-on-incident status-out/availability-status.json
132 changes: 132 additions & 0 deletions .github/workflows/codeql.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
# =============================================================================
# CodeQL (SAST of first-party code; VDR-CSO-DET, VDR-CSO-DAC, VDR-TFR-PSD)
# =============================================================================
# Static analysis of the code this system ships and runs, uploaded to GitHub
# code scanning (free on a public repository):
#
# repo this repository: Python (the generators and gates in scripts/,
# tools/), JavaScript (the runtime Lambda, the watchdog, the
# CloudFront functions, the site and trust-center JS) and the
# GitHub Actions workflows themselves.
# silk-reeling the Silk Reeling app as deployed: its Python API Lambda and
# its SPA. Its source lives in a private repository with no code
# scanning of its own, so it is analysed here, from the same ref
# the deploy builds (vars.SILK_REELING_REF, default main).
#
# When: on every push and pull request to main (changed code is analysed before
# and as it merges), after every successful deploy to main (the Silk Reeling
# code the deploy just shipped), and daily (new queries over unchanged code).
#
# The VDR builds read the open CodeQL alerts on main through the code-scanning
# API (scripts/fetch-detection-feeds.sh); the detection gate fails the run when
# any category below has no error-free analysis on main in the last 72 hours
# (detection.codeql, infrastructure/schemas/detection-feeds.json, which lists the
# categories this file produces; tests/test_detect_wiring.py keeps them equal).
# =============================================================================
name: CodeQL

on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
schedule:
- cron: '41 5 * * *' # 05:41 UTC daily
workflow_dispatch:
# After every deploy to main; the job conditions drop deploy runs that did not
# succeed or came from a pull request.
workflow_run:
workflows: [Deploy Website with OPA Compliance]
types: [completed]
branches: [main]

permissions:
contents: read

concurrency:
group: codeql-${{ github.event_name == 'pull_request' && github.ref || 'main' }}
cancel-in-progress: false

jobs:
repo:
name: CodeQL (${{ matrix.language }})
if: >-
github.event_name != 'workflow_run' ||
(github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.event != 'pull_request')
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: read
security-events: write # upload the results to code scanning
strategy:
fail-fast: false
matrix:
language: [python, javascript-typescript, actions]
steps:
- name: Checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

- name: Initialize CodeQL
uses: github/codeql-action/init@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
with:
languages: ${{ matrix.language }}
build-mode: none

- name: Analyze
uses: github/codeql-action/analyze@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
with:
category: /language:${{ matrix.language }}

silk-reeling:
name: CodeQL Silk Reeling (${{ matrix.language }})
# Needs the private-source token, which pull requests do not get; the
# app's code does not change in this repository's pull requests anyway.
if: >-
github.event_name != 'pull_request' &&
(github.event_name != 'workflow_run' ||
(github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.event != 'pull_request'))
runs-on: ubuntu-latest
timeout-minutes: 30
permissions:
contents: read
security-events: write # upload the results to code scanning
strategy:
fail-fast: false
matrix:
language: [python, javascript-typescript]
steps:
- name: Checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

# The app's source only, without its git metadata (which would carry the
# token in the remote URL).
- name: Fetch the Silk Reeling source (the ref the deploy builds)
env:
SILK_REELING_REF: ${{ vars.SILK_REELING_REF || 'main' }}
SILK_REELING_REPO_TOKEN: ${{ secrets.SILK_REELING_REPO_TOKEN }}
run: |
set -euo pipefail
[ -n "${SILK_REELING_REPO_TOKEN}" ] || { echo "::error::SILK_REELING_REPO_TOKEN is not set"; exit 1; }
git clone --quiet --depth 1 --branch "$SILK_REELING_REF" \
"https://x-access-token:${SILK_REELING_REPO_TOKEN}@github.com/sam-aydlette/silk-reeling-mirror.git" silk-reeling
rm -rf silk-reeling/.git
ls silk-reeling/backend silk-reeling/frontend > /dev/null

- name: Initialize CodeQL
uses: github/codeql-action/init@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
with:
languages: ${{ matrix.language }}
build-mode: none
source-root: silk-reeling

# The results (rule, file path, line, message) go to this repository's code
# scanning; the database, which holds the private source, is not uploaded.
- name: Analyze
uses: github/codeql-action/analyze@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
with:
category: /silk-reeling/language:${{ matrix.language }}
upload-database: false
Loading
Loading