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 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 — Spec-Driven Development (SDD) 도구
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 이 도움말 표시
@@ -15,14 +15,15 @@ const scaffoldDir = () => {
15
15
  }
16
16
  throw new Error("scaffold 디렉터리를 찾을 수 없다");
17
17
  };
18
- const copyIfMissing = (src, dest) => {
19
- if (existsSync(dest))
20
- return false;
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 true;
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
- console.log("specthread init\n");
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 = ["config.jsonc", "rules.md", "project.md", "pending.md"];
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 created = copyIfMissing(join(scaffold, file), join(stDir, file));
85
- if (created)
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 created = copyIfMissing(join(scaffold, "templates", file), join(templatesDir, file));
94
- if (created)
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 = ["check.md", "gen.md", "plan-open.md", "plan-run.md", "plan-close.md"];
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 created = copyIfMissing(join(scaffold, "claude", "skills", file), join(skillsDir, file));
108
- if (created)
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 로 문서 정합성을 확인할 수 있다.");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specthread",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "Spec-Driven Development (SDD) template. Docs are the single source of truth; code implements docs.",
5
5
  "type": "module",
6
6
  "bin": {