codexspec 0.7.1__tar.gz → 0.7.3__tar.gz

{codexspec-0.7.1 → codexspec-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexspec
-Version: 0.7.1
+Version: 0.7.3
 Summary: CodexSpec - A Requirements-First SDD toolkit for Claude Code
 Project-URL: Homepage, https://github.com/Zts0hg/codexspec
 Project-URL: Repository, https://github.com/Zts0hg/codexspec
@@ -554,6 +554,7 @@ Implementation follows **conditional TDD workflow**:
 | `--set-document-lang`     | Set the document language    |
 | `--set-commit-lang`, `-c` | Set the commit-message language |
 | `--list-langs`            | List all supported languages |
+| `--auto-next`            | Toggle/set `workflow.auto_next` (bare toggles; or on/off) |
 
 </details>
 
@@ -677,6 +678,7 @@ codexspec config --set-lang zh-CN
 codexspec config --set-interaction-lang zh-CN
 codexspec config --set-document-lang en
 codexspec config --set-commit-lang en
+codexspec config --auto-next
 ```
 
 ### Supported Languages

{codexspec-0.7.1 → codexspec-0.7.3}/README.md

@@ -509,6 +509,7 @@ Implementation follows **conditional TDD workflow**:
 | `--set-document-lang`     | Set the document language    |
 | `--set-commit-lang`, `-c` | Set the commit-message language |
 | `--list-langs`            | List all supported languages |
+| `--auto-next`            | Toggle/set `workflow.auto_next` (bare toggles; or on/off) |
 
 </details>
 
@@ -632,6 +633,7 @@ codexspec config --set-lang zh-CN
 codexspec config --set-interaction-lang zh-CN
 codexspec config --set-document-lang en
 codexspec config --set-commit-lang en
+codexspec config --auto-next
 ```
 
 ### Supported Languages

{codexspec-0.7.1 → codexspec-0.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codexspec"
-version = "0.7.1"
+version = "0.7.3"
 description = "CodexSpec - A Requirements-First SDD toolkit for Claude Code"
 readme = "README.md"
 requires-python = ">=3.11"

{codexspec-0.7.1 → codexspec-0.7.3}/src/codexspec/__init__.py

@@ -173,6 +173,15 @@ def check() -> None:
     console.print(table)
 
 
+# workflow.auto_next toggle (used by the ``config --auto-next`` option).
+# Defined here because ``config()``'s ``flag_value`` default is evaluated at
+# function-definition time.
+_AUTO_NEXT_TRUE = {"on", "true", "1", "yes"}
+_AUTO_NEXT_FALSE = {"off", "false", "0", "no"}
+_AUTO_NEXT_SENTINEL = "__toggle__"
+_AUTO_NEXT_ACCEPTED = "on/off, true/false, 1/0, yes/no"
+
+
 @app.command()
 def config(
     set_lang: Optional[str] = typer.Option(
@@ -202,6 +211,16 @@ def config(
         "--list-langs",
         help="List all supported languages",
     ),
+    # ``--auto-next`` accepts an explicit value (on/off|true/false|1/0|yes/no).
+    # The bare form (toggle) is rewritten to ``--auto-next=<sentinel>`` by
+    # ``_normalize_auto_next_argv`` in ``main()``: Click 8.3 no longer honors
+    # ``flag_value`` for a bare optional-value option (it errors "requires an
+    # argument"), so the bare case is handled before Click parses.
+    auto_next: Optional[str] = typer.Option(
+        None,
+        "--auto-next",
+        help="Toggle workflow.auto_next (bare), or set it (on/off|true/false|1/0|yes/no).",
+    ),
 ) -> None:
     """
     View or modify CodexSpec project configuration.
@@ -213,6 +232,7 @@ def config(
         codexspec config                       # Show current configuration
         codexspec config --set-lang zh-CN      # Set language to Chinese
         codexspec config --set-commit-lang en  # Set commit messages to English
+        codexspec config --auto-next           # Toggle workflow.auto_next
         codexspec config --list-langs          # List supported languages
     """
     # Handle list languages
@@ -235,6 +255,25 @@ def config(
         console.print("Run [cyan]codexspec init[/cyan] to create a new project.")
         raise typer.Exit(1)
 
+    # Handle auto-next toggle/set
+    if auto_next is not None:
+        if auto_next == _AUTO_NEXT_SENTINEL:
+            target = not _read_auto_next(config_file)
+        else:
+            try:
+                target = parse_auto_next_value(auto_next)
+            except ValueError:
+                console.print(f"[red]Invalid --auto-next value:[/red] {auto_next!r}")
+                console.print(f"Accepted values: {_AUTO_NEXT_ACCEPTED} (or pass --auto-next bare to toggle).")
+                raise typer.Exit(1)
+        if _write_auto_next(config_file, target):
+            state = "enabled" if target else "disabled"
+            console.print(f"[green]auto_next {state}[/green] (workflow.auto_next = {str(target).lower()})")
+        else:
+            console.print("[red]Failed to update workflow.auto_next[/red]")
+            raise typer.Exit(1)
+        return
+
     # Handle set language
     if set_lang:
         normalized = normalize_locale(set_lang)
@@ -898,6 +937,111 @@ def _update_project_ai(config_file: Path, ai: str) -> None:
         return
 
 
+# --- workflow.auto_next toggle helpers -------------------------------------
+
+
+def parse_auto_next_value(raw: str) -> bool:
+    """Parse an explicit ``--auto-next`` value into a boolean.
+
+    Accepts ``on/off``, ``true/false``, ``1/0``, ``yes/no`` (case-insensitive,
+    surrounding whitespace ignored). Raises ``ValueError`` for any other token
+    so the caller can report the error and exit non-zero.
+    """
+    token = (raw or "").strip().lower()
+    if token in _AUTO_NEXT_TRUE:
+        return True
+    if token in _AUTO_NEXT_FALSE:
+        return False
+    raise ValueError(f"invalid --auto-next value: {raw!r}")
+
+
+def _read_auto_next(config_file: Path) -> bool:
+    """Return True only when ``workflow.auto_next`` is the literal ``true``.
+
+    An absent key/section, ``false``, or any malformed value is treated as
+    ``False`` — matching the runtime rule that only literal ``true`` enables
+    auto-next.
+    """
+    try:
+        content = config_file.read_text(encoding="utf-8")
+    except OSError:
+        return False
+    in_workflow = False
+    for line in content.splitlines():
+        if not line.strip():
+            continue
+        if not line[0].isspace():  # top-level key (or comment)
+            key = line.split("#", 1)[0].strip()
+            in_workflow = key == "workflow:"
+            continue
+        if in_workflow:
+            match = re.match(r"^\s*auto_next:\s*(\S+?)\s*(?:#.*)?$", line)
+            if match:
+                return match.group(1) == "true"
+    return False
+
+
+def _write_auto_next(config_file: Path, value: bool) -> bool:
+    """Set ``workflow.auto_next`` to an unquoted boolean.
+
+    Three cases: (1) the key exists under the ``workflow:`` section — update
+    the value in place; (2) the section exists but the key is absent — insert
+    ``auto_next: <bool>`` as its first child; (3) the section is absent —
+    append a ``workflow:`` section at the end of the file. All other lines and
+    comments are preserved; the inserted line is bare (no reconstructed
+    comment). Returns ``False`` on I/O error.
+    """
+    try:
+        content = config_file.read_text(encoding="utf-8")
+    except OSError:
+        return False
+
+    token = "true" if value else "false"
+    lines = content.split("\n")
+
+    workflow_idx: Optional[int] = None
+    in_workflow = False
+    for i, line in enumerate(lines):
+        if not line.strip():
+            continue
+        if not line[0].isspace():
+            key = line.split("#", 1)[0].strip()
+            in_workflow = key == "workflow:"
+            if in_workflow:
+                workflow_idx = i
+            continue
+        if in_workflow and re.match(r"^\s*auto_next:\s*\S+", line):
+            indent = line[: len(line) - len(line.lstrip())]
+            lines[i] = f"{indent}auto_next: {token}"
+            return _dump_lines(config_file, lines)
+
+    if workflow_idx is not None:
+        lines.insert(workflow_idx + 1, f"  auto_next: {token}")
+        return _dump_lines(config_file, lines)
+
+    section = f"workflow:\n  auto_next: {token}"
+    if not content:
+        new_content = section + "\n"
+    elif content.endswith("\n"):
+        new_content = content + "\n" + section + "\n"
+    else:
+        new_content = content + "\n\n" + section + "\n"
+    try:
+        config_file.write_text(new_content, encoding="utf-8")
+    except OSError:
+        return False
+    return True
+
+
+def _dump_lines(path: Path, lines: list[str]) -> bool:
+    """Write ``lines`` joined by newlines; return False on I/O error."""
+    try:
+        path.write_text("\n".join(lines), encoding="utf-8")
+    except OSError:
+        return False
+    return True
+
+
 def _next_step_start(integration_keys: set[str], language: str) -> str:
     """Return a target-aware start instruction."""
     if integration_keys == {"codex"}:
@@ -1295,8 +1439,38 @@ The following slash commands are available in this project:
 """
 
 
+def _normalize_auto_next_argv(argv: list[str]) -> list[str]:
+    """Rewrite a bare ``--auto-next`` into ``--auto-next=<sentinel>``.
+
+    Click 8.3 no longer honors ``flag_value`` for a bare optional-value option
+    (it errors "requires an argument"). To preserve ``codexspec config
+    --auto-next`` (bare) as a toggle, a standalone ``--auto-next`` token — one
+    that is not already in ``--auto-next=...`` form and is not followed by a
+    value token — is rewritten to ``--auto-next=<sentinel>``, which the
+    ``config`` handler interprets as a toggle.
+    """
+    out: list[str] = []
+    i = 0
+    while i < len(argv):
+        tok = argv[i]
+        if tok == "--auto-next":
+            nxt = argv[i + 1] if i + 1 < len(argv) else None
+            if nxt is None or nxt.startswith("-"):
+                out.append(f"--auto-next={_AUTO_NEXT_SENTINEL}")
+            else:
+                out.append(tok)
+                out.append(nxt)
+                i += 1
+        else:
+            out.append(tok)
+        i += 1
+    return out
+
+
 def main() -> None:
     """Main entry point for the CLI."""
+    if "--auto-next" in sys.argv:
+        sys.argv = _normalize_auto_next_argv(sys.argv)
     app()
 
 

{codexspec-0.7.1 → codexspec-0.7.3}/templates/commands/config.md

@@ -104,6 +104,7 @@ Display the configuration as in Step 2, then exit.
       {"label": "Document language", "description": "Language for generated artifact files (requirements/spec/plan/tasks) (currently: {current value})"},
       {"label": "Output language (legacy)", "description": "Fallback language used when interaction/document are not set (currently: {current value})"},
       {"label": "Commit language", "description": "Language for commit messages (currently: {current value})"},
+      {"label": "Auto-next chain", "description": "Auto-advance the SDD pipeline once a stage passes (workflow.auto_next) (currently: {current value})"},
       {"label": "Back", "description": "Return to main menu"}
     ]
   }]
@@ -127,9 +128,32 @@ Display the configuration as in Step 2, then exit.
 }
 ```
 
-3. Update the configuration file with the new value
-4. Display the updated configuration
-5. Exit
+3. For "Auto-next chain", ask whether to enable or disable:
+
+```json
+{
+  "questions": [{
+    "question": "Set workflow.auto_next:",
+    "header": "Auto-next",
+    "options": [
+      {"label": "Enable", "description": "Auto-advance the SDD pipeline once a stage passes"},
+      {"label": "Disable", "description": "Do not auto-advance; advance to the next command manually"},
+      {"label": "Back", "description": "Return without changing"}
+    ]
+  }]
+}
+```
+
+   Then read `.codexspec/config.yml`. The current value is enabled only when
+   `workflow.auto_next` is the literal `true`; an absent key/section, `false`,
+   or any other value is disabled. Write `workflow.auto_next` as an unquoted
+   `true`/`false` (update the value in place when the key exists; otherwise add
+   a `workflow:` section with `auto_next: <bool>`), preserving every other
+   line and comment.
+
+4. Update the configuration file with the new value
+5. Display the updated configuration
+6. Exit
 
 #### Option: Reset to defaults
 

{codexspec-0.7.1 → codexspec-0.7.3}/templates/commands/generate-spec.md

@@ -95,6 +95,17 @@ Invoke `/codexspec:review-spec <feature-dir>/spec.md` after saving.
 - Run a maximum of two automatic fix-and-review rounds.
 - If defects remain, the same defect repeats, or remediation requires a user decision, stop and report the evidence.
 
+## Auto-Next Chain Advance
+
+Read `workflow.auto_next` from `.codexspec/config.yml` (default `false`; only the literal value `true` enables it — absent, `false`, or any other value means disabled).
+
+When `workflow.auto_next` is `true` AND the Automatic Review Loop above concluded in a passing state — the final Overall Status is `PASS` or `PASS_WITH_WARNINGS` — advance the chain automatically:
+
+1. Emit exactly one notice line, in the interaction language, e.g. `auto_next: review passed → invoking /codexspec:spec-to-plan <feature-dir>`.
+2. Invoke `/codexspec:spec-to-plan <feature-dir>` exactly once, then end this command.
+
+Do not auto-advance when `workflow.auto_next` is disabled, or the review loop stopped at `NEEDS_REVISION` or `BLOCKED`, or stopped early per the conditions above; in those cases hand control back to the user exactly as the review loop already does. This advances the chain and does not modify the Output Summary.
+
 ## Output Summary
 
 Report:

{codexspec-0.7.1 → codexspec-0.7.3}/templates/commands/plan-to-tasks.md

@@ -102,6 +102,17 @@ When the review loop above concludes in a passing state — the final `/codexspe
 - analyze's results are informational only. They do not change whether tasks are ready for implementation and do not add a gate before `/codexspec:implement-tasks`.
 - Do not modify the Output Summary for analyze, and do not save an additional analyze report file; analyze's own output is the report.
 
+## Auto-Next Chain Advance
+
+Read `workflow.auto_next` from `.codexspec/config.yml` (default `false`; only the literal value `true` enables it).
+
+When `workflow.auto_next` is `true` AND the review loop above concluded in a passing state (`PASS` or `PASS_WITH_WARNINGS`) — after the analyze step above has run — advance the chain automatically:
+
+1. Emit exactly one notice line, in the interaction language, e.g. `auto_next: review passed → invoking /codexspec:implement-tasks <feature-dir>`.
+2. Invoke `/codexspec:implement-tasks <feature-dir>` exactly once, with no confirmation prompt, then end this command.
+
+analyze's findings are informational only and do NOT block this advance (see the Automatic Cross-Artifact Analysis section above). Do not auto-advance when `workflow.auto_next` is disabled, or the review loop stopped at `NEEDS_REVISION` or `BLOCKED`, or stopped early; hand control back to the user as the review loop already does. This advances the chain and does not modify the Output Summary.
+
 ## Output Summary
 
 Report the tasks path, plan/requirement coverage, dependency summary, unresolved items, and auto-review status.

{codexspec-0.7.1 → codexspec-0.7.3}/templates/commands/spec-to-plan.md

@@ -101,6 +101,17 @@ Invoke `/codexspec:review-plan <feature-dir>/plan.md`.
 - Run a maximum of two automatic fix-and-review rounds.
 - Stop if a defect repeats, remains unresolved, or requires a user decision.
 
+## Auto-Next Chain Advance
+
+Read `workflow.auto_next` from `.codexspec/config.yml` (default `false`; only the literal value `true` enables it — absent, `false`, or any other value means disabled).
+
+When `workflow.auto_next` is `true` AND the Automatic Review Loop above concluded in a passing state — the final Overall Status is `PASS` or `PASS_WITH_WARNINGS` — advance the chain automatically:
+
+1. Emit exactly one notice line, in the interaction language, e.g. `auto_next: review passed → invoking /codexspec:plan-to-tasks <feature-dir>`.
+2. Invoke `/codexspec:plan-to-tasks <feature-dir>` exactly once, then end this command.
+
+Do not auto-advance when `workflow.auto_next` is disabled, or the review loop stopped at `NEEDS_REVISION` or `BLOCKED`, or stopped early per the conditions above; in those cases hand control back to the user exactly as the review loop already does. This advances the chain and does not modify the Output Summary.
+
 ## Output Summary
 
 Report the plan path, requirement coverage, plan-level decisions, unresolved items, and auto-review status.

{codexspec-0.7.1 → codexspec-0.7.3}/templates/commands/specify.md

@@ -107,3 +107,14 @@ Report:
 - Confirmed IDs
 - Open IDs and whether they block specification generation
 - Next command: `/codexspec:generate-spec <feature-dir>`
+
+## Auto-Next Chain Advance
+
+Read `workflow.auto_next` from `.codexspec/config.yml` (default `false`; only the literal value `true` enables it).
+
+When `workflow.auto_next` is `true` AND discovery is complete — the Completion criteria above are met and the user has explicitly confirmed the final stage summary (not each intermediate topic confirmation) — advance the chain automatically:
+
+1. Emit exactly one notice line, in the interaction language, e.g. `auto_next: requirements confirmed → invoking /codexspec:generate-spec <feature-dir>`.
+2. Invoke `/codexspec:generate-spec <feature-dir>` exactly once, then end this command.
+
+Do not auto-advance on intermediate topic confirmations, or when `workflow.auto_next` is disabled (absent, `false`, or non-`true`); in those cases report normally and hand off to the next command manually. This advances the chain and does not modify the Completion report.