@jeancodogno/specforce-kit 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/index.js +46 -0
  2. package/package.json +12 -28
  3. package/.geminiignore +0 -15
  4. package/.github/workflows/ci.yml +0 -104
  5. package/.github/workflows/release.yml +0 -51
  6. package/.golangci.yml +0 -24
  7. package/.goreleaser.yaml +0 -39
  8. package/.rgignore +0 -13
  9. package/.specforce/archive/agents-md-hooks-config/design.md +0 -38
  10. package/.specforce/archive/agents-md-hooks-config/requirements.md +0 -35
  11. package/.specforce/archive/agents-md-hooks-config/tasks.md +0 -76
  12. package/.specforce/config.yaml +0 -32
  13. package/.specforce/docs/.gitkeep +0 -0
  14. package/.specforce/docs/architecture.md +0 -98
  15. package/.specforce/docs/engineering.md +0 -84
  16. package/.specforce/docs/governance.md +0 -30
  17. package/.specforce/docs/memorial.md +0 -45
  18. package/.specforce/docs/principles.md +0 -31
  19. package/.specforce/docs/security.md +0 -31
  20. package/.specforce/docs/ui-ux.md +0 -129
  21. package/.specforce/specs/.gitkeep +0 -0
  22. package/AGENTS.md +0 -46
  23. package/CONTRIBUTING.md +0 -81
  24. package/Makefile +0 -49
  25. package/assets/logo-header.png +0 -0
  26. package/assets/logo.png +0 -0
  27. package/docs/artifacts.md +0 -41
  28. package/docs/cli.md +0 -73
  29. package/docs/configuration.md +0 -59
  30. package/docs/getting-started.md +0 -110
  31. package/docs/supported-tools.md +0 -28
  32. package/go.mod +0 -35
  33. package/go.sum +0 -61
  34. package/src/cmd/specforce/main.go +0 -23
  35. package/src/cmd/specforce/main_test.go +0 -7
  36. package/src/internal/agent/artifacts/constitution/architecture.yaml +0 -70
  37. package/src/internal/agent/artifacts/constitution/engineering.yaml +0 -52
  38. package/src/internal/agent/artifacts/constitution/governance.yaml +0 -41
  39. package/src/internal/agent/artifacts/constitution/memorial.yaml +0 -55
  40. package/src/internal/agent/artifacts/constitution/principles.yaml +0 -54
  41. package/src/internal/agent/artifacts/constitution/security.yaml +0 -47
  42. package/src/internal/agent/artifacts/constitution/ui-ux.yaml +0 -158
  43. package/src/internal/agent/artifacts/spec/design.yaml +0 -50
  44. package/src/internal/agent/artifacts/spec/requirements.yaml +0 -48
  45. package/src/internal/agent/artifacts/spec/tasks.yaml +0 -55
  46. package/src/internal/agent/compatibility_test.go +0 -120
  47. package/src/internal/agent/cwd_test.go +0 -9
  48. package/src/internal/agent/embed.go +0 -19
  49. package/src/internal/agent/integration_test.go +0 -138
  50. package/src/internal/agent/kit/agents/product-analyst.yaml +0 -31
  51. package/src/internal/agent/kit/agents/technical-developer.yaml +0 -28
  52. package/src/internal/agent/kit/agents/technical-project-planner.yaml +0 -30
  53. package/src/internal/agent/kit/agents/technical-qa-engineer.yaml +0 -36
  54. package/src/internal/agent/kit/agents/technical-solution-architect.yaml +0 -32
  55. package/src/internal/agent/kit/commands/archive.yaml +0 -25
  56. package/src/internal/agent/kit/commands/constitution.yaml +0 -132
  57. package/src/internal/agent/kit/commands/implement.yaml +0 -96
  58. package/src/internal/agent/kit/commands/spec.yaml +0 -94
  59. package/src/internal/agent/kit/instructions/archive.md +0 -68
  60. package/src/internal/agent/kit/kit.yaml +0 -111
  61. package/src/internal/agent/kit/skills/opportunity-framing/SKILL.yaml +0 -56
  62. package/src/internal/agent/kit/skills/pragmatic-product-owner/SKILL.yaml +0 -58
  63. package/src/internal/agent/kit/skills/pragmatic-product-owner/references/spec-artifacts.yaml +0 -38
  64. package/src/internal/agent/kit/skills/spec-clarification-interview/SKILL.yaml +0 -52
  65. package/src/internal/agent/kit/skills/task-atomic-decomposition/SKILL.yaml +0 -137
  66. package/src/internal/agent/kit/skills/task-atomic-decomposition/references/roadmap-patterns.yaml +0 -103
  67. package/src/internal/agent/kit_manifests_test.go +0 -58
  68. package/src/internal/agent/manifest.go +0 -15
  69. package/src/internal/agent/registry.go +0 -69
  70. package/src/internal/agent/registry_test.go +0 -51
  71. package/src/internal/agent/translator.go +0 -334
  72. package/src/internal/agent/translator_test.go +0 -734
  73. package/src/internal/cli/archive.go +0 -91
  74. package/src/internal/cli/archive_test.go +0 -67
  75. package/src/internal/cli/cli.go +0 -259
  76. package/src/internal/cli/cli_test.go +0 -130
  77. package/src/internal/cli/cobra/archive.go +0 -26
  78. package/src/internal/cli/cobra/console.go +0 -21
  79. package/src/internal/cli/cobra/constitution.go +0 -44
  80. package/src/internal/cli/cobra/dummy_test.go +0 -7
  81. package/src/internal/cli/cobra/implementation.go +0 -50
  82. package/src/internal/cli/cobra/init.go +0 -23
  83. package/src/internal/cli/cobra/install.go +0 -21
  84. package/src/internal/cli/cobra/root.go +0 -47
  85. package/src/internal/cli/cobra/spec.go +0 -91
  86. package/src/internal/cli/console.go +0 -48
  87. package/src/internal/cli/constitution.go +0 -190
  88. package/src/internal/cli/constitution_test.go +0 -50
  89. package/src/internal/cli/implementation.go +0 -153
  90. package/src/internal/cli/implementation_test.go +0 -165
  91. package/src/internal/cli/spec.go +0 -369
  92. package/src/internal/cli/spec_test.go +0 -85
  93. package/src/internal/constitution/registry.go +0 -139
  94. package/src/internal/constitution/registry_test.go +0 -97
  95. package/src/internal/constitution/status.go +0 -70
  96. package/src/internal/constitution/status_test.go +0 -160
  97. package/src/internal/core/blueprint.go +0 -49
  98. package/src/internal/core/blueprint_test.go +0 -58
  99. package/src/internal/core/config.go +0 -124
  100. package/src/internal/core/config_test.go +0 -145
  101. package/src/internal/core/constants.go +0 -13
  102. package/src/internal/core/errors.go +0 -31
  103. package/src/internal/core/errors_test.go +0 -48
  104. package/src/internal/core/hooks.go +0 -89
  105. package/src/internal/core/hooks_test.go +0 -51
  106. package/src/internal/core/kit.go +0 -15
  107. package/src/internal/core/kit_test.go +0 -65
  108. package/src/internal/core/path.go +0 -115
  109. package/src/internal/core/path_test.go +0 -101
  110. package/src/internal/core/ui.go +0 -19
  111. package/src/internal/installer/dependencies.go +0 -23
  112. package/src/internal/installer/install.go +0 -89
  113. package/src/internal/installer/installer.go +0 -45
  114. package/src/internal/installer/installer_test.go +0 -96
  115. package/src/internal/project/agents_md.go +0 -155
  116. package/src/internal/project/agents_md_test.go +0 -147
  117. package/src/internal/project/bootstrapper.go +0 -64
  118. package/src/internal/project/bootstrapper_test.go +0 -89
  119. package/src/internal/project/detector.go +0 -35
  120. package/src/internal/project/detector_test.go +0 -96
  121. package/src/internal/project/refresh_integration_test.go +0 -86
  122. package/src/internal/project/service.go +0 -93
  123. package/src/internal/project/service_test.go +0 -135
  124. package/src/internal/spec/archive.go +0 -49
  125. package/src/internal/spec/archive_test.go +0 -55
  126. package/src/internal/spec/discovery.go +0 -53
  127. package/src/internal/spec/discovery_test.go +0 -60
  128. package/src/internal/spec/implementation.go +0 -296
  129. package/src/internal/spec/implementation_test.go +0 -253
  130. package/src/internal/spec/registry.go +0 -142
  131. package/src/internal/spec/registry_test.go +0 -105
  132. package/src/internal/spec/scanner.go +0 -219
  133. package/src/internal/spec/scanner_test.go +0 -243
  134. package/src/internal/spec/service.go +0 -157
  135. package/src/internal/spec/service_test.go +0 -238
  136. package/src/internal/spec/status.go +0 -94
  137. package/src/internal/spec/status_test.go +0 -146
  138. package/src/internal/spec/tasks.go +0 -103
  139. package/src/internal/spec/tasks_test.go +0 -137
  140. package/src/internal/tui/components.go +0 -132
  141. package/src/internal/tui/console.go +0 -247
  142. package/src/internal/tui/console_test.go +0 -19
  143. package/src/internal/tui/constitution.go +0 -36
  144. package/src/internal/tui/constitution_test.go +0 -32
  145. package/src/internal/tui/implementation.go +0 -151
  146. package/src/internal/tui/logo.go +0 -89
  147. package/src/internal/tui/multiselect.go +0 -199
  148. package/src/internal/tui/progressbar.go +0 -37
  149. package/src/internal/tui/progressbar_test.go +0 -30
  150. package/src/internal/tui/spec.go +0 -35
  151. package/src/internal/tui/spinner.go +0 -66
  152. package/src/internal/tui/terminal.go +0 -18
  153. package/src/internal/tui/theme.go +0 -125
  154. package/src/internal/tui/ui.go +0 -52
@@ -1,60 +0,0 @@
1
- package spec
2
-
3
- import (
4
- "context"
5
- "os"
6
- "path/filepath"
7
- "testing"
8
- )
9
-
10
- func TestDiscovery(t *testing.T) {
11
- // Setup temp project root
12
- if err := os.MkdirAll(filepath.Join("testdata", "discovery"), 0755); err != nil {
13
- t.Fatal(err)
14
- }
15
- defer func() { _ = os.RemoveAll("testdata") }()
16
-
17
- projectRoot := filepath.Join("testdata", "discovery")
18
- specsDir := filepath.Join(projectRoot, ".specforce", "specs")
19
- archiveDir := filepath.Join(projectRoot, ".specforce", "archive")
20
-
21
- // Create active spec
22
- if err := os.MkdirAll(filepath.Join(specsDir, "active-spec"), 0755); err != nil {
23
- t.Fatal(err)
24
- }
25
- // Create archived spec
26
- if err := os.MkdirAll(filepath.Join(archiveDir, "archived-spec"), 0755); err != nil {
27
- t.Fatal(err)
28
- }
29
-
30
- t.Run("SpecExists active", func(t *testing.T) {
31
- exists, status := SpecExists(projectRoot, "active-spec")
32
- if !exists || status != "active" {
33
- t.Errorf("expected active-spec to exist and be active, got %v, %s", exists, status)
34
- }
35
- })
36
-
37
- t.Run("SpecExists archived", func(t *testing.T) {
38
- exists, status := SpecExists(projectRoot, "archived-spec")
39
- if !exists || status != "archived" {
40
- t.Errorf("expected archived-spec to exist and be archived, got %v, %s", exists, status)
41
- }
42
- })
43
-
44
- t.Run("SpecExists none", func(t *testing.T) {
45
- exists, status := SpecExists(projectRoot, "none")
46
- if exists {
47
- t.Errorf("expected none to not exist, got %v, %s", exists, status)
48
- }
49
- })
50
-
51
- t.Run("ListActiveSpecs", func(t *testing.T) {
52
- specs, err := ListActiveSpecs(context.Background(), projectRoot)
53
- if err != nil {
54
- t.Fatal(err)
55
- }
56
- if len(specs) != 1 || specs[0].Slug != "active-spec" {
57
- t.Errorf("expected 1 active spec (active-spec), got %d: %+v", len(specs), specs)
58
- }
59
- })
60
- }
@@ -1,296 +0,0 @@
1
- package spec
2
-
3
- import (
4
- "context"
5
- "errors"
6
- "fmt"
7
- "os"
8
- "path/filepath"
9
- "regexp"
10
- "strings"
11
-
12
- "github.com/jeancodogno/specforce-kit/src/internal/core"
13
- )
14
-
15
- type ImplementationTask struct {
16
- ID string `json:"id"`
17
- Title string `json:"title"`
18
- State string `json:"state"`
19
- Target string `json:"target"`
20
- Context string `json:"context"`
21
- ActionSteps []string `json:"action_steps"`
22
- Verification string `json:"verification"`
23
- }
24
-
25
- type Phase struct {
26
- ID string `json:"id"`
27
- Title string `json:"title"`
28
- Tasks []ImplementationTask `json:"tasks"`
29
- }
30
-
31
- type ImplementationReport struct {
32
- Name string `json:"name"`
33
- Status string `json:"status"` // ready | blocked
34
- MissingArtifacts []string `json:"missing_artifacts,omitempty"`
35
- ContextFiles []string `json:"context_files"`
36
- Instructions []string `json:"instructions,omitempty"`
37
- Phases []Phase `json:"phases"`
38
- ExecutionStrategy string `json:"execution_strategy"`
39
- PreemptiveMitigations string `json:"preemptive_mitigations"`
40
- }
41
-
42
- // Tasks returns a flat list of tasks across all phases for backward compatibility.
43
- func (r *ImplementationReport) Tasks() []ImplementationTask {
44
- var tasks []ImplementationTask
45
- for _, p := range r.Phases {
46
- tasks = append(tasks, p.Tasks...)
47
- }
48
- return tasks
49
- }
50
-
51
- // FindProjectRoot looks for the .specforce directory in the current or parent directories.
52
- func FindProjectRoot() (string, error) {
53
- cwd, err := os.Getwd()
54
- if err != nil {
55
- return "", err
56
- }
57
-
58
- current := cwd
59
- for {
60
- if _, err := os.Stat(filepath.Join(current, ".specforce")); err == nil {
61
- return current, nil
62
- }
63
-
64
- parent := filepath.Dir(current)
65
- if parent == current {
66
- break
67
- }
68
- current = parent
69
- }
70
-
71
- return "", fmt.Errorf(".specforce directory not found")
72
- }
73
-
74
- // CheckTriadArtifacts verifies if requirements.md, design.md, and tasks.md exist.
75
- func CheckTriadArtifacts(projectRoot, slug string) (bool, []string) {
76
- required := []string{"requirements.md", "design.md", "tasks.md"}
77
- missing := []string{}
78
-
79
- specDir := filepath.Join(projectRoot, ".specforce", "specs", slug)
80
-
81
- for _, art := range required {
82
- if _, err := os.Stat(filepath.Join(specDir, art)); os.IsNotExist(err) {
83
- missing = append(missing, art)
84
- }
85
- }
86
-
87
- return len(missing) == 0, missing
88
- }
89
-
90
- // GetContextFiles returns absolute paths for all files in the spec directory and global docs.
91
- func GetContextFiles(projectRoot, slug string) ([]string, error) {
92
- files := []string{}
93
-
94
- specDir := filepath.Join(projectRoot, ".specforce", "specs", slug)
95
-
96
- // Helper to add files from a directory
97
- addFiles := func(dir string) error {
98
- if _, err := os.Stat(dir); os.IsNotExist(err) {
99
- return nil
100
- }
101
-
102
- return filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
103
- if err != nil {
104
- return err
105
- }
106
- if !info.IsDir() {
107
- abs, err := filepath.Abs(path)
108
- if err != nil {
109
- return err
110
- }
111
- files = append(files, abs)
112
- }
113
- return nil
114
- })
115
- }
116
-
117
- if err := addFiles(specDir); err != nil {
118
- return nil, err
119
- }
120
-
121
- return files, nil
122
- }
123
-
124
- // ParseTasks extracts implementation details from tasks.md.
125
- func ParseTasks(ctx context.Context, projectRoot, slug string) (*ImplementationReport, error) {
126
- if err := ctx.Err(); err != nil {
127
- return nil, err
128
- }
129
-
130
- tasksPath, err := core.SecurePath(projectRoot, filepath.Join(".specforce", "specs", slug, "tasks.md"))
131
- if err != nil {
132
- return nil, fmt.Errorf("security: %w", err)
133
- }
134
- // #nosec G304 - Path is secured by SecurePath
135
- content, err := os.ReadFile(tasksPath)
136
- if err != nil {
137
- return nil, fmt.Errorf("failed to read spec file %s: %w", tasksPath, errors.Join(core.ErrInvalidSpecFile, err))
138
- }
139
-
140
- report := &ImplementationReport{
141
- Name: slug,
142
- Phases: []Phase{},
143
- }
144
-
145
- extractStrategyAndMitigations(content, report)
146
-
147
- if err := extractTasksFromContent(ctx, content, report); err != nil {
148
- return nil, err
149
- }
150
-
151
- report.Status = calculateReportStatus(report.Tasks())
152
-
153
- return report, nil
154
- }
155
-
156
- func extractStrategyAndMitigations(content []byte, report *ImplementationReport) {
157
- strategyRegex := regexp.MustCompile(`(?s)## 1\. Execution Strategy\n(.*?)(?:\n##|$)`)
158
- strategyMatch := strategyRegex.FindSubmatch(content)
159
- if len(strategyMatch) > 1 {
160
- report.ExecutionStrategy = strings.TrimSpace(string(strategyMatch[1]))
161
- }
162
-
163
- mitigationsRegex := regexp.MustCompile(`(?s)## 3\. Pre-emptive Mitigations\n(.*?)(?:\n##|$)`)
164
- mitigationsMatch := mitigationsRegex.FindSubmatch(content)
165
- if len(mitigationsMatch) > 1 {
166
- report.PreemptiveMitigations = strings.TrimSpace(string(mitigationsMatch[1]))
167
- }
168
- }
169
-
170
- func extractTasksFromContent(ctx context.Context, content []byte, report *ImplementationReport) error {
171
- phaseHeaderRegex := regexp.MustCompile(`(?m)^### Phase (\d+): (.*)$`)
172
- taskHeaderRegex := regexp.MustCompile(`(?m)^#{3,4} (T[\d.]+): (.*)$`)
173
-
174
- phaseMatches := phaseHeaderRegex.FindAllSubmatchIndex(content, -1)
175
- taskMatches := taskHeaderRegex.FindAllSubmatchIndex(content, -1)
176
-
177
- for _, tm := range taskMatches {
178
- if err := ctx.Err(); err != nil {
179
- return err
180
- }
181
-
182
- task := parseTaskBlock(content, tm, taskMatches, phaseMatches)
183
-
184
- // Find or create phase
185
- currentPhaseIdx := findPhaseIdxForTask(content, tm[0], phaseMatches, report)
186
- report.Phases[currentPhaseIdx].Tasks = append(report.Phases[currentPhaseIdx].Tasks, task)
187
- }
188
-
189
- return nil
190
- }
191
-
192
- func parseTaskBlock(content []byte, tm []int, taskMatches, phaseMatches [][]int) ImplementationTask {
193
- task := ImplementationTask{
194
- ID: string(content[tm[2]:tm[3]]),
195
- Title: strings.TrimSpace(string(content[tm[4]:tm[5]])),
196
- }
197
-
198
- // Find the absolute next header (could be Phase or Task or ##)
199
- nextHeaderPos := len(content)
200
- for _, nextTm := range taskMatches {
201
- if nextTm[0] > tm[0] && nextTm[0] < nextHeaderPos {
202
- nextHeaderPos = nextTm[0]
203
- break
204
- }
205
- }
206
- for _, pm := range phaseMatches {
207
- if pm[0] > tm[0] && pm[0] < nextHeaderPos {
208
- nextHeaderPos = pm[0]
209
- break
210
- }
211
- }
212
- nextSectionRegex := regexp.MustCompile(`(?m)^## `)
213
- sectionMatch := nextSectionRegex.FindIndex(content[tm[1]:])
214
- if sectionMatch != nil {
215
- absSectionPos := tm[1] + sectionMatch[0]
216
- if absSectionPos < nextHeaderPos {
217
- nextHeaderPos = absSectionPos
218
- }
219
- }
220
-
221
- taskBlock := content[tm[0]:nextHeaderPos]
222
- task.State = extractField(taskBlock, `\*\*State:\*\* \x60?\[([^\]\x60\n]*)\]\x60?`)
223
- task.Target = extractField(taskBlock, `\*\*Target:\*\* \x60?([^\x60\n]*)\x60?`)
224
- task.Context = extractField(taskBlock, `\*\*Context:\*\* \x60?([^\x60\n]*)\x60?`)
225
- task.Verification = extractField(taskBlock, `(?s)\*\*Verification \(TDD\):\*\*\n(.*?)(?:\n\n|\n###|\n##|$)`)
226
-
227
- actionStepsRegex := regexp.MustCompile(`(?m)^- (.*)$`)
228
- actionMatches := actionStepsRegex.FindAllSubmatch(taskBlock, -1)
229
- for _, am := range actionMatches {
230
- task.ActionSteps = append(task.ActionSteps, string(am[1]))
231
- }
232
-
233
- return task
234
- }
235
-
236
- func findPhaseIdxForTask(content []byte, taskStart int, phaseMatches [][]int, report *ImplementationReport) int {
237
- matchIdx := -1
238
- for i := len(phaseMatches) - 1; i >= 0; i-- {
239
- if phaseMatches[i][0] < taskStart {
240
- matchIdx = i
241
- break
242
- }
243
- }
244
-
245
- if matchIdx == -1 {
246
- if len(report.Phases) == 0 || report.Phases[0].ID != "0" {
247
- report.Phases = append([]Phase{{ID: "0", Title: "Initial Tasks", Tasks: []ImplementationTask{}}}, report.Phases...)
248
- }
249
- return 0
250
- }
251
-
252
- phaseID := string(content[phaseMatches[matchIdx][2]:phaseMatches[matchIdx][3]])
253
- phaseTitle := strings.TrimSpace(string(content[phaseMatches[matchIdx][4]:phaseMatches[matchIdx][5]]))
254
-
255
- for idx, p := range report.Phases {
256
- if p.ID == phaseID && p.Title == phaseTitle {
257
- return idx
258
- }
259
- }
260
-
261
- report.Phases = append(report.Phases, Phase{ID: phaseID, Title: phaseTitle, Tasks: []ImplementationTask{}})
262
- return len(report.Phases) - 1
263
- }
264
-
265
- func calculateReportStatus(tasks []ImplementationTask) string {
266
- if len(tasks) == 0 {
267
- return "ready"
268
- }
269
- allFinished := true
270
- allPending := true
271
- for _, t := range tasks {
272
- st := strings.ToUpper(t.State)
273
- if st != "FINISHED" {
274
- allFinished = false
275
- }
276
- if st != "PENDING" && st != "" {
277
- allPending = false
278
- }
279
- }
280
-
281
- if allFinished {
282
- return "finished"
283
- } else if !allPending {
284
- return "in-progress"
285
- }
286
- return "ready"
287
- }
288
-
289
- func extractField(block []byte, pattern string) string {
290
- re := regexp.MustCompile(pattern)
291
- match := re.FindSubmatch(block)
292
- if len(match) > 1 {
293
- return strings.TrimSpace(string(match[1]))
294
- }
295
- return ""
296
- }
@@ -1,253 +0,0 @@
1
- package spec
2
-
3
- import (
4
- "context"
5
- "os"
6
- "path/filepath"
7
- "testing"
8
- )
9
-
10
- func TestCheckTriadArtifacts(t *testing.T) {
11
- tmpDir, err := os.MkdirTemp("", "specforce-test-*")
12
- if err != nil {
13
- t.Fatal(err)
14
- }
15
- defer func() { _ = os.RemoveAll(tmpDir) }()
16
-
17
- slug := "test-feature"
18
- specDir := filepath.Join(tmpDir, ".specforce", "specs", slug)
19
- err = os.MkdirAll(specDir, 0755)
20
- if err != nil {
21
- t.Fatal(err)
22
- }
23
-
24
- // Case 1: All missing
25
- ok, missing := CheckTriadArtifacts(tmpDir, slug)
26
- if ok {
27
- t.Error("Expected false, got true")
28
- }
29
- if len(missing) != 3 {
30
- t.Errorf("Expected 3 missing, got %d", len(missing))
31
- }
32
-
33
- // Case 2: Some missing
34
- if err := os.WriteFile(filepath.Join(specDir, "requirements.md"), []byte("test"), 0644); err != nil {
35
- t.Fatal(err)
36
- }
37
- ok, missing = CheckTriadArtifacts(tmpDir, slug)
38
- if ok {
39
- t.Error("Expected false, got true")
40
- }
41
- if len(missing) != 2 {
42
- t.Errorf("Expected 2 missing, got %d", len(missing))
43
- }
44
-
45
- // Case 3: None missing
46
- if err := os.WriteFile(filepath.Join(specDir, "design.md"), []byte("test"), 0644); err != nil {
47
- t.Fatal(err)
48
- }
49
- if err := os.WriteFile(filepath.Join(specDir, "tasks.md"), []byte("test"), 0644); err != nil {
50
- t.Fatal(err)
51
- }
52
- ok, missing = CheckTriadArtifacts(tmpDir, slug)
53
- if !ok {
54
- t.Error("Expected true, got false")
55
- }
56
- if len(missing) != 0 {
57
- t.Errorf("Expected 0 missing, got %d", len(missing))
58
- }
59
- }
60
-
61
- func TestGetContextFiles(t *testing.T) {
62
- tmpDir, err := os.MkdirTemp("", "specforce-test-*")
63
- if err != nil {
64
- t.Fatal(err)
65
- }
66
- defer func() { _ = os.RemoveAll(tmpDir) }()
67
-
68
- slug := "test-feature"
69
- specDir := filepath.Join(tmpDir, ".specforce", "specs", slug)
70
- docsDir := filepath.Join(tmpDir, ".specforce", "docs")
71
- err = os.MkdirAll(specDir, 0755)
72
- if err != nil {
73
- t.Fatal(err)
74
- }
75
- err = os.MkdirAll(docsDir, 0755)
76
- if err != nil {
77
- t.Fatal(err)
78
- }
79
-
80
- if err := os.WriteFile(filepath.Join(specDir, "tasks.md"), []byte("test"), 0644); err != nil {
81
- t.Fatal(err)
82
- }
83
- if err := os.WriteFile(filepath.Join(docsDir, "architecture.md"), []byte("test"), 0644); err != nil {
84
- t.Fatal(err)
85
- }
86
-
87
- files, err := GetContextFiles(tmpDir, slug)
88
- if err != nil {
89
- t.Fatalf("Unexpected error: %v", err)
90
- }
91
-
92
- if len(files) != 1 {
93
- t.Errorf("Expected 1 file (from spec dir), got %d. Global docs from .specforce/docs should be excluded.", len(files))
94
- }
95
-
96
- for _, f := range files {
97
- if !filepath.IsAbs(f) {
98
- t.Errorf("Expected absolute path, got %s", f)
99
- }
100
- }
101
- }
102
-
103
- func setupTasksFile(t *testing.T, tmpDir, slug, content string) {
104
- specDir := filepath.Join(tmpDir, ".specforce", "specs", slug)
105
- err := os.MkdirAll(specDir, 0755)
106
- if err != nil {
107
- t.Fatal(err)
108
- }
109
-
110
- if err := os.WriteFile(filepath.Join(specDir, "tasks.md"), []byte(content), 0644); err != nil {
111
- t.Fatal(err)
112
- }
113
- }
114
-
115
- func getSampleTasksMD() string {
116
- return `
117
- # Implementation Roadmap
118
-
119
- ## 1. Execution Strategy
120
- Strategy details here.
121
-
122
- ## 2. Tasks
123
-
124
- ### Phase 1: Setup
125
- #### T1.1: Task One
126
- **State:** [FINISHED]
127
- **Target:** target/one
128
- **Context:** context/one
129
-
130
- **Action Steps:**
131
- - step 1
132
- - step 2
133
-
134
- **Verification (TDD):**
135
- run verify 1
136
-
137
- ### Phase 2: Implementation
138
- #### T1.2: Task Two
139
- **State:** [IN-PROGRESS]
140
- **Target:** target/two
141
- **Context:** context/two
142
-
143
- **Action Steps:**
144
- - step A
145
-
146
- **Verification (TDD):**
147
- run verify 2
148
-
149
- ## 3. Pre-emptive Mitigations
150
- Mitigation details here.
151
- `
152
- }
153
-
154
- func TestParseTasks(t *testing.T) {
155
- tmpDir, err := os.MkdirTemp("", "specforce-test-*")
156
- if err != nil {
157
- t.Fatal(err)
158
- }
159
- defer func() { _ = os.RemoveAll(tmpDir) }()
160
-
161
- slug := "test-feature"
162
- setupTasksFile(t, tmpDir, slug, getSampleTasksMD())
163
-
164
- report, err := ParseTasks(context.Background(), tmpDir, slug)
165
- if err != nil {
166
- t.Fatalf("Unexpected error: %v", err)
167
- }
168
-
169
- if len(report.Phases) != 2 {
170
- t.Errorf("Expected 2 phases, got %d", len(report.Phases))
171
- }
172
-
173
- if report.Phases[0].Title != "Setup" || report.Phases[1].Title != "Implementation" {
174
- t.Errorf("Unexpected phase titles: %s, %s", report.Phases[0].Title, report.Phases[1].Title)
175
- }
176
-
177
- if len(report.Tasks()) != 2 {
178
- t.Errorf("Expected 2 tasks total, got %d", len(report.Tasks()))
179
- }
180
-
181
- t1 := report.Phases[0].Tasks[0]
182
- if t1.ID != "T1.1" || t1.Title != "Task One" {
183
- t.Errorf("Task 1.1 mismatch: %+v", t1)
184
- }
185
-
186
- if report.ExecutionStrategy != "Strategy details here." {
187
- t.Errorf("Expected strategy, got %v", report.ExecutionStrategy)
188
- }
189
-
190
- if report.PreemptiveMitigations != "Mitigation details here." {
191
- t.Errorf("Expected mitigations, got %v", report.PreemptiveMitigations)
192
- }
193
- }
194
-
195
- func TestParseTasks_EdgeCases(t *testing.T) {
196
- tmpDir, err := os.MkdirTemp("", "specforce-test-*")
197
- if err != nil {
198
- t.Fatal(err)
199
- }
200
- defer func() { _ = os.RemoveAll(tmpDir) }()
201
-
202
- slug := "edge-feature"
203
- content := `
204
- # No sections
205
- #### T1.1: Standalone Task
206
- **State:** [PENDING]
207
- `
208
- setupTasksFile(t, tmpDir, slug, content)
209
-
210
- report, err := ParseTasks(context.Background(), tmpDir, slug)
211
- if err != nil {
212
- t.Fatal(err)
213
- }
214
-
215
- if report.ExecutionStrategy != "" {
216
- t.Errorf("Expected empty strategy, got %v", report.ExecutionStrategy)
217
- }
218
-
219
- if len(report.Phases) != 1 || report.Phases[0].Title != "Initial Tasks" {
220
- t.Errorf("Expected 1 default phase, got %v", len(report.Phases))
221
- }
222
- }
223
-
224
- func TestImplementationReport_Tasks(t *testing.T) {
225
- report := &ImplementationReport{
226
- Phases: []Phase{
227
- {
228
- ID: "1",
229
- Title: "Phase 1",
230
- Tasks: []ImplementationTask{
231
- {ID: "T1.1", Title: "Task 1.1"},
232
- {ID: "T1.2", Title: "Task 1.2"},
233
- },
234
- },
235
- {
236
- ID: "2",
237
- Title: "Phase 2",
238
- Tasks: []ImplementationTask{
239
- {ID: "T2.1", Title: "Task 2.1"},
240
- },
241
- },
242
- },
243
- }
244
-
245
- tasks := report.Tasks()
246
- if len(tasks) != 3 {
247
- t.Fatalf("Expected 3 tasks, got %d", len(tasks))
248
- }
249
-
250
- if tasks[0].ID != "T1.1" || tasks[1].ID != "T1.2" || tasks[2].ID != "T2.1" {
251
- t.Errorf("Unexpected task order or IDs: %v", tasks)
252
- }
253
- }