scene-capability-engine 3.6.36 → 3.6.38
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/CHANGELOG.md +37 -12
- package/bin/scene-capability-engine.js +1 -1
- package/docs/331-poc-adaptation-roadmap.md +3 -3
- package/docs/command-reference.md +5 -5
- package/docs/faq.md +1 -1
- package/docs/interactive-customization/331-poc-sce-integration-checklist.md +3 -3
- package/docs/interactive-customization/moqui-interactive-template-playbook.md +4 -4
- package/docs/interactive-customization/phase-acceptance-evidence.md +2 -2
- package/docs/moqui-standard-rebuild-guide.md +6 -6
- package/docs/moqui-template-core-library-playbook.md +1 -1
- package/docs/release-checklist.md +50 -27
- package/docs/releases/README.md +2 -0
- package/docs/releases/v3.6.37.md +22 -0
- package/docs/releases/v3.6.38.md +19 -0
- package/docs/steering-governance.md +112 -0
- package/docs/steering-strategy-guide.md +7 -7
- package/docs/troubleshooting.md +1 -1
- package/docs/zh/release-checklist.md +40 -17
- package/docs/zh/releases/README.md +2 -0
- package/docs/zh/releases/v3.6.37.md +22 -0
- package/docs/zh/releases/v3.6.38.md +19 -0
- package/lib/auto/governance-summary.js +2 -2
- package/lib/commands/adopt.js +4 -4
- package/lib/commands/auto.js +3 -3
- package/lib/spec/bootstrap/context-collector.js +1 -1
- package/lib/steering/adoption-config.js +2 -2
- package/lib/steering/compliance-cache.js +2 -2
- package/lib/steering/steering-manager.js +4 -4
- package/lib/task/task-claimer.js +1 -2
- package/lib/workspace/multi/workspace-context-resolver.js +3 -3
- package/lib/workspace/multi/workspace-state-manager.js +0 -164
- package/lib/workspace/sce-tracking-audit.js +1 -1
- package/lib/workspace/takeover-baseline.js +1 -1
- package/package.json +4 -2
- package/template/.sce/README.md +1 -1
- package/template/.sce/steering/CORE_PRINCIPLES.md +21 -211
- package/template/.sce/steering/CURRENT_CONTEXT.md +9 -27
- package/template/.sce/steering/ENVIRONMENT.md +18 -32
- package/template/.sce/steering/RULES_GUIDE.md +16 -44
- package/template/.sce/steering/manifest.yaml +50 -0
- package/bin/kse.js +0 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
# Changelog
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [3.6.38] - 2026-03-12
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- Added `scripts/steering-content-audit.js` to audit steering content budgets, stale history, checklist leakage, stable-layer spec leakage, and non-canonical governance aliases.
|
|
14
|
+
- Added weekly scheduled workflow `.github/workflows/steering-hygiene.yml` and project guidance in `docs/steering-governance.md` for recurring steering review and cleanup.
|
|
15
|
+
- Added Spec `119-00-steering-self-governance` to document the steering self-governance model, audit scope, and CI rollout.
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
- Refactored `.sce/steering/` and `template/.sce/steering/` so baseline steering content stays lean, layered, and free of long history or task-state drift.
|
|
19
|
+
- Extended steering manifest governance metadata with file budgets, relocation targets, review cadence, and canonical mechanism rules.
|
|
20
|
+
- Wired `npm run audit:steering` into CI and `prepublishOnly`, making steering hygiene part of normal validation and release flow.
|
|
21
|
+
|
|
22
|
+
## [3.6.37] - 2026-03-12
|
|
23
|
+
|
|
24
|
+
### Added
|
|
25
|
+
- Added explicit release-environment guidance that clarifies this project publishes only from `v*` tag pushes, requires GitHub Actions secret `NPM_TOKEN`, and must bump `package.json.version` before tagging.
|
|
26
|
+
- Added release notes for `v3.6.37` under `docs/releases/` and `docs/zh/releases/`.
|
|
27
|
+
|
|
28
|
+
### Changed
|
|
29
|
+
- Removed legacy `kse` command/content references across active code paths, templates, fixtures, watch configuration, version metadata, steering, and release documentation without preserving compatibility aliases.
|
|
30
|
+
- Renamed the multi-workspace directory validation API from `isValidKseDirectory` to `isValidSceDirectory` and updated the related tests.
|
|
31
|
+
- Renamed historical spec/template fixture paths from `kse` identifiers to `sce` identifiers, including scene package template IDs and spec-scene override references.
|
|
32
|
+
- Updated the branding consistency gate to fail on legacy `kse` aliases and stale social handles instead of allowing them to linger in tracked content.
|
|
33
|
+
- Fixed `scripts/git-managed-gate.js` on Windows by falling back to `git.cmd` / `git.exe` resolution, so `prepublishOnly` and release preflight no longer misreport a valid repository as missing git metadata.
|
|
34
|
+
|
|
10
35
|
### Added
|
|
11
36
|
- Added `lib/auto/handoff-release-gate-history-loaders-service.js` for release-gate history entry normalization, report discovery, seed loading, and merge selection.
|
|
12
37
|
- Added `lib/auto/handoff-run-service.js` for full auto-handoff orchestration outside the command layer.
|
|
@@ -278,7 +303,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
278
303
|
- `state-reconcile-<tag>.json`
|
|
279
304
|
|
|
280
305
|
### Changed
|
|
281
|
-
- Release workflow state reconciliation gate is now enforce-by-default (`
|
|
306
|
+
- Release workflow state reconciliation gate is now enforce-by-default (`SCE_RELEASE_STATE_MIGRATION_ENFORCE` defaults to `true`).
|
|
282
307
|
- Release workflow Node runtime updated to `22.x` so sqlite-backed reconciliation can run in release pipeline.
|
|
283
308
|
|
|
284
309
|
## [3.6.7] - 2026-03-05
|
|
@@ -856,7 +881,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
856
881
|
- **Interactive runtime policy + work-order default pipeline**: Added `interactive-runtime-policy-evaluate` and `interactive-work-order-build`, integrated both into `interactive-customization-loop` and `interactive-flow` (including `sce scene interactive-loop/interactive-flow` passthrough), with default `runtime_mode=ops-fix`, `runtime_environment=staging`, runtime non-allow fail gate option, and auditable work-order artifacts.
|
|
857
882
|
- **Release weekly ops closed-loop summary**: Added `node scripts/release-ops-weekly-summary.js` (npm alias `npm run report:release-ops-weekly`) to aggregate handoff evidence, release-gate history, interactive governance, and matrix signals into one weekly risk/recommendation card (`weekly-ops-summary.json|.md`).
|
|
858
883
|
- **Release workflow weekly ops asset publication**: `release.yml` now exports and publishes `weekly-ops-summary-<tag>.json|.md` alongside governance snapshot and Moqui release evidence assets.
|
|
859
|
-
- **Release weekly ops hard gate**: Added `node scripts/release-weekly-ops-gate.js` (npm alias `npm run gate:release-ops-weekly`) and wired release workflow defaults to block publish when weekly ops summary risk exceeds `medium` (configurable via `
|
|
884
|
+
- **Release weekly ops hard gate**: Added `node scripts/release-weekly-ops-gate.js` (npm alias `npm run gate:release-ops-weekly`) and wired release workflow defaults to block publish when weekly ops summary risk exceeds `medium` (configurable via `SCE_RELEASE_WEEKLY_OPS_*` variables).
|
|
860
885
|
- **Unified weekly+drift remediation bundle**: Added `node scripts/release-risk-remediation-bundle.js` (npm alias `npm run report:release-risk-remediation`) and wired release workflow to publish `release-risk-remediation-<tag>.json|.md|.lines` assets derived from merged gate signals.
|
|
861
886
|
- **Release asset integrity hard gate**: Added `node scripts/release-asset-integrity-check.js` (npm alias `npm run gate:release-asset-integrity`) and wired `release.yml` to block publish on missing/empty core release-evidence assets, while exporting `release-asset-integrity-<tag>.json|.md`.
|
|
862
887
|
- **Interactive dialogue governance baseline**: Added `node scripts/interactive-dialogue-governance.js`, baseline policy `docs/interactive-customization/dialogue-governance-policy-baseline.json`, and loop/flow integration so embedded assistants emit `allow|clarify|deny` dialogue decisions with clarification prompts before planning.
|
|
@@ -878,7 +903,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
878
903
|
- **Interactive matrix signal closed-loop defaultization**: `interactive-flow` now runs a default matrix snapshot stage (`moqui-template-baseline-report`) after loop execution, persists session matrix artifacts, appends `.sce/reports/interactive-matrix-signals.jsonl`, and exposes matrix controls (`--no-matrix`, thresholds, compare baseline, signal path, fail-on-portfolio/regression/error) in both script and `sce scene interactive-flow`.
|
|
879
904
|
- **Interactive approval workflow state machine**: Added `node scripts/interactive-approval-workflow.js` (status alias `npm run report:interactive-approval-status`) covering `draft/submitted/approved/rejected/executed/verified/archived` transitions, with high-risk execute blocking and append-only approval event audit JSONL.
|
|
880
905
|
- **Interactive Moqui adapter stage-C baseline**: Added `lib/interactive-customization/moqui-interactive-adapter.js` plus `node scripts/interactive-moqui-adapter.js` (alias `npm run report:interactive-adapter-capabilities`) to implement unified adapter contract `capabilities/plan/validate/apply/rollback`, low-risk one-click apply (`low-risk-apply`), policy-aware controlled execution, and append-only execution records with validation snapshot + rollback reference.
|
|
881
|
-
- **Interactive template matrix stage-D baseline**: Added `
|
|
906
|
+
- **Interactive template matrix stage-D baseline**: Added `sce.scene--moqui-interactive-customization-loop--0.1.0` scene package assets (scene-package/scene manifest/template manifest), plus template sedimentation playbook, adapter extension contract schema/sample, and Domain_Pack extension flow docs for cross-stack replication.
|
|
882
907
|
- **Interactive governance observability + alerting**: Added `node scripts/interactive-governance-report.js` (alias `npm run report:interactive-governance`) to compute adoption/success/rollback/security-intercept/satisfaction KPIs, apply threshold alerts, and emit JSON/Markdown governance reports with `--fail-on-alert` gate behavior.
|
|
883
908
|
- **Interactive governance matrix telemetry integration**: `interactive-governance-report` now consumes matrix signals by default, computes matrix pass/regression/stage-error metrics, and enforces threshold alerts for matrix trend degradation.
|
|
884
909
|
- **Matrix regression gate + remediation queue automation**: Added `scripts/matrix-regression-gate.js` and `scripts/moqui-matrix-remediation-queue.js` with npm aliases (`gate:matrix-regression`, `report:matrix-remediation-queue`) so CI/release can enforce configurable regression limits and export close-loop remediation lines from matrix regressions.
|
|
@@ -901,8 +926,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
901
926
|
- **Capability matrix recommendations upgrade**: `sce auto handoff capability-matrix` now also recommends baseline-driven phased one-shot remediation commands when Moqui matrix regressions appear in baseline trend comparison.
|
|
902
927
|
- **Handoff profile policy abstraction (`default|moqui|enterprise`)**: `sce auto handoff run` and `sce auto handoff capability-matrix` now support `--profile` preset policies with explicit option override precedence, plus external integration contract guidance in `docs/handoff-profile-integration-guide.md`.
|
|
903
928
|
- **Regression/governance recommendation unification**: `sce auto handoff regression`, `sce auto governance stats`, and governance close-loop release-gate blockers now include baseline-driven phased one-shot remediation guidance for Moqui matrix regressions.
|
|
904
|
-
- **Release workflow matrix evidence hardening**: `test.yml` and `release.yml` now archive matrix/governance artifacts by default and support configurable matrix regression hard-gate controls via `
|
|
905
|
-
- **Release workflow Moqui summary alignment**: `release.yml` now explicitly generates and publishes `moqui-release-summary.{json,md}` from baseline + interactive governance + evidence inputs, with optional hard-gate flag `
|
|
929
|
+
- **Release workflow matrix evidence hardening**: `test.yml` and `release.yml` now archive matrix/governance artifacts by default and support configurable matrix regression hard-gate controls via `SCE_MATRIX_REGRESSION_GATE_ENFORCE` + `SCE_MATRIX_REGRESSION_GATE_MAX`.
|
|
930
|
+
- **Release workflow Moqui summary alignment**: `release.yml` now explicitly generates and publishes `moqui-release-summary.{json,md}` from baseline + interactive governance + evidence inputs, with optional hard-gate flag `SCE_MOQUI_RELEASE_SUMMARY_ENFORCE`.
|
|
906
931
|
- **Release governance snapshot standalone assets**: Added `scripts/release-governance-snapshot-export.js` and wired `release.yml` to publish `governance-snapshot-<tag>.json|.md` as independent governance audit artifacts (with unavailable placeholders when evidence summary is missing).
|
|
907
932
|
- **331-poc integration checklist baseline**: Added `docs/interactive-customization/331-poc-sce-integration-checklist.md` to define minimal runtime contract, default commands, gate defaults, and pass criteria for Moqui + SCE deployment.
|
|
908
933
|
- **Interactive feedback ingestion helper**: Added `node scripts/interactive-feedback-log.js` (alias `npm run log:interactive-feedback`) to append structured business-user feedback events into `.sce/reports/interactive-user-feedback.jsonl` for governance sample coverage and trend stability.
|
|
@@ -1285,7 +1310,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1285
1310
|
## [1.39.0] - 2026-02-10
|
|
1286
1311
|
|
|
1287
1312
|
### Added
|
|
1288
|
-
- **Moqui ERP Adapter**: Integrate Moqui ERP instance into
|
|
1313
|
+
- **Moqui ERP Adapter**: Integrate Moqui ERP instance into SCE scene runtime
|
|
1289
1314
|
- `MoquiClient` — HTTP client with JWT auth lifecycle (login, refresh, re-login, logout), retry logic using Node.js built-in `http`/`https`
|
|
1290
1315
|
- `MoquiAdapter` — Binding handler for `spec.erp.*` and `moqui.*` refs, entity CRUD, service invocation, screen discovery
|
|
1291
1316
|
- `sce scene connect` — Test connectivity and authentication to Moqui ERP instance
|
|
@@ -2089,7 +2114,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
2089
2114
|
- Template management: `sce templates update`, `sce templates cache`, `sce templates guide`
|
|
2090
2115
|
- Custom sources: `sce templates add-source <name> <url>`, `sce templates remove-source <name>`, `sce templates sources`
|
|
2091
2116
|
- Create Spec from template: `sce spec create <name> --template <template-id>`
|
|
2092
|
-
- Local caching for offline use (~/.
|
|
2117
|
+
- Local caching for offline use (~/.sce/templates/)
|
|
2093
2118
|
- Multi-source support with conflict resolution (source:template-id format)
|
|
2094
2119
|
- Automatic variable substitution ({{SPEC_NAME}}, {{DATE}}, {{AUTHOR}}, etc.)
|
|
2095
2120
|
- YAML frontmatter removal in applied templates
|
|
@@ -2186,10 +2211,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
2186
2211
|
- **Multi-user support**: Detects and respects `contexts/` multi-user collaboration setup
|
|
2187
2212
|
- Differential backup: Only backs up violating files/directories (not entire .sce/)
|
|
2188
2213
|
- Backup location: `.sce/backups/steering-cleanup-{timestamp}/`
|
|
2189
|
-
- Version-based caching (~/.
|
|
2214
|
+
- Version-based caching (~/.sce/steering-check-cache.json) to avoid repeated checks
|
|
2190
2215
|
- Performance target: <50ms per check
|
|
2191
2216
|
- Clear progress messages during auto-fix
|
|
2192
|
-
- Bypass options: `--skip-steering-check` flag and `
|
|
2217
|
+
- Bypass options: `--skip-steering-check` flag and `SCE_SKIP_STEERING_CHECK` environment variable
|
|
2193
2218
|
- Force check option: `--force-steering-check` flag
|
|
2194
2219
|
- Comprehensive documentation in `.sce/README.md`
|
|
2195
2220
|
|
|
@@ -2227,7 +2252,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
2227
2252
|
- **Critical Principle**: Added "测试失败零容忍原则" (Zero Tolerance for Test Failures) to CORE_PRINCIPLES.md
|
|
2228
2253
|
- Emphasizes "千里之堤溃于蚁穴" - never ignore any test failure
|
|
2229
2254
|
- Provides clear execution standards and rationale
|
|
2230
|
-
- Aligns with Ultrawork spirit and
|
|
2255
|
+
- Aligns with Ultrawork spirit and SCE core values
|
|
2231
2256
|
|
|
2232
2257
|
### Changed
|
|
2233
2258
|
- **Documentation Optimization**: Refactored CORE_PRINCIPLES.md for clarity and value density
|
|
@@ -2414,7 +2439,7 @@ rm -rf .sce/steering/workspaces
|
|
|
2414
2439
|
- `sce workspace remove <name>` - Remove workspace from registry
|
|
2415
2440
|
- `sce workspace info [name]` - Display workspace details
|
|
2416
2441
|
- **Data Atomicity Architecture**
|
|
2417
|
-
- Single source of truth: `~/.
|
|
2442
|
+
- Single source of truth: `~/.sce/workspace-state.json`
|
|
2418
2443
|
- Atomic operations for all workspace state changes
|
|
2419
2444
|
- Automatic migration from legacy format
|
|
2420
2445
|
- Cross-platform path handling with PathUtils
|
|
@@ -1118,7 +1118,7 @@ async function updateProjectConfig(projectName) {
|
|
|
1118
1118
|
const skipAutoTakeover = isTakeoverAutoApplySkippedCommand(args);
|
|
1119
1119
|
const skipCheck = isNoMutationCommand(args) ||
|
|
1120
1120
|
args.includes('--skip-steering-check') ||
|
|
1121
|
-
process.env.
|
|
1121
|
+
process.env.SCE_SKIP_STEERING_CHECK === '1';
|
|
1122
1122
|
const forceCheck = args.includes('--force-steering-check');
|
|
1123
1123
|
|
|
1124
1124
|
if (!isLegacyAllowlistedCommand) {
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
- tag 发布时自动将 release notes 草稿、evidence 审阅 markdown、summary JSON 作为 GitHub Release 资产上传。
|
|
55
55
|
- 无 evidence 时至少上传 fallback notes,保证发布资产结构稳定。
|
|
56
56
|
20. 新增可配置发布门禁(workflow 级):
|
|
57
|
-
- 支持通过 `
|
|
57
|
+
- 支持通过 `SCE_RELEASE_*` 仓库变量配置 success rate/risk/ontology 阈值。
|
|
58
58
|
- 支持 advisory(默认)与 enforce(阻断发布)两种模式,且门禁在 `npm publish` 前执行。
|
|
59
59
|
21. 新增 release gate 审计产物:
|
|
60
60
|
- 每次 tag 发布生成 `release-gate-<tag>.json`,记录阈值、观测信号、违规项和判定结果。
|
|
@@ -87,10 +87,10 @@
|
|
|
87
87
|
- 自动检测连续 gate 失败、高风险占比过高、短期风险占比上升。
|
|
88
88
|
- 在 Release Notes 中显式给出 drift alerts,提前暴露质量恶化趋势。
|
|
89
89
|
31. 漂移告警阈值参数化:
|
|
90
|
-
- 支持通过 `
|
|
90
|
+
- 支持通过 `SCE_RELEASE_DRIFT_*` 仓库变量调节 fail streak/high-risk share/delta 阈值。
|
|
91
91
|
- 不同项目可按发布策略调整灵敏度,减少误报或漏报。
|
|
92
92
|
32. 漂移告警阻断模式:
|
|
93
|
-
- 新增 `
|
|
93
|
+
- 新增 `SCE_RELEASE_DRIFT_ENFORCE`,可在漂移告警触发时阻断发布。
|
|
94
94
|
- 保留默认 advisory 模式,确保历史数据不足时不误阻断。
|
|
95
95
|
33. 漂移告警审计写回 gate 报告:
|
|
96
96
|
- `release.yml` 将 drift 评估结果回写到 `release-gate-<tag>.json` 的 `drift` 字段。
|
|
@@ -1574,7 +1574,7 @@ Moqui template library lexicon audit (script-level governance helper):
|
|
|
1574
1574
|
- `node scripts/moqui-lexicon-audit.js [--manifest <path>] [--template-dir <path>] [--lexicon <path>] [--out <path>] [--markdown-out <path>] [--fail-on-gap] [--json]`: audit manifest/template capability names against canonical Moqui lexicon; reports unknown aliases and uncovered expected capabilities.
|
|
1575
1575
|
- Expected capability scope uses `manifest.capabilities` first; when empty, it infers canonical expected capabilities from `manifest.templates` and emits `expected_scope` metadata (`source`, `inferred_*`, `unresolved_templates`).
|
|
1576
1576
|
- By default, template capability auditing is scoped to `manifest.templates` (when matched), reducing noise from unrelated templates.
|
|
1577
|
-
- Template scope matching normalizes `sce.scene--*` / `
|
|
1577
|
+
- Template scope matching normalizes `sce.scene--*` / `sce.scene--*` prefixes, so renamed template namespaces still map correctly.
|
|
1578
1578
|
|
|
1579
1579
|
Moqui release summary helper (script-level consolidated gate view):
|
|
1580
1580
|
- `node scripts/moqui-release-summary.js [--evidence <path>] [--baseline <path>] [--lexicon <path>] [--capability-matrix <path>] [--interactive-governance <path>] [--matrix-remediation-plan <path>] [--out <path>] [--markdown-out <path>] [--fail-on-gate-fail] [--json]`: merge handoff release-evidence + baseline + lexicon + capability-matrix + interactive-governance into one Moqui release gate summary (`passed | failed | incomplete`) with executable remediation recommendations.
|
|
@@ -2126,10 +2126,10 @@ Release workflow default:
|
|
|
2126
2126
|
- Runs interactive flow smoke (`npm run test:interactive-flow-smoke`) in test/release test jobs.
|
|
2127
2127
|
- Runs interactive governance gate by default (`interactive-governance-report --period weekly --fail-on-alert`) in test and release pipelines.
|
|
2128
2128
|
- Evaluates matrix regression gate in CI/release with configurable policy:
|
|
2129
|
-
- `
|
|
2130
|
-
- `
|
|
2129
|
+
- `SCE_MATRIX_REGRESSION_GATE_ENFORCE` (`true|false`, default advisory/disabled)
|
|
2130
|
+
- `SCE_MATRIX_REGRESSION_GATE_MAX` (default `0`)
|
|
2131
2131
|
- Optional release summary hard-gate:
|
|
2132
|
-
- `
|
|
2132
|
+
- `SCE_MOQUI_RELEASE_SUMMARY_ENFORCE` (`true|false`, default advisory/disabled)
|
|
2133
2133
|
- Publishes `moqui-template-baseline.json` + `moqui-template-baseline.md` as release assets.
|
|
2134
2134
|
- Publishes `moqui-release-summary.json` + `moqui-release-summary.md` as release review assets.
|
|
2135
2135
|
- Publishes `interactive-governance-<tag>.json` + `interactive-governance-<tag>.md` as release evidence assets.
|
|
@@ -2138,7 +2138,7 @@ Release workflow default:
|
|
|
2138
2138
|
- Evaluates weekly ops risk gate by default (`release-weekly-ops-gate`; default block when `risk > medium` or summary missing).
|
|
2139
2139
|
- Publishes `release-risk-remediation-<tag>.json|.md|.lines` derived from unified weekly+drift gate signals.
|
|
2140
2140
|
- Evaluates and publishes release asset integrity audit (`release-asset-integrity-<tag>.json|.md`) before `npm publish`.
|
|
2141
|
-
- Enforces baseline portfolio gate by default (`
|
|
2141
|
+
- Enforces baseline portfolio gate by default (`SCE_MOQUI_BASELINE_ENFORCE` defaults to `true` when unset).
|
|
2142
2142
|
|
|
2143
2143
|
### Moqui ERP Integration
|
|
2144
2144
|
|
package/docs/faq.md
CHANGED
|
@@ -682,7 +682,7 @@ sce spec bootstrap --name 03-00-ci-cd-pipeline --non-interactive
|
|
|
682
682
|
**Ask the community:**
|
|
683
683
|
- GitHub Discussions: https://github.com/heguangyong/scene-capability-engine/discussions
|
|
684
684
|
- Discord: [Join our Discord](https://discord.gg/sce)
|
|
685
|
-
- Twitter: [@
|
|
685
|
+
- Twitter: [@sce_dev](https://twitter.com/sce_dev)
|
|
686
686
|
|
|
687
687
|
**Report issues:**
|
|
688
688
|
- GitHub Issues: https://github.com/heguangyong/scene-capability-engine/issues
|
|
@@ -71,9 +71,9 @@ node scripts/matrix-regression-gate.js \
|
|
|
71
71
|
|
|
72
72
|
Recommended GitHub Variables:
|
|
73
73
|
|
|
74
|
-
- `
|
|
75
|
-
- `
|
|
76
|
-
- `
|
|
74
|
+
- `SCE_MATRIX_REGRESSION_GATE_ENFORCE=true`
|
|
75
|
+
- `SCE_MATRIX_REGRESSION_GATE_MAX=0`
|
|
76
|
+
- `SCE_MOQUI_RELEASE_SUMMARY_ENFORCE=true` (optional hard gate for release summary `failed` state)
|
|
77
77
|
|
|
78
78
|
Security baseline:
|
|
79
79
|
|
|
@@ -20,10 +20,10 @@ This playbook defines how to turn validated Moqui interactive customization flow
|
|
|
20
20
|
|
|
21
21
|
Primary package for the interactive loop:
|
|
22
22
|
|
|
23
|
-
- `.sce/templates/scene-packages/
|
|
24
|
-
- `.sce/templates/scene-packages/
|
|
25
|
-
- `.sce/templates/scene-packages/
|
|
26
|
-
- `.sce/templates/scene-packages/
|
|
23
|
+
- `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene-package.json`
|
|
24
|
+
- `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene.template.yaml`
|
|
25
|
+
- `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/custom/scene.yaml`
|
|
26
|
+
- `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/template.manifest.json`
|
|
27
27
|
|
|
28
28
|
## Capability Matrix Mapping
|
|
29
29
|
|
|
@@ -90,8 +90,8 @@ Scope:
|
|
|
90
90
|
|
|
91
91
|
Evidence:
|
|
92
92
|
|
|
93
|
-
- `.sce/templates/scene-packages/
|
|
94
|
-
- `.sce/templates/scene-packages/
|
|
93
|
+
- `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene-package.json`
|
|
94
|
+
- `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene.template.yaml`
|
|
95
95
|
- `docs/interactive-customization/moqui-interactive-template-playbook.md`
|
|
96
96
|
- `docs/interactive-customization/adapter-extension-contract.schema.json`
|
|
97
97
|
- `docs/interactive-customization/domain-pack-extension-flow.md`
|
|
@@ -84,12 +84,12 @@ Defaults: `ready>=6`, `partial<=0`, `gap<=0`.
|
|
|
84
84
|
|
|
85
85
|
## Default Moqui Template Matrix
|
|
86
86
|
|
|
87
|
-
- `
|
|
88
|
-
- `
|
|
89
|
-
- `
|
|
90
|
-
- `
|
|
91
|
-
- `
|
|
92
|
-
- `
|
|
87
|
+
- `sce.scene--moqui-entity-model-core--0.1.0`
|
|
88
|
+
- `sce.scene--moqui-service-contract-core--0.1.0`
|
|
89
|
+
- `sce.scene--moqui-screen-flow-core--0.1.0`
|
|
90
|
+
- `sce.scene--moqui-form-interaction-core--0.1.0`
|
|
91
|
+
- `sce.scene--moqui-rule-decision-core--0.1.0`
|
|
92
|
+
- `sce.scene--moqui-page-copilot-dialog--0.1.0`
|
|
93
93
|
|
|
94
94
|
## Next Step for Business Project
|
|
95
95
|
|
|
@@ -201,7 +201,7 @@ sce auto close-loop-batch .sce/auto/ontology-remediation.lines --format lines --
|
|
|
201
201
|
|
|
202
202
|
Stage-D baseline package for the interactive business customization loop:
|
|
203
203
|
|
|
204
|
-
- `
|
|
204
|
+
- `sce.scene--moqui-interactive-customization-loop--0.1.0`
|
|
205
205
|
|
|
206
206
|
This package captures:
|
|
207
207
|
|
|
@@ -115,41 +115,48 @@ Verify:
|
|
|
115
115
|
|
|
116
116
|
Ensure:
|
|
117
117
|
|
|
118
|
+
- Release automation is tag-driven, not commit-driven:
|
|
119
|
+
- `.github/workflows/release.yml` only triggers on `push.tags: v*`
|
|
120
|
+
- plain `git push` runs normal CI and does not publish npm/GitHub release
|
|
121
|
+
- GitHub Actions publish prerequisites are in place:
|
|
122
|
+
- repository secret `NPM_TOKEN` must exist and remain valid for `npm publish --access public`
|
|
123
|
+
- `GITHUB_TOKEN` is used by workflow for release asset/readback steps
|
|
118
124
|
- `package.json` version is correct.
|
|
125
|
+
- `package.json` version must be greater than the currently published npm version.
|
|
119
126
|
- `CHANGELOG.md` includes release-relevant entries.
|
|
120
127
|
- Release notes draft exists (for example `docs/releases/vX.Y.Z.md`).
|
|
121
128
|
- Optional: configure release evidence gate with repository variables (`Settings -> Secrets and variables -> Actions -> Variables`):
|
|
122
|
-
- `
|
|
123
|
-
- `
|
|
124
|
-
- `
|
|
125
|
-
- `
|
|
126
|
-
- `
|
|
127
|
-
- `
|
|
128
|
-
- `
|
|
129
|
-
- `
|
|
130
|
-
- `
|
|
129
|
+
- `SCE_RELEASE_GATE_ENFORCE`: `true|false` (default advisory, non-blocking)
|
|
130
|
+
- `SCE_RELEASE_GATE_REQUIRE_EVIDENCE`: require `handoff-runs.json` summary
|
|
131
|
+
- `SCE_RELEASE_GATE_REQUIRE_GATE_PASS`: require evidence gate `passed=true` (default true when evidence exists)
|
|
132
|
+
- `SCE_RELEASE_GATE_MIN_SPEC_SUCCESS_RATE`: minimum allowed success rate percent
|
|
133
|
+
- `SCE_RELEASE_GATE_MAX_RISK_LEVEL`: `low|medium|high|unknown` (default `unknown`)
|
|
134
|
+
- `SCE_RELEASE_GATE_MAX_UNMAPPED_RULES`: maximum allowed unmapped ontology business rules
|
|
135
|
+
- `SCE_RELEASE_GATE_MAX_UNDECIDED_DECISIONS`: maximum allowed undecided ontology decisions
|
|
136
|
+
- `SCE_RELEASE_GATE_REQUIRE_SCENE_BATCH_PASS`: require scene package publish-batch gate passed (`true|false`, default `true`)
|
|
137
|
+
- `SCE_RELEASE_GATE_MAX_SCENE_BATCH_FAILURES`: maximum allowed scene package batch failure count (default `0`)
|
|
131
138
|
- Optional: tune release drift alerts in release notes:
|
|
132
139
|
- Drift evaluation is executed by `scripts/release-drift-evaluate.js` in CI (history load, alert calc, gate report writeback, enforce exit code).
|
|
133
|
-
- `
|
|
134
|
-
- `
|
|
135
|
-
- `
|
|
136
|
-
- `
|
|
137
|
-
- `
|
|
138
|
-
- `
|
|
139
|
-
- `
|
|
140
|
+
- `SCE_RELEASE_DRIFT_ENFORCE`: `true|false` (default `false`), block publish when drift alerts are triggered
|
|
141
|
+
- `SCE_RELEASE_DRIFT_FAIL_STREAK_MIN`: minimum consecutive failed gates to trigger alert (default `2`)
|
|
142
|
+
- `SCE_RELEASE_DRIFT_HIGH_RISK_SHARE_MIN_PERCENT`: minimum high-risk share in latest 5 versions (default `60`)
|
|
143
|
+
- `SCE_RELEASE_DRIFT_HIGH_RISK_SHARE_DELTA_MIN_PERCENT`: minimum short-vs-long high-risk share delta (default `25`)
|
|
144
|
+
- `SCE_RELEASE_DRIFT_PREFLIGHT_BLOCK_RATE_MIN_PERCENT`: minimum release preflight blocked rate in latest 5 known runs (default `40`)
|
|
145
|
+
- `SCE_RELEASE_DRIFT_HARD_GATE_BLOCK_STREAK_MIN`: minimum consecutive hard-gate preflight blocked streak (latest window, default `2`)
|
|
146
|
+
- `SCE_RELEASE_DRIFT_PREFLIGHT_UNAVAILABLE_STREAK_MIN`: minimum consecutive release preflight unavailable streak (latest window, default `2`)
|
|
140
147
|
- Optional: tune weekly ops release gate:
|
|
141
|
-
- `
|
|
142
|
-
- `
|
|
143
|
-
- `
|
|
144
|
-
- `
|
|
145
|
-
- `
|
|
146
|
-
- `
|
|
147
|
-
- `
|
|
148
|
+
- `SCE_RELEASE_WEEKLY_OPS_ENFORCE`: `true|false` (default `true`)
|
|
149
|
+
- `SCE_RELEASE_WEEKLY_OPS_REQUIRE_SUMMARY`: require weekly summary artifact (`true|false`, default `true`)
|
|
150
|
+
- `SCE_RELEASE_WEEKLY_OPS_MAX_RISK_LEVEL`: `low|medium|high|unknown` (default `medium`)
|
|
151
|
+
- `SCE_RELEASE_WEEKLY_OPS_MAX_GOVERNANCE_BREACHES`: optional max breach count
|
|
152
|
+
- `SCE_RELEASE_WEEKLY_OPS_MAX_AUTHORIZATION_TIER_BLOCK_RATE_PERCENT`: max authorization-tier deny/review block rate percent (default `40`)
|
|
153
|
+
- `SCE_RELEASE_WEEKLY_OPS_MAX_DIALOGUE_AUTHORIZATION_BLOCK_RATE_PERCENT`: max dialogue-authorization block rate percent (default `40`)
|
|
154
|
+
- `SCE_RELEASE_WEEKLY_OPS_MAX_MATRIX_REGRESSION_RATE_PERCENT`: optional max regression-positive rate percent
|
|
148
155
|
- Invalid numeric values are reported as gate `config_warnings` and default threshold fallback is applied.
|
|
149
156
|
- Optional: tune release asset integrity gate:
|
|
150
|
-
- `
|
|
151
|
-
- `
|
|
152
|
-
- `
|
|
157
|
+
- `SCE_RELEASE_ASSET_INTEGRITY_ENFORCE`: `true|false` (default `true`)
|
|
158
|
+
- `SCE_RELEASE_ASSET_INTEGRITY_REQUIRE_NON_EMPTY`: `true|false` (default `true`)
|
|
159
|
+
- `SCE_RELEASE_ASSET_INTEGRITY_REQUIRED_FILES`: override required asset list (comma-separated, supports `{tag}`)
|
|
153
160
|
- Optional release-asset 0-byte guard (enabled in workflow by default):
|
|
154
161
|
- `scripts/release-asset-nonempty-normalize.js` auto-fills placeholder content for optional assets such as `.lines` and `.jsonl` before GitHub Release upload.
|
|
155
162
|
- Local dry-run example:
|
|
@@ -159,4 +166,20 @@ Ensure:
|
|
|
159
166
|
- Optional local dry-run for gate history index artifact:
|
|
160
167
|
- `sce auto handoff gate-index --dir .sce/reports/release-evidence --out .sce/reports/release-evidence/release-gate-history.json --json`
|
|
161
168
|
|
|
162
|
-
Then proceed with your release workflow
|
|
169
|
+
Then proceed with your release workflow:
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
# 1. bump version + commit first
|
|
173
|
+
# 2. push branch changes
|
|
174
|
+
git push origin main
|
|
175
|
+
|
|
176
|
+
# 3. create and push release tag
|
|
177
|
+
git tag vX.Y.Z
|
|
178
|
+
git push origin vX.Y.Z
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Expected:
|
|
182
|
+
|
|
183
|
+
- `git push origin main` only runs normal CI.
|
|
184
|
+
- `git push origin vX.Y.Z` triggers GitHub Actions `Release` workflow.
|
|
185
|
+
- workflow publishes npm package and creates GitHub Release if all release gates pass.
|
package/docs/releases/README.md
CHANGED
|
@@ -9,6 +9,8 @@ This directory stores release-facing documents:
|
|
|
9
9
|
## Archived Versions
|
|
10
10
|
|
|
11
11
|
- [Release checklist](../release-checklist.md)
|
|
12
|
+
- [v3.6.38 release notes](./v3.6.38.md)
|
|
13
|
+
- [v3.6.37 release notes](./v3.6.37.md)
|
|
12
14
|
- [v1.46.2 release notes](./v1.46.2.md) (historical)
|
|
13
15
|
- [v1.46.2 validation report](./v1.46.2-validation.md) (historical)
|
|
14
16
|
- [GitHub Releases](https://github.com/heguangyong/scene-capability-engine/releases) (latest)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# v3.6.37 Release Notes
|
|
2
|
+
|
|
3
|
+
Release date: 2026-03-12
|
|
4
|
+
|
|
5
|
+
## Highlights
|
|
6
|
+
|
|
7
|
+
- Removed legacy `kse` command/content references from active runtime paths, templates, fixtures, and release-facing documentation without keeping a compatibility bridge.
|
|
8
|
+
- Standardized scene package/template metadata and fixture paths on `sce` naming so generated artifacts no longer leak old `kse` identifiers.
|
|
9
|
+
- Fixed Windows release preflight for `scripts/git-managed-gate.js` by adding `git.cmd` / `git.exe` fallback resolution.
|
|
10
|
+
- Documented the actual release trigger model: only `v*` tag pushes trigger GitHub Actions release publishing, and workflow publishing depends on repository secret `NPM_TOKEN`.
|
|
11
|
+
|
|
12
|
+
## Verification
|
|
13
|
+
|
|
14
|
+
- `npx jest tests/unit/workspace/workspace-context-resolver.test.js tests/unit/workspace/workspace-state-manager.test.js tests/unit/steering/compliance-cache.test.js tests/unit/scripts/moqui-lexicon-audit.test.js tests/unit/scripts/moqui-standard-rebuild.test.js tests/unit/scripts/moqui-metadata-extract.test.js tests/unit/task/task-claimer.test.js tests/unit/commands/auto.test.js tests/integration/auto-close-loop-cli.integration.test.js --runInBand`
|
|
15
|
+
- `node scripts/check-branding-consistency.js`
|
|
16
|
+
- `npx jest tests/unit/scripts/git-managed-gate.test.js --runInBand`
|
|
17
|
+
|
|
18
|
+
## Release Notes
|
|
19
|
+
|
|
20
|
+
- Plain `git push` does not publish this project.
|
|
21
|
+
- Release automation starts only when `git push origin vX.Y.Z` triggers `.github/workflows/release.yml`.
|
|
22
|
+
- GitHub Actions publish requires repository secret `NPM_TOKEN`.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# v3.6.38 Release Notes
|
|
2
|
+
|
|
3
|
+
Release date: 2026-03-12
|
|
4
|
+
|
|
5
|
+
## Highlights
|
|
6
|
+
|
|
7
|
+
- Added a steering self-governance audit that checks content budgets, stale history, checklist leakage, stable-layer Spec leakage, and non-canonical governance aliases.
|
|
8
|
+
- Refactored the live steering baseline and template steering files so they stay lean, layered, and easier to refresh over time.
|
|
9
|
+
- Added recurring steering hygiene enforcement in normal CI, `prepublishOnly`, and a weekly GitHub Actions schedule.
|
|
10
|
+
|
|
11
|
+
## Verification
|
|
12
|
+
|
|
13
|
+
- `npm run audit:steering`
|
|
14
|
+
- `npx jest tests/unit/steering/steering-compliance-checker.test.js tests/unit/scripts/steering-content-audit.test.js tests/unit/scripts/git-managed-gate.test.js --runInBand`
|
|
15
|
+
|
|
16
|
+
## Release Notes
|
|
17
|
+
|
|
18
|
+
- Steering is now expected to self-correct through recurring audit rather than rely on ad hoc cleanup.
|
|
19
|
+
- Stable steering layers should remain short-lived in content size but long-lived in principle quality.
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# Steering 治理与净化
|
|
2
|
+
|
|
3
|
+
## 目标
|
|
4
|
+
|
|
5
|
+
让 `.sce/steering/` 长期保持三种品质:
|
|
6
|
+
|
|
7
|
+
- 健壮:长期规则稳定,不被短期任务污染
|
|
8
|
+
- 活力:随着项目演进持续校正,不靠历史惯性堆积
|
|
9
|
+
- 节制:只保留最小必要上下文,其他内容迁回更合适的位置
|
|
10
|
+
|
|
11
|
+
## 分层标准
|
|
12
|
+
|
|
13
|
+
| 位置 | 应放什么 | 不应放什么 |
|
|
14
|
+
|------|---------|-----------|
|
|
15
|
+
| `.sce/steering/CORE_PRINCIPLES.md` | 长期原则、跨 Spec 仍成立的默认行为 | 任务项、历史版本、阶段流水、短期战术 |
|
|
16
|
+
| `.sce/steering/ENVIRONMENT.md` | 项目环境、目录约定、发布触发方式、长期运行约束 | Spec 进度、问题清单、临时 workaround |
|
|
17
|
+
| `.sce/steering/CURRENT_CONTEXT.md` | 当前阶段最小必要上下文、近期优先级 | 长历史、完整日志、旧阶段总结 |
|
|
18
|
+
| `.sce/steering/RULES_GUIDE.md` | 职责边界、迁移规则、审计入口 | 详细制度、示例、长篇解释 |
|
|
19
|
+
| `.sce/specs/<spec>/` | 任务、证据、诊断、阶段记录、报告 | 不应再回写到 steering 的长历史 |
|
|
20
|
+
| `docs/` | 详细制度、示例、方法论、治理说明 | 当前 session 的即时状态 |
|
|
21
|
+
|
|
22
|
+
## 审查周期
|
|
23
|
+
|
|
24
|
+
- 每周一次
|
|
25
|
+
- 每次发布前一次
|
|
26
|
+
- 每次重大 Spec 收尾后一次
|
|
27
|
+
- 接管老项目或大规模文档迁移后,再补一次
|
|
28
|
+
|
|
29
|
+
## 审查动作
|
|
30
|
+
|
|
31
|
+
每次审查只做四类决定:
|
|
32
|
+
|
|
33
|
+
1. 保留
|
|
34
|
+
条件:内容长期有效,且放在当前层是正确的
|
|
35
|
+
2. 合并
|
|
36
|
+
条件:多条规则表达同一个约束,只是换了说法
|
|
37
|
+
3. 迁移
|
|
38
|
+
条件:内容有效,但层级错了
|
|
39
|
+
4. 删除
|
|
40
|
+
条件:短期价值已结束、已有现成机制承接、或已经被文档/系统能力覆盖
|
|
41
|
+
|
|
42
|
+
## 防腐重点
|
|
43
|
+
|
|
44
|
+
### 1. 不允许平行机制
|
|
45
|
+
|
|
46
|
+
steering 不能因为“想提醒 AI”就再造一套并行机制。
|
|
47
|
+
|
|
48
|
+
典型案例:
|
|
49
|
+
|
|
50
|
+
- 缺陷经验、临时兜底、发布阻断:统一复用 `errorbook`
|
|
51
|
+
- Scene / session 生命周期:复用现有 close-loop / scene 运行时
|
|
52
|
+
- release gate:复用现有 release workflow 与 gate 脚本
|
|
53
|
+
|
|
54
|
+
如果某条 steering 规则本质上是在说“再搞一套模式”,应先问两件事:
|
|
55
|
+
|
|
56
|
+
1. 现有 SCE 是否已经有能力承接?
|
|
57
|
+
2. 这条内容应该写成机制引用,而不是重新定义机制吗?
|
|
58
|
+
|
|
59
|
+
### 2. 不允许长历史驻留
|
|
60
|
+
|
|
61
|
+
历史记录、阶段流水、版本脚注、完成纪要不应长期留在 steering。
|
|
62
|
+
|
|
63
|
+
迁移目标:
|
|
64
|
+
|
|
65
|
+
- 当前阶段以外的推进历史 -> 对应 Spec `custom/` 或 `reports/`
|
|
66
|
+
- 发布历史 -> `CHANGELOG.md` / `docs/releases/`
|
|
67
|
+
- 详细治理说明 -> `docs/steering-governance.md`
|
|
68
|
+
|
|
69
|
+
### 3. 不允许任务态混入
|
|
70
|
+
|
|
71
|
+
steering 不是待办清单。
|
|
72
|
+
|
|
73
|
+
以下内容应迁出:
|
|
74
|
+
|
|
75
|
+
- checklist
|
|
76
|
+
- “下一个动作”
|
|
77
|
+
- 具体执行命令流水
|
|
78
|
+
- 某个 Spec 的进行中任务状态
|
|
79
|
+
|
|
80
|
+
### 4. 不允许错层
|
|
81
|
+
|
|
82
|
+
判断标准很简单:
|
|
83
|
+
|
|
84
|
+
- 跨项目、跨阶段仍成立?放 `CORE_PRINCIPLES.md`
|
|
85
|
+
- 仅对当前项目成立?放 `ENVIRONMENT.md`
|
|
86
|
+
- 仅对当前阶段成立?放 `CURRENT_CONTEXT.md`
|
|
87
|
+
- 需要示例和长解释?放 `docs/`
|
|
88
|
+
|
|
89
|
+
## 审计入口
|
|
90
|
+
|
|
91
|
+
本项目提供自动审计:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
npm run audit:steering
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
当前会检查:
|
|
98
|
+
|
|
99
|
+
- 文件预算是否超线
|
|
100
|
+
- 长期层是否混入历史版本脚注
|
|
101
|
+
- 长期层是否混入 Spec 引用
|
|
102
|
+
- steering 中是否混入 checklist / 任务态
|
|
103
|
+
- `CURRENT_CONTEXT.md` 是否与当前包版本脱节
|
|
104
|
+
- 是否出现“错题 / 错题本”这类非规范机制别名
|
|
105
|
+
|
|
106
|
+
## 通过标准
|
|
107
|
+
|
|
108
|
+
- `CORE_PRINCIPLES.md` 能在短时间读完并说明默认行为
|
|
109
|
+
- `CURRENT_CONTEXT.md` 不依赖长历史也能让 Agent 开工
|
|
110
|
+
- steering 中不再出现任务态和阶段流水
|
|
111
|
+
- 已有机制统一复用,不再出现平行命名
|
|
112
|
+
- 周期性审计可稳定通过
|
|
@@ -64,14 +64,14 @@ Detect existing steering files
|
|
|
64
64
|
│
|
|
65
65
|
└─ Steering files found → Prompt for strategy
|
|
66
66
|
↓
|
|
67
|
-
├─ use-
|
|
67
|
+
├─ use-sce → Backup existing → Install sce steering
|
|
68
68
|
│
|
|
69
69
|
└─ use-project → Keep existing → Skip sce steering
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
## Rollback
|
|
73
73
|
|
|
74
|
-
If you chose "use-
|
|
74
|
+
If you chose "use-sce" and want to restore your original steering files:
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
77
|
# List available backups
|
|
@@ -100,7 +100,7 @@ Your steering strategy choice is saved in `.sce/adoption-config.json`:
|
|
|
100
100
|
{
|
|
101
101
|
"version": "1.0.0",
|
|
102
102
|
"adoptedAt": "2026-01-23T10:00:00.000Z",
|
|
103
|
-
"steeringStrategy": "use-
|
|
103
|
+
"steeringStrategy": "use-sce",
|
|
104
104
|
"steeringBackupId": "steering-2026-01-23T10-00-00-000Z",
|
|
105
105
|
"multiUserMode": false,
|
|
106
106
|
"lastUpdated": "2026-01-23T10:00:00.000Z"
|
|
@@ -111,7 +111,7 @@ Your steering strategy choice is saved in `.sce/adoption-config.json`:
|
|
|
111
111
|
|
|
112
112
|
### For New sce Users
|
|
113
113
|
|
|
114
|
-
1. **Choose "use-
|
|
114
|
+
1. **Choose "use-sce"** to get the full experience
|
|
115
115
|
2. Review the installed steering files to understand sce workflow
|
|
116
116
|
3. Customize `ENVIRONMENT.md` for your project specifics
|
|
117
117
|
4. Update `CURRENT_CONTEXT.md` as you work on different Specs
|
|
@@ -123,7 +123,7 @@ Your steering strategy choice is saved in `.sce/adoption-config.json`:
|
|
|
123
123
|
3. Consider creating a hybrid approach:
|
|
124
124
|
- Keep your core steering rules
|
|
125
125
|
- Add sce-specific rules in separate files
|
|
126
|
-
- Use file naming to control load order (e.g., `00-core.md`, `10-
|
|
126
|
+
- Use file naming to control load order (e.g., `00-core.md`, `10-sce.md`)
|
|
127
127
|
|
|
128
128
|
### For Teams
|
|
129
129
|
|
|
@@ -138,13 +138,13 @@ Your steering strategy choice is saved in `.sce/adoption-config.json`:
|
|
|
138
138
|
|
|
139
139
|
**Solution:**
|
|
140
140
|
- Check which steering strategy you chose: `cat .sce/adoption-config.json`
|
|
141
|
-
- If "use-
|
|
141
|
+
- If "use-sce", verify sce steering files are present
|
|
142
142
|
- If "use-project", ensure your steering files are compatible with sce
|
|
143
143
|
|
|
144
144
|
### Problem: Want to switch strategies after adoption
|
|
145
145
|
|
|
146
146
|
**Solution:**
|
|
147
|
-
1. If currently "use-
|
|
147
|
+
1. If currently "use-sce":
|
|
148
148
|
```bash
|
|
149
149
|
sce rollback {steering-backup-id}
|
|
150
150
|
```
|
package/docs/troubleshooting.md
CHANGED
|
@@ -1045,7 +1045,7 @@ ls -la .sce/
|
|
|
1045
1045
|
|
|
1046
1046
|
**4. Community:**
|
|
1047
1047
|
- Discord: [Join our Discord](https://discord.gg/sce)
|
|
1048
|
-
- Twitter: [@
|
|
1048
|
+
- Twitter: [@sce_dev](https://twitter.com/sce_dev)
|
|
1049
1049
|
|
|
1050
1050
|
### Creating a Good Issue Report
|
|
1051
1051
|
|