clawcity 2.5.1 → 2.5.3

package/dist/commands/install.js

@@ -85,6 +85,7 @@ function printLegacyInstructions(payload) {
         asString(instructions.step2),
         asString(instructions.step3),
         asString(instructions.step4),
+        asString(instructions.step5),
     ].filter((step) => Boolean(step));
     if (steps.length === 0)
         return;
@@ -156,15 +157,30 @@ export async function installSkill(skillName, options) {
         // Display results
         console.log('\n' + chalk.cyan('━'.repeat(50)));
         console.log(chalk.bold.white(`\n🎉 Welcome to ${skill.displayName}, ${payload.name || 'new agent'}!\n`));
+        const docsUrl = asString(payload.cli_handoff?.fallback_docs) || skill.skillUrl;
+        const automation = payload.automation_preflight;
+        const workflowsUrl = asString(automation?.part3_url) || 'https://www.clawcity.app/skill-workflows.md#part-3-automation-scripts';
+        const automationTitle = asString(automation?.part3_title) || 'Part 3: Automation Scripts';
+        const automationHeadline = asString(automation?.headline) || 'Efficient play requires a loop script.';
+        const automationRationale = asString(automation?.rationale);
+        const automationCommand = normalizeCommand(asString(automation?.recommended_command) || 'npx clawcity@latest guide --section automation');
+        console.log(chalk.bold.white('⚡ Efficiency First'));
+        console.log(chalk.gray(automationHeadline));
+        if (automationRationale) {
+            console.log(chalk.gray(automationRationale));
+        }
+        console.log(chalk.cyan(`  ${automationTitle}: ${workflowsUrl}`));
+        console.log(chalk.gray(`  setup command: ${automationCommand}\n`));
+        console.log(chalk.bold.white('\n▶ Primary next action'));
+        console.log(chalk.cyan(`  ${getPrimaryNextAction(payload)}\n`));
+        console.log(chalk.gray(`Automation default: design + save a loop script, then run and observe it repeatedly. See ${automationTitle}.`));
+        console.log(chalk.gray('Optional trust setup after gameplay starts: share the ownership verification link with your human.\n'));
         console.log(chalk.yellow('⚠️  IMPORTANT: Save these credentials!\n'));
         console.log(chalk.gray('API Key (keep secret):'));
         console.log(chalk.green(`  ${payload.api_key || 'unavailable'}\n`));
-        console.log(chalk.gray('Claim Link (share with your human):'));
+        console.log(chalk.gray('Ownership Verification Link (optional trust setup):'));
         console.log(chalk.cyan(`  ${inferClaimLink(payload) || 'unavailable'}\n`));
         console.log(chalk.cyan('━'.repeat(50)));
-        console.log(chalk.bold.white('\n▶ Primary next action'));
-        console.log(chalk.cyan(`  ${getPrimaryNextAction(payload)}\n`));
-        console.log(chalk.gray('Optional trust setup after gameplay starts: share the ownership link with your human for verification.\n'));
         const oracle = payload.oracle;
         if (oracle) {
             console.log(chalk.bold.white('🔮 Oracle Briefing'));
@@ -217,7 +233,66 @@ export async function installSkill(skillName, options) {
             });
             console.log('');
         }
-        const docsUrl = asString(payload.cli_handoff?.fallback_docs) || skill.skillUrl;
+        const coachObjectives = Array.isArray(payload.coach_objectives)
+            ? payload.coach_objectives
+            : [];
+        if (coachObjectives.length > 0) {
+            console.log(chalk.bold.white('🎯 Coach Objectives'));
+            coachObjectives.forEach((objective, index) => {
+                const title = asString(objective.title) || `Objective ${index + 1}`;
+                const status = asString(objective.status) || 'pending';
+                const rationale = asString(objective.rationale);
+                console.log(chalk.white(`${index + 1}. ${title} [${status}]`));
+                if (rationale) {
+                    console.log(chalk.gray(`   why: ${rationale}`));
+                }
+            });
+            console.log('');
+        }
+        const coachBadges = Array.isArray(payload.coach_badges)
+            ? payload.coach_badges
+            : [];
+        if (coachBadges.length > 0) {
+            console.log(chalk.bold.white('🏅 Strategy Badges'));
+            coachBadges.forEach((badge) => {
+                const title = asString(badge.title) || 'Badge';
+                const description = asString(badge.description);
+                const earned = badge.earned === true;
+                console.log(chalk.white(`- ${title}: ${earned ? 'earned' : 'locked'}`));
+                if (description) {
+                    console.log(chalk.gray(`   ${description}`));
+                }
+            });
+            console.log('');
+        }
+        const coachFeedback = payload.coach_feedback;
+        if (coachFeedback && typeof coachFeedback === 'object') {
+            const whatHappened = Array.isArray(coachFeedback.what_happened)
+                ? coachFeedback.what_happened.filter((line) => typeof line === 'string' && line.length > 0)
+                : [];
+            const happeningNow = Array.isArray(coachFeedback.what_is_happening_now)
+                ? coachFeedback.what_is_happening_now.filter((line) => typeof line === 'string' && line.length > 0)
+                : [];
+            const whatToDoNext = Array.isArray(coachFeedback.what_to_do_next)
+                ? coachFeedback.what_to_do_next.filter((line) => typeof line === 'string' && line.length > 0)
+                : [];
+            if (whatHappened.length > 0 || happeningNow.length > 0 || whatToDoNext.length > 0) {
+                console.log(chalk.bold.white('🧠 Agent-Human Feedback'));
+                if (whatHappened.length > 0) {
+                    console.log(chalk.gray('What happened:'));
+                    whatHappened.forEach((line) => console.log(chalk.gray(`  - ${line}`)));
+                }
+                if (happeningNow.length > 0) {
+                    console.log(chalk.gray('What is happening now:'));
+                    happeningNow.forEach((line) => console.log(chalk.gray(`  - ${line}`)));
+                }
+                if (whatToDoNext.length > 0) {
+                    console.log(chalk.gray('What to do next:'));
+                    whatToDoNext.forEach((line) => console.log(chalk.gray(`  - ${line}`)));
+                }
+                console.log('');
+            }
+        }
         console.log(chalk.gray('Skill documentation:'));
         console.log(chalk.cyan(`  ${docsUrl}\n`));
         console.log(chalk.gray('OpenClaw agent config:'));

package/dist/commands/planning.js

@@ -240,6 +240,7 @@ export function registerPlanningCommands(program) {
                 can_execute: asBoolean(claim.can_execute),
                 can_afford: asBoolean(claim.can_afford),
                 affordable_now: asBoolean(claim.can_execute) && asBoolean(claim.can_afford),
+                quote_source: asString(claim.quote_source) || 'unknown',
                 reasons: Array.isArray(claim.reasons) ? claim.reasons : [],
                 effective_cost: asRecord(claim.effective_cost) || {},
                 missing_resources: Array.isArray(claim.missing_resources) ? claim.missing_resources : [],
@@ -255,6 +256,9 @@ export function registerPlanningCommands(program) {
             if (result.missing_resources.length > 0) {
                 console.log(`Missing: ${result.missing_resources.join('; ')}`);
             }
+            if (result.quote_source !== 'rpc') {
+                console.log('Quote source: fallback (local estimate). If uncertain, run `clawcity claim` for authoritative cost.');
+            }
             printReasons(result.reasons);
             return;
         }

package/dist/commands/territory.js

@@ -116,7 +116,7 @@ export function registerTerritoryCommands(program) {
     });
     ownership
         .command('link <token>')
-        .description('Render ownership claim link for a token')
+        .description('Render ownership verification link for a token')
         .option('--json', 'Print raw JSON response')
         .action((token, opts) => {
         const baseUrl = (process.env.CLAWCITY_URL || 'https://www.clawcity.app').replace(/\/+$/, '');
@@ -128,7 +128,7 @@ export function registerTerritoryCommands(program) {
             }, null, 2));
             return;
         }
-        console.log(`Claim link: ${link}`);
+        console.log(`Ownership verification link: ${link}`);
         console.log('Share this link with your human, then run:');
         console.log(`clawcity ownership verify ${token} --twitter <handle> --tweet-url <url>`);
     });

package/dist/lib/formatters.js

@@ -435,8 +435,12 @@ export function formatTournamentPerksLines(data) {
     return lines;
 }
 export function formatOracleLines(data, includeAllPending = false) {
+    const automation = asRecord(data.automation_preflight);
     const contract = asRecord(data.contract);
     const oracle = asRecord(data.oracle);
+    const coachObjectives = asRecordArray(data.coach_objectives);
+    const coachBadges = asRecordArray(data.coach_badges);
+    const coachFeedback = asRecord(data.coach_feedback);
     const nextSteps = asRecordArray(data.next_steps);
     const allPendingSteps = asRecordArray(data.all_pending_steps);
     const title = asString(oracle?.title) || 'Oracle';
@@ -446,9 +450,25 @@ export function formatOracleLines(data, includeAllPending = false) {
     const total = asNumber(contract?.total_outcomes) ?? 0;
     const lines = [
         `${title} | Outcomes: ${completed}/${total}`,
-        narrative,
-        `Objective: ${objective}`,
     ];
+    const automationHeadline = asString(automation?.headline);
+    const automationPartTitle = asString(automation?.part3_title);
+    const automationPartUrl = asString(automation?.part3_url);
+    const automationCommand = asString(automation?.recommended_command);
+    if (automationHeadline) {
+        lines.push(`Efficiency: ${automationHeadline}`);
+    }
+    if (automationPartTitle && automationPartUrl) {
+        lines.push(`${automationPartTitle}: ${automationPartUrl}`);
+    }
+    else if (automationPartUrl) {
+        lines.push(`Automation scripts: ${automationPartUrl}`);
+    }
+    if (automationCommand) {
+        lines.push(`Automation setup command: ${automationCommand}`);
+    }
+    lines.push(narrative);
+    lines.push(`Objective: ${objective}`);
     const pending = includeAllPending ? allPendingSteps : nextSteps;
     if (pending.length > 0) {
         lines.push(includeAllPending ? 'Pending steps:' : 'Next steps:');
@@ -470,5 +490,53 @@ export function formatOracleLines(data, includeAllPending = false) {
     if (prompt) {
         lines.push(`Starter prompt: ${prompt}`);
     }
+    if (coachObjectives.length > 0) {
+        lines.push('Coach objectives:');
+        coachObjectives.forEach((objective, index) => {
+            const objectiveTitle = asString(objective.title) || `Objective ${index + 1}`;
+            const status = asString(objective.status) || 'pending';
+            const rationale = asString(objective.rationale);
+            lines.push(`  ${index + 1}. ${objectiveTitle} [${status}]`);
+            if (rationale)
+                lines.push(`     why: ${rationale}`);
+        });
+    }
+    if (coachBadges.length > 0) {
+        lines.push('Strategy badges:');
+        coachBadges.forEach((badge) => {
+            const title = asString(badge.title) || 'Badge';
+            const description = asString(badge.description);
+            const earned = badge.earned === true;
+            lines.push(`  - ${title}: ${earned ? 'earned' : 'locked'}`);
+            if (description)
+                lines.push(`    ${description}`);
+        });
+    }
+    if (coachFeedback) {
+        const whatHappened = Array.isArray(coachFeedback.what_happened)
+            ? coachFeedback.what_happened.filter((line) => typeof line === 'string' && line.length > 0)
+            : [];
+        const happeningNow = Array.isArray(coachFeedback.what_is_happening_now)
+            ? coachFeedback.what_is_happening_now.filter((line) => typeof line === 'string' && line.length > 0)
+            : [];
+        const whatToDoNext = Array.isArray(coachFeedback.what_to_do_next)
+            ? coachFeedback.what_to_do_next.filter((line) => typeof line === 'string' && line.length > 0)
+            : [];
+        if (whatHappened.length > 0 || happeningNow.length > 0 || whatToDoNext.length > 0) {
+            lines.push('Agent-human feedback:');
+            if (whatHappened.length > 0) {
+                lines.push('  What happened:');
+                whatHappened.forEach((line) => lines.push(`    - ${line}`));
+            }
+            if (happeningNow.length > 0) {
+                lines.push('  What is happening now:');
+                happeningNow.forEach((line) => lines.push(`    - ${line}`));
+            }
+            if (whatToDoNext.length > 0) {
+                lines.push('  What to do next:');
+                whatToDoNext.forEach((line) => lines.push(`    - ${line}`));
+            }
+        }
+    }
     return lines;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawcity",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Agent-first CLI for ClawCity gameplay, tournaments, and public game APIs",
   "type": "module",
   "main": "dist/index.js",