frontmattering 0.4.2__tar.gz

frontmattering-0.4.2/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.{md,yml,yaml,json,toml}]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab

frontmattering-0.4.2/.gitattributes

@@ -0,0 +1,8 @@
+* text=auto eol=lf
+*.bat text eol=crlf
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.zip binary
+*.sqlite binary

frontmattering-0.4.2/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,38 @@
+name: Bug report
+description: Report a reproducible defect
+title: "[Bug]: "
+labels: [bug]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened, and what should have happened?
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      placeholder: 0.3.1
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Include the smallest complete commands and input files possible.
+    validations:
+      required: true
+  - type: textarea
+    id: output
+    attributes:
+      label: Structured output or traceback
+      render: shell
+  - type: checkboxes
+    id: security
+    attributes:
+      label: Security
+      options:
+        - label: This report does not disclose an unpatched vulnerability.
+          required: true

frontmattering-0.4.2/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,24 @@
+name: Feature request
+description: Propose a narrowly scoped capability
+title: "[Feature]: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: friction
+    attributes:
+      label: User friction
+      description: What concrete workflow failure or repeated cost does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: boundary
+    attributes:
+      label: Proposed boundary
+      description: What should the feature establish, and what should it not establish?
+    validations:
+      required: true
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence of need
+      description: Real corpus, commands, examples, or measurements.

frontmattering-0.4.2/.github/pull_request_template.md

@@ -0,0 +1,20 @@
+## Purpose
+
+Describe the concrete defect or friction addressed.
+
+## Claim boundary
+
+State what this change establishes and what it does not establish.
+
+## Verification
+
+- [ ] Canonical verification passes.
+- [ ] Relevant parser/index fixtures pass.
+- [ ] New behavior has regression coverage.
+- [ ] Generated artifacts are current.
+- [ ] Release cleanliness passes.
+- [ ] No authored meaning exists only in a generated projection or database.
+
+## Compatibility
+
+Describe schema, CLI, package, and clean-break effects. Do not add compatibility adapters without an explicit new contract.

frontmattering-0.4.2/.github/workflows/ci.yml

@@ -0,0 +1,88 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  PYTHONDONTWRITEBYTECODE: "1"
+
+jobs:
+  verify:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .
+      - name: Python syntax
+        run: python kernel/tools/check_python_syntax.py
+      - name: Canonical verification and adversarial scenarios
+        run: python kernel/tools/test_verify_kernel.py
+      - name: Markdown parser adoption
+        run: python kernel/tools/check_markdown_parser_adoption.py
+      - name: SQLite frontmatter index
+        run: python kernel/tools/check_frontmatter_sqlite_index.py
+      - name: Projection consistency
+        run: python kernel/tools/check_projection_consistency.py
+      - name: Report quality
+        run: python kernel/tools/check_report_quality.py
+      - name: Exception taxonomy
+        run: python kernel/tools/check_kernel_exception_taxonomy.py
+      - name: Pilot-readiness contract
+        run: python kernel/tools/check_pilot_readiness.py
+      - name: Release cleanliness
+        run: python kernel/tools/check_kernel_cleanliness.py --release
+      - name: Whole-tree distribution receipt
+        run: python kernel/tools/distribution_receipt.py --check
+
+  package:
+    runs-on: ubuntu-latest
+    needs: verify
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Build tooling
+        run: python -m pip install --upgrade pip build
+      - name: Build distributions
+        run: python -m build
+      - name: Inspect and smoke-test wheel
+        run: |
+          python - <<'PY'
+          import pathlib, subprocess, sys, tempfile, zipfile
+          wheels=list(pathlib.Path('dist').glob('*.whl'))
+          if len(wheels)!=1:
+              raise SystemExit(f'expected one wheel, found {wheels}')
+          wheel=wheels[0]
+          with zipfile.ZipFile(wheel) as zf:
+              bad=[n for n in zf.namelist() if '__pycache__/' in n or n.endswith(('.pyc','.pyo')) or n.startswith('tools/')]
+              if bad:
+                  raise SystemExit('\n'.join(bad))
+          with tempfile.TemporaryDirectory() as td:
+              target=pathlib.Path(td)/'site'
+              subprocess.run([sys.executable,'-m','pip','install','--target',str(target),str(wheel)],check=True)
+              env={'PYTHONPATH':str(target),'PYTHONDONTWRITEBYTECODE':'1'}
+              subprocess.run([sys.executable,'-m','frontmattering','--version'],env=env,check=True)
+              subprocess.run([sys.executable,'-m','frontmattering','doctor','--format','json'],env=env,check=True)
+          print('distribution inspection and installed-wheel smoke: PASS')
+          PY
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/*

frontmattering-0.4.2/.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release candidate
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Existing tag to package
+        required: true
+
+permissions:
+  contents: read
+
+env:
+  PYTHONDONTWRITEBYTECODE: "1"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install build dependencies
+        run: python -m pip install --upgrade pip build
+      - name: Verify release tree
+        run: |
+          python -m pip install -e .
+          python kernel/tools/test_verify_kernel.py
+          python kernel/tools/check_markdown_parser_adoption.py
+          python kernel/tools/check_frontmatter_sqlite_index.py
+          python kernel/tools/check_projection_consistency.py
+          python kernel/tools/check_report_quality.py
+          python kernel/tools/check_kernel_exception_taxonomy.py
+          python kernel/tools/check_pilot_readiness.py
+          python kernel/tools/check_kernel_cleanliness.py --release
+          python kernel/tools/distribution_receipt.py --check
+          python kernel/tools/pack_kernel_distro.py --check-only
+      - name: Build Python distributions
+        run: python -m build
+      - name: Installed-wheel doctor
+        run: |
+          python - <<'PY'
+          import pathlib, subprocess, sys, tempfile
+          wheel=next(pathlib.Path('dist').glob('*.whl'))
+          with tempfile.TemporaryDirectory() as td:
+              target=pathlib.Path(td)/'site'
+              subprocess.run([sys.executable,'-m','pip','install','--target',str(target),str(wheel)],check=True)
+              env={'PYTHONPATH':str(target),'PYTHONDONTWRITEBYTECODE':'1'}
+              subprocess.run([sys.executable,'-m','frontmattering','doctor','--format','json'],env=env,check=True)
+          PY
+      - uses: actions/upload-artifact@v4
+        with:
+          name: release-candidate-${{ inputs.tag }}
+          path: dist/*

frontmattering-0.4.2/.gitignore

@@ -0,0 +1,26 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+.venv/
+venv/
+env/
+build/
+dist/
+*.egg-info/
+*.sqlite
+*.sqlite3
+.frontmattering/ir/
+.frontmattering/*.sqlite
+.env
+.env.*
+.DS_Store
+.idea/
+.vscode/settings.json

frontmattering-0.4.2/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.4.2
+
+- Removed the mistaken MIT component license expression after confirming the package contains Frontmattering-owned source and normal runtime dependencies, not vendored third-party source.
+- Replaced third-party notices with a dependency-only notice for PyYAML and markdown-it-py.
+- Removed the v0.4.1 publication hold.
+- Preserved clean public identity: package, import package, and CLI are all `frontmattering`.
+
+## 0.4.1
+
+- Corrected public notices and added 30-day professional/organizational evaluation permission.
+- Added verbatim redistribution permission for unmodified official package artifacts.
+- Marked publication as held pending third-party provenance clarification; superseded by v0.4.2 after code ownership was confirmed.
+
+## 0.4.0
+
+- Clean public rebrand to Frontmattering.
+- Project package, import package, and CLI are now `frontmattering`.
+- Removed old public CLI/import/package aliases.
+- Replaced the previous permissive project license with Frontmattering Individual Use License v1.0 plus commercial-license requirement.
+- Preserved validator/runtime/body-tether/trust-profile behavior from the internal v0.3.6 line.

frontmattering-0.4.2/CODE_OF_CONDUCT.md

@@ -0,0 +1,8 @@
+# Code of conduct
+
+Be respectful, technically rigorous, and specific. Critique artifacts and
+claims rather than people. Harassment, threats, discriminatory conduct,
+doxxing, and deliberate disruption are not acceptable.
+
+Maintainers may edit, hide, or remove contributions that violate these rules
+and may restrict participation when necessary to protect the project.

frontmattering-0.4.2/COMMERCIAL_LICENSE_REQUIRED.md

@@ -0,0 +1,14 @@
+# Commercial license required
+
+Frontmattering is source-available. It is free for individual natural persons using it for personal learning, private research, hobby projects, personal repositories, education, experimentation, or individual evaluation.
+
+Professional, organizational, commercial, client, employer, CI/CD, hosted, managed-service, platform, resale, consulting, public-sector, nonprofit, school, university, or revenue-connected use requires either:
+
+1. a paid commercial license; or
+2. the 30-day time-boxed evaluation permission stated in LICENSE.md.
+
+The evaluation permission exists so prospective professional and organizational users can test Frontmattering in realistic internal workflows, including CI runtime-gate evaluation, before buying a license. It does not authorize production reliance, client delivery, paid audits, managed service operation, or continued use after the evaluation period.
+
+Initial public pricing is not fixed in this package. Commercial terms should be published before broad external outreach so small professional users can self-select instead of starting every evaluation with a sales conversation.
+
+Commercial license inquiries should use the commercial contact published at https://frontmattering.com/ or in the official project repository.

frontmattering-0.4.2/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing
+
+Frontmattering is not accepting external code contributions until the contributor license process is finalized.
+
+Feedback, issue reports, reproducible fixtures, and external pilot receipts are welcome. Do not submit code patches unless a written contributor/license agreement has been accepted first.
+
+This avoids contaminating the licensing base while the project is pre-commercial-pilot.

frontmattering-0.4.2/FRONTMATTERING_V0_4_2_DELIVERY_NOTE.md

@@ -0,0 +1,18 @@
+# Frontmattering v0.4.2 delivery note
+
+This release bundle is intended to replace the v0.4.1 publication-held candidate.
+
+v0.4.2 removes the false third-party/vendored-code attribution path and removes the temporary publication marker, based on the stated project fact that all Frontmattering source code is owned by the project rights holder and that PyYAML / markdown-it-py are separate runtime dependencies rather than vendored source code.
+
+Before real PyPI upload, run:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+python -m twine upload --repository testpypi dist/*
+```
+
+Then test-install from TestPyPI in a clean virtual environment before uploading to production PyPI.
+
+The custom source-available license text is included as a publication candidate, not legal advice.

frontmattering-0.4.2/FRONTMATTERING_v0_4_2_RELEASE_SUMMARY.md

@@ -0,0 +1,25 @@
+# Frontmattering v0.4.2 release summary
+
+- Product: Frontmattering
+- Version: 0.4.2
+- Release type: PyPI-clear license/notice cleanup candidate
+- Public package: `frontmattering`
+- Import package: `frontmattering`
+- CLI: `frontmattering`
+- License expression: `LicenseRef-FRONTMATTERING-Individual-Use-1.2`
+
+## Summary
+
+v0.4.2 removes the false MIT/vendored-third-party posture from the public package. The package now states that Frontmattering does not vendor third-party source code; PyYAML and markdown-it-py remain normal separately installed runtime dependencies.
+
+## Publication status
+
+Technically ready for TestPyPI/PyPI upload after local `twine check` and account-side publication steps. The custom license should still receive qualified legal review before commercial sales.
+
+## Non-goals
+
+- No validator feature changes.
+- No schema compatibility aliases.
+- No old public compatibility surfaces.
+- No license server or activation mechanism.
+- No semantic-summary truth claim.

frontmattering-0.4.2/GOVERNANCE.md

@@ -0,0 +1,20 @@
+# Project governance
+
+The project is currently maintainer-led while the public identity, release
+process, and first external pilots are established.
+
+## Authority
+
+- Markdown source and canonical frontmatter are authored truth.
+- Generated schemas, reports, document IR, receipts, and SQLite indexes are
+  deterministic, rebuildable projections.
+- Validation results establish structural conformance only.
+- Normative-model changes require explicit review and new fixtures.
+- Distribution changes must pass release cleanliness and receipt checks.
+
+## Decisions
+
+Material decisions should be recorded in reviewable repository artifacts.
+Consensus is preferred; the lead maintainer resolves deadlocks during the
+preview phase. Governance will be revised before accepting a broader maintainer
+team or creating certification claims.

frontmattering-0.4.2/LICENSE.md

@@ -0,0 +1,39 @@
+# Frontmattering Individual Use License v1.2
+
+Copyright (c) 2026 Lasse T.
+
+Frontmattering is source-available software. It is not open-source software under the Open Source Definition because professional, organizational, commercial, CI/CD, hosted, managed-service, client, employer, platform, resale, consulting, public-sector, nonprofit, school, university, and revenue-connected use is restricted except as expressly permitted below or by a separate commercial license.
+
+## 1. Individual personal-use grant
+
+An individual natural person may install, inspect, copy for personal backup, and run Frontmattering free of charge for personal learning, private research, hobby projects, personal repositories, education, experimentation, or individual evaluation, provided the use is not on behalf of an employer, client, company, nonprofit, government body, school, university, association, or other organization, and is not part of paid work, professional services, commercial activity, CI/CD, hosted service operation, managed service delivery, product development, compliance activity, or revenue-connected activity.
+
+## 2. Time-boxed evaluation permission
+
+An individual or organization may evaluate Frontmattering for up to 30 days from the first installation or first use by that individual or organization, solely to decide whether to obtain a commercial license.
+
+During the evaluation period, the evaluator may install Frontmattering, run it on non-public or internal Markdown corpora, generate briefs, run validation, and test the validate-only runtime gate in CI for evaluation purposes.
+
+The evaluation permission does not allow production reliance, client delivery, hosted or managed-service operation, resale, sublicensing, use as part of a paid audit or paid consulting deliverable, operation of a commercial product or platform, or continued use after the evaluation period without a commercial license.
+
+## 3. Verbatim redistribution permission
+
+You may copy and redistribute unmodified copies of the official Frontmattering source distribution, wheel distribution, and associated license and notice files, provided that the copies are complete and unmodified; all copyright, license, commercial-license, trademark, attribution, NOTICE, and third-party notice files remain included and unmodified; and you do not represent that you own Frontmattering or that you may grant rights beyond this license.
+
+This permission allows redistribution of unmodified official package artifacts, including ordinary package-index mirrors, package caches, and internal artifact proxies. It does not grant permission to modify, create derivative works, sublicense, host as a service, include in a commercial product, or use Frontmattering for professional or organizational purposes except as separately permitted.
+
+## 4. Commercial-license requirement
+
+Professional, organizational, commercial, client, employer, CI/CD, hosted, managed-service, platform, resale, consulting, public-sector, nonprofit, school, university, or revenue-connected use outside the 30-day evaluation permission requires a separate paid commercial license from the copyright holder.
+
+Commercial license inquiries should use the commercial contact published at https://frontmattering.com/ or in the official project repository.
+
+## 5. Notices and restrictions
+
+You may not remove copyright, license, commercial-license, trademark, attribution, NOTICE, or third-party notice files. You may not represent Frontmattering as open-source software. No trademark rights are granted. No patent license is granted except as required to exercise the permissions expressly granted above.
+
+## 6. Warranty disclaimer and limitation of liability
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, NON-INFRINGEMENT, SECURITY, CORRECTNESS, OR AVAILABILITY. TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE COPYRIGHT HOLDERS ARE NOT LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM OR RELATED TO THE SOFTWARE OR ITS USE.
+
+If you need rights outside this license, obtain a commercial license.

frontmattering-0.4.2/MANIFEST.in

@@ -0,0 +1,32 @@
+include .editorconfig
+include .gitattributes
+include .gitignore
+include CODE_OF_CONDUCT.md
+include LICENSE.md
+include COMMERCIAL_LICENSE_REQUIRED.md
+include NOTICE
+include README.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+include GOVERNANCE.md
+include SECURITY.md
+include SUPPORT.md
+include THIRD_PARTY_NOTICES.md
+include TRADEMARKS.md
+include REPOSITORY_STATUS.md
+include RELEASE_NOTES_v0_*.md
+include FRONTMATTERING_v0_4_2_RELEASE_SUMMARY.md
+include FRONTMATTERING_V0_4_2_DELIVERY_NOTE.md
+recursive-include .github *.md *.yml *.yaml
+recursive-include benchmarks/cold_start_v1 *.md *.yaml *.json *.py
+recursive-include contracts *.md
+recursive-include kernel *.md *.yaml *.json *.py
+recursive-include tests *.py
+prune **/__pycache__
+prune **/.pytest_cache
+prune build
+prune dist
+global-exclude *.py[cod]
+global-exclude *.pyo
+global-exclude *.swp
+global-exclude *.tmp

frontmattering-0.4.2/NOTICE

@@ -0,0 +1,10 @@
+Frontmattering
+
+Copyright (c) 2026 Lasse T.
+All rights reserved except as expressly granted in LICENSE.md or a separate commercial license agreement.
+
+Frontmattering is source-available software. Individual personal use and time-boxed professional/organizational evaluation are permitted under LICENSE.md. Professional, organizational, commercial, CI/CD, hosted, client, employer, managed-service, platform, or revenue-connected use outside the evaluation grant requires a commercial license.
+
+This distribution does not vendor third-party source-code components. Runtime dependencies, if any, are installed as separate Python distributions and remain subject to their own licenses and metadata.
+
+“Frontmattering” is the public product name. Historical internal names may appear only in provenance records, release history, or migration notes and are not public compatibility surfaces.

frontmattering-0.4.2/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: frontmattering
+Version: 0.4.2
+Summary: Governed frontmatter, freshness tethers, and validate-only runtime gates for agent-facing Markdown
+Author: Lasse T.
+License-Expression: LicenseRef-FRONTMATTERING-Individual-Use-1.2
+Project-URL: Homepage, https://frontmattering.com
+Project-URL: Repository, https://github.com/frontmattering/frontmattering
+Project-URL: Issues, https://github.com/frontmattering/frontmattering/issues
+Keywords: markdown,frontmatter,documentation,governance,ai-agents,validation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+License-File: COMMERCIAL_LICENSE_REQUIRED.md
+License-File: NOTICE
+License-File: THIRD_PARTY_NOTICES.md
+License-File: TRADEMARKS.md
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: markdown-it-py>=4.0.0
+Dynamic: license-file
+
+# Frontmattering
+
+Frontmattering makes Markdown safer for agents.
+
+It adds governed frontmatter, task routing, body/frontmatter freshness tethers, and a vendorable validate-only runtime gate so an agent can consume a compact brief without silently relying on stale documentation.
+
+## Install from a local distribution
+
+```bash
+python -m pip install frontmattering-0.4.2-py3-none-any.whl
+frontmattering --version
+frontmattering doctor
+```
+
+## First-hour path
+
+```bash
+frontmattering init docs --set-id MYDOCS --title "My docs"
+frontmattering promote docs/INDEX.md --profile router --in-place
+frontmattering promote docs/*.md --profile guide --in-place
+frontmattering tether update --add docs
+frontmattering validate docs
+frontmattering brief docs
+```
+
+For strict freshness enforcement, set `validation_profile: trust` in `.frontmattering/project.yaml`, then run:
+
+```bash
+frontmattering validate docs
+frontmattering brief docs
+```
+
+## Runtime gate
+
+```bash
+frontmattering runtime pack --out frontmattering-runtime.pyz
+python frontmattering-runtime.pyz validate docs --format json
+```
+
+The runtime artifact is validate-only. It does not expose init, promote, new, index, tether update, or authoring surfaces.
+
+## License
+
+Frontmattering is source-available. It is free for individual natural persons within the scope of `LICENSE.md`. Professional, organizational, commercial, client, employer, CI/CD, hosted, managed-service, platform, consulting, or revenue-connected use requires a paid commercial license.
+
+Frontmattering is not open-source software under the Open Source Definition because professional and organizational use is restricted without a commercial license.
+
+Runtime dependency status is recorded in `THIRD_PARTY_NOTICES.md`; project notices are recorded in `NOTICE`.
+
+## Claim boundary
+
+A `FRESH` brief means the current body bytes and canonical trust-bearing frontmatter fields match their mechanical tether. It does not prove semantic summary correctness, human approval, external adoption, or production suitability.
+
+A `STALE` or `UNTETHERED` summary must not be relied on without reading the body.
+
+
+## Publication status
+
+This v0.4.2 package is a PyPI-clear technical candidate after license/notice cleanup. Custom license text should still receive legal review before paid commercial sales.

frontmattering-0.4.2/README.md

@@ -0,0 +1,59 @@
+# Frontmattering
+
+Frontmattering makes Markdown safer for agents.
+
+It adds governed frontmatter, task routing, body/frontmatter freshness tethers, and a vendorable validate-only runtime gate so an agent can consume a compact brief without silently relying on stale documentation.
+
+## Install from a local distribution
+
+```bash
+python -m pip install frontmattering-0.4.2-py3-none-any.whl
+frontmattering --version
+frontmattering doctor
+```
+
+## First-hour path
+
+```bash
+frontmattering init docs --set-id MYDOCS --title "My docs"
+frontmattering promote docs/INDEX.md --profile router --in-place
+frontmattering promote docs/*.md --profile guide --in-place
+frontmattering tether update --add docs
+frontmattering validate docs
+frontmattering brief docs
+```
+
+For strict freshness enforcement, set `validation_profile: trust` in `.frontmattering/project.yaml`, then run:
+
+```bash
+frontmattering validate docs
+frontmattering brief docs
+```
+
+## Runtime gate
+
+```bash
+frontmattering runtime pack --out frontmattering-runtime.pyz
+python frontmattering-runtime.pyz validate docs --format json
+```
+
+The runtime artifact is validate-only. It does not expose init, promote, new, index, tether update, or authoring surfaces.
+
+## License
+
+Frontmattering is source-available. It is free for individual natural persons within the scope of `LICENSE.md`. Professional, organizational, commercial, client, employer, CI/CD, hosted, managed-service, platform, consulting, or revenue-connected use requires a paid commercial license.
+
+Frontmattering is not open-source software under the Open Source Definition because professional and organizational use is restricted without a commercial license.
+
+Runtime dependency status is recorded in `THIRD_PARTY_NOTICES.md`; project notices are recorded in `NOTICE`.
+
+## Claim boundary
+
+A `FRESH` brief means the current body bytes and canonical trust-bearing frontmatter fields match their mechanical tether. It does not prove semantic summary correctness, human approval, external adoption, or production suitability.
+
+A `STALE` or `UNTETHERED` summary must not be relied on without reading the body.
+
+
+## Publication status
+
+This v0.4.2 package is a PyPI-clear technical candidate after license/notice cleanup. Custom license text should still receive legal review before paid commercial sales.