specfact-cli 0.38.1__tar.gz → 0.38.2__tar.gz

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.38.1
+Version: 0.38.2
 Summary: The swiss knife CLI for agile DevOps teams. Keep backlog, specs, tests, and code in sync with validation and contract enforcement for new projects and long-lived codebases.
 Project-URL: Homepage, https://github.com/nold-ai/specfact-cli
 Project-URL: Repository, https://github.com/nold-ai/specfact-cli.git

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.38.1"
+version = "0.38.2"
 description = "The swiss knife CLI for agile DevOps teams. Keep backlog, specs, tests, and code in sync with validation and contract enforcement for new projects and long-lived codebases."
 readme = "README.md"
 requires-python = ">=3.11"

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/src/__init__.py

@@ -3,4 +3,4 @@ SpecFact CLI - Spec→Contract→Sentinel tool for contract-driven development.
 """
 
 # Package version: keep in sync with pyproject.toml, setup.py, src/specfact_cli/__init__.py
-__version__ = "0.38.1"
+__version__ = "0.38.2"

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/src/specfact_cli/__init__.py

@@ -8,6 +8,6 @@ This package provides command-line tools for:
 - Supporting agile ceremonies and team workflows
 """
 
-__version__ = "0.38.1"
+__version__ = "0.38.2"
 
 __all__ = ["__version__"]

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/src/specfact_cli/modules/backlog/module-package.yaml

@@ -1,5 +1,5 @@
 name: backlog
-version: 0.1.5
+version: 0.1.6
 commands:
   - backlog
 command_help:
@@ -28,5 +28,5 @@ publisher:
 description: Manage backlog ceremonies, refinement, and dependency insights.
 license: Apache-2.0
 integrity:
-  checksum: sha256:f70d5fe4f5800a1ceec246c699c8747aada4cc9cf96d7063519e8d66ed9d9e61
-  signature: bUkOlza/4kdLocRbDOyCnjdi2CQQkDkm5pSBuzg5LzJ3RllJ2NuXVCSlTjtdbdMYxQOf2JdLpl27mpcvHUnAAQ==
+  checksum: sha256:a3b033ef35a6a95e1c40ffe28e112cb1683af5051dd813038bacf1cd76bfd7ad
+  signature: gHQkRqNpRRpxwRmFiHSHaSpq8/rwKvv1v/4Wjt8pRl0Z2VFTVF1DStb2XwgZlE0Bpg77n++G5mIl7KkM7MyGBQ==

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/src/specfact_cli/modules/backlog/src/commands.py

@@ -31,6 +31,7 @@ import yaml
 from beartype import beartype
 from icontract import ensure, require
 from rich.console import Console
+from rich.markdown import Markdown
 from rich.panel import Panel
 from rich.progress import Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
 from rich.prompt import Confirm
@@ -78,6 +79,18 @@ class _BacklogCommandGroup(TyperGroup):
         return sorted(commands, key=lambda name: (self._ORDER_PRIORITY.get(name, 1000), name))
 
 
+def _is_interactive_tty() -> bool:
+    """
+    Return True when running in an interactive TTY suitable for rich Markdown rendering.
+
+    CI and non-TTY environments should fall back to plain Markdown text to keep output machine-friendly.
+    """
+    try:
+        return sys.stdout.isatty()
+    except Exception:  # pragma: no cover - extremely defensive
+        return False
+
+
 class _CeremonyCommandGroup(TyperGroup):
     """Stable ordering for backlog ceremony subcommands."""
 
@@ -1475,7 +1488,7 @@ def _build_summarize_prompt_content(
         )
         lines.append(f"- **Last updated:** {updated}")
         if include_comments:
-            body = (item.body_markdown or "").strip()
+            body = _normalize_markdown_text((item.body_markdown or "").strip())
             if body:
                 snippet = body[:_SUMMARIZE_BODY_TRUNCATE]
                 if len(body) > _SUMMARIZE_BODY_TRUNCATE:
@@ -1492,7 +1505,8 @@ def _build_summarize_prompt_content(
             if item_comments:
                 lines.append("- **Comments (annotations):**")
                 for c in item_comments:
-                    lines.append(f"  - {c}")
+                    normalized_comment = _normalize_markdown_text(c)
+                    lines.append(f"  - {normalized_comment}")
         if item.story_points is not None:
             lines.append(f"- **Story points:** {item.story_points}")
         if item.priority is not None:
@@ -1506,6 +1520,57 @@ def _build_summarize_prompt_content(
     return "\n".join(lines).strip()
 
 
+_HTML_TAG_RE = re.compile(r"<[A-Za-z/][^>]*>")
+
+
+@beartype
+@ensure(lambda result: not _HTML_TAG_RE.search(result or ""), "Normalized text must not contain raw HTML tags")
+def _normalize_markdown_text(text: str) -> str:
+    """
+    Normalize provider-specific markup (HTML, entities) to Markdown-friendly text.
+
+    This is intentionally conservative: plain Markdown is left as-is, while common HTML constructs from
+    ADO-style bodies and comments are converted to readable Markdown and stripped of tags/entities.
+    """
+    if not text:
+        return ""
+
+    # Fast path: if no obvious HTML markers, return as-is.
+    if "<" not in text and "&" not in text:
+        return text
+
+    from html import unescape
+
+    # Unescape HTML entities first so we can treat content uniformly.
+    value = unescape(text)
+
+    # Replace common block/linebreak tags with newlines before stripping other tags.
+    # Handle several variants to cover typical ADO HTML.
+    value = re.sub(r"<\s*br\s*/?\s*>", "\n", value, flags=re.IGNORECASE)
+    value = re.sub(r"</\s*p\s*>", "\n\n", value, flags=re.IGNORECASE)
+    value = re.sub(r"<\s*p[^>]*>", "", value, flags=re.IGNORECASE)
+
+    # Turn list items into markdown bullets.
+    value = re.sub(r"<\s*li[^>]*>", "- ", value, flags=re.IGNORECASE)
+    value = re.sub(r"</\s*li\s*>", "\n", value, flags=re.IGNORECASE)
+    value = re.sub(r"<\s*ul[^>]*>", "", value, flags=re.IGNORECASE)
+    value = re.sub(r"</\s*ul\s*>", "\n", value, flags=re.IGNORECASE)
+    value = re.sub(r"<\s*ol[^>]*>", "", value, flags=re.IGNORECASE)
+    value = re.sub(r"</\s*ol\s*>", "\n", value, flags=re.IGNORECASE)
+
+    # Drop any remaining tags conservatively.
+    value = _HTML_TAG_RE.sub("", value)
+
+    # Normalize whitespace: collapse excessive blank lines but keep paragraph structure.
+    # First, normalize Windows-style newlines.
+    value = value.replace("\r\n", "\n").replace("\r", "\n")
+    # Collapse 3+ blank lines into 2.
+    value = re.sub(r"\n{3,}", "\n\n", value)
+    # Strip leading/trailing whitespace on each line.
+    lines = [line.rstrip() for line in value.split("\n")]
+    return "\n".join(lines).strip()
+
+
 @beartype
 def _build_refine_export_content(
     adapter: str,
@@ -2996,7 +3061,10 @@ def daily(
             Path(summarize_to).write_text(content, encoding="utf-8")
             console.print(f"[dim]Summarize prompt written to {summarize_to} ({len(filtered)} item(s))[/dim]")
         else:
-            console.print(content)
+            if _is_interactive_tty() and not os.environ.get("CI"):
+                console.print(Markdown(content))
+            else:
+                console.print(content)
         return
 
     if interactive:

{specfact_cli-0.38.1 → specfact_cli-0.38.2}/src/specfact_cli/utils/startup_checks.py

@@ -372,7 +372,7 @@ def print_startup_checks(
                     f"IDE: [cyan]{template_result.ide}[/cyan]\n"
                     f"Location: [dim]{template_result.ide_dir}[/dim]\n\n"
                     f"{details_str}\n\n"
-                    f"Run [bold]specfact init --force[/bold] to update them.",
+                    f"Run [bold]specfact init ide --force[/bold] to update them.",
                     border_style="yellow",
                 )
             )