opencode-flema-engram-sidebar 0.2.0 → 0.4.0

package/dist/viewer/core.d.ts

@@ -0,0 +1,93 @@
+import type { EngramAdapter, EngramTargets, HealthStatus, Observation, Project } from "../adapters/types.js";
+import { type SDDChange } from "../utils/sdd-detector.js";
+import type { ODDState } from "../schemas/odd-state.js";
+import type { ProjectResolution } from "../utils/project-resolver.js";
+export type SidebarHealth = "loading" | "ok" | "stale" | "error" | "offline";
+export type SidebarWorkflowMode = "odd" | "legacy-sdd";
+export interface SidebarViewModel {
+    workflowMode?: SidebarWorkflowMode;
+    projectName?: string;
+    project?: Project;
+    resolution?: ProjectResolution;
+    changes: SDDChange[];
+    odd?: ODDState;
+    observations?: Observation[];
+    blockers: Observation[];
+    recentActivity: Observation[];
+    health: SidebarHealth;
+    loading: boolean;
+    lastRefreshAt?: Date;
+    error?: string;
+    terminal?: SidebarTerminalState;
+    targets?: EngramTargets;
+}
+export interface SidebarTerminalState {
+    status: "loading" | SidebarRefreshOutcomeStatus;
+    stage: SidebarOperationStage | "mounted" | "refresh";
+    health: SidebarHealth;
+    observationCount: number;
+}
+export interface UseEngramOptions {
+    projectName?: string;
+    resolution?: ProjectResolution;
+    initialError?: string;
+    pollInterval?: number;
+    enabled?: boolean;
+    autoRefresh?: boolean;
+    resolveProject?: () => Promise<ProjectResolution>;
+    now?: () => Date;
+    stageTimeoutMs?: number;
+}
+export interface SidebarRefreshInput {
+    health?: HealthStatus;
+    projects?: Project[];
+    observations?: Observation[];
+    projectName?: string;
+    resolution?: ProjectResolution;
+    errors?: unknown[];
+    failures?: SidebarRefreshFailure[];
+    warnings?: string[];
+    stages?: SidebarStageTransition[];
+    targets?: EngramTargets;
+    now: Date;
+}
+export type SidebarRefreshStage = "project-resolution" | "health" | "projects" | "observations" | "refresh";
+export interface SidebarRefreshFailure {
+    stage: SidebarRefreshStage;
+    endpoint?: string;
+    reason: unknown;
+}
+export type SidebarRefreshOutcomeStatus = "success" | "partial" | "failed";
+export type SidebarTransitionStatus = "started" | SidebarRefreshOutcomeStatus | "skipped";
+export type SidebarOperationStage = "project-resolution" | "health" | "projects" | "filtered-observations" | "fallback-observations" | "reducing" | "terminal";
+export interface SidebarStageTransition {
+    stage: SidebarOperationStage;
+    status: SidebarTransitionStatus;
+    endpoint?: string;
+    count?: number;
+    message?: string;
+}
+export interface SidebarRefreshOutcome {
+    status: SidebarRefreshOutcomeStatus;
+    summary: string;
+    failures: SidebarRefreshFailure[];
+    warnings: string[];
+    stages: SidebarStageTransition[];
+}
+export declare function reduceSidebarRefresh(current: SidebarViewModel, input: SidebarRefreshInput): SidebarViewModel;
+export declare function fetchSidebarRefresh(adapter: EngramAdapter, options?: Pick<UseEngramOptions, "projectName" | "resolution" | "resolveProject" | "now" | "stageTimeoutMs"> & {
+    onTransition?: (transition: SidebarStageTransition) => void;
+}): Promise<SidebarRefreshInput>;
+export interface EngramReadControllerOptions extends Pick<UseEngramOptions, "projectName" | "resolution" | "initialError" | "enabled" | "resolveProject" | "now" | "stageTimeoutMs"> {
+    onState?: (state: SidebarViewModel) => void;
+}
+export interface EngramReadController {
+    getState: () => SidebarViewModel;
+    refresh: () => Promise<SidebarRefreshOutcome>;
+    setWorkflowMode: (mode: SidebarWorkflowMode) => void;
+    dispose: () => void;
+}
+export declare function createEngramReadController(adapter: EngramAdapter, options?: EngramReadControllerOptions): EngramReadController;
+export declare function withStageTimeout<T>(promise: Promise<T>, stage: string, timeoutMs: number, endpoint?: string): Promise<T>;
+export declare function outcomeFor(input: SidebarRefreshInput): SidebarRefreshOutcome;
+//# sourceMappingURL=core.d.ts.map

package/dist/viewer/core.d.ts.map

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

package/dist/viewer/core.js

@@ -0,0 +1,455 @@
+import { collectBlockers, groupByChange } from "../utils/sdd-detector.js";
+import { deriveODDState } from "../utils/odd-detector.js";
+import { EngramUnavailable } from "../utils/errors.js";
+import { scheduleLongTimeout } from "../utils/timeout.js";
+const DEFAULT_STAGE_TIMEOUT_MS = 5_000;
+const SIDEBAR_OBSERVATION_LIMIT = 20;
+const OBSERVATION_FALLBACK_LIMIT = 100;
+const EMPTY_STATE = {
+    workflowMode: "odd",
+    odd: deriveODDState([]),
+    observations: [],
+    changes: [],
+    blockers: [],
+    recentActivity: [],
+    health: "loading",
+    loading: true,
+    terminal: { status: "loading", stage: "mounted", health: "loading", observationCount: 0 },
+};
+function workflowChanges(mode, observations) {
+    return mode === "legacy-sdd" ? groupByChange(observations) : [];
+}
+function messageOf(reason) {
+    return reason instanceof Error ? reason.message : String(reason);
+}
+export function reduceSidebarRefresh(current, input) {
+    const serviceAvailable = input.health?.local.available === true || input.health?.cloud?.available === true;
+    const observationsAvailable = input.observations !== undefined;
+    const criticalFailure = input.failures?.some((failure) => failure.stage === "project-resolution"
+        || failure.stage === "health"
+        || failure.stage === "observations"
+        || failure.stage === "refresh") === true;
+    const coreComplete = serviceAvailable && observationsAvailable && !criticalFailure;
+    const partial = input.projects !== undefined || (observationsAvailable && projectNameFor(input) !== undefined);
+    const health = coreComplete
+        ? "ok"
+        : partial || current.lastRefreshAt
+            ? "stale"
+            : input.health
+                ? "error"
+                : "offline";
+    const projectName = input.resolution
+        ? input.resolution.projectName
+        : input.projectName ?? current.projectName;
+    const sameProject = projectName !== undefined && projectName === current.projectName;
+    const observations = input.observations !== undefined
+        ? input.observations.filter((observation) => observation.project === projectName)
+        : sameProject ? current.observations ?? [] : [];
+    const activity = input.observations !== undefined
+        ? observations
+        : sameProject ? current.recentActivity : [];
+    const failure = input.failures?.[0];
+    const error = input.errors?.[0];
+    const warning = input.warnings?.[0];
+    const reduced = {
+        projectName,
+        resolution: input.resolution ?? current.resolution,
+        project: projectForRefresh(current.project, input.projects, observationsAvailable ? observations : undefined, projectName),
+        workflowMode: current.workflowMode ?? "odd",
+        changes: workflowChanges(current.workflowMode, observations),
+        observations,
+        odd: input.observations === undefined && sameProject && current.odd
+            ? current.odd
+            : deriveODDState(observations),
+        blockers: input.observations !== undefined
+            ? collectBlockers(observations)
+            : sameProject ? current.blockers : [],
+        recentActivity: [...activity]
+            .sort((a, b) => b.updated_at.localeCompare(a.updated_at) || b.id - a.id)
+            .slice(0, 5),
+        health,
+        loading: false,
+        lastRefreshAt: coreComplete ? input.now : current.lastRefreshAt,
+        targets: input.targets ?? current.targets,
+        error: failure
+            ? describeFailure(failure, input)
+            : error !== undefined
+                ? messageOf(error)
+                : warning
+                    ? warning
+                    : serviceAvailable
+                        ? coreComplete ? undefined : "Engram observations unavailable"
+                        : input.health ? "Engram health check failed" : "Engram is offline",
+    };
+    reduced.terminal = {
+        status: outcomeFor(input).status,
+        stage: "terminal",
+        health: reduced.health,
+        observationCount: observations.length,
+    };
+    return reduced;
+}
+export async function fetchSidebarRefresh(adapter, options = {}) {
+    const stageTimeoutMs = options.stageTimeoutMs ?? DEFAULT_STAGE_TIMEOUT_MS;
+    let resolution = options.resolution;
+    const failures = [];
+    const stages = [];
+    const transition = (stage) => {
+        stages.push(stage);
+        options.onTransition?.(stage);
+    };
+    if (options.resolveProject) {
+        transition({ stage: "project-resolution", status: "started", endpoint: defaultEndpoint("project-resolution") });
+        try {
+            resolution = await withStageTimeout(options.resolveProject(), "project resolution", stageTimeoutMs, defaultEndpoint("project-resolution"));
+            if (resolution.validation === "offline") {
+                const failure = {
+                    stage: "project-resolution",
+                    reason: new Error("Engram project validation was unavailable"),
+                };
+                failures.push(failure);
+                transition({
+                    stage: "project-resolution",
+                    status: "failed",
+                    endpoint: defaultEndpoint("project-resolution"),
+                    message: messageOf(failure.reason),
+                });
+            }
+            else {
+                transition({ stage: "project-resolution", status: "success", endpoint: defaultEndpoint("project-resolution") });
+            }
+        }
+        catch (reason) {
+            const failure = failureFor("project-resolution", reason);
+            failures.push(failure);
+            transition({
+                stage: "project-resolution",
+                status: "failed",
+                endpoint: failure.endpoint,
+                message: messageOf(reason),
+            });
+        }
+    }
+    else {
+        transition({
+            stage: "project-resolution",
+            status: resolution || options.projectName ? "success" : "skipped",
+            endpoint: defaultEndpoint("project-resolution"),
+        });
+    }
+    const projectName = resolution ? resolution.projectName : options.projectName;
+    const healthRequest = trackRequest(Promise.resolve().then(() => adapter.health()), "health", stageTimeoutMs, transition);
+    const projectsRequest = trackRequest(Promise.resolve().then(() => adapter.listProjects()), "projects", stageTimeoutMs, transition);
+    const observationsRequest = fetchCanonicalObservations(adapter, projectName, stageTimeoutMs, transition);
+    const [health, projects, canonicalObservations] = await Promise.allSettled([
+        healthRequest,
+        projectsRequest,
+        observationsRequest,
+    ]);
+    if (health.status === "rejected")
+        failures.push(failureFor("health", health.reason));
+    if (projects.status === "rejected")
+        failures.push(failureFor("projects", projects.reason));
+    if (canonicalObservations.status === "rejected") {
+        failures.push(failureFor("observations", canonicalObservations.reason));
+    }
+    return {
+        health: health.status === "fulfilled" ? health.value : undefined,
+        projects: projects.status === "fulfilled" ? projects.value : undefined,
+        observations: canonicalObservations.status === "fulfilled"
+            ? canonicalObservations.value.observations
+            : undefined,
+        projectName,
+        resolution,
+        targets: adapter.describeTargets?.(),
+        errors: [health, projects, canonicalObservations]
+            .filter((result) => result.status === "rejected")
+            .map((result) => result.reason),
+        failures: failures.length ? failures : undefined,
+        warnings: canonicalObservations.status === "fulfilled" && canonicalObservations.value.warning
+            ? [canonicalObservations.value.warning]
+            : undefined,
+        stages,
+        now: options.now?.() ?? new Date(),
+    };
+}
+function projectNameFor(input) {
+    return input.resolution ? input.resolution.projectName : input.projectName;
+}
+async function fetchCanonicalObservations(adapter, projectName, timeoutMs, onTransition) {
+    const endpoint = defaultEndpoint("observations");
+    if (!projectName) {
+        onTransition({ stage: "filtered-observations", status: "skipped", endpoint, count: 0 });
+        onTransition({ stage: "fallback-observations", status: "skipped", endpoint, count: 0 });
+        return { observations: [] };
+    }
+    const deadline = Date.now() + timeoutMs;
+    const run = async (stage, request) => {
+        onTransition({ stage, status: "started", endpoint });
+        try {
+            const observations = await withStageTimeout(Promise.resolve().then(request), stage === "filtered-observations" ? "filtered observations request" : "fallback observations request", Math.max(0, deadline - Date.now()), endpoint);
+            onTransition({ stage, status: "success", endpoint, count: observations.length });
+            return observations;
+        }
+        catch (reason) {
+            onTransition({ stage, status: "failed", endpoint, message: messageOf(reason) });
+            throw reason;
+        }
+    };
+    const filtered = await run("filtered-observations", () => adapter.listObservations({
+        project: projectName,
+        limit: SIDEBAR_OBSERVATION_LIMIT,
+    }));
+    if (filtered.length > 0 && filtered.every((observation) => observation.project === projectName)) {
+        onTransition({ stage: "fallback-observations", status: "skipped", endpoint });
+        return { observations: filtered };
+    }
+    const unfiltered = await run("fallback-observations", () => adapter.listObservations({ limit: OBSERVATION_FALLBACK_LIMIT }));
+    const observations = unfiltered
+        .filter((observation) => observation.project === projectName)
+        .slice(0, SIDEBAR_OBSERVATION_LIMIT);
+    const reason = filtered.length === 0
+        ? "Filtered observations returned no records"
+        : "Filtered observations returned cross-project records";
+    return {
+        observations,
+        warning: `${reason}; used bounded unfiltered fallback (limit ${OBSERVATION_FALLBACK_LIMIT}) with exact project matching for ${projectName}.`,
+    };
+}
+function projectForRefresh(current, projects, observations, projectName) {
+    if (!projectName)
+        return undefined;
+    const refreshed = projects?.find((project) => project.name === projectName);
+    const previous = current?.name === projectName ? current : undefined;
+    if (observations === undefined)
+        return previous ?? refreshed;
+    const base = refreshed ?? previous;
+    if (!base && observations.length === 0)
+        return undefined;
+    const latestObservation = observations.reduce((latest, observation) => !latest || observation.updated_at > latest
+        ? observation.updated_at
+        : latest, undefined);
+    const lastActiveAt = base?.lastActiveAt ?? latestObservation;
+    if (!lastActiveAt)
+        return undefined;
+    return {
+        name: projectName,
+        observationCount: observations.length,
+        lastActiveAt,
+        scopes: base?.scopes ?? [...new Set(observations.map((observation) => observation.scope))].sort(),
+    };
+}
+export function createEngramReadController(adapter, options = {}) {
+    let state = {
+        ...EMPTY_STATE,
+        projectName: options.projectName,
+        resolution: options.resolution,
+        error: options.initialError,
+        loading: options.enabled !== false,
+    };
+    let generation = 0;
+    let disposed = false;
+    let initialResolutionPending = hasValidatedProjectName(options.resolution);
+    const publish = (update) => {
+        if (disposed)
+            return;
+        state = update(state);
+        options.onState?.(state);
+    };
+    const refresh = async () => {
+        if (disposed) {
+            return {
+                status: "failed",
+                summary: "Engram controller is disposed",
+                failures: [],
+                warnings: [],
+                stages: [{ stage: "terminal", status: "failed", message: "Engram controller is disposed" }],
+            };
+        }
+        const currentGeneration = ++generation;
+        const useInitialResolution = initialResolutionPending;
+        initialResolutionPending = false;
+        publish((current) => ({
+            ...current,
+            loading: true,
+            terminal: {
+                status: "loading",
+                stage: "refresh",
+                health: current.health,
+                observationCount: current.terminal?.observationCount ?? current.project?.observationCount ?? 0,
+            },
+        }));
+        try {
+            const input = await fetchSidebarRefresh(adapter, {
+                ...options,
+                resolveProject: useInitialResolution ? undefined : options.resolveProject,
+                onTransition: (transition) => {
+                    if (currentGeneration !== generation)
+                        return;
+                    publish((current) => ({
+                        ...current,
+                        terminal: {
+                            status: "loading",
+                            stage: transition.stage,
+                            health: current.health,
+                            observationCount: transition.stage.includes("observations") && transition.count !== undefined
+                                ? transition.count
+                                : current.terminal?.observationCount ?? 0,
+                        },
+                    }));
+                },
+            });
+            if (currentGeneration !== generation)
+                return outcomeFor(input);
+            input.stages?.push({ stage: "reducing", status: "started" });
+            publish((current) => ({
+                ...current,
+                terminal: {
+                    status: "loading",
+                    stage: "reducing",
+                    health: current.health,
+                    observationCount: input.observations?.length ?? current.terminal?.observationCount ?? 0,
+                },
+            }));
+            publish((current) => reduceSidebarRefresh(current, input));
+            input.stages?.push({ stage: "reducing", status: "success" });
+            const outcome = outcomeFor(input);
+            outcome.stages.push({ stage: "terminal", status: outcome.status, message: outcome.summary });
+            return outcome;
+        }
+        catch (reason) {
+            const failure = { stage: "refresh", reason };
+            if (currentGeneration !== generation) {
+                return outcomeFor({ failures: [failure], now: options.now?.() ?? new Date() });
+            }
+            const input = {
+                projectName: state.projectName ?? options.projectName,
+                resolution: state.resolution ?? options.resolution,
+                failures: [failure],
+                now: options.now?.() ?? new Date(),
+            };
+            publish((current) => reduceSidebarRefresh(current, input));
+            const outcome = outcomeFor(input);
+            outcome.stages.push({ stage: "terminal", status: "failed", message: outcome.summary });
+            return outcome;
+        }
+    };
+    return {
+        getState: () => state,
+        refresh,
+        setWorkflowMode(mode) {
+            if (disposed || state.workflowMode === mode)
+                return;
+            publish((current) => ({
+                ...current,
+                workflowMode: mode,
+                changes: workflowChanges(mode, current.observations ?? []),
+            }));
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            generation += 1;
+        },
+    };
+}
+function failureFor(stage, reason) {
+    return {
+        stage,
+        endpoint: reason instanceof EngramUnavailable ? reason.endpoint : defaultEndpoint(stage),
+        reason,
+    };
+}
+function defaultEndpoint(stage) {
+    if (stage === "project-resolution")
+        return "/observations/recent + /sessions/recent";
+    if (stage === "health")
+        return "/health";
+    if (stage === "projects")
+        return "/observations/recent + /sessions/recent";
+    if (stage === "observations")
+        return "/observations/recent";
+    return undefined;
+}
+function hasValidatedProjectName(resolution) {
+    return Boolean(resolution?.projectName
+        && (resolution.validation === "exact" || resolution.validation === "case-insensitive"));
+}
+export function withStageTimeout(promise, stage, timeoutMs, endpoint) {
+    return new Promise((resolve, reject) => {
+        let cancelTimeout = () => undefined;
+        promise.then((value) => {
+            cancelTimeout();
+            resolve(value);
+        }, (reason) => {
+            cancelTimeout();
+            reject(reason);
+        });
+        const onTimeout = () => {
+            reject(new EngramUnavailable(`${stage} timed out after ${timeoutMs}ms`, undefined, {
+                kind: "timeout",
+                endpoint,
+            }));
+        };
+        if (timeoutMs === 0) {
+            const timeoutId = setTimeout(onTimeout, 0);
+            cancelTimeout = () => clearTimeout(timeoutId);
+        }
+        else {
+            cancelTimeout = scheduleLongTimeout(onTimeout, timeoutMs);
+        }
+    });
+}
+async function trackRequest(promise, stage, timeoutMs, onTransition) {
+    const endpoint = defaultEndpoint(stage);
+    onTransition({ stage, status: "started", endpoint });
+    try {
+        const value = await withStageTimeout(promise, `${stage} request`, timeoutMs, endpoint);
+        onTransition({
+            stage,
+            status: "success",
+            endpoint,
+            count: Array.isArray(value) ? value.length : undefined,
+        });
+        return value;
+    }
+    catch (reason) {
+        onTransition({ stage, status: "failed", endpoint, message: messageOf(reason) });
+        throw reason;
+    }
+}
+export function outcomeFor(input) {
+    const failures = input.failures ?? [];
+    const warnings = input.warnings ?? [];
+    const coreComplete = input.health?.local.available === true
+        && input.observations !== undefined
+        && !failures.some((failure) => failure.stage !== "projects");
+    const hasUsableData = input.health !== undefined
+        || input.projects !== undefined
+        || input.observations !== undefined;
+    const status = coreComplete && failures.length === 0 && warnings.length === 0
+        ? "success"
+        : hasUsableData
+            ? "partial"
+            : "failed";
+    const firstFailure = failures[0];
+    const summary = firstFailure
+        ? `${firstFailure.endpoint ? `${firstFailure.stage} ${firstFailure.endpoint}` : firstFailure.stage}: ${messageOf(firstFailure.reason)}`
+        : warnings[0]
+            ?? (status === "success" ? "Refresh complete" : "required refresh data unavailable");
+    return {
+        status,
+        summary,
+        failures,
+        warnings,
+        stages: [...(input.stages ?? [])],
+    };
+}
+function describeFailure(failure, input) {
+    const location = failure.endpoint ? `${failure.stage} ${failure.endpoint}` : failure.stage;
+    const projects = input.projects === undefined ? "unavailable" : String(input.projects.length);
+    const observations = input.observations === undefined ? "unavailable" : String(input.observations.length);
+    return `${location}: ${messageOf(failure.reason)} (projects=${projects}, observations=${observations})`;
+}
+//# sourceMappingURL=core.js.map

package/dist/viewer/core.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-flema-engram-sidebar",
-  "version": "0.2.0",
-  "description": "Local-first OpenCode plugin/sidebar for Engram memory and SDD context, with an optional MCP stdio adapter",
+  "version": "0.4.0",
+  "description": "Read-only Engram viewers for OpenCode and Pi/Gentle Shell with ODD-first project context and an optional MCP stdio adapter",
   "type": "module",
   "exports": {
     ".": {
@@ -11,8 +11,21 @@
     "./tui": {
       "types": "./dist/sidebar/plugin.d.ts",
       "import": "./dist/sidebar/plugin.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./pi": {
+      "types": "./dist/pi.d.ts",
+      "import": "./dist/pi.js"
     }
   },
+  "pi": {
+    "extensions": [
+      "./dist/pi.js"
+    ]
+  },
   "bin": {
     "flema-engram": "dist/maintenance.js",
     "mcp-flema-engram": "dist/stdio.js"
@@ -41,9 +54,12 @@
     "engram",
     "local-first",
     "developer-tools",
-    "sdd",
+    "odd",
+    "pi",
+    "gentle-shell",
     "memory",
-    "mcp"
+    "mcp",
+    "pi-package"
   ],
   "license": "MIT",
   "repository": {