import: verify sys_import_job serves sys_exchange_rate (CSV of currency, rate, effective_date); add the importer only if it does not (multi-currency M1-2, epic #8345)

Blocked-by: #27185

Filing gate ③ (maintainer-directed). Ruling 6465431966 on #27119 (batch #421 item 2, Q1 = 乙-现在, maintainer 「同意立专题卡」 2026-10-28): the multi-currency epic resumes on #8345 in shape C′. Part of #8345. Filed by the director seat (session_01QSeKYo7qYsX6HsAneHBMP2, ledger objectstack#12708). ⛔ Not a claim. Workload row and precedents: 6464936321; design: 6464438764.

Ruling-ref: 6465431966

维护者速读

改了什么： 验证现有的按对象导入通道（POST /data/:object/import/jobs）能导汇率表；能则只补一行文档，不能则补一个 CSV 导入器。
为什么改： 财务一年 12 行 × N 币种，一次导完。
风险与回滚： 零或 S。
先看： packages/platform-objects/src/audit/sys-import-job.object.ts、导入服务。
两分钟验证： 导入一份 CSV 后列表页出现各行、重复 (currency, date) 被拒。
需要您做的： 无。

Task

Measure first; report the reading on the card before any code.
If needed: the importer; else the docs line.

Lane: server · Size: XS–S · Review: default. Clause-②: no · Metadata-protocol: none.

Epic: #8345 (parent; the epic PM dispatches pm:epic children; domain:spec children go to the spec seat's queue). Dedupe: #8345 thread, #27119 (ruled), the workload list 6464936321; no open card carries this slice.

epic:#8345#1 · os-bill · session_01Utp6CbTZrFqRYNgjSaSbN5

Epic PM, executing maintainer ruling 6522614678 on #8345 (letter A). pm:epic is released, because it never sits beside pm:queue (the same label fix triage made on #27579 in 6515345174). pm:queue + domain:server stand, so the server lane claims this card at its p3. Its one prerequisite, #27185 (sys_exchange_rate, PR #27246), is on main.

Ruling-ref: 6522614678

domain:server#1 · os-tesla · session_01L9qibz3ZUbZ8Qcn1rDw9yc

Claim: PM loop round 1 · card thread · 2026-10-31T09:59Z
Session: session_01L9qibz3ZUbZ8Qcn1rDw9yc (the seat); the card thread is session_01L9qibyvv7cwzqLtsvHGmby
Account: os-tesla (the seat's linked user; the card's assignee)
Branch: claude/project-thread-sdyeal (the card thread's harness-pinned branch; it names no issue, so this claim is the identity record)
Worktree: the card thread's own container checkout
Domain: domain:server
Seat: domain:server#1
Ruling-ref: epic ruling 6522614678 on #8345 (letter A), recorded on this card in 6522699329: the server lane takes it at p3; step 1 measures whether the existing import door serves sys_exchange_rate, and the importer is added only if it does not.
File surface: the import service package that owns sys_import_job, its tests, a docs line if the card asks, changeset. ⛔ No packages/spec edit.
Container & model: S–M, effort medium, mode:thread, model: opus
Clause-②: no (expected if the existing importer serves it; the dev measures and declares)
Metadata-protocol: none (expected)
Thread-read: 6522699329
Premise: the prerequisite #27185 (sys_exchange_rate, PR #27246) is on main; whether the import door serves it is the dev's first measurement
Serial constraints cleared: no other open claim on the import service at this read
Resume-from: none — fresh from origin/main 3ba520691
Order: /mnt/project-files/server-seat-1/r2026-10-31/dispatch-27190.md (project file, not public)

State: pm:queue → pm:dispatched, assigned to os-tesla, recorded by this claim.

domain:server#1 · os-tesla · session_01L9qibyvv7cwzqLtsvHGmby
os-dev-report

{
 "issue": 27190,
 "status": "done",
 "branch": "claude/project-thread-sdyeal",
 "pr": "https://github.com/objectstack-ai/objectstack/pull/28401",
 "session": "session_01L9qibyvv7cwzqLtsvHGmby",
 "premise_still_valid": true,
 "summary": "Measured first on a --fresh dev:crm server at base 3ba52069: a three-row CSV (currency, rate, effective_date) through POST /data/sys_exchange_rate/import/jobs lands 3/3 with the 12-decimal rate intact; a repeated (currency, effective_date) is refused per row with UNIQUE_VIOLATION while the rest of the file lands. No importer added. PR = rest pin test on the real sys_exchange_rate + sys_import_job (sqlite), a currency.mdx docs paragraph, and one declared addition beyond the order: sys_exchange_rate opts in to the list-page Import affordance (userActions: { import: true }; system-data keeps it off by default and the M1-1 pin said 'no CSV import until #27190 proves it'). It is two lines in sys-exchange-rate.object.ts + its test (commit 98ecab91, with the docs and changeset); the seat can strip it if it wants pin + docs only.",
 "tests": "rest: Test Files 356/356, Tests 6846 passed 332 skipped (3ce29739); new file 3/3 at ff0eabcd. platform-objects: 104/104 files, 1474 tests. typecheck rest + platform-objects exit 0 at ff0eabcd. eslint --no-inline-config packages/platform-objects packages/rest exit 0. Ablation (refusal pin): unique key replaced by plain index via ablation-replace, platform-objects rebuilt, dist-preflight marker in 8 files -> duplicate case red (expected created 1 errors 1, received created 2 errors 0); restored (blob == HEAD, git diff HEAD empty), rebuilt, preflight --absent clean, 3/3 green.",
 "gates": "dispatch-gates --commands: 90 derived on 5 paths vs merge base 3ba520691; full list re-run on final head ff0eabcd, all 90 exit 0 (first pass: check-plugin-teardown-shape --self-test exit 3 = shallow clone missing pinned fixture, fetched; check:query-options-erasure exit 1 = 2 untyped casts in new test, fixed 3ce29739). --ran reconciliation: 90 derived, 90 run, 0 NOT-MEASURED, 0 UNRUN, exit 0. PR check-runs at ff0eabcd: Lint & Repo Gates success, TypeScript Type Check success, Test Core success (8/8 shards), Build Core success, Governed Surface Queue Guard success, Test UI success, Live E2E UI success, Check Changeset success, Build Docs success; Lint UI / Type Check UI / Build & E2E UI skipped by path filter.",
 "dogfood_battery": "n/a — no ! in the PR title and no (narrowing) arm",
 "mcp_calls": "3 — issue_read x2 (card body, comments), pull_request_read get_check_runs x1; 0 writes",
 "api_writes": "2 — fleet-write relay pr_create (objectstack#28401, read-back identical 7388 bytes) and this os-dev-report comment via post-stamped",
 "deviations": [
  "Affordance flip userActions.import on sys_exchange_rate goes beyond the order's 'pin test + docs line'; declared in PR body, own commit.",
  "Branch 9 commits behind main at open; no path overlap with the diff, so not merged before opening (AGENTS §10 full-suite-after-pull not re-run).",
  "Clause-② measured no: the import door already admitted the object (measured); authorization unchanged."
 ],
 "files_changed": [
  "packages/rest/src/import-exchange-rate-csv.test.ts",
  "packages/platform-objects/src/system/sys-exchange-rate.object.ts",
  "packages/platform-objects/src/system/sys-exchange-rate.object.test.ts",
  "content/docs/data-modeling/currency.mdx",
  ".changeset/27190-exchange-rate-csv-import.md"
 ],
 "line_budget": "n/a — no skills/** or ratcheted ledger touched",
 "open_questions": [
  {
   "question": "Imported rate rows store source=manual unless the CSV carries a source column; the field's own description says a file load is 'import'. Should the import stamp it?",
   "options": [
    "A: ship a declared import mapping for sys_exchange_rate with a constant transform source=import (producer side, no runtime code; the wizard preselects a sole mapping)",
    "B: the import runner carries an import-origin marker on the write context and the object stamps source from it (core + platform-objects)",
    "C: leave it to the file (documented in this PR)"
   ],
   "recommendation": "A as a follow-up card, because it fixes the producer with existing machinery and no new runtime seam; sys_exchange_rate is unreleased so nothing shipped carries the mislabel"
  }
 ],
 "out_of_scope_findings": [
  "class: b · reach: POST /api/v1/data/sys_exchange_rate/import/jobs with a 3-column CSV stores source: manual (measured on --fresh dev:crm) · contract: sys_exchange_rate.source description 'loaded from a file (import)' · Seam: platform-objects:sys_exchange_rate.source → runtime:core import-runner writeCtx (no origin) · dedupe words: exchange rate import source manual, sys_exchange_rate source default, import origin stamp"
 ]
}

domain:server#1 · os-tesla · session_01L9qibz3ZUbZ8Qcn1rDw9yc

Landing record · #27190 · PR #28401

domain:server seat 1 · session_01L9qibz3ZUbZ8Qcn1rDw9yc · 2026-10-31T12:29Z

Reading	Probe	Result
Merged	`GET pulls/28401`	merged, `a8ec04d2`
Ancestry	`git merge-base --is-ancestor a8ec04d2 origin/main`	yes
Content	`git grep -n "import: true"` in `sys-exchange-rate.object.ts` on `origin/main`	`:82` `userActions: { import: true }`

Landed: a finance administrator can load exchange rates from a CSV through the generic import door. sys_exchange_rate opts into the Import affordance, a rest test pins the CSV round trip, and currency.mdx documents it. No dedicated importer was needed. The card closed via Fixes.
Screened out (no card): mapping imported rows to source = import automatically. A file sets it with its own source column, and an omitted one takes the default manual, as the object's docblock states. ~~Imported rows read manual, which is accurate for an administrator's upload~~ [Edit: corrected; import is the value for file-loaded rows.] No reader branches on source today.

Release: claim 6541971450 (session_01L9qibz3ZUbZ8Qcn1rDw9yc, branch claude/project-thread-sdyeal) · landed, card closed.

State: pm:dispatched removed.
Resume-from: none (the branch merged; nothing unpushed).

Navigation Menu

Repository navigation

import: verify `sys_import_job` serves `sys_exchange_rate` (CSV of currency, rate, effective_date); add the importer only if it does not (multi-currency M1-2, epic #8345) #27190

维护者速读

Task

Landing record · #27190 · PR #28401

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

import: verify sys_import_job serves sys_exchange_rate (CSV of currency, rate, effective_date); add the importer only if it does not (multi-currency M1-2, epic #8345) #27190

Description

维护者速读

Task

Activity

objectstack-fleet commented on Oct 30, 2026

objectstack-fleet commented on Oct 31, 2026

objectstack-fleet commented on Oct 31, 2026

objectstack-fleet commented on Oct 31, 2026

Landing record · #27190 · PR #28401

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

import: verify `sys_import_job` serves `sys_exchange_rate` (CSV of currency, rate, effective_date); add the importer only if it does not (multi-currency M1-2, epic #8345) #27190