aios-core 2.2.2 → 3.0.0

package/.aios-core/development/tasks/squad-creator-validate.md

@@ -0,0 +1,151 @@
+---
+task: Validate Squad
+responsável: @squad-creator
+responsável_type: agent
+atomic_layer: task
+Entrada: |
+  - squad_path: Path to the squad directory (default: ./squads/{name})
+  - name: Squad name (alternative to full path)
+  - strict: If true, warnings become errors (default: false)
+  - verbose: If true, show detailed output (default: false)
+Saída: |
+  - validation_result: Object with { valid, errors, warnings, suggestions }
+  - report: Formatted report for display
+  - exit_code: 0 if valid, 1 if invalid
+Checklist:
+  - [ ] Resolve squad path via squad-loader
+  - [ ] Execute squad-validator.validate()
+  - [ ] Format result for output
+  - [ ] Return appropriate exit code
+---
+
+# *validate-squad
+
+Validates a squad against the JSON Schema and TASK-FORMAT-SPECIFICATION-V1.
+
+## Usage
+
+```
+@squad-creator
+*validate-squad ./squads/my-squad
+*validate-squad my-squad
+*validate-squad my-squad --strict
+*validate-squad my-squad --verbose
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `squad_path` | string | - | Full path to squad directory |
+| `name` | string | - | Squad name (resolves to ./squads/{name}) |
+| `--strict` | flag | false | Treat warnings as errors |
+| `--verbose` | flag | false | Show detailed validation output |
+
+## Validation Checks
+
+### 1. Manifest Validation
+- Checks for `squad.yaml` or `config.yaml` (deprecated)
+- Validates against JSON Schema
+- Required fields: `name`, `version`
+
+### 2. Structure Validation
+- Checks for expected directories: `tasks/`, `agents/`
+- Verifies referenced files exist
+
+### 3. Task Validation (TASK-FORMAT-SPECIFICATION-V1)
+- Checks for required fields in task files
+- Validates naming conventions (kebab-case)
+
+### 4. Agent Validation
+- Checks for valid agent definition format
+- Validates naming conventions
+
+## Flow
+
+```
+1. Resolve squad path
+   ├── If full path provided → use directly
+   └── If name provided → resolve via ./squads/{name}/
+
+2. Execute validations
+   ├── validateManifest() → Schema check
+   ├── validateStructure() → Directory check
+   ├── validateTasks() → Task format check
+   └── validateAgents() → Agent format check
+
+3. Format and display result
+   ├── Show errors (if any)
+   ├── Show warnings (if any)
+   └── Show final result (VALID/INVALID)
+
+4. Return exit code
+   ├── 0 → Valid (or valid with warnings)
+   └── 1 → Invalid (errors found)
+```
+
+## Output Example
+
+```
+Validating squad: ./squads/my-squad/
+
+Errors: 0
+Warnings: 2
+  - [MISSING_DIRECTORY]: Expected directory not found: workflows/
+    Suggestion: mkdir workflows (task-first architecture recommends tasks/ and agents/)
+  - [TASK_MISSING_FIELD] (my-task.md): Task missing recommended field: Checklist
+    Suggestion: Add "Checklist:" to my-task.md (TASK-FORMAT-SPECIFICATION-V1)
+
+Result: VALID (with warnings)
+```
+
+## Error Codes
+
+| Code | Severity | Description |
+|------|----------|-------------|
+| `MANIFEST_NOT_FOUND` | Error | No squad.yaml or config.yaml found |
+| `YAML_PARSE_ERROR` | Error | Invalid YAML syntax |
+| `SCHEMA_ERROR` | Error | Manifest doesn't match JSON Schema |
+| `FILE_NOT_FOUND` | Error | Referenced file doesn't exist |
+| `DEPRECATED_MANIFEST` | Warning | Using config.yaml instead of squad.yaml |
+| `MISSING_DIRECTORY` | Warning | Expected directory not found |
+| `NO_TASKS` | Warning | No task files in tasks/ |
+| `TASK_MISSING_FIELD` | Warning | Task missing recommended field |
+| `AGENT_INVALID_FORMAT` | Warning | Agent file may not follow format |
+| `INVALID_NAMING` | Warning | Filename not in kebab-case |
+
+## Implementation
+
+```javascript
+const { SquadLoader } = require('./.aios-core/development/scripts/squad');
+const { SquadValidator } = require('./.aios-core/development/scripts/squad');
+
+async function validateSquad(options) {
+  const { squadPath, name, strict, verbose } = options;
+
+  // Resolve path
+  const loader = new SquadLoader();
+  let resolvedPath = squadPath;
+  if (!squadPath && name) {
+    const resolved = await loader.resolve(name);
+    resolvedPath = resolved.path;
+  }
+
+  // Validate
+  const validator = new SquadValidator({ strict, verbose });
+  const result = await validator.validate(resolvedPath);
+
+  // Format output
+  console.log(validator.formatResult(result, resolvedPath));
+
+  // Return exit code
+  return result.valid ? 0 : 1;
+}
+```
+
+## Related
+
+- **Story:** SQS-3 (Squad Validator + JSON Schema)
+- **Dependencies:** squad-loader.js, squad-validator.js
+- **Schema:** .aios-core/schemas/squad-schema.json
+- **Agent:** @squad-creator (Craft)

package/.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md

@@ -30,7 +30,7 @@
               ↓
 ┌─────────────────────────────────────┐
 │   LAYER 2: Output Formatter         │  ← Template engine (JS)
-│   (.aios-core/scripts/)             │
+│   (.aios-core/infrastructure/scripts/)│
 └─────────────────────────────────────┘
               ↓
 ┌─────────────────────────────────────┐
@@ -156,7 +156,7 @@ archetypes:
 ### Template Engine Architecture
 
 ```javascript
-// .aios-core/scripts/output-formatter.js
+// .aios-core/infrastructure/scripts/output-formatter.js
 
 class PersonalizedOutputFormatter {
   constructor(agent, task, results) {
@@ -238,7 +238,7 @@ class PersonalizedOutputFormatter {
 ### Pattern Validation
 
 ```javascript
-// .aios-core/scripts/validate-output-pattern.js
+// .aios-core/infrastructure/scripts/validate-output-pattern.js
 
 /**
  * Ensures all task outputs follow standard structure

package/.aios-core/index.d.ts

@@ -1,8 +1,8 @@
-// @aios-fullstack/core - TypeScript Definitions
-export declare const MetaAgent: any;
-export declare const TaskManager: any;
-export declare const ElicitationEngine: any;
-export declare const TemplateEngine: any;
-export declare const ComponentSearch: any;
-export declare const DependencyAnalyzer: any;
+// @aios-fullstack/core - TypeScript Definitions
+export declare const MetaAgent: any;
+export declare const TaskManager: any;
+export declare const ElicitationEngine: any;
+export declare const TemplateEngine: any;
+export declare const ComponentSearch: any;
+export declare const DependencyAnalyzer: any;
 export {};

package/.aios-core/index.js

@@ -1,7 +1,7 @@
 // @synkra/aios-core/core - CommonJS Entry Point
 const MetaAgent = require('./infrastructure/scripts/component-generator.js');
 const TaskManager = require('./infrastructure/scripts/batch-creator.js');
-const ElicitationEngine = require('./scripts/elicitation-engine.js');
+const ElicitationEngine = require('./core/elicitation/elicitation-engine.js');
 const TemplateEngine = require('./infrastructure/scripts/template-engine.js');
 const ComponentSearch = require('./infrastructure/scripts/component-search.js');
 const DependencyAnalyzer = require('./infrastructure/scripts/dependency-analyzer.js');

package/.aios-core/infrastructure/scripts/batch-creator.js

@@ -7,7 +7,7 @@
 const fs = require('fs-extra');
 const path = require('path');
 const ComponentGenerator = require('./component-generator');
-const ElicitationEngine = require('../../scripts/elicitation-engine');
+const ElicitationEngine = require('../../core/elicitation/elicitation-engine');
 const DependencyAnalyzer = require('./dependency-analyzer');
 const TransactionManager = require('./transaction-manager');
 const chalk = require('chalk');

package/.aios-core/infrastructure/scripts/component-generator.js

@@ -10,7 +10,7 @@ const TemplateEngine = require('./template-engine');
 const TemplateValidator = require('./template-validator');
 const SecurityChecker = require('./security-checker');
 const YAMLValidator = require('./yaml-validator');
-const ElicitationEngine = require('../../scripts/elicitation-engine');
+const ElicitationEngine = require('../../core/elicitation/elicitation-engine');
 // const ComponentPreview = require('./component-preview'); // Archived in archived-utilities/ (Story 3.1.2)
 // const ManifestPreview = require('./manifest-preview'); // Archived in archived-utilities/ (Story 3.1.3)
 const ComponentMetadata = require('./component-metadata');