@llman-sdd/core 0.1.2 → 0.1.3
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.
- package/package.json +1 -1
- package/src/archive/sevenzip.ts +1 -1
- package/src/context/indexStore.ts +6 -12
- package/src/git/spawnGit.ts +0 -8
- package/src/index.ts +32 -4
- package/src/init/defaultConfig.ts +2 -2
- package/src/init/init.ts +46 -56
- package/src/report/collect.ts +3 -3
- package/src/report/graph.ts +22 -34
- package/src/report/show.ts +14 -37
- package/src/report/specs.ts +19 -19
- package/src/review/review.ts +34 -9
- package/src/spec/ir.ts +7 -0
- package/src/spec/parser.ts +9 -4
- package/src/templates/embedded.ts +67 -0
- package/src/templates/engine.ts +3 -2
- package/src/validation/validate.ts +3 -5
- package/templates/en/agents-root-stub.md +1 -1
- package/templates/en/skills/llman-sdd-apply-cycle.md +7 -7
- package/templates/en/skills/llman-sdd-apply.md +12 -12
- package/templates/en/skills/llman-sdd-arch-review.md +2 -2
- package/templates/en/skills/llman-sdd-archive.md +12 -12
- package/templates/en/skills/llman-sdd-continue.md +8 -8
- package/templates/en/skills/llman-sdd-draft.md +5 -5
- package/templates/en/skills/llman-sdd-explore.md +5 -5
- package/templates/en/skills/llman-sdd-ff.md +7 -7
- package/templates/en/skills/llman-sdd-graph.md +10 -10
- package/templates/en/skills/llman-sdd-onboard.md +7 -7
- package/templates/en/skills/llman-sdd-propose.md +14 -14
- package/templates/en/skills/llman-sdd-quick.md +6 -6
- package/templates/en/skills/llman-sdd-research.md +2 -2
- package/templates/en/skills/llman-sdd-show.md +4 -4
- package/templates/en/skills/llman-sdd-specs-compact.md +6 -6
- package/templates/en/skills/llman-sdd-validate.md +5 -5
- package/templates/en/skills/llman-sdd-verify.md +7 -7
- package/templates/en/skills/llman-sdd-wayfinder.md +7 -7
- package/templates/en/units/migrate-prompt.md +5 -5
- package/templates/en/units/skills/ethics-governance.md +1 -1
- package/templates/en/units/skills/git-native-flow.md +2 -2
- package/templates/en/units/skills/stage-guard.md +1 -1
- package/templates/en/units/skills/structured-protocol.md +5 -5
- package/templates/en/units/skills/validation-hints.md +2 -2
- package/templates/en/units/workflow/archive-freeze-guidance.md +3 -3
- package/templates/shared/review.html +2 -2
- package/templates/zh-Hans/agents-root-stub.md +1 -1
- package/templates/zh-Hans/skills/llman-sdd-apply-cycle.md +7 -7
- package/templates/zh-Hans/skills/llman-sdd-apply.md +12 -12
- package/templates/zh-Hans/skills/llman-sdd-arch-review.md +2 -2
- package/templates/zh-Hans/skills/llman-sdd-archive.md +12 -12
- package/templates/zh-Hans/skills/llman-sdd-continue.md +8 -8
- package/templates/zh-Hans/skills/llman-sdd-draft.md +5 -5
- package/templates/zh-Hans/skills/llman-sdd-explore.md +5 -5
- package/templates/zh-Hans/skills/llman-sdd-ff.md +7 -7
- package/templates/zh-Hans/skills/llman-sdd-graph.md +10 -10
- package/templates/zh-Hans/skills/llman-sdd-onboard.md +7 -7
- package/templates/zh-Hans/skills/llman-sdd-propose.md +14 -14
- package/templates/zh-Hans/skills/llman-sdd-quick.md +6 -6
- package/templates/zh-Hans/skills/llman-sdd-research.md +2 -2
- package/templates/zh-Hans/skills/llman-sdd-show.md +4 -4
- package/templates/zh-Hans/skills/llman-sdd-specs-compact.md +6 -6
- package/templates/zh-Hans/skills/llman-sdd-validate.md +5 -5
- package/templates/zh-Hans/skills/llman-sdd-verify.md +7 -7
- package/templates/zh-Hans/skills/llman-sdd-wayfinder.md +7 -7
- package/templates/zh-Hans/units/migrate-prompt.md +5 -5
- package/templates/zh-Hans/units/skills/ethics-governance.md +1 -1
- package/templates/zh-Hans/units/skills/git-native-flow.md +2 -2
- package/templates/zh-Hans/units/skills/stage-guard.md +1 -1
- package/templates/zh-Hans/units/skills/structured-protocol.md +5 -5
- package/templates/zh-Hans/units/skills/validation-hints.md +2 -2
- package/templates/zh-Hans/units/workflow/archive-freeze-guidance.md +3 -3
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
## Ethics Governance
|
|
2
2
|
- `ethics.risk_level`:low——仅读写本仓库与 `llmanspec/`,无外发动作;正文另有声明时从其声明。
|
|
3
3
|
- `ethics.prohibited_actions`:违反正文「硬约束」的动作;未经用户明确要求的 push / PR / 外部上传。
|
|
4
|
-
- `ethics.required_evidence`:结论须有命令输出或文件路径佐证;门禁状态以 `llman
|
|
4
|
+
- `ethics.required_evidence`:结论须有命令输出或文件路径佐证;门禁状态以 `llman-sdd validate` 为准。
|
|
5
5
|
- `ethics.refusal_contract`:门禁 CRITICAL 未清零 → 拒绝进入下一阶段;自修复达上限 → 报告 blocker。
|
|
6
6
|
- `ethics.escalation_policy`:改动 SDD 合约/模板或执行不可逆动作前,暂停并请用户确认。
|
|
@@ -35,6 +35,6 @@ flowchart TB
|
|
|
35
35
|
|
|
36
36
|
硬规则:
|
|
37
37
|
1. **先** `change start` / `attach`(Branch binding / 分支绑定)进入 Full;**再**在绑定的非默认分支编辑 `llmanspec/specs/**` 并 commit(Specs landing / 合约落地)。
|
|
38
|
-
2. 无 live 合约变更时可设 frontmatter `needs_specs_change: false`。进入 apply 前 `llman
|
|
39
|
-
3. `change checkpoint` 已移除(无存档点概念:中途不必存档,`change finalize` 不要求干净树)。收口一律 `llman
|
|
38
|
+
2. 无 live 合约变更时可设 frontmatter `needs_specs_change: false`。进入 apply 前 `llman-sdd show <id> --json` 的 `readyToImplement` 须为 true(`Full ∧ gateChecks 全过`;specs-landed 项 = `specsLanded ∨ needs_specs_change=false`;一切范围 = 现算 merge-base,存储 `base_sha` 仅审计)。
|
|
39
|
+
3. `change checkpoint` 已移除(无存档点概念:中途不必存档,`change finalize` 不要求干净树)。收口一律 `llman-sdd change finalize <id>`:自动提交 `archive(sdd): <id>`(实现 diff + 改名一次提交);`--no-commit` 跳过自动提交(CI/手动历史场景)。change 分支上提交自由(分段或 finalize 单次收尾均可)。
|
|
40
40
|
4. **禁止**为过干净树门禁把 live specs commit 到默认分支;已 attach 时不要重复 `start`。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
## Context
|
|
2
|
-
- 先查状态再动手:change/spec 状态以 `llman
|
|
3
|
-
- 读 spec 全文前先用 `llman
|
|
2
|
+
- 先查状态再动手:change/spec 状态以 `llman-sdd show/list/validate` 输出为准。
|
|
3
|
+
- 读 spec 全文前先用 `llman-sdd context --task --paths` 定位相关 specs。
|
|
4
4
|
|
|
5
5
|
## Goal
|
|
6
6
|
- 本节命令达成一个可验证结果;结果路径与校验状态随报告输出。
|
|
@@ -10,8 +10,8 @@
|
|
|
10
10
|
- 改动保持最小;已知校验错误禁止强行继续。
|
|
11
11
|
|
|
12
12
|
## Workflow
|
|
13
|
-
- 每步以 `llman
|
|
14
|
-
- 命令细节见下方生成式命令参考或 `llman
|
|
13
|
+
- 每步以 `llman-sdd` 命令结果为事实来源;改动工件后必跑 `llman-sdd validate`。
|
|
14
|
+
- 命令细节见下方生成式命令参考或 `llman-sdd <cmd> --help`。
|
|
15
15
|
|
|
16
16
|
## Decision Policy
|
|
17
17
|
- 高影响歧义先澄清再继续;事实自己查证,只有决策问用户。
|
|
@@ -22,6 +22,6 @@
|
|
|
22
22
|
## Ethics Governance
|
|
23
23
|
- `ethics.risk_level`:low——仅读写本仓库与 `llmanspec/`,无外发动作;正文另有声明时从其声明。
|
|
24
24
|
- `ethics.prohibited_actions`:违反正文「硬约束」的动作;未经用户明确要求的 push / PR / 外部上传。
|
|
25
|
-
- `ethics.required_evidence`:结论须有命令输出或文件路径佐证;门禁状态以 `llman
|
|
25
|
+
- `ethics.required_evidence`:结论须有命令输出或文件路径佐证;门禁状态以 `llman-sdd validate` 为准。
|
|
26
26
|
- `ethics.refusal_contract`:门禁 CRITICAL 未清零 → 拒绝进入下一阶段;自修复达上限 → 报告 blocker。
|
|
27
27
|
- `ethics.escalation_policy`:改动 SDD 合约/模板或执行不可逆动作前,暂停并请用户确认。
|
|
@@ -15,10 +15,10 @@
|
|
|
15
15
|
- `@manual` 须与 `@human` 同用;禁止 `@human` 与 `@executable` 同场景。
|
|
16
16
|
|
|
17
17
|
3)遗留 `spec.toon`(`legacy spec.toon found ... run ... toon2features`):
|
|
18
|
-
运行 `llman
|
|
18
|
+
运行 `llman-sdd project migrate --kind toon2features --yes`,审阅 diff 后提交。
|
|
19
19
|
|
|
20
20
|
Git-native 护栏:
|
|
21
21
|
- **Branch binding** → **Specs landing**:先 `change start` / `attach`,再在绑定的非默认分支编辑 live `.feature` 并 commit。
|
|
22
|
-
- 锁定规则(报告制):改/删既有 `@human` 场景只出 WARNING,不阻断 validate / change finalize / change diff;报告按 `@req:<id>` 指明被改的是哪条规则。控制点:git 分支对比 + `llman
|
|
22
|
+
- 锁定规则(报告制):改/删既有 `@human` 场景只出 WARNING,不阻断 validate / change finalize / change diff;报告按 `@req:<id>` 指明被改的是哪条规则。控制点:git 分支对比 + `llman-sdd review` / `change diff` 的报告浮现。旧的锁定确认元数据(frontmatter `rules_touched` / `agent_acked`、`@agent` tag、`--yes` 的确认语义)已全部删除,无别名、无兼容层。
|
|
23
23
|
- apply 前须 `readyToImplement=true`(或 `needs_specs_change: false`)。收尾优先 `change finalize`。
|
|
24
24
|
- 勿使用 `change delta` / solidify / `*.feature.delta.toon`。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
## Archive 冷备引导
|
|
2
2
|
- 当 archive 目录增长过大时,使用冷备维护:
|
|
3
|
-
- 预览冻结候选:`llman
|
|
4
|
-
- 冻结旧归档:`llman
|
|
5
|
-
- 需要恢复时:`llman
|
|
3
|
+
- 预览冻结候选:`llman-sdd archive freeze --dry-run`
|
|
4
|
+
- 冻结旧归档:`llman-sdd archive freeze --before <YYYY-MM-DD> --keep-recent <N>`
|
|
5
|
+
- 需要恢复时:`llman-sdd archive thaw --change <YYYY-MM-DD-id>`
|
|
6
6
|
- freeze/thaw 仅用于日期归档目录(`YYYY-MM-DD-*`);建议保留少量最近目录不冻结。
|