@nahisaho/musubix-sdd-ontology 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview SDD Ontology type definitions
+ * @traceability REQ-SDD-ONTO-001
+ */
+/**
+ * Ontology module metadata
+ */
+export interface OntologyModule {
+    id: string;
+    name: string;
+    namespace: string;
+    version: string;
+    description: string;
+    dependencies: string[];
+    filePath: string;
+}
+/**
+ * EARS requirement types
+ */
+export type EarsPatternType = 'ubiquitous' | 'event-driven' | 'state-driven' | 'unwanted' | 'optional';
+/**
+ * EARS requirement structure
+ */
+export interface EarsRequirement {
+    id: string;
+    pattern: EarsPatternType;
+    trigger?: string;
+    condition?: string;
+    system: string;
+    response: string;
+    priority: 'P0' | 'P1' | 'P2';
+}
+/**
+ * C4 diagram level
+ */
+export type C4Level = 'context' | 'container' | 'component' | 'code';
+/**
+ * C4 element structure
+ */
+export interface C4Element {
+    id: string;
+    level: C4Level;
+    name: string;
+    type: string;
+    description: string;
+    technology?: string;
+    parent?: string;
+    relationships: C4Relationship[];
+}
+/**
+ * C4 relationship
+ */
+export interface C4Relationship {
+    target: string;
+    description: string;
+    technology?: string;
+}
+/**
+ * Traceability link types
+ */
+export type TraceLinkType = 'satisfies' | 'implements' | 'tests' | 'derives-from' | 'refines';
+/**
+ * Traceability link
+ */
+export interface TraceLink {
+    source: string;
+    target: string;
+    type: TraceLinkType;
+    rationale?: string;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    code: string;
+    message: string;
+    location?: string;
+}
+/**
+ * Validation warning
+ */
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Supported languages for i18n
+ */
+export type SupportedLanguage = 'en' | 'ja';
+/**
+ * Localized string
+ */
+export interface LocalizedString {
+    en: string;
+    ja?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,UAAU,GACV,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,cAAc,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,YAAY,GACZ,OAAO,GACP,cAAc,GACd,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview SDD Ontology type definitions
+ * @traceability REQ-SDD-ONTO-001
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/validator/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Ontology validator module
+ * @traceability TSK-SDD-ONTO-006
+ */
+export { OntologyValidator } from './ontology-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/validator/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Ontology validator module
+ * @traceability TSK-SDD-ONTO-006
+ */
+export { OntologyValidator } from './ontology-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/validator/ontology-validator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Ontology validator for TTL syntax and semantics
+ * @traceability TSK-SDD-ONTO-006, REQ-SDD-ONTO-001-F006
+ */
+import type { ValidationResult } from '../types.js';
+/**
+ * Ontology validator
+ */
+export declare class OntologyValidator {
+    /**
+     * Validate TTL content (basic syntax check)
+     */
+    validateTTL(content: string): ValidationResult;
+    /**
+     * Validate EARS requirement text
+     */
+    validateEarsText(text: string): ValidationResult;
+    /**
+     * Validate C4 element ID format
+     */
+    validateC4ElementId(id: string): ValidationResult;
+}
+//# sourceMappingURL=ontology-validator.d.ts.map

package/dist/validator/ontology-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology-validator.d.ts","sourceRoot":"","sources":["../../src/validator/ontology-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,aAAa,CAAC;AAExF;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IA+C9C;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAwChD;;OAEG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;CA2BlD"}

package/dist/validator/ontology-validator.js

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Ontology validator for TTL syntax and semantics
+ * @traceability TSK-SDD-ONTO-006, REQ-SDD-ONTO-001-F006
+ */
+/**
+ * Ontology validator
+ */
+export class OntologyValidator {
+    /**
+     * Validate TTL content (basic syntax check)
+     */
+    validateTTL(content) {
+        const errors = [];
+        const warnings = [];
+        // Check for required prefixes
+        if (!content.includes('@prefix')) {
+            errors.push({
+                code: 'MISSING_PREFIX',
+                message: 'TTL file must contain @prefix declarations',
+            });
+        }
+        // Check for unclosed quotes
+        const quoteMatches = content.match(/"/g);
+        if (quoteMatches && quoteMatches.length % 2 !== 0) {
+            errors.push({
+                code: 'UNCLOSED_QUOTE',
+                message: 'TTL file contains unclosed string literal',
+            });
+        }
+        // Check for statement termination
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (line && !line.startsWith('#') && !line.startsWith('@')) {
+                // Non-empty, non-comment, non-directive line should end with . , or ;
+                if (!line.endsWith('.') && !line.endsWith(',') && !line.endsWith(';')) {
+                    // Could be multi-line - just a warning
+                    if (i === lines.length - 1 || !lines[i + 1].trim().match(/^[.,;]/)) {
+                        warnings.push({
+                            code: 'POSSIBLE_UNTERMINATED',
+                            message: `Line ${i + 1} may be unterminated`,
+                            suggestion: 'Check statement termination with . , or ;',
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validate EARS requirement text
+     */
+    validateEarsText(text) {
+        const errors = [];
+        const warnings = [];
+        // Check for EARS keywords
+        const hasEarsKeyword = /^(THE|WHEN|WHILE|IF)\s/i.test(text);
+        if (!hasEarsKeyword) {
+            errors.push({
+                code: 'MISSING_EARS_KEYWORD',
+                message: 'EARS requirement must start with THE, WHEN, WHILE, or IF',
+            });
+        }
+        // Check for SHALL
+        if (!text.includes('SHALL')) {
+            errors.push({
+                code: 'MISSING_SHALL',
+                message: 'EARS requirement must contain SHALL',
+            });
+        }
+        // Check for ambiguous words
+        const ambiguousWords = ['might', 'could', 'should', 'may'];
+        for (const word of ambiguousWords) {
+            if (new RegExp(`\\b${word}\\b`, 'i').test(text)) {
+                warnings.push({
+                    code: 'AMBIGUOUS_WORD',
+                    message: `Requirement contains ambiguous word: ${word}`,
+                    suggestion: `Consider using SHALL or SHALL NOT instead of ${word}`,
+                });
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validate C4 element ID format
+     */
+    validateC4ElementId(id) {
+        const errors = [];
+        const warnings = [];
+        // ID should be alphanumeric with hyphens
+        if (!/^[a-z][a-z0-9-]*$/i.test(id)) {
+            errors.push({
+                code: 'INVALID_C4_ID',
+                message: 'C4 element ID must start with letter and contain only alphanumeric characters and hyphens',
+            });
+        }
+        // Warn if ID is too long
+        if (id.length > 50) {
+            warnings.push({
+                code: 'LONG_C4_ID',
+                message: 'C4 element ID is longer than 50 characters',
+                suggestion: 'Consider using a shorter, more descriptive ID',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=ontology-validator.js.map

package/dist/validator/ontology-validator.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@nahisaho/musubix-sdd-ontology",
+  "version": "1.0.0",
+  "description": "MUSUBIX SDD Ontology - Turtle modules for EARS, C4, Traceability",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./ttl/*": "./ttl/*"
+  },
+  "files": [
+    "dist",
+    "ttl"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "validate-ttl": "node dist/cli/validate.js"
+  },
+  "keywords": [
+    "musubix",
+    "ontology",
+    "sdd",
+    "ears",
+    "c4model",
+    "traceability",
+    "turtle"
+  ],
+  "author": "nahisaho",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nahisaho/MUSUBIX.git",
+    "directory": "packages/sdd-ontology"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@nahisaho/musubix-ontology-mcp": "^1.0.0"
+  }
+}