ai-spector 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 (168) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +150 -0
  3. package/dist/cli.d.ts +3 -0
  4. package/dist/cli.d.ts.map +1 -0
  5. package/dist/cli.js +173 -0
  6. package/dist/cli.js.map +1 -0
  7. package/dist/commands/analyze.d.ts +9 -0
  8. package/dist/commands/analyze.d.ts.map +1 -0
  9. package/dist/commands/analyze.js +62 -0
  10. package/dist/commands/analyze.js.map +1 -0
  11. package/dist/commands/bootstrap.d.ts +4 -0
  12. package/dist/commands/bootstrap.d.ts.map +1 -0
  13. package/dist/commands/bootstrap.js +58 -0
  14. package/dist/commands/bootstrap.js.map +1 -0
  15. package/dist/commands/graph-impact.d.ts +10 -0
  16. package/dist/commands/graph-impact.d.ts.map +1 -0
  17. package/dist/commands/graph-impact.js +31 -0
  18. package/dist/commands/graph-impact.js.map +1 -0
  19. package/dist/commands/graph-merge.d.ts +11 -0
  20. package/dist/commands/graph-merge.d.ts.map +1 -0
  21. package/dist/commands/graph-merge.js +88 -0
  22. package/dist/commands/graph-merge.js.map +1 -0
  23. package/dist/commands/graph-query.d.ts +10 -0
  24. package/dist/commands/graph-query.d.ts.map +1 -0
  25. package/dist/commands/graph-query.js +31 -0
  26. package/dist/commands/graph-query.js.map +1 -0
  27. package/dist/commands/graph-visualize.d.ts +10 -0
  28. package/dist/commands/graph-visualize.d.ts.map +1 -0
  29. package/dist/commands/graph-visualize.js +72 -0
  30. package/dist/commands/graph-visualize.js.map +1 -0
  31. package/dist/commands/init.d.ts +6 -0
  32. package/dist/commands/init.d.ts.map +1 -0
  33. package/dist/commands/init.js +47 -0
  34. package/dist/commands/init.js.map +1 -0
  35. package/dist/commands/validate.d.ts +10 -0
  36. package/dist/commands/validate.d.ts.map +1 -0
  37. package/dist/commands/validate.js +89 -0
  38. package/dist/commands/validate.js.map +1 -0
  39. package/dist/config/load.d.ts +21 -0
  40. package/dist/config/load.d.ts.map +1 -0
  41. package/dist/config/load.js +77 -0
  42. package/dist/config/load.js.map +1 -0
  43. package/dist/config/types.d.ts +22 -0
  44. package/dist/config/types.d.ts.map +1 -0
  45. package/dist/config/types.js +2 -0
  46. package/dist/config/types.js.map +1 -0
  47. package/dist/graph/InMemoryGraph.d.ts +20 -0
  48. package/dist/graph/InMemoryGraph.d.ts.map +1 -0
  49. package/dist/graph/InMemoryGraph.js +181 -0
  50. package/dist/graph/InMemoryGraph.js.map +1 -0
  51. package/dist/graph/defaults.d.ts +10 -0
  52. package/dist/graph/defaults.d.ts.map +1 -0
  53. package/dist/graph/defaults.js +10 -0
  54. package/dist/graph/defaults.js.map +1 -0
  55. package/dist/graph/impact.d.ts +32 -0
  56. package/dist/graph/impact.d.ts.map +1 -0
  57. package/dist/graph/impact.js +88 -0
  58. package/dist/graph/impact.js.map +1 -0
  59. package/dist/graph/knowledge.d.ts +53 -0
  60. package/dist/graph/knowledge.d.ts.map +1 -0
  61. package/dist/graph/knowledge.js +79 -0
  62. package/dist/graph/knowledge.js.map +1 -0
  63. package/dist/graph/load.d.ts +4 -0
  64. package/dist/graph/load.d.ts.map +1 -0
  65. package/dist/graph/load.js +12 -0
  66. package/dist/graph/load.js.map +1 -0
  67. package/dist/graph/loadGraph.d.ts +3 -0
  68. package/dist/graph/loadGraph.d.ts.map +1 -0
  69. package/dist/graph/loadGraph.js +7 -0
  70. package/dist/graph/loadGraph.js.map +1 -0
  71. package/dist/graph/merge.d.ts +15 -0
  72. package/dist/graph/merge.d.ts.map +1 -0
  73. package/dist/graph/merge.js +63 -0
  74. package/dist/graph/merge.js.map +1 -0
  75. package/dist/graph/query.d.ts +18 -0
  76. package/dist/graph/query.d.ts.map +1 -0
  77. package/dist/graph/query.js +132 -0
  78. package/dist/graph/query.js.map +1 -0
  79. package/dist/registry/build.d.ts +3 -0
  80. package/dist/registry/build.d.ts.map +1 -0
  81. package/dist/registry/build.js +53 -0
  82. package/dist/registry/build.js.map +1 -0
  83. package/dist/registry/slug.d.ts +4 -0
  84. package/dist/registry/slug.d.ts.map +1 -0
  85. package/dist/registry/slug.js +16 -0
  86. package/dist/registry/slug.js.map +1 -0
  87. package/dist/types.d.ts +45 -0
  88. package/dist/types.d.ts.map +1 -0
  89. package/dist/types.js +2 -0
  90. package/dist/types.js.map +1 -0
  91. package/dist/util/fs.d.ts +6 -0
  92. package/dist/util/fs.d.ts.map +1 -0
  93. package/dist/util/fs.js +24 -0
  94. package/dist/util/fs.js.map +1 -0
  95. package/dist/util/paths.d.ts +16 -0
  96. package/dist/util/paths.d.ts.map +1 -0
  97. package/dist/util/paths.js +19 -0
  98. package/dist/util/paths.js.map +1 -0
  99. package/dist/visualize/html.d.ts +13 -0
  100. package/dist/visualize/html.d.ts.map +1 -0
  101. package/dist/visualize/html.js +374 -0
  102. package/dist/visualize/html.js.map +1 -0
  103. package/dist/visualize/stats.d.ts +21 -0
  104. package/dist/visualize/stats.d.ts.map +1 -0
  105. package/dist/visualize/stats.js +45 -0
  106. package/dist/visualize/stats.js.map +1 -0
  107. package/documents.json +64 -0
  108. package/package.json +65 -0
  109. package/scaffold/.ai-spector/.docflow/config/analyze.graphify.json +40 -0
  110. package/scaffold/.ai-spector/.docflow/config/completeness-rules.basic-design.json +18 -0
  111. package/scaffold/.ai-spector/.docflow/config/completeness-rules.detail-design.json +57 -0
  112. package/scaffold/.ai-spector/.docflow/config/completeness-rules.srs.json +72 -0
  113. package/scaffold/.ai-spector/.docflow/config/dag.basic-design.json +38 -0
  114. package/scaffold/.ai-spector/.docflow/config/dag.detail-design.json +64 -0
  115. package/scaffold/.ai-spector/.docflow/config/dag.srs.json +87 -0
  116. package/scaffold/.ai-spector/.docflow/config/data-source.json +5 -0
  117. package/scaffold/.ai-spector/.docflow/config/index.docs.json +22 -0
  118. package/scaffold/.ai-spector/.docflow/config/workflow.dependencies.json +271 -0
  119. package/scaffold/.ai-spector/.docflow/extract/patch.example.json +20 -0
  120. package/scaffold/.ai-spector/.docflow/state.json +11 -0
  121. package/scaffold/.ai-spector/docflow.config.json +7 -0
  122. package/scaffold/.ai-spector/index/README.md +18 -0
  123. package/scaffold/.ai-spector/index/basic-design.md +5 -0
  124. package/scaffold/.ai-spector/index/srs.md +5 -0
  125. package/scaffold/.cursor/commands/_cli-failures.md +110 -0
  126. package/scaffold/.cursor/commands/_graph.md +48 -0
  127. package/scaffold/.cursor/commands/_prerequisites.md +48 -0
  128. package/scaffold/.cursor/commands/_workflow.md +50 -0
  129. package/scaffold/.cursor/commands/analyze.md +92 -0
  130. package/scaffold/.cursor/commands/generate-basic-design.md +26 -0
  131. package/scaffold/.cursor/commands/generate-detail-design.md +19 -0
  132. package/scaffold/.cursor/commands/generate-srs.md +63 -0
  133. package/scaffold/.cursor/commands/graph-impact.md +45 -0
  134. package/scaffold/.cursor/commands/index-docs.md +36 -0
  135. package/scaffold/.cursor/commands/sync-graph.md +30 -0
  136. package/scaffold/.cursor/commands/validate-graph.md +28 -0
  137. package/scaffold/.cursor/commands/visualize-graph.md +24 -0
  138. package/scaffold/.cursor/skills/ai-spector/SKILL.md +39 -0
  139. package/scaffold/docs/data-source/README.md +7 -0
  140. package/schemas/rules.impact.json +17 -0
  141. package/schemas/rules.traceability.json +30 -0
  142. package/schemas/schema.extract-patch.json +19 -0
  143. package/schemas/schema.graph.json +83 -0
  144. package/schemas/schema.knowledge.json +107 -0
  145. package/templates/basic_design/db-design-template.md +177 -0
  146. package/templates/basic_design/detail-api-template.md +278 -0
  147. package/templates/basic_design/detail-screen-template.md +281 -0
  148. package/templates/basic_design/list-api-template.md +130 -0
  149. package/templates/basic_design/list-screen-template.md +242 -0
  150. package/templates/detail_design/common/architecture-overview-template.md +302 -0
  151. package/templates/detail_design/common/deployment-infrastructure-template.md +461 -0
  152. package/templates/detail_design/common/error-handling-patterns-template.md +460 -0
  153. package/templates/detail_design/common/integration-patterns-template.md +410 -0
  154. package/templates/detail_design/common/performance-standards-template.md +406 -0
  155. package/templates/detail_design/common/security-patterns-template.md +395 -0
  156. package/templates/detail_design/feature-detail-design-template.md +773 -0
  157. package/templates/detail_design/feature-list-template.md +39 -0
  158. package/templates/srs/1-introduction.md +58 -0
  159. package/templates/srs/2-overall-description.md +91 -0
  160. package/templates/srs/3-use-case-detail-template.md +142 -0
  161. package/templates/srs/3-use-cases.md +53 -0
  162. package/templates/srs/4-system-feature-detail-template.md +131 -0
  163. package/templates/srs/4-system-features-list-template.md +39 -0
  164. package/templates/srs/5-data-requirements.md +59 -0
  165. package/templates/srs/6-external-interfaces.md +56 -0
  166. package/templates/srs/7-quality-attributes.md +74 -0
  167. package/templates/srs/8-internationalization.md +36 -0
  168. package/templates/srs/9-other-requirements.md +46 -0
package/dist/visualize/html.js ADDED
@@ -0,0 +1,374 @@
1
+ function escapeJsonForScript(data) {
2
+ return JSON.stringify(data).replace(/</g, "\\u003c");
3
+ }
4
+ export function buildVisualizationHtml(payload) {
5
+ const embedded = escapeJsonForScript(payload);
6
+ return `<!DOCTYPE html>
7
+ <html lang="en">
8
+ <head>
9
+ <meta charset="utf-8" />
10
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
11
+ <title>AI Spector — Graph &amp; Knowledge</title>
12
+ <script src="https://cdn.jsdelivr.net/npm/vis-network@9.1.9/standalone/umd/vis-network.min.js"></script>
13
+ <style>
14
+ :root {
15
+ --bg: #0f1419;
16
+ --panel: #1a2332;
17
+ --border: #2d3a4d;
18
+ --text: #e7ecf3;
19
+ --muted: #8b9cb3;
20
+ --accent: #3b82f6;
21
+ }
22
+ * { box-sizing: border-box; }
23
+ body {
24
+ margin: 0;
25
+ font-family: "SF Pro Text", system-ui, -apple-system, sans-serif;
26
+ background: var(--bg);
27
+ color: var(--text);
28
+ min-height: 100vh;
29
+ }
30
+ header {
31
+ padding: 1rem 1.25rem;
32
+ border-bottom: 1px solid var(--border);
33
+ display: flex;
34
+ flex-wrap: wrap;
35
+ gap: 0.75rem 1.5rem;
36
+ align-items: baseline;
37
+ }
38
+ header h1 { margin: 0; font-size: 1.15rem; font-weight: 600; }
39
+ header .meta { color: var(--muted); font-size: 0.8rem; }
40
+ nav.tabs {
41
+ display: flex;
42
+ gap: 0.25rem;
43
+ padding: 0.5rem 1.25rem 0;
44
+ border-bottom: 1px solid var(--border);
45
+ }
46
+ nav.tabs button {
47
+ background: transparent;
48
+ border: none;
49
+ color: var(--muted);
50
+ padding: 0.6rem 1rem;
51
+ cursor: pointer;
52
+ font-size: 0.9rem;
53
+ border-bottom: 2px solid transparent;
54
+ margin-bottom: -1px;
55
+ }
56
+ nav.tabs button.active {
57
+ color: var(--text);
58
+ border-bottom-color: var(--accent);
59
+ }
60
+ .panel { display: none; padding: 1rem 1.25rem 1.5rem; }
61
+ .panel.active { display: block; }
62
+ .stats-grid {
63
+ display: grid;
64
+ grid-template-columns: repeat(auto-fill, minmax(140px, 1fr));
65
+ gap: 0.75rem;
66
+ margin-bottom: 1rem;
67
+ }
68
+ .stat-card {
69
+ background: var(--panel);
70
+ border: 1px solid var(--border);
71
+ border-radius: 8px;
72
+ padding: 0.75rem 1rem;
73
+ }
74
+ .stat-card .label { font-size: 0.75rem; color: var(--muted); }
75
+ .stat-card .value { font-size: 1.35rem; font-weight: 600; margin-top: 0.2rem; }
76
+ .graph-toolbar {
77
+ display: flex;
78
+ flex-wrap: wrap;
79
+ gap: 0.75rem;
80
+ align-items: center;
81
+ margin-bottom: 0.75rem;
82
+ }
83
+ .graph-toolbar label { font-size: 0.85rem; color: var(--muted); display: flex; align-items: center; gap: 0.4rem; }
84
+ .graph-toolbar select, .graph-toolbar input {
85
+ background: var(--panel);
86
+ border: 1px solid var(--border);
87
+ color: var(--text);
88
+ padding: 0.35rem 0.6rem;
89
+ border-radius: 6px;
90
+ font-size: 0.85rem;
91
+ }
92
+ #graph-network {
93
+ width: 100%;
94
+ height: min(70vh, 640px);
95
+ border: 1px solid var(--border);
96
+ border-radius: 8px;
97
+ background: #121820;
98
+ }
99
+ #node-detail {
100
+ margin-top: 0.75rem;
101
+ padding: 0.75rem 1rem;
102
+ background: var(--panel);
103
+ border: 1px solid var(--border);
104
+ border-radius: 8px;
105
+ font-size: 0.85rem;
106
+ min-height: 4rem;
107
+ white-space: pre-wrap;
108
+ font-family: ui-monospace, monospace;
109
+ }
110
+ .legend {
111
+ display: flex;
112
+ flex-wrap: wrap;
113
+ gap: 0.5rem 1rem;
114
+ margin-top: 0.75rem;
115
+ font-size: 0.75rem;
116
+ }
117
+ .legend span { display: inline-flex; align-items: center; gap: 0.35rem; }
118
+ .legend i {
119
+ width: 10px;
120
+ height: 10px;
121
+ border-radius: 50%;
122
+ display: inline-block;
123
+ }
124
+ table.data {
125
+ width: 100%;
126
+ border-collapse: collapse;
127
+ font-size: 0.85rem;
128
+ }
129
+ table.data th, table.data td {
130
+ text-align: left;
131
+ padding: 0.5rem 0.75rem;
132
+ border-bottom: 1px solid var(--border);
133
+ }
134
+ table.data th { color: var(--muted); font-weight: 500; }
135
+ table.data tr:hover td { background: var(--panel); }
136
+ .empty { color: var(--muted); font-style: italic; padding: 1rem 0; }
137
+ .section-title { font-size: 1rem; margin: 1.25rem 0 0.5rem; color: var(--muted); }
138
+ .badge {
139
+ display: inline-block;
140
+ padding: 0.15rem 0.45rem;
141
+ border-radius: 4px;
142
+ font-size: 0.7rem;
143
+ background: var(--border);
144
+ margin-left: 0.35rem;
145
+ }
146
+ </style>
147
+ </head>
148
+ <body>
149
+ <header>
150
+ <h1>AI Spector — Graph &amp; Knowledge</h1>
151
+ <span class="meta" id="header-meta"></span>
152
+ </header>
153
+ <nav class="tabs" role="tablist">
154
+ <button type="button" class="active" data-tab="overview">Overview</button>
155
+ <button type="button" data-tab="graph">Graph</button>
156
+ <button type="button" data-tab="knowledge">Knowledge</button>
157
+ </nav>
158
+
159
+ <section id="panel-overview" class="panel active"></section>
160
+ <section id="panel-graph" class="panel">
161
+ <div class="graph-toolbar">
162
+ <label>View
163
+ <select id="filter-view">
164
+ <option value="domain">Domain + documents</option>
165
+ <option value="structure">Documents + sections</option>
166
+ <option value="all">Full graph</option>
167
+ </select>
168
+ </label>
169
+ <label>Search <input type="search" id="filter-search" placeholder="node id or title…" /></label>
170
+ <label><input type="checkbox" id="filter-physics" checked /> Physics</label>
171
+ </div>
172
+ <div id="graph-network"></div>
173
+ <div class="legend" id="legend"></div>
174
+ <div id="node-detail">Click a node to inspect.</div>
175
+ </section>
176
+ <section id="panel-knowledge" class="panel"></section>
177
+
178
+ <script type="application/json" id="payload">${embedded}</script>
179
+ <script>
180
+ (function () {
181
+ const P = JSON.parse(document.getElementById("payload").textContent);
182
+
183
+ const NODE_COLORS = {
184
+ document: "#3b82f6",
185
+ section: "#64748b",
186
+ table: "#475569",
187
+ diagram: "#475569",
188
+ actor: "#a855f7",
189
+ useCase: "#22c55e",
190
+ feature: "#f59e0b",
191
+ requirement: "#ec4899",
192
+ dataEntity: "#06b6d4",
193
+ };
194
+
195
+ const STRUCTURE = new Set(["document", "section", "table", "diagram"]);
196
+
197
+ document.getElementById("header-meta").textContent =
198
+ P.projectRoot + " · generated " + new Date(P.generatedAt).toLocaleString();
199
+
200
+ // Tabs
201
+ document.querySelectorAll("nav.tabs button").forEach((btn) => {
202
+ btn.addEventListener("click", () => {
203
+ document.querySelectorAll("nav.tabs button").forEach((b) => b.classList.remove("active"));
204
+ document.querySelectorAll(".panel").forEach((p) => p.classList.remove("active"));
205
+ btn.classList.add("active");
206
+ document.getElementById("panel-" + btn.dataset.tab).classList.add("active");
207
+ if (btn.dataset.tab === "graph" && !window.__network) initGraph();
208
+ });
209
+ });
210
+
211
+ // Overview
212
+ const ov = document.getElementById("panel-overview");
213
+ const gs = P.graphStats;
214
+ const ks = P.knowledgeStats;
215
+ ov.innerHTML =
216
+ '<div class="stats-grid">' +
217
+ stat("Graph nodes", gs.nodes) +
218
+ stat("Graph edges", gs.edges) +
219
+ stat("Domain nodes", gs.domainNodes) +
220
+ stat("Structure nodes", gs.structureNodes) +
221
+ (ks.present ? stat("Knowledge use cases", ks.useCases) : stat("Knowledge", "—")) +
222
+ (ks.present ? stat("Knowledge features", ks.features) : "") +
223
+ "</div>" +
224
+ "<p class=\\"section-title\\">Nodes by type</p>" +
225
+ typeBreakdown(gs.byType) +
226
+ (ks.present ? "<p class=\\"section-title\\">Knowledge staging (not merged yet?)</p><p>Compare tables in the <strong>Knowledge</strong> tab with domain nodes in the <strong>Graph</strong> tab.</p>" : "<p class=\\"empty\\">No knowledge.json found — run /analyze in Cursor.</p>");
227
+
228
+ function stat(label, value) {
229
+ return '<div class="stat-card"><div class="label">' + label + '</div><div class="value">' + value + "</div></div>";
230
+ }
231
+ function typeBreakdown(byType) {
232
+ return "<table class=data><thead><tr><th>Type</th><th>Count</th></tr></thead><tbody>" +
233
+ Object.entries(byType).sort((a, b) => b[1] - a[1]).map(([t, n]) => "<tr><td>" + t + "</td><td>" + n + "</td></tr>").join("") +
234
+ "</tbody></table>";
235
+ }
236
+
237
+ // Knowledge panel
238
+ const kn = document.getElementById("panel-knowledge");
239
+ if (!P.knowledge || !ks.present) {
240
+ kn.innerHTML = '<p class="empty">No knowledge.json loaded.</p>';
241
+ } else {
242
+ kn.innerHTML =
243
+ knowledgeTable("Actors", P.knowledge.actors, ["id", "name", "title", "listedInSection"]) +
244
+ knowledgeTable("Use cases", P.knowledge.useCases, ["id", "title", "priority", "listedInSection"]) +
245
+ knowledgeTable("Features", P.knowledge.features, ["id", "title", "satisfies", "listedInSection"]) +
246
+ knowledgeTable("Functional requirements", P.knowledge.functionalRequirements, ["id", "title", "tracesTo", "listedInSection"]) +
247
+ knowledgeTable("NFRs", P.knowledge.nfrs, ["id", "title", "listedInSection"]) +
248
+ knowledgeTable("Entities", P.knowledge.entities, ["id", "name", "listedInSection"]);
249
+ }
250
+
251
+ function knowledgeTable(title, rows, cols) {
252
+ if (!rows || !rows.length) return '<p class="section-title">' + title + ' <span class="badge">0</span></p><p class="empty">(empty)</p>';
253
+ const head = cols.map((c) => "<th>" + c + "</th>").join("");
254
+ const body = rows.map((row) =>
255
+ "<tr>" + cols.map((c) => {
256
+ let v = row[c];
257
+ if (Array.isArray(v)) v = v.join(", ");
258
+ if (v === undefined || v === null) v = "";
259
+ return "<td>" + escapeHtml(String(v)) + "</td>";
260
+ }).join("") + "</tr>"
261
+ ).join("");
262
+ return '<p class="section-title">' + title + ' <span class="badge">' + rows.length + "</span></p>" +
263
+ '<table class="data"><thead><tr>' + head + "</tr></thead><tbody>" + body + "</tbody></table>";
264
+ }
265
+
266
+ function escapeHtml(s) {
267
+ return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
268
+ }
269
+
270
+ // Legend
271
+ const legend = document.getElementById("legend");
272
+ legend.innerHTML = Object.entries(NODE_COLORS).map(([t, c]) =>
273
+ '<span><i style="background:' + c + '"></i>' + t + "</span>"
274
+ ).join("");
275
+
276
+ let network = null;
277
+ window.__network = null;
278
+
279
+ function nodeLabel(n) {
280
+ const t = n.title || n.heading || n.name || n.id;
281
+ return t.length > 42 ? t.slice(0, 40) + "…" : t;
282
+ }
283
+
284
+ function filterNodes(viewMode, search) {
285
+ const q = (search || "").trim().toLowerCase();
286
+ return P.graph.nodes.filter((n) => {
287
+ if (viewMode === "domain") {
288
+ if (n.type === "section" && !q) return false;
289
+ if (n.type === "table" || n.type === "diagram") return false;
290
+ } else if (viewMode === "structure") {
291
+ if (!STRUCTURE.has(n.type)) return false;
292
+ }
293
+ if (q) {
294
+ const hay = (n.id + " " + (n.title || "") + " " + (n.heading || "") + " " + (n.name || "")).toLowerCase();
295
+ return hay.includes(q);
296
+ }
297
+ return true;
298
+ });
299
+ }
300
+
301
+ function buildVisData(viewMode, search) {
302
+ const nodes = filterNodes(viewMode, search);
303
+ const ids = new Set(nodes.map((n) => n.id));
304
+ const visNodes = nodes.map((n) => ({
305
+ id: n.id,
306
+ label: nodeLabel(n),
307
+ title: "<pre style=\\"margin:0;font-size:11px\\">" + escapeHtml(JSON.stringify(n, null, 2)) + "</pre>",
308
+ color: NODE_COLORS[n.type] || "#94a3b8",
309
+ font: { color: "#e7ecf3", size: 11 },
310
+ shape: n.type === "document" ? "box" : "dot",
311
+ size: STRUCTURE.has(n.type) ? 12 : 18,
312
+ }));
313
+ const visEdges = P.graph.edges
314
+ .filter((e) => ids.has(e.from) && ids.has(e.to))
315
+ .map((e, i) => ({
316
+ id: i,
317
+ from: e.from,
318
+ to: e.to,
319
+ label: e.type,
320
+ font: { size: 9, color: "#8b9cb3", strokeWidth: 0 },
321
+ color: { color: "#4b5563", highlight: "#60a5fa" },
322
+ arrows: "to",
323
+ }));
324
+ return { nodes: new vis.DataSet(visNodes), edges: new vis.DataSet(visEdges) };
325
+ }
326
+
327
+ function initGraph() {
328
+ const container = document.getElementById("graph-network");
329
+ const viewMode = document.getElementById("filter-view").value;
330
+ const search = document.getElementById("filter-search").value;
331
+ const data = buildVisData(viewMode, search);
332
+ const physics = document.getElementById("filter-physics").checked;
333
+ const options = {
334
+ physics: { enabled: physics, stabilization: { iterations: 120 } },
335
+ interaction: { hover: true, tooltipDelay: 120 },
336
+ layout: { improvedLayout: true },
337
+ edges: { smooth: { type: "dynamic" } },
338
+ };
339
+ if (network) {
340
+ network.setData(data);
341
+ network.setOptions(options);
342
+ } else {
343
+ network = new vis.Network(container, data, options);
344
+ window.__network = network;
345
+ network.on("click", (params) => {
346
+ const detail = document.getElementById("node-detail");
347
+ if (!params.nodes.length) {
348
+ detail.textContent = "Click a node to inspect.";
349
+ return;
350
+ }
351
+ const id = params.nodes[0];
352
+ const node = P.graph.nodes.find((n) => n.id === id);
353
+ const out = P.graph.edges.filter((e) => e.from === id);
354
+ const inc = P.graph.edges.filter((e) => e.to === id);
355
+ detail.textContent =
356
+ JSON.stringify(node, null, 2) +
357
+ "\\n\\n--- outgoing (" + out.length + ") ---\\n" +
358
+ out.map((e) => e.type + " → " + e.to).join("\\n") +
359
+ "\\n\\n--- incoming (" + inc.length + ") ---\\n" +
360
+ inc.map((e) => e.from + " → " + e.type).join("\\n");
361
+ });
362
+ }
363
+ }
364
+
365
+ ["filter-view", "filter-search", "filter-physics"].forEach((id) => {
366
+ document.getElementById(id).addEventListener("change", () => initGraph());
367
+ document.getElementById(id).addEventListener("input", () => initGraph());
368
+ });
369
+ })();
370
+ </script>
371
+ </body>
372
+ </html>`;
373
+ }
374
+ //# sourceMappingURL=html.js.map
package/dist/visualize/html.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/visualize/html.ts"],"names":[],"mappings":"AAaA,SAAS,mBAAmB,CAAC,IAAa;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAyB;IAC9D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE9C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDA4KwC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkMjD,CAAC;AACT,CAAC"}
package/dist/visualize/stats.d.ts ADDED
@@ -0,0 +1,21 @@
1
+ import type { TraceabilityGraph } from "../types.js";
2
+ import type { AnalysisKnowledge } from "../graph/knowledge.js";
3
+ export interface GraphStats {
4
+ nodes: number;
5
+ edges: number;
6
+ byType: Record<string, number>;
7
+ domainNodes: number;
8
+ structureNodes: number;
9
+ }
10
+ export interface KnowledgeStats {
11
+ present: boolean;
12
+ actors: number;
13
+ useCases: number;
14
+ features: number;
15
+ functionalRequirements: number;
16
+ nfrs: number;
17
+ entities: number;
18
+ }
19
+ export declare function computeGraphStats(graph: TraceabilityGraph): GraphStats;
20
+ export declare function computeKnowledgeStats(knowledge: AnalysisKnowledge | null): KnowledgeStats;
21
+ //# sourceMappingURL=stats.d.ts.map
package/dist/visualize/stats.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/visualize/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAsBtE;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAClC,cAAc,CAqBhB"}
package/dist/visualize/stats.js ADDED
@@ -0,0 +1,45 @@
1
+ export function computeGraphStats(graph) {
2
+ const byType = {};
3
+ const structure = new Set(["document", "section", "table", "diagram"]);
4
+ let domainNodes = 0;
5
+ let structureNodes = 0;
6
+ for (const n of graph.nodes) {
7
+ byType[n.type] = (byType[n.type] ?? 0) + 1;
8
+ if (structure.has(n.type)) {
9
+ structureNodes++;
10
+ }
11
+ else {
12
+ domainNodes++;
13
+ }
14
+ }
15
+ return {
16
+ nodes: graph.nodes.length,
17
+ edges: graph.edges.length,
18
+ byType,
19
+ domainNodes,
20
+ structureNodes,
21
+ };
22
+ }
23
+ export function computeKnowledgeStats(knowledge) {
24
+ if (!knowledge) {
25
+ return {
26
+ present: false,
27
+ actors: 0,
28
+ useCases: 0,
29
+ features: 0,
30
+ functionalRequirements: 0,
31
+ nfrs: 0,
32
+ entities: 0,
33
+ };
34
+ }
35
+ return {
36
+ present: true,
37
+ actors: knowledge.actors?.length ?? 0,
38
+ useCases: knowledge.useCases?.length ?? 0,
39
+ features: knowledge.features?.length ?? 0,
40
+ functionalRequirements: knowledge.functionalRequirements?.length ?? 0,
41
+ nfrs: knowledge.nfrs?.length ?? 0,
42
+ entities: knowledge.entities?.length ?? 0,
43
+ };
44
+ }
45
+ //# sourceMappingURL=stats.js.map
package/dist/visualize/stats.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/visualize/stats.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IACvE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QACzB,MAAM;QACN,WAAW;QACX,cAAc;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAAmC;IAEnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,sBAAsB,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QACrC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACzC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACzC,sBAAsB,EAAE,SAAS,CAAC,sBAAsB,EAAE,MAAM,IAAI,CAAC;QACrE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;QACjC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;KAC1C,CAAC;AACJ,CAAC"}
package/documents.json ADDED
@@ -0,0 +1,64 @@
1
+ {
2
+ "version": 1,
3
+ "name": "srs",
4
+ "templatesDir": "templates/srs",
5
+ "documents": [
6
+ {
7
+ "documentId": "doc.srs.1-introduction",
8
+ "template": "1-introduction.md",
9
+ "output": "docs/srs/1-introduction.md"
10
+ },
11
+ {
12
+ "documentId": "doc.srs.2-overall-description",
13
+ "template": "2-overall-description.md",
14
+ "output": "docs/srs/2-overall-description.md"
15
+ },
16
+ {
17
+ "documentId": "doc.srs.3-use-cases",
18
+ "template": "3-use-cases.md",
19
+ "output": "docs/srs/3-use-cases.md"
20
+ },
21
+ {
22
+ "documentId": "doc.srs.4-system-features",
23
+ "template": "4-system-features-list-template.md",
24
+ "output": "docs/srs/4-system-features.md"
25
+ },
26
+ {
27
+ "documentId": "doc.srs.5-data-requirements",
28
+ "template": "5-data-requirements.md",
29
+ "output": "docs/srs/5-data-requirements.md"
30
+ },
31
+ {
32
+ "documentId": "doc.srs.6-external-interfaces",
33
+ "template": "6-external-interfaces.md",
34
+ "output": "docs/srs/6-external-interfaces.md"
35
+ },
36
+ {
37
+ "documentId": "doc.srs.7-quality-attributes",
38
+ "template": "7-quality-attributes.md",
39
+ "output": "docs/srs/7-quality-attributes.md"
40
+ },
41
+ {
42
+ "documentId": "doc.srs.8-internationalization",
43
+ "template": "8-internationalization.md",
44
+ "output": "docs/srs/8-internationalization.md"
45
+ },
46
+ {
47
+ "documentId": "doc.srs.9-other-requirements",
48
+ "template": "9-other-requirements.md",
49
+ "output": "docs/srs/9-other-requirements.md"
50
+ },
51
+ {
52
+ "documentId": "doc.srs.uc-detail",
53
+ "template": "3-use-case-detail-template.md",
54
+ "outputPattern": "docs/srs/03-use-cases/uc-{nn}-{slug}.md",
55
+ "perDomain": "useCase"
56
+ },
57
+ {
58
+ "documentId": "doc.srs.feature-detail",
59
+ "template": "4-system-feature-detail-template.md",
60
+ "outputPattern": "docs/srs/04-system-features/f-{nn}-{slug}.md",
61
+ "perDomain": "feature"
62
+ }
63
+ ]
64
+ }
package/package.json ADDED
@@ -0,0 +1,65 @@
1
+ {
2
+ "name": "ai-spector",
3
+ "version": "0.1.0",
4
+ "description": "Cursor-first documentation workflow: traceability graph, SRS/basic/detail design templates, and ai-spector CLI",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/YOUR_ORG/ai-spector.git"
10
+ },
11
+ "homepage": "https://github.com/YOUR_ORG/ai-spector#readme",
12
+ "bugs": {
13
+ "url": "https://github.com/YOUR_ORG/ai-spector/issues"
14
+ },
15
+ "keywords": [
16
+ "ai-spector",
17
+ "cursor",
18
+ "documentation",
19
+ "srs",
20
+ "traceability",
21
+ "requirements",
22
+ "software-design",
23
+ "graph"
24
+ ],
25
+ "engines": {
26
+ "node": ">=20"
27
+ },
28
+ "publishConfig": {
29
+ "access": "public"
30
+ },
31
+ "files": [
32
+ "dist",
33
+ "schemas",
34
+ "templates",
35
+ "documents.json",
36
+ "scaffold",
37
+ "README.md",
38
+ "LICENSE"
39
+ ],
40
+ "bin": {
41
+ "ai-spector": "./dist/cli.js"
42
+ },
43
+ "scripts": {
44
+ "build": "tsc",
45
+ "prepack": "npm run build",
46
+ "prepublishOnly": "npm run build",
47
+ "start": "node dist/cli.js",
48
+ "pack:check": "npm pack --dry-run",
49
+ "prepublish:check": "npm run build && npm pack --dry-run",
50
+ "init:example": "node dist/cli.js init -C example --force",
51
+ "analyze": "node dist/cli.js -r example analyze",
52
+ "graph:validate": "node dist/cli.js -r example graph validate",
53
+ "graph:merge": "node dist/cli.js -r example graph merge --from-knowledge",
54
+ "graph:visualize": "node dist/cli.js -r example graph visualize --open"
55
+ },
56
+ "dependencies": {
57
+ "ajv": "^8.17.1",
58
+ "ajv-formats": "^3.0.1",
59
+ "commander": "^12.1.0"
60
+ },
61
+ "devDependencies": {
62
+ "@types/node": "^22.10.0",
63
+ "typescript": "^5.7.2"
64
+ }
65
+ }
package/scaffold/.ai-spector/.docflow/config/analyze.graphify.json ADDED
@@ -0,0 +1,40 @@
1
+ {
2
+ "version": 1,
3
+ "graphify": {
4
+ "indexPath": ".ai-spector/.docflow/graph/graphify-index",
5
+ "defaultDataSource": "docs/data-source",
6
+ "include": [
7
+ "docs/data-source"
8
+ ],
9
+ "exclude": [
10
+ ".git/**",
11
+ "node_modules/**",
12
+ "dist/**",
13
+ "build/**",
14
+ ".next/**",
15
+ "coverage/**",
16
+ "docs/srs/**",
17
+ "docs/basic-design/**",
18
+ "docs/detail-design/**",
19
+ ".ai-spector/**"
20
+ ]
21
+ },
22
+ "queryProfiles": [
23
+ {
24
+ "name": "actors-and-use-cases",
25
+ "goal": "Extract users, actors, and end-to-end use cases."
26
+ },
27
+ {
28
+ "name": "feature-map",
29
+ "goal": "Extract features, dependencies, and requirement groupings."
30
+ },
31
+ {
32
+ "name": "data-and-interfaces",
33
+ "goal": "Extract entities, data flows, and external/internal interfaces."
34
+ },
35
+ {
36
+ "name": "nfr-and-constraints",
37
+ "goal": "Extract quality attributes, constraints, and operational requirements."
38
+ }
39
+ ]
40
+ }
package/scaffold/.ai-spector/.docflow/config/completeness-rules.basic-design.json ADDED
@@ -0,0 +1,18 @@
1
+ {
2
+ "version": 1,
3
+ "defaultChecks": {
4
+ "disallowPlaceholders": ["<", "TODO", "TBD"],
5
+ "requireNonEmptyTables": true,
6
+ "validateMarkdownLinks": true
7
+ },
8
+ "rules": [
9
+ {
10
+ "target": "db-design.md",
11
+ "requiredHeadings": ["# Database Design"]
12
+ },
13
+ {
14
+ "target": "api-list.md",
15
+ "requiredHeadings": ["# API List:"]
16
+ }
17
+ ]
18
+ }