frontmattering 0.4.2__tar.gz → 0.4.3__tar.gz

{frontmattering-0.4.2 → frontmattering-0.4.3}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.4.3
+
+- README/PyPI long description: install instruction is now `pip install frontmattering` instead of a local wheel path.
+- Public license summary now states the 30-day evaluation permission (LICENSE.md §2), not only the paid-commercial requirement.
+- Fixed `frontmattering doctor`: the AI_INDEX currency check embedded Python- and terminal-width-sensitive argparse output (usage-line wrapping and positional `.required`), producing a spurious FAIL on any environment other than the one the index was frozen on. Index generation is now deterministic — whitespace-normalized command signatures and `required` derived from `nargs` — so `doctor` passes across supported Python versions.
+- Removed the residual `-pypi-clear` publication marker from internal version strings.
+- No validator, frontmatter-schema, runtime-parity, or canonical-model (`v0.1.5`) changes.
+- Both wheel and sdist are published for this version.
+
 ## 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.

{frontmattering-0.4.2/kernel/frontmattering.egg-info → frontmattering-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontmattering
-Version: 0.4.2
+Version: 0.4.3
 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
@@ -36,10 +36,10 @@ 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
+## Install
 
 ```bash
-python -m pip install frontmattering-0.4.2-py3-none-any.whl
+python -m pip install frontmattering
 frontmattering --version
 frontmattering doctor
 ```
@@ -73,7 +73,7 @@ The runtime artifact is validate-only. It does not expose init, promote, new, in
 
 ## 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 source-available. It is free for individual personal use within the scope of `LICENSE.md`. Professional, organizational, employer, client, CI/CD, hosted, managed-service, platform, consulting, or revenue-connected use is permitted for a 30-day evaluation period under `LICENSE.md`; continued use after the evaluation 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.
 
@@ -88,4 +88,4 @@ 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.
+This v0.4.3 package is a public-surface cleanup of the v0.4.2 PyPI-clear release (install/readme/license-summary corrections; no validator, schema, or canonical-model changes). Custom license text should still receive legal review before paid commercial sales.

{frontmattering-0.4.2 → frontmattering-0.4.3}/README.md

@@ -4,10 +4,10 @@ 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
+## Install
 
 ```bash
-python -m pip install frontmattering-0.4.2-py3-none-any.whl
+python -m pip install frontmattering
 frontmattering --version
 frontmattering doctor
 ```
@@ -41,7 +41,7 @@ The runtime artifact is validate-only. It does not expose init, promote, new, in
 
 ## 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 source-available. It is free for individual personal use within the scope of `LICENSE.md`. Professional, organizational, employer, client, CI/CD, hosted, managed-service, platform, consulting, or revenue-connected use is permitted for a 30-day evaluation period under `LICENSE.md`; continued use after the evaluation 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.
 
@@ -56,4 +56,4 @@ 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.
+This v0.4.3 package is a public-surface cleanup of the v0.4.2 PyPI-clear release (install/readme/license-summary corrections; no validator, schema, or canonical-model changes). Custom license text should still receive legal review before paid commercial sales.

{frontmattering-0.4.2 → frontmattering-0.4.3}/kernel/AI_INDEX.json

@@ -62,7 +62,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering brief [-h] [--task TASK]\n                            [--section {summary,blocks,traps,limits,do-not,trust,reading-order,defects,claim-boundary}]\n                            [--include-dev] [--format {markdown,json}]\n                            [paths ...]",
+      "signature": "frontmattering brief [-h] [--task TASK] [--section {summary,blocks,traps,limits,do-not,trust,reading-order,defects,claim-boundary}] [--include-dev] [--format {markdown,json}] [paths ...]",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -188,7 +188,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering index [-h]\n                            {build,rebuild,update,check,status,delete} ...",
+      "signature": "frontmattering index [-h] {build,rebuild,update,check,status,delete} ...",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -232,7 +232,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering init [-h] --set-id SET_ID --title TITLE [--force]\n                           directory",
+      "signature": "frontmattering init [-h] --set-id SET_ID --title TITLE [--force] directory",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -360,7 +360,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering new [-h]\n                          [--profile {contract,evidence,guide,registry,release,router,spec}]\n                          --title TITLE [--summary SUMMARY] [--force]\n                          path",
+      "signature": "frontmattering new [-h] [--profile {contract,evidence,guide,registry,release,router,spec}] --title TITLE [--summary SUMMARY] [--force] path",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -416,7 +416,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering parse [-h] [--output OUTPUT] [--batch]\n                            [--security-profile {permissive,moderate,strict}]\n                            [--allows-html]\n                            path",
+      "signature": "frontmattering parse [-h] [--output OUTPUT] [--batch] [--security-profile {permissive,moderate,strict}] [--allows-html] path",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -494,7 +494,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering promote [-h]\n                              --profile {contract,evidence,guide,registry,release,router,spec}\n                              [--title TITLE] [--output OUTPUT] [--in-place]\n                              [--check] [--format {markdown,json}]\n                              input",
+      "signature": "frontmattering promote [-h] --profile {contract,evidence,guide,registry,release,router,spec} [--title TITLE] [--output OUTPUT] [--in-place] [--check] [--format {markdown,json}] input",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -545,7 +545,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering query [-h] [--index INDEX] [--task TASK]\n                            [--authority AUTHORITY] [--role ROLE]\n                            [--target TARGET]",
+      "signature": "frontmattering query [-h] [--index INDEX] [--task TASK] [--authority AUTHORITY] [--role ROLE] [--target TARGET]",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -615,7 +615,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering schema [-h] [--output OUTPUT] [--check PATH] [--vscode]\n                             [paths ...]",
+      "signature": "frontmattering schema [-h] [--output OUTPUT] [--check PATH] [--vscode] [paths ...]",
       "summary": "==SUPPRESS==",
       "type": "function"
     },

{frontmattering-0.4.2/kernel/frontmattering/resources → frontmattering-0.4.3/kernel}/KERNEL_ACCEPTANCE_REPORT.md

@@ -64,7 +64,7 @@ template_contract:
 
 spec: FRONTMATTERING_FRONTMATTER_SPEC_v0_1_5.md
 spec_sha256: cb4f431d6326a04a2b30d5d1b4a99c301342b017799953b12740acf5b110b023
-kernel_files_sha256: 713befd933348e6ee6331c4748d2d0eab8a7650cf175832c70d8cebd7b2c55bb
+kernel_files_sha256: 9a94048a44cda60de8749783dc296cb02d45bbaf08253632b38073d5816f5c81
 
 classes_total: 101
 ok: 101  missing_fixture: 0  wrong_finding: 0  not_rejected: 0  rejected_valid: 0

frontmattering-0.4.3/kernel/frontmattering/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.3"

{frontmattering-0.4.2 → frontmattering-0.4.3}/kernel/frontmattering/__main__.py

@@ -719,7 +719,7 @@ def _parse_one_document(path: Path, args: argparse.Namespace) -> tuple[dict, int
     metadata.pop("security", None)
     payload = {
         "schema_version": "frontmattering_document_ir/v0_3",
-        "distribution_version": "0.4.2",
+        "distribution_version": "0.4.3",
         "canonical_model_version": "0.1.5",
         "source": {
             "path": str(path),
@@ -772,7 +772,7 @@ def command_parse(args: argparse.Namespace) -> int:
             dest.parent.mkdir(parents=True, exist_ok=True)
             dest.write_text(json.dumps(_json_safe(payload), indent=2, sort_keys=True, ensure_ascii=False)+"\n", encoding="utf-8")
             records.append({"source": rel.as_posix()[:-8], "ir": rel.as_posix(), "source_sha256": payload["source"]["sha256"]})
-        manifest = {"schema_version":"frontmattering_ir_batch_manifest/v0_3","distribution_version":"0.4.2-pypi-clear","source_root":str(path),"document_count":len(records),"records":records,"selection":selection.payload(),"claim_boundary":"Disposable deterministic projection; source Markdown remains authoritative."}
+        manifest = {"schema_version":"frontmattering_ir_batch_manifest/v0_3","distribution_version":"0.4.3","source_root":str(path),"document_count":len(records),"records":records,"selection":selection.payload(),"claim_boundary":"Disposable deterministic projection; source Markdown remains authoritative."}
         (out_root/"manifest.json").write_text(json.dumps(manifest,indent=2,sort_keys=True)+"\n",encoding="utf-8")
         print(f"document_ir_batch_written={out_root} documents={len(records)}")
         return terminal
@@ -1019,7 +1019,7 @@ def _runtime_wrapper() -> str:
         "runtime_builder": "frontmattering.__main__.command_runtime_pack",
     }
     return RUNTIME_WRAPPER_TEMPLATE.replace(
-        "__KERNEL_VERSION__", "0.4.2"
+        "__KERNEL_VERSION__", "0.4.3"
     ).replace(
         "__RUNTIME_BUILD_MANIFEST__", json.dumps(manifest, sort_keys=True)
     )
@@ -1066,7 +1066,7 @@ def command_runtime_pack(args: argparse.Namespace) -> int:
         "schema_version": "frontmattering_runtime_pack_report/v0_2",
         "runtime_artifact": str(out),
         "canonical_model_version": "0.1.5",
-        "kernel_version": "0.4.2",
+        "kernel_version": "0.4.3",
         "artifact_format": "python_zipapp",
         "surface": "validate_only",
         "artifact_sha256": hashlib.sha256(artifact_bytes).hexdigest(),
@@ -1104,7 +1104,7 @@ def build_parser() -> argparse.ArgumentParser:
         prog="frontmattering",
         description="Govern and orient load-bearing Markdown with Frontmattering canonical model v0.1.5 frontmatter.",
     )
-    parser.add_argument("--version", action="version", version="frontmattering distribution v0.4.2; canonical model v0.1.5")
+    parser.add_argument("--version", action="version", version="frontmattering distribution v0.4.3; canonical model v0.1.5")
     sub = parser.add_subparsers(dest="command", required=True, parser_class=StrictArgumentParser)
 
     init = sub.add_parser("init", help="Initialize a small Frontmattering document set and package router.")

{frontmattering-0.4.2 → frontmattering-0.4.3}/kernel/frontmattering/resources/AI_INDEX.json

@@ -62,7 +62,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering brief [-h] [--task TASK]\n                            [--section {summary,blocks,traps,limits,do-not,trust,reading-order,defects,claim-boundary}]\n                            [--include-dev] [--format {markdown,json}]\n                            [paths ...]",
+      "signature": "frontmattering brief [-h] [--task TASK] [--section {summary,blocks,traps,limits,do-not,trust,reading-order,defects,claim-boundary}] [--include-dev] [--format {markdown,json}] [paths ...]",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -188,7 +188,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering index [-h]\n                            {build,rebuild,update,check,status,delete} ...",
+      "signature": "frontmattering index [-h] {build,rebuild,update,check,status,delete} ...",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -232,7 +232,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering init [-h] --set-id SET_ID --title TITLE [--force]\n                           directory",
+      "signature": "frontmattering init [-h] --set-id SET_ID --title TITLE [--force] directory",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -360,7 +360,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering new [-h]\n                          [--profile {contract,evidence,guide,registry,release,router,spec}]\n                          --title TITLE [--summary SUMMARY] [--force]\n                          path",
+      "signature": "frontmattering new [-h] [--profile {contract,evidence,guide,registry,release,router,spec}] --title TITLE [--summary SUMMARY] [--force] path",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -416,7 +416,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering parse [-h] [--output OUTPUT] [--batch]\n                            [--security-profile {permissive,moderate,strict}]\n                            [--allows-html]\n                            path",
+      "signature": "frontmattering parse [-h] [--output OUTPUT] [--batch] [--security-profile {permissive,moderate,strict}] [--allows-html] path",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -494,7 +494,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering promote [-h]\n                              --profile {contract,evidence,guide,registry,release,router,spec}\n                              [--title TITLE] [--output OUTPUT] [--in-place]\n                              [--check] [--format {markdown,json}]\n                              input",
+      "signature": "frontmattering promote [-h] --profile {contract,evidence,guide,registry,release,router,spec} [--title TITLE] [--output OUTPUT] [--in-place] [--check] [--format {markdown,json}] input",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -545,7 +545,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering query [-h] [--index INDEX] [--task TASK]\n                            [--authority AUTHORITY] [--role ROLE]\n                            [--target TARGET]",
+      "signature": "frontmattering query [-h] [--index INDEX] [--task TASK] [--authority AUTHORITY] [--role ROLE] [--target TARGET]",
       "summary": "==SUPPRESS==",
       "type": "function"
     },
@@ -615,7 +615,7 @@
         "description": "Process exit code documented by the command implementation.",
         "type": "int"
       },
-      "signature": "frontmattering schema [-h] [--output OUTPUT] [--check PATH] [--vscode]\n                             [paths ...]",
+      "signature": "frontmattering schema [-h] [--output OUTPUT] [--check PATH] [--vscode] [paths ...]",
       "summary": "==SUPPRESS==",
       "type": "function"
     },

{frontmattering-0.4.2/kernel → frontmattering-0.4.3/kernel/frontmattering/resources}/KERNEL_ACCEPTANCE_REPORT.md

@@ -64,7 +64,7 @@ template_contract:
 
 spec: FRONTMATTERING_FRONTMATTER_SPEC_v0_1_5.md
 spec_sha256: cb4f431d6326a04a2b30d5d1b4a99c301342b017799953b12740acf5b110b023
-kernel_files_sha256: 713befd933348e6ee6331c4748d2d0eab8a7650cf175832c70d8cebd7b2c55bb
+kernel_files_sha256: 9a94048a44cda60de8749783dc296cb02d45bbaf08253632b38073d5816f5c81
 
 classes_total: 101
 ok: 101  missing_fixture: 0  wrong_finding: 0  not_rejected: 0  rejected_valid: 0

{frontmattering-0.4.2 → frontmattering-0.4.3}/kernel/frontmattering/resources/tools/check_pilot_readiness.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Focused regression gate for the clean-break Frontmattering v0.4.2 CLI trust/adoption candidate.
+"""Focused regression gate for the clean-break Frontmattering v0.4.3 CLI trust/adoption candidate.
 
 This gate verifies implementation obligations and negative cases. It does not
 supply external participant evidence or prove semantic/product value.
@@ -130,7 +130,7 @@ def check_product_boundary() -> dict:
         require(phrase not in combined, f"forbidden broad claim present: {phrase}")
 
     pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
-    require('version = "0.4.2"' in pyproject, "distribution version not updated")
+    require('version = "0.4.3"' in pyproject, "distribution version not updated")
     require('dependencies = ["PyYAML>=6.0", "markdown-it-py>=4.0.0"]' in pyproject, "runtime dependency surface expanded")
     for forbidden in ("sqlalchemy", "fastapi", "chromadb", "openai", "polars", "pyarrow"):
         require(forbidden not in pyproject.casefold(), f"forbidden runtime dependency present: {forbidden}")
@@ -528,7 +528,7 @@ def main() -> int:
     payload = {
         "schema_version": "frontmattering_pilot_readiness_check/v0_2",
         "terminal_state": "PASS" if not failures else "FAIL",
-        "distribution_version": "0.4.2-pypi-clear",
+        "distribution_version": "0.4.3",
         "canonical_model_version": "0.1.5",
         "results": results,
         "failures": failures,

{frontmattering-0.4.2/kernel → frontmattering-0.4.3/kernel/frontmattering/resources}/tools/distribution_receipt.py

@@ -16,7 +16,7 @@ def prohibited():
 def files():
     return sorted(p for p in ROOT.rglob('*') if p.is_file() and rel(p) not in EXCLUDED and '.egg-info/' not in rel(p))
 def payload():
-    return {'receipt_schema':'frontmattering_distribution_receipt/v0_4','canonical_model_version':'0.1.5','distribution_version':'0.4.2','claim_boundary':'Exact admissible file inventory and digest currency only; not adoption, release approval, semantic adequacy, or production readiness.','files':[{'path':rel(p),'size_bytes':p.stat().st_size,'sha256':sha(p)} for p in files()]}
+    return {'receipt_schema':'frontmattering_distribution_receipt/v0_4','canonical_model_version':'0.1.5','distribution_version':'0.4.3','claim_boundary':'Exact admissible file inventory and digest currency only; not adoption, release approval, semantic adequacy, or production readiness.','files':[{'path':rel(p),'size_bytes':p.stat().st_size,'sha256':sha(p)} for p in files()]}
 def refuse_debris():
     bad=prohibited()
     if bad:

{frontmattering-0.4.2/kernel → frontmattering-0.4.3/kernel/frontmattering/resources}/tools/generate_ai_index.py

@@ -29,6 +29,28 @@ def _subparser_action(parser: argparse.ArgumentParser) -> argparse._SubParsersAc
     )
 
 
+# argparse computes ``.required`` for positional actions differently across
+# CPython versions; derive it from ``nargs`` so the generated index is stable.
+_OPTIONAL_NARGS = frozenset({argparse.OPTIONAL, argparse.ZERO_OR_MORE, argparse.REMAINDER})
+
+
+def _required(action: argparse.Action) -> bool:
+    if action.option_strings:
+        return bool(action.required)
+    return action.nargs not in _OPTIONAL_NARGS
+
+
+def _normalize_usage(usage: str) -> str:
+    # argparse wraps usage text to the terminal width, so the raw string varies
+    # by environment/Python version. Collapse all whitespace to single spaces
+    # for a stable, width-independent signature.
+    collapsed = " ".join(usage.split())
+    prefix = "usage: "
+    if collapsed.startswith(prefix):
+        collapsed = collapsed[len(prefix):]
+    return collapsed
+
+
 def _parameter(action: argparse.Action) -> dict[str, Any] | None:
     if action.dest == "help":
         return None
@@ -36,7 +58,7 @@ def _parameter(action: argparse.Action) -> dict[str, Any] | None:
     payload: dict[str, Any] = {
         "name": name,
         "dest": action.dest,
-        "required": bool(getattr(action, "required", False)),
+        "required": _required(action),
         "nargs": action.nargs,
         "help": action.help,
     }
@@ -62,8 +84,8 @@ def generate_ai_index() -> dict[str, Any]:
                 "name": name,
                 "type": "function",
                 "path": f"frontmattering.__main__.{getattr(func, '__name__', 'unknown')}",
-                "summary": command_parser.description or command_parser.get_default("help") or command_parser.format_usage().strip(),
-                "signature": command_parser.format_usage().replace("usage: ", "").strip(),
+                "summary": command_parser.description or command_parser.get_default("help") or _normalize_usage(command_parser.format_usage()),
+                "signature": _normalize_usage(command_parser.format_usage()),
                 "parameters": parameters,
                 "returns": {
                     "type": "int",
@@ -111,7 +133,7 @@ def main(argv: list[str] | None = None) -> int:
         if existing != current:
             print("ai_index_check=FAIL")
             print("why=AI_INDEX.json does not match the live argparse command surface")
-            print("fix=uv run python FFQT_GUIDES/kernel/tools/generate_ai_index.py --write")
+            print("fix=python kernel/tools/generate_ai_index.py --write")
             return 1
         print("ai_index_check=PASS")
         return 0

{frontmattering-0.4.2 → frontmattering-0.4.3/kernel/frontmattering.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontmattering
-Version: 0.4.2
+Version: 0.4.3
 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
@@ -36,10 +36,10 @@ 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
+## Install
 
 ```bash
-python -m pip install frontmattering-0.4.2-py3-none-any.whl
+python -m pip install frontmattering
 frontmattering --version
 frontmattering doctor
 ```
@@ -73,7 +73,7 @@ The runtime artifact is validate-only. It does not expose init, promote, new, in
 
 ## 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 source-available. It is free for individual personal use within the scope of `LICENSE.md`. Professional, organizational, employer, client, CI/CD, hosted, managed-service, platform, consulting, or revenue-connected use is permitted for a 30-day evaluation period under `LICENSE.md`; continued use after the evaluation 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.
 
@@ -88,4 +88,4 @@ 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.
+This v0.4.3 package is a public-surface cleanup of the v0.4.2 PyPI-clear release (install/readme/license-summary corrections; no validator, schema, or canonical-model changes). Custom license text should still receive legal review before paid commercial sales.

{frontmattering-0.4.2 → frontmattering-0.4.3}/kernel/tools/check_pilot_readiness.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Focused regression gate for the clean-break Frontmattering v0.4.2 CLI trust/adoption candidate.
+"""Focused regression gate for the clean-break Frontmattering v0.4.3 CLI trust/adoption candidate.
 
 This gate verifies implementation obligations and negative cases. It does not
 supply external participant evidence or prove semantic/product value.
@@ -130,7 +130,7 @@ def check_product_boundary() -> dict:
         require(phrase not in combined, f"forbidden broad claim present: {phrase}")
 
     pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
-    require('version = "0.4.2"' in pyproject, "distribution version not updated")
+    require('version = "0.4.3"' in pyproject, "distribution version not updated")
     require('dependencies = ["PyYAML>=6.0", "markdown-it-py>=4.0.0"]' in pyproject, "runtime dependency surface expanded")
     for forbidden in ("sqlalchemy", "fastapi", "chromadb", "openai", "polars", "pyarrow"):
         require(forbidden not in pyproject.casefold(), f"forbidden runtime dependency present: {forbidden}")
@@ -528,7 +528,7 @@ def main() -> int:
     payload = {
         "schema_version": "frontmattering_pilot_readiness_check/v0_2",
         "terminal_state": "PASS" if not failures else "FAIL",
-        "distribution_version": "0.4.2-pypi-clear",
+        "distribution_version": "0.4.3",
         "canonical_model_version": "0.1.5",
         "results": results,
         "failures": failures,

{frontmattering-0.4.2/kernel/frontmattering/resources → frontmattering-0.4.3/kernel}/tools/distribution_receipt.py

@@ -16,7 +16,7 @@ def prohibited():
 def files():
     return sorted(p for p in ROOT.rglob('*') if p.is_file() and rel(p) not in EXCLUDED and '.egg-info/' not in rel(p))
 def payload():
-    return {'receipt_schema':'frontmattering_distribution_receipt/v0_4','canonical_model_version':'0.1.5','distribution_version':'0.4.2','claim_boundary':'Exact admissible file inventory and digest currency only; not adoption, release approval, semantic adequacy, or production readiness.','files':[{'path':rel(p),'size_bytes':p.stat().st_size,'sha256':sha(p)} for p in files()]}
+    return {'receipt_schema':'frontmattering_distribution_receipt/v0_4','canonical_model_version':'0.1.5','distribution_version':'0.4.3','claim_boundary':'Exact admissible file inventory and digest currency only; not adoption, release approval, semantic adequacy, or production readiness.','files':[{'path':rel(p),'size_bytes':p.stat().st_size,'sha256':sha(p)} for p in files()]}
 def refuse_debris():
     bad=prohibited()
     if bad:

{frontmattering-0.4.2/kernel/frontmattering/resources → frontmattering-0.4.3/kernel}/tools/generate_ai_index.py

@@ -29,6 +29,28 @@ def _subparser_action(parser: argparse.ArgumentParser) -> argparse._SubParsersAc
     )
 
 
+# argparse computes ``.required`` for positional actions differently across
+# CPython versions; derive it from ``nargs`` so the generated index is stable.
+_OPTIONAL_NARGS = frozenset({argparse.OPTIONAL, argparse.ZERO_OR_MORE, argparse.REMAINDER})
+
+
+def _required(action: argparse.Action) -> bool:
+    if action.option_strings:
+        return bool(action.required)
+    return action.nargs not in _OPTIONAL_NARGS
+
+
+def _normalize_usage(usage: str) -> str:
+    # argparse wraps usage text to the terminal width, so the raw string varies
+    # by environment/Python version. Collapse all whitespace to single spaces
+    # for a stable, width-independent signature.
+    collapsed = " ".join(usage.split())
+    prefix = "usage: "
+    if collapsed.startswith(prefix):
+        collapsed = collapsed[len(prefix):]
+    return collapsed
+
+
 def _parameter(action: argparse.Action) -> dict[str, Any] | None:
     if action.dest == "help":
         return None
@@ -36,7 +58,7 @@ def _parameter(action: argparse.Action) -> dict[str, Any] | None:
     payload: dict[str, Any] = {
         "name": name,
         "dest": action.dest,
-        "required": bool(getattr(action, "required", False)),
+        "required": _required(action),
         "nargs": action.nargs,
         "help": action.help,
     }
@@ -62,8 +84,8 @@ def generate_ai_index() -> dict[str, Any]:
                 "name": name,
                 "type": "function",
                 "path": f"frontmattering.__main__.{getattr(func, '__name__', 'unknown')}",
-                "summary": command_parser.description or command_parser.get_default("help") or command_parser.format_usage().strip(),
-                "signature": command_parser.format_usage().replace("usage: ", "").strip(),
+                "summary": command_parser.description or command_parser.get_default("help") or _normalize_usage(command_parser.format_usage()),
+                "signature": _normalize_usage(command_parser.format_usage()),
                 "parameters": parameters,
                 "returns": {
                     "type": "int",
@@ -111,7 +133,7 @@ def main(argv: list[str] | None = None) -> int:
         if existing != current:
             print("ai_index_check=FAIL")
             print("why=AI_INDEX.json does not match the live argparse command surface")
-            print("fix=uv run python FFQT_GUIDES/kernel/tools/generate_ai_index.py --write")
+            print("fix=python kernel/tools/generate_ai_index.py --write")
             return 1
         print("ai_index_check=PASS")
         return 0

{frontmattering-0.4.2 → frontmattering-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontmattering"
-version = "0.4.2"
+version = "0.4.3"
 description = "Governed frontmatter, freshness tethers, and validate-only runtime gates for agent-facing Markdown"
 readme = "README.md"
 requires-python = ">=3.10"

frontmattering-0.4.2/kernel/frontmattering/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.4.2"