scene-capability-engine 3.0.1 → 3.0.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/CHANGELOG.md +235 -233
- package/LICENSE +2 -2
- package/README.md +8 -11
- package/README.zh.md +7 -10
- package/bin/kse.js +1 -1
- package/bin/sce.js +1 -1
- package/bin/sco.js +1 -1
- package/docs/331-poc-adaptation-roadmap.md +25 -25
- package/docs/331-poc-dual-track-integration-guide.md +26 -26
- package/docs/331-poc-weekly-delivery-checklist.md +8 -8
- package/docs/OFFLINE_INSTALL.md +10 -10
- package/docs/README.md +24 -24
- package/docs/adopt-migration-guide.md +51 -51
- package/docs/adoption-guide.md +56 -56
- package/docs/agent-hooks-analysis.md +52 -52
- package/docs/architecture.md +6 -6
- package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
- package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
- package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
- package/docs/autonomous-control-guide.md +89 -89
- package/docs/command-reference.md +31 -16
- package/docs/community.md +4 -4
- package/docs/cross-tool-guide.md +47 -47
- package/docs/developer-guide.md +5 -5
- package/docs/document-governance.md +91 -91
- package/docs/environment-management-guide.md +53 -53
- package/docs/examples/add-export-command/design.md +2 -2
- package/docs/examples/add-export-command/requirements.md +5 -5
- package/docs/examples/add-export-command/tasks.md +2 -2
- package/docs/faq.md +69 -69
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
- package/docs/images/wechat-qr.png +0 -0
- package/docs/integration-modes.md +60 -60
- package/docs/integration-philosophy.md +48 -48
- package/docs/knowledge-management-guide.md +21 -21
- package/docs/manual-workflows-guide.md +20 -20
- package/docs/moqui-capability-matrix.md +43 -22
- package/docs/moqui-template-core-library-playbook.md +49 -21
- package/docs/multi-agent-coordination-guide.md +19 -19
- package/docs/multi-repo-management-guide.md +93 -93
- package/docs/quick-start-with-ai-tools.md +36 -36
- package/docs/quick-start.md +16 -16
- package/docs/release-checklist.md +7 -7
- package/docs/releases/v1.46.2-validation.md +1 -1
- package/docs/releases/v1.46.2.md +10 -10
- package/docs/scene-runtime-guide.md +42 -42
- package/docs/spec-collaboration-guide.md +43 -43
- package/docs/spec-locking-guide.md +26 -26
- package/docs/spec-numbering-guide.md +6 -6
- package/docs/spec-workflow.md +25 -25
- package/docs/steering-strategy-guide.md +36 -36
- package/docs/team-collaboration-guide.md +23 -23
- package/docs/testing-strategy.md +2 -2
- package/docs/tools/claude-guide.md +26 -26
- package/docs/tools/cursor-guide.md +31 -31
- package/docs/tools/generic-guide.md +22 -22
- package/docs/tools/kiro-guide.md +43 -43
- package/docs/tools/vscode-guide.md +18 -18
- package/docs/tools/windsurf-guide.md +50 -50
- package/docs/troubleshooting.md +116 -116
- package/docs/upgrade-guide.md +49 -49
- package/docs/value-observability-guide.md +6 -6
- package/docs/zh/README.md +22 -22
- package/docs/zh/quick-start.md +34 -34
- package/docs/zh/release-checklist.md +6 -6
- package/docs/zh/releases/v1.46.2-validation.md +1 -1
- package/docs/zh/releases/v1.46.2.md +9 -9
- package/docs/zh/spec-numbering-guide.md +6 -6
- package/docs/zh/tools/claude-guide.md +14 -14
- package/docs/zh/tools/cursor-guide.md +18 -18
- package/docs/zh/tools/generic-guide.md +40 -40
- package/docs/zh/tools/kiro-guide.md +50 -50
- package/docs/zh/tools/vscode-guide.md +20 -20
- package/docs/zh/tools/windsurf-guide.md +49 -49
- package/docs/zh/value-observability-guide.md +6 -6
- package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
- package/lib/adoption/adoption-logger.js +1 -1
- package/lib/adoption/adoption-strategy.js +3 -3
- package/lib/adoption/detection-engine.js +1 -1
- package/lib/adoption/error-formatter.js +17 -17
- package/lib/adoption/progress-reporter.js +2 -2
- package/lib/adoption/smart-orchestrator.js +2 -2
- package/lib/adoption/strategy-selector.js +2 -2
- package/lib/adoption/summary-generator.js +3 -3
- package/lib/auto/autonomous-engine.js +2 -2
- package/lib/auto/close-loop-runner.js +9 -9
- package/lib/backup/backup-system.js +2 -2
- package/lib/collab/collab-manager.js +2 -2
- package/lib/commands/adopt.js +16 -16
- package/lib/commands/auto.js +1148 -106
- package/lib/commands/collab.js +8 -8
- package/lib/commands/docs.js +26 -26
- package/lib/commands/doctor.js +2 -2
- package/lib/commands/env.js +14 -14
- package/lib/commands/knowledge.js +13 -13
- package/lib/commands/lock.js +6 -6
- package/lib/commands/ops.js +19 -19
- package/lib/commands/orchestrate.js +5 -5
- package/lib/commands/prompt.js +3 -3
- package/lib/commands/rollback.js +4 -4
- package/lib/commands/scene.js +30 -30
- package/lib/commands/spec-bootstrap.js +1 -1
- package/lib/commands/spec-gate.js +1 -1
- package/lib/commands/spec-pipeline.js +1 -1
- package/lib/commands/task.js +1 -1
- package/lib/commands/templates.js +27 -27
- package/lib/commands/upgrade.js +8 -8
- package/lib/commands/value.js +4 -4
- package/lib/commands/watch.js +9 -9
- package/lib/commands/workflows.js +5 -5
- package/lib/commands/workspace-multi.js +17 -17
- package/lib/commands/workspace.js +5 -5
- package/lib/context/context-exporter.js +1 -1
- package/lib/context/prompt-generator.js +1 -1
- package/lib/data/moqui-capability-lexicon.json +258 -2
- package/lib/environment/environment-manager.js +1 -1
- package/lib/gitignore/gitignore-detector.js +4 -4
- package/lib/gitignore/gitignore-integration.js +2 -2
- package/lib/gitignore/gitignore-transformer.js +3 -3
- package/lib/gitignore/layered-rules-template.js +2 -2
- package/lib/governance/diagnostic-engine.js +4 -4
- package/lib/governance/doc-reference-checker.js +1 -1
- package/lib/governance/hooks-manager.js +5 -5
- package/lib/governance/reporter.js +1 -1
- package/lib/knowledge/knowledge-manager.js +6 -6
- package/lib/orchestrator/agent-spawner.js +1 -1
- package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
- package/lib/orchestrator/orchestration-engine.js +55 -6
- package/lib/repo/config-manager.js +2 -2
- package/lib/repo/handlers/init-handler.js +3 -3
- package/lib/scene-runtime/audit-emitter.js +2 -2
- package/lib/scene-runtime/binding-plugin-loader.js +1 -1
- package/lib/scene-runtime/moqui-adapter.js +2 -2
- package/lib/scene-runtime/moqui-extractor.js +3 -3
- package/lib/scene-runtime/scene-loader.js +3 -3
- package/lib/scene-runtime/scene-template-linter.js +1 -1
- package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
- package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
- package/lib/spec/multi-spec-orchestrate.js +1 -1
- package/lib/spec-gate/rules/default-rules.js +1 -1
- package/lib/steering/adoption-config.js +1 -1
- package/lib/steering/compliance-auto-fixer.js +1 -1
- package/lib/steering/compliance-cache.js +3 -3
- package/lib/steering/compliance-error-reporter.js +1 -1
- package/lib/steering/index.js +1 -1
- package/lib/steering/steering-manager.js +7 -7
- package/lib/task/task-claimer.js +2 -1
- package/lib/templates/metadata-collector.js +6 -6
- package/lib/templates/template-creator.js +2 -2
- package/lib/templates/template-exporter.js +12 -12
- package/lib/upgrade/migration-engine.js +4 -4
- package/lib/utils/tool-detector.js +25 -25
- package/lib/utils/validation.js +3 -3
- package/lib/version/version-checker.js +13 -13
- package/lib/version/version-manager.js +7 -7
- package/lib/watch/presets.js +4 -4
- package/lib/workspace/multi/path-utils.js +1 -1
- package/lib/workspace/multi/workspace-context-resolver.js +9 -9
- package/lib/workspace/multi/workspace-registry.js +2 -2
- package/lib/workspace/multi/workspace-state-manager.js +1 -1
- package/lib/workspace/multi/workspace.js +1 -1
- package/lib/workspace/workspace-sync.js +1 -1
- package/locales/en.json +1 -1
- package/locales/zh.json +1 -1
- package/package.json +3 -5
- package/template/.kiro/README.md +40 -40
- package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
- package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
- package/template/.kiro/steering/ENVIRONMENT.md +2 -2
- package/template/README.md +3 -3
- /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -8,40 +8,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
10
|
### Added
|
|
11
|
-
- **
|
|
11
|
+
- **Capability lexicon hard gate end-to-end defaultization**: `sce auto handoff run` and `sce auto handoff capability-matrix` now enforce unknown Moqui capability alias blocking by default (expected/provided), emit lexicon gate telemetry into release evidence, and promote those signals into governance risk/concern/recommendation/close-loop block decisions.
|
|
12
|
+
- **SCE naming consolidation + compatibility bridge**: Rebranded product naming to `Scene Capability Engine`, moved package to `scene-capability-engine`, promoted `sce` as the primary CLI command, and preserved `sco` / `sce` / `scene-capability-engine` aliases for migration continuity.
|
|
13
|
+
- **Official template library v1.5.0 alignment**: Synced with `scene-capability-engine-templates` `v1.5.0`, adding scene orchestration template coverage for canvas visualization, interaction hardening, execution playbook, dependency drilldown, decision cockpit, runbook export, action queue orchestration, action pack export, and unified scene governance closure.
|
|
12
14
|
- **Branding consistency release guard**: Added `test:brand-consistency` to block publish when legacy repository/package/product naming reappears in tracked source files.
|
|
13
15
|
- **Rate-limit launch budget safety guard**: Hardened orchestration launch-budget bookkeeping to safely handle partially initialized engine instances in property/instrumentation scenarios.
|
|
14
16
|
- **Property test CI stability (`orchestration-engine.property`)**: Disabled launch-budget waiting in parallel invariant property harness to avoid artificial 60s hold windows and intermittent Jest worker crashes under high-concurrency CI runs.
|
|
15
|
-
- **Moqui runtime binding config overrides**: Added `--moqui-config <path>` to `
|
|
17
|
+
- **Moqui runtime binding config overrides**: Added `--moqui-config <path>` to `sce scene run` and `sce scene doctor`, allowing runtime binding resolution to use an explicit `moqui-adapter.json` path per execution context.
|
|
16
18
|
- **Moqui client rate-limit resilience tests**: Added dedicated unit coverage for `429 Too Many Requests` retry/exhaustion handling and retryable network error recovery in `tests/unit/scene-runtime/moqui-client.test.js`.
|
|
17
19
|
- **Template ontology contract completeness**: Hardened scene package template contract examples to include ontology entities/relations plus governance lineage/rules/decision sections required by strict lint and ontology validation flows.
|
|
18
|
-
- **Scene ontology impact/path analysis commands**: Added `
|
|
20
|
+
- **Scene ontology impact/path analysis commands**: Added `sce scene ontology impact` (reverse dependency blast-radius analysis with `--relation` and `--max-depth`) and `sce scene ontology path` (shortest relation path between refs with optional `--undirected`) to improve ontology-driven change planning and explainability.
|
|
19
21
|
- **Close-loop quantitative DoD gates**: Added `--dod-max-risk-level`, `--dod-kpi-min-completion-rate`, `--dod-max-success-rate-drop`, and `--dod-baseline-window` so autonomous closure can enforce explicit risk/KPI/baseline thresholds beyond binary checks.
|
|
20
22
|
- **Close-loop conflict/ontology execution planning**: Added lease-conflict scheduling governance and scene ontology scheduling guidance with opt-out controls (`--no-conflict-governance`, `--no-ontology-guidance`), and surfaced planning telemetry in `portfolio.execution_plan` plus agent sync plan output.
|
|
21
23
|
- **Close-loop strategy memory feedback loop**: Added persisted strategy memory (`.kiro/auto/close-loop-strategy-memory.json`) to reuse prior goal-level policy hints and track-level feedback bias during decomposition, with run telemetry under `strategy_memory`.
|
|
22
|
-
- **Unified autonomous observability snapshot**: Added `
|
|
23
|
-
- **Agent-facing spec JSON interfaces**: Added `
|
|
24
|
-
- **Autonomous archive schema compatibility tooling**: Added `
|
|
25
|
-
- **Governance resumed-session filtering and ratio telemetry**: `
|
|
26
|
-
- **Governance close-loop post-run retention hook**: Added `--governance-session-keep` and `--governance-session-older-than-days` to `
|
|
27
|
-
- **Governance resume drift guardrails**: `
|
|
28
|
-
- **Governance session maintenance commands**: Added `
|
|
24
|
+
- **Unified autonomous observability snapshot**: Added `sce auto observability snapshot` to aggregate close-loop, batch, controller, governance, and KPI-trend telemetry into one machine-readable payload.
|
|
25
|
+
- **Agent-facing spec JSON interfaces**: Added `sce auto spec status <spec-name> --json` and `sce auto spec instructions <spec-name> --json` for structured status/instruction retrieval in master-sub agent workflows.
|
|
26
|
+
- **Autonomous archive schema compatibility tooling**: Added `sce auto schema check` and `sce auto schema migrate` (dry-run by default, `--apply` to persist) to audit and migrate `schema_version` across autonomous archives.
|
|
27
|
+
- **Governance resumed-session filtering and ratio telemetry**: `sce auto governance session list|stats` now support `--resume-only`, with new resumed/fresh counters and resume lineage composition telemetry (`resumed_rate_percent`, `resumed_from_counts`) for resumed-chain observability.
|
|
28
|
+
- **Governance close-loop post-run retention hook**: Added `--governance-session-keep` and `--governance-session-older-than-days` to `sce auto governance close-loop` for automatic governance session archive pruning after each run, with current session protection and telemetry in `governance_session_prune`.
|
|
29
|
+
- **Governance resume drift guardrails**: `sce auto governance close-loop --governance-resume` now reuses persisted target/advisory policy defaults by default and blocks explicit policy drift unless `--governance-resume-allow-drift` is set, reducing accidental resume misconfiguration.
|
|
30
|
+
- **Governance session maintenance commands**: Added `sce auto governance session list|stats|prune` for persisted governance close-loop session observability and retention management, including status/day filters, convergence/risk telemetry, and archive cleanup controls (`--keep`, `--older-than-days`, `--dry-run`).
|
|
29
31
|
- **Governance close-loop session persistence and resume**: Added default governance loop session archiving (`.kiro/auto/governance-close-loop-sessions`) with controls `--governance-session-id`, `--no-governance-session`, and `--governance-resume <session|latest|file>` so interrupted governance rounds can be resumed without restarting from round 1.
|
|
30
|
-
- **Governance close-loop advisory execution**: Added optional advisory action execution to `
|
|
31
|
-
- **Governance close-loop rounds command**: Added `
|
|
32
|
-
- **Governance maintenance close-loop command**: Added `
|
|
33
|
-
- **Cross-archive governance stats command**: Added `
|
|
34
|
-
- **Session and batch session stats commands**: Added `
|
|
35
|
-
- **Controller session stats command**: Added `
|
|
36
|
-
- **Session list status filtering + composition telemetry**: `
|
|
37
|
-
- **KPI mode composition telemetry**: `
|
|
32
|
+
- **Governance close-loop advisory execution**: Added optional advisory action execution to `sce auto governance close-loop` via `--execute-advisory`, including bounded controls `--advisory-recover-max-rounds` and `--advisory-controller-max-cycles`, with per-round advisory telemetry (`advisory_actions`, advisory action counts) and top-level advisory policy/summary output. Advisory source selection is now autonomous (latest recoverable batch summary / latest controller session with pending goals) and emits `skipped` instead of hard-failing when no actionable advisory source exists.
|
|
33
|
+
- **Governance close-loop rounds command**: Added `sce auto governance close-loop` to run bounded governance-maintenance rounds toward a target risk (`--target-risk`) with convergence telemetry (`rounds`, `initial_assessment`, `final_assessment`, `stop_reason`, `converged`) and non-mutating planning support (`--plan-only`, `--dry-run`).
|
|
34
|
+
- **Governance maintenance close-loop command**: Added `sce auto governance maintain` to combine governance assessment and optional maintenance execution (`--apply`) across session/batch/controller archives and recovery memory, with policy knobs (`--session-keep`, `--batch-session-keep`, `--controller-session-keep`, `--recovery-memory-older-than-days`), dry-run support, and before/after telemetry.
|
|
35
|
+
- **Cross-archive governance stats command**: Added `sce auto governance stats` with optional `--days` / `--status` filters to unify session/batch-session/controller-session telemetry and recovery-memory state into one governance snapshot (`totals`, `throughput`, `health` risk diagnostics, `top_master_specs`, and per-archive detail payloads).
|
|
36
|
+
- **Session and batch session stats commands**: Added `sce auto session stats` and `sce auto batch-session stats` with optional `--days` / `--status` filters and JSON telemetry (completion/failure rates, volume aggregates, composition breakdowns, latest-session snapshots) for autonomous archive observability.
|
|
37
|
+
- **Controller session stats command**: Added `sce auto controller-session stats` with optional `--days` / `--status` filters and JSON telemetry (`status_counts`, `queue_format_counts`, completion/failure rates, goal-volume sums, and latest-session snapshot) for controller archive observability.
|
|
38
|
+
- **Session list status filtering + composition telemetry**: `sce auto session list`, `sce auto batch-session list`, and `sce auto controller-session list` now support `--status <csv>` (case-insensitive) and emit `status_filter` / `status_counts` in JSON output for faster archive triage.
|
|
39
|
+
- **KPI mode composition telemetry**: `sce auto kpi trend` JSON output now includes `mode_breakdown` (batch/program/recover/controller/other) to expose mixed-run trend composition.
|
|
38
40
|
- **Spec protection source expansion**: `spec-session prune` now protects specs referenced by recent/incomplete controller sessions (via nested batch summary references), reducing accidental cleanup during controller-driven autonomous runs.
|
|
39
|
-
- **Controller session maintenance commands**: Added `
|
|
40
|
-
- **Controller-aware autonomous KPI trend mode**: `
|
|
41
|
+
- **Controller session maintenance commands**: Added `sce auto controller-session list` / `sce auto controller-session prune` (retention + age filters + dry-run/json) for persisted close-loop-controller summary archives.
|
|
42
|
+
- **Controller-aware autonomous KPI trend mode**: `sce auto kpi trend` now supports `--mode controller` and includes persisted controller session telemetry in trend aggregation (including nested program sub-spec/spec-growth rollups when available).
|
|
41
43
|
- **Controller checkpoint resume**: `close-loop-controller` now supports `--controller-resume <latest|id|file>` plus persisted controller session snapshots (`.kiro/auto/close-loop-controller-sessions`) with retention controls (`--controller-session-id`, `--controller-session-keep`, `--controller-session-older-than-days`, `--no-controller-session`).
|
|
42
44
|
- **Controller concurrency lease lock**: Added queue lease lock controls (`--controller-lock-file`, `--controller-lock-ttl-seconds`, `--no-controller-lock`) to prevent concurrent queue corruption and allow stale-lock takeover under bounded TTL.
|
|
43
|
-
- **Persistent close-loop queue controller**: Added `
|
|
44
|
-
- **KPI sample generator command**: Added `
|
|
45
|
+
- **Persistent close-loop queue controller**: Added `sce auto close-loop-controller [queue-file]` with queue drain/poll runtime (`--queue-format`, `--dequeue-limit`, `--wait-on-empty`, `--poll-seconds`, runtime budgets, done/failed archives) so broad goals can be continuously executed through `close-loop-program` without manual re-invocation.
|
|
46
|
+
- **KPI sample generator command**: Added `sce value metrics sample` to generate a ready-to-use KPI input JSON scaffold (`kpi-input.json`) for first-time observability runs.
|
|
45
47
|
- **Value observability documentation track**: Added dedicated EN/ZH guides for KPI snapshot/baseline/trend workflow (`docs/value-observability-guide.md`, `docs/zh/value-observability-guide.md`) and wired entry links from README + docs indexes for faster discovery of measurable delivery capabilities.
|
|
46
48
|
- **Release communication assets**: Added bilingual v1.46.2 release notes (`docs/releases/v1.46.2.md`, `docs/zh/releases/v1.46.2.md`) and a reusable pre-release checklist (`docs/release-checklist.md`).
|
|
47
49
|
- **Release validation artifacts**: Added release-readiness evidence reports in EN/ZH (`docs/releases/v1.46.2-validation.md`, `docs/zh/releases/v1.46.2-validation.md`) with test and package dry-run results.
|
|
@@ -49,13 +51,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
49
51
|
- **Value metrics helper test coverage**: Added deterministic tests for ISO week period derivation and sample payload structure in command-level unit tests.
|
|
50
52
|
- **Spec 115 quality hardening program**: Added a master/sub-spec collaboration portfolio (`115-00` + `115-01..115-04`) to parallelize CI trust, Jest open-handle governance, watch follow completion, and doc link canonicalization.
|
|
51
53
|
- **Test governance scripts**: Added `test:smoke`, `test:full`, `test:handles`, `test:skip-audit`, plus `scripts/check-skip-allowlist.js` and `tests/skip-allowlist.txt` for skip-test regression guardrails.
|
|
52
|
-
- **Autonomous close-loop command**: Added `
|
|
53
|
-
- **Definition-of-Done gates for close-loop**: Added configurable completion gates for `
|
|
54
|
+
- **Autonomous close-loop command**: Added `sce auto close-loop "<goal>"` to perform one-command goal decomposition (master/sub specs), collaboration bootstrap, and orchestration until terminal state.
|
|
55
|
+
- **Definition-of-Done gates for close-loop**: Added configurable completion gates for `sce auto close-loop` (`--dod-tests`, `--dod-tasks-closed`, `--no-dod*`) so autonomous runs only report success when required evidence checks pass.
|
|
54
56
|
- **DoD evidence archive for close-loop**: Added automatic DoD report persistence to `.kiro/specs/<master>/custom/dod-report.json` with CLI controls (`--dod-report`, `--no-dod-report`) for audit-ready closure evidence.
|
|
55
|
-
- **Close-loop session resume**: Added session snapshot persistence for `
|
|
56
|
-
- **Close-loop session hygiene commands**: Added `
|
|
57
|
-
- **Spec directory retention commands**: Added `
|
|
58
|
-
- **Active spec protection in retention prune**: `
|
|
57
|
+
- **Close-loop session resume**: Added session snapshot persistence for `sce auto close-loop` (`.kiro/auto/close-loop-sessions`) plus resume controls (`--resume`, `--session-id`, `--no-session`) to continue interrupted master/sub executions.
|
|
58
|
+
- **Close-loop session hygiene commands**: Added `sce auto session list` and `sce auto session prune` (retention + age filters + dry-run/json) so long-running autonomous programs can maintain session archives without manual file cleanup.
|
|
59
|
+
- **Spec directory retention commands**: Added `sce auto spec-session list|prune` (retention + age filters + dry-run/json) to control `.kiro/specs` growth for continuous autonomous runs.
|
|
60
|
+
- **Active spec protection in retention prune**: `sce auto spec-session prune` now protects active/recently referenced specs by default (`--no-protect-active` to override).
|
|
59
61
|
- **Automatic spec retention policy for program/batch/recover**: Added `--spec-session-keep` / `--spec-session-older-than-days` (`--no-spec-session-protect-active` optional) so autonomous multi-goal runs can auto-prune `.kiro/specs` after execution.
|
|
60
62
|
- **Configurable spec protection window**: Added `--spec-session-protect-window-days` (and `spec-session prune --protect-window-days`) so teams can tune recent-reference protection horizon for retention safety.
|
|
61
63
|
- **Spec protection reason observability**: `spec-session prune` now emits `protection_ranking_top` by default and supports `--show-protection-reasons` for per-spec reason detail (`protected_specs[*].reasons`, `protection_ranking`) during retention audits.
|
|
@@ -63,10 +65,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
63
65
|
- **Unified program budget gate**: Added `--program-max-elapsed-minutes`, `--program-max-agent-budget`, and `--program-max-total-sub-specs` so `close-loop-program` convergence gate can enforce time/concurrency/sub-spec budgets together with success/risk policy.
|
|
64
66
|
- **Program/recover gate policy parity + auto-remediation hooks**: `close-loop-recover` now supports the same gate/fallback/budget policy flags as program mode and can emit `program_gate_auto_remediation` (auto patch/prune hints) when gate/budget checks fail.
|
|
65
67
|
- **Spec growth/duplicate guardrails**: Added `--spec-session-max-created`, `--spec-session-max-created-per-goal`, and `--spec-session-max-duplicate-goals` (with hard-fail option) plus summary telemetry (`goal_input_guard`, `spec_session_growth_guard`) to reduce runaway autonomous portfolio expansion.
|
|
66
|
-
- **Autonomous KPI trend command**: Added `
|
|
67
|
-
- **Autonomous KPI trend period/csv/anomaly enhancement**: Extended `
|
|
68
|
+
- **Autonomous KPI trend command**: Added `sce auto kpi trend` to aggregate weekly success/completion, failure, sub-spec, and spec-growth telemetry from persisted autonomous summary sessions.
|
|
69
|
+
- **Autonomous KPI trend period/csv/anomaly enhancement**: Extended `sce auto kpi trend` with `--period week|day`, `--csv` export mode, and JSON anomaly diagnostics (`anomaly_detection`, `anomalies`) for latest-period regression checks.
|
|
68
70
|
- **Program governance stabilization loop**: Added `close-loop-program` governance controls (`--program-govern-until-stable`, `--program-govern-max-rounds`, `--program-govern-max-minutes`, anomaly knobs, `--program-govern-use-action`, `--no-program-govern-auto-action`) so gate/anomaly failures can trigger bounded replay/recover rounds with remediation action execution until stable, with `program_governance`, `program_kpi_trend`, and `program_kpi_anomalies` telemetry.
|
|
69
|
-
- **Close-loop multi-goal batch command**: Added `
|
|
71
|
+
- **Close-loop multi-goal batch command**: Added `sce auto close-loop-batch <goals-file>` with file-format autodetect (`json|lines`), `--continue-on-error`, and per-goal summary output so autonomous master/sub execution can scale across multiple goals in one run.
|
|
70
72
|
- **Close-loop batch global scheduler**: Added `--batch-parallel` (`1-20`) to execute multiple goals concurrently in `close-loop-batch`, enabling master/sub portfolios to progress in parallel without manual orchestration handoffs.
|
|
71
73
|
- **Close-loop batch resume from summary**: Added `--resume-from-summary <path>` to recover pending goals from a prior batch run and continue autonomous delivery without rebuilding the entire goal queue manually.
|
|
72
74
|
- **Close-loop batch resume strategy selector**: Added `--resume-strategy pending|failed-only` so operators can choose whether summary resume should include unprocessed goals (`pending`) or only failed/error goals (`failed-only`).
|
|
@@ -76,10 +78,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
76
78
|
- **Close-loop batch program decomposition mode**: Added `--decompose-goal` + `--program-goals` so one broad goal can be auto-split into multiple batch goals and executed as a master batch without manually authoring a goals file.
|
|
77
79
|
- **Close-loop batch automatic retry rounds**: Added `--batch-retry-rounds` + `--batch-retry-strategy` (`adaptive|strict`) with `batch_retry` summary telemetry so failed/stopped goals can be retried in the same autonomous batch run without manual re-invocation.
|
|
78
80
|
- **Close-loop batch session archive + latest resume**: Added automatic batch summary session persistence (`.kiro/auto/close-loop-batch-summaries`) with controls (`--batch-session-id`, `--batch-session-keep`, `--no-batch-session`) and support for `--resume-from-summary latest`.
|
|
79
|
-
- **Close-loop batch session maintenance commands**: Added `
|
|
81
|
+
- **Close-loop batch session maintenance commands**: Added `sce auto batch-session list` / `sce auto batch-session prune` plus age-based retention control (`--batch-session-older-than-days`) for persisted batch summary archives.
|
|
80
82
|
- **Close-loop batch until-complete retry mode**: Added `--batch-retry-until-complete` + `--batch-retry-max-rounds` so multi-goal runs can auto-drain failed/stopped goals to completion within one command invocation under bounded retry policy.
|
|
81
83
|
- **Close-loop batch autonomous policy mode**: Added `--batch-autonomous` to apply closed-loop defaults automatically (continue-on-error, adaptive parallelism, complexity-first scheduling, aging boost, retry-until-complete) for hands-off program execution.
|
|
82
|
-
- **Close-loop program command**: Added `
|
|
84
|
+
- **Close-loop program command**: Added `sce auto close-loop-program "<goal>"` to auto-decompose one broad objective into multi-goal autonomous execution (master/sub portfolios) with closed-loop batch policy enabled by default.
|
|
83
85
|
- **Close-loop program KPI snapshot**: Added `program_kpi` in `close-loop-program` summary plus `--program-kpi-out` for standalone KPI export (convergence state, risk level, retry recovery, complexity/wait profile).
|
|
84
86
|
- **Close-loop program convergence gate + audit output**: Added policy gates (`--program-min-success-rate`, `--program-max-risk-level`) plus `--program-audit-out` for governance-grade audit JSON; program exits non-zero when gate policy is not met.
|
|
85
87
|
- **Close-loop program gate profiles**: Added `--program-gate-profile` (`default|dev|staging|prod`) so teams can switch convergence policy baselines by environment while still allowing explicit threshold overrides.
|
|
@@ -87,30 +89,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
87
89
|
- **Close-loop program gate fallback chain**: Added `--program-gate-fallback-chain <profiles>` so gate evaluation can try multiple fallback policy profiles in order after primary gate failure.
|
|
88
90
|
- **Close-loop program recovery time budget**: Added `--program-recover-max-minutes` so built-in auto recovery loops can stop on elapsed-time limits, with `recovery_cycle` budget telemetry.
|
|
89
91
|
- **Close-loop program remediation diagnostics**: Added `program_diagnostics` (`failure_clusters` + prioritized `remediation_actions`) to turn program KPI output into actionable convergence guidance.
|
|
90
|
-
- **Close-loop recovery command**: Added `
|
|
92
|
+
- **Close-loop recovery command**: Added `sce auto close-loop-recover [summary]` with remediation-action selection (`--use-action`) to automatically replay unresolved goals using strategy patches derived from diagnostics.
|
|
91
93
|
- **Close-loop recovery self-healing rounds**: Added `--recover-until-complete` + `--recover-max-rounds` with `recovery_cycle` history so recovery can run multiple rounds autonomously until convergence or bounded exhaustion.
|
|
92
94
|
- **Close-loop recovery time/memory governance**: Added `--recover-max-minutes` and `--recovery-memory-ttl-days` so recovery loops can enforce elapsed-time budgets and stale-memory pruning during action selection.
|
|
93
|
-
- **Recovery memory lifecycle commands**: Added `
|
|
94
|
-
- **Recovery memory scope analytics command**: Added `
|
|
95
|
+
- **Recovery memory lifecycle commands**: Added `sce auto recovery-memory show|prune|clear` to inspect, prune, and reset persisted recovery strategy memory.
|
|
96
|
+
- **Recovery memory scope analytics command**: Added `sce auto recovery-memory scopes` to inspect aggregate recovery-memory statistics grouped by scope.
|
|
95
97
|
- **Criticality-priority scheduler mode**: Added `--batch-priority critical-first` with per-goal criticality telemetry in `resource_plan` and result summaries.
|
|
96
98
|
- **Goal decomposition quality diagnostics**: Added `generated_from_goal.quality` (score, coverage ratio, warnings) for program/batch semantic decomposition observability.
|
|
97
99
|
- **Goal decomposition quality auto-refinement**: Added `--program-min-quality-score` with automatic second-pass goal refinement and `quality.refinement` telemetry, so weak decompositions are improved before execution.
|
|
98
100
|
- **Goal decomposition hard quality gate**: Added `--program-quality-gate` to fail execution when final decomposition quality remains below threshold after refinement.
|
|
99
101
|
- **Recovery memory scope isolation + explainability**: Added `--recovery-memory-scope` and selection explanation metadata (`selection_explain`) so remediation memory can be isolated by scope and action selection is auditable.
|
|
100
|
-
- **Scoped recovery memory maintenance**: `
|
|
102
|
+
- **Scoped recovery memory maintenance**: `sce auto recovery-memory show|prune` now support `--scope <scope>` for targeted inspection and cleanup.
|
|
101
103
|
- **Program gate fallback observability**: Program outputs now include `program_gate_fallbacks` and `program_gate_effective` fields for full fallback decision traceability.
|
|
102
|
-
- **Program-level auto recovery loop**: `
|
|
104
|
+
- **Program-level auto recovery loop**: `sce auto close-loop-program` now auto-enters bounded recovery rounds by default (`--program-recover-max-rounds`, `--no-program-auto-recover`) so one command can drive program execution to closure without manual follow-up.
|
|
103
105
|
- **Recovery strategy memory**: Added persisted recovery memory (`.kiro/auto/close-loop-recovery-memory.json`) so `close-loop-recover` and program auto-recovery can reuse previously successful remediation actions when `--use-action` is omitted.
|
|
104
106
|
- **Program coordination telemetry**: Added `program_coordination` output (master/sub topology, unresolved goals, scheduler snapshot) for multi-spec orchestration observability in both program and recover summaries.
|
|
105
107
|
- **Close-loop batch KPI summary**: Added aggregate `metrics` in batch output (success rate, status breakdown, average sub-spec count, average replan cycles) for portfolio-level observability.
|
|
106
|
-
- **Close-loop auto session retention policy**: Added `--session-keep` and `--session-older-than-days` to `
|
|
108
|
+
- **Close-loop auto session retention policy**: Added `--session-keep` and `--session-older-than-days` to `sce auto close-loop` so each autonomous run can prune stale session snapshots automatically.
|
|
107
109
|
- **Automatic replan loop for close-loop failures**: Added remediation replan cycles (`--replan-attempts`, `--no-replan`) so failed orchestration runs can auto-generate recovery specs and retry autonomously.
|
|
108
110
|
- **Replan stall guard**: Added failed-spec signature deduplication so close-loop auto-replan stops early when the same failure set repeats, preventing low-value remediation loops.
|
|
109
111
|
- **Replan no-progress stall guard**: Added `--replan-no-progress-window` so close-loop retries terminate when consecutive failed cycles show no net progress, improving autonomous convergence and reducing retry noise.
|
|
110
112
|
- **Goal decomposition engine**: Added heuristic portfolio planner for automatic sub-spec splitting, dependency wiring, and deterministic spec prefix allocation.
|
|
111
113
|
- **Complex-goal auto-split scaling**: Enhanced decomposition heuristic to auto-escalate sub-spec count up to 5 for high-complexity goals, strengthening master/sub parallel delivery for larger feature sets.
|
|
112
114
|
- **Autonomous close-loop tests**: Added unit coverage for decomposition strategy and close-loop runner behavior (plan-only and execution paths).
|
|
113
|
-
- **Autonomous CLI end-to-end regression**: Added integration coverage for `
|
|
115
|
+
- **Autonomous CLI end-to-end regression**: Added integration coverage for `sce auto close-loop --resume latest`, `sce auto close-loop-batch --dry-run --json`, and `sce auto session list/prune` via real `bin/scene-capability-engine.js` execution.
|
|
114
116
|
- **Program gate fallback-chain integration fixture**: Added deterministic non-dry-run CLI integration coverage for primary-gate failure + fallback-chain acceptance to harden convergence policy regression checks.
|
|
115
117
|
- **Spec 116 autonomous-closure portfolio**: Added `116-00` master with `116-01..116-03` sub-specs as a live master/sub example generated through the close-loop workflow, including `custom/agent-sync-plan.md`.
|
|
116
118
|
- **Spec 117 autonomous hardening portfolio**: Added `117-00` master with `117-01..117-04` sub-specs to continue parallel delivery on no-confirmation closed-loop execution, master/sub decomposition, orchestration runtime, and observability gates.
|
|
@@ -124,15 +126,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
124
126
|
- **Default ERP binding routing now prefers Moqui when configured**: Runtime default handler order now resolves `spec.erp.*` through `moqui.adapter` first when adapter config is present, while preserving deterministic fallback to `builtin.erp-sim` when config is unavailable.
|
|
125
127
|
- **Moqui extraction output enriched for AI-native ontology usage**: Extracted manifests/contracts now emit action intent semantics, dependency chains, governance lineage, ontology model entities/relations, and agent hints for downstream planning.
|
|
126
128
|
- **Controller queue hygiene default**: `close-loop-controller` now deduplicates duplicate broad goals by default (`--no-controller-dedupe` to preserve raw duplicates), and summary telemetry includes dedupe/lock/session metadata.
|
|
127
|
-
- **Positioning and onboarding messaging**: Strengthened EN/ZH README and quick-start docs with explicit
|
|
128
|
-
- **CLI first-screen positioning text**: Updated `
|
|
129
|
+
- **Positioning and onboarding messaging**: Strengthened EN/ZH README and quick-start docs with explicit sce advantage matrix, 90-second value proof, and KPI observability positioning to improve first-contact clarity.
|
|
130
|
+
- **CLI first-screen positioning text**: Updated `sce --help` top description in EN/ZH locales to reflect current core strengths: Spec workflow, orchestration, and KPI observability.
|
|
129
131
|
- **Offline onboarding consistency**: Refreshed `START_HERE.txt`, `INSTALL_OFFLINE.txt`, and `docs/OFFLINE_INSTALL.md` to v1.46.2 guidance and aligned quick-start prerequisites with current runtime requirement (Node.js >= 16).
|
|
130
|
-
- **Value metrics operator guidance**: Enhanced snapshot/baseline/trend failure messages with actionable follow-up commands (including `
|
|
132
|
+
- **Value metrics operator guidance**: Enhanced snapshot/baseline/trend failure messages with actionable follow-up commands (including `sce value metrics sample`) to reduce first-run friction.
|
|
131
133
|
- **Top-level release navigation**: Updated EN/ZH root READMEs to expose release archive and validation report links directly from Advanced Topics for faster proof-of-value discovery.
|
|
132
134
|
- **Observability guide usability**: Added EN/ZH expected JSON output examples for `snapshot --json` and `trend --json` to speed up first-run verification and integration scripting.
|
|
133
|
-
- **Watch log operator flow**: Implemented `
|
|
135
|
+
- **Watch log operator flow**: Implemented `sce watch logs --follow` streaming behavior and documented follow examples in command reference.
|
|
134
136
|
- **Canonical documentation links**: Standardized mixed repository links to `https://github.com/heguangyong/scene-capability-engine` and wired canonical-link scan commands into EN/ZH release checklists.
|
|
135
|
-
- **Autonomy positioning clarity**: Strengthened EN/ZH docs and command reference to emphasize closed-loop delivery and automatic master/sub spec decomposition as
|
|
137
|
+
- **Autonomy positioning clarity**: Strengthened EN/ZH docs and command reference to emphasize closed-loop delivery and automatic master/sub spec decomposition as sce core strengths.
|
|
136
138
|
- **Autonomous operator UX**: Expanded docs with semantic decomposition and live stream behavior for close-loop command usage.
|
|
137
139
|
|
|
138
140
|
### Fixed
|
|
@@ -161,21 +163,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
161
163
|
## [1.46.1] - 2026-02-13
|
|
162
164
|
|
|
163
165
|
### Fixed
|
|
164
|
-
- **NPM publish metadata normalization**: Updated `package.json` `bin` entries to use `bin/
|
|
166
|
+
- **NPM publish metadata normalization**: Updated `package.json` `bin` entries to use `bin/scene-capability-engine.js` (without `./`) so npm no longer strips CLI bin mappings during publish.
|
|
165
167
|
- **Repository metadata format**: Normalized `repository.url` to `git+https://github.com/heguangyong/scene-capability-engine.git` to remove npm publish auto-correction warnings.
|
|
166
168
|
|
|
167
169
|
## [1.46.0] - 2026-02-13
|
|
168
170
|
|
|
169
171
|
### Added
|
|
170
|
-
- **Spec bootstrap command**: Added `
|
|
171
|
-
- **Spec pipeline command**: Added `
|
|
172
|
-
- **Spec gate command**: Added `
|
|
172
|
+
- **Spec bootstrap command**: Added `sce spec bootstrap` to generate `requirements.md`, `design.md`, and `tasks.md` drafts in one step.
|
|
173
|
+
- **Spec pipeline command**: Added `sce spec pipeline run` for staged Spec workflow execution with structured progress output.
|
|
174
|
+
- **Spec gate command**: Added `sce spec gate run` to standardize gate checks and produce machine-readable gate reports.
|
|
173
175
|
- **Multi-spec orchestrate helper**: Added shared helper logic for parsing multi-spec targets and routing execution through orchestrate runtime.
|
|
174
176
|
- **Coverage for new spec workflow**: Added unit tests for bootstrap/pipeline/gate commands and multi-spec orchestrate default behavior.
|
|
175
177
|
|
|
176
178
|
### Changed
|
|
177
|
-
- **Default multi-spec execution mode**: `
|
|
178
|
-
- **CLI spec command routing**: Improved `
|
|
179
|
+
- **Default multi-spec execution mode**: `sce spec bootstrap`, `sce spec pipeline run`, and `sce spec gate run` now default to orchestrate mode when `--specs` is provided.
|
|
180
|
+
- **CLI spec command routing**: Improved `sce spec` command routing for new subcommands while preserving backward compatibility for legacy paths.
|
|
179
181
|
- **Documentation alignment**: Updated EN/ZH docs to promote the new spec-first workflow and document multi-spec default orchestrate behavior.
|
|
180
182
|
|
|
181
183
|
## [1.45.13] - 2026-02-13
|
|
@@ -232,12 +234,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
232
234
|
## [1.45.4] - 2026-02-13
|
|
233
235
|
|
|
234
236
|
### Fixed
|
|
235
|
-
- **Version upgrade path fallback**: `checkCompatibility()` and `calculateUpgradePath()` now use semver-based logic for versions not in the legacy compatibility matrix, fixing `Unknown source version: 1.45.2` error when running `
|
|
237
|
+
- **Version upgrade path fallback**: `checkCompatibility()` and `calculateUpgradePath()` now use semver-based logic for versions not in the legacy compatibility matrix, fixing `Unknown source version: 1.45.2` error when running `sce upgrade`
|
|
236
238
|
|
|
237
239
|
## [1.45.3] - 2026-02-13
|
|
238
240
|
|
|
239
241
|
### Fixed
|
|
240
|
-
- **Self-dependency removed**: Removed erroneous `
|
|
242
|
+
- **Self-dependency removed**: Removed erroneous `scene-capability-engine` self-dependency from `package.json` that caused npm to install stale old versions inside the package, resulting in `error: unknown command 'orchestrate'` and other missing commands in target projects
|
|
241
243
|
|
|
242
244
|
## [1.45.2] - 2026-02-13
|
|
243
245
|
|
|
@@ -261,10 +263,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
261
263
|
- **AgentSpawner** (`lib/orchestrator/agent-spawner.js`): Process manager for Codex CLI sub-agents with timeout detection, graceful termination (SIGTERM → SIGKILL), and event emission
|
|
262
264
|
- **StatusMonitor** (`lib/orchestrator/status-monitor.js`): Codex JSON Lines event parsing, per-Spec status tracking, orchestration-level status aggregation
|
|
263
265
|
- **OrchestrationEngine** (`lib/orchestrator/orchestration-engine.js`): Core engine with DAG-based dependency analysis, batch scheduling, parallel execution (≤ maxParallel), failure propagation, and retry mechanism
|
|
264
|
-
- **CLI Commands** (`
|
|
265
|
-
- `
|
|
266
|
-
- `
|
|
267
|
-
- `
|
|
266
|
+
- **CLI Commands** (`sce orchestrate`):
|
|
267
|
+
- `sce orchestrate run --specs "spec-a,spec-b" --max-parallel 3` — Start multi-agent orchestration
|
|
268
|
+
- `sce orchestrate status` — View orchestration progress
|
|
269
|
+
- `sce orchestrate stop` — Gracefully stop all sub-agents
|
|
268
270
|
- 11 correctness properties verified via property-based testing (fast-check)
|
|
269
271
|
- 236+ new tests across unit, property, and integration test suites
|
|
270
272
|
|
|
@@ -286,8 +288,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
286
288
|
## [1.43.1] - 2026-02-11
|
|
287
289
|
|
|
288
290
|
### Changed
|
|
289
|
-
- **Agent Onboarding Document** (`template/.kiro/README.md`, `.kiro/README.md`): Comprehensive rewrite of "
|
|
290
|
-
- **CORE_PRINCIPLES Principle 9**: Strengthened version sync and steering refresh principle — `.kiro/README.md` is now the authoritative agent onboarding entry point for understanding all
|
|
291
|
+
- **Agent Onboarding Document** (`template/.kiro/README.md`, `.kiro/README.md`): Comprehensive rewrite of "sce Capabilities" section listing all commands and features (Core, Task, Spec Locking, Workspace, Environment, Multi-Repo, Collab, Multi-Agent Coordination, Autonomous Control, Scene Runtime, Document Governance, DevOps, Knowledge Management)
|
|
292
|
+
- **CORE_PRINCIPLES Principle 9**: Strengthened version sync and steering refresh principle — `.kiro/README.md` is now the authoritative agent onboarding entry point for understanding all sce capabilities
|
|
291
293
|
|
|
292
294
|
## [1.43.0] - 2026-02-11
|
|
293
295
|
|
|
@@ -320,13 +322,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
320
322
|
- `LINEAGE_SOURCE_NOT_IN_BINDINGS`, `LINEAGE_SINK_NOT_IN_BINDINGS`
|
|
321
323
|
- `EMPTY_AGENT_SUMMARY`, `INVALID_AGENT_COMPLEXITY`, `INVALID_AGENT_DURATION`
|
|
322
324
|
- **Agent Readiness Score**: New bonus dimension (max +10) in quality score calculator
|
|
323
|
-
- **CLI Commands** (`
|
|
324
|
-
- `
|
|
325
|
-
- `
|
|
326
|
-
- `
|
|
327
|
-
- `
|
|
328
|
-
- `
|
|
329
|
-
- `
|
|
325
|
+
- **CLI Commands** (`sce scene ontology`):
|
|
326
|
+
- `sce scene ontology show` — Display ontology graph
|
|
327
|
+
- `sce scene ontology deps --ref <ref>` — Query dependency chain
|
|
328
|
+
- `sce scene ontology validate` — Validate graph consistency
|
|
329
|
+
- `sce scene ontology actions --ref <ref>` — Show action abstraction
|
|
330
|
+
- `sce scene ontology lineage --ref <ref>` — Show data lineage
|
|
331
|
+
- `sce scene ontology agent-info` — Show agent hints
|
|
330
332
|
|
|
331
333
|
## [1.41.0] - 2026-02-11
|
|
332
334
|
|
|
@@ -343,15 +345,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
343
345
|
- **Quality Score Calculator**: 4-dimension scoring with 0-100 scale
|
|
344
346
|
- Contract validity, lint pass rate, documentation quality, governance completeness
|
|
345
347
|
- Configurable dimension weights
|
|
346
|
-
- `
|
|
348
|
+
- `sce scene lint` — Lint scene package for quality issues
|
|
347
349
|
- `--package <path>` scene package directory
|
|
348
350
|
- `--strict` treat warnings as errors
|
|
349
351
|
- `--json` structured JSON output
|
|
350
|
-
- `
|
|
352
|
+
- `sce scene score` — Calculate quality score (0-100)
|
|
351
353
|
- `--package <path>` scene package directory
|
|
352
354
|
- `--strict` fail if score below threshold (default 60)
|
|
353
355
|
- `--json` structured JSON output
|
|
354
|
-
- `
|
|
356
|
+
- `sce scene contribute` — One-stop contribute pipeline: validate → lint → score → publish
|
|
355
357
|
- `--package <path>` scene package directory
|
|
356
358
|
- `--registry <dir>` custom registry directory
|
|
357
359
|
- `--skip-lint` skip lint step
|
|
@@ -363,12 +365,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
363
365
|
### Added
|
|
364
366
|
- **Moqui Scene Template Extractor**: Extract reusable scene templates from live Moqui ERP instances
|
|
365
367
|
- `MoquiExtractor` — Analyze discovered Moqui resources, identify business patterns (crud/query/workflow), generate scene template bundles
|
|
366
|
-
- Built-in YAML serializer for scene manifests (`
|
|
368
|
+
- Built-in YAML serializer for scene manifests (`sce.scene/v0.2` apiVersion)
|
|
367
369
|
- Entity grouping by Header/Item suffix patterns (e.g., OrderHeader + OrderItem → composite pattern)
|
|
368
370
|
- Pattern-based manifest generation with governance contracts (risk_level, approval, idempotency)
|
|
369
|
-
- Package contract generation (`
|
|
371
|
+
- Package contract generation (`sce.scene.package/v0.1` apiVersion) with template parameters
|
|
370
372
|
- Template bundle file writing with partial failure resilience
|
|
371
|
-
- `
|
|
373
|
+
- `sce scene extract` — Extract scene templates from Moqui ERP instance
|
|
372
374
|
- `--config <path>` custom adapter config path
|
|
373
375
|
- `--type <type>` filter discovery by resource type (entities|services|screens)
|
|
374
376
|
- `--pattern <pattern>` filter by business pattern (crud|query|workflow)
|
|
@@ -385,10 +387,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
385
387
|
- **Moqui ERP Adapter**: Integrate Moqui ERP instance into KSE scene runtime
|
|
386
388
|
- `MoquiClient` — HTTP client with JWT auth lifecycle (login, refresh, re-login, logout), retry logic using Node.js built-in `http`/`https`
|
|
387
389
|
- `MoquiAdapter` — Binding handler for `spec.erp.*` and `moqui.*` refs, entity CRUD, service invocation, screen discovery
|
|
388
|
-
- `
|
|
390
|
+
- `sce scene connect` — Test connectivity and authentication to Moqui ERP instance
|
|
389
391
|
- `--config <path>` custom adapter config path
|
|
390
392
|
- `--json` structured JSON output
|
|
391
|
-
- `
|
|
393
|
+
- `sce scene discover` — Discover available entities, services, and screens from Moqui ERP
|
|
392
394
|
- `--config <path>` custom adapter config path
|
|
393
395
|
- `--type <type>` filter by catalog type (entities|services|screens)
|
|
394
396
|
- `--json` structured JSON output
|
|
@@ -400,13 +402,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
400
402
|
|
|
401
403
|
### Added
|
|
402
404
|
- **Scene Registry Statistics**: Dashboard for local scene package registry metrics
|
|
403
|
-
- `
|
|
405
|
+
- `sce scene stats` show aggregate statistics (packages, versions, tags, ownership, deprecation, last publish)
|
|
404
406
|
- `--registry <dir>` custom registry directory
|
|
405
407
|
- `--json` structured JSON output
|
|
406
408
|
- **Scene Version Locking**: Protect specific package versions from accidental unpublish
|
|
407
|
-
- `
|
|
408
|
-
- `
|
|
409
|
-
- `
|
|
409
|
+
- `sce scene lock set --name <pkg> --version <ver>` lock a version
|
|
410
|
+
- `sce scene lock rm --name <pkg> --version <ver>` unlock a version
|
|
411
|
+
- `sce scene lock ls --name <pkg>` list locked versions
|
|
410
412
|
- `--registry <dir>` custom registry directory
|
|
411
413
|
- `--json` structured JSON output
|
|
412
414
|
- Lock state stored as `locked: true` on version entries in `registry-index.json`
|
|
@@ -415,9 +417,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
415
417
|
|
|
416
418
|
### Added
|
|
417
419
|
- **Scene Distribution Tags**: Manage distribution tags on scene packages in local registry
|
|
418
|
-
- `
|
|
419
|
-
- `
|
|
420
|
-
- `
|
|
420
|
+
- `sce scene tag add --name <pkg> --tag <tag> --version <ver>` add a distribution tag
|
|
421
|
+
- `sce scene tag rm --name <pkg> --tag <tag>` remove a distribution tag
|
|
422
|
+
- `sce scene tag ls --name <pkg>` list all tags and latest version
|
|
421
423
|
- `--registry <dir>` custom registry directory
|
|
422
424
|
- `--json` structured JSON output
|
|
423
425
|
- Tags stored as `tags` object on package entry, separate from `latest` field
|
|
@@ -427,10 +429,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
427
429
|
|
|
428
430
|
### Added
|
|
429
431
|
- **Scene Package Ownership**: Manage package ownership metadata in local registry
|
|
430
|
-
- `
|
|
431
|
-
- `
|
|
432
|
-
- `
|
|
433
|
-
- `
|
|
432
|
+
- `sce scene owner set --name <pkg> --owner <owner>` set package owner
|
|
433
|
+
- `sce scene owner show --name <pkg>` display current owner
|
|
434
|
+
- `sce scene owner list --owner <owner>` list packages by owner (case-insensitive)
|
|
435
|
+
- `sce scene owner transfer --name <pkg> --from <old> --to <new>` transfer ownership
|
|
434
436
|
- `--remove` clear owner field
|
|
435
437
|
- `--registry <dir>` custom registry directory
|
|
436
438
|
- `--json` structured JSON output
|
|
@@ -441,7 +443,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
441
443
|
|
|
442
444
|
### Added
|
|
443
445
|
- **Scene Registry Audit**: Health check for local scene package registry
|
|
444
|
-
- `
|
|
446
|
+
- `sce scene audit` scan registry index, verify tarball existence and SHA-256 integrity
|
|
445
447
|
- `--registry <dir>` custom registry directory (default `.kiro/registry`)
|
|
446
448
|
- `--fix` auto-remove orphaned tarballs and clean missing-tarball index entries
|
|
447
449
|
- `--json` structured JSON output
|
|
@@ -452,7 +454,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
452
454
|
|
|
453
455
|
### Added
|
|
454
456
|
- **Scene Package Deprecation**: Mark/unmark package versions as deprecated in local registry
|
|
455
|
-
- `
|
|
457
|
+
- `sce scene deprecate --name <pkg> --message <msg>` deprecate all versions
|
|
456
458
|
- `--version <v>` target specific version
|
|
457
459
|
- `--undo` remove deprecation marker
|
|
458
460
|
- `--registry <dir>` custom registry directory
|
|
@@ -467,7 +469,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
467
469
|
|
|
468
470
|
### Added
|
|
469
471
|
- **Scene Package Directory Validation**: Comprehensive validation for scene package directories
|
|
470
|
-
- `
|
|
472
|
+
- `sce scene package-validate --package <dir>` now supports directory-level validation
|
|
471
473
|
- `--strict` treat warnings as errors (exit code 1)
|
|
472
474
|
- `--json` structured JSON output
|
|
473
475
|
- Validates `scene-package.json` existence and required fields
|
|
@@ -484,7 +486,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
484
486
|
|
|
485
487
|
### Added
|
|
486
488
|
- **Scene Package Info**: Display detailed package information from local registry
|
|
487
|
-
- `
|
|
489
|
+
- `sce scene info --name <packageName>` show package details
|
|
488
490
|
- `--registry <dir>` custom registry directory
|
|
489
491
|
- `--json` structured JSON output
|
|
490
492
|
- `--versions-only` show only version list
|
|
@@ -498,7 +500,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
498
500
|
|
|
499
501
|
### Added
|
|
500
502
|
- **Scene Package Diff**: Compare two versions of a scene package in the local registry
|
|
501
|
-
- `
|
|
503
|
+
- `sce scene diff --name <pkg> --from <v1> --to <v2>` compare package versions
|
|
502
504
|
- `--registry <dir>` custom registry directory
|
|
503
505
|
- `--json` structured JSON output
|
|
504
506
|
- `--stat` show only file change summary
|
|
@@ -513,7 +515,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
513
515
|
|
|
514
516
|
### Added
|
|
515
517
|
- **Scene Version Bump**: Bump version in scene-package.json following semver
|
|
516
|
-
- `
|
|
518
|
+
- `sce scene version --bump <major|minor|patch|x.y.z>` bump scene package version
|
|
517
519
|
- `--package <dir>` scene package directory (default: current directory)
|
|
518
520
|
- `--dry-run` preview without writing
|
|
519
521
|
- `--json` structured JSON output
|
|
@@ -526,10 +528,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
526
528
|
|
|
527
529
|
### Added
|
|
528
530
|
- **Scene Registry Query**: List and search scene packages in local registry
|
|
529
|
-
- `
|
|
531
|
+
- `sce scene list` list all packages in registry
|
|
530
532
|
- `--registry <dir>` custom registry directory
|
|
531
533
|
- `--json` structured JSON output
|
|
532
|
-
- `
|
|
534
|
+
- `sce scene search --query <term>` search packages by keyword
|
|
533
535
|
- Case-insensitive substring matching on name, description, and group
|
|
534
536
|
- `--registry <dir>` custom registry directory
|
|
535
537
|
- `--json` structured JSON output
|
|
@@ -541,7 +543,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
541
543
|
|
|
542
544
|
### Added
|
|
543
545
|
- **Scene Package Install**: Install published scene packages from local registry
|
|
544
|
-
- `
|
|
546
|
+
- `sce scene install --name <packageName>` install scene package from registry
|
|
545
547
|
- `--version <version>` exact version or omit for latest
|
|
546
548
|
- `--out <dir>` custom target directory (default: `./{packageName}`)
|
|
547
549
|
- `--registry <dir>` custom registry directory
|
|
@@ -559,12 +561,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
559
561
|
|
|
560
562
|
### Added
|
|
561
563
|
- **Scene Package Registry Publish/Unpublish**: Local registry-based publish and unpublish for scene packages
|
|
562
|
-
- `
|
|
564
|
+
- `sce scene publish --package <path>` publish scene package to local registry
|
|
563
565
|
- `--registry <dir>` custom registry directory
|
|
564
566
|
- `--dry-run` preview without writing
|
|
565
567
|
- `--force` overwrite existing version
|
|
566
568
|
- `--json` structured JSON output
|
|
567
|
-
- `
|
|
569
|
+
- `sce scene unpublish --name <name> --version <version>` remove published version
|
|
568
570
|
- `--registry <dir>` custom registry directory
|
|
569
571
|
- `--json` structured JSON output
|
|
570
572
|
- Tarball bundling with SHA-256 integrity verification
|
|
@@ -577,7 +579,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
577
579
|
## [1.26.0] - 2026-02-10
|
|
578
580
|
|
|
579
581
|
### Added
|
|
580
|
-
- **Scene Template Instantiation**: Complete `
|
|
582
|
+
- **Scene Template Instantiation**: Complete `sce scene instantiate` command for template package instantiation
|
|
581
583
|
- `--package <name>` select template package, `--values <json|file>` supply variables
|
|
582
584
|
- `--out <dir>` output directory, `--template-dir <dir>` custom template root
|
|
583
585
|
- `--list` list available packages, `--dry-run` preview without writing
|
|
@@ -587,13 +589,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
587
589
|
- Post-instantiate hook execution via `post-instantiate` script in scene-package.json
|
|
588
590
|
- Implements Spec 76-00-scene-template-instantiation
|
|
589
591
|
|
|
590
|
-
- **Default Agent Hooks in Adopt**: `
|
|
592
|
+
- **Default Agent Hooks in Adopt**: `sce adopt` now creates 3 default hooks in `.kiro/hooks/`
|
|
591
593
|
- `run-tests-on-save.kiro.hook` - Manual trigger to run tests (userTriggered)
|
|
592
594
|
- `check-spec-on-create.kiro.hook` - Validate spec structure on creation (fileCreated)
|
|
593
595
|
- `sync-tasks-on-edit.kiro.hook` - Sync workspace on tasks.md edit (fileEdited)
|
|
594
596
|
- Hooks directory added to all adoption strategies (fresh/partial/full)
|
|
595
597
|
|
|
596
|
-
- **
|
|
598
|
+
- **AI IDE MCP Auto-Configuration**: When AI IDE is detected during `sce adopt`, automatically creates `.kiro/settings/mcp.json` with shell MCP server (`mcp-server-commands`). Skips if config already exists.
|
|
597
599
|
|
|
598
600
|
## [1.25.0] - 2026-02-09
|
|
599
601
|
|
|
@@ -604,9 +606,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
604
606
|
- **Multi-File Template Rendering**: Recursive file processing with `{{variable}}` substitution, `{{#if}}` conditionals, `{{#each}}` loops, and unresolved placeholder passthrough
|
|
605
607
|
- **Three-Layer Inheritance Resolution**: L1-Capability / L2-Domain / L3-Instance package hierarchy with variable schema and file merging, cycle detection
|
|
606
608
|
- **CLI Commands**:
|
|
607
|
-
- `
|
|
608
|
-
- `
|
|
609
|
-
- `
|
|
609
|
+
- `sce scene template-validate --package <path>` - Validate template variable schema in scene-package.json
|
|
610
|
+
- `sce scene template-resolve --package <name>` - Resolve full inheritance chain and display merged schema
|
|
611
|
+
- `sce scene template-render --package <name> --values <json> --out <dir>` - Render template package with variable substitution
|
|
610
612
|
- All commands support `--json` output mode
|
|
611
613
|
- Reuses existing package registry and contract validation infrastructure
|
|
612
614
|
|
|
@@ -659,13 +661,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
659
661
|
- **User Knowledge Management System (MVP)**: Personal knowledge base for capturing project experiences
|
|
660
662
|
- **Knowledge Base**: Organize patterns, lessons, workflows, checklists, and references
|
|
661
663
|
- **CLI Commands**: Complete command set for knowledge management
|
|
662
|
-
- `
|
|
663
|
-
- `
|
|
664
|
-
- `
|
|
665
|
-
- `
|
|
666
|
-
- `
|
|
667
|
-
- `
|
|
668
|
-
- `
|
|
664
|
+
- `sce knowledge init` - Initialize knowledge base
|
|
665
|
+
- `sce knowledge add <type> <title>` - Add new entry (pattern/lesson/workflow/checklist/reference)
|
|
666
|
+
- `sce knowledge list` - List all entries with filtering and sorting
|
|
667
|
+
- `sce knowledge search <keyword>` - Search entries (title, tags, content)
|
|
668
|
+
- `sce knowledge show <id>` - Display entry details
|
|
669
|
+
- `sce knowledge delete <id>` - Delete entry with backup
|
|
670
|
+
- `sce knowledge stats` - Show statistics
|
|
669
671
|
- **Entry Types**: Five built-in types with customizable templates
|
|
670
672
|
- Pattern: Design patterns and architectural solutions
|
|
671
673
|
- Lesson: Lessons learned from experience
|
|
@@ -712,7 +714,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
712
714
|
- Weighted average estimation (more weight to recent data)
|
|
713
715
|
- Improved completion time estimates over multiple executions
|
|
714
716
|
- Historical data persistence to `.kiro/auto/historical-data.json`
|
|
715
|
-
- **CORE_PRINCIPLES Compliance**: Automatic verification of
|
|
717
|
+
- **CORE_PRINCIPLES Compliance**: Automatic verification of sce project structure
|
|
716
718
|
- Checks for `.kiro` directory (adoption marker)
|
|
717
719
|
- Validates `version.json`, `specs/`, `steering/` directories
|
|
718
720
|
- Ensures Spec-driven development workflow compliance
|
|
@@ -756,12 +758,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
756
758
|
- `CheckpointManager`: Checkpoint creation and rollback with user approval workflow
|
|
757
759
|
- `AutonomousEngine`: Central orchestrator integrating all managers
|
|
758
760
|
- **CLI Commands**: Complete command set for autonomous execution
|
|
759
|
-
- `
|
|
760
|
-
- `
|
|
761
|
-
- `
|
|
762
|
-
- `
|
|
763
|
-
- `
|
|
764
|
-
- `
|
|
761
|
+
- `sce auto create <description>`: Create and run Spec autonomously from feature description
|
|
762
|
+
- `sce auto run <spec>`: Execute existing Spec tasks autonomously
|
|
763
|
+
- `sce auto status`: Display current execution state and progress
|
|
764
|
+
- `sce auto resume`: Resume from last checkpoint after pause
|
|
765
|
+
- `sce auto stop`: Gracefully stop execution and save state
|
|
766
|
+
- `sce auto config`: View and update autonomous execution configuration
|
|
765
767
|
- **Key Features**:
|
|
766
768
|
- Continuous task execution without interruption
|
|
767
769
|
- Automatic error recovery with strategy learning
|
|
@@ -818,12 +820,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
818
820
|
- **Integration Testing**: Run cross-Spec integration tests to verify modules work together correctly
|
|
819
821
|
- **Dependency Visualization**: View dependency graphs with critical path highlighting
|
|
820
822
|
- **CLI Commands**: Complete set of commands for collaboration management
|
|
821
|
-
- `
|
|
822
|
-
- `
|
|
823
|
-
- `
|
|
824
|
-
- `
|
|
825
|
-
- `
|
|
826
|
-
- `
|
|
823
|
+
- `sce collab init` - Initialize Master Spec with Sub-Specs
|
|
824
|
+
- `sce collab status` - Display collaboration status and dependency graph
|
|
825
|
+
- `sce collab assign` - Assign Specs to SCE instances
|
|
826
|
+
- `sce collab verify` - Verify interface contract compliance
|
|
827
|
+
- `sce collab integrate` - Run integration tests across Specs
|
|
828
|
+
- `sce collab migrate` - Convert standalone Spec to collaborative mode
|
|
827
829
|
- **Backward Compatible**: Opt-in system that doesn't affect existing single-Spec workflows
|
|
828
830
|
- **Comprehensive Documentation**: Complete guide with examples and best practices
|
|
829
831
|
|
|
@@ -965,7 +967,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
965
967
|
- Parent reference validation now correctly matches parent paths with repository paths
|
|
966
968
|
- Improved error messages to include available paths when validation fails
|
|
967
969
|
- **Git Command Duplication**: Fixed command execution that duplicated "git" prefix
|
|
968
|
-
- `
|
|
970
|
+
- `sce repo exec "git branch"` now correctly executes "git branch" instead of "git git branch"
|
|
969
971
|
- Command trimming and prefix detection added to RepoManager.execInRepo()
|
|
970
972
|
- **Backward Compatibility**: All existing configurations work without changes
|
|
971
973
|
- Existing single-repository configurations function identically
|
|
@@ -981,7 +983,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
981
983
|
|
|
982
984
|
### Added
|
|
983
985
|
- **Nested Repository Support**: Discover and manage Git repositories nested inside other repositories
|
|
984
|
-
- `
|
|
986
|
+
- `sce repo init` now scans inside Git repositories to find nested subrepositories by default
|
|
985
987
|
- Added `--nested` and `--no-nested` flags to control scanning behavior
|
|
986
988
|
- Parent-child relationships tracked in configuration with `parent` field
|
|
987
989
|
- Display parent relationships in status and health commands
|
|
@@ -1043,10 +1045,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1043
1045
|
|
|
1044
1046
|
### Added
|
|
1045
1047
|
- **Multi-Repository Management**: Complete feature for managing multiple Git subrepositories
|
|
1046
|
-
- `
|
|
1047
|
-
- `
|
|
1048
|
-
- `
|
|
1049
|
-
- `
|
|
1048
|
+
- `sce repo init`: Auto-discover and initialize repository configuration
|
|
1049
|
+
- `sce repo status`: View status of all repositories in unified table
|
|
1050
|
+
- `sce repo exec`: Execute Git commands across all repositories
|
|
1051
|
+
- `sce repo health`: Verify repository configuration and connectivity
|
|
1050
1052
|
- Configuration stored in `.kiro/project-repos.json`
|
|
1051
1053
|
- Support for repository groups, tags, and metadata
|
|
1052
1054
|
- Cross-platform path handling (Windows/Linux/macOS)
|
|
@@ -1095,7 +1097,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1095
1097
|
- **Steering Rules**: Enhanced with automatic version sync workflow
|
|
1096
1098
|
|
|
1097
1099
|
### Notes
|
|
1098
|
-
- This release ensures AI tools stay synchronized with
|
|
1100
|
+
- This release ensures AI tools stay synchronized with sce version updates
|
|
1099
1101
|
- All 1491 tests passing
|
|
1100
1102
|
|
|
1101
1103
|
## [1.18.0] - 2026-01-31
|
|
@@ -1128,7 +1130,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1128
1130
|
|
|
1129
1131
|
### Added
|
|
1130
1132
|
- **Template Creation from Existing Spec**: Automated workflow to convert completed Specs into reusable templates
|
|
1131
|
-
- CLI command: `
|
|
1133
|
+
- CLI command: `sce templates create-from-spec --spec <identifier> [options]`
|
|
1132
1134
|
- Automatic content generalization (replaces project-specific details with template variables)
|
|
1133
1135
|
- Interactive metadata collection (name, description, category, tags, author, version)
|
|
1134
1136
|
- YAML frontmatter generation for all template files
|
|
@@ -1182,10 +1184,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1182
1184
|
### Added
|
|
1183
1185
|
- **Spec Template Library**: Complete template management system for rapid Spec creation
|
|
1184
1186
|
- Browse, search, and apply pre-built Spec templates from official and custom sources
|
|
1185
|
-
- Template discovery: `
|
|
1186
|
-
- Template management: `
|
|
1187
|
-
- Custom sources: `
|
|
1188
|
-
- Create Spec from template: `
|
|
1187
|
+
- Template discovery: `sce templates list`, `sce templates search <keyword>`, `sce templates show <template-id>`
|
|
1188
|
+
- Template management: `sce templates update`, `sce templates cache`, `sce templates guide`
|
|
1189
|
+
- Custom sources: `sce templates add-source <name> <url>`, `sce templates remove-source <name>`, `sce templates sources`
|
|
1190
|
+
- Create Spec from template: `sce spec create <name> --template <template-id>`
|
|
1189
1191
|
- Local caching for offline use (~/.kse/templates/)
|
|
1190
1192
|
- Multi-source support with conflict resolution (source:template-id format)
|
|
1191
1193
|
- Automatic variable substitution ({{SPEC_NAME}}, {{DATE}}, {{AUTHOR}}, etc.)
|
|
@@ -1210,7 +1212,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1210
1212
|
- Only requires user intervention for: fatal errors, external resources, major architecture decisions, final acceptance
|
|
1211
1213
|
- Added "避免重复测试" (Avoid Redundant Testing) clarification
|
|
1212
1214
|
- Skip tests if just executed during Spec implementation
|
|
1213
|
-
- Handles
|
|
1215
|
+
- Handles SCE's file-save-triggered subagent scenario
|
|
1214
1216
|
|
|
1215
1217
|
### Notes
|
|
1216
1218
|
- All existing tests pass (1491 tests)
|
|
@@ -1224,8 +1226,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1224
1226
|
- **.gitignore Auto-Fix for Team Collaboration**: Automatic detection and fixing of .gitignore configuration
|
|
1225
1227
|
- Detects old blanket `.kiro/` exclusion patterns that prevent Spec sharing
|
|
1226
1228
|
- Replaces with layered strategy: commit Specs, exclude personal state
|
|
1227
|
-
- Integrated into `
|
|
1228
|
-
- Standalone command: `
|
|
1229
|
+
- Integrated into `sce adopt` and `sce upgrade` flows (automatic)
|
|
1230
|
+
- Standalone command: `sce doctor --fix-gitignore`
|
|
1229
1231
|
- Creates backup before modification (stored in `.kiro/backups/gitignore-{timestamp}`)
|
|
1230
1232
|
- Preserves all user rules (non-.kiro patterns)
|
|
1231
1233
|
- Handles different line endings (CRLF/LF) correctly
|
|
@@ -1254,7 +1256,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1254
1256
|
- Rollback capability to restore previous environment state
|
|
1255
1257
|
- Support for multiple configuration file mappings per environment
|
|
1256
1258
|
- Environment verification with custom commands (optional)
|
|
1257
|
-
- Commands: `
|
|
1259
|
+
- Commands: `sce env list`, `sce env switch`, `sce env info`, `sce env register`, `sce env unregister`, `sce env rollback`
|
|
1258
1260
|
- Comprehensive user documentation in `docs/environment-management-guide.md`
|
|
1259
1261
|
- 66 unit tests covering all core functionality
|
|
1260
1262
|
|
|
@@ -1262,7 +1264,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1262
1264
|
- **EnvironmentRegistry**: JSON-based persistent storage (`.kiro/environments.json`)
|
|
1263
1265
|
- **EnvironmentManager**: Core logic for environment operations
|
|
1264
1266
|
- **BackupSystem**: Automatic backup/restore with history management
|
|
1265
|
-
- **CLI Integration**: Seamless integration with existing
|
|
1267
|
+
- **CLI Integration**: Seamless integration with existing sce commands
|
|
1266
1268
|
- **Cross-platform**: Consistent behavior on Windows, Linux, and Mac
|
|
1267
1269
|
|
|
1268
1270
|
## [1.13.1] - 2026-01-29
|
|
@@ -1309,9 +1311,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1309
1311
|
- Added complete directory structure documentation with purpose explanations
|
|
1310
1312
|
- Added workspace management section with detailed usage examples
|
|
1311
1313
|
- Added document governance section with validation commands
|
|
1312
|
-
- Added data storage location details for `
|
|
1314
|
+
- Added data storage location details for `sce workspace` feature
|
|
1313
1315
|
- Added JSON data structure examples for workspace-state.json
|
|
1314
|
-
- Clarified difference between `
|
|
1316
|
+
- Clarified difference between `sce workspace` (cross-project) and `contexts/` (multi-user)
|
|
1315
1317
|
- Added key features list for workspace management
|
|
1316
1318
|
|
|
1317
1319
|
### Changed
|
|
@@ -1341,7 +1343,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1341
1343
|
|
|
1342
1344
|
### Fixed
|
|
1343
1345
|
- **Critical**: Registered `workspace` command in CLI that was missing from v1.12.0
|
|
1344
|
-
- Added workspace command registration in `bin/
|
|
1346
|
+
- Added workspace command registration in `bin/scene-capability-engine.js`
|
|
1345
1347
|
- All workspace subcommands now available: create, list, switch, remove, info
|
|
1346
1348
|
- Fixes issue where users couldn't access multi-workspace management features
|
|
1347
1349
|
|
|
@@ -1401,11 +1403,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1401
1403
|
|
|
1402
1404
|
### Fixed - CRITICAL: Workspace Context Pollution 🚨
|
|
1403
1405
|
|
|
1404
|
-
**HOTFIX**: Fixed critical bug where
|
|
1406
|
+
**HOTFIX**: Fixed critical bug where AI IDE reads all workspace contexts
|
|
1405
1407
|
|
|
1406
1408
|
**Critical Issue**:
|
|
1407
1409
|
- Workspace contexts were stored in `.kiro/steering/workspaces/`
|
|
1408
|
-
-
|
|
1410
|
+
- AI IDE reads ALL `.md` files in `steering/` directory
|
|
1409
1411
|
- This caused ALL personal CURRENT_CONTEXT.md files to be read simultaneously
|
|
1410
1412
|
- Result: Context pollution, confusion, and incorrect AI behavior
|
|
1411
1413
|
|
|
@@ -1418,8 +1420,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1418
1420
|
```
|
|
1419
1421
|
.kiro/
|
|
1420
1422
|
├── steering/
|
|
1421
|
-
│ └── CURRENT_CONTEXT.md ← Only active context (read by
|
|
1422
|
-
└── contexts/ ← Personal workspaces (NOT read by
|
|
1423
|
+
│ └── CURRENT_CONTEXT.md ← Only active context (read by SCE)
|
|
1424
|
+
└── contexts/ ← Personal workspaces (NOT read by SCE)
|
|
1423
1425
|
├── developer1/
|
|
1424
1426
|
│ └── CURRENT_CONTEXT.md
|
|
1425
1427
|
└── developer2/
|
|
@@ -1501,15 +1503,15 @@ rm -rf .kiro/steering/workspaces
|
|
|
1501
1503
|
|
|
1502
1504
|
### Added - Multi-Workspace Management 🚀
|
|
1503
1505
|
|
|
1504
|
-
**Spec 16-00**: Complete multi-workspace management system for managing multiple
|
|
1506
|
+
**Spec 16-00**: Complete multi-workspace management system for managing multiple sce projects
|
|
1505
1507
|
|
|
1506
1508
|
**New Features**:
|
|
1507
1509
|
- **Workspace Management Commands**
|
|
1508
|
-
- `
|
|
1509
|
-
- `
|
|
1510
|
-
- `
|
|
1511
|
-
- `
|
|
1512
|
-
- `
|
|
1510
|
+
- `sce workspace create <name> [path]` - Register a new workspace
|
|
1511
|
+
- `sce workspace list` - List all registered workspaces
|
|
1512
|
+
- `sce workspace switch <name>` - Switch active workspace
|
|
1513
|
+
- `sce workspace remove <name>` - Remove workspace from registry
|
|
1514
|
+
- `sce workspace info [name]` - Display workspace details
|
|
1513
1515
|
- **Data Atomicity Architecture**
|
|
1514
1516
|
- Single source of truth: `~/.kse/workspace-state.json`
|
|
1515
1517
|
- Atomic operations for all workspace state changes
|
|
@@ -1546,7 +1548,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1546
1548
|
- Session summary and completion report
|
|
1547
1549
|
|
|
1548
1550
|
**Benefits**:
|
|
1549
|
-
- Manage multiple
|
|
1551
|
+
- Manage multiple sce projects from a single location
|
|
1550
1552
|
- Quick workspace switching without directory navigation
|
|
1551
1553
|
- Consistent workspace state across all operations
|
|
1552
1554
|
- Foundation for future cross-workspace features
|
|
@@ -1600,7 +1602,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1600
1602
|
|
|
1601
1603
|
### Added - Adopt Command UX Improvement 🎉
|
|
1602
1604
|
|
|
1603
|
-
**Spec 14-00**: Complete UX overhaul for the `
|
|
1605
|
+
**Spec 14-00**: Complete UX overhaul for the `sce adopt` command with zero-interaction smart adoption
|
|
1604
1606
|
|
|
1605
1607
|
**Phase 1: Core Smart Adoption**
|
|
1606
1608
|
- **Smart Orchestrator**: Zero-interaction adoption coordinator
|
|
@@ -1688,7 +1690,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1688
1690
|
- Clear problem descriptions (non-technical language)
|
|
1689
1691
|
- Possible causes listing
|
|
1690
1692
|
- Actionable solutions
|
|
1691
|
-
- Help references (
|
|
1693
|
+
- Help references (sce doctor, documentation)
|
|
1692
1694
|
- Consistent formatting across all errors
|
|
1693
1695
|
|
|
1694
1696
|
**Phase 3: Advanced Features**
|
|
@@ -1788,11 +1790,11 @@ rm -rf .kiro/steering/workspaces
|
|
|
1788
1790
|
- Clear error reporting with missing elements
|
|
1789
1791
|
|
|
1790
1792
|
**New CLI Commands**:
|
|
1791
|
-
- `
|
|
1792
|
-
- `
|
|
1793
|
-
- `
|
|
1794
|
-
- `
|
|
1795
|
-
- `
|
|
1793
|
+
- `sce ops init <project-name>` - Initialize operations specs from templates
|
|
1794
|
+
- `sce ops validate [<project-name>]` - Validate operations spec completeness
|
|
1795
|
+
- `sce ops audit [options]` - Query audit logs with filtering
|
|
1796
|
+
- `sce ops takeover <action> [options]` - Manage takeover levels
|
|
1797
|
+
- `sce ops feedback <action> [options]` - Manage user feedback
|
|
1796
1798
|
|
|
1797
1799
|
**New Components**:
|
|
1798
1800
|
- `lib/operations/operations-manager.js` - Operations spec lifecycle management
|
|
@@ -1851,7 +1853,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1851
1853
|
|
|
1852
1854
|
### Added - Interactive Conflict Resolution System 🎯
|
|
1853
1855
|
|
|
1854
|
-
**Spec 10-00**: Complete overhaul of `
|
|
1856
|
+
**Spec 10-00**: Complete overhaul of `sce adopt` conflict handling with interactive resolution
|
|
1855
1857
|
|
|
1856
1858
|
**Core Features**:
|
|
1857
1859
|
- **Interactive Conflict Resolution**: Choose how to handle each conflicting file
|
|
@@ -1907,19 +1909,19 @@ rm -rf .kiro/steering/workspaces
|
|
|
1907
1909
|
**Usage Examples**:
|
|
1908
1910
|
```bash
|
|
1909
1911
|
# Interactive mode (default) - prompts for each conflict
|
|
1910
|
-
|
|
1912
|
+
sce adopt
|
|
1911
1913
|
|
|
1912
1914
|
# Force mode - overwrite all conflicts with backup
|
|
1913
|
-
|
|
1915
|
+
sce adopt --force
|
|
1914
1916
|
|
|
1915
1917
|
# Auto mode - skip all conflicts automatically
|
|
1916
|
-
|
|
1918
|
+
sce adopt --auto
|
|
1917
1919
|
|
|
1918
1920
|
# Auto + force - overwrite all conflicts without prompts
|
|
1919
|
-
|
|
1921
|
+
sce adopt --auto --force
|
|
1920
1922
|
|
|
1921
1923
|
# Dry run - preview what would happen
|
|
1922
|
-
|
|
1924
|
+
sce adopt --dry-run
|
|
1923
1925
|
```
|
|
1924
1926
|
|
|
1925
1927
|
**Benefits**:
|
|
@@ -1941,35 +1943,35 @@ kse adopt --dry-run
|
|
|
1941
1943
|
## [1.6.4] - 2026-01-24
|
|
1942
1944
|
|
|
1943
1945
|
### Added
|
|
1944
|
-
- **Prominent clarification to prevent confusion with
|
|
1946
|
+
- **Prominent clarification to prevent confusion with AI IDE** 🎯
|
|
1945
1947
|
- Added warning box at top of README.md and README.zh.md
|
|
1946
|
-
- Clarifies that
|
|
1948
|
+
- Clarifies that sce is an npm package/CLI tool, NOT the AI IDE desktop application
|
|
1947
1949
|
- Updated package.json description to explicitly state the difference
|
|
1948
|
-
- **Triggered by**: Real user feedback - iFlow (using GLM-4.7) confused
|
|
1950
|
+
- **Triggered by**: Real user feedback - iFlow (using GLM-4.7) confused sce with AI IDE and tried to download the wrong software
|
|
1949
1951
|
|
|
1950
1952
|
**Why this matters:**
|
|
1951
|
-
- Prevents AI tools (especially smaller models) from confusing
|
|
1952
|
-
- Saves users time by immediately clarifying what
|
|
1953
|
+
- Prevents AI tools (especially smaller models) from confusing sce with AI IDE
|
|
1954
|
+
- Saves users time by immediately clarifying what sce is
|
|
1953
1955
|
- Improves first-time user experience
|
|
1954
1956
|
- Sets foundation for Spec 11 (comprehensive documentation alignment)
|
|
1955
1957
|
|
|
1956
1958
|
**User feedback that triggered this:**
|
|
1957
|
-
> "iFlow 用 GLM-4.7 好傻 下载
|
|
1958
|
-
> (iFlow using GLM-4.7 was silly and downloaded
|
|
1959
|
+
> "iFlow 用 GLM-4.7 好傻 下载 SCE 了"
|
|
1960
|
+
> (iFlow using GLM-4.7 was silly and downloaded SCE [IDE] instead)
|
|
1959
1961
|
|
|
1960
1962
|
## [1.6.3] - 2026-01-24
|
|
1961
1963
|
|
|
1962
1964
|
### Fixed
|
|
1963
1965
|
- **Fixed incorrect command recommendations in diagnostic tools** 🐛
|
|
1964
|
-
- Updated `lib/governance/diagnostic-engine.js` to recommend `
|
|
1966
|
+
- Updated `lib/governance/diagnostic-engine.js` to recommend `sce docs archive --spec <spec-name>` instead of `sce archive --spec <spec-name>`
|
|
1965
1967
|
- Updated `lib/commands/status.js` to show correct archive command in quick fix suggestions
|
|
1966
1968
|
- Fixed all related test expectations to match actual command structure
|
|
1967
|
-
- **Impact**: Users will now see correct commands when `
|
|
1968
|
-
- **Root cause**: Documentation/functionality mismatch - the actual command is `
|
|
1969
|
+
- **Impact**: Users will now see correct commands when `sce doctor --docs` or `sce status` detect misplaced artifacts
|
|
1970
|
+
- **Root cause**: Documentation/functionality mismatch - the actual command is `sce docs archive`, not `sce archive`
|
|
1969
1971
|
|
|
1970
1972
|
**Discovered from real user feedback:**
|
|
1971
|
-
> User's AI (Codex) tried to run `
|
|
1972
|
-
> based on `
|
|
1973
|
+
> User's AI (Codex) tried to run `sce archive --spec 01-00-user-space-diagnosis`
|
|
1974
|
+
> based on `sce doctor --docs` recommendation, but got `error: unknown command 'archive'`
|
|
1973
1975
|
|
|
1974
1976
|
**Why this matters:**
|
|
1975
1977
|
- Prevents user confusion when following system recommendations
|
|
@@ -1982,19 +1984,19 @@ kse adopt --dry-run
|
|
|
1982
1984
|
- **Simplified Quick Start based on real user feedback** 📝
|
|
1983
1985
|
- Added "The Simplest Way" section (30 seconds, one command to AI)
|
|
1984
1986
|
- Moved detailed steps into collapsible section
|
|
1985
|
-
- Reflects actual user experience: "Just tell AI to install and use
|
|
1987
|
+
- Reflects actual user experience: "Just tell AI to install and use sce"
|
|
1986
1988
|
- AI handles everything automatically (install, adopt, read docs, start working)
|
|
1987
1989
|
- Updated both English and Chinese README files
|
|
1988
1990
|
|
|
1989
1991
|
**User feedback:**
|
|
1990
|
-
> "I just told Codex to install
|
|
1992
|
+
> "I just told Codex to install sce, and it figured out how to use it.
|
|
1991
1993
|
> Then I just said 'use this mode to manage the project' and it worked."
|
|
1992
1994
|
|
|
1993
1995
|
**Why this matters:**
|
|
1994
1996
|
- Reduces perceived complexity from "5 minutes, 4 steps" to "30 seconds, 1 command"
|
|
1995
1997
|
- Matches real-world usage pattern
|
|
1996
1998
|
- Emphasizes AI autonomy rather than manual steps
|
|
1997
|
-
- Makes
|
|
1999
|
+
- Makes sce feel even more like "invisible infrastructure"
|
|
1998
2000
|
|
|
1999
2001
|
## [1.6.1] - 2026-01-24
|
|
2000
2002
|
|
|
@@ -2009,68 +2011,68 @@ kse adopt --dry-run
|
|
|
2009
2011
|
**Why this matters:**
|
|
2010
2012
|
- Previous code used string replacement which failed on Windows paths
|
|
2011
2013
|
- Could cause backup creation to fail silently or create backups in wrong locations
|
|
2012
|
-
- Critical for `
|
|
2014
|
+
- Critical for `sce adopt --force` conflict resolution feature
|
|
2013
2015
|
|
|
2014
2016
|
## [1.6.0] - 2026-01-24
|
|
2015
2017
|
|
|
2016
2018
|
### Changed - BREAKING CONCEPTUAL CHANGE 🎯
|
|
2017
2019
|
|
|
2018
|
-
**Repositioned
|
|
2020
|
+
**Repositioned sce from "tool" to "methodology enforcer"**
|
|
2019
2021
|
|
|
2020
|
-
This is a fundamental shift in how
|
|
2022
|
+
This is a fundamental shift in how sce should be understood and used:
|
|
2021
2023
|
|
|
2022
2024
|
**Before (WRONG approach):**
|
|
2023
|
-
- `.kiro/README.md` was a "
|
|
2024
|
-
- Taught AI "how to use
|
|
2025
|
+
- `.kiro/README.md` was a "sce command manual"
|
|
2026
|
+
- Taught AI "how to use sce tool"
|
|
2025
2027
|
- Listed 20+ commands with examples
|
|
2026
|
-
- Users had to "learn
|
|
2028
|
+
- Users had to "learn sce" before using it
|
|
2027
2029
|
|
|
2028
2030
|
**After (CORRECT approach):**
|
|
2029
2031
|
- `.kiro/README.md` is a "project development guide"
|
|
2030
2032
|
- Explains project follows Spec-driven methodology
|
|
2031
2033
|
- AI's role: follow the methodology, not learn the tool
|
|
2032
|
-
-
|
|
2034
|
+
- sce commands are helpers used automatically when needed
|
|
2033
2035
|
|
|
2034
2036
|
**Key insight from user feedback:**
|
|
2035
|
-
> "After installing
|
|
2036
|
-
> AI will understand the methodology and naturally use
|
|
2037
|
+
> "After installing sce, just tell AI to read .kiro/README.md.
|
|
2038
|
+
> AI will understand the methodology and naturally use sce commands
|
|
2037
2039
|
> to solve problems, rather than memorizing command syntax."
|
|
2038
2040
|
|
|
2039
2041
|
**What changed:**
|
|
2040
2042
|
- `.kiro/README.md` - Completely rewritten as methodology guide (not tool manual)
|
|
2041
|
-
- `
|
|
2043
|
+
- `sce adopt` completion message - Now says "Tell AI to read README" instead of "Create your first spec"
|
|
2042
2044
|
- `docs/quick-start.md` - Simplified from 5-minute tool tutorial to 2-minute methodology introduction
|
|
2043
2045
|
- Removed detailed Spec creation examples (that's AI's job, not user's manual work)
|
|
2044
2046
|
|
|
2045
2047
|
**Impact:**
|
|
2046
|
-
- Users don't need to "learn
|
|
2048
|
+
- Users don't need to "learn sce" anymore
|
|
2047
2049
|
- AI tools understand project methodology by reading README
|
|
2048
2050
|
- Natural workflow: User asks for feature → AI creates Spec → AI implements
|
|
2049
|
-
-
|
|
2051
|
+
- sce becomes invisible infrastructure, not a tool to master
|
|
2050
2052
|
|
|
2051
2053
|
**Migration:**
|
|
2052
|
-
- Existing projects: Run `
|
|
2054
|
+
- Existing projects: Run `sce adopt --force` to get new README
|
|
2053
2055
|
- Tell your AI: "Please read .kiro/README.md to understand project methodology"
|
|
2054
2056
|
- AI will automatically understand and follow Spec-driven approach
|
|
2055
2057
|
|
|
2056
|
-
This aligns
|
|
2058
|
+
This aligns sce with its true purpose: **enforcing development methodology**, not being a CLI tool to learn.
|
|
2057
2059
|
|
|
2058
2060
|
## [1.5.5] - 2026-01-24
|
|
2059
2061
|
|
|
2060
2062
|
### Added
|
|
2061
|
-
- AI-friendly `.kiro/README.md` template explaining
|
|
2062
|
-
- Comprehensive
|
|
2063
|
+
- AI-friendly `.kiro/README.md` template explaining sce commands and usage
|
|
2064
|
+
- Comprehensive sce command reference for AI tools (status, workflows, context export, etc.)
|
|
2063
2065
|
- AI workflow guide with step-by-step instructions for common tasks
|
|
2064
2066
|
- Spec structure documentation for AI understanding
|
|
2065
|
-
- Best practices section for AI tools using
|
|
2067
|
+
- Best practices section for AI tools using sce
|
|
2066
2068
|
|
|
2067
2069
|
### Changed
|
|
2068
|
-
- Updated `.kiro/README.md` template to focus on
|
|
2070
|
+
- Updated `.kiro/README.md` template to focus on sce CLI usage instead of SCE Spec system philosophy
|
|
2069
2071
|
- Simplified template file list in adoption strategy (removed obsolete files)
|
|
2070
2072
|
- Fixed template path in adoption strategy to point to correct location (`template/.kiro`)
|
|
2071
2073
|
|
|
2072
2074
|
### Fixed
|
|
2073
|
-
- AI tools can now understand what
|
|
2075
|
+
- AI tools can now understand what sce is and how to use it by reading `.kiro/README.md`
|
|
2074
2076
|
- Adoption command now correctly copies README from template
|
|
2075
2077
|
|
|
2076
2078
|
## [1.5.4] - 2026-01-24
|
|
@@ -2096,13 +2098,13 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2096
2098
|
## [1.5.0] - 2026-01-24
|
|
2097
2099
|
|
|
2098
2100
|
### Added
|
|
2099
|
-
- **Interactive conflict resolution for
|
|
2101
|
+
- **Interactive conflict resolution for sce adopt** 🎯 - Choose how to handle conflicting files
|
|
2100
2102
|
- Three resolution strategies: skip all, overwrite all, or review each file
|
|
2101
2103
|
- Per-file review with diff viewing capability
|
|
2102
2104
|
- Selective backup system (only backs up files being overwritten)
|
|
2103
2105
|
- Full support for --force, --auto, and --dry-run modes
|
|
2104
2106
|
- Clear conflict categorization (steering, documentation, tools)
|
|
2105
|
-
- Usage: `
|
|
2107
|
+
- Usage: `sce adopt` (interactive prompts when conflicts detected)
|
|
2106
2108
|
|
|
2107
2109
|
**Benefits**:
|
|
2108
2110
|
- Full control over which files to keep or overwrite
|
|
@@ -2113,11 +2115,11 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2113
2115
|
## [1.4.6] - 2026-01-24
|
|
2114
2116
|
|
|
2115
2117
|
### Added
|
|
2116
|
-
- **--force option for
|
|
2118
|
+
- **--force option for sce adopt** 🔥 - Force overwrite conflicting files during adoption
|
|
2117
2119
|
- Automatically creates backup before overwriting
|
|
2118
2120
|
- Shows clear warning when enabled
|
|
2119
2121
|
- Useful for upgrading template files to latest version
|
|
2120
|
-
- Usage: `
|
|
2122
|
+
- Usage: `sce adopt --force`
|
|
2121
2123
|
|
|
2122
2124
|
### Fixed
|
|
2123
2125
|
- Cross-platform path normalization test compatibility
|
|
@@ -2141,7 +2143,7 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2141
2143
|
|
|
2142
2144
|
**Benefits**:
|
|
2143
2145
|
- Clear guidance on when to use major vs minor numbers
|
|
2144
|
-
- Practical examples from real projects (
|
|
2146
|
+
- Practical examples from real projects (scene-capability-engine, e-commerce, SaaS)
|
|
2145
2147
|
- Decision tree for quick strategy selection
|
|
2146
2148
|
- Best practices and common pitfalls
|
|
2147
2149
|
- Supports both simple and complex project needs
|
|
@@ -2190,46 +2192,46 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2190
2192
|
|
|
2191
2193
|
**Documentation Improvements**:
|
|
2192
2194
|
- Corrected Integration Workflow diagram in README.md and README.zh.md
|
|
2193
|
-
- Changed flow from "User →
|
|
2195
|
+
- Changed flow from "User → sce → User → AI Tool" to "User ↔ AI Tool ↔ sce"
|
|
2194
2196
|
- Added key insight: "You stay in your AI tool. The AI reads the Spec and generates code."
|
|
2195
2197
|
- Both English and Chinese versions updated
|
|
2196
2198
|
|
|
2197
2199
|
### Why This Matters
|
|
2198
2200
|
|
|
2199
|
-
This patch ensures CI/CD pipeline works correctly and reinforces the correct mental model: users stay in their AI tool, which calls
|
|
2201
|
+
This patch ensures CI/CD pipeline works correctly and reinforces the correct mental model: users stay in their AI tool, which calls sce behind the scenes.
|
|
2200
2202
|
|
|
2201
2203
|
## [1.4.1] - 2026-01-23
|
|
2202
2204
|
|
|
2203
2205
|
### Fixed - Documentation Clarity 🎯
|
|
2204
2206
|
|
|
2205
2207
|
**Corrected Integration Flow**:
|
|
2206
|
-
- **Fixed sequence diagrams** - Now correctly show "User ↔ AI Tool ↔
|
|
2207
|
-
- **Emphasized AI-driven workflow** - AI tools call
|
|
2208
|
-
- **Clarified positioning** -
|
|
2208
|
+
- **Fixed sequence diagrams** - Now correctly show "User ↔ AI Tool ↔ sce" instead of "User → sce → AI Tool"
|
|
2209
|
+
- **Emphasized AI-driven workflow** - AI tools call sce directly, users stay in their familiar interface
|
|
2210
|
+
- **Clarified positioning** - sce works behind the scenes, users don't "switch tools"
|
|
2209
2211
|
|
|
2210
2212
|
**Updated Documentation**:
|
|
2211
|
-
- `README.md` - Rewrote Step 4 to emphasize AI tool calls
|
|
2213
|
+
- `README.md` - Rewrote Step 4 to emphasize AI tool calls sce automatically
|
|
2212
2214
|
- `README.zh.md` - Chinese version updated to match
|
|
2213
2215
|
- `docs/integration-modes.md` - Fixed sequence diagrams and workflow descriptions
|
|
2214
2216
|
|
|
2215
2217
|
**Key Message**:
|
|
2216
2218
|
- ✅ Users continue using their preferred AI tool (Cursor, Claude, Windsurf, etc.)
|
|
2217
|
-
- ✅ AI tool calls
|
|
2219
|
+
- ✅ AI tool calls sce commands during conversation
|
|
2218
2220
|
- ✅ No "tool switching" - seamless integration
|
|
2219
|
-
- ✅
|
|
2221
|
+
- ✅ sce is the "context provider" working behind the scenes
|
|
2220
2222
|
|
|
2221
2223
|
### Why This Matters
|
|
2222
2224
|
|
|
2223
|
-
Users are already comfortable with their AI tools.
|
|
2225
|
+
Users are already comfortable with their AI tools. sce enhances their existing workflow by providing structured context, not by replacing their tools. This patch clarifies that positioning.
|
|
2224
2226
|
|
|
2225
2227
|
## [1.4.0] - 2026-01-23
|
|
2226
2228
|
|
|
2227
2229
|
### Added - User Onboarding and Documentation Overhaul 📚
|
|
2228
2230
|
|
|
2229
2231
|
**Complete Documentation Restructure**:
|
|
2230
|
-
- **New Positioning**: Repositioned
|
|
2232
|
+
- **New Positioning**: Repositioned sce as "A context provider for AI coding tools"
|
|
2231
2233
|
- **Three-Tier Structure**: README → Core Guides → Tool-Specific Guides
|
|
2232
|
-
- **"What
|
|
2234
|
+
- **"What sce is NOT" Section**: Clear clarification of sce's role
|
|
2233
2235
|
|
|
2234
2236
|
**New Documentation** (20+ new files):
|
|
2235
2237
|
- **Quick Start Guide** (`docs/quick-start.md`): Complete 5-minute tutorial with user-login example
|
|
@@ -2237,7 +2239,7 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2237
2239
|
- Cursor Integration Guide
|
|
2238
2240
|
- Claude Code Integration Guide
|
|
2239
2241
|
- Windsurf Integration Guide
|
|
2240
|
-
-
|
|
2242
|
+
- SCE Integration Guide
|
|
2241
2243
|
- VS Code + Copilot Integration Guide
|
|
2242
2244
|
- Generic AI Tools Guide
|
|
2243
2245
|
- **Core Guides**:
|
|
@@ -2274,7 +2276,7 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2274
2276
|
|
|
2275
2277
|
- **README.md**: Complete restructure with embedded quick start and clear positioning
|
|
2276
2278
|
- **README.zh.md**: Updated to match new English structure
|
|
2277
|
-
- All documentation now emphasizes
|
|
2279
|
+
- All documentation now emphasizes sce's role as a context provider for AI tools
|
|
2278
2280
|
|
|
2279
2281
|
### Improved
|
|
2280
2282
|
|
|
@@ -2313,13 +2315,13 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2313
2315
|
- Status reporting and metrics
|
|
2314
2316
|
|
|
2315
2317
|
**CLI Commands** (7 commands):
|
|
2316
|
-
- `
|
|
2317
|
-
- `
|
|
2318
|
-
- `
|
|
2319
|
-
- `
|
|
2320
|
-
- `
|
|
2321
|
-
- `
|
|
2322
|
-
- `
|
|
2318
|
+
- `sce watch init` - Initialize watch configuration
|
|
2319
|
+
- `sce watch start/stop` - Control watch mode
|
|
2320
|
+
- `sce watch status` - Show current status
|
|
2321
|
+
- `sce watch logs` - View execution logs (with tail/follow)
|
|
2322
|
+
- `sce watch metrics` - Display automation metrics
|
|
2323
|
+
- `sce watch presets` - List available presets
|
|
2324
|
+
- `sce watch install <preset>` - Install automation preset
|
|
2323
2325
|
|
|
2324
2326
|
**Automation Presets** (4 presets):
|
|
2325
2327
|
- `auto-sync` - Automatically sync workspace when tasks.md changes
|
|
@@ -2328,14 +2330,14 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2328
2330
|
- `test-runner` - Run tests when source files change
|
|
2329
2331
|
|
|
2330
2332
|
**Tool Detection & Auto-Configuration**:
|
|
2331
|
-
- Automatic IDE detection (
|
|
2333
|
+
- Automatic IDE detection (AI IDE, VS Code, Cursor)
|
|
2332
2334
|
- Tool-specific automation recommendations
|
|
2333
2335
|
- Auto-configuration during project adoption
|
|
2334
2336
|
- Confidence-based suggestions
|
|
2335
2337
|
|
|
2336
2338
|
**Manual Workflows** (6 workflows):
|
|
2337
2339
|
- Complete workflow guide (300+ lines)
|
|
2338
|
-
- `
|
|
2340
|
+
- `sce workflows` command for workflow management
|
|
2339
2341
|
- Step-by-step instructions with time estimates
|
|
2340
2342
|
- Interactive checklists for common tasks
|
|
2341
2343
|
- Workflows: task-sync, context-export, prompt-generation, daily, task-completion, spec-creation
|
|
@@ -2399,9 +2401,9 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2399
2401
|
- `validateProject()`: Complete project validation
|
|
2400
2402
|
- **Automatic Version Checking**: Detect version mismatches
|
|
2401
2403
|
- VersionChecker class for automatic version detection
|
|
2402
|
-
- Warning display when project version differs from installed
|
|
2404
|
+
- Warning display when project version differs from installed sce
|
|
2403
2405
|
- `--no-version-check` flag to suppress warnings
|
|
2404
|
-
- `
|
|
2406
|
+
- `sce version-info` command for detailed version information
|
|
2405
2407
|
- **Enhanced Testing**: Added tests for validation and version checking
|
|
2406
2408
|
- 7 new unit tests for validation system
|
|
2407
2409
|
- 4 new unit tests for version checker
|
|
@@ -2428,9 +2430,9 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2428
2430
|
- Backup validation and integrity checking
|
|
2429
2431
|
- Easy rollback to previous states
|
|
2430
2432
|
- **New CLI Commands**:
|
|
2431
|
-
- `
|
|
2432
|
-
- `
|
|
2433
|
-
- `
|
|
2433
|
+
- `sce adopt`: Adopt existing projects into Scene Capability Engine
|
|
2434
|
+
- `sce upgrade`: Upgrade project to newer version
|
|
2435
|
+
- `sce rollback`: Restore project from backup
|
|
2434
2436
|
- **Core Components**:
|
|
2435
2437
|
- DetectionEngine: Analyzes project structure and determines adoption strategy
|
|
2436
2438
|
- AdoptionStrategy: Implements fresh, partial, and full adoption modes
|
|
@@ -2470,7 +2472,7 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2470
2472
|
- Added semver dependency for version comparison
|
|
2471
2473
|
- Created lib/version/ directory for version management
|
|
2472
2474
|
- Created lib/utils/ directory for shared utilities
|
|
2473
|
-
- Prepared foundation for
|
|
2475
|
+
- Prepared foundation for sce adopt and sce upgrade commands
|
|
2474
2476
|
|
|
2475
2477
|
### Documentation
|
|
2476
2478
|
- Created spec 02-00-project-adoption-and-upgrade
|