Skip to content

ci: drop the stale LICENSE.md requirement from make check - #2

Merged
veraxis-protocol merged 1 commit into
mainfrom
ci-hygiene-license-check-2026-09-08
Sep 8, 2026
Merged

veraxis-protocol merged 1 commit into
mainfrom
ci-hygiene-license-check-2026-09-08

Conversation

@veraxis-protocol

Copy link
Copy Markdown
Owner

Problem

make check — the only gate .github/workflows/ci.yml runs — fails on main for every push and every pull request:

Missing required file: LICENSE.md
make: *** [Makefile:11: check] Error 1

The required-file list names both LICENSE and LICENSE.md. The repository contains only LICENSE.

Which file is canonical

Inspected LICENSE, the Makefile, repository documentation and packaging metadata before changing anything. The evidence is one-sided:

Evidence Finding
LICENSE Full Creative Commons Attribution 4.0 International text, 395 lines, 18,656 bytes
README.md → Licensing Names CC BY 4.0, refers certification marks to TRADEMARKS.md; implies no second licence file
git log --all -- LICENSE.md Empty. LICENSE.md has never existed on any branch
References to LICENSE.md Exactly one, repository-wide: the Makefile's req=(…) array
Packaging/build metadata None present (no pyproject.toml, setup.py, package.json)

LICENSE is the canonical artifact. The requirement is stale; the tree is correct.

Repair

Remove LICENSE.md from the required-file list. One line, one file.

-	req=(README.md LICENSE LICENSE.md GOVERNANCE.md VERSIONING.md VIP_PROCESS.md schemas/veip-evidence-pack.schema.json); \
+	req=(README.md LICENSE GOVERNANCE.md VERSIONING.md VIP_PROCESS.md schemas/veip-evidence-pack.schema.json); \

A second licence file was deliberately not created. Satisfying the check by duplicating licence text would leave two artifacts that can drift apart, on precisely the question where drift is least acceptable. The work order authorizing this repair says the same: do not create a second licence file merely to satisfy a stale check unless repository evidence explicitly requires two distinct files. It does not.

Verification

Step Result
Base b7bae309cd39b6be2f1669aff75c4feb9cf18668 reproduces the failure Missing required file: LICENSE.md, exit 2
This branch — make check OK: required files present, exit 0
This branch — make schema OK: schema JSON parses, exit 0
This branch — make ci exit 0
  • Base SHA: b7bae309cd39b6be2f1669aff75c4feb9cf18668
  • Head SHA: d9ebd2b5646dcd4028a28dcf1e05e31d9be7fd2b

Scope

Diff is limited to the minimum CI/build-hygiene repair: Makefile, 1 insertion, 1 deletion. No specification, schema, licence terms, governance or versioning content is touched.

Relationship to CAT-ALIGN-001

Separate and deliberately not folded into the documentation work. #1 is the CAT-ALIGN-001 category-alignment PR; it inherits this same pre-existing failure and carries a comment saying so. This PR fixes the cause. Merging this one first should turn #1 green with no change to #1 itself.


Generated by Claude Code

`make check` required both LICENSE and LICENSE.md. Only LICENSE exists, so the
check has been failing on main for every push and pull request.

Repository evidence establishes LICENSE as the canonical licence artifact:

- LICENSE contains the full Creative Commons Attribution 4.0 International
  text (395 lines);
- README's Licensing section names CC BY 4.0 and refers certification marks to
  TRADEMARKS.md, implying no second licence file;
- `git log --all -- LICENSE.md` is empty: the file has never existed on any
  branch;
- the Makefile's required list is the only reference to LICENSE.md anywhere in
  the repository;
- there is no packaging or build metadata that would require a second file.

So the requirement is stale, not the tree. Removing the entry is the minimum
repair. A second licence file is deliberately not created: duplicating licence
text to satisfy a stale check would create two artifacts that can drift apart
on a question where drift matters.

No specification, schema, licence terms, governance or versioning content is
changed.

Verification:
- base reproduces the failure: `Missing required file: LICENSE.md`, exit 2
- this branch: `make check` OK exit 0, `make schema` OK exit 0, `make ci` exit 0

Signed-off-by: Arkadiy Miteiko <am@veraxis.io>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pkw68qW3iRaeJsiMPBEPvW
@veraxis-protocol
veraxis-protocol merged commit 003268d into main Sep 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant