specfact-cli 0.26.7__tar.gz → 0.26.8__tar.gz

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.26.7
+Version: 0.26.8
 Summary: Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts. Automate legacy code documentation and prevent modernization regressions.
 Project-URL: Homepage, https://github.com/nold-ai/specfact-cli
 Project-URL: Repository, https://github.com/nold-ai/specfact-cli.git
@@ -238,6 +238,7 @@ Requires-Dist: opentelemetry-sdk>=1.27.0
 Requires-Dist: pydantic>=2.12.3
 Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.0.1
 Requires-Dist: requests>=2.32.3
 Requires-Dist: rich<13.6.0,>=13.5.2
 Requires-Dist: ruamel-yaml>=0.18.16
@@ -450,21 +451,26 @@ specfact validate sidecar run my-project /path/to/repo
 - **Agile/scrum ready** - DoR checklists, story points, dependencies
 - **Backlog standardization** 🆕 - Template-driven refinement with persona/framework filtering
 - **Sprint/iteration filtering** 🆕 - Filter by sprint, release, iteration for agile workflows
+- **Interactive field mapping** 🆕 - Discover and map Azure DevOps fields with arrow-key navigation
+- **Azure DevOps integration** 🆕 - Full support for ADO work items with automatic token resolution
 
 👉 **[Agile/Scrum Workflows](docs/guides/agile-scrum-workflows.md)** - Team collaboration guide  
-👉 **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 - Standardize backlog items with templates
+👉 **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 - Standardize backlog items with templates  
+👉 **[Custom Field Mapping](docs/guides/custom-field-mapping.md)** 🆕 - Map ADO fields interactively
 
 ### 🔌 Integrations
 
 - **VS Code, Cursor** - Catch bugs before you commit
 - **GitHub Actions** - Automated quality gates
 - **AI IDEs** - Generate prompts for fixing gaps
-- **DevOps tools** - Sync with GitHub Issues, Linear, Jira
+- **DevOps tools** - Sync with GitHub Issues, Azure DevOps, Linear, Jira
 - **Backlog Refinement** 🆕 - AI-assisted template-driven refinement for standardizing work items
+- **Azure DevOps field mapping** 🆕 - Interactive field discovery and mapping for custom ADO process templates
 - **Spec-Kit, OpenSpec, Specmatic** - Works with your existing tools
 
 👉 **[Integrations Overview](docs/guides/integrations-overview.md)** - All integration options  
-👉 **[Backlog Refinement Guide](docs/guides/backlog-refinement.md)** 🆕 **NEW** - Template-driven backlog standardization
+👉 **[Backlog Refinement Guide](docs/guides/backlog-refinement.md)** 🆕 **NEW** - Template-driven backlog standardization  
+👉 **[Custom Field Mapping](docs/guides/custom-field-mapping.md)** 🆕 **NEW** - Interactive ADO field mapping
 
 ---
 
@@ -529,8 +535,9 @@ specfact validate sidecar run my-project /path/to/repo
 - **[Spec-Kit Journey](docs/guides/speckit-journey.md)** - From Spec-Kit to SpecFact
 - **[OpenSpec Journey](docs/guides/openspec-journey.md)** - OpenSpec integration
 - **[Specmatic Integration](docs/guides/specmatic-integration.md)** - API contract testing
-- **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Linear, Jira
+- **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Azure DevOps, Linear, Jira
 - **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 **NEW** - AI-assisted template-driven backlog standardization
+- **[Custom Field Mapping](docs/guides/custom-field-mapping.md)** 🆕 **NEW** - Interactive Azure DevOps field mapping
 
 👉 **[Full Documentation Index](docs/README.md)** - Browse all documentation  
 👉 **[Online Documentation](https://docs.specfact.io/)** - Complete documentation site

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/README.md

@@ -173,21 +173,26 @@ specfact validate sidecar run my-project /path/to/repo
 - **Agile/scrum ready** - DoR checklists, story points, dependencies
 - **Backlog standardization** 🆕 - Template-driven refinement with persona/framework filtering
 - **Sprint/iteration filtering** 🆕 - Filter by sprint, release, iteration for agile workflows
+- **Interactive field mapping** 🆕 - Discover and map Azure DevOps fields with arrow-key navigation
+- **Azure DevOps integration** 🆕 - Full support for ADO work items with automatic token resolution
 
 👉 **[Agile/Scrum Workflows](docs/guides/agile-scrum-workflows.md)** - Team collaboration guide  
-👉 **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 - Standardize backlog items with templates
+👉 **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 - Standardize backlog items with templates  
+👉 **[Custom Field Mapping](docs/guides/custom-field-mapping.md)** 🆕 - Map ADO fields interactively
 
 ### 🔌 Integrations
 
 - **VS Code, Cursor** - Catch bugs before you commit
 - **GitHub Actions** - Automated quality gates
 - **AI IDEs** - Generate prompts for fixing gaps
-- **DevOps tools** - Sync with GitHub Issues, Linear, Jira
+- **DevOps tools** - Sync with GitHub Issues, Azure DevOps, Linear, Jira
 - **Backlog Refinement** 🆕 - AI-assisted template-driven refinement for standardizing work items
+- **Azure DevOps field mapping** 🆕 - Interactive field discovery and mapping for custom ADO process templates
 - **Spec-Kit, OpenSpec, Specmatic** - Works with your existing tools
 
 👉 **[Integrations Overview](docs/guides/integrations-overview.md)** - All integration options  
-👉 **[Backlog Refinement Guide](docs/guides/backlog-refinement.md)** 🆕 **NEW** - Template-driven backlog standardization
+👉 **[Backlog Refinement Guide](docs/guides/backlog-refinement.md)** 🆕 **NEW** - Template-driven backlog standardization  
+👉 **[Custom Field Mapping](docs/guides/custom-field-mapping.md)** 🆕 **NEW** - Interactive ADO field mapping
 
 ---
 
@@ -252,8 +257,9 @@ specfact validate sidecar run my-project /path/to/repo
 - **[Spec-Kit Journey](docs/guides/speckit-journey.md)** - From Spec-Kit to SpecFact
 - **[OpenSpec Journey](docs/guides/openspec-journey.md)** - OpenSpec integration
 - **[Specmatic Integration](docs/guides/specmatic-integration.md)** - API contract testing
-- **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Linear, Jira
+- **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Azure DevOps, Linear, Jira
 - **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 **NEW** - AI-assisted template-driven backlog standardization
+- **[Custom Field Mapping](docs/guides/custom-field-mapping.md)** 🆕 **NEW** - Interactive Azure DevOps field mapping
 
 👉 **[Full Documentation Index](docs/README.md)** - Browse all documentation  
 👉 **[Online Documentation](https://docs.specfact.io/)** - Complete documentation site

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.26.7"
+version = "0.26.8"
 description = "Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts. Automate legacy code documentation and prevent modernization regressions."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -37,6 +37,7 @@ dependencies = [
     # CLI framework
     "typer>=0.20.0",
     "rich>=13.5.2,<13.6.0",  # Compatible with semgrep (requires rich~=13.5.2)
+    "questionary>=2.0.1",  # Interactive prompts with arrow key navigation
     
     # Template engine
     "jinja2>=3.1.6",

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/resources/templates/backlog/field_mappings/ado_agile.yaml

@@ -7,6 +7,7 @@ framework: agile
 field_mappings:
   System.Description: description
   System.AcceptanceCriteria: acceptance_criteria
+  Microsoft.VSTS.Common.AcceptanceCriteria: acceptance_criteria  # Alternative field name
   Microsoft.VSTS.Scheduling.StoryPoints: story_points
   Microsoft.VSTS.Common.BusinessValue: business_value
   Microsoft.VSTS.Common.Priority: priority

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/resources/templates/backlog/field_mappings/ado_default.yaml

@@ -7,6 +7,7 @@ framework: default
 field_mappings:
   System.Description: description
   System.AcceptanceCriteria: acceptance_criteria
+  Microsoft.VSTS.Common.AcceptanceCriteria: acceptance_criteria  # Alternative field name
   Microsoft.VSTS.Common.StoryPoints: story_points
   Microsoft.VSTS.Scheduling.StoryPoints: story_points
   Microsoft.VSTS.Common.BusinessValue: business_value

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/resources/templates/backlog/field_mappings/ado_kanban.yaml

@@ -7,6 +7,7 @@ framework: kanban
 field_mappings:
   System.Description: description
   System.AcceptanceCriteria: acceptance_criteria
+  Microsoft.VSTS.Common.AcceptanceCriteria: acceptance_criteria  # Alternative field name
   Microsoft.VSTS.Common.Priority: priority
   System.WorkItemType: work_item_type
   System.State: state

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/resources/templates/backlog/field_mappings/ado_safe.yaml

@@ -8,6 +8,7 @@ framework: safe
 field_mappings:
   System.Description: description
   System.AcceptanceCriteria: acceptance_criteria
+  Microsoft.VSTS.Common.AcceptanceCriteria: acceptance_criteria  # Alternative field name
   Microsoft.VSTS.Scheduling.StoryPoints: story_points
   Microsoft.VSTS.Common.BusinessValue: business_value
   Microsoft.VSTS.Common.Priority: priority

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/resources/templates/backlog/field_mappings/ado_scrum.yaml

@@ -7,6 +7,7 @@ framework: scrum
 field_mappings:
   System.Description: description
   System.AcceptanceCriteria: acceptance_criteria
+  Microsoft.VSTS.Common.AcceptanceCriteria: acceptance_criteria  # Alternative field name
   Microsoft.VSTS.Scheduling.StoryPoints: story_points
   Microsoft.VSTS.Common.BusinessValue: business_value
   Microsoft.VSTS.Common.Priority: priority

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/src/specfact_cli/__init__.py

@@ -9,6 +9,6 @@ This package provides command-line tools for:
 - Validating reproducibility
 """
 
-__version__ = "0.26.7"
+__version__ = "0.26.8"
 
 __all__ = ["__version__"]

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/src/specfact_cli/adapters/ado.py

@@ -3067,8 +3067,19 @@ class AdoAdapter(BridgeAdapter, BacklogAdapterMixin, BacklogAdapter):
         ado_fields = ado_mapper.map_from_canonical(canonical_fields)
 
         # Get reverse mapping to find ADO field names for canonical fields
+        # Use same preference logic as map_from_canonical: prefer System.* over Microsoft.VSTS.Common.*
         field_mappings = ado_mapper._get_field_mappings()
-        reverse_mappings = {v: k for k, v in field_mappings.items()}
+        reverse_mappings: dict[str, str] = {}
+        for ado_field, canonical in field_mappings.items():
+            if canonical not in reverse_mappings:
+                # First mapping for this canonical field - use it
+                reverse_mappings[canonical] = ado_field
+            else:
+                # Multiple mappings exist - prefer System.* over Microsoft.VSTS.Common.*
+                current_ado_field = reverse_mappings[canonical]
+                # Prefer System.* fields for write operations (more common in Scrum)
+                if ado_field.startswith("System.") and not current_ado_field.startswith("System."):
+                    reverse_mappings[canonical] = ado_field
 
         # Update description (body_markdown) - always use System.Description
         if update_fields is None or "body" in update_fields or "body_markdown" in update_fields:

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/src/specfact_cli/backlog/converter.py

@@ -220,9 +220,27 @@ def convert_ado_work_item_to_backlog_item(
     assigned_to = fields.get("System.AssignedTo", {})
     if assigned_to:
         if isinstance(assigned_to, dict):
-            assignees = [assigned_to.get("displayName", assigned_to.get("uniqueName", ""))]
+            # Extract all available identifiers (displayName, uniqueName, mail) for flexible filtering
+            # This allows filtering to work with any of these identifiers as mentioned in help text
+            # Priority order: displayName (for display) > uniqueName > mail
+            assignee_candidates = []
+            if assigned_to.get("displayName"):
+                assignee_candidates.append(assigned_to["displayName"].strip())
+            if assigned_to.get("uniqueName"):
+                assignee_candidates.append(assigned_to["uniqueName"].strip())
+            if assigned_to.get("mail"):
+                assignee_candidates.append(assigned_to["mail"].strip())
+
+            # Remove duplicates while preserving order (displayName first)
+            seen = set()
+            for candidate in assignee_candidates:
+                if candidate and candidate not in seen:
+                    assignees.append(candidate)
+                    seen.add(candidate)
         else:
-            assignees = [str(assigned_to)]
+            assignee_str = str(assigned_to).strip()
+            if assignee_str:
+                assignees = [assignee_str]
 
     tags = []
     ado_tags = fields.get("System.Tags", "")

{specfact_cli-0.26.7 → specfact_cli-0.26.8}/src/specfact_cli/backlog/mappers/ado_mapper.py

@@ -32,6 +32,7 @@ class AdoFieldMapper(FieldMapper):
     DEFAULT_FIELD_MAPPINGS = {
         "System.Description": "description",
         "System.AcceptanceCriteria": "acceptance_criteria",
+        "Microsoft.VSTS.Common.AcceptanceCriteria": "acceptance_criteria",  # Alternative field name
         "Microsoft.VSTS.Common.StoryPoints": "story_points",
         "Microsoft.VSTS.Scheduling.StoryPoints": "story_points",  # Alternative field name
         "Microsoft.VSTS.Common.BusinessValue": "business_value",
@@ -146,6 +147,9 @@ class AdoFieldMapper(FieldMapper):
         """
         Map canonical fields back to ADO field format.
 
+        When multiple ADO fields map to the same canonical field, prefers System.* fields
+        over Microsoft.VSTS.Common.* fields for better compatibility with Scrum templates.
+
         Args:
             canonical_fields: Dict of canonical field names to values
 
@@ -155,8 +159,19 @@ class AdoFieldMapper(FieldMapper):
         # Use custom mapping if available, otherwise use defaults
         field_mappings = self._get_field_mappings()
 
-        # Reverse mapping: canonical -> ADO field name
-        reverse_mappings = {v: k for k, v in field_mappings.items()}
+        # Build reverse mapping with preference for System.* fields over Microsoft.VSTS.Common.*
+        # This ensures write operations use the more common System.* fields (better Scrum compatibility)
+        reverse_mappings: dict[str, str] = {}
+        for ado_field, canonical in field_mappings.items():
+            if canonical not in reverse_mappings:
+                # First mapping for this canonical field - use it
+                reverse_mappings[canonical] = ado_field
+            else:
+                # Multiple mappings exist - prefer System.* over Microsoft.VSTS.Common.*
+                current_ado_field = reverse_mappings[canonical]
+                # Prefer System.* fields for write operations (more common in Scrum)
+                if ado_field.startswith("System.") and not current_ado_field.startswith("System."):
+                    reverse_mappings[canonical] = ado_field
 
         ado_fields: dict[str, Any] = {}
 
@@ -195,6 +210,10 @@ class AdoFieldMapper(FieldMapper):
         """
         Extract field value from ADO fields dict using mapping.
 
+        Supports multiple field name alternatives for the same canonical field.
+        Checks all ADO fields that map to the canonical field and returns the first found value.
+        Priority: custom mapping > default mapping (handled by _get_field_mappings merge order).
+
         Args:
             fields_dict: ADO fields dict
             field_mappings: Field mappings (ADO field name -> canonical field name)
@@ -203,7 +222,8 @@ class AdoFieldMapper(FieldMapper):
         Returns:
             Field value or None if not found
         """
-        # Find ADO field name for this canonical field
+        # Find all ADO field names that map to this canonical field
+        # Check all alternatives and return the first found value
         for ado_field, canonical in field_mappings.items():
             if canonical == canonical_field:
                 value = fields_dict.get(ado_field)