@cccarv82/freya 2.1.6 → 2.1.7

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/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@cccarv82/freya",
-  "version": "2.1.6",
+  "version": "2.1.7",
   "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();