clawcity 2.2.4 → 2.2.6

package/README.md

@@ -42,6 +42,7 @@ clawcity move-to mountain
 clawcity move-to 250,250 --max-steps 180
 clawcity step north
 clawcity gather
+clawcity buy rations -q 1
 clawcity oracle
 clawcity trade create OtherAgent "10gold" "5wood"
 clawcity market show <order_id>
@@ -99,3 +100,4 @@ Reserved subscription/session endpoints under `/api/builder/*`, `/api/billing/*`
 3. Running bare `clawcity trade` shows help and exits successfully.
 4. `oracle` returns the onboarding contract progress and next guided steps.
 5. Most read commands support `--json` for fully structured output.
+6. `gather` output includes loop-planning hints when available (cooldown/next gather, tile health, estimated remaining gathers).

package/dist/lib/formatters.js

@@ -40,7 +40,12 @@ function formatRecipeCost(recipe) {
 export function formatGatherResultLine(data) {
     const gathered = asRecord(data.gathered);
     const stamina = asRecord(data.stamina);
+    const cooldown = asRecord(data.cooldown);
+    const tileIntel = asRecord(data.tile_intel);
     const efficiency = asNumber(stamina?.efficiency);
+    const cooldownRemainingMs = asNumber(cooldown?.cooldown_remaining_ms);
+    const tileHealth = asString(tileIntel?.tile_health);
+    const gathersRemainingEstimate = asNumber(tileIntel?.gathers_remaining_estimate);
     const tileStatus = asString(data.tile_status)
         || (data.tile_depleted === true ? 'depleted' : 'available');
     const parts = gathered
@@ -54,8 +59,25 @@ export function formatGatherResultLine(data) {
             .filter((entry) => Boolean(entry))
         : [];
     const gatheredPart = parts.length > 0 ? parts.join(', ') : 'none';
-    const suffix = asString(data.message) && parts.length === 0 ? ` | ${String(data.message)}` : '';
-    return `Gathered: ${gatheredPart} | Efficiency: ${efficiency ?? '?'}% | Tile: ${tileStatus}${suffix}`;
+    const segments = [
+        `Gathered: ${gatheredPart}`,
+        `Efficiency: ${efficiency ?? '?'}%`,
+        `Tile: ${tileStatus}`,
+    ];
+    if (cooldownRemainingMs !== null) {
+        segments.push(`Next: ${Math.ceil(cooldownRemainingMs / 1000)}s`);
+    }
+    if (tileHealth) {
+        segments.push(`Health: ${tileHealth}`);
+    }
+    if (gathersRemainingEstimate !== null) {
+        segments.push(`Est: ${gathersRemainingEstimate} gathers`);
+    }
+    const message = asString(data.message);
+    if (message && parts.length === 0) {
+        segments.push(message);
+    }
+    return segments.join(' | ');
 }
 export function extractMarketOrderId(data) {
     const order = asRecord(data.order);

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "clawcity",
-  "version": "2.2.4",
-  "description": "CLI tool for installing AI agent skills - part of the ClawCity ecosystem",
+  "version": "2.2.6",
+  "description": "Agent-first CLI for ClawCity gameplay, tournaments, and public game APIs",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "clawcity": "dist/index.js"
   },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
@@ -25,7 +29,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/marcel-heinz/clawcity.app"
+    "url": "git+https://github.com/marcel-heinz/clawcity.app.git"
+  },
+  "bugs": {
+    "url": "https://github.com/marcel-heinz/clawcity.app/issues"
   },
   "homepage": "https://www.clawcity.app",
   "dependencies": {

package/test/formatters.cli.mjs

@@ -1,103 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import {
-  extractMarketOrderId,
-  formatGatherResultLine,
-  formatMarketPricesLines,
-  formatOracleLines,
-  formatRecipesLines,
-} from '../dist/lib/formatters.js';
-
-test('formatGatherResultLine handles zero-resource gathers cleanly', () => {
-  const line = formatGatherResultLine({
-    gathered: { gold: 0, wood: 0, food: 0, stone: 0 },
-    stamina: { efficiency: 100 },
-    tile_status: 'market',
-  });
-
-  assert.equal(line, 'Gathered: none | Efficiency: 100% | Tile: market');
-});
-
-test('extractMarketOrderId supports nested response shape', () => {
-  const id = extractMarketOrderId({
-    order: { id: 'abc-123' },
-    message: 'created',
-  });
-  assert.equal(id, 'abc-123');
-});
-
-test('formatMarketPricesLines parses stats and pair rates', () => {
-  const lines = formatMarketPricesLines({
-    stats: {
-      open_orders: 4,
-      transactions_24h: 9,
-      active_trading_pairs: 2,
-    },
-    pairs: [
-      {
-        offer_resource: 'wood',
-        request_resource: 'stone',
-        order_count: 2,
-        total_offer_available: 100,
-        best_rate: 1.25,
-        avg_rate: 1.4,
-      },
-    ],
-  });
-
-  assert.equal(lines[0], 'Open orders: 4 | 24h transactions: 9 | Active pairs: 2');
-  assert.match(lines[1], /wood->stone/);
-  assert.match(lines[1], /best:1\.25/);
-  assert.match(lines[1], /avg:1\.40/);
-});
-
-test('formatRecipesLines supports craftable + shop payload', () => {
-  const lines = formatRecipesLines({
-    craftable: [
-      {
-        id: 'wooden_pickaxe',
-        recipe: { wood: 40, stone: 10 },
-        effects: ['+25% gathering on mountain'],
-      },
-    ],
-    shop: [
-      {
-        id: 'rations',
-        price: 20,
-        effects: ['+25 food'],
-      },
-    ],
-  });
-
-  assert.equal(lines[0], 'Craftable items:');
-  assert.match(lines[1], /wooden_pickaxe: 40w\+10s/);
-  assert.equal(lines[2], 'Shop items:');
-  assert.match(lines[3], /rations: 20 gold/);
-});
-
-test('formatOracleLines shows outcome progress and step list', () => {
-  const lines = formatOracleLines({
-    contract: {
-      completed_outcomes: 2,
-      total_outcomes: 6,
-    },
-    oracle: {
-      title: 'The Oracle of ClawCity',
-      narrative: 'A short story.',
-      tournament_objective: 'Master Gatherer: total gathered.',
-      starter_prompt: 'You are an autonomous competitor.',
-    },
-    next_steps: [
-      {
-        title: 'Leave Spawn',
-        command: 'clawcity move forest',
-        expected: 'Reach forest terrain.',
-      },
-    ],
-  });
-
-  assert.equal(lines[0], 'The Oracle of ClawCity | Outcomes: 2/6');
-  assert.equal(lines[1], 'A short story.');
-  assert.match(lines[3], /Next steps:/);
-  assert.match(lines[4], /1\. Leave Spawn/);
-});