scene-capability-engine 3.0.0 → 3.0.2
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 +234 -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 +11 -11
- 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/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 +22 -22
- package/docs/moqui-template-core-library-playbook.md +20 -20
- 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 +93 -93
- 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 +29 -29
- 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 +1 -1
- 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/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 +5 -6
- 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,39 +8,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
10
|
### Added
|
|
11
|
-
- **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` / `
|
|
11
|
+
- **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.
|
|
12
|
+
- **Branding consistency release guard**: Added `test:brand-consistency` to block publish when legacy repository/package/product naming reappears in tracked source files.
|
|
12
13
|
- **Rate-limit launch budget safety guard**: Hardened orchestration launch-budget bookkeeping to safely handle partially initialized engine instances in property/instrumentation scenarios.
|
|
13
14
|
- **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.
|
|
14
|
-
- **Moqui runtime binding config overrides**: Added `--moqui-config <path>` to `
|
|
15
|
+
- **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.
|
|
15
16
|
- **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`.
|
|
16
17
|
- **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.
|
|
17
|
-
- **Scene ontology impact/path analysis commands**: Added `
|
|
18
|
+
- **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.
|
|
18
19
|
- **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.
|
|
19
20
|
- **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.
|
|
20
21
|
- **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`.
|
|
21
|
-
- **Unified autonomous observability snapshot**: Added `
|
|
22
|
-
- **Agent-facing spec JSON interfaces**: Added `
|
|
23
|
-
- **Autonomous archive schema compatibility tooling**: Added `
|
|
24
|
-
- **Governance resumed-session filtering and ratio telemetry**: `
|
|
25
|
-
- **Governance close-loop post-run retention hook**: Added `--governance-session-keep` and `--governance-session-older-than-days` to `
|
|
26
|
-
- **Governance resume drift guardrails**: `
|
|
27
|
-
- **Governance session maintenance commands**: Added `
|
|
22
|
+
- **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.
|
|
23
|
+
- **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.
|
|
24
|
+
- **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.
|
|
25
|
+
- **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.
|
|
26
|
+
- **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`.
|
|
27
|
+
- **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.
|
|
28
|
+
- **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`).
|
|
28
29
|
- **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.
|
|
29
|
-
- **Governance close-loop advisory execution**: Added optional advisory action execution to `
|
|
30
|
-
- **Governance close-loop rounds command**: Added `
|
|
31
|
-
- **Governance maintenance close-loop command**: Added `
|
|
32
|
-
- **Cross-archive governance stats command**: Added `
|
|
33
|
-
- **Session and batch session stats commands**: Added `
|
|
34
|
-
- **Controller session stats command**: Added `
|
|
35
|
-
- **Session list status filtering + composition telemetry**: `
|
|
36
|
-
- **KPI mode composition telemetry**: `
|
|
30
|
+
- **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.
|
|
31
|
+
- **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`).
|
|
32
|
+
- **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.
|
|
33
|
+
- **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).
|
|
34
|
+
- **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.
|
|
35
|
+
- **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.
|
|
36
|
+
- **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.
|
|
37
|
+
- **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.
|
|
37
38
|
- **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.
|
|
38
|
-
- **Controller session maintenance commands**: Added `
|
|
39
|
-
- **Controller-aware autonomous KPI trend mode**: `
|
|
39
|
+
- **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.
|
|
40
|
+
- **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).
|
|
40
41
|
- **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`).
|
|
41
42
|
- **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.
|
|
42
|
-
- **Persistent close-loop queue controller**: Added `
|
|
43
|
-
- **KPI sample generator command**: Added `
|
|
43
|
+
- **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.
|
|
44
|
+
- **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.
|
|
44
45
|
- **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.
|
|
45
46
|
- **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`).
|
|
46
47
|
- **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.
|
|
@@ -48,13 +49,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
48
49
|
- **Value metrics helper test coverage**: Added deterministic tests for ISO week period derivation and sample payload structure in command-level unit tests.
|
|
49
50
|
- **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.
|
|
50
51
|
- **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.
|
|
51
|
-
- **Autonomous close-loop command**: Added `
|
|
52
|
-
- **Definition-of-Done gates for close-loop**: Added configurable completion gates for `
|
|
52
|
+
- **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.
|
|
53
|
+
- **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.
|
|
53
54
|
- **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.
|
|
54
|
-
- **Close-loop session resume**: Added session snapshot persistence for `
|
|
55
|
-
- **Close-loop session hygiene commands**: Added `
|
|
56
|
-
- **Spec directory retention commands**: Added `
|
|
57
|
-
- **Active spec protection in retention prune**: `
|
|
55
|
+
- **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.
|
|
56
|
+
- **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.
|
|
57
|
+
- **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.
|
|
58
|
+
- **Active spec protection in retention prune**: `sce auto spec-session prune` now protects active/recently referenced specs by default (`--no-protect-active` to override).
|
|
58
59
|
- **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.
|
|
59
60
|
- **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.
|
|
60
61
|
- **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.
|
|
@@ -62,10 +63,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
62
63
|
- **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.
|
|
63
64
|
- **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.
|
|
64
65
|
- **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.
|
|
65
|
-
- **Autonomous KPI trend command**: Added `
|
|
66
|
-
- **Autonomous KPI trend period/csv/anomaly enhancement**: Extended `
|
|
66
|
+
- **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.
|
|
67
|
+
- **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.
|
|
67
68
|
- **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.
|
|
68
|
-
- **Close-loop multi-goal batch command**: Added `
|
|
69
|
+
- **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.
|
|
69
70
|
- **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.
|
|
70
71
|
- **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.
|
|
71
72
|
- **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`).
|
|
@@ -75,10 +76,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
75
76
|
- **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.
|
|
76
77
|
- **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.
|
|
77
78
|
- **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`.
|
|
78
|
-
- **Close-loop batch session maintenance commands**: Added `
|
|
79
|
+
- **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.
|
|
79
80
|
- **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.
|
|
80
81
|
- **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.
|
|
81
|
-
- **Close-loop program command**: Added `
|
|
82
|
+
- **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.
|
|
82
83
|
- **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).
|
|
83
84
|
- **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.
|
|
84
85
|
- **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.
|
|
@@ -86,30 +87,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
86
87
|
- **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.
|
|
87
88
|
- **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.
|
|
88
89
|
- **Close-loop program remediation diagnostics**: Added `program_diagnostics` (`failure_clusters` + prioritized `remediation_actions`) to turn program KPI output into actionable convergence guidance.
|
|
89
|
-
- **Close-loop recovery command**: Added `
|
|
90
|
+
- **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.
|
|
90
91
|
- **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.
|
|
91
92
|
- **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.
|
|
92
|
-
- **Recovery memory lifecycle commands**: Added `
|
|
93
|
-
- **Recovery memory scope analytics command**: Added `
|
|
93
|
+
- **Recovery memory lifecycle commands**: Added `sce auto recovery-memory show|prune|clear` to inspect, prune, and reset persisted recovery strategy memory.
|
|
94
|
+
- **Recovery memory scope analytics command**: Added `sce auto recovery-memory scopes` to inspect aggregate recovery-memory statistics grouped by scope.
|
|
94
95
|
- **Criticality-priority scheduler mode**: Added `--batch-priority critical-first` with per-goal criticality telemetry in `resource_plan` and result summaries.
|
|
95
96
|
- **Goal decomposition quality diagnostics**: Added `generated_from_goal.quality` (score, coverage ratio, warnings) for program/batch semantic decomposition observability.
|
|
96
97
|
- **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.
|
|
97
98
|
- **Goal decomposition hard quality gate**: Added `--program-quality-gate` to fail execution when final decomposition quality remains below threshold after refinement.
|
|
98
99
|
- **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.
|
|
99
|
-
- **Scoped recovery memory maintenance**: `
|
|
100
|
+
- **Scoped recovery memory maintenance**: `sce auto recovery-memory show|prune` now support `--scope <scope>` for targeted inspection and cleanup.
|
|
100
101
|
- **Program gate fallback observability**: Program outputs now include `program_gate_fallbacks` and `program_gate_effective` fields for full fallback decision traceability.
|
|
101
|
-
- **Program-level auto recovery loop**: `
|
|
102
|
+
- **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.
|
|
102
103
|
- **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.
|
|
103
104
|
- **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.
|
|
104
105
|
- **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.
|
|
105
|
-
- **Close-loop auto session retention policy**: Added `--session-keep` and `--session-older-than-days` to `
|
|
106
|
+
- **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.
|
|
106
107
|
- **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.
|
|
107
108
|
- **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.
|
|
108
109
|
- **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.
|
|
109
110
|
- **Goal decomposition engine**: Added heuristic portfolio planner for automatic sub-spec splitting, dependency wiring, and deterministic spec prefix allocation.
|
|
110
111
|
- **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.
|
|
111
112
|
- **Autonomous close-loop tests**: Added unit coverage for decomposition strategy and close-loop runner behavior (plan-only and execution paths).
|
|
112
|
-
- **Autonomous CLI end-to-end regression**: Added integration coverage for `
|
|
113
|
+
- **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.
|
|
113
114
|
- **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.
|
|
114
115
|
- **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`.
|
|
115
116
|
- **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.
|
|
@@ -123,15 +124,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
123
124
|
- **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.
|
|
124
125
|
- **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.
|
|
125
126
|
- **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.
|
|
126
|
-
- **Positioning and onboarding messaging**: Strengthened EN/ZH README and quick-start docs with explicit
|
|
127
|
-
- **CLI first-screen positioning text**: Updated `
|
|
127
|
+
- **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.
|
|
128
|
+
- **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.
|
|
128
129
|
- **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).
|
|
129
|
-
- **Value metrics operator guidance**: Enhanced snapshot/baseline/trend failure messages with actionable follow-up commands (including `
|
|
130
|
+
- **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.
|
|
130
131
|
- **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.
|
|
131
132
|
- **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.
|
|
132
|
-
- **Watch log operator flow**: Implemented `
|
|
133
|
+
- **Watch log operator flow**: Implemented `sce watch logs --follow` streaming behavior and documented follow examples in command reference.
|
|
133
134
|
- **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.
|
|
134
|
-
- **Autonomy positioning clarity**: Strengthened EN/ZH docs and command reference to emphasize closed-loop delivery and automatic master/sub spec decomposition as
|
|
135
|
+
- **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.
|
|
135
136
|
- **Autonomous operator UX**: Expanded docs with semantic decomposition and live stream behavior for close-loop command usage.
|
|
136
137
|
|
|
137
138
|
### Fixed
|
|
@@ -160,21 +161,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
160
161
|
## [1.46.1] - 2026-02-13
|
|
161
162
|
|
|
162
163
|
### Fixed
|
|
163
|
-
- **NPM publish metadata normalization**: Updated `package.json` `bin` entries to use `bin/
|
|
164
|
+
- **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.
|
|
164
165
|
- **Repository metadata format**: Normalized `repository.url` to `git+https://github.com/heguangyong/scene-capability-engine.git` to remove npm publish auto-correction warnings.
|
|
165
166
|
|
|
166
167
|
## [1.46.0] - 2026-02-13
|
|
167
168
|
|
|
168
169
|
### Added
|
|
169
|
-
- **Spec bootstrap command**: Added `
|
|
170
|
-
- **Spec pipeline command**: Added `
|
|
171
|
-
- **Spec gate command**: Added `
|
|
170
|
+
- **Spec bootstrap command**: Added `sce spec bootstrap` to generate `requirements.md`, `design.md`, and `tasks.md` drafts in one step.
|
|
171
|
+
- **Spec pipeline command**: Added `sce spec pipeline run` for staged Spec workflow execution with structured progress output.
|
|
172
|
+
- **Spec gate command**: Added `sce spec gate run` to standardize gate checks and produce machine-readable gate reports.
|
|
172
173
|
- **Multi-spec orchestrate helper**: Added shared helper logic for parsing multi-spec targets and routing execution through orchestrate runtime.
|
|
173
174
|
- **Coverage for new spec workflow**: Added unit tests for bootstrap/pipeline/gate commands and multi-spec orchestrate default behavior.
|
|
174
175
|
|
|
175
176
|
### Changed
|
|
176
|
-
- **Default multi-spec execution mode**: `
|
|
177
|
-
- **CLI spec command routing**: Improved `
|
|
177
|
+
- **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.
|
|
178
|
+
- **CLI spec command routing**: Improved `sce spec` command routing for new subcommands while preserving backward compatibility for legacy paths.
|
|
178
179
|
- **Documentation alignment**: Updated EN/ZH docs to promote the new spec-first workflow and document multi-spec default orchestrate behavior.
|
|
179
180
|
|
|
180
181
|
## [1.45.13] - 2026-02-13
|
|
@@ -231,12 +232,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
231
232
|
## [1.45.4] - 2026-02-13
|
|
232
233
|
|
|
233
234
|
### Fixed
|
|
234
|
-
- **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 `
|
|
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 `sce upgrade`
|
|
235
236
|
|
|
236
237
|
## [1.45.3] - 2026-02-13
|
|
237
238
|
|
|
238
239
|
### Fixed
|
|
239
|
-
- **Self-dependency removed**: Removed erroneous `
|
|
240
|
+
- **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
|
|
240
241
|
|
|
241
242
|
## [1.45.2] - 2026-02-13
|
|
242
243
|
|
|
@@ -260,10 +261,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
260
261
|
- **AgentSpawner** (`lib/orchestrator/agent-spawner.js`): Process manager for Codex CLI sub-agents with timeout detection, graceful termination (SIGTERM → SIGKILL), and event emission
|
|
261
262
|
- **StatusMonitor** (`lib/orchestrator/status-monitor.js`): Codex JSON Lines event parsing, per-Spec status tracking, orchestration-level status aggregation
|
|
262
263
|
- **OrchestrationEngine** (`lib/orchestrator/orchestration-engine.js`): Core engine with DAG-based dependency analysis, batch scheduling, parallel execution (≤ maxParallel), failure propagation, and retry mechanism
|
|
263
|
-
- **CLI Commands** (`
|
|
264
|
-
- `
|
|
265
|
-
- `
|
|
266
|
-
- `
|
|
264
|
+
- **CLI Commands** (`sce orchestrate`):
|
|
265
|
+
- `sce orchestrate run --specs "spec-a,spec-b" --max-parallel 3` — Start multi-agent orchestration
|
|
266
|
+
- `sce orchestrate status` — View orchestration progress
|
|
267
|
+
- `sce orchestrate stop` — Gracefully stop all sub-agents
|
|
267
268
|
- 11 correctness properties verified via property-based testing (fast-check)
|
|
268
269
|
- 236+ new tests across unit, property, and integration test suites
|
|
269
270
|
|
|
@@ -285,8 +286,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
285
286
|
## [1.43.1] - 2026-02-11
|
|
286
287
|
|
|
287
288
|
### Changed
|
|
288
|
-
- **Agent Onboarding Document** (`template/.kiro/README.md`, `.kiro/README.md`): Comprehensive rewrite of "
|
|
289
|
-
- **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
|
|
289
|
+
- **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)
|
|
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 sce capabilities
|
|
290
291
|
|
|
291
292
|
## [1.43.0] - 2026-02-11
|
|
292
293
|
|
|
@@ -319,13 +320,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
319
320
|
- `LINEAGE_SOURCE_NOT_IN_BINDINGS`, `LINEAGE_SINK_NOT_IN_BINDINGS`
|
|
320
321
|
- `EMPTY_AGENT_SUMMARY`, `INVALID_AGENT_COMPLEXITY`, `INVALID_AGENT_DURATION`
|
|
321
322
|
- **Agent Readiness Score**: New bonus dimension (max +10) in quality score calculator
|
|
322
|
-
- **CLI Commands** (`
|
|
323
|
-
- `
|
|
324
|
-
- `
|
|
325
|
-
- `
|
|
326
|
-
- `
|
|
327
|
-
- `
|
|
328
|
-
- `
|
|
323
|
+
- **CLI Commands** (`sce scene ontology`):
|
|
324
|
+
- `sce scene ontology show` — Display ontology graph
|
|
325
|
+
- `sce scene ontology deps --ref <ref>` — Query dependency chain
|
|
326
|
+
- `sce scene ontology validate` — Validate graph consistency
|
|
327
|
+
- `sce scene ontology actions --ref <ref>` — Show action abstraction
|
|
328
|
+
- `sce scene ontology lineage --ref <ref>` — Show data lineage
|
|
329
|
+
- `sce scene ontology agent-info` — Show agent hints
|
|
329
330
|
|
|
330
331
|
## [1.41.0] - 2026-02-11
|
|
331
332
|
|
|
@@ -342,15 +343,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
342
343
|
- **Quality Score Calculator**: 4-dimension scoring with 0-100 scale
|
|
343
344
|
- Contract validity, lint pass rate, documentation quality, governance completeness
|
|
344
345
|
- Configurable dimension weights
|
|
345
|
-
- `
|
|
346
|
+
- `sce scene lint` — Lint scene package for quality issues
|
|
346
347
|
- `--package <path>` scene package directory
|
|
347
348
|
- `--strict` treat warnings as errors
|
|
348
349
|
- `--json` structured JSON output
|
|
349
|
-
- `
|
|
350
|
+
- `sce scene score` — Calculate quality score (0-100)
|
|
350
351
|
- `--package <path>` scene package directory
|
|
351
352
|
- `--strict` fail if score below threshold (default 60)
|
|
352
353
|
- `--json` structured JSON output
|
|
353
|
-
- `
|
|
354
|
+
- `sce scene contribute` — One-stop contribute pipeline: validate → lint → score → publish
|
|
354
355
|
- `--package <path>` scene package directory
|
|
355
356
|
- `--registry <dir>` custom registry directory
|
|
356
357
|
- `--skip-lint` skip lint step
|
|
@@ -362,12 +363,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
362
363
|
### Added
|
|
363
364
|
- **Moqui Scene Template Extractor**: Extract reusable scene templates from live Moqui ERP instances
|
|
364
365
|
- `MoquiExtractor` — Analyze discovered Moqui resources, identify business patterns (crud/query/workflow), generate scene template bundles
|
|
365
|
-
- Built-in YAML serializer for scene manifests (`
|
|
366
|
+
- Built-in YAML serializer for scene manifests (`sce.scene/v0.2` apiVersion)
|
|
366
367
|
- Entity grouping by Header/Item suffix patterns (e.g., OrderHeader + OrderItem → composite pattern)
|
|
367
368
|
- Pattern-based manifest generation with governance contracts (risk_level, approval, idempotency)
|
|
368
|
-
- Package contract generation (`
|
|
369
|
+
- Package contract generation (`sce.scene.package/v0.1` apiVersion) with template parameters
|
|
369
370
|
- Template bundle file writing with partial failure resilience
|
|
370
|
-
- `
|
|
371
|
+
- `sce scene extract` — Extract scene templates from Moqui ERP instance
|
|
371
372
|
- `--config <path>` custom adapter config path
|
|
372
373
|
- `--type <type>` filter discovery by resource type (entities|services|screens)
|
|
373
374
|
- `--pattern <pattern>` filter by business pattern (crud|query|workflow)
|
|
@@ -384,10 +385,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
384
385
|
- **Moqui ERP Adapter**: Integrate Moqui ERP instance into KSE scene runtime
|
|
385
386
|
- `MoquiClient` — HTTP client with JWT auth lifecycle (login, refresh, re-login, logout), retry logic using Node.js built-in `http`/`https`
|
|
386
387
|
- `MoquiAdapter` — Binding handler for `spec.erp.*` and `moqui.*` refs, entity CRUD, service invocation, screen discovery
|
|
387
|
-
- `
|
|
388
|
+
- `sce scene connect` — Test connectivity and authentication to Moqui ERP instance
|
|
388
389
|
- `--config <path>` custom adapter config path
|
|
389
390
|
- `--json` structured JSON output
|
|
390
|
-
- `
|
|
391
|
+
- `sce scene discover` — Discover available entities, services, and screens from Moqui ERP
|
|
391
392
|
- `--config <path>` custom adapter config path
|
|
392
393
|
- `--type <type>` filter by catalog type (entities|services|screens)
|
|
393
394
|
- `--json` structured JSON output
|
|
@@ -399,13 +400,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
399
400
|
|
|
400
401
|
### Added
|
|
401
402
|
- **Scene Registry Statistics**: Dashboard for local scene package registry metrics
|
|
402
|
-
- `
|
|
403
|
+
- `sce scene stats` show aggregate statistics (packages, versions, tags, ownership, deprecation, last publish)
|
|
403
404
|
- `--registry <dir>` custom registry directory
|
|
404
405
|
- `--json` structured JSON output
|
|
405
406
|
- **Scene Version Locking**: Protect specific package versions from accidental unpublish
|
|
406
|
-
- `
|
|
407
|
-
- `
|
|
408
|
-
- `
|
|
407
|
+
- `sce scene lock set --name <pkg> --version <ver>` lock a version
|
|
408
|
+
- `sce scene lock rm --name <pkg> --version <ver>` unlock a version
|
|
409
|
+
- `sce scene lock ls --name <pkg>` list locked versions
|
|
409
410
|
- `--registry <dir>` custom registry directory
|
|
410
411
|
- `--json` structured JSON output
|
|
411
412
|
- Lock state stored as `locked: true` on version entries in `registry-index.json`
|
|
@@ -414,9 +415,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
414
415
|
|
|
415
416
|
### Added
|
|
416
417
|
- **Scene Distribution Tags**: Manage distribution tags on scene packages in local registry
|
|
417
|
-
- `
|
|
418
|
-
- `
|
|
419
|
-
- `
|
|
418
|
+
- `sce scene tag add --name <pkg> --tag <tag> --version <ver>` add a distribution tag
|
|
419
|
+
- `sce scene tag rm --name <pkg> --tag <tag>` remove a distribution tag
|
|
420
|
+
- `sce scene tag ls --name <pkg>` list all tags and latest version
|
|
420
421
|
- `--registry <dir>` custom registry directory
|
|
421
422
|
- `--json` structured JSON output
|
|
422
423
|
- Tags stored as `tags` object on package entry, separate from `latest` field
|
|
@@ -426,10 +427,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
426
427
|
|
|
427
428
|
### Added
|
|
428
429
|
- **Scene Package Ownership**: Manage package ownership metadata in local registry
|
|
429
|
-
- `
|
|
430
|
-
- `
|
|
431
|
-
- `
|
|
432
|
-
- `
|
|
430
|
+
- `sce scene owner set --name <pkg> --owner <owner>` set package owner
|
|
431
|
+
- `sce scene owner show --name <pkg>` display current owner
|
|
432
|
+
- `sce scene owner list --owner <owner>` list packages by owner (case-insensitive)
|
|
433
|
+
- `sce scene owner transfer --name <pkg> --from <old> --to <new>` transfer ownership
|
|
433
434
|
- `--remove` clear owner field
|
|
434
435
|
- `--registry <dir>` custom registry directory
|
|
435
436
|
- `--json` structured JSON output
|
|
@@ -440,7 +441,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
440
441
|
|
|
441
442
|
### Added
|
|
442
443
|
- **Scene Registry Audit**: Health check for local scene package registry
|
|
443
|
-
- `
|
|
444
|
+
- `sce scene audit` scan registry index, verify tarball existence and SHA-256 integrity
|
|
444
445
|
- `--registry <dir>` custom registry directory (default `.kiro/registry`)
|
|
445
446
|
- `--fix` auto-remove orphaned tarballs and clean missing-tarball index entries
|
|
446
447
|
- `--json` structured JSON output
|
|
@@ -451,7 +452,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
451
452
|
|
|
452
453
|
### Added
|
|
453
454
|
- **Scene Package Deprecation**: Mark/unmark package versions as deprecated in local registry
|
|
454
|
-
- `
|
|
455
|
+
- `sce scene deprecate --name <pkg> --message <msg>` deprecate all versions
|
|
455
456
|
- `--version <v>` target specific version
|
|
456
457
|
- `--undo` remove deprecation marker
|
|
457
458
|
- `--registry <dir>` custom registry directory
|
|
@@ -466,7 +467,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
466
467
|
|
|
467
468
|
### Added
|
|
468
469
|
- **Scene Package Directory Validation**: Comprehensive validation for scene package directories
|
|
469
|
-
- `
|
|
470
|
+
- `sce scene package-validate --package <dir>` now supports directory-level validation
|
|
470
471
|
- `--strict` treat warnings as errors (exit code 1)
|
|
471
472
|
- `--json` structured JSON output
|
|
472
473
|
- Validates `scene-package.json` existence and required fields
|
|
@@ -483,7 +484,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
483
484
|
|
|
484
485
|
### Added
|
|
485
486
|
- **Scene Package Info**: Display detailed package information from local registry
|
|
486
|
-
- `
|
|
487
|
+
- `sce scene info --name <packageName>` show package details
|
|
487
488
|
- `--registry <dir>` custom registry directory
|
|
488
489
|
- `--json` structured JSON output
|
|
489
490
|
- `--versions-only` show only version list
|
|
@@ -497,7 +498,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
497
498
|
|
|
498
499
|
### Added
|
|
499
500
|
- **Scene Package Diff**: Compare two versions of a scene package in the local registry
|
|
500
|
-
- `
|
|
501
|
+
- `sce scene diff --name <pkg> --from <v1> --to <v2>` compare package versions
|
|
501
502
|
- `--registry <dir>` custom registry directory
|
|
502
503
|
- `--json` structured JSON output
|
|
503
504
|
- `--stat` show only file change summary
|
|
@@ -512,7 +513,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
512
513
|
|
|
513
514
|
### Added
|
|
514
515
|
- **Scene Version Bump**: Bump version in scene-package.json following semver
|
|
515
|
-
- `
|
|
516
|
+
- `sce scene version --bump <major|minor|patch|x.y.z>` bump scene package version
|
|
516
517
|
- `--package <dir>` scene package directory (default: current directory)
|
|
517
518
|
- `--dry-run` preview without writing
|
|
518
519
|
- `--json` structured JSON output
|
|
@@ -525,10 +526,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
525
526
|
|
|
526
527
|
### Added
|
|
527
528
|
- **Scene Registry Query**: List and search scene packages in local registry
|
|
528
|
-
- `
|
|
529
|
+
- `sce scene list` list all packages in registry
|
|
529
530
|
- `--registry <dir>` custom registry directory
|
|
530
531
|
- `--json` structured JSON output
|
|
531
|
-
- `
|
|
532
|
+
- `sce scene search --query <term>` search packages by keyword
|
|
532
533
|
- Case-insensitive substring matching on name, description, and group
|
|
533
534
|
- `--registry <dir>` custom registry directory
|
|
534
535
|
- `--json` structured JSON output
|
|
@@ -540,7 +541,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
540
541
|
|
|
541
542
|
### Added
|
|
542
543
|
- **Scene Package Install**: Install published scene packages from local registry
|
|
543
|
-
- `
|
|
544
|
+
- `sce scene install --name <packageName>` install scene package from registry
|
|
544
545
|
- `--version <version>` exact version or omit for latest
|
|
545
546
|
- `--out <dir>` custom target directory (default: `./{packageName}`)
|
|
546
547
|
- `--registry <dir>` custom registry directory
|
|
@@ -558,12 +559,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
558
559
|
|
|
559
560
|
### Added
|
|
560
561
|
- **Scene Package Registry Publish/Unpublish**: Local registry-based publish and unpublish for scene packages
|
|
561
|
-
- `
|
|
562
|
+
- `sce scene publish --package <path>` publish scene package to local registry
|
|
562
563
|
- `--registry <dir>` custom registry directory
|
|
563
564
|
- `--dry-run` preview without writing
|
|
564
565
|
- `--force` overwrite existing version
|
|
565
566
|
- `--json` structured JSON output
|
|
566
|
-
- `
|
|
567
|
+
- `sce scene unpublish --name <name> --version <version>` remove published version
|
|
567
568
|
- `--registry <dir>` custom registry directory
|
|
568
569
|
- `--json` structured JSON output
|
|
569
570
|
- Tarball bundling with SHA-256 integrity verification
|
|
@@ -576,7 +577,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
576
577
|
## [1.26.0] - 2026-02-10
|
|
577
578
|
|
|
578
579
|
### Added
|
|
579
|
-
- **Scene Template Instantiation**: Complete `
|
|
580
|
+
- **Scene Template Instantiation**: Complete `sce scene instantiate` command for template package instantiation
|
|
580
581
|
- `--package <name>` select template package, `--values <json|file>` supply variables
|
|
581
582
|
- `--out <dir>` output directory, `--template-dir <dir>` custom template root
|
|
582
583
|
- `--list` list available packages, `--dry-run` preview without writing
|
|
@@ -586,13 +587,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
586
587
|
- Post-instantiate hook execution via `post-instantiate` script in scene-package.json
|
|
587
588
|
- Implements Spec 76-00-scene-template-instantiation
|
|
588
589
|
|
|
589
|
-
- **Default Agent Hooks in Adopt**: `
|
|
590
|
+
- **Default Agent Hooks in Adopt**: `sce adopt` now creates 3 default hooks in `.kiro/hooks/`
|
|
590
591
|
- `run-tests-on-save.kiro.hook` - Manual trigger to run tests (userTriggered)
|
|
591
592
|
- `check-spec-on-create.kiro.hook` - Validate spec structure on creation (fileCreated)
|
|
592
593
|
- `sync-tasks-on-edit.kiro.hook` - Sync workspace on tasks.md edit (fileEdited)
|
|
593
594
|
- Hooks directory added to all adoption strategies (fresh/partial/full)
|
|
594
595
|
|
|
595
|
-
- **
|
|
596
|
+
- **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.
|
|
596
597
|
|
|
597
598
|
## [1.25.0] - 2026-02-09
|
|
598
599
|
|
|
@@ -603,9 +604,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
603
604
|
- **Multi-File Template Rendering**: Recursive file processing with `{{variable}}` substitution, `{{#if}}` conditionals, `{{#each}}` loops, and unresolved placeholder passthrough
|
|
604
605
|
- **Three-Layer Inheritance Resolution**: L1-Capability / L2-Domain / L3-Instance package hierarchy with variable schema and file merging, cycle detection
|
|
605
606
|
- **CLI Commands**:
|
|
606
|
-
- `
|
|
607
|
-
- `
|
|
608
|
-
- `
|
|
607
|
+
- `sce scene template-validate --package <path>` - Validate template variable schema in scene-package.json
|
|
608
|
+
- `sce scene template-resolve --package <name>` - Resolve full inheritance chain and display merged schema
|
|
609
|
+
- `sce scene template-render --package <name> --values <json> --out <dir>` - Render template package with variable substitution
|
|
609
610
|
- All commands support `--json` output mode
|
|
610
611
|
- Reuses existing package registry and contract validation infrastructure
|
|
611
612
|
|
|
@@ -658,13 +659,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
658
659
|
- **User Knowledge Management System (MVP)**: Personal knowledge base for capturing project experiences
|
|
659
660
|
- **Knowledge Base**: Organize patterns, lessons, workflows, checklists, and references
|
|
660
661
|
- **CLI Commands**: Complete command set for knowledge management
|
|
661
|
-
- `
|
|
662
|
-
- `
|
|
663
|
-
- `
|
|
664
|
-
- `
|
|
665
|
-
- `
|
|
666
|
-
- `
|
|
667
|
-
- `
|
|
662
|
+
- `sce knowledge init` - Initialize knowledge base
|
|
663
|
+
- `sce knowledge add <type> <title>` - Add new entry (pattern/lesson/workflow/checklist/reference)
|
|
664
|
+
- `sce knowledge list` - List all entries with filtering and sorting
|
|
665
|
+
- `sce knowledge search <keyword>` - Search entries (title, tags, content)
|
|
666
|
+
- `sce knowledge show <id>` - Display entry details
|
|
667
|
+
- `sce knowledge delete <id>` - Delete entry with backup
|
|
668
|
+
- `sce knowledge stats` - Show statistics
|
|
668
669
|
- **Entry Types**: Five built-in types with customizable templates
|
|
669
670
|
- Pattern: Design patterns and architectural solutions
|
|
670
671
|
- Lesson: Lessons learned from experience
|
|
@@ -711,7 +712,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
711
712
|
- Weighted average estimation (more weight to recent data)
|
|
712
713
|
- Improved completion time estimates over multiple executions
|
|
713
714
|
- Historical data persistence to `.kiro/auto/historical-data.json`
|
|
714
|
-
- **CORE_PRINCIPLES Compliance**: Automatic verification of
|
|
715
|
+
- **CORE_PRINCIPLES Compliance**: Automatic verification of sce project structure
|
|
715
716
|
- Checks for `.kiro` directory (adoption marker)
|
|
716
717
|
- Validates `version.json`, `specs/`, `steering/` directories
|
|
717
718
|
- Ensures Spec-driven development workflow compliance
|
|
@@ -755,12 +756,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
755
756
|
- `CheckpointManager`: Checkpoint creation and rollback with user approval workflow
|
|
756
757
|
- `AutonomousEngine`: Central orchestrator integrating all managers
|
|
757
758
|
- **CLI Commands**: Complete command set for autonomous execution
|
|
758
|
-
- `
|
|
759
|
-
- `
|
|
760
|
-
- `
|
|
761
|
-
- `
|
|
762
|
-
- `
|
|
763
|
-
- `
|
|
759
|
+
- `sce auto create <description>`: Create and run Spec autonomously from feature description
|
|
760
|
+
- `sce auto run <spec>`: Execute existing Spec tasks autonomously
|
|
761
|
+
- `sce auto status`: Display current execution state and progress
|
|
762
|
+
- `sce auto resume`: Resume from last checkpoint after pause
|
|
763
|
+
- `sce auto stop`: Gracefully stop execution and save state
|
|
764
|
+
- `sce auto config`: View and update autonomous execution configuration
|
|
764
765
|
- **Key Features**:
|
|
765
766
|
- Continuous task execution without interruption
|
|
766
767
|
- Automatic error recovery with strategy learning
|
|
@@ -817,12 +818,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
817
818
|
- **Integration Testing**: Run cross-Spec integration tests to verify modules work together correctly
|
|
818
819
|
- **Dependency Visualization**: View dependency graphs with critical path highlighting
|
|
819
820
|
- **CLI Commands**: Complete set of commands for collaboration management
|
|
820
|
-
- `
|
|
821
|
-
- `
|
|
822
|
-
- `
|
|
823
|
-
- `
|
|
824
|
-
- `
|
|
825
|
-
- `
|
|
821
|
+
- `sce collab init` - Initialize Master Spec with Sub-Specs
|
|
822
|
+
- `sce collab status` - Display collaboration status and dependency graph
|
|
823
|
+
- `sce collab assign` - Assign Specs to SCE instances
|
|
824
|
+
- `sce collab verify` - Verify interface contract compliance
|
|
825
|
+
- `sce collab integrate` - Run integration tests across Specs
|
|
826
|
+
- `sce collab migrate` - Convert standalone Spec to collaborative mode
|
|
826
827
|
- **Backward Compatible**: Opt-in system that doesn't affect existing single-Spec workflows
|
|
827
828
|
- **Comprehensive Documentation**: Complete guide with examples and best practices
|
|
828
829
|
|
|
@@ -964,7 +965,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
964
965
|
- Parent reference validation now correctly matches parent paths with repository paths
|
|
965
966
|
- Improved error messages to include available paths when validation fails
|
|
966
967
|
- **Git Command Duplication**: Fixed command execution that duplicated "git" prefix
|
|
967
|
-
- `
|
|
968
|
+
- `sce repo exec "git branch"` now correctly executes "git branch" instead of "git git branch"
|
|
968
969
|
- Command trimming and prefix detection added to RepoManager.execInRepo()
|
|
969
970
|
- **Backward Compatibility**: All existing configurations work without changes
|
|
970
971
|
- Existing single-repository configurations function identically
|
|
@@ -980,7 +981,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
980
981
|
|
|
981
982
|
### Added
|
|
982
983
|
- **Nested Repository Support**: Discover and manage Git repositories nested inside other repositories
|
|
983
|
-
- `
|
|
984
|
+
- `sce repo init` now scans inside Git repositories to find nested subrepositories by default
|
|
984
985
|
- Added `--nested` and `--no-nested` flags to control scanning behavior
|
|
985
986
|
- Parent-child relationships tracked in configuration with `parent` field
|
|
986
987
|
- Display parent relationships in status and health commands
|
|
@@ -1042,10 +1043,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1042
1043
|
|
|
1043
1044
|
### Added
|
|
1044
1045
|
- **Multi-Repository Management**: Complete feature for managing multiple Git subrepositories
|
|
1045
|
-
- `
|
|
1046
|
-
- `
|
|
1047
|
-
- `
|
|
1048
|
-
- `
|
|
1046
|
+
- `sce repo init`: Auto-discover and initialize repository configuration
|
|
1047
|
+
- `sce repo status`: View status of all repositories in unified table
|
|
1048
|
+
- `sce repo exec`: Execute Git commands across all repositories
|
|
1049
|
+
- `sce repo health`: Verify repository configuration and connectivity
|
|
1049
1050
|
- Configuration stored in `.kiro/project-repos.json`
|
|
1050
1051
|
- Support for repository groups, tags, and metadata
|
|
1051
1052
|
- Cross-platform path handling (Windows/Linux/macOS)
|
|
@@ -1094,7 +1095,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1094
1095
|
- **Steering Rules**: Enhanced with automatic version sync workflow
|
|
1095
1096
|
|
|
1096
1097
|
### Notes
|
|
1097
|
-
- This release ensures AI tools stay synchronized with
|
|
1098
|
+
- This release ensures AI tools stay synchronized with sce version updates
|
|
1098
1099
|
- All 1491 tests passing
|
|
1099
1100
|
|
|
1100
1101
|
## [1.18.0] - 2026-01-31
|
|
@@ -1127,7 +1128,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1127
1128
|
|
|
1128
1129
|
### Added
|
|
1129
1130
|
- **Template Creation from Existing Spec**: Automated workflow to convert completed Specs into reusable templates
|
|
1130
|
-
- CLI command: `
|
|
1131
|
+
- CLI command: `sce templates create-from-spec --spec <identifier> [options]`
|
|
1131
1132
|
- Automatic content generalization (replaces project-specific details with template variables)
|
|
1132
1133
|
- Interactive metadata collection (name, description, category, tags, author, version)
|
|
1133
1134
|
- YAML frontmatter generation for all template files
|
|
@@ -1181,10 +1182,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1181
1182
|
### Added
|
|
1182
1183
|
- **Spec Template Library**: Complete template management system for rapid Spec creation
|
|
1183
1184
|
- Browse, search, and apply pre-built Spec templates from official and custom sources
|
|
1184
|
-
- Template discovery: `
|
|
1185
|
-
- Template management: `
|
|
1186
|
-
- Custom sources: `
|
|
1187
|
-
- Create Spec from template: `
|
|
1185
|
+
- Template discovery: `sce templates list`, `sce templates search <keyword>`, `sce templates show <template-id>`
|
|
1186
|
+
- Template management: `sce templates update`, `sce templates cache`, `sce templates guide`
|
|
1187
|
+
- Custom sources: `sce templates add-source <name> <url>`, `sce templates remove-source <name>`, `sce templates sources`
|
|
1188
|
+
- Create Spec from template: `sce spec create <name> --template <template-id>`
|
|
1188
1189
|
- Local caching for offline use (~/.kse/templates/)
|
|
1189
1190
|
- Multi-source support with conflict resolution (source:template-id format)
|
|
1190
1191
|
- Automatic variable substitution ({{SPEC_NAME}}, {{DATE}}, {{AUTHOR}}, etc.)
|
|
@@ -1209,7 +1210,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1209
1210
|
- Only requires user intervention for: fatal errors, external resources, major architecture decisions, final acceptance
|
|
1210
1211
|
- Added "避免重复测试" (Avoid Redundant Testing) clarification
|
|
1211
1212
|
- Skip tests if just executed during Spec implementation
|
|
1212
|
-
- Handles
|
|
1213
|
+
- Handles SCE's file-save-triggered subagent scenario
|
|
1213
1214
|
|
|
1214
1215
|
### Notes
|
|
1215
1216
|
- All existing tests pass (1491 tests)
|
|
@@ -1223,8 +1224,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1223
1224
|
- **.gitignore Auto-Fix for Team Collaboration**: Automatic detection and fixing of .gitignore configuration
|
|
1224
1225
|
- Detects old blanket `.kiro/` exclusion patterns that prevent Spec sharing
|
|
1225
1226
|
- Replaces with layered strategy: commit Specs, exclude personal state
|
|
1226
|
-
- Integrated into `
|
|
1227
|
-
- Standalone command: `
|
|
1227
|
+
- Integrated into `sce adopt` and `sce upgrade` flows (automatic)
|
|
1228
|
+
- Standalone command: `sce doctor --fix-gitignore`
|
|
1228
1229
|
- Creates backup before modification (stored in `.kiro/backups/gitignore-{timestamp}`)
|
|
1229
1230
|
- Preserves all user rules (non-.kiro patterns)
|
|
1230
1231
|
- Handles different line endings (CRLF/LF) correctly
|
|
@@ -1253,7 +1254,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1253
1254
|
- Rollback capability to restore previous environment state
|
|
1254
1255
|
- Support for multiple configuration file mappings per environment
|
|
1255
1256
|
- Environment verification with custom commands (optional)
|
|
1256
|
-
- Commands: `
|
|
1257
|
+
- Commands: `sce env list`, `sce env switch`, `sce env info`, `sce env register`, `sce env unregister`, `sce env rollback`
|
|
1257
1258
|
- Comprehensive user documentation in `docs/environment-management-guide.md`
|
|
1258
1259
|
- 66 unit tests covering all core functionality
|
|
1259
1260
|
|
|
@@ -1261,7 +1262,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1261
1262
|
- **EnvironmentRegistry**: JSON-based persistent storage (`.kiro/environments.json`)
|
|
1262
1263
|
- **EnvironmentManager**: Core logic for environment operations
|
|
1263
1264
|
- **BackupSystem**: Automatic backup/restore with history management
|
|
1264
|
-
- **CLI Integration**: Seamless integration with existing
|
|
1265
|
+
- **CLI Integration**: Seamless integration with existing sce commands
|
|
1265
1266
|
- **Cross-platform**: Consistent behavior on Windows, Linux, and Mac
|
|
1266
1267
|
|
|
1267
1268
|
## [1.13.1] - 2026-01-29
|
|
@@ -1308,9 +1309,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1308
1309
|
- Added complete directory structure documentation with purpose explanations
|
|
1309
1310
|
- Added workspace management section with detailed usage examples
|
|
1310
1311
|
- Added document governance section with validation commands
|
|
1311
|
-
- Added data storage location details for `
|
|
1312
|
+
- Added data storage location details for `sce workspace` feature
|
|
1312
1313
|
- Added JSON data structure examples for workspace-state.json
|
|
1313
|
-
- Clarified difference between `
|
|
1314
|
+
- Clarified difference between `sce workspace` (cross-project) and `contexts/` (multi-user)
|
|
1314
1315
|
- Added key features list for workspace management
|
|
1315
1316
|
|
|
1316
1317
|
### Changed
|
|
@@ -1340,7 +1341,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1340
1341
|
|
|
1341
1342
|
### Fixed
|
|
1342
1343
|
- **Critical**: Registered `workspace` command in CLI that was missing from v1.12.0
|
|
1343
|
-
- Added workspace command registration in `bin/
|
|
1344
|
+
- Added workspace command registration in `bin/scene-capability-engine.js`
|
|
1344
1345
|
- All workspace subcommands now available: create, list, switch, remove, info
|
|
1345
1346
|
- Fixes issue where users couldn't access multi-workspace management features
|
|
1346
1347
|
|
|
@@ -1400,11 +1401,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1400
1401
|
|
|
1401
1402
|
### Fixed - CRITICAL: Workspace Context Pollution 🚨
|
|
1402
1403
|
|
|
1403
|
-
**HOTFIX**: Fixed critical bug where
|
|
1404
|
+
**HOTFIX**: Fixed critical bug where AI IDE reads all workspace contexts
|
|
1404
1405
|
|
|
1405
1406
|
**Critical Issue**:
|
|
1406
1407
|
- Workspace contexts were stored in `.kiro/steering/workspaces/`
|
|
1407
|
-
-
|
|
1408
|
+
- AI IDE reads ALL `.md` files in `steering/` directory
|
|
1408
1409
|
- This caused ALL personal CURRENT_CONTEXT.md files to be read simultaneously
|
|
1409
1410
|
- Result: Context pollution, confusion, and incorrect AI behavior
|
|
1410
1411
|
|
|
@@ -1417,8 +1418,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
1417
1418
|
```
|
|
1418
1419
|
.kiro/
|
|
1419
1420
|
├── steering/
|
|
1420
|
-
│ └── CURRENT_CONTEXT.md ← Only active context (read by
|
|
1421
|
-
└── contexts/ ← Personal workspaces (NOT read by
|
|
1421
|
+
│ └── CURRENT_CONTEXT.md ← Only active context (read by SCE)
|
|
1422
|
+
└── contexts/ ← Personal workspaces (NOT read by SCE)
|
|
1422
1423
|
├── developer1/
|
|
1423
1424
|
│ └── CURRENT_CONTEXT.md
|
|
1424
1425
|
└── developer2/
|
|
@@ -1500,15 +1501,15 @@ rm -rf .kiro/steering/workspaces
|
|
|
1500
1501
|
|
|
1501
1502
|
### Added - Multi-Workspace Management 🚀
|
|
1502
1503
|
|
|
1503
|
-
**Spec 16-00**: Complete multi-workspace management system for managing multiple
|
|
1504
|
+
**Spec 16-00**: Complete multi-workspace management system for managing multiple sce projects
|
|
1504
1505
|
|
|
1505
1506
|
**New Features**:
|
|
1506
1507
|
- **Workspace Management Commands**
|
|
1507
|
-
- `
|
|
1508
|
-
- `
|
|
1509
|
-
- `
|
|
1510
|
-
- `
|
|
1511
|
-
- `
|
|
1508
|
+
- `sce workspace create <name> [path]` - Register a new workspace
|
|
1509
|
+
- `sce workspace list` - List all registered workspaces
|
|
1510
|
+
- `sce workspace switch <name>` - Switch active workspace
|
|
1511
|
+
- `sce workspace remove <name>` - Remove workspace from registry
|
|
1512
|
+
- `sce workspace info [name]` - Display workspace details
|
|
1512
1513
|
- **Data Atomicity Architecture**
|
|
1513
1514
|
- Single source of truth: `~/.kse/workspace-state.json`
|
|
1514
1515
|
- Atomic operations for all workspace state changes
|
|
@@ -1545,7 +1546,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1545
1546
|
- Session summary and completion report
|
|
1546
1547
|
|
|
1547
1548
|
**Benefits**:
|
|
1548
|
-
- Manage multiple
|
|
1549
|
+
- Manage multiple sce projects from a single location
|
|
1549
1550
|
- Quick workspace switching without directory navigation
|
|
1550
1551
|
- Consistent workspace state across all operations
|
|
1551
1552
|
- Foundation for future cross-workspace features
|
|
@@ -1599,7 +1600,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1599
1600
|
|
|
1600
1601
|
### Added - Adopt Command UX Improvement 🎉
|
|
1601
1602
|
|
|
1602
|
-
**Spec 14-00**: Complete UX overhaul for the `
|
|
1603
|
+
**Spec 14-00**: Complete UX overhaul for the `sce adopt` command with zero-interaction smart adoption
|
|
1603
1604
|
|
|
1604
1605
|
**Phase 1: Core Smart Adoption**
|
|
1605
1606
|
- **Smart Orchestrator**: Zero-interaction adoption coordinator
|
|
@@ -1687,7 +1688,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1687
1688
|
- Clear problem descriptions (non-technical language)
|
|
1688
1689
|
- Possible causes listing
|
|
1689
1690
|
- Actionable solutions
|
|
1690
|
-
- Help references (
|
|
1691
|
+
- Help references (sce doctor, documentation)
|
|
1691
1692
|
- Consistent formatting across all errors
|
|
1692
1693
|
|
|
1693
1694
|
**Phase 3: Advanced Features**
|
|
@@ -1787,11 +1788,11 @@ rm -rf .kiro/steering/workspaces
|
|
|
1787
1788
|
- Clear error reporting with missing elements
|
|
1788
1789
|
|
|
1789
1790
|
**New CLI Commands**:
|
|
1790
|
-
- `
|
|
1791
|
-
- `
|
|
1792
|
-
- `
|
|
1793
|
-
- `
|
|
1794
|
-
- `
|
|
1791
|
+
- `sce ops init <project-name>` - Initialize operations specs from templates
|
|
1792
|
+
- `sce ops validate [<project-name>]` - Validate operations spec completeness
|
|
1793
|
+
- `sce ops audit [options]` - Query audit logs with filtering
|
|
1794
|
+
- `sce ops takeover <action> [options]` - Manage takeover levels
|
|
1795
|
+
- `sce ops feedback <action> [options]` - Manage user feedback
|
|
1795
1796
|
|
|
1796
1797
|
**New Components**:
|
|
1797
1798
|
- `lib/operations/operations-manager.js` - Operations spec lifecycle management
|
|
@@ -1850,7 +1851,7 @@ rm -rf .kiro/steering/workspaces
|
|
|
1850
1851
|
|
|
1851
1852
|
### Added - Interactive Conflict Resolution System 🎯
|
|
1852
1853
|
|
|
1853
|
-
**Spec 10-00**: Complete overhaul of `
|
|
1854
|
+
**Spec 10-00**: Complete overhaul of `sce adopt` conflict handling with interactive resolution
|
|
1854
1855
|
|
|
1855
1856
|
**Core Features**:
|
|
1856
1857
|
- **Interactive Conflict Resolution**: Choose how to handle each conflicting file
|
|
@@ -1906,19 +1907,19 @@ rm -rf .kiro/steering/workspaces
|
|
|
1906
1907
|
**Usage Examples**:
|
|
1907
1908
|
```bash
|
|
1908
1909
|
# Interactive mode (default) - prompts for each conflict
|
|
1909
|
-
|
|
1910
|
+
sce adopt
|
|
1910
1911
|
|
|
1911
1912
|
# Force mode - overwrite all conflicts with backup
|
|
1912
|
-
|
|
1913
|
+
sce adopt --force
|
|
1913
1914
|
|
|
1914
1915
|
# Auto mode - skip all conflicts automatically
|
|
1915
|
-
|
|
1916
|
+
sce adopt --auto
|
|
1916
1917
|
|
|
1917
1918
|
# Auto + force - overwrite all conflicts without prompts
|
|
1918
|
-
|
|
1919
|
+
sce adopt --auto --force
|
|
1919
1920
|
|
|
1920
1921
|
# Dry run - preview what would happen
|
|
1921
|
-
|
|
1922
|
+
sce adopt --dry-run
|
|
1922
1923
|
```
|
|
1923
1924
|
|
|
1924
1925
|
**Benefits**:
|
|
@@ -1940,35 +1941,35 @@ kse adopt --dry-run
|
|
|
1940
1941
|
## [1.6.4] - 2026-01-24
|
|
1941
1942
|
|
|
1942
1943
|
### Added
|
|
1943
|
-
- **Prominent clarification to prevent confusion with
|
|
1944
|
+
- **Prominent clarification to prevent confusion with AI IDE** 🎯
|
|
1944
1945
|
- Added warning box at top of README.md and README.zh.md
|
|
1945
|
-
- Clarifies that
|
|
1946
|
+
- Clarifies that sce is an npm package/CLI tool, NOT the AI IDE desktop application
|
|
1946
1947
|
- Updated package.json description to explicitly state the difference
|
|
1947
|
-
- **Triggered by**: Real user feedback - iFlow (using GLM-4.7) confused
|
|
1948
|
+
- **Triggered by**: Real user feedback - iFlow (using GLM-4.7) confused sce with AI IDE and tried to download the wrong software
|
|
1948
1949
|
|
|
1949
1950
|
**Why this matters:**
|
|
1950
|
-
- Prevents AI tools (especially smaller models) from confusing
|
|
1951
|
-
- Saves users time by immediately clarifying what
|
|
1951
|
+
- Prevents AI tools (especially smaller models) from confusing sce with AI IDE
|
|
1952
|
+
- Saves users time by immediately clarifying what sce is
|
|
1952
1953
|
- Improves first-time user experience
|
|
1953
1954
|
- Sets foundation for Spec 11 (comprehensive documentation alignment)
|
|
1954
1955
|
|
|
1955
1956
|
**User feedback that triggered this:**
|
|
1956
|
-
> "iFlow 用 GLM-4.7 好傻 下载
|
|
1957
|
-
> (iFlow using GLM-4.7 was silly and downloaded
|
|
1957
|
+
> "iFlow 用 GLM-4.7 好傻 下载 SCE 了"
|
|
1958
|
+
> (iFlow using GLM-4.7 was silly and downloaded SCE [IDE] instead)
|
|
1958
1959
|
|
|
1959
1960
|
## [1.6.3] - 2026-01-24
|
|
1960
1961
|
|
|
1961
1962
|
### Fixed
|
|
1962
1963
|
- **Fixed incorrect command recommendations in diagnostic tools** 🐛
|
|
1963
|
-
- Updated `lib/governance/diagnostic-engine.js` to recommend `
|
|
1964
|
+
- Updated `lib/governance/diagnostic-engine.js` to recommend `sce docs archive --spec <spec-name>` instead of `sce archive --spec <spec-name>`
|
|
1964
1965
|
- Updated `lib/commands/status.js` to show correct archive command in quick fix suggestions
|
|
1965
1966
|
- Fixed all related test expectations to match actual command structure
|
|
1966
|
-
- **Impact**: Users will now see correct commands when `
|
|
1967
|
-
- **Root cause**: Documentation/functionality mismatch - the actual command is `
|
|
1967
|
+
- **Impact**: Users will now see correct commands when `sce doctor --docs` or `sce status` detect misplaced artifacts
|
|
1968
|
+
- **Root cause**: Documentation/functionality mismatch - the actual command is `sce docs archive`, not `sce archive`
|
|
1968
1969
|
|
|
1969
1970
|
**Discovered from real user feedback:**
|
|
1970
|
-
> User's AI (Codex) tried to run `
|
|
1971
|
-
> based on `
|
|
1971
|
+
> User's AI (Codex) tried to run `sce archive --spec 01-00-user-space-diagnosis`
|
|
1972
|
+
> based on `sce doctor --docs` recommendation, but got `error: unknown command 'archive'`
|
|
1972
1973
|
|
|
1973
1974
|
**Why this matters:**
|
|
1974
1975
|
- Prevents user confusion when following system recommendations
|
|
@@ -1981,19 +1982,19 @@ kse adopt --dry-run
|
|
|
1981
1982
|
- **Simplified Quick Start based on real user feedback** 📝
|
|
1982
1983
|
- Added "The Simplest Way" section (30 seconds, one command to AI)
|
|
1983
1984
|
- Moved detailed steps into collapsible section
|
|
1984
|
-
- Reflects actual user experience: "Just tell AI to install and use
|
|
1985
|
+
- Reflects actual user experience: "Just tell AI to install and use sce"
|
|
1985
1986
|
- AI handles everything automatically (install, adopt, read docs, start working)
|
|
1986
1987
|
- Updated both English and Chinese README files
|
|
1987
1988
|
|
|
1988
1989
|
**User feedback:**
|
|
1989
|
-
> "I just told Codex to install
|
|
1990
|
+
> "I just told Codex to install sce, and it figured out how to use it.
|
|
1990
1991
|
> Then I just said 'use this mode to manage the project' and it worked."
|
|
1991
1992
|
|
|
1992
1993
|
**Why this matters:**
|
|
1993
1994
|
- Reduces perceived complexity from "5 minutes, 4 steps" to "30 seconds, 1 command"
|
|
1994
1995
|
- Matches real-world usage pattern
|
|
1995
1996
|
- Emphasizes AI autonomy rather than manual steps
|
|
1996
|
-
- Makes
|
|
1997
|
+
- Makes sce feel even more like "invisible infrastructure"
|
|
1997
1998
|
|
|
1998
1999
|
## [1.6.1] - 2026-01-24
|
|
1999
2000
|
|
|
@@ -2008,68 +2009,68 @@ kse adopt --dry-run
|
|
|
2008
2009
|
**Why this matters:**
|
|
2009
2010
|
- Previous code used string replacement which failed on Windows paths
|
|
2010
2011
|
- Could cause backup creation to fail silently or create backups in wrong locations
|
|
2011
|
-
- Critical for `
|
|
2012
|
+
- Critical for `sce adopt --force` conflict resolution feature
|
|
2012
2013
|
|
|
2013
2014
|
## [1.6.0] - 2026-01-24
|
|
2014
2015
|
|
|
2015
2016
|
### Changed - BREAKING CONCEPTUAL CHANGE 🎯
|
|
2016
2017
|
|
|
2017
|
-
**Repositioned
|
|
2018
|
+
**Repositioned sce from "tool" to "methodology enforcer"**
|
|
2018
2019
|
|
|
2019
|
-
This is a fundamental shift in how
|
|
2020
|
+
This is a fundamental shift in how sce should be understood and used:
|
|
2020
2021
|
|
|
2021
2022
|
**Before (WRONG approach):**
|
|
2022
|
-
- `.kiro/README.md` was a "
|
|
2023
|
-
- Taught AI "how to use
|
|
2023
|
+
- `.kiro/README.md` was a "sce command manual"
|
|
2024
|
+
- Taught AI "how to use sce tool"
|
|
2024
2025
|
- Listed 20+ commands with examples
|
|
2025
|
-
- Users had to "learn
|
|
2026
|
+
- Users had to "learn sce" before using it
|
|
2026
2027
|
|
|
2027
2028
|
**After (CORRECT approach):**
|
|
2028
2029
|
- `.kiro/README.md` is a "project development guide"
|
|
2029
2030
|
- Explains project follows Spec-driven methodology
|
|
2030
2031
|
- AI's role: follow the methodology, not learn the tool
|
|
2031
|
-
-
|
|
2032
|
+
- sce commands are helpers used automatically when needed
|
|
2032
2033
|
|
|
2033
2034
|
**Key insight from user feedback:**
|
|
2034
|
-
> "After installing
|
|
2035
|
-
> AI will understand the methodology and naturally use
|
|
2035
|
+
> "After installing sce, just tell AI to read .kiro/README.md.
|
|
2036
|
+
> AI will understand the methodology and naturally use sce commands
|
|
2036
2037
|
> to solve problems, rather than memorizing command syntax."
|
|
2037
2038
|
|
|
2038
2039
|
**What changed:**
|
|
2039
2040
|
- `.kiro/README.md` - Completely rewritten as methodology guide (not tool manual)
|
|
2040
|
-
- `
|
|
2041
|
+
- `sce adopt` completion message - Now says "Tell AI to read README" instead of "Create your first spec"
|
|
2041
2042
|
- `docs/quick-start.md` - Simplified from 5-minute tool tutorial to 2-minute methodology introduction
|
|
2042
2043
|
- Removed detailed Spec creation examples (that's AI's job, not user's manual work)
|
|
2043
2044
|
|
|
2044
2045
|
**Impact:**
|
|
2045
|
-
- Users don't need to "learn
|
|
2046
|
+
- Users don't need to "learn sce" anymore
|
|
2046
2047
|
- AI tools understand project methodology by reading README
|
|
2047
2048
|
- Natural workflow: User asks for feature → AI creates Spec → AI implements
|
|
2048
|
-
-
|
|
2049
|
+
- sce becomes invisible infrastructure, not a tool to master
|
|
2049
2050
|
|
|
2050
2051
|
**Migration:**
|
|
2051
|
-
- Existing projects: Run `
|
|
2052
|
+
- Existing projects: Run `sce adopt --force` to get new README
|
|
2052
2053
|
- Tell your AI: "Please read .kiro/README.md to understand project methodology"
|
|
2053
2054
|
- AI will automatically understand and follow Spec-driven approach
|
|
2054
2055
|
|
|
2055
|
-
This aligns
|
|
2056
|
+
This aligns sce with its true purpose: **enforcing development methodology**, not being a CLI tool to learn.
|
|
2056
2057
|
|
|
2057
2058
|
## [1.5.5] - 2026-01-24
|
|
2058
2059
|
|
|
2059
2060
|
### Added
|
|
2060
|
-
- AI-friendly `.kiro/README.md` template explaining
|
|
2061
|
-
- Comprehensive
|
|
2061
|
+
- AI-friendly `.kiro/README.md` template explaining sce commands and usage
|
|
2062
|
+
- Comprehensive sce command reference for AI tools (status, workflows, context export, etc.)
|
|
2062
2063
|
- AI workflow guide with step-by-step instructions for common tasks
|
|
2063
2064
|
- Spec structure documentation for AI understanding
|
|
2064
|
-
- Best practices section for AI tools using
|
|
2065
|
+
- Best practices section for AI tools using sce
|
|
2065
2066
|
|
|
2066
2067
|
### Changed
|
|
2067
|
-
- Updated `.kiro/README.md` template to focus on
|
|
2068
|
+
- Updated `.kiro/README.md` template to focus on sce CLI usage instead of SCE Spec system philosophy
|
|
2068
2069
|
- Simplified template file list in adoption strategy (removed obsolete files)
|
|
2069
2070
|
- Fixed template path in adoption strategy to point to correct location (`template/.kiro`)
|
|
2070
2071
|
|
|
2071
2072
|
### Fixed
|
|
2072
|
-
- AI tools can now understand what
|
|
2073
|
+
- AI tools can now understand what sce is and how to use it by reading `.kiro/README.md`
|
|
2073
2074
|
- Adoption command now correctly copies README from template
|
|
2074
2075
|
|
|
2075
2076
|
## [1.5.4] - 2026-01-24
|
|
@@ -2095,13 +2096,13 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2095
2096
|
## [1.5.0] - 2026-01-24
|
|
2096
2097
|
|
|
2097
2098
|
### Added
|
|
2098
|
-
- **Interactive conflict resolution for
|
|
2099
|
+
- **Interactive conflict resolution for sce adopt** 🎯 - Choose how to handle conflicting files
|
|
2099
2100
|
- Three resolution strategies: skip all, overwrite all, or review each file
|
|
2100
2101
|
- Per-file review with diff viewing capability
|
|
2101
2102
|
- Selective backup system (only backs up files being overwritten)
|
|
2102
2103
|
- Full support for --force, --auto, and --dry-run modes
|
|
2103
2104
|
- Clear conflict categorization (steering, documentation, tools)
|
|
2104
|
-
- Usage: `
|
|
2105
|
+
- Usage: `sce adopt` (interactive prompts when conflicts detected)
|
|
2105
2106
|
|
|
2106
2107
|
**Benefits**:
|
|
2107
2108
|
- Full control over which files to keep or overwrite
|
|
@@ -2112,11 +2113,11 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2112
2113
|
## [1.4.6] - 2026-01-24
|
|
2113
2114
|
|
|
2114
2115
|
### Added
|
|
2115
|
-
- **--force option for
|
|
2116
|
+
- **--force option for sce adopt** 🔥 - Force overwrite conflicting files during adoption
|
|
2116
2117
|
- Automatically creates backup before overwriting
|
|
2117
2118
|
- Shows clear warning when enabled
|
|
2118
2119
|
- Useful for upgrading template files to latest version
|
|
2119
|
-
- Usage: `
|
|
2120
|
+
- Usage: `sce adopt --force`
|
|
2120
2121
|
|
|
2121
2122
|
### Fixed
|
|
2122
2123
|
- Cross-platform path normalization test compatibility
|
|
@@ -2140,7 +2141,7 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2140
2141
|
|
|
2141
2142
|
**Benefits**:
|
|
2142
2143
|
- Clear guidance on when to use major vs minor numbers
|
|
2143
|
-
- Practical examples from real projects (
|
|
2144
|
+
- Practical examples from real projects (scene-capability-engine, e-commerce, SaaS)
|
|
2144
2145
|
- Decision tree for quick strategy selection
|
|
2145
2146
|
- Best practices and common pitfalls
|
|
2146
2147
|
- Supports both simple and complex project needs
|
|
@@ -2189,46 +2190,46 @@ This aligns kse with its true purpose: **enforcing development methodology**, no
|
|
|
2189
2190
|
|
|
2190
2191
|
**Documentation Improvements**:
|
|
2191
2192
|
- Corrected Integration Workflow diagram in README.md and README.zh.md
|
|
2192
|
-
- Changed flow from "User →
|
|
2193
|
+
- Changed flow from "User → sce → User → AI Tool" to "User ↔ AI Tool ↔ sce"
|
|
2193
2194
|
- Added key insight: "You stay in your AI tool. The AI reads the Spec and generates code."
|
|
2194
2195
|
- Both English and Chinese versions updated
|
|
2195
2196
|
|
|
2196
2197
|
### Why This Matters
|
|
2197
2198
|
|
|
2198
|
-
This patch ensures CI/CD pipeline works correctly and reinforces the correct mental model: users stay in their AI tool, which calls
|
|
2199
|
+
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.
|
|
2199
2200
|
|
|
2200
2201
|
## [1.4.1] - 2026-01-23
|
|
2201
2202
|
|
|
2202
2203
|
### Fixed - Documentation Clarity 🎯
|
|
2203
2204
|
|
|
2204
2205
|
**Corrected Integration Flow**:
|
|
2205
|
-
- **Fixed sequence diagrams** - Now correctly show "User ↔ AI Tool ↔
|
|
2206
|
-
- **Emphasized AI-driven workflow** - AI tools call
|
|
2207
|
-
- **Clarified positioning** -
|
|
2206
|
+
- **Fixed sequence diagrams** - Now correctly show "User ↔ AI Tool ↔ sce" instead of "User → sce → AI Tool"
|
|
2207
|
+
- **Emphasized AI-driven workflow** - AI tools call sce directly, users stay in their familiar interface
|
|
2208
|
+
- **Clarified positioning** - sce works behind the scenes, users don't "switch tools"
|
|
2208
2209
|
|
|
2209
2210
|
**Updated Documentation**:
|
|
2210
|
-
- `README.md` - Rewrote Step 4 to emphasize AI tool calls
|
|
2211
|
+
- `README.md` - Rewrote Step 4 to emphasize AI tool calls sce automatically
|
|
2211
2212
|
- `README.zh.md` - Chinese version updated to match
|
|
2212
2213
|
- `docs/integration-modes.md` - Fixed sequence diagrams and workflow descriptions
|
|
2213
2214
|
|
|
2214
2215
|
**Key Message**:
|
|
2215
2216
|
- ✅ Users continue using their preferred AI tool (Cursor, Claude, Windsurf, etc.)
|
|
2216
|
-
- ✅ AI tool calls
|
|
2217
|
+
- ✅ AI tool calls sce commands during conversation
|
|
2217
2218
|
- ✅ No "tool switching" - seamless integration
|
|
2218
|
-
- ✅
|
|
2219
|
+
- ✅ sce is the "context provider" working behind the scenes
|
|
2219
2220
|
|
|
2220
2221
|
### Why This Matters
|
|
2221
2222
|
|
|
2222
|
-
Users are already comfortable with their AI tools.
|
|
2223
|
+
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.
|
|
2223
2224
|
|
|
2224
2225
|
## [1.4.0] - 2026-01-23
|
|
2225
2226
|
|
|
2226
2227
|
### Added - User Onboarding and Documentation Overhaul 📚
|
|
2227
2228
|
|
|
2228
2229
|
**Complete Documentation Restructure**:
|
|
2229
|
-
- **New Positioning**: Repositioned
|
|
2230
|
+
- **New Positioning**: Repositioned sce as "A context provider for AI coding tools"
|
|
2230
2231
|
- **Three-Tier Structure**: README → Core Guides → Tool-Specific Guides
|
|
2231
|
-
- **"What
|
|
2232
|
+
- **"What sce is NOT" Section**: Clear clarification of sce's role
|
|
2232
2233
|
|
|
2233
2234
|
**New Documentation** (20+ new files):
|
|
2234
2235
|
- **Quick Start Guide** (`docs/quick-start.md`): Complete 5-minute tutorial with user-login example
|
|
@@ -2236,7 +2237,7 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2236
2237
|
- Cursor Integration Guide
|
|
2237
2238
|
- Claude Code Integration Guide
|
|
2238
2239
|
- Windsurf Integration Guide
|
|
2239
|
-
-
|
|
2240
|
+
- SCE Integration Guide
|
|
2240
2241
|
- VS Code + Copilot Integration Guide
|
|
2241
2242
|
- Generic AI Tools Guide
|
|
2242
2243
|
- **Core Guides**:
|
|
@@ -2273,7 +2274,7 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2273
2274
|
|
|
2274
2275
|
- **README.md**: Complete restructure with embedded quick start and clear positioning
|
|
2275
2276
|
- **README.zh.md**: Updated to match new English structure
|
|
2276
|
-
- All documentation now emphasizes
|
|
2277
|
+
- All documentation now emphasizes sce's role as a context provider for AI tools
|
|
2277
2278
|
|
|
2278
2279
|
### Improved
|
|
2279
2280
|
|
|
@@ -2312,13 +2313,13 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2312
2313
|
- Status reporting and metrics
|
|
2313
2314
|
|
|
2314
2315
|
**CLI Commands** (7 commands):
|
|
2315
|
-
- `
|
|
2316
|
-
- `
|
|
2317
|
-
- `
|
|
2318
|
-
- `
|
|
2319
|
-
- `
|
|
2320
|
-
- `
|
|
2321
|
-
- `
|
|
2316
|
+
- `sce watch init` - Initialize watch configuration
|
|
2317
|
+
- `sce watch start/stop` - Control watch mode
|
|
2318
|
+
- `sce watch status` - Show current status
|
|
2319
|
+
- `sce watch logs` - View execution logs (with tail/follow)
|
|
2320
|
+
- `sce watch metrics` - Display automation metrics
|
|
2321
|
+
- `sce watch presets` - List available presets
|
|
2322
|
+
- `sce watch install <preset>` - Install automation preset
|
|
2322
2323
|
|
|
2323
2324
|
**Automation Presets** (4 presets):
|
|
2324
2325
|
- `auto-sync` - Automatically sync workspace when tasks.md changes
|
|
@@ -2327,14 +2328,14 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2327
2328
|
- `test-runner` - Run tests when source files change
|
|
2328
2329
|
|
|
2329
2330
|
**Tool Detection & Auto-Configuration**:
|
|
2330
|
-
- Automatic IDE detection (
|
|
2331
|
+
- Automatic IDE detection (AI IDE, VS Code, Cursor)
|
|
2331
2332
|
- Tool-specific automation recommendations
|
|
2332
2333
|
- Auto-configuration during project adoption
|
|
2333
2334
|
- Confidence-based suggestions
|
|
2334
2335
|
|
|
2335
2336
|
**Manual Workflows** (6 workflows):
|
|
2336
2337
|
- Complete workflow guide (300+ lines)
|
|
2337
|
-
- `
|
|
2338
|
+
- `sce workflows` command for workflow management
|
|
2338
2339
|
- Step-by-step instructions with time estimates
|
|
2339
2340
|
- Interactive checklists for common tasks
|
|
2340
2341
|
- Workflows: task-sync, context-export, prompt-generation, daily, task-completion, spec-creation
|
|
@@ -2398,9 +2399,9 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2398
2399
|
- `validateProject()`: Complete project validation
|
|
2399
2400
|
- **Automatic Version Checking**: Detect version mismatches
|
|
2400
2401
|
- VersionChecker class for automatic version detection
|
|
2401
|
-
- Warning display when project version differs from installed
|
|
2402
|
+
- Warning display when project version differs from installed sce
|
|
2402
2403
|
- `--no-version-check` flag to suppress warnings
|
|
2403
|
-
- `
|
|
2404
|
+
- `sce version-info` command for detailed version information
|
|
2404
2405
|
- **Enhanced Testing**: Added tests for validation and version checking
|
|
2405
2406
|
- 7 new unit tests for validation system
|
|
2406
2407
|
- 4 new unit tests for version checker
|
|
@@ -2427,9 +2428,9 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2427
2428
|
- Backup validation and integrity checking
|
|
2428
2429
|
- Easy rollback to previous states
|
|
2429
2430
|
- **New CLI Commands**:
|
|
2430
|
-
- `
|
|
2431
|
-
- `
|
|
2432
|
-
- `
|
|
2431
|
+
- `sce adopt`: Adopt existing projects into Scene Capability Engine
|
|
2432
|
+
- `sce upgrade`: Upgrade project to newer version
|
|
2433
|
+
- `sce rollback`: Restore project from backup
|
|
2433
2434
|
- **Core Components**:
|
|
2434
2435
|
- DetectionEngine: Analyzes project structure and determines adoption strategy
|
|
2435
2436
|
- AdoptionStrategy: Implements fresh, partial, and full adoption modes
|
|
@@ -2469,7 +2470,7 @@ Users are already comfortable with their AI tools. kse enhances their existing w
|
|
|
2469
2470
|
- Added semver dependency for version comparison
|
|
2470
2471
|
- Created lib/version/ directory for version management
|
|
2471
2472
|
- Created lib/utils/ directory for shared utilities
|
|
2472
|
-
- Prepared foundation for
|
|
2473
|
+
- Prepared foundation for sce adopt and sce upgrade commands
|
|
2473
2474
|
|
|
2474
2475
|
### Documentation
|
|
2475
2476
|
- Created spec 02-00-project-adoption-and-upgrade
|