| name | fix-license-headers |
| description | Normalize Xerxes Apache-2.0 headers with the native Bun maintenance command and verify TypeScript sources. |
| version | 2.0.0 |
| tags | ["license","headers","hygiene","typescript","bun","xerxes"] |
| required_tools | ["exec_command","ReadFile"] |
When to use
Use this skill when a source, shell, YAML, or Docker file needs the repository
Apache-2.0 copyright header, or when a review reports a malformed header.
How to use
1. Run the native maintenance command in preview mode
The maintenance entry point is TypeScript and runs with Bun:
bun run --cwd xerxes fix-license-headers -- --root . --dry-run
Review the output, then run it without --dry-run only when the listed changes
are in scope:
bun run --cwd xerxes fix-license-headers -- --root .
The command normalizes the repository's comment-style Apache header in the file
kinds it manages and skips generated directories such as node_modules,
dist, build, and .git.
2. Add a TypeScript header deliberately
Every TypeScript source file begins with the same compact native header used by
adjacent modules:
The maintenance scanner does not insert TypeScript headers automatically, so
copy this header into a new .ts or .tsx file at creation time and review it
as part of the source change.
3. Verify the result
For a focused TypeScript tree, list files that lack the canonical copyright
line:
rg -L "^// Copyright 2026 The Xerxes-Agents Author" xerxes/src -g '*.ts' -g '*.tsx'
bun test xerxes/test/maintenanceScripts.test.ts
git diff --check
The rg command should produce no paths for a fully normalized tree. Inspect
the diff before any commit; the maintenance command must not rewrite generated
output or unrelated user changes.
Common pitfalls
- Preserve a shell shebang as the first line; the comment header follows it.
- Preserve YAML document separators: the comment header belongs before
---.
- Do not add an alternate license text or a different copyright year without an
explicit repository-wide decision.
- Do not use a non-Bun script or external formatter to make header changes.
- If the scanner omits a file type, make the minimal manual header change and
add a native test before broadening scanner behavior.
