@memoarchitect/tools 0.4.4

package/packages/tools/lib/protocol/messages.d.ts

@@ -0,0 +1,470 @@
+import type { MemoModelDTO } from '../model/semantic.js';
+import type { ValidationResult, CompletenessReport } from '../validator/types.js';
+import type { OntologyPackageInfo } from '../model/ontology-loader.js';
+import type { MethodologyDescriptor } from '../model/methodology-loader.js';
+export type ServerMessage = ModelUpdateMessage | ValidationUpdateMessage | CompletenessUpdateMessage | ErrorMessage | ImportResultMessage | DiagramParseResultMessage | DiagramSourceResultMessage | OntologyPackagesMessage | MethodologyUpdateMessage | DiagramLayoutMessage | OntologyInstallResultMessage | OntologyRemoveResultMessage | LlmStatusMessage | LlmAskResultMessage | LlmGenerateResultMessage | LlmDraftResultMessage | LlmSuggestResultMessage | RestartRequiredMessage | DhfDocsMessage | DhfSettingsMessage | DhfTemplatesResultMessage | DhfTemplateContentMessage;
+export interface ModelUpdateMessage {
+    type: 'model:update';
+    payload: MemoModelDTO;
+}
+export interface ValidationUpdateMessage {
+    type: 'validation:update';
+    payload: ValidationResult;
+}
+export interface CompletenessUpdateMessage {
+    type: 'completeness:update';
+    payload: CompletenessReport;
+}
+export interface ErrorMessage {
+    type: 'error';
+    payload: {
+        message: string;
+    };
+}
+/** Server sends ontology package metadata when client connects or memo.package.yaml changes */
+export interface OntologyPackagesMessage {
+    type: 'ontology:packages';
+    payload: {
+        packages: OntologyPackageInfo[];
+    };
+}
+/** Server sends parsed methodology data — Phase B (data-only, no UI yet) */
+export interface MethodologyUpdateMessage {
+    type: 'methodology:update';
+    payload: MethodologyDescriptor;
+}
+export type ClientMessage = RequestRefreshMessage | ElementUpdateMessage | ElementCreateMessage | AddRelationshipMessage | CsvImportMessage | DiagramCreateMessage | DiagramUpdateMessage | DiagramDeleteMessage | DiagramParseMessage | DiagramSourceRequestMessage | DiagramSourceSaveMessage | OntologySaveSelectionMessage | OntologyInstallMessage | OntologyRemoveMessage | DiagramLayoutUpdateMessage | LlmAskMessage | LlmGenerateMessage | LlmDraftMessage | LlmSuggestMessage | DhfDocsLoadMessage | DhfDocSaveMessage | DhfDocDeleteMessage | DhfSettingsSaveMessage | DhfTemplatesListMessage | DhfTemplateReadMessage;
+export interface RequestRefreshMessage {
+    type: 'request:refresh';
+}
+/** Client requests the server to persist ontology selection to memo.package.yaml */
+export interface OntologySaveSelectionMessage {
+    type: 'ontology:save-selection';
+    payload: {
+        selected: string[];
+    };
+}
+/** Client requests installing an ontology from git URL, npm package, or local path */
+export interface OntologyInstallMessage {
+    type: 'ontology:install';
+    payload: {
+        source: string;
+    };
+}
+/** Server responds to ontology:install with success/failure */
+export interface OntologyInstallResultMessage {
+    type: 'ontology:install:result';
+    payload: {
+        success: boolean;
+        packageName?: string;
+        error?: string;
+    };
+}
+/** Client requests removing an installed ontology package */
+export interface OntologyRemoveMessage {
+    type: 'ontology:remove';
+    payload: {
+        packageName: string;
+    };
+}
+/** Server responds to ontology:remove with success/failure */
+export interface OntologyRemoveResultMessage {
+    type: 'ontology:remove:result';
+    payload: {
+        success: boolean;
+        packageName: string;
+        error?: string;
+    };
+}
+/** Client requests an element field update (2-way sync) */
+export interface ElementUpdateMessage {
+    type: 'element:update';
+    payload: {
+        elementId: string;
+        doc?: string;
+        attributes?: Record<string, string>;
+    };
+}
+/** Client requests a new element creation in SysML */
+export interface ElementCreateMessage {
+    type: 'element:create';
+    payload: {
+        name: string;
+        kind: string;
+        construct: string;
+        attributes?: Record<string, string>;
+    };
+}
+/** Client requests a new relationship between two elements */
+export interface AddRelationshipMessage {
+    type: 'relationship:add';
+    payload: {
+        sourceId: string;
+        targetId: string;
+        type: string;
+    };
+}
+/** Client sends CSV data for bulk import of elements and/or relationships */
+export interface CsvImportMessage {
+    type: 'csv:import';
+    payload: {
+        /** CSV text for elements (optional — can import only relationships) */
+        elementsCsv?: string;
+        /** CSV text for relationships (optional — can import only elements) */
+        relationshipsCsv?: string;
+        /** Target package name for generated SysML file */
+        packageName?: string;
+        /** Target .sysml file path (relative to project root) */
+        targetFile?: string;
+    };
+}
+/** Client creates a new user diagram under a viewpoint */
+export interface DiagramCreateMessage {
+    type: 'diagram:create';
+    payload: {
+        id: string;
+        name: string;
+        diagramType: string;
+        viewpointId: string;
+        description?: string;
+        properties?: Record<string, string>;
+        elementIds?: string[];
+        relationshipTypes?: string[];
+    };
+}
+/** Client updates an existing diagram's metadata */
+export interface DiagramUpdateMessage {
+    type: 'diagram:update';
+    payload: {
+        id: string;
+        name?: string;
+        description?: string;
+        properties?: Record<string, string>;
+        elementIds?: string[];
+        relationshipTypes?: string[];
+    };
+}
+/** Client deletes a user-created diagram */
+export interface DiagramDeleteMessage {
+    type: 'diagram:delete';
+    payload: {
+        id: string;
+    };
+}
+/** Client requests server-side SysML parse to extract element IDs */
+export interface DiagramParseMessage {
+    type: 'diagram:parse';
+    payload: {
+        diagramId: string;
+        text: string;
+    };
+}
+/** Server responds with parsed element IDs (or errors) */
+export interface DiagramParseResultMessage {
+    type: 'diagram:parse:result';
+    payload: {
+        diagramId: string;
+        elementIds: string[];
+        errors: string[];
+    };
+}
+/** Client requests the exact SysML file backing a source-derived diagram. */
+export interface DiagramSourceRequestMessage {
+    type: 'diagram:source:request';
+    payload: {
+        requestId: string;
+        diagramId: string;
+    };
+}
+/** Client saves the exact SysML file backing a source-derived diagram. */
+export interface DiagramSourceSaveMessage {
+    type: 'diagram:source:save';
+    payload: {
+        requestId: string;
+        diagramId: string;
+        text: string;
+    };
+}
+/** Server response for loading or saving a diagram's SysML source file. */
+export interface DiagramSourceResultMessage {
+    type: 'diagram:source:result';
+    payload: {
+        requestId: string;
+        diagramId: string;
+        operation: 'load' | 'save';
+        success: boolean;
+        sourceFile?: string;
+        text?: string;
+        error?: string;
+    };
+}
+/** Per-node visual override stored in the view's .viewlayout companion. */
+export interface DiagramNodeLayout {
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    color?: string;
+    /** Per-diagram boundary-port positions, relative to the owning node. */
+    ports?: Record<string, {
+        x: number;
+        y: number;
+        side?: 'top' | 'bottom' | 'left' | 'right';
+    }>;
+}
+/** Per-edge visual override */
+export interface DiagramEdgeLayout {
+    color?: string;
+    strokeWidth?: number;
+    labelVisible?: boolean;
+    style?: 'solid' | 'dashed' | 'dotted';
+    /** User-adjusted orthogonal route points in canvas coordinates. */
+    points?: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** Endpoint identity captured with a manual route. A changed attachment
+     * invalidates the bends and returns the edge to automatic routing. */
+    source?: string;
+    target?: string;
+    sourcePortId?: string;
+    targetPortId?: string;
+}
+/** Full layout for one diagram, deserialized from its .viewlayout companion. */
+export interface DiagramLayout {
+    nodes: Record<string, DiagramNodeLayout>;
+    edges: Record<string, DiagramEdgeLayout>;
+    canvas?: {
+        zoom?: number;
+        pan?: {
+            x: number;
+            y: number;
+        };
+        grid?: number;
+        snap?: boolean;
+        /** False after the first user geometry override. */
+        autoLayout?: boolean;
+        /** Animate directional flow along connectors. */
+        flowAnimation?: boolean;
+    };
+}
+/** Server → Client: initial layout data for all diagrams that have sidecars */
+export interface DiagramLayoutMessage {
+    type: 'diagram:layout';
+    payload: {
+        layouts: Record<string, DiagramLayout>;
+    };
+}
+/** Client → Server: save updated positions after user drags nodes */
+export interface DiagramLayoutUpdateMessage {
+    type: 'diagram:layout:update';
+    payload: {
+        diagramId: string;
+        layout: DiagramLayout;
+    };
+}
+/** Server → Client: whether an LLM provider is configured and available */
+export interface LlmStatusMessage {
+    type: 'llm:status';
+    payload: {
+        available: boolean;
+        provider?: string;
+        model?: string;
+    };
+}
+/** Client → Server: ask a natural language question about the model */
+export interface LlmAskMessage {
+    type: 'llm:ask';
+    payload: {
+        requestId: string;
+        question: string;
+    };
+}
+/** Server → Client: answer to a model Q&A question */
+export interface LlmAskResultMessage {
+    type: 'llm:ask:result';
+    payload: {
+        requestId: string;
+        answer?: string;
+        error?: string;
+    };
+}
+/** Client → Server: generate SysML v2 from a natural language description */
+export interface LlmGenerateMessage {
+    type: 'llm:generate';
+    payload: {
+        requestId: string;
+        description: string;
+    };
+}
+/** Server → Client: generated SysML v2 code */
+export interface LlmGenerateResultMessage {
+    type: 'llm:generate:result';
+    payload: {
+        requestId: string;
+        sysml?: string;
+        explanation?: string;
+        suggestedFile?: string;
+        error?: string;
+    };
+}
+/** Client → Server: draft one or all sections of a DHF document type */
+export interface LlmDraftMessage {
+    type: 'llm:draft';
+    payload: {
+        requestId: string;
+        documentTypeId: string;
+        targetSections?: string[];
+    };
+}
+/** Server → Client: drafted DHF markdown content */
+export interface LlmDraftResultMessage {
+    type: 'llm:draft:result';
+    payload: {
+        requestId: string;
+        markdown?: string;
+        summary?: string;
+        error?: string;
+    };
+}
+/** Client → Server: ask for AI-driven completeness suggestions */
+export interface LlmSuggestMessage {
+    type: 'llm:suggest';
+    payload: {
+        requestId: string;
+    };
+}
+/** Server → Client: list of suggested next modeling steps */
+export interface LlmSuggestResultMessage {
+    type: 'llm:suggest:result';
+    payload: {
+        requestId: string;
+        suggestions?: string[];
+        error?: string;
+    };
+}
+/** Server → Client: ontology changed on disk — client must reload after server restart */
+export interface RestartRequiredMessage {
+    type: 'app:restart-required';
+    reason: 'ontology-source-changed' | 'ontology-selection-changed';
+    changedFile: string;
+    instruction: string;
+}
+/** A DHF workbench document persisted as markdown in the project's dhf/documents/ */
+export interface DhfDocDTO {
+    id: string;
+    title: string;
+    group: string;
+    templateId: string;
+    /** Full markdown source including YAML frontmatter */
+    content: string;
+    createdAt: number;
+    /** "Name | Role" entries, one per line */
+    authors: string;
+    /** "Name | Role" entries, one per line */
+    approvers: string;
+}
+/** Project-level DHF settings persisted in .memo/dhf-settings.json */
+export interface DhfSettingsDTO {
+    company?: string;
+    product?: string;
+    deviceType?: string;
+    version?: string;
+    phase?: string;
+    documentNumberingPrefix?: string;
+    primaryColor?: string;
+    [key: string]: unknown;
+}
+/** A markdown file in the project repo usable as a document template */
+export interface DhfRepoTemplateInfo {
+    /** Path relative to project root */
+    path: string;
+    /** Title from frontmatter or first heading, falls back to filename */
+    title: string;
+}
+/** Client → Server: request all persisted DHF documents */
+export interface DhfDocsLoadMessage {
+    type: 'dhf:docs:load';
+}
+/** Server → Client: all persisted DHF documents (on connect and after changes) */
+export interface DhfDocsMessage {
+    type: 'dhf:docs';
+    payload: {
+        docs: DhfDocDTO[];
+    };
+}
+/** Client → Server: create or update a DHF document file */
+export interface DhfDocSaveMessage {
+    type: 'dhf:doc:save';
+    payload: {
+        doc: DhfDocDTO;
+    };
+}
+/** Client → Server: delete a DHF document file */
+export interface DhfDocDeleteMessage {
+    type: 'dhf:doc:delete';
+    payload: {
+        docId: string;
+    };
+}
+/** Server → Client: persisted DHF settings (on connect) */
+export interface DhfSettingsMessage {
+    type: 'dhf:settings';
+    payload: {
+        settings: DhfSettingsDTO;
+    };
+}
+/** Client → Server: persist DHF settings */
+export interface DhfSettingsSaveMessage {
+    type: 'dhf:settings:save';
+    payload: {
+        settings: DhfSettingsDTO;
+    };
+}
+/** Client → Server: list markdown files in the repo usable as templates */
+export interface DhfTemplatesListMessage {
+    type: 'dhf:templates:list';
+    payload: {
+        requestId: string;
+    };
+}
+/** Server → Client: repo template listing */
+export interface DhfTemplatesResultMessage {
+    type: 'dhf:templates:result';
+    payload: {
+        requestId: string;
+        templates: DhfRepoTemplateInfo[];
+    };
+}
+/** Client → Server: read one repo template file */
+export interface DhfTemplateReadMessage {
+    type: 'dhf:template:read';
+    payload: {
+        requestId: string;
+        path: string;
+    };
+}
+/** Server → Client: repo template content */
+export interface DhfTemplateContentMessage {
+    type: 'dhf:template:content';
+    payload: {
+        requestId: string;
+        path: string;
+        content?: string;
+        error?: string;
+    };
+}
+/** Server → Client: CSV import results */
+export interface ImportResultMessage {
+    type: 'import:result';
+    payload: {
+        success: boolean;
+        elementsImported: number;
+        relationshipsImported: number;
+        errors: string[];
+        warnings: string[];
+        /** Path to generated .sysml file */
+        generatedFile?: string;
+    };
+}
+//# sourceMappingURL=messages.d.ts.map

package/packages/tools/lib/protocol/messages.d.ts.map

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

package/packages/tools/lib/protocol/messages.js

@@ -0,0 +1,6 @@
+// ─── WebSocket Protocol Messages ──────────────────────────────────────────────
+//
+// Shared types for the CLI dev server ↔ Web app WebSocket protocol.
+// ─────────────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=messages.js.map

package/packages/tools/lib/protocol/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/protocol/messages.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,oEAAoE;AACpE,gFAAgF"}

package/packages/tools/lib/serializer/csv-io.d.ts

@@ -0,0 +1,113 @@
+import type { MemoModel } from '../model/semantic.js';
+import type { MEMOConfig } from '../model/config.js';
+/**
+ * Import provenance — tracks where an element came from.
+ * Stored as _import_* attributes in the generated SysML so the trace is
+ * visible in the model and survives round-trips through the CLI.
+ */
+export interface ImportProvenance {
+    /** Source file name (e.g. "requirements-v3.xlsx") */
+    sourceFile: string;
+    /** 1-based row number in the source artifact */
+    sourceRow: number;
+    /** ISO-8601 timestamp of the import (e.g. "2026-04-14T18:00:00Z") */
+    importTimestamp: string;
+    /** Stable session ID grouping all elements from a single import run */
+    importSessionId: string;
+}
+/** Parsed element from CSV (before SysML generation) */
+export interface CsvElement {
+    id: string;
+    name: string;
+    kind: string;
+    construct: string;
+    layer?: string;
+    doc: string;
+    attributes: Record<string, string>;
+    /** Optional provenance metadata written as _import_* attributes in SysML */
+    provenance?: ImportProvenance;
+}
+/**
+ * Attach provenance to a batch of CsvElements.
+ * `sourceRow` is auto-assigned (1-based index into the `elements` array).
+ * Call this after `parseElementsCsv()` when you want full traceability.
+ *
+ * @example
+ * const result = parseElementsCsv(csv, config);
+ * const withProvenance = attachProvenance(result.items, {
+ *   sourceFile: 'requirements-v3.xlsx',
+ *   importTimestamp: new Date().toISOString(),
+ *   importSessionId: crypto.randomUUID(),
+ * });
+ */
+export declare function attachProvenance(elements: CsvElement[], meta: Omit<ImportProvenance, 'sourceRow'>): CsvElement[];
+/** Parsed relationship from CSV */
+export interface CsvRelationship {
+    sourceId: string;
+    targetId: string;
+    type: string;
+    sourceEnd: string;
+    targetEnd: string;
+}
+/** Result of parsing a CSV file */
+export interface CsvParseResult<T> {
+    items: T[];
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Parse an elements CSV file.
+ *
+ * **Standard CSV format for elements:**
+ * ```
+ * id,name,kind,construct,doc,[attr1],[attr2],...
+ * ```
+ *
+ * - `id` — unique element identifier (required, valid SysML identifier)
+ * - `name` — display name (required)
+ * - `kind` — ontology type from config.kinds (required, e.g. "Hazard", "Requirement")
+ * - `construct` — SysML construct override (optional, auto-derived from kind if omitted)
+ * - `doc` — documentation comment (optional)
+ * - Additional columns become `attribute redefines <colName> = "<value>"` in SysML
+ *
+ * The `kind` value is validated against the resolved config. If `construct` is omitted,
+ * it is derived from the kind's `sysmlConstruct` definition. The `layer` is always
+ * derived from the kind definition and cannot be set manually.
+ */
+export declare function parseElementsCsv(csvText: string, config: MEMOConfig): CsvParseResult<CsvElement>;
+/**
+ * Export model elements to CSV.
+ *
+ * Produces a CSV with fixed columns (id, name, kind, construct, doc) plus
+ * dynamic attribute columns gathered from all elements in the model.
+ */
+export declare function exportElementsCsv(model: MemoModel, _config: MEMOConfig): string;
+/**
+ * Parse a relationships CSV file.
+ *
+ * **Standard CSV format for relationships:**
+ * ```
+ * sourceId,targetId,type,sourceEnd,targetEnd
+ * ```
+ *
+ * - `sourceId` — source element id (required, must exist in model or import batch)
+ * - `targetId` — target element id (required, must exist in model or import batch)
+ * - `type` — relationship type from config (required, e.g. "mitigates", "traceTo")
+ * - `sourceEnd` — connection end name (optional, default: "source")
+ * - `targetEnd` — connection end name (optional, default: "target")
+ */
+export declare function parseRelationshipsCsv(csvText: string, config: MEMOConfig, knownElementIds?: Set<string>): CsvParseResult<CsvRelationship>;
+/**
+ * Export model relationships to CSV.
+ */
+export declare function exportRelationshipsCsv(model: MemoModel): string;
+/**
+ * Generate a template CSV for elements based on the config's ontology kinds.
+ * Includes all valid kinds as example rows with their default attributes.
+ */
+export declare function generateElementTemplate(config: MEMOConfig): string;
+/**
+ * Generate a template CSV for relationships based on config relationship types.
+ */
+export declare function generateRelationshipTemplate(config: MEMOConfig): string;
+//# sourceMappingURL=csv-io.d.ts.map

package/packages/tools/lib/serializer/csv-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-io.d.ts","sourceRoot":"","sources":["../../src/serializer/csv-io.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAiC,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAIrE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,UAAU,EAAE,EACtB,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC1C,UAAU,EAAE,CAKd;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AA+DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,GACnB,cAAc,CAAC,UAAU,CAAC,CA6G5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CA+B/E;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,cAAc,CAAC,eAAe,CAAC,CA4EjC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAY/D;AAoBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA8BlE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiBvE"}