agent-issues 0.0.119

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 (208) hide show
  1. package/.github/agents/agent-issues.agent.md +54 -0
  2. package/.github/agents/agent-issues.claude.md +51 -0
  3. package/dist/agent-installer.d.ts +49 -0
  4. package/dist/agent-installer.js +171 -0
  5. package/dist/agent-installer.js.map +1 -0
  6. package/dist/auth-session.d.ts +40 -0
  7. package/dist/auth-session.js +107 -0
  8. package/dist/auth-session.js.map +1 -0
  9. package/dist/body-backfill.d.ts +26 -0
  10. package/dist/body-backfill.js +219 -0
  11. package/dist/body-backfill.js.map +1 -0
  12. package/dist/build-mode.d.ts +1 -0
  13. package/dist/build-mode.js +1 -0
  14. package/dist/build-mode.js.map +1 -0
  15. package/dist/cli/commands/auth.d.ts +61 -0
  16. package/dist/cli/commands/auth.js +134 -0
  17. package/dist/cli/commands/auth.js.map +1 -0
  18. package/dist/cli/commands/backfill.d.ts +8 -0
  19. package/dist/cli/commands/backfill.js +36 -0
  20. package/dist/cli/commands/backfill.js.map +1 -0
  21. package/dist/cli/commands/comments.d.ts +34 -0
  22. package/dist/cli/commands/comments.js +124 -0
  23. package/dist/cli/commands/comments.js.map +1 -0
  24. package/dist/cli/commands/context.d.ts +13 -0
  25. package/dist/cli/commands/context.js +156 -0
  26. package/dist/cli/commands/context.js.map +1 -0
  27. package/dist/cli/commands/entities.d.ts +91 -0
  28. package/dist/cli/commands/entities.js +420 -0
  29. package/dist/cli/commands/entities.js.map +1 -0
  30. package/dist/cli/commands/export.d.ts +20 -0
  31. package/dist/cli/commands/export.js +98 -0
  32. package/dist/cli/commands/export.js.map +1 -0
  33. package/dist/cli/commands/fallback.d.ts +6 -0
  34. package/dist/cli/commands/fallback.js +10 -0
  35. package/dist/cli/commands/fallback.js.map +1 -0
  36. package/dist/cli/commands/handoff.d.ts +1 -0
  37. package/dist/cli/commands/handoff.js +2 -0
  38. package/dist/cli/commands/handoff.js.map +1 -0
  39. package/dist/cli/commands/installers.d.ts +37 -0
  40. package/dist/cli/commands/installers.js +78 -0
  41. package/dist/cli/commands/installers.js.map +1 -0
  42. package/dist/cli/commands/kanban.d.ts +8 -0
  43. package/dist/cli/commands/kanban.js +83 -0
  44. package/dist/cli/commands/kanban.js.map +1 -0
  45. package/dist/cli/commands/meta.d.ts +14 -0
  46. package/dist/cli/commands/meta.js +33 -0
  47. package/dist/cli/commands/meta.js.map +1 -0
  48. package/dist/cli/commands/plan-entries.d.ts +30 -0
  49. package/dist/cli/commands/plan-entries.js +94 -0
  50. package/dist/cli/commands/plan-entries.js.map +1 -0
  51. package/dist/cli/commands/site.d.ts +29 -0
  52. package/dist/cli/commands/site.js +89 -0
  53. package/dist/cli/commands/site.js.map +1 -0
  54. package/dist/cli/commands/sql.d.ts +6 -0
  55. package/dist/cli/commands/sql.js +21 -0
  56. package/dist/cli/commands/sql.js.map +1 -0
  57. package/dist/cli/commands/synchronize.d.ts +12 -0
  58. package/dist/cli/commands/synchronize.js +31 -0
  59. package/dist/cli/commands/synchronize.js.map +1 -0
  60. package/dist/cli/commands/tenants.d.ts +29 -0
  61. package/dist/cli/commands/tenants.js +101 -0
  62. package/dist/cli/commands/tenants.js.map +1 -0
  63. package/dist/cli/index.d.ts +4 -0
  64. package/dist/cli/index.js +120 -0
  65. package/dist/cli/index.js.map +1 -0
  66. package/dist/cli/renderers.d.ts +250 -0
  67. package/dist/cli/renderers.js +286 -0
  68. package/dist/cli/renderers.js.map +1 -0
  69. package/dist/cli/shared.d.ts +97 -0
  70. package/dist/cli/shared.js +192 -0
  71. package/dist/cli/shared.js.map +1 -0
  72. package/dist/cli.d.ts +11 -0
  73. package/dist/cli.js +41 -0
  74. package/dist/cli.js.map +1 -0
  75. package/dist/context-cli.d.ts +16 -0
  76. package/dist/context-cli.js +131 -0
  77. package/dist/context-cli.js.map +1 -0
  78. package/dist/daemon/daemon-lifecycle.d.ts +1 -0
  79. package/dist/daemon/daemon-lifecycle.js +2 -0
  80. package/dist/daemon/daemon-lifecycle.js.map +1 -0
  81. package/dist/daemon/daemon-main.d.ts +14 -0
  82. package/dist/daemon/daemon-main.js +30 -0
  83. package/dist/daemon/daemon-main.js.map +1 -0
  84. package/dist/daemon/local-daemon-store.d.ts +21 -0
  85. package/dist/daemon/local-daemon-store.js +31 -0
  86. package/dist/daemon/local-daemon-store.js.map +1 -0
  87. package/dist/entity-projection.d.ts +141 -0
  88. package/dist/entity-projection.js +147 -0
  89. package/dist/entity-projection.js.map +1 -0
  90. package/dist/entra-device-login.d.ts +12 -0
  91. package/dist/entra-device-login.js +40 -0
  92. package/dist/entra-device-login.js.map +1 -0
  93. package/dist/export-files.d.ts +24 -0
  94. package/dist/export-files.js +230 -0
  95. package/dist/export-files.js.map +1 -0
  96. package/dist/export-markdown.d.ts +24 -0
  97. package/dist/export-markdown.js +343 -0
  98. package/dist/export-markdown.js.map +1 -0
  99. package/dist/help.d.ts +112 -0
  100. package/dist/help.js +1430 -0
  101. package/dist/help.js.map +1 -0
  102. package/dist/kanban/assets.d.ts +3 -0
  103. package/dist/kanban/assets.js +37 -0
  104. package/dist/kanban/assets.js.map +1 -0
  105. package/dist/kanban/index.d.ts +1 -0
  106. package/dist/kanban/index.js +2 -0
  107. package/dist/kanban/index.js.map +1 -0
  108. package/dist/kanban/server.d.ts +28 -0
  109. package/dist/kanban/server.js +118 -0
  110. package/dist/kanban/server.js.map +1 -0
  111. package/dist/mcp-installer.d.ts +32 -0
  112. package/dist/mcp-installer.js +118 -0
  113. package/dist/mcp-installer.js.map +1 -0
  114. package/dist/mcp-server/index.d.ts +11 -0
  115. package/dist/mcp-server/index.js +504 -0
  116. package/dist/mcp-server/index.js.map +1 -0
  117. package/dist/mcp-server/index.test.d.ts +1 -0
  118. package/dist/mcp-server/index.test.js +746 -0
  119. package/dist/mcp-server/index.test.js.map +1 -0
  120. package/dist/mcp-server/mcp-tool-audit.d.ts +6 -0
  121. package/dist/mcp-server/mcp-tool-audit.js +47 -0
  122. package/dist/mcp-server/mcp-tool-audit.js.map +1 -0
  123. package/dist/mcp-server/stdio.d.ts +2 -0
  124. package/dist/mcp-server/stdio.js +7 -0
  125. package/dist/mcp-server/stdio.js.map +1 -0
  126. package/dist/mcp.d.ts +2 -0
  127. package/dist/mcp.js +19 -0
  128. package/dist/mcp.js.map +1 -0
  129. package/dist/open-storage-driver.d.ts +53 -0
  130. package/dist/open-storage-driver.js +71 -0
  131. package/dist/open-storage-driver.js.map +1 -0
  132. package/dist/open-synchronize-stores.d.ts +24 -0
  133. package/dist/open-synchronize-stores.js +34 -0
  134. package/dist/open-synchronize-stores.js.map +1 -0
  135. package/dist/project-identity.d.ts +23 -0
  136. package/dist/project-identity.js +121 -0
  137. package/dist/project-identity.js.map +1 -0
  138. package/dist/runtime-access-boundary.d.ts +7 -0
  139. package/dist/runtime-access-boundary.js +182 -0
  140. package/dist/runtime-access-boundary.js.map +1 -0
  141. package/dist/service-discovery.d.ts +10 -0
  142. package/dist/service-discovery.js +64 -0
  143. package/dist/service-discovery.js.map +1 -0
  144. package/dist/site/assets.d.ts +4 -0
  145. package/dist/site/assets.js +46 -0
  146. package/dist/site/assets.js.map +1 -0
  147. package/dist/site/cloud-events-relay.d.ts +18 -0
  148. package/dist/site/cloud-events-relay.js +78 -0
  149. package/dist/site/cloud-events-relay.js.map +1 -0
  150. package/dist/site/index.d.ts +1 -0
  151. package/dist/site/index.js +2 -0
  152. package/dist/site/index.js.map +1 -0
  153. package/dist/site/server.d.ts +42 -0
  154. package/dist/site/server.js +320 -0
  155. package/dist/site/server.js.map +1 -0
  156. package/dist/skill-installer.d.ts +35 -0
  157. package/dist/skill-installer.js +174 -0
  158. package/dist/skill-installer.js.map +1 -0
  159. package/dist/vitest-setup.d.ts +1 -0
  160. package/dist/vitest-setup.js +7 -0
  161. package/dist/vitest-setup.js.map +1 -0
  162. package/package.json +42 -0
  163. package/site/dist/assets/index-DKEVC0aQ.css +1 -0
  164. package/site/dist/assets/index-DSR4mIml.js +4396 -0
  165. package/site/dist/index.html +14 -0
  166. package/skills/agent-issues-language.md +5 -0
  167. package/skills/agent-issues-operating-contract.md +208 -0
  168. package/skills/ai-agent-issues/SKILL.md +127 -0
  169. package/skills/ai-domain-modeling/ADR-FORMAT.md +48 -0
  170. package/skills/ai-domain-modeling/CONTEXT-FORMAT.md +54 -0
  171. package/skills/ai-domain-modeling/SKILL.md +45 -0
  172. package/skills/ai-grill-with-docs/SKILL.md +28 -0
  173. package/skills/ai-handoff/SKILL.md +41 -0
  174. package/skills/ai-implement/SKILL.md +98 -0
  175. package/skills/ai-migrate-docs/SKILL.md +65 -0
  176. package/skills/ai-next-work/SKILL.md +43 -0
  177. package/skills/ai-plan/SKILL.md +41 -0
  178. package/skills/ai-prepare/SKILL.md +79 -0
  179. package/skills/ai-prototype/LOGIC.md +67 -0
  180. package/skills/ai-prototype/SKILL.md +31 -0
  181. package/skills/ai-prototype/UI.md +112 -0
  182. package/skills/ai-recipe-migration/SKILL.md +49 -0
  183. package/skills/ai-start-work/SKILL.md +56 -0
  184. package/skills/ai-tdd/SKILL.md +99 -0
  185. package/skills/ai-tdd/deep-modules.md +33 -0
  186. package/skills/ai-tdd/interface-design.md +20 -0
  187. package/skills/ai-tdd/mocking.md +28 -0
  188. package/skills/ai-tdd/refactoring.md +10 -0
  189. package/skills/ai-tdd/tests.md +74 -0
  190. package/skills/ai-to-issues/SKILL.md +70 -0
  191. package/skills/ai-to-prd/SKILL.md +33 -0
  192. package/skills/ai-wayfinder/SKILL.md +110 -0
  193. package/skills/recipes/README.md +29 -0
  194. package/skills/recipes/adr.md +21 -0
  195. package/skills/recipes/context-summary.md +17 -0
  196. package/skills/recipes/context-term.md +3 -0
  197. package/skills/recipes/debt.md +21 -0
  198. package/skills/recipes/epic.md +21 -0
  199. package/skills/recipes/handoff.md +29 -0
  200. package/skills/recipes/initiative.md +21 -0
  201. package/skills/recipes/issue-comment.md +15 -0
  202. package/skills/recipes/issue.md +33 -0
  203. package/skills/recipes/prd.md +29 -0
  204. package/skills/recipes/project.md +21 -0
  205. package/skills/recipes/user-story.md +15 -0
  206. package/skills/recipes/version.md +13 -0
  207. package/skills/recipes/wayfinder-map.md +25 -0
  208. package/skills/recipes/wayfinder-ticket.md +17 -0
@@ -0,0 +1,343 @@
1
+ import { projectPlanEntries } from "@agent-issues/core";
2
+ export function renderInitiativeMarkdownExport(input, options = {}) {
3
+ const { bundle, commentsByIssueId = {}, context, planEntries = [], relations, users = [] } = input;
4
+ const includeFrontmatter = options.includeFrontmatter ?? true;
5
+ const headingLevel = options.headingLevel ?? 1;
6
+ const entityIds = collectBundleEntityIds(bundle);
7
+ const bundleRelations = relations.filter((relation) => entityIds.has(relation.fromId) && entityIds.has(relation.toId));
8
+ const frontmatter = {
9
+ type: "initiative-export",
10
+ initiative: summarizeEntity(bundle.initiative),
11
+ counts: {
12
+ entities: bundle.entities.length,
13
+ prds: bundle.prds.length,
14
+ userStories: bundle.userStories.length,
15
+ adrs: bundle.adrs.length,
16
+ issues: bundle.issues.length,
17
+ relations: bundleRelations.length
18
+ },
19
+ connections: summarizeRelations(bundleRelations),
20
+ context: summarizeContext(context),
21
+ generatedAt: new Date().toISOString()
22
+ };
23
+ const sections = [
24
+ includeFrontmatter ? renderFrontmatter(frontmatter) : "",
25
+ renderEntitySection(bundle.initiative, headingLevel),
26
+ renderContextSection(context, headingLevel + 1),
27
+ renderEntityCollection("PRDs", bundle.prds, headingLevel + 1),
28
+ renderEntityCollection("User Stories", bundle.userStories, headingLevel + 1),
29
+ renderEntityCollection("ADRs", bundle.adrs, headingLevel + 1),
30
+ renderEntityCollection("Issues", bundle.issues, headingLevel + 1, commentsByIssueId, users),
31
+ renderEntityCollection("Entities", bundle.entities.filter((entity) => entity.id !== bundle.initiative.id && !["prd", "userStory", "adr", "issue"].includes(entity.kind)), headingLevel + 1, commentsByIssueId, users, planEntries),
32
+ renderRelationsSection("Relations", bundleRelations, headingLevel + 1)
33
+ ];
34
+ return sections
35
+ .filter((section) => section.length > 0)
36
+ .join("\n\n");
37
+ }
38
+ export function renderProjectMarkdownExport(input) {
39
+ const { commentsByIssueId = {}, snapshot } = input;
40
+ const frontmatter = {
41
+ type: "project-export",
42
+ generatedAt: snapshot.generatedAt,
43
+ counts: {
44
+ entities: snapshot.entities.length,
45
+ relations: snapshot.relations.length,
46
+ initiatives: snapshot.initiatives.length,
47
+ projectAdrs: snapshot.projectAdrs.length,
48
+ orphans: snapshot.orphans.length
49
+ },
50
+ connections: summarizeRelations(snapshot.relations),
51
+ sharedContext: summarizeContext(snapshot.contexts.shared)
52
+ };
53
+ const initiativeSections = snapshot.initiatives.map((bundle) => {
54
+ const context = snapshot.contexts.initiatives.find((details) => details.context.scopeEntityId === bundle.initiative.id) ?? emptyInitiativeContext(bundle.initiative);
55
+ return renderInitiativeMarkdownExport({
56
+ bundle,
57
+ commentsByIssueId,
58
+ context,
59
+ planEntries: snapshot.planEntries,
60
+ relations: snapshot.relations,
61
+ users: snapshot.users
62
+ }, {
63
+ includeFrontmatter: false,
64
+ headingLevel: 2
65
+ });
66
+ });
67
+ return [
68
+ renderFrontmatter(frontmatter),
69
+ "# Project Export",
70
+ renderProjectSummary(snapshot),
71
+ renderUserDirectorySection(snapshot),
72
+ renderEntityCollection("Entities", snapshot.entities, 2, commentsByIssueId, snapshot.users, snapshot.planEntries),
73
+ renderRelationsSection("Relations", snapshot.relations, 2),
74
+ initiativeSections.join("\n\n")
75
+ ]
76
+ .filter((section) => section.length > 0)
77
+ .join("\n\n");
78
+ }
79
+ function renderProjectSummary(snapshot) {
80
+ return [
81
+ `Generated at: ${snapshot.generatedAt}`,
82
+ `Initiatives: ${snapshot.initiatives.length}`,
83
+ `Entities: ${snapshot.entities.length}`,
84
+ `Relations: ${snapshot.relations.length}`
85
+ ].join("\n");
86
+ }
87
+ function renderUserDirectorySection(snapshot) {
88
+ const users = collectReferencedUsers(snapshot);
89
+ if (users.length === 0) {
90
+ return "## User Directory\n\nNone.";
91
+ }
92
+ return [
93
+ "## User Directory",
94
+ ...users.map((user) => `- ${user.id}: ${user.authenticationSubject}${user.displayName ? ` (${user.displayName})` : ""}`)
95
+ ].join("\n");
96
+ }
97
+ function collectReferencedUsers(snapshot) {
98
+ const userIds = new Set();
99
+ for (const entity of snapshot.entities) {
100
+ userIds.add(entity.createdBy);
101
+ userIds.add(entity.updatedBy);
102
+ }
103
+ for (const relation of snapshot.relations) {
104
+ userIds.add(relation.createdBy);
105
+ }
106
+ for (const context of [snapshot.contexts.shared, ...snapshot.contexts.initiatives]) {
107
+ if (context.context.createdBy)
108
+ userIds.add(context.context.createdBy);
109
+ if (context.context.updatedBy)
110
+ userIds.add(context.context.updatedBy);
111
+ for (const term of context.terms) {
112
+ userIds.add(term.createdBy);
113
+ userIds.add(term.updatedBy);
114
+ }
115
+ }
116
+ return snapshot.users
117
+ .filter((user) => userIds.has(user.id))
118
+ .map((user) => ({ id: user.id, authenticationSubject: user.authenticationSubject, displayName: user.displayName }));
119
+ }
120
+ function renderEntitySection(entity, level, commentsByIssueId = {}, users = [], planEntries = []) {
121
+ const header = `${"#".repeat(level)} ${entity.id} ${entity.title}`;
122
+ const metadata = [
123
+ `Kind: ${entity.kind}`,
124
+ `Status: ${entity.status}`,
125
+ ...(entity.category ? [`Category: ${entity.category}`] : []),
126
+ ...(entity.priority ? [`Priority: ${entity.priority}`] : []),
127
+ ...(entity.type ? [`Type: ${entity.type}`] : []),
128
+ `Created by: ${entity.createdBy}`,
129
+ `Updated by: ${entity.updatedBy}`,
130
+ `Created: ${entity.createdAt}`,
131
+ `Updated: ${entity.updatedAt}`,
132
+ `Body source: ${entity.bodySource}`
133
+ ].join("\n");
134
+ const body = entity.body.trim().length > 0 ? entity.body : "_No body._";
135
+ const conversation = entity.kind === "issue"
136
+ ? renderIssueConversationMarkdown(commentsByIssueId[entity.id] ?? [], users, level + 1)
137
+ : "";
138
+ const planProjection = entity.kind === "plan"
139
+ ? renderPlanProjectionMarkdown(planEntries.filter((entry) => entry.planId === entity.id), level + 1)
140
+ : "";
141
+ return [header, metadata, body, planProjection, conversation].filter((section) => section.length > 0).join("\n\n");
142
+ }
143
+ function renderEntityCollection(title, entities, headingLevel, commentsByIssueId = {}, users = [], planEntries = []) {
144
+ if (entities.length === 0) {
145
+ return `${"#".repeat(headingLevel)} ${title}\n\nNone.`;
146
+ }
147
+ return [`${"#".repeat(headingLevel)} ${title}`, ...entities.map((entity) => renderEntitySection(entity, 3, commentsByIssueId, users, planEntries))].join("\n\n");
148
+ }
149
+ export function renderPlanProjectionMarkdown(entries, headingLevel) {
150
+ const projection = projectPlanEntries(entries);
151
+ const referencesById = new Map(projection.history.map((entry) => [entry.id, entry.reference]));
152
+ const renderEntry = (entry) => {
153
+ const references = entry.referencedEntityIds.length > 0 ? ` References: ${entry.referencedEntityIds.join(", ")}.` : "";
154
+ const supersession = entry.supersededEntryIds.length > 0 ? ` Supersedes: ${entry.supersededEntryIds.map((id) => referencesById.get(id) ?? id).join(", ")}.` : "";
155
+ return `- ${entry.reference}: ${entry.tombstone ? "Deleted entry" : entry.body ?? ""}${references}${supersession}`;
156
+ };
157
+ const current = projection.current.map((group) => {
158
+ const content = group.entries.length === 0
159
+ ? "None."
160
+ : group.entries.map(renderEntry).join("\n");
161
+ return [`${"#".repeat(headingLevel + 1)} ${group.title}`, content].join("\n\n");
162
+ }).join("\n\n");
163
+ const history = projection.history.length === 0
164
+ ? "None."
165
+ : projection.history.map(renderEntry).join("\n");
166
+ return [`${"#".repeat(headingLevel)} Current Plan`, current, `${"#".repeat(headingLevel)} Plan Entry History`, history].join("\n\n");
167
+ }
168
+ export function renderIssueConversationMarkdown(comments, users, headingLevel) {
169
+ const heading = `${"#".repeat(headingLevel)} Conversation`;
170
+ if (comments.length === 0) {
171
+ return `${heading}\n\nNo comments.`;
172
+ }
173
+ return [heading, ...comments.map((comment) => renderIssueComment(comment, users, headingLevel + 1))].join("\n\n");
174
+ }
175
+ function renderIssueComment(comment, users, headingLevel) {
176
+ const metadata = [
177
+ `Created by: ${resolveUser(comment.createdBy, users)}`,
178
+ `Updated by: ${resolveUser(comment.updatedBy, users)}`,
179
+ `Created: ${comment.createdAt}`,
180
+ `Updated: ${comment.updatedAt}`,
181
+ `References: ${comment.referencedIssueIds.length > 0 ? comment.referencedIssueIds.join(", ") : "none"}`
182
+ ].join("\n");
183
+ const body = comment.tombstone ? "Deleted comment" : comment.body ?? "";
184
+ return [`${"#".repeat(headingLevel)} ${comment.reference}`, metadata, body].join("\n\n");
185
+ }
186
+ function resolveUser(userId, users) {
187
+ const user = users.find((candidate) => candidate.id === userId);
188
+ if (!user) {
189
+ return userId;
190
+ }
191
+ return user.displayName ? `${user.displayName} (${user.authenticationSubject})` : user.authenticationSubject;
192
+ }
193
+ function renderRelationsSection(title, relations, headingLevel) {
194
+ if (relations.length === 0) {
195
+ return `${"#".repeat(headingLevel)} ${title}\n\nNone.`;
196
+ }
197
+ const lines = relations.map((relation) => `- ${relation.fromId} --${relation.type}--> ${relation.toId} createdBy=${relation.createdBy} created=${relation.createdAt}`);
198
+ return [`${"#".repeat(headingLevel)} ${title}`, ...lines].join("\n");
199
+ }
200
+ function renderContextSection(context, headingLevel) {
201
+ const header = `${"#".repeat(headingLevel)} Context`;
202
+ const metadata = [
203
+ `Scope: ${context.context.scopeKind}`,
204
+ `Label: ${context.context.scopeLabel}`,
205
+ `Title: ${context.context.title}`,
206
+ `Created by: ${context.context.createdBy ?? "none"}`,
207
+ `Updated by: ${context.context.updatedBy ?? "none"}`,
208
+ `Summary: ${context.context.summary}`
209
+ ].join("\n");
210
+ if (context.terms.length === 0) {
211
+ return [header, metadata, "No terms."].join("\n\n");
212
+ }
213
+ const terms = context.terms.map((term) => {
214
+ const avoid = term.avoid.length > 0 ? ` Avoid: ${term.avoid.join(", ")}.` : "";
215
+ return `- ${term.term}: ${term.definition}.${avoid} Created by: ${term.createdBy}. Updated by: ${term.updatedBy}.`;
216
+ });
217
+ return [header, metadata, `${"#".repeat(headingLevel + 1)} Terms`, ...terms].join("\n\n");
218
+ }
219
+ function summarizeEntity(entity) {
220
+ return {
221
+ id: entity.id,
222
+ createdBy: entity.createdBy,
223
+ updatedBy: entity.updatedBy,
224
+ kind: entity.kind,
225
+ status: entity.status,
226
+ title: entity.title
227
+ };
228
+ }
229
+ function summarizeRelations(relations) {
230
+ return relations.map((relation) => ({
231
+ from: relation.fromId,
232
+ type: relation.type,
233
+ to: relation.toId,
234
+ createdBy: relation.createdBy,
235
+ createdAt: relation.createdAt
236
+ }));
237
+ }
238
+ function summarizeContext(context) {
239
+ return {
240
+ key: context.context.key,
241
+ scopeKind: context.context.scopeKind,
242
+ scopeEntityId: context.context.scopeEntityId,
243
+ scopeLabel: context.context.scopeLabel,
244
+ title: context.context.title,
245
+ summary: context.context.summary,
246
+ createdBy: context.context.createdBy,
247
+ updatedBy: context.context.updatedBy,
248
+ termCount: context.terms.length,
249
+ terms: context.terms.map((term) => ({
250
+ term: term.term,
251
+ definition: term.definition,
252
+ avoid: term.avoid,
253
+ createdBy: term.createdBy,
254
+ updatedBy: term.updatedBy
255
+ }))
256
+ };
257
+ }
258
+ export function renderFrontmatter(value) {
259
+ return `---\n${toYaml(value, 0)}---`;
260
+ }
261
+ function toYaml(value, indent) {
262
+ const prefix = " ".repeat(indent);
263
+ if (Array.isArray(value)) {
264
+ if (value.length === 0) {
265
+ return `${prefix}[]\n`;
266
+ }
267
+ return value
268
+ .map((entry) => {
269
+ if (isScalar(entry)) {
270
+ return `${prefix}- ${formatScalar(entry)}\n`;
271
+ }
272
+ const nested = toYaml(entry, indent + 2);
273
+ return `${prefix}-\n${nested}`;
274
+ })
275
+ .join("");
276
+ }
277
+ if (isPlainObject(value)) {
278
+ return Object.entries(value)
279
+ .map(([key, entry]) => {
280
+ if (isScalar(entry)) {
281
+ return `${prefix}${key}: ${formatScalar(entry)}\n`;
282
+ }
283
+ if (Array.isArray(entry) && entry.length === 0) {
284
+ return `${prefix}${key}: []\n`;
285
+ }
286
+ return `${prefix}${key}:\n${toYaml(entry, indent + 2)}`;
287
+ })
288
+ .join("");
289
+ }
290
+ return `${prefix}${formatScalar(value)}\n`;
291
+ }
292
+ function formatScalar(value) {
293
+ if (typeof value === "string") {
294
+ return JSON.stringify(value);
295
+ }
296
+ if (typeof value === "number" || typeof value === "boolean") {
297
+ return String(value);
298
+ }
299
+ if (value === null) {
300
+ return "null";
301
+ }
302
+ return JSON.stringify(String(value));
303
+ }
304
+ function isScalar(value) {
305
+ return value === null || ["string", "number", "boolean"].includes(typeof value);
306
+ }
307
+ function isPlainObject(value) {
308
+ return typeof value === "object" && value !== null && !Array.isArray(value);
309
+ }
310
+ function collectBundleEntityIds(bundle) {
311
+ return new Set([
312
+ bundle.initiative.id,
313
+ ...bundle.entities.map((entity) => entity.id),
314
+ ...bundle.prds.map((entity) => entity.id),
315
+ ...bundle.userStories.map((entity) => entity.id),
316
+ ...bundle.adrs.map((entity) => entity.id),
317
+ ...bundle.issues.map((entity) => entity.id)
318
+ ]);
319
+ }
320
+ function emptyInitiativeContext(initiative) {
321
+ return {
322
+ context: {
323
+ id: null,
324
+ reference: null,
325
+ shortReference: null,
326
+ createdBy: null,
327
+ updatedBy: null,
328
+ key: initiative.id,
329
+ scopeKind: "initiative",
330
+ scopeEntityId: initiative.id,
331
+ scopeLabel: initiative.title,
332
+ title: `${initiative.title} Context`,
333
+ summary: "",
334
+ revision: 0,
335
+ contentHash: "",
336
+ createdAt: null,
337
+ updatedAt: null,
338
+ exists: false
339
+ },
340
+ terms: []
341
+ };
342
+ }
343
+ //# sourceMappingURL=export-markdown.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export-markdown.js","sourceRoot":"","sources":["../src/export-markdown.ts"],"names":[],"mappings":"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"}
package/dist/help.d.ts ADDED
@@ -0,0 +1,112 @@
1
+ import { ALLOWED_RELATIONS, type EntityKind } from "@agent-issues/core";
2
+ import type { ListSkillsResult } from "./skill-installer.js";
3
+ type OptionSpec = {
4
+ name: string;
5
+ description: string;
6
+ required?: boolean;
7
+ allowedValues?: readonly string[];
8
+ };
9
+ type PositionalSpec = {
10
+ name: string;
11
+ description: string;
12
+ required?: boolean;
13
+ allowedValues?: readonly string[];
14
+ };
15
+ type CommandSpec = {
16
+ name: string;
17
+ summary: string;
18
+ usage: string[];
19
+ positionals?: PositionalSpec[];
20
+ options?: OptionSpec[];
21
+ examples?: string[];
22
+ notes?: string[];
23
+ output?: {
24
+ human?: string[];
25
+ json?: string[];
26
+ };
27
+ };
28
+ type GlobalOptionSpec = OptionSpec;
29
+ export type HelpPayload = {
30
+ name: string;
31
+ summary: string;
32
+ globalOptions: GlobalOptionSpec[];
33
+ commands: Array<{
34
+ name: string;
35
+ summary: string;
36
+ usage: string[];
37
+ }>;
38
+ discovery: string[];
39
+ command?: CommandSpec;
40
+ };
41
+ export type CapabilitiesPayload = {
42
+ help: HelpPayload;
43
+ schema: SchemaPayload;
44
+ skills: ListSkillsResult;
45
+ };
46
+ export type SchemaPayload = {
47
+ entityCategories: readonly string[];
48
+ entityKinds: Array<{
49
+ kind: EntityKind;
50
+ idPrefix: string;
51
+ initialStatus: string;
52
+ statuses: readonly string[];
53
+ archiveStatus: string;
54
+ }>;
55
+ entityPriorities: readonly string[];
56
+ relationTypes: string[];
57
+ allowedRelations: typeof ALLOWED_RELATIONS;
58
+ structuralRelationTypes: readonly string[];
59
+ parentRules: Array<{
60
+ parentKind: EntityKind;
61
+ childKind: EntityKind;
62
+ relationType: string;
63
+ }>;
64
+ context: {
65
+ storage: "database";
66
+ scopes: string[];
67
+ defaultKey: string;
68
+ listCommand: string;
69
+ readCommand: string;
70
+ searchCommand: string;
71
+ conflictsCommand: string;
72
+ initializeCommand: string;
73
+ defineCommand: string;
74
+ forgetCommand: string;
75
+ termFields: string[];
76
+ };
77
+ issueComments: {
78
+ storage: "database";
79
+ parentKind: "issue";
80
+ recordPrefix: "COM";
81
+ addCommand: string;
82
+ listCommand: string;
83
+ editCommand: string;
84
+ deleteCommand: string;
85
+ historyCommand: string;
86
+ fields: string[];
87
+ };
88
+ planEntries: {
89
+ storage: "database";
90
+ parentKind: "plan";
91
+ recordPrefix: "PLAN_ENTRY";
92
+ linkRelationType: "informs";
93
+ linkTargetKind: "issue";
94
+ addCommand: string;
95
+ linkCommand: string;
96
+ unlinkCommand: string;
97
+ fields: string[];
98
+ };
99
+ };
100
+ export declare function isKnownCommand(commandName: string): boolean;
101
+ /**
102
+ * Resolves a help lookup from raw positionals to a command spec name,
103
+ * preferring the longest match so multi-word commands (e.g. "auth login")
104
+ * are found before falling back to their first word alone.
105
+ */
106
+ export declare function resolveHelpCommandName(positionals: string[]): string | undefined;
107
+ export declare function getHelpPayload(commandName?: string): HelpPayload;
108
+ export declare function getCapabilitiesPayload(skills: ListSkillsResult): CapabilitiesPayload;
109
+ export declare function renderHelp(payload: HelpPayload): string;
110
+ export declare function getSchemaPayload(): SchemaPayload;
111
+ export declare function renderSchema(payload: SchemaPayload): string;
112
+ export {};