wn-dev-std 2026.6.27__tar.gz

wn_dev_std-2026.6.27/.github/pull_request_template.md

@@ -0,0 +1,10 @@
+Linked issue:
+
+## Summary
+
+
+## Validation
+
+
+PR title and commit subjects must use Conventional Commit form, for example
+`fix: handle missing board outline`.

wn_dev_std-2026.6.27/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / Python 3.12
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Sync
+        run: uv sync --all-extras
+      - name: Run Rack signoff
+        run: uv run rack run --all
+      - name: Build package
+        run: uv run python -m build
+      - name: Check package
+        run: uv run twine check dist/*
+      - name: Installed wheel smoke test
+        shell: pwsh
+        run: |
+          $wheel = Get-ChildItem dist -Filter "*.whl" | Select-Object -First 1
+          uv tool install --force $wheel.FullName
+          wn-dev-std --version
+          wn-dev-std standard

wn_dev_std-2026.6.27/.github/workflows/pr-hygiene.yml

@@ -0,0 +1,117 @@
+name: PR Hygiene
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+  issues: read
+  pull-requests: read
+
+jobs:
+  hygiene:
+    name: metadata and commit hygiene
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check PR metadata and commits
+        uses: actions/github-script@v9
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const failures = [];
+
+            const bannedPatterns = [
+              { pattern: /\bclaude\b/i, message: "mentions Claude" },
+              { pattern: /\banthropic\b/i, message: "mentions Anthropic" },
+              { pattern: /\bgenerated\s+with\b/i, message: "uses generated-with attribution" },
+              { pattern: /\bco-authored-by:\s*(claude|anthropic)\b/i, message: "uses AI-vendor co-author attribution" },
+            ];
+            const emojiPattern = /[\p{Extended_Pictographic}\uFE0F]/u;
+            const conventionalSubjectPattern = /^(build|chore|ci|deps|docs|feat|fix|perf|refactor|release|revert|style|test)(\([A-Za-z0-9._-]+\))?!?: .+$/;
+
+            function checkConventionalSubject(label, subject) {
+              if (!conventionalSubjectPattern.test(subject || "")) {
+                failures.push(`${label} must use Conventional Commit form, for example \`fix: handle missing board outline\`.`);
+              }
+            }
+
+            function checkText(label, text) {
+              const value = text || "";
+              if (emojiPattern.test(value)) {
+                failures.push(`${label} contains emoji or pictographic symbols.`);
+              }
+              for (const { pattern, message } of bannedPatterns) {
+                if (pattern.test(value)) {
+                  failures.push(`${label} ${message}.`);
+                }
+              }
+            }
+
+            function issueNumbersFrom(text) {
+              const value = text || "";
+              const numbers = new Set();
+              const sameRepoIssueUrl = new RegExp(
+                `https://github\\.com/${owner}/${repo}/issues/(\\d+)`,
+                "gi",
+              );
+              for (const match of value.matchAll(sameRepoIssueUrl)) {
+                numbers.add(Number(match[1]));
+              }
+              for (const match of value.matchAll(/(^|[^\w/])#(\d+)\b/g)) {
+                numbers.add(Number(match[2]));
+              }
+              return [...numbers];
+            }
+
+            checkText("PR title", pr.title);
+            checkText("PR body", pr.body || "");
+            checkConventionalSubject("PR title", pr.title || "");
+
+            const linkedIssueLine = (pr.body || "")
+              .split(/\r?\n/)
+              .find((line) => /^Linked issue:/i.test(line));
+            const issueNumbers = issueNumbersFrom(linkedIssueLine || "");
+            if (!linkedIssueLine || issueNumbers.length === 0) {
+              failures.push("PR body must fill in `Linked issue:` with an existing same-repo issue such as `#123`.");
+            }
+
+            for (const issueNumber of issueNumbers) {
+              try {
+                const response = await github.rest.issues.get({
+                  owner,
+                  repo,
+                  issue_number: issueNumber,
+                });
+                if (response.data.pull_request) {
+                  failures.push(`#${issueNumber} is a pull request, not an issue.`);
+                }
+              } catch (error) {
+                failures.push(`Linked issue #${issueNumber} does not exist or is not readable.`);
+              }
+            }
+
+            const commits = await github.paginate(github.rest.pulls.listCommits, {
+              owner,
+              repo,
+              pull_number: pr.number,
+              per_page: 100,
+            });
+            for (const commit of commits) {
+              const message = commit.commit.message || "";
+              const subject = message.split(/\r?\n/, 1)[0];
+              checkText(`Commit ${commit.sha.slice(0, 7)} message`, message);
+              checkConventionalSubject(`Commit ${commit.sha.slice(0, 7)} subject`, subject);
+              if (subject.length > 72) {
+                failures.push(`Commit ${commit.sha.slice(0, 7)} subject is ${subject.length} characters; keep it at 72 or fewer.`);
+              }
+              if (/^wip\b/i.test(subject)) {
+                failures.push(`Commit ${commit.sha.slice(0, 7)} subject starts with WIP.`);
+              }
+            }
+
+            if (failures.length > 0) {
+              core.setFailed(`PR hygiene failed:\n- ${failures.join("\n- ")}`);
+            }

wn_dev_std-2026.6.27/.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: Release Validation
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Verify tag matches package version
+        shell: bash
+        run: |
+          VERSION="$(uv run python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          test "v${VERSION}" = "${GITHUB_REF_NAME}"
+      - name: Verify release notes mention package version
+        shell: bash
+        run: |
+          VERSION="$(uv run python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          RELEASE_DATE="$(uv run python -c 'import tomllib; v=tomllib.load(open("pyproject.toml","rb"))["project"]["version"]; y,m,d,*_=map(int,v.split(".")); print(f"{y:04d}-{m:02d}-{d:02d}")')"
+          grep -F "## ${VERSION}" CHANGELOG.md
+          test -f "docs/releases/${RELEASE_DATE}.md"
+          grep -F "\`${VERSION}\`" "docs/releases/${RELEASE_DATE}.md"
+      - name: Sync
+        run: uv sync --all-extras
+      - name: Run Rack signoff
+        run: uv run rack run --all
+      - name: Build package
+        run: uv run python -m build
+      - name: Check package
+        run: uv run twine check dist/*
+      - name: Installed wheel smoke test
+        shell: pwsh
+        run: |
+          $wheel = Get-ChildItem dist -Filter "*.whl" | Select-Object -First 1
+          uv tool install --force $wheel.FullName
+          wn-dev-std --version
+          wn-dev-std check .

wn_dev_std-2026.6.27/.gitignore

@@ -0,0 +1,20 @@
+.env
+.env.*
+!.env.example
+
+.venv/
+.pytest_cache/
+.ruff_cache/
+.pyright/
+__pycache__/
+*.py[cod]
+
+build/
+dist/
+*.egg-info/
+
+rack_results/
+tests/rack_results/
+
+.coverage
+htmlcov/

wn_dev_std-2026.6.27/AGENTS.md

@@ -0,0 +1,80 @@
+# Agent Guide
+
+This repository is the reference implementation for Wavenumber development
+standards. Treat it as both production code and an executable example for new
+projects.
+
+## Setup
+
+Use `uv` for all Python workflows:
+
+```bash
+uv sync --all-extras
+```
+
+Do not hand-edit `uv.lock`. Update it with `uv lock` and verify it with
+`uv lock --check`.
+
+## Test And Signoff
+
+Run the full local signoff before release-facing changes:
+
+```bash
+uv run rack run --all
+uv run python -m build
+uv run twine check dist/*
+```
+
+Fast development checks can run individual Rack strata:
+
+```bash
+uv run rack run L0_foundation
+uv run rack run L99_signoff
+```
+
+## Architecture Boundaries
+
+- `src/wn_dev_std/cli/main.py` is the thin CLI entry point.
+- Each public command lives in its own file under
+  `src/wn_dev_std/cli/commands/`.
+- Reusable standard data and checks live outside the CLI package.
+- `docs/design/*.html` and `docs/contracts/*` are source-of-truth public
+  contracts, not generated scratch output.
+- HTML design docs must declare `data-doc-status` as `draft`, `proposal`,
+  `accepted`, or `superseded`; release signoff must review any draft/proposal
+  docs before treating them as contract evidence.
+- C++ profile templates live under `docs/templates/cpp/`; keep them aligned
+  with `docs/design/cpp-standard.html` and the checker policy.
+
+## Release Rules
+
+- `main` should represent the latest released/tagged source.
+- Public changes should merge through PRs with required CI.
+- GitHub Release publication triggers release validation for this model repo.
+- Do not publish this repository to PyPI.
+- Date-based versions are standard, for example `2026.6.4`.
+- Same-day follow-up releases append a fourth segment, for example
+  `2026.6.4.1`.
+- `CHANGELOG.md` and `docs/releases/<YYYY-MM-DD>.md` must mention the current
+  version.
+
+## Generated Files
+
+Generated files must document their source of truth, regeneration command, and
+release inclusion policy. Do not commit local result directories such as
+`rack_results/`, `dist/`, or `.venv/`.
+
+Mixed-mode projects are the exception to the blanket `dist/` rule. They may
+commit grouped runtime artifacts such as `dist/native/<platform>/` and
+`dist/wasm/<target>/` when the artifact policy is documented and covered by
+release signoff. Root-level `dist/` files should remain limited to manifests or
+artifact documentation.
+
+C++ projects use Ninja as the default CMake generator, commit `.clang-format`
+and `.clang-tidy`, and enable `CMAKE_EXPORT_COMPILE_COMMANDS=ON` in presets.
+
+## Exceptions
+
+The default standard is strict. Any exception must have documented rationale,
+scope, and review trigger. Legacy projects may use baselines or ratchets, but
+new code must meet the current standard.

wn_dev_std-2026.6.27/CHANGELOG.md

@@ -0,0 +1,90 @@
+# Changelog
+
+## 2026.6.27
+
+- Add `dev-std log show` for reading one compliant plan work log by globally
+  unique log id.
+- Release the first plan/log hygiene workflow slice with stricter plan-root
+  Markdown metadata checks, structured plan steps, log attachment validation,
+  and read/write helper commands.
+- Document package-scoped plan audits, root discovery, active plan lifecycle,
+  and the intended non-destructive boundary for plan/log commands.
+
+## 2026.6.22
+
+- Add a public PR hygiene standard for linked issues, Conventional Commit PR
+  titles and commit subjects, emoji rejection, and AI-vendor attribution
+  rejection.
+- Add reusable GitHub workflow and pull request template files under
+  `docs/templates/github/`.
+- Add an opt-in `[pr_hygiene]` conformance check that verifies downstream repos
+  have installed the public PR hygiene workflow and template.
+
+## 2026.6.14
+
+- Allow JavaScript profiles to use a foldered canonical standard design doc at
+  `docs/design/standards/javascript.html` while preserving the legacy
+  `docs/design/javascript-standard.html` path.
+- Add `[documentation.standard_docs].javascript` for projects with deliberate
+  custom design-doc layouts.
+- Document the configuration schema and add regression tests for legacy,
+  foldered, configured, and missing JavaScript standard doc paths.
+
+## 2026.6.12
+
+- Add the `zephyr-firmware` profile with west-based build-loop expectations,
+  app-owned source signoff, target-toolchain notes, and embedded C/C++
+  complexity gates.
+- Add reusable C/C++ and Zephyr `signoff.toml` templates.
+- Make canonical native new-code complexity explicit:
+  `max_cyclomatic_complexity = 10`.
+- Add native signoff configuration checks for complexity, file size, function
+  size, clang-format mode, clang-tidy mode, and Lizard enforcement.
+- Document the Rack/signoff quality model, including the public `wn-rack` PyPI
+  package and the expectation that every project has an `L99_signoff` gate.
+
+## 2026.6.10
+
+- Allow local root `.env` files to pass `wn-dev-std check` only when Git reports
+  them as untracked and ignored.
+- Require C/C++ profiles to expose a Lizard-based native complexity gate under
+  `tests/`.
+
+## 2026.6.9
+
+- Add the C/C++ fixed-width integer spelling rule to the `cpp-library`
+  standard.
+- Require C/C++ profiles to configure clang-tidy `google-runtime-int` as an
+  error so owned code uses `std::int32_t`, `std::uint32_t`, `std::int64_t`, and
+  `std::uint64_t` instead of `short`, `long`, or `long long`.
+
+## 2026.6.7
+
+- Codify HTML design-doc status markers with `draft`, `proposal`,
+  `accepted`, and `superseded` states.
+- Add a `wn-dev-std check` design-doc status gate that fails unmarked or
+  invalid HTML design docs and reports draft/proposal docs for release signoff.
+- Add the documentation standard design page and mark the reference design docs
+  as accepted.
+
+## 2026.6.4
+
+- Add the initial working `wn-dev-std` Python package and CLI.
+- Define the first strict Python development baseline with Rack, Ruff, Pyright,
+  Hatchling, committed lockfiles, HTML design docs, JSON contracts, and
+  release metadata signoff.
+- Add the initial `cpp-library` profile with CMake, Ninja, clang-format,
+  clang-tidy, CTest, warnings, sanitizer, ABI, and public/private header rules.
+- Add the initial `python-native-wasm` mixed-mode profile modeled on Geometer
+  for packages with CMake/C++, platform wheels, and WASM artifacts.
+- Add the initial `csharp-app` profile for SDK-style C# application and
+  host-plugin projects.
+- Add `javascript-web-app` and `python-js-app` profiles for no-build browser
+  apps, CSS/JS hygiene ratchets, and FastAPI-style Python-served frontends.
+- Codify checked JavaScript/JSDoc, deterministic `node:test` coverage,
+  CSS custom-property tokens, owned `wn-*` Web Components, JS-to-WASM wrapper
+  tests, and simple command verbs for no-build web projects.
+- Add configurable compatibility-pruning checks for retired environment
+  variables, setup aliases, and other legacy surfaces.
+- Add CI and model release-validation workflows for public Python packages,
+  without publishing `wn-dev-std` itself to PyPI.

wn_dev_std-2026.6.27/CODE_OF_CONDUCT.md

@@ -0,0 +1,8 @@
+# Code Of Conduct
+
+Wavenumber public repositories should be practical, technical, and respectful.
+Contributors are expected to focus on the work, provide clear technical
+context, and avoid personal attacks or harassment.
+
+Report conduct concerns through the project maintainers or the security contact
+listed in `SECURITY.md` when the concern involves private disclosure.

wn_dev_std-2026.6.27/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing
+
+Thank you for contributing to `wn-dev-std`.
+
+## Development Workflow
+
+1. Create a branch from `main`.
+2. Make focused changes.
+3. Run signoff:
+
+   ```bash
+   uv sync --all-extras
+   uv run rack run --all
+   uv run python -m build
+   uv run twine check dist/*
+   ```
+
+4. Open a pull request.
+
+## Standards Changes
+
+Standards changes should update all affected surfaces:
+
+- implementation
+- tests
+- `docs/design/*.html`
+- explicit `data-doc-status` markers for HTML design docs
+- `docs/contracts/*`
+- `README.md` when user-facing behavior changes
+- `CHANGELOG.md`
+- `docs/releases/<YYYY-MM-DD>.md` for release-facing changes
+
+## Exceptions
+
+Strict rules are the default. Exceptions must include rationale, scope, owner or
+review context, and a clear reason the rule cannot currently be met.

wn_dev_std-2026.6.27/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wavenumber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.