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