@bluefly/openstandardagents 0.2.7 → 0.2.8

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAoCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,YAAY,UAAQ,GAAG,WAAW,CAiDhE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAc/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/utils/version.js

@@ -0,0 +1,156 @@
+/**
+ * OSSA Version Utilities
+ *
+ * Provides dynamic version detection from package.json
+ * NEVER hardcode version strings - use these utilities
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+// Cache the version info once resolved
+let cachedVersionInfo = null;
+/**
+ * Find package.json by searching upward from a starting directory
+ */
+function findPackageJson(startDir) {
+    let current = startDir;
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.resolve(current, 'package.json');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Parse version string into components
+ */
+function parseVersion(version) {
+    // Handle versions like "0.2.8", "0.2.8-RC", "0.2.8-beta.1"
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/);
+    if (!match) {
+        throw new Error(`Invalid version format: ${version}`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+        prerelease: match[4]
+    };
+}
+/**
+ * Get OSSA version information dynamically from package.json
+ *
+ * @param forceRefresh - If true, bypasses cache and re-reads package.json
+ * @returns VersionInfo object with all version details
+ *
+ * @example
+ * const { version, schemaPath, apiVersion } = getVersionInfo();
+ * console.log(`Using OSSA ${version}`);
+ * console.log(`Schema at: ${schemaPath}`);
+ */
+export function getVersionInfo(forceRefresh = false) {
+    if (cachedVersionInfo && !forceRefresh) {
+        return cachedVersionInfo;
+    }
+    let version = '0.2.8'; // Ultimate fallback
+    // Try to find package.json
+    // Strategy 1: From this file's location (works in dist)
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        const pkgPath = findPackageJson(__dirname);
+        if (pkgPath) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            version = pkg.version;
+        }
+    }
+    catch {
+        // Strategy 2: From process.cwd()
+        try {
+            const pkgPath = findPackageJson(process.cwd());
+            if (pkgPath) {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+                version = pkg.version;
+            }
+        }
+        catch {
+            // Use fallback
+        }
+    }
+    // Strategy 3: Check environment variable override
+    if (process.env.OSSA_VERSION) {
+        version = process.env.OSSA_VERSION;
+    }
+    const parsed = parseVersion(version);
+    const schemaDir = `v${version}`;
+    const schemaFile = `ossa-${version}.schema.json`;
+    cachedVersionInfo = {
+        version,
+        ...parsed,
+        schemaDir,
+        schemaFile,
+        schemaPath: `spec/${schemaDir}/${schemaFile}`,
+        apiVersion: `ossa.io/${schemaDir}`
+    };
+    return cachedVersionInfo;
+}
+/**
+ * Get just the version string (convenience function)
+ */
+export function getVersion() {
+    return getVersionInfo().version;
+}
+/**
+ * Get the schema path (convenience function)
+ */
+export function getSchemaPath() {
+    return getVersionInfo().schemaPath;
+}
+/**
+ * Get the API version for manifests (convenience function)
+ */
+export function getApiVersion() {
+    return getVersionInfo().apiVersion;
+}
+/**
+ * Get the schema directory (e.g., "v0.2.8")
+ */
+export function getSchemaDir() {
+    return getVersionInfo().schemaDir;
+}
+/**
+ * Check if version is a prerelease
+ */
+export function isPrerelease() {
+    return getVersionInfo().prerelease !== undefined;
+}
+/**
+ * Get supported schema versions (for migration, validation)
+ * Returns versions in descending order (newest first)
+ */
+export function getSupportedVersions() {
+    const current = getVersionInfo();
+    // Generate supported versions dynamically
+    // Current version + 2 previous minor versions
+    const versions = [current.version];
+    // Add previous minor versions if they exist
+    for (let i = 1; i <= 2; i++) {
+        if (current.minor - i >= 0) {
+            versions.push(`${current.major}.${current.minor - i}.0`);
+        }
+    }
+    return versions;
+}
+/**
+ * Resolve absolute path to schema file
+ */
+export function resolveSchemaPath(projectRoot) {
+    const root = projectRoot || process.cwd();
+    return path.resolve(root, getVersionInfo().schemaPath);
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"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"}

package/eslint-report.json

@@ -0,0 +1 @@
+[{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/export.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/generate.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/github-sync.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/gitlab-agent.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/import.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/init.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/migrate.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/release.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/run.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/schema.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/setup.command.ts","messages":[{"ruleId":"@typescript-eslint/no-unused-vars","severity":1,"message":"'options' is defined but never used. Allowed unused args must match /^_/u.","line":214,"column":15,"nodeType":null,"messageId":"unusedVar","endLine":214,"endColumn":22}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":1,"fixableErrorCount":0,"fixableWarningCount":0,"source":"/**\n * OSSA Setup Command\n * Professional setup commands for branch protection and release automation\n * Follows DRY, OpenAPI, Zod, CRUD principles\n */\n\nimport chalk from 'chalk';\nimport { Command } from 'commander';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { execSync } from 'child_process';\nimport { z } from 'zod';\n\n/**\n * Zod Schema for Setup Options\n */\nconst SetupOptionsSchema = z.object({\n  force: z.boolean().optional().default(false),\n  verbose: z.boolean().optional().default(false),\n});\n\ntype SetupOptions = z.infer<typeof SetupOptionsSchema>;\n\n/**\n * Base Setup Service (DRY)\n */\nclass SetupService {\n  protected projectRoot: string;\n\n  constructor() {\n    this.projectRoot = this.findProjectRoot();\n  }\n\n  protected findProjectRoot(): string {\n    let current = process.cwd();\n    for (let i = 0; i < 10; i++) {\n      const packageJson = path.join(current, 'package.json');\n      if (fs.existsSync(packageJson)) {\n        return current;\n      }\n      const parent = path.dirname(current);\n      if (parent === current) break;\n      current = parent;\n    }\n    return process.cwd();\n  }\n\n  protected log(message: string, type: 'info' | 'success' | 'warning' | 'error' = 'info'): void {\n    const colors = {\n      info: chalk.blue,\n      success: chalk.green,\n      warning: chalk.yellow,\n      error: chalk.red,\n    };\n    console.log(colors[type](message));\n  }\n\n  protected exec(command: string, options?: { cwd?: string; silent?: boolean }): string {\n    try {\n      const result = execSync(command, {\n        cwd: options?.cwd || this.projectRoot,\n        encoding: 'utf-8',\n        stdio: options?.silent ? 'pipe' : 'inherit',\n      });\n      return result.toString();\n    } catch {\n      throw new Error(`Command failed: ${command}`);\n    }\n  }\n\n  protected fileExists(filePath: string): boolean {\n    return fs.existsSync(path.resolve(this.projectRoot, filePath));\n  }\n\n  protected ensureDirectory(dirPath: string): void {\n    const fullPath = path.resolve(this.projectRoot, dirPath);\n    if (!fs.existsSync(fullPath)) {\n      fs.mkdirSync(fullPath, { recursive: true });\n    }\n  }\n}\n\n/**\n * Branch Protection Setup Service\n */\nclass BranchProtectionService extends SetupService {\n  private readonly protectedBranches = ['main', 'development'];\n  private readonly hooksDir = '.git/hooks';\n  private readonly hookFile = 'post-checkout';\n\n  async setup(options: SetupOptions): Promise<void> {\n    this.log('🔒 Setting up branch protection for main and development...', 'info');\n    this.log('');\n\n    // Ensure hooks directory exists\n    this.ensureDirectory(this.hooksDir);\n\n    // Create post-checkout hook\n    await this.createPostCheckoutHook(options.force);\n\n    // Configure git hooks path\n    this.exec('git config core.hooksPath .git/hooks', { silent: true });\n\n    this.log('');\n    this.log('✅ Branch protection installed!', 'success');\n    this.log('');\n    this.log(`Protected branches: ${this.protectedBranches.join(', ')}`);\n    this.log('');\n    this.log(\n      'The hook will automatically switch you back if you try to checkout these branches.'\n    );\n    this.log('');\n  }\n\n  private async createPostCheckoutHook(force: boolean): Promise<void> {\n    const hookPath = path.resolve(this.projectRoot, this.hooksDir, this.hookFile);\n\n    if (fs.existsSync(hookPath) && !force) {\n      this.log(`✅ Post-checkout hook already exists`, 'info');\n      // Ensure it's executable\n      fs.chmodSync(hookPath, 0o755);\n      return;\n    }\n\n    const hookContent = this.generateHookContent();\n    fs.writeFileSync(hookPath, hookContent, { mode: 0o755 });\n\n    this.log(`✅ Created post-checkout hook`, 'success');\n  }\n\n  private generateHookContent(): string {\n    return `#!/bin/bash\n#\n# Git Post-Checkout Hook\n# Prevents checking out main and development branches locally\n# Enforces feature branch workflow\n#\n\n# Post-checkout hook receives:\n# $1 = previous HEAD\n# $2 = new HEAD\n# $3 = flag (0=file checkout, 1=branch checkout)\n\n# Only block branch checkouts, not file checkouts\nif [ \"$3\" != \"1\" ]; then\n  exit 0\nfi\n\n# Get current branch name\nCURRENT_BRANCH=$(git branch --show-current 2>/dev/null)\n\n# Protected branches that cannot be checked out locally\nPROTECTED_BRANCHES=\"main development\"\n\n# Check if we're on a protected branch\nfor PROTECTED in $PROTECTED_BRANCHES; do\n  if [ \"$CURRENT_BRANCH\" = \"$PROTECTED\" ]; then\n    echo \"\"\n    echo \"❌ ERROR: Cannot work on '$PROTECTED' branch locally\"\n    echo \"\"\n    echo \"This project enforces a feature branch workflow:\"\n    echo \"  • Work is done on feature branches\"\n    echo \"  • Feature branches → merge to development (via MR)\"\n    echo \"  • Development → merge to main (via MR)\"\n    echo \"\"\n    echo \"Switching you back to your previous branch...\"\n    echo \"\"\n    \n    # Switch back to previous branch or a safe default\n    PREVIOUS_BRANCH=$(git reflog | grep \"checkout:\" | head -2 | tail -1 | awk '{print $NF}' | sed 's|.*:||')\n    \n    if [ -n \"$PREVIOUS_BRANCH\" ] && [ \"$PREVIOUS_BRANCH\" != \"$PROTECTED\" ]; then\n      git checkout \"$PREVIOUS_BRANCH\" 2>/dev/null\n      echo \"✅ Switched back to: $PREVIOUS_BRANCH\"\n    else\n      # Try to find a feature branch\n      FEATURE_BRANCH=$(git branch -a | grep -E \"feat/|feature/\" | head -1 | sed 's|.*/||' | xargs)\n      if [ -n \"$FEATURE_BRANCH\" ]; then\n        git checkout \"$FEATURE_BRANCH\" 2>/dev/null\n        echo \"✅ Switched to feature branch: $FEATURE_BRANCH\"\n      else\n        echo \"⚠️  Could not auto-switch. Please manually checkout a feature branch:\"\n        echo \"   git checkout -b feat/your-feature development\"\n      fi\n    fi\n    \n    echo \"\"\n    echo \"To work on this project:\"\n    echo \"  1. Create a feature branch: git checkout -b feat/your-feature development\"\n    echo \"  2. Make your changes\"\n    echo \"  3. Push and create a merge request\"\n    echo \"\"\n    echo \"If you need to view $PROTECTED:\"\n    echo \"  • Use: git worktree add ../project-$PROTECTED $PROTECTED\"\n    echo \"  • Or view on GitLab: https://gitlab.com/blueflyio/openstandardagents/-/tree/$PROTECTED\"\n    echo \"\"\n    exit 1\n  fi\ndone\n\n# Allow checkout\nexit 0\n`;\n  }\n}\n\n/**\n * Release Automation Setup Service\n */\nclass ReleaseAutomationService extends SetupService {\n  private readonly requiredDependencies = ['@gitbeaker/rest', '@octokit/rest'];\n  private readonly requiredEnvVars = ['GITLAB_TOKEN', 'NPM_TOKEN', 'GITHUB_TOKEN'];\n\n  async setup(options: SetupOptions): Promise<void> {\n    this.log('🚀 Release Automation Setup', 'info');\n    this.log('==============================', 'info');\n    this.log('');\n\n    // Check branch\n    await this.checkBranch();\n\n    // Check dependencies\n    await this.checkDependencies();\n\n    // Check CI/CD variables\n    this.checkCICDVariables();\n\n    // Check webhooks\n    this.checkWebhooks();\n\n    // Run tests\n    await this.runTests();\n\n    this.log('');\n    this.log('==============================', 'info');\n    this.log('✅ Setup checks complete!', 'success');\n    this.log('');\n    this.log('Next steps:');\n    this.log('  1. Configure webhooks in GitLab UI');\n    this.log('  2. Set CI/CD variables in GitLab UI');\n    this.log('  3. Create test milestone: v0.2.8-test');\n    this.log('  4. Verify automation works');\n    this.log('');\n  }\n\n  private async checkBranch(): Promise<void> {\n    try {\n      const branch = this.exec('git branch --show-current', { silent: true }).trim();\n      if (branch !== 'development') {\n        this.log(\n          `⚠️  Warning: Not on development branch (current: ${branch})`,\n          'warning'\n        );\n        this.log('   Switch to development first: git checkout development', 'warning');\n        throw new Error('Must be on development branch');\n      }\n      this.log('✅ On development branch', 'success');\n      this.log('');\n    } catch (error) {\n      if (error instanceof Error && error.message === 'Must be on development branch') {\n        throw error;\n      }\n      throw new Error('Failed to check git branch');\n    }\n  }\n\n  private async checkDependencies(): Promise<void> {\n    this.log('📦 Checking dependencies...', 'info');\n\n    for (const dep of this.requiredDependencies) {\n      try {\n        this.exec(`npm list ${dep}`, { silent: true });\n        this.log(`  ✅ ${dep}`, 'success');\n      } catch {\n        this.log(`  ❌ ${dep} not found`, 'error');\n        this.log('   Run: npm install', 'error');\n        throw new Error(`Missing dependency: ${dep}`);\n      }\n    }\n\n    this.log('✅ Dependencies installed', 'success');\n    this.log('');\n  }\n\n  private checkCICDVariables(): void {\n    this.log('🔐 Checking CI/CD variables...', 'info');\n    this.log('');\n    this.log('Required variables (set in GitLab UI):');\n    for (const varName of this.requiredEnvVars) {\n      const exists = !!process.env[varName];\n      const status = exists ? '✅' : '❌';\n      this.log(`  ${status} ${varName}${exists ? ' (set)' : ' (missing)'}`);\n    }\n    this.log('');\n    this.log('To set these:');\n    this.log('  1. Go to: Settings → CI/CD → Variables');\n    this.log('  2. Add each variable');\n    this.log('  3. Mark as \\'Protected\\' and \\'Masked\\'');\n    this.log('');\n  }\n\n  private checkWebhooks(): void {\n    this.log('🔗 Webhooks to configure:', 'info');\n    this.log('');\n    this.log('Webhook 1: Milestone Events');\n    this.log('  URL: https://your-webhook-endpoint.com/milestone');\n    this.log('  Trigger: Milestone events');\n    this.log('');\n    this.log('Webhook 2: Push Events');\n    this.log('  URL: https://your-webhook-endpoint.com/push');\n    this.log('  Trigger: Push events (development branch)');\n    this.log('');\n    this.log('To configure:');\n    this.log('  Go to: Settings → Webhooks');\n    this.log('');\n  }\n\n  private async runTests(): Promise<void> {\n    this.log('🧪 Running tests...', 'info');\n    try {\n      this.exec('npm test', { silent: false });\n      this.log('✅ All tests passing', 'success');\n    } catch {\n      this.log('❌ Tests failed', 'error');\n      throw new Error('Tests failed');\n    }\n  }\n}\n\n/**\n * Main Setup Command\n */\nexport const setupCommand = new Command('setup')\n  .description('Setup OSSA project tools and automation')\n  .option('-f, --force', 'Force overwrite existing configuration')\n  .option('-v, --verbose', 'Verbose output');\n\n/**\n * Branch Protection Subcommand\n */\nconst branchProtectionSubcommand = new Command('branch-protection')\n  .alias('bp')\n  .description('Setup git hooks to prevent checking out main/development locally')\n  .option('-f, --force', 'Force overwrite existing hooks')\n  .option('-v, --verbose', 'Verbose output')\n  .action(async (options: { force?: boolean; verbose?: boolean }) => {\n    try {\n      const validated = SetupOptionsSchema.parse(options);\n      const service = new BranchProtectionService();\n      await service.setup(validated);\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        console.error(chalk.red('Validation error:'), error.issues);\n        process.exit(1);\n      }\n      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);\n      process.exit(1);\n    }\n  });\n\n/**\n * Release Automation Subcommand\n */\nconst releaseAutomationSubcommand = new Command('release-automation')\n  .alias('ra')\n  .description('Setup release automation (dependencies, CI/CD variables, webhooks)')\n  .option('-f, --force', 'Force setup even if checks fail')\n  .option('-v, --verbose', 'Verbose output')\n  .action(async (options: { force?: boolean; verbose?: boolean }) => {\n    try {\n      const validated = SetupOptionsSchema.parse(options);\n      const service = new ReleaseAutomationService();\n      await service.setup(validated);\n    } catch (error) {\n      if (error instanceof z.ZodError) {\n        console.error(chalk.red('Validation error:'), error.issues);\n        process.exit(1);\n      }\n      console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);\n      process.exit(1);\n    }\n  });\n\n// Register subcommands\nsetupCommand.addCommand(branchProtectionSubcommand);\nsetupCommand.addCommand(releaseAutomationSubcommand);\n\n","usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/sync.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/commands/validate.command.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/cli/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/di-container.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/repositories/manifest.repository.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/repositories/schema.repository.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/generation.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/github-sync/github-client.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/github-sync/gitlab-client.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/github-sync/schemas.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/github-sync/sync.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/gitlab-agent.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/migration.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/base-crud.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/merge-request.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/milestone.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/release.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/schemas/release.schema.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/tag.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/release-automation/webhook.service.ts","messages":[{"ruleId":"@typescript-eslint/no-unused-vars","severity":1,"message":"'project' is assigned a value but never used.","line":50,"column":15,"nodeType":null,"messageId":"unusedVar","endLine":50,"endColumn":22},{"ruleId":"@typescript-eslint/no-unused-vars","severity":1,"message":"'project' is assigned a value but never used.","line":117,"column":13,"nodeType":null,"messageId":"unusedVar","endLine":117,"endColumn":20},{"ruleId":"@typescript-eslint/no-unused-vars","severity":1,"message":"'project' is assigned a value but never used.","line":145,"column":13,"nodeType":null,"messageId":"unusedVar","endLine":145,"endColumn":20}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":3,"fixableErrorCount":0,"fixableWarningCount":0,"source":"/**\n * Webhook Service\n * Handles GitLab webhooks with Zod validation\n */\n\nimport {\n  MilestoneWebhookPayloadSchema,\n  PushWebhookPayloadSchema,\n  WebhookResponseSchema,\n  type MilestoneWebhookPayload,\n  type PushWebhookPayload,\n  type WebhookResponse,\n} from './schemas/release.schema.js';\nimport { ReleaseService } from './release.service.js';\nimport { MilestoneService } from './milestone.service.js';\nimport { TagService } from './tag.service.js';\nimport { MergeRequestService } from './merge-request.service.js';\n\n/**\n * Webhook Service\n * DRY: Centralized webhook handling\n */\nexport class WebhookService {\n  private releaseService: ReleaseService;\n  private milestoneService: MilestoneService;\n  private tagService: TagService;\n  private mergeRequestService: MergeRequestService;\n\n  constructor(\n    gitlabToken: string,\n    projectId: string | number = process.env.CI_PROJECT_ID || ''\n  ) {\n    this.releaseService = new ReleaseService(gitlabToken, projectId);\n    this.milestoneService = new MilestoneService(gitlabToken, projectId);\n    this.tagService = new TagService(gitlabToken, projectId);\n    this.mergeRequestService = new MergeRequestService(gitlabToken, projectId);\n  }\n\n  /**\n   * Handle milestone webhook\n   */\n  async handleMilestoneWebhook(\n    payload: unknown\n  ): Promise<WebhookResponse> {\n    try {\n      // Validate payload with Zod\n      const validated = MilestoneWebhookPayloadSchema.parse(payload);\n      const actions: WebhookResponse['actions'] = [];\n\n      const { project, object_attributes: milestone } = validated;\n\n      // Determine if this is a create or close event\n      const isNewMilestone =\n        milestone.state === 'active' &&\n        new Date(milestone.created_at).getTime() ===\n          new Date(milestone.updated_at).getTime();\n\n      if (isNewMilestone) {\n        // Milestone created - create dev tag and branch\n        const action = await this.handleMilestoneCreate(validated);\n        if (action) actions.push(action);\n      } else if (milestone.state === 'closed') {\n        // Milestone closed - create RC\n        const action = await this.handleMilestoneClose(validated);\n        if (action) actions.push(action);\n      }\n\n      return WebhookResponseSchema.parse({\n        success: true,\n        message: `Milestone ${milestone.title} processed`,\n        actions,\n      });\n    } catch (error) {\n      return WebhookResponseSchema.parse({\n        success: false,\n        message: `Webhook processing failed: ${error}`,\n        actions: [],\n      });\n    }\n  }\n\n  /**\n   * Handle push webhook\n   */\n  async handlePushWebhook(payload: unknown): Promise<WebhookResponse> {\n    try {\n      // Validate payload with Zod\n      const validated = PushWebhookPayloadSchema.parse(payload);\n      const actions: WebhookResponse['actions'] = [];\n\n      // Only process development branch pushes\n      if (validated.ref === 'refs/heads/development') {\n        const action = await this.handleDevelopmentPush(validated);\n        if (action) actions.push(action);\n      }\n\n      return WebhookResponseSchema.parse({\n        success: true,\n        message: 'Push webhook processed',\n        actions,\n      });\n    } catch (error) {\n      return WebhookResponseSchema.parse({\n        success: false,\n        message: `Webhook processing failed: ${error}`,\n        actions: [],\n      });\n    }\n  }\n\n  /**\n   * Handle milestone creation\n   */\n  private async handleMilestoneCreate(\n    payload: MilestoneWebhookPayload\n  ): Promise<{ type: string; status: string; details?: Record<string, unknown> } | null> {\n    const { project, object_attributes: milestone } = payload;\n    const version = milestone.title.replace(/^v/, '');\n\n    // Create initial dev tag\n    const devTag = `v${version}-dev.0`;\n    await this.tagService.create({\n      name: devTag,\n      ref: 'development',\n      message: `Initial dev tag for ${milestone.title}`,\n    });\n\n    return {\n      type: 'milestone_created',\n      status: 'success',\n      details: {\n        milestoneId: milestone.id,\n        tag: devTag,\n        version,\n      },\n    };\n  }\n\n  /**\n   * Handle milestone closure\n   */\n  private async handleMilestoneClose(\n    payload: MilestoneWebhookPayload\n  ): Promise<{ type: string; status: string; details?: Record<string, unknown> } | null> {\n    const { project, object_attributes: milestone } = payload;\n    const version = milestone.title.replace(/^v/, '');\n\n    // Get milestone statistics\n    const milestoneData = await this.milestoneService.read(milestone.id);\n    if (!milestoneData) {\n      throw new Error(`Milestone ${milestone.id} not found`);\n    }\n\n    // Check all issues are closed\n    if (milestoneData.statistics.openIssues > 0) {\n      throw new Error(\n        `Cannot create RC: ${milestoneData.statistics.openIssues} issues still open`\n      );\n    }\n\n    // Create RC tag\n    const rcTag = `v${version}-rc.1`;\n    await this.tagService.create({\n      name: rcTag,\n      ref: 'development',\n      message: `Release candidate for ${milestone.title}`,\n    });\n\n    // Create MR: development → main\n    const mr = await this.mergeRequestService.create({\n      sourceBranch: 'development',\n      targetBranch: 'main',\n      title: `Release ${milestone.title}`,\n      description: `Release candidate ${rcTag} for milestone ${milestone.title}`,\n      labels: ['release', 'automation'],\n      milestoneId: milestone.id,\n    });\n\n    return {\n      type: 'milestone_closed',\n      status: 'success',\n      details: {\n        milestoneId: milestone.id,\n        rcTag,\n        mergeRequestId: mr.id,\n      },\n    };\n  }\n\n  /**\n   * Handle development branch push\n   */\n  private async handleDevelopmentPush(\n    payload: PushWebhookPayload\n  ): Promise<{ type: string; status: string; details?: Record<string, unknown> } | null> {\n    // Auto-increment dev tag\n    // This would be implemented based on current version detection\n    // For now, return success\n\n    return {\n      type: 'dev_tag_incremented',\n      status: 'success',\n      details: {\n        branch: payload.ref,\n        commits: payload.commits.length,\n      },\n    };\n  }\n}\n\n","usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/runtime/claude/capability-mapper.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/runtime/claude/claude-adapter.ts","messages":[{"ruleId":"@typescript-eslint/no-unused-vars","severity":1,"message":"'options' is defined but never used. Allowed unused args must match /^_/u.","line":268,"column":5,"nodeType":null,"messageId":"unusedVar","endLine":268,"endColumn":12}],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":1,"fixableErrorCount":0,"fixableWarningCount":0,"source":"/**\n * Claude Runtime Adapter\n * Runs OSSA agents using Anthropic's Claude API\n */\n\nimport Anthropic from '@anthropic-ai/sdk';\nimport { ManifestParser } from './manifest-parser.js';\nimport { CapabilityMapper } from './capability-mapper.js';\nimport type {\n  OssaManifestWithAnthropic,\n  ClaudeMessage,\n  ClaudeRunOptions,\n  ClaudeAdapterConfig,\n  AgentInfo,\n  ToolHandler,\n  ClaudeTool,\n} from './types.js';\n\n/**\n * Claude adapter for executing OSSA agents\n */\nexport class ClaudeAdapter {\n  private client: Anthropic;\n  private parser: ManifestParser;\n  private mapper: CapabilityMapper;\n  private messages: ClaudeMessage[] = [];\n  private conversationHistory: Anthropic.MessageParam[] = [];\n\n  constructor(config: ClaudeAdapterConfig) {\n    // Initialize Anthropic client\n    this.client = new Anthropic({\n      apiKey: config.apiKey || process.env.ANTHROPIC_API_KEY,\n    });\n\n    // Initialize parser and mapper\n    this.parser = new ManifestParser(config.manifest);\n    this.mapper = new CapabilityMapper();\n\n    // Validate manifest\n    const validation = this.parser.validate();\n    if (!validation.valid) {\n      throw new Error(\n        `Invalid OSSA manifest: ${validation.errors.join(', ')}`\n      );\n    }\n\n    // Check if Anthropic integration is enabled\n    if (!this.parser.isAnthropicEnabled()) {\n      console.warn(\n        'Warning: Anthropic extension is disabled in manifest'\n      );\n    }\n\n    // Initialize tools\n    this.initializeTools();\n  }\n\n  /**\n   * Initialize tools from manifest\n   */\n  private initializeTools(): void {\n    // Map Claude extension tools first (highest priority)\n    const anthropicExt = this.parser.getAnthropicExtension();\n    if (anthropicExt?.tools) {\n      this.mapper.mapClaudeTools(anthropicExt.tools);\n    }\n\n    // Map OSSA spec tools\n    const specTools = this.parser.getSpecTools();\n    this.mapper.mapOssaTools(specTools);\n\n    // Map MCP capabilities if any\n    for (const tool of specTools) {\n      if (tool.type === 'mcp' && tool.capabilities) {\n        this.mapper.mapMcpCapabilities(tool.capabilities);\n      } else if (tool.type === 'http') {\n        this.mapper.mapHttpTool(tool);\n      }\n    }\n  }\n\n  /**\n   * Register a tool handler\n   */\n  registerToolHandler(name: string, handler: ToolHandler): boolean {\n    return this.mapper.registerToolHandler(name, handler);\n  }\n\n  /**\n   * Execute a tool call\n   */\n  private async executeTool(\n    name: string,\n    input: Record<string, unknown>\n  ): Promise<string> {\n    const tool = this.mapper.getTool(name);\n    if (!tool) {\n      return JSON.stringify({\n        error: `Tool '${name}' not found`,\n      });\n    }\n\n    if (tool.handler) {\n      try {\n        return await tool.handler(input);\n      } catch (error) {\n        return JSON.stringify({\n          error: `Error executing ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        });\n      }\n    }\n\n    // Default: return placeholder response\n    return JSON.stringify({\n      message: `Tool '${name}' executed`,\n      input,\n      note: 'No handler registered for this tool',\n    });\n  }\n\n  /**\n   * Initialize the conversation\n   */\n  initialize(): void {\n    this.messages = [];\n    this.conversationHistory = [];\n  }\n\n  /**\n   * Send a message and get a response\n   */\n  async chat(\n    userMessage: string,\n    options?: ClaudeRunOptions\n  ): Promise<string> {\n    // Add user message to history\n    this.conversationHistory.push({\n      role: 'user',\n      content: userMessage,\n    });\n\n    const tools = this.mapper.getClaudeTools();\n    let turnCount = 0;\n    const maxTurns = options?.maxTurns || 10;\n\n    while (turnCount < maxTurns) {\n      turnCount++;\n\n      if (options?.verbose) {\n        console.log(`\\n[Turn ${turnCount}/${maxTurns}]`);\n      }\n\n      // Call Claude API\n      const response = await this.client.messages.create({\n        model: this.parser.getModel(),\n        max_tokens: this.parser.getMaxTokens(),\n        temperature: this.parser.getTemperature(),\n        system: this.parser.getSystemPrompt(),\n        messages: this.conversationHistory,\n        tools: tools.length > 0 ? tools : undefined,\n        stop_sequences: this.parser.getStopSequences(),\n      });\n\n      if (options?.verbose) {\n        console.log(\n          `  Model: ${response.model}, Stop: ${response.stop_reason}`\n        );\n        console.log(\n          `  Tokens: ${response.usage.input_tokens} in, ${response.usage.output_tokens} out`\n        );\n      }\n\n      // Add assistant response to history\n      this.conversationHistory.push({\n        role: 'assistant',\n        content: response.content,\n      });\n\n      // Check if we need to execute tools\n      const toolUses = response.content.filter(\n        (block) => block.type === 'tool_use'\n      );\n\n      if (toolUses.length > 0) {\n        if (options?.verbose) {\n          console.log(`  [Executing ${toolUses.length} tool(s)...]`);\n        }\n\n        // Execute all tool calls\n        const toolResults: Array<{\n          type: 'tool_result';\n          tool_use_id: string;\n          content: string;\n        }> = [];\n\n        for (const toolUse of toolUses) {\n          if (toolUse.type !== 'tool_use') continue;\n\n          const { id, name, input } = toolUse;\n\n          if (options?.verbose) {\n            console.log(\n              `    → ${name}(${JSON.stringify(input).substring(0, 100)}...)`\n            );\n          }\n\n          const result = await this.executeTool(\n            name,\n            input as Record<string, unknown>\n          );\n\n          if (options?.verbose) {\n            console.log(\n              `    ← ${result.substring(0, 100)}${result.length > 100 ? '...' : ''}`\n            );\n          }\n\n          toolResults.push({\n            type: 'tool_result',\n            tool_use_id: id,\n            content: result,\n          });\n        }\n\n        // Add tool results to conversation\n        this.conversationHistory.push({\n          role: 'user',\n          content: toolResults,\n        });\n\n        // Continue the loop to get final response\n        continue;\n      }\n\n      // Check if we have a text response\n      const textBlocks = response.content.filter(\n        (block) => block.type === 'text'\n      );\n\n      if (textBlocks.length > 0) {\n        return textBlocks\n          .map((block) => (block.type === 'text' ? block.text : ''))\n          .join('\\n');\n      }\n\n      // No text and no tool calls - unexpected\n      if (response.stop_reason === 'end_turn') {\n        return '';\n      }\n\n      // Max tokens or stop sequence reached\n      if (\n        response.stop_reason === 'max_tokens' ||\n        response.stop_reason === 'stop_sequence'\n      ) {\n        return '[Response truncated due to length limit]';\n      }\n    }\n\n    return '[Max turns reached without completion]';\n  }\n\n  /**\n   * Stream a response (for future implementation)\n   */\n  async chatStream(\n    userMessage: string,\n    options?: ClaudeRunOptions\n  ): Promise<AsyncIterable<string>> {\n    // Add user message to history\n    this.conversationHistory.push({\n      role: 'user',\n      content: userMessage,\n    });\n\n    const tools = this.mapper.getClaudeTools();\n\n    const stream = await this.client.messages.stream({\n      model: this.parser.getModel(),\n      max_tokens: this.parser.getMaxTokens(),\n      temperature: this.parser.getTemperature(),\n      system: this.parser.getSystemPrompt(),\n      messages: this.conversationHistory,\n      tools: tools.length > 0 ? tools : undefined,\n    });\n\n    // Return async generator\n    return (async function* () {\n      for await (const chunk of stream) {\n        if (\n          chunk.type === 'content_block_delta' &&\n          chunk.delta.type === 'text_delta'\n        ) {\n          yield chunk.delta.text;\n        }\n      }\n    })();\n  }\n\n  /**\n   * Get agent information\n   */\n  getAgentInfo(): AgentInfo {\n    const metadata = this.parser.getMetadata();\n    const tools = Array.from(this.mapper.getTools().keys());\n\n    return {\n      name: metadata.name,\n      model: this.parser.getModel(),\n      tools,\n      provider: 'anthropic',\n    };\n  }\n\n  /**\n   * Get conversation history\n   */\n  getConversationHistory(): Anthropic.MessageParam[] {\n    return this.conversationHistory;\n  }\n\n  /**\n   * Clear conversation history\n   */\n  clearHistory(): void {\n    this.conversationHistory = [];\n    this.messages = [];\n  }\n\n  /**\n   * Get available tools\n   */\n  getTools(): ClaudeTool[] {\n    return this.mapper.getClaudeTools();\n  }\n\n  /**\n   * Get the Anthropic client (for advanced usage)\n   */\n  getClient(): Anthropic {\n    return this.client;\n  }\n\n  /**\n   * Get the manifest parser\n   */\n  getParser(): ManifestParser {\n    return this.parser;\n  }\n\n  /**\n   * Get the capability mapper\n   */\n  getMapper(): CapabilityMapper {\n    return this.mapper;\n  }\n\n  /**\n   * Create a Claude adapter from a manifest file\n   */\n  static async fromFile(\n    manifestPath: string,\n    apiKey?: string\n  ): Promise<ClaudeAdapter> {\n    const fs = await import('fs/promises');\n    const manifestContent = await fs.readFile(manifestPath, 'utf-8');\n    const manifest = JSON.parse(\n      manifestContent\n    ) as OssaManifestWithAnthropic;\n\n    return new ClaudeAdapter({\n      manifest,\n      apiKey,\n    });\n  }\n\n  /**\n   * Create a Claude adapter from a manifest object\n   */\n  static fromManifest(\n    manifest: OssaManifestWithAnthropic,\n    apiKey?: string\n  ): ClaudeAdapter {\n    return new ClaudeAdapter({\n      manifest,\n      apiKey,\n    });\n  }\n}\n","usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/runtime/claude/manifest-parser.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/runtime/claude/types.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/runtime/openai.adapter.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validation.service.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/anthropic.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/autogen.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/crewai.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/cursor.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/langchain.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/langflow.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/langgraph.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/llamaindex.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/openai.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/services/validators/vercel-ai.validator.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/types/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/types/openapi-extensions.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/utils/index.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]},{"filePath":"/Users/flux423/Sites/LLM/openstandardagents/src/utils/version.ts","messages":[],"suppressedMessages":[],"errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0,"usedDeprecatedRules":[{"ruleId":"no-extra-semi","replacedBy":[]},{"ruleId":"no-mixed-spaces-and-tabs","replacedBy":[]}]}]

package/examples/adk-integration/code-review-workflow.yml

@@ -1,7 +1,7 @@
 # Example: ADK Code Review Workflow with OSSA Agents
 # This demonstrates how OSSA agents work with ADK orchestration patterns
 
-apiVersion: '@ossa/v0.1.9'
+apiVersion: ossa/v0.2.8
 kind: Workflow
 metadata:
   name: code-review-workflow

package/examples/adk-integration/customer-support.yml

@@ -1,7 +1,7 @@
 # Example: ADK Customer Support System with OSSA Agents
 # Demonstrates Coordinator and Dispatcher patterns
 
-apiVersion: '@ossa/v0.1.9'
+apiVersion: ossa/v0.2.8
 kind: Workflow
 metadata:
   name: customer-support-system

package/examples/adk-integration/data-pipeline.yml

@@ -1,7 +1,7 @@
 # Example: ADK Data Processing Pipeline with OSSA Agents
 # Demonstrates LoopAgent and ConditionalAgent patterns
 
-apiVersion: '@ossa/v0.1.9'
+apiVersion: ossa/v0.2.8
 kind: Workflow
 metadata:
   name: data-processing-pipeline

package/examples/advanced/workflows/hybrid-model-strategy.yaml

@@ -1,7 +1,7 @@
 # Hybrid Model Strategy: Fast Local Planning + Premium Development
 # Demonstrates using fast Ollama models for planning agents and Claude for development
 
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Workflow
 metadata:
   name: hybrid-development-workflow

package/examples/agent-manifests/critics/critic-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: code-quality-critic

package/examples/agent-manifests/governors/governor-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: policy-compliance-governor

package/examples/agent-manifests/integrators/integrator-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: multi-system-integrator

package/examples/agent-manifests/judges/judge-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: decision-arbitration-judge

package/examples/agent-manifests/monitors/monitor-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: system-performance-monitor

package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml

@@ -20,7 +20,7 @@
 # ============================================================================
 
 # OSSA manifest version - defines the schema and features available
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 
 # Kind declares this as an Agent manifest (vs. Bridge, Tool, etc.)
 kind: Agent

package/examples/agent-manifests/sample-compliant-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9-alpha.1
+apiVersion: ossa/v0.2.8-alpha.1
 kind: Agent
 metadata:
   name: financial-data-processor

package/examples/agent-manifests/workers/worker-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa.io/v0.1.9
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: data-processing-worker

package/examples/anthropic/claude-assistant.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "claude-assistant",

package/examples/autogen/multi-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "autogen-assistant",

package/examples/claude-code/code-reviewer.ossa.yaml

@@ -0,0 +1,78 @@
+apiVersion: ossa/v0.2.8
+kind: Agent
+metadata:
+  name: claude-code-reviewer
+  version: 1.0.0
+  description: Claude Code agent for TypeScript/Node.js code review
+
+spec:
+  role: |
+    You are a senior code reviewer specializing in TypeScript, Node.js,
+    and OSSA specification compliance. Review code for quality, security,
+    and adherence to best practices.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250929
+    temperature: 0.2
+    max_tokens: 16384
+
+  capabilities:
+    - name: review_code
+      description: Review code changes for quality and security
+      input_schema:
+        type: object
+        properties:
+          file_paths:
+            type: array
+            items:
+              type: string
+          focus_areas:
+            type: array
+            items:
+              type: string
+              enum: [security, performance, types, tests, docs]
+        required: [file_paths]
+
+    - name: suggest_improvements
+      description: Suggest code improvements and refactoring
+      input_schema:
+        type: object
+        properties:
+          file_path:
+            type: string
+          improvement_type:
+            type: string
+            enum: [refactor, optimize, simplify, secure]
+        required: [file_path, improvement_type]
+
+  constraints:
+    max_file_size: 100000
+    allowed_extensions:
+      - .ts
+      - .tsx
+      - .js
+      - .json
+      - .yaml
+      - .yml
+
+extensions:
+  claude_code:
+    enabled: true
+    agent_type: reviewer
+    capabilities:
+      - file_read
+      - grep_search
+      - glob_search
+    review_focus:
+      - type_safety
+      - error_handling
+      - security_vulnerabilities
+      - code_clarity
+      - test_coverage
+
+  anthropic:
+    enabled: true
+    model: claude-sonnet-4-5-20250929
+    max_tokens: 16384
+    temperature: 0.2

package/examples/claude-code/ossa-validator.ossa.yaml

@@ -0,0 +1,80 @@
+apiVersion: ossa/v0.2.8
+kind: Agent
+metadata:
+  name: ossa-validator
+  version: 1.0.0
+  description: Claude Code agent for OSSA manifest validation and generation
+
+spec:
+  role: |
+    You are an OSSA specification expert that helps users validate,
+    create, and migrate AI agent manifests to the OSSA standard.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250929
+    temperature: 0.3
+    max_tokens: 8192
+
+  capabilities:
+    - name: validate
+      description: Validate OSSA manifests against schema
+      input_schema:
+        type: object
+        properties:
+          manifest_path:
+            type: string
+            description: Path to OSSA manifest file
+        required: [manifest_path]
+
+    - name: generate
+      description: Generate OSSA manifests from templates
+      input_schema:
+        type: object
+        properties:
+          agent_type:
+            type: string
+            enum: [chat, workflow, compliance, worker]
+          name:
+            type: string
+        required: [agent_type, name]
+
+    - name: migrate
+      description: Migrate manifests between OSSA versions
+      input_schema:
+        type: object
+        properties:
+          source_path:
+            type: string
+          target_version:
+            type: string
+            default: "0.2.8"
+        required: [source_path]
+
+  tools:
+    - name: ossa_validate
+      description: Run OSSA CLI validation
+      handler: bash
+      command: npm run cli -- validate ${manifest_path}
+
+    - name: ossa_generate
+      description: Generate new OSSA manifest
+      handler: bash
+      command: npm run cli -- generate ${agent_type} --name "${name}"
+
+extensions:
+  claude_code:
+    enabled: true
+    agent_type: specialist
+    capabilities:
+      - file_read
+      - file_write
+      - bash_execute
+    allowed_commands:
+      - "npm run cli --"
+      - "npm run test"
+      - "npm run build"
+    workspace_paths:
+      - "spec/"
+      - "examples/"
+      - "src/"

package/examples/common_npm/agent-router.ossa.yaml

@@ -1,3 +1,4 @@
+apiVersion: ossa/v0.2.8
 ossaVersion: "1.0"
 
 agent:

package/examples/common_npm/agent-router.v0.2.2.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: agent-router

package/examples/crewai/research-team.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "research-agent",

package/examples/cursor/code-review-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "code-review-agent",

package/examples/drupal/gitlab-ml-recommender.ossa.yaml

@@ -37,6 +37,7 @@
 # ============================================================================
 
 # OSSA specification version - defines which features are available
+apiVersion: ossa/v0.2.8
 ossaVersion: "1.0"
 
 # Agent metadata and configuration

package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: gitlab-ml-recommender

package/examples/extensions/drupal-v1.yml

@@ -2,7 +2,7 @@
 # Extension specification for Drupal LLM Platform deployment
 # Compatible with Drupal 10+ and llm-platform modules
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: ExtensionSchema
 metadata:
   name: drupal-extension