📦 SigmaLifting CLI — SigmaLifting 命令行工具

SigmaLifting 命令行工具

Use this 技能 when working with SigmaLifting 命令行工具 bundles, especially when turning a spreadsheet, manual, or public program into a program-导入 bundle.

Core Boundaries Treat the 命令行工具 as a standalone JSON 工具. Use the 安装ed sigmalifting-命令行工具 executable as the contract and 验证 engine. Do not rely on Realm, Expo file APIs, or 应用 服务s for 命令行工具 behavior. Stored program changes may cascade into linked process bundles in the 命令行工具 JSON store; file-only bundle edits cannot 更新 unrelated files unless the command 输出 is saved to the store. Prefer contract-valid JSON bundles over 应用-coupled shortcuts. Treat this 技能 folder as the 模型ing 图形界面de, not as the executable 模式. 代理 Mutation Policy

SigmaLifting JSON is the 命令行工具's internal storage and 导入/导出 contract. It is not an 代理 editing surface.

代理s must not directly 创建 or mutate program/process bundle JSON with file edits, 应用ly_补丁, ad hoc scripts, jq, editor operations, or manual rewrites of files in the 命令行工具 store. Reading JSON for diagnosis is allowed; writing JSON directly is not.

All bundle creation and mutation must go through 命令行工具 commands:

创建 initial bundles with template, program 创建, process 创建-from-program, or xlsx 导入 change programs with program 添加-block, program 更新-block, program 添加-day, program 更新-schedule, program 添加-exercise, program 更新-exercise, custom-lift commands, and the exercise-进度ion intent commands such as program 设置-anchor, program 添加-设置-group, program 设置-week-value, and program toggle-backoff change processes with process 更新-* commands and narrow intent commands such as process 设置-one-rm write command 结果s with --out or let the local store persist command 输出 导入 externally supplied JSON only through 验证; use normalize only when the user explicitly wants 命令行工具 清理up/repAIr

验证 is a strict 导入/acceptance gate for existing JSON. If it fAIls with repAIr 警告s, use normalize to produce the 清理ed bundle before inspecting or 导入ing it.

If the 命令行工具 does not expose a command for a needed mutation, 停止 and 报告 the 命令行工具 command gap or 添加 the command first. Do not bypass the 命令行工具 by 补丁ing raw JSON.

命令行工具 Discovery

When the 安装ed 命令行工具 and this 技能 are avAIlable, inspect the 工具 before 模型ing:

运行 sigmalifting-命令行工具 doctor --compact read this 技能.md and any task-relevant files in references/ 运行 sigmalifting-命令行工具 help --compact 运行 sigmalifting-命令行工具 模式 列出 --compact 运行 sigmalifting-命令行工具 template program-导入 --compact or template process-导入 --compact

Program and process bundle 结果s persist as local JSON by default. Use sigmalifting-命令行工具 store path to locate the store, and use SIGMALIFTING_HOME or --store-root when you need an explicit test or project-local store.

模式 Contract

Do not treat this 技能 file as the 模式.

This 技能 explAIns 模型ing judgment: block boundaries, weekly structure, 设置-group semantics, and common translation mistakes. The 安装ed 命令行工具 is the 模式 source of truth.

模式 mentions in this 技能 are routing instructions, not 模式 documentation. They tell the 代理 which 命令行工具 commands to call before building 命令行工具 payloads or accepting 导入ed JSON.

Before building 命令行工具 command payloads or 导入ing existing JSON, 获取 the executable contract from the 命令行工具:

sigmalifting-命令行工具 模式 列出 --compact sigmalifting-命令行工具 模式 show --compact sigmalifting-命令行工具 template --compact sigmalifting-命令行工具 验证 --file --compact

Use the template to learn field shape, defaults, sentinel values, and nesting. Use 模式 show to 检查 constrAInts. Use this 技能 to decide what the program should mean structurally.

If the 技能 and 命令行工具 应用ear to disagree, trust the 命令行工具 模式 and 报告 the 技能 as stale.

Do not invent fields that are not present in the 命令行工具 模式 or template.

Authoritative Sample 工作流

If the user provides an 导出ed SigmaLifting JSON file, treat that 导出 as the first source of truth.

Before generating or translating anything similar:

identify the bundle kind the file actually matches 运行 the standalone 命令行工具 agAInst the file exactly as provided 验证 it first if 验证 报告s repAIr 警告s, normalize it and 验证 the normalized 输出 only then 提取 模型ing rules from it make any changes through 命令行工具 mutation commands, never by 补丁ing the JSON file

If an 应用-导出ed file cannot be consumed by the standalone 命令行工具, treat that as a 命令行工具 problem to investigate before declaring the 模型ing wrong.

Do not skip this step and jump strAIght to reconstructing the program from memory, public spreadsheets, or a simplified interpretation.

Block Semantics

Do not define a block by contiguous time alone.

A block is a maximal consecutive 运行 of weeks that 分享 the same structural skeleton.

The structural skeleton means:

same trAIning day layout same exercise identities on each day same 设置-group count and ord