@smartmemory/compose 0.2.18-beta → 0.2.19-beta

package/lib/status-projection.js

@@ -0,0 +1,36 @@
+/**
+ * status-projection.js — the single canonical status mapping (COMP-MCP-VALIDATE-3).
+ *
+ * Projects a feature/ROADMAP status (UPPERCASE roadmap vocabulary) onto the
+ * vision-state status (lowercase tracker vocabulary). Used on WRITE (the
+ * `setFeatureStatus` projection and the back-projection migration) AND on READ
+ * (the validator's `*_VS_VISION_STATE` comparison), so a status written by the
+ * projection can never itself trip STATUS_MISMATCH_*_VS_VISION_STATE — one rule
+ * set, enforced on write and read.
+ *
+ * Pure data, no IO.
+ */
+
+// feature/ROADMAP UPPERCASE status -> vision-state lowercase status.
+const FEATURE_TO_VISION = {
+  PLANNED: 'planned',
+  IN_PROGRESS: 'in_progress',
+  PARTIAL: 'in_progress', // vision cannot represent "partially shipped"
+  COMPLETE: 'complete',
+  BLOCKED: 'blocked',
+  PARKED: 'parked',
+  KILLED: 'killed',
+  SUPERSEDED: 'superseded', // D1: vision VALID_STATUSES gains 'superseded'
+};
+
+/**
+ * @param {string|null|undefined} status  A feature/ROADMAP status (any case).
+ * @returns {string|null} The vision-state status, or null for empty/unknown
+ *   input. Vision-native statuses with no feature-vocab key (e.g. ready/review)
+ *   also return null; callers treat null as "no opinion" — the validator falls
+ *   back to identity, the writer skips the projection.
+ */
+export function featureStatusToVisionStatus(status) {
+  if (!status) return null;
+  return FEATURE_TO_VISION[String(status).toUpperCase()] ?? null;
+}

package/package.json

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

package/scripts/backproject-vision-status.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * backproject-vision-status.mjs — one-time back-projection of historical
+ * vision-state status drift (COMP-MCP-VALIDATE-3).
+ *
+ * The typed writers now project status onto vision-state on every transition,
+ * but historical vision-state was never reconciled. This script projects the
+ * canonical feature.json status onto each bound vision item, clearing the
+ * pre-existing STATUS_MISMATCH_*_VS_VISION_STATE findings the write-time hook
+ * cannot reach (they predate any new mutation).
+ *
+ * Idempotent: a second run stages zero changes. Dry-run by default; pass
+ * --apply to write. Operates on the project root (default: process.cwd()),
+ * NOT compose's own data/.
+ *
+ *   node scripts/backproject-vision-status.mjs            # dry-run, cwd
+ *   node scripts/backproject-vision-status.mjs --apply    # write
+ *   node scripts/backproject-vision-status.mjs --root /path/to/project --apply
+ */
+
+import { readFileSync, writeFileSync, renameSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import crypto from 'node:crypto';
+import { loadFeaturesDir } from '../lib/project-paths.js';
+import { featureStatusToVisionStatus } from '../lib/status-projection.js';
+
+/**
+ * Compute (and optionally apply) the back-projection for one project root.
+ *
+ * @param {object} opts
+ * @param {string} opts.root   Project root containing .compose/data + features dir.
+ * @param {boolean} [opts.apply=false]  Write the reconciled state when true.
+ * @returns {{changes: Array<{code:string, id:string, from:string|null, to:string}>,
+ *           skipped: number, total: number, applied: boolean}}
+ */
+export function backprojectVisionStatus({ root, apply = false }) {
+  const visionPath = join(root, '.compose', 'data', 'vision-state.json');
+  if (!existsSync(visionPath)) {
+    return { changes: [], skipped: 0, total: 0, applied: false };
+  }
+  const state = JSON.parse(readFileSync(visionPath, 'utf-8'));
+  const items = Array.isArray(state.items) ? state.items : [];
+  const featuresDir = join(root, loadFeaturesDir(root));
+
+  const changes = [];
+  let skipped = 0;
+  for (const item of items) {
+    const code = item.lifecycle?.featureCode || item.featureCode;
+    if (!code) { skipped++; continue; }
+    const fjPath = join(featuresDir, code, 'feature.json');
+    if (!existsSync(fjPath)) { skipped++; continue; } // UI-only / external items
+    let feature;
+    try {
+      feature = JSON.parse(readFileSync(fjPath, 'utf-8'));
+    } catch {
+      skipped++; continue;
+    }
+    const target = featureStatusToVisionStatus(feature.status);
+    if (!target) { skipped++; continue; }
+    if (item.status !== target) {
+      changes.push({ code, id: item.id, from: item.status ?? null, to: target });
+      item.status = target;
+    }
+  }
+
+  if (apply && changes.length > 0) {
+    const tmp = `${visionPath}.tmp.${crypto.randomUUID()}`;
+    writeFileSync(tmp, JSON.stringify(state, null, 2) + '\n', 'utf-8');
+    renameSync(tmp, visionPath);
+  }
+
+  return { changes, skipped, total: items.length, applied: apply && changes.length > 0 };
+}
+
+// ── CLI ──────────────────────────────────────────────────────────────────────
+const isMain = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1];
+if (isMain) {
+  const argv = process.argv.slice(2);
+  const apply = argv.includes('--apply');
+  const rootIdx = argv.indexOf('--root');
+  const root = rootIdx !== -1 ? argv[rootIdx + 1] : process.cwd();
+
+  const { changes, skipped, total, applied } = backprojectVisionStatus({ root, apply });
+
+  console.log(`Back-projection — ${total} vision items, ${skipped} skipped (no bound feature.json).`);
+  if (changes.length === 0) {
+    console.log('No drift. vision-state already matches canonical feature.json status.');
+  } else {
+    console.log(`${changes.length} item(s) ${applied ? 'reconciled' : 'would change'}:`);
+    for (const c of changes) {
+      console.log(`  ${c.code.padEnd(28)} ${String(c.from).padEnd(12)} → ${c.to}`);
+    }
+    if (!applied) console.log('\nDry-run. Re-run with --apply to write.');
+  }
+}

package/server/graph-export.js

@@ -24,6 +24,7 @@ const STATUS_MAP = {
   parked: 'parked',
   complete: 'complete',
   killed: 'complete',
+  superseded: 'complete',
 };
 
 const EDGE_TYPE_MAP = {

package/server/vision-store.js

@@ -8,7 +8,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 
 export const VALID_TYPES = ['feature', 'bug', 'track', 'idea', 'decision', 'question', 'thread', 'artifact', 'task', 'spec', 'evaluation'];
-export const VALID_STATUSES = ['planned', 'ready', 'in_progress', 'review', 'complete', 'blocked', 'parked', 'killed'];
+export const VALID_STATUSES = ['planned', 'ready', 'in_progress', 'review', 'complete', 'blocked', 'parked', 'killed', 'superseded'];
 export const VALID_CONNECTION_TYPES = ['informs', 'blocks', 'supports', 'contradicts', 'implements'];
 export const VALID_PHASES = ['vision', 'specification', 'planning', 'implementation', 'verification', 'release'];
 

package/dist/assets/channel-Bcu04MIK.js

@@ -1 +0,0 @@
-import{ai as o,aj as n}from"./App-CG-2euMe.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/assets/classDiagram-4FO5ZUOK-DU4yxldU.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-727SXJPM-DesUnrEw.js";import{_ as i}from"./App-CG-2euMe.js";import"./chunk-FMBD7UC4-DYHv1PcZ.js";import"./chunk-ND2GUHAM-D0MENOLX.js";import"./chunk-55IACEB6-hMeFx5Nh.js";import"./chunk-2J33WTMH-zMzVB2a6.js";import"./mobile-CG5tLa2S.js";import"./index-B4dv3acY.js";import"./graph-Cs_vqCR0.js";var b={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{b as diagram};

package/dist/assets/classDiagram-v2-Q7XG4LA2-DU4yxldU.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-727SXJPM-DesUnrEw.js";import{_ as i}from"./App-CG-2euMe.js";import"./chunk-FMBD7UC4-DYHv1PcZ.js";import"./chunk-ND2GUHAM-D0MENOLX.js";import"./chunk-55IACEB6-hMeFx5Nh.js";import"./chunk-2J33WTMH-zMzVB2a6.js";import"./mobile-CG5tLa2S.js";import"./index-B4dv3acY.js";import"./graph-Cs_vqCR0.js";var b={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{b as diagram};

package/dist/assets/stateDiagram-v2-BHNVJYJU-BLR6AkKX.js

@@ -1 +0,0 @@
-import{s as r,b as e,a,S as s}from"./chunk-AQP2D5EJ-1uGGvkxW.js";import{_ as i}from"./App-CG-2euMe.js";import"./chunk-55IACEB6-hMeFx5Nh.js";import"./chunk-2J33WTMH-zMzVB2a6.js";import"./mobile-CG5tLa2S.js";import"./index-B4dv3acY.js";import"./graph-Cs_vqCR0.js";var n={parser:a,get db(){return new s(2)},renderer:e,styles:r,init:i(t=>{t.state||(t.state={}),t.state.arrowMarkerAbsolute=t.arrowMarkerAbsolute},"init")};export{n as diagram};