specthread 0.1.3 → 0.1.4
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.
- package/README.md +2 -0
- package/dist/bin/cli.js +2 -1
- package/dist/commands/init.js +34 -22
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -34,6 +34,7 @@ CLAUDE.md ← Claude Code용 (@AGENTS.md)
|
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
36
|
npx specthread init [--tools claude,cursor] # 프로젝트 초기화
|
|
37
|
+
npx specthread init --force # scaffold 파일을 최신으로 덮어쓰기
|
|
37
38
|
npx specthread check # 문서 정합성 검사
|
|
38
39
|
npx specthread gen # 참조 절·목차·요약 표 미리보기
|
|
39
40
|
npx specthread gen --write # 실제 적용
|
|
@@ -64,6 +65,7 @@ specthread/config.local.jsonc (개인)
|
|
|
64
65
|
| 키 | 역할 |
|
|
65
66
|
| ----------- | ----------------------------------------------- |
|
|
66
67
|
| `path` | 스캔 대상 경로 (자유 KV) |
|
|
68
|
+
| `fileKinds` | 확장자 → 종류 매핑 (`doc` / `source`) |
|
|
67
69
|
| `features` | 기능 플래그 (`markers`, `emDash`, `references`) |
|
|
68
70
|
| `markers` | 마커 종류·시점 라벨 |
|
|
69
71
|
| `docTypes` | 경로별 템플릿·프론트매터 스키마 |
|
package/dist/bin/cli.js
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
const [command, ...rest] = process.argv.slice(2);
|
|
3
|
-
const usage = `specthread
|
|
3
|
+
const usage = `specthread - Spec-Driven Development (SDD) 도구
|
|
4
4
|
|
|
5
5
|
사용법: specthread <command> [options]
|
|
6
6
|
|
|
7
7
|
commands:
|
|
8
8
|
init [--tools claude,cursor] 프로젝트에 SDD 체계 초기화
|
|
9
|
+
init --force scaffold 파일을 최신으로 덮어쓰기
|
|
9
10
|
check 문서 정합성 검사 (28개 규칙)
|
|
10
11
|
gen [--write] 참조 절·목차·미확정 사항 요약 생성
|
|
11
12
|
help 이 도움말 표시
|
package/dist/commands/init.js
CHANGED
|
@@ -15,14 +15,15 @@ const scaffoldDir = () => {
|
|
|
15
15
|
}
|
|
16
16
|
throw new Error("scaffold 디렉터리를 찾을 수 없다");
|
|
17
17
|
};
|
|
18
|
-
const
|
|
19
|
-
if (existsSync(dest))
|
|
20
|
-
return
|
|
18
|
+
const copyFile = (src, dest, force) => {
|
|
19
|
+
if (existsSync(dest) && !force)
|
|
20
|
+
return "skipped";
|
|
21
|
+
const existed = existsSync(dest);
|
|
21
22
|
const dir = dirname(dest);
|
|
22
23
|
if (!existsSync(dir))
|
|
23
24
|
mkdirSync(dir, { recursive: true });
|
|
24
25
|
writeFileSync(dest, readFileSync(src, "utf8"), "utf8");
|
|
25
|
-
return
|
|
26
|
+
return existed ? "overwritten" : "created";
|
|
26
27
|
};
|
|
27
28
|
const ensureAgentsMd = (cwd, scaffold) => {
|
|
28
29
|
const dest = join(cwd, "AGENTS.md");
|
|
@@ -66,11 +67,20 @@ const parseTools = (args) => {
|
|
|
66
67
|
return new Set(["claude"]);
|
|
67
68
|
return new Set(args[idx + 1].split(",").map((t) => t.trim().toLowerCase()));
|
|
68
69
|
};
|
|
70
|
+
const STATUS_LABEL = {
|
|
71
|
+
created: "생성",
|
|
72
|
+
overwritten: "덮어씀",
|
|
73
|
+
skipped: "이미 존재. 건너뜀",
|
|
74
|
+
};
|
|
69
75
|
export const init = (args) => {
|
|
70
76
|
const cwd = process.cwd();
|
|
71
77
|
const scaffold = scaffoldDir();
|
|
72
78
|
const tools = parseTools(args);
|
|
73
|
-
|
|
79
|
+
const force = args.includes("--force");
|
|
80
|
+
if (force)
|
|
81
|
+
console.log("specthread init --force\n");
|
|
82
|
+
else
|
|
83
|
+
console.log("specthread init\n");
|
|
74
84
|
const stDir = join(cwd, "specthread");
|
|
75
85
|
if (existsSync(stDir)) {
|
|
76
86
|
console.log(" specthread/ 이미 존재 - 기존 설정 유지");
|
|
@@ -79,22 +89,21 @@ export const init = (args) => {
|
|
|
79
89
|
mkdirSync(stDir, { recursive: true });
|
|
80
90
|
console.log(" specthread/ 생성");
|
|
81
91
|
}
|
|
82
|
-
const specthreadFiles = [
|
|
92
|
+
const specthreadFiles = [
|
|
93
|
+
"config.jsonc",
|
|
94
|
+
"rules.md",
|
|
95
|
+
"project.md",
|
|
96
|
+
"pending.md",
|
|
97
|
+
];
|
|
83
98
|
for (const file of specthreadFiles) {
|
|
84
|
-
const
|
|
85
|
-
|
|
86
|
-
console.log(` specthread/${file} 생성`);
|
|
87
|
-
else
|
|
88
|
-
console.log(` specthread/${file} 이미 존재 - 건너뜀`);
|
|
99
|
+
const status = copyFile(join(scaffold, file), join(stDir, file), force);
|
|
100
|
+
console.log(` specthread/${file} ${STATUS_LABEL[status]}`);
|
|
89
101
|
}
|
|
90
102
|
const templateFiles = ["spec.md", "plan.md"];
|
|
91
103
|
const templatesDir = join(stDir, "templates");
|
|
92
104
|
for (const file of templateFiles) {
|
|
93
|
-
const
|
|
94
|
-
|
|
95
|
-
console.log(` specthread/templates/${file} 생성`);
|
|
96
|
-
else
|
|
97
|
-
console.log(` specthread/templates/${file} 이미 존재 - 건너뜀`);
|
|
105
|
+
const status = copyFile(join(scaffold, "templates", file), join(templatesDir, file), force);
|
|
106
|
+
console.log(` specthread/templates/${file} ${STATUS_LABEL[status]}`);
|
|
98
107
|
}
|
|
99
108
|
ensureAgentsMd(cwd, scaffold);
|
|
100
109
|
if (tools.has("claude")) {
|
|
@@ -102,13 +111,16 @@ export const init = (args) => {
|
|
|
102
111
|
const skillsDir = join(cwd, ".claude", "skills");
|
|
103
112
|
if (!existsSync(skillsDir))
|
|
104
113
|
mkdirSync(skillsDir, { recursive: true });
|
|
105
|
-
const skillFiles = [
|
|
114
|
+
const skillFiles = [
|
|
115
|
+
"check.md",
|
|
116
|
+
"gen.md",
|
|
117
|
+
"plan-open.md",
|
|
118
|
+
"plan-run.md",
|
|
119
|
+
"plan-close.md",
|
|
120
|
+
];
|
|
106
121
|
for (const file of skillFiles) {
|
|
107
|
-
const
|
|
108
|
-
|
|
109
|
-
console.log(` .claude/skills/${file} 생성`);
|
|
110
|
-
else
|
|
111
|
-
console.log(` .claude/skills/${file} 이미 존재 - 건너뜀`);
|
|
122
|
+
const status = copyFile(join(scaffold, "claude", "skills", file), join(skillsDir, file), force);
|
|
123
|
+
console.log(` .claude/skills/${file} ${STATUS_LABEL[status]}`);
|
|
112
124
|
}
|
|
113
125
|
}
|
|
114
126
|
console.log("\n완료. npx specthread check 로 문서 정합성을 확인할 수 있다.");
|