@o-lang/olang 1.0.2 → 1.0.3

package/cli.js

@@ -5,6 +5,21 @@ const { execute } = require('./src/runtime');
 const fs = require('fs');
 const path = require('path');
 
+/**
+ * Enforce .ol extension ONLY
+ */
+function ensureOlExtension(filename) {
+  if (!filename.endsWith('.ol')) {
+    throw new Error(
+      `Invalid file: "${filename}".\n` +
+      `O-Lang workflows must use the ".ol" extension.`
+    );
+  }
+}
+
+/**
+ * Default mock resolver (for demo use)
+ */
 async function defaultMockResolver(action, context) {
   if (action.startsWith('Search for ')) {
     return {
@@ -13,20 +28,27 @@ async function defaultMockResolver(action, context) {
       url: "mock://hr-policy"
     };
   }
+
   if (action.startsWith('Ask ')) {
-    return "✅ [Mock] Summarized for staff.";
+    return "✅ [Mock] Summarized for demonstration.";
   }
+
   if (action.startsWith('Notify ')) {
     const recipient = action.match(/Notify (\S+)/)?.[1] || 'user@example.com';
     return `📬 Notification sent to ${recipient}`;
   }
+
   if (action.startsWith('Debrief ') || action.startsWith('Evolve ')) {
     console.log(`[O-Lang] ${action}`);
     return 'Acknowledged';
   }
+
   return `[Unhandled: ${action}]`;
 }
 
+/**
+ * Resolver chaining mechanism
+ */
 function createResolverChain(resolvers) {
   return async (action, context) => {
     for (const resolver of resolvers) {
@@ -61,7 +83,9 @@ function loadSingleResolver(specifier) {
       console.log(`📁 Loaded resolver: ${absolutePath}`);
       return resolver;
     } catch (e2) {
-      throw new Error(`Failed to load resolver '${specifier}':\n  npm: ${e1.message}\n  file: ${e2.message}`);
+      throw new Error(
+        `Failed to load resolver '${specifier}':\n  npm: ${e1.message}\n  file: ${e2.message}`
+      );
     }
   }
 }
@@ -76,27 +100,41 @@ function loadResolverChain(specifiers) {
   return createResolverChain(resolvers);
 }
 
+/**
+ * CLI Setup
+ */
 const program = new Command();
 
 program
   .name('olang')
-  .description('O-Lang CLI: run .olang workflows')
+  .description('O-Lang CLI: run .ol workflows with rule-enforced agent governance')
   .command('run <file>')
-  .option('-r, --resolver <specifier>', 'Resolver (npm package or local path). Can be used multiple times.\nExample:\n  -r @o-lang/llm-groq\n  -r @o-lang/notify-telegram', (val, acc) => {
-    acc.push(val);
-    return acc;
-  }, [])
-  .option('-i, --input <k=v>', 'Input parameters', (val, acc = {}) => {
-    const [k, v] = val.split('=');
-    acc[k] = v;
-    return acc;
-  }, {})
+  .option(
+    '-r, --resolver <specifier>',
+    'Resolver (npm package or local path). Can be used multiple times.\nExample:\n  -r @o-lang/llm-groq\n  -r @o-lang/notify-telegram',
+    (val, acc) => { acc.push(val); return acc; },
+    []
+  )
+  .option(
+    '-i, --input <k=v>',
+    'Input parameters',
+    (val, acc = {}) => {
+      const [k, v] = val.split('=');
+      acc[k] = v;
+      return acc;
+    },
+    {}
+  )
   .action(async (file, options) => {
     try {
+      ensureOlExtension(file);
+
       const content = fs.readFileSync(file, 'utf8');
       const workflow = parse(content);
+
       const resolver = loadResolverChain(options.resolver);
       const result = await execute(workflow, options.input, resolver);
+
       console.log('\n=== Workflow Result ===');
       console.log(JSON.stringify(result, null, 2));
     } catch (err) {
@@ -106,10 +144,3 @@ program
   });
 
 program.parse(process.argv);
-
-
-
-
-
-
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@o-lang/olang",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "author": "Olalekan Ogundipe <info@workfily.com>",
   "description": "O-Lang: A governance language for user-directed, rule-enforced agent workflows",
   "main": "./src/index.js",

package/src/parser.js

@@ -1,5 +1,11 @@
 // src/parser.js
-function parse(code) {
+
+function parse(code, fileName = null) {
+  // --- New: Enforce .ol extension if filename provided ---
+  if (fileName && !fileName.endsWith(".ol")) {
+    throw new Error(`Expected .ol workflow, got: ${fileName}`);
+  }
+
   const lines = code
     .split(/\r?\n/)
     .map(l => l.trim())
@@ -59,16 +65,11 @@ function parse(code) {
         let key = eq[1].trim();
         let value = eq[2].trim();
 
-        // Parse list: [a, b, c]
         if (value.startsWith('[') && value.endsWith(']')) {
           value = value.slice(1, -1).split(',').map(v => v.trim().replace(/^"/, '').replace(/"$/, ''));
-        }
-        // Parse number
-        else if (!isNaN(value)) {
+        } else if (!isNaN(value)) {
           value = Number(value);
-        }
-        // Keep string (remove quotes if present)
-        else if (value.startsWith('"') && value.endsWith('"')) {
+        } else if (value.startsWith('"') && value.endsWith('"')) {
           value = value.slice(1, -1);
         }
 
@@ -119,7 +120,7 @@ function parse(code) {
       continue;
     }
 
-    // Agent ... uses ...
+    // Agent uses
     const agentUseMatch = line.match(/^Agent\s+"([^"]+)"\s+uses\s+"([^"]+)"$/i);
     if (agentUseMatch) {
       workflow.steps.push({
@@ -199,7 +200,7 @@ function parse(code) {
       continue;
     }
 
-    // --- New: Use <Tool> ---
+    // Use <Tool>
     const useMatch = line.match(/^Use\s+(.+)$/i);
     if (useMatch) {
       workflow.steps.push({
@@ -212,7 +213,7 @@ function parse(code) {
       continue;
     }
 
-    // --- New: Ask <Target> ---
+    // Ask <Target>
     const askMatch = line.match(/^Ask\s+(.+)$/i);
     if (askMatch) {
       workflow.steps.push({
@@ -268,13 +269,11 @@ function parseBlock(lines) {
       steps.push({ type: 'prompt', question: promptMatch[1], saveAs: null });
     }
 
-    // New: Use <Tool>
     const useMatch = line.match(/^Use\s+(.+)$/i);
     if (useMatch) {
       steps.push({ type: 'use', tool: useMatch[1].trim(), saveAs: null, constraints: {} });
     }
 
-    // New: Ask <Target>
     const askMatch = line.match(/^Ask\s+(.+)$/i);
     if (askMatch) {
       steps.push({ type: 'ask', target: askMatch[1].trim(), saveAs: null, constraints: {} });