codeframe-ai 0.9.4__tar.gz → 0.9.5__tar.gz

{codeframe_ai-0.9.4/codeframe_ai.egg-info → codeframe_ai-0.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeframe-ai
-Version: 0.9.4
+Version: 0.9.5
 Summary: A project delivery system that orchestrates frontier coding agents: Think, Build, Prove, Ship.
 Author-email: Frank Bria <hello@codeframe.sh>
 License: AGPL-3.0-or-later
@@ -159,7 +159,7 @@ THE CLOSED LOOP
 ---
 
 > [!NOTE]
-> **CodeFRAME is in public beta (`0.9.4`).** The vision and the Golden Path CLI
+> **CodeFRAME is in public beta (`0.9.5`).** The vision and the Golden Path CLI
 > (`cf init/prd/tasks/work/proof/pr`) and v2 API are stable enough to build on;
 > the web UI and anything marked "in progress" in
 > [`docs/PRODUCT_ROADMAP.md`](docs/PRODUCT_ROADMAP.md) are still moving, and
@@ -385,6 +385,7 @@ cf status                             # Workspace status
 # Requirements
 cf prd generate                       # AI-guided Socratic PRD creation
 cf prd generate --template lean       # Use a specific template
+cf prd generate --max-questions 6     # Cap discovery (default 10; /done finishes early)
 cf prd add <file.md>                  # Import existing PRD
 cf prd show                           # Display current PRD
 

{codeframe_ai-0.9.4 → codeframe_ai-0.9.5}/README.md

@@ -74,7 +74,7 @@ THE CLOSED LOOP
 ---
 
 > [!NOTE]
-> **CodeFRAME is in public beta (`0.9.4`).** The vision and the Golden Path CLI
+> **CodeFRAME is in public beta (`0.9.5`).** The vision and the Golden Path CLI
 > (`cf init/prd/tasks/work/proof/pr`) and v2 API are stable enough to build on;
 > the web UI and anything marked "in progress" in
 > [`docs/PRODUCT_ROADMAP.md`](docs/PRODUCT_ROADMAP.md) are still moving, and
@@ -300,6 +300,7 @@ cf status                             # Workspace status
 # Requirements
 cf prd generate                       # AI-guided Socratic PRD creation
 cf prd generate --template lean       # Use a specific template
+cf prd generate --max-questions 6     # Cap discovery (default 10; /done finishes early)
 cf prd add <file.md>                  # Import existing PRD
 cf prd show                           # Display current PRD
 

{codeframe_ai-0.9.4 → codeframe_ai-0.9.5}/codeframe/adapters/llm/base.py

@@ -60,12 +60,14 @@ class Purpose(str, Enum):
     SUPERVISION = "supervision"  # Supervisor decisions (blocker triage, tactical resolution)
 
 
-# Default model aliases (use valid Anthropic model identifiers)
-DEFAULT_PLANNING_MODEL = "claude-sonnet-4-5"
-DEFAULT_EXECUTION_MODEL = "claude-sonnet-4-5"
+# Default model aliases (use valid Anthropic model identifiers). The Sonnet tier
+# moved to 5.5 before claude-sonnet-4-5 retires on 2026-11-30 (#1348); Haiku 4.5
+# stays the generation default until it has an announced retirement date.
+DEFAULT_PLANNING_MODEL = "claude-sonnet-5-5"
+DEFAULT_EXECUTION_MODEL = "claude-sonnet-5-5"
 DEFAULT_GENERATION_MODEL = "claude-haiku-4-5"
-DEFAULT_CORRECTION_MODEL = "claude-sonnet-4-5"  # Use same tier; override via CODEFRAME_CORRECTION_MODEL for a stronger model
-DEFAULT_SUPERVISION_MODEL = "claude-sonnet-4-5"  # Use same tier; override via CODEFRAME_SUPERVISION_MODEL for a stronger model
+DEFAULT_CORRECTION_MODEL = "claude-sonnet-5-5"  # Use same tier; override via CODEFRAME_CORRECTION_MODEL for a stronger model
+DEFAULT_SUPERVISION_MODEL = "claude-sonnet-5-5"  # Use same tier; override via CODEFRAME_SUPERVISION_MODEL for a stronger model
 
 
 @dataclass

{codeframe_ai-0.9.4 → codeframe_ai-0.9.5}/codeframe/cli/app.py

@@ -214,14 +214,54 @@ def _load_brief_file(path: Path) -> str:
     return brief
 
 
+def _finish_non_interactive(session, question: dict) -> bool:
+    """--brief-file after MAX_ANSWER_ATTEMPTS: finish if an answer is in, else stop.
+
+    There is no list to desynchronise, so repeated rejection means the brief does
+    not cover what is being asked. With an answer in, finishing beats failing:
+    the PRD lists what is still uncovered (#1443, #1450).
+    """
+    answered = session.answered_count
+    if not answered:
+        console.print(
+            "[red]Error:[/red] giving up in non-interactive mode. The stand-in "
+            "answered from the brief five times without being accepted, which "
+            "usually means the brief does not cover what this question asks:\n\n"
+            f"  {escape(question.get('text', ''))}\n\n"
+            "Extend the brief to cover it, or run interactively."
+        )
+        raise typer.Exit(1)
+    console.print(
+        f"[yellow]Finishing discovery with the {answered} answer"
+        f"{'' if answered == 1 else 's'} accepted so far; the PRD will list "
+        "what is still uncovered as open questions.[/yellow]"
+    )
+    session.finish_now()
+    return True
+
+
+def _offer_finish(session) -> bool:
+    """Interactive: offer to finish now when an answer is in (#1450)."""
+    if not session.answered_count or not typer.confirm(
+        "Finish discovery now and generate the PRD from what's been answered?",
+        default=True,
+    ):
+        return False
+    session.finish_now()
+    return True
+
+
 def _handle_answer_attempts_exhausted(session, answers: "_AnswerSource", question: dict) -> bool:
     """React to MAX_ANSWER_ATTEMPTS rejections on one question (#1114).
 
-    Returns True to keep trying, False when the caller should stop.
+    Returns True to keep trying, False when the caller should stop. When it
+    finishes discovery instead (#1450), the session is complete on return and
+    the caller goes on to generate the PRD.
 
-    Non-interactive runs stop: a canned list that has desynchronised will not
-    resynchronise by being fed more of itself. Interactive runs are told what is
-    happening and offered the pause they would otherwise have to discover.
+    A canned --answers-file stops: a list that has desynchronised will not
+    resynchronise by being fed more of itself. Otherwise, once an answer has
+    been accepted, finishing is the better exit. Interactive runs are asked;
+    --brief-file finishes.
     """
     console.print(
         f"\n[yellow]That question has been answered {MAX_ANSWER_ATTEMPTS} times "
@@ -237,29 +277,22 @@ def _handle_answer_attempts_exhausted(session, answers: "_AnswerSource", questio
         )
         raise typer.Exit(1)
     if not answers.interactive:
-        # --brief-file: there is no list to desynchronise, so repeated rejection
-        # means the brief does not cover what is being asked.
-        console.print(
-            "[red]Error:[/red] giving up in non-interactive mode. The stand-in "
-            "answered from the brief five times without being accepted, which "
-            "usually means the brief does not cover what this question asks:\n\n"
-            f"  {escape(question.get('text', ''))}\n\n"
-            "Extend the brief to cover it, or run interactively."
-        )
-        raise typer.Exit(1)
+        return _finish_non_interactive(session, question)
 
     console.print(
         "[dim]Questions often have two parts; make sure the answer covers all of "
         "them. You can also type /pause to save and come back.[/dim]"
     )
-    if not typer.confirm("Keep trying this question?", default=True):
-        blocker_id = session.pause_discovery("Stuck on a question")
-        console.print("\n[green]✓[/green] Session paused")
-        console.print(
-            f"To resume: [cyan]cf prd generate --resume {blocker_id[:8]}[/cyan]"
-        )
-        return False
-    return True
+    if typer.confirm("Keep trying this question?", default=True):
+        return True
+    if _offer_finish(session):
+        return True
+    blocker_id = session.pause_discovery("Stuck on a question")
+    console.print("\n[green]✓[/green] Session paused")
+    console.print(
+        f"To resume: [cyan]cf prd generate --resume {blocker_id[:8]}[/cyan]"
+    )
+    return False
 
 
 def _load_answers_file(path: Path) -> list[str]:
@@ -1615,6 +1648,17 @@ def prd_generate(
             "survives a rejected answer."
         ),
     ),
+    max_questions: Optional[int] = typer.Option(
+        None,
+        "--max-questions",
+        min=1,
+        help=(
+            "Finish discovery after this many answers, for this run only "
+            "(like --template, repeat it on --resume). Set "
+            "discovery_max_questions in .codeframe/config.yaml to make it "
+            "stick; the default is 10."
+        ),
+    ),
 ) -> None:
     """Generate a PRD through AI-driven Socratic discovery.
 
@@ -1631,7 +1675,11 @@ def prd_generate(
     - Determines when enough information has been gathered
     - Generates the final PRD from the conversation
 
+    Discovery stops after --max-questions answers, or sooner once coverage
+    stops improving; areas still uncovered become open questions in the PRD.
+
     Special commands during discovery:
+      /done   - Finish now and generate the PRD from what's been answered
       /pause  - Save progress and exit (creates a blocker for resume)
       /quit   - Exit without saving
       /help   - Show available commands
@@ -1750,6 +1798,10 @@ def prd_generate(
                 console.print("\n[dim]Set the API key named above to use AI discovery.[/dim]")
                 raise typer.Exit(1)
 
+        if max_questions is not None:
+            session.max_questions = max_questions
+            session.complete_if_capped()
+
         console.print("\n[bold]Starting AI-driven PRD discovery...[/bold]")
         console.print("[dim]The AI will ask questions to understand your project.[/dim]")
         console.print("[dim]Type /help for available commands[/dim]\n")
@@ -1787,7 +1839,10 @@ def prd_generate(
             progress_bar = "█" * int(pct // 5)
             progress_empty = "░" * (20 - len(progress_bar))
 
-            console.print(f"[dim]Question {question['question_number']} | Coverage: {pct}%[/dim]")
+            console.print(
+                f"[dim]Question {question['question_number']} of at most "
+                f"{progress.get('max_questions')} | Coverage: {pct}%[/dim]"
+            )
             console.print(f"[dim]{progress_bar}{progress_empty}[/dim]\n")
 
             # Show question
@@ -1803,6 +1858,8 @@ def prd_generate(
                             session, answers, question
                         ):
                             return
+                        if session.is_complete():
+                            break
                         attempts = 1
 
                     answer = answers.ask(question["text"])
@@ -1814,12 +1871,22 @@ def prd_generate(
                     # Handle special commands
                     if answer.lower() == "/help":
                         console.print("\n[bold]Available commands:[/bold]")
+                        console.print("  /done   - Finish now and generate the PRD")
                         console.print("  /pause  - Save progress and exit")
                         console.print("  /quit   - Exit without saving")
                         console.print("  /help   - Show this help")
                         console.print()
                         continue
 
+                    if answer.lower() == "/done":
+                        if not session.answered_count:
+                            console.print(
+                                "[yellow]Answer at least one question before finishing.[/yellow]"
+                            )
+                            continue
+                        session.finish_now()
+                        break
+
                     if answer.lower() == "/quit":
                         if typer.confirm("Exit without saving?"):
                             console.print("Cancelled.")

{codeframe_ai-0.9.4 → codeframe_ai-0.9.5}/codeframe/core/adapters/streaming_chat.py

@@ -22,7 +22,13 @@ from enum import Enum
 from pathlib import Path
 from typing import AsyncIterator, Callable, Optional
 
-from codeframe.adapters.llm.base import LLMProvider, Tool, ToolCall, ToolResult
+from codeframe.adapters.llm.base import (
+    DEFAULT_PLANNING_MODEL,
+    LLMProvider,
+    Tool,
+    ToolCall,
+    ToolResult,
+)
 from codeframe.core.spend_limit import SpendLimitExceeded
 from codeframe.core.usage_recording import charge_budget, check_budget, mark_unrecorded
 from codeframe.lib.metrics_tracker import MetricsTracker
@@ -36,10 +42,11 @@ from codeframe.core.tools import (
 logger = logging.getLogger(__name__)
 
 # ---------------------------------------------------------------------------
-# Default model (matches DEFAULT_PLANNING_MODEL in base.py)
+# Default model: the planning default, so it moves with base.py instead of
+# drifting onto a retired ID (#1348)
 # ---------------------------------------------------------------------------
 
-_DEFAULT_MODEL = "claude-sonnet-4-5"
+_DEFAULT_MODEL = DEFAULT_PLANNING_MODEL
 
 # Maximum token budget for conversation history passed to the API.
 # claude-sonnet-4 context window is 200k; leave 20k for response headroom.

{codeframe_ai-0.9.4 → codeframe_ai-0.9.5}/codeframe/core/config.py

@@ -225,6 +225,9 @@ class EnvironmentConfig:
     # Settings page (issue #554) — UI-managed agent settings
     max_cost_usd: Optional[float] = None
 
+    # PRD discovery question cap (#1443); None means the default of 10.
+    discovery_max_questions: Optional[int] = None
+
     def validate(self) -> list[str]:
         """Validate configuration values.