@givolt/i3-composer-agent 3.1.0 → 4.0.0

package/skills/i3-ui-prototype/references/project-layout.md

@@ -1,92 +0,0 @@
-# 项目共享目录、宿主缓存与模块关联
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-## 目录归属
-
-新项目的原型业务资料统一在 `prototypes/`：索引为 `prototypes/index.json`，准备资料为 `prototypes/.preparation/<id>/`，实例为 `prototypes/<id>/`。仅安装 Skill 不生成这些业务目录。业务修改落在实例 app，需求与模板快照在 inputs，正式设计、QA、交接和基线随项目保留。
-
-Skill、命令和辅助工具沿用安装器所选宿主基址；工具仍在 `tools/i3-prototype/`。本地测试安装器的离线 npm 缓存在该基址 `cache/i3-prototype/install/`，预检使用系统临时目录并清理。浏览器工具只有实际执行时才创建自己的缓存，不在业务根默认创建 `.playwright-cli`。
-
-| 范围 | 浏览器缓存 |
-| --- | --- |
-| 项目安装 | `<host-base>/cache/i3-prototype/playwright/<run-id>/` |
-| 全局安装 | `<global-host-base>/cache/i3-prototype/<project-key>/playwright/<run-id>/` |
-
-project-key 由规范化项目路径生成，包含摘要，同名项目不会共用一个缓存。CodeBuddy 项目／全局基址通常是项目 `.codebuddy`／`~/.codebuddy`；本包 Codex 适配使用项目 `.agents`／`~/.agents`。其他宿主、环境变量覆盖与共享物理目标按现有安装器目标表解析，不改变上游规则。
-
-同一项目换宿主时共用 prototypes；默认只发现当前宿主项目和全局工具。缓存不是需求或交接的唯一保存位置，正式证据归档到实例 QA。共享目录可读不等于某个 AD 流程已经自动接通索引或执行验收。
-
-## 先读取实际路径
-
-```sh
-# 只读，不创建目录；host 与安装范围必须按实际填写。
-node <skill-root>/scripts/native-pilot.cjs paths --project <project-root> --id assets --host codebuddy --scope project
-# 全局 Skill 仍指定业务项目；返回该项目共享路径与全局宿主缓存。
-node <skill-root>/scripts/native-pilot.cjs paths --project <project-root> --id assets --host codebuddy --scope global
-```
-
-paths 返回的 scope 是安装范围，scopeFile 是准备区 scope.json 的完整路径。新 scope 按 scopeFile 保存；不要提前创建实例目录。初始化成功后已将需求固定到 `inputs/scope.json`，生成前的有效查询应归入本实例 QA。确认没有未归档资料后才清理本次工作副本；失败保留恢复所需资料，不删除用户原始需求。
-
-## scope.moduleIds 与 appliesTo
-
-新原生 scope 使用 schemaVersion=3，moduleIds 为数组，例如 `["asset-management", "work-order-management"]`。标识须来自实际 PRD 或已确定项目模块：小写字母开头，使用字母、数字和单个连字符分隔，总长不超过 128；不把文档名、需求全文、代码路径或通配符当模块标识。模块身份不清楚时填 []，不编造标识。
-
-需求的 source.reference 保留具体 PRD、版本与需求编号，statement 保留真实依据。多个 PRD 同模块去重；不同模块取本原型 scope 范围内并集。需求 ID 在本 scope 内唯一，文档冲突明确留作待确认项；模块关联不能代替需求覆盖或完成证明。
-
-创建会将 scope 固定到 inputs，并从 moduleIds 去重生成索引条目的 appliesTo。directory 始终相对业务项目根目录，不相对 index.json 所在目录。旧 scope 没有 moduleIds 时按原合同保留，既有中文模块标签仍可按原文查询；不将新标识格式追溯强加给旧数据。空 appliesTo 表示未关联，不适用于全项目。
-
-```sh
-node <skill-root>/scripts/native-pilot.cjs index --project <project-root> --module asset-management
-```
-
-查询只读。返回 matches、unbound、selection：多匹配为 ambiguous，不自动挑选“最新”；关联与固定输入不一致时 status=failed，该条目不会进入 matches。随后仍须读取候选、有效 QA 与已认可基线，不能把 matched 当作已验收。
-
-已固定的 scope 改动需按现有 revise 合同明确接受输入、校验摘要并重新验证。`revise --accept-inputs` 接受新 scope 时同步索引，索引写入失败回退本次元数据更改；历史基线与用户编辑的输入不被覆盖。
-
-索引被误改、而固定输入仍有效时可显式修复：
-
-```sh
-node <skill-root>/scripts/native-pilot.cjs sync-index --project <project-root> --id assets
-```
-
-sync-index 只从该实例已接受的固定 scope 生成关联，不修改候选源码、输入或基线；输入尚未明确接受或另一负责人正在写入时拒绝。没有 moduleIds 的旧合同不自动补值。
-
-## 旧索引兼容与显式迁移
-
-只有旧根 `.i3-ui-prototypes.json` 的项目继续读取、更新同一旧索引，不在后台创建第二份；其已有实例保持原目录和摘要。双索引不一致时报告冲突，不能猜测、合并或覆盖。两份相同索引可读取，写入前仍需显式整理为一份。
-
-```sh
-node <skill-root>/scripts/native-pilot.cjs migrate-index --project <project-root> --check
-# 核对预览 sourceDigest，再明确执行：
-node <skill-root>/scripts/native-pilot.cjs migrate-index --project <project-root> --expected-digest <sourceDigest>
-```
-
-迁移保留索引原文和 directory 的解析基准，将原根索引存档到 `prototypes/.migration/index-<id>/legacy-index.json`，新活动索引为 prototypes/index.json。失败保留原索引、移除本次未提交的新索引，备份可审查；不移原型或重写旧输入。安装／升级不触发该迁移。旧准备目录、模板副本、工具和 `.playwright-cli` 不自动搬动或清空。
-
-## 实际使用 Playwright CLI 时
-
-主验收继续按 i3-browser-testing-with-devtools 与框架合同执行。本节只收纳实际使用的 Playwright CLI 补充输出，不自动安装 CLI／浏览器，不替代 Skill／MCP 调用或业务验收。
-
-```sh
-# 创建该宿主、项目与运行的输出配置，返回 configFile 和环境信息。
-node <skill-root>/scripts/native-pilot.cjs browser-cache --project <project-root> --host codebuddy --scope global --run-id review-r001
-# 也可用包装器运行已有 CLI 的 Node 入口；参数在 -- 后完整传给 CLI。
-node <skill-root>/scripts/native-pilot.cjs browser-cli --project <project-root> --host codebuddy --scope global --run-id review-r001 --cli <absolute-playwright-cli.js> -- -s=i3-assets-review open <local-preview-url>
-```
-
-包装器设置输出配置、环境与工作目录到该缓存，保存调用输出。后续同一浏览器会话继续使用同样的 run-id、scope 和 session；资源路径使用绝对路径。命令返回 executed 仅说明进程成功退出，不说明界面或验收通过。只操作本次会话，不使用 close-all／kill-all，不自动安装。
-
-明确选择要保留的原始输出，归档后再清理缓存：
-
-```sh
-node <skill-root>/scripts/native-pilot.cjs archive-browser-output --project <project-root> --host codebuddy --scope global --run-id review-r001 --id assets --files page.yml,cli-output.log
-```
-
-只拷贝指定缓存内的普通文件，不允许路径越界、符号链接或覆盖已有归档；实际文件名以本轮工具输出为准。目标为 `prototypes/assets/qa/runs/review-r001/tool-output/`，保存摘要及归档时的候选身份，verification 保持 not-assessed。它是可审查原始材料，不能替代实际浏览器报告与验收记录。缓存缺失不影响 AD 读取已经归档的项目资料。

package/skills/i3-ui-prototype/references/template-adapters.md

@@ -1,63 +0,0 @@
-# 模板目录与运行层接入
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-## 当前资源
-
-`assets/templates/catalog.json` 负责类型、可用状态、版本和预览入口，并用 `defaultTemplate` 指定默认类型。可生成条目必须指向自己目录下的 `manifest.json`；planned 条目不要求资源目录，不能初始化，也不会回退为其他模板。
-
-完整内容参考可直接离线打开，native-pilot prepare-template 也复用同一资产（见 [content-template.md](content-template.md)）。HTML 审查实例的企业后台运行合同仍使用 `easel-html`：完整 EASEL `reference/`、`origin.json` 来源清单、设计 token 和独立滚动适配。原始 326 个文件保持原样。AI 工作台、数字孪生大屏和移动端仅为 planned 目录条目，没有假模板包。旧三套兼容模板明确使用 `legacy-html`，共享 `common/`，各自保留 preset；不能把这些兼容演示当成新三类已经实现。
-
-模板选择页按 catalog 展示可用类型并切换预览，只负责查看资源；点击卡片不会创建业务原型、采用专业建议或确认基线。实际生成仍走技能操作并按业务适配，浏览器验证和用户认可分别保存。
-
-## manifest
-
-可生成模板的最小清单示例：
-
-```json
-{
-  "schemaVersion": 1,
-  "adapter": "easel-html",
-  "preset": "enterprise-admin/preset.json",
-  "resources": { "root": "enterprise-admin" },
-  "defaultTitle": "企业管理后台 · EASEL 完整示例"
-}
-```
-
-资源路径相对于 `assets/templates/`，必须存在，不能绝对寻址、包含 `..` 或通过符号链接跳转。manifest 只能选择代码中明确登记的内置 adapter；它不是可以执行任意脚本的插件描述。未知 adapter、缺清单或不安全路径在创建实例前拒绝。摘要包含所选 catalog 条目、清单、资源、登记器、adapter 版本及其声明的实现文件；其他模板条目不会改变当前模板摘要。仅修改 preset 不足以表示一个独立运行层。
-
-## adapter 合同
-
-`scripts/template-adapters.cjs` 集中读取与校验 catalog/manifest，计算摘要并选择运行层。当前仅登记 `adapters/easel-html.cjs`、`adapters/legacy-html.cjs`，不按模板 ID 在公共生成器中分支，也不隐式复制 common。
-
-每个 adapter 提供：
-
-- `version` 和 `implementationFiles`：运行层版本、应计入摘要的实现及辅助文件；新增内置运行层应完整登记实现依赖。
-- `fingerprintInputs(context)`：实际模板资源路径。上下文的 `resource(name)` 只读取 manifest 声明且通过安全校验的位置。
-- `initialize(directory, options, context)`：写入隔离的实例暂存目录，返回 `{metadata, handoff}`；公共层再统一写配置、token、QA 和项目登记。
-- `validateRuntime(metadata, options)`：运行身份、用途及适用业务验收条件。
-- `runtime`：`kind`、`requiredFiles`、`identityFields`、`excludedBrowserPrefixes`、`protectedFiles`、`protectedDirectories`。它们定义运行检查、摘要身份和基线保护，不代替实际浏览器执行。
-
-共同设计契约、token、入口和需求映射始终受保护，运行层可增加自己的保护路径。运行身份变化也作为契约变化报告。EASEL 的历史 tools/tests/qa 不作为浏览器模块扫描；当前验收仍读取实例根 qa。
-
-`createTemplateRegistry({assetRoot, adapters})` 支持受信任的程序内集成与隔离测试；CLI 使用随包登记器，不接受从模板清单加载任意 adapter 代码。旧实例没有 `template.adapter` 时按已登记模板识别；缺新增 runtime 字段的旧 legacy 身份不补写字段，旧 EASEL 的 purpose/business/runtime 顺序保持，原有内容摘要与快照继续可读。未知模板不靠猜测识别为 common。
-
-## 扩展步骤
-
-1. 准备完整可运行资源、preset 与设计契约；有外部来源时保留来源清单、许可和固定内容。
-2. 增加 manifest，声明真实 adapter 与资源；独立运行形态实现并登记 adapter，不能只改 available 后复用错误演示。
-3. catalog 登记版本、manifest 和本地预览。planned 保持不可生成，原有实例不自动切换模板或升级摘要。
-4. 验证独立运行层无 common 也能生成，资源/实现变化改变指纹，非法清单写入前拒绝，运行检查与基线保护覆盖，旧实例摘要兼容；再做真实浏览器与业务场景验收。
-5. 在源码维护流程登记新增分发文件，完成品牌生成、打包/安装完整性检查。此登记不代表用户认可模板或授权发布。
-
-## 原生内容参考扩展（新 scope v3）
-
-HTML 实例的 manifest／adapter 与原生内容参考各有合同。原生不靠 HTML adapter 选择框架：catalog 可用条目增加安全 `contentRoot`，该目录提供 template.json（kind=content-reference）、离线 index.html、完整源资产、component-inventory.json、generation.json 和派生 template-inventory.json；先列全组件分类，再生成清单。generation.json 固定本模板适用模式、框架、预设及通用规则摘要，不接受任意插件代码。新的同类模板不需要修改核心生成器的模板 ID 分支；不同文件组织／运行形态须先明确适配，不声称任意 HTML 可自动接入。
-
-维护者在 Skill 源码修改模板及分类后执行 `native-pilot.cjs sync-generation-assets`；以 `--check` 核对派生文件，随后执行 inventory、模式／反例、原生配置和真实业务验收。规则目录发生变化时先评审版本与能力，再更新各模板 generation.json 的 definitionDigest（generation.json 采用 Node JSON.stringify 后的 SHA256），重算清单，不靠更新摘要掩盖删功能。离线预设 JS 由注册元数据生成；品牌重放后重算派生清单，引用 HTML／历史来源内容保持原字节。业务生成、analyze 和旧实例 inspect 不写这些源资产；旧实例始终按 inputs 快照而非新安装目录验收。

package/skills/i3-ui-prototype/references/workflow-contract.md

@@ -1,77 +0,0 @@
-# 操作与状态
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-## 公共前置与副作用
-
-主会话通过自然语言、命令、元技能或直接 Skill 使用同一顺序：识别操作及限制，读取实际文件和清单，恢复固定输入／版本／交接，确认实际工具，确定单一修改负责人，再进入对应运行层。入口仅发现工作 Skill，不强制分派角色，不绕回命令或元技能。按操作需要复用 frontend、框架官方、UIUX 和 browser 技能，各工程技能保留原有方法。
-
-| 操作 | 允许范围 |
-| --- | --- |
-| analyze | 只读文件和已核对的只读查询，分析留在会话 |
-| create | 在授权项目内准备未存在的用户模板副本、同步索引、创建新实例并实现 |
-| revise | 基于实际文件及固定合同形成新候选，保留手改和旧基线 |
-| inspect | 检查当前实例；用户明确只读时不保存报告或运行状态 |
-| confirm-baseline | 用户认可具体版本且验收匹配后，保存不可覆盖的快照 |
-
-明确“不改代码／不写文件”优先于默认 create。analyze 不创建目录、安装升级、写 provider 结果、初始化运行记录或改变状态；约束包括检查器、官方 Skill、UIUX 和浏览器助手的下游行为。用户要求保存分析文档时只写指定输出。只读期间不得为了记录执行模式而落盘。
-
-analyze 返回需求／通用能力覆盖、模板与框架选型、验收计划和未决项，信息足够后停止探索并回传。已有来源的固定 profile／component-map／acceptance 可支持选型，不等于逐组件逐 Prop 实施核验；只对影响选型的具体疑点定向查本地 API。完整目标版本包／源码验证留 create，不遍历 starter、node_modules、整套 CLI 帮助或组件清单来证明分析；必要定向读取仍可进行。未知点保留 openItems，不把 UIUX 准入、逐条采纳、构建或浏览器当分析前置，不把计划写成已验证结果。
-
-能力覆盖包含绑定参数，不能只按 Table／pagination 等名称匹配。PRD 要求可调页大小而当前绑定 `fixedPageSize: 10` 时，报告部分覆盖、明确在可写阶段需显式适配；固定值不是默认值，不能借已有通用分页能力宣称全部满足。分析完整交付可 status=complete，但覆盖检查与 openItems 如实保留冲突；仅分析未完成才 partial／blocked。只读期间不改需求、绑定或固定输入，后续计划不记为已实现或已验收。
-
-先按实际 `--host`、`--scope` 只读检测宿主基址 `tools/i3-prototype/` 下的工具，保留旧项目 `.prototype-tools` 检测；或使用宿主已经明确给出的绝对入口，核对固定版本后直接调用；不要反复扫描 node_modules。analyze 不运行 npm exec／npx 或任何会自动安装／补缓存的命令；缺工具报告未决项，改用现有只读资料。可写模式同样使用准备好的本地固定 CLI，只有工具准备另有授权时才在明确工具目录安装；该授权不包含业务文件、已安装 SDK、宿主设置或未选择的全局目录。项目构建依赖的 --install 是另一项写操作，不能借用查询工具授权。
-
-create／revise 的项目写入范围不包含用户级长期记忆或宿主 auto-memory；未经用户明确要求，不创建或更新这些文件。纯文件续接依靠实例合同与交接；测试启动时核对宿主记忆开关和工具写入范围，不将 no-session-persistence 视为禁止 auto-memory，不更改全局偏好。
-
-执行阶段保持一个源码／合同修改负责人；另有授权的协作按实际工具和执行记录留证，不冒认其他执行者的工作。连续性来自文件。写入前核对预期 revision／candidateDigest，遇到并发变化停止该次写入并重读，不覆盖较新候选。
-
-## 原生组件 v2
-
-已有实例优先用 native-pilot.cjs state 一次恢复合同、身份、设计／构建／QA及精确 commands，不遍历依赖或反复读控制器实现。真实查询与人工设计取舍完成后，本轮 CodeBuddy 原生流程依次为 build→宿主实际加载 i3-browser-testing-with-devtools Skill→Chrome DevTools MCP 按能力执行并取得实际观测→新业务场景实测及 record-run（旧设备合同另用 browser 专项回归）→state→finalize→独立最终回复。Skill 的 DOM／计算样式、截图、console、network、a11y 与 performance 观测不能只列计划或挂名；缺任一必需工具／执行时整链不 complete。analyze 只提出这份验收计划，不启动检查。
-
-browser 是历史设备合同的 Playwright 专项工具，自行管理服务，不替代上述 Skill 或 MCP。实际 DevTools 检查后用 record-devtools-review --report 登记独立 qa/devtools-review.json；新 create 的固定 acceptance.browserReview 要求当前报告，state 列缺项，finalize 拒绝缺失／过期／证据变化。脚本只核结构、文件和当前身份，不证明真实调用，仍输出 invocationVerified=false。主会话另核原始宿主 stream、实际观测及同一 candidate／build，交付前核对当前 state／delivery，再以自然语言给出结果和证据位置。详细证据合同见 interaction-acceptance。旧 v1 和无 browserReview 的已有 v2 保留原验收，新要求仅进入新实例或显式接受变更的输入；其他宿主的等效工具结果单列，不冒充这条指定链。
-
-create 使用完整 enterprise-admin 内容模板、实际 scope.pages／regions 和 vue-antdv-next 框架，使用 native-pilot.cjs。用户 HTML 工作副本升级不覆盖。创建前检查标识、绑定和索引一致，固定本次范围、模板、能力、框架及必需场景。PRD 可简短，但明确／假设／待确认／范围外须有来源。
-
-目标目录须留给原子 create：provider 先 probe，初始化后才在实例 qa 下保存查询和设计证据。初始化前需要保存的官方／UIUX 查询使用独立准备目录，不能预先创建 prototypes/<id>/qa。没有 prototype.json 的已有目录先核对来源，不能调用 revise 冒充实例。只有确认整个目录均由本次准备操作产生，才可整体移走，确保目标不存在后重试；只移文件留下空目录仍会失败。含用户或未知文件时保留并报告冲突。
-
-required 不可任意 N/A；检查器按已声明业务区域重算必需集合，实际页面与区域的对应由前端／浏览器复核。缺失语义、参数或范围仍待处理，不能为通过删能力。新流程的分页与四主题默认及 scope 格式见 [content-template.md](content-template.md)。初始化状态为 needs-adaptation，主会话继续实现实际业务；完成后标 adapted，才进入当前候选验收。旧设备列表的固定容量、可选主题和验收数量仍按旧 inputs，不追溯追加要求。
-
-revise 使用 `native-pilot.cjs revise <root> --revision <new> --expected-revision <current> --expected-digest <currentDigest>`，保留实际源码而非重复制 starter。模板或框架升级是显式输入变更，旧实例继续检查固定输入。手改后旧证据失效；新交互补映射，删除必需功能产生缺口。
-
-确需更改固定输入时，由当前修改负责人先整理 inputs 中完整新快照、能力／范围／场景及 requirements-map，再使用同一 revise 命令加 `--accept-inputs`。该选项在锁和预期版本保护下完整校验新合同，成功才接受新 inputDigest 和版本并清除旧验证状态；失败不推进版本。它不自动下载或套用新模板、框架，不补造需求映射。普通 revise 遇到输入变化会拒绝，避免新版本带着旧摘要。
-
-inspect、manifest、build 按 v2 合同执行；不得让 legacy 写接口接管。首次可写构建使用 `build <root> --install` 安装固定锁依赖，后续 build 复用依赖。preview 输出 URL 并持续服务，--build-id 可选择固定构建。浏览器证据导入后 `inspect <root> --acceptance` 检查覆盖与身份。
-
-持续写任务可 `claim <root> --owner <owner> --expected-revision <revision> --expected-digest <digest>`；revise 传同一 owner，编辑结束 `release <root> --owner <owner>` 后再验收／确认。临时修改由脚本 claim／release。锁不进入候选身份，丢失 Agent 不自动清除别人仍持有的修改权。
-
-compare-baseline 只比较当前候选与已保存基线；confirm-baseline --confirmation 接收具体版本的人类确认，再核对当前验收并保存不可覆盖快照。证据不齐保留待确认候选，不手工构造批准状态。
-
-## Legacy HTML
-
-legacy create 读取业务上下文、检测专业模式、展示四类模板可用状态并记录选择，再初始化和适配。企业后台可用；AI 工作台、数字孪生大屏和移动端 planned，不能替换生成。旧三套模板供历史实例。needs-design-provider 不等于成功；可先比较需求和模板，按已有授权修复或等待明确选择 template。已有 expertMode 作为迭代默认。
-
-legacy revise 指定未使用版本，改变导航、token、组件行为或业务状态时解释影响。inspect 写报告服从本次范围，不改页面或冻结。确认须有具体版本的用户认可和完整必需证据。旧实例不补写 v2 metadata，不改原摘要及已冻结历史。
-
-## 状态与交付
-
-verification 使用 not-run、partial、passed、failed、blocked；review 使用 pending-review、changes-requested、approved。expert 使用 pending、used、reviewed、skipped、missing、unusable、no-match。它们分别表示检查、用户认可及专业能力使用；不相互推断。
-
-专业查询成功、建议处理、采用和效果验证独立保存。有依据的零采用可完成复核，冻结不自动改 used。template 明确跳过专业查询但不降低功能验收。provider 不可用报告具体原因，不静默切模式。
-
-原型可从草拟需求开始。需求确认、原型认可、正式规格批准和生产授权分别保存。返回 operation、scope、revision、executionMode、mode、verification、review、openQuestions 和下一项必要动作；说明结构、真实宿主、浏览器和人类确认各自结果。
-
-各入口在工具之后用自然语言交付实际范围、身份、证据、缺项和下一步，不强制父子 JSON、标记或结构校验。validate-result.cjs 可作特定维护工具，不是普通原型入口前置。业务、当前 state/delivery、真实 QA 分别核对，不能由结构结果推断。analyze 留在会话、不写收据；参数冲突以部分覆盖和未决项说明，不把分析完成等同覆盖通过。
-
-企业后台默认 purpose=business-prototype，完整参考副本的 business.status=needs-adaptation；必须完成实际业务适配才能验收。用户明确评审 EASEL 模板本身时，使用 purpose=template-review，并将 reference-demo 范围写进交接。模板认可不等于任何新业务的需求或原型认可。
-
-## 项目共享与宿主缓存
-
-默认业务写入集中于 prototypes：准备区 .preparation/<id>、共享 index.json 和本次实例。安装与分析不提前生成这些资料；原型流程不在根目录散落准备目录、工具或浏览器 CLI 输出。工具与缓存使用实际宿主基址，global 缓存按规范化项目身份隔离；正式需求、交接与 QA 归实例。旧路径不因升级自动迁移。目录、scope.moduleIds 与 appliesTo 的唯一来源、冲突及迁移规则见 [project-layout.md](project-layout.md)。

package/skills/i3-ui-prototype/scripts/adapters/easel-html.cjs

@@ -1,30 +0,0 @@
-'use strict';
-const assert = require('node:assert/strict');
-const enterprise = require('../enterprise-template.cjs');
-module.exports = {
-  version: '1',
-  implementationFiles: [__filename, require.resolve('../enterprise-template.cjs')],
-  runtime: {
-    kind: 'easel-html', identityFields: ['purpose', 'business', 'runtime'],
-    requiredFiles: ['app/app.js', 'app/enterprise-bootstrap.mjs', 'app/routes.json', 'app/runtime/dom.js', 'app/styles/tokens.css', 'design-system/source.json'],
-    excludedBrowserPrefixes: ['app/tools/', 'app/tests/', 'app/qa/'],
-    protectedFiles: ['app/tokens.css', 'app/styles.css', 'app/index.html', 'app/domain.mjs', 'requirements-map.json', 'app/app.js', 'app/routes.json', 'app/config.json', 'app/enterprise-bootstrap.mjs', 'app/usability.css', 'app/offline.js'],
-    protectedDirectories: ['design-system/', 'app/styles/', 'app/runtime/', 'app/src/'],
-  },
-  fingerprintInputs(context) {
-    enterprise.verifyReference(context.resource('root'));
-    return [context.resources.root];
-  },
-  initialize(directory, options, context) {
-    const purpose = options.purpose || 'business-prototype';
-    const runtime = enterprise.initialize(directory, { ...options, purpose, templateRoot: context.resource('root') });
-    return {
-      metadata: { purpose, runtime, business: { status: purpose === 'template-review' ? 'reference-demo' : 'needs-adaptation', source: 'i3-Composer 示例业务' } },
-      handoff: `用途：${purpose}。业务适配：${purpose === 'template-review' ? 'reference-demo' : 'needs-adaptation'}。完整保留 i3-Composer 示例，不能当作其他业务已完成；app/qa 为历史来源证据，当前验收读取根 qa/。\n\n`,
-    };
-  },
-  validateRuntime(metadata, options = {}) {
-    assert.ok(metadata.runtime?.kind === 'easel-html' && ['template-review', 'business-prototype'].includes(metadata.purpose), 'Invalid enterprise runtime contract');
-    if (options.acceptance && metadata.purpose === 'business-prototype') assert.equal(metadata.business?.status, 'adapted', 'Enterprise demo needs business adaptation / 需先完成实际业务适配');
-  },
-};

package/skills/i3-ui-prototype/scripts/adapters/legacy-html.cjs

@@ -1,28 +0,0 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const assert = require('node:assert/strict');
-module.exports = {
-  version: '1',
-  implementationFiles: [__filename],
-  runtime: {
-    kind: 'legacy-html', identityFields: ['runtime'],
-    requiredFiles: ['app/app.mjs', 'app/domain.mjs', 'app/styles.css', 'mocks/applications.json'],
-    excludedBrowserPrefixes: [],
-    protectedFiles: ['app/tokens.css', 'app/styles.css', 'app/index.html', 'app/domain.mjs', 'requirements-map.json'],
-    protectedDirectories: ['design-system/'],
-  },
-  fingerprintInputs: ({ resources }) => [resources.common],
-  initialize(directory, options, context) {
-    const common = context.resource('common');
-    for (const folder of ['app', 'mocks', 'design-system']) fs.cpSync(path.join(common, folder), path.join(directory, folder), { recursive: true });
-    fs.renameSync(path.join(directory, 'design-system/master.md'), path.join(directory, 'design-system/MASTER.md'));
-    fs.copyFileSync(path.join(common, 'requirements-map.json'), path.join(directory, 'requirements-map.json'));
-    return { metadata: { runtime: { kind: 'legacy-html', entry: 'app/index.html' } }, handoff: '' };
-  },
-  validateRuntime(metadata) {
-    // Older legacy instances did not store a runtime field. Do not migrate
-    // their identity or invalidate already recorded content digests.
-    assert.ok(!metadata.runtime || metadata.runtime.kind === 'legacy-html', 'Invalid legacy runtime contract');
-  },
-};

package/skills/i3-ui-prototype/scripts/browser-workspace.cjs

@@ -1,72 +0,0 @@
-'use strict';
-const { fs, path, crypto, hash, assert, json, id, inside, write } = require('./native-files.cjs');
-const { spawnSync } = require('node:child_process');
-const { resolveLocations } = require('./prototype-locations.cjs');
-function location(options) {
-  id(options.runId);
-  const context = resolveLocations(options);
-  return { context, directory: inside(context.cacheDirectory, `playwright/${options.runId}`) };
-}
-function prepare(options = {}) {
-  const { context, directory } = location(options), configFile = inside(directory, 'cli.config.json');
-  const config = { outputDir: directory, outputMode: 'file' };
-  if (fs.existsSync(configFile)) assert.deepEqual(json(configFile), config, 'Existing browser output config differs; preserve it and use another run ID');
-  else write(directory, 'cli.config.json', config);
-  return { status: 'prepared', directory, configFile, host: context.host, scope: context.scope, projectKey: context.projectKey,
-    environment: { PLAYWRIGHT_MCP_OUTPUT_DIR: directory, PLAYWRIGHT_MCP_CONFIG: configFile } };
-}
-function runCli(options = {}) {
-  assert.ok(typeof options.cli === 'string' && path.isAbsolute(options.cli), '--cli requires an existing absolute Playwright CLI Node entry');
-  const entry = fs.realpathSync(options.cli); assert.ok(fs.statSync(entry).isFile(), 'CLI entry must be a file');
-  assert.ok(Array.isArray(options.command) && options.command.length && options.command.every(value => typeof value === 'string'), 'Provide CLI arguments after --');
-  assert.ok(!options.command.some(value => value === '--config' || value.startsWith('--config=')), 'Output config is managed by this wrapper');
-  const command = options.command.find(value => !value.startsWith('-'));
-  assert.ok(!['install', 'install-browser', 'close-all', 'kill-all'].includes(command), 'Installation and all-session commands are not prototype browser operations');
-  const output = prepare(options);
-  const result = spawnSync(process.execPath, [entry, '--config', output.configFile, ...options.command], {
-    cwd: output.directory, env: { ...process.env, ...(options.env || {}), ...output.environment }, encoding: 'utf8', timeout: 60000, maxBuffer: 16 * 1024 * 1024 });
-  const call = `cli-${crypto.randomUUID()}`;
-  write(output.directory, `${call}.stdout.log`, result.stdout || ''); write(output.directory, `${call}.stderr.log`, result.stderr || result.error?.message || '');
-  return { ...output, status: result.status === 0 && !result.error ? 'executed' : 'failed', exitCode: result.status,
-    stdout: result.stdout || '', stderr: result.stderr || result.error?.message || '', verification: 'not-assessed' };
-}
-function archive(options = {}) {
-  const { context, directory: source } = location(options);
-  assert.ok(fs.existsSync(source), 'Browser cache does not exist');
-  const files = Array.isArray(options.files) ? options.files : typeof options.files === 'string' ? options.files.split(',') : [];
-  assert.ok(files.length && new Set(files).size === files.length, 'Explicit unique output files are required');
-  const selected = files.map(file => {
-    assert.ok(!['archive.json', 'cli.config.json'].includes(file), 'Reserved browser output filename');
-    const from = inside(source, file); assert.ok(fs.statSync(from).isFile(), 'Only regular output files can be archived');
-    return { file, from, digest: hash(fs.readFileSync(from)) };
-  });
-  const prototype = require('./project-registry.cjs').paths(context.project, options.id).directory;
-  assert.ok(prototype && fs.existsSync(prototype), 'Prototype must already exist');
-  const ownerFile = inside(prototype, '.prototype-write.lock');
-  if (fs.existsSync(ownerFile)) assert.equal(json(ownerFile).owner, options.owner, 'Prototype has another active writer');
-  const native = require('./native-pilot-lib.cjs'), candidate = native.manifest(prototype);
-  const parent = inside(prototype, `qa/runs/${options.runId}`), destination = inside(parent, 'tool-output');
-  assert.ok(!fs.existsSync(destination), 'Archived output already exists; preserve it');
-  fs.mkdirSync(parent, { recursive: true });
-  const lockFile = inside(parent, '.tool-output.lock'), lock = fs.openSync(lockFile, 'wx');
-  let stage;
-  try {
-    stage = fs.mkdtempSync(path.join(parent, '.archive-'));
-    for (const item of selected) {
-      const target = inside(stage, item.file); fs.mkdirSync(path.dirname(target), { recursive: true });
-      fs.copyFileSync(item.from, target, fs.constants.COPYFILE_EXCL);
-      assert.equal(hash(fs.readFileSync(target)), item.digest, 'Output changed while archiving');
-      assert.equal(hash(fs.readFileSync(item.from)), item.digest, 'Source output changed while archiving');
-    }
-    write(stage, 'archive.json', { schemaVersion: 1, host: context.host, scope: context.scope, projectKey: context.projectKey, runId: options.runId,
-      candidateDigest: candidate.digest, revision: candidate.revision, files: Object.fromEntries(selected.map(item => [item.file, item.digest])), verification: 'not-assessed' });
-    assert.equal(native.manifest(prototype).digest, candidate.digest, 'Candidate changed while archiving');
-    assert.ok(!fs.existsSync(destination), 'Archived output appeared while copying');
-    fs.renameSync(stage, destination);
-    return { status: 'archived', directory: destination, files, verification: 'not-assessed' };
-  } finally {
-    if (stage && fs.existsSync(stage)) fs.rmSync(stage, { recursive: true, force: true });
-    fs.closeSync(lock); fs.unlinkSync(lockFile);
-  }
-}
-module.exports = { prepare, runCli, archive };

package/skills/i3-ui-prototype/scripts/buddy-host.cjs

@@ -1,40 +0,0 @@
-'use strict';
-// Identification never treats absence of an IDE marker as proof of CLI identity.
-const path=require('node:path'),os=require('node:os'),assert=require('node:assert/strict');
-const HOSTS=['codebuddy','workbuddy'];
-function globalBase({host='codebuddy',home=os.homedir(),env=process.env}={}){
- assert.ok(HOSTS.includes(host),'Unsupported Buddy host');
- const key=host==='workbuddy'?'WORKBUDDY_CONFIG_DIR':'CODEBUDDY_CONFIG_DIR';
- const base=env[key]?.trim()||path.join(home,`.${host}`);
- assert.ok(path.isAbsolute(base)&&!/[\x00\r\n]/.test(base),`${key} must be an absolute safe directory`);
- return path.normalize(base);
-}
-function identify(payload,record,{home=os.homedir(),env=process.env}={}){
- const clients={CodeBuddyIDE:['codebuddy','ide'],CodeBuddyCLI:['codebuddy','cli'],CodeBuddyCode:['codebuddy','cli'],WorkBuddy:['workbuddy','ide'],WorkBuddyIDE:['workbuddy','ide'],WorkBuddyDesktop:['workbuddy','ide']};
- const client=clients[payload.client];
- const declared=typeof payload.host==='string'?payload.host.toLowerCase():null;
- let found=client&&{host:client[0],product:client[1],identitySource:'native-client'};
- if(found&&declared)assert.equal(declared,found.host,'Conflicting native host identity');
- const candidates=[];
- if(typeof payload.transcript_path==='string'&&path.isAbsolute(payload.transcript_path)){
-  const file=path.normalize(payload.transcript_path);
-  for(const host of HOSTS){
-   const parent=path.join(globalBase({host,home,env}),'projects')+path.sep;
-   if(file.startsWith(parent)&&file.endsWith('.jsonl'))candidates.push(host);
-  }
- }
- if(found&&candidates.length)assert.ok(candidates.includes(found.host),'Conflicting client and native host log location');
- if(!found&&candidates.length){
-  const host=candidates.length===1?candidates[0]:env.WORKBUDDY_CONFIG_DIR&&candidates.includes('workbuddy')?'workbuddy':null;
-  assert.ok(host,'Conflicting native host log locations');
-  found={host,product:host==='codebuddy'?'cli':'ide',identitySource:'native-host-log-location'};
- }
- // A legacy installation retains its original, explicitly weaker contract.
- if(!found&&record.schemaVersion===1&&['ide','cli'].includes(record.product))found={host:'codebuddy',product:record.product,identitySource:'legacy-profile'};
- assert.ok(found,'Native host/product identity is unavailable; keep invocation unverified');
- if(declared)assert.equal(declared,found.host,'Conflicting native host identity');
- assert.ok((record.hosts||['codebuddy']).includes(found.host),'Native host is outside the registered scope');
- return {...found,productVersion:payload.client_version||payload.product_version||(found.host==='workbuddy'?(env.WORKBUDDY_APP_VERSION||env.CLIENT_INFO_PRODUCT_VERSION):null)||(record.product==='auto'?null:record.productVersion)||'unreported'};
-}
-function isIDE(payload){return ['CodeBuddyIDE','WorkBuddy','WorkBuddyIDE','WorkBuddyDesktop'].includes(payload.client);}
-module.exports={HOSTS,globalBase,identify,isIDE};

package/skills/i3-ui-prototype/scripts/check-design-provider.cjs

@@ -1,9 +0,0 @@
-'use strict';
-const lib = require('./prototype-lib.cjs');
-try {
-  const { options } = lib.parseArgs(process.argv.slice(2));
-  const provider = lib.checkDesignProvider(options);
-  const result = options.query && provider.availability === 'available' ? { provider, query: options.query, result: lib.queryProvider(provider.root, options.query, options) } : provider;
-  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
-  if (provider.availability !== 'available') process.exitCode = 2;
-} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }

package/skills/i3-ui-prototype/scripts/check-prototype.cjs

@@ -1,14 +0,0 @@
-'use strict';
-const lib = require('./prototype-lib.cjs');
-try {
-  const { options, positional } = lib.parseArgs(process.argv.slice(2));
-  if (!positional[0]) throw new Error('Usage: node check-prototype.cjs <prototype-directory> [--acceptance] [--enforce-baseline]');
-  const result = lib.checkPrototype(positional[0], options);
-  result.baseline = lib.compareBaseline(positional[0]);
-  if (result.baseline.status === 'corrupt-baseline' || (options.enforceBaseline && result.baseline.protectedChanges.length)) {
-    result.status = 'failed';
-    result.errors = [...(result.errors || []), result.baseline.status === 'corrupt-baseline' ? 'Approved baseline is corrupt' : 'Design constraints changed; review and confirm a new baseline'];
-  }
-  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
-  if (result.status !== 'passed') process.exitCode = 1;
-} catch (error) { process.stderr.write(error.message + '\n'); process.exitCode = 1; }

package/skills/i3-ui-prototype/scripts/codebuddy-context.cjs

@@ -1,92 +0,0 @@
-'use strict';
-const fs=require('node:fs'),path=require('node:path'),os=require('node:os'),assert=require('node:assert/strict');
-const R=require('./codebuddy-registration.cjs'),E=require('./execution-evidence.cjs'),H=require('./buddy-host.cjs');
-const FILES=['native-tool-name.cjs','native-command.cjs','buddy-host.cjs','execution-recovery.cjs','execution-diagnostics.cjs','ptc-callbacks.cjs','native-tool-result.cjs','prototype-dependencies.cjs','execution-policy.cjs','execution-evidence.cjs','codebuddy-ide-source.cjs','execution-gates.cjs','execution-assertions.cjs','execution-runtime.cjs','codebuddy-context.cjs','codebuddy-registration.cjs','codebuddy-hook.cjs','prototype-hooks.cjs','hosts/codebuddy.cjs','native-pilot.cjs','native-pilot-lib.cjs','native-delivery.cjs','native-devtools.cjs','native-files.cjs','native-build.cjs'];
-const read=file=>R.fileIO.read(file);
-function scriptsForEntry(scriptPath) {
- if(path.basename(scriptPath)!=='i3-prototype.cjs')return path.dirname(path.dirname(scriptPath));
- const root=path.resolve(path.dirname(scriptPath),'..');
- const candidates=[root,path.dirname(root)].flatMap(directory=>['i3-ui-prototype',['ui','prototype'].join('-')].map(id=>path.join(directory,'skills',id,'scripts')));
- const scripts=candidates.find(dir=>fs.existsSync(path.join(dir,'hosts/codebuddy.cjs')));assert.ok(scripts,'Unified Hook entry has no prototype Skill');return path.resolve(scripts);
-}
-function bundle(scriptPath) {
- const scripts=scriptsForEntry(scriptPath);
- const files=FILES.map(file=>[file,E.sha(fs.readFileSync(path.join(scripts,file)))]);
- files.push(['profile',E.sha(fs.readFileSync(path.join(scripts,'../assets/hosts/codebuddy/profile.json')))]);
- if(path.basename(scriptPath)==='i3-prototype.cjs') {
-  files.push(['unified-entry',E.sha(fs.readFileSync(scriptPath))]);
-  files.push(['unified-manager',E.sha(fs.readFileSync(path.join(path.dirname(scriptPath),'manage.cjs')))]);
- }
- return E.sha(JSON.stringify(files));
-}
-function registration(base) {
- const raw=read(path.join(base,'state/i3-prototype/installation.json'));if(!raw)return null;
- const record=JSON.parse(raw);assert.equal(record.owner,R.OWNER,'Unknown Hook ownership');assert.ok([1,2].includes(record.schemaVersion),'Unsupported Hook ownership');assert.equal(record.base,base,'Hook base differs');
- if(record.schemaVersion===2)assert.ok(record.product==='auto'&&Array.isArray(record.hosts)&&record.hosts.length&&record.hosts.every(host=>H.HOSTS.includes(host)),'Invalid automatic Hook identity');
- const settingsText=read(path.join(base,'settings.json')),settings=R.config(settingsText);
- for(const event of R.EVENTS)assert.equal((settings.hooks?.[event]||[]).filter(group=>JSON.stringify(group)===JSON.stringify(record.groups[event])).length,1,'Registered Hook was removed, duplicated, or edited');
- assert.equal(bundle(record.scriptPath),record.scriptDigest,'Audit adapter bytes changed; refresh owned registration');
- assert.ok(fs.existsSync(record.nodePath),'Registered Node executable is missing');
- return {...record,settingsDigest:E.sha(settingsText),registrationDigest:E.sha(JSON.stringify(record))};
-}
-const globalBase=H.globalBase;
-function select({project,product,host='codebuddy',home=os.homedir(),env=process.env,readText=read,loadRegistration=registration}) {
- assert.ok(['ide','cli'].includes(product),'Actual native product identity required');
- const projectBase=path.join(project,'.codebuddy'),userBase=globalBase({host,home,env});
- const projectText=readText(path.join(projectBase,'settings.json')),localText=readText(path.join(projectBase,'settings.local.json'));
- if(localText){const local=R.config(localText);assert.ok(!local.hooks&&!local.disableAllHooks&&!local.allowManagedHooksOnly,'Local Hook overrides are not supported by this profile');}
- const projectSettings=R.config(projectText);assert.ok(!projectSettings.disableAllHooks&&!projectSettings.allowManagedHooksOnly,'Project Hook policy prevents automatic auditing');
- const globalText=readText(path.join(userBase,'settings.json')),globalSettings=R.config(globalText);assert.ok(!globalSettings.disableAllHooks&&!globalSettings.allowManagedHooksOnly,'Global Hook policy prevents automatic auditing');
- // IDE documents project settings as an override. Do not silently fall back through a shadowing file.
- const bases=host==='codebuddy'&&product==='ide'&&projectText!==null?[projectBase]:[projectBase,userBase];
- for(const base of [...new Set(bases)]) {
-  const record=loadRegistration(base);if(!record)continue;
-  if(record.product==='auto'){
-   if(!(record.hosts||[]).includes(host))continue;
-  }else {assert.equal(host,'codebuddy','Legacy profile is CodeBuddy only');assert.equal(record.product,product,'Conflicting CodeBuddy product profiles');}
-  return {...record,host,product};
- }
- return null;
-}
-function projectKey(project){return `${path.basename(project).replace(/[^a-zA-Z0-9_-]/g,'-').slice(0,32)||'project'}-${E.sha(project).slice(0,16)}`;}
-function sessionDirectory(record,project,sessionId) {
- assert.ok(typeof sessionId==='string'&&sessionId,'Native session ID required');
- return path.join(record.base,'state/i3-prototype',projectKey(project),E.sha(record.schemaVersion===2?`${record.host}:${record.product}:${sessionId}`:sessionId).slice(0,24));
-}
-function source(payload,record,project) {
- assert.ok(typeof payload.transcript_path==='string'&&typeof payload.session_id==='string','Native transcript and session fields required');
- const roots=record.transcriptRoots||[],mode=record.transcriptMode||(roots.length?'manual':'auto');
- const value=E.readSource(payload.transcript_path,roots,{mode,project});
- assert.ok(value.prompts.length,'Original user task is absent from native transcript');
- assert.ok(value.calls.every(call=>call.sessionId===payload.session_id),'Native session identity missing or mismatched');
- assert.ok(value.prompts.every(prompt=>!prompt.sessionId||prompt.sessionId===payload.session_id),'Native prompt session differs');
- return record.product==='cli'?require('./ptc-callbacks.cjs').read(value,{record,project,sessionId:payload.session_id}):value;
-}
-function readOnly(prompt) {
- if(/不(?:要)?(?:改代码|修改(?:任何)?代码|实施|生成原型)|\b(?:analysis only|do not (?:edit|modify|implement))\b/i.test(prompt))return true;
- if(/(?:只|仅).{0,6}(?:分析|讨论|梳理|检查|解释)/.test(prompt))return true;
- if(/先.{0,4}(?:分析|讨论|梳理|检查|解释)/.test(prompt)&&!/(?:然后|再|后).{0,8}(?:实现|实施|修改|继续)/.test(prompt))return true;
- return /^\s*(?:请|先)?(?:暂停|停止|取消)(?:[，。！\s]|(?:这|当前|实施|工作|修改|生成))|^\s*(?:stop|cancel|pause)\b/i.test(prompt);
-}
-function userRestriction(prompt) {
- if(readOnly(prompt))return true;
- // Only an explicit request to resume implementation releases a restriction.
- // Ordinary questions never turn a pause into permission to write.
- if(typeof prompt!=='string'||/[?？]|(?:为什么|如何|是否|哪些|什么|是不是|能不能|吗)/.test(prompt))return null;
- const text=prompt.trim().replace(/^(?:(?:那就|好的?|现在|请|可以)[，,\s]*)+/,'').replace(/^please\s+/i,'');
- const resume=/^(?:继续|恢复)(?:[。！!\s]*$|吧[。！!\s]*$|实施|实现|开发|修改|执行|生成|修订|(?:当前|本次)?原型(?:的)?(?:实施|实现|开发|修改|制作|生成|修订))/.test(text)||/^(?:开始实施|开始实现|实施吧|执行吧)/.test(text)||/^(?:按|按照|依照)[^\n]{0,40}(?:方案|计划)[，,\s]*(?:开始)?(?:实施|实现|执行)(?:吧)?(?:[，,。！!\s]|$)/.test(text)||/^(?:帮我)?(?:生成|创建|实现|修订|修改|制作)[^\n]{0,20}原型/.test(text)||/^\/i3-prototype\b[^\n]*(?:生成|实现|创建|修订|修改|继续)/.test(text)||/^(?:continue|resume)(?:[.!\s]*$|\s+(?:the prototype\s+)?(?:implementation|implementing|development|coding)\b)|^(?:proceed|start implementation)[.!\s]*$/i.test(text);
- return resume?false:null;
-}
-function restriction(prompts=[],previous) {
- const value={blocked:previous?.blocked===true,throughLine:previous?.throughLine||0};
- for(const prompt of prompts)if(prompt.line>value.throughLine){
-  const control=userRestriction(prompt.text);if(control!==null)value.blocked=control;
-  value.throughLine=prompt.line;
- }
- return value;
-}
-function prefix(file,bytes,digest) {
- assert.ok(Number.isSafeInteger(bytes)&&bytes>0&&bytes<=64*1024*1024,'Invalid source cursor');
- const raw=E.cursorBytes(file);assert.ok(raw.length>=bytes,'Native transcript was truncated');assert.equal(E.sha(raw.subarray(0,bytes)),digest,'Native transcript prefix changed');
-}
-module.exports={FILES:Object.freeze(FILES),read,scriptsForEntry,bundle,registration,globalBase,select,projectKey,sessionDirectory,source,readOnly,userRestriction,restriction,prefix};