atris 3.0.1 → 3.2.0

package/lib/scorecard.js

@@ -0,0 +1,301 @@
+const fs = require('fs');
+const path = require('path');
+const { parseTodo } = require('./todo');
+
+const PRIVATE_MEMORY_ROOT = '.atris/presidio';
+
+function ensurePrivateMemoryDir(atrisDir) {
+  const privateDir = path.join(path.dirname(atrisDir), PRIVATE_MEMORY_ROOT);
+  fs.mkdirSync(privateDir, { recursive: true });
+  return privateDir;
+}
+
+function getScorecardsPath(atrisDir) {
+  return path.join(ensurePrivateMemoryDir(atrisDir), 'scorecards.md');
+}
+
+function parsePickedAt(value) {
+  if (!value) return null;
+  const match = String(value).trim().match(/^(\d{4}-\d{2}-\d{2})(?:\s+(\d{2}:\d{2}))?/);
+  if (!match) return null;
+
+  const [, datePart, timePart = '00:00'] = match;
+  const parsed = new Date(`${datePart}T${timePart}:00`);
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+
+function parseTickDate(dateStr, timeLabel) {
+  const match = String(timeLabel || '').trim().toLowerCase().match(/^(\d{1,2}):(\d{2})(?:\s*(am|pm))?$/);
+  if (!match) return null;
+
+  let hours = parseInt(match[1], 10);
+  const minutes = parseInt(match[2], 10);
+  const meridiem = match[3] || null;
+
+  if (meridiem === 'pm' && hours !== 12) hours += 12;
+  if (meridiem === 'am' && hours === 12) hours = 0;
+
+  const parsed = new Date(`${dateStr}T00:00:00`);
+  parsed.setHours(hours, minutes, 0, 0);
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+
+function listLogFiles(atrisDir, startDate, endDate = new Date()) {
+  const logsDir = path.join(atrisDir, 'logs');
+  if (!fs.existsSync(logsDir)) return [];
+
+  const startKey = startDate.toISOString().slice(0, 10);
+  const endKey = endDate.toISOString().slice(0, 10);
+  const files = [];
+
+  for (const year of fs.readdirSync(logsDir)) {
+    const yearDir = path.join(logsDir, year);
+    let stat;
+    try {
+      stat = fs.statSync(yearDir);
+    } catch {
+      continue;
+    }
+    if (!stat.isDirectory()) continue;
+
+    for (const entry of fs.readdirSync(yearDir)) {
+      if (!entry.endsWith('.md')) continue;
+      const dateKey = entry.replace(/\.md$/, '');
+      if (dateKey < startKey || dateKey > endKey) continue;
+      files.push({ dateKey, file: path.join(yearDir, entry) });
+    }
+  }
+
+  files.sort((a, b) => a.dateKey.localeCompare(b.dateKey));
+  return files;
+}
+
+function readNotesSection(content) {
+  const match = String(content || '').match(/## Notes\n([\s\S]*?)(?=\n##\s|$)/);
+  return match ? match[1] : '';
+}
+
+function collectRewardStats(atrisDir, pickedAt) {
+  const startAt = parsePickedAt(pickedAt);
+  if (!startAt) {
+    return { totalReward: 0, totalTicks: 0, haltedTicks: 0 };
+  }
+
+  let totalReward = 0;
+  let totalTicks = 0;
+  let haltedTicks = 0;
+
+  for (const { dateKey, file } of listLogFiles(atrisDir, startAt)) {
+    const notes = readNotesSection(fs.readFileSync(file, 'utf8'));
+    if (!notes) continue;
+
+    const lines = notes.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+      const headerMatch = lines[i].match(/^- (\d{1,2}:\d{2}(?:\s*[ap]m)?)$/i);
+      if (!headerMatch) continue;
+
+      const tickAt = parseTickDate(dateKey, headerMatch[1]);
+      if (!tickAt || tickAt < startAt) continue;
+
+      let reward = null;
+      let halted = false;
+      let j = i + 1;
+      for (; j < lines.length; j++) {
+        const current = lines[j];
+        if (j > i + 1 && /^- (\d{1,2}:\d{2}(?:\s*[ap]m)?)$/i.test(current)) break;
+        if (current && !current.startsWith('  ')) break;
+
+        const trimmed = current.trim();
+        if (!trimmed) continue;
+        if (/^Reward:\s*-?\d+$/i.test(trimmed)) {
+          reward = parseInt(trimmed.replace(/^Reward:\s*/i, ''), 10);
+        }
+        if (/review flagged issues|verify failed|hit an error|stopped for a manual check/i.test(trimmed)) {
+          halted = true;
+        }
+      }
+
+      if (reward !== null) {
+        totalReward += reward;
+        totalTicks += 1;
+        if (halted) haltedTicks += 1;
+      }
+
+      i = j - 1;
+    }
+  }
+
+  return { totalReward, totalTicks, haltedTicks };
+}
+
+function countLessonsGenerated(atrisDir, pickedAt) {
+  const startAt = parsePickedAt(pickedAt);
+  if (!startAt) return 0;
+
+  const lessonsPath = path.join(atrisDir, 'lessons.md');
+  if (!fs.existsSync(lessonsPath)) return 0;
+
+  const startDateKey = startAt.toISOString().slice(0, 10);
+  return fs.readFileSync(lessonsPath, 'utf8')
+    .split('\n')
+    .reduce((count, line) => {
+      const match = line.match(/^- \*\*\[(\d{4}-\d{2}-\d{2})\]/);
+      return match && match[1] >= startDateKey ? count + 1 : count;
+    }, 0);
+}
+
+function buildScorecardData(atrisDir, { slug, pickedAt } = {}) {
+  if (!slug) {
+    throw new Error('Scorecard: slug is required');
+  }
+
+  const todoPath = path.join(atrisDir, 'TODO.md');
+  const todo = parseTodo(todoPath);
+  const startAt = parsePickedAt(pickedAt) || new Date();
+  const rewardStats = collectRewardStats(atrisDir, pickedAt);
+  const completedEndgame = todo.completed.filter(t => t.tag === 'endgame').length;
+  const activeEndgame = todo.backlog.filter(t => t.tag === 'endgame').length
+    + todo.inProgress.filter(t => t.tag === 'endgame').length;
+
+  return {
+    slug,
+    startDate: startAt.toISOString().slice(0, 10),
+    endDate: new Date().toISOString().slice(0, 10),
+    tasksShipped: completedEndgame,
+    tasksAttempted: completedEndgame + activeEndgame,
+    wallClockHours: Math.max(0, (Date.now() - startAt.getTime()) / (1000 * 60 * 60)),
+    haltRatio: rewardStats.totalTicks > 0 ? rewardStats.haltedTicks / rewardStats.totalTicks : 0,
+    totalReward: rewardStats.totalReward,
+    lessonsGenerated: countLessonsGenerated(atrisDir, pickedAt),
+  };
+}
+
+/**
+ * Write a scorecard when an endgame closes.
+ *
+ * @param {string} atrisDir - Path to atris/ directory
+ * @param {object} data - Scorecard data
+ *   - slug: endgame slug (e.g., "loop-self-seeds-horizons")
+ *   - startDate: ISO date when endgame started
+ *   - endDate: ISO date when endgame ended (default: today)
+ *   - tasksShipped: number of tasks completed
+ *   - tasksAttempted: number of tasks started
+ *   - wallClockHours: total hours (float)
+ *   - haltRatio: fraction of ticks that halted (e.g., 0.1)
+ *   - totalReward: sum of per-tick reward scores
+ *   - lessonsGenerated: number of lessons appended to lessons.md
+ */
+function writeScorecard(atrisDir, data) {
+  const {
+    slug,
+    startDate,
+    endDate = new Date().toISOString().split('T')[0],
+    tasksShipped = 0,
+    tasksAttempted = 0,
+    wallClockHours = 0,
+    haltRatio = 0,
+    totalReward = 0,
+    lessonsGenerated = 0,
+  } = data;
+
+  // Validate required fields
+  if (!slug) {
+    throw new Error('Scorecard: slug is required');
+  }
+
+  const scorecardsPath = getScorecardsPath(atrisDir);
+
+  // Ensure scorecards.md exists
+  if (!fs.existsSync(scorecardsPath)) {
+    const template = `# scorecards.md — Endgame Results\n\n> Append-only. One line per closed endgame. Records outcome metrics from the horizon.\n\n---\n\n`;
+    fs.writeFileSync(scorecardsPath, template, 'utf8');
+  }
+
+  // Format: - **[date] slug** — shipped: X/Y — wall-clock: Nh — halt: Z% — reward: total — lessons: N
+  const haltPercent = Math.round(haltRatio * 100);
+  const wallClockStr = wallClockHours < 1 ? `${Math.round(wallClockHours * 60)}m` : `${wallClockHours.toFixed(1)}h`;
+  const line = `- **[${endDate}] ${slug}** — shipped: ${tasksShipped}/${tasksAttempted} — wall-clock: ${wallClockStr} — halt: ${haltPercent}% — reward: ${totalReward} — lessons: ${lessonsGenerated}\n`;
+
+  // Append to file
+  fs.appendFileSync(scorecardsPath, line, 'utf8');
+}
+
+/**
+ * Detect if the current endgame in TODO.md is complete (all endgame tasks in Completed).
+ * Returns { complete: boolean, endgameSlug: string | null }
+ */
+function detectEndgameCompletion(atrisDir) {
+  const todoPath = path.join(atrisDir, 'TODO.md');
+  if (!fs.existsSync(todoPath)) {
+    return { complete: false, endgameSlug: null };
+  }
+
+  const todo = parseTodo(todoPath);
+
+  // Find the current endgame section
+  const endgameSectionMatch = fs.readFileSync(todoPath, 'utf8')
+    .match(/## Endgame\n\n\*\*Slug:\*\*\s*(\S+)/);
+
+  if (!endgameSectionMatch) {
+    return { complete: false, endgameSlug: null };
+  }
+
+  const slug = endgameSectionMatch[1];
+
+  // Check if there are any endgame-tagged tasks in backlog or in-progress
+  const hasActiveEndgame = todo.backlog.some(t => t.tag === 'endgame')
+    || todo.inProgress.some(t => t.tag === 'endgame');
+
+  return {
+    complete: !hasActiveEndgame,
+    endgameSlug: slug,
+  };
+}
+
+/**
+ * Parse scorecards.md and return array of scorecard objects.
+ */
+function readScorecards(atrisDir) {
+  const scorecardsPath = getScorecardsPath(atrisDir);
+  if (!fs.existsSync(scorecardsPath)) return [];
+
+  const content = fs.readFileSync(scorecardsPath, 'utf8');
+  const scorecards = [];
+
+  for (const line of content.split('\n')) {
+    const match = line.match(/^- \*\*\[(.+?)\]\s+(.+?)\*\*\s*—\s*shipped:\s*(\d+)\/(\d+)\s*—\s*wall-clock:\s*(.+?)\s*—\s*halt:\s*(\d+)%\s*—\s*reward:\s*(\d+)\s*—\s*lessons:\s*(\d+)$/);
+    if (!match) continue;
+
+    const [, endDate, slug, shipped, attempted, wallClockStr, haltPercent, reward, lessons] = match;
+
+    // Parse wall-clock back to hours
+    let wallClockHours = 0;
+    if (wallClockStr.endsWith('h')) {
+      wallClockHours = parseFloat(wallClockStr);
+    } else if (wallClockStr.endsWith('m')) {
+      wallClockHours = parseInt(wallClockStr) / 60;
+    }
+
+    scorecards.push({
+      endDate,
+      slug,
+      tasksShipped: parseInt(shipped),
+      tasksAttempted: parseInt(attempted),
+      wallClockHours,
+      haltRatio: parseInt(haltPercent) / 100,
+      totalReward: parseInt(reward),
+      lessonsGenerated: parseInt(lessons),
+    });
+  }
+
+  return scorecards;
+}
+
+module.exports = {
+  PRIVATE_MEMORY_ROOT,
+  getScorecardsPath,
+  buildScorecardData,
+  writeScorecard,
+  readScorecards,
+  detectEndgameCompletion,
+};

package/lib/todo.js

@@ -33,8 +33,8 @@ function parseSection(content, sectionName) {
     const line = rawLine.trimEnd();
 
     // New task line: - **T1:** Description or - **T1a:** Description [tag] [tag]
-    // Accepts task IDs like T1, W3b, M12c — single uppercase letter, digits, optional trailing lowercase letter.
-    const taskMatch = line.match(/^- \*\*([A-Z]\d+[a-z]?):\*\*\s*(.+)$/);
+    // Accepts task IDs like T1, W3b, M12c, R1, T#1 — letter(s), optional symbols, digits, optional trailing letter.
+    const taskMatch = line.match(/^- \*\*([A-Za-z][A-Za-z0-9#]*\d[a-z]?):\*\*\s*(.+)$/);
     if (taskMatch) {
       if (current) tasks.push(current);
       // Capture ALL bracketed tags in the line, not just the last one. Endgame is priority.
@@ -47,6 +47,7 @@ function parseSection(content, sectionName) {
         tags: allTags,
         claimed: null,
         stage: null,
+        verify: null,
       };
       continue;
     }
@@ -60,6 +61,7 @@ function parseSection(content, sectionName) {
         tag: null,
         claimed: null,
         stage: null,
+        verify: null,
       });
       continue;
     }
@@ -73,6 +75,7 @@ function parseSection(content, sectionName) {
         tag: null,
         claimed: null,
         stage: null,
+        verify: null,
       });
       continue;
     }
@@ -92,6 +95,13 @@ function parseSection(content, sectionName) {
       current.stage = stageMatch[1].trim();
       continue;
     }
+
+    // Verify line
+    const verifyMatch = line.match(/\*\*Verify:\*\*\s*(.+)$/) || line.match(/Verify:\s*(.+)$/);
+    if (verifyMatch) {
+      current.verify = verifyMatch[1].trim();
+      continue;
+    }
   }
 
   if (current) tasks.push(current);

package/lib/wiki.js

@@ -2,6 +2,7 @@ const fs = require('fs');
 const path = require('path');
 
 const WIKI_ROOT = 'atris/wiki';
+const PRIVATE_WIKI_ROOT = '.atris/presidio';
 const LEGACY_WIKI_ROOT = 'wiki';
 const WIKI_BRIEFS_SUBDIR = 'briefs';
 const LEGACY_WIKI_BRIEFS_SUBDIR = 'syntheses';
@@ -9,6 +10,14 @@ const WIKI_SUBDIRS = ['people', 'systems', 'concepts', WIKI_BRIEFS_SUBDIR];
 const WIKI_STATUS_FILE = 'STATUS.md';
 const WIKI_CONTENT_SUBDIRS = WIKI_SUBDIRS.map((subdir) => path.join(WIKI_ROOT, subdir));
 
+function getWikiRoot(mode = 'public') {
+  return mode === 'private' ? PRIVATE_WIKI_ROOT : WIKI_ROOT;
+}
+
+function getWikiLinkRoot(mode = 'public') {
+  return mode === 'private' ? PRIVATE_WIKI_ROOT : 'atris/wiki';
+}
+
 function today() {
   return new Date().toISOString().slice(0, 10);
 }
@@ -17,10 +26,12 @@ function nowTime() {
   return new Date().toTimeString().slice(0, 5);
 }
 
-function protocolMarkdown() {
+function protocolMarkdown(mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
+  const wikiLinkRoot = getWikiLinkRoot(mode);
   return `# Atris Wiki Protocol
 
-This wiki lives in \`${WIKI_ROOT}/\`.
+This wiki lives in \`${wikiRoot}/\`.
 
 ## Purpose
 
@@ -28,20 +39,20 @@ Turn raw project context into a living memory the next agent can pick up cold.
 
 ## Shape
 
-- \`${WIKI_ROOT}/wiki.md\` - this protocol
-- \`${WIKI_ROOT}/index.md\` - catalog grouped by page type
-- \`${WIKI_ROOT}/log.md\` - append-only ingest and lint history
-- \`${WIKI_ROOT}/STATUS.md\` - plain-English health summary
-- \`${WIKI_ROOT}/people/\` - humans (employees, contacts, stakeholders)
-- \`${WIKI_ROOT}/systems/\` - tools, tables, dashboards, services, products
-- \`${WIKI_ROOT}/concepts/\` - patterns, frameworks, recurring ideas
-- \`${WIKI_ROOT}/${WIKI_BRIEFS_SUBDIR}/\` - multi-page briefs and cross-cutting analysis
+- \`${wikiRoot}/wiki.md\` - this protocol
+- \`${wikiRoot}/index.md\` - catalog grouped by page type
+- \`${wikiRoot}/log.md\` - append-only ingest and lint history
+- \`${wikiRoot}/STATUS.md\` - plain-English health summary
+- \`${wikiRoot}/people/\` - humans (employees, contacts, stakeholders)
+- \`${wikiRoot}/systems/\` - tools, tables, dashboards, services, products
+- \`${wikiRoot}/concepts/\` - patterns, frameworks, recurring ideas
+- \`${wikiRoot}/${WIKI_BRIEFS_SUBDIR}/\` - multi-page briefs and cross-cutting analysis
 
 ## Rules
 
 - Read the full source before writing.
 - Merge new facts into existing pages. Do not overwrite history blindly.
-- Add cross-references with \`[[atris/wiki/...]]\` links.
+- Add cross-references with \`[[${wikiLinkRoot}/...]]\` links.
 - Keep \`index.md\`, \`log.md\`, and \`STATUS.md\` in sync with page changes.
 - If something is unclear or contradictory, say so directly.
 `;
@@ -155,15 +166,18 @@ function migrateLegacyBriefsDir(wikiDir) {
   rewriteLegacyWikiReferences(wikiDir);
 }
 
-function ensureWikiScaffold(projectRoot = process.cwd()) {
-  const wikiDir = path.join(projectRoot, WIKI_ROOT);
+function ensureWikiScaffold(projectRoot = process.cwd(), mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
+  const wikiDir = path.join(projectRoot, wikiRoot);
   fs.mkdirSync(wikiDir, { recursive: true });
-  migrateLegacyBriefsDir(wikiDir);
+  if (mode === 'public') {
+    migrateLegacyBriefsDir(wikiDir);
+  }
   for (const subdir of WIKI_SUBDIRS) {
     fs.mkdirSync(path.join(wikiDir, subdir), { recursive: true });
   }
 
-  ensureFile(path.join(wikiDir, 'wiki.md'), protocolMarkdown());
+  ensureFile(path.join(wikiDir, 'wiki.md'), protocolMarkdown(mode));
   ensureFile(path.join(wikiDir, 'index.md'), indexMarkdown());
   ensureFile(path.join(wikiDir, 'log.md'), logMarkdown());
   ensureFile(path.join(wikiDir, WIKI_STATUS_FILE), statusMarkdown());
@@ -171,7 +185,12 @@ function ensureWikiScaffold(projectRoot = process.cwd()) {
   return wikiDir;
 }
 
-function findLocalWikiDir(projectRoot = process.cwd(), slug = null) {
+function findLocalWikiDir(projectRoot = process.cwd(), slug = null, mode = 'public') {
+  if (mode === 'private') {
+    const privateDir = path.join(projectRoot, PRIVATE_WIKI_ROOT);
+    return fs.existsSync(privateDir) ? privateDir : null;
+  }
+
   const tries = [
     path.join(projectRoot, WIKI_ROOT),
     path.join(projectRoot, LEGACY_WIKI_ROOT),
@@ -190,8 +209,8 @@ function normalizeWikiOnlyPrefix(prefix) {
   return null;
 }
 
-function readWikiStatus(projectRoot = process.cwd(), slug = null) {
-  const wikiDir = findLocalWikiDir(projectRoot, slug);
+function readWikiStatus(projectRoot = process.cwd(), slug = null, mode = 'public') {
+  const wikiDir = findLocalWikiDir(projectRoot, slug, mode);
   if (!wikiDir) return null;
 
   const statusPath = path.join(wikiDir, WIKI_STATUS_FILE);
@@ -275,8 +294,9 @@ function parseFrontmatter(content) {
   return frontmatter;
 }
 
-function readWikiPages(projectRoot = process.cwd()) {
-  const wikiDir = path.join(projectRoot, WIKI_ROOT);
+function readWikiPages(projectRoot = process.cwd(), mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
+  const wikiDir = path.join(projectRoot, wikiRoot);
   const pages = [];
 
   for (const subdir of WIKI_SUBDIRS) {
@@ -302,8 +322,8 @@ function normalizeSourcePath(projectRoot, source) {
   return path.normalize(path.join(projectRoot, source));
 }
 
-function findStaleWikiPages(projectRoot = process.cwd()) {
-  return readWikiPages(projectRoot)
+function findStaleWikiPages(projectRoot = process.cwd(), mode = 'public') {
+  return readWikiPages(projectRoot, mode)
     .map((page) => {
       const sources = Array.isArray(page.frontmatter.sources) ? page.frontmatter.sources : [];
       if (sources.length === 0) return null;
@@ -345,13 +365,14 @@ function findStaleWikiPages(projectRoot = process.cwd()) {
 }
 
 function extractWikiLinks(content) {
-  const matches = content.match(/\[\[(atris\/wiki\/[^\]]+?)\]\]/g) || [];
+  const matches = content.match(/\[\[((?:atris\/wiki|\.atris\/presidio)\/[^\]]+?)\]\]/g) || [];
   return matches.map((match) => match.slice(2, -2));
 }
 
-function findWikiOrphans(projectRoot = process.cwd()) {
-  const pages = readWikiPages(projectRoot);
-  const indexPath = path.join(projectRoot, WIKI_ROOT, 'index.md');
+function findWikiOrphans(projectRoot = process.cwd(), mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
+  const pages = readWikiPages(projectRoot, mode);
+  const indexPath = path.join(projectRoot, wikiRoot, 'index.md');
   const indexContent = fs.existsSync(indexPath) ? fs.readFileSync(indexPath, 'utf8') : '';
 
   const inboundLinks = new Map();
@@ -423,8 +444,8 @@ function parseStatusBullets(content) {
   return bullets;
 }
 
-function writeWikiStatus(projectRoot = process.cwd(), report) {
-  const wikiDir = ensureWikiScaffold(projectRoot);
+function writeWikiStatus(projectRoot = process.cwd(), report, mode = 'public') {
+  const wikiDir = ensureWikiScaffold(projectRoot, mode);
   const statusPath = path.join(wikiDir, WIKI_STATUS_FILE);
   const existing = fs.existsSync(statusPath) ? fs.readFileSync(statusPath, 'utf8') : '';
   const bullets = parseStatusBullets(existing);
@@ -444,8 +465,8 @@ function writeWikiStatus(projectRoot = process.cwd(), report) {
   return statusPath;
 }
 
-function appendWikiLog(projectRoot = process.cwd(), summary, details = []) {
-  const wikiDir = ensureWikiScaffold(projectRoot);
+function appendWikiLog(projectRoot = process.cwd(), summary, details = [], mode = 'public') {
+  const wikiDir = ensureWikiScaffold(projectRoot, mode);
   const logPath = path.join(wikiDir, 'log.md');
   let content = fs.existsSync(logPath) ? fs.readFileSync(logPath, 'utf8') : '# Atris Wiki Log\n';
   const dateHeader = `## ${today()}`;
@@ -471,17 +492,20 @@ function formatSourceList(sourceValue) {
     .join(', ');
 }
 
-const WIKI_SCHEMA = `The wiki lives in ${WIKI_ROOT}/.
+function buildWikiSchema(mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
+  const wikiLinkRoot = getWikiLinkRoot(mode);
+  return `The wiki lives in ${wikiRoot}/.
 
 Structure:
-- ${WIKI_ROOT}/wiki.md - protocol for future agents
-- ${WIKI_ROOT}/index.md - catalog grouped by type
-- ${WIKI_ROOT}/log.md - append-only activity log
-- ${WIKI_ROOT}/STATUS.md - plain-English health summary
-- ${WIKI_ROOT}/people/ - one page per human
-- ${WIKI_ROOT}/systems/ - one page per tool, table, dashboard, service, or product
-- ${WIKI_ROOT}/concepts/ - pattern and framework pages
-- ${WIKI_ROOT}/${WIKI_BRIEFS_SUBDIR}/ - cross-cutting briefs referencing 3+ pages
+- ${wikiRoot}/wiki.md - protocol for future agents
+- ${wikiRoot}/index.md - catalog grouped by type
+- ${wikiRoot}/log.md - append-only activity log
+- ${wikiRoot}/STATUS.md - plain-English health summary
+- ${wikiRoot}/people/ - one page per human
+- ${wikiRoot}/systems/ - one page per tool, table, dashboard, service, or product
+- ${wikiRoot}/concepts/ - pattern and framework pages
+- ${wikiRoot}/${WIKI_BRIEFS_SUBDIR}/ - cross-cutting briefs referencing 3+ pages
 
 Page format:
 ---
@@ -497,7 +521,7 @@ tags: [tag1, tag2]
 # Title
 Body in markdown.
 ## Cross-References
-- [[atris/wiki/people/related.md]] - why related
+- [[${wikiLinkRoot}/people/related.md]] - why related
 
 Rules:
 - Read every listed source fully before writing
@@ -505,20 +529,23 @@ Rules:
 - Keep index.md, log.md, and STATUS.md current
 - Flag contradictions directly instead of smoothing them over
 - Never modify the raw source documents you ingested`;
+}
 
-function buildIngestPrompt(sourceValue) {
+function buildIngestPrompt(sourceValue, mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
+  const wikiLinkRoot = getWikiLinkRoot(mode);
   return `Atris wiki ingest: ${formatSourceList(sourceValue)}
-${WIKI_SCHEMA}
+${buildWikiSchema(mode)}
 
 Workflow:
 1. Read every source in: ${sourceValue}
-2. Ensure ${WIKI_ROOT}/ exists with wiki.md, index.md, log.md, STATUS.md, and the 3 page subfolders
+2. Ensure ${wikiRoot}/ exists with wiki.md, index.md, log.md, STATUS.md, and the 3 page subfolders
 3. Extract people, systems, and concepts worth preserving
-4. Create or update pages under ${WIKI_ROOT}/, merging with existing facts instead of replacing them
-5. Add cross-references using [[atris/wiki/...]] links
-6. Update ${WIKI_ROOT}/index.md with one-line descriptions of touched pages
-7. Append an INGEST entry to ${WIKI_ROOT}/log.md under today's date
-8. Refresh ${WIKI_ROOT}/STATUS.md in plain English for a non-technical reader
+4. Create or update pages under ${wikiRoot}/, merging with existing facts instead of replacing them
+5. Add cross-references using [[${wikiLinkRoot}/...]] links
+6. Update ${wikiRoot}/index.md with one-line descriptions of touched pages
+7. Append an INGEST entry to ${wikiRoot}/log.md under today's date
+8. Refresh ${wikiRoot}/STATUS.md in plain English for a non-technical reader
 
 Quality bar:
 - Ask clarifying questions if the source is ambiguous
@@ -527,18 +554,20 @@ Quality bar:
 - Leave the wiki sharper than you found it`;
 }
 
-function buildQueryPrompt(question) {
+function buildQueryPrompt(question, mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
   return `Atris wiki query: ${question}
 
-Read ${WIKI_ROOT}/index.md first, then the most relevant pages.
-Answer from the wiki with direct references to page paths under ${WIKI_ROOT}/.
+Read ${wikiRoot}/index.md first, then the most relevant pages.
+Answer from the wiki with direct references to page paths under ${wikiRoot}/.
 If the answer reveals a reusable insight, offer to save it as a brief page.`;
 }
 
-function buildLintPrompt() {
+function buildLintPrompt(mode = 'public') {
+  const wikiRoot = getWikiRoot(mode);
   return `Atris wiki lint pass
 
-Read ${WIKI_ROOT}/index.md, crawl the referenced pages, and inspect the local wiki.
+Read ${wikiRoot}/index.md, crawl the referenced pages, and inspect the local wiki.
 
 Checks:
 1. Every page referenced by index.md exists
@@ -546,8 +575,8 @@ Checks:
 3. Orphan pages are listed
 4. Contradictions are called out plainly
 5. Gaps worth ingesting next are listed concretely
-6. ${WIKI_ROOT}/STATUS.md is rewritten in plain English
-7. ${WIKI_ROOT}/log.md gets a LINT entry under today's date
+6. ${wikiRoot}/STATUS.md is rewritten in plain English
+7. ${wikiRoot}/log.md gets a LINT entry under today's date
 
 Output:
 - Clear summary for a non-technical reader
@@ -557,11 +586,13 @@ Output:
 
 module.exports = {
   WIKI_ROOT,
+  PRIVATE_WIKI_ROOT,
   LEGACY_WIKI_ROOT,
   WIKI_SUBDIRS,
   WIKI_CONTENT_SUBDIRS,
-  WIKI_SCHEMA,
+  WIKI_SCHEMA: buildWikiSchema(),
   WIKI_STATUS_FILE,
+  getWikiRoot,
   ensureWikiScaffold,
   findLocalWikiDir,
   normalizeWikiOnlyPrefix,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "3.0.1",
+  "version": "3.2.0",
   "description": "Atris — an operating system for intelligence. Integrates with any agent.",
   "main": "bin/atris.js",
   "bin": {
@@ -32,7 +32,8 @@
     "atris/skills/"
   ],
   "scripts": {
-    "test": "node --test"
+    "test": "node --test",
+    "prepare": "cp scripts/pre-commit .git/hooks/pre-commit 2>/dev/null && chmod +x .git/hooks/pre-commit || true"
   },
   "keywords": [
     "atrisdev",