fix(scripts): persist .specify/feature.json during feature creation

Author: grafvonb

scripts/bash/common.sh

@@ -333,4 +333,3 @@ except Exception:
     # Callers running under set -e should use: TEMPLATE=$(resolve_template ...) || true
     return 1
 }
-

scripts/bash/create-new-feature.sh

@@ -324,6 +324,7 @@ fi
 
 FEATURE_DIR="$SPECS_DIR/$BRANCH_NAME"
 SPEC_FILE="$FEATURE_DIR/spec.md"
+FEATURE_METADATA_FILE="$REPO_ROOT/.specify/feature.json"
 
 if [ "$DRY_RUN" != true ]; then
     if [ "$HAS_GIT" = true ]; then
@@ -363,6 +364,7 @@ if [ "$DRY_RUN" != true ]; then
     fi
 
     mkdir -p "$FEATURE_DIR"
+    mkdir -p "$(dirname "$FEATURE_METADATA_FILE")"
 
     if [ ! -f "$SPEC_FILE" ]; then
         TEMPLATE=$(resolve_template "spec-template" "$REPO_ROOT") || true
@@ -374,6 +376,14 @@ if [ "$DRY_RUN" != true ]; then
         fi
     fi
 
+    if command -v jq >/dev/null 2>&1; then
+        jq -cn \
+            --arg feature_directory "specs/$BRANCH_NAME" \
+            '{feature_directory:$feature_directory}' >"$FEATURE_METADATA_FILE"
+    else
+        printf '{"feature_directory":"%s"}\n' "$(json_escape "specs/$BRANCH_NAME")" >"$FEATURE_METADATA_FILE"
+    fi
+
     # Inform the user how to persist the feature variable in their own shell
     printf '# To persist: export SPECIFY_FEATURE=%q\n' "$BRANCH_NAME" >&2
 fi

scripts/powershell/common.ps1

@@ -265,4 +265,3 @@ function Resolve-Template {
 
     return $null
 }
-

scripts/powershell/create-new-feature.ps1

@@ -289,6 +289,7 @@ if ($branchName.Length -gt $maxBranchLength) {
 
 $featureDir = Join-Path $specsDir $branchName
 $specFile = Join-Path $featureDir 'spec.md'
+$featureMetadataFile = Join-Path $repoRoot '.specify/feature.json'
 
 if (-not $DryRun) {
     if ($hasGit) {
@@ -342,6 +343,7 @@ if (-not $DryRun) {
     }
 
     New-Item -ItemType Directory -Path $featureDir -Force | Out-Null
+    New-Item -ItemType Directory -Path (Split-Path $featureMetadataFile -Parent) -Force | Out-Null
 
     if (-not (Test-Path -PathType Leaf $specFile)) {
         $template = Resolve-Template -TemplateName 'spec-template' -RepoRoot $repoRoot
@@ -352,6 +354,10 @@ if (-not $DryRun) {
         }
     }
 
+    [PSCustomObject]@{
+        feature_directory = "specs/$branchName"
+    } | ConvertTo-Json -Compress | Set-Content -Path $featureMetadataFile -Encoding utf8
+
     # Set the SPECIFY_FEATURE environment variable for the current session
     $env:SPECIFY_FEATURE = $branchName
 }

tests/test_timestamp_branches.py

@@ -105,6 +105,19 @@ def test_json_output_keys(self, git_repo: Path):
             assert key in data, f"missing {key} in JSON: {data}"
         assert re.match(r"^\d{8}-\d{6}$", data["FEATURE_NUM"])
 
+    def test_writes_feature_metadata_file(self, git_repo: Path):
+        """The create script persists .specify/feature.json for downstream commands."""
+        import json
+
+        result = run_script(git_repo, "--json", "--short-name", "meta-test", "Metadata test")
+        assert result.returncode == 0, result.stderr
+        data = json.loads(result.stdout)
+
+        metadata_file = git_repo / ".specify" / "feature.json"
+        assert metadata_file.exists(), "feature metadata file was not created"
+        metadata = json.loads(metadata_file.read_text(encoding="utf-8"))
+        assert metadata == {"feature_directory": f"specs/{data['BRANCH_NAME']}"}
+
     def test_long_name_truncation(self, git_repo: Path):
         """Test 5: Long branch name is truncated to <= 244 chars."""
         long_name = "a-" * 150 + "end"
@@ -774,3 +787,18 @@ def test_ps_dry_run_json_absent_without_flag(self, ps_git_repo: Path):
         assert result.returncode == 0, result.stderr
         data = json.loads(result.stdout)
         assert "DRY_RUN" not in data, f"DRY_RUN should not be in normal JSON: {data}"
+
+    def test_ps_writes_feature_metadata_file(self, ps_git_repo: Path):
+        """PowerShell create script persists .specify/feature.json."""
+        import json
+
+        result = run_ps_script(
+            ps_git_repo, "-Json", "-ShortName", "ps-meta", "PowerShell metadata"
+        )
+        assert result.returncode == 0, result.stderr
+        data = json.loads(result.stdout)
+
+        metadata_file = ps_git_repo / ".specify" / "feature.json"
+        assert metadata_file.exists(), "feature metadata file was not created"
+        metadata = json.loads(metadata_file.read_text(encoding="utf-8-sig"))
+        assert metadata == {"feature_directory": f"specs/{data['BRANCH_NAME']}"}