speccoder-runtime 0.5.1

Application services of speccoder: the only crate that executes anything.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! The Spec Kit project `speccoder bench import` writes around an issue.

use std::fs;
use std::path::{Path, PathBuf};

use crate::bench::Issue;

/// Writes a Spec Kit project into `project`: the issue as the user story of
/// `spec.md`, a plan naming the test command, and one task to resolve it.
pub fn scaffold(
    project: &Path,
    slug: &str,
    issue: &Issue<'_>,
    test_cmd: &[String],
) -> Result<(), String> {
    let feature = format!("001-{slug}");
    let fdir = project.join("specs").join(&feature);
    fs::create_dir_all(&fdir).map_err(|e| e.to_string())?;
    fs::create_dir_all(project.join(".specify/memory")).map_err(|e| e.to_string())?;
    let write = |p: PathBuf, text: String| fs::write(p, text).map_err(|e| e.to_string());
    write(
        project.join(".specify/init-options.json"),
        "{\"speckit_version\": \"1.2.3\", \"integration\": \"claude\", \"script\": \"sh\"}\n"
            .to_owned(),
    )?;
    write(
        project.join(".specify/memory/constitution.md"),
        "# Constitution\n\n### I. Minimal\nChange only what the issue needs; keep existing behaviour and tests.\n\n### II. Honest\nA requirement that cannot be met as written is reported, never worked around.\n".to_owned(),
    )?;
    let first_line = issue
        .statement
        .lines()
        .find(|l| !l.trim().is_empty())
        .unwrap_or("Resolve the issue");
    let title: String = first_line
        .trim()
        .trim_start_matches('#')
        .trim()
        .chars()
        .take(70)
        .collect();
    write(
        fdir.join("spec.md"),
        format!(
            "# Feature Specification: {}\n\n## User Scenarios & Testing\n\n### User Story 1 - {title} (Priority: P1)\n\nAn issue reported against `{}`:\n\n{}\n\n## Requirements\n\n- **FR-001**: The behaviour the issue asks for works.\n- **FR-002**: Existing behaviour and tests are unchanged.\n",
            issue.id,
            issue.repo,
            issue.statement.trim()
        ),
    )?;
    write(
        fdir.join("plan.md"),
        format!(
            "# Implementation Plan: {}\n\nExisting repository `{}` at `{}`. Find the code the issue concerns and change it there; do not rewrite unrelated code. Tests: `{}`.\n",
            issue.id,
            issue.repo,
            issue.base_commit,
            test_cmd.join(" ")
        ),
    )?;
    write(
        fdir.join("tasks.md"),
        format!(
            "# Tasks: {}\n\n## Phase 1: User Story 1 - {title} (Priority: P1)\n\n- [ ] T001 [US1] Resolve the issue described in spec.md, with a test that fails before the change and passes after\n",
            issue.id
        ),
    )?;
    Ok(())
}