@smartmemory/compose 0.1.18-beta → 0.1.19-beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartmemory/compose",
-  "version": "0.1.18-beta",
+  "version": "0.1.19-beta",
   "description": "Structured AI dev pipeline — goal-to-product orchestration with gates, iteration loops, and feature lifecycle management.",
   "author": "SmartMemory",
   "license": "MIT",

package/server/feature-scan.js

@@ -159,8 +159,21 @@ export function scanFeatures(featuresDir) {
       relatedFeatures: [],
       predecessors: [],
       successors: [],
+      group: null,  // explicit group from feature.json overrides derivation
     };
 
+    // Read feature.json if present — supplies optional explicit `group`,
+    // and may override description/status if more authoritative than the docs.
+    try {
+      const specPath = path.join(featureDir, 'feature.json');
+      if (fs.existsSync(specPath)) {
+        const spec = JSON.parse(fs.readFileSync(specPath, 'utf-8'));
+        if (typeof spec.group === 'string' && spec.group.trim()) {
+          feature.group = spec.group.trim();
+        }
+      }
+    } catch { /* ignore malformed feature.json */ }
+
     // List artifacts
     try {
       feature.artifacts = fs.readdirSync(featureDir)
@@ -503,6 +516,7 @@ export function seedFeatures(features, store) {
         phase: feature.phase || 'planning',
         confidence: feature.confidence,
         files: feature.artifacts.map(a => `docs/features/${feature.name}/${a}`),
+        ...(feature.group ? { group: feature.group } : {}),
       });
       try {
         store.updateLifecycle(featureItem.id, { featureCode: feature.name, currentPhase: 'explore_design' });
@@ -525,6 +539,9 @@ export function seedFeatures(features, store) {
       if (JSON.stringify(newFiles) !== JSON.stringify(featureItem.files || [])) {
         updates.files = newFiles;
       }
+      if (feature.group && feature.group !== featureItem.group) {
+        updates.group = feature.group;
+      }
       if (Object.keys(updates).length > 0) {
         store.updateItem(featureItem.id, updates);
         seeded.updated++;

package/server/vision-store.js

@@ -77,15 +77,19 @@ export class VisionStore {
           }
           if (!item.slug && item.title) item.slug = slugify(item.title);
           if (!item.files) item.files = [];
-          // Always re-derive group on load — the rule has evolved (singletons →
-          // first-2-tokens) and existing items need the new shape. Custom
-          // user-set groups are not a use case here; group is derived metadata.
-          const newGroup = deriveGroup(item.title, item.featureCode || item.lifecycle?.featureCode);
-          if (newGroup && newGroup !== item.group) {
-            item.group = newGroup;
+          // Group precedence (most-authoritative first):
+          //   1. feature.json `group` field — applied later in seedFeatures()
+          //   2. deriveGroup() heuristic — applied here on every load
+          //   3. previously stored value — overridden when (1) or (2) yields anything
+          // Always re-derive so items track rule changes (e.g. singleton →
+          // first-2-tokens migration). seedFeatures() runs after _load and
+          // overrides this with the feature.json value when present.
+          const derived = deriveGroup(item.title, item.featureCode || item.lifecycle?.featureCode);
+          if (derived && derived !== item.group) {
+            item.group = derived;
             migrated = true;
-          } else if (!item.group && newGroup) {
-            item.group = newGroup;
+          } else if (!item.group && derived) {
+            item.group = derived;
             migrated = true;
           }
           this.items.set(item.id, item);