@backendkit-labs/agent-coding 0.29.0 → 0.31.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 (212) hide show
  1. package/README.md +20 -10
  2. package/dist/__tests__/cli-baseline.test.d.ts +2 -0
  3. package/dist/__tests__/cli-baseline.test.d.ts.map +1 -0
  4. package/dist/__tests__/cli-baseline.test.js +114 -0
  5. package/dist/__tests__/cli-baseline.test.js.map +1 -0
  6. package/dist/__tests__/createCodingEngine.forwarding.test.js +2 -1
  7. package/dist/__tests__/createCodingEngine.forwarding.test.js.map +1 -1
  8. package/dist/__tests__/createCodingEngine.learning.test.d.ts +2 -0
  9. package/dist/__tests__/createCodingEngine.learning.test.d.ts.map +1 -0
  10. package/dist/__tests__/createCodingEngine.learning.test.js +81 -0
  11. package/dist/__tests__/createCodingEngine.learning.test.js.map +1 -0
  12. package/dist/__tests__/workspace-trust.test.js +7 -5
  13. package/dist/__tests__/workspace-trust.test.js.map +1 -1
  14. package/dist/agents/AgentLoader.d.ts.map +1 -1
  15. package/dist/agents/AgentLoader.js +2 -1
  16. package/dist/agents/AgentLoader.js.map +1 -1
  17. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts +22 -0
  18. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts.map +1 -0
  19. package/dist/cli/agent-discovery/AgentPackageLoader.js +100 -0
  20. package/dist/cli/agent-discovery/AgentPackageLoader.js.map +1 -0
  21. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts +31 -0
  22. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts.map +1 -0
  23. package/dist/cli/agent-discovery/RemoteAgentRegistry.js +106 -0
  24. package/dist/cli/agent-discovery/RemoteAgentRegistry.js.map +1 -0
  25. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts +2 -0
  26. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts.map +1 -0
  27. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js +34 -0
  28. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js.map +1 -0
  29. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts +2 -0
  30. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts.map +1 -0
  31. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js +147 -0
  32. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js.map +1 -0
  33. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts +2 -0
  34. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts.map +1 -0
  35. package/dist/cli/agent-discovery/__tests__/download-guard.test.js +47 -0
  36. package/dist/cli/agent-discovery/__tests__/download-guard.test.js.map +1 -0
  37. package/dist/cli/agent-discovery/discoverAgents.d.ts +21 -0
  38. package/dist/cli/agent-discovery/discoverAgents.d.ts.map +1 -0
  39. package/dist/cli/agent-discovery/discoverAgents.js +74 -0
  40. package/dist/cli/agent-discovery/discoverAgents.js.map +1 -0
  41. package/dist/cli/agent-discovery/download-guard.d.ts +20 -0
  42. package/dist/cli/agent-discovery/download-guard.d.ts.map +1 -0
  43. package/dist/cli/agent-discovery/download-guard.js +84 -0
  44. package/dist/cli/agent-discovery/download-guard.js.map +1 -0
  45. package/dist/cli/agent-discovery/index.d.ts +5 -0
  46. package/dist/cli/agent-discovery/index.d.ts.map +1 -0
  47. package/dist/cli/agent-discovery/index.js +12 -0
  48. package/dist/cli/agent-discovery/index.js.map +1 -0
  49. package/dist/cli/agent-discovery/types.d.ts +48 -0
  50. package/dist/cli/agent-discovery/types.d.ts.map +1 -0
  51. package/dist/cli/agent-discovery/types.js +3 -0
  52. package/dist/cli/agent-discovery/types.js.map +1 -0
  53. package/dist/cli/bootstrap/GlobalSeed.d.ts +46 -0
  54. package/dist/cli/bootstrap/GlobalSeed.d.ts.map +1 -0
  55. package/dist/cli/bootstrap/GlobalSeed.js +285 -0
  56. package/dist/cli/bootstrap/GlobalSeed.js.map +1 -0
  57. package/dist/cli/bootstrap/config.d.ts +24 -0
  58. package/dist/cli/bootstrap/config.d.ts.map +1 -0
  59. package/dist/cli/bootstrap/config.js +71 -0
  60. package/dist/cli/bootstrap/config.js.map +1 -0
  61. package/dist/cli/checkpoint/index.d.ts +17 -0
  62. package/dist/cli/checkpoint/index.d.ts.map +1 -0
  63. package/dist/cli/checkpoint/index.js +207 -0
  64. package/dist/cli/checkpoint/index.js.map +1 -0
  65. package/dist/cli/commands/builtin.d.ts +7 -0
  66. package/dist/cli/commands/builtin.d.ts.map +1 -0
  67. package/dist/cli/commands/builtin.js +962 -0
  68. package/dist/cli/commands/builtin.js.map +1 -0
  69. package/dist/cli/context/__tests__/formatPipeline.test.d.ts +2 -0
  70. package/dist/cli/context/__tests__/formatPipeline.test.d.ts.map +1 -0
  71. package/dist/cli/context/__tests__/formatPipeline.test.js +25 -0
  72. package/dist/cli/context/__tests__/formatPipeline.test.js.map +1 -0
  73. package/dist/cli/context/index.d.ts +8 -0
  74. package/dist/cli/context/index.d.ts.map +1 -0
  75. package/dist/cli/context/index.js +8 -0
  76. package/dist/cli/context/index.js.map +1 -0
  77. package/dist/cli/context/pipeline.d.ts +46 -0
  78. package/dist/cli/context/pipeline.d.ts.map +1 -0
  79. package/dist/cli/context/pipeline.js +112 -0
  80. package/dist/cli/context/pipeline.js.map +1 -0
  81. package/dist/cli/context/stages/stage-instructions.d.ts +12 -0
  82. package/dist/cli/context/stages/stage-instructions.d.ts.map +1 -0
  83. package/dist/cli/context/stages/stage-instructions.js +76 -0
  84. package/dist/cli/context/stages/stage-instructions.js.map +1 -0
  85. package/dist/cli/context/stages/stage-lessons.d.ts +13 -0
  86. package/dist/cli/context/stages/stage-lessons.d.ts.map +1 -0
  87. package/dist/cli/context/stages/stage-lessons.js +83 -0
  88. package/dist/cli/context/stages/stage-lessons.js.map +1 -0
  89. package/dist/cli/context/stages/stage-manifest.d.ts +11 -0
  90. package/dist/cli/context/stages/stage-manifest.d.ts.map +1 -0
  91. package/dist/cli/context/stages/stage-manifest.js +62 -0
  92. package/dist/cli/context/stages/stage-manifest.js.map +1 -0
  93. package/dist/cli/context/stages/stage-project.d.ts +10 -0
  94. package/dist/cli/context/stages/stage-project.d.ts.map +1 -0
  95. package/dist/cli/context/stages/stage-project.js +55 -0
  96. package/dist/cli/context/stages/stage-project.js.map +1 -0
  97. package/dist/cli/context/stages/stage-session.d.ts +12 -0
  98. package/dist/cli/context/stages/stage-session.d.ts.map +1 -0
  99. package/dist/cli/context/stages/stage-session.js +69 -0
  100. package/dist/cli/context/stages/stage-session.js.map +1 -0
  101. package/dist/cli/file-sources.d.ts +17 -0
  102. package/dist/cli/file-sources.d.ts.map +1 -0
  103. package/dist/cli/file-sources.js +42 -0
  104. package/dist/cli/file-sources.js.map +1 -0
  105. package/dist/cli/index.d.ts +26 -0
  106. package/dist/cli/index.d.ts.map +1 -0
  107. package/dist/cli/index.js +55 -0
  108. package/dist/cli/index.js.map +1 -0
  109. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts +2 -0
  110. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts.map +1 -0
  111. package/dist/cli/skills/__tests__/SkillLoader.test.js +285 -0
  112. package/dist/cli/skills/__tests__/SkillLoader.test.js.map +1 -0
  113. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts +2 -0
  114. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts.map +1 -0
  115. package/dist/cli/skills/__tests__/SkillManager.safety.test.js +87 -0
  116. package/dist/cli/skills/__tests__/SkillManager.safety.test.js.map +1 -0
  117. package/dist/cli/skills/__tests__/stack.test.d.ts +2 -0
  118. package/dist/cli/skills/__tests__/stack.test.d.ts.map +1 -0
  119. package/dist/cli/skills/__tests__/stack.test.js +81 -0
  120. package/dist/cli/skills/__tests__/stack.test.js.map +1 -0
  121. package/dist/cli/skills/loader.d.ts +42 -0
  122. package/dist/cli/skills/loader.d.ts.map +1 -0
  123. package/dist/cli/skills/loader.js +158 -0
  124. package/dist/cli/skills/loader.js.map +1 -0
  125. package/dist/cli/skills/manager.d.ts +97 -0
  126. package/dist/cli/skills/manager.d.ts.map +1 -0
  127. package/dist/cli/skills/manager.js +304 -0
  128. package/dist/cli/skills/manager.js.map +1 -0
  129. package/dist/cli/skills/parse-md-skill.d.ts +14 -0
  130. package/dist/cli/skills/parse-md-skill.d.ts.map +1 -0
  131. package/dist/cli/skills/parse-md-skill.js +86 -0
  132. package/dist/cli/skills/parse-md-skill.js.map +1 -0
  133. package/dist/cli/skills/providers/github.d.ts +21 -0
  134. package/dist/cli/skills/providers/github.d.ts.map +1 -0
  135. package/dist/cli/skills/providers/github.js +146 -0
  136. package/dist/cli/skills/providers/github.js.map +1 -0
  137. package/dist/cli/skills/providers/index.d.ts +6 -0
  138. package/dist/cli/skills/providers/index.d.ts.map +1 -0
  139. package/dist/cli/skills/providers/index.js +12 -0
  140. package/dist/cli/skills/providers/index.js.map +1 -0
  141. package/dist/cli/skills/providers/local.d.ts +16 -0
  142. package/dist/cli/skills/providers/local.d.ts.map +1 -0
  143. package/dist/cli/skills/providers/local.js +91 -0
  144. package/dist/cli/skills/providers/local.js.map +1 -0
  145. package/dist/cli/skills/providers/obsidian.d.ts +31 -0
  146. package/dist/cli/skills/providers/obsidian.d.ts.map +1 -0
  147. package/dist/cli/skills/providers/obsidian.js +141 -0
  148. package/dist/cli/skills/providers/obsidian.js.map +1 -0
  149. package/dist/cli/skills/providers/skills-sh.d.ts +32 -0
  150. package/dist/cli/skills/providers/skills-sh.d.ts.map +1 -0
  151. package/dist/cli/skills/providers/skills-sh.js +53 -0
  152. package/dist/cli/skills/providers/skills-sh.js.map +1 -0
  153. package/dist/cli/skills/providers/types.d.ts +25 -0
  154. package/dist/cli/skills/providers/types.d.ts.map +1 -0
  155. package/dist/cli/skills/providers/types.js +3 -0
  156. package/dist/cli/skills/providers/types.js.map +1 -0
  157. package/dist/cli/skills/safe-name.d.ts +2 -0
  158. package/dist/cli/skills/safe-name.d.ts.map +1 -0
  159. package/dist/cli/skills/safe-name.js +22 -0
  160. package/dist/cli/skills/safe-name.js.map +1 -0
  161. package/dist/cli/skills/stack.d.ts +3 -0
  162. package/dist/cli/skills/stack.d.ts.map +1 -0
  163. package/dist/cli/skills/stack.js +64 -0
  164. package/dist/cli/skills/stack.js.map +1 -0
  165. package/dist/cli/skills/types.d.ts +28 -0
  166. package/dist/cli/skills/types.d.ts.map +1 -0
  167. package/dist/cli/skills/types.js +3 -0
  168. package/dist/cli/skills/types.js.map +1 -0
  169. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts +2 -0
  170. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts.map +1 -0
  171. package/dist/cli/trust/__tests__/workspace-trust.test.js +252 -0
  172. package/dist/cli/trust/__tests__/workspace-trust.test.js.map +1 -0
  173. package/dist/cli/trust/workspace-trust.d.ts +49 -0
  174. package/dist/cli/trust/workspace-trust.d.ts.map +1 -0
  175. package/dist/cli/trust/workspace-trust.js +163 -0
  176. package/dist/cli/trust/workspace-trust.js.map +1 -0
  177. package/dist/cli/workspace/index.d.ts +68 -0
  178. package/dist/cli/workspace/index.d.ts.map +1 -0
  179. package/dist/cli/workspace/index.js +231 -0
  180. package/dist/cli/workspace/index.js.map +1 -0
  181. package/dist/index.d.ts +13 -1
  182. package/dist/index.d.ts.map +1 -1
  183. package/dist/index.js +17 -7
  184. package/dist/index.js.map +1 -1
  185. package/dist/pipeline/index.d.ts +2 -0
  186. package/dist/pipeline/index.d.ts.map +1 -1
  187. package/dist/pipeline/index.js +7 -1
  188. package/dist/pipeline/index.js.map +1 -1
  189. package/dist/pipeline/learning/__tests__/learning.test.d.ts +2 -0
  190. package/dist/pipeline/learning/__tests__/learning.test.d.ts.map +1 -0
  191. package/dist/pipeline/learning/__tests__/learning.test.js +145 -0
  192. package/dist/pipeline/learning/__tests__/learning.test.js.map +1 -0
  193. package/dist/pipeline/learning/index.d.ts +33 -0
  194. package/dist/pipeline/learning/index.d.ts.map +1 -0
  195. package/dist/pipeline/learning/index.js +131 -0
  196. package/dist/pipeline/learning/index.js.map +1 -0
  197. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts +8 -2
  198. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts.map +1 -1
  199. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js +19 -3
  200. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js.map +1 -1
  201. package/dist/pipeline/orchestration/audit-reporter.d.ts +5 -1
  202. package/dist/pipeline/orchestration/audit-reporter.d.ts.map +1 -1
  203. package/dist/pipeline/orchestration/audit-reporter.js +6 -0
  204. package/dist/pipeline/orchestration/audit-reporter.js.map +1 -1
  205. package/dist/pipeline/orchestration/orchestrator.d.ts +9 -0
  206. package/dist/pipeline/orchestration/orchestrator.d.ts.map +1 -1
  207. package/dist/pipeline/orchestration/orchestrator.js +15 -0
  208. package/dist/pipeline/orchestration/orchestrator.js.map +1 -1
  209. package/dist/store/ProjectStore.d.ts.map +1 -1
  210. package/dist/store/ProjectStore.js +2 -1
  211. package/dist/store/ProjectStore.js.map +1 -1
  212. package/package.json +10 -2
@@ -0,0 +1,17 @@
1
+ export interface CheckpointSummary {
2
+ filename: string;
3
+ date: string;
4
+ time: string;
5
+ feature: string;
6
+ path: string;
7
+ }
8
+ export declare function createCheckpoint(projectDir: string, featureName: string, description: string, sessionContent: string): Promise<string>;
9
+ export declare function listCheckpoints(projectDir: string): Promise<CheckpointSummary[]>;
10
+ /** Returns the most recent checkpoint per unique feature name. */
11
+ export declare function getLatestCheckpoints(checkpoints: CheckpointSummary[]): CheckpointSummary[];
12
+ export declare function readCheckpoint(projectDir: string, filename: string): Promise<string | null>;
13
+ /** Extracts only the session state body from a checkpoint file (strips frontmatter + headers). */
14
+ export declare function extractSessionFromCheckpoint(content: string): string;
15
+ export declare function compactSession(projectDir: string, featureName: string, checkpointRef: string): Promise<void>;
16
+ export declare function compactSessionContent(content: string): string;
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/checkpoint/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB;AAuCD,wBAAsB,gBAAgB,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgBtF;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAO1F;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMjG;AAED,kGAAkG;AAClG,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpE;AAID,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO7D"}
@@ -0,0 +1,207 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.createCheckpoint = createCheckpoint;
37
+ exports.listCheckpoints = listCheckpoints;
38
+ exports.getLatestCheckpoints = getLatestCheckpoints;
39
+ exports.readCheckpoint = readCheckpoint;
40
+ exports.extractSessionFromCheckpoint = extractSessionFromCheckpoint;
41
+ exports.compactSession = compactSession;
42
+ exports.compactSessionContent = compactSessionContent;
43
+ const fs = __importStar(require("fs/promises"));
44
+ const path = __importStar(require("path"));
45
+ // ── Constants ─────────────────────────────────────────────────────────────────
46
+ const SESSION_MAX_BYTES = 8192;
47
+ // ── Filename helpers ──────────────────────────────────────────────────────────
48
+ function buildCheckpointFilename(featureName) {
49
+ const now = new Date();
50
+ const date = now.toISOString().slice(0, 10);
51
+ const time = now.toTimeString().slice(0, 5).replace(':', '');
52
+ if (!featureName)
53
+ return `checkpoint-${date}-${time}.md`;
54
+ const safeName = featureName.replace(/[^\w\s-]/g, '').replace(/\s+/g, '-').toLowerCase();
55
+ return `checkpoint-${safeName}-${date}-${time}.md`;
56
+ }
57
+ function parseCheckpointFilename(filename) {
58
+ if (!filename.startsWith('checkpoint-') || !filename.endsWith('.md'))
59
+ return null;
60
+ const base = filename.slice('checkpoint-'.length, -'.md'.length);
61
+ // New format: {feature?}-YYYY-MM-DD-HHmm
62
+ const newFmt = base.match(/^(.*?)(\d{4}-\d{2}-\d{2})-(\d{4})$/);
63
+ if (newFmt) {
64
+ const feature = (newFmt[1] ?? '').replace(/-$/, '');
65
+ return { date: newFmt[2] ?? '', time: newFmt[3] ?? '', feature };
66
+ }
67
+ // Old format: YYYY-MM-DD-{feature} — parse for backwards compatibility
68
+ const oldFmt = base.match(/^(\d{4}-\d{2}-\d{2})-(.*)$/);
69
+ if (oldFmt) {
70
+ return { date: oldFmt[1] ?? '', time: '0000', feature: oldFmt[2] ?? '' };
71
+ }
72
+ return null;
73
+ }
74
+ // ── Checkpoint CRUD ───────────────────────────────────────────────────────────
75
+ async function createCheckpoint(projectDir, featureName, description, sessionContent) {
76
+ const now = new Date();
77
+ const date = now.toISOString().slice(0, 10);
78
+ const timeDisplay = now.toTimeString().slice(0, 5);
79
+ const label = featureName || '(unnamed)';
80
+ const cpFile = path.join(projectDir, 'checkpoints', buildCheckpointFilename(featureName));
81
+ const content = [
82
+ '---',
83
+ `tags: [memory, checkpoint${featureName ? `, ${featureName.replace(/\s+/g, '-').toLowerCase()}` : ''}]`,
84
+ `date: ${date}`,
85
+ `time: ${timeDisplay}`,
86
+ `feature: "${featureName}"`,
87
+ '---',
88
+ '',
89
+ `# Checkpoint: ${label}`,
90
+ '',
91
+ `**Date:** ${date} ${timeDisplay}`,
92
+ description ? `**Description:** ${description}` : '',
93
+ '',
94
+ '---',
95
+ '',
96
+ '## Session state at checkpoint creation',
97
+ '',
98
+ sessionContent || '*(session.md is empty)*',
99
+ ].filter(l => l !== null).join('\n');
100
+ await fs.mkdir(path.dirname(cpFile), { recursive: true });
101
+ await fs.writeFile(cpFile, content, 'utf-8');
102
+ const logFile = path.join(projectDir, 'project-log.md');
103
+ try {
104
+ const log = await fs.readFile(logFile, 'utf-8');
105
+ const row = `| ${date} ${timeDisplay} | ${label} | Checkpoint |`;
106
+ if (log.includes('## Project Milestones')) {
107
+ const updated = log.replace(/(## Project Milestones[\s\S]*?\|---.*?\n)/, `$1${row}\n`);
108
+ await fs.writeFile(logFile, updated, 'utf-8');
109
+ }
110
+ }
111
+ catch { /* no log file */ }
112
+ return cpFile;
113
+ }
114
+ async function listCheckpoints(projectDir) {
115
+ const dir = path.join(projectDir, 'checkpoints');
116
+ try {
117
+ const files = await fs.readdir(dir);
118
+ return files
119
+ .filter(f => f.startsWith('checkpoint-') && f.endsWith('.md'))
120
+ .map(f => {
121
+ const parsed = parseCheckpointFilename(f);
122
+ if (!parsed)
123
+ return null;
124
+ return { filename: f, date: parsed.date, time: parsed.time, feature: parsed.feature, path: path.join(dir, f) };
125
+ })
126
+ .filter((x) => x !== null)
127
+ .sort((a, b) => `${b.date}-${b.time}`.localeCompare(`${a.date}-${a.time}`));
128
+ }
129
+ catch {
130
+ return [];
131
+ }
132
+ }
133
+ /** Returns the most recent checkpoint per unique feature name. */
134
+ function getLatestCheckpoints(checkpoints) {
135
+ const seen = new Map();
136
+ for (const cp of checkpoints) {
137
+ const key = cp.feature || '__unnamed__';
138
+ if (!seen.has(key))
139
+ seen.set(key, cp);
140
+ }
141
+ return Array.from(seen.values());
142
+ }
143
+ async function readCheckpoint(projectDir, filename) {
144
+ try {
145
+ return await fs.readFile(path.join(projectDir, 'checkpoints', filename), 'utf-8');
146
+ }
147
+ catch {
148
+ return null;
149
+ }
150
+ }
151
+ /** Extracts only the session state body from a checkpoint file (strips frontmatter + headers). */
152
+ function extractSessionFromCheckpoint(content) {
153
+ const marker = '## Session state at checkpoint creation';
154
+ const idx = content.indexOf(marker);
155
+ if (idx === -1)
156
+ return content;
157
+ return content.slice(idx + marker.length).trim();
158
+ }
159
+ // ── Session compaction ────────────────────────────────────────────────────────
160
+ async function compactSession(projectDir, featureName, checkpointRef) {
161
+ const date = new Date().toISOString().slice(0, 10);
162
+ const sessionFile = path.join(projectDir, 'memory', 'session.md');
163
+ let content;
164
+ try {
165
+ content = await fs.readFile(sessionFile, 'utf-8');
166
+ }
167
+ catch {
168
+ return;
169
+ }
170
+ content = compactSessionContent(content);
171
+ content = content.replace(/^updated_at: .+$/m, `updated_at: ${date}`);
172
+ if (/^last_checkpoint:/m.test(content)) {
173
+ content = content.replace(/^last_checkpoint: .+$/m, `last_checkpoint: "${featureName}"`);
174
+ }
175
+ else {
176
+ content = content.replace(/^(updated_at: .+)$/m, `$1\nlast_checkpoint: "${featureName}"`);
177
+ }
178
+ content = content.replace(/\*(?:Created|Updated|Compacted) by .+ on .+\*/, `*Compacted on ${date} (checkpoint: ${checkpointRef})*`);
179
+ await fs.writeFile(sessionFile, content, 'utf-8');
180
+ }
181
+ function compactSessionContent(content) {
182
+ content = truncateSectionItems(content, 'Decisions', 5, 'bullet');
183
+ content = truncateSectionItems(content, 'Active Issues', 5, 'numbered');
184
+ if (Buffer.byteLength(content, 'utf-8') > SESSION_MAX_BYTES) {
185
+ content = truncateSectionItems(content, 'Engine Learnings', 3, 'bullet');
186
+ }
187
+ return content;
188
+ }
189
+ function truncateSectionItems(content, title, maxItems, style) {
190
+ const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
191
+ const re = new RegExp(`## ${escaped}\\n([\\s\\S]*?)(?=\\n---\\s*\\n|\\n## |$)`);
192
+ const match = re.exec(content);
193
+ if (!match)
194
+ return content;
195
+ const body = match[1] ?? '';
196
+ const pattern = style === 'bullet' ? /^-\s+.+$/gm : /^\d+\.\s+.+$/gm;
197
+ const items = body.match(pattern) ?? [];
198
+ if (items.length <= maxItems)
199
+ return content;
200
+ const kept = items.slice(-maxItems);
201
+ const newBody = style === 'numbered'
202
+ ? kept.map((line, i) => `${i + 1}. ${line.replace(/^\d+\.\s*/, '')}`).join('\n')
203
+ : kept.join('\n');
204
+ const sectionRe = new RegExp(`(## ${escaped}\\n)[\\s\\S]*?(?=\\n---\\s*\\n|\\n## |$)`);
205
+ return content.replace(sectionRe, `$1${newBody}\n`);
206
+ }
207
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/checkpoint/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import { SlashCommandRegistry } from '@backendkit-labs/agent-core';
2
+ /**
3
+ * Registers the framework's built-in slash commands into the given registry.
4
+ * Call this once when bootstrapping the app — before registering app-specific commands.
5
+ */
6
+ export declare function registerBuiltinCommands(registry: SlashCommandRegistry): void;
7
+ //# sourceMappingURL=builtin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/builtin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAmEnE;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAy4B5E"}