pm-csv 2026.10.23 → 2026.10.24

package/dist/table-schema.js

@@ -0,0 +1,260 @@
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync } from "node:fs";
+import { getWorkspaceContracts, PmCliError } from "@unbrained/pm-cli/sdk";
+import { IMPORT_COLUMNS, parseCSV, stripBOM, resolveDelimiter, parseFieldMap, resolveImportFieldMap, validateFieldMapTargets, checkMapSourcesPresent, validateParsedCSV, strictValidationIssues, normalizeStatus, importParsedCSV, readBoolOption } from "./index.js";
+/** Expected SDK/CLI refusal with an actionable remedy and semantic usage exit code. */
+export class TableSchemaRefusal extends PmCliError {
+    /** Stable category for automated refusal handling. */
+    code;
+    /** Concrete recovery action required before retrying. */
+    remedy;
+    constructor(code, remedy) {
+        super(`${code}: ${remedy}`, 2, { code, required: remedy, nextSteps: [remedy] });
+        this.code = code;
+        this.remedy = remedy;
+    }
+}
+/** Reject malformed quoting before using the existing parser; inspect only record separators outside quotes. */
+function readTable(text, delimiter) {
+    if (Buffer.byteLength(text) > 8 * 1024 * 1024 || delimiter.length !== 1 || /["\r\n\uFEFF]/.test(delimiter)) {
+        throw new TableSchemaRefusal("csv_table_invalid", "Use at most 8 MiB of UTF-8 CSV and a single delimiter other than quotes or newlines.");
+    }
+    const source = stripBOM(text);
+    let state = "start";
+    const endings = new Set();
+    for (let index = 0; index < source.length; index++) {
+        const char = source[index];
+        if (state === "quoted") {
+            if (char === '"') {
+                if (source[index + 1] === '"')
+                    index++;
+                else
+                    state = "after";
+            }
+            continue;
+        }
+        if (char === delimiter)
+            state = "start";
+        else if (char === "\n" || char === "\r") {
+            if (char === "\r") {
+                if (source[++index] !== "\n")
+                    throw new TableSchemaRefusal("csv_table_invalid", "Use LF or CRLF record separators; bare CR is unsupported.");
+                endings.add("crlf");
+            }
+            else
+                endings.add("lf");
+            state = "start";
+        }
+        else if (char === '"' && state === "start")
+            state = "quoted";
+        else if (char === '"' || state === "after") {
+            throw new TableSchemaRefusal("csv_table_invalid", "Quote complete fields and double embedded quotes; remove characters after closing quotes.");
+        }
+        else
+            state = "plain";
+    }
+    if (state === "quoted" || endings.size > 1)
+        throw new TableSchemaRefusal("csv_table_invalid", "Close every quoted field and use one consistent record separator.");
+    const table = parseCSV(source, delimiter);
+    const headers = table[0];
+    if (!headers?.length || headers.length > 128 || table.length > 10001 ||
+        headers.some(header => !header.trim() || header.length > 128) ||
+        new Set(headers.map(header => header.trim().toLowerCase())).size !== headers.length ||
+        table.some(row => row.length !== headers.length || row.every(cell => !cell.trim()))) {
+        throw new TableSchemaRefusal("csv_table_invalid", "Provide 1-128 distinct nonempty headers, at most 10000 data rows, matching row widths and no empty records.");
+    }
+    return { table, dialect: { delimiter, quote: '"', bom: text.startsWith("\uFEFF"), eol: [...endings][0] ?? "none" } };
+}
+/** Infer a conservative lexical domain over the complete column, never a sample. */
+function inferDomain(values) {
+    const nonempty = values.map(value => value.trim()).filter(Boolean);
+    const kind = nonempty.length === 0 ? "empty" : nonempty.every(value => /^[+-]?\d+$/.test(value)) ? "integer"
+        : nonempty.every(value => /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/.test(value)) ? "decimal"
+            : nonempty.every(value => /^(true|false)$/i.test(value)) ? "boolean" : "text";
+    return { kind, nullable: nonempty.length < values.length };
+}
+/** Canonical SHA-256 contract identity. Key ordering is reconstructed by the schema reader. */
+function revision(base) {
+    return createHash("sha256").update(JSON.stringify(base)).digest("hex");
+}
+/** Read native target enums without activating extensions or invoking git. */
+async function targetContract(pmRoot) {
+    const contracts = await getWorkspaceContracts(pmRoot, { noExtensions: true });
+    return { types: contracts.types.sort(), statuses: contracts.statuses.sort() };
+}
+/** Project only explicitly mapped columns; ignored canonical-looking headers cannot acquire meaning. */
+function mappedTable(table, columns) {
+    const selected = columns.map((column, index) => ({ ...column, index })).filter(column => column.field !== null);
+    return [selected.map(column => column.field), ...table.slice(1).map(row => selected.map(column => row[column.index]))];
+}
+/** Reuse strict import checks, then check mapped type/status destinations against the SDK contract. */
+function validateMapping(table, columns, target) {
+    const projected = mappedTable(table, columns);
+    const report = validateParsedCSV(projected[0], projected.slice(1), {});
+    if (strictValidationIssues(report).length || table.slice(1).some(row => columns.some((column, index) => {
+        const value = row[index].trim();
+        return value !== "" && ((column.field === "type" && !target.types.includes(value)) ||
+            (column.field === "status" && !target.statuses.includes(normalizeStatus(value))));
+    })))
+        throw new TableSchemaRefusal("csv_table_invalid", "Correct missing titles, unsupported types/statuses, priorities outside 0-4 or ambiguous pm mappings, then describe again.");
+}
+/** Produce bounded summary counts without returning table contents. */
+function receipt(schema, rows) {
+    const mapped = schema.columns.filter(column => column.field !== null).length;
+    return { version: 1, revision: schema.revision, rows, columns: schema.columns.length, mapped, ignored: schema.columns.length - mapped };
+}
+/** Describe and propose a reusable schema without writing tracker state or artifacts. */
+export async function describeTable(pmRoot, text, options = {}) {
+    const delimiter = resolveDelimiter(options.delimiter);
+    const { table, dialect } = readTable(text, delimiter);
+    const headers = table[0].map(header => header.trim().toLowerCase());
+    const explicit = options.fieldMap ?? {};
+    if (validateFieldMapTargets(explicit).length || checkMapSourcesPresent(headers, explicit).length) {
+        throw new TableSchemaRefusal("csv_table_invalid", "Map existing normalized source headers to supported CSV import fields.");
+    }
+    const { fieldMap } = resolveImportFieldMap(headers, explicit, options.autoMap ?? false);
+    const columns = table[0].map((name, index) => {
+        const field = fieldMap[headers[index]] ?? headers[index];
+        return { name, domain: inferDomain(table.slice(1).map(row => row[index])), field: IMPORT_COLUMNS.includes(field) ? field : null };
+    });
+    const target = await targetContract(pmRoot);
+    validateMapping(table, columns, target);
+    const base = { version: 1, dialect, columns, target };
+    const schema = { ...base, revision: revision(base) };
+    return { schema, receipt: receipt(schema, table.length - 1) };
+}
+/** Narrow an unknown JSON artifact before accessing nested properties. */
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Validate artifact version, bounds, mapping shape and canonical identity. Unknown versions fail closed. */
+export function parseTableSchema(value) {
+    const invalid = new TableSchemaRefusal("csv_schema_invalid", "Use an unchanged version 1 schema produced by csv schema describe; create a new artifact for intentional changes.");
+    if (!record(value) || value.version !== 1 || typeof value.revision !== "string" || !record(value.dialect) ||
+        !record(value.target) || !Array.isArray(value.columns) || value.columns.length < 1 || value.columns.length > 128)
+        throw invalid;
+    const { dialect, target } = value;
+    if (typeof dialect.delimiter !== "string" || dialect.delimiter.length !== 1 || /["\r\n\uFEFF]/.test(dialect.delimiter) ||
+        dialect.quote !== '"' || typeof dialect.bom !== "boolean" || !["lf", "crlf", "none"].includes(String(dialect.eol)) ||
+        !Array.isArray(target.types) || !Array.isArray(target.statuses) ||
+        [...target.types, ...target.statuses].some(entry => typeof entry !== "string"))
+        throw invalid;
+    const columns = value.columns.map((column) => {
+        if (!record(column) || typeof column.name !== "string" || !column.name.trim() || column.name.length > 128 ||
+            !record(column.domain) || !["empty", "integer", "decimal", "boolean", "text"].includes(String(column.domain.kind)) ||
+            typeof column.domain.nullable !== "boolean" || (column.field !== null && !IMPORT_COLUMNS.includes(column.field)))
+            throw invalid;
+        return { name: column.name, domain: { kind: column.domain.kind, nullable: column.domain.nullable }, field: column.field };
+    });
+    const fields = columns.flatMap(column => column.field === null ? [] : [column.field]);
+    if (new Set(columns.map(column => column.name.trim().toLowerCase())).size !== columns.length ||
+        new Set(fields).size !== fields.length || !fields.includes("title"))
+        throw invalid;
+    const base = { version: 1, dialect: { delimiter: dialect.delimiter, quote: '"', bom: dialect.bom, eol: dialect.eol },
+        columns, target: { types: [...target.types], statuses: [...target.statuses] } };
+    if (revision(base) !== value.revision)
+        throw invalid;
+    return { ...base, revision: value.revision };
+}
+/** Enforce a saved mapping against the full new table before any tracker mutation. */
+export async function previewTable(pmRoot, text, saved) {
+    const schema = parseTableSchema(saved);
+    const { table, dialect } = readTable(text, schema.dialect.delimiter);
+    if (JSON.stringify(dialect) !== JSON.stringify(schema.dialect) || JSON.stringify(table[0]) !== JSON.stringify(schema.columns.map(column => column.name))) {
+        throw new TableSchemaRefusal("csv_schema_changed", "Review changed headers, order or dialect; run csv schema describe into a new artifact and explicitly approve its mappings.");
+    }
+    for (const [index, column] of schema.columns.entries()) {
+        const next = inferDomain(table.slice(1).map(row => row[index]));
+        if ((!column.domain.nullable && next.nullable) || (next.kind !== "empty" && column.domain.kind !== "text" && next.kind !== column.domain.kind &&
+            !(column.domain.kind === "decimal" && next.kind === "integer"))) {
+            throw new TableSchemaRefusal("csv_domain_changed", "Review changed value domains or new empty cells; describe the revised table into a new schema before importing.");
+        }
+    }
+    if (JSON.stringify(await targetContract(pmRoot)) !== JSON.stringify(schema.target)) {
+        throw new TableSchemaRefusal("csv_target_changed", "Review tracker type/status changes and describe a new table schema against the current tracker.");
+    }
+    validateMapping(table, schema.columns, schema.target);
+    return receipt(schema, table.length - 1);
+}
+/** Negotiate a captured UTF-8 table then use the existing import mutation/upsert core.
+ * Preview never runs mutation hooks. Import retains legacy partial-write semantics on row failures.
+ */
+export async function importNegotiatedTable(pmRoot, text, saved, options = {}) {
+    const schema = parseTableSchema(saved);
+    const { dryRun, keyField } = options;
+    const summary = await previewTable(pmRoot, text, schema);
+    if (dryRun)
+        return { ...summary, imported: 0, updated: 0, skipped: 0 };
+    const { table } = readTable(text, schema.dialect.delimiter);
+    const result = importParsedCSV(pmRoot, mappedTable(table, schema.columns), { delimiter: schema.dialect.delimiter, fieldMap: {}, dryRun: false, keyField });
+    if (result.errors.length)
+        throw new TableSchemaRefusal("csv_table_import_failed", `Inspect tracker state and import policies before retrying: imported=${result.imported}, updated=${result.updated}, skipped=${result.skipped}, errors=${result.errors.length}. Use csv import --atomic when rollback is required.`);
+    return { ...summary, imported: result.imported, updated: result.updated, skipped: result.skipped };
+}
+/** Read UTF-8 input and optional JSON contract without leaking IO paths in refusals. */
+function readInputs(file, schemaFile) {
+    try {
+        if (!file)
+            throw new Error("missing input");
+        const bytes = readFileSync(file);
+        const text = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+        return { text, saved: schemaFile === undefined ? undefined : JSON.parse(readFileSync(schemaFile, "utf8")) };
+    }
+    catch {
+        throw new TableSchemaRefusal("csv_schema_io", "Provide readable UTF-8 CSV and, for preview/import, a readable versioned JSON schema.");
+    }
+}
+/** Register native host-rendered TOON/JSON commands; full artifacts are written only on explicit request. */
+export function registerTableSchemaCommands(api) {
+    api.registerCommand({
+        name: "csv schema describe", description: "Describe a bounded UTF-8 table and propose a versioned pm mapping without tracker writes.",
+        arguments: [{ name: "file", required: true, description: "UTF-8 CSV input" }],
+        flags: [
+            { long: "--delimiter", value_name: "char", description: "Delimiter or comma|semicolon|tab|pipe (default comma)" },
+            { long: "--map", value_name: "mapping", description: "Normalized Source=field pairs" },
+            { long: "--auto-map", description: "Propose existing unambiguous import aliases" },
+            { long: "--output", value_name: "file", description: "Exclusively create reusable JSON schema; never overwrite" },
+        ],
+        async run(ctx) {
+            const { text } = readInputs(ctx.args[0]);
+            let fieldMap;
+            try {
+                fieldMap = parseFieldMap(ctx.options["map"]);
+            }
+            catch {
+                throw new TableSchemaRefusal("csv_table_invalid", "Use --map Source=title,Rank=priority with supported import fields.");
+            }
+            const described = await describeTable(ctx.pm_root, text, { delimiter: ctx.options["delimiter"], fieldMap, autoMap: readBoolOption(ctx.options, "auto-map", "autoMap") });
+            const output = ctx.options["output"];
+            if (output) {
+                try {
+                    writeFileSync(output, `${JSON.stringify(described.schema, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+                }
+                catch {
+                    throw new TableSchemaRefusal("csv_schema_io", "Choose a new writable schema filename; existing artifacts are preserved.");
+                }
+            }
+            return { ...described.receipt, saved: Boolean(output) };
+        },
+    });
+    for (const action of ["preview", "import"])
+        api.registerCommand({
+            name: `csv schema ${action}`, description: `${action === "preview" ? "Check" : "Import"} a table using an unchanged saved schema; refuse drift before writes.`,
+            arguments: [{ name: "file", required: true, description: "UTF-8 table matching the saved dialect" }],
+            flags: [
+                { long: "--schema", value_name: "file", description: "Required version 1 JSON schema" },
+                { long: "--dry-run", description: "Read-only negotiation; no item or history writes" },
+                { long: "--key", value_name: "field", description: "Existing import upsert key (import only)" },
+            ],
+            async run(ctx) {
+                const schemaFile = ctx.options["schema"];
+                const keyField = ctx.options["key"];
+                if (!schemaFile || (keyField !== undefined && !IMPORT_COLUMNS.includes(keyField))) {
+                    throw new TableSchemaRefusal("csv_schema_invalid", "Provide --schema saved.json and, optionally, a supported import field for --key.");
+                }
+                const { text, saved } = readInputs(ctx.args[0], schemaFile);
+                return { ...await importNegotiatedTable(ctx.pm_root, text, saved, { dryRun: action === "preview" || readBoolOption(ctx.options, "dry-run", "dryRun"), keyField }) };
+            },
+        });
+}
+//# sourceMappingURL=table-schema.js.map

package/dist/table-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-schema.js","sourceRoot":"","sources":["../table-schema.ts"],"names":[],"mappings":"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"}

package/docs/compatibility-2026.10.20.md

@@ -0,0 +1,76 @@
+# pm-cli 2026.10.20 compatibility
+
+Dependabot [PR 177](https://github.com/unbraind/pm-csv/pull/177) updates the
+development host from 2026.10.15 to 2026.10.20. Its original Node 22 and Node 26
+CI jobs failed three tests. The priority-99 row errors in those logs are
+deliberately injected invalid inputs, not unexpected update failures.
+
+| Failure | Root cause | Adaptation |
+| --- | --- | --- |
+| Malformed SDK journal identities | The SDK now distinguishes `transaction_journal_invalid` from a valid journal that mismatches the plan. pm-csv depended on the older combined diagnostic and decoded bindings before validating the schema and transaction identity. | Validate both identities before using bindings or entering the coordinator; throw a host-recognized `CommandError`. Keep the original plan-mismatch refusal and prove every fixture byte stays unchanged. |
+| Partial create/update command and importer failures | The tests read `priority` from default brief list rows. `--all` selects statuses, independently of projection, on the new host. | Request `--full` in the verification reads. Keep the exact error counts, continuation, priority and absence assertions. Production complete-list readers already request `--output-include full` and certify completeness. |
+| Legacy CLI parity without git | The same brief-row assumption in a real CLI verification read. | Request `--full`; retain both command spellings, streaming and buffered imports, a PATH without git, dry-run snapshots and nonzero failure assertions. |
+
+## Version evidence
+
+Read release notes for 2026.10.17 through 2026.10.20. There is no v2026.10.16
+release; v2026.10.17 covers the source range starting at v2026.10.15.
+
+- [2026.10.17](https://github.com/unbraind/pm-cli/releases/tag/v2026.10.17)
+  adds SDK bulk creation. Its
+  [implementation](https://github.com/unbraind/pm-cli/commit/94757af3016420bfda6b6fc1905be7814ee2ea1d)
+  separates invalid journals from plan mismatches in
+  `src/sdk/workspace-transaction.ts`.
+- [2026.10.18](https://github.com/unbraind/pm-cli/releases/tag/v2026.10.18)
+  documents GH-1489, keeping all-status selection independent of projection.
+- [2026.10.19](https://github.com/unbraind/pm-cli/releases/tag/v2026.10.19)
+  adds encoding aliases; [2026.10.20](https://github.com/unbraind/pm-cli/releases/tag/v2026.10.20)
+  preserves JSON row facts and compacts default brief TOON envelopes. Neither
+  promises priority in a brief list row.
+
+Real installed-host probes in fresh non-git trackers confirmed:
+
+| Host | Default `list --all --json` priority | With `--full` | Bad journal schema |
+| --- | --- | --- | --- |
+| 2026.10.15 | 2 | 2 | journal does not match the supplied plan |
+| 2026.10.20 | omitted | 2 | journal is invalid (schema version or transaction id does not match the journal file) |
+
+Both hosts rejected priority 99 with exit 2 and accepted priority 2. No upstream
+regression was established by these failures, so no new upstream issue draft
+is needed.
+
+## Regression proof
+
+The focused command is:
+
+```sh
+npm run build && npm run build:test && node --test --test-name-pattern="malformed SDK journal|partial create/update|legacy CSV CLI" test/atomic-update.test.ts test/commands.test.ts test/legacy-import-cli.test.ts
+```
+
+It passes 3/3 with the pinned host on PATH. The journal test covers malformed
+step shapes, missing/unsupported schemas and missing/foreign transaction ids in
+source and built code. It asserts refusal before coordinator entry and compares
+all fixture file bytes, including item history and the journal itself.
+
+Reverting only `loadAtomicBindings` to the PR's original implementation and
+rebuilding makes the journal regression fail 0/1 at the behavioral assertion
+`invalid journal identity must refuse before coordinator entry` (`true !== false`).
+Restoring the function makes it pass. No refusal expectation was weakened.
+
+## Lease fencing assessment (no pin or workaround change)
+
+[pm-cli 2026.10.23](https://github.com/unbraind/pm-cli/releases/tag/v2026.10.23)
+includes [GH-1549](https://github.com/unbraind/pm-cli/issues/1549), implemented in
+[PR 1550](https://github.com/unbraind/pm-cli/pull/1550). Native item mutations
+fence their commit against lease takeover and changed item bytes. The public
+`acquireLockLease` primitive also lets extensions fence their own commits.
+
+A real unguarded SDK probe with a one-second lease and a newer writer committing
+after expiry overwrote the newer title on 2026.10.20. The same probe on
+2026.10.23 refused the stale writer and preserved the newer title. This supports
+removing the callback-only `csv_lease_expired` mitigation for native mutation
+paths once the supported host floor is raised and SDK/CLI takeover regressions
+are migrated to the host's typed refusal. Extension-provided lock overrides
+still own their fencing contract; the upstream implementation cannot fence
+those providers automatically. The current peer floor and development pin still
+need the mitigation, so `lease-guard.ts` remains unchanged.

package/docs/table-schema.md

@@ -0,0 +1,123 @@
+# Versioned table schema negotiation
+
+A saved version 1 schema binds a UTF-8 table's delimiter, doubled-double-quote
+escaping, BOM presence, record separator, exact ordered headers, full-column
+value domains and proposed pm mappings. It also binds the target types and
+statuses resolved by the native pm SDK. A renamed, reordered, added or removed
+column cannot reuse that mapping. Describe the changed input into a **new**
+artifact and review the mapping before using it.
+
+```csv
+Summary;priority;body
+"Document; negotiation";2;"Quote ""safely"""
+```
+
+```bash
+pm csv schema describe backlog.csv --delimiter semicolon --auto-map --output backlog.schema.json --json
+pm csv schema preview backlog.csv --schema backlog.schema.json --json
+pm csv schema import backlog.csv --schema backlog.schema.json --dry-run --json
+pm csv schema import backlog.csv --schema backlog.schema.json --key title --json
+```
+
+`describe` proposes the existing import aliases only when `--auto-map` is
+explicit. Alternatively use `--map Summary=title,Rank=priority`. Input map keys
+follow the existing lowercase/trimmed header convention. The saved artifact
+preserves the original exact header spelling, whitespace and order. A field
+outside the supported CSV import surface has `field: null` and is excluded
+from import. Renaming an ignored column still requires review.
+
+Without `--output`, describe returns a compact count/revision receipt. With
+`--output`, it exclusively creates a private JSON artifact (mode 0600), never
+overwriting an existing file. Review its `columns[].field` proposals in that
+file; cell values and input paths are absent. The host renders receipts in
+TOON by default and JSON with global `--json`. Receipts stay constant in size
+as row counts grow: version, revision, row/column/mapped/ignored counts, plus
+save or import counts. No row previews are returned.
+
+## Typed SDK
+
+```ts
+import { readFileSync } from "node:fs";
+import {
+  describeTable, previewTable, importNegotiatedTable, TableSchemaRefusal,
+} from "pm-csv";
+import type { TableSchema, TableReceipt } from "pm-csv";
+
+const tracker = ".agents/pm";
+const text = readFileSync("backlog.csv", "utf8");
+const { schema } = await describeTable(tracker, text, {
+  delimiter: ";", fieldMap: { summary: "title" },
+});
+const saved: TableSchema = schema;
+const preview: TableReceipt = await previewTable(tracker, text, saved);
+try {
+  await importNegotiatedTable(tracker, text, saved, { keyField: "title" });
+} catch (error) {
+  if (error instanceof TableSchemaRefusal) {
+    console.error(error.code, error.remedy);
+  } else throw error;
+}
+```
+
+Use `parseTableSchema(unknown)` to validate an artifact before reuse. Unsupported
+versions, malformed shapes and changed revisions refuse. The SHA-256 revision
+hashes canonical JSON in the order `version,dialect,columns,target`, with
+dialect keys `delimiter,quote,bom,eol`, column keys `name,domain,field`, domain
+keys `kind,nullable` and target keys `types,statuses`. Top-level JSON key order
+does not matter. This checksum detects accidental edits; it is not an
+authentication signature. Only use reviewed artifacts from trusted sources.
+
+## Domains and refusals
+
+Domains inspect **all** cells, never a sample. After trimming, nonempty values
+are classified as integer, decimal, boolean (`true`/`false`, case insensitive),
+text or empty. `nullable` records whether empty cells were observed. Text allows
+arbitrary new strings; decimal permits an integer subset. New empty cells in a
+nonnullable column and other domain widening require a new schema. An all-empty
+column cannot silently become populated. Domains describe lexical input and
+do not promise preservation of whitespace or numerical formatting: negotiated
+import retains existing CSV coercion and trimming semantics.
+
+| Code | Remedy |
+|---|---|
+| `csv_table_invalid` | Correct quoting, row widths, mappings, title, priority, type or status. |
+| `csv_schema_invalid` | Restore a valid unchanged version 1 artifact or describe a new one. |
+| `csv_schema_changed` | Review dialect/header/order changes and explicitly adopt a new schema. |
+| `csv_domain_changed` | Review changed domains/nullability and describe again. |
+| `csv_target_changed` | Review changed target types/statuses and describe again. |
+| `csv_schema_io` | Supply readable UTF-8 inputs or a new writable output filename. |
+| `csv_table_import_failed` | Inspect reported counts and tracker policies before retrying. |
+
+All package refusals extend the SDK's `PmCliError`, expose `code` and `remedy`,
+and exit 2 with structured context/next steps. Normal SDK tracker-read errors
+retain their native SDK error contract. Schema refusal messages never echo raw
+cell values; mutation diagnostics retain the existing importer's behavior.
+
+## Boundaries
+
+The negotiated protocol accepts at most 8 MiB, 128 columns (distinct normalized
+headers of at most 128 characters) and 10000 data rows. It rejects malformed
+quotes, mixed LF/CRLF record separators, bare CR, blank records, ragged rows,
+unknown statuses and invalid priorities. Embedded line endings inside quoted
+cells are preserved by parsing/serialization and do not define record dialect.
+The shared import parser retains an explicit final `""` record even without a
+trailing newline. Quoted and unquoted empty records are validated and refused;
+a single terminating LF or CRLF does not invent an additional record.
+Delimiter aliases are comma, semicolon, tab and pipe. Quoting style may change
+between equivalent valid encodings; escaping rules remain fixed.
+
+Describe, preview and import dry-run do not mutate tracker documents, history
+or settings and need no git. Preview checks the table contract and pm field
+values; it does not plan dedup outcomes or execute per-item mutation hooks.
+Import negotiates the complete captured text before calling the existing CSV
+create/update core, so changing the source file afterward cannot change that
+operation's input. The SDK also captures caller-owned schemas and options before
+asynchronous tracker reads. Native history, locking, schema validation, key semantics and
+mutation policies remain authoritative. Negotiation is not a target-schema
+lock: a concurrent policy change can still refuse a row during import.
+
+Negotiated import retains legacy partial-write semantics on mutation failures;
+its refusal reports counts. It does not offer atomic resume or compensation.
+The separate `csv import --atomic` command remains available for that workflow.
+Core schema evolution changes tracker contracts; this protocol describes input
+tables. Spreadsheet edit sessions and cell lineage remain separate protocols.

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-csv",
-  "version": "2026.10.23",
+  "version": "2026.10.24",
   "description": "CSV importer and exporter for pm-cli",
   "author": "@unbraind",
   "entry": "./dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-csv",
-  "version": "2026.10.23",
+  "version": "2026.10.24",
   "description": "CSV importer and exporter for pm-cli",
   "repository": {
     "type": "git",
@@ -68,12 +68,12 @@
     "@babel/eslint-parser": "8.0.7",
     "@babel/plugin-syntax-typescript": "8.0.3",
     "@types/node": "26.6.5",
-    "@unbrained/pm-cli": "2026.10.15",
+    "@unbrained/pm-cli": "2026.10.20",
     "eslint": "10.13.0",
     "jiti": "2.7.0",
-    "jscpd": "5.4.1",
-    "pm-changelog": "2026.10.16",
-    "pm-ops": "2026.10.16",
+    "jscpd": "5.4.2",
+    "pm-changelog": "2026.10.20",
+    "pm-ops": "2026.10.20",
     "typescript": "7.0.2",
     "yaml": "2.9.1"
   },
@@ -118,10 +118,12 @@
       "docs/atomic-compensation.md",
       "docs/spreadsheet-roundtrip.md",
       "docs/row-lineage.md",
+      "docs/table-schema.md",
       "CHANGELOG.md"
     ],
     "examples": [
-      "README.md"
+      "README.md",
+      "docs/table-schema.md"
     ]
   },
   "publishConfig": {