@bluefly/openstandardagents 0.4.5 → 0.4.6

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

@@ -8,16 +8,17 @@
  *   ossa workspace policy list   - List allowed/denied tools
  *   ossa workspace discover      - Auto-discover project agents
  *   ossa workspace sync          - Sync registry with discovered agents
+ *   ossa workspace publish       - POST discovery to a registry API (e.g. mesh /api/v1/discovery)
  */
-import { Command } from 'commander';
 import chalk from 'chalk';
+import { Command } from 'commander';
 import * as fs from 'fs';
+import { glob } from 'glob';
 import * as path from 'path';
 import * as yaml from 'yaml';
-import { glob } from 'glob';
+import { getDefaultAgentVersion, getDefaultDiscoveryPatterns, getDefaultDiscoveryRefresh, getDefaultDiscoveryStrategy, getDefaultOSSAAPIVersion, getDefaultPolicyKind, getDefaultRegistryKind, getDefaultWorkspaceDir, getRequiredWorkspaceDirs, getWorkspacePolicyPath, getWorkspaceRegistryPath, } from '../../config/defaults.js';
 import { getVersion } from '../../utils/version.js';
-import { outputJSON, handleCommandError } from '../utils/index.js';
-import { getDefaultWorkspaceDir, getRequiredWorkspaceDirs, getWorkspaceRegistryPath, getWorkspacePolicyPath, getDefaultOSSAAPIVersion, getDefaultRegistryKind, getDefaultPolicyKind, getDefaultAgentVersion, getDefaultDiscoveryStrategy, getDefaultDiscoveryRefresh, getDefaultDiscoveryPatterns, } from '../../config/defaults.js';
+import { handleCommandError, outputJSON } from '../utils/index.js';
 export const workspaceCommand = new Command('workspace').description('Manage .agents-workspace/ (two-tier architecture governance)');
 // ============================================================================
 // Subcommand: workspace init
@@ -148,6 +149,43 @@ Global conventions and standards that apply to all agents in this workspace.
     }
 });
 // ============================================================================
+// Subcommand: workspace scaffold
+// ============================================================================
+workspaceCommand
+    .command('scaffold')
+    .description('Scaffold the IDE workspace mapping via OSSA standards')
+    .option('--dir <directory>', 'Base directory to scaffold', '.')
+    .option('--init-projects <projects>', 'Comma separated list of project paths to generate .agents/ stubs into')
+    .option('--worktree <worktrees>', 'Comma separated list of external worktree paths to bind into the IDE workspace')
+    .action(async (options) => {
+    try {
+        const { container } = await import('../../di-container.js');
+        const { WorkspaceService } = await import('../../services/workspace/workspace.service.js');
+        const service = container.get(WorkspaceService);
+        const initProjects = options.initProjects
+            ? options.initProjects.split(',').map((s) => s.trim())
+            : [];
+        const externalWorktrees = options.worktree
+            ? options.worktree.split(',').map((s) => s.trim())
+            : [];
+        console.log(chalk.blue(`Scaffolding workspace from ${options.dir}...`));
+        const result = await service.scaffold(options.dir, initProjects, externalWorktrees);
+        console.log(chalk.green('\n✓ Workspace scaffold completed'));
+        console.log(chalk.gray(`  Central Workspace: ${result.workspacePath}`));
+        if (result.projectsScaffolded > 0) {
+            console.log(chalk.gray(`  Projects Provisioned: ${result.projectsScaffolded} .agents/ folders newly created`));
+        }
+        if (result.externalWorktreesBound > 0) {
+            console.log(chalk.cyan(`  Worktrees Bound: ${result.externalWorktreesBound} external git paths integrated`));
+        }
+        console.log(chalk.gray(`  IDE Setup Bound: ${result.codeWorkspacePath}\n`));
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error);
+    }
+});
+// ============================================================================
 // Subcommand: workspace list
 // ============================================================================
 workspaceCommand
@@ -465,4 +503,127 @@ workspaceCommand
         await discover.parseAsync(['discover'], { from: 'user' });
     }
 });
+// ============================================================================
+// Subcommand: workspace publish (POST to registry/mesh discovery API)
+// ============================================================================
+workspaceCommand
+    .command('publish')
+    .description('POST workspace discovery to a registry API (e.g. mesh /api/v1/discovery). Run "ossa workspace discover" first.')
+    .option('--registry-url <url>', 'Registry base URL (e.g. https://your-registry.example.com). Default: MESH_URL or AGENT_REGISTRY_URL env. POSTs to <url>/api/v1/discovery')
+    .option('--discover', 'Run workspace discover first if registry is missing')
+    .action(async (options) => {
+    try {
+        const registryUrl = options.registryUrl ||
+            process.env.MESH_URL ||
+            process.env.AGENT_REGISTRY_URL;
+        if (!registryUrl) {
+            console.error(chalk.red('Missing --registry-url or MESH_URL / AGENT_REGISTRY_URL'));
+            process.exit(1);
+        }
+        const cwd = process.cwd();
+        const registryPath = path.resolve(cwd, getDefaultWorkspaceDir(), getWorkspaceRegistryPath());
+        if (!fs.existsSync(registryPath)) {
+            if (options.discover) {
+                console.log(chalk.blue('No registry found; running discover...'));
+                const discover = workspaceCommand.commands.find((c) => c.name() === 'discover');
+                if (discover) {
+                    await discover.parseAsync(['discover'], { from: 'user' });
+                }
+                if (!fs.existsSync(registryPath)) {
+                    console.log(chalk.red('Discover did not create registry'));
+                    process.exit(1);
+                }
+            }
+            else {
+                console.log(chalk.yellow('No workspace registry found'));
+                console.log(chalk.gray('  Run `ossa workspace discover` first, or use --discover'));
+                process.exit(1);
+            }
+        }
+        const content = fs.readFileSync(registryPath, 'utf-8');
+        const registry = yaml.parse(content);
+        const agents = registry.agents || [];
+        const workspaceName = registry.metadata?.name || 'workspace';
+        const scannedAt = new Date().toISOString();
+        const payload = {
+            source_id: workspaceName,
+            workspace: { name: workspaceName, scanned_at: scannedAt },
+            projects: agents.map((p) => ({
+                name: p.project ?? p.path,
+                path: p.path ?? `./${p.project ?? ''}`,
+                agents: p.agents ?? [],
+            })),
+        };
+        const base = registryUrl.replace(/\/$/, '');
+        const url = `${base}/api/v1/discovery`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        if (res.ok || res.status === 202) {
+            console.log(chalk.green('Published to registry: ') +
+                base +
+                ` (${payload.projects.length} projects)`);
+        }
+        else {
+            const text = await res.text();
+            console.error(chalk.red('Publish failed: ') + res.status + ' ' + text);
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error);
+    }
+});
+// ============================================================================
+// Subcommand: workspace list-remote (GET from registry/mesh discovery API)
+// ============================================================================
+workspaceCommand
+    .command('list-remote')
+    .description('List agents from a registry API (GET /api/v1/discovery). No local workspace required.')
+    .requiredOption('--registry-url <url>', 'Registry base URL (e.g. https://your-registry.example.com)')
+    .option('--json', 'Output raw JSON')
+    .action(async (options) => {
+    try {
+        const base = options.registryUrl.replace(/\/$/, '');
+        const res = await fetch(`${base}/api/v1/discovery`);
+        if (!res.ok) {
+            console.error(chalk.red('Registry request failed: ') +
+                res.status +
+                ' ' +
+                (await res.text()));
+            process.exit(1);
+        }
+        const data = (await res.json());
+        if (options.json) {
+            console.log(JSON.stringify(data, null, 2));
+            process.exit(0);
+        }
+        const projects = data.projects ?? [];
+        const total = projects.reduce((n, p) => n + (p.agents?.length ?? 0), 0);
+        console.log(chalk.blue('Registry: ') + base);
+        console.log(chalk.gray('Sources: ') +
+            (data.sources?.length ?? 0) +
+            '  ' +
+            chalk.gray('Agents: ') +
+            total);
+        for (const p of projects) {
+            const projName = p.project_name ?? p.name ?? p.project_path ?? p.path ?? '?';
+            for (const a of p.agents ?? []) {
+                const label = typeof a === 'string'
+                    ? a
+                    : (a.name ??
+                        a.path ??
+                        '?');
+                console.log('  ' + projName + ' / ' + label);
+            }
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error);
+    }
+});
 //# sourceMappingURL=workspace.command.js.map

package/dist/cli/extensions/gitlab.extension.js

@@ -12,6 +12,7 @@
  *   export OSSA_EXTENSIONS=true
  *   export OSSA_EXTENSIONS_LIST=gitlab
  */
+import { SPEC_VERSION } from '../../version.js';
 /**
  * Load GitLab extension commands
  *
@@ -56,7 +57,7 @@ export async function loadGitLabExtension() {
     return {
         name: 'gitlab',
         description: 'GitLab integration (Agent, Duo Catalog, CI/CD)',
-        version: '0.4.5',
+        version: SPEC_VERSION,
         commands,
     };
 }

package/dist/cli/index.js

@@ -17,12 +17,12 @@ import { program } from 'commander';
 import 'reflect-metadata';
 import { initializeAdapters } from '../adapters/index.js';
 // Core OSSA commands (platform-agnostic)
+import { agentsLocalCommandGroup } from './commands/agents-local.command.js';
 import { agentsMdCommand } from './commands/agents-md.command.js';
 import { agentsCommandGroup } from './commands/agents.command.js';
-import { agentsLocalCommandGroup } from './commands/agents-local.command.js';
+import { buildCommand } from './commands/build.command.js';
 import { complianceCommand } from './commands/compliance.command.js';
 import { conformanceCommand } from './commands/conformance.command.js';
-import { governanceCommand } from './commands/governance.command.js';
 import { contractCommand } from './commands/contract.command.js';
 import { dependenciesCommand } from './commands/dependencies.command.js';
 import { deployCommand, rollbackCommand, statusCommand, stopCommand, } from './commands/deploy.js';
@@ -30,63 +30,66 @@ import { diffCommand } from './commands/diff.command.js';
 import { exportCommand } from './commands/export.command.js';
 import { extensionTeamCommand } from './commands/extension-team.command.js';
 import { generateCommand } from './commands/generate.command.js';
+import { governanceCommand } from './commands/governance.command.js';
 import { importCommand } from './commands/import.command.js';
 import { infoCommand } from './commands/info.command.js';
 import { initCommand } from './commands/init.command.js';
-import { scaffoldCommand } from './commands/scaffold.command.js';
-import { wizardCommand } from './commands/wizard.command.js';
-import { wizardAPIFirstCommand } from './commands/wizard-api-first.command.js';
 import { installCommand } from './commands/install.command.js';
 import { lintCommand } from './commands/lint.command.js';
-import { standardizeCommand } from './commands/standardize.command.js';
 import { llmsTxtCommand } from './commands/llms-txt.command.js';
-import { migrateCommand } from './commands/migrate.command.js';
-import { buildCommand } from './commands/build.command.js';
 import { migrateBatchCommand } from './commands/migrate-batch.command.js';
+import { migrateCommand } from './commands/migrate.command.js';
 import { publishCommand } from './commands/publish.command.js';
 import { quickstartCommand } from './commands/quickstart.command.js';
 import { registryCommand } from './commands/registry.command.js';
 import { runCommand } from './commands/run.command.js';
+import { scaffoldCommand } from './commands/scaffold.command.js';
 import { schemaCommand } from './commands/schema.command.js';
 import { searchCommand } from './commands/search.command.js';
-import { updateCommand } from './commands/update.command.js';
+import { standardizeCommand } from './commands/standardize.command.js';
 import { testCommand } from './commands/test.command.js';
+import { updateCommand } from './commands/update.command.js';
 import { validateCommand } from './commands/validate.command.js';
+import { wizardAPIFirstCommand } from './commands/wizard-api-first.command.js';
+import { wizardCommand } from './commands/wizard.command.js';
 // Agent Card (A2A discovery)
 import { agentCardCommand } from './commands/agent-card.command.js';
 // Registry commands (GAID/DID)
+import { capabilityCommandGroup } from './commands/capability/index.js';
+import { discoverCommand } from './commands/discover.js';
 import { generateGaidCommand } from './commands/generate-gaid.command.js';
+import { manifestCommandGroup } from './commands/manifest/index.js';
+import { mcpCommand } from './commands/mcp.command.js';
 import { registerCommand } from './commands/register.js';
-import { discoverCommand } from './commands/discover.js';
-import { verifyCommand } from './commands/verify.js';
-import { workspaceCommand } from './commands/workspace.command.js';
-import { taxonomyCommandGroup } from './commands/taxonomy.command.js';
 import { skillsCommandGroup } from './commands/skills.command.js';
+import { taxonomyCommandGroup } from './commands/taxonomy.command.js';
 import { templateCommandGroup } from './commands/template.command.js';
 import { toolCommandGroup } from './commands/tool/index.js';
-import { capabilityCommandGroup } from './commands/capability/index.js';
-import { manifestCommandGroup } from './commands/manifest/index.js';
+import { verifyCommand } from './commands/verify.js';
+import { workspaceCommand } from './commands/workspace.command.js';
 // Framework integration commands
-import { langflowCommand } from './commands/langflow.command.js';
-import { langchainCommand } from './commands/langchain.command.js';
 import { frameworkCommand } from './commands/framework.command.js';
+import { langchainCommand } from './commands/langchain.command.js';
+import { langflowCommand } from './commands/langflow.command.js';
 // Additional commands (previously unregistered)
 import { agentWizardCommand } from './commands/agent-wizard.command.js';
 import { docsCommand } from './commands/docs.command.js';
 import { enhanceCommand } from './commands/enhance.command.js';
 import { examplesCommand } from './commands/examples.command.js';
 import { knowledgeCommandGroup } from './commands/knowledge.command.js';
+import { platformsCommand } from './commands/platforms.command.js';
 // Note: knowledge-index and knowledge-query are subcommands within knowledgeCommandGroup
+import { createAuditCommand } from './commands/audit.js';
+import { devCommand } from './commands/dev.command.js';
+import { estimateCommand } from './commands/estimate.command.js';
 import { migrateLangchainCommand } from './commands/migrate-langchain.command.js';
 import { releaseCommand } from './commands/release.command.js';
+import { daemonCommand } from './commands/daemon.command.js';
 import { serveCommand } from './commands/serve.command.js';
-import { devCommand } from './commands/dev.command.js';
 import { syncCommand } from './commands/sync.command.js';
-import { createAuditCommand } from './commands/audit.js';
-import { estimateCommand } from './commands/estimate.command.js';
 import { upgradeCommand } from './commands/upgrade.command.js';
 // Extension system (SOLID: Open/Closed via registry pattern)
-import { shouldLoadExtensions, getEnabledExtensions, createExtensionsCommand, loadExtension, getRegisteredExtensions, } from './extensions/index.js';
+import { createExtensionsCommand, getEnabledExtensions, getRegisteredExtensions, loadExtension, shouldLoadExtensions, } from './extensions/index.js';
 // Load package.json for version (lazy to avoid Jest module resolution issues)
 import * as fs from 'fs';
 import * as path from 'path';
@@ -197,6 +200,7 @@ program.addCommand(agentCardCommand);
 program.addCommand(generateGaidCommand);
 // --- Development ---
 program.addCommand(generateCommand);
+program.addCommand(daemonCommand);
 program.addCommand(devCommand);
 program.addCommand(serveCommand);
 program.addCommand(runCommand);
@@ -215,6 +219,7 @@ program.addCommand(stopCommand);
 program.addCommand(agentsMdCommand);
 program.addCommand(llmsTxtCommand);
 program.addCommand(docsCommand);
+program.addCommand(platformsCommand);
 // --- Skills & Templates ---
 program.addCommand(skillsCommandGroup);
 program.addCommand(templateCommandGroup);
@@ -255,6 +260,7 @@ for (const cmd of [
     langchainCommand,
     frameworkCommand,
     workspaceCommand,
+    mcpCommand,
     extensionTeamCommand,
     estimateCommand,
 ]) {
@@ -266,15 +272,14 @@ program.addCommand(createAuditCommand(), { hidden: true });
 program.addHelpText('after', `
   Core:       wizard, init, validate, export, lint, diff, build, migrate
   Agents:     agents, agents-local, agent-card, generate-gaid
-  Dev:        generate, dev, serve, run, test
+  Dev:        generate, daemon, dev, serve, run, test
   Distribute: publish, install, update, search
   Deploy:     deploy, status, rollback, stop
   Docs:       agents-md, llms-txt, docs
   Skills:     skills, template
   Compliance: conformance, compliance, governance, contract
-  More:       Use "ossa <command> --help" for any command. 30+ additional
-              commands available: quickstart, setup, scaffold, import, enhance,
-              registry, migrate-batch, langchain, langflow, and more.
+  More:       platforms (matrix: GitLab, Drupal, kagent, OpenAI, Claude, etc.),
+              quickstart, import, enhance, registry, migrate-batch, langchain, langflow.
 `);
 // ============================================================================
 // Extension Loading

package/dist/cli/schema-driven/schema-loader.js

@@ -128,9 +128,19 @@ export class SchemaLoader {
      */
     getEnumDescription(path, value) {
         const definition = this.getDefinition(path);
-        // Try to find description in examples or comments
-        // This is a placeholder - enhance based on actual schema structure
-        return definition?.description;
+        if (definition?.description)
+            return definition.description;
+        const enumVals = definition?.enum;
+        if (Array.isArray(enumVals) && enumVals.includes(value)) {
+            const examples = definition?.examples;
+            const ex = Array.isArray(examples)
+                ? examples.find((e) => e === value || e?.value === value)
+                : undefined;
+            return typeof ex === 'object' && ex?.description
+                ? ex.description
+                : undefined;
+        }
+        return undefined;
     }
     /**
      * Get required fields for a specific path

package/dist/cli/skills-wizard/skill-wizard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Interactive wizard for creating Agent Skills (SKILL.md) and optional OSSA skill manifest.
+ * Aligns with Agent Skills (agentskills.io) and Claude Code skills:
+ * https://code.claude.com/docs/en/skills
+ */
+export interface SkillWizardState {
+    name: string;
+    description: string;
+    instructions: string;
+    argumentHint: string;
+    disableModelInvocation: boolean;
+    userInvocable: boolean;
+    allowedTools: string;
+    context: 'inline' | 'fork';
+    agent: string;
+    platforms: string[];
+    outputPath: string;
+    emitOssaManifest: boolean;
+}
+export declare function runSkillWizard(): Promise<SkillWizardState>;
+export declare function writeSkillArtifacts(state: SkillWizardState): Promise<{
+    skillMdPath: string;
+    ossaPath?: string;
+}>;
+//# sourceMappingURL=skill-wizard.d.ts.map

package/dist/cli/skills-wizard/skill-wizard.js

@@ -0,0 +1,195 @@
+/**
+ * Interactive wizard for creating Agent Skills (SKILL.md) and optional OSSA skill manifest.
+ * Aligns with Agent Skills (agentskills.io) and Claude Code skills:
+ * https://code.claude.com/docs/en/skills
+ */
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as yaml from 'yaml';
+const SKILL_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+const SKILL_NAME_MAX = 64;
+function validateSkillName(input) {
+    if (!input || input.length > SKILL_NAME_MAX)
+        return false;
+    return SKILL_NAME_PATTERN.test(input);
+}
+const DEFAULT_OUTPUT = process.env.SKILLS_PATH ||
+    (process.env.HOME
+        ? path.join(process.env.HOME, '.claude', 'skills')
+        : '.claude/skills');
+export async function runSkillWizard() {
+    console.log(chalk.blue.bold('\nOSSA Skill Wizard'));
+    console.log(chalk.gray('Create an Agent Skills (SKILL.md) compatible skill. See: https://code.claude.com/docs/en/skills\n'));
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Skill name (lowercase, hyphens; becomes /slash-command):',
+            validate: (input) => {
+                if (!input)
+                    return 'Name is required';
+                if (!validateSkillName(input)) {
+                    return `Use lowercase letters, numbers, hyphens only (max ${SKILL_NAME_MAX} chars), e.g. explain-code`;
+                }
+                return true;
+            },
+            filter: (input) => input
+                .trim()
+                .toLowerCase()
+                .replace(/\s+/g, '-')
+                .replace(/[^a-z0-9-]/g, ''),
+        },
+        {
+            type: 'input',
+            name: 'description',
+            message: 'Description (when should Claude use this skill?):',
+            validate: (input) => input?.trim() ? true : 'Description is required',
+        },
+        {
+            type: 'editor',
+            name: 'instructions',
+            message: 'Instructions (markdown body for the skill):',
+            default: 'Add step-by-step instructions here. Use $ARGUMENTS for user input.\n',
+        },
+        {
+            type: 'input',
+            name: 'argumentHint',
+            message: 'Argument hint for /menu (e.g. [filename] or [issue-number]):',
+            default: '',
+        },
+        {
+            type: 'confirm',
+            name: 'disableModelInvocation',
+            message: 'Only you can invoke (disable Claude auto-invocation)?',
+            default: false,
+        },
+        {
+            type: 'confirm',
+            name: 'userInvocable',
+            message: 'Show in / menu (user-invocable)?',
+            default: true,
+        },
+        {
+            type: 'input',
+            name: 'allowedTools',
+            message: 'Allowed tools (comma-separated, e.g. Read,Grep,Bash):',
+            default: '',
+            filter: (input) => input
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean)
+                .join(', '),
+        },
+        {
+            type: 'list',
+            name: 'context',
+            message: 'Run in subagent (fork) or inline?',
+            choices: [
+                { name: 'Inline (same conversation)', value: 'inline' },
+                { name: 'Fork (isolated subagent)', value: 'fork' },
+            ],
+            default: 'inline',
+        },
+        {
+            type: 'input',
+            name: 'agent',
+            message: 'Subagent type when fork (Explore, Plan, general-purpose):',
+            default: 'general-purpose',
+            when: (answers) => answers.context === 'fork',
+        },
+        {
+            type: 'checkbox',
+            name: 'platforms',
+            message: 'Target platforms:',
+            choices: [
+                { name: 'Claude Code', value: 'claude-code' },
+                { name: 'Cursor', value: 'cursor' },
+                { name: 'Goose', value: 'goose' },
+                { name: 'Windsurf', value: 'windsurf' },
+                { name: 'Codex CLI', value: 'codex-cli' },
+                { name: 'Gemini CLI', value: 'gemini-cli' },
+            ],
+            default: ['claude-code'],
+        },
+        {
+            type: 'input',
+            name: 'outputPath',
+            message: 'Output directory for skill folder:',
+            default: DEFAULT_OUTPUT,
+        },
+        {
+            type: 'confirm',
+            name: 'emitOssaManifest',
+            message: 'Also create OSSA skill manifest (skill.ossa.yaml)?',
+            default: false,
+        },
+    ]);
+    return answers;
+}
+function buildFrontmatter(state) {
+    const lines = [
+        '---',
+        `name: ${state.name}`,
+        `description: ${state.description}`,
+    ];
+    if (state.argumentHint)
+        lines.push(`argument-hint: ${state.argumentHint}`);
+    if (state.disableModelInvocation)
+        lines.push('disable-model-invocation: true');
+    if (!state.userInvocable)
+        lines.push('user-invocable: false');
+    if (state.allowedTools)
+        lines.push(`allowed-tools: ${state.allowedTools}`);
+    if (state.context === 'fork') {
+        lines.push('context: fork');
+        if (state.agent)
+            lines.push(`agent: ${state.agent}`);
+    }
+    lines.push('---');
+    return lines.join('\n') + '\n';
+}
+function buildSkillMd(state) {
+    const front = buildFrontmatter(state);
+    const body = (state.instructions ||
+        `You are the ${state.name} skill. Add instructions here.`).trim();
+    return front + '\n' + body + '\n';
+}
+function buildOssaSkillManifest(state) {
+    return {
+        apiVersion: 'ossa/v0.4',
+        kind: 'Skill',
+        metadata: {
+            name: state.name,
+            description: state.description,
+            version: '1.0.0',
+        },
+        spec: {
+            description: state.description,
+            instructions: state.instructions?.trim() || '',
+            platforms: state.platforms?.length ? state.platforms : ['claude-code'],
+            ...(state.allowedTools && {
+                allowedTools: state.allowedTools
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter(Boolean),
+            }),
+        },
+    };
+}
+export async function writeSkillArtifacts(state) {
+    const outDir = path.resolve(state.outputPath, state.name);
+    await fs.mkdir(outDir, { recursive: true });
+    const skillMdPath = path.join(outDir, 'SKILL.md');
+    const content = buildSkillMd(state);
+    await fs.writeFile(skillMdPath, content, 'utf-8');
+    let ossaPath;
+    if (state.emitOssaManifest) {
+        ossaPath = path.join(outDir, 'skill.ossa.yaml');
+        const ossa = buildOssaSkillManifest(state);
+        await fs.writeFile(ossaPath, yaml.stringify(ossa), 'utf-8');
+    }
+    return { skillMdPath, ossaPath };
+}
+//# sourceMappingURL=skill-wizard.js.map

package/dist/cli/utils/error-formatter.js

@@ -4,6 +4,7 @@
  * Inspired by professional tools like npm, cargo, rustc
  */
 import chalk from 'chalk';
+import { API_VERSION } from '../../version.js';
 /**
  * Common typos and their corrections
  */
@@ -212,7 +213,7 @@ function formatError(error, index, manifest) {
             lines.push('');
             // Special handling for apiVersion pattern
             if (fieldName === 'apiVersion') {
-                lines.push(chalk.yellow(`   [TIP] apiVersion should follow format: ${chalk.bold('ossa/v0.4.5')}`));
+                lines.push(chalk.yellow(`   [TIP] apiVersion should follow format: ${chalk.bold(API_VERSION)}`));
                 lines.push(chalk.yellow(`      Your value: ${JSON.stringify(actualValue)}`));
                 lines.push('');
             }
@@ -273,7 +274,7 @@ export function formatValidationErrors(errors, manifest) {
     lines.push('');
     lines.push(chalk.cyan('[TIP] Common fixes:'));
     lines.push(chalk.cyan('   • Check spelling of field names (case-sensitive)'));
-    lines.push(chalk.cyan('   • Verify apiVersion format: ossa/v0.4.5'));
+    lines.push(chalk.cyan(`   • Verify apiVersion format: ${API_VERSION}`));
     lines.push(chalk.cyan('   • Use --verbose for detailed error information'));
     lines.push(chalk.cyan('   • Check examples/claude-code/ for reference manifests'));
     lines.push('');
@@ -294,7 +295,7 @@ export function suggestFix(manifest, error) {
     if (error.keyword === 'required' &&
         error.params?.missingProperty === 'apiVersion') {
         suggestions.push('Add apiVersion field:');
-        suggestions.push('  apiVersion: ossa/v0.4.5');
+        suggestions.push(`  apiVersion: ${API_VERSION}`);
     }
     if (error.keyword === 'required' &&
         error.params?.missingProperty === 'kind') {

package/dist/cli/utils/standard-options.d.ts

@@ -96,9 +96,9 @@ export declare function addStandardValidationOptions(command: Command): Command;
  * Resolution order:
  * 1. --registry flag (highest priority)
  * 2. OSSA_REGISTRY_URL environment variable
- * 3. Default: https://mesh.blueflyagents.com
+ * 3. Default: OSSA_REGISTRY_URL env var (empty if not set)
  */
-export declare const DEFAULT_REGISTRY_URL = "https://mesh.blueflyagents.com";
+export declare const DEFAULT_REGISTRY_URL: string;
 export declare function addRegistryOptions(command: Command): Command;
 /**
  * Resolve registry URL from flag, environment variable, or default.