@yigemo/choosefire 0.3.0 → 0.4.0

package/README.md

@@ -63,6 +63,11 @@ choosefire wealth account-show --account-id <uuid> --json
 choosefire wealth holding-create --command-id <uuid> --holding-id <uuid> --account-id <uuid> --name "Global Equity ETF" --currency CNY --expected-workspace-version <n> --idempotency-key <key> [--instrument-ref ETF-EXAMPLE-001] [--quantity 12.5 --quantity-as-of <iso>] --json
 choosefire wealth holding-update --command-id <uuid> --holding-id <uuid> --name "Global Equity ETF" --currency CNY --expected-object-revision <n> --expected-workspace-version <n> --idempotency-key <key> [--quantity 13.5 --quantity-as-of <iso>] --json
 choosefire wealth holding-archive --command-id <uuid> --holding-id <uuid> --reason "Position closed" --expected-object-revision <n> --expected-workspace-version <n> --idempotency-key <key> --json
+choosefire transaction cash-flow --cash-flow-id <uuid> --account-id <uuid> --direction in --amount 2500 --currency CNY --occurred-at <iso> --expected-workspace-version <n> --idempotency-key <key> --json
+choosefire transaction create --transaction-id <uuid> --account-id <uuid> --holding-id <uuid> --type buy --amount 1000 --currency CNY --quantity 10 --price 100 --trade-at <iso> --expected-workspace-version <n> --idempotency-key <key> --json
+choosefire transaction update --transaction-id <uuid> --account-id <uuid> --holding-id <uuid> --type buy --amount 1100 --currency CNY --quantity 10 --price 110 --trade-at <iso> --expected-object-revision <n> --expected-workspace-version <n> --idempotency-key <key> --json
+choosefire transaction archive --transaction-id <uuid> --reason "Duplicate import" --expected-object-revision <n> --expected-workspace-version <n> --idempotency-key <key> --json
+choosefire transaction timeline --account-id <uuid> [--holding-id <uuid>] --json
 choosefire plan list --json
 choosefire plan get <plan-id> --json
 choosefire plan update-inputs <plan-id> --annual-return 0.035 --annual-inflation 0.04 --expected-updated-at <iso> --dry-run --json
@@ -74,7 +79,7 @@ choosefire asset remove --plan <plan-id> --account-id asset-bank --reason "dupli
 choosefire visual dataset --plan <plan-id> --kind overview --json
 ```
 
-The `workspace`, `household`, and `wealth` operations use the workspace bearer only, validate every request and response against the checked-in contract, never retry mutations, and never fall back to the legacy token or local files. Workspace and family-wealth v2 are enabled by default now that the production capability is public; set `CHOOSEFIRE_ACCOUNT_WORKSPACE_ENABLED=false` or `CHOOSEFIRE_FAMILY_WEALTH_V2_ENABLED=false` for an explicit rollback/compatibility run. Holding commands are available only for detailed accounts. `--quantity` and `--quantity-as-of` must be supplied together so scripts and audit replays remain deterministic. Give every wealth mutation an explicit `--command-id`; when an outcome is unknown, first read the latest projection and then explicitly retry the exact serialized body with the original command ID and idempotency key to recover the receipt-first outcome. Never generate a new ID or key for that recovery attempt. The JSON error includes this exact recovery material and action.
+The `workspace`, `household`, `wealth`, and `transaction` operations use the workspace bearer only, validate every request and response against the checked-in contract, never retry mutations, and never fall back to the legacy token or local files. Workspace and family-wealth v2 are enabled by default now that the production capability is public; set `CHOOSEFIRE_ACCOUNT_WORKSPACE_ENABLED=false` or `CHOOSEFIRE_FAMILY_WEALTH_V2_ENABLED=false` for an explicit rollback/compatibility run. Holding and investment transaction commands are available only for detailed accounts. Buy, sell, subscribe, and redeem require a holding, quantity, and price; deposits and withdrawals remain external cash flows. Give every mutation an explicit `--command-id`; when an outcome is unknown, first read the latest projection and then explicitly retry the exact serialized body with the original command ID and idempotency key to recover the receipt-first outcome. Never generate a new ID or key for that recovery attempt. The JSON error includes this exact recovery material and action.
 
 Existing legacy plan write commands still default to dry-run unless `--apply` is passed. For CLI and MCP sources, `--expected-updated-at` should be provided to avoid overwriting newer data.
 

package/contracts/choosefire-family-wealth/v2/capability-matrix.v1.json

@@ -178,18 +178,18 @@
       "webPath": "/app/assets/:id"
     },
     {
-      "builtinAi": "apply_with_confirmation",
+      "builtinAi": "unavailable",
       "capabilityId": "transaction.record",
-      "cliPath": "transaction record",
-      "commandOrQuery": "transaction.record.v2",
+      "cliPath": "transaction create|update|archive|timeline",
+      "commandOrQuery": "investment_transaction.create|update|archive.v2 + account.activity_timeline.v2",
       "fixtureIds": [
         "CFW-FIX-003"
       ],
-      "mcpSurface": "choosefire.transaction.record",
+      "mcpSurface": "unavailable (R3 MCP is read-only)",
       "milestone": "R3",
       "requiredRole": "owner",
       "riskLevel": "L1",
-      "status": "absent",
+      "status": "web",
       "storyIds": [
         "CAPTURE-01",
         "TRACK-01"

package/contracts/choosefire-family-wealth/v2/manifest.json

@@ -1,10 +1,10 @@
 {
-  "aggregateSha256": "6674c1519f2c624417763c6a04b272ed192d80808bb6a066d1c996506bd0b386",
+  "aggregateSha256": "c93e376036957ca8a7b57af66d71539fb9aeb351b453d1ed7b7b28c4b39cb2ff",
   "artifacts": [
     {
-      "bytes": 12295,
+      "bytes": 12365,
       "path": "capability-matrix.v1.json",
-      "sha256": "81031a02b50c7d03ed6d35757886c343e5abb487330b828e011bc74d93ea0e59"
+      "sha256": "1fad812434d8a95edb1643125586ea3bbd2f0834c5c3925096ac33792b07579c"
     },
     {
       "bytes": 1974,
@@ -32,14 +32,14 @@
       "sha256": "a956ab303c2b35720c8328649170a8e0c18ea37a36d98614b46adfc56f5c51cc"
     },
     {
-      "bytes": 93734,
+      "bytes": 115365,
       "path": "openapi.generated.json",
-      "sha256": "e5f7896c6c056e2ef96a86a9dbf30d23ed32409f25d0ae05ba3de4cf5c242232"
+      "sha256": "69be924ee8f365f301372dae617c33c38585b2a6ddaf194ea7c55aa254b5c64d"
     },
     {
-      "bytes": 68643,
+      "bytes": 81952,
       "path": "runtime-schemas/family-wealth.v2.schema.json",
-      "sha256": "c40b4d8ed3c13097c9fffae9260f03ecb93393a3f4db8ba6f4bf58a74fee817e"
+      "sha256": "f8c9da648a4f266fe747ed98a10699c455a6e1e61431a54d3fa876b068665331"
     },
     {
       "bytes": 700,