0.2.1b5

.github/workflows/ci.yml

@@ -100,7 +100,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/release.yml

@@ -205,9 +205,12 @@ jobs:
           # Ensure fork exists (no-op if already forked)
           gh repo fork Azure/azure-cli-extensions --clone=false || true
 
-          # Clone the fork via gh (handles auth automatically)
+          # Sync fork's main with upstream so we have the latest index/service files
           GH_USER=$(gh api user -q .login)
           echo "Fork owner: $GH_USER"
+          gh repo sync "${GH_USER}/azure-cli-extensions" --source Azure/azure-cli-extensions --branch main --force
+
+          # Clone the fork via gh (handles auth automatically)
           gh repo clone "${GH_USER}/azure-cli-extensions" azure-cli-extensions -- --depth 1
 
           # Add upstream for PR targeting

.github/workflows/repostats.yml

@@ -0,0 +1,16 @@
+on:
+  schedule:
+    # Run this once per day, towards the end of the day for keeping the most
+    # recent data point most meaningful (hours are interpreted in UTC).
+    - cron: "0 23 * * *"
+  workflow_dispatch: # Allow for running this manually.
+
+jobs:
+  j1:
+    name: repostats-for-nice-project
+    runs-on: ubuntu-latest
+    steps:
+      - name: run-ghrs
+        uses: jgehrcke/github-repo-stats@RELEASE
+        with:
+          ghtoken: ${{ secrets.STATS_GITHUB_TOKEN }}

HISTORY.rst

@@ -3,6 +3,111 @@
 Release History
 ===============
 
+0.2.1b5
++++++++
+
+Backlog enrichment
+~~~~~~~~~~~~~~~~~~~
+* **Enriched backlog with full project context** — ``generate backlog``
+  now loads build stages, deploy status, cost analysis, and stage
+  completion (same context as spec-kit) for richer item generation.
+* **Completed work items** — items for already-built/deployed stages are
+  generated with ``status: done`` and grouped under a "Completed POC Work"
+  epic, with tasks marked as done.
+* **Production Readiness epic** — dedicated epic for POC-to-production
+  work (SKU upgrades, networking, CI/CD, monitoring, DR), separate from
+  generic "Deferred / Future Work".
+* **Azure DevOps hierarchy** — generation prompt requests Feature → User
+  Story → Task structure with ``children[]``; push code now creates Task
+  work items linked to their parent User Story.
+* **Dict task format** — tasks can be ``{"title": "...", "done": true}``
+  objects; GitHub issues render completed tasks as ``[x]``, DevOps
+  descriptions show checkbox markers.  String tasks remain supported.
+
+Spec-kit enrichment
+~~~~~~~~~~~~~~~~~~~~
+* **Enriched spec-kit with full project context** — ``generate speckit``
+  now loads discovery state, build stages, deploy status, cost analysis,
+  and stage completion to populate templates with real project data.
+* **Per-template prompt overrides** — each spec-kit template gets a
+  tailored AI prompt that tells the doc-agent exactly which context
+  sections to use and what output format to produce.
+* **production.md** — new template covering POC-to-production guidance:
+  SKU upgrades, networking, CI/CD, monitoring, DR, load testing, and
+  estimated production costs.
+* **Restructured tasks.md** — tasks now map 1:1 to build/deploy stages
+  with status markers: ``[x]`` completed, ``[!]`` failed, ``[ ]`` pending.
+  Added Phase 6 (Production Readiness) for hardening tasks.
+
+Init improvements
+~~~~~~~~~~~~~~~~~~
+* **Removed eager directory creation from init** — ``concept/apps/``,
+  ``concept/infra/`` (terraform/, bicep/), and ``concept/db/`` (sql/,
+  cosmos/, databricks/, fabric/) are no longer created during
+  ``az prototype init``.  These directories are now created on demand
+  by the build stage only when they are actually needed.
+* **Fixed --output-dir nesting** — ``--output-dir ./my-output`` now
+  uses the specified directory as the project root instead of creating
+  a ``name/`` subdirectory inside it.
+* **Fixed "Next: cd ..." hint** — the summary panel now shows the
+  actual project directory name instead of always displaying the
+  ``--name`` value.
+* **--json flag on all commands** — added ``json_output`` parameter to
+  every command function so the global ``--json`` / ``-j`` flag is
+  accepted on all 24 commands (previously only 3 accepted it).
+* **Naming env/zone_id derived from --environment** — ``naming.env``
+  and ``naming.zone_id`` in ``prototype.yaml`` now reflect the chosen
+  environment (dev→dev/zd, staging→stg/zs, prod→prd/zp) instead of
+  always defaulting to ``dev``/``zd``.
+
+TUI stage tree fix
+~~~~~~~~~~~~~~~~~~
+* **Fixed stage tree showing completed checkmark for unstarted stages** —
+  when launching with ``--stage design`` from an init-only project, the
+  Design stage now correctly shows as in-progress (●) instead of
+  completed (✓).  Stage status is now derived from detected state files,
+  not the target stage.
+* **Stage skip guard** — ``--stage deploy`` from an init-only project
+  now prints a warning and falls back to the next valid stage (e.g.
+  design) instead of allowing users to skip ahead.
+* **Consistent "no project" error message** — all commands now show the
+  same red ``CLIError`` message when ``prototype.yaml`` is missing:
+  *"No prototype project found. Run 'az prototype init'."*
+* **Replaced ``--output-format`` with ``--table`` / ``--report``** — the
+  ``analyze costs`` command shows the cost summary table by default,
+  ``--table`` shows the summary without saving a file, ``--report``
+  shows the full detailed report, and ``--json`` returns raw JSON.
+  The ``generate backlog`` command uses ``--table`` instead of
+  ``--output-format``.
+* **``--json`` on cost analysis returns full content** — ``--json`` now
+  suppresses console output and returns a structured JSON dict with the
+  full cost report in the ``content`` field for machine consumption.
+* **``generate docs`` default output moved to ``concept/docs/``** —
+  documentation is now generated alongside other concept artifacts
+  instead of a separate ``docs/`` directory at the project root.
+* **Normalized path separators in generate output** — displayed paths
+  now use forward slashes on all platforms instead of mixed separators
+  on Windows.  Also handles cross-mount ``--path`` values (e.g.
+  ``Y:\output`` from a ``\\Mac\projects`` project) without crashing.
+* **Spec-kit generates its own templates** — ``generate speckit`` now
+  produces spec-kit-specific files (``constitution.md``, ``spec.md``,
+  ``plan.md``, ``tasks.md``) aligned with the `spec-kit
+  <https://github.com/github/spec-kit>`_ format instead of duplicating
+  the documentation templates.
+
+TUI post-design improvements
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* **Removed CLI "Next steps" from TUI** — the ``az prototype`` CLI
+  commands block is no longer printed into the TUI console after
+  architecture generation; replaced with a continuation prompt.
+* **"continue" launches build** — typing ``continue`` after design
+  completes now starts the build stage, matching the prompt text.
+* **Reduced console noise** — removed extra blank lines between
+  "Planning...", "Generating architecture...", and feasibility
+  check messages in the TUI output.
+* **Feasibility wording** — changed "Reviewing {iac} feasibility..."
+  to "Confirming {iac} feasibility..." and removed the arrow prefix.
+
 0.2.1b4
 +++++++
 

azext_prototype/_help.py

@@ -214,10 +214,14 @@
     the command returns the cached result unless the design context has
     changed. Use --refresh to force a fresh analysis.
 examples:
-    - name: Generate cost estimate
+    - name: Show cost summary table (default)
       text: az prototype analyze costs
-    - name: Get costs in JSON format
-      text: az prototype analyze costs --output-format json
+    - name: Show cost summary table only (no file save)
+      text: az prototype analyze costs --table
+    - name: Show full detailed cost report
+      text: az prototype analyze costs --report
+    - name: Get costs as JSON
+      text: az prototype analyze costs --json
     - name: Force fresh analysis (bypass cache)
       text: az prototype analyze costs --refresh
 """

azext_prototype/_params.py

@@ -236,10 +236,16 @@ def load_arguments(self, _):
 
     with self.argument_context("prototype analyze costs") as c:
         c.argument(
-            "output_format",
-            arg_type=get_enum_type(["table", "json", "markdown"]),
-            help="Output format for the cost report.",
-            default="markdown",
+            "table",
+            action="store_true",
+            default=False,
+            help="Display only the cost summary table.",
+        )
+        c.argument(
+            "report",
+            action="store_true",
+            default=False,
+            help="Display the full detailed cost report.",
         )
         c.argument(
             "refresh",
@@ -259,10 +265,10 @@ def load_arguments(self, _):
         c.argument("org", help="Organization or owner name (GitHub org/user or Azure DevOps org).")
         c.argument("project", help="Project name (Azure DevOps project or GitHub repo).")
         c.argument(
-            "output_format",
-            arg_type=get_enum_type(["table", "json", "markdown"]),
-            help="Output format for the backlog.",
-            default="markdown",
+            "table",
+            action="store_true",
+            default=False,
+            help="Display backlog as a table instead of markdown.",
         )
         c.argument(
             "quick",

azext_prototype/azext_metadata.json

@@ -2,7 +2,7 @@
   "azext.isPreview": true,
   "azext.minCliCoreVersion": "2.50.0",
   "name": "prototype",
-  "version": "0.2.1b4",
+  "version": "0.2.1b5",
   "azext.summary": "Azure CLI extension for building rapid prototypes with GitHub Copilot.",
   "license": "MIT",
   "classifiers": [