briefops 1.0.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 (255) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/CODE_OF_CONDUCT.md +13 -0
  3. package/CONTRIBUTING.md +53 -0
  4. package/LICENSE +21 -0
  5. package/README.md +801 -0
  6. package/SECURITY.md +59 -0
  7. package/dist/cli.d.ts +3 -0
  8. package/dist/cli.js +54 -0
  9. package/dist/cli.js.map +1 -0
  10. package/dist/commands/approve.d.ts +2 -0
  11. package/dist/commands/approve.js +38 -0
  12. package/dist/commands/approve.js.map +1 -0
  13. package/dist/commands/brief.d.ts +2 -0
  14. package/dist/commands/brief.js +81 -0
  15. package/dist/commands/brief.js.map +1 -0
  16. package/dist/commands/codex.d.ts +2 -0
  17. package/dist/commands/codex.js +163 -0
  18. package/dist/commands/codex.js.map +1 -0
  19. package/dist/commands/compare.d.ts +2 -0
  20. package/dist/commands/compare.js +48 -0
  21. package/dist/commands/compare.js.map +1 -0
  22. package/dist/commands/continue.d.ts +2 -0
  23. package/dist/commands/continue.js +66 -0
  24. package/dist/commands/continue.js.map +1 -0
  25. package/dist/commands/doctor.d.ts +2 -0
  26. package/dist/commands/doctor.js +90 -0
  27. package/dist/commands/doctor.js.map +1 -0
  28. package/dist/commands/eval.d.ts +2 -0
  29. package/dist/commands/eval.js +89 -0
  30. package/dist/commands/eval.js.map +1 -0
  31. package/dist/commands/export.d.ts +2 -0
  32. package/dist/commands/export.js +105 -0
  33. package/dist/commands/export.js.map +1 -0
  34. package/dist/commands/finish.d.ts +2 -0
  35. package/dist/commands/finish.js +71 -0
  36. package/dist/commands/finish.js.map +1 -0
  37. package/dist/commands/handoff.d.ts +2 -0
  38. package/dist/commands/handoff.js +77 -0
  39. package/dist/commands/handoff.js.map +1 -0
  40. package/dist/commands/inbox.d.ts +2 -0
  41. package/dist/commands/inbox.js +36 -0
  42. package/dist/commands/inbox.js.map +1 -0
  43. package/dist/commands/init.d.ts +2 -0
  44. package/dist/commands/init.js +13 -0
  45. package/dist/commands/init.js.map +1 -0
  46. package/dist/commands/inspect.d.ts +2 -0
  47. package/dist/commands/inspect.js +226 -0
  48. package/dist/commands/inspect.js.map +1 -0
  49. package/dist/commands/log.d.ts +2 -0
  50. package/dist/commands/log.js +96 -0
  51. package/dist/commands/log.js.map +1 -0
  52. package/dist/commands/memory.d.ts +2 -0
  53. package/dist/commands/memory.js +236 -0
  54. package/dist/commands/memory.js.map +1 -0
  55. package/dist/commands/pack.d.ts +2 -0
  56. package/dist/commands/pack.js +42 -0
  57. package/dist/commands/pack.js.map +1 -0
  58. package/dist/commands/prime.d.ts +4 -0
  59. package/dist/commands/prime.js +44 -0
  60. package/dist/commands/prime.js.map +1 -0
  61. package/dist/commands/project.d.ts +2 -0
  62. package/dist/commands/project.js +50 -0
  63. package/dist/commands/project.js.map +1 -0
  64. package/dist/commands/shared.d.ts +3 -0
  65. package/dist/commands/shared.js +24 -0
  66. package/dist/commands/shared.js.map +1 -0
  67. package/dist/commands/skill.d.ts +2 -0
  68. package/dist/commands/skill.js +146 -0
  69. package/dist/commands/skill.js.map +1 -0
  70. package/dist/commands/worker.d.ts +2 -0
  71. package/dist/commands/worker.js +128 -0
  72. package/dist/commands/worker.js.map +1 -0
  73. package/dist/core/adapter.d.ts +22 -0
  74. package/dist/core/adapter.js +167 -0
  75. package/dist/core/adapter.js.map +1 -0
  76. package/dist/core/approval.d.ts +26 -0
  77. package/dist/core/approval.js +86 -0
  78. package/dist/core/approval.js.map +1 -0
  79. package/dist/core/brief.d.ts +47 -0
  80. package/dist/core/brief.js +411 -0
  81. package/dist/core/brief.js.map +1 -0
  82. package/dist/core/codex.d.ts +53 -0
  83. package/dist/core/codex.js +286 -0
  84. package/dist/core/codex.js.map +1 -0
  85. package/dist/core/codexPlugin.d.ts +51 -0
  86. package/dist/core/codexPlugin.js +228 -0
  87. package/dist/core/codexPlugin.js.map +1 -0
  88. package/dist/core/compatibility.d.ts +2 -0
  89. package/dist/core/compatibility.js +16 -0
  90. package/dist/core/compatibility.js.map +1 -0
  91. package/dist/core/config.d.ts +19 -0
  92. package/dist/core/config.js +77 -0
  93. package/dist/core/config.js.map +1 -0
  94. package/dist/core/contextBudget.d.ts +12 -0
  95. package/dist/core/contextBudget.js +22 -0
  96. package/dist/core/contextBudget.js.map +1 -0
  97. package/dist/core/contextCompare.d.ts +27 -0
  98. package/dist/core/contextCompare.js +97 -0
  99. package/dist/core/contextCompare.js.map +1 -0
  100. package/dist/core/continuity.d.ts +25 -0
  101. package/dist/core/continuity.js +73 -0
  102. package/dist/core/continuity.js.map +1 -0
  103. package/dist/core/errors.d.ts +4 -0
  104. package/dist/core/errors.js +12 -0
  105. package/dist/core/errors.js.map +1 -0
  106. package/dist/core/eval.d.ts +38 -0
  107. package/dist/core/eval.js +180 -0
  108. package/dist/core/eval.js.map +1 -0
  109. package/dist/core/exportPolicy.d.ts +7 -0
  110. package/dist/core/exportPolicy.js +17 -0
  111. package/dist/core/exportPolicy.js.map +1 -0
  112. package/dist/core/exportTargets.d.ts +25 -0
  113. package/dist/core/exportTargets.js +292 -0
  114. package/dist/core/exportTargets.js.map +1 -0
  115. package/dist/core/handoff.d.ts +48 -0
  116. package/dist/core/handoff.js +611 -0
  117. package/dist/core/handoff.js.map +1 -0
  118. package/dist/core/inbox.d.ts +15 -0
  119. package/dist/core/inbox.js +56 -0
  120. package/dist/core/inbox.js.map +1 -0
  121. package/dist/core/lock.d.ts +11 -0
  122. package/dist/core/lock.js +99 -0
  123. package/dist/core/lock.js.map +1 -0
  124. package/dist/core/log.d.ts +38 -0
  125. package/dist/core/log.js +93 -0
  126. package/dist/core/log.js.map +1 -0
  127. package/dist/core/memory.d.ts +86 -0
  128. package/dist/core/memory.js +353 -0
  129. package/dist/core/memory.js.map +1 -0
  130. package/dist/core/memoryHygiene.d.ts +25 -0
  131. package/dist/core/memoryHygiene.js +95 -0
  132. package/dist/core/memoryHygiene.js.map +1 -0
  133. package/dist/core/memoryProposal.d.ts +40 -0
  134. package/dist/core/memoryProposal.js +279 -0
  135. package/dist/core/memoryProposal.js.map +1 -0
  136. package/dist/core/output.d.ts +7 -0
  137. package/dist/core/output.js +18 -0
  138. package/dist/core/output.js.map +1 -0
  139. package/dist/core/patch.d.ts +37 -0
  140. package/dist/core/patch.js +220 -0
  141. package/dist/core/patch.js.map +1 -0
  142. package/dist/core/paths.d.ts +33 -0
  143. package/dist/core/paths.js +84 -0
  144. package/dist/core/paths.js.map +1 -0
  145. package/dist/core/prime.d.ts +17 -0
  146. package/dist/core/prime.js +298 -0
  147. package/dist/core/prime.js.map +1 -0
  148. package/dist/core/privacyDoctor.d.ts +14 -0
  149. package/dist/core/privacyDoctor.js +59 -0
  150. package/dist/core/privacyDoctor.js.map +1 -0
  151. package/dist/core/project.d.ts +16 -0
  152. package/dist/core/project.js +73 -0
  153. package/dist/core/project.js.map +1 -0
  154. package/dist/core/securityDoctor.d.ts +14 -0
  155. package/dist/core/securityDoctor.js +96 -0
  156. package/dist/core/securityDoctor.js.map +1 -0
  157. package/dist/core/skill.d.ts +16 -0
  158. package/dist/core/skill.js +81 -0
  159. package/dist/core/skill.js.map +1 -0
  160. package/dist/core/storage.d.ts +20 -0
  161. package/dist/core/storage.js +112 -0
  162. package/dist/core/storage.js.map +1 -0
  163. package/dist/core/tokens.d.ts +5 -0
  164. package/dist/core/tokens.js +24 -0
  165. package/dist/core/tokens.js.map +1 -0
  166. package/dist/core/worker.d.ts +51 -0
  167. package/dist/core/worker.js +312 -0
  168. package/dist/core/worker.js.map +1 -0
  169. package/dist/core/workflow.d.ts +61 -0
  170. package/dist/core/workflow.js +308 -0
  171. package/dist/core/workflow.js.map +1 -0
  172. package/dist/core/workspace.d.ts +7 -0
  173. package/dist/core/workspace.js +214 -0
  174. package/dist/core/workspace.js.map +1 -0
  175. package/dist/index.d.ts +2 -0
  176. package/dist/index.js +16 -0
  177. package/dist/index.js.map +1 -0
  178. package/dist/schemas/brief.d.ts +12 -0
  179. package/dist/schemas/brief.js +2 -0
  180. package/dist/schemas/brief.js.map +1 -0
  181. package/dist/schemas/eval.d.ts +96 -0
  182. package/dist/schemas/eval.js +30 -0
  183. package/dist/schemas/eval.js.map +1 -0
  184. package/dist/schemas/handoff.d.ts +33 -0
  185. package/dist/schemas/handoff.js +13 -0
  186. package/dist/schemas/handoff.js.map +1 -0
  187. package/dist/schemas/log.d.ts +51 -0
  188. package/dist/schemas/log.js +19 -0
  189. package/dist/schemas/log.js.map +1 -0
  190. package/dist/schemas/memory.d.ts +112 -0
  191. package/dist/schemas/memory.js +21 -0
  192. package/dist/schemas/memory.js.map +1 -0
  193. package/dist/schemas/memoryProposal.d.ts +181 -0
  194. package/dist/schemas/memoryProposal.js +46 -0
  195. package/dist/schemas/memoryProposal.js.map +1 -0
  196. package/dist/schemas/patch.d.ts +38 -0
  197. package/dist/schemas/patch.js +15 -0
  198. package/dist/schemas/patch.js.map +1 -0
  199. package/dist/schemas/project.d.ts +23 -0
  200. package/dist/schemas/project.js +8 -0
  201. package/dist/schemas/project.js.map +1 -0
  202. package/dist/schemas/skill.d.ts +26 -0
  203. package/dist/schemas/skill.js +9 -0
  204. package/dist/schemas/skill.js.map +1 -0
  205. package/dist/schemas/worker.d.ts +29 -0
  206. package/dist/schemas/worker.js +12 -0
  207. package/dist/schemas/worker.js.map +1 -0
  208. package/dist/version.d.ts +1 -0
  209. package/dist/version.js +3 -0
  210. package/dist/version.js.map +1 -0
  211. package/docs/codex-resume.md +13 -0
  212. package/docs/compatibility.md +49 -0
  213. package/docs/concept.md +13 -0
  214. package/docs/evals.md +18 -0
  215. package/docs/file-format.md +67 -0
  216. package/docs/handoff-briefs.md +9 -0
  217. package/docs/integrations/harnesses.md +74 -0
  218. package/docs/memory-lifecycle.md +23 -0
  219. package/docs/persistent-worker.md +15 -0
  220. package/docs/privacy-model.md +40 -0
  221. package/docs/quickstart.md +74 -0
  222. package/docs/release-checklist.md +68 -0
  223. package/docs/roadmap.md +33 -0
  224. package/docs/superpowers/plans/2026-06-08-briefops-oss-readiness.md +1272 -0
  225. package/docs/superpowers/plans/2026-06-08-codex-first-context-optimization.md +1176 -0
  226. package/docs/token-budget.md +63 -0
  227. package/examples/atlas-q/README.md +15 -0
  228. package/examples/codex-first-context/README.md +48 -0
  229. package/examples/codex-first-context/after-briefops-prime.md +40 -0
  230. package/examples/codex-first-context/before-manual-history-dump.md +18 -0
  231. package/examples/persistent-worker-demo/README.md +15 -0
  232. package/examples/persistent-worker-demo/after-codex-resume.md +17 -0
  233. package/examples/persistent-worker-demo/before-context-dump.md +5 -0
  234. package/examples/persistent-worker-demo/briefops-workspace/codex/prompts/resume_demo.md +29 -0
  235. package/examples/persistent-worker-demo/briefops-workspace/handoffs/handoff_demo.md +50 -0
  236. package/examples/persistent-worker-demo/briefops-workspace/logs/log_20260604_001.yaml +14 -0
  237. package/examples/persistent-worker-demo/briefops-workspace/logs/log_20260604_002.yaml +12 -0
  238. package/examples/persistent-worker-demo/briefops-workspace/memory/decisions.yaml +12 -0
  239. package/examples/persistent-worker-demo/briefops-workspace/memory/deprecated.yaml +1 -0
  240. package/examples/persistent-worker-demo/briefops-workspace/memory/facts.yaml +12 -0
  241. package/examples/persistent-worker-demo/briefops-workspace/memory/incidents.yaml +12 -0
  242. package/examples/persistent-worker-demo/briefops-workspace/memory/lessons.yaml +12 -0
  243. package/examples/persistent-worker-demo/briefops-workspace/memory-proposals/memprop_demo_001.memory-proposal.yaml +23 -0
  244. package/examples/persistent-worker-demo/briefops-workspace/projects/atlas-q.project.md +18 -0
  245. package/examples/persistent-worker-demo/briefops-workspace/skills/backtest-validation.skill.md +13 -0
  246. package/examples/persistent-worker-demo/briefops-workspace/skills/risk-review.skill.md +15 -0
  247. package/examples/persistent-worker-demo/briefops-workspace/workers/quant-reviewer.worker.yaml +12 -0
  248. package/examples/persistent-worker-demo/briefops-workspace/workers/summaries/quant-reviewer.summary.md +44 -0
  249. package/package.json +59 -0
  250. package/plugins/briefops-codex/.codex-plugin/plugin.json +39 -0
  251. package/plugins/briefops-codex/README.md +44 -0
  252. package/plugins/briefops-codex/skills/briefops-continue-worker/SKILL.md +22 -0
  253. package/plugins/briefops-codex/skills/briefops-finish-task/SKILL.md +22 -0
  254. package/plugins/briefops-codex/skills/briefops-prime-context/SKILL.md +24 -0
  255. package/plugins/briefops-codex/skills/briefops-review-memory/SKILL.md +27 -0
@@ -0,0 +1,411 @@
1
+ import path from "node:path";
2
+ import { normalizeBriefAdapter, renderBriefWithAdapter } from "./adapter.js";
3
+ import { BriefOpsError } from "./errors.js";
4
+ import { formatMemoryItem, selectRelevantMemory } from "./memory.js";
5
+ import { writeGeneratedOutput } from "./output.js";
6
+ import { readProject } from "./project.js";
7
+ import { readSkill } from "./skill.js";
8
+ import { formatWorkerForBrief, readWorker } from "./worker.js";
9
+ import { formatDateStamp, normalizeName, slugForFilename, workspacePaths } from "./paths.js";
10
+ import { estimateTokens, truncateToTokenBudget } from "./tokens.js";
11
+ import { listFilesBySuffix, readTextFile } from "./storage.js";
12
+ import { requireWorkspace } from "./workspace.js";
13
+ const DEFAULT_MEMORY_BUDGET = 300;
14
+ const TASK_BUDGET_FLOOR = 100;
15
+ const OUTPUT_CONTRACT_BUDGET = 200;
16
+ const MIN_SKILL_BUDGET = 80;
17
+ const outputContract = [
18
+ "Return:",
19
+ "",
20
+ "1. Summary",
21
+ "2. Findings or implementation notes",
22
+ "3. Files changed",
23
+ "4. Verification performed",
24
+ "5. Remaining risks or follow-ups"
25
+ ].join("\n");
26
+ async function renderStableBrief(options) {
27
+ let warnings = [...options.parts.warnings];
28
+ let totalTokens = options.parts.totalTokens;
29
+ let content = "";
30
+ for (let pass = 0; pass < 8; pass += 1) {
31
+ content = await renderBriefWithAdapter({
32
+ cwd: options.cwd,
33
+ adapter: options.adapter,
34
+ parts: {
35
+ warnings,
36
+ workerText: options.parts.workerText,
37
+ skillText: options.parts.skillText,
38
+ projectText: options.parts.projectText,
39
+ memoryText: options.parts.memoryText,
40
+ taskText: options.parts.taskText,
41
+ outputContract,
42
+ readIfNeeded: options.parts.readIfNeeded,
43
+ report: options.parts.report,
44
+ totalTokens,
45
+ budget: options.budget
46
+ }
47
+ });
48
+ const renderedTokens = estimateTokens(content);
49
+ const needsBudgetWarning = renderedTokens > options.budget &&
50
+ !warnings.some((warning) => warning.startsWith("Rendered brief exceeds token budget"));
51
+ if (needsBudgetWarning) {
52
+ warnings = [
53
+ ...warnings,
54
+ `Rendered brief exceeds token budget by ${renderedTokens - options.budget} estimated tokens.`
55
+ ];
56
+ totalTokens = renderedTokens;
57
+ continue;
58
+ }
59
+ if (renderedTokens === totalTokens) {
60
+ return {
61
+ content,
62
+ warnings,
63
+ totalTokens: renderedTokens
64
+ };
65
+ }
66
+ totalTokens = renderedTokens;
67
+ }
68
+ content = await renderBriefWithAdapter({
69
+ cwd: options.cwd,
70
+ adapter: options.adapter,
71
+ parts: {
72
+ warnings,
73
+ workerText: options.parts.workerText,
74
+ skillText: options.parts.skillText,
75
+ projectText: options.parts.projectText,
76
+ memoryText: options.parts.memoryText,
77
+ taskText: options.parts.taskText,
78
+ outputContract,
79
+ readIfNeeded: options.parts.readIfNeeded,
80
+ report: options.parts.report,
81
+ totalTokens,
82
+ budget: options.budget
83
+ }
84
+ });
85
+ return {
86
+ content,
87
+ warnings,
88
+ totalTokens: estimateTokens(content)
89
+ };
90
+ }
91
+ function extractReadIfNeeded(projectBody) {
92
+ const lines = projectBody.split(/\r?\n/);
93
+ const start = lines.findIndex((line) => /^##\s+read if needed\s*$/i.test(line.trim()));
94
+ if (start === -1) {
95
+ return "";
96
+ }
97
+ const section = [];
98
+ for (const line of lines.slice(start + 1)) {
99
+ if (/^##\s+/.test(line.trim())) {
100
+ break;
101
+ }
102
+ section.push(line);
103
+ }
104
+ return section.join("\n").trim();
105
+ }
106
+ function stripReadIfNeeded(projectBody) {
107
+ const lines = projectBody.split(/\r?\n/);
108
+ const start = lines.findIndex((line) => /^##\s+read if needed\s*$/i.test(line.trim()));
109
+ if (start === -1) {
110
+ return projectBody;
111
+ }
112
+ const endOffset = lines
113
+ .slice(start + 1)
114
+ .findIndex((line) => /^##\s+/.test(line.trim()));
115
+ const end = endOffset === -1 ? lines.length : start + 1 + endOffset;
116
+ return [...lines.slice(0, start), ...lines.slice(end)].join("\n").trim();
117
+ }
118
+ async function resolveBriefOptions(input) {
119
+ const cwd = input.cwd ?? process.cwd();
120
+ await requireWorkspace(cwd);
121
+ const workerName = input.worker ? normalizeName(input.worker) : undefined;
122
+ const worker = workerName ? await readWorker(cwd, workerName) : undefined;
123
+ const project = input.project
124
+ ? normalizeName(input.project)
125
+ : worker?.project
126
+ ? normalizeName(worker.project)
127
+ : undefined;
128
+ const skills = input.skill
129
+ ? [normalizeName(input.skill)]
130
+ : worker?.default_skills.map(normalizeName) ?? [];
131
+ if (!project) {
132
+ throw new BriefOpsError("Brief generation requires --project or a worker with a default project.");
133
+ }
134
+ if (skills.length === 0) {
135
+ throw new BriefOpsError("Brief generation requires --skill or a worker with default skills.");
136
+ }
137
+ return {
138
+ cwd,
139
+ skills,
140
+ project,
141
+ worker: workerName,
142
+ task: input.task,
143
+ budget: input.budget ?? 2000,
144
+ adapter: normalizeBriefAdapter(input.adapter)
145
+ };
146
+ }
147
+ async function selectMemoryForSkills(options) {
148
+ const selections = await Promise.all(options.skills.map((skill) => selectRelevantMemory({
149
+ cwd: options.cwd,
150
+ project: options.project,
151
+ skill,
152
+ worker: options.worker,
153
+ task: options.task,
154
+ quotas: {
155
+ decisions: 2,
156
+ lessons: 3,
157
+ incidents: 1,
158
+ facts: 2,
159
+ deprecated: 0
160
+ },
161
+ maxTokens: options.maxTokens
162
+ })));
163
+ const seen = new Set();
164
+ const ordered = selections
165
+ .flatMap((selection) => selection.items)
166
+ .filter((item) => {
167
+ if (seen.has(item.id)) {
168
+ return false;
169
+ }
170
+ seen.add(item.id);
171
+ return true;
172
+ });
173
+ const selected = [];
174
+ let tokens = 0;
175
+ for (const item of ordered) {
176
+ const itemTokens = estimateTokens(formatMemoryItem(item));
177
+ if (tokens + itemTokens > options.maxTokens) {
178
+ continue;
179
+ }
180
+ selected.push(item);
181
+ tokens += itemTokens;
182
+ }
183
+ const originalOmitted = selections.reduce((sum, selection) => sum + selection.omitted, 0);
184
+ return {
185
+ items: selected,
186
+ text: selected.map(formatMemoryItem).join("\n"),
187
+ tokens,
188
+ omitted: originalOmitted + ordered.length - selected.length
189
+ };
190
+ }
191
+ async function buildSkillText(options, skillBudget) {
192
+ const skills = await Promise.all(options.skills.map((skill) => readSkill(options.cwd, skill)));
193
+ const perSkillBudget = Math.max(MIN_SKILL_BUDGET, Math.floor(skillBudget / skills.length));
194
+ const rendered = skills.map((skill) => {
195
+ const budget = Math.min(skill.data.max_tokens, perSkillBudget);
196
+ const result = truncateToTokenBudget(skill.body, budget);
197
+ const header = options.skills.length > 1 ? `### ${skill.data.name}\n\n` : "";
198
+ return {
199
+ text: `${header}${result.text || "Skill content unavailable after trimming."}`,
200
+ used: estimateTokens(result.text),
201
+ budget,
202
+ trimmed: result.trimmed
203
+ };
204
+ });
205
+ return {
206
+ text: rendered.map((item) => item.text).join("\n\n"),
207
+ used: rendered.reduce((sum, item) => sum + item.used, 0),
208
+ budget: rendered.reduce((sum, item) => sum + item.budget, 0),
209
+ trimmed: rendered.some((item) => item.trimmed)
210
+ };
211
+ }
212
+ async function buildParts(options, state) {
213
+ const project = await readProject(options.cwd, options.project);
214
+ const skillResult = await buildSkillText(options, state.skillBudget);
215
+ const projectResult = truncateToTokenBudget(stripReadIfNeeded(project.body), state.projectBudget);
216
+ const memory = await selectMemoryForSkills({
217
+ cwd: options.cwd,
218
+ project: options.project,
219
+ skills: options.skills,
220
+ worker: options.worker,
221
+ task: options.task,
222
+ maxTokens: state.memoryBudget
223
+ });
224
+ const workerResult = options.worker
225
+ ? truncateToTokenBudget(await formatWorkerForBrief(options.cwd, options.worker), state.workerBudget)
226
+ : { text: "", trimmed: false };
227
+ const taskText = options.task.trim();
228
+ const outputTokens = estimateTokens(outputContract);
229
+ const taskBudget = Math.max(TASK_BUDGET_FLOOR, estimateTokens(taskText));
230
+ const report = [
231
+ options.worker
232
+ ? {
233
+ label: "Worker",
234
+ used: estimateTokens(workerResult.text),
235
+ budget: state.workerBudget
236
+ }
237
+ : undefined,
238
+ {
239
+ label: options.skills.length > 1 ? "Skills" : "Skill",
240
+ used: skillResult.used,
241
+ budget: skillResult.budget
242
+ },
243
+ {
244
+ label: "Project Context",
245
+ used: estimateTokens(projectResult.text),
246
+ budget: state.projectBudget
247
+ },
248
+ {
249
+ label: "Memory",
250
+ used: memory.tokens,
251
+ budget: state.memoryBudget
252
+ },
253
+ {
254
+ label: "Task",
255
+ used: estimateTokens(taskText),
256
+ budget: taskBudget
257
+ },
258
+ {
259
+ label: "Output Contract",
260
+ used: outputTokens,
261
+ budget: OUTPUT_CONTRACT_BUDGET
262
+ }
263
+ ].filter((line) => Boolean(line));
264
+ const totalTokens = report.reduce((sum, line) => sum + line.used, 0);
265
+ const warnings = [
266
+ workerResult.trimmed ? "Worker profile was trimmed to fit its component budget." : undefined,
267
+ skillResult.trimmed ? "Skill content was trimmed to fit its component budget." : undefined,
268
+ projectResult.trimmed ? "Project context was trimmed to fit its component budget." : undefined,
269
+ memory.omitted > 0 ? `${memory.omitted} matching memory item(s) were omitted by token budget.` : undefined
270
+ ].filter((warning) => Boolean(warning));
271
+ return {
272
+ skillText: skillResult.text || "Skill content unavailable after trimming.",
273
+ projectText: projectResult.text || "Project context omitted to fit token budget.",
274
+ memoryText: memory.text || "No active matching memory items included.",
275
+ workerText: workerResult.text,
276
+ taskText,
277
+ readIfNeeded: extractReadIfNeeded(project.body) || "No project source references listed.",
278
+ report,
279
+ totalTokens,
280
+ warnings,
281
+ memoryOmitted: memory.omitted
282
+ };
283
+ }
284
+ export async function generateBrief(input) {
285
+ const options = await resolveBriefOptions(input);
286
+ const skills = await Promise.all(options.skills.map((skill) => readSkill(options.cwd, skill)));
287
+ const project = await readProject(options.cwd, options.project);
288
+ const worker = options.worker ? await readWorker(options.cwd, options.worker) : undefined;
289
+ const state = {
290
+ skillBudget: skills.reduce((sum, skill) => sum + skill.data.max_tokens, 0),
291
+ projectBudget: project.data.max_tokens,
292
+ memoryBudget: DEFAULT_MEMORY_BUDGET,
293
+ workerBudget: worker?.max_tokens ?? 0
294
+ };
295
+ let parts = await buildParts(options, state);
296
+ if (parts.totalTokens > options.budget) {
297
+ const overage = parts.totalTokens - options.budget;
298
+ state.memoryBudget = Math.max(0, state.memoryBudget - overage);
299
+ parts = await buildParts(options, state);
300
+ }
301
+ if (parts.totalTokens > options.budget && state.memoryBudget > 0) {
302
+ state.memoryBudget = 0;
303
+ parts = await buildParts(options, state);
304
+ }
305
+ if (parts.totalTokens > options.budget && state.workerBudget > 0) {
306
+ const overage = parts.totalTokens - options.budget;
307
+ state.workerBudget = Math.max(0, state.workerBudget - overage);
308
+ parts = await buildParts(options, state);
309
+ }
310
+ if (parts.totalTokens > options.budget) {
311
+ const overage = parts.totalTokens - options.budget;
312
+ state.projectBudget = Math.max(0, state.projectBudget - overage);
313
+ parts = await buildParts(options, state);
314
+ }
315
+ if (parts.totalTokens > options.budget) {
316
+ const overage = parts.totalTokens - options.budget;
317
+ const minimumSkillBudget = Math.min(MIN_SKILL_BUDGET, state.skillBudget);
318
+ state.skillBudget = Math.max(minimumSkillBudget, state.skillBudget - overage);
319
+ parts = await buildParts(options, state);
320
+ }
321
+ if (parts.totalTokens > options.budget) {
322
+ parts.warnings.push(`Brief exceeds token budget by ${parts.totalTokens - options.budget} estimated tokens.`);
323
+ }
324
+ const rendered = await renderStableBrief({
325
+ cwd: options.cwd,
326
+ adapter: options.adapter,
327
+ parts,
328
+ budget: options.budget
329
+ });
330
+ return {
331
+ content: rendered.content,
332
+ warnings: rendered.warnings,
333
+ report: parts.report,
334
+ totalTokens: rendered.totalTokens,
335
+ budget: options.budget
336
+ };
337
+ }
338
+ export async function saveGeneratedBrief(options) {
339
+ return writeGeneratedOutput({
340
+ defaultPath: path.join(workspacePaths(options.cwd).briefs, `${formatDateStamp()}-${slugForFilename(options.project ?? "global")}-${slugForFilename(options.worker ?? options.skill ?? "brief")}.md`),
341
+ outputPath: options.outputPath,
342
+ content: options.generated.content,
343
+ force: options.force
344
+ });
345
+ }
346
+ export async function inspectBriefTokens(input) {
347
+ const options = await resolveBriefOptions(input);
348
+ const generated = await generateBrief(input);
349
+ const reportValue = (labels) => generated.report.find((line) => labels.includes(line.label))?.used ?? 0;
350
+ return {
351
+ skillName: options.skills.join(","),
352
+ skillTokens: reportValue(["Skill", "Skills"]),
353
+ projectName: options.project,
354
+ projectTokens: reportValue(["Project Context"]),
355
+ workerName: options.worker,
356
+ workerTokens: reportValue(["Worker"]),
357
+ memoryTokens: reportValue(["Memory"]),
358
+ taskTokens: reportValue(["Task"]),
359
+ totalTokens: generated.totalTokens,
360
+ renderedTokens: generated.totalTokens,
361
+ budget: options.budget,
362
+ warnings: generated.warnings,
363
+ report: generated.report
364
+ };
365
+ }
366
+ function briefIdFromPath(filePath) {
367
+ return path.basename(filePath, ".md");
368
+ }
369
+ async function resolveSavedBriefPath(cwd, idOrLatest) {
370
+ await requireWorkspace(cwd);
371
+ const files = await listFilesBySuffix(workspacePaths(cwd).briefs, ".md");
372
+ if (files.length === 0) {
373
+ throw new BriefOpsError("No saved briefs found.");
374
+ }
375
+ if (idOrLatest.trim().toLowerCase() === "latest") {
376
+ return [...files].sort().at(-1);
377
+ }
378
+ const id = path.basename(idOrLatest, ".md");
379
+ const match = files.find((filePath) => briefIdFromPath(filePath) === id);
380
+ if (!match) {
381
+ throw new BriefOpsError(`Saved brief not found: ${idOrLatest}`);
382
+ }
383
+ return match;
384
+ }
385
+ export async function listSavedBriefs(cwd = process.cwd()) {
386
+ await requireWorkspace(cwd);
387
+ const files = await listFilesBySuffix(workspacePaths(cwd).briefs, ".md");
388
+ const briefs = await Promise.all(files.map(async (filePath) => {
389
+ const content = await readTextFile(filePath);
390
+ return {
391
+ id: briefIdFromPath(filePath),
392
+ path: filePath,
393
+ tokens: estimateTokens(content)
394
+ };
395
+ }));
396
+ return briefs.sort((a, b) => b.id.localeCompare(a.id));
397
+ }
398
+ export async function showSavedBrief(cwd, idOrLatest) {
399
+ return readTextFile(await resolveSavedBriefPath(cwd, idOrLatest));
400
+ }
401
+ export async function inspectSavedBrief(cwd, idOrLatest) {
402
+ const filePath = await resolveSavedBriefPath(cwd, idOrLatest);
403
+ const content = await readTextFile(filePath);
404
+ return {
405
+ id: briefIdFromPath(filePath),
406
+ path: filePath,
407
+ tokens: estimateTokens(content),
408
+ characters: content.length
409
+ };
410
+ }
411
+ //# sourceMappingURL=brief.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/core/brief.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import type { ExportPolicy } from "./exportPolicy.js";
2
+ export type CodexInstallOptions = {
3
+ cwd?: string;
4
+ force?: boolean;
5
+ };
6
+ export type CodexMissionOptions = {
7
+ cwd?: string;
8
+ skill?: string;
9
+ project?: string;
10
+ worker?: string;
11
+ task: string;
12
+ budget?: number;
13
+ completionPromise?: string;
14
+ mode?: string;
15
+ save?: boolean;
16
+ outputPath?: string;
17
+ force?: boolean;
18
+ };
19
+ export type CodexPlanOptions = {
20
+ cwd?: string;
21
+ project?: string;
22
+ worker?: string;
23
+ idea: string;
24
+ save?: boolean;
25
+ outputPath?: string;
26
+ force?: boolean;
27
+ };
28
+ export type CodexResumeOptions = {
29
+ cwd?: string;
30
+ worker?: string;
31
+ project?: string;
32
+ task: string;
33
+ fromHandoff?: string;
34
+ budget?: number;
35
+ mode?: string;
36
+ completionPromise?: string;
37
+ exportPolicy?: ExportPolicy;
38
+ save?: boolean;
39
+ outputPath?: string;
40
+ force?: boolean;
41
+ };
42
+ export type CodexPromptResult = {
43
+ content: string;
44
+ tokens: number;
45
+ savedPath?: string;
46
+ };
47
+ export declare function installCodexPack(options?: CodexInstallOptions): Promise<{
48
+ agentsPath: string;
49
+ promptDir: string;
50
+ }>;
51
+ export declare function generateCodexMission(options: CodexMissionOptions): Promise<CodexPromptResult>;
52
+ export declare function generateCodexPlan(options: CodexPlanOptions): Promise<CodexPromptResult>;
53
+ export declare function generateCodexResume(options: CodexResumeOptions): Promise<CodexPromptResult>;