synarcx 0.1.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 (288) hide show
  1. package/LICENSE +23 -0
  2. package/README.md +90 -0
  3. package/bin/synarcx.js +3 -0
  4. package/dist/cli/index.d.ts +2 -0
  5. package/dist/cli/index.js +474 -0
  6. package/dist/commands/change.d.ts +35 -0
  7. package/dist/commands/change.js +278 -0
  8. package/dist/commands/completion.d.ts +72 -0
  9. package/dist/commands/completion.js +264 -0
  10. package/dist/commands/config.d.ts +36 -0
  11. package/dist/commands/config.js +552 -0
  12. package/dist/commands/feedback.d.ts +9 -0
  13. package/dist/commands/feedback.js +170 -0
  14. package/dist/commands/schema.d.ts +6 -0
  15. package/dist/commands/schema.js +870 -0
  16. package/dist/commands/show.d.ts +14 -0
  17. package/dist/commands/show.js +132 -0
  18. package/dist/commands/spec.d.ts +15 -0
  19. package/dist/commands/spec.js +226 -0
  20. package/dist/commands/validate.d.ts +24 -0
  21. package/dist/commands/validate.js +295 -0
  22. package/dist/commands/workflow/index.d.ts +17 -0
  23. package/dist/commands/workflow/index.js +12 -0
  24. package/dist/commands/workflow/instructions.d.ts +29 -0
  25. package/dist/commands/workflow/instructions.js +327 -0
  26. package/dist/commands/workflow/new-change.d.ts +11 -0
  27. package/dist/commands/workflow/new-change.js +45 -0
  28. package/dist/commands/workflow/schemas.d.ts +10 -0
  29. package/dist/commands/workflow/schemas.js +34 -0
  30. package/dist/commands/workflow/shared.d.ts +57 -0
  31. package/dist/commands/workflow/shared.js +117 -0
  32. package/dist/commands/workflow/status.d.ts +14 -0
  33. package/dist/commands/workflow/status.js +75 -0
  34. package/dist/commands/workflow/templates.d.ts +16 -0
  35. package/dist/commands/workflow/templates.js +69 -0
  36. package/dist/commands/workspace/open.d.ts +29 -0
  37. package/dist/commands/workspace/open.js +84 -0
  38. package/dist/commands/workspace/operations.d.ts +18 -0
  39. package/dist/commands/workspace/operations.js +461 -0
  40. package/dist/commands/workspace/selection.d.ts +5 -0
  41. package/dist/commands/workspace/selection.js +90 -0
  42. package/dist/commands/workspace/types.d.ts +83 -0
  43. package/dist/commands/workspace/types.js +36 -0
  44. package/dist/commands/workspace.d.ts +3 -0
  45. package/dist/commands/workspace.js +635 -0
  46. package/dist/core/archive.d.ts +11 -0
  47. package/dist/core/archive.js +319 -0
  48. package/dist/core/artifact-graph/graph.d.ts +56 -0
  49. package/dist/core/artifact-graph/graph.js +141 -0
  50. package/dist/core/artifact-graph/index.d.ts +8 -0
  51. package/dist/core/artifact-graph/index.js +14 -0
  52. package/dist/core/artifact-graph/instruction-loader.d.ts +143 -0
  53. package/dist/core/artifact-graph/instruction-loader.js +217 -0
  54. package/dist/core/artifact-graph/outputs.d.ts +14 -0
  55. package/dist/core/artifact-graph/outputs.js +39 -0
  56. package/dist/core/artifact-graph/resolver.d.ts +81 -0
  57. package/dist/core/artifact-graph/resolver.js +258 -0
  58. package/dist/core/artifact-graph/schema.d.ts +13 -0
  59. package/dist/core/artifact-graph/schema.js +108 -0
  60. package/dist/core/artifact-graph/state.d.ts +12 -0
  61. package/dist/core/artifact-graph/state.js +31 -0
  62. package/dist/core/artifact-graph/types.d.ts +45 -0
  63. package/dist/core/artifact-graph/types.js +43 -0
  64. package/dist/core/available-tools.d.ts +17 -0
  65. package/dist/core/available-tools.js +43 -0
  66. package/dist/core/command-generation/adapters/amazon-q.d.ts +13 -0
  67. package/dist/core/command-generation/adapters/amazon-q.js +26 -0
  68. package/dist/core/command-generation/adapters/antigravity.d.ts +13 -0
  69. package/dist/core/command-generation/adapters/antigravity.js +26 -0
  70. package/dist/core/command-generation/adapters/auggie.d.ts +13 -0
  71. package/dist/core/command-generation/adapters/auggie.js +27 -0
  72. package/dist/core/command-generation/adapters/bob.d.ts +14 -0
  73. package/dist/core/command-generation/adapters/bob.js +45 -0
  74. package/dist/core/command-generation/adapters/claude.d.ts +13 -0
  75. package/dist/core/command-generation/adapters/claude.js +50 -0
  76. package/dist/core/command-generation/adapters/cline.d.ts +14 -0
  77. package/dist/core/command-generation/adapters/cline.js +27 -0
  78. package/dist/core/command-generation/adapters/codebuddy.d.ts +13 -0
  79. package/dist/core/command-generation/adapters/codebuddy.js +28 -0
  80. package/dist/core/command-generation/adapters/codex.d.ts +16 -0
  81. package/dist/core/command-generation/adapters/codex.js +39 -0
  82. package/dist/core/command-generation/adapters/continue.d.ts +13 -0
  83. package/dist/core/command-generation/adapters/continue.js +28 -0
  84. package/dist/core/command-generation/adapters/costrict.d.ts +13 -0
  85. package/dist/core/command-generation/adapters/costrict.js +27 -0
  86. package/dist/core/command-generation/adapters/crush.d.ts +13 -0
  87. package/dist/core/command-generation/adapters/crush.js +30 -0
  88. package/dist/core/command-generation/adapters/cursor.d.ts +14 -0
  89. package/dist/core/command-generation/adapters/cursor.js +44 -0
  90. package/dist/core/command-generation/adapters/factory.d.ts +13 -0
  91. package/dist/core/command-generation/adapters/factory.js +27 -0
  92. package/dist/core/command-generation/adapters/gemini.d.ts +13 -0
  93. package/dist/core/command-generation/adapters/gemini.js +26 -0
  94. package/dist/core/command-generation/adapters/github-copilot.d.ts +13 -0
  95. package/dist/core/command-generation/adapters/github-copilot.js +26 -0
  96. package/dist/core/command-generation/adapters/iflow.d.ts +13 -0
  97. package/dist/core/command-generation/adapters/iflow.js +29 -0
  98. package/dist/core/command-generation/adapters/index.d.ts +32 -0
  99. package/dist/core/command-generation/adapters/index.js +32 -0
  100. package/dist/core/command-generation/adapters/junie.d.ts +13 -0
  101. package/dist/core/command-generation/adapters/junie.js +26 -0
  102. package/dist/core/command-generation/adapters/kilocode.d.ts +14 -0
  103. package/dist/core/command-generation/adapters/kilocode.js +23 -0
  104. package/dist/core/command-generation/adapters/kiro.d.ts +13 -0
  105. package/dist/core/command-generation/adapters/kiro.js +26 -0
  106. package/dist/core/command-generation/adapters/lingma.d.ts +13 -0
  107. package/dist/core/command-generation/adapters/lingma.js +30 -0
  108. package/dist/core/command-generation/adapters/opencode.d.ts +13 -0
  109. package/dist/core/command-generation/adapters/opencode.js +27 -0
  110. package/dist/core/command-generation/adapters/pi.d.ts +18 -0
  111. package/dist/core/command-generation/adapters/pi.js +55 -0
  112. package/dist/core/command-generation/adapters/qoder.d.ts +13 -0
  113. package/dist/core/command-generation/adapters/qoder.js +30 -0
  114. package/dist/core/command-generation/adapters/qwen.d.ts +13 -0
  115. package/dist/core/command-generation/adapters/qwen.js +26 -0
  116. package/dist/core/command-generation/adapters/roocode.d.ts +14 -0
  117. package/dist/core/command-generation/adapters/roocode.js +27 -0
  118. package/dist/core/command-generation/adapters/windsurf.d.ts +14 -0
  119. package/dist/core/command-generation/adapters/windsurf.js +51 -0
  120. package/dist/core/command-generation/generator.d.ts +21 -0
  121. package/dist/core/command-generation/generator.js +27 -0
  122. package/dist/core/command-generation/index.d.ts +22 -0
  123. package/dist/core/command-generation/index.js +24 -0
  124. package/dist/core/command-generation/registry.d.ts +36 -0
  125. package/dist/core/command-generation/registry.js +98 -0
  126. package/dist/core/command-generation/types.d.ts +56 -0
  127. package/dist/core/command-generation/types.js +8 -0
  128. package/dist/core/completions/command-registry.d.ts +7 -0
  129. package/dist/core/completions/command-registry.js +596 -0
  130. package/dist/core/completions/completion-provider.d.ts +71 -0
  131. package/dist/core/completions/completion-provider.js +129 -0
  132. package/dist/core/completions/factory.d.ts +64 -0
  133. package/dist/core/completions/factory.js +75 -0
  134. package/dist/core/completions/generators/bash-generator.d.ts +35 -0
  135. package/dist/core/completions/generators/bash-generator.js +230 -0
  136. package/dist/core/completions/generators/fish-generator.d.ts +32 -0
  137. package/dist/core/completions/generators/fish-generator.js +160 -0
  138. package/dist/core/completions/generators/powershell-generator.d.ts +36 -0
  139. package/dist/core/completions/generators/powershell-generator.js +266 -0
  140. package/dist/core/completions/generators/zsh-generator.d.ts +47 -0
  141. package/dist/core/completions/generators/zsh-generator.js +274 -0
  142. package/dist/core/completions/installers/bash-installer.d.ts +87 -0
  143. package/dist/core/completions/installers/bash-installer.js +318 -0
  144. package/dist/core/completions/installers/fish-installer.d.ts +43 -0
  145. package/dist/core/completions/installers/fish-installer.js +143 -0
  146. package/dist/core/completions/installers/powershell-installer.d.ts +102 -0
  147. package/dist/core/completions/installers/powershell-installer.js +387 -0
  148. package/dist/core/completions/installers/zsh-installer.d.ts +117 -0
  149. package/dist/core/completions/installers/zsh-installer.js +421 -0
  150. package/dist/core/completions/templates/bash-templates.d.ts +6 -0
  151. package/dist/core/completions/templates/bash-templates.js +30 -0
  152. package/dist/core/completions/templates/fish-templates.d.ts +7 -0
  153. package/dist/core/completions/templates/fish-templates.js +45 -0
  154. package/dist/core/completions/templates/powershell-templates.d.ts +6 -0
  155. package/dist/core/completions/templates/powershell-templates.js +34 -0
  156. package/dist/core/completions/templates/zsh-templates.d.ts +6 -0
  157. package/dist/core/completions/templates/zsh-templates.js +45 -0
  158. package/dist/core/completions/types.d.ts +101 -0
  159. package/dist/core/completions/types.js +2 -0
  160. package/dist/core/config-prompts.d.ts +9 -0
  161. package/dist/core/config-prompts.js +34 -0
  162. package/dist/core/config-schema.d.ts +86 -0
  163. package/dist/core/config-schema.js +213 -0
  164. package/dist/core/config.d.ts +19 -0
  165. package/dist/core/config.js +38 -0
  166. package/dist/core/converters/json-converter.d.ts +6 -0
  167. package/dist/core/converters/json-converter.js +51 -0
  168. package/dist/core/global-config.d.ts +49 -0
  169. package/dist/core/global-config.js +124 -0
  170. package/dist/core/index.d.ts +3 -0
  171. package/dist/core/index.js +4 -0
  172. package/dist/core/init.d.ts +37 -0
  173. package/dist/core/init.js +585 -0
  174. package/dist/core/legacy-cleanup.d.ts +169 -0
  175. package/dist/core/legacy-cleanup.js +578 -0
  176. package/dist/core/list.d.ts +9 -0
  177. package/dist/core/list.js +172 -0
  178. package/dist/core/migration.d.ts +23 -0
  179. package/dist/core/migration.js +108 -0
  180. package/dist/core/parsers/change-parser.d.ts +13 -0
  181. package/dist/core/parsers/change-parser.js +197 -0
  182. package/dist/core/parsers/markdown-parser.d.ts +26 -0
  183. package/dist/core/parsers/markdown-parser.js +227 -0
  184. package/dist/core/parsers/requirement-blocks.d.ts +37 -0
  185. package/dist/core/parsers/requirement-blocks.js +201 -0
  186. package/dist/core/parsers/spec-structure.d.ts +9 -0
  187. package/dist/core/parsers/spec-structure.js +88 -0
  188. package/dist/core/profile-sync-drift.d.ts +38 -0
  189. package/dist/core/profile-sync-drift.js +197 -0
  190. package/dist/core/profiles.d.ts +26 -0
  191. package/dist/core/profiles.js +37 -0
  192. package/dist/core/project-config.d.ts +64 -0
  193. package/dist/core/project-config.js +224 -0
  194. package/dist/core/schemas/base.schema.d.ts +13 -0
  195. package/dist/core/schemas/base.schema.js +13 -0
  196. package/dist/core/schemas/change.schema.d.ts +73 -0
  197. package/dist/core/schemas/change.schema.js +31 -0
  198. package/dist/core/schemas/index.d.ts +4 -0
  199. package/dist/core/schemas/index.js +4 -0
  200. package/dist/core/schemas/spec.schema.d.ts +18 -0
  201. package/dist/core/schemas/spec.schema.js +15 -0
  202. package/dist/core/shared/index.d.ts +8 -0
  203. package/dist/core/shared/index.js +8 -0
  204. package/dist/core/shared/skill-generation.d.ts +49 -0
  205. package/dist/core/shared/skill-generation.js +90 -0
  206. package/dist/core/shared/tool-detection.d.ts +71 -0
  207. package/dist/core/shared/tool-detection.js +152 -0
  208. package/dist/core/specs-apply.d.ts +73 -0
  209. package/dist/core/specs-apply.js +393 -0
  210. package/dist/core/styles/palette.d.ts +7 -0
  211. package/dist/core/styles/palette.js +8 -0
  212. package/dist/core/templates/index.d.ts +8 -0
  213. package/dist/core/templates/index.js +9 -0
  214. package/dist/core/templates/skill-templates.d.ts +15 -0
  215. package/dist/core/templates/skill-templates.js +14 -0
  216. package/dist/core/templates/types.d.ts +19 -0
  217. package/dist/core/templates/types.js +5 -0
  218. package/dist/core/templates/workflows/analyze.d.ts +4 -0
  219. package/dist/core/templates/workflows/analyze.js +101 -0
  220. package/dist/core/templates/workflows/apply-change.d.ts +10 -0
  221. package/dist/core/templates/workflows/apply-change.js +308 -0
  222. package/dist/core/templates/workflows/archive-change.d.ts +10 -0
  223. package/dist/core/templates/workflows/archive-change.js +271 -0
  224. package/dist/core/templates/workflows/clarify.d.ts +4 -0
  225. package/dist/core/templates/workflows/clarify.js +108 -0
  226. package/dist/core/templates/workflows/debug.d.ts +4 -0
  227. package/dist/core/templates/workflows/debug.js +117 -0
  228. package/dist/core/templates/workflows/explore.d.ts +10 -0
  229. package/dist/core/templates/workflows/explore.js +479 -0
  230. package/dist/core/templates/workflows/propose.d.ts +10 -0
  231. package/dist/core/templates/workflows/propose.js +216 -0
  232. package/dist/core/templates/workflows/sync.d.ts +4 -0
  233. package/dist/core/templates/workflows/sync.js +108 -0
  234. package/dist/core/update.d.ts +82 -0
  235. package/dist/core/update.js +555 -0
  236. package/dist/core/validation/constants.d.ts +34 -0
  237. package/dist/core/validation/constants.js +40 -0
  238. package/dist/core/validation/types.d.ts +18 -0
  239. package/dist/core/validation/types.js +2 -0
  240. package/dist/core/validation/validator.d.ts +33 -0
  241. package/dist/core/validation/validator.js +418 -0
  242. package/dist/core/view.d.ts +8 -0
  243. package/dist/core/view.js +169 -0
  244. package/dist/core/workspace/foundation.d.ts +79 -0
  245. package/dist/core/workspace/foundation.js +367 -0
  246. package/dist/core/workspace/index.d.ts +5 -0
  247. package/dist/core/workspace/index.js +5 -0
  248. package/dist/core/workspace/link-input.d.ts +9 -0
  249. package/dist/core/workspace/link-input.js +32 -0
  250. package/dist/core/workspace/open-surface.d.ts +24 -0
  251. package/dist/core/workspace/open-surface.js +137 -0
  252. package/dist/core/workspace/openers.d.ts +21 -0
  253. package/dist/core/workspace/openers.js +119 -0
  254. package/dist/index.d.ts +3 -0
  255. package/dist/index.js +3 -0
  256. package/dist/prompts/searchable-multi-select.d.ts +28 -0
  257. package/dist/prompts/searchable-multi-select.js +159 -0
  258. package/dist/ui/ascii-patterns.d.ts +25 -0
  259. package/dist/ui/ascii-patterns.js +140 -0
  260. package/dist/ui/welcome-screen.d.ts +10 -0
  261. package/dist/ui/welcome-screen.js +144 -0
  262. package/dist/utils/change-metadata.d.ts +51 -0
  263. package/dist/utils/change-metadata.js +147 -0
  264. package/dist/utils/change-utils.d.ts +62 -0
  265. package/dist/utils/change-utils.js +122 -0
  266. package/dist/utils/command-references.d.ts +18 -0
  267. package/dist/utils/command-references.js +20 -0
  268. package/dist/utils/file-system.d.ts +41 -0
  269. package/dist/utils/file-system.js +301 -0
  270. package/dist/utils/index.d.ts +6 -0
  271. package/dist/utils/index.js +9 -0
  272. package/dist/utils/interactive.d.ts +18 -0
  273. package/dist/utils/interactive.js +21 -0
  274. package/dist/utils/item-discovery.d.ts +4 -0
  275. package/dist/utils/item-discovery.js +73 -0
  276. package/dist/utils/match.d.ts +3 -0
  277. package/dist/utils/match.js +22 -0
  278. package/dist/utils/shell-detection.d.ts +20 -0
  279. package/dist/utils/shell-detection.js +41 -0
  280. package/dist/utils/task-progress.d.ts +8 -0
  281. package/dist/utils/task-progress.js +36 -0
  282. package/package.json +76 -0
  283. package/schemas/synarcx/schema.yaml +153 -0
  284. package/schemas/synarcx/templates/design.md +19 -0
  285. package/schemas/synarcx/templates/proposal.md +23 -0
  286. package/schemas/synarcx/templates/spec.md +8 -0
  287. package/schemas/synarcx/templates/tasks.md +9 -0
  288. package/scripts/postinstall.js +83 -0
@@ -0,0 +1,393 @@
1
+ /**
2
+ * Spec Application Logic
3
+ *
4
+ * Extracted from ArchiveCommand to enable standalone spec application.
5
+ * Applies delta specs from a change to main specs without archiving.
6
+ */
7
+ import { promises as fs } from 'fs';
8
+ import path from 'path';
9
+ import chalk from 'chalk';
10
+ import { SYNSPEC_DIR_NAME } from './config.js';
11
+ import { extractRequirementsSection, parseDeltaSpec, normalizeRequirementName, } from './parsers/requirement-blocks.js';
12
+ import { findMainSpecStructureIssues } from './parsers/spec-structure.js';
13
+ import { Validator } from './validation/validator.js';
14
+ // -----------------------------------------------------------------------------
15
+ // Public API
16
+ // -----------------------------------------------------------------------------
17
+ /**
18
+ * Find all delta spec files that need to be applied from a change.
19
+ */
20
+ export async function findSpecUpdates(changeDir, mainSpecsDir) {
21
+ const updates = [];
22
+ const changeSpecsDir = path.join(changeDir, 'specs');
23
+ try {
24
+ const entries = await fs.readdir(changeSpecsDir, { withFileTypes: true });
25
+ for (const entry of entries) {
26
+ if (entry.isDirectory()) {
27
+ const specFile = path.join(changeSpecsDir, entry.name, 'spec.md');
28
+ const targetFile = path.join(mainSpecsDir, entry.name, 'spec.md');
29
+ try {
30
+ await fs.access(specFile);
31
+ // Check if target exists
32
+ let exists = false;
33
+ try {
34
+ await fs.access(targetFile);
35
+ exists = true;
36
+ }
37
+ catch {
38
+ exists = false;
39
+ }
40
+ updates.push({
41
+ source: specFile,
42
+ target: targetFile,
43
+ exists,
44
+ });
45
+ }
46
+ catch {
47
+ // Source spec doesn't exist, skip
48
+ }
49
+ }
50
+ }
51
+ }
52
+ catch {
53
+ // No specs directory in change
54
+ }
55
+ return updates;
56
+ }
57
+ /**
58
+ * Build an updated spec by applying delta operations.
59
+ * Returns the rebuilt content and counts of operations.
60
+ */
61
+ export async function buildUpdatedSpec(update, changeName) {
62
+ // Read change spec content (delta-format expected)
63
+ const changeContent = await fs.readFile(update.source, 'utf-8');
64
+ // Parse deltas from the change spec file
65
+ const plan = parseDeltaSpec(changeContent);
66
+ const specName = path.basename(path.dirname(update.target));
67
+ // Pre-validate duplicates within sections
68
+ const addedNames = new Set();
69
+ for (const add of plan.added) {
70
+ const name = normalizeRequirementName(add.name);
71
+ if (addedNames.has(name)) {
72
+ throw new Error(`${specName} validation failed - duplicate requirement in ADDED for header "### Requirement: ${add.name}"`);
73
+ }
74
+ addedNames.add(name);
75
+ }
76
+ const modifiedNames = new Set();
77
+ for (const mod of plan.modified) {
78
+ const name = normalizeRequirementName(mod.name);
79
+ if (modifiedNames.has(name)) {
80
+ throw new Error(`${specName} validation failed - duplicate requirement in MODIFIED for header "### Requirement: ${mod.name}"`);
81
+ }
82
+ modifiedNames.add(name);
83
+ }
84
+ const removedNamesSet = new Set();
85
+ for (const rem of plan.removed) {
86
+ const name = normalizeRequirementName(rem);
87
+ if (removedNamesSet.has(name)) {
88
+ throw new Error(`${specName} validation failed - duplicate requirement in REMOVED for header "### Requirement: ${rem}"`);
89
+ }
90
+ removedNamesSet.add(name);
91
+ }
92
+ const renamedFromSet = new Set();
93
+ const renamedToSet = new Set();
94
+ for (const { from, to } of plan.renamed) {
95
+ const fromNorm = normalizeRequirementName(from);
96
+ const toNorm = normalizeRequirementName(to);
97
+ if (renamedFromSet.has(fromNorm)) {
98
+ throw new Error(`${specName} validation failed - duplicate FROM in RENAMED for header "### Requirement: ${from}"`);
99
+ }
100
+ if (renamedToSet.has(toNorm)) {
101
+ throw new Error(`${specName} validation failed - duplicate TO in RENAMED for header "### Requirement: ${to}"`);
102
+ }
103
+ renamedFromSet.add(fromNorm);
104
+ renamedToSet.add(toNorm);
105
+ }
106
+ // Pre-validate cross-section conflicts
107
+ const conflicts = [];
108
+ for (const n of modifiedNames) {
109
+ if (removedNamesSet.has(n))
110
+ conflicts.push({ name: n, a: 'MODIFIED', b: 'REMOVED' });
111
+ if (addedNames.has(n))
112
+ conflicts.push({ name: n, a: 'MODIFIED', b: 'ADDED' });
113
+ }
114
+ for (const n of addedNames) {
115
+ if (removedNamesSet.has(n))
116
+ conflicts.push({ name: n, a: 'ADDED', b: 'REMOVED' });
117
+ }
118
+ // Renamed interplay: MODIFIED must reference the NEW header, not FROM
119
+ for (const { from, to } of plan.renamed) {
120
+ const fromNorm = normalizeRequirementName(from);
121
+ const toNorm = normalizeRequirementName(to);
122
+ if (modifiedNames.has(fromNorm)) {
123
+ throw new Error(`${specName} validation failed - when a rename exists, MODIFIED must reference the NEW header "### Requirement: ${to}"`);
124
+ }
125
+ // Detect ADDED colliding with a RENAMED TO
126
+ if (addedNames.has(toNorm)) {
127
+ throw new Error(`${specName} validation failed - RENAMED TO header collides with ADDED for "### Requirement: ${to}"`);
128
+ }
129
+ }
130
+ if (conflicts.length > 0) {
131
+ const c = conflicts[0];
132
+ throw new Error(`${specName} validation failed - requirement present in multiple sections (${c.a} and ${c.b}) for header "### Requirement: ${c.name}"`);
133
+ }
134
+ const hasAnyDelta = plan.added.length + plan.modified.length + plan.removed.length + plan.renamed.length > 0;
135
+ if (!hasAnyDelta) {
136
+ throw new Error(`Delta parsing found no operations for ${path.basename(path.dirname(update.source))}. ` +
137
+ `Provide ADDED/MODIFIED/REMOVED/RENAMED sections in change spec.`);
138
+ }
139
+ // Load or create base target content
140
+ let targetContent;
141
+ let isNewSpec = false;
142
+ try {
143
+ targetContent = await fs.readFile(update.target, 'utf-8');
144
+ }
145
+ catch {
146
+ // Target spec does not exist; MODIFIED and RENAMED are not allowed for new specs
147
+ // REMOVED will be ignored with a warning since there's nothing to remove
148
+ if (plan.modified.length > 0 || plan.renamed.length > 0) {
149
+ throw new Error(`${specName}: target spec does not exist; only ADDED requirements are allowed for new specs. MODIFIED and RENAMED operations require an existing spec.`);
150
+ }
151
+ // Warn about REMOVED requirements being ignored for new specs
152
+ if (plan.removed.length > 0) {
153
+ console.log(chalk.yellow(`⚠️ Warning: ${specName} - ${plan.removed.length} REMOVED requirement(s) ignored for new spec (nothing to remove).`));
154
+ }
155
+ isNewSpec = true;
156
+ targetContent = buildSpecSkeleton(specName, changeName);
157
+ }
158
+ const structureIssues = findMainSpecStructureIssues(targetContent);
159
+ if (structureIssues.length > 0) {
160
+ const details = structureIssues
161
+ .map(issue => `line ${issue.line}: ${issue.message}`)
162
+ .join('\n');
163
+ throw new Error(`${specName}: target spec is structurally invalid and cannot be updated until fixed:\n${details}`);
164
+ }
165
+ // Extract requirements section and build name->block map
166
+ const parts = extractRequirementsSection(targetContent);
167
+ const nameToBlock = new Map();
168
+ for (const block of parts.bodyBlocks) {
169
+ nameToBlock.set(normalizeRequirementName(block.name), block);
170
+ }
171
+ // Apply operations in order: RENAMED → REMOVED → MODIFIED → ADDED
172
+ // RENAMED
173
+ for (const r of plan.renamed) {
174
+ const from = normalizeRequirementName(r.from);
175
+ const to = normalizeRequirementName(r.to);
176
+ if (!nameToBlock.has(from)) {
177
+ throw new Error(`${specName} RENAMED failed for header "### Requirement: ${r.from}" - source not found`);
178
+ }
179
+ if (nameToBlock.has(to)) {
180
+ throw new Error(`${specName} RENAMED failed for header "### Requirement: ${r.to}" - target already exists`);
181
+ }
182
+ const block = nameToBlock.get(from);
183
+ const newHeader = `### Requirement: ${to}`;
184
+ const rawLines = block.raw.split('\n');
185
+ rawLines[0] = newHeader;
186
+ const renamedBlock = {
187
+ headerLine: newHeader,
188
+ name: to,
189
+ raw: rawLines.join('\n'),
190
+ };
191
+ nameToBlock.delete(from);
192
+ nameToBlock.set(to, renamedBlock);
193
+ }
194
+ // REMOVED
195
+ for (const name of plan.removed) {
196
+ const key = normalizeRequirementName(name);
197
+ if (!nameToBlock.has(key)) {
198
+ // For new specs, REMOVED requirements are already warned about and ignored
199
+ // For existing specs, missing requirements are an error
200
+ if (!isNewSpec) {
201
+ throw new Error(`${specName} REMOVED failed for header "### Requirement: ${name}" - not found`);
202
+ }
203
+ // Skip removal for new specs (already warned above)
204
+ continue;
205
+ }
206
+ nameToBlock.delete(key);
207
+ }
208
+ // MODIFIED
209
+ for (const mod of plan.modified) {
210
+ const key = normalizeRequirementName(mod.name);
211
+ if (!nameToBlock.has(key)) {
212
+ throw new Error(`${specName} MODIFIED failed for header "### Requirement: ${mod.name}" - not found`);
213
+ }
214
+ // Replace block with provided raw (ensure header line matches key)
215
+ const modHeaderMatch = mod.raw.split('\n')[0].match(/^###\s*Requirement:\s*(.+)\s*$/i);
216
+ if (!modHeaderMatch || normalizeRequirementName(modHeaderMatch[1]) !== key) {
217
+ throw new Error(`${specName} MODIFIED failed for header "### Requirement: ${mod.name}" - header mismatch in content`);
218
+ }
219
+ nameToBlock.set(key, mod);
220
+ }
221
+ // ADDED
222
+ for (const add of plan.added) {
223
+ const key = normalizeRequirementName(add.name);
224
+ if (nameToBlock.has(key)) {
225
+ throw new Error(`${specName} ADDED failed for header "### Requirement: ${add.name}" - already exists`);
226
+ }
227
+ nameToBlock.set(key, add);
228
+ }
229
+ // Duplicates within resulting map are implicitly prevented by key uniqueness.
230
+ // Recompose requirements section preserving original ordering where possible
231
+ const keptOrder = [];
232
+ const seen = new Set();
233
+ for (const block of parts.bodyBlocks) {
234
+ const key = normalizeRequirementName(block.name);
235
+ const replacement = nameToBlock.get(key);
236
+ if (replacement) {
237
+ keptOrder.push(replacement);
238
+ seen.add(key);
239
+ }
240
+ }
241
+ // Append any newly added that were not in original order
242
+ for (const [key, block] of nameToBlock.entries()) {
243
+ if (!seen.has(key)) {
244
+ keptOrder.push(block);
245
+ }
246
+ }
247
+ const reqBody = [parts.preamble && parts.preamble.trim() ? parts.preamble.trimEnd() : '']
248
+ .filter(Boolean)
249
+ .concat(keptOrder.map((b) => b.raw))
250
+ .join('\n\n')
251
+ .trimEnd();
252
+ const rebuilt = [parts.before.trimEnd(), parts.headerLine, reqBody, parts.after]
253
+ .filter((s, idx) => !(idx === 0 && s === ''))
254
+ .join('\n')
255
+ .replace(/\n{3,}/g, '\n\n');
256
+ return {
257
+ rebuilt,
258
+ counts: {
259
+ added: plan.added.length,
260
+ modified: plan.modified.length,
261
+ removed: plan.removed.length,
262
+ renamed: plan.renamed.length,
263
+ },
264
+ };
265
+ }
266
+ /**
267
+ * Write an updated spec to disk.
268
+ */
269
+ export async function writeUpdatedSpec(update, rebuilt, counts) {
270
+ // Create target directory if needed
271
+ const targetDir = path.dirname(update.target);
272
+ await fs.mkdir(targetDir, { recursive: true });
273
+ await fs.writeFile(update.target, rebuilt);
274
+ const specName = path.basename(path.dirname(update.target));
275
+ console.log(`Applying changes to synspec/specs/${specName}/spec.md:`);
276
+ if (counts.added)
277
+ console.log(` + ${counts.added} added`);
278
+ if (counts.modified)
279
+ console.log(` ~ ${counts.modified} modified`);
280
+ if (counts.removed)
281
+ console.log(` - ${counts.removed} removed`);
282
+ if (counts.renamed)
283
+ console.log(` → ${counts.renamed} renamed`);
284
+ }
285
+ /**
286
+ * Build a skeleton spec for new capabilities.
287
+ */
288
+ export function buildSpecSkeleton(specFolderName, changeName) {
289
+ const titleBase = specFolderName;
290
+ return `# ${titleBase} Specification\n\n## Purpose\nTBD - created by archiving change ${changeName}. Update Purpose after archive.\n\n## Requirements\n`;
291
+ }
292
+ /**
293
+ * Apply all delta specs from a change to main specs.
294
+ *
295
+ * @param projectRoot - The project root directory
296
+ * @param changeName - The name of the change to apply
297
+ * @param options - Options for the operation
298
+ * @returns Result of the operation with counts
299
+ */
300
+ export async function applySpecs(projectRoot, changeName, options = {}) {
301
+ const changeDir = path.join(projectRoot, SYNSPEC_DIR_NAME, 'changes', changeName);
302
+ const mainSpecsDir = path.join(projectRoot, SYNSPEC_DIR_NAME, 'specs');
303
+ // Verify change exists
304
+ try {
305
+ const stat = await fs.stat(changeDir);
306
+ if (!stat.isDirectory()) {
307
+ throw new Error(`Change '${changeName}' not found.`);
308
+ }
309
+ }
310
+ catch {
311
+ throw new Error(`Change '${changeName}' not found.`);
312
+ }
313
+ // Find specs to update
314
+ const specUpdates = await findSpecUpdates(changeDir, mainSpecsDir);
315
+ if (specUpdates.length === 0) {
316
+ return {
317
+ changeName,
318
+ capabilities: [],
319
+ totals: { added: 0, modified: 0, removed: 0, renamed: 0 },
320
+ noChanges: true,
321
+ };
322
+ }
323
+ // Prepare all updates first (validation pass, no writes)
324
+ const prepared = [];
325
+ for (const update of specUpdates) {
326
+ const built = await buildUpdatedSpec(update, changeName);
327
+ prepared.push({ update, rebuilt: built.rebuilt, counts: built.counts });
328
+ }
329
+ // Validate rebuilt specs unless validation is skipped
330
+ if (!options.skipValidation) {
331
+ const validator = new Validator();
332
+ for (const p of prepared) {
333
+ const specName = path.basename(path.dirname(p.update.target));
334
+ const report = await validator.validateSpecContent(specName, p.rebuilt);
335
+ if (!report.valid) {
336
+ const errors = report.issues
337
+ .filter((i) => i.level === 'ERROR')
338
+ .map((i) => ` ✗ ${i.message}`)
339
+ .join('\n');
340
+ throw new Error(`Validation errors in rebuilt spec for ${specName}:\n${errors}`);
341
+ }
342
+ }
343
+ }
344
+ // Build results
345
+ const capabilities = [];
346
+ const totals = { added: 0, modified: 0, removed: 0, renamed: 0 };
347
+ for (const p of prepared) {
348
+ const capability = path.basename(path.dirname(p.update.target));
349
+ if (!options.dryRun) {
350
+ // Write the updated spec
351
+ const targetDir = path.dirname(p.update.target);
352
+ await fs.mkdir(targetDir, { recursive: true });
353
+ await fs.writeFile(p.update.target, p.rebuilt);
354
+ if (!options.silent) {
355
+ console.log(`Applying changes to synspec/specs/${capability}/spec.md:`);
356
+ if (p.counts.added)
357
+ console.log(` + ${p.counts.added} added`);
358
+ if (p.counts.modified)
359
+ console.log(` ~ ${p.counts.modified} modified`);
360
+ if (p.counts.removed)
361
+ console.log(` - ${p.counts.removed} removed`);
362
+ if (p.counts.renamed)
363
+ console.log(` → ${p.counts.renamed} renamed`);
364
+ }
365
+ }
366
+ else if (!options.silent) {
367
+ console.log(`Would apply changes to synspec/specs/${capability}/spec.md:`);
368
+ if (p.counts.added)
369
+ console.log(` + ${p.counts.added} added`);
370
+ if (p.counts.modified)
371
+ console.log(` ~ ${p.counts.modified} modified`);
372
+ if (p.counts.removed)
373
+ console.log(` - ${p.counts.removed} removed`);
374
+ if (p.counts.renamed)
375
+ console.log(` → ${p.counts.renamed} renamed`);
376
+ }
377
+ capabilities.push({
378
+ capability,
379
+ ...p.counts,
380
+ });
381
+ totals.added += p.counts.added;
382
+ totals.modified += p.counts.modified;
383
+ totals.removed += p.counts.removed;
384
+ totals.renamed += p.counts.renamed;
385
+ }
386
+ return {
387
+ changeName,
388
+ capabilities,
389
+ totals,
390
+ noChanges: false,
391
+ };
392
+ }
393
+ //# sourceMappingURL=specs-apply.js.map
@@ -0,0 +1,7 @@
1
+ export declare const PALETTE: {
2
+ white: import("chalk").ChalkInstance;
3
+ lightGray: import("chalk").ChalkInstance;
4
+ midGray: import("chalk").ChalkInstance;
5
+ darkGray: import("chalk").ChalkInstance;
6
+ };
7
+ //# sourceMappingURL=palette.d.ts.map
@@ -0,0 +1,8 @@
1
+ import chalk from 'chalk';
2
+ export const PALETTE = {
3
+ white: chalk.hex('#f4f4f4'),
4
+ lightGray: chalk.hex('#c8c8c8'),
5
+ midGray: chalk.hex('#8a8a8a'),
6
+ darkGray: chalk.hex('#4a4a4a')
7
+ };
8
+ //# sourceMappingURL=palette.js.map
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Template exports for synarcx.
3
+ *
4
+ * The old config file templates (AGENTS.md, project.md, claude-template, etc.)
5
+ * have been removed. The skill-based workflow uses skill-templates.ts directly.
6
+ */
7
+ export * from './skill-templates.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Template exports for synarcx.
3
+ *
4
+ * The old config file templates (AGENTS.md, project.md, claude-template, etc.)
5
+ * have been removed. The skill-based workflow uses skill-templates.ts directly.
6
+ */
7
+ // Re-export all skill templates and related types through the compatibility facade.
8
+ export * from './skill-templates.js';
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Agent Skill Templates
3
+ *
4
+ * Compatibility facade that re-exports split workflow template modules.
5
+ */
6
+ export type { SkillTemplate, CommandTemplate } from './types.js';
7
+ export { getSynExploreSkillTemplate, getSynExploreCommandTemplate } from './workflows/explore.js';
8
+ export { getSynApplySkillTemplate, getSynApplyCommandTemplate } from './workflows/apply-change.js';
9
+ export { getSynArchiveSkillTemplate, getSynArchiveCommandTemplate } from './workflows/archive-change.js';
10
+ export { getSynProposeSkillTemplate, getSynProposeCommandTemplate } from './workflows/propose.js';
11
+ export { getSynSyncSkillTemplate, getSynSyncCommandTemplate } from './workflows/sync.js';
12
+ export { getSynClarifySkillTemplate, getSynClarifyCommandTemplate } from './workflows/clarify.js';
13
+ export { getSynAnalyzeSkillTemplate, getSynAnalyzeCommandTemplate } from './workflows/analyze.js';
14
+ export { getSynDebugSkillTemplate, getSynDebugCommandTemplate } from './workflows/debug.js';
15
+ //# sourceMappingURL=skill-templates.d.ts.map
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Agent Skill Templates
3
+ *
4
+ * Compatibility facade that re-exports split workflow template modules.
5
+ */
6
+ export { getSynExploreSkillTemplate, getSynExploreCommandTemplate } from './workflows/explore.js';
7
+ export { getSynApplySkillTemplate, getSynApplyCommandTemplate } from './workflows/apply-change.js';
8
+ export { getSynArchiveSkillTemplate, getSynArchiveCommandTemplate } from './workflows/archive-change.js';
9
+ export { getSynProposeSkillTemplate, getSynProposeCommandTemplate } from './workflows/propose.js';
10
+ export { getSynSyncSkillTemplate, getSynSyncCommandTemplate } from './workflows/sync.js';
11
+ export { getSynClarifySkillTemplate, getSynClarifyCommandTemplate } from './workflows/clarify.js';
12
+ export { getSynAnalyzeSkillTemplate, getSynAnalyzeCommandTemplate } from './workflows/analyze.js';
13
+ export { getSynDebugSkillTemplate, getSynDebugCommandTemplate } from './workflows/debug.js';
14
+ //# sourceMappingURL=skill-templates.js.map
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Core template types for skills and slash commands.
3
+ */
4
+ export interface SkillTemplate {
5
+ name: string;
6
+ description: string;
7
+ instructions: string;
8
+ license?: string;
9
+ compatibility?: string;
10
+ metadata?: Record<string, string>;
11
+ }
12
+ export interface CommandTemplate {
13
+ name: string;
14
+ description: string;
15
+ category: string;
16
+ tags: string[];
17
+ content: string;
18
+ }
19
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Core template types for skills and slash commands.
3
+ */
4
+ export {};
5
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1,4 @@
1
+ import type { SkillTemplate, CommandTemplate } from '../types.js';
2
+ export declare function getSynAnalyzeSkillTemplate(): SkillTemplate;
3
+ export declare function getSynAnalyzeCommandTemplate(): CommandTemplate;
4
+ //# sourceMappingURL=analyze.d.ts.map
@@ -0,0 +1,101 @@
1
+ export function getSynAnalyzeSkillTemplate() {
2
+ return {
3
+ name: 'syn-analyze',
4
+ description: 'Cross-artifact consistency check across proposal, specs, design, and tasks. Edits in place to fix inconsistencies.',
5
+ instructions: `Run a cross-artifact consistency check for a change. Edits artifacts in place to fix issues found.
6
+
7
+ ---
8
+
9
+ ## Steps
10
+
11
+ 1. **Identify the change**
12
+ - If the user specified a change name, use it
13
+ - Otherwise, run \`synarcx list --json\` to find active changes
14
+ - If multiple, ask which one to analyze
15
+
16
+ 2. **Read all artifacts**
17
+ - \`synspec/changes/<name>/proposal.md\`
18
+ - \`synspec/changes/<name>/specs/**/*.md\`
19
+ - \`synspec/changes/<name>/design.md\`
20
+ - \`synspec/changes/<name>/tasks.md\`
21
+
22
+ 3. **Run consistency checks**
23
+
24
+ a. **Terminology consistency** — same terms used across all artifacts
25
+ b. **Scope alignment** — proposal scope matches design and tasks
26
+ c. **Completeness** — no missing sections or dangling references
27
+ d. **Conflict detection** — contradictory statements between artifacts
28
+ e. **Traceability** — every task maps to a spec requirement
29
+
30
+ 4. **Fix inconsistencies in place**
31
+ - Edit artifacts directly to resolve issues
32
+ - Maximum 5 edits per session
33
+ - Show what was changed and why
34
+
35
+ 5. **Generate summary** of changes made
36
+
37
+ ---
38
+
39
+ ## Output
40
+
41
+ After completing, summarize:
42
+ - What was checked
43
+ - What inconsistencies were found and fixed
44
+ - What artifacts were modified
45
+ - Any remaining concerns
46
+ - Next step: Run \`/syn:apply\` to start implementation`,
47
+ license: 'MIT',
48
+ compatibility: 'Requires synarcx CLI.',
49
+ metadata: { author: 'synarcx', version: '0.1' },
50
+ };
51
+ }
52
+ export function getSynAnalyzeCommandTemplate() {
53
+ return {
54
+ name: 'syn:analyze',
55
+ description: 'Cross-artifact consistency check for proposal, specs, design, and tasks',
56
+ category: 'Workflow',
57
+ tags: ['workflow', 'analyze'],
58
+ content: `Run a cross-artifact consistency check for a change. Edits artifacts in place to fix issues found.
59
+
60
+ ---
61
+
62
+ ## Steps
63
+
64
+ 1. **Identify the change**
65
+ - If the user specified a change name, use it
66
+ - Otherwise, run \`synarcx list --json\` to find active changes
67
+ - If multiple, ask which one to analyze
68
+
69
+ 2. **Read all artifacts**
70
+ - \`synspec/changes/<name>/proposal.md\`
71
+ - \`synspec/changes/<name>/specs/**/*.md\`
72
+ - \`synspec/changes/<name>/design.md\`
73
+ - \`synspec/changes/<name>/tasks.md\`
74
+
75
+ 3. **Run consistency checks**
76
+ - **Terminology consistency** — same terms across all artifacts
77
+ - **Scope alignment** — proposal scope matches design and tasks
78
+ - **Completeness** — no missing sections or dangling references
79
+ - **Conflict detection** — contradictory statements between artifacts
80
+ - **Traceability** — every task maps to a spec requirement
81
+
82
+ 4. **Fix inconsistencies in place**
83
+ - Edit artifacts directly to resolve issues
84
+ - Maximum 5 edits per session
85
+ - Show what was changed and why
86
+
87
+ 5. **Generate summary** of changes made
88
+
89
+ ---
90
+
91
+ ## Output
92
+
93
+ After completing, summarize:
94
+ - What was checked
95
+ - What inconsistencies were found and fixed
96
+ - What artifacts were modified
97
+ - Any remaining concerns
98
+ - Next step: Run \`/syn:apply\` to start implementation`
99
+ };
100
+ }
101
+ //# sourceMappingURL=analyze.js.map
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Skill Template Workflow Modules
3
+ *
4
+ * This file is generated by splitting the legacy monolithic
5
+ * templates file into workflow-focused modules.
6
+ */
7
+ import type { SkillTemplate, CommandTemplate } from '../types.js';
8
+ export declare function getSynApplySkillTemplate(): SkillTemplate;
9
+ export declare function getSynApplyCommandTemplate(): CommandTemplate;
10
+ //# sourceMappingURL=apply-change.d.ts.map