@josfox/jos 4.0.7 → 4.1.0

package/src/commands/init.js

@@ -1,162 +1,162 @@
-/**
- * JOS INIT Command - Create new .jos artifacts
- * Creates a minimal valid .jos with detached integrity manifest
- * Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)
- */
-
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-
-const C = {
-    reset: '\x1b[0m', bold: '\x1b[1m',
-    purple: '\x1b[38;5;135m', cyan: '\x1b[38;5;51m',
-    green: '\x1b[38;5;78m', gray: '\x1b[38;5;245m'
-};
-
-exports.execute = async (args, home) => {
-    const name = args[0] || 'new-artifact';
-    const type = args.includes('--pipeline') ? 'pipeline' : 'atom';
-    const filename = `${name}.jos`;
-
-    if (args.includes('--help') || args.includes('-h')) {
-        console.log(`
-${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}
-${C.bold}JOS INIT${C.reset} // Create new .jos artifacts
-${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}
-
-${C.bold}Usage:${C.reset}
-  jos init <name> [options]
-
-${C.bold}Options:${C.reset}
-  --pipeline    Create a pipeline artifact (default: atom)
-
-${C.bold}Creates:${C.reset}
-  <name>.jos           The artifact file
-  <name>.jos.sig.json  Detached integrity manifest
-`);
-        return;
-    }
-
-    console.log(`\n${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}`);
-    console.log(`${C.bold}JOS INIT${C.reset} // ${C.gray}Creating ${type} artifact${C.reset}`);
-    console.log(`${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}\n`);
-
-    // Create artifact with full JOSFOXAI + MAGIC compliance
-    const template = {
-        "$schema": "https://josfox.ai/schemas/jos-0.0.7.json",
-        "$comment": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)",
-
-        // JOSFOXAI Kernel
-        "jos": {
-            "open": `jos run ${type}`,
-            "supports": ["@josfox/jos", "josctl"],
-            "canonical": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)"
-        },
-        "orchestration_contract": {
-            "version": "0.0.7",
-            "mode": "sync"
-        },
-        "id_jos": `${type}-${name}-${Date.now()}`,
-        "adaptive_ai": {
-            "learning_mode": "frozen",
-            "llm_friendly_sentence": `This ${type} artifact performs the ${name} task.`
-        },
-        "security": {
-            "type": "open",
-            "permissions": [],
-            "health_check": null,
-            "integrity": null,
-            "integrity_ref": `./${filename}.sig.json`
-        },
-        "files": [],
-        "orchestration": {
-            "state": { "current_status": "idle" },
-            "definitions": {
-                "main_task": {
-                    "type": "shell",
-                    "description": "Main task - replace with your command",
-                    "command": "echo 'Hello from " + name + "'"
-                }
-            },
-            "flows": {
-                "main": {
-                    "description": "Main execution flow",
-                    "steps": ["main_task"]
-                }
-            }
-        },
-        "x_run_params": {
-            "timeout": 300,
-            "retry_on_failure": false
-        },
-
-        // MAGIC Kernel
-        "meta": {
-            "version": "1.0.0",
-            "type": type,
-            "name": name,
-            "provider": "local",
-            "author": "JOS Developer",
-            "canonical_version": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)"
-        },
-        "artifacts": {
-            "description": `Auto-generated ${type} artifact. Update this description.`,
-            "outputs": []
-        },
-        "guardrails": {
-            "avoid": [],
-            "max_retries": 1
-        },
-        "intention": {
-            "objective": "Define your objective here",
-            "success_criteria": "Define success criteria here"
-        },
-        "capabilities": []
-    };
-
-    // Write artifact
-    const content = JSON.stringify(template, null, 2);
-    fs.writeFileSync(filename, content);
-    console.log(`${C.green}✓ Created:${C.reset} ${filename}`);
-
-    // Generate integrity manifest
-    const sha256 = crypto.createHash('sha256').update(content).digest('hex');
-    const stats = fs.statSync(filename);
-
-    const manifest = {
-        "$schema": "https://josfox.ai/schemas/jos-manifest-0.0.7.json",
-        "manifest_version": "1.0.0",
-        "artifact_ref": filename,
-        "artifact_sha256": sha256,
-        "artifact_size_bytes": stats.size,
-        "timestamp": new Date().toISOString(),
-        "generated_by": "jos init command",
-        "canonical_version": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)"
-    };
-
-    const manifestPath = filename + '.sig.json';
-    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
-    console.log(`${C.green}✓ Created:${C.reset} ${manifestPath}`);
-    console.log(`${C.gray}  SHA256: ${sha256}${C.reset}`);
-
-    console.log(`
-${C.cyan}Next steps:${C.reset}
-  1. Edit ${filename} to define your tasks
-  2. Run: ${C.purple}jos validate ${filename}${C.reset}
-  3. Run: ${C.purple}jos run ${filename}${C.reset}
-`);
-
-    // Log to witness
-    const runDir = path.join(home, 'runs', 'init-' + new Date().toISOString().replace(/[:.]/g, '-'));
-    if (!fs.existsSync(runDir)) fs.mkdirSync(runDir, { recursive: true });
-
-    const event = {
-        timestamp: new Date().toISOString(),
-        type: 'init:created',
-        artifact: filename,
-        manifest: manifestPath,
-        sha256: sha256
-    };
-    fs.appendFileSync(path.join(runDir, 'events.jsonl'), JSON.stringify(event) + '\n');
-};
+/**
+ * JOS INIT Command - Create new .jos artifacts
+ * Creates a minimal valid .jos with detached integrity manifest
+ * Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const C = {
+    reset: '\x1b[0m', bold: '\x1b[1m',
+    purple: '\x1b[38;5;135m', cyan: '\x1b[38;5;51m',
+    green: '\x1b[38;5;78m', gray: '\x1b[38;5;245m'
+};
+
+exports.execute = async (args, home) => {
+    const name = args[0] || 'new-artifact';
+    const type = args.includes('--pipeline') ? 'pipeline' : 'atom';
+    const filename = `${name}.jos`;
+
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}
+${C.bold}JOS INIT${C.reset} // Create new .jos artifacts
+${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}
+
+${C.bold}Usage:${C.reset}
+  jos init <name> [options]
+
+${C.bold}Options:${C.reset}
+  --pipeline    Create a pipeline artifact (default: atom)
+
+${C.bold}Creates:${C.reset}
+  <name>.jos           The artifact file
+  <name>.jos.sig.json  Detached integrity manifest
+`);
+        return;
+    }
+
+    console.log(`\n${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}`);
+    console.log(`${C.bold}JOS INIT${C.reset} // ${C.gray}Creating ${type} artifact${C.reset}`);
+    console.log(`${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}\n`);
+
+    // Create artifact with full JOSFOXAI + MAGIC compliance
+    const template = {
+        "$schema": "https://josfox.ai/schemas/jos-0.0.7.json",
+        "$comment": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)",
+
+        // JOSFOXAI Kernel
+        "jos": {
+            "open": `jos run ${type}`,
+            "supports": ["@josfox/jos", "josctl"],
+            "canonical": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)"
+        },
+        "orchestration_contract": {
+            "version": "0.0.7",
+            "mode": "sync"
+        },
+        "id_jos": `${type}-${name}-${Date.now()}`,
+        "adaptive_ai": {
+            "learning_mode": "frozen",
+            "llm_friendly_sentence": `This ${type} artifact performs the ${name} task.`
+        },
+        "security": {
+            "type": "open",
+            "permissions": [],
+            "health_check": null,
+            "integrity": null,
+            "integrity_ref": `./${filename}.sig.json`
+        },
+        "files": [],
+        "orchestration": {
+            "state": { "current_status": "idle" },
+            "definitions": {
+                "main_task": {
+                    "type": "shell",
+                    "description": "Main task - replace with your command",
+                    "command": "echo 'Hello from " + name + "'"
+                }
+            },
+            "flows": {
+                "main": {
+                    "description": "Main execution flow",
+                    "steps": ["main_task"]
+                }
+            }
+        },
+        "x_run_params": {
+            "timeout": 300,
+            "retry_on_failure": false
+        },
+
+        // MAGIC Kernel
+        "meta": {
+            "version": "1.0.0",
+            "type": type,
+            "name": name,
+            "provider": "local",
+            "author": "JOS Developer",
+            "canonical_version": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)"
+        },
+        "artifacts": {
+            "description": `Auto-generated ${type} artifact. Update this description.`,
+            "outputs": []
+        },
+        "guardrails": {
+            "avoid": [],
+            "max_retries": 1
+        },
+        "intention": {
+            "objective": "Define your objective here",
+            "success_criteria": "Define success criteria here"
+        },
+        "capabilities": []
+    };
+
+    // Write artifact
+    const content = JSON.stringify(template, null, 2);
+    fs.writeFileSync(filename, content);
+    console.log(`${C.green}✓ Created:${C.reset} ${filename}`);
+
+    // Generate integrity manifest
+    const sha256 = crypto.createHash('sha256').update(content).digest('hex');
+    const stats = fs.statSync(filename);
+
+    const manifest = {
+        "$schema": "https://josfox.ai/schemas/jos-manifest-0.0.7.json",
+        "manifest_version": "1.0.0",
+        "artifact_ref": filename,
+        "artifact_sha256": sha256,
+        "artifact_size_bytes": stats.size,
+        "timestamp": new Date().toISOString(),
+        "generated_by": "jos init command",
+        "canonical_version": "Format version v0.0.7 — Specification maturity v0.1.0 (Alpha)"
+    };
+
+    const manifestPath = filename + '.sig.json';
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    console.log(`${C.green}✓ Created:${C.reset} ${manifestPath}`);
+    console.log(`${C.gray}  SHA256: ${sha256}${C.reset}`);
+
+    console.log(`
+${C.cyan}Next steps:${C.reset}
+  1. Edit ${filename} to define your tasks
+  2. Run: ${C.purple}jos validate ${filename}${C.reset}
+  3. Run: ${C.purple}jos run ${filename}${C.reset}
+`);
+
+    // Log to witness
+    const runDir = path.join(home, 'runs', 'init-' + new Date().toISOString().replace(/[:.]/g, '-'));
+    if (!fs.existsSync(runDir)) fs.mkdirSync(runDir, { recursive: true });
+
+    const event = {
+        timestamp: new Date().toISOString(),
+        type: 'init:created',
+        artifact: filename,
+        manifest: manifestPath,
+        sha256: sha256
+    };
+    fs.appendFileSync(path.join(runDir, 'events.jsonl'), JSON.stringify(event) + '\n');
+};

package/src/commands/llm.js

@@ -0,0 +1,159 @@
+/**
+ * JOS LLM Command - Execute artifacts via LLM
+ */
+const fs = require('fs');
+const path = require('path');
+const AdapterFactory = require('../adapters');
+const { calculateChecksum, verifyIntegrity } = require('../utils/crypto');
+
+// AURORA colors
+const C = {
+    reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+    purple: '\x1b[38;5;135m', cyan: '\x1b[38;5;51m',
+    green: '\x1b[38;5;78m', red: '\x1b[38;5;196m',
+    yellow: '\x1b[38;5;220m', white: '\x1b[38;5;255m',
+    gray: '\x1b[38;5;245m', blue: '\x1b[38;5;39m'
+};
+
+const DEFAULT_PROVIDER = 'https://api.josfox.cloud/prompts';
+
+function getProviderConfig(home) {
+    const configPath = path.join(home, 'prompts', 'providers.json');
+    if (fs.existsSync(configPath)) {
+        return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+    return {
+        providers: {
+            'josfox-cloud': { url: DEFAULT_PROVIDER, type: 'native', description: 'Official JOSFOX Cloud provider' }
+        },
+        default: 'josfox-cloud'
+    };
+}
+
+function getApiKey(home) {
+    const secretsPath = path.join(home, 'secrets', 'vault.json');
+    if (fs.existsSync(secretsPath)) {
+        try {
+            const secrets = JSON.parse(fs.readFileSync(secretsPath, 'utf8'));
+            return secrets.JOSFOX_API_KEY || secrets.OPENAI_API_KEY || null;
+        } catch { return null; }
+    }
+    return process.env.JOSFOX_API_KEY || process.env.OPENAI_API_KEY || null;
+}
+
+exports.execute = async (args, home) => {
+    if (args.includes('--help') || args.length === 0) {
+        console.log(`
+${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}
+${C.bold}JOS LLM EXECUTION${C.reset} // Execute artifacts via LLM
+${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}
+
+${C.bold}Usage:${C.reset}
+  jos llm <artifact.jos|.fox> [options]
+
+${C.bold}Options:${C.reset}
+  --model <name>          Target model
+  --provider <url>        API endpoint or Ollama URL
+  --type <native|ollama>  Provider type
+  --production            Enforce strict SHA integrity for .jos
+
+${C.bold}Notes:${C.reset}
+  • .fox artifacts ALWAYS require valid SHA checksums.
+  • .jos artifacts require SHA only in --production mode.
+`);
+        return;
+    }
+
+    const target = args[0];
+    const absPath = path.resolve(target);
+
+    if (!fs.existsSync(absPath)) {
+        console.log(`${C.red}✖ File not found: ${target}${C.reset}`);
+        return;
+    }
+
+    const ext = path.extname(absPath);
+    if (ext !== '.jos' && ext !== '.fox') {
+        console.log(`${C.red}✖ Invalid file type. Must be .jos or .fox${C.reset}`);
+        return;
+    }
+
+    console.log(`\n${C.cyan}${C.bold}JOS LLM EXECUTION${C.reset}`);
+    console.log(`${C.dim}Artifact: ${path.basename(absPath)}${C.reset}`);
+
+    // READ & PARSE
+    const rawContent = fs.readFileSync(absPath, 'utf8');
+    let artifact;
+    try {
+        artifact = JSON.parse(rawContent);
+    } catch (e) {
+        console.log(`${C.red}✖ Invalid JSON: ${e.message}${C.reset}`);
+        return;
+    }
+
+    // INTEGRITY CHECK
+    const isProduction = args.includes('--production') || process.env.NODE_ENV === 'production';
+    const enforceSha = ext === '.fox' || isProduction;
+
+    if (enforceSha) {
+        // TODO: Strict canonical verification. For now, we check if meta.checksum exists.
+        if (!artifact.meta || !artifact.meta.checksum) {
+            console.log(`${C.red}✖ Integrity Check Failed: Missing checksum in ${ext} file${C.reset}`);
+            console.log(`${C.gray}  (.fox files and production .jos require signed checksums)${C.reset}`);
+            return;
+        }
+        // const isValid = verifyIntegrity(artifact, rawContent); // Placeholder for strict check
+        // if (!isValid) { ... }
+        console.log(`${C.green}✓ Integrity Validated (Signature present)${C.reset}`);
+    } else {
+        console.log(`${C.yellow}⚠ Integrity Check Skipped (Dev Mode)${C.reset}`);
+    }
+
+    // RESOLVE PROVIDER
+    const config = getProviderConfig(home);
+    const providerKey = config.default;
+    const providerCfg = config.providers[providerKey] || config.providers['josfox-cloud'];
+
+    let providerUrl = providerCfg.url;
+    let providerType = providerCfg.type || 'native';
+
+    if (args.includes('--provider')) {
+        const pName = args[args.indexOf('--provider') + 1];
+        if (config.providers[pName]) {
+            providerUrl = config.providers[pName].url;
+            providerType = config.providers[pName].type || 'native';
+        } else {
+            providerUrl = pName;
+        }
+    }
+    if (args.includes('--type')) {
+        providerType = args[args.indexOf('--type') + 1];
+    }
+
+    const model = args.includes('--model') ? args[args.indexOf('--model') + 1] : null;
+    const apiKey = getApiKey(home);
+
+    console.log(`${C.dim}Provider: ${providerUrl} (${providerType})${C.reset}`);
+    console.log(`${C.purple}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${C.reset}\n`);
+
+    // EXECUTE
+    const Adapter = AdapterFactory.getAdapter(providerType);
+
+    try {
+        console.log(`${C.yellow}⏳ Executing via LLM...${C.reset}`);
+
+        const result = await Adapter.execute(artifact, providerUrl, model, apiKey);
+
+        console.log(`\n${C.green}✓ Execution Complete${C.reset}`);
+        console.log(`${C.cyan}Status:${C.reset} ${result.status}`);
+        console.log(`\n${C.bold}Output:${C.reset}\n`);
+        console.log(result.output);
+        console.log('');
+
+    } catch (e) {
+        console.log(`${C.red}✖ Execution Failed: ${e.message}${C.reset}`);
+        if (e.message && e.message.includes('ECONNREFUSED')) {
+            console.log(`${C.gray}  Is the provider running?${C.reset}`);
+        }
+    }
+};