changeledger 0.5.0 → 0.6.1

package/src/viewer/public/styles.css

@@ -1262,3 +1262,286 @@ body {
     padding: 8px 8px;
   }
 }
+
+/* config editor tabs and form (113924) */
+.config-section {
+  border-bottom: 1px solid var(--line);
+}
+.config-tabs {
+  display: flex;
+  gap: 2px;
+  padding: 12px 20px 0;
+  border-bottom: 1px solid var(--line);
+}
+.config-tab {
+  padding: 6px 14px;
+  border: 1px solid transparent;
+  border-bottom: none;
+  border-radius: 6px 6px 0 0;
+  background: transparent;
+  color: var(--muted);
+  cursor: pointer;
+  font-size: 12px;
+  font-weight: 500;
+  position: relative;
+  bottom: -1px;
+}
+.config-tab.active {
+  background: var(--bg);
+  border-color: var(--line);
+  color: var(--text);
+}
+.config-form-structured {
+  display: flex;
+  flex-direction: column;
+  gap: 0;
+}
+.config-group {
+  margin: 0;
+  padding: 14px 20px;
+  border: none;
+  border-bottom: 1px solid var(--line);
+}
+.config-group legend {
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--muted);
+  padding: 0;
+  margin-bottom: 8px;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+.config-group label {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 12px;
+  color: var(--muted);
+  margin-bottom: 8px;
+}
+.config-group input[type="text"],
+.config-group input:not([type]) {
+  padding: 6px 10px;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: var(--bg);
+  color: var(--text);
+  font-size: 13px;
+}
+.config-group textarea {
+  padding: 6px 10px;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: var(--bg);
+  color: var(--text);
+  font-size: 12px;
+  font-family: ui-monospace, monospace;
+  resize: vertical;
+}
+.config-group label.config-checkbox {
+  flex-direction: row;
+  align-items: center;
+  gap: 8px;
+  color: var(--text);
+}
+.config-checkbox input[type="checkbox"] {
+  width: 16px;
+  height: 16px;
+  accent-color: var(--accent);
+}
+.config-type-row {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  padding: 6px 0;
+  margin: 0;
+  border: 0;
+  border-bottom: 1px solid var(--line);
+  flex-wrap: wrap;
+}
+.config-type-row:last-child {
+  border-bottom: none;
+}
+.config-group .config-type-row legend {
+  min-width: 80px;
+  font-size: 13px;
+  color: var(--text);
+  text-transform: none;
+  letter-spacing: normal;
+  margin: 0;
+}
+.config-type-row label:first-of-type {
+  flex: 1 1 240px;
+}
+.config-type-row select {
+  padding: 4px 8px;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: var(--bg);
+  color: var(--text);
+  font-size: 12px;
+}
+.config-note {
+  font-size: 11px;
+  color: var(--muted);
+  margin: 0 0 6px;
+}
+.config-readonly-note {
+  font-style: italic;
+}
+.config-group-internal p {
+  display: flex;
+  gap: 12px;
+  margin: 4px 0;
+  font-size: 12px;
+}
+.config-readonly-label {
+  color: var(--muted);
+  font-family: ui-monospace, monospace;
+  min-width: 120px;
+}
+.config-readonly-value {
+  color: var(--text);
+}
+.config-migration-card {
+  padding: 16px 20px;
+}
+.config-migration-card h3 {
+  margin: 0 0 8px;
+  font-size: 14px;
+  color: #f7ab57;
+}
+.config-migration-preview {
+  margin-top: 12px;
+}
+.config-migration-yaml {
+  max-height: 300px;
+  overflow: auto;
+  padding: 10px;
+  background: #0b0d11;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  font-size: 11px;
+  font-family: ui-monospace, monospace;
+  color: #d9e1ea;
+  margin: 8px 0;
+}
+.config-migration-ok {
+  color: #56d364;
+  font-size: 12px;
+}
+.config-future-schema p {
+  padding: 0 20px;
+  font-size: 12px;
+  color: var(--muted);
+}
+.config-schema-badge {
+  display: inline-block;
+  margin: 12px 20px 4px;
+  padding: 2px 8px;
+  border-radius: 4px;
+  background: rgba(248, 81, 73, 0.15);
+  color: #ff8078;
+  font-size: 11px;
+  font-weight: 600;
+}
+.config-section-note {
+  padding: 0 20px;
+  font-size: 11px;
+  color: var(--muted);
+  font-style: italic;
+}
+
+/* Native confirm dialog (cl-confirm-dialog) */
+.cl-confirm-dialog {
+  margin: auto;
+  padding: 28px 28px 24px;
+  min-width: 320px;
+  max-width: 440px;
+  background: var(--panel);
+  border: 1px solid var(--line);
+  border-radius: 14px;
+  box-shadow: 0 24px 72px rgba(0, 0, 0, 0.55);
+  color: var(--text);
+}
+.cl-confirm-dialog::backdrop {
+  background: rgba(4, 6, 10, 0.75);
+  backdrop-filter: blur(4px);
+}
+.cl-confirm-message {
+  margin: 0 0 20px;
+  font-size: 14px;
+  line-height: 1.55;
+  color: var(--text);
+}
+.cl-confirm-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+}
+
+/* Toast notifications */
+.toast-container {
+  position: fixed;
+  bottom: 24px;
+  right: 24px;
+  z-index: 100;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  pointer-events: none;
+}
+.toast {
+  padding: 12px 16px;
+  border-radius: 10px;
+  font-size: 13px;
+  font-weight: 500;
+  max-width: 340px;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.45);
+  animation: toast-in 0.2s ease;
+  pointer-events: auto;
+}
+.toast-error {
+  background: #2a1215;
+  border: 1px solid rgba(248, 81, 73, 0.45);
+  color: #ff8078;
+}
+.toast-info {
+  background: var(--panel);
+  border: 1px solid var(--line);
+  color: var(--text);
+}
+@keyframes toast-in {
+  from {
+    opacity: 0;
+    transform: translateY(8px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* Prompt input inside confirm dialog */
+.cl-prompt-label {
+  display: block;
+  margin-bottom: 6px;
+  color: var(--muted);
+  font-size: 12px;
+}
+.cl-prompt-input {
+  display: block;
+  width: 100%;
+  margin: 0 0 16px;
+  padding: 8px 12px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--bg);
+  color: var(--text);
+  font-size: 13px;
+  box-sizing: border-box;
+}
+.cl-prompt-input:focus {
+  outline: none;
+  border-color: var(--accent);
+}

package/src/viewer/server/router.mjs

@@ -5,8 +5,12 @@ import { gitRefs } from '../../git.mjs';
 import { publicDir } from '../../paths.mjs';
 import { loadRepoAsync } from '../../repo.mjs';
 import {
+  applyConfigMigration,
   changeStatus,
+  patchProjectConfig,
+  previewConfigMigration,
   readProjectConfig,
+  readProjectConfigStructured,
   repairProjectPath,
   resolveProjects,
   saveProjectConfig,
@@ -87,12 +91,15 @@ export function createRequestListener(cwd, localOnly, token) {
       const route = url.pathname;
       const params = url.searchParams;
 
-      if (
-        req.method === 'POST' &&
-        ['/api/status', '/api/project-config', '/api/project-path', '/api/project-remove'].includes(
-          route,
-        )
-      ) {
+      const WRITE_ROUTES = new Set([
+        '/api/status',
+        '/api/project-config',
+        '/api/project-config-patch',
+        '/api/project-config-migrate-apply',
+        '/api/project-path',
+        '/api/project-remove',
+      ]);
+      if (req.method === 'POST' && WRITE_ROUTES.has(route)) {
         if (!isAuthorizedWrite(req, token)) {
           send(res, 403, MIME['.json'], JSON.stringify({ error: 'unauthorized write' }));
           req.destroy();
@@ -121,14 +128,17 @@ export function createRequestListener(cwd, localOnly, token) {
             }
             const { projects } = resolveProjects(cwd, localOnly);
             const options = { localOnly };
-            const result =
-              route === '/api/status'
-                ? changeStatus(projects, payload)
-                : route === '/api/project-config'
-                  ? saveProjectConfig(projects, payload, options)
-                  : route === '/api/project-path'
-                    ? repairProjectPath(projects, payload, options)
-                    : unregisterProject(projects, payload, options);
+            let result;
+            if (route === '/api/status') result = changeStatus(projects, payload);
+            else if (route === '/api/project-config')
+              result = saveProjectConfig(projects, payload, options);
+            else if (route === '/api/project-config-patch')
+              result = patchProjectConfig(projects, payload);
+            else if (route === '/api/project-config-migrate-apply')
+              result = applyConfigMigration(projects, payload);
+            else if (route === '/api/project-path')
+              result = repairProjectPath(projects, payload, options);
+            else result = unregisterProject(projects, payload, options);
             const { code, body } = result;
             send(res, code, MIME['.json'], JSON.stringify(body));
           } catch (error) {
@@ -154,6 +164,22 @@ export function createRequestListener(cwd, localOnly, token) {
         send(res, code, MIME['.json'], JSON.stringify(body));
         return;
       }
+      if (route === '/api/project-config-structured') {
+        const { projects } = resolveProjects(cwd, localOnly);
+        const { code, body } = readProjectConfigStructured(projects, params.get('project'));
+        send(res, code, MIME['.json'], JSON.stringify(body));
+        return;
+      }
+      if (route === '/api/project-config-migrate-preview') {
+        const { projects } = resolveProjects(cwd, localOnly);
+        const { code, body } = previewConfigMigration(
+          projects,
+          params.get('project'),
+          params.get('revision'),
+        );
+        send(res, code, MIME['.json'], JSON.stringify(body));
+        return;
+      }
       if (route === '/api/git') {
         const rawId = params.get('id');
         if (rawId && !/^[0-9]{8}-[0-9]{6}$/.test(rawId)) {

package/templates/config.yml

@@ -1,6 +1,10 @@
 # ChangeLedger — repo configuration
 # Repo specifics: documentation language, change types and active stages per type.
 
+# Schema version — used to detect and migrate outdated configurations.
+# Run `changeledger config migrate --dry-run` to inspect available migrations.
+schema_version: 1
+
 # Language for generated documentation CONTENT. Structure (headings, keys, enums)
 # is always English. See `changeledger context spec`.
 language: en

package/templates/contract/core.md

@@ -5,6 +5,10 @@ reflection. Work is planned and documented before code is written.
 
 ## Non-negotiable fast path
 
+Running `changeledger context` is discovery, not compliance by itself. Read the
+complete output and follow the current mode. If the output is truncated or
+incomplete, stop and restore complete context before creating or modifying files.
+
 1. Work starts with conversation. Read-only investigation may clarify a request,
    but create no change or implementation artifact until there is enough clarity
    to document faithfully **and** the human explicitly authorizes documentation. A direct request such
@@ -22,6 +26,11 @@ reflection. Work is planned and documented before code is written.
 8. After human acceptance, graduate persistent truth or record an explicit skip,
    then archive the done change.
 
+If no approved or in-progress change applies, do not silently edit repository
+files. Create or update a change, or ask the human whether a purely operational,
+reversible edit with no persistent truth or observable behavior change should be
+done directly. If unsure, document it in ChangeLedger.
+
 Humans consume changes in `changeledger view`; write for the rendered view.
 
 ## Lifecycle
@@ -60,5 +69,12 @@ Valid modes: implement, review, spec, release.
 - `changeledger context release`: plan portable delivery metadata.
 - `changeledger context <change-id>`: infer the correct context from lifecycle.
 
+## Operational discovery
+
+Prefer structured CLI queries before scanning files:
+
+- `changeledger list --status approved`: find approved changes ready to implement.
+- `changeledger graduate --pending`: find accepted changes whose graduation decision is unresolved.
+
 Run `changeledger help` or `changeledger <command> --help` for exact CLI syntax.
 Structure is always English; narrative content follows `.changeledger/config.yml`.

package/templates/contract/release.md

@@ -13,3 +13,13 @@ override its type with `release_impact` (`none|patch|minor|major`).
 ChangeLedger owns portable membership and SemVer. The operating agent owns
 stack-specific version files, project gates, commits, tags and publishing.
 Never infer that every ChangeLedger repository uses npm or GitHub.
+
+## Routine release preparation
+
+Routine release preparation is operational work.
+Version bumps, release manifests, quality gates, packaging, commits, tags and publishing do not require a ChangeLedger change by themselves.
+Do not create a change only to group those routine steps.
+
+If preparation reveals a functional fix, release-workflow change or persistent documentation, capture it as a separate change.
+Complete that change and rerun `changeledger release plan` before `changeledger release record <version>`.
+Keep this workflow stack-agnostic; do not assume npm, GitHub or specific manifest filenames.