@attocash/cli 0.2.1 → 0.2.2

package/README.md

@@ -373,6 +373,12 @@ outstanding checks, including native credential probes and their subprocesses.
 Doctor does not check npm for updates.
 
 An agent should call the MCP **`doctor` tool** to inspect the server's own process.
+`wallet_status.initialized` describes the saved public wallet identity; status
+does not read the password store. If a signing operation returns
+`WALLET_CREDENTIAL_MISSING`, the profile remains initialized but its credential
+lookup returned empty. Run doctor in that session before attempting recovery;
+do not reset or replace the wallet to repair credential access.
+
 A terminal result cannot establish that an already-running MCP has the same
 environment. When a user-owned Linux session socket is available, doctor may test
 environment overrides in an isolated credential probe. It returns
@@ -615,6 +621,8 @@ atto wallet configure --representative <atto-address>
 Configuration updates preserve omitted settings. Supply at least one option.
 `--representative` changes the default used to open accounts; use
 `atto representative change <address>` to change an existing account's representative.
+Selecting the account's current representative returns `REPRESENTATIVE_UNCHANGED`
+without signing or publishing a transaction.
 `wallet status` shows the profile directory and whether receiving runs in that
 process; it does not report receiving sessions in other terminals.
 

package/dist/application/app.js

@@ -173,8 +173,12 @@ export class AttoApplication {
         this.recoveryReads++;
         try {
             const phrase = await this.secrets.get();
-            if (!phrase)
+            if (!phrase) {
+                this.requireResetFinished();
+                if (this.identity())
+                    throw new AttoError('WALLET_CREDENTIAL_MISSING', 'The wallet is initialized, but the OS password store returned no recovery phrase for this profile. Run doctor in this session to check credential access. Do not reset or replace the wallet.');
                 throw new AttoError('WALLET_NOT_INITIALIZED', 'Create or import a wallet through the CLI first.');
+            }
             return phrase;
         }
         finally {

package/dist/application/operations.js

@@ -69,7 +69,7 @@ export const operations = [
     { name: 'terms_accept', description: 'Persist acknowledgement of the specified terms version for USD-priced payments. Call only after the user has read and explicitly accepted those terms.', schema: z.strictObject({ version: z.string().min(1).max(128), accepted: z.literal(true) }), readOnly: false },
     { name: 'receive', description: 'Receive one pending payment by hash, opening the account if needed.', schema: z.strictObject({ index: index.default(0), hash, representative: address.optional() }), readOnly: false },
     { name: 'receive_all', description: 'Receive a bounded set of pending payments for a key index, opening the account if needed.', schema: z.strictObject({ index: index.default(0), limit: limit.default(100), timeoutMs: timeoutMs.default(2000), representative: address.optional() }), readOnly: false },
-    { name: 'representative_change', description: 'Publish a representative change for an existing account.', schema: z.strictObject({ index: index.default(0), representative: address }), readOnly: false },
+    { name: 'representative_change', description: 'Publish a representative change for an existing account. Selecting its current representative returns REPRESENTATIVE_UNCHANGED without publishing.', schema: z.strictObject({ index: index.default(0), representative: address }), readOnly: false },
     { name: 'limits_get', description: 'Read spending policy, approved send pool, MCP access, proposal status, historical usage, reservations, and remaining allowances.', schema: z.strictObject({}), readOnly: true },
     { name: 'limits_propose', description: 'Propose spending limits, MCP access, and optional send-pool settings for local terminal approval. Omitted pool preserves the approved pool. Does not change active settings or grant access. A new proposal replaces the previous proposal and expires after 24 hours. Read limits_get for active settings and proposal status. Amounts are ATTO or RAW; null perRequest with empty rolling means unlimited spending if approved.', schema: z.strictObject({ policy, access: z.enum(['read-only', 'spend']).default('spend'), pool: pool.optional() }), readOnly: false },
     { name: 'watch_start', description: 'Start an observational, reconnecting watch for this session, defaulting to active wallet addresses. Choose one saved index, explicit addresses (including foreign accounts), a transaction/entry hash, or networkWide=true. Network-wide receivables are unsupported. Read buffered events and connection status with watch_read. Does not enable automatic receiving.', schema: z.strictObject({ event: z.enum(['account', 'transaction', 'entry', 'receivable']), ...streamFields, index: index.optional(), networkWide: z.boolean().optional() }).refine(singleSelection, 'Choose one watch selection.').refine(value => !(value.networkWide && value.event === 'receivable'), 'Receivable watches require addresses.'), readOnly: false },

package/dist/wallet/signing.js

@@ -119,7 +119,13 @@ export async function signingWallet(seed, index, settings, beforeSign, suppliedW
         },
         async change(value, representative, timestamp) {
             requireIndex(value);
-            return perform(time => attoAccountChange(requireAccount(), representative, time), timestamp);
+            return perform(time => {
+                const current = requireAccount();
+                if (current.representativeAddress.value === representative.value) {
+                    throw new AttoError('REPRESENTATIVE_UNCHANGED', 'This account already uses the requested representative. Choose a different representative to publish a change.');
+                }
+                return attoAccountChange(current, representative, time);
+            }, timestamp);
         },
         async getAccountByIndex(value) { requireIndex(value); return account ?? null; },
         close() { signer = undefined; },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attocash/cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Atto wallet CLI and reusable wallet engine with local key custody and shared spending limits",
   "license": "BSD-3-Clause",
   "type": "module",