@bluefly/openstandardagents 0.4.5 → 0.4.6

package/dist/api/server.js

@@ -0,0 +1,21 @@
+/**
+ * OSSA API Server — standalone entrypoint
+ *
+ * Usage: ossa serve [--port 3000] [--cors-origin '*']
+ */
+import { createApp } from './index.js';
+export function startServer(opts) {
+    const port = opts?.port ?? parseInt(process.env.OSSA_API_PORT || '3000', 10);
+    const app = createApp({ corsOrigin: opts?.corsOrigin });
+    app.listen(port, () => {
+        console.log(`OSSA API server listening on http://localhost:${port}`);
+        console.log(`  Health:    GET  http://localhost:${port}/health`);
+        console.log(`  Manifests: GET  http://localhost:${port}/api/v1/manifests`);
+        console.log(`  Wizard:    POST http://localhost:${port}/api/v1/wizard/sessions`);
+        console.log(`  Export:    POST http://localhost:${port}/api/v1/export`);
+        console.log(`  Convert:   POST http://localhost:${port}/api/v1/convert`);
+        console.log(`  Skills:    GET  http://localhost:${port}/api/v1/skills`);
+        console.log(`  Workspace: GET  http://localhost:${port}/api/v1/workspace/status`);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/cli/banner.d.ts

@@ -3,12 +3,16 @@
  * Displays beautiful ASCII art and branding for the OSSA wizard
  */
 export declare const OSSA_BANNER: string;
+/** Standalone wizard logo: bold ASCII/ANSI art for agent creation wizard. */
+export declare const WIZARD_LOGO: string;
 export declare const WIZARD_BANNER: string;
 export declare const FEATURES_GRAPHIC: string;
 export declare const VERSION_INFO: string;
 export declare const COMPLETION_GRAPHIC: string;
 export declare const TEMPLATES_GRAPHIC: string;
 export declare function printBanner(): void;
+/** Show the standalone wizard logo and version at wizard start (branded top). */
+export declare function printWizardLogo(): void;
 export declare function printWizardBanner(): void;
 export declare function printTemplates(): void;
 export declare function printCompletion(): void;

package/dist/cli/banner.js

@@ -19,10 +19,21 @@ ${chalk.cyan('║')}        ${chalk.gray('The Universal Agent Specification Lang
 ${chalk.cyan('║')}                                                                       ${chalk.cyan('║')}
 ${chalk.cyan('╚═══════════════════════════════════════════════════════════════════════╝')}
 `;
+/** Standalone wizard logo: bold ASCII/ANSI art for agent creation wizard. */
+export const WIZARD_LOGO = `
+${chalk.cyan('  ') + chalk.bold.blue('  ___   ____   ____   ___   ') + chalk.cyan('     ') + chalk.blue('agent://')}
+${chalk.cyan('  ') + chalk.bold.blue(' / _ \\ / __ \\ / ___| / _ \\  ') + chalk.cyan('     ') + chalk.gray('open standard')}
+${chalk.cyan('  ') + chalk.bold.blue('| | | | |  | \\___ \\| | | | ') + chalk.cyan('  ') + chalk.cyan('---') + chalk.blue('---') + chalk.cyan('---') + chalk.blue('---')}
+${chalk.cyan('  ') + chalk.bold.blue('| | | | |  | |___) | |_| | ') + chalk.cyan('  ') + chalk.white('O') + chalk.cyan(' S ') + chalk.white('S') + chalk.cyan(' A')}
+${chalk.cyan('  ') + chalk.bold.blue('| |_| | |__| |____/ \\___/  ')}
+${chalk.cyan('  ') + chalk.bold.blue(' \\___/ \\____/              ')}
+${chalk.cyan('')}
+${chalk.cyan('  ') + chalk.yellow.bold('  Agent Creation Wizard') + chalk.gray('  |  ') + chalk.white('Open Standard for Software Agents')}
+`;
 export const WIZARD_BANNER = `
 ${chalk.magenta('╔═══════════════════════════════════════════════════════════════════════╗')}
 ${chalk.magenta('║')}                                                                       ${chalk.magenta('║')}
-${chalk.magenta('║')}          ${chalk.bold.yellow('🧙  OSSA Agent Creation Wizard v2.0')}                        ${chalk.magenta('║')}
+${chalk.magenta('║')}          ${chalk.bold.yellow('OSSA Agent Creation Wizard v2.0')}                             ${chalk.magenta('║')}
 ${chalk.magenta('║')}                                                                       ${chalk.magenta('║')}
 ${chalk.magenta('║')}      ${chalk.gray('Create production-ready agents with AI superpowers')}            ${chalk.magenta('║')}
 ${chalk.magenta('║')}                                                                       ${chalk.magenta('║')}
@@ -73,6 +84,13 @@ export function printBanner() {
     console.log(VERSION_INFO);
     console.log('');
 }
+/** Show the standalone wizard logo and version at wizard start (branded top). */
+export function printWizardLogo() {
+    console.clear();
+    console.log(WIZARD_LOGO);
+    console.log(VERSION_INFO);
+    console.log('');
+}
 export function printWizardBanner() {
     console.log(WIZARD_BANNER);
     console.log(FEATURES_GRAPHIC);

package/dist/cli/commands/agent-card.command.js

@@ -16,7 +16,8 @@ import { AgentCardGenerator } from '../../services/agent-card-generator.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export const agentCardCommand = new Command('agent-card')
-    .description('Generate and validate .well-known/agent-card.json from OSSA manifests');
+    .description('Generate and validate agent cards from OSSA manifests. Serve at .well-known/agent-card.json or .well-known/agent.json (A2A). Card is a projection; manifest is single source of truth.')
+    .addHelpText('after', 'Well-known: For A2A compatibility serve the same JSON at /.well-known/agent.json. OSSA schema: spec/v0.4/agent-card.schema.json');
 // ── ossa agent-card generate ──────────────────────────────────────────
 agentCardCommand
     .command('generate')
@@ -27,8 +28,12 @@ agentCardCommand
     .option('--http <url>', 'HTTP endpoint URL')
     .option('--grpc <url>', 'gRPC endpoint URL')
     .option('--websocket <url>', 'WebSocket endpoint URL')
+    .option('--manifest-ref <url>', 'URL to full OSSA manifest (single source of truth)')
+    .option('--manifest-digest <digest>', 'Content digest of manifest (e.g. SHA-256)')
+    .option('--compute-digest', 'Compute SHA-256 digest from manifest content')
+    .option('--card-profile <profile>', 'Card profile: minimal, discovery, or full', 'full')
     .option('--stdout', 'Print to stdout instead of writing file')
-    .description('Generate agent-card.json from an OSSA manifest')
+    .description('Generate agent-card.json from an OSSA manifest. Serve at .well-known/agent-card.json or .well-known/agent.json (A2A).')
     .action(async (manifestPath, opts) => {
     try {
         // Read manifest
@@ -39,8 +44,7 @@ agentCardCommand
         }
         const content = fs.readFileSync(fullPath, 'utf-8');
         let manifest;
-        if (fullPath.endsWith('.yaml') ||
-            fullPath.endsWith('.yml')) {
+        if (fullPath.endsWith('.yaml') || fullPath.endsWith('.yml')) {
             manifest = yaml.load(content);
         }
         else {
@@ -54,13 +58,20 @@ agentCardCommand
             endpoints.grpc = opts.grpc;
         if (opts.websocket)
             endpoints.websocket = opts.websocket;
+        const profile = opts.cardProfile === 'minimal' ||
+            opts.cardProfile === 'discovery' ||
+            opts.cardProfile === 'full'
+            ? opts.cardProfile
+            : undefined;
         const generator = new AgentCardGenerator();
         const result = generator.generate(manifest, {
             namespace: opts.namespace,
             uri: opts.uri,
-            endpoints: Object.keys(endpoints).length > 0
-                ? endpoints
-                : undefined,
+            endpoints: Object.keys(endpoints).length > 0 ? endpoints : undefined,
+            manifestRef: opts.manifestRef,
+            manifestDigest: opts.manifestDigest,
+            manifestContent: opts.computeDigest ? content : undefined,
+            cardProfile: profile,
         });
         // Show warnings
         for (const warning of result.warnings) {

package/dist/cli/commands/agent-wizard.command.js

@@ -16,19 +16,20 @@
  * SOLID: Single Responsibility - Agent wizard orchestration only
  * DRY: Reuses existing services and utilities
  */
+import chalk from 'chalk';
 import { Command } from 'commander';
+import * as fs from 'fs';
 import inquirer from 'inquirer';
 import ora from 'ora';
-import * as fs from 'fs';
 import * as path from 'path';
-import * as yaml from 'yaml';
-import chalk from 'chalk';
 import { IdCardService } from '../../services/id-card.service.js';
-import { console_ui, formatAgentType, } from '../wizard/ui/console.js';
+import { getApiVersion, getVersion } from '../../utils/version.js';
+import { safeParseYAML, safeStringifyYAML } from '../../utils/yaml-parser.js';
 import { AGENT_TYPES } from '../wizard/data/agent-types.js';
 import { LLM_PROVIDERS, estimateMonthlyCost, } from '../wizard/data/llm-providers.js';
 import { AGENT_TEMPLATES, getTemplateById, getTemplatesByType, } from '../wizard/data/templates.js';
-import { getApiVersion } from '../../utils/version.js';
+import { console_ui, formatAgentType } from '../wizard/ui/console.js';
+import { printWizardLogo } from '../banner.js';
 /**
  * Create a new agent using the interactive wizard
  */
@@ -52,7 +53,8 @@ async function createAgentWizard(options) {
         canUndo: false,
         history: [],
     };
-    // Show welcome header
+    // Branded logo and welcome
+    printWizardLogo();
     console_ui.header('OSSA Agent Creation Wizard', 'Create production-ready agents step-by-step');
     console.log(chalk.gray('This wizard will guide you through creating a complete OSSA agent.'));
     console.log(chalk.gray('You can use defaults, templates, or customize every detail.\n'));
@@ -232,7 +234,7 @@ async function createFromExample(state, options) {
         state.agent = JSON.parse(exampleContent);
     }
     else {
-        state.agent = yaml.parse(exampleContent);
+        state.agent = safeParseYAML(exampleContent);
     }
     console_ui.success(`Loaded example: ${path.basename(examplePath)}`);
     // Customize
@@ -242,6 +244,7 @@ async function createFromExample(state, options) {
  * Create a custom agent step-by-step
  */
 async function createCustomAgent(state, options) {
+    state.totalSteps = 15;
     // Step 1: Agent Type
     await selectAgentType(state);
     // Step 2: Basic Information
@@ -260,8 +263,30 @@ async function createCustomAgent(state, options) {
     await configureObservability(state);
     // Step 9: Extensions
     await configureExtensions(state);
-    // Step 10: Save
-    await saveAgent(state, options);
+    // Step 10: Separation of Duties
+    const { configureSeparationOfDutiesStep } = await import('../wizard/steps/09b-separation-of-duties.js');
+    await configureSeparationOfDutiesStep(state);
+    // Step 11: Token Efficiency (v0.4)
+    const { configureTokenEfficiencyStep } = await import('../wizard/steps/09a-token-efficiency.js');
+    await configureTokenEfficiencyStep(state);
+    // Step 12: Deployment
+    const { configureDeploymentStep } = await import('../wizard/steps/08-deployment.js');
+    await configureDeploymentStep(state);
+    // Step 12a: Target export platforms (multi-select + matrix summary)
+    const { configureTargetPlatformsStep } = await import('../wizard/steps/08a-target-platforms.js');
+    state = await configureTargetPlatformsStep(state);
+    // Step 13: AGENTS.md (agents.md standard)
+    const { configureAgentsMdStep } = await import('../wizard/steps/09c-agents-md.js');
+    await configureAgentsMdStep(state);
+    // Step 14: Drupal Tools + ECA
+    const { configureDrupalToolsEcaStep } = await import('../wizard/steps/09d-drupal-tools-eca.js');
+    await configureDrupalToolsEcaStep(state);
+    // Step 15: Memory Management (v0.4)
+    const { configureMemoryManagementStep } = await import('../wizard/steps/09e-memory-management.js');
+    await configureMemoryManagementStep(state);
+    // Step 16: Review & Save
+    const { reviewAndSaveStep } = await import('../wizard/steps/10-review.js');
+    await reviewAndSaveStep(state, options);
 }
 /**
  * Step 1: Select agent type
@@ -719,7 +744,7 @@ async function saveAgent(state, options) {
             content = JSON.stringify(state.agent, null, 2);
         }
         else {
-            content = yaml.stringify(state.agent, {
+            content = safeStringifyYAML(state.agent, {
                 indent: 2,
                 lineWidth: 0,
             });
@@ -755,7 +780,7 @@ async function listAgents(options) {
         const content = fs.readFileSync(agentPath, 'utf-8');
         const agent = agentPath.endsWith('.json')
             ? JSON.parse(content)
-            : yaml.parse(content);
+            : safeParseYAML(content);
         return [
             agent.metadata?.name || 'Unknown',
             agent.metadata?.version || 'N/A',
@@ -778,7 +803,7 @@ async function showAgent(name, options) {
         return;
     }
     const content = fs.readFileSync(agentPath, 'utf-8');
-    const agent = yaml.parse(content);
+    const agent = safeParseYAML(content);
     console_ui.section('Metadata');
     console_ui.success(`Name: ${agent.metadata?.name}`);
     console_ui.success(`Version: ${agent.metadata?.version}`);
@@ -899,7 +924,7 @@ async function updateAgent(name, options) {
         return;
     }
     const content = fs.readFileSync(agentPath, 'utf-8');
-    const agent = yaml.parse(content);
+    const agent = safeParseYAML(content);
     if (options.field) {
         // Update specific field
         const { value } = await inquirer.prompt([
@@ -977,7 +1002,7 @@ async function updateAgent(name, options) {
         }
     }
     // Save updated manifest
-    const yamlContent = yaml.stringify(agent, {
+    const yamlContent = safeStringifyYAML(agent, {
         indent: 2,
         lineWidth: 0,
     });
@@ -996,7 +1021,7 @@ async function validateAgentManifest(manifestPath, options) {
     const spinner = ora('Validating manifest...').start();
     try {
         const content = fs.readFileSync(manifestPath, 'utf-8');
-        const agent = yaml.parse(content);
+        const agent = safeParseYAML(content);
         const errors = [];
         const warnings = [];
         // Required fields validation
@@ -1064,9 +1089,9 @@ async function validateAgentManifest(manifestPath, options) {
         }
         if (options.verbose) {
             console_ui.info('\nManifest summary:');
-            console_ui.success(`Name: ${agent.metadata.name}`);
-            console_ui.success(`Version: ${agent.metadata.version}`);
-            console_ui.success(`LLM: ${agent.spec.llm.provider}/${agent.spec.llm.model}`);
+            console_ui.success(`Name: ${agent.metadata?.name || 'N/A'}`);
+            console_ui.success(`Version: ${agent.metadata?.version || 'N/A'}`);
+            console_ui.success(`LLM: ${agent.spec?.llm?.provider || 'N/A'}/${agent.spec?.llm?.model || 'N/A'}`);
             console_ui.success(`Tools: ${agent.spec?.tools?.length || 0}`);
         }
     }
@@ -1077,13 +1102,13 @@ async function validateAgentManifest(manifestPath, options) {
     }
 }
 // ============================================================================
-// Agent ID Card Wizard (v0.4.5+)
+// Agent ID Card Wizard (v0.4.6+)
 // ============================================================================
 /**
  * Interactive wizard to create or update an Agent ID Card
  */
 async function idCardWizard(options) {
-    console_ui.header('Agent ID Card Wizard', 'Create a human-friendly identity for your agent (v0.4.5+)');
+    console_ui.header('Agent ID Card Wizard', 'Create a human-friendly identity for your agent (v0.4.6+)');
     // Load existing manifest if provided
     let agent = null;
     let manifestPath = options.manifest;
@@ -1091,7 +1116,7 @@ async function idCardWizard(options) {
         const content = fs.readFileSync(manifestPath, 'utf-8');
         agent = manifestPath.endsWith('.json')
             ? JSON.parse(content)
-            : yaml.parse(content);
+            : safeParseYAML(content);
         console_ui.success(`Loaded manifest: ${manifestPath}`);
     }
     else if (!manifestPath) {
@@ -1107,7 +1132,7 @@ async function idCardWizard(options) {
                 const content = fs.readFileSync(candidate, 'utf-8');
                 agent = candidate.endsWith('.json')
                     ? JSON.parse(content)
-                    : yaml.parse(content);
+                    : safeParseYAML(content);
                 manifestPath = candidate;
                 console_ui.success(`Auto-detected manifest: ${candidate}`);
                 break;
@@ -1116,7 +1141,7 @@ async function idCardWizard(options) {
     }
     if (!agent) {
         agent = {
-            apiVersion: 'ossa/v0.4.5',
+            apiVersion: getApiVersion(),
             kind: 'Agent',
             metadata: { name: '' },
             spec: { role: '' },
@@ -1186,7 +1211,7 @@ async function idCardWizard(options) {
         },
     ]);
     const defaultRegistryId = agent.metadata.name
-        ? `ossa://blueflyio/${agent.metadata.name}@${agent.metadata.version || '0.4.5'}`
+        ? `ossa://${process.env.OSSA_ORG || 'my-org'}/${agent.metadata.name}@${agent.metadata.version || getVersion()}`
         : '';
     const { registryId } = await inquirer.prompt([
         {
@@ -1222,7 +1247,7 @@ async function idCardWizard(options) {
             type: 'input',
             name: 'createdWith',
             message: 'Created with (tool/CLI version):',
-            default: existingProvenance?.createdWith || 'ossa-cli/0.4.5',
+            default: existingProvenance?.createdWith || `ossa-cli/${getVersion()}`,
         },
     ]);
     // Lineage (if forked/derived)
@@ -1423,19 +1448,20 @@ async function idCardWizard(options) {
     // Save
     if (options.dryRun) {
         console_ui.info('Dry run — showing YAML output:');
-        console.log('\n' + chalk.gray(yaml.stringify({ idCard }, { indent: 2, lineWidth: 0 })));
+        console.log('\n' +
+            chalk.gray(safeStringifyYAML({ idCard }, { indent: 2, lineWidth: 0 })));
         return;
     }
     const outputPath = options.output || manifestPath;
     if (!outputPath) {
         // No manifest, output standalone ID card YAML
-        const idCardYaml = yaml.stringify({ idCard }, { indent: 2, lineWidth: 0 });
+        const idCardYaml = safeStringifyYAML({ idCard }, { indent: 2, lineWidth: 0 });
         console.log('\n' + idCardYaml);
         console_ui.info('No output path specified. Copy the YAML above into your manifest under metadata.idCard');
         return;
     }
     // Save full manifest
-    const yamlContent = yaml.stringify(agent, {
+    const yamlContent = safeStringifyYAML(agent, {
         indent: 2,
         lineWidth: 0,
     });
@@ -1453,6 +1479,7 @@ async function idCardWizard(options) {
 // ============================================================================
 export const agentWizardCommand = new Command('agent-wizard')
     .description("Interactive wizard for creating OSSA agents (THE WORLD'S BEST)")
+    .addHelpText('after', 'Token efficiency and deployment: https://openstandardagents.org/docs/token-efficiency-and-deployment-tuning')
     .option('-o, --output <path>', 'Output file path', 'agent.ossa.yaml')
     .option('-d, --directory <dir>', 'Agent directory', '.agents')
     .option('-t, --template <id>', 'Use a template')

package/dist/cli/commands/agents-local.command.js

@@ -6,11 +6,9 @@ import chalk from 'chalk';
 import { Command } from 'commander';
 import * as fs from 'fs';
 import * as path from 'path';
-import * as yaml from 'yaml';
-const AGENTS_DIR = '.agents';
-const WORKSPACE_DIR = '.agents-workspace';
-const MANIFEST_NAME = 'agent.ossa.yaml';
-const REGISTRY_NAME = 'registry.yaml';
+import { getApiVersion } from '../../utils/version.js';
+import { AGENTS_DIR, WORKSPACE_DIR, MANIFEST_NAME, REGISTRY_NAME, } from '../../utils/constants.js';
+import { safeParseYAML, safeStringifyYAML } from '../../utils/yaml-parser.js';
 /**
  * Initialize .agents/ structure in current project
  */
@@ -74,7 +72,7 @@ const addCommand = new Command('add')
     }
     fs.mkdirSync(agentDir, { recursive: true });
     const manifest = {
-        apiVersion: 'ossa/v0.4.5',
+        apiVersion: getApiVersion(),
         kind: 'Agent',
         metadata: {
             name,
@@ -96,7 +94,7 @@ const addCommand = new Command('add')
             tools: [],
         },
     };
-    fs.writeFileSync(path.join(agentDir, MANIFEST_NAME), yaml.stringify(manifest));
+    fs.writeFileSync(path.join(agentDir, MANIFEST_NAME), safeStringifyYAML(manifest));
     console.log(chalk.green(`Created ${AGENTS_DIR}/${name}/${MANIFEST_NAME}`));
     console.log(chalk.gray(`\nEdit the manifest, then run: ossa agents sync`));
 });
@@ -126,7 +124,7 @@ const syncCommand = new Command('sync')
         }
         try {
             const content = fs.readFileSync(manifestPath, 'utf-8');
-            const manifest = yaml.parse(content);
+            const manifest = safeParseYAML(content);
             agents.push({
                 name: manifest.metadata?.name || entry.name,
                 manifest: `${entry.name}/${MANIFEST_NAME}`,
@@ -191,7 +189,7 @@ const localListCommand = new Command('local')
     let agents = [];
     if (fs.existsSync(registryPath)) {
         const content = fs.readFileSync(registryPath, 'utf-8');
-        const registry = yaml.parse(content);
+        const registry = safeParseYAML(content);
         agents = registry?.agents || [];
     }
     else {
@@ -205,7 +203,7 @@ const localListCommand = new Command('local')
             const manifestPath = path.join(agentsDir, entry.name, MANIFEST_NAME);
             if (fs.existsSync(manifestPath)) {
                 try {
-                    const manifest = yaml.parse(fs.readFileSync(manifestPath, 'utf-8'));
+                    const manifest = safeParseYAML(fs.readFileSync(manifestPath, 'utf-8'));
                     agents.push({
                         name: manifest.metadata?.name || entry.name,
                         manifest: `${entry.name}/${MANIFEST_NAME}`,

package/dist/cli/commands/agents-md.command.js

@@ -7,6 +7,7 @@ import chalk from 'chalk';
 import { container } from '../../di-container.js';
 import { ManifestRepository } from '../../repositories/manifest.repository.js';
 import { AgentsMdService } from '../../services/agents-md/agents-md.service.js';
+import { AgentsMdDiscoveryService } from '../../services/agents-md/agents-md-discovery.service.js';
 import { handleCommandError } from '../utils/index.js';
 export const agentsMdCommand = new Command('agents-md').description('Generate, validate, and sync OpenAI agents.md files from OSSA manifests');
 // Generate subcommand
@@ -131,8 +132,7 @@ extensions:
         await agentsMdService.syncAgentsMd(manifestPath, options.watch || false);
         console.log(chalk.green('✓ AGENTS.md synced successfully'));
         if (options.watch) {
-            console.log(chalk.blue('\n👀 Watching for changes... (Press Ctrl+C to stop)'));
-            // Keep process alive for watching
+            console.log(chalk.blue('\nWatching for changes... (Press Ctrl+C to stop)'));
             await new Promise(() => { });
         }
         else {
@@ -143,4 +143,94 @@ extensions:
         handleCommandError(error);
     }
 });
+// Discover subcommand: find all AGENTS.md files and their manifests
+agentsMdCommand
+    .command('discover')
+    .argument('[dir]', 'Workspace directory to scan', process.cwd())
+    .option('-v, --verbose', 'Show validation warnings')
+    .description('Discover all AGENTS.md files in workspace (.agents/*/ and root) for update and maintenance')
+    .action(async (dir, options) => {
+    try {
+        const baseDir = dir || process.cwd();
+        console.log(chalk.blue(`Discovering AGENTS.md in ${baseDir}...`));
+        const discovery = container.get(AgentsMdDiscoveryService);
+        const results = await discovery.discover(baseDir);
+        if (results.length === 0) {
+            console.log(chalk.yellow('No AGENTS.md files or .agents/ agents found.'));
+            console.log(chalk.gray('Create agents with the wizard (step 9c) or run ossa agents-md generate <manifest>'));
+            process.exit(0);
+            return;
+        }
+        console.log(chalk.bold(`\nDiscovered ${results.length} AGENTS.md entry(ies):\n`));
+        console.log('Path'.padEnd(60) +
+            'Agent'.padEnd(24) +
+            'Manifest'.padEnd(12) +
+            'Status');
+        console.log('─'.repeat(100));
+        for (const r of results) {
+            const relPath = r.agentsMdPath.replace(baseDir, '').replace(/^\//, '') || 'AGENTS.md';
+            const agent = (r.agentName ?? '-').padEnd(22);
+            const hasManifest = r.manifestPath ? 'yes' : 'no ';
+            let status;
+            if (r.valid === null)
+                status = chalk.yellow('missing');
+            else if (r.valid)
+                status = chalk.green('valid');
+            else
+                status = chalk.red('invalid');
+            console.log(`${relPath.padEnd(60)}${agent}${hasManifest.padEnd(12)}${status}`);
+            if (options.verbose && r.warnings.length > 0) {
+                r.warnings.forEach((w) => console.log(chalk.gray(`  - ${w}`)));
+            }
+        }
+        console.log(chalk.gray('\nRun ossa agents-md maintain [dir] to validate and regenerate outdated AGENTS.md'));
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error);
+    }
+});
+// Maintain subcommand: discover then validate/regenerate to update and maintain
+agentsMdCommand
+    .command('maintain')
+    .argument('[dir]', 'Workspace directory to scan', process.cwd())
+    .option('-r, --regenerate', 'Regenerate all (not only invalid) from manifest')
+    .option('--dry-run', 'Only report what would be updated')
+    .option('-v, --verbose', 'Verbose output')
+    .description('Discover AGENTS.md files and update/maintain them (validate, regenerate invalid or all)')
+    .action(async (dir, options) => {
+    try {
+        const baseDir = dir || process.cwd();
+        console.log(chalk.blue(`Maintaining AGENTS.md in ${baseDir}...`));
+        const discovery = container.get(AgentsMdDiscoveryService);
+        const { discovered, updated, skipped, failed } = await discovery.maintain(baseDir, {
+            regenerate: options.regenerate ?? false,
+            dryRun: options.dryRun,
+        });
+        if (discovered.length === 0) {
+            console.log(chalk.yellow('Nothing to maintain. Run ossa agents-md discover to list.'));
+            process.exit(0);
+            return;
+        }
+        if (options.verbose || updated.length > 0 || failed.length > 0) {
+            console.log(chalk.bold('\nMaintain result:'));
+            console.log(chalk.green(`  Updated: ${updated.length}`));
+            console.log(chalk.gray(`  Skipped (valid/no manifest): ${skipped.length}`));
+            if (failed.length > 0) {
+                console.log(chalk.red(`  Failed: ${failed.length}`));
+                failed.forEach((f) => console.log(chalk.red(`    ${f.path}: ${f.error}`)));
+            }
+        }
+        if (updated.length > 0) {
+            console.log(chalk.green('\nUpdated:'));
+            updated.forEach((p) => console.log(chalk.cyan(`  ${p}`)));
+        }
+        if (failed.length > 0)
+            process.exit(1);
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error);
+    }
+});
 //# sourceMappingURL=agents-md.command.js.map

package/dist/cli/commands/build.command.js

@@ -9,6 +9,7 @@ import * as path from 'path';
 import { stringify as yamlStringify } from 'yaml';
 import { container } from '../../di-container.js';
 import { ManifestRepository } from '../../repositories/manifest.repository.js';
+import { ValidationService } from '../../services/validation.service.js';
 import { KAgentCRDGenerator } from '../../sdks/kagent/crd-generator.js';
 import { getBuildDefaults } from '../../config/defaults.js';
 export const buildCommand = new Command('build')
@@ -27,7 +28,11 @@ export const buildCommand = new Command('build')
         const manifest = await manifestRepo.load(manifestPath);
         if (options.validate) {
             console.log(chalk.yellow('Validating manifest...'));
-            // TODO: Add validation
+            const svc = container.get(ValidationService);
+            const result = await svc.validate(manifest);
+            if (!result.valid) {
+                throw new Error(result.errors?.join('; ') ?? 'Validation failed');
+            }
             console.log(chalk.green('✓ Manifest valid\n'));
         }
         // Create output directory

package/dist/cli/commands/catalog/list.command.js

@@ -43,7 +43,7 @@ export function createListCommand() {
                 id: info.id,
                 hasOssa,
                 hasDuo,
-                syncStatus: hasDuo ? 'synced' : 'unsynced', // Simplified - TODO: check remote
+                syncStatus: hasDuo ? 'synced' : 'unsynced',
                 version,
             };
         });

package/dist/cli/commands/catalog/schemas.d.ts

@@ -46,8 +46,8 @@ export declare const ListOptionsSchema: z.ZodObject<{
         table: "table";
     }>>;
     status: z.ZodDefault<z.ZodEnum<{
-        all: "all";
         modified: "modified";
+        all: "all";
         synced: "synced";
         unsynced: "unsynced";
     }>>;

package/dist/cli/commands/daemon.command.d.ts

@@ -0,0 +1,9 @@
+/**
+ * OSSA Daemon Command
+ * Local development daemon for Neural Forge real-time builder integration
+ *
+ * @experimental This feature is experimental and may change without notice.
+ */
+import { Command } from 'commander';
+export declare const daemonCommand: Command;
+//# sourceMappingURL=daemon.command.d.ts.map