opencode-flema-engram-sidebar 0.1.0

package/dist/sidebar/plugin.js

@@ -0,0 +1,288 @@
+import { jsx as _jsx } from "@opentui/solid/jsx-runtime";
+/** @jsxImportSource @opentui/solid */
+import { createSignal, ErrorBoundary, onCleanup } from "solid-js";
+import { LocalEngramAdapter } from "../adapters/local.js";
+import { resolveProject } from "../utils/project-resolver.js";
+import { activityLines } from "./components/activity-feed.js";
+import { blockerLines } from "./components/blockers.js";
+import { phaseProgressLines } from "./components/phase-progress.js";
+import { projectLines } from "./components/project-list.js";
+import { useEngram } from "./hooks/use-engram.js";
+export const REFRESH_SHORTCUT = "alt+r";
+export function createSidebarActionRegistry() {
+    const defaultSession = "engram-default-session";
+    const instances = new Map();
+    const createMount = (requestedSession) => {
+        const sessionId = requestedSession ?? defaultSession;
+        const token = Symbol("engram-sidebar-mount");
+        let initialRefreshScheduled = false;
+        let initialRefreshTimer;
+        instances.set(sessionId, { token });
+        const dispose = () => {
+            if (initialRefreshTimer !== undefined)
+                clearTimeout(initialRefreshTimer);
+            if (instances.get(sessionId)?.token === token)
+                instances.delete(sessionId);
+        };
+        return {
+            activate(dependencies) {
+                const active = instances.get(sessionId);
+                if (active?.token === token)
+                    active.dependencies = dependencies;
+                return dispose;
+            },
+            scheduleInitialRefresh(visibleSession) {
+                if (initialRefreshScheduled)
+                    return;
+                initialRefreshScheduled = true;
+                initialRefreshTimer = setTimeout(() => {
+                    initialRefreshTimer = undefined;
+                    const active = instances.get(sessionId);
+                    if (active?.token !== token || !active.dependencies || visibleSession() !== sessionId)
+                        return;
+                    void runCurrent(REFRESH_SHORTCUT, sessionId, visibleSession, token);
+                }, 0);
+            },
+            dispose,
+        };
+    };
+    const runCurrent = async (key, sessionId, visibleSession, expectedToken) => {
+        const active = instances.get(sessionId);
+        if (!active?.dependencies || (expectedToken && active.token !== expectedToken))
+            return false;
+        if (visibleSession() !== sessionId)
+            return false;
+        return handleSidebarKey(key, {
+            ...active.dependencies,
+            isCurrent: () => instances.get(sessionId)?.token === active.token && visibleSession() === sessionId,
+        });
+    };
+    return {
+        activate(dependencies, requestedSession) {
+            return createMount(requestedSession).activate(dependencies);
+        },
+        createMount,
+        current(sessionId = defaultSession) {
+            return instances.get(sessionId)?.dependencies;
+        },
+        async run(key, requestedSession, visibleSession = () => requestedSession ?? defaultSession) {
+            const sessionId = requestedSession ?? defaultSession;
+            return runCurrent(key, sessionId, visibleSession);
+        },
+    };
+}
+export function describeSidebar(state, actionStatus) {
+    const health = healthPresentation(state.health);
+    const lines = [
+        "🧠 Engram",
+        `${health.icon} Health: ${healthLabel(state.health)}`,
+        ...projectLines({
+            projectName: state.projectName,
+            project: state.project,
+            resolution: state.resolution,
+        }),
+        ...phaseProgressLines(state.changes),
+        ...blockerLines(state.blockers),
+        ...activityLines(state.recentActivity),
+        `🔄 [${REFRESH_SHORTCUT}] Refresh`,
+    ];
+    if (state.health === "offline")
+        lines.splice(2, 0, `⚠️ Engram is offline; press ${REFRESH_SHORTCUT} to retry.`);
+    if (state.health === "stale")
+        lines.splice(2, 0, `🕒 Showing stale data; press ${REFRESH_SHORTCUT} to retry.`);
+    if (state.error)
+        lines.splice(state.health === "offline" || state.health === "stale" ? 3 : 2, 0, `⚠️ Detail: ${state.error}`);
+    if (actionStatus)
+        lines.push(actionStatus);
+    return lines;
+}
+export async function handleSidebarKey(key, dependencies) {
+    if (key === REFRESH_SHORTCUT) {
+        dependencies.setStatus("🔄 Refreshing…");
+        try {
+            const outcome = await dependencies.refresh();
+            const visibleState = dependencies.state?.();
+            const terminal = visibleState?.terminal;
+            const reachedVisibleSuccess = outcome?.status === "success"
+                && dependencies.isCurrent?.() !== false
+                && visibleState?.loading === false
+                && visibleState.health === "ok"
+                && terminal?.status === "success"
+                && terminal.stage === "terminal";
+            dependencies.setStatus(reachedVisibleSuccess
+                ? "✅ Refreshed"
+                : `⚠️ Refresh incomplete: ${outcome?.status !== "success"
+                    ? outcome?.summary ?? "refresh returned no terminal outcome"
+                    : `stage=${terminal?.stage ?? "unbound"}`}`);
+        }
+        catch (error) {
+            dependencies.setStatus(`💔 Refresh failed: ${failureMessage(error)}`);
+        }
+        return true;
+    }
+    return false;
+}
+export function renderSidebarSafely(render, props) {
+    try {
+        return { ok: true, element: render(props) };
+    }
+    catch (error) {
+        return { ok: false, error: failureMessage(error) };
+    }
+}
+function asOptions(input) {
+    return {
+        enabled: typeof input?.enabled === "boolean" ? input.enabled : undefined,
+        project: typeof input?.project === "string" ? input.project : undefined,
+        pollInterval: typeof input?.pollInterval === "number" && input.pollInterval > 0
+            ? input.pollInterval
+            : undefined,
+    };
+}
+function healthLabel(health) {
+    if (health === "loading")
+        return "CHECKING";
+    return String(health).toUpperCase();
+}
+function healthPresentation(health) {
+    switch (health) {
+        case "ok":
+            return { icon: "🟢", color: "success" };
+        case "error":
+        case "offline":
+            return { icon: "💔", color: "error" };
+        default:
+            return { icon: "⚠️", color: "warning" };
+    }
+}
+export function EngramSidebar(props) {
+    const engram = useEngram(props.adapter, {
+        projectName: props.projectName,
+        resolution: props.projectResolution,
+        initialError: props.initialError,
+        pollInterval: props.pollInterval,
+        resolveProject: props.resolveProject,
+        autoRefresh: false,
+    });
+    const [actionStatus, setActionStatus] = createSignal();
+    const text = createSidebarTextAccessor(engram.state, actionStatus);
+    const actionDependencies = {
+        refresh: engram.refresh,
+        setStatus: setActionStatus,
+        state: engram.state,
+    };
+    const deactivate = props.actionMount
+        ? props.actionMount.activate(actionDependencies)
+        : props.actionRegistry.activate(actionDependencies, props.sessionId);
+    onCleanup(deactivate);
+    return (_jsx(ErrorBoundary, { fallback: (error) => _jsx("text", { children: `Engram sidebar unavailable: ${String(error)}` }), children: _jsx("text", { fg: props.theme?.current.text, children: text() }) }));
+}
+export function createSidebarTextAccessor(state, actionStatus) {
+    return () => describeSidebar(state(), actionStatus()).join("\n");
+}
+export function createSidebarSectionAccessors(state) {
+    return {
+        project: {
+            projectName: () => state().projectName,
+            project: () => state().project,
+            resolution: () => state().resolution,
+        },
+        changes: () => state().changes,
+        blockers: () => state().blockers,
+        activity: () => state().recentActivity,
+    };
+}
+function failureMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function createEngramTuiPlugin(dependencies = {}) {
+    const adapter = dependencies.adapter ?? new LocalEngramAdapter();
+    const cwd = dependencies.cwd ?? process.cwd();
+    const renderSidebar = dependencies.renderSidebar ?? ((props) => _jsx(EngramSidebar, { ...props }));
+    const actionRegistry = dependencies.actionRegistry ?? createSidebarActionRegistry();
+    return {
+        id: "engram-sidebar",
+        tui: async (api, rawOptions) => {
+            const options = asOptions(rawOptions);
+            if (options.enabled === false)
+                return;
+            let projectResolution;
+            let initialError;
+            try {
+                projectResolution = await resolveProject(adapter, cwd, {
+                    explicitProject: options.project,
+                });
+                if (projectResolution.validation === "offline") {
+                    initialError = "Engram project validation was unavailable during startup";
+                }
+            }
+            catch (error) {
+                projectResolution = { validation: "offline" };
+                initialError = `Initial project resolution failed: ${failureMessage(error)}`;
+            }
+            api.keymap.registerLayer({
+                mode: "base",
+                commands: [
+                    {
+                        name: "engram.refresh",
+                        title: "Refresh Engram sidebar",
+                        category: "Engram",
+                        run: () => {
+                            const sessionId = currentRouteSession(api.route.current);
+                            return sessionId
+                                ? actionRegistry.run(REFRESH_SHORTCUT, sessionId, () => currentRouteSession(api.route.current))
+                                : false;
+                        },
+                    },
+                ],
+                bindings: [
+                    { key: REFRESH_SHORTCUT, cmd: "engram.refresh", desc: "Refresh Engram sidebar" },
+                ],
+            });
+            const slot = {
+                slots: {
+                    sidebar_content(context, _props) {
+                        const actionMount = actionRegistry.createMount(_props.session_id);
+                        const result = renderSidebarSafely(renderSidebar, {
+                            adapter,
+                            projectName: projectResolution.projectName,
+                            projectResolution,
+                            initialError,
+                            pollInterval: options.pollInterval,
+                            theme: context.theme,
+                            actionRegistry,
+                            actionMount,
+                            sessionId: _props.session_id,
+                            resolveProject: () => resolveProject(adapter, cwd, {
+                                explicitProject: options.project,
+                            }),
+                        });
+                        if (result.ok) {
+                            actionMount.scheduleInitialRefresh(() => currentRouteSession(api.route.current));
+                        }
+                        else {
+                            actionMount.dispose();
+                        }
+                        return result.ok
+                            ? result.element
+                            : _jsx("text", { children: `Engram sidebar unavailable: ${result.error}` });
+                    },
+                },
+            };
+            api.slots.register(slot);
+        },
+    };
+}
+const plugin = createEngramTuiPlugin();
+export default plugin;
+export { ActivityFeed } from "./components/activity-feed.js";
+export { Blockers } from "./components/blockers.js";
+export { PhaseProgress } from "./components/phase-progress.js";
+export { ProjectList } from "./components/project-list.js";
+export { useEngram } from "./hooks/use-engram.js";
+function currentRouteSession(route) {
+    return route.name === "session" && typeof route.params?.sessionID === "string"
+        ? route.params.sessionID
+        : undefined;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/sidebar/plugin.js.map

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

package/dist/stdio.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":""}

package/dist/stdio.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { LocalEngramAdapter } from "./adapters/local.js";
+import { EngramMcpServer } from "./mcp/server.js";
+const server = new EngramMcpServer({ adapter: new LocalEngramAdapter() });
+let stopping = false;
+async function stop() {
+    if (stopping)
+        return;
+    stopping = true;
+    await server.stop();
+}
+for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.once(signal, () => void stop().finally(() => process.exit(0)));
+}
+process.once("uncaughtException", (error) => {
+    console.error(error instanceof Error ? error.message : "Internal MCP server error");
+    void stop().finally(() => process.exit(1));
+});
+await server.start();
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAC1E,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,KAAK,UAAU,IAAI;IACjB,IAAI,QAAQ;QAAE,OAAO;IACrB,QAAQ,GAAG,IAAI,CAAC;IAChB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;IACpF,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class EngramUnavailable extends Error {
+    readonly kind: EngramErrorKind;
+    readonly statusCode?: number;
+    readonly endpoint?: string;
+    constructor(message: string, cause?: Error, opts?: {
+        kind?: EngramErrorKind;
+        statusCode?: number;
+        endpoint?: string;
+    });
+}
+export type EngramErrorKind = "connection" | "timeout" | "http" | "parse" | "validation";
+export declare class ValidationError extends Error {
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class NotImplemented extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,eAAe,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAOtH;AAED,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;AAEzF,qBAAa,eAAgB,SAAQ,KAAK;aACK,OAAO,CAAC,EAAE,OAAO;gBAAlD,OAAO,EAAE,MAAM,EAAkB,OAAO,CAAC,EAAE,OAAO,YAAA;CAI/D;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,SAAoB;CAIxC"}

package/dist/utils/errors.js

@@ -0,0 +1,27 @@
+export class EngramUnavailable extends Error {
+    kind;
+    statusCode;
+    endpoint;
+    constructor(message, cause, opts) {
+        super(message, cause ? { cause } : undefined);
+        this.name = "EngramUnavailable";
+        this.kind = opts?.kind ?? "connection";
+        this.statusCode = opts?.statusCode;
+        this.endpoint = opts?.endpoint;
+    }
+}
+export class ValidationError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "ValidationError";
+    }
+}
+export class NotImplemented extends Error {
+    constructor(message = "Not implemented") {
+        super(message);
+        this.name = "NotImplemented";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1B,IAAI,CAAkB;IACtB,UAAU,CAAU;IACpB,QAAQ,CAAU;IAElC,YAAY,OAAe,EAAE,KAAa,EAAE,IAAyE;QACnH,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,YAAY,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAC;IACjC,CAAC;CACF;AAID,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACK;IAA7C,YAAY,OAAe,EAAkB,OAAiB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,YAAO,GAAP,OAAO,CAAU;QAE5D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,GAAG,iBAAiB;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/utils/format.d.ts

@@ -0,0 +1,11 @@
+/**
+ * formatRelativeTime
+ *
+ * Formats an ISO date string as a human-readable relative time
+ * (e.g. "just now", "5m ago", "2h ago", "3d ago").
+ */
+/**
+ * Formats a date string to a relative time format
+ */
+export declare function formatRelativeTime(dateStr: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgB1D"}

package/dist/utils/format.js

@@ -0,0 +1,30 @@
+/**
+ * formatRelativeTime
+ *
+ * Formats an ISO date string as a human-readable relative time
+ * (e.g. "just now", "5m ago", "2h ago", "3d ago").
+ */
+/**
+ * Formats a date string to a relative time format
+ */
+export function formatRelativeTime(dateStr) {
+    const date = new Date(dateStr);
+    if (Number.isNaN(date.getTime())) {
+        return "";
+    }
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffMins = Math.floor(diffMs / 60_000);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffMins < 1)
+        return "just now";
+    if (diffMins < 60)
+        return `${diffMins}m ago`;
+    if (diffHours < 24)
+        return `${diffHours}h ago`;
+    if (diffDays < 7)
+        return `${diffDays}d ago`;
+    return date.toLocaleDateString();
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IAE5C,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACpC,IAAI,QAAQ,GAAG,EAAE;QAAE,OAAO,GAAG,QAAQ,OAAO,CAAC;IAC7C,IAAI,SAAS,GAAG,EAAE;QAAE,OAAO,GAAG,SAAS,OAAO,CAAC;IAC/C,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,GAAG,QAAQ,OAAO,CAAC;IAC5C,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils/project-resolver.d.ts

@@ -0,0 +1,21 @@
+import type { EngramAdapter } from "../adapters/types.js";
+export interface ProjectResolutionOptions {
+    explicitProject?: string;
+    envProject?: string;
+}
+export type ProjectCandidateSource = "explicit" | "environment" | "cwd";
+export type ProjectValidation = "exact" | "case-insensitive" | "ambiguous" | "no-match" | "offline" | "no-candidate";
+export interface ProjectResolution {
+    projectName?: string;
+    candidate?: string;
+    source?: ProjectCandidateSource;
+    validation: ProjectValidation;
+}
+export declare function resolveProjectName(cwd: string, options?: ProjectResolutionOptions): string | undefined;
+/**
+ * Resolves one workspace candidate and validates it against live Engram data.
+ * A candidate is never promoted to projectName unless Engram confirms it.
+ */
+export declare function resolveProject(adapter: Pick<EngramAdapter, "listProjects">, cwd: string, options?: ProjectResolutionOptions): Promise<ProjectResolution>;
+export declare function normalizeProjectName(name: string): string | undefined;
+//# sourceMappingURL=project-resolver.d.ts.map

package/dist/utils/project-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/project-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,aAAa,GAAG,KAAK,CAAC;AACxE,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,SAAS,GACT,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAaD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,MAAM,GAAG,SAAS,CAiBpB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,EAC5C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAwB5B;AAiFD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE"}

package/dist/utils/project-resolver.js

@@ -0,0 +1,122 @@
+import path from "node:path";
+function nonBlank(value) {
+    const candidate = value?.trim();
+    return candidate ? candidate : undefined;
+}
+export function resolveProjectName(cwd, options = {}) {
+    const explicit = nonBlank(options.explicitProject);
+    if (explicit)
+        return explicit;
+    const environment = nonBlank(options.envProject ?? process.env.ENGRAM_PROJECT);
+    if (environment)
+        return environment;
+    const candidate = nonBlank(cwd);
+    if (!candidate)
+        return undefined;
+    const pathApi = /^[A-Za-z]:[\\/]/.test(candidate) || candidate.includes("\\")
+        ? path.win32
+        : path.posix;
+    const resolved = pathApi.resolve(candidate);
+    if (resolved === pathApi.parse(resolved).root)
+        return undefined;
+    return normalizeProjectName(pathApi.basename(resolved));
+}
+/**
+ * Resolves one workspace candidate and validates it against live Engram data.
+ * A candidate is never promoted to projectName unless Engram confirms it.
+ */
+export async function resolveProject(adapter, cwd, options = {}) {
+    const candidates = resolveProjectCandidates(cwd, options);
+    if (candidates.length === 0)
+        return { validation: "no-candidate" };
+    let knownNames;
+    try {
+        knownNames = (await adapter.listProjects()).map((project) => project.name);
+    }
+    catch {
+        const candidate = candidates[0];
+        return {
+            candidate: candidate.source === "cwd" ? undefined : candidate.name,
+            source: candidate.source,
+            validation: "offline",
+        };
+    }
+    let unresolved;
+    for (const candidate of candidates) {
+        const resolution = matchProjectCandidate(knownNames, candidate);
+        if (resolution.projectName)
+            return resolution;
+        if (resolution.validation === "ambiguous" || !unresolved)
+            unresolved = resolution;
+    }
+    return unresolved ?? { validation: "no-candidate" };
+}
+function matchProjectCandidate(knownNames, candidate) {
+    const exactMatches = knownNames.filter((name) => name === candidate.name);
+    if (exactMatches.length === 1) {
+        return {
+            projectName: exactMatches[0],
+            candidate: candidate.name,
+            source: candidate.source,
+            validation: "exact",
+        };
+    }
+    if (exactMatches.length > 1) {
+        return { candidate: candidate.name, source: candidate.source, validation: "ambiguous" };
+    }
+    const foldedCandidate = candidate.name.toLowerCase();
+    let foldedMatches = knownNames.filter((name) => name.toLowerCase() === foldedCandidate);
+    if (candidate.pathLike) {
+        const normalizedCandidate = normalizePathForComparison(candidate.name);
+        foldedMatches = knownNames.filter((name) => name.toLowerCase() === foldedCandidate
+            || normalizePathForComparison(name) === normalizedCandidate);
+    }
+    if (foldedMatches.length === 1) {
+        return {
+            projectName: foldedMatches[0],
+            candidate: candidate.name,
+            source: candidate.source,
+            validation: "case-insensitive",
+        };
+    }
+    return {
+        candidate: candidate.name,
+        source: candidate.source,
+        validation: foldedMatches.length > 1 ? "ambiguous" : "no-match",
+    };
+}
+function resolveProjectCandidates(cwd, options) {
+    const explicit = nonBlank(options.explicitProject);
+    if (explicit)
+        return [{ name: explicit, source: "explicit" }];
+    const environment = nonBlank(options.envProject ?? process.env.ENGRAM_PROJECT);
+    if (environment)
+        return [{ name: environment, source: "environment" }];
+    const name = resolveProjectName(cwd, { envProject: "" });
+    if (!name)
+        return [];
+    const candidates = [{ name, source: "cwd" }];
+    const absolutePath = resolveAbsolutePath(cwd);
+    if (absolutePath && absolutePath !== name) {
+        candidates.push({ name: absolutePath, source: "cwd", pathLike: true });
+    }
+    return candidates;
+}
+function resolveAbsolutePath(cwd) {
+    const candidate = nonBlank(cwd);
+    if (!candidate)
+        return undefined;
+    const pathApi = /^[A-Za-z]:[\\/]/.test(candidate) || candidate.includes("\\")
+        ? path.win32
+        : path.posix;
+    const resolved = pathApi.normalize(pathApi.resolve(candidate));
+    return resolved === pathApi.parse(resolved).root ? undefined : resolved;
+}
+function normalizePathForComparison(value) {
+    return value.trim().replace(/[\\/]+/g, "\\").replace(/\\+$/, "").toLowerCase();
+}
+export function normalizeProjectName(name) {
+    const normalized = name.trim().toLowerCase().replace(/\s+/g, "-");
+    return /[\p{L}\p{N}]/u.test(normalized) ? normalized : undefined;
+}
+//# sourceMappingURL=project-resolver.js.map

package/dist/utils/project-resolver.js.map

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

package/dist/utils/sdd-detector.d.ts

@@ -0,0 +1,35 @@
+import type { Observation } from "../adapters/types.js";
+export declare const SDD_PHASES: readonly ["init", "explore", "proposal", "spec", "design", "tasks", "apply", "verify", "archive"];
+export type SDDPhaseName = (typeof SDD_PHASES)[number];
+export type SDDChangeState = "open" | "in-progress" | "completed" | "archived";
+export interface SDDArtifact {
+    observationId: number;
+    kind: SDDPhaseName;
+    topicKey: string;
+    title: string;
+    updatedAt: string;
+}
+export interface SDDPhase {
+    phase: SDDPhaseName;
+    status: "pending" | "in-progress" | "done";
+    topicKey: string;
+    observationId: number;
+}
+export interface SDDChange {
+    name: string;
+    state: SDDChangeState;
+    latestAt: string;
+    phases: SDDPhase[];
+    artifacts: SDDArtifact[];
+    blockers: Observation[];
+}
+export declare function normalizePhase(artifact: string): SDDPhaseName | undefined;
+export declare function parseSDDTopicKey(topicKey: string): {
+    changeName: string;
+    phase: SDDPhaseName;
+    artifact: string;
+} | null;
+export declare function collectBlockers(observations: Observation[]): Observation[];
+export declare function deriveChangeState(phases: readonly SDDPhaseName[]): SDDChangeState;
+export declare function groupByChange(observations: Observation[]): SDDChange[];
+//# sourceMappingURL=sdd-detector.d.ts.map

package/dist/utils/sdd-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-detector.d.ts","sourceRoot":"","sources":["../../src/utils/sdd-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,eAAO,MAAM,UAAU,mGAUb,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAUD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAMzE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAOP;AASD,wBAAgB,eAAe,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAS1E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,CAMjF;AAMD,wBAAgB,aAAa,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CA8DtE"}