Pre-Deployment App Graph with Git Integration

.specify/memory/constitution.md

@@ -1,6 +1,6 @@
 <!--
 Sync Impact Report
-- Version change: 1.0.0 -> 1.1.0
+- Version change: 1.1.0 -> 1.2.0
 - Modified principles: none
 - Added sections:
   - Project Structure (multi-repository overview)
@@ -399,4 +399,4 @@ For day-to-day development guidance beyond this constitution, refer to:
 - [Developer guides](https://github.com/radius-project/radius/tree/main/docs/contributing) for detailed technical instructions
 - [Code organization guide](https://github.com/radius-project/radius/blob/main/docs/contributing/contributing-code/contributing-code-organization/README.md) for repository structure
 
-**Version**: 1.1.0 | **Ratified**: 2025-11-06 | **Last Amended**: 2026-01-30
+**Version**: 1.2.0 | **Ratified**: 2025-11-06 | **Last Amended**: 2026-01-30

specs/001-git-app-graph-preview/checklists/requirements.md

@@ -0,0 +1,57 @@
+# Specification Quality Checklist: Git App Graph Preview
+
+**Purpose**: Validate specification completeness and quality before proceeding to planning
+**Created**: January 30, 2026
+**Last Validated**: January 30, 2026
+**Feature**: [spec.md](../spec.md)
+
+## Content Quality
+
+- [x] No implementation details (languages, frameworks, APIs)
+- [x] Focused on user value and business needs
+- [x] Written for non-technical stakeholders
+- [x] All mandatory sections completed
+
+## Requirement Completeness
+
+- [x] No [NEEDS CLARIFICATION] markers remain
+- [x] Requirements are testable and unambiguous
+- [x] Success criteria are measurable
+- [x] Success criteria are technology-agnostic (no implementation details)
+- [x] All acceptance scenarios are defined
+- [x] Edge cases are identified
+- [x] Scope is clearly bounded
+- [x] Dependencies and assumptions identified
+
+## Feature Readiness
+
+- [x] All functional requirements have clear acceptance criteria
+- [x] User scenarios cover primary flows
+- [x] Feature meets measurable outcomes defined in Success Criteria
+- [x] No implementation details leak into specification
+
+## Notes
+
+**Validation Summary**: All items passed ✓
+
+**Spec Statistics**:
+- 6 user stories with clear priorities (P1: 2, P2: 2, P3: 2)
+- 17 functional requirements (FR-001 to FR-017)
+- 5 non-functional requirements (NFR-001 to NFR-005)
+- 8 measurable success criteria (SC-001 to SC-008)
+- 6 edge cases documented
+- 5 open questions identified for planning phase
+
+**Notable Additions Since Initial Draft**:
+- Problem Statement section added
+- Constitution Alignment mapping added
+- Testing Requirements section added (per Constitution Principle IV)
+- Non-Functional Requirements added (organizational code quality standards)
+- Cross-Repository Impact section added
+- Open Questions section captures decisions needed
+
+**Minor Notes (Acceptable)**:
+- NFRs reference Go/golangci-lint - acceptable as organizational standards, not implementation choices
+- Cross-Repository Impact mentions repo paths - acceptable as planning information
+
+**Status**: Specification is ready for `/speckit.clarify` or `/speckit.plan`

specs/001-git-app-graph-preview/contracts/app-graph-schema.yaml

@@ -0,0 +1,300 @@
+openapi: 3.0.3
+info:
+  title: Radius App Graph Static API
+  description: |
+    Internal API contract for static app graph generation from Bicep files.
+    This contract defines the JSON schema for app graph output and diff operations.
+
+    Note: This is a CLI-internal contract, not a REST API. The schema defines
+    the structure of JSON files written by `rad app graph` commands.
+  version: 1.0.0
+  license:
+    name: Apache 2.0
+    url: https://www.apache.org/licenses/LICENSE-2.0
+
+paths: {}
+
+components:
+  schemas:
+    AppGraph:
+      type: object
+      description: Complete application topology extracted from Bicep files
+      required:
+        - metadata
+        - resources
+        - connections
+      properties:
+        metadata:
+          $ref: '#/components/schemas/AppGraphMetadata'
+        resources:
+          type: array
+          items:
+            $ref: '#/components/schemas/AppGraphResource'
+        connections:
+          type: array
+          items:
+            $ref: '#/components/schemas/AppGraphConnection'
+
+    AppGraphMetadata:
+      type: object
+      description: Generation context and provenance information
+      required:
+        - generatedAt
+        - radiusCliVersion
+        - sourceFiles
+        - sourceHash
+      properties:
+        generatedAt:
+          type: string
+          format: date-time
+          description: UTC timestamp when this graph was generated
+          example: "2026-01-30T10:15:00Z"
+        radiusCliVersion:
+          type: string
+          description: Version of rad CLI used to generate this graph
+          example: "0.35.0"
+        sourceFiles:
+          type: array
+          items:
+            type: string
+          description: Bicep files that contributed to this graph
+          example: ["app.bicep", "modules/database.bicep"]
+        sourceHash:
+          type: string
+          pattern: "^sha256:[a-f0-9]{64}$"
+          description: SHA256 hash of source files for staleness detection
+          example: "sha256:7d865e959b2466918c9863afca942d0fb89d7c9ac0c99bafc3749504ded97730"
+        gitCommit:
+          type: string
+          description: Current git commit SHA (if in a git repository)
+          example: "abc123def456"
+
+    AppGraphResource:
+      type: object
+      description: A single resource in the application topology
+      required:
+        - id
+        - name
+        - type
+        - sourceLocation
+      properties:
+        id:
+          type: string
+          description: Fully qualified Radius resource ID
+          pattern: "^/planes/radius/.+/providers/.+/.+"
+          example: "/planes/radius/local/resourceGroups/default/providers/Applications.Core/containers/frontend"
+        name:
+          type: string
+          description: Human-readable resource name
+          example: "frontend"
+        type:
+          type: string
+          description: Resource type
+          example: "Applications.Core/containers"
+        sourceLocation:
+          $ref: '#/components/schemas/SourceLocation'
+        gitInfo:
+          $ref: '#/components/schemas/GitInfo'
+        properties:
+          type: object
+          additionalProperties: true
+          description: Type-specific resource configuration
+
+    SourceLocation:
+      type: object
+      description: Bicep source file and line where a resource is defined
+      required:
+        - file
+        - line
+      properties:
+        file:
+          type: string
+          description: Path to Bicep file (relative to repo root)
+          example: "app.bicep"
+        line:
+          type: integer
+          minimum: 1
+          description: 1-based line number where resource begins
+          example: 12
+        module:
+          type: string
+          description: Module path if from an imported module
+          example: "modules/database.bicep"
+
+    GitInfo:
+      type: object
+      description: Git commit information for a resource
+      required:
+        - commitSha
+        - commitShort
+        - author
+        - date
+        - message
+      properties:
+        commitSha:
+          type: string
+          pattern: "^[a-f0-9]{40}$"
+          description: Full commit hash that last modified this resource
+          example: "abc123def456789012345678901234567890abcd"
+        commitShort:
+          type: string
+          pattern: "^[a-f0-9]{7}$"
+          description: Abbreviated commit hash for display
+          example: "abc123d"
+        author:
+          type: string
+          format: email
+          description: Commit author email
+          example: "dev@example.com"
+        date:
+          type: string
+          format: date-time
+          description: Commit timestamp in RFC3339 format
+          example: "2026-01-29T14:30:00Z"
+        message:
+          type: string
+          description: Commit message (first line only)
+          example: "Add frontend container"
+        uncommitted:
+          type: boolean
+          description: True if resource has uncommitted changes
+          default: false
+
+    AppGraphConnection:
+      type: object
+      description: Directed edge between two resources
+      required:
+        - sourceId
+        - targetId
+        - type
+      properties:
+        sourceId:
+          type: string
+          description: Resource ID where connection originates
+          example: "/planes/radius/local/resourceGroups/default/providers/Applications.Core/containers/frontend"
+        targetId:
+          type: string
+          description: Resource ID where connection terminates
+          example: "/planes/radius/local/resourceGroups/default/providers/Applications.Core/containers/backend"
+        type:
+          type: string
+          enum:
+            - connection
+            - route
+            - dependsOn
+          description: Kind of connection
+
+    GraphDiff:
+      type: object
+      description: Differences between two app graphs
+      required:
+        - addedResources
+        - removedResources
+        - modifiedResources
+        - addedConnections
+        - removedConnections
+        - summary
+      properties:
+        baseCommit:
+          type: string
+          description: Commit SHA of the base graph
+          example: "abc123"
+        headCommit:
+          type: string
+          description: Commit SHA of the head graph
+          example: "def456"
+        addedResources:
+          type: array
+          items:
+            $ref: '#/components/schemas/AppGraphResource'
+          description: Resources in head but not in base
+        removedResources:
+          type: array
+          items:
+            $ref: '#/components/schemas/AppGraphResource'
+          description: Resources in base but not in head
+        modifiedResources:
+          type: array
+          items:
+            $ref: '#/components/schemas/ResourceDiff'
+          description: Resources with changed properties
+        addedConnections:
+          type: array
+          items:
+            $ref: '#/components/schemas/AppGraphConnection'
+          description: Connections in head but not in base
+        removedConnections:
+          type: array
+          items:
+            $ref: '#/components/schemas/AppGraphConnection'
+          description: Connections in base but not in head
+        summary:
+          $ref: '#/components/schemas/DiffSummary'
+
+    ResourceDiff:
+      type: object
+      description: Changes to a single resource
+      required:
+        - id
+        - name
+        - type
+        - changedProperties
+      properties:
+        id:
+          type: string
+          description: Resource ID
+        name:
+          type: string
+          description: Resource name
+        type:
+          type: string
+          description: Resource type
+        changedProperties:
+          type: array
+          items:
+            $ref: '#/components/schemas/PropertyChange'
+
+    PropertyChange:
+      type: object
+      description: Single property modification
+      required:
+        - path
+      properties:
+        path:
+          type: string
+          description: JSON path to changed property
+          example: "properties.container.image"
+        oldValue:
+          description: Value in base graph
+        newValue:
+          description: Value in head graph
+
+    DiffSummary:
+      type: object
+      description: Aggregate statistics for the diff
+      required:
+        - totalChanges
+        - resourcesAdded
+        - resourcesRemoved
+        - resourcesModified
+        - connectionsAdded
+        - connectionsRemoved
+      properties:
+        totalChanges:
+          type: integer
+          minimum: 0
+        resourcesAdded:
+          type: integer
+          minimum: 0
+        resourcesRemoved:
+          type: integer
+          minimum: 0
+        resourcesModified:
+          type: integer
+          minimum: 0
+        connectionsAdded:
+          type: integer
+          minimum: 0
+        connectionsRemoved:
+          type: integer
+          minimum: 0