aios-core 4.2.14 → 4.3.0

package/.aios-core/utils/filters/schema-filter.js

@@ -0,0 +1,157 @@
+// =============================================================================
+// schema-filter.js — Schema-type filter for MCP tool responses
+// =============================================================================
+// Selects only whitelisted fields from JSON objects or arrays of objects.
+// Optionally truncates serialized output to max_tokens.
+//
+// Usage (stdin):
+//   echo '[{"name":"John","ssn":"123"}]' | node schema-filter.js --fields name
+//
+// Usage (programmatic):
+//   const { filterSchema } = require('./schema-filter');
+//   const result = filterSchema(data, { fields: ['name', 'url'] });
+// =============================================================================
+
+'use strict';
+
+const fs = require('fs');
+const { CHARS_PER_TOKEN } = require('./constants');
+
+/**
+ * Project whitelisted fields from an object.
+ * @param {Object} obj - Source object
+ * @param {string[]} fields - Fields to keep
+ * @returns {Object} Projected object
+ */
+function projectFields(obj, fields) {
+  if (!obj || typeof obj !== 'object') return obj;
+
+  const result = {};
+  for (const field of fields) {
+    if (field in obj) {
+      result[field] = obj[field];
+    }
+  }
+  return result;
+}
+
+/**
+ * Apply schema filter to input data.
+ * @param {Object|Object[]} input - Parsed JSON input
+ * @param {Object} options - Filter options
+ * @param {string[]} options.fields - Fields to whitelist
+ * @param {number} [options.max_tokens] - Optional token limit for output
+ * @returns {{ filtered: Object|Object[], original_length: number, filtered_length: number, reduction_pct: number }}
+ */
+function filterSchema(input, options = {}) {
+  const fields = options.fields || [];
+
+  if (!fields.length) {
+    // No fields specified — pass through unfiltered
+    const serialized = JSON.stringify(input, null, 2);
+    return {
+      filtered: input,
+      original_length: serialized.length,
+      filtered_length: serialized.length,
+      reduction_pct: 0,
+    };
+  }
+
+  const originalSerialized = JSON.stringify(input, null, 2);
+  const originalLength = originalSerialized.length;
+
+  let filtered;
+  if (Array.isArray(input)) {
+    filtered = input.map((item) => projectFields(item, fields));
+  } else {
+    filtered = projectFields(input, fields);
+  }
+
+  let filteredSerialized = JSON.stringify(filtered, null, 2);
+
+  // Apply max_tokens truncation if specified
+  if (options.max_tokens) {
+    const maxChars = options.max_tokens * CHARS_PER_TOKEN;
+    if (filteredSerialized.length > maxChars) {
+      // For arrays, truncate by removing trailing items to keep valid JSON
+      if (Array.isArray(filtered)) {
+        while (JSON.stringify(filtered, null, 2).length > maxChars && filtered.length > 1) {
+          filtered.pop();
+        }
+        filteredSerialized = JSON.stringify(filtered, null, 2);
+        if (filteredSerialized.length > maxChars) {
+          filteredSerialized = filteredSerialized.slice(0, maxChars) + '\n... [truncated]';
+        }
+      } else {
+        // For objects, hard truncate with marker (object already field-projected)
+        filteredSerialized = filteredSerialized.slice(0, maxChars) + '\n... [truncated]';
+      }
+    }
+  }
+
+  const filteredLength = filteredSerialized.length;
+  const reductionPct = originalLength > 0
+    ? Math.round((1 - filteredLength / originalLength) * 100)
+    : 0;
+
+  return {
+    filtered,
+    original_length: originalLength,
+    filtered_length: filteredLength,
+    reduction_pct: reductionPct,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// CLI entrypoint
+// ---------------------------------------------------------------------------
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 2; i < argv.length; i++) {
+    if (argv[i] === '--fields' && argv[i + 1]) {
+      args.fields = argv[i + 1].split(',');
+      i++;
+    } else if (argv[i] === '--input' && argv[i + 1]) {
+      args.input = argv[i + 1];
+      i++;
+    } else if (argv[i] === '--max-tokens' && argv[i + 1]) {
+      args.max_tokens = parseInt(argv[i + 1], 10);
+      i++;
+    }
+  }
+  return args;
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+
+  let inputData;
+  if (args.input) {
+    inputData = fs.readFileSync(args.input, 'utf8');
+  } else if (!process.stdin.isTTY) {
+    inputData = fs.readFileSync(0, 'utf8');
+  } else {
+    console.error('Usage: echo \'[{"a":1,"b":2}]\' | node schema-filter.js --fields a');
+    process.exit(1);
+  }
+
+  try {
+    inputData = JSON.parse(inputData);
+  } catch (err) {
+    console.error('Error: Input must be valid JSON.', err.message);
+    process.exit(1);
+  }
+
+  const result = filterSchema(inputData, {
+    fields: args.fields,
+    max_tokens: args.max_tokens,
+  });
+
+  console.log(JSON.stringify(result, null, 2));
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { filterSchema, projectFields, CHARS_PER_TOKEN };

package/.claude/CLAUDE.md

@@ -4,6 +4,7 @@ Este arquivo configura o comportamento do Claude Code ao trabalhar neste reposit
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Constitution
 
 O AIOS possui uma **Constitution formal** com princípios inegociáveis e gates automáticos.
@@ -25,6 +26,7 @@ O AIOS possui uma **Constitution formal** com princípios inegociáveis e gates
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Language Configuration
 
 Language preference is handled by Claude Code's native `language` setting (v2.1.0+).
@@ -38,6 +40,7 @@ The installer writes this automatically during `npx aios-core install`. No langu
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Premissa Arquitetural: CLI First
 
 O Synkra AIOS segue uma hierarquia clara de prioridades que deve guiar **TODAS** as decisões:
@@ -64,6 +67,7 @@ CLI First → Observability Second → UI Third
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Estrutura do Projeto
 
 ```
@@ -84,6 +88,25 @@ aios-core/
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
+## Framework vs Project Boundary
+
+O AIOS usa um modelo de 4 camadas (L1-L4) para separar artefatos do framework e do projeto. Deny rules em `.claude/settings.json` reforçam isso deterministicamente.
+
+| Camada | Mutabilidade | Paths | Notas |
+|--------|-------------|-------|-------|
+| **L1** Framework Core | NEVER modify | `.aios-core/core/`, `.aios-core/constitution.md`, `bin/aios.js`, `bin/aios-init.js` | Protegido por deny rules |
+| **L2** Framework Templates | NEVER modify | `.aios-core/development/tasks/`, `.aios-core/development/templates/`, `.aios-core/development/checklists/`, `.aios-core/development/workflows/`, `.aios-core/infrastructure/` | Extend-only |
+| **L3** Project Config | Mutable (exceptions) | `.aios-core/data/`, `agents/*/MEMORY.md`, `core-config.yaml` | Allow rules permitem |
+| **L4** Project Runtime | ALWAYS modify | `docs/stories/`, `packages/`, `squads/`, `tests/` | Trabalho do projeto |
+
+**Toggle:** `core-config.yaml` → `boundary.frameworkProtection: true/false` controla se deny rules são ativas (default: true para projetos, false para contribuidores do framework).
+
+> **Referência formal:** `.claude/settings.json` (deny/allow rules), `.claude/rules/agent-authority.md`
+
+---
+
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Sistema de Agentes
 
 ### Ativação de Agentes
@@ -122,6 +145,7 @@ Use prefixo `*` para comandos:
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Story-Driven Development
 
 1. **Trabalhe a partir de stories** - Todo desenvolvimento começa com uma story em `docs/stories/`
@@ -136,6 +160,7 @@ Use prefixo `*` para comandos:
 
 ---
 
+<!-- PROJECT-CUSTOMIZED: Safe to modify for your project -->
 ## Padrões de Código
 
 ### Convenções de Nomenclatura
@@ -185,6 +210,7 @@ try {
 
 ---
 
+<!-- PROJECT-CUSTOMIZED: Safe to modify for your project -->
 ## Testes & Quality Gates
 
 ### Comandos de Teste
@@ -205,6 +231,7 @@ npm test            # Jest
 
 ---
 
+<!-- PROJECT-CUSTOMIZED: Safe to modify for your project -->
 ## Convenções Git
 
 ### Commits
@@ -229,6 +256,7 @@ Seguir Conventional Commits:
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## Otimização Claude Code
 
 ### Uso de Ferramentas
@@ -245,6 +273,13 @@ Seguir Conventional Commits:
 - Use execução paralela para operações independentes
 - Cache dados frequentemente acessados durante a sessão
 
+### Context Management (NOG-18 + TOK-4A)
+- Use `/compact` when context feels heavy or approaching limits
+- Context brackets (SYNAPSE) replaced by native compaction
+- Agent memory persists in `.aios-core/development/agents/{id}/MEMORY.md`
+- Rules with `paths:` frontmatter only load when working on matching files
+- **Agent Handoff:** On agent switch (`@agent`), previous agent is compacted to ~379-token handoff artifact. See `.claude/rules/agent-handoff.md` for full protocol. Max 3 retained summaries, oldest discarded.
+
 ### Gerenciamento de Sessão
 - Rastreie progresso da story durante a sessão
 - Atualize checkboxes imediatamente após completar tasks
@@ -259,6 +294,7 @@ Seguir Conventional Commits:
 
 ---
 
+<!-- PROJECT-CUSTOMIZED: Safe to modify for your project -->
 ## Comandos Frequentes
 
 ### Desenvolvimento
@@ -287,6 +323,7 @@ npm run build               # Build produção
 
 ---
 
+<!-- FRAMEWORK-OWNED: Generated by AIOS installer, do not customize -->
 ## MCP Usage
 
 Ver `.claude/rules/mcp-usage.md` para regras detalhadas.
@@ -298,6 +335,31 @@ Ver `.claude/rules/mcp-usage.md` para regras detalhadas.
 
 ---
 
+<!-- PROJECT-CUSTOMIZED: Token Optimization TOK-2 -->
+## Tool Selection Guidance
+
+Prefer native Claude Code tools over MCP for common operations. The tool-registry at `.aios-core/data/tool-registry.yaml` defines the 3-Tier Tool Mesh:
+
+| Tier | When Loaded | Examples |
+|------|-------------|---------|
+| **1** (Always) | Session start | Read, Write, Edit, Bash, Grep, Glob, Task |
+| **2** (Deferred) | Agent activation | git, coderabbit, context7, supabase |
+| **3** (Deferred) | Via tool search | EXA, Playwright, Apify, Nogic, Code-Graph |
+
+**Guidelines:**
+- Use Tier 1 native tools for file ops, search, and commands — avoid MCP equivalents
+- Tier 3 MCP tools are deferred via Tool Search — only loaded when explicitly needed
+- Limit tool search to maximum 2 searches per turn to avoid overhead
+- Essential MCP servers (nogic, code-graph) are never disabled
+- Non-essential servers (EXA, Apify, Playwright) load on-demand via tool search
+
+**Tool Examples (TOK-4B):** Concrete input examples improve tool selection accuracy by +18pp. See `.claude/rules/tool-examples.md` for examples of top-10 tools. Full registry: `.aios-core/data/mcp-tool-examples.yaml`. ADR-5: examples for always-loaded tools only, search for deferred tools.
+
+**Runtime capabilities:** `.aios/runtime-capabilities.json` (generated by capability-detection.js)
+
+---
+
+<!-- PROJECT-CUSTOMIZED: Safe to modify for your project -->
 ## Debug
 
 ### Habilitar Debug