@cccarv82/freya 2.1.6 → 2.2.0

package/.agent/rules/freya/freya.mdc

@@ -35,3 +35,11 @@ Como posso ajudar você hoje?
 [4] General Assistance
 ```
 </menu-display>
+
+## Registro Padrao
+
+- Logs diarios (raw input, notas cronologicas): `logs/daily/YYYY-MM-DD.md`
+- Dados estruturados (status, tarefas, carreira): `data/**`
+- Sintese e navegacao (hubs, reports): `docs/**`
+
+Regra: nunca gravar logs diarios em data/ ou docs/. Nunca gravar dados estruturados em logs/.

package/cli/init.js

@@ -81,7 +81,7 @@ function ensurePackageJson(targetDir, force, summary) {
   const existing = readJsonSafe(pkgPath);
 
   const scriptsToEnsure = {
-    health: 'node scripts/validate-data.js',
+    health: 'node scripts/validate-data.js && node scripts/validate-structure.js',
     migrate: 'node scripts/migrate-data.js',
     report: 'node scripts/generate-weekly-report.js',
     'sm-weekly': 'node scripts/generate-sm-weekly-report.js',

package/cli/web-ui.js

@@ -656,6 +656,48 @@
       grid.appendChild(card);    }
   }
 
+  function renderProjects() {
+    const el = $('projectsGrid');
+    if (!el) return;
+    const filter = String(($('projectsFilter') && $('projectsFilter').value) || '').toLowerCase();
+    const items = Array.isArray(state.projects) ? state.projects : [];
+    const filtered = items.filter((p) => {
+      const hay = [p.client, p.program, p.stream, p.project, p.slug, (p.tags||[]).join(' ')].join(' ').toLowerCase();
+      return !filter || hay.includes(filter);
+    });
+    el.innerHTML = '';
+    for (const p of filtered) {
+      const card = document.createElement('div');
+      card.className = 'reportCard';
+      card.innerHTML = '<div class="reportHead">'
+        + '<div><div class="reportTitle">' + escapeHtml(p.project || p.slug || 'Projeto') + '</div>'
+        + '<div class="reportMeta">' + escapeHtml([p.client, p.program, p.stream].filter(Boolean).join(' · ')) + '</div></div>'
+        + '<div class="reportActions">' + (p.active ? '<span class="pill ok">ativo</span>' : '<span class="pill warn">inativo</span>') + '</div>'
+        + '</div>'
+        + '<div class="help" style="margin-top:8px">' + escapeHtml(p.currentStatus || 'Sem status') + '</div>'
+        + '<div class="reportMeta" style="margin-top:8px">Última atualização: ' + escapeHtml(p.lastUpdated || '—') + '</div>'
+        + '<div class="reportMeta">Eventos: ' + escapeHtml(String(p.historyCount || 0)) + '</div>';
+      el.appendChild(card);
+    }
+    if (!filtered.length) {
+      const empty = document.createElement('div');
+      empty.className = 'help';
+      empty.textContent = 'Nenhum projeto encontrado.';
+      el.appendChild(empty);
+    }
+  }
+
+  async function refreshProjects() {
+    try {
+      const r = await api('/api/projects/list', { dir: dirOrDefault() });
+      state.projects = r.projects || [];
+      renderProjects();
+    } catch (e) {
+      const el = $('projectsGrid');
+      if (el) el.textContent = 'Falha ao carregar projetos.';
+    }
+  }
+
   async function refreshReportsPage() {
     try {
       setPill('run', 'carregando…');
@@ -680,6 +722,7 @@
   function wireRailNav() {
     const dash = $('railDashboard');
     const rep = $('railReports');
+    const proj = $('railProjects');
     const health = $('railCompanion');
     if (dash) {
       dash.onclick = () => {
@@ -698,6 +741,12 @@
         if (!isReports) window.location.href = '/reports';
       };
     }
+    if (proj) {
+      proj.onclick = () => {
+        const isProjects = document.body && document.body.dataset && document.body.dataset.page === 'projects';
+        if (!isProjects) window.location.href = '/projects';
+      };
+    }
     if (health) {
       health.onclick = () => {
         const isHealth = document.body && document.body.dataset && document.body.dataset.page === 'companion';
@@ -1314,6 +1363,7 @@
   } catch {}
 
   const isReportsPage = document.body && document.body.dataset && document.body.dataset.page === 'reports';
+  const isProjectsPage = document.body && document.body.dataset && document.body.dataset.page === 'projects';
   const isCompanionPage = document.body && document.body.dataset && document.body.dataset.page === 'companion';
 
   // Load persisted settings from the workspace + bootstrap (auto-init + auto-health)
@@ -1342,6 +1392,11 @@
       return;
     }
 
+    if (isProjectsPage) {
+      await refreshProjects();
+      return;
+    }
+
     if (isCompanionPage) {
       await refreshHealthChecklist();
       return;
@@ -1385,6 +1440,7 @@
   window.renderReportsList = renderReportsList;
   window.renderReportsPage = renderReportsPage;
   window.refreshReportsPage = refreshReportsPage;
+  window.refreshProjects = refreshProjects;
   window.refreshBlockersInsights = refreshBlockersInsights;
   window.refreshHealthChecklist = refreshHealthChecklist;
   window.copyOut = copyOut;

package/cli/web.js

@@ -905,6 +905,7 @@ function buildHtml(safeDefault, appVersion) {
             <button class="railBtn active" id="railDashboard" type="button" title="Dashboard">D</button>
             <button class="railBtn" id="railReports" type="button" title="Relatórios">R</button>
             <button class="railBtn" id="railCompanion" type="button" title="Companion">C</button>
+                      <button class="railBtn" id="railProjects" type="button" title="Projects">P</button>
           </div>
           <div class="railBottom">
             <div class="railStatus" id="railStatus" title="status"></div>
@@ -1155,6 +1156,7 @@ function buildReportsHtml(safeDefault, appVersion) {
             <button class="railBtn" id="railDashboard" type="button" title="Dashboard">D</button>
             <button class="railBtn active" id="railReports" type="button" title="Relatórios">R</button>
             <button class="railBtn" id="railCompanion" type="button" title="Companion">C</button>
+                      <button class="railBtn" id="railProjects" type="button" title="Projects">P</button>
           </div>
           <div class="railBottom">
             <div class="railStatus" id="railStatus" title="status"></div>
@@ -1209,6 +1211,84 @@ function buildReportsHtml(safeDefault, appVersion) {
 </html>`
 }
 
+function buildProjectsHtml(safeDefault, appVersion) {
+  const safeVersion = escapeHtml(appVersion || 'unknown');
+  return `<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Projects</title>
+  <link rel="stylesheet" href="/app.css" />
+</head>
+<body data-page="projects">
+  <div class="app">
+    <div class="frame">
+      <div class="shell">
+
+        <aside class="rail">
+          <div class="railTop">
+            <div class="railLogo">F</div>
+          </div>
+          <div class="railNav">
+            <button class="railBtn" id="railDashboard" type="button" title="Dashboard">D</button>
+            <button class="railBtn" id="railReports" type="button" title="Relatorios">R</button>
+            <button class="railBtn" id="railCompanion" type="button" title="Companion">C</button>
+            <button class="railBtn active" id="railProjects" type="button" title="Projects">P</button>
+          </div>
+          <div class="railBottom">
+            <div class="railStatus" id="railStatus" title="status"></div>
+          </div>
+        </aside>
+
+        <main class="center reportsPage" id="projectsPage">
+          <div class="topbar">
+            <div class="brandLine">
+              <span class="spark"></span>
+              <div class="brandStack">
+                <div class="brand">FREYA</div>
+                <div class="brandSub">Projects</div>
+              </div>
+            </div>
+            <div class="topActions">
+              <span class="chip" id="chipVersion">v${safeVersion}</span>
+              <span class="chip" id="chipPort">127.0.0.1:3872</span>
+            </div>
+          </div>
+
+          <div class="centerBody">
+            <input id="dir" type="hidden" />
+
+            <section class="reportsHeader">
+              <div>
+                <div class="reportsTitle">Projects</div>
+                <div class="reportsSubtitle">Status por projeto com ultima atualizacao e riscos.</div>
+              </div>
+              <div class="reportsActions">
+                <button class="btn small" type="button" onclick="refreshProjects()">Atualizar</button>
+              </div>
+            </section>
+
+            <section class="reportsTools">
+              <input id="projectsFilter" placeholder="filtrar (cliente, projeto, tag)" oninput="renderProjects()" />
+            </section>
+
+            <section class="reportsGrid" id="projectsGrid"></section>
+          </div>
+        </main>
+
+      </div>
+    </div>
+  </div>
+
+  <script>
+    window.__FREYA_DEFAULT_DIR = "${safeDefault}";
+  </script>
+  <script src="/app.js"></script>
+</body>
+</html>`;
+}
+
 function buildCompanionHtml(safeDefault, appVersion) {
   const safeVersion = escapeHtml(appVersion || 'unknown');
   return `<!doctype html>
@@ -1232,6 +1312,7 @@ function buildCompanionHtml(safeDefault, appVersion) {
             <button class="railBtn" id="railDashboard" type="button" title="Dashboard">D</button>
             <button class="railBtn" id="railReports" type="button" title="Relatórios">R</button>
             <button class="railBtn active" id="railCompanion" type="button" title="Companion">C</button>
+                      <button class="railBtn" id="railProjects" type="button" title="Projects">P</button>
           </div>
           <div class="railBottom">
             <div class="railStatus" id="railStatus" title="status"></div>
@@ -1616,6 +1697,14 @@ async function cmdWeb({ port, dir, open, dev }) {
         return;
       }
 
+      if (req.method === 'GET' && req.url === '/projects') {
+        try { res.__freyaDebug.workspaceDir = normalizeWorkspaceDir(dir || './freya'); } catch {}
+        const body = projectsHtml(dir || './freya');
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store' });
+        res.end(body);
+        return;
+      }
+
       if (req.method === 'GET' && req.url === '/app.css') {
         const css = fs.readFileSync(path.join(__dirname, 'web-ui.css'), 'utf8');
         res.writeHead(200, { 'Content-Type': 'text/css; charset=utf-8', 'Cache-Control': 'no-store' });
@@ -1701,7 +1790,41 @@ async function cmdWeb({ port, dir, open, dev }) {
           return safeJson(res, 200, { ok: true, map: out });
         }
 
-        if (req.url === '/api/reports/list') {
+        if (req.url === '/api/projects/list') {
+          const base = path.join(workspaceDir, 'data', 'Clients');
+          const items = [];
+          if (exists(base)) {
+            const stack = [base];
+            while (stack.length) {
+              const dirp = stack.pop();
+              const entries = fs.readdirSync(dirp, { withFileTypes: true });
+              for (const ent of entries) {
+                const full = path.join(dirp, ent.name);
+                if (ent.isDirectory()) stack.push(full);
+                else if (ent.isFile() && ent.name === 'status.json') {
+                  const doc = readJsonOrNull(full) || {};
+                  const rel = path.relative(base, path.dirname(full)).replace(/\\/g, '/');
+                  items.push({
+                    slug: rel,
+                    client: doc.client || null,
+                    program: doc.program || null,
+                    stream: doc.stream || null,
+                    project: doc.project || null,
+                    active: doc.active !== false,
+                    currentStatus: doc.currentStatus || '',
+                    lastUpdated: doc.lastUpdated || '',
+                    tags: Array.isArray(doc.tags) ? doc.tags : [],
+                    historyCount: Array.isArray(doc.history) ? doc.history.length : 0
+                  });
+                }
+              }
+            }
+          }
+          items.sort((a,b)=> String(b.lastUpdated||'').localeCompare(String(a.lastUpdated||'')));
+          return safeJson(res, 200, { ok: true, projects: items });
+        }
+
+if (req.url === '/api/reports/list') {
           const reports = listReports(workspaceDir);
           return safeJson(res, 200, { reports });
         }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@cccarv82/freya",
-  "version": "2.1.6",
+  "version": "2.2.0",
   "description": "Personal AI Assistant with local-first persistence",
   "scripts": {
-    "health": "node scripts/validate-data.js",
+    "health": "node scripts/validate-data.js && node scripts/validate-structure.js",
     "migrate": "node scripts/migrate-data.js",
     "report": "node scripts/generate-weekly-report.js",
     "sm-weekly": "node scripts/generate-sm-weekly-report.js",
@@ -13,7 +13,7 @@
     "export-obsidian": "node scripts/export-obsidian.js",
     "build-index": "node scripts/index/build-index.js",
     "update-index": "node scripts/index/update-index.js",
-    "test": "node tests/unit/test-package-config.js && node tests/unit/test-cli-init.js && node tests/unit/test-cli-web-help.js && node tests/unit/test-web-static-assets.js && node tests/unit/test-fs-utils.js && node tests/unit/test-search-utils.js && node tests/unit/test-index-utils.js && node tests/unit/test-task-schema.js && node tests/unit/test-daily-generation.js && node tests/unit/test-report-generation.js && node tests/unit/test-executive-report-logs.js && node tests/unit/test-oracle-retrieval.js && node tests/unit/test-task-completion.js && node tests/unit/test-migrate-data.js && node tests/unit/test-blockers-validation.js && node tests/unit/test-blockers-report.js && node tests/unit/test-sm-weekly-report.js && node tests/integration/test-ingestor-task.js"
+    "test": "node tests/unit/test-package-config.js && node tests/unit/test-cli-init.js && node tests/unit/test-cli-web-help.js && node tests/unit/test-web-static-assets.js && node tests/unit/test-fs-utils.js && node tests/unit/test-search-utils.js && node tests/unit/test-index-utils.js && node tests/unit/test-task-schema.js && node tests/unit/test-daily-generation.js && node tests/unit/test-report-generation.js && node tests/unit/test-executive-report-logs.js && node tests/unit/test-oracle-retrieval.js && node tests/unit/test-task-completion.js && node tests/unit/test-migrate-data.js && node tests/unit/test-blockers-validation.js && node tests/unit/test-blockers-report.js && node tests/unit/test-sm-weekly-report.js && node tests/integration/test-ingestor-task.js && node tests/unit/test-structure-validation.js"
   },
   "keywords": [],
   "author": "",

package/scripts/validate-structure.js

@@ -0,0 +1,151 @@
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.join(__dirname, '..');
+const LOGS_DIR = path.join(ROOT, 'logs', 'daily');
+const DATA_DIR = path.join(ROOT, 'data');
+const DOCS_DIR = path.join(ROOT, 'docs');
+const CLIENTS_DIR = path.join(DATA_DIR, 'Clients');
+
+const errors = [];
+
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+function readFileSafe(p) {
+  try { return fs.readFileSync(p, 'utf8'); } catch { return null; }
+}
+
+function walk(dir, out = []) {
+  if (!exists(dir)) return out;
+  for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, ent.name);
+    if (ent.isDirectory()) walk(full, out);
+    else out.push(full);
+  }
+  return out;
+}
+
+function parseFrontmatter(text) {
+  if (!text) return null;
+  const lines = text.split(/\r?\n/);
+  if (!lines.length || lines[0].trim() !== '---') return null;
+  const fm = {};
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === '---') break;
+    const idx = line.indexOf(':');
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    const value = line.slice(idx + 1).trim();
+    fm[key] = value;
+  }
+  return fm;
+}
+
+function validateDailyLogs() {
+  if (!exists(LOGS_DIR)) return;
+  const files = fs.readdirSync(LOGS_DIR)
+    .filter((f) => /^\d{4}-\d{2}-\d{2}\.md$/.test(f));
+
+  for (const name of files) {
+    const full = path.join(LOGS_DIR, name);
+    const body = readFileSafe(full);
+    const fm = parseFrontmatter(body);
+    const date = name.replace(/\.md$/, '');
+    if (!fm) {
+      errors.push(`Daily log missing frontmatter: ${path.relative(ROOT, full)}`);
+      continue;
+    }
+    const type = String(fm.Type || '').toLowerCase();
+    const fmDate = String(fm.Date || '').trim();
+    if (type !== 'daily') {
+      errors.push(`Daily log frontmatter Type must be 'daily': ${path.relative(ROOT, full)}`);
+    }
+    if (fmDate !== date) {
+      errors.push(`Daily log frontmatter Date must match filename (${date}): ${path.relative(ROOT, full)}`);
+    }
+  }
+}
+
+function collectProjectSlugs() {
+  if (!exists(CLIENTS_DIR)) return [];
+  const slugs = [];
+  const files = walk(CLIENTS_DIR).filter((f) => f.endsWith('status.json'));
+  for (const file of files) {
+    const rel = path.relative(CLIENTS_DIR, path.dirname(file));
+    if (!rel) continue;
+    const slug = rel.split(path.sep).join('/').toLowerCase();
+    slugs.push(slug);
+  }
+  return Array.from(new Set(slugs));
+}
+
+function validateProjectStatusHistory() {
+  if (!exists(CLIENTS_DIR)) return;
+  const files = walk(CLIENTS_DIR).filter((f) => f.endsWith('status.json'));
+  for (const file of files) {
+    const raw = readFileSafe(file);
+    if (!raw) continue;
+    try {
+      const json = JSON.parse(raw);
+      if (!Array.isArray(json.history)) {
+        errors.push(`status.json must include history array: ${path.relative(ROOT, file)}`);
+      }
+    } catch (e) {
+      errors.push(`Invalid JSON in status.json: ${path.relative(ROOT, file)}`);
+    }
+  }
+}
+
+function validateTaskProjectSlugs() {
+  const slugs = collectProjectSlugs();
+  if (!slugs.length) return; // no known slugs -> skip
+
+  const taskFile = path.join(DATA_DIR, 'tasks', 'task-log.json');
+  if (!exists(taskFile)) return;
+
+  let json;
+  try { json = JSON.parse(readFileSafe(taskFile) || '{}'); } catch { return; }
+  const tasks = Array.isArray(json.tasks) ? json.tasks : [];
+
+  for (const task of tasks) {
+    if (!task || typeof task !== 'object') continue;
+    const desc = String(task.description || '').toLowerCase();
+    if (!desc) continue;
+    const mentioned = slugs.find((slug) => desc.includes(slug));
+    if (mentioned && !task.projectSlug) {
+      errors.push(`Task missing projectSlug for mentioned project (${mentioned}): ${task.id || task.description}`);
+    }
+  }
+}
+
+function validateDocsHubs() {
+  const hubs = [
+    path.join(DOCS_DIR, 'reports', 'Reports Hub.md'),
+    path.join(DOCS_DIR, 'career', 'Career Hub.md'),
+    path.join(DOCS_DIR, 'standards', 'Standards Hub.md'),
+  ];
+  for (const hub of hubs) {
+    if (!exists(hub)) {
+      errors.push(`Missing hub doc: ${path.relative(ROOT, hub)}`);
+    }
+  }
+}
+
+function main() {
+  validateDailyLogs();
+  validateProjectStatusHistory();
+  validateTaskProjectSlugs();
+  validateDocsHubs();
+
+  if (errors.length) {
+    console.error('❌ Structure validation failed:');
+    for (const err of errors) console.error('-', err);
+    process.exit(1);
+  }
+  console.log('✅ Structure validation passed');
+}
+
+main();

package/templates/base/.agent/rules/freya/agents/ingestor.mdc

@@ -14,6 +14,14 @@ Before ANY attempt to parse, classify, or understand the input, you MUST write t
 This ensures no data is lost even if the subsequent steps fail.
 </critical-rule>
 
+<structure-guardrails>
+**Pasta correta, sempre:**
+- Logs diários brutos → `logs/daily/YYYY-MM-DD.md`
+- Dados estruturados → `data/**` (tasks, career, Clients/.../status.json)
+- Documentos de síntese/hubs/relatórios → `docs/**`
+Nunca gravar dados estruturados em `logs/` e nunca colocar notas diárias em `docs/`.
+</structure-guardrails>
+
 <workflow>
 1.  **Receive Input:** The user provides text (status update, blocker, random thought, etc.).
 2.  **Safe Log (PRIORITY):**

package/templates/base/.agent/rules/freya/agents/master.mdc

@@ -81,6 +81,11 @@ You must fully embody this agent's persona and follow all activation instruction
     - If user asks "Relatório Scrum Master", "SM weekly" or "weekly scrum" -> Execute `npm run sm-weekly` via the Shell tool.
     - If user asks "Relatório de blockers", "blockers report", "riscos" -> Execute `npm run blockers` via the Shell tool.
     - Inform the user where the file was saved when applicable.
+  - **Structure Guardrail (ALWAYS)**:
+    - Logs diários brutos → `logs/daily/`
+    - Dados estruturados → `data/`
+    - Hubs e relatórios → `docs/`
+    - Nunca misturar camadas.
   - **Git Operations**: If user asks "Commit changes", "Save my work", or "Generate commit" ->
     1. Execute `git status --porcelain` via Shell.
     2. If output is empty, inform the user "No changes to commit".

package/templates/base/docs/career/Career Hub.md

@@ -0,0 +1,13 @@
+---
+Type: career-hub
+Tags: [career, hub]
+DataPath: data/career/career-log.json
+---
+
+# Career Hub
+
+Centro de navegação para evolução de carreira dentro da FREYA.
+
+## Como usar
+- Registrar feedbacks e conquistas em `data/career/career-log.json`.
+- Criar relatórios de carreira em `docs/reports`.

package/templates/base/docs/reports/Reports Hub.md

@@ -0,0 +1,13 @@
+---
+Type: reports-hub
+Tags: [reports, hub]
+DirPath: docs/reports
+---
+
+# Reports Hub
+
+Ponto único para visualizar relatórios gerados pela FREYA.
+
+## Como usar
+- Relatórios gerados via scripts aparecem aqui.
+- Mantenha links para relatórios importantes.

package/templates/base/docs/standards/Standards Hub.md

@@ -0,0 +1,11 @@
+---
+Type: standards-hub
+Tags: [standards, governance]
+---
+
+# Standards Hub
+
+Mapa de documentos de padrões e governança.
+
+## Como usar
+- Centralize aqui links de padrões e boas práticas.

package/templates/base/scripts/validate-structure.js

@@ -0,0 +1,151 @@
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.join(__dirname, '..');
+const LOGS_DIR = path.join(ROOT, 'logs', 'daily');
+const DATA_DIR = path.join(ROOT, 'data');
+const DOCS_DIR = path.join(ROOT, 'docs');
+const CLIENTS_DIR = path.join(DATA_DIR, 'Clients');
+
+const errors = [];
+
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+function readFileSafe(p) {
+  try { return fs.readFileSync(p, 'utf8'); } catch { return null; }
+}
+
+function walk(dir, out = []) {
+  if (!exists(dir)) return out;
+  for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, ent.name);
+    if (ent.isDirectory()) walk(full, out);
+    else out.push(full);
+  }
+  return out;
+}
+
+function parseFrontmatter(text) {
+  if (!text) return null;
+  const lines = text.split(/\r?\n/);
+  if (!lines.length || lines[0].trim() !== '---') return null;
+  const fm = {};
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === '---') break;
+    const idx = line.indexOf(':');
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    const value = line.slice(idx + 1).trim();
+    fm[key] = value;
+  }
+  return fm;
+}
+
+function validateDailyLogs() {
+  if (!exists(LOGS_DIR)) return;
+  const files = fs.readdirSync(LOGS_DIR)
+    .filter((f) => /^\d{4}-\d{2}-\d{2}\.md$/.test(f));
+
+  for (const name of files) {
+    const full = path.join(LOGS_DIR, name);
+    const body = readFileSafe(full);
+    const fm = parseFrontmatter(body);
+    const date = name.replace(/\.md$/, '');
+    if (!fm) {
+      errors.push(`Daily log missing frontmatter: ${path.relative(ROOT, full)}`);
+      continue;
+    }
+    const type = String(fm.Type || '').toLowerCase();
+    const fmDate = String(fm.Date || '').trim();
+    if (type !== 'daily') {
+      errors.push(`Daily log frontmatter Type must be 'daily': ${path.relative(ROOT, full)}`);
+    }
+    if (fmDate !== date) {
+      errors.push(`Daily log frontmatter Date must match filename (${date}): ${path.relative(ROOT, full)}`);
+    }
+  }
+}
+
+function collectProjectSlugs() {
+  if (!exists(CLIENTS_DIR)) return [];
+  const slugs = [];
+  const files = walk(CLIENTS_DIR).filter((f) => f.endsWith('status.json'));
+  for (const file of files) {
+    const rel = path.relative(CLIENTS_DIR, path.dirname(file));
+    if (!rel) continue;
+    const slug = rel.split(path.sep).join('/').toLowerCase();
+    slugs.push(slug);
+  }
+  return Array.from(new Set(slugs));
+}
+
+function validateProjectStatusHistory() {
+  if (!exists(CLIENTS_DIR)) return;
+  const files = walk(CLIENTS_DIR).filter((f) => f.endsWith('status.json'));
+  for (const file of files) {
+    const raw = readFileSafe(file);
+    if (!raw) continue;
+    try {
+      const json = JSON.parse(raw);
+      if (!Array.isArray(json.history)) {
+        errors.push(`status.json must include history array: ${path.relative(ROOT, file)}`);
+      }
+    } catch (e) {
+      errors.push(`Invalid JSON in status.json: ${path.relative(ROOT, file)}`);
+    }
+  }
+}
+
+function validateTaskProjectSlugs() {
+  const slugs = collectProjectSlugs();
+  if (!slugs.length) return; // no known slugs -> skip
+
+  const taskFile = path.join(DATA_DIR, 'tasks', 'task-log.json');
+  if (!exists(taskFile)) return;
+
+  let json;
+  try { json = JSON.parse(readFileSafe(taskFile) || '{}'); } catch { return; }
+  const tasks = Array.isArray(json.tasks) ? json.tasks : [];
+
+  for (const task of tasks) {
+    if (!task || typeof task !== 'object') continue;
+    const desc = String(task.description || '').toLowerCase();
+    if (!desc) continue;
+    const mentioned = slugs.find((slug) => desc.includes(slug));
+    if (mentioned && !task.projectSlug) {
+      errors.push(`Task missing projectSlug for mentioned project (${mentioned}): ${task.id || task.description}`);
+    }
+  }
+}
+
+function validateDocsHubs() {
+  const hubs = [
+    path.join(DOCS_DIR, 'reports', 'Reports Hub.md'),
+    path.join(DOCS_DIR, 'career', 'Career Hub.md'),
+    path.join(DOCS_DIR, 'standards', 'Standards Hub.md'),
+  ];
+  for (const hub of hubs) {
+    if (!exists(hub)) {
+      errors.push(`Missing hub doc: ${path.relative(ROOT, hub)}`);
+    }
+  }
+}
+
+function main() {
+  validateDailyLogs();
+  validateProjectStatusHistory();
+  validateTaskProjectSlugs();
+  validateDocsHubs();
+
+  if (errors.length) {
+    console.error('❌ Structure validation failed:');
+    for (const err of errors) console.error('-', err);
+    process.exit(1);
+  }
+  console.log('✅ Structure validation passed');
+}
+
+main();