@jaimevalasek/aioson 1.7.0 → 1.8.0

package/src/installer.js

@@ -10,7 +10,23 @@ const { shouldIncludeForProfile } = require('./install-profile');
 
 const ROOT_DIR = path.join(__dirname, '..');
 const TEMPLATE_DIR = path.join(ROOT_DIR, 'template');
-const PROJECT_LOCAL_FILES = new Set(['aioson-models.json']);
+const PROJECT_LOCAL_FILES = new Set([
+  'aioson-models.json',
+  '.aioson/context/design-doc.md',
+  '.aioson/design-docs/code-reuse.md',
+  '.aioson/design-docs/componentization.md',
+  '.aioson/design-docs/file-size.md',
+  '.aioson/design-docs/folder-structure.md',
+  '.aioson/design-docs/naming.md',
+  '.aioson/git-guard.json'
+]);
+// Baseline blockPaths merged into every project's git-guard.json on install and update.
+// These are never removed — only added if missing. Project-specific entries are preserved.
+const GIT_GUARD_BASELINE_BLOCK_PATHS = [
+  'node_modules/**',
+  'aioson-logs/**'
+];
+
 const GITIGNORE_POLICY_LINES = [
   '# AIOSON — keep shared project memory and tool contracts',
   '!AGENTS.md',
@@ -38,6 +54,7 @@ const GITIGNORE_POLICY_LINES = [
   '!.aioson/my-agents/',
   '!.aioson/my-agents/**',
   '# AIOSON — local-only artifacts',
+  'aioson-logs/',
   'aioson-models.json',
   '.aioson/backups/',
   '.aioson/cloud-imports/',
@@ -87,6 +104,26 @@ async function ensureProjectGitignorePolicy(targetDir) {
   return ensureGitignoreEntries(targetDir, GITIGNORE_POLICY_LINES);
 }
 
+async function ensureGitGuardBaseline(targetDir) {
+  const guardPath = path.join(targetDir, '.aioson/git-guard.json');
+  if (!(await exists(guardPath))) return 0;
+
+  let config;
+  try {
+    config = JSON.parse(await fs.readFile(guardPath, 'utf8'));
+  } catch {
+    return 0; // corrupted — do not touch
+  }
+
+  const existing = new Set(Array.isArray(config.blockPaths) ? config.blockPaths : []);
+  const toAdd = GIT_GUARD_BASELINE_BLOCK_PATHS.filter((p) => !existing.has(p));
+  if (toAdd.length === 0) return 0;
+
+  config.blockPaths = [...(config.blockPaths || []), ...toAdd];
+  await fs.writeFile(guardPath, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
+  return toAdd.length;
+}
+
 async function countProjectFiles(targetDir) {
   const SKIP = new Set(['.git', 'node_modules', 'vendor', '.aioson', 'dist', 'build', '__pycache__']);
   let count = 0;
@@ -107,7 +144,12 @@ async function listFilesRecursive(dir) {
   const out = [];
 
   async function walk(current) {
-    const entries = await fs.readdir(current, { withFileTypes: true });
+    let entries;
+    try {
+      entries = await fs.readdir(current, { withFileTypes: true });
+    } catch {
+      return;
+    }
     for (const entry of entries) {
       const full = path.join(current, entry.name);
       if (entry.isDirectory()) {
@@ -126,7 +168,9 @@ async function listFilesRecursive(dir) {
  * Returns a skip-reason string if the file should be skipped, or false if it should be installed.
  */
 function shouldSkipTemplatePath(rel, profile = null) {
+  if (rel === '.gitignore') return 'merge-only';
   if (rel === '.aioson/context/.gitkeep') return false;
+  if (rel === '.aioson/context/design-doc.md') return false; // framework default — copied on fresh install, project-local on update
   if (rel.startsWith('.aioson/context/')) return 'context-protected';
   // Never overwrite user-installed skills (only the .gitkeep is created)
   if (rel.startsWith('.aioson/installed-skills/') && rel !== '.aioson/installed-skills/.gitkeep') return 'context-protected';
@@ -142,7 +186,14 @@ function shouldSkipTemplatePath(rel, profile = null) {
 async function writeInstallMetadata(targetDir, action, frameworkDetection, installProfile) {
   const metaPath = path.join(targetDir, '.aioson/install.json');
   await ensureDir(path.dirname(metaPath));
-  const existing = (await exists(metaPath)) ? JSON.parse(await fs.readFile(metaPath, 'utf8')) : {};
+  let existing = {};
+  if (await exists(metaPath)) {
+    try {
+      existing = JSON.parse(await fs.readFile(metaPath, 'utf8'));
+    } catch {
+      // corrupted install.json — reset rather than crash
+    }
+  }
 
   const version = await getCliVersion();
   const data = {
@@ -215,7 +266,10 @@ async function installTemplate(targetDir, options = {}) {
     const dest = path.join(targetDir, rel);
     const destExists = await exists(dest);
 
-    if (destExists && PROJECT_LOCAL_FILES.has(rel)) {
+    // Project-local files are never overwritten from template.
+    // On fresh install they are created once; on any subsequent operation they are preserved
+    // even if the file was manually deleted.
+    if (PROJECT_LOCAL_FILES.has(rel) && (destExists || mode !== 'install')) {
       skipped.push({ path: rel, reason: 'project-local' });
       continue;
     }
@@ -232,8 +286,12 @@ async function installTemplate(targetDir, options = {}) {
 
     if (destExists && mode === 'update' && backupOnOverwrite && MANAGED_FILES.includes(rel)) {
       if (!dryRun) {
-        const backupPath = await backupManagedFile(targetDir, rel, backupRoot);
-        if (backupPath) backedUp.push(toRelativeSafe(targetDir, backupPath));
+        try {
+          const backupPath = await backupManagedFile(targetDir, rel, backupRoot);
+          if (backupPath) backedUp.push(toRelativeSafe(targetDir, backupPath));
+        } catch {
+          // backup failed — warn but do not block the update
+        }
       } else {
         backedUp.push(toRelativeSafe(targetDir, path.join(backupRoot, rel)));
       }
@@ -258,9 +316,13 @@ async function installTemplate(targetDir, options = {}) {
       await fs.writeFile(gitkeep, '', 'utf8');
     }
 
+    // Squad research cache — created on install so @orache can write without mkdir
+    await ensureDir(path.join(targetDir, 'squad-searches', 'standalone'));
+
     await writeInstallMetadata(targetDir, mode, frameworkDetection, installProfile);
 
     await ensureProjectGitignorePolicy(targetDir);
+    await ensureGitGuardBaseline(targetDir);
 
     runtime = await ensureProjectRuntime(targetDir);
   }
@@ -290,5 +352,7 @@ module.exports = {
   ensureGitignoreEntry,
   ensureGitignoreEntries,
   ensureProjectGitignorePolicy,
+  ensureGitGuardBaseline,
+  GIT_GUARD_BASELINE_BLOCK_PATHS,
   countProjectFiles
 };