@organon-methodology/tools 0.3.0

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 (287) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +152 -0
  3. package/dist/cli/commands/coverage.d.ts +12 -0
  4. package/dist/cli/commands/coverage.d.ts.map +1 -0
  5. package/dist/cli/commands/coverage.js +80 -0
  6. package/dist/cli/commands/coverage.js.map +1 -0
  7. package/dist/cli/commands/find.d.ts +15 -0
  8. package/dist/cli/commands/find.d.ts.map +1 -0
  9. package/dist/cli/commands/find.js +81 -0
  10. package/dist/cli/commands/find.js.map +1 -0
  11. package/dist/cli/commands/generate-tests.d.ts +14 -0
  12. package/dist/cli/commands/generate-tests.d.ts.map +1 -0
  13. package/dist/cli/commands/generate-tests.js +87 -0
  14. package/dist/cli/commands/generate-tests.js.map +1 -0
  15. package/dist/cli/commands/generate.d.ts +15 -0
  16. package/dist/cli/commands/generate.d.ts.map +1 -0
  17. package/dist/cli/commands/generate.js +77 -0
  18. package/dist/cli/commands/generate.js.map +1 -0
  19. package/dist/cli/commands/health.d.ts +13 -0
  20. package/dist/cli/commands/health.d.ts.map +1 -0
  21. package/dist/cli/commands/health.js +79 -0
  22. package/dist/cli/commands/health.js.map +1 -0
  23. package/dist/cli/commands/init.d.ts +14 -0
  24. package/dist/cli/commands/init.d.ts.map +1 -0
  25. package/dist/cli/commands/init.js +132 -0
  26. package/dist/cli/commands/init.js.map +1 -0
  27. package/dist/cli/commands/mcp.d.ts +11 -0
  28. package/dist/cli/commands/mcp.d.ts.map +1 -0
  29. package/dist/cli/commands/mcp.js +26 -0
  30. package/dist/cli/commands/mcp.js.map +1 -0
  31. package/dist/cli/commands/query.d.ts +19 -0
  32. package/dist/cli/commands/query.d.ts.map +1 -0
  33. package/dist/cli/commands/query.js +103 -0
  34. package/dist/cli/commands/query.js.map +1 -0
  35. package/dist/cli/commands/upgrade.d.ts +13 -0
  36. package/dist/cli/commands/upgrade.d.ts.map +1 -0
  37. package/dist/cli/commands/upgrade.js +162 -0
  38. package/dist/cli/commands/upgrade.js.map +1 -0
  39. package/dist/cli/commands/validate.d.ts +13 -0
  40. package/dist/cli/commands/validate.d.ts.map +1 -0
  41. package/dist/cli/commands/validate.js +89 -0
  42. package/dist/cli/commands/validate.js.map +1 -0
  43. package/dist/cli/commands/verify.d.ts +12 -0
  44. package/dist/cli/commands/verify.d.ts.map +1 -0
  45. package/dist/cli/commands/verify.js +67 -0
  46. package/dist/cli/commands/verify.js.map +1 -0
  47. package/dist/cli/index.d.ts +19 -0
  48. package/dist/cli/index.d.ts.map +1 -0
  49. package/dist/cli/index.js +59 -0
  50. package/dist/cli/index.js.map +1 -0
  51. package/dist/core/add-protocols-array.d.ts +17 -0
  52. package/dist/core/add-protocols-array.d.ts.map +1 -0
  53. package/dist/core/add-protocols-array.js +95 -0
  54. package/dist/core/add-protocols-array.js.map +1 -0
  55. package/dist/core/add-protocols-array.test.d.ts +2 -0
  56. package/dist/core/add-protocols-array.test.d.ts.map +1 -0
  57. package/dist/core/add-protocols-array.test.js +86 -0
  58. package/dist/core/add-protocols-array.test.js.map +1 -0
  59. package/dist/core/config.d.ts +44 -0
  60. package/dist/core/config.d.ts.map +1 -0
  61. package/dist/core/config.js +130 -0
  62. package/dist/core/config.js.map +1 -0
  63. package/dist/core/config.test.d.ts +2 -0
  64. package/dist/core/config.test.d.ts.map +1 -0
  65. package/dist/core/config.test.js +88 -0
  66. package/dist/core/config.test.js.map +1 -0
  67. package/dist/core/find.d.ts +29 -0
  68. package/dist/core/find.d.ts.map +1 -0
  69. package/dist/core/find.js +191 -0
  70. package/dist/core/find.js.map +1 -0
  71. package/dist/core/find.test.d.ts +2 -0
  72. package/dist/core/find.test.d.ts.map +1 -0
  73. package/dist/core/find.test.js +91 -0
  74. package/dist/core/find.test.js.map +1 -0
  75. package/dist/core/frontmatter-parser.d.ts +45 -0
  76. package/dist/core/frontmatter-parser.d.ts.map +1 -0
  77. package/dist/core/frontmatter-parser.js +122 -0
  78. package/dist/core/frontmatter-parser.js.map +1 -0
  79. package/dist/core/frontmatter-parser.test.d.ts +2 -0
  80. package/dist/core/frontmatter-parser.test.d.ts.map +1 -0
  81. package/dist/core/frontmatter-parser.test.js +200 -0
  82. package/dist/core/frontmatter-parser.test.js.map +1 -0
  83. package/dist/core/generate-frontmatter.d.ts +27 -0
  84. package/dist/core/generate-frontmatter.d.ts.map +1 -0
  85. package/dist/core/generate-frontmatter.js +219 -0
  86. package/dist/core/generate-frontmatter.js.map +1 -0
  87. package/dist/core/generate-frontmatter.test.d.ts +2 -0
  88. package/dist/core/generate-frontmatter.test.d.ts.map +1 -0
  89. package/dist/core/generate-frontmatter.test.js +161 -0
  90. package/dist/core/generate-frontmatter.test.js.map +1 -0
  91. package/dist/core/generate-tests.d.ts +41 -0
  92. package/dist/core/generate-tests.d.ts.map +1 -0
  93. package/dist/core/generate-tests.js +191 -0
  94. package/dist/core/generate-tests.js.map +1 -0
  95. package/dist/core/generate-tests.test.d.ts +2 -0
  96. package/dist/core/generate-tests.test.d.ts.map +1 -0
  97. package/dist/core/generate-tests.test.js +205 -0
  98. package/dist/core/generate-tests.test.js.map +1 -0
  99. package/dist/core/health.d.ts +16 -0
  100. package/dist/core/health.d.ts.map +1 -0
  101. package/dist/core/health.js +156 -0
  102. package/dist/core/health.js.map +1 -0
  103. package/dist/core/health.test.d.ts +2 -0
  104. package/dist/core/health.test.d.ts.map +1 -0
  105. package/dist/core/health.test.js +97 -0
  106. package/dist/core/health.test.js.map +1 -0
  107. package/dist/core/init.d.ts +25 -0
  108. package/dist/core/init.d.ts.map +1 -0
  109. package/dist/core/init.js +100 -0
  110. package/dist/core/init.js.map +1 -0
  111. package/dist/core/init.test.d.ts +8 -0
  112. package/dist/core/init.test.d.ts.map +1 -0
  113. package/dist/core/init.test.js +203 -0
  114. package/dist/core/init.test.js.map +1 -0
  115. package/dist/core/invariant-coverage.d.ts +41 -0
  116. package/dist/core/invariant-coverage.d.ts.map +1 -0
  117. package/dist/core/invariant-coverage.js +181 -0
  118. package/dist/core/invariant-coverage.js.map +1 -0
  119. package/dist/core/invariant-coverage.test.d.ts +2 -0
  120. package/dist/core/invariant-coverage.test.d.ts.map +1 -0
  121. package/dist/core/invariant-coverage.test.js +188 -0
  122. package/dist/core/invariant-coverage.test.js.map +1 -0
  123. package/dist/core/meta-invariants.test.d.ts +17 -0
  124. package/dist/core/meta-invariants.test.d.ts.map +1 -0
  125. package/dist/core/meta-invariants.test.js +191 -0
  126. package/dist/core/meta-invariants.test.js.map +1 -0
  127. package/dist/core/node-fs.d.ts +22 -0
  128. package/dist/core/node-fs.d.ts.map +1 -0
  129. package/dist/core/node-fs.js +47 -0
  130. package/dist/core/node-fs.js.map +1 -0
  131. package/dist/core/organon-invariants.test.d.ts +15 -0
  132. package/dist/core/organon-invariants.test.d.ts.map +1 -0
  133. package/dist/core/organon-invariants.test.js +149 -0
  134. package/dist/core/organon-invariants.test.js.map +1 -0
  135. package/dist/core/query.d.ts +35 -0
  136. package/dist/core/query.d.ts.map +1 -0
  137. package/dist/core/query.js +139 -0
  138. package/dist/core/query.js.map +1 -0
  139. package/dist/core/query.test.d.ts +2 -0
  140. package/dist/core/query.test.d.ts.map +1 -0
  141. package/dist/core/query.test.js +97 -0
  142. package/dist/core/query.test.js.map +1 -0
  143. package/dist/core/suggest-tools.d.ts +15 -0
  144. package/dist/core/suggest-tools.d.ts.map +1 -0
  145. package/dist/core/suggest-tools.js +139 -0
  146. package/dist/core/suggest-tools.js.map +1 -0
  147. package/dist/core/suggest-tools.test.d.ts +2 -0
  148. package/dist/core/suggest-tools.test.d.ts.map +1 -0
  149. package/dist/core/suggest-tools.test.js +122 -0
  150. package/dist/core/suggest-tools.test.js.map +1 -0
  151. package/dist/core/test-helpers.d.ts +63 -0
  152. package/dist/core/test-helpers.d.ts.map +1 -0
  153. package/dist/core/test-helpers.js +265 -0
  154. package/dist/core/test-helpers.js.map +1 -0
  155. package/dist/core/types.d.ts +277 -0
  156. package/dist/core/types.d.ts.map +1 -0
  157. package/dist/core/types.js +9 -0
  158. package/dist/core/types.js.map +1 -0
  159. package/dist/core/upgrade.d.ts +46 -0
  160. package/dist/core/upgrade.d.ts.map +1 -0
  161. package/dist/core/upgrade.js +227 -0
  162. package/dist/core/upgrade.js.map +1 -0
  163. package/dist/core/upgrade.test.d.ts +8 -0
  164. package/dist/core/upgrade.test.d.ts.map +1 -0
  165. package/dist/core/upgrade.test.js +370 -0
  166. package/dist/core/upgrade.test.js.map +1 -0
  167. package/dist/core/validate-frontmatter.d.ts +20 -0
  168. package/dist/core/validate-frontmatter.d.ts.map +1 -0
  169. package/dist/core/validate-frontmatter.js +529 -0
  170. package/dist/core/validate-frontmatter.js.map +1 -0
  171. package/dist/core/validate-frontmatter.test.d.ts +2 -0
  172. package/dist/core/validate-frontmatter.test.d.ts.map +1 -0
  173. package/dist/core/validate-frontmatter.test.js +366 -0
  174. package/dist/core/validate-frontmatter.test.js.map +1 -0
  175. package/dist/core/validate-workflow.d.ts +17 -0
  176. package/dist/core/validate-workflow.d.ts.map +1 -0
  177. package/dist/core/validate-workflow.js +233 -0
  178. package/dist/core/validate-workflow.js.map +1 -0
  179. package/dist/core/validate-workflow.test.d.ts +2 -0
  180. package/dist/core/validate-workflow.test.d.ts.map +1 -0
  181. package/dist/core/validate-workflow.test.js +205 -0
  182. package/dist/core/validate-workflow.test.js.map +1 -0
  183. package/dist/core/verify-tier4-tests.d.ts +34 -0
  184. package/dist/core/verify-tier4-tests.d.ts.map +1 -0
  185. package/dist/core/verify-tier4-tests.js +106 -0
  186. package/dist/core/verify-tier4-tests.js.map +1 -0
  187. package/dist/core/verify-tier4-tests.test.d.ts +2 -0
  188. package/dist/core/verify-tier4-tests.test.d.ts.map +1 -0
  189. package/dist/core/verify-tier4-tests.test.js +140 -0
  190. package/dist/core/verify-tier4-tests.test.js.map +1 -0
  191. package/dist/core/verify-triplets.d.ts +17 -0
  192. package/dist/core/verify-triplets.d.ts.map +1 -0
  193. package/dist/core/verify-triplets.js +217 -0
  194. package/dist/core/verify-triplets.js.map +1 -0
  195. package/dist/core/verify-triplets.test.d.ts +2 -0
  196. package/dist/core/verify-triplets.test.d.ts.map +1 -0
  197. package/dist/core/verify-triplets.test.js +147 -0
  198. package/dist/core/verify-triplets.test.js.map +1 -0
  199. package/dist/core/verify.d.ts +19 -0
  200. package/dist/core/verify.d.ts.map +1 -0
  201. package/dist/core/verify.js +162 -0
  202. package/dist/core/verify.js.map +1 -0
  203. package/dist/core/verify.test.d.ts +2 -0
  204. package/dist/core/verify.test.d.ts.map +1 -0
  205. package/dist/core/verify.test.js +147 -0
  206. package/dist/core/verify.test.js.map +1 -0
  207. package/dist/index.d.ts +31 -0
  208. package/dist/index.d.ts.map +1 -0
  209. package/dist/index.js +27 -0
  210. package/dist/index.js.map +1 -0
  211. package/dist/mcp/prompts.d.ts +9 -0
  212. package/dist/mcp/prompts.d.ts.map +1 -0
  213. package/dist/mcp/prompts.js +265 -0
  214. package/dist/mcp/prompts.js.map +1 -0
  215. package/dist/mcp/resources.d.ts +7 -0
  216. package/dist/mcp/resources.d.ts.map +1 -0
  217. package/dist/mcp/resources.js +111 -0
  218. package/dist/mcp/resources.js.map +1 -0
  219. package/dist/mcp/server.d.ts +7 -0
  220. package/dist/mcp/server.d.ts.map +1 -0
  221. package/dist/mcp/server.js +31 -0
  222. package/dist/mcp/server.js.map +1 -0
  223. package/dist/mcp/tools.d.ts +7 -0
  224. package/dist/mcp/tools.d.ts.map +1 -0
  225. package/dist/mcp/tools.js +130 -0
  226. package/dist/mcp/tools.js.map +1 -0
  227. package/dist/templates/config.d.ts +6 -0
  228. package/dist/templates/config.d.ts.map +1 -0
  229. package/dist/templates/config.js +30 -0
  230. package/dist/templates/config.js.map +1 -0
  231. package/dist/templates/index.d.ts +7 -0
  232. package/dist/templates/index.d.ts.map +1 -0
  233. package/dist/templates/index.js +7 -0
  234. package/dist/templates/index.js.map +1 -0
  235. package/dist/templates/organon/claude-md.d.ts +7 -0
  236. package/dist/templates/organon/claude-md.d.ts.map +1 -0
  237. package/dist/templates/organon/claude-md.js +32 -0
  238. package/dist/templates/organon/claude-md.js.map +1 -0
  239. package/dist/templates/organon/ethos.d.ts +5 -0
  240. package/dist/templates/organon/ethos.d.ts.map +1 -0
  241. package/dist/templates/organon/ethos.js +69 -0
  242. package/dist/templates/organon/ethos.js.map +1 -0
  243. package/dist/templates/organon/index.d.ts +10 -0
  244. package/dist/templates/organon/index.d.ts.map +1 -0
  245. package/dist/templates/organon/index.js +10 -0
  246. package/dist/templates/organon/index.js.map +1 -0
  247. package/dist/templates/organon/observations-readme.d.ts +5 -0
  248. package/dist/templates/organon/observations-readme.d.ts.map +1 -0
  249. package/dist/templates/organon/observations-readme.js +25 -0
  250. package/dist/templates/organon/observations-readme.js.map +1 -0
  251. package/dist/templates/organon/philosophy.d.ts +5 -0
  252. package/dist/templates/organon/philosophy.d.ts.map +1 -0
  253. package/dist/templates/organon/philosophy.js +75 -0
  254. package/dist/templates/organon/philosophy.js.map +1 -0
  255. package/dist/templates/organon/protocols.d.ts +7 -0
  256. package/dist/templates/organon/protocols.d.ts.map +1 -0
  257. package/dist/templates/organon/protocols.js +197 -0
  258. package/dist/templates/organon/protocols.js.map +1 -0
  259. package/dist/templates/organon/readme.d.ts +5 -0
  260. package/dist/templates/organon/readme.d.ts.map +1 -0
  261. package/dist/templates/organon/readme.js +40 -0
  262. package/dist/templates/organon/readme.js.map +1 -0
  263. package/dist/templates/skills/domain-feature-design.d.ts +9 -0
  264. package/dist/templates/skills/domain-feature-design.d.ts.map +1 -0
  265. package/dist/templates/skills/domain-feature-design.js +123 -0
  266. package/dist/templates/skills/domain-feature-design.js.map +1 -0
  267. package/dist/templates/skills/index.d.ts +15 -0
  268. package/dist/templates/skills/index.d.ts.map +1 -0
  269. package/dist/templates/skills/index.js +35 -0
  270. package/dist/templates/skills/index.js.map +1 -0
  271. package/dist/templates/skills/organon-file-creation.d.ts +9 -0
  272. package/dist/templates/skills/organon-file-creation.d.ts.map +1 -0
  273. package/dist/templates/skills/organon-file-creation.js +138 -0
  274. package/dist/templates/skills/organon-file-creation.js.map +1 -0
  275. package/dist/templates/skills/quality-review.d.ts +9 -0
  276. package/dist/templates/skills/quality-review.d.ts.map +1 -0
  277. package/dist/templates/skills/quality-review.js +127 -0
  278. package/dist/templates/skills/quality-review.js.map +1 -0
  279. package/dist/templates/skills/session-compounding.d.ts +9 -0
  280. package/dist/templates/skills/session-compounding.d.ts.map +1 -0
  281. package/dist/templates/skills/session-compounding.js +118 -0
  282. package/dist/templates/skills/session-compounding.js.map +1 -0
  283. package/dist/templates/skills/verify-and-health.d.ts +9 -0
  284. package/dist/templates/skills/verify-and-health.d.ts.map +1 -0
  285. package/dist/templates/skills/verify-and-health.js +99 -0
  286. package/dist/templates/skills/verify-and-health.js.map +1 -0
  287. package/package.json +72 -0
@@ -0,0 +1,156 @@
1
+ /**
2
+ * Health dashboard.
3
+ *
4
+ * Reports coverage (% files with frontmatter), validation status,
5
+ * token analysis, freshness, and overall health score.
6
+ */
7
+ import { estimateTokens, parseOrganonFile } from './frontmatter-parser.js';
8
+ import { validateFrontmatter } from './validate-frontmatter.js';
9
+ import { joinPath } from './config.js';
10
+ // ---------------------------------------------------------------------------
11
+ // Main
12
+ // ---------------------------------------------------------------------------
13
+ export async function health(options) {
14
+ const { projectRoot, config, fs } = options;
15
+ const errors = [];
16
+ const warnings = [];
17
+ const issues = [];
18
+ // Discover organon files
19
+ const allFiles = await discoverOrganonFiles(projectRoot, config, fs);
20
+ // Parse all files
21
+ const parsed = [];
22
+ for (const file of allFiles) {
23
+ const absPath = joinPath(projectRoot, file);
24
+ try {
25
+ const content = await fs.readFile(absPath);
26
+ parsed.push(parseOrganonFile(file, content));
27
+ }
28
+ catch {
29
+ errors.push({
30
+ severity: 'error',
31
+ code: 'FILE_READ_ERROR',
32
+ message: `Cannot read file: ${file}`,
33
+ file,
34
+ });
35
+ }
36
+ }
37
+ // Coverage
38
+ const withFrontmatter = parsed.filter((f) => f.frontmatter !== null);
39
+ const coverage = {
40
+ totalFiles: parsed.length,
41
+ withFrontmatter: withFrontmatter.length,
42
+ percentage: parsed.length > 0 ? Math.round((withFrontmatter.length / parsed.length) * 100) : 0,
43
+ };
44
+ if (coverage.percentage < 100) {
45
+ const missingFiles = parsed.filter((f) => f.frontmatter === null);
46
+ for (const f of missingFiles) {
47
+ issues.push({
48
+ severity: 'warning',
49
+ code: 'HEALTH_MISSING_FRONTMATTER',
50
+ message: `Missing frontmatter: ${f.path}`,
51
+ file: f.path,
52
+ suggestion: options.fixSuggestions ? 'Run: organon generate <file>' : undefined,
53
+ });
54
+ }
55
+ }
56
+ // Validation
57
+ const validationResult = await validateFrontmatter({
58
+ projectRoot,
59
+ config,
60
+ fs,
61
+ stages: [1, 3], // Schema + truthfulness only (faster than full validation)
62
+ });
63
+ const validation = {
64
+ passing: validationResult.filesChecked - validationResult.filesWithErrors,
65
+ failing: validationResult.filesWithErrors,
66
+ warnings: validationResult.filesWithWarnings,
67
+ };
68
+ // Push validation issues
69
+ for (const r of validationResult.results) {
70
+ for (const e of r.errors)
71
+ issues.push(e);
72
+ for (const w of r.warnings)
73
+ issues.push(w);
74
+ }
75
+ // Token analysis
76
+ const tokenEstimates = withFrontmatter
77
+ .map((f) => ({ file: f.path, tokens: f.frontmatter.token_estimate ?? estimateTokens(f.content) }))
78
+ .sort((a, b) => b.tokens - a.tokens);
79
+ const totalTokens = tokenEstimates.reduce((sum, t) => sum + t.tokens, 0);
80
+ const tokens = {
81
+ total: totalTokens,
82
+ average: tokenEstimates.length > 0 ? Math.round(totalTokens / tokenEstimates.length) : 0,
83
+ largest: tokenEstimates.length > 0 ? tokenEstimates[0] : { file: '', tokens: 0 },
84
+ smallest: tokenEstimates.length > 0 ? tokenEstimates[tokenEstimates.length - 1] : { file: '', tokens: 0 },
85
+ };
86
+ // Freshness
87
+ const now = new Date();
88
+ const thresholdMs = config.freshnessThresholdHours * 60 * 60 * 1000;
89
+ let fresh = 0;
90
+ let stale = 0;
91
+ let unknown = 0;
92
+ let stalestFile;
93
+ for (const file of allFiles) {
94
+ const absPath = joinPath(projectRoot, file);
95
+ try {
96
+ const stat = await fs.stat(absPath);
97
+ const ageMs = now.getTime() - stat.mtime.getTime();
98
+ if (ageMs > thresholdMs) {
99
+ stale++;
100
+ if (!stalestFile || stat.mtime < stalestFile.lastModified) {
101
+ stalestFile = { file, lastModified: stat.mtime };
102
+ }
103
+ }
104
+ else {
105
+ fresh++;
106
+ }
107
+ }
108
+ catch {
109
+ unknown++;
110
+ }
111
+ }
112
+ const freshness = { fresh, stale, unknown, stalestFile };
113
+ // Score calculation (0-100)
114
+ const coverageScore = coverage.percentage; // 0-100
115
+ const validationScore = validationResult.filesChecked > 0
116
+ ? Math.round(((validationResult.filesChecked - validationResult.filesWithErrors) / validationResult.filesChecked) * 100)
117
+ : 100;
118
+ const freshnessScore = allFiles.length > 0
119
+ ? Math.round((fresh / allFiles.length) * 100)
120
+ : 100;
121
+ // Weighted average: coverage 40%, validation 40%, freshness 20%
122
+ const score = Math.round(coverageScore * 0.4 +
123
+ validationScore * 0.4 +
124
+ freshnessScore * 0.2);
125
+ return {
126
+ success: errors.length === 0,
127
+ score,
128
+ coverage,
129
+ validation,
130
+ tokens,
131
+ freshness,
132
+ issues,
133
+ errors,
134
+ warnings,
135
+ };
136
+ }
137
+ // ---------------------------------------------------------------------------
138
+ // Helpers
139
+ // ---------------------------------------------------------------------------
140
+ async function discoverOrganonFiles(projectRoot, config, fs) {
141
+ const allFiles = new Set();
142
+ for (const organonPath of config.organonPaths) {
143
+ for (const pattern of config.organonGlobs) {
144
+ const fullPattern = organonPath === '.' ? pattern : `${organonPath}/${pattern}`;
145
+ const matches = await fs.glob(fullPattern, {
146
+ cwd: projectRoot,
147
+ ignore: config.ignorePatterns,
148
+ });
149
+ for (const m of matches) {
150
+ allFiles.add(m);
151
+ }
152
+ }
153
+ }
154
+ return [...allFiles].sort();
155
+ }
156
+ //# sourceMappingURL=health.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=health.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.test.d.ts","sourceRoot":"","sources":["../../src/core/health.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,97 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { health } from './health.js';
3
+ import { MemoryFileSystem, makeEthos, makeReadme } from './test-helpers.js';
4
+ function makeConfig(projectRoot) {
5
+ return {
6
+ projectRoot,
7
+ organonPaths: ['.'],
8
+ organonGlobs: ['**/ETHOS.md', '**/README.md'],
9
+ ignorePatterns: [],
10
+ workflowPaths: {},
11
+ freshnessThresholdHours: 24,
12
+ };
13
+ }
14
+ describe('health', () => {
15
+ it('reports 100% coverage when all files have frontmatter', async () => {
16
+ const fs = new MemoryFileSystem({
17
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
18
+ '/project/README.md': makeReadme({ name: 'root', scope: 'product' }),
19
+ });
20
+ const config = makeConfig('/project');
21
+ const result = await health({ projectRoot: '/project', config, fs });
22
+ expect(result.coverage.percentage).toBe(100);
23
+ });
24
+ it('reports partial coverage', async () => {
25
+ const fs = new MemoryFileSystem({
26
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
27
+ '/project/README.md': '# No frontmatter here',
28
+ });
29
+ const config = makeConfig('/project');
30
+ const result = await health({ projectRoot: '/project', config, fs });
31
+ expect(result.coverage.percentage).toBe(50);
32
+ expect(result.coverage.withFrontmatter).toBe(1);
33
+ expect(result.coverage.totalFiles).toBe(2);
34
+ });
35
+ it('calculates a health score', async () => {
36
+ const fs = new MemoryFileSystem({
37
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
38
+ });
39
+ const config = makeConfig('/project');
40
+ const result = await health({ projectRoot: '/project', config, fs });
41
+ expect(result.score).toBeGreaterThanOrEqual(0);
42
+ expect(result.score).toBeLessThanOrEqual(100);
43
+ });
44
+ it('includes token analysis', async () => {
45
+ const fs = new MemoryFileSystem({
46
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
47
+ });
48
+ const config = makeConfig('/project');
49
+ const result = await health({ projectRoot: '/project', config, fs });
50
+ expect(result.tokens.total).toBeGreaterThan(0);
51
+ expect(result.tokens.average).toBeGreaterThan(0);
52
+ expect(result.tokens.largest.file).toBeTruthy();
53
+ });
54
+ it('reports freshness', async () => {
55
+ const fs = new MemoryFileSystem({
56
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
57
+ });
58
+ const config = makeConfig('/project');
59
+ const result = await health({ projectRoot: '/project', config, fs });
60
+ expect(result.freshness.fresh + result.freshness.stale + result.freshness.unknown)
61
+ .toBe(1);
62
+ });
63
+ it('detects stale files', async () => {
64
+ const fs = new MemoryFileSystem();
65
+ // Add file with old mtime
66
+ const oldDate = new Date(Date.now() - 48 * 60 * 60 * 1000); // 48h ago
67
+ fs.addFile('/project/ETHOS.md', makeEthos({ name: 'test', scope: 'product' }), oldDate);
68
+ const config = makeConfig('/project');
69
+ const result = await health({ projectRoot: '/project', config, fs });
70
+ expect(result.freshness.stale).toBe(1);
71
+ expect(result.freshness.stalestFile).toBeTruthy();
72
+ });
73
+ it('includes fix suggestions when requested', async () => {
74
+ const fs = new MemoryFileSystem({
75
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
76
+ '/project/README.md': '# No frontmatter',
77
+ });
78
+ const config = makeConfig('/project');
79
+ const result = await health({
80
+ projectRoot: '/project',
81
+ config,
82
+ fs,
83
+ fixSuggestions: true,
84
+ });
85
+ const missing = result.issues.find((i) => i.code === 'HEALTH_MISSING_FRONTMATTER');
86
+ expect(missing?.suggestion).toBeTruthy();
87
+ });
88
+ it('gives high score for perfect project', async () => {
89
+ const fs = new MemoryFileSystem({
90
+ '/project/ETHOS.md': makeEthos({ name: 'test', scope: 'product' }),
91
+ });
92
+ const config = makeConfig('/project');
93
+ const result = await health({ projectRoot: '/project', config, fs });
94
+ expect(result.score).toBeGreaterThanOrEqual(80);
95
+ });
96
+ });
97
+ //# sourceMappingURL=health.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.test.js","sourceRoot":"","sources":["../../src/core/health.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Pure init logic for `organon init`.
3
+ *
4
+ * Returns a file tree as Map<string, string> (path → content).
5
+ * Never writes directly — the CLI handler applies the result.
6
+ *
7
+ * @organon-invariant INV-TOOLS-5 idempotent-operations
8
+ */
9
+ import type { FileSystem, DiagnosticMessage } from './types.js';
10
+ export interface InitOptions {
11
+ projectRoot: string;
12
+ installSkills: boolean;
13
+ force: boolean;
14
+ fs: FileSystem;
15
+ }
16
+ export interface InitResult {
17
+ success: boolean;
18
+ /** Files to create: relative path → content */
19
+ files: Map<string, string>;
20
+ /** Files skipped because they already exist (and --force not set) */
21
+ skipped: string[];
22
+ diagnostics: DiagnosticMessage[];
23
+ }
24
+ export declare function init(options: InitOptions): Promise<InitResult>;
25
+ //# sourceMappingURL=init.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAiBhE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,UAAU,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAMD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAyFpE"}
@@ -0,0 +1,100 @@
1
+ /**
2
+ * Pure init logic for `organon init`.
3
+ *
4
+ * Returns a file tree as Map<string, string> (path → content).
5
+ * Never writes directly — the CLI handler applies the result.
6
+ *
7
+ * @organon-invariant INV-TOOLS-5 idempotent-operations
8
+ */
9
+ import { joinPath } from './config.js';
10
+ import { getSkillTemplates, ETHOS_TEMPLATE, PHILOSOPHY_TEMPLATE, README_TEMPLATE, PROTOCOLS_TEMPLATE, CLAUDE_MD_TEMPLATE, OBSERVATIONS_README_TEMPLATE, CONFIG_TEMPLATE, } from '../templates/index.js';
11
+ // ---------------------------------------------------------------------------
12
+ // Main
13
+ // ---------------------------------------------------------------------------
14
+ export async function init(options) {
15
+ const { projectRoot, installSkills, force, fs } = options;
16
+ const files = new Map();
17
+ const skipped = [];
18
+ const diagnostics = [];
19
+ // 1. Generate organon scaffold files
20
+ const organonFiles = [
21
+ ['organon.config.json', CONFIG_TEMPLATE],
22
+ ['CLAUDE.md', CLAUDE_MD_TEMPLATE],
23
+ ['organon/ETHOS.md', ETHOS_TEMPLATE],
24
+ ['organon/PHILOSOPHY.md', PHILOSOPHY_TEMPLATE],
25
+ ['organon/README.md', README_TEMPLATE],
26
+ ['organon/protocols/PROTOCOLS.md', PROTOCOLS_TEMPLATE],
27
+ ['organon/observations/README.md', OBSERVATIONS_README_TEMPLATE],
28
+ ];
29
+ for (const [relativePath, content] of organonFiles) {
30
+ try {
31
+ const fullPath = joinPath(projectRoot, relativePath);
32
+ const exists = await fs.exists(fullPath);
33
+ if (exists && !force) {
34
+ skipped.push(relativePath);
35
+ diagnostics.push({
36
+ severity: 'info',
37
+ code: 'INIT_FILE_EXISTS',
38
+ message: `Skipped (already exists): ${relativePath}`,
39
+ file: relativePath,
40
+ });
41
+ }
42
+ else {
43
+ files.set(relativePath, content);
44
+ }
45
+ }
46
+ catch (err) {
47
+ diagnostics.push({
48
+ severity: 'error',
49
+ code: 'INIT_CHECK_ERROR',
50
+ message: `Could not check ${relativePath}: ${err instanceof Error ? err.message : String(err)}`,
51
+ file: relativePath,
52
+ });
53
+ }
54
+ }
55
+ // 2. Generate skill files (if requested)
56
+ if (installSkills) {
57
+ const skillTemplates = getSkillTemplates();
58
+ for (const [, { path: relativePath, content }] of skillTemplates) {
59
+ try {
60
+ const fullPath = joinPath(projectRoot, relativePath);
61
+ const exists = await fs.exists(fullPath);
62
+ if (exists && !force) {
63
+ skipped.push(relativePath);
64
+ diagnostics.push({
65
+ severity: 'info',
66
+ code: 'INIT_SKILL_EXISTS',
67
+ message: `Skipped skill (already exists): ${relativePath}`,
68
+ file: relativePath,
69
+ });
70
+ }
71
+ else {
72
+ files.set(relativePath, content);
73
+ }
74
+ }
75
+ catch (err) {
76
+ diagnostics.push({
77
+ severity: 'error',
78
+ code: 'INIT_CHECK_ERROR',
79
+ message: `Could not check ${relativePath}: ${err instanceof Error ? err.message : String(err)}`,
80
+ file: relativePath,
81
+ });
82
+ }
83
+ }
84
+ }
85
+ // 3. Summary diagnostic
86
+ if (files.size === 0 && skipped.length > 0) {
87
+ diagnostics.push({
88
+ severity: 'info',
89
+ code: 'INIT_ALREADY_INITIALIZED',
90
+ message: `Project already initialized. All ${skipped.length} files exist. Use --force to overwrite.`,
91
+ });
92
+ }
93
+ return {
94
+ success: diagnostics.filter((d) => d.severity === 'error').length === 0,
95
+ files,
96
+ skipped,
97
+ diagnostics,
98
+ };
99
+ }
100
+ //# sourceMappingURL=init.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Tests for organon init core logic.
3
+ *
4
+ * @organon-invariant INV-TOOLS-2 every-command-has-tests
5
+ * @organon-invariant INV-TOOLS-5 idempotent-operations
6
+ */
7
+ export {};
8
+ //# sourceMappingURL=init.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.test.d.ts","sourceRoot":"","sources":["../../src/core/init.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
@@ -0,0 +1,203 @@
1
+ /**
2
+ * Tests for organon init core logic.
3
+ *
4
+ * @organon-invariant INV-TOOLS-2 every-command-has-tests
5
+ * @organon-invariant INV-TOOLS-5 idempotent-operations
6
+ */
7
+ import { describe, it, expect } from 'vitest';
8
+ import { init } from './init.js';
9
+ import { MemoryFileSystem } from './test-helpers.js';
10
+ import { getSkillTemplates, METHODOLOGY_VERSION } from '../templates/index.js';
11
+ describe('init', () => {
12
+ it('generates all organon scaffold files', async () => {
13
+ const fs = new MemoryFileSystem();
14
+ const result = await init({
15
+ projectRoot: '/project',
16
+ installSkills: false,
17
+ force: false,
18
+ fs,
19
+ });
20
+ expect(result.success).toBe(true);
21
+ expect(result.files.size).toBeGreaterThanOrEqual(7);
22
+ expect(result.files.has('organon.config.json')).toBe(true);
23
+ expect(result.files.has('CLAUDE.md')).toBe(true);
24
+ expect(result.files.has('organon/ETHOS.md')).toBe(true);
25
+ expect(result.files.has('organon/PHILOSOPHY.md')).toBe(true);
26
+ expect(result.files.has('organon/README.md')).toBe(true);
27
+ expect(result.files.has('organon/protocols/PROTOCOLS.md')).toBe(true);
28
+ expect(result.files.has('organon/observations/README.md')).toBe(true);
29
+ });
30
+ it('generates skill files when installSkills is true', async () => {
31
+ const fs = new MemoryFileSystem();
32
+ const result = await init({
33
+ projectRoot: '/project',
34
+ installSkills: true,
35
+ force: false,
36
+ fs,
37
+ });
38
+ expect(result.success).toBe(true);
39
+ expect(result.files.size).toBe(7 + getSkillTemplates().size);
40
+ expect(result.files.has('.claude/skills/domain-feature-design/SKILL.md')).toBe(true);
41
+ expect(result.files.has('.claude/skills/organon-file-creation/SKILL.md')).toBe(true);
42
+ expect(result.files.has('.claude/skills/quality-review/SKILL.md')).toBe(true);
43
+ expect(result.files.has('.claude/skills/session-compounding/SKILL.md')).toBe(true);
44
+ expect(result.files.has('.claude/skills/verify-and-health/SKILL.md')).toBe(true);
45
+ });
46
+ it('skips existing files without --force', async () => {
47
+ const fs = new MemoryFileSystem({
48
+ '/project/organon/ETHOS.md': '# Existing ethos',
49
+ '/project/organon.config.json': '{}',
50
+ });
51
+ const result = await init({
52
+ projectRoot: '/project',
53
+ installSkills: false,
54
+ force: false,
55
+ fs,
56
+ });
57
+ expect(result.success).toBe(true);
58
+ expect(result.skipped).toContain('organon/ETHOS.md');
59
+ expect(result.skipped).toContain('organon.config.json');
60
+ expect(result.files.has('organon/ETHOS.md')).toBe(false);
61
+ expect(result.files.has('organon.config.json')).toBe(false);
62
+ // Other files still generated
63
+ expect(result.files.has('organon/PHILOSOPHY.md')).toBe(true);
64
+ });
65
+ it('overwrites existing files with --force', async () => {
66
+ const fs = new MemoryFileSystem({
67
+ '/project/organon/ETHOS.md': '# Existing ethos',
68
+ });
69
+ const result = await init({
70
+ projectRoot: '/project',
71
+ installSkills: false,
72
+ force: true,
73
+ fs,
74
+ });
75
+ expect(result.success).toBe(true);
76
+ expect(result.skipped.length).toBe(0);
77
+ expect(result.files.has('organon/ETHOS.md')).toBe(true);
78
+ });
79
+ it('reports already-initialized when all files exist', async () => {
80
+ const fs = new MemoryFileSystem({
81
+ '/project/organon.config.json': '{}',
82
+ '/project/CLAUDE.md': '# claude',
83
+ '/project/organon/ETHOS.md': '# ethos',
84
+ '/project/organon/PHILOSOPHY.md': '# phil',
85
+ '/project/organon/README.md': '# readme',
86
+ '/project/organon/protocols/PROTOCOLS.md': '# protocols',
87
+ '/project/organon/observations/README.md': '# observations',
88
+ });
89
+ const result = await init({
90
+ projectRoot: '/project',
91
+ installSkills: false,
92
+ force: false,
93
+ fs,
94
+ });
95
+ expect(result.success).toBe(true);
96
+ expect(result.files.size).toBe(0);
97
+ expect(result.skipped.length).toBe(7);
98
+ const codes = result.diagnostics.map((d) => d.code);
99
+ expect(codes).toContain('INIT_ALREADY_INITIALIZED');
100
+ });
101
+ it('generates files with valid frontmatter', async () => {
102
+ const fs = new MemoryFileSystem();
103
+ const result = await init({
104
+ projectRoot: '/project',
105
+ installSkills: false,
106
+ force: false,
107
+ fs,
108
+ });
109
+ // Check that generated organon files have YAML frontmatter delimiters
110
+ // CLAUDE.md is not an organon file, so it doesn't need frontmatter
111
+ for (const [filePath, content] of result.files) {
112
+ if (filePath.endsWith('.md') && filePath !== 'CLAUDE.md') {
113
+ expect(content.startsWith('---\n'), `${filePath} should start with frontmatter`).toBe(true);
114
+ expect(content.includes('\n---\n'), `${filePath} should have closing frontmatter`).toBe(true);
115
+ }
116
+ }
117
+ });
118
+ it('generated config has methodology_version', async () => {
119
+ const fs = new MemoryFileSystem();
120
+ const result = await init({
121
+ projectRoot: '/project',
122
+ installSkills: false,
123
+ force: false,
124
+ fs,
125
+ });
126
+ const configContent = result.files.get('organon.config.json');
127
+ expect(configContent).toBeDefined();
128
+ const config = JSON.parse(configContent);
129
+ expect(config.methodology_version).toBe(METHODOLOGY_VERSION);
130
+ });
131
+ it('skill templates have methodology_version in frontmatter', async () => {
132
+ const fs = new MemoryFileSystem();
133
+ const result = await init({
134
+ projectRoot: '/project',
135
+ installSkills: true,
136
+ force: false,
137
+ fs,
138
+ });
139
+ for (const [path, content] of result.files) {
140
+ if (path.includes('.claude/skills/')) {
141
+ expect(content).toContain(`methodology_version: "${METHODOLOGY_VERSION}"`);
142
+ expect(content).toContain('protocol_id:');
143
+ expect(content).toContain('protocol_file:');
144
+ }
145
+ }
146
+ });
147
+ it('is idempotent — second run skips all files created by first', async () => {
148
+ const fs = new MemoryFileSystem();
149
+ // First run: generates all files
150
+ const result1 = await init({
151
+ projectRoot: '/project',
152
+ installSkills: true,
153
+ force: false,
154
+ fs,
155
+ });
156
+ expect(result1.files.size).toBeGreaterThan(0);
157
+ // Simulate writing the files to the FS
158
+ for (const [relativePath, content] of result1.files) {
159
+ fs.addFile(`/project/${relativePath}`, content);
160
+ }
161
+ // Second run: all files already exist, should skip everything
162
+ const result2 = await init({
163
+ projectRoot: '/project',
164
+ installSkills: true,
165
+ force: false,
166
+ fs,
167
+ });
168
+ expect(result2.files.size).toBe(0);
169
+ expect(result2.skipped.length).toBe(result1.files.size);
170
+ });
171
+ it('emits error diagnostic when fs.exists throws for organon files', async () => {
172
+ const fs = new MemoryFileSystem();
173
+ fs.throwOn('ETHOS.md');
174
+ const result = await init({
175
+ projectRoot: '/project',
176
+ installSkills: false,
177
+ force: false,
178
+ fs,
179
+ });
180
+ expect(result.success).toBe(false);
181
+ const errorDiags = result.diagnostics.filter((d) => d.severity === 'error');
182
+ expect(errorDiags.length).toBeGreaterThan(0);
183
+ expect(errorDiags.some((d) => d.code === 'INIT_CHECK_ERROR')).toBe(true);
184
+ // Other files not affected by the throw should still be generated
185
+ expect(result.files.has('organon/PHILOSOPHY.md')).toBe(true);
186
+ });
187
+ it('emits error diagnostic when fs.exists throws for skill files', async () => {
188
+ const fs = new MemoryFileSystem();
189
+ fs.throwOn('verify-and-health');
190
+ const result = await init({
191
+ projectRoot: '/project',
192
+ installSkills: true,
193
+ force: false,
194
+ fs,
195
+ });
196
+ expect(result.success).toBe(false);
197
+ const errorDiags = result.diagnostics.filter((d) => d.severity === 'error');
198
+ expect(errorDiags.some((d) => d.code === 'INIT_CHECK_ERROR' && d.file?.includes('verify-and-health'))).toBe(true);
199
+ // Other skills should still be generated
200
+ expect(result.files.has('.claude/skills/quality-review/SKILL.md')).toBe(true);
201
+ });
202
+ });
203
+ //# sourceMappingURL=init.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.test.js","sourceRoot":"","sources":["../../src/core/init.test.ts"],"names":[],"mappings":"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"}