opencode-flema-engram-sidebar 0.1.0

package/dist/utils/sdd-detector.js

@@ -0,0 +1,115 @@
+export const SDD_PHASES = [
+    "init",
+    "explore",
+    "proposal",
+    "spec",
+    "design",
+    "tasks",
+    "apply",
+    "verify",
+    "archive",
+];
+const PHASE_ALIASES = {
+    "apply-progress": "apply",
+    "verify-report": "verify",
+    "archive-report": "archive",
+};
+const phaseOrder = (phase) => SDD_PHASES.indexOf(phase);
+export function normalizePhase(artifact) {
+    const alias = PHASE_ALIASES[artifact];
+    if (alias)
+        return alias;
+    return SDD_PHASES.includes(artifact)
+        ? artifact
+        : undefined;
+}
+export function parseSDDTopicKey(topicKey) {
+    const match = /^sdd\/([^/]+)\/([^/]+)$/.exec(topicKey);
+    const changeName = match?.[1];
+    const artifact = match?.[2];
+    if (!changeName || !artifact)
+        return null;
+    const phase = normalizePhase(artifact);
+    return phase ? { changeName, phase, artifact } : null;
+}
+const BLOCKER_CONTENT = [
+    /status\s*[:：]\s*blocked\b/i,
+    /\bblocker\s*[:：]/i,
+    /\bblocked\s+(?:by|on|waiting)\b/i,
+    /\b(?:depends?\s+on|waiting\s+(?:for|on))\b/i,
+];
+export function collectBlockers(observations) {
+    return observations
+        .filter((observation) => observation.type.toLowerCase() === "blocker" ||
+        /\bblocked\b/i.test(observation.title) ||
+        BLOCKER_CONTENT.some((pattern) => pattern.test(observation.content)))
+        .sort(compareNewestObservation);
+}
+export function deriveChangeState(phases) {
+    if (phases.includes("archive"))
+        return "archived";
+    if (phases.includes("verify"))
+        return "completed";
+    return phases.some((phase) => phaseOrder(phase) > phaseOrder("proposal"))
+        ? "in-progress"
+        : "open";
+}
+function compareNewestObservation(a, b) {
+    return b.updated_at.localeCompare(a.updated_at) || b.id - a.id;
+}
+export function groupByChange(observations) {
+    const grouped = new Map();
+    for (const observation of observations) {
+        const parsed = parseSDDTopicKey(observation.topic_key);
+        if (!parsed)
+            continue;
+        const entries = grouped.get(parsed.changeName) ?? [];
+        entries.push({ observation, phase: parsed.phase });
+        grouped.set(parsed.changeName, entries);
+    }
+    return [...grouped.entries()]
+        .map(([name, entries]) => {
+        const latestByPhase = new Map();
+        for (const { observation, phase } of entries) {
+            const current = latestByPhase.get(phase);
+            if (!current || compareNewestObservation(observation, current) < 0) {
+                latestByPhase.set(phase, observation);
+            }
+        }
+        const phaseNames = [...latestByPhase.keys()].sort((a, b) => phaseOrder(a) - phaseOrder(b));
+        const state = deriveChangeState(phaseNames);
+        const activePhase = state === "open" || state === "in-progress"
+            ? phaseNames.at(-1)
+            : undefined;
+        const phases = phaseNames.map((phase) => {
+            const observation = latestByPhase.get(phase);
+            return {
+                phase,
+                status: phase === activePhase ? "in-progress" : "done",
+                topicKey: observation.topic_key,
+                observationId: observation.id,
+            };
+        });
+        const artifacts = entries
+            .map(({ observation, phase }) => ({
+            observationId: observation.id,
+            kind: phase,
+            topicKey: observation.topic_key,
+            title: observation.title,
+            updatedAt: observation.updated_at,
+        }))
+            .sort((a, b) => phaseOrder(a.kind) - phaseOrder(b.kind) ||
+            a.updatedAt.localeCompare(b.updatedAt) ||
+            a.observationId - b.observationId);
+        return {
+            name,
+            state,
+            latestAt: entries.map(({ observation }) => observation.updated_at).sort().at(-1),
+            phases,
+            artifacts,
+            blockers: collectBlockers(entries.map(({ observation }) => observation)),
+        };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=sdd-detector.js.map

package/dist/utils/sdd-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-detector.js","sourceRoot":"","sources":["../../src/utils/sdd-detector.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM;IACN,SAAS;IACT,UAAU;IACV,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,SAAS;CACD,CAAC;AA6BX,MAAM,aAAa,GAA2C;IAC5D,gBAAgB,EAAE,OAAO;IACzB,eAAe,EAAE,QAAQ;IACzB,gBAAgB,EAAE,SAAS;CAC5B,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAmB,EAAU,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE9E,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,OAAQ,UAAgC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzD,CAAC,CAAE,QAAyB;QAC5B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAK/C,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,eAAe,GAAG;IACtB,4BAA4B;IAC5B,mBAAmB;IACnB,kCAAkC;IAClC,6CAA6C;CAC9C,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,YAA2B;IACzD,OAAO,YAAY;SAChB,MAAM,CACL,CAAC,WAAW,EAAE,EAAE,CACd,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS;QAC5C,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QACtC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CACvE;SACA,IAAI,CAAC,wBAAwB,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACvE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM,CAAC;AACb,CAAC;AAED,SAAS,wBAAwB,CAAC,CAAc,EAAE,CAAc;IAC9D,OAAO,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,YAA2B;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoE,CAAC;IAE5F,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAa,EAAE;QAClC,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;QAC3D,KAAK,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,IAAI,wBAAwB,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnE,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAC/C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CACxC,CAAC;QACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,aAAa;YAC7D,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAY,EAAE;YAChD,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAC9C,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM;gBACtD,QAAQ,EAAE,WAAW,CAAC,SAAS;gBAC/B,aAAa,EAAE,WAAW,CAAC,EAAE;aAC9B,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,OAAO;aACtB,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,EAAe,EAAE,CAAC,CAAC;YAC7C,aAAa,EAAE,WAAW,CAAC,EAAE;YAC7B,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,WAAW,CAAC,SAAS;YAC/B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,SAAS,EAAE,WAAW,CAAC,UAAU;SAClC,CAAC,CAAC;aACF,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;YACvC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CACpC,CAAC;QAEJ,OAAO;YACL,IAAI;YACJ,KAAK;YACL,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE;YACjF,MAAM;YACN,SAAS;YACT,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "opencode-flema-engram-sidebar",
+  "version": "0.1.0",
+  "description": "Local-first OpenCode plugin/sidebar for Engram memory and SDD context, with an optional MCP stdio adapter",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tui": {
+      "types": "./dist/sidebar/plugin.d.ts",
+      "import": "./dist/sidebar/plugin.js"
+    }
+  },
+  "bin": {
+    "mcp-flema-engram": "dist/stdio.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest --coverage",
+    "mcp": "tsx src/stdio.ts",
+    "verify:package": "node scripts/package-verifier.mjs",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build && npm run verify:package"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "opencode-sidebar",
+    "tui",
+    "sidebar",
+    "engram",
+    "local-first",
+    "developer-tools",
+    "sdd",
+    "memory",
+    "mcp"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oniricosistemas/flema-engram.git"
+  },
+  "bugs": {
+    "url": "https://github.com/oniricosistemas/flema-engram/issues"
+  },
+  "homepage": "https://github.com/oniricosistemas/flema-engram#readme",
+  "engines": {
+    "node": ">=22",
+    "opencode": ">=1.18.25"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@opencode-ai/plugin": "^1.18.25",
+    "@opentui/solid": "^0.5.9",
+    "solid-js": "^1.9.12",
+    "tsx": "^4.23.13",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.2.7",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  }
+}