escribano 0.1.4 → 0.2.2

package/dist/utils/env-logger.js

@@ -0,0 +1,166 @@
+/**
+ * Environment Variable Logger
+ *
+ * Parses .env.example to extract default values and descriptions,
+ * then logs all ESCRIBANO_* environment variables with comparisons
+ * to their defaults. Only logs when ESCRIBANO_VERBOSE=true.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+const SECRET_VARS = ['ESCRIBANO_OUTLINE_TOKEN'];
+/**
+ * Parse .env.example file to extract variable names, defaults, and descriptions.
+ * Returns empty array if file not found.
+ */
+function parseEnvExample() {
+    const envExamplePath = resolve(process.cwd(), '.env.example');
+    let content;
+    try {
+        content = readFileSync(envExamplePath, 'utf-8');
+    }
+    catch {
+        // File not found or unreadable
+        return [];
+    }
+    const vars = [];
+    const lines = content.split('\n');
+    let currentDescription = [];
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Skip empty lines - reset description
+        if (trimmedLine === '') {
+            currentDescription = [];
+            continue;
+        }
+        // Comment line
+        if (trimmedLine.startsWith('#')) {
+            const commentContent = trimmedLine.slice(1).trim();
+            // Skip section headers (pattern: # ===)
+            if (commentContent.startsWith('===')) {
+                currentDescription = [];
+                continue;
+            }
+            // Skip deprecated section marker
+            if (commentContent.toLowerCase().includes('deprecated')) {
+                currentDescription = [];
+                continue;
+            }
+            // Accumulate description
+            currentDescription.push(commentContent);
+            continue;
+        }
+        // Variable line (contains =)
+        if (trimmedLine.includes('=')) {
+            const eqIndex = trimmedLine.indexOf('=');
+            const name = trimmedLine.slice(0, eqIndex).trim();
+            const value = trimmedLine.slice(eqIndex + 1).trim();
+            // Skip if name starts with # (deprecated/commented)
+            if (name.startsWith('#')) {
+                currentDescription = [];
+                continue;
+            }
+            // Only track ESCRIBANO_* variables
+            if (name.startsWith('ESCRIBANO_')) {
+                vars.push({
+                    name,
+                    defaultValue: value,
+                    description: currentDescription.join(' '),
+                });
+            }
+            currentDescription = [];
+        }
+    }
+    return vars;
+}
+/**
+ * Check if a variable should be masked (secret).
+ */
+function isSecretVar(name) {
+    return SECRET_VARS.includes(name);
+}
+/**
+ * Format value for display, masking secrets if needed.
+ */
+function formatValue(value, isSecret) {
+    if (value === 'not set') {
+        return 'not set';
+    }
+    if (isSecret && value !== 'not set' && value !== '') {
+        return '***';
+    }
+    if (value === '') {
+        return '(empty)';
+    }
+    return value;
+}
+/**
+ * Main logging function. Only runs when ESCRIBANO_VERBOSE=true.
+ */
+export function logEnvironmentVariables() {
+    if (process.env.ESCRIBANO_VERBOSE !== 'true') {
+        return;
+    }
+    const envVars = parseEnvExample();
+    if (envVars.length === 0) {
+        console.log('\n=== Environment Variables ===');
+        console.log('  (Could not parse .env.example)\n');
+        return;
+    }
+    // Build list of vars with their current values
+    const varsWithValues = envVars.map((varDef) => {
+        const currentValue = process.env[varDef.name] ?? 'not set';
+        const isCustom = currentValue !== varDef.defaultValue && currentValue !== 'not set';
+        return {
+            ...varDef,
+            currentValue,
+            isCustom,
+            isSecret: isSecretVar(varDef.name),
+        };
+    });
+    // Sort alphabetically by name
+    varsWithValues.sort((a, b) => a.name.localeCompare(b.name));
+    // Log output
+    console.log('\n=== Environment Variables ===\n');
+    for (const varDef of varsWithValues) {
+        const marker = varDef.isCustom ? ' [CUSTOM]' : '';
+        const displayCurrent = formatValue(varDef.currentValue, varDef.isSecret);
+        const displayDefault = formatValue(varDef.defaultValue, false);
+        console.log(`  ${varDef.name}${marker}`);
+        console.log(`    Current: ${displayCurrent}`);
+        console.log(`    Default: ${displayDefault}`);
+        if (varDef.description) {
+            // Wrap description to fit nicely (max ~60 chars per line)
+            const wrappedDesc = wrapText(varDef.description, 58);
+            for (const line of wrappedDesc) {
+                console.log(`    ${line}`);
+            }
+        }
+        console.log('');
+    }
+}
+/**
+ * Wrap text to specified width.
+ */
+function wrapText(text, width) {
+    if (text.length <= width) {
+        return [text];
+    }
+    const words = text.split(' ');
+    const lines = [];
+    let currentLine = '';
+    for (const word of words) {
+        if (`${currentLine} ${word}`.trim().length <= width) {
+            currentLine = currentLine ? `${currentLine} ${word}` : word;
+        }
+        else {
+            if (currentLine) {
+                lines.push(currentLine);
+            }
+            currentLine = word;
+        }
+    }
+    if (currentLine) {
+        lines.push(currentLine);
+    }
+    return lines;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "escribano",
-  "version": "0.1.4",
+  "version": "0.2.2",
   "description": "AI-powered session intelligence tool — turn screen recordings into structured work summaries",
   "main": "dist/index.js",
   "type": "module",
@@ -11,7 +11,9 @@
     "dist",
     "migrations",
     "prompts",
-    "scripts"
+    "scripts",
+    "src/scripts/audio_preprocessor.py",
+    "src/scripts/visual_observer_base.py"
   ],
   "scripts": {
     "test": "vitest run",
@@ -20,6 +22,7 @@
     "build": "tsc",
     "postbuild": "node scripts/add-shebang.mjs",
     "prepublishOnly": "pnpm build",
+    "postpublish": "node scripts/create-release.mjs",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
@@ -30,7 +33,7 @@
     "dashboard": "node tools/dashboard/server.js",
     "db:reset": "rm -f ~/.escribano/escribano.db*",
     "ollama": "OLLAMA_NUM_PARALLEL=4 OLLAMA_MAX_LOADED_MODELS=3 OLLAMA_FLASH_ATTENTION=1 OLLAMA_KEEP_ALIVE=-1 OLLAMA_CONTEXT_LENGTH=262144 ollama serve",
-    "ollama-2": "OLLAMA_NUM_PARALLEL=1 OLLAMA_HOST=127.0.0.1:11435 OLLAMA_MAX_LOADED_MODELS=1 OLLAMA_FLASH_ATTENTION=1 OLLAMA_KEEP_ALIVE=-1 OLLAMA_CONTEXT_LENGTH=262144 ollama serve",
+    "ollama-2": "OLLAMA_NUM_PARALLEL=1 OLLAMA_HOST=127.0.0.1.11435 OLLAMA_MAX_LOADED_MODELS=1 OLLAMA_FLASH_ATTENTION=1 OLLAMA_KEEP_ALIVE=-1 OLLAMA_CONTEXT_LENGTH=262144 ollama serve",
     "index:rebuild": "tsx --env-file=.env src/scripts/rebuild-index.ts"
   },
   "keywords": [

package/scripts/backfill-releases.mjs

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+
+import { execSync } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+
+const REPO_ROOT = join(import.meta.dirname, "..");
+const CHANGELOG_PATH = join(REPO_ROOT, "CHANGELOG.md");
+
+function run(cmd) {
+  return execSync(cmd, { encoding: "utf-8", cwd: REPO_ROOT }).trim();
+}
+
+function getPreviousTag(currentTag, allTags) {
+  const currentIndex = allTags.indexOf(currentTag);
+  if (currentIndex === 0) return null;
+  return allTags[currentIndex - 1];
+}
+
+function getCommitsBetweenTags(fromTag, toTag) {
+  const range = fromTag ? `${fromTag}..${toTag}` : toTag;
+  const format = "%H|%s|%an|%ad";
+  const dateformat = "--date=short";
+  
+  const commits = run(`git log ${range} --pretty=format:'${format}' ${dateformat}`)
+    .split("\n")
+    .filter(Boolean)
+    .map(line => {
+      const [hash, subject, author, date] = line.split("|");
+      return { hash, subject, author, date };
+    });
+  
+  return commits;
+}
+
+async function generateReleaseNotes(commits, version, tagDate) {
+  const commitList = commits
+    .map(c => `- ${c.subject} (${c.author}, ${c.date})`)
+    .join("\n");
+
+  const prompt = `You are a release notes generator. Given these git commits, create a clean, user-friendly changelog entry.
+
+Version: ${version}
+Date: ${tagDate}
+
+Commits:
+${commitList}
+
+Generate a changelog entry in this exact format (use markdown):
+
+## [${version}] - ${tagDate}
+
+### Added
+- (new features)
+
+### Fixed  
+- (bug fixes)
+
+### Changed
+- (improvements, refactors)
+
+### Removed
+- (deprecated features removed)
+
+Rules:
+- Group commits into the most appropriate section
+- Use present tense ("Add feature" not "Added feature")
+- Be concise but descriptive
+- If a section has no commits, omit it entirely
+- Only output the changelog entry, no additional text`;
+
+  try {
+    const response = await fetch("http://localhost:11434/api/generate", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        model: process.env.ESCRIBANO_LLM_MODEL || "qwen3:8b",
+        prompt,
+        stream: false,
+        options: {
+          temperature: 0.3,
+        },
+      }),
+    });
+
+    if (!response.ok) {
+      throw new Error(`Ollama request failed: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return data.response.trim();
+  } catch (error) {
+    console.error("⚠️  Failed to generate notes with Ollama, using fallback");
+    console.error(error.message);
+    
+    const changes = commits.map(c => `- ${c.subject}`).join("\n");
+    
+    return `## [${version}] - ${tagDate}
+
+### Changed
+${changes}`;
+  }
+}
+
+function updateChangelog(releaseNotes) {
+  let changelog = "";
+  
+  if (existsSync(CHANGELOG_PATH)) {
+    changelog = readFileSync(CHANGELOG_PATH, "utf-8");
+  }
+  
+  const header = `# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+`;
+
+  if (!changelog.includes("# Changelog")) {
+    changelog = header + changelog;
+  }
+  
+  // Insert new release after header
+  const lines = changelog.split("\n");
+  const insertIndex = lines.findIndex(line => line.startsWith("## [")) || 6;
+  
+  lines.splice(insertIndex, 0, releaseNotes, "");
+  
+  writeFileSync(CHANGELOG_PATH, lines.join("\n"));
+  console.log("✅ Updated CHANGELOG.md");
+}
+
+function createGitHubRelease(tag, releaseNotes) {
+  const notesFile = `/tmp/escribano-release-${tag}.md`;
+  writeFileSync(notesFile, releaseNotes);
+  
+  try {
+    run(`gh release create ${tag} --title "${tag}" --notes-file "${notesFile}"`);
+    console.log(`✅ Created GitHub release: ${tag}`);
+  } catch (error) {
+    if (error.message.includes("already exists")) {
+      console.log(`⚠️  Release ${tag} already exists, skipping`);
+    } else {
+      throw error;
+    }
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0) {
+    console.log("Usage: node scripts/backfill-releases.mjs <tag1> [tag2] [tag3] ...");
+    console.log("Example: node scripts/backfill-releases.mjs v0.1.1 v0.1.3 v0.2.0");
+    process.exit(1);
+  }
+  
+  const tagsToProcess = args;
+  const allTags = run("git tag --list 'v*' | sort -V").split("\n").filter(Boolean);
+  
+  console.log(`🚀 Creating releases for ${tagsToProcess.length} tags...\n`);
+  
+  for (const tag of tagsToProcess) {
+    if (!allTags.includes(tag)) {
+      console.error(`❌ Tag ${tag} not found`);
+      continue;
+    }
+    
+    console.log(`\n📌 Processing ${tag}`);
+    
+    const previousTag = getPreviousTag(tag, allTags);
+    console.log(`   Previous tag: ${previousTag || "none (first release)"}`);
+    
+    const commits = getCommitsBetweenTags(previousTag, tag);
+    console.log(`   Found ${commits.length} commits`);
+    
+    if (commits.length === 0) {
+      console.log("   ⚠️  No commits found, skipping");
+      continue;
+    }
+    
+    const version = tag.replace(/^v/, "");
+    const tagDate = run(`git log -1 --format=%ad --date=short ${tag}`);
+    
+    const releaseNotes = await generateReleaseNotes(commits, version, tagDate);
+    
+    console.log("\n   Generated release notes:");
+    console.log("   " + releaseNotes.split("\n").join("\n   "));
+    console.log("\n   ---");
+    
+    updateChangelog(releaseNotes);
+    createGitHubRelease(tag, releaseNotes);
+  }
+  
+  console.log("\n🎉 All releases complete!");
+  console.log("\nNext steps:");
+  console.log("  1. Review CHANGELOG.md changes");
+  console.log("  2. Commit: git add CHANGELOG.md && git commit -m 'docs: add CHANGELOG'");
+  console.log("  3. Push: git push");
+}
+
+main().catch(error => {
+  console.error("❌ Release creation failed:", error.message);
+  process.exit(1);
+});

package/scripts/create-release.mjs

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+
+import { execSync } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+
+const REPO_ROOT = join(import.meta.dirname, "..");
+const CHANGELOG_PATH = join(REPO_ROOT, "CHANGELOG.md");
+
+function run(cmd) {
+  return execSync(cmd, { encoding: "utf-8", cwd: REPO_ROOT }).trim();
+}
+
+function getCurrentTag() {
+  try {
+    return run("git describe --tags --exact-match");
+  } catch {
+    console.error("❌ No git tag found at current commit");
+    console.error("   Run: git tag v<x.y.z> && git push --tags");
+    process.exit(1);
+  }
+}
+
+function getPreviousTag(currentTag) {
+  const allTags = run("git tag --list 'v*' | sort -V").split("\n").filter(Boolean);
+  const currentIndex = allTags.indexOf(currentTag);
+  
+  if (currentIndex === 0) return null;
+  return allTags[currentIndex - 1];
+}
+
+function getCommitsSinceTag(previousTag, currentTag) {
+  const range = previousTag ? `${previousTag}..${currentTag}` : currentTag;
+  const format = "%H|%s|%an|%ad";
+  const dateformat = "--date=short";
+  
+  const commits = run(`git log ${range} --pretty=format:'${format}' ${dateformat}`)
+    .split("\n")
+    .filter(Boolean)
+    .map(line => {
+      const [hash, subject, author, date] = line.split("|");
+      return { hash, subject, author, date };
+    });
+  
+  return commits;
+}
+
+async function generateReleaseNotes(commits, version) {
+  const commitList = commits
+    .map(c => `- ${c.subject} (${c.author}, ${c.date})`)
+    .join("\n");
+
+  const prompt = `You are a release notes generator. Given these git commits, create a clean, user-friendly changelog entry.
+
+Version: ${version}
+
+Commits:
+${commitList}
+
+Generate a changelog entry in this exact format (use markdown):
+
+## [${version}] - ${new Date().toISOString().split("T")[0]}
+
+### Added
+- (new features)
+
+### Fixed  
+- (bug fixes)
+
+### Changed
+- (improvements, refactors)
+
+### Removed
+- (deprecated features removed)
+
+Rules:
+- Group commits into the most appropriate section
+- Use present tense ("Add feature" not "Added feature")
+- Be concise but descriptive
+- If a section has no commits, omit it entirely
+- Only output the changelog entry, no additional text`;
+
+  try {
+    const response = await fetch("http://localhost:11434/api/generate", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        model: process.env.ESCRIBANO_LLM_MODEL || "qwen3:8b",
+        prompt,
+        stream: false,
+        options: {
+          temperature: 0.3,
+        },
+      }),
+    });
+
+    if (!response.ok) {
+      throw new Error(`Ollama request failed: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return data.response.trim();
+  } catch (error) {
+    console.error("⚠️  Failed to generate notes with Ollama, using fallback");
+    console.error(error.message);
+    
+    // Fallback: simple format
+    const date = new Date().toISOString().split("T")[0];
+    const changes = commits.map(c => `- ${c.subject}`).join("\n");
+    
+    return `## [${version}] - ${date}
+
+### Changed
+${changes}`;
+  }
+}
+
+function updateChangelog(releaseNotes) {
+  let changelog = "";
+  
+  if (existsSync(CHANGELOG_PATH)) {
+    changelog = readFileSync(CHANGELOG_PATH, "utf-8");
+  }
+  
+  const header = `# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+`;
+
+  if (!changelog.includes("# Changelog")) {
+    changelog = header + changelog;
+  }
+  
+  // Insert new release after header
+  const lines = changelog.split("\n");
+  const insertIndex = lines.findIndex(line => line.startsWith("## [")) || 6;
+  
+  lines.splice(insertIndex, 0, releaseNotes, "");
+  
+  writeFileSync(CHANGELOG_PATH, lines.join("\n"));
+  console.log("✅ Updated CHANGELOG.md");
+}
+
+function createGitHubRelease(tag, releaseNotes) {
+  const notesFile = `/tmp/escribano-release-${tag}.md`;
+  writeFileSync(notesFile, releaseNotes);
+  
+  try {
+    run(`gh release create ${tag} --title "${tag}" --notes-file "${notesFile}"`);
+    console.log(`✅ Created GitHub release: ${tag}`);
+  } catch (error) {
+    if (error.message.includes("already exists")) {
+      console.log(`⚠️  Release ${tag} already exists, skipping`);
+    } else {
+      throw error;
+    }
+  }
+}
+
+async function main() {
+  console.log("🚀 Creating GitHub release...\n");
+  
+  const currentTag = getCurrentTag();
+  console.log(`📌 Current tag: ${currentTag}`);
+  
+  const previousTag = getPreviousTag(currentTag);
+  console.log(`📌 Previous tag: ${previousTag || "none (first release)"}`);
+  
+  const commits = getCommitsSinceTag(previousTag, currentTag);
+  console.log(`📝 Found ${commits.length} commits\n`);
+  
+  if (commits.length === 0) {
+    console.log("⚠️  No commits found, skipping release creation");
+    process.exit(0);
+  }
+  
+  const version = currentTag.replace(/^v/, "");
+  const releaseNotes = await generateReleaseNotes(commits, version);
+  
+  console.log("Generated release notes:\n");
+  console.log(releaseNotes);
+  console.log("\n---\n");
+  
+  updateChangelog(releaseNotes);
+  createGitHubRelease(currentTag, releaseNotes);
+  
+  console.log("\n🎉 Release complete!");
+  console.log("\nNext steps:");
+  console.log("  1. Review CHANGELOG.md changes");
+  console.log("  2. Commit: git add CHANGELOG.md && git commit -m 'docs: update CHANGELOG'");
+  console.log("  3. Push: git push");
+}
+
+main().catch(error => {
+  console.error("❌ Release creation failed:", error.message);
+  process.exit(1);
+});