Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
32 changes: 0 additions & 32 deletions .editorconfig
Original file line number Diff line number Diff line change
@@ -1,15 +1,5 @@
root = true

# Language/framework-agnostic base. Covers universal defaults plus per-type
# sections for the file classes that appear across the platform: Markdown, shell,
# PowerShell, config/serialization (JSON/YAML/TOML), JS/TS, Go, Windows batch, git
# config, and lockfiles. A repository may add a deeper project-local
# `.editorconfig` for narrower source sections; analyzer components do not
# duplicate these universal text defaults.
#
# .gitattributes is the single authority for line endings (it transforms bytes
# on checkout); end_of_line here is an editor hint only.

[*]
indent_style = space
indent_size = 4
Expand All @@ -18,56 +8,34 @@ trim_trailing_whitespace = true
insert_final_newline = true
end_of_line = lf

# Markdown: trailing whitespace is significant (two trailing spaces = a hard
# line break); indentation is variable per CommonMark.
[*.{md,markdown}]
trim_trailing_whitespace = false
indent_size = unset

# Config / serialization / data
[*.{json,jsonc,yml,yaml,toml}]
indent_size = 2

# JavaScript / TypeScript: 2-space, matching the shared Biome formatter policy
# (the single owner of JS/TS formatting). IndentSize is disabled in the checker,
# so this is an editor hint that keeps editors aligned with Biome.
[*.{js,jsx,mjs,cjs,ts,tsx,mts,cts}]
indent_size = 2

# Go: gofmt is the sole formatter and indents with tabs, so the space default
# does not apply; indent enforcement is disabled here and deferred to gofmt
# (mirrors the JS/TS deferral to Biome).
[*.go]
indent_style = unset
indent_size = unset

# Shell: shfmt reads this section, and its switch_case_indent default (false)
# would move every indented `case` branch one level left on any edit.
[*.{sh,bash}]
indent_size = 2
switch_case_indent = true

# Extensionless shebang scripts (e.g. vault-exec): `[[shell]]` is a shfmt
# extension, outside the EditorConfig spec, that matches any file shfmt detects
# as shell (bash included). Editors that do not know it match nothing here.
[[shell]]
indent_size = 2
switch_case_indent = true

# Windows batch: cmd.exe requires CRLF.
[*.{cmd,bat}]
end_of_line = crlf

# Git config: git writes (and idiomatically uses) tab indentation under each
# section, so the space default does not apply. Covers the plain file, gitconfig
# includes, and chezmoi-style source forms (dot_gitconfig, dot_gitconfig.tmpl).
[{.gitconfig,*.gitconfig,dot_gitconfig*}]
indent_style = tab

# Lockfiles: generated; suppress formatting enforcement. packages.lock.json is
# NuGet's lock file (written by restore with platform line endings and no final
# newline, hence end_of_line is unset too; .gitattributes still normalizes the
# committed bytes to LF).
[{package-lock.json,packages.lock.json,*.lock}]
end_of_line = unset
indent_size = unset
Expand Down
1 change: 0 additions & 1 deletion .editorconfig-checker.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
{
"_comment": "Root-canonical editorconfig-checker policy (keys per editorconfig-checker 4.x). Validates files against the repo-root .editorconfig. Line endings are NOT checked here: .gitattributes is the single authority for EOL, so EndOfLine is disabled to avoid double-enforcement. IndentSize and MaxLineLength are disabled because indent width and line length are owned by per-language formatters and are IDE hints, not hard rules. Only deviations from the engine defaults are listed. Verbose, Debug, IgnoreDefaults, NoColor, AllowedContentTypes, PassedFiles, and the Disable entries not named below already hold their engine defaults, so they are omitted deliberately rather than restated; do not add them back. Note AllowedContentTypes is omitted rather than left empty because the engine merges a non-empty value onto its defaults and skips an empty one, so `[]` was already a no-op. Exclude[] entries are universal regular expressions; managed consumers do not edit this file and pass repository-specific excludes with -exclude (which combines additively). Version is intentionally blank so the config adopts cleanly on any 4.x engine; consumers pin the engine in CI.",
"Version": "",
"Exclude": [
"bin/",
Expand Down
38 changes: 0 additions & 38 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -1,65 +1,27 @@
# Language/framework-agnostic base. `* text=auto eol=lf` normalizes text to LF in
# the repository AND checks it out LF on every platform (deterministic, regardless
# of a developer's core.autocrlf). Windows-native types below override to CRLF. A
# later line overrides an earlier one, per attribute. This file is the single
# authority for line endings (editorconfig end_of_line is an editor hint only).

* text=auto eol=lf

###############################################################################
# Richer diffs (line endings inherit the LF default above).
###############################################################################

*.md diff=markdown
*.sh diff=bash
*.bash diff=bash

###############################################################################
# PowerShell: LF is deliberate. Verified to run on both PowerShell 7 and
# Windows PowerShell 5.1. The PowerShell repo pins .ps1 to eol=lf; the popular
# community gitattributes template pins crlf, and they target different eras. Listed
# explicitly so it is not "corrected" to crlf without a requirement to round-trip
# pre-existing CRLF-signed scripts unchanged.
###############################################################################

*.ps1 text eol=lf
*.psm1 text eol=lf
*.psd1 text eol=lf

###############################################################################
# Windows-native: cmd.exe requires CRLF (overrides the LF default above).
###############################################################################

*.cmd text eol=crlf
*.bat text eol=crlf

###############################################################################
# Lockfiles: tracked and diffed as text; GitHub collapses them in pull request
# diffs (regenerate to resolve). `-diff` would make git report them as binary.
###############################################################################

package-lock.json linguist-generated
packages.lock.json linguist-generated
*.lock linguist-generated

###############################################################################
# Append-only lists: one entry per line, order carries no meaning, and each
# list's checker compares sets (keyed lists fail on a key listed twice). A union
# merge keeps both sides' appended lines instead of conflicting. These paths
# exist only in claude-code-plugins; in other repositories they match nothing.
###############################################################################

scripts/affected-tests-no-suite.txt merge=union
scripts/em-dash-purged-paths.txt merge=union
scripts/fragment-plugins.txt merge=union
scripts/outside-node-packages.txt merge=union
scripts/shared-copies.txt merge=union
scripts/skill-leaf-name-registry.txt merge=union

###############################################################################
# Binary: no line-ending conversion, no diff.
###############################################################################

*.png binary
*.jpg binary
*.jpeg binary
Expand Down
16 changes: 0 additions & 16 deletions .gitleaks.toml
Original file line number Diff line number Diff line change
@@ -1,24 +1,8 @@
# gitleaks: https://github.com/gitleaks/gitleaks
# Config reference: https://github.com/gitleaks/gitleaks#configuration
#
# Root-canonical policy: inherit the upstream default ruleset and add only
# rules that are broadly valid, none repo-specific. Managed consumers do not edit this file. Intentional findings
# use a repository-owned .gitleaksignore or inline `gitleaks:allow` comment.

# Floor the engine version: silences the "no minVersion specified" debug
# warning (v8.29.0+) and pins the feature baseline this config relies on
# (`[extend].useDefault`, `[[allowlists]]`).
minVersion = "v8.25.0"

[extend]
useDefault = true

# GitHub App installation tokens in both formats: the classic `ghs_` + 36
# characters and the stateless `ghs_<appid>_<jwt>`. The default
# `github-app-token` rule stops at the `_` after the app id and the default
# `jwt` rule's `\b` cannot match between `_` and `eyJ`. GitHub's recommended
# regex: https://github.blog/changelog/2026-05-15-github-app-installation-tokens-per-request-override-header/
# The leading `\b` keeps words that end in "ghs" (`highs_and_lows_...`) from matching.
[[rules]]
id = "github-app-installation-token"
description = "GitHub App installation token, classic and stateless (ghs_<appid>_<jwt>) formats"
Expand Down
54 changes: 18 additions & 36 deletions .markdownlint-cli2.jsonc
Original file line number Diff line number Diff line change
@@ -1,41 +1,23 @@
{
// GitHub Flavored Markdown (GFM) ruleset for markdownlint-cli2.
// The $schema URL pins to the markdownlint-cli2 devDependency of
// melodic-software/standards (its package.json), where this file is authored
// and synced into consumers from. Authoring-time validation only: it makes
// no claim about which markdownlint-cli2 version a consumer runs. In standards,
// bump it alongside that dependency; markdownlint-schema-pin.test.sh fails the
// standards build if the two drift apart.
// Rules reference: https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
// All rules are enabled by default; only deviations are listed below.
// Globs are passed by the caller (CLI / CI), not declared here.
"$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.24.0/schema/markdownlint-cli2-config-schema.json",
"ignores": [
// Build, dependency, and cache trees: not authored markdown.
"**/node_modules/**",
"**/.venv/**",
"**/bin/**",
"**/obj/**"
],
"$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.24.1/schema/markdownlint-cli2-config-schema.json",
"ignores": ["**/node_modules/**", "**/.venv/**", "**/bin/**", "**/obj/**"],
"config": {
// --- GFM-aligned style ---
"MD003": { "style": "atx" }, // ATX headings (# Heading)
"MD004": { "style": "dash" }, // Dash unordered-list bullets
"MD049": { "style": "asterisk" }, // *emphasis*
"MD050": { "style": "asterisk" }, // **strong**
"MD046": { "style": "fenced" }, // Fenced (not indented) code blocks
"MD048": { "style": "backtick" }, // Backtick (not tilde) code fences
"MD024": { "siblings_only": true }, // Allow duplicate headings under different parents
"MD060": false, // Table column style: disabled; allows any pipe spacing (its default flags tables matching no supported style)
"MD003": { "style": "atx" },
"MD004": { "style": "dash" },
"MD049": { "style": "asterisk" },
"MD050": { "style": "asterisk" },
"MD046": { "style": "fenced" },
"MD048": { "style": "backtick" },
"MD024": { "siblings_only": true },
"MD060": false,

// --- Relaxed for GFM / prose ---
"MD013": false, // No hard line-length limit (tables and code exceed 80)
"MD025": false, // Allow multiple top-level (H1) sections
"MD028": false, // Allow blank lines between adjacent blockquotes
"MD033": false, // Allow inline HTML (<details>, <summary>, <br>, ...)
"MD034": false, // Allow bare URLs (GFM autolinks them)
"MD036": false, // Allow bold text used as a pseudo-heading
"MD040": false, // Fenced code need not declare a language
"MD041": false // First line need not be a top-level heading (frontmatter)
"MD013": false,
"MD025": false,
"MD028": false,
"MD033": false,
"MD034": false,
"MD036": false,
"MD040": false,
"MD041": false
}
}
7 changes: 2 additions & 5 deletions REVIEW.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,7 @@
Managed Code Review gives every review agent this file's contents as the
repository's review instructions. Its citations, the
`standards/review/<file>.md#<heading>` paths in parentheses, are not include
lines, so Managed Code Review does not read the cited files and sees only the
words printed below (see "Depth"). A self-hosted or local review running the
`review` plugin also follows each citation into the `standards` repository
for the full criterion behind the line.
lines; "Depth" says which reviews follow them.

Review in this organization splits into two mutually exclusive scopes, so a
finding belongs to exactly one and is never reported twice. The **code-review lane**
Expand All @@ -30,7 +27,7 @@ surface's three markers:
| Important | 🔴 Important |
| Suggestion | 🟡 Nit |

🟣 Pre-existing is not an SSOT severity: it is this surface's own <!-- ai-slop-ignore: severity-marker vocabulary, load-bearing -->
The 🟣 Pre-existing marker is not an SSOT severity: it is this surface's own
detection-time judgment of whether a finding predates the diff, orthogonal
to the three severities above, and no criterion assigns it.

Expand Down
70 changes: 0 additions & 70 deletions _typos.toml
Original file line number Diff line number Diff line change
@@ -1,106 +1,36 @@
# typos: https://github.com/crate-ci/typos
# Config reference: https://github.com/crate-ci/typos/blob/master/docs/reference.md
# Identifiers vs words: https://github.com/crate-ci/typos/blob/master/docs/design.md
#
# Root-canonical policy synced verbatim to managed consumers (read-only there).
# typos already respects .gitignore and skips binary files, so the lists below
# stay minimal.

[default]
# American English is the house language: non-American variants are corrections,
# not accepted alternates.
locale = "en-us"

extend-ignore-re = [
# Inline ignore directives. typos has no built-in pragma, so this config
# blesses a convention: silence a single line, the following line, or a
# block, without polluting the global allow-lists. Shell / JS comment forms.
"(?Rm)^.*(#|//)\\s*spellchecker:disable-line$",
# \r?\n tolerates a CRLF line ending, matching the CRLF-awareness of the sibling
# directives above (?Rm) and below (?s); a bare \n silently no-ops on a CRLF file.
"(#|//)\\s*spellchecker:ignore-next-line\\r?\\n.*",
"(?s)(#|//)\\s*spellchecker:off.*?\\n\\s*(#|//)\\s*spellchecker:on",
# Markdown / HTML comment form of the block directive: invisible in render.
"(?s)<!--\\s*spellchecker:off\\s*-->.*?<!--\\s*spellchecker:on\\s*-->",
# Braced GUID / UUID literals: typos skips uniform-case UUIDs natively, but
# a mixed-case one trips the word splitter on its hex segments (e.g. `Ba54`
# splits to `Ba` -> "By"). Matches the canonical 8-4-4-4-12 brace form.
"\\{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\\}",
]

# Domain words / proper nouns (case-insensitive, [default.extend-words]) and
# whole-token identifiers (case-sensitive, below): the base carries the
# CONSTELLATION-WIDE UNION. This file is synced verbatim to consumers and typos
# has no config layering, so a repo-specific exception cannot survive as a
# local edit: route a broadly valid exception here via an upstream PR; a repo
# with genuinely different policy owns the complete component locally.
# Each entry only skips its exact token, so the union is inert outside the
# repos that need it; keep every entry annotated.
[default.extend-words]
# ASUS Armoury Crate, and the `Asus.ArmouryCrate` winget package id it is
# installed by. Used in provisioning. typos splits the compound, so the word entry is
# what spares the id; rewriting it to "Armory" would break the install.
armoury = "armoury"
# Reaching for "the full axe": claude-code-plugins docs-hygiene. The en-us
# locale prefers the "ax" variant; both are American, so this is a house
# spelling choice, not a correction.
axe = "axe"
# The Calibre ebook manager: the `calibre.calibre` winget package id, the
# `calibre`/`calibredb` CLIs, and CALIBRE_-prefixed environment variables:
# claude-code-plugins kindle-dedrm, provisioning. Rewriting it to "caliber"
# would break both the package id and the command names.
calibre = "calibre"
# Canva, the design platform, and its `canva@claude-plugins-official` Claude Code
# plugin: claude-code-plugins user-interface routing and its eval cases. The
# en-us dictionary corrects it to "canvas", which would break the plugin id.
canva = "canva"

[default.extend-identifiers]
# Win32 APPBARDATA variable ($abd): dotfiles set-windows-prefs (taskbar auto-hide).
abd = "abd"
# Business Associate Agreements (HIPAA): provisioning.
BAAs = "BAAs"
# Python trust-store package (the certifi CA bundle): claude-code-proxy.
certifi = "certifi"
# Scansion vocalization for a stressed syllable ("DUM da DUM da"): songwriting
# plugin, prosody/meter craft docs. Corrected to "DUMB" by default. Case-sensitive
# and whole-token, so lowercase "dum" and any word containing it are unaffected.
DUM = "DUM"
# schtasks output-format switch (/FO, documented uppercase in
# `schtasks /query /?`): claude-code-proxy. Case-sensitive and whole-token, so
# lowercase "fo" is unaffected.
FO = "FO"
# Features on Demand (Windows optional-feature packaging): provisioning.
FoD = "FoD"
# The MITRE Corporation (MITRE ATT&CK, the CVE program): review conventions.
# The en-us locale corrects the woodworking joint's British spelling to "miter";
# case-sensitive and whole-token, so that correction still applies to prose.
MITRE = "MITRE"
# CC BY-ND license abbreviation (NoDerivatives): claude-code-proxy.
# Case-sensitive and whole-token, so lowercase "nd" is unaffected.
ND = "ND"
# Plug and Play, the standard Windows abbreviation in prose ("PnP device
# enumeration"): claude-code-proxy. The splitter flags the `Pn` segment as
# "On". Whole-token: the PnP-prefixed identifiers below still need their own
# entries.
PnP = "PnP"
# NIC power-management registry value name: provisioning.
PnPCapabilities = "PnPCapabilities"
# Deliberate word-stem inside a documented grep pattern (matches rotate/rotation
# variants): claude-code-proxy. Whole-token, so real "rotate" typos still flag.
rotat = "rotat"
# Win32 WMI device class: claude-code-proxy. The whole identifier is the
# token typos sees (its splitter flags the `Pn` segment as "On"), so the
# entry carries the full class name, not the bare PnPEntity suffix.
Win32_PnPEntity = "Win32_PnPEntity"
# Jasmine/Jest suite-skip global (the x-prefixed describe): claude-code-plugins
# testing detector and any consumer with JS tests. Corrected to "describe" by
# default; whole-token, so prose "describe" is unaffected.
xdescribe = "xdescribe"

[files]
# typos respects .gitignore by default, so only tracked paths that should never
# be spell-checked belong here. Minified bundles are the near-universal case.
extend-exclude = [
"*.min.*",
]
Loading
Loading