pantheon-opencode 1.3.5 → 1.3.7

package/scripts/memory_mcp_server.py

@@ -1,4 +1,3 @@
-# Auto-generated: resolved symlink from ../src/mcp/memory_mcp_server.py
 #!/usr/bin/env python3
 """Pantheon Memory MCP Server — lightweight, zero heavy deps.
 
@@ -26,6 +25,7 @@ import json
 import os
 import sqlite3
 import time
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
@@ -187,10 +187,55 @@ def _parse_metadata(row: dict[str, Any]) -> dict[str, Any]:
 _RRF_CONST = 60
 
 
+def _parse_iso_ts(value: str) -> float:
+    """Parse an ISO 8601 UTC timestamp to epoch seconds.
+
+    Handles both aware ISO strings (``2026-08-21T10:00:00Z`` /
+    ``...+00:00``) and legacy naive rows from ``DEFAULT (datetime('now'))``
+    (``YYYY-MM-DD HH:MM:SS``, space separator, no TZ). Naive timestamps are
+    assumed UTC — SQLite's ``datetime('now')`` is UTC, so interpreting them
+    in the local timezone would skew freshness decay.
+    """
+    dt = datetime.fromisoformat(value.replace("Z", "+00:00"))
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=timezone.utc)
+    return dt.timestamp()
+
+
+def _fetch_created_at_map(
+    db: sqlite3.Connection, ids: list[int]
+) -> dict[int, str]:
+    """Fetch created_at timestamps for the given memory IDs.
+
+    Args:
+        db: Active SQLite connection.
+        ids: Memory row IDs to look up.
+
+    Returns:
+        Mapping of id -> created_at ISO string. Empty on failure.
+    """
+    created_at_map: dict[int, str] = {}
+    if not ids:
+        return created_at_map
+    try:
+        placeholders = ",".join("?" * len(ids))
+        rows = db.execute(
+            f"SELECT id, created_at FROM memories "
+            f"WHERE id IN ({placeholders})",
+            ids,
+        ).fetchall()
+        created_at_map = {r["id"]: r["created_at"] for r in rows}
+    except Exception:
+        created_at_map = {}
+    return created_at_map
+
+
 def _rrf_fuse(
     vec_ids: list[int],
     fts_ids: list[int],
     top_k: int,
+    created_at_map: dict[int, str] | None = None,
+    decay_days: float | None = None,
 ) -> list[tuple[int, float]]:
     """Reciprocal Rank Fusion of vector and FTS5 result ID lists.
 
@@ -198,6 +243,12 @@ def _rrf_fuse(
         vec_ids: Ordered list of IDs from vector search (most relevant first).
         fts_ids: Ordered list of IDs from FTS5 search (most relevant first).
         top_k: Maximum number of fused results to return.
+        created_at_map: Optional mapping of doc_id -> created_at ISO string,
+            used to compute freshness when ``decay_days`` is set.
+        decay_days: Optional freshness half-life in days. When set, each fused
+            score is multiplied by ``freshness = 2^(-days/decay_days)`` so
+            older entries rank lower. Default None = no decay (backward
+            compatible).
 
     Returns:
         List of (id, rrf_score) tuples sorted by descending score.
@@ -207,6 +258,19 @@ def _rrf_fuse(
         scores[doc_id] = 1.0 / (_RRF_CONST + rank)
     for rank, doc_id in enumerate(fts_ids, start=1):
         scores[doc_id] = scores.get(doc_id, 0.0) + 1.0 / (_RRF_CONST + rank)
+
+    if decay_days is not None and decay_days > 0 and created_at_map:
+        now = time.time()
+        for doc_id in list(scores):
+            created = created_at_map.get(doc_id)
+            if not created:
+                continue
+            try:
+                days = max(0.0, (now - _parse_iso_ts(created)) / 86400.0)
+            except (ValueError, TypeError):
+                continue
+            scores[doc_id] *= 2.0 ** (-days / decay_days)
+
     ranked = sorted(scores.items(), key=lambda x: (-x[1], x[0]))
     return ranked[:top_k]
 
@@ -283,12 +347,15 @@ def memory_store(
 @mcp.tool(
     description="Hybrid semantic search across memories. "
     "Combines vector cosine similarity and FTS5 BM25 keyword search "
-    "via Reciprocal Rank Fusion (RRF).",
+    "via Reciprocal Rank Fusion (RRF). Optional decay_days applies a "
+    "freshness half-life (2^(-days/decay_days)) so recent entries rank "
+    "higher; default None keeps the original rank-only behavior.",
 )
 def memory_search(  # noqa: PLR0912
     query: str,
     namespace: str | None = None,
     top_k: int = 5,
+    decay_days: float | None = None,
 ) -> list[dict[str, Any]]:
     """Hybrid search: vector + keyword fused via RRF.
 
@@ -300,6 +367,9 @@ def memory_search(  # noqa: PLR0912
         query: Search query text.
         namespace: Optional namespace filter.
         top_k: Maximum results (default 5, max 50).
+        decay_days: Optional freshness half-life in days. When set, fused
+            scores are multiplied by ``2^(-days_since_created/decay_days)``
+            so older entries rank lower. Default None = no decay.
 
     Returns:
         List of memory entries with score and metadata.
@@ -365,8 +435,14 @@ def memory_search(  # noqa: PLR0912
     except Exception:
         fts_ids = []
 
-    # 4. RRF fusion
-    fused = _rrf_fuse(vec_ids, fts_ids, top_k)
+    # 4. RRF fusion (optionally freshness-decayed)
+    candidate_ids = list(dict.fromkeys([*vec_ids, *fts_ids]))
+    created_at_map = (
+        _fetch_created_at_map(db, candidate_ids)
+        if decay_days is not None and decay_days > 0
+        else {}
+    )
+    fused = _rrf_fuse(vec_ids, fts_ids, top_k, created_at_map, decay_days)
 
     if not fused:
         return []

package/scripts/postinstall.mjs

@@ -5,43 +5,45 @@
  * Runs after `npm install` completes. Validates environment and prints
  * setup instructions. Does NOT install Pantheon platform components.
  */
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
-const __dirname = fileURLToPath(new URL('.', import.meta.url));
-const ROOT = join(__dirname, '..');
+const __dirname = fileURLToPath(new URL('.', import.meta.url))
+const _ROOT = join(__dirname, '..')
 
-const REQUIRED_NODE_MAJOR = 18;
-const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+const REQUIRED_NODE_MAJOR = 18
+const nodeMajor = parseInt(process.versions.node.split('.')[0], 10)
 
 try {
   // Validate Node.js version
   if (nodeMajor < REQUIRED_NODE_MAJOR) {
-    console.error(`❌ Node.js >= ${REQUIRED_NODE_MAJOR} required (current: ${process.versions.node})`);
-    process.exit(1);
+    console.error(
+      `❌ Node.js >= ${REQUIRED_NODE_MAJOR} required (current: ${process.versions.node})`,
+    )
+    process.exit(1)
   }
 
   // Validate js-yaml is available
   try {
-    await import('js-yaml');
+    await import('js-yaml')
   } catch {
-    console.warn('⚠️  js-yaml not found — run `npm install` to install dependencies');
+    console.warn('⚠️  js-yaml not found — run `npm install` to install dependencies')
   }
 
-  console.log('');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('  Pantheon OpenCode — npm dependencies installed ✅');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('');
-  console.log('  Next steps:');
-  console.log('  1. Configure Pantheon:');
-  console.log('     npm run setup');
-  console.log('     # or: npx pantheon-opencode init');
-  console.log('  2. Verify installation:');
-  console.log('     npm run doctor');
-  console.log('');
+  console.log('')
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log('  Pantheon OpenCode — npm dependencies installed ✅')
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log('')
+  console.log('  Next steps:')
+  console.log('  1. Configure Pantheon:')
+  console.log('     npm run setup')
+  console.log('     # or: npx pantheon-opencode init')
+  console.log('  2. Verify installation:')
+  console.log('     npm run doctor')
+  console.log('')
 } catch (err) {
-  console.error(`❌ Post-install check failed: ${err.message}`);
-  process.exit(1);
+  console.error(`❌ Post-install check failed: ${err.message}`)
+  process.exit(1)
 }

package/scripts/prune.mjs

@@ -34,7 +34,7 @@ import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
-const ROOT = join(__dirname, '..')
+const _ROOT = join(__dirname, '..')
 const DEFAULT_BACKUP_AGE_DAYS = 30
 
 // ---------------------------------------------------------------------------

package/scripts/redaction-gate.mjs

@@ -30,7 +30,9 @@ function scanFile(path) {
 }
 
 function scanTarball(path) {
-  const entries = execFileSync('tar', ['-tzf', path], { encoding: 'utf8' }).split('\n').filter(Boolean)
+  const entries = execFileSync('tar', ['-tzf', path], { encoding: 'utf8' })
+    .split('\n')
+    .filter(Boolean)
   const result = []
   for (const entry of entries) {
     const content = execFileSync('tar', ['-xOzf', path, entry])

package/scripts/sync-tui.mjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * sync-tui.mjs — Postinstall hook: sync TUI plugin to user's OpenCode config
+ *
+ * Runs automatically after `npm install pantheon-opencode@latest`. Detects the
+ * user's OpenCode config directory and, if the TUI plugin was previously
+ * installed (via `npx pantheon-opencode init`), copies fresh files from the
+ * installed package and refreshes dependencies.
+ *
+ * If the user hasn't initialized yet → do nothing (silent exit).
+ */
+import { execSync } from 'node:child_process'
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url))
+const ROOT = join(__dirname, '..')
+
+// ── Helpers ────────────────────────────────────────────────────────────
+
+/**
+ * Write content to filePath only if it differs from what's on disk.
+ * @returns {boolean} true if file was written (changed), false if skipped
+ */
+function writeIfChanged(filePath, content) {
+  const existing = existsSync(filePath) ? readFileSync(filePath, 'utf8') : null
+  if (existing === content) return false
+  writeFileSync(filePath, content, 'utf8')
+  return true
+}
+
+/**
+ * Read the `version` field from a package.json, or null on failure.
+ */
+function readVersion(pkgPath) {
+  try {
+    return JSON.parse(readFileSync(pkgPath, 'utf8')).version || null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Resolve the user's OpenCode config directory.
+ * Priority: $XDG_CONFIG_HOME/opencode → ~/.opencode → null (not initialized)
+ */
+function resolveConfigDir() {
+  const xdgConfig = process.env.XDG_CONFIG_HOME || join(homedir(), '.config')
+  const xdgDir = join(xdgConfig, 'opencode')
+  if (existsSync(xdgDir)) return xdgDir
+
+  const homeDir = join(homedir(), '.opencode')
+  if (existsSync(homeDir)) return homeDir
+
+  return null
+}
+
+/**
+ * Copy plugin runtime files (dist/*, package.json, src/index.tsx) from srcDir
+ * to dstDir. Skips files that are byte-identical.
+ * @returns {{ created: number, skipped: number }}
+ */
+function copyPluginFiles(srcDir, dstDir) {
+  const result = { created: 0, skipped: 0 }
+
+  mkdirSync(dstDir, { recursive: true })
+  mkdirSync(join(dstDir, 'dist'), { recursive: true })
+
+  // src/index.tsx → index.tsx
+  const srcIdx = join(srcDir, 'src', 'index.tsx')
+  if (existsSync(srcIdx)) {
+    const content = readFileSync(srcIdx, 'utf8')
+    if (writeIfChanged(join(dstDir, 'index.tsx'), content)) result.created++
+    else result.skipped++
+  }
+
+  // dist/*
+  const distSrc = join(srcDir, 'dist')
+  if (existsSync(distSrc)) {
+    for (const f of readdirSync(distSrc)) {
+      const content = readFileSync(join(distSrc, f), 'utf8')
+      if (writeIfChanged(join(dstDir, 'dist', f), content)) result.created++
+      else result.skipped++
+    }
+  }
+
+  // package.json
+  const pkgSrc = join(srcDir, 'package.json')
+  if (existsSync(pkgSrc)) {
+    const content = readFileSync(pkgSrc, 'utf8')
+    if (writeIfChanged(join(dstDir, 'package.json'), content)) result.created++
+    else result.skipped++
+  }
+
+  return result
+}
+
+// ── Main ───────────────────────────────────────────────────────────────
+
+try {
+  const configDir = resolveConfigDir()
+  if (!configDir) {
+    // User hasn't run init yet — silent exit, no error
+    process.exit(0)
+  }
+
+  const tuiCopyDir = join(configDir, 'plugins', 'pantheon-tui')
+  if (!existsSync(tuiCopyDir)) {
+    // TUI plugin not installed — silent exit
+    process.exit(0)
+  }
+
+  // Source: TUI plugin inside the installed package
+  const tuiSrcDir = join(ROOT, 'src', 'plugins', 'tui')
+  if (!existsSync(tuiSrcDir)) {
+    // Source not found (shouldn't happen in a proper install)
+    process.exit(0)
+  }
+
+  // Compare versions before copy
+  const installedVersion = readVersion(join(tuiCopyDir, 'package.json'))
+  const sourceVersion = readVersion(join(tuiSrcDir, 'package.json'))
+
+  // Copy fresh files
+  const { created, skipped } = copyPluginFiles(tuiSrcDir, tuiCopyDir)
+
+  // Refresh dependencies in the copy
+  try {
+    execSync('npm install --omit=dev --no-audit', { cwd: tuiCopyDir, stdio: 'pipe' })
+  } catch {
+    // Non-fatal — deps may already be current
+  }
+
+  // Log result
+  if (installedVersion && sourceVersion && installedVersion === sourceVersion && created === 0) {
+    console.log(`  TUI plugin already up to date (v${sourceVersion})`)
+  } else {
+    console.log(
+      `  TUI plugin updated to v${sourceVersion || 'latest'}${installedVersion ? ` (was v${installedVersion})` : ''}`,
+    )
+  }
+} catch (err) {
+  // Postinstall scripts must never break npm install
+  console.warn(`⚠️  TUI sync skipped: ${err.message}`)
+  process.exit(0)
+}

package/scripts/uninstall.mjs

@@ -37,13 +37,11 @@ const PANTHEON_AGENT_NAMES = [
   'prometheus',
   'hephaestus',
 
-
   'nyx',
   'gaia',
   'iris',
   'mnemosyne',
   'talos',
-
 ]
 
 const PLATFORM_LABELS = {

package/scripts/validation-policy.mjs

@@ -1,5 +1,10 @@
 /** Status/exit policy shared by installation validation and its tests. */
-export const VALIDATION_STATUS = Object.freeze({ PASS: 'PASS', WARN: 'WARN', ERROR: 'ERROR', SKIP: 'SKIP' })
+export const VALIDATION_STATUS = Object.freeze({
+  PASS: 'PASS',
+  WARN: 'WARN',
+  ERROR: 'ERROR',
+  SKIP: 'SKIP',
+})
 
 export function classifyDoctorExit(exitStatus, output = '') {
   if (exitStatus === 0) return VALIDATION_STATUS.PASS

package/scripts/version-check.mjs

@@ -26,7 +26,11 @@ import { fileURLToPath, pathToFileURL } from 'node:url'
 export const MANIFESTS = [
   { name: 'pyproject.toml', file: 'pyproject.toml', kind: 'toml' },
   { name: 'plugin.json', file: 'plugin.json', kind: 'json' },
-  { name: 'src/plugins/tui/package.json', file: join('src', 'plugins', 'tui', 'package.json'), kind: 'json' },
+  {
+    name: 'src/plugins/tui/package.json',
+    file: join('src', 'plugins', 'tui', 'package.json'),
+    kind: 'json',
+  },
 ]
 
 function readTomlVersion(filePath) {
@@ -109,8 +113,7 @@ function printDivergenceTable(result) {
   console.log('')
 }
 
-const isDirectRun =
-  process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href
+const isDirectRun = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href
 
 if (isDirectRun) {
   // npm scripts run from the package root, so the working directory is the
@@ -138,7 +141,9 @@ if (isDirectRun) {
       console.log(`✓ Synced ${changed} manifest(s) to v${after.source}`)
       process.exit(0)
     }
-    console.error(`version-check: sync incomplete — ${after.manifests.filter((m) => !m.ok).length} manifest(s) still divergent`)
+    console.error(
+      `version-check: sync incomplete — ${after.manifests.filter((m) => !m.ok).length} manifest(s) still divergent`,
+    )
     process.exit(1)
   }
   console.error('version-check: manifests out of sync (run with --fix to sync)')

package/src/agents/aphrodite.md

@@ -14,7 +14,7 @@ permission:
   task:
     "*": deny
 temperature: 0.3
-steps: 50
+steps: 70
 skills:
   - tdd-with-agents
   - visual-review-pipeline

package/src/agents/demeter.md

@@ -12,7 +12,7 @@ permission:
   task:
     "*": deny
 temperature: 0.2
-steps: 40
+steps: 60
 skills:
   - tdd-with-agents
   - incremental-implementation

package/src/agents/hephaestus.md

@@ -12,7 +12,7 @@ permission:
   task:
     "*": deny
 temperature: 0.3
-steps: 40
+steps: 60
 skills:
   - tdd-with-agents
   - auto-continue

package/src/agents/hermes.md

@@ -11,7 +11,7 @@ mcp_tools:
   pantheon-memory: [memory_search]
   pantheon-code-mode: [execute_code_script]
 temperature: 0.3
-steps: 50
+steps: 70
 skills:
   - tdd-with-agents
   - file-prompts

package/src/agents/themis.md

@@ -97,6 +97,10 @@ Verificacoes rapidas de estilo e sanidade:
 - [ ] Formatacao consistente (mesmo style guide)
 - [ ] Nomes de variaveis/funcoes descritivos
 - [ ] Comentarios TODO ou FIXME sem resolucao
+- [ ] Comment Checker: codigo gerado indistinguivel de humano
+      - Flag comentarios obvios/excessivos (ex: `// increment i`, `# set x to 5`)
+      - Flag codigo morto comentado (blocos inteiros desativados)
+      - Flag cabecalhos boilerplate (autor/data/licenca repetitivos)
 
 Tempo estimado: ~10% do esforco de review