faf-python-sdk 1.3.0__tar.gz → 1.3.1__tar.gz

{faf_python_sdk-1.3.0 → faf_python_sdk-1.3.1}/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to faf-python-sdk are documented here.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
+## [1.3.1] - 2026-09-07 — The Interop Edition
+
+Docs / copy patch — no API change.
+
+### Fixed
+- "generate" removed from external copy: the `interop.py` module docstring, the
+  `## Setup & build` blockquote written into every AGENTS.md ("regenerated each
+  time" → "do not edit the managed block"), README, and CHANGELOG. FAF authors
+  and delivers facts. The `generate_agents_md` / `generate_gemini_md` function
+  names are unchanged (internal identifiers, TS↔Python parity).
+
 ## [1.3.0] - 2026-09-06 — The Interop Edition
 
 The SDK can now author AI-context files, not just parse and score them.
@@ -18,7 +29,7 @@ The SDK can now author AI-context files, not just parse and score them.
   intentionally omitted from AGENTS.md — it belongs in the README / .faf DNA.
 - `faf_meta_tag(faf)`, `title_label(key)`, `slot_label(path)` — the shared
   label + metastamp helpers, also from `src/interop`.
-- Both generators take the **raw parsed dict** (`FafFile.data.raw`) — the .faf
+- Both take the **raw parsed dict** (`FafFile.data.raw`) — the .faf
   format carries top-level `commands` / `key_files` / `security` that the typed
   model doesn't surface.
 - 17 tests, including deterministic-output and human-context-omission guards.

{faf_python_sdk-1.3.0 → faf_python_sdk-1.3.1}/CLAUDE.md

@@ -29,5 +29,5 @@ Python SDK for parsing, validating, scoring, and authoring .faf project context
 
 ---
 
-*STATUS: BI-SYNC ACTIVE — 2026-09-06T18:19:41.228Z*
+*STATUS: BI-SYNC ACTIVE — 2026-09-07T02:08:39.970Z*
 <!-- faf:end -->

{faf_python_sdk-1.3.0 → faf_python_sdk-1.3.1}/PKG-INFO

@@ -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 → faf_python_sdk-1.3.1}/README.md

@@ -14,10 +14,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
@@ -27,7 +29,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 → faf_python_sdk-1.3.1}/faf_sdk/__init__.py

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

{faf_python_sdk-1.3.0 → faf_python_sdk-1.3.1}/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()
 

{faf_python_sdk-1.3.0 → faf_python_sdk-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "faf-python-sdk"
-version = "1.3.0"
+version = "1.3.1"
 description = "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."
 readme = "README.md"
 license = {text = "MIT"}