13 Commits
Author SHA1 Message Date
james.maesandClaude Sonnet 5.5 a18179e90f docs(exceptions): record exact printing uri-js tool license
KofTwentyTwo/ci-policy: ci / fork-guard (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / go-0 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / go-nix-1 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / gradle-2 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / gradle-3 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / java-docker-4 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / java-maven-5 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / manifests-6 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / nix-7 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / node-8 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / python-9 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / rust-10 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / rust-11 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / rust-12 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-0 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-1 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-2 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-3 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-4 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-5 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-6 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / image-build-7 (pull_request) Skipped
KofTwentyTwo/ci-policy: ci / not-enrolled (pull_request) Skipped
KofTwentyTwo/ci-policy: native / fork-deny (pull_request) Skipped
KofTwentyTwo/ci-policy: native / dotnet-0 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / dotnet-1 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / dotnet-2 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / dotnet-3 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / swift-4 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / swift-5 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / swift-6 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / swift-8 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / swift-7 (pull_request) Skipped
KofTwentyTwo/ci-policy: native / native-result (pull_request) Successful in 7s
KofTwentyTwo/ci-policy: Shared source and config CI / verify (pull_request) Successful in 21s
KofTwentyTwo/ci-policy: Shared source and config CI / secrets (pull_request) Successful in 23s
KofTwentyTwo/ci-policy: Shared source and config CI / gate (pull_request) Successful in 12s
KofTwentyTwo/ci-policy: ci / source-config-13 (pull_request) Successful in 38s
KofTwentyTwo/ci-policy: ci / ci-result (pull_request) Successful in 8s
KofTwentyTwo/ci-policy: ci / fork-guard (push) Skipped
KofTwentyTwo/ci-policy: ci / go-0 (push) Skipped
KofTwentyTwo/ci-policy: ci / go-nix-1 (push) Skipped
KofTwentyTwo/ci-policy: ci / gradle-2 (push) Skipped
KofTwentyTwo/ci-policy: ci / gradle-3 (push) Skipped
KofTwentyTwo/ci-policy: ci / java-docker-4 (push) Skipped
KofTwentyTwo/ci-policy: ci / java-maven-5 (push) Skipped
KofTwentyTwo/ci-policy: ci / manifests-6 (push) Skipped
KofTwentyTwo/ci-policy: ci / nix-7 (push) Skipped
KofTwentyTwo/ci-policy: ci / node-8 (push) Skipped
KofTwentyTwo/ci-policy: ci / python-9 (push) Skipped
KofTwentyTwo/ci-policy: ci / rust-10 (push) Skipped
KofTwentyTwo/ci-policy: ci / rust-11 (push) Skipped
KofTwentyTwo/ci-policy: ci / rust-12 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-0 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-1 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-2 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-3 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-4 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-5 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-6 (push) Skipped
KofTwentyTwo/ci-policy: ci / image-build-7 (push) Skipped
KofTwentyTwo/ci-policy: ci / not-enrolled (push) Skipped
KofTwentyTwo/ci-policy: native / fork-deny (push) Skipped
KofTwentyTwo/ci-policy: native / dotnet-0 (push) Skipped
KofTwentyTwo/ci-policy: native / dotnet-1 (push) Skipped
KofTwentyTwo/ci-policy: native / dotnet-2 (push) Skipped
KofTwentyTwo/ci-policy: native / dotnet-3 (push) Skipped
KofTwentyTwo/ci-policy: native / swift-4 (push) Skipped
KofTwentyTwo/ci-policy: native / swift-5 (push) Skipped
KofTwentyTwo/ci-policy: native / swift-6 (push) Skipped
KofTwentyTwo/ci-policy: native / swift-7 (push) Skipped
KofTwentyTwo/ci-policy: native / swift-8 (push) Skipped
KofTwentyTwo/ci-policy: native / native-result (push) Successful in 5s
KofTwentyTwo/ci-policy: Shared source and config CI / verify (push) Successful in 15s
KofTwentyTwo/ci-policy: Shared source and config CI / secrets (push) Successful in 15s
KofTwentyTwo/ci-policy: Shared source and config CI / gate (push) Successful in 10s
KofTwentyTwo/ci-policy: ci / source-config-13 (push) Successful in 32s
KofTwentyTwo/ci-policy: ci / ci-result (push) Successful in 4s
Approve only the unchanged development-only uri-js 4.4.1 package used transitively by ESLint, with version, integrity and license-byte guards. Other license and vulnerability gates remain required.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: James Maes <james@kof22.com>
2026-11-01 16:39:45 -06:00
james.maesandCodex fbfc8d2cf3 docs(exceptions): accept exact printing Windows SDK licenses
Record EX-0014 for the exact maintainer-approved fifteen-package Microsoft
Windows SDK closure in QRun-IO/qqq-print-agent. Preserve versions, artifact
hashes, notices, redistribution conditions and all required security gates.

Signed-off-by: James Maes <james@kof22.com>
Co-Authored-By: Codex (GPT-6) <noreply@openai.com>
2026-11-01 03:50:16 -06:00
james.maesandCodex 7d758b1344 fix(ci): restore CodeQL coverage and record H2 license exception (#54)
Record EX-0013 only for QRun-IO/qbit-printing's unmodified H2 2.4.240 binary, with reviewed SHA-256, existing security controls and expiry 2027-04-30.

Restore normal required CI and preserve Actions plus JavaScript/TypeScript security-extended coverage in the advanced workflow. Default setup was explicitly disabled to resolve its upload conflict. All required checks and both advanced analyses passed on b8e4debe64040a346c5a0815174a68edc94fed98.

Signed-off-by: James Maes <james@kof22.com>
Co-Authored-By: Codex (GPT-6) <noreply@openai.com>
2026-10-31 03:39:29 -05:00
james.maesandClaude Opus 5.5 c95e9e298c docs(exceptions): add EX-0009 to EX-0012 from the repository audit (#37)
Adds four exception-register entries for standing deviations found by
the 2026-10-12 repository audit:

- **EX-0009**: GitFlow with merge commits (K22-REPO-20 linear history,
K22-REPO-22 squash only) for Website-Backend, Website-Frontend, Munitor
and cluster-gitops. Munitor's release and deploy pipeline depends on
develop/main ancestry. cluster-gitops image bumps are now GitHub-signed
GraphQL commits with no ruleset bypass actor.
- **EX-0010**: CircleCI (Munitor orb) instead of the GitHub Actions
reusable-workflow gates (K22-CI-01, 10-24, 30) for Website-Backend,
Website-Frontend and Munitor. The CircleCI checks are required by
rulesets.
- **EX-0011**: 2-space formatting (K22-CODE-TS-01, K22-CODE-SH-02) in
Website-Frontend (Prettier + eslint-config-next) and Munitor (Bash). A
reformat would trigger releases; the repositories' `.editorconfig` cites
this ID.
- **EX-0012**: Praetor commits git-crypt-encrypted local OpenTofu state
and tfvars (K22-CODE-TF-04/05). This is the bootstrap/recovery path for
the infrastructure that would host a remote backend.

No exception is needed for the munitor-ci bot's unsigned pushes, because
that is fixed: Munitor now commits through `createCommitOnBranch`, so
the commits are signed.

AI disclosure: drafted by Claude Code (Claude Opus 5.5) at the
maintainer's direction.

Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: James Maes <james@kof22.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 06:08:56 -05:00
james.maesandClaude Fable 5.1 1cc9d01fa3 docs(exceptions): close EX-0002 for gclo (#33)
gclo now ships Authenticode-signed releases through the shared workflow
(sign: true; Azure Artifact Signing over OIDC; v1.0.2-beta.3,
v1.1.0-beta.1 and v1.1.0 verified with signtool verify /pa /all, 289
files, 0 failures). EX-0002 is recorded as closed for gclo on 2026-10-11
and narrowed to Windows apps that have not turned signing on yet (AppKit
samples, future apps).

Relates to KofTwentyTwo/gclo#57 and standards#5.

Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: James Maes <james@kof22.com>
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-11 08:01:14 -05:00
james.maesandGPT-6 5c21fc7771 docs(exceptions): scope temporary frontend audit exception (#27)
Website-Frontend CI currently fails on GHSA-vfj7-8cjw-p6xm in
development-only braces 3.0.3. No patched package release exists. Record
EX-0008 for this advisory and its propagated findings only, expiring
November 10, 2026, with a review on October 17.

The implementation retains the full audit, rejects all production
high/critical findings and all critical findings, checks exact locked
development paths/version, fails on audit errors or expiry, and requires
reassessment for any newer braces release. Lint, tests, build, secret
scanning, SAST and Trivy remain enabled. No global scanner suppression
is added.

Validation: Markdown lint and offline link/fragment checks pass. The
consumer guard passes against the current website lockfile and
regression cases for acceptance, expiry, unrelated/mixed advisories,
runtime paths, critical findings, new releases and audit errors. This
register change is the approval record required by the exception policy;
consumer release remains gated by its normal CI.

Signed-off-by: James Maes <james@kof22.com>
Co-authored-by: GPT-6 <codex@openai.com>
2026-10-10 15:09:28 -05:00
james.maesandCodex 83134656fc docs(assurance): record OpenSSF passing badge (#25)
The README and assurance records still say enrollment is blocked, even
though OpenSSF project 15366 now identifies KofTwentyTwo/standards and
displays a passing badge. Add the provider's live badge and project URL,
record the completed maintainer self-assessment, and close the
enrollment-only exception EX-0007 while preserving its history.

Set the next assessment review to 2027-01-08 or before the next
MINOR/MAJOR release, whichever occurs first. Retain the unmet suggested
coverage and warning criteria and the release smoke-test follow-up in
#22. Update Scorecard dispositions without claiming an unobserved score
change.

Validation: public assessment identity and passing status verified;
Markdown lint passed for all 69 documents; offline links and anchors
passed with zero errors; full repository conformance passed with 32
PASS, 5 REVIEW, 3 existing WARN, 1 N/A, and no FAIL/UNKNOWN; git diff
--check passed.

AI assistance: Codex (GPT-6) prepared and validated this documentation
change. No standards requirement, workflow, root AGENTS.md, release tag,
or published asset changes.

Signed-off-by: James Maes <james@kof22.com>
Co-authored-by: Codex (GPT-6) <noreply@openai.com>
2026-10-10 14:56:22 -05:00
james.maesandOpenAI GPT-6 Codex f7262f97cb feat(assurance)!: require applicable fuzzing and badge participation
Add mandatory parser fuzzing (K22-TEST-25) and public Product Best Practices participation (K22-REPO-12), with scope records, criterion evidence, and adoption templates. The existing required conformance job runs both PowerShell fuzz seeds on PR/main and longer campaigns on weekly schedules and release tags.

Fixes #18. Preserve Scorecard detection limits: native PowerShell property-based fuzzing is running, but is not a claim of a supported integration or a passing badge. EX-0007 covers standards enrollment only, reviewed 2026-10-17 and expiring 2026-11-10 UTC, while the provider blocks maintainer login.

BREAKING CHANGE: Public Product repositories must enroll and maintain an evidence-backed assessment; complex untrusted-input parsers must have required CI fuzz campaigns and documented scope. Publish these new MUSTs in a MAJOR release. Existing immutable v0.1.2 and reserved failed tags remain unchanged; this merge does not publish another release.

Validation: all nine required PR checks passed at aa40477a11, including both native fuzz seeds. Extended local campaigns passed 20000 cases and 320000 assertions. Checker/package regressions, Markdown/links, workflow lint/security, secret scans, configured analysis of new PowerShell code, and full authenticated conformance passed.

AI review: https://github.com/KofTwentyTwo/standards/pull/19#pullrequestreview-5480144854. No blocking code findings remain. Substantial AI assistance: OpenAI GPT-6 Codex, under explicit maintainer implementation and merge authorization. No independent human review or completed badge assessment is claimed.

Signed-off-by: James Maes <james@kof22.com>
Co-Authored-By: OpenAI GPT-6 Codex <noreply@openai.com>
2026-10-10 12:38:20 -05:00
james.maesandCodex fbd9757d33 feat(releases): publish immutable standards bundles (#8)
## What  Publish committed standards as versioned ZIP/tar.gz bundles with a source manifest, SHA256SUMS, release notes, and GitHub build attestations. Release Please proposes reviewed semantic version PRs; maintainer-created tags invoke all existing CI gates and protected immutable publication. First version: **0.1.0**. Closes #7.  ## Why  Consumers need a complete snapshot whose version identifies permanent bytes and a verifiable source commit across languages and operating systems.  ## How it was tested  Package regression fixtures verify committed-only content, hidden files, both archive formats, deterministic output, checksum coverage, version/changelog validation, and refusal to overwrite output. Checker self-tests, static conformance, actionlint, zizmor (offline), markdownlint, internal links, gitleaks, and separate-process PSScriptAnalyzer checks pass. Live CI will re-run required checks before merge.  ## GitHub setup and scope  Immutable releases are already enabled. Configure `release-automation` for main only and `release` for v* tags with KofTwentyTwo approval and no admin bypass. An App installed only on this repository gets Contents/PR write and Administration read, no ruleset bypass. Its key stays in environment secrets. EX-0006 records only the main-only version-bot key exception; main/tag rulesets and GITHUB_TOKEN PR restrictions remain intact. MINOR/MAJOR checklists receive `release: ready` after preflight; post-publication verification remains pending until shipping.  ## Checklist  - [x] Commits signed and DCO signed off - [x] Format/lint clean; no application build required - [x] Behavioral package tests added; no existing coverage gate - [x] Contributor guide, distribution ADR, threat model, and release instructions included - [x] No secrets or private data in the patch - [x] New SHA-pinned actions justified for version proposals, scoped App tokens, and provenance; no runtime dependencies - [x] Substantial AI assistance: Codex (GPT-6); maintainer review and release approval remain required  

Security review: docs/security/scorecard-dispositions.md records the Scorecard process alerts and 2027-01-10 reassessment. Automated code review is posted on this PR; all current required checks passed.

Signed-off-by: James Maes <james@kof22.com>
Co-Authored-By: Codex (GPT-6) <noreply@openai.com>
2026-10-10 08:57:32 -05:00
james.maesandClaude Fable 5 36bf5e6d1c feat: AI agent operations standard (K22-AGENT) and EX-0005 (#6)
## What

- **`standards/ai-agents.md`** — new K22-AGENT standard for how an agent
session runs: instruction precedence, standards loaded fresh at every
session start (including after context clear/compaction), autonomy
boundaries, minimal-change and verification-honesty discipline,
secrets/untrusted-content rules, provenance trailers per K22-AI-02,
context economy. Complements `policies/ai-assisted-development.md`
(governance) with session operations.
- **`exceptions/register.md`** — EX-0005: agents push directly to the
four Internal-tier personal-automation repos (second-brain, nix, Praetor
develop, Jellyfin) where that is the designed workflow; reasons, risks,
compensating controls, yearly review. K22-AGENT-04 requires agents to
resolve such conflicts through the register instead of silently
violating or refusing.
- **`README.md`** — one row in the "If you want to…" table.

## Notes for review

- The K22-AGENT MUSTs are verified by review/configuration review (like
the K22-AI policy controls), not by `Test-RepoConformance.ps1` — agent
session behavior isn't repo-checkable; no checker change included.
- New MUSTs normally mean a MAJOR release; the repo is pre-1.0 draft, so
this lands before the v1.0.0 baseline.
- K22-AI-11 assessment behind EX-0005's "in part": the agent permission
classifier does confirm destructive/protected operations (it blocks
blind IaC applies); the gap is unconfirmed `git push` in the four listed
repos only.
- Downstream (nix repo, separate change): `~/.ai` becomes a thin private
layer (profile/preferences) over a standards clone that session-start
hooks keep fresh — that work lands after this merges.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Signed-off-by: James Maes <james@kof22.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-10-10 08:32:14 -05:00
james.maesandClaude Fable 5.1 ae174f5495 fix(pr): exempt file-licensed packages, accept the security type, and keep the DCO check robust (#4)
Found while bringing gclo into conformance (KofTwentyTwo/gclo#62).

## What

- `pr.yml`: new `allow-dependencies-licenses` input (package URLs)
passed to `actions/dependency-review-action`, for packages whose nuspec
declares a license *file* (the dependency graph reports `NOASSERTION` /
`LicenseRef-scancode-unknown`). gclo's `LibGit2Sharp`,
`Microsoft.WindowsAppSDK` and `Microsoft.Windows.SDK.BuildTools` fail
`pr / dependency-review` on every change otherwise (see gclo#70).
- `pr.yml`: the title check accepts `security`, which `policies/sdlc.md`
lists as an allowed type; `sdlc.md` gains `style`, which the check
already accepted.
- `pr.yml`: DCO check bug: for a commit whose author email is not linked
to a GitHub account, `.author.login` is null and the TSV field is empty;
bash's tab `IFS` collapses adjacent tabs, the columns shift, and the
check reports "no Signed-off-by" for a commit that has one. The login is
written as `-` now.
- `exceptions/register.md`: EX-0003 (gclo's libgit2
GPL-2.0-with-linking-exception and Windows SDK license terms,
K22-DEP-02) and EX-0004 (gclo's in-repository release workflow until the
shared reusable release workflow exists, K22-CI-30 / K22-REL-04);
EX-0002's "current state" now says gclo ships `SHA256SUMS` and
attestations since v1.0.1-beta.1.
- `configs/shell/PSScriptAnalyzerSettings.psd1`: `CheckOperator` and
`PSAlignAssignmentStatement` contradict each other on every aligned
multi-line hashtable (including this settings file); alignment is the
Kingsrook rule, so `CheckOperator` is off.
- `MAINTAINERS.md`: gclo's adoption status.

## How it was tested

- `actionlint` clean; YAML parses.
- The DCO failure mode and the license failure were both observed on
gclo pull requests today (gclo#68 before the author email was fixed;
gclo#70).
- PSScriptAnalyzer 1.25.0 with the changed settings: gclo's four scripts
report 0 findings; with the original settings the aligned hashtables in
the settings file itself are flagged.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Signed-off-by: James Maes <james@kof22.com>
Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-09 10:55:01 -05:00
james.maesandClaude Opus 5.5 855cf44091 docs: mark standards as draft and expand the README
Compliance crosswalks now report Defined/Enforced/Verified instead of Met,
since no repository has been verified yet; response-time commitments become
binding at v1.0.0; exception compensating controls describe current state.
README rewritten as a setup and usage guide. Fixes doc inaccuracies found while
building the tooling (Dependabot and image digests, tag-creation bypass,
documentation-only READMEs, malicious-package detection).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: James Maes <james@kof22.com>
2026-10-09 07:53:22 -05:00
james.maesandClaude Opus 5.5 e7745eb476 docs: KofTwentyTwo standards v1 policies, standards, and architecture
Original KofTwentyTwo standards written against 2026 public frameworks
(OpenSSF OSPS Baseline v2026.08.28, NIST SSDF v1.1, SLSA v1.2, Scorecard):

- policies: requirement framework (K22-<AREA>-NN, RFC 2119), SDLC,
  security program (WISP equivalent), AI-assisted development, exceptions
- standards: repository, CI/CD, testing, dependencies, releases
- architecture: Windows desktop application reference architecture
- compliance: full OSPS Baseline crosswalk (63/64 met, 1 excepted),
  SSDF, SLSA, and Scorecard mappings
- exception register (EX-0001 single maintainer, EX-0002 Windows signing)
- governance, maintainers and repository inventory, code of conduct,
  licenses (docs CC BY 4.0, code MIT)

Coding standards (Kingsrook style), IDE/CLI configs, reusable workflows,
and the conformance checker follow in separate pull requests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: James Maes <james@kof22.com>
2026-10-09 07:47:10 -05:00