faf-python-sdk 1.3.0__py3-none-any.whl → 1.3.1__py3-none-any.whl

{faf_python_sdk-1.3.0.dist-info → faf_python_sdk-1.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: faf-python-sdk
-Version: 1.3.0
+Version: 1.3.1
 Summary: Persistent project context for Python — parse, validate, and score `.faf` files. The foundation other Python FAF tools (gemini-faf-mcp, custom MCP servers, CI validators) build on. IANA-registered application/vnd.faf+yaml.
 Project-URL: Homepage, https://faf.one
 Project-URL: Documentation, https://github.com/Wolfe-Jam/faf-python-sdk
@@ -46,10 +46,12 @@ The foundation other Python FAF tools build on. If you're building MCP servers,
 
 **Media Type:** `application/vnd.faf+yaml` (IANA registered)
 
-## What's New in v1.3.0 — The Interop Edition
+## What's New in v1.3.1 — The Interop Edition
 
 The SDK can now author AI-context files, not just parse and score them.
 
+> **v1.3.1** is a copy patch — "generate" removed from external text (module docstring, the blockquote written into every AGENTS.md, README, CHANGELOG). No API change; the `faf_sdk.interop` functions below are unchanged.
+
 `faf_sdk.interop` — `generate_agents_md(faf)` and `generate_gemini_md(faf)`, Python ports of faf-cli's `src/interop/agents.ts` + `gemini.ts`, in parity with the canonical TypeScript. Deterministic BETTER-shaped projection: setup (install→build→dev ordered) · tests · layout · conventions · three-tier guardrails · definition of done · security · commit · stack. Human Context (who/why marketing) is intentionally omitted from AGENTS.md — it belongs in the README / .faf DNA, not agent ops.
 
 ```python
@@ -59,7 +61,7 @@ faf = parse_file("project.faf")
 print(generate_agents_md(faf.data.raw))   # takes the raw dict — carries top-level commands / key_files / security
 ```
 
-Any Python FAF tool that authors an AI-context file wraps this now — never hand-roll a Markdown generator. `gemini-faf-mcp` 2.7.0's `faf_agents` / `faf_gemini` are the reference wrappers.
+Any Python FAF tool that authors an AI-context file wraps this now — never hand-roll one. `gemini-faf-mcp` 2.7.0's `faf_agents` / `faf_gemini` are the reference wrappers.
 
 ## What's New in v1.2.0 — The Dart Edition
 

{faf_python_sdk-1.3.0.dist-info → faf_python_sdk-1.3.1.dist-info}/RECORD

@@ -1,14 +1,14 @@
-faf_sdk/__init__.py,sha256=1ARRF6IEkjcvf0zJwqWQF30TjTGtgrzWi8O3YwigASc,1842
+faf_sdk/__init__.py,sha256=_HepiDZAIejVARbFBkTIK3yXyefmemLZlP9Ao6O29NE,1842
 faf_sdk/dart_detection.json,sha256=jFtKnyyMVVFsunizteFZ2pLhYC1qC2nCIWQB9SdOqKE,1195
 faf_sdk/detect.py,sha256=GothQNKChKSEwke74MRy63VyBYLqOzN1j3yzjsSVpJA,6310
 faf_sdk/discovery.py,sha256=3Jj3lSzPAj9l0_VjJneLAwo1dMXvhneFhcVN4m2ejOw,8643
-faf_sdk/interop.py,sha256=fgIm13pLZIxSrjJiq7ZXXvR5ViWezuGUxhzCbsz_eZQ,13465
+faf_sdk/interop.py,sha256=V2gdR4Y2w8R2mUtRBPq-pSlu4glzpeFuWfpQazvPOGI,13450
 faf_sdk/mk4.py,sha256=dA8o3YB0W19Mt_bqcR67HAw4S08zxj6IzEmubTy-pQY,5708
 faf_sdk/parser.py,sha256=lJJysj52X0Q_aGhl4PMXY2PuMqASFHdVRiSZFDdampk,4925
 faf_sdk/types.py,sha256=sm1ezSzCc-93bszr4ite31_xZRKjwqf2utlqN6_0QuM,6615
 faf_sdk/validator.py,sha256=6uneOwar4GYUF52BnAQTu159kE4mh4RWRgG6onVbiG4,5730
 faf_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-faf_python_sdk-1.3.0.dist-info/METADATA,sha256=L_RFAhO35YJ9RRSGyl5M8IIdFBU6rndw5bnKmUJmBpk,8784
-faf_python_sdk-1.3.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-faf_python_sdk-1.3.0.dist-info/licenses/LICENSE,sha256=ARScF5tFhbQnYO2V5QAuCwhDHcxKdOWTOV81Pxx_j7U,1065
-faf_python_sdk-1.3.0.dist-info/RECORD,,
+faf_python_sdk-1.3.1.dist-info/METADATA,sha256=df6Rn6Y5FFupYES2dA_98R-0K6kb6vtQJJQow510RHM,8991
+faf_python_sdk-1.3.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+faf_python_sdk-1.3.1.dist-info/licenses/LICENSE,sha256=ARScF5tFhbQnYO2V5QAuCwhDHcxKdOWTOV81Pxx_j7U,1065
+faf_python_sdk-1.3.1.dist-info/RECORD,,

faf_sdk/__init__.py

@@ -36,7 +36,7 @@ from .types import (
     AIScoring
 )
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"
 __all__ = [
     # Parser
     "parse",

faf_sdk/interop.py

@@ -1,5 +1,5 @@
 """
-AI-context file generators — AGENTS.md and GEMINI.md from .faf data.
+AI-context file authoring — AGENTS.md and GEMINI.md from .faf data.
 
 Python port of faf-cli's `src/interop/agents.ts` + `gemini.ts`, kept in
 parity with the canonical TypeScript. Deterministic projection from curated
@@ -90,7 +90,7 @@ def slot_label(path: str) -> str:
 
 
 def faf_meta_tag(faf: dict) -> str:
-    """The two-line `<!-- faf: ... -->` metastamp every faf-generated file opens with."""
+    """The two-line `<!-- faf: ... -->` metastamp every faf-authored file opens with."""
     proj = faf.get("project") or {}
     name = str(proj.get("name") or "").strip()
     lang = str(proj.get("main_language") or "").strip()
@@ -102,7 +102,7 @@ def faf_meta_tag(faf: dict) -> str:
     return f"{line1}\n{line2}"
 
 
-# --- command classification (shared by both generators) ---------------------
+# --- command classification (shared by both) --------------------------------
 
 def _classify_commands(faf: dict) -> dict:
     commands = faf.get("commands") or {}
@@ -187,9 +187,9 @@ def generate_agents_md(faf: dict) -> str:
         push(orientation)
         push()
     push(
-        "> Authored by faf — refresh with `faf export --agents` or the "
-        "`faf_agents` MCP tool. The managed block is regenerated each time; "
-        "hand-written content outside it is preserved."
+        "> Authored by faf — do not edit the managed block; refresh with "
+        "`faf export --agents` or the `faf_agents` MCP tool. Hand-written "
+        "content outside it is preserved."
     )
     push()