@microi.net/cli 5.9.2 → 5.9.3

package/skills/report-engine/SKILL.md

@@ -1,71 +1,71 @@
----
-name: report-engine
-description: Microi 报表引擎设计与验收规范。用于 Rpt_Report 虚拟表格、数据源、报表字段、查询/增删改接口替换、统计聚合、导出、行级权限和界面引擎图表。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi 报表引擎
-
-## 定位
-
-报表引擎以 `Rpt_Report`、报表字段配置和数据源引擎组成虚拟表格。表格展示使用报表引擎；ECharts 图表和仪表盘使用界面引擎。报表字段是虚拟字段，不能假设存在同名物理表列。
-
-## 建模顺序
-
-1. 明确指标口径、时间粒度、维度、权限和导出上限。
-2. 创建只读数据源（SQL/V8/JSON），使用稳定 `DataSourceKey`。
-3. 创建报表并绑定数据源。
-4. 配置字段 `Name/Label/Component`、查询列、排序、格式和表内编辑。
-5. 如需写操作，为查询/新增/修改/删除分别绑定专用接口引擎。
-6. 菜单只暴露用户需要的报表入口，配置数据范围。
-
-## 权限与 SQL
-
-- 报表数据源必须应用当前租户和服务端用户数据范围。菜单权限不会自动保护任意聚合 SQL。
-- 聚合结果也可能泄露敏感信息；小样本、人员薪资、客户金额等需最小分组阈值或字段脱敏。
-- SQL 动态值参数化，维度/排序/指标使用白名单映射，不接收原始 SQL、列名或 `GROUP BY`。
-- 管理员专用平台表不能作为普通用户报表数据源；只读委托表只有获得真实 `Read` 授权后才能查询，`mic_page/mic_print` 继续按角色权限处理。
-
-## 写入型报表
-
-统计报表通常来自多表。新增、修改、删除必须调用接口引擎，在一个事务中完成校验与写入：
-
-```js
-var result = await V8.ApiEngine.Run('report_adjust_inventory', {
-  RowId: V8.Form.Id,
-  ExpectedVersion: V8.Form.Version,
-  Quantity: Number(V8.Form.Quantity || 0)
-});
-```
-
-接口引擎重新校验角色、记录范围、当前版本和业务状态。前端隐藏按钮、只读字段或报表行数据不能作为授权。
-
-## 性能
-
-- 默认分页，限制最大页数/每页行数/导出行数。
-- 大聚合在数据库建立合适索引或使用预聚合表；不要每次全表扫描。
-- 缓存 Key 包含 `OsClient + ReportId + 权限主体/授权版本 + 查询参数哈希`。
-- 导出走后台任务；生成文件放私有桶并绑定菜单、记录和字段访问上下文。
-
-## MCP 工作流
-
-1. `microi_get_db_schema` 读取 `Rpt_Report`、数据源、字段、菜单和业务表。
-2. `microi_save_data_source` 保存数据源并回读。
-3. 创建/更新报表及字段；复杂写操作先创建接口引擎。
-4. 设置菜单与角色权限。
-5. 用真实普通角色验收列表、筛选、汇总、详情、编辑与导出。
-
-## 图表
-
-界面引擎图表应调用返回稳定 `{Code, Data}` 的统计接口引擎，不在前端下载明细再聚合。统计接口设置时间范围、维度和最大点数，返回空数据时保持稳定结构。
-
-## 验收清单
-
-- [ ] 指标口径、时区和小数精度明确
-- [ ] 当前租户与行级范围在数据库查询中生效
-- [ ] 虚拟字段与物理字段没有混用
-- [ ] 写操作走事务接口引擎并校验并发版本
-- [ ] 分页、聚合、导出均有资源上限
-- [ ] 缓存按租户和权限隔离
-- [ ] 普通角色、无权限角色、跨租户负向测试通过
+---
+name: report-engine
+description: Microi 报表引擎设计与验收规范。用于 Rpt_Report 虚拟表格、数据源、报表字段、查询/增删改接口替换、统计聚合、导出、行级权限和界面引擎图表。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi 报表引擎
+
+## 定位
+
+报表引擎以 `Rpt_Report`、报表字段配置和数据源引擎组成虚拟表格。表格展示使用报表引擎；ECharts 图表和仪表盘使用界面引擎。报表字段是虚拟字段，不能假设存在同名物理表列。
+
+## 建模顺序
+
+1. 明确指标口径、时间粒度、维度、权限和导出上限。
+2. 创建只读数据源（SQL/V8/JSON），使用稳定 `DataSourceKey`。
+3. 创建报表并绑定数据源。
+4. 配置字段 `Name/Label/Component`、查询列、排序、格式和表内编辑。
+5. 如需写操作，为查询/新增/修改/删除分别绑定专用接口引擎。
+6. 菜单只暴露用户需要的报表入口，配置数据范围。
+
+## 权限与 SQL
+
+- 报表数据源必须应用当前租户和服务端用户数据范围。菜单权限不会自动保护任意聚合 SQL。
+- 聚合结果也可能泄露敏感信息；小样本、人员薪资、客户金额等需最小分组阈值或字段脱敏。
+- SQL 动态值参数化，维度/排序/指标使用白名单映射，不接收原始 SQL、列名或 `GROUP BY`。
+- 管理员专用平台表不能作为普通用户报表数据源；只读委托表只有获得真实 `Read` 授权后才能查询，`mic_page/mic_print` 继续按角色权限处理。
+
+## 写入型报表
+
+统计报表通常来自多表。新增、修改、删除必须调用接口引擎，在一个事务中完成校验与写入：
+
+```js
+var result = await V8.ApiEngine.Run('report_adjust_inventory', {
+  RowId: V8.Form.Id,
+  ExpectedVersion: V8.Form.Version,
+  Quantity: Number(V8.Form.Quantity || 0)
+});
+```
+
+接口引擎重新校验角色、记录范围、当前版本和业务状态。前端隐藏按钮、只读字段或报表行数据不能作为授权。
+
+## 性能
+
+- 默认分页，限制最大页数/每页行数/导出行数。
+- 大聚合在数据库建立合适索引或使用预聚合表；不要每次全表扫描。
+- 缓存 Key 包含 `OsClient + ReportId + 权限主体/授权版本 + 查询参数哈希`。
+- 导出走后台任务；生成文件放私有桶并绑定菜单、记录和字段访问上下文。
+
+## MCP 工作流
+
+1. `microi_get_db_schema` 读取 `Rpt_Report`、数据源、字段、菜单和业务表。
+2. `microi_save_data_source` 保存数据源并回读。
+3. 创建/更新报表及字段；复杂写操作先创建接口引擎。
+4. 设置菜单与角色权限。
+5. 用真实普通角色验收列表、筛选、汇总、详情、编辑与导出。
+
+## 图表
+
+界面引擎图表应调用返回稳定 `{Code, Data}` 的统计接口引擎，不在前端下载明细再聚合。统计接口设置时间范围、维度和最大点数，返回空数据时保持稳定结构。
+
+## 验收清单
+
+- [ ] 指标口径、时区和小数精度明确
+- [ ] 当前租户与行级范围在数据库查询中生效
+- [ ] 虚拟字段与物理字段没有混用
+- [ ] 写操作走事务接口引擎并校验并发版本
+- [ ] 分页、聚合、导出均有资源上限
+- [ ] 缓存按租户和权限隔离
+- [ ] 普通角色、无权限角色、跨租户负向测试通过

package/skills/report-engine/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "报表引擎"
-  short_description: "设计遵守菜单与行级权限的报表、聚合接口、写操作与导出验收"
-  default_prompt: "使用 $report-engine 设计并验收当前 Microi 报表。"
+interface:
+  display_name: "报表引擎"
+  short_description: "设计遵守菜单与行级权限的报表、聚合接口、写操作与导出验收"
+  default_prompt: "使用 $report-engine 设计并验收当前 Microi 报表。"

package/skills/scripts/optimize-progressive-disclosure.mjs

@@ -1,204 +1,204 @@
-import crypto from 'node:crypto'
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-const manifestPath = path.join(skillsRoot, '.progressive-disclosure-manifest.json')
-const maxEntryLines = 285
-const keepBudgetLines = 170
-const referenceBudgetLines = 245
-
-const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
-const lineCount = (value) => value.length === 0 ? 0 : value.split(/\r?\n/).length
-const slug = (value) => value
-  .replace(/^#+\s*/, '')
-  .replace(/[`*_]/g, '')
-  .trim()
-  .toLowerCase()
-  .replace(/[^\p{L}\p{N}]+/gu, '-')
-  .replace(/^-|-$/g, '')
-  .slice(0, 48) || 'reference'
-
-const splitAtHeading = (value, headingPattern) => {
-  const matches = [...value.matchAll(headingPattern)]
-  if (matches.length <= 1) return [value]
-  const parts = []
-  if (matches[0].index > 0) parts.push(value.slice(0, matches[0].index))
-  for (let index = 0; index < matches.length; index += 1) {
-    parts.push(value.slice(matches[index].index, matches[index + 1]?.index ?? value.length))
-  }
-  return parts.filter(Boolean)
-}
-
-const splitOversized = (value, eol) => {
-  if (lineCount(value) <= referenceBudgetLines) return [value]
-  let parts = splitAtHeading(value, /^###\s+.+$/gm)
-  if (parts.length === 1) parts = splitAtHeading(value, /^####\s+.+$/gm)
-  const output = []
-  for (const part of parts) {
-    if (lineCount(part) <= referenceBudgetLines) {
-      output.push(part)
-      continue
-    }
-    const lines = part.split(/\r?\n/)
-    let start = 0
-    while (start < lines.length) {
-      let end = Math.min(start + referenceBudgetLines - 8, lines.length)
-      if (end < lines.length) {
-        for (let cursor = end; cursor > start + 40; cursor -= 1) {
-          if (lines[cursor - 1].trim() === '') {
-            end = cursor
-            break
-          }
-        }
-      }
-      const hasTrailingBreak = end < lines.length || part.endsWith(eol)
-      output.push(lines.slice(start, end).join(eol) + (hasTrailingBreak ? eol : ''))
-      start = end
-    }
-  }
-  return output
-}
-
-const headingOf = (value, fallback) => value.match(/^#{2,4}\s+(.+)$/m)?.[1]?.trim() || fallback
-
-const skillDirectories = fs.readdirSync(skillsRoot, { withFileTypes: true })
-  .filter((entry) => entry.isDirectory() && fs.existsSync(path.join(skillsRoot, entry.name, 'SKILL.md')))
-  .map((entry) => entry.name)
-  .sort()
-
-const manifest = {
-  version: 1,
-  generatedAt: new Date().toISOString(),
-  policy: {
-    maxEntryLines,
-    referenceBudgetLines,
-    note: 'Original prefix and ordered chunks reconstruct the exact pre-split SKILL.md bytes.'
-  },
-  skills: {}
-}
-
-for (const skillName of skillDirectories) {
-  const skillPath = path.join(skillsRoot, skillName, 'SKILL.md')
-  const original = fs.readFileSync(skillPath, 'utf8')
-  if (lineCount(original) <= 300) continue
-  if (original.includes('<!-- microi-progressive:begin -->')) {
-    throw new Error(`${skillName} is already optimized; validate instead of running twice`)
-  }
-
-  const eol = original.includes('\r\n') ? '\r\n' : '\n'
-  const sectionMatches = [...original.matchAll(/^##\s+.+$/gm)]
-  if (sectionMatches.length < 2) {
-    throw new Error(`${skillName} needs at least two level-2 sections for safe semantic splitting`)
-  }
-  const prefix = original.slice(0, sectionMatches[0].index)
-  const sections = sectionMatches.map((match, index) => ({
-    heading: match[0].replace(/^##\s+/, '').trim(),
-    raw: original.slice(match.index, sectionMatches[index + 1]?.index ?? original.length),
-  }))
-
-  const kept = []
-  const moved = []
-  let keptLines = lineCount(prefix)
-  for (const section of sections) {
-    // Keep one contiguous prefix only. Picking a later short section after an
-    // earlier section was moved would reorder the original knowledge stream.
-    if (moved.length === 0 && (kept.length === 0 || keptLines + lineCount(section.raw) <= keepBudgetLines)) {
-      kept.push(section)
-      keptLines += lineCount(section.raw)
-    } else {
-      moved.push(section)
-    }
-  }
-  if (moved.length === 0) {
-    moved.push(kept.pop())
-  }
-
-  const fragments = moved.flatMap((section) => splitOversized(section.raw, eol).map((raw, index) => ({
-    raw,
-    heading: headingOf(raw, `${section.heading} (${index + 1})`),
-  })))
-
-  const referenceGroups = []
-  let current = []
-  let currentLines = 5
-  for (const fragment of fragments) {
-    const cost = lineCount(fragment.raw) + 3
-    if (current.length && currentLines + cost > referenceBudgetLines) {
-      referenceGroups.push(current)
-      current = []
-      currentLines = 5
-    }
-    current.push(fragment)
-    currentLines += cost
-  }
-  if (current.length) referenceGroups.push(current)
-
-  const referencesDirectory = path.join(skillsRoot, skillName, 'references')
-  fs.mkdirSync(referencesDirectory, { recursive: true })
-  const chunkRecords = []
-  let ordinal = 0
-  const wrapChunk = (raw, destination) => {
-    const id = `${skillName}-${String(ordinal).padStart(3, '0')}`
-    const record = {
-      id,
-      ordinal,
-      destination: destination.replaceAll('\\', '/'),
-      sha256: hash(raw),
-      lines: lineCount(raw),
-      heading: headingOf(raw, skillName),
-    }
-    chunkRecords.push(record)
-    ordinal += 1
-    return `<!-- microi-progressive:chunk id=${id} sha256=${record.sha256} -->${eol}${raw}<!-- /microi-progressive:chunk -->${eol}`
-  }
-
-  const entryChunks = kept.map((section) => wrapChunk(section.raw, `${skillName}/SKILL.md`)).join('')
-  const referenceRecords = []
-  referenceGroups.forEach((group, index) => {
-    const fileName = `progressive-${String(index + 1).padStart(2, '0')}-${slug(group[0].heading)}.md`
-    const relative = `references/${fileName}`
-    const destination = `${skillName}/${relative}`
-    const body = group.map((fragment) => wrapChunk(fragment.raw, destination)).join('')
-    const title = `# ${skillName} 详细参考 ${index + 1}${eol}${eol}`
-    const note = `> 按需读取；本文件由 SKILL.md 的原章节无损拆分。${eol}${eol}`
-    fs.writeFileSync(path.join(referencesDirectory, fileName), title + note + body, 'utf8')
-    referenceRecords.push({
-      path: relative,
-      headings: group.map((fragment) => fragment.heading),
-    })
-  })
-
-  const routerLines = [
-    '## 详细参考路由（渐进披露）',
-    '',
-    '仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。',
-    '',
-    ...referenceRecords.map((reference) =>
-      `- [${reference.path}](${reference.path})：${reference.headings.join('；')}`),
-    '',
-  ].join(eol)
-  const rewritten = prefix
-    + `<!-- microi-progressive:begin -->${eol}`
-    + entryChunks
-    + routerLines
-    + `<!-- microi-progressive:end -->${eol}`
-  if (lineCount(rewritten) > maxEntryLines) {
-    throw new Error(`${skillName} entry remains ${lineCount(rewritten)} lines; lower keepBudgetLines`)
-  }
-  fs.writeFileSync(skillPath, rewritten, 'utf8')
-
-  manifest.skills[skillName] = {
-    originalSha256: hash(original),
-    originalLines: lineCount(original),
-    prefixSha256: hash(prefix),
-    prefixBytes: Buffer.byteLength(prefix),
-    entryLines: lineCount(rewritten),
-    chunks: chunkRecords,
-    references: referenceRecords,
-  }
-}
-
-fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
-console.log(`Optimized ${Object.keys(manifest.skills).length} skills; manifest: ${manifestPath}`)
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const manifestPath = path.join(skillsRoot, '.progressive-disclosure-manifest.json')
+const maxEntryLines = 285
+const keepBudgetLines = 170
+const referenceBudgetLines = 245
+
+const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
+const lineCount = (value) => value.length === 0 ? 0 : value.split(/\r?\n/).length
+const slug = (value) => value
+  .replace(/^#+\s*/, '')
+  .replace(/[`*_]/g, '')
+  .trim()
+  .toLowerCase()
+  .replace(/[^\p{L}\p{N}]+/gu, '-')
+  .replace(/^-|-$/g, '')
+  .slice(0, 48) || 'reference'
+
+const splitAtHeading = (value, headingPattern) => {
+  const matches = [...value.matchAll(headingPattern)]
+  if (matches.length <= 1) return [value]
+  const parts = []
+  if (matches[0].index > 0) parts.push(value.slice(0, matches[0].index))
+  for (let index = 0; index < matches.length; index += 1) {
+    parts.push(value.slice(matches[index].index, matches[index + 1]?.index ?? value.length))
+  }
+  return parts.filter(Boolean)
+}
+
+const splitOversized = (value, eol) => {
+  if (lineCount(value) <= referenceBudgetLines) return [value]
+  let parts = splitAtHeading(value, /^###\s+.+$/gm)
+  if (parts.length === 1) parts = splitAtHeading(value, /^####\s+.+$/gm)
+  const output = []
+  for (const part of parts) {
+    if (lineCount(part) <= referenceBudgetLines) {
+      output.push(part)
+      continue
+    }
+    const lines = part.split(/\r?\n/)
+    let start = 0
+    while (start < lines.length) {
+      let end = Math.min(start + referenceBudgetLines - 8, lines.length)
+      if (end < lines.length) {
+        for (let cursor = end; cursor > start + 40; cursor -= 1) {
+          if (lines[cursor - 1].trim() === '') {
+            end = cursor
+            break
+          }
+        }
+      }
+      const hasTrailingBreak = end < lines.length || part.endsWith(eol)
+      output.push(lines.slice(start, end).join(eol) + (hasTrailingBreak ? eol : ''))
+      start = end
+    }
+  }
+  return output
+}
+
+const headingOf = (value, fallback) => value.match(/^#{2,4}\s+(.+)$/m)?.[1]?.trim() || fallback
+
+const skillDirectories = fs.readdirSync(skillsRoot, { withFileTypes: true })
+  .filter((entry) => entry.isDirectory() && fs.existsSync(path.join(skillsRoot, entry.name, 'SKILL.md')))
+  .map((entry) => entry.name)
+  .sort()
+
+const manifest = {
+  version: 1,
+  generatedAt: new Date().toISOString(),
+  policy: {
+    maxEntryLines,
+    referenceBudgetLines,
+    note: 'Original prefix and ordered chunks reconstruct the exact pre-split SKILL.md bytes.'
+  },
+  skills: {}
+}
+
+for (const skillName of skillDirectories) {
+  const skillPath = path.join(skillsRoot, skillName, 'SKILL.md')
+  const original = fs.readFileSync(skillPath, 'utf8')
+  if (lineCount(original) <= 300) continue
+  if (original.includes('<!-- microi-progressive:begin -->')) {
+    throw new Error(`${skillName} is already optimized; validate instead of running twice`)
+  }
+
+  const eol = original.includes('\r\n') ? '\r\n' : '\n'
+  const sectionMatches = [...original.matchAll(/^##\s+.+$/gm)]
+  if (sectionMatches.length < 2) {
+    throw new Error(`${skillName} needs at least two level-2 sections for safe semantic splitting`)
+  }
+  const prefix = original.slice(0, sectionMatches[0].index)
+  const sections = sectionMatches.map((match, index) => ({
+    heading: match[0].replace(/^##\s+/, '').trim(),
+    raw: original.slice(match.index, sectionMatches[index + 1]?.index ?? original.length),
+  }))
+
+  const kept = []
+  const moved = []
+  let keptLines = lineCount(prefix)
+  for (const section of sections) {
+    // Keep one contiguous prefix only. Picking a later short section after an
+    // earlier section was moved would reorder the original knowledge stream.
+    if (moved.length === 0 && (kept.length === 0 || keptLines + lineCount(section.raw) <= keepBudgetLines)) {
+      kept.push(section)
+      keptLines += lineCount(section.raw)
+    } else {
+      moved.push(section)
+    }
+  }
+  if (moved.length === 0) {
+    moved.push(kept.pop())
+  }
+
+  const fragments = moved.flatMap((section) => splitOversized(section.raw, eol).map((raw, index) => ({
+    raw,
+    heading: headingOf(raw, `${section.heading} (${index + 1})`),
+  })))
+
+  const referenceGroups = []
+  let current = []
+  let currentLines = 5
+  for (const fragment of fragments) {
+    const cost = lineCount(fragment.raw) + 3
+    if (current.length && currentLines + cost > referenceBudgetLines) {
+      referenceGroups.push(current)
+      current = []
+      currentLines = 5
+    }
+    current.push(fragment)
+    currentLines += cost
+  }
+  if (current.length) referenceGroups.push(current)
+
+  const referencesDirectory = path.join(skillsRoot, skillName, 'references')
+  fs.mkdirSync(referencesDirectory, { recursive: true })
+  const chunkRecords = []
+  let ordinal = 0
+  const wrapChunk = (raw, destination) => {
+    const id = `${skillName}-${String(ordinal).padStart(3, '0')}`
+    const record = {
+      id,
+      ordinal,
+      destination: destination.replaceAll('\\', '/'),
+      sha256: hash(raw),
+      lines: lineCount(raw),
+      heading: headingOf(raw, skillName),
+    }
+    chunkRecords.push(record)
+    ordinal += 1
+    return `<!-- microi-progressive:chunk id=${id} sha256=${record.sha256} -->${eol}${raw}<!-- /microi-progressive:chunk -->${eol}`
+  }
+
+  const entryChunks = kept.map((section) => wrapChunk(section.raw, `${skillName}/SKILL.md`)).join('')
+  const referenceRecords = []
+  referenceGroups.forEach((group, index) => {
+    const fileName = `progressive-${String(index + 1).padStart(2, '0')}-${slug(group[0].heading)}.md`
+    const relative = `references/${fileName}`
+    const destination = `${skillName}/${relative}`
+    const body = group.map((fragment) => wrapChunk(fragment.raw, destination)).join('')
+    const title = `# ${skillName} 详细参考 ${index + 1}${eol}${eol}`
+    const note = `> 按需读取；本文件由 SKILL.md 的原章节无损拆分。${eol}${eol}`
+    fs.writeFileSync(path.join(referencesDirectory, fileName), title + note + body, 'utf8')
+    referenceRecords.push({
+      path: relative,
+      headings: group.map((fragment) => fragment.heading),
+    })
+  })
+
+  const routerLines = [
+    '## 详细参考路由（渐进披露）',
+    '',
+    '仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。',
+    '',
+    ...referenceRecords.map((reference) =>
+      `- [${reference.path}](${reference.path})：${reference.headings.join('；')}`),
+    '',
+  ].join(eol)
+  const rewritten = prefix
+    + `<!-- microi-progressive:begin -->${eol}`
+    + entryChunks
+    + routerLines
+    + `<!-- microi-progressive:end -->${eol}`
+  if (lineCount(rewritten) > maxEntryLines) {
+    throw new Error(`${skillName} entry remains ${lineCount(rewritten)} lines; lower keepBudgetLines`)
+  }
+  fs.writeFileSync(skillPath, rewritten, 'utf8')
+
+  manifest.skills[skillName] = {
+    originalSha256: hash(original),
+    originalLines: lineCount(original),
+    prefixSha256: hash(prefix),
+    prefixBytes: Buffer.byteLength(prefix),
+    entryLines: lineCount(rewritten),
+    chunks: chunkRecords,
+    references: referenceRecords,
+  }
+}
+
+fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
+console.log(`Optimized ${Object.keys(manifest.skills).length} skills; manifest: ${manifestPath}`)