github / github/spec-kit

[Bug]: Test-FeatureJsonMatchesFeatureDir was missing in common.ps1 — this was a missing function that caused setup-tasks.ps1 to fail.

Open Beginner friendly
#2,721 3 comments 0 reactions 0 assignees View on GitHub
stale
Dominant language
Python
Stars
137k
Forks
12.3k
Avg merge
2d 12h
Merged PRs (30d)
159

Description

### Bug Description

On start of `/speckit.tasks` in PowerShell environment, it attempts to call function
`Test-FeatureJsonMatchesFeatureDir`
An error is thrown and there is no such commandlet.

CoPilot eventually worked around the problem.

```shell
.\.specify\scripts\powershell\setup-tasks.ps1 -Json
C:\Code\private\app\.specify\scripts\powershell\setup-tasks.ps1 : The term
'Test-FeatureJsonMatchesFeatureDir' is not recognized as the name of a cmdlet, function, script file, or
operable program. Check the spelling of the name, or if a path was included, verify that the path is
correct and try again.
At line:1 char:1
+ .\.specify\scripts\powershell\setup-tasks.ps1 -Json
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (Test-FeatureJsonMatchesFeatureDir:String) [setup-tasks.ps1]
, CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException,setup-tasks.ps1
```

### Steps to Reproduce

1: Run `/speckit.tasks`
2: Errors noted for missing function `Test-FeatureJsonMatchesFeatureDir`

The function checks if feature.json pins an existing feature directory, and if it does, branch naming validation gets skipped.

Since the function is missing from common.ps1, this validation logic can't run.

### Expected Behavior

No error should have been reported.

### Actual Behavior

```shell
.\.specify\scripts\powershell\setup-tasks.ps1 -Json
C:\Code\private\app\.specify\scripts\powershell\setup-tasks.ps1 : The term
'Test-FeatureJsonMatchesFeatureDir' is not recognized as the name of a cmdlet, function, script file, or
operable program. Check the spelling of the name, or if a path was included, verify that the path is
correct and try again.
At line:1 char:1
+ .\.specify\scripts\powershell\setup-tasks.ps1 -Json
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (Test-FeatureJsonMatchesFeatureDir:String) [setup-tasks.ps1]
, CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException,setup-tasks.ps1
```

Since the function is missing from common.ps1, this validation logic can't run.

CoPilot eventually determined what the function should have returned and worked around the problem.

### Specify CLI Version

0.8.13

### AI Agent

GitHub Copilot

### Operating System

Windows 11 (10.0.26220)

### Python Version

Python 3.12.6

### Error Logs

```shell
.\.specify\scripts\powershell\setup-tasks.ps1 -Json
C:\Code\private\app\.specify\scripts\powershell\setup-tasks.ps1 : At
C:\Code\private\app\.specify\scripts\powershell\common.ps1:141 char:122
+ ... -Path $RepoRoot $pinnedRelative) -ErrorAction SilentlyContinue)?.Path
+ ~~~~~~
Unexpected token '?.Path' in expression or statement.
At C:\Code\private\app\.specify\scripts\powershell\common.ps1:142 char:102
+ ... h -LiteralPath $ActiveFeatureDir -ErrorAction SilentlyContinue)?.Path
+ ~~~~~~
Unexpected token '?.Path' in expression or statement.
At line:1 char:1
+ .\.specify\scripts\powershell\setup-tasks.ps1 -Json
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ParserError: (:) [setup-tasks.ps1], ParseException
+ FullyQualifiedErrorId : UnexpectedToken,setup-tasks.ps1
```

### Additional Context

This speckit was in-place upgraded from a previous version ~ 1 month old

Contributor guide

Open the contributing guide

Research direction

Start with .specify/scripts/powershell/common.ps1 and the call from .specify/scripts/powershell/setup-tasks.ps1. Reproduce the failure with setup-tasks.ps1 -Json in PowerShell, then verify that Test-FeatureJsonMatchesFeatureDir is available and that the feature-directory validation completes without the reported command or parser errors.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
cli, tooling
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.