specweave 1.0.592 → 2.0.0

package/dist/src/core/config/migrate-to-2.js

@@ -0,0 +1,185 @@
+/**
+ * One-shot 1.x → 2.0 config migration.
+ *
+ * Runs on every load, but only ever reports `changed: true` when it actually
+ * rewrote something, so callers persist the file at most once. Composes the
+ * `limits` migration (limits-migrator.ts) so a config makes exactly one pass.
+ *
+ * What it does:
+ * - limits.maxActiveIncrements → limits.activeIncrements (advisory), legacy
+ *   limit keys dropped                                    [limits-migrator]
+ * - testing.defaultTestMode  → testing.mode
+ *   testing.coverageTargets  → testing.coverage
+ *   testing.{defaultCoverageTarget,tddEnforcement,playwright} dropped
+ * - hooks.*.sync_living_docs → livingDocs: 'onDone' | false
+ * - planning.deepInterview.{enabled,enforcement} → planning.deepInterview: 'off' | 'warn'
+ * - sync.mode dropped (the queued event queue is gone)
+ * - dead 1.x keys deleted outright (see DEAD_KEYS)
+ *
+ * Deleted keys are recorded in `.specweave/state/config-migration-2.json` so a
+ * user can see what was dropped without digging through git history.
+ *
+ * @module core/config/migrate-to-2
+ */
+import { migrateLimits } from './limits-migrator.js';
+import { CONFIG_SCHEMA_VERSION } from './schema-version.js';
+/**
+ * 1.x keys with no reader in 2.0. Removed without replacement.
+ *
+ * `banner` appears both as a top-level object and as a `hooks` sub-key in 1.x
+ * configs; both are dropped because the UserPromptSubmit banner hook is gone.
+ */
+export const DEAD_KEYS = [
+    'contextBudget',
+    'quality',
+    'cache',
+    'deduplication',
+    'archiving',
+    'apiDocs',
+    'statusLine',
+    'incrementAssist',
+    'billing',
+    'translation',
+    'language',
+    'documentation',
+    'reflect',
+    'pluginAutoLoad',
+    'banner',
+    'grill',
+    'codeReview',
+    'qualityGates',
+    'skillGen',
+];
+/** Sub-keys of `hooks` that 2.0 no longer honours. */
+const DEAD_HOOK_KEYS = ['banner', 'post_increment_planning', 'post_task_completion'];
+/** Sub-keys of `testing` that 2.0 no longer honours (after the renames). */
+const DEAD_TESTING_KEYS = ['defaultTestMode', 'defaultCoverageTarget', 'coverageTargets', 'tddEnforcement', 'playwright'];
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Migrate a raw parsed config object in place.
+ *
+ * Idempotent: running it twice on the same object reports `changed: false`
+ * the second time.
+ */
+export function migrateTo2(config) {
+    const removedKeys = [];
+    const renamedKeys = [];
+    let changed = false;
+    // limits.* (advisory WIP) — shared with the standalone migrator so a config
+    // is never rewritten twice for the same reason.
+    if (migrateLimits(config)) {
+        changed = true;
+        renamedKeys.push('limits.maxActiveIncrements → limits.activeIncrements');
+    }
+    // testing.* renames
+    if (isPlainObject(config.testing)) {
+        const t = config.testing;
+        if (t.mode === undefined && typeof t.defaultTestMode === 'string') {
+            t.mode = t.defaultTestMode;
+            renamedKeys.push('testing.defaultTestMode → testing.mode');
+        }
+        if (t.coverage === undefined && isPlainObject(t.coverageTargets)) {
+            t.coverage = t.coverageTargets;
+            renamedKeys.push('testing.coverageTargets → testing.coverage');
+        }
+        for (const key of DEAD_TESTING_KEYS) {
+            if (key in t) {
+                delete t[key];
+                removedKeys.push(`testing.${key}`);
+                changed = true;
+            }
+        }
+    }
+    // The 1.x `livingDocs` object (copyBasedSync/threeLayerSync) becomes the
+    // `false | 'onDone'` switch; the hooks flags below decide which.
+    if (isPlainObject(config.livingDocs)) {
+        delete config.livingDocs;
+        removedKeys.push('livingDocs.{copyBasedSync,threeLayerSync}');
+        changed = true;
+    }
+    // hooks.*.sync_living_docs → livingDocs
+    if (isPlainObject(config.hooks)) {
+        const hooks = config.hooks;
+        const done = isPlainObject(hooks.post_increment_done) ? hooks.post_increment_done : undefined;
+        const planned = isPlainObject(hooks.post_increment_planning) ? hooks.post_increment_planning : undefined;
+        const wanted = done?.sync_living_docs === true || planned?.sync_living_docs === true;
+        if (config.livingDocs === undefined && wanted) {
+            config.livingDocs = 'onDone';
+            renamedKeys.push('hooks.*.sync_living_docs → livingDocs: "onDone"');
+            changed = true;
+        }
+        if (done && 'sync_living_docs' in done) {
+            delete done.sync_living_docs;
+            removedKeys.push('hooks.post_increment_done.sync_living_docs');
+            changed = true;
+        }
+        for (const key of DEAD_HOOK_KEYS) {
+            if (key in hooks) {
+                delete hooks[key];
+                removedKeys.push(`hooks.${key}`);
+                changed = true;
+            }
+        }
+        if (Object.keys(hooks).length === 0) {
+            delete config.hooks;
+            changed = true;
+        }
+    }
+    // planning.deepInterview: object → 'off' | 'warn'
+    if (isPlainObject(config.planning)) {
+        const planning = config.planning;
+        const di = planning.deepInterview;
+        if (isPlainObject(di)) {
+            planning.deepInterview = di.enabled === true ? 'warn' : 'off';
+            renamedKeys.push('planning.deepInterview.{enabled,enforcement} → planning.deepInterview enum');
+            changed = true;
+        }
+        else if (di !== undefined && di !== 'off' && di !== 'warn') {
+            // 'strict' (or anything unrecognised) downgrades: 2.0 never blocks a write.
+            planning.deepInterview = 'warn';
+            renamedKeys.push(`planning.deepInterview "${String(di)}" → "warn"`);
+            changed = true;
+        }
+    }
+    // sync.mode — the queued event queue was removed in 2.0.
+    if (isPlainObject(config.sync) && 'mode' in config.sync) {
+        delete config.sync.mode;
+        removedKeys.push('sync.mode');
+        changed = true;
+    }
+    // Dead top-level keys.
+    for (const key of DEAD_KEYS) {
+        if (key in config) {
+            delete config[key];
+            removedKeys.push(key);
+            changed = true;
+        }
+    }
+    // Everything above may have produced renames without deletions.
+    if (renamedKeys.length > 0)
+        changed = true;
+    if (changed && config.version !== CONFIG_SCHEMA_VERSION) {
+        config.version = CONFIG_SCHEMA_VERSION;
+    }
+    return { changed, removedKeys, renamedKeys };
+}
+/** Build the note written to `.specweave/state/config-migration-2.json`. */
+export function buildMigrationNote(result, fromVersion) {
+    return {
+        migratedAt: new Date().toISOString(),
+        from: fromVersion || 'unknown',
+        to: CONFIG_SCHEMA_VERSION,
+        removedKeys: result.removedKeys,
+        renamedKeys: result.renamedKeys,
+    };
+}
+/**
+ * Top-level keys present in `config` that 2.0 does not know about.
+ * Used for the single warning line printed on load.
+ */
+export function unknownKeys(config, known) {
+    return Object.keys(config).filter((k) => !known.includes(k) && k !== 'umbrella' && k !== 'multiProject' && k !== 'projectMappings');
+}
+//# sourceMappingURL=migrate-to-2.js.map

package/dist/src/core/config/migrate-to-2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-to-2.js","sourceRoot":"","sources":["../../../../src/core/config/migrate-to-2.ts"],"names":[],"mappings":"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"}

package/dist/src/core/config/schema-version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The config *schema* version 2.0 configs carry.
+ *
+ * This is deliberately NOT the package version: `.specweave/config.json` has
+ * its own shape version (see the 2.0 design), and the CLI's npm version moves
+ * independently. Nothing here may be derived from package.json.
+ *
+ * @module core/config/schema-version
+ */
+/** Value written to `config.version` by the 1.x → 2.0 migration. */
+export declare const CONFIG_SCHEMA_VERSION = "2.0";
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/src/core/config/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../../../src/core/config/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,QAAQ,CAAC"}

package/dist/src/core/config/schema-version.js

@@ -0,0 +1,12 @@
+/**
+ * The config *schema* version 2.0 configs carry.
+ *
+ * This is deliberately NOT the package version: `.specweave/config.json` has
+ * its own shape version (see the 2.0 design), and the CLI's npm version moves
+ * independently. Nothing here may be derived from package.json.
+ *
+ * @module core/config/schema-version
+ */
+/** Value written to `config.version` by the 1.x → 2.0 migration. */
+export const CONFIG_SCHEMA_VERSION = '2.0';
+//# sourceMappingURL=schema-version.js.map

package/dist/src/core/config/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../../../src/core/config/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC"}