nlos 1.4.0 → 1.6.0

package/bin/nlos.js

@@ -112,6 +112,40 @@ function showTokens() {
   }
 }
 
+// Minimal kernel for small models (~500 tokens)
+const MINIMAL_KERNEL = `# YOU ARE NL-OS
+
+You are NL-OS, a Natural Language Operating System. You help users think and work.
+
+## YOUR FIRST RESPONSE
+
+Say exactly: "NL-OS ready."
+
+## COMMANDS
+
+When user message starts with ">", it is a command. Execute it:
+
+>hype = Give 1-2 sentences of encouragement about their work
+>note TEXT = Say "Noted." (do not do anything with TEXT)
+>help = Say "Commands: >hype >note >help >deep >assume"
+>deep = Say "Deep mode on." Then think step-by-step
+>assume NAME = Say "Now acting as NAME." Then roleplay as NAME
+
+## RULES
+
+1. ">" means command - execute it immediately
+2. Be helpful, concise, no emojis
+3. If unsure, ask for clarification
+
+## EXAMPLE
+
+User: >hype
+Assistant: You're making real progress. Keep that momentum going.
+
+User: hello
+Assistant: Hello! How can I help you today?
+`;
+
 // Command preamble - explicit rules that help ALL models parse commands correctly
 const COMMAND_PREAMBLE = `# YOU ARE NL-OS (Natural Language Operating System)
 
@@ -287,6 +321,7 @@ function chat(options = {}) {
   const {
     model = 'qwen2.5:3b',
     full = false,
+    minimal = false,
     profile = null,
   } = options;
 
@@ -304,18 +339,24 @@ function chat(options = {}) {
 
   log('blue', `Starting NL-OS chat session...`);
   log('cyan', `Model: ${selectedModel}`);
-  log('cyan', `Tier: ${full ? 'FULL' : 'MANDATORY'}`);
+  log('cyan', `Tier: ${minimal ? 'MINIMAL' : full ? 'FULL' : 'MANDATORY'}`);
   console.log();
 
   // Generate the kernel payload
   log('yellow', 'Building kernel payload...');
-  const payload = generatePayload(full ? 'full' : 'mandatory', 'markdown');
 
-  // Escape the payload for Modelfile SYSTEM directive
-  // Replace """ with escaped version and handle multiline
-  const escapedPayload = payload.replace(/"""/g, '\\"\\"\\"');
+  let payload;
+  let tokenEstimate;
+
+  if (minimal) {
+    // Use minimal kernel for small models
+    payload = MINIMAL_KERNEL;
+    tokenEstimate = '~500';
+  } else {
+    payload = generatePayload(full ? 'full' : 'mandatory', 'markdown');
+    tokenEstimate = full ? '~15,500' : '~10,600';
+  }
 
-  const tokenEstimate = full ? '~15,500' : '~10,600';
   log('green', `Kernel payload ready (${tokenEstimate} tokens)`);
   console.log();
 
@@ -337,6 +378,14 @@ function chat(options = {}) {
   const modelfilePath = path.join(PACKAGE_ROOT, 'portable', '.Modelfile.nlos');
   const nlosModelName = 'nlos-kernel:latest';
 
+  // Delete old model to ensure fresh kernel
+  try {
+    execSync(`ollama rm ${nlosModelName}`, { stdio: 'pipe' });
+    log('cyan', 'Removed old kernel model');
+  } catch {
+    // Model didn't exist, that's fine
+  }
+
   const modelfileContent = `FROM ${selectedModel}
 SYSTEM """${payload}"""
 `;
@@ -428,6 +477,123 @@ function payload(options = {}) {
   }
 }
 
+function init(options = {}) {
+  const targetDir = process.cwd();
+
+  log('blue', `Initializing NL-OS workspace in ${targetDir}...\n`);
+
+  // Files to copy from package to local workspace
+  const filesToCopy = [
+    { src: 'memory.md', dest: 'memory.md', desc: 'Directive stack (customize this!)' },
+    { src: 'KERNEL.md', dest: 'KERNEL.md', desc: 'Kernel entry point' },
+    { src: 'AGENTS.md', dest: 'AGENTS.md', desc: 'Agent rules and invariants' },
+    { src: 'axioms.yaml', dest: 'axioms.yaml', desc: 'Canonical definitions' },
+    { src: 'personalities.md', dest: 'personalities.md', desc: 'Voice presets' },
+  ];
+
+  const commandsToCopy = [
+    'hype.md',
+    'note.md',
+    'assume.md',
+  ];
+
+  // Create directories
+  const commandsDir = path.join(targetDir, 'commands');
+  if (!fs.existsSync(commandsDir)) {
+    fs.mkdirSync(commandsDir, { recursive: true });
+  }
+
+  // Copy kernel files
+  log('yellow', 'Copying kernel files:');
+  for (const { src, dest, desc } of filesToCopy) {
+    const srcPath = path.join(PACKAGE_ROOT, src);
+    const destPath = path.join(targetDir, dest);
+
+    if (fs.existsSync(destPath)) {
+      log('cyan', `  [skip] ${dest} (already exists)`);
+    } else if (fs.existsSync(srcPath)) {
+      fs.copyFileSync(srcPath, destPath);
+      log('green', `  [created] ${dest} - ${desc}`);
+    } else {
+      log('red', `  [missing] ${src} not found in package`);
+    }
+  }
+
+  // Copy command files
+  console.log();
+  log('yellow', 'Copying command files:');
+  for (const cmd of commandsToCopy) {
+    const srcPath = path.join(PACKAGE_ROOT, '.cursor', 'commands', cmd);
+    const destPath = path.join(commandsDir, cmd);
+
+    if (fs.existsSync(destPath)) {
+      log('cyan', `  [skip] commands/${cmd} (already exists)`);
+    } else if (fs.existsSync(srcPath)) {
+      fs.copyFileSync(srcPath, destPath);
+      log('green', `  [created] commands/${cmd}`);
+    } else {
+      log('red', `  [missing] ${cmd} not found in package`);
+    }
+  }
+
+  // Create .nlos config file
+  const configPath = path.join(targetDir, '.nlos.yaml');
+  if (!fs.existsSync(configPath)) {
+    const config = `# NL-OS Workspace Configuration
+# Generated: ${new Date().toISOString().split('T')[0]}
+
+workspace:
+  name: "${path.basename(targetDir)}"
+  initialized: true
+
+kernel:
+  # Use local files (set to false to use global package)
+  use_local: true
+
+  # Default model for this workspace
+  default_model: qwen2.5:3b
+
+  # Tier: minimal, mandatory, full
+  default_tier: minimal
+
+# Add workspace-specific settings below
+`;
+    fs.writeFileSync(configPath, config);
+    log('green', `  [created] .nlos.yaml - workspace config`);
+  }
+
+  // Create .gitignore addition
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  const gitignoreContent = `# NL-OS
+.nlos-cache/
+`;
+  if (!fs.existsSync(gitignorePath)) {
+    fs.writeFileSync(gitignorePath, gitignoreContent);
+    log('green', `  [created] .gitignore`);
+  }
+
+  console.log();
+  log('green', 'Workspace initialized!\n');
+
+  console.log(`${colors.yellow}Next steps:${colors.reset}`);
+  console.log(`  1. Edit ${colors.cyan}memory.md${colors.reset} to customize your directives`);
+  console.log(`  2. Add commands to ${colors.cyan}commands/${colors.reset}`);
+  console.log(`  3. Run ${colors.cyan}nlos chat --minimal${colors.reset} to start\n`);
+
+  console.log(`${colors.yellow}Files created:${colors.reset}`);
+  console.log(`  ${targetDir}/`);
+  console.log(`  ├── KERNEL.md          # Entry point`);
+  console.log(`  ├── memory.md          # Your directives (edit this!)`);
+  console.log(`  ├── AGENTS.md          # Agent rules`);
+  console.log(`  ├── axioms.yaml        # Definitions`);
+  console.log(`  ├── personalities.md   # Voice presets`);
+  console.log(`  ├── commands/          # Your commands`);
+  console.log(`  │   ├── hype.md`);
+  console.log(`  │   ├── note.md`);
+  console.log(`  │   └── assume.md`);
+  console.log(`  └── .nlos.yaml         # Workspace config`);
+}
+
 function showHelp() {
   console.log(`
 ${colors.cyan}NL-OS${colors.reset} - Natural Language Operating System
@@ -436,6 +602,7 @@ ${colors.yellow}Usage:${colors.reset}
   nlos <command> [options]
 
 ${colors.yellow}Commands:${colors.reset}
+  init              Initialize NL-OS workspace in current directory
   chat              Interactive NL-OS chat session (recommended)
   boot              Boot NL-OS and verify kernel loads
   payload           Generate portable kernel payloads
@@ -443,9 +610,10 @@ ${colors.yellow}Commands:${colors.reset}
   tokens            Show token estimates
   help              Show this help message
 
-${colors.yellow}Boot Options:${colors.reset}
+${colors.yellow}Chat/Boot Options:${colors.reset}
   --model <name>    Model to use (default: qwen2.5:3b)
   --profile <name>  Use profile: speed, balanced, quality, memory_constrained
+  --minimal         Use minimal ~500 token kernel (best for small models)
   --full            Load full kernel (includes personalities)
   --dry-run         Preview system prompt without launching
   --runtime <name>  Runtime: ollama, llama-cpp, lm-studio (default: ollama)
@@ -457,7 +625,8 @@ ${colors.yellow}Payload Options:${colors.reset}
   --all             Generate all variants
 
 ${colors.yellow}Examples:${colors.reset}
-  nlos chat                           # Start interactive chat (recommended)
+  nlos init                           # Initialize workspace with kernel files
+  nlos chat --minimal                 # Use minimal kernel for small models (3B)
   nlos chat --model llama3.1:8b       # Chat with specific model
   nlos chat --profile quality --full  # Quality mode with full kernel
   nlos boot                           # Verify kernel loads (one-shot)
@@ -494,6 +663,8 @@ function parseArgs(args) {
       options.runtime = args[++i];
     } else if (arg === '--full') {
       options.full = true;
+    } else if (arg === '--minimal') {
+      options.minimal = true;
     } else if (arg === '--dry-run') {
       options.dryRun = true;
     } else if (arg === '--all') {
@@ -512,6 +683,10 @@ const command = args[0];
 const options = parseArgs(args.slice(1));
 
 switch (command) {
+  case 'init':
+    init(options);
+    break;
+
   case 'chat':
     chat(options);
     break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nlos",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Natural Language Operating System - A model-agnostic kernel for any LLM",
   "main": "bin/nlos.js",
   "bin": {