@baselineos/lang 0.1.0

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@baselineos/lang",
+  "version": "0.1.0",
+  "description": "Baseline Lang — Language & Expression Layer",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@baselineos/protocol-core": "1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest';
+import { BaselineLangSystem } from '../index.js';
+
+describe('lang', () => {
+  it('should instantiate BaselineLangSystem', () => {
+    const lang = new BaselineLangSystem();
+    expect(lang).toBeDefined();
+  });
+
+  it('should have command registry with entries', () => {
+    const lang = new BaselineLangSystem();
+    expect(lang.getCommandRegistry().size).toBeGreaterThan(0);
+  });
+});

package/src/__tests__/validation.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect } from 'vitest';
+import { BaselineLangSystem } from '../index.js';
+
+describe('lang validation', () => {
+  it('enforces required options and allowed values', () => {
+    const lang = new BaselineLangSystem();
+    lang.registerCommand('deploy', {
+      aliases: [],
+      description: 'Deploy a service',
+      usage: 'deploy --region <name>',
+      examples: ['deploy --region us'],
+      options: {
+        region: {
+          type: 'string',
+          required: true,
+          values: ['us', 'eu'],
+        },
+      },
+    });
+
+    const missing = lang.processInput('deploy');
+    expect(missing.success).toBe(false);
+    expect(missing.details).toContain('Missing required option: region');
+
+    const invalid = lang.processInput('deploy --region mars');
+    expect(invalid.success).toBe(false);
+    expect(invalid.details).toContain('Invalid value for option: region');
+
+    const ok = lang.processInput('deploy --region us');
+    expect(ok.success).toBe(true);
+  });
+
+  it('coerces number and boolean options', () => {
+    const lang = new BaselineLangSystem();
+    lang.registerCommand('scale', {
+      aliases: [],
+      description: 'Scale service',
+      usage: 'scale --count <n> [--force]',
+      examples: ['scale --count 3 --force'],
+      options: {
+        count: { type: 'number', required: true },
+        force: { type: 'boolean' },
+      },
+    });
+
+    const result = lang.processInput('scale --count 3 --force');
+    expect(result.success).toBe(true);
+    const options = result.result?.options as Map<string, unknown>;
+    expect(options.get('count')).toBe(3);
+    expect(options.get('force')).toBe(true);
+  });
+
+  it('merges project lexicon entries', () => {
+    const lang = new BaselineLangSystem({
+      projectLexicon: {
+        baseline: {
+          description: 'Project-specific term',
+          aliases: ['bl'],
+          tags: ['core'],
+        },
+      },
+    });
+
+    const lexicon = lang.getLexicon();
+    const entry = lexicon.get('baseline');
+    expect(entry?.description).toBe('Project-specific term');
+    expect(entry?.aliases).toContain('bl');
+  });
+
+  it('suggests similar commands on typos', () => {
+    const lang = new BaselineLangSystem();
+    const result = lang.processInput('hepl');
+    expect(result.success).toBe(false);
+    expect(result.suggestions?.join(' ')).toContain('help');
+  });
+
+  it('returns help output from registry metadata', () => {
+    const lang = new BaselineLangSystem();
+    const result = lang.processInput('help');
+    expect(result.success).toBe(true);
+    expect(result.result?.message).toContain('help');
+  });
+});

package/src/__tests__/workflow.test.ts

@@ -0,0 +1,11 @@
+import { describe, it, expect } from 'vitest';
+import { BaselineLangSystem } from '../index.js';
+
+describe('lang workflow', () => {
+  it('processes a basic command', () => {
+    const lang = new BaselineLangSystem();
+    const result = lang.processInput('help');
+    expect(result.success).toBe(true);
+    expect(result.parsed?.command).toBe('help');
+  });
+});

package/src/config/lang-system-config.json

@@ -0,0 +1,346 @@
+{
+  "system": {
+    "name": "Baseline Lang System",
+    "version": "1.0.0",
+    "description": "Natural language processing and command interpretation for Baseline Protocol",
+    "language": "en",
+    "encoding": "utf-8"
+  },
+  "syntax": {
+    "commandPrefix": "--",
+    "optionPrefix": "-",
+    "separator": " ",
+    "quoteChar": "\"",
+    "escapeChar": "\\",
+    "wildcard": "*",
+    "range": ".."
+  },
+  "patterns": {
+    "intent": {
+      "question": "^(what|how|when|where|why|who|which|can|should|will|do|does|is|are|was|were)",
+      "action": "^(create|make|build|generate|start|begin|init|initialize|launch|establish|found|set|put)",
+      "query": "^(show|display|list|find|search|get|fetch|retrieve|look|see|view|examine|inspect)",
+      "modification": "^(update|modify|edit|change|alter|adjust|transform|convert|adapt|revise|amend)",
+      "deletion": "^(delete|remove|destroy|eliminate|clear|wipe|erase|purge|drop|uninstall)",
+      "status": "^(status|info|details|state|condition|health|check|verify|validate|test)",
+      "navigation": "^(go|navigate|move|jump|switch|change|enter|exit|open|close)",
+      "configuration": "^(config|configure|setup|install|deploy|arrange|organize|structure)"
+    },
+    "command": {
+      "basic": "^[a-z][a-z0-9-]*$",
+      "compound": "^[a-z][a-z0-9-]*:[a-z][a-z0-9-]*$",
+      "nested": "^[a-z][a-z0-9-]*:[a-z][a-z0-9-]*:[a-z][a-z0-9-]*$",
+      "namespaced": "^[a-z][a-z0-9-]*\\.[a-z][a-z0-9-]*$"
+    },
+    "option": {
+      "short": "^-[a-zA-Z]$",
+      "long": "^--[a-z][a-z0-9-]*$",
+      "withValue": "^--[a-z][a-z0-9-]*=",
+      "flag": "^--[a-z][a-z0-9-]*$"
+    },
+    "value": {
+      "text": "^[a-zA-Z0-9\\s\\-_\\.,/\\\\]+$",
+      "number": "^[0-9]+(\\.[0-9]+)?$",
+      "identifier": "^[a-zA-Z_][a-zA-Z0-9_]*$",
+      "path": "^[a-zA-Z0-9\\-_/\\\\\\.]+$",
+      "url": "^https?://[a-zA-Z0-9\\-_./]+$",
+      "email": "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
+    }
+  },
+  "commands": {
+    "help": {
+      "aliases": ["h", "?", "--help", "help"],
+      "description": "Show help information and command reference",
+      "usage": "help [command] [options]",
+      "examples": [
+        "help",
+        "help create",
+        "help --verbose",
+        "help create project"
+      ],
+      "options": {
+        "verbose": {
+          "type": "boolean",
+          "description": "Show detailed help information",
+          "default": false
+        },
+        "format": {
+          "type": "string",
+          "description": "Output format (text, json, markdown)",
+          "default": "text",
+          "values": ["text", "json", "markdown"]
+        }
+      }
+    },
+    "create": {
+      "aliases": ["c", "new", "make", "build", "generate"],
+      "description": "Create a new resource or entity",
+      "usage": "create <type> [name] [options]",
+      "examples": [
+        "create project",
+        "create project myproject",
+        "create --type=project --name=myproject --description=\"A new project\"",
+        "create project myproject --template=web --framework=react"
+      ],
+      "options": {
+        "type": {
+          "type": "string",
+          "description": "Type of resource to create",
+          "required": true,
+          "values": ["project", "service", "component", "document", "user", "team"]
+        },
+        "name": {
+          "type": "string",
+          "description": "Name of the resource",
+          "required": false
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the resource",
+          "required": false
+        },
+        "template": {
+          "type": "string",
+          "description": "Template to use for creation",
+          "required": false
+        },
+        "framework": {
+          "type": "string",
+          "description": "Framework to use",
+          "required": false
+        },
+        "force": {
+          "type": "boolean",
+          "description": "Force creation even if resource exists",
+          "default": false
+        }
+      }
+    },
+    "list": {
+      "aliases": ["ls", "show", "display", "view"],
+      "description": "List resources or entities",
+      "usage": "list [type] [options]",
+      "examples": [
+        "list",
+        "list projects",
+        "list --type=project --format=json",
+        "list projects --filter=active --sort=name"
+      ],
+      "options": {
+        "type": {
+          "type": "string",
+          "description": "Type of resources to list",
+          "required": false
+        },
+        "format": {
+          "type": "string",
+          "description": "Output format (text, json, table, csv)",
+          "default": "text",
+          "values": ["text", "json", "table", "csv"]
+        },
+        "filter": {
+          "type": "string",
+          "description": "Filter criteria",
+          "required": false
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort field",
+          "required": false
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum number of results",
+          "default": 50
+        }
+      }
+    },
+    "update": {
+      "aliases": ["u", "modify", "edit", "change", "alter"],
+      "description": "Update an existing resource or entity",
+      "usage": "update <type> <id> [options]",
+      "examples": [
+        "update project 123",
+        "update project 123 --name=newName",
+        "update --type=project --id=123 --description=\"Updated description\""
+      ],
+      "options": {
+        "type": {
+          "type": "string",
+          "description": "Type of resource to update",
+          "required": true
+        },
+        "id": {
+          "type": "string",
+          "description": "ID of the resource",
+          "required": true
+        },
+        "name": {
+          "type": "string",
+          "description": "New name for the resource",
+          "required": false
+        },
+        "description": {
+          "type": "string",
+          "description": "New description for the resource",
+          "required": false
+        },
+        "force": {
+          "type": "boolean",
+          "description": "Force update even if validation fails",
+          "default": false
+        }
+      }
+    },
+    "delete": {
+      "aliases": ["d", "remove", "rm", "del", "destroy"],
+      "description": "Delete a resource or entity",
+      "usage": "delete <type> <id> [options]",
+      "examples": [
+        "delete project 123",
+        "delete project 123 --force",
+        "delete --type=project --id=123 --confirm"
+      ],
+      "options": {
+        "type": {
+          "type": "string",
+          "description": "Type of resource to delete",
+          "required": true
+        },
+        "id": {
+          "type": "string",
+          "description": "ID of the resource",
+          "required": true
+        },
+        "force": {
+          "type": "boolean",
+          "description": "Force deletion without confirmation",
+          "default": false
+        },
+        "confirm": {
+          "type": "boolean",
+          "description": "Confirm deletion",
+          "default": false
+        }
+      }
+    },
+    "status": {
+      "aliases": ["s", "info", "details", "health"],
+      "description": "Show status information about resources or system",
+      "usage": "status [type] [id] [options]",
+      "examples": [
+        "status",
+        "status project 123",
+        "status system",
+        "status --type=project --id=123 --verbose"
+      ],
+      "options": {
+        "type": {
+          "type": "string",
+          "description": "Type of resource to check status",
+          "required": false
+        },
+        "id": {
+          "type": "string",
+          "description": "ID of the resource",
+          "required": false
+        },
+        "verbose": {
+          "type": "boolean",
+          "description": "Show detailed status information",
+          "default": false
+        },
+        "format": {
+          "type": "string",
+          "description": "Output format (text, json, table)",
+          "default": "text",
+          "values": ["text", "json", "table"]
+        }
+      }
+    },
+    "config": {
+      "aliases": ["cfg", "settings", "configure"],
+      "description": "Manage system configuration and settings",
+      "usage": "config [action] [key] [value] [options]",
+      "examples": [
+        "config show",
+        "config get database.url",
+        "config set database.url localhost:5432",
+        "config list --format=json"
+      ],
+      "options": {
+        "action": {
+          "type": "string",
+          "description": "Action to perform (show, get, set, list, reset)",
+          "required": false,
+          "values": ["show", "get", "set", "list", "reset", "export", "import"]
+        },
+        "key": {
+          "type": "string",
+          "description": "Configuration key",
+          "required": false
+        },
+        "value": {
+          "type": "string",
+          "description": "Configuration value",
+          "required": false
+        },
+        "format": {
+          "type": "string",
+          "description": "Output format (text, json, yaml)",
+          "default": "text",
+          "values": ["text", "json", "yaml"]
+        }
+      }
+    },
+    "test": {
+      "aliases": ["t", "validate", "check", "verify"],
+      "description": "Run tests or validation checks",
+      "usage": "test [type] [options]",
+      "examples": [
+        "test",
+        "test unit",
+        "test integration --verbose",
+        "test --type=system --format=json"
+      ],
+      "options": {
+        "type": {
+          "type": "string",
+          "description": "Type of tests to run",
+          "required": false,
+          "values": ["unit", "integration", "system", "all"]
+        },
+        "verbose": {
+          "type": "boolean",
+          "description": "Show detailed test output",
+          "default": false
+        },
+        "format": {
+          "type": "string",
+          "description": "Output format (text, json, junit)",
+          "default": "text",
+          "values": ["text", "json", "junit"]
+        }
+      }
+    }
+  },
+  "validation": {
+    "strict": false,
+    "allowUnknown": true,
+    "maxTokens": 100,
+    "maxOptions": 20,
+    "maxArguments": 10
+  },
+  "errorHandling": {
+    "suggestions": true,
+    "fuzzyMatching": true,
+    "maxSuggestions": 5,
+    "levenshteinThreshold": 2
+  },
+  "performance": {
+    "cacheSize": 1000,
+    "maxCacheAge": 300000,
+    "enableProfiling": false,
+    "logPerformance": false
+  }
+}

package/src/index.ts

@@ -0,0 +1,25 @@
+export {
+  BaselineLangSystem,
+  IntentRecognizer,
+  CommandProcessor,
+  SyntaxValidator,
+} from './system.js';
+
+export type {
+  LangSystemConfig,
+  SyntaxConfig,
+  PatternConfig,
+  CommandConfig,
+  CommandOptionSpec,
+  CommandValidationSpec,
+  RegisteredCommand,
+  CommandHandler,
+  CommandResult,
+  ParsedInput,
+  IntentResult,
+  ProcessResult,
+  ParsedOption,
+  LexiconEntry,
+  LangValidationConfig,
+  BaselineLangOptions,
+} from './system.js';