aranea-sdk-cli 0.3.7 → 0.3.9

package/dist/commands/knowledge.js

@@ -149,6 +149,7 @@ exports.knowledgeCommand
     .action(async (options) => {
     try {
         const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'knowledge add --title <title> --category <cat>');
         (0, config_1.warnIfProduction)(env, 'knowledge add');
         console.log(chalk_1.default.bold(`\n=== Knowledge Add (${env}) ===\n`));
         // 認証トークン
@@ -234,6 +235,7 @@ exports.knowledgeCommand
     .action(async (options) => {
     try {
         const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'knowledge search --query <query>');
         console.log(chalk_1.default.bold(`\n=== Knowledge Search (${env}) ===\n`));
         const token = options.token || await getAuthToken();
         if (!token) {
@@ -278,6 +280,7 @@ exports.knowledgeCommand
     .action(async (options) => {
     try {
         const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'knowledge list');
         console.log(chalk_1.default.bold(`\n=== Knowledge List (${env}) ===\n`));
         const token = options.token || await getAuthToken();
         if (!token) {
@@ -320,6 +323,7 @@ exports.knowledgeCommand
     .action(async (options) => {
     try {
         const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'knowledge get --id <id>');
         console.log(chalk_1.default.bold(`\n=== Knowledge Get (${env}) ===\n`));
         const token = options.token || await getAuthToken();
         if (!token) {
@@ -352,6 +356,7 @@ exports.knowledgeCommand
     .action(async (options) => {
     try {
         const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'knowledge delete --id <id>');
         (0, config_1.warnIfProduction)(env, 'knowledge delete');
         console.log(chalk_1.default.bold(`\n=== Knowledge Delete (${env}) ===\n`));
         const token = options.token || await getAuthToken();

package/dist/commands/metatron.js

@@ -127,6 +127,7 @@ exports.metatronCommand
     .action(async (question, options) => {
     try {
         const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'metatron ask "<question>"');
         if (!options.raw) {
             console.log(chalk_1.default.bold(`\n=== AraneaMetatron (${env}) ===\n`));
             console.log(chalk_1.default.gray(`Q: ${question}`));
@@ -160,6 +161,7 @@ exports.metatronCommand
     .option('-e, --endpoint <env>', '環境 (staging|production)', 'production')
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    (0, config_1.checkStagingAvailability)(env, 'metatron chat');
     console.log(chalk_1.default.bold(`\n=== AraneaMetatron Chat (${env}) ===\n`));
     console.log(chalk_1.default.gray('AraneaSDKについて質問してください。'));
     console.log(chalk_1.default.gray('終了するには "exit" または Ctrl+C を入力\n'));

package/dist/commands/schema.js

@@ -165,6 +165,8 @@ exports.schemaCommand
     .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema list');
     const apiBase = getSchemaApiBase(env);
     const spinner = (0, ora_1.default)(`Fetching schema list from ${env}...`).start();
     try {
@@ -211,6 +213,8 @@ exports.schemaCommand
     .option('--json', 'Output as JSON')
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema get --type <type>');
     const apiBase = getSchemaApiBase(env);
     const spinner = (0, ora_1.default)(`Fetching schema for ${options.type} from ${env}...`).start();
     try {
@@ -358,6 +362,8 @@ exports.schemaCommand
     .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema validate --type <type> --file <file>');
     const apiBase = getSchemaApiBase(env);
     const spinner = (0, ora_1.default)('Validating...').start();
     try {
@@ -553,7 +559,7 @@ exports.schemaCommand
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
     // Check staging availability
-    (0, config_1.checkStagingAvailability)(env, 'schema push --endpoint production');
+    (0, config_1.checkStagingAvailability)(env, 'schema push --file <file>');
     // Require --force for production
     if (!options.dryRun && !(0, config_1.requireProductionConfirmation)(env, 'schema push', options.force)) {
         process.exit(1);
@@ -688,6 +694,8 @@ exports.schemaCommand
     .option('-y, --confirm', 'Skip confirmation prompt')
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema promote --type <type>');
     const apiBase = getSchemaApiBase(env);
     // Always warn for promote
     console.log(chalk_1.default.yellow(`\nPromoting schema to PRODUCTION state in ${env} environment\n`));
@@ -794,6 +802,8 @@ exports.schemaCommand
     .option('--json', 'Output as JSON')
     .action(async (options) => {
     const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema info --type <type>');
     const apiBase = getSchemaApiBase(env);
     const spinner = (0, ora_1.default)(`Fetching schema info: ${options.type} from ${env}...`).start();
     try {
@@ -870,6 +880,8 @@ exports.schemaCommand
             console.log(chalk_1.default.gray(`  Promote: aranea-sdk schema promote --type ${schema.type} --endpoint ${env}`));
         }
         console.log(chalk_1.default.gray(`  Get full schema: aranea-sdk schema get --type ${schema.type} --endpoint ${env} --json`));
+        console.log(chalk_1.default.gray(`  History: aranea-sdk schema history --type ${schema.type} --endpoint ${env}`));
+        console.log(chalk_1.default.gray(`  Rollback: aranea-sdk schema rollback --type ${schema.type} --version <v> --endpoint ${env}`));
         console.log('');
     }
     catch (error) {
@@ -883,3 +895,193 @@ exports.schemaCommand
         process.exit(1);
     }
 });
+// schema history - show version history
+exports.schemaCommand
+    .command('history')
+    .description('Show schema version history')
+    .requiredOption('-t, --type <type>', 'Type name')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
+    .option('-l, --limit <limit>', 'Number of versions to show', '10')
+    .action(async (options) => {
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema history --type <type>');
+    const apiBase = getSchemaApiBase(env);
+    const spinner = (0, ora_1.default)(`Fetching history for ${options.type} from ${env}...`).start();
+    try {
+        const response = await axios_1.default.get(`${apiBase}`, {
+            params: {
+                action: 'history',
+                type: options.type,
+                limit: options.limit,
+            },
+        });
+        spinner.stop();
+        if (!response.data.ok) {
+            console.log(chalk_1.default.red(`\nFailed to get history: ${response.data.error}`));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.bold(`\n=== Schema History: ${options.type} (${env}) ===\n`));
+        const history = response.data.history || [];
+        if (history.length === 0) {
+            console.log(chalk_1.default.yellow('No version history found.'));
+            console.log(chalk_1.default.gray('Version history is created when schema is updated.'));
+            console.log('');
+            return;
+        }
+        console.log(chalk_1.default.cyan('Available Versions:'));
+        console.log('');
+        for (const entry of history) {
+            const stateIcon = entry.state === 'production' ? chalk_1.default.green('P') : chalk_1.default.yellow('D');
+            console.log(`  [${stateIcon}] v${entry.version}`);
+            console.log(`      State: ${entry.state} | Changed: ${entry.changedAt || 'N/A'}`);
+            console.log(`      By: ${entry.changedBy || 'system'}`);
+            if (entry.changeReason) {
+                console.log(`      Reason: ${entry.changeReason}`);
+            }
+            console.log('');
+        }
+        console.log(chalk_1.default.gray(`Legend: [${chalk_1.default.green('P')}]=Production [${chalk_1.default.yellow('D')}]=Development`));
+        console.log('');
+        console.log(chalk_1.default.gray('To rollback:'));
+        console.log(chalk_1.default.gray(`  aranea-sdk schema rollback --type ${options.type} --version <version> --endpoint ${env}`));
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch history');
+        console.log(chalk_1.default.red(`\nError: ${error.message}`));
+        process.exit(1);
+    }
+});
+// schema rollback - rollback to a previous version
+exports.schemaCommand
+    .command('rollback')
+    .description('Rollback schema to a previous version')
+    .requiredOption('-t, --type <type>', 'Type name to rollback')
+    .requiredOption('-v, --version <version>', 'Target version number to rollback to')
+    .option('--token <token>', 'Firebase Auth ID token')
+    .option('-e, --endpoint <env>', 'Environment (staging|production)', 'staging')
+    .option('-d, --dry-run', 'Show what would be rolled back without actually doing it')
+    .option('-y, --confirm', 'Skip confirmation prompt')
+    .action(async (options) => {
+    const env = (0, config_1.resolveEnvironment)(options.endpoint);
+    // Check staging availability
+    (0, config_1.checkStagingAvailability)(env, 'schema rollback --type <type> --version <v>');
+    const apiBase = getSchemaApiBase(env);
+    console.log(chalk_1.default.yellow(`\n⚠️  Schema Rollback (${env})\n`));
+    const spinner = (0, ora_1.default)(`Fetching schema info: ${options.type}...`).start();
+    try {
+        // First, fetch current schema info and history
+        const [schemaResult, historyResult] = await Promise.all([
+            fetchSchema(apiBase, options.type),
+            axios_1.default.get(`${apiBase}`, {
+                params: { action: 'history', type: options.type, limit: 20 },
+            }),
+        ]);
+        spinner.stop();
+        if (!schemaResult.ok) {
+            console.log(chalk_1.default.red(`Schema "${options.type}" not found`));
+            process.exit(1);
+        }
+        const schema = schemaResult.schema;
+        const history = historyResult.data.history || [];
+        const targetVersion = parseInt(options.version, 10);
+        // Find target version in history
+        const targetEntry = history.find((h) => h.version === targetVersion);
+        if (!targetEntry) {
+            console.log(chalk_1.default.red(`Version ${targetVersion} not found in history`));
+            console.log('');
+            console.log(chalk_1.default.yellow('Available versions:'));
+            history.forEach((h) => {
+                console.log(`  v${h.version} (${h.state}) - ${h.changedAt || 'N/A'}`);
+            });
+            console.log('');
+            process.exit(1);
+        }
+        // Show rollback info
+        console.log(chalk_1.default.bold('Current Schema:'));
+        console.log(`  Type: ${schema.type}`);
+        console.log(`  State: ${schema.state === 'production' ? chalk_1.default.green(schema.state) : chalk_1.default.yellow(schema.state)}`);
+        console.log(`  Version: ${schema.version || schema.revisionNumber || 'N/A'}`);
+        console.log('');
+        console.log(chalk_1.default.bold('Rollback Target:'));
+        console.log(`  Version: v${targetVersion}`);
+        console.log(`  State at time: ${targetEntry.state}`);
+        console.log(`  Changed: ${targetEntry.changedAt || 'N/A'}`);
+        console.log(`  By: ${targetEntry.changedBy || 'system'}`);
+        if (targetEntry.changeReason) {
+            console.log(`  Reason: ${targetEntry.changeReason}`);
+        }
+        console.log('');
+        if (options.dryRun) {
+            console.log(chalk_1.default.bold('=== Dry Run: Would Rollback ===\n'));
+            console.log(`  From: current (v${schema.version || schema.revisionNumber || '?'})`);
+            console.log(`  To: v${targetVersion}`);
+            console.log('');
+            console.log(chalk_1.default.gray('Remove --dry-run to actually rollback'));
+            return;
+        }
+        // Confirmation step
+        if (!options.confirm) {
+            console.log(chalk_1.default.red('This will rollback the schema to a previous version.'));
+            console.log(chalk_1.default.red('The current version will be saved in history.'));
+            console.log('');
+            const confirmed = await promptConfirm('Are you sure you want to proceed?');
+            if (!confirmed) {
+                console.log(chalk_1.default.yellow('\nRollback cancelled.'));
+                return;
+            }
+        }
+        const token = getAuthToken(options);
+        if (!token) {
+            console.log(chalk_1.default.red('\nAuthentication required'));
+            console.log(chalk_1.default.yellow('Provide a token using one of:'));
+            console.log('  --token <TOKEN>');
+            console.log('  export ARANEA_AUTH_TOKEN=<TOKEN>');
+            process.exit(1);
+        }
+        const rollbackSpinner = (0, ora_1.default)(`Rolling back ${options.type} to v${targetVersion}...`).start();
+        // Call the API to rollback
+        const response = await axios_1.default.post(`${apiBase}`, {
+            action: 'rollback',
+            type: options.type,
+            targetVersion: targetVersion,
+        }, {
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        if (response.data.ok) {
+            rollbackSpinner.succeed(`Schema "${options.type}" rolled back to v${targetVersion}`);
+            console.log('');
+            console.log(`  New Version: v${response.data.newVersion || 'N/A'}`);
+            if (response.data.warnings) {
+                response.data.warnings.forEach((w) => {
+                    console.log(`  ${chalk_1.default.yellow(w)}`);
+                });
+            }
+            console.log('');
+        }
+        else {
+            rollbackSpinner.fail(`Rollback failed: ${response.data.error || 'Unknown error'}`);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        if (error.response?.status === 401) {
+            console.log(chalk_1.default.red('\nAuthentication failed - invalid or expired token'));
+            console.log(chalk_1.default.yellow('Token is valid for 1 hour. Please refresh your token.'));
+        }
+        else if (error.response?.status === 403) {
+            console.log(chalk_1.default.red('\nPermission denied - insufficient privileges'));
+        }
+        else if (error.response?.data?.error) {
+            console.log(chalk_1.default.red(`\nRollback failed: ${error.response.data.error}`));
+        }
+        else {
+            console.log(chalk_1.default.red(`\nRollback failed: ${error.message}`));
+        }
+        process.exit(1);
+    }
+});

package/dist/index.js

@@ -28,7 +28,7 @@ const program = new commander_1.Command();
 program
     .name('aranea-sdk')
     .description('AraneaSDK CLI - デバイス開発支援ツール')
-    .version('0.3.7');
+    .version('0.3.9');
 // test コマンド
 program.addCommand(test_1.testCommand);
 // simulate コマンド

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aranea-sdk-cli",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "AraneaSDK CLI - ESP32 IoTデバイス開発支援ツール",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",