light-plan 0.0.0-stage → 0.1.0

package/dist/remote/providers/jsonfile/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The jsonfile provider adapter — one folder, exposing the four-member
+ * `Provider` shape the registry holds.
+ *
+ * Adding a provider is exactly this folder plus one line in
+ * `src/remote/registry.ts`. Nothing in core or the planners names jsonfile.
+ */
+import type { Capabilities } from '../../capabilities.js';
+import type { Provider, RemoteRecord } from '../../provider.js';
+/** The remote id a jsonfile record is keyed by: its per-file issue number. */
+export declare function jsonfileRemoteIdOf(record: RemoteRecord): string;
+/** The remote issue numbers a record waits on — its native `depends_on` edges. */
+export declare function jsonfileDependsOnOf(record: RemoteRecord): string[];
+/**
+ * The remote id of a record's parent, from the managed block (the file is a
+ * flat tracker — hierarchyDepth 0 — so the parent rides rung 4, never a native
+ * field).
+ */
+export declare function jsonfileParentIdOf(record: RemoteRecord): string | undefined;
+/**
+ * The jsonfile capability table. Every cell is a static fact — a JSON file has
+ * no plan tiers or rollouts to probe. This is the first provider whose `type`
+ * and `status` are both *native* fields (rung 1), and the only one whose
+ * `delete` hard-removes the issue.
+ */
+export declare const jsonfileCapabilities: Capabilities;
+/**
+ * Where a jsonfile remote's tracker lives when nobody says otherwise:
+ * `.lpm/remotes/<name>/tracker.json`, beside that remote's own link store and
+ * caches. The path is relative to the board root — the connector resolves it
+ * from there, so a sync run from a subdirectory finds the same file.
+ *
+ * This is the one provider whose connection names something *light-plan* owns
+ * rather than somebody else's system, so it is the one provider that can pick
+ * for itself. `--file` still overrides it.
+ */
+export declare function jsonfileDefaultConnection(remoteName: string): Record<string, unknown>;
+export declare const jsonfileProvider: Provider;

package/dist/remote/providers/jsonfile/index.js

@@ -0,0 +1,90 @@
+/**
+ * The jsonfile provider adapter — one folder, exposing the four-member
+ * `Provider` shape the registry holds.
+ *
+ * Adding a provider is exactly this folder plus one line in
+ * `src/remote/registry.ts`. Nothing in core or the planners names jsonfile.
+ */
+import { parentRemoteIdFromBlock } from '../../hierarchy.js';
+import { jsonfileConfigSchema } from './config.js';
+import { jsonfileConnector } from './connector.js';
+import { jsonfileTranslator } from './translator.js';
+/** The remote id a jsonfile record is keyed by: its per-file issue number. */
+export function jsonfileRemoteIdOf(record) {
+    const number = record.number;
+    if (typeof number === 'number')
+        return String(number);
+    if (typeof number === 'string' && number !== '')
+        return number;
+    return '';
+}
+/** The remote issue numbers a record waits on — its native `depends_on` edges. */
+export function jsonfileDependsOnOf(record) {
+    const deps = record.depends_on;
+    if (!Array.isArray(deps))
+        return [];
+    return deps
+        .map((entry) => (typeof entry === 'number' ? String(entry) : typeof entry === 'string' ? entry : ''))
+        .filter((entry) => entry !== '');
+}
+/**
+ * The remote id of a record's parent, from the managed block (the file is a
+ * flat tracker — hierarchyDepth 0 — so the parent rides rung 4, never a native
+ * field).
+ */
+export function jsonfileParentIdOf(record) {
+    const body = record.body;
+    if (typeof body === 'string')
+        return parentRemoteIdFromBlock(body);
+    return undefined;
+}
+/**
+ * The jsonfile capability table. Every cell is a static fact — a JSON file has
+ * no plan tiers or rollouts to probe. This is the first provider whose `type`
+ * and `status` are both *native* fields (rung 1), and the only one whose
+ * `delete` hard-removes the issue.
+ */
+export const jsonfileCapabilities = {
+    // Flat: no native parent field. Deeper nesting rides the managed block.
+    hierarchyDepth: 0,
+    // The `type` field is native.
+    nativeTypes: true,
+    // A named `status` field, exactly as Linear's workflow-state name is native.
+    status: { kind: 'states' },
+    // `depends_on` is a native edge list; no native `relates_to`.
+    edges: { dependsOn: true, relatesTo: false },
+    // No typed custom-field registry — attributes ride labels (rung 3).
+    customFields: null,
+    // Nothing is creatable through an API — the file is the whole API.
+    provisioning: { customFields: false, periods: false, labels: false },
+    // No native period container.
+    periods: { native: false, creatable: false },
+    // Comments carry ids, can be edited and deleted.
+    comments: { native: true, editable: true, deletable: true },
+    // `updated_at` filtering over a full read.
+    incrementalRead: { kind: 'since' },
+    // The file is ours: its type and status strings are whatever we write, so
+    // a scaffold names them after the board and leaves nothing to fill in.
+    vocabulary: 'open',
+};
+/**
+ * Where a jsonfile remote's tracker lives when nobody says otherwise:
+ * `.lpm/remotes/<name>/tracker.json`, beside that remote's own link store and
+ * caches. The path is relative to the board root — the connector resolves it
+ * from there, so a sync run from a subdirectory finds the same file.
+ *
+ * This is the one provider whose connection names something *light-plan* owns
+ * rather than somebody else's system, so it is the one provider that can pick
+ * for itself. `--file` still overrides it.
+ */
+export function jsonfileDefaultConnection(remoteName) {
+    return { file: `.lpm/remotes/${remoteName}/tracker.json` };
+}
+export const jsonfileProvider = {
+    config: jsonfileConfigSchema,
+    capabilities: jsonfileCapabilities,
+    translator: jsonfileTranslator,
+    connector: jsonfileConnector,
+    defaultConnection: jsonfileDefaultConnection,
+};
+//# sourceMappingURL=index.js.map

package/dist/remote/providers/jsonfile/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/remote/providers/jsonfile/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACpG,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD,wEAAwE;IACxE,cAAc,EAAE,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,IAAI;IACjB,6EAA6E;IAC7E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,8DAA8D;IAC9D,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5C,oEAAoE;IACpE,YAAY,EAAE,IAAI;IAClB,mEAAmE;IACnE,YAAY,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IACpE,8BAA8B;IAC9B,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5C,iDAAiD;IACjD,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAC3D,2CAA2C;IAC3C,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;IAClC,0EAA0E;IAC1E,uEAAuE;IACvE,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,OAAO,EAAE,IAAI,EAAE,gBAAgB,UAAU,eAAe,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,MAAM,EAAE,oBAAoB;IAC5B,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,iBAAiB,EAAE,yBAAyB;CAC7C,CAAC"}

package/dist/remote/providers/jsonfile/store.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The JSON-file tracker's storage — a single JSON document holding a flat list
+ * of issues, exactly what a "tracker" backed by a local file looks like.
+ *
+ * This is the *only* I/O surface the connector and the conformance test double
+ * share. It is deliberately tiny and deliberately boring: a file is the whole
+ * tracker, there is no schema to migrate beyond `version`, and a write is a
+ * whole-file rewrite (a demo tracker does not need a journal).
+ */
+/** One user comment, as the file holds it. */
+export interface JsonComment {
+    id: number;
+    body: string;
+    author: string;
+    created_at: string;
+}
+/**
+ * One issue, in the file's flat shape. Everything the board distinguishes has
+ * a *native* home here — `type` and `status` are real fields, `depends_on` a
+ * real edge list — which is the point of the provider: it exercises the
+ * degradation ladder's rung 1, which no shipped platform does.
+ */
+export interface JsonIssue {
+    /** The remote id, a per-file monotonic number. */
+    number: number;
+    title: string;
+    body: string;
+    /** Native status name, e.g. `Done` — the mapping's `statuses.*.remote`. */
+    status: string;
+    /** Native type name, e.g. `story` — the mapping's `types.*.type`. */
+    type: string;
+    /** Human and attribute labels; the sync reconciles its claimed ones only. */
+    labels: string[];
+    /** Native assignee account, or null when unassigned. */
+    assignee: string | null;
+    /** Native dependency edges — the remote issue numbers this one waits on. */
+    depends_on: number[];
+    comments: JsonComment[];
+    created_at: string;
+    updated_at: string;
+}
+/** The whole store: a version, the issues, and the next issue number. */
+export interface JsonStore {
+    version: 1;
+    issues: JsonIssue[];
+    next_number: number;
+}
+/** The store before anything has been filed. */
+export declare function emptyJsonStore(): JsonStore;
+/**
+ * Read the store. A missing file is a valid empty store — the first sync
+ * creates it. A file that cannot be parsed is thrown, not repaired: a corrupt
+ * tracker should fail loudly, the same rule the link store applies.
+ */
+export declare function readJsonStore(file: string): JsonStore;
+/** Write the store, creating the containing directory when it does not exist. */
+export declare function writeJsonStore(file: string, store: JsonStore): void;
+/** The next comment id, derived rather than stored so the file stays minimal. */
+export declare function nextCommentId(store: JsonStore): number;

package/dist/remote/providers/jsonfile/store.js

@@ -0,0 +1,48 @@
+/**
+ * The JSON-file tracker's storage — a single JSON document holding a flat list
+ * of issues, exactly what a "tracker" backed by a local file looks like.
+ *
+ * This is the *only* I/O surface the connector and the conformance test double
+ * share. It is deliberately tiny and deliberately boring: a file is the whole
+ * tracker, there is no schema to migrate beyond `version`, and a write is a
+ * whole-file rewrite (a demo tracker does not need a journal).
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+/** The store before anything has been filed. */
+export function emptyJsonStore() {
+    return { version: 1, issues: [], next_number: 1 };
+}
+/**
+ * Read the store. A missing file is a valid empty store — the first sync
+ * creates it. A file that cannot be parsed is thrown, not repaired: a corrupt
+ * tracker should fail loudly, the same rule the link store applies.
+ */
+export function readJsonStore(file) {
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return emptyJsonStore();
+        throw error;
+    }
+    return JSON.parse(raw);
+}
+/** Write the store, creating the containing directory when it does not exist. */
+export function writeJsonStore(file, store) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify(store, null, 2)}\n`, 'utf8');
+}
+/** The next comment id, derived rather than stored so the file stays minimal. */
+export function nextCommentId(store) {
+    let max = 0;
+    for (const issue of store.issues) {
+        for (const comment of issue.comments)
+            if (comment.id > max)
+                max = comment.id;
+    }
+    return max + 1;
+}
+//# sourceMappingURL=store.js.map

package/dist/remote/providers/jsonfile/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../src/remote/providers/jsonfile/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,IAAI,MAAM,WAAW,CAAC;AA2C7B,gDAAgD;AAChD,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,cAAc,EAAE,CAAC;QAChF,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;AACtC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAgB;IAC3D,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ;YAAE,IAAI,OAAO,CAAC,EAAE,GAAG,GAAG;gBAAE,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,CAAC;AACjB,CAAC"}

package/dist/remote/providers/jsonfile/translator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The jsonfile provider's two-way vocabulary translation.
+ *
+ * The JSON-file tracker is the *minimum* a tracker can be, and it holds its
+ * vocabulary natively rather than on labels:
+ *
+ *   - **type** is the native `type` field (rung 1), with an optional human
+ *     label kept beside it (rung 3) so the sync's label claim still has an
+ *     exact label to reconcile and a person reading the file sees the type;
+ *   - **status** is the native `status` field (rung 1) — the mapping's
+ *     `statuses.*.remote` value is the field value, exactly as Linear's
+ *     workflow-state name is;
+ *   - **attributes** ride label prefixes (rung 3), as GitHub's do — the file
+ *     has no typed custom-field registry;
+ *   - **`depends_on`** is the native `depends_on` array (rung 1), handled by
+ *     the connector's `link` / `unlink` rather than here.
+ *
+ * Assignees and periods are deliberately not mapped in this slice: the file
+ * holds an arbitrary `assignee` string and no period container, so both ride
+ * the ladder (and the managed block for a degraded period level).
+ *
+ * Pure: no I/O. One translator serves every jsonfile remote; the mapping and
+ * the board's attribute definitions are passed per call.
+ */
+import { type LabelClaim } from '../../labels.js';
+import type { AttributeDefs, BoardOp, DescribeResult, FieldsFromRecordResult, RemoteRecord, Translator } from '../../provider.js';
+import type { JsonfileMapping } from './config.js';
+/**
+ * The labels a mapping claims (LP-308): the exact type labels and status
+ * states, and the attribute prefixes. Derived from the mapping, never a
+ * convention.
+ */
+export declare function labelClaimFromJsonfileMapping(mapping: JsonfileMapping): LabelClaim;
+/**
+ * Push: a board op becomes a jsonfile request description.
+ *
+ * A create/update carries `title`, `body`, the native `type`, the native
+ * status name in `state`, and the labels derived from the mapping (the type
+ * labels plus one `<prefix>:<value>` label per mapped attribute). An attribute
+ * value that will not coerce is omitted and reported in `problems`. A delete
+ * carries only its kind — the connector removes the issue from the file.
+ */
+export declare function describeRequest(op: BoardOp, mapping: Record<string, unknown>, attributes: AttributeDefs, _roster?: Map<any, any>, _periods?: Map<any, any>): DescribeResult;
+/**
+ * Pull: a jsonfile issue record becomes board fields.
+ *
+ * `title` and `body` pass through (the managed block stripped, as everywhere);
+ * `type` is recovered when exactly one board type's native `remote` or labels
+ * match; `status` from the native `status` field; `attributes` from
+ * `<prefix>:<value>` labels. Ambiguity leaves the field absent — the pull
+ * planner breaks ties with the board's hierarchy.
+ */
+export declare function fieldsFromRecord(record: RemoteRecord, mapping: Record<string, unknown>, attributes: AttributeDefs, _roster?: Map<any, any>, _periods?: Map<any, any>): FieldsFromRecordResult;
+export declare const jsonfileTranslator: Translator;

package/dist/remote/providers/jsonfile/translator.js

@@ -0,0 +1,199 @@
+/**
+ * The jsonfile provider's two-way vocabulary translation.
+ *
+ * The JSON-file tracker is the *minimum* a tracker can be, and it holds its
+ * vocabulary natively rather than on labels:
+ *
+ *   - **type** is the native `type` field (rung 1), with an optional human
+ *     label kept beside it (rung 3) so the sync's label claim still has an
+ *     exact label to reconcile and a person reading the file sees the type;
+ *   - **status** is the native `status` field (rung 1) — the mapping's
+ *     `statuses.*.remote` value is the field value, exactly as Linear's
+ *     workflow-state name is;
+ *   - **attributes** ride label prefixes (rung 3), as GitHub's do — the file
+ *     has no typed custom-field registry;
+ *   - **`depends_on`** is the native `depends_on` array (rung 1), handled by
+ *     the connector's `link` / `unlink` rather than here.
+ *
+ * Assignees and periods are deliberately not mapped in this slice: the file
+ * holds an arbitrary `assignee` string and no period container, so both ride
+ * the ladder (and the managed block for a degraded period level).
+ *
+ * Pure: no I/O. One translator serves every jsonfile remote; the mapping and
+ * the board's attribute definitions are passed per call.
+ */
+import { coerceFromRemote, coerceToRemote, } from '../../attributes.js';
+import { labelClaim } from '../../labels.js';
+import { parseManagedBlock } from '../../managed-block.js';
+import { boardTypesMatching, mapStatusFromRemote, mapStatusToRemote, mapTypeToRemote, } from '../../mapping.js';
+/** An issue's labels as plain strings, whatever the record's spelling. */
+function labelsOf(record) {
+    const labels = record.labels;
+    if (!Array.isArray(labels))
+        return [];
+    return labels
+        .map((label) => {
+        if (typeof label === 'string')
+            return label;
+        if (label && typeof label === 'object') {
+            const name = label.name;
+            if (typeof name === 'string')
+                return name;
+        }
+        return '';
+    })
+        .filter((label) => label.length > 0);
+}
+/** The remote field a board attribute of this type lands on: labels only. */
+function fieldFor(type) {
+    return type === 'array' ? { kind: 'labels' } : { kind: 'text' };
+}
+/** Skip a value that carries nothing to write. */
+function isEmptyValue(value) {
+    return value === undefined || value === null || value === '';
+}
+/**
+ * The labels a mapping claims (LP-308): the exact type labels and status
+ * states, and the attribute prefixes. Derived from the mapping, never a
+ * convention.
+ */
+export function labelClaimFromJsonfileMapping(mapping) {
+    const exact = [];
+    const prefixes = [];
+    // The type rides the native `type` field, not a label, so the claim covers
+    // only the statuses and the attribute prefixes.
+    for (const entry of Object.values(mapping.statuses ?? {})) {
+        exact.push(...entry.remote);
+    }
+    for (const prefix of Object.values(mapping.attributes ?? {})) {
+        if (prefix.length > 0)
+            prefixes.push(`${prefix}:`);
+    }
+    return labelClaim(exact, prefixes);
+}
+/**
+ * Push: a board op becomes a jsonfile request description.
+ *
+ * A create/update carries `title`, `body`, the native `type`, the native
+ * status name in `state`, and the labels derived from the mapping (the type
+ * labels plus one `<prefix>:<value>` label per mapped attribute). An attribute
+ * value that will not coerce is omitted and reported in `problems`. A delete
+ * carries only its kind — the connector removes the issue from the file.
+ */
+export function describeRequest(op, mapping, attributes, _roster = new Map(), _periods = new Map()) {
+    if (op.kind === 'delete') {
+        return { request: { kind: 'delete' }, problems: [], resourceGaps: [], periodGaps: [] };
+    }
+    const m = mapping;
+    const labels = [];
+    const problems = [];
+    let state;
+    // The file has a native `type` field, so the mapped value is written there
+    // and nowhere else — writing it as a label too would be the same fact twice.
+    const type = mapTypeToRemote(m.types ?? {}, op.fields.type);
+    const remoteStatus = mapStatusToRemote(m.statuses ?? {}, op.fields.status);
+    if (remoteStatus !== undefined)
+        state = remoteStatus;
+    for (const [attribute, prefix] of Object.entries(m.attributes ?? {})) {
+        const value = op.fields.attributes?.[attribute];
+        if (isEmptyValue(value))
+            continue;
+        const attributeType = attributes[attribute]?.type ?? 'string';
+        const field = fieldFor(attributeType);
+        const result = coerceToRemote(attributeType, value, field);
+        if (!result.ok) {
+            problems.push({ attribute, direction: 'push', reason: result.reason, options: result.options });
+            continue;
+        }
+        if (field.kind === 'labels') {
+            for (const item of result.value)
+                labels.push(`${prefix}:${item}`);
+        }
+        else {
+            labels.push(`${prefix}:${String(result.value)}`);
+        }
+    }
+    return {
+        request: {
+            kind: op.kind,
+            title: op.fields.title,
+            body: op.fields.body,
+            type,
+            labels,
+            labelClaim: labelClaimFromJsonfileMapping(m),
+            state,
+        },
+        problems,
+        resourceGaps: [],
+        periodGaps: [],
+    };
+}
+/**
+ * Pull: a jsonfile issue record becomes board fields.
+ *
+ * `title` and `body` pass through (the managed block stripped, as everywhere);
+ * `type` is recovered when exactly one board type's native `remote` or labels
+ * match; `status` from the native `status` field; `attributes` from
+ * `<prefix>:<value>` labels. Ambiguity leaves the field absent — the pull
+ * planner breaks ties with the board's hierarchy.
+ */
+export function fieldsFromRecord(record, mapping, attributes, _roster = new Map(), _periods = new Map()) {
+    const m = mapping;
+    const labels = labelsOf(record);
+    const patch = {};
+    const problems = [];
+    const result = { patch, problems, unknownAccounts: [] };
+    if (typeof record.title === 'string')
+        patch.title = record.title;
+    // The managed block is the sync layer's own output, never the document's
+    // prose — stripped on the way back (LP-309, LP-314).
+    if (typeof record.body === 'string') {
+        const parsed = parseManagedBlock(record.body);
+        patch.body = parsed.found ? parsed.body : record.body;
+    }
+    // Type: every board type whose mapped values match the native `type` field.
+    const remoteType = typeof record.type === 'string' ? record.type : undefined;
+    const typeCandidates = boardTypesMatching(m.types ?? {}, { remoteType, labels });
+    if (typeCandidates.length === 1)
+        patch.type = typeCandidates[0];
+    // Status: the native status name resolved through the mapping.
+    if (typeof record.status === 'string' && record.status !== '') {
+        const resolution = mapStatusFromRemote(m.statuses ?? {}, [record.status]);
+        if (resolution.status !== undefined)
+            patch.status = resolution.status;
+    }
+    // Attributes: `<prefix>:<value>` labels, coerced back by prefix and type.
+    const recovered = {};
+    for (const [attribute, prefix] of Object.entries(m.attributes ?? {})) {
+        const attributeType = attributes[attribute]?.type ?? 'string';
+        const field = fieldFor(attributeType);
+        if (field.kind === 'labels') {
+            const items = labels
+                .filter((label) => label.startsWith(`${prefix}:`))
+                .map((label) => label.slice(prefix.length + 1))
+                .filter((item) => item.length > 0);
+            if (items.length > 0)
+                recovered[attribute] = items;
+            continue;
+        }
+        const marker = labels.find((label) => label.startsWith(`${prefix}:`));
+        if (marker === undefined)
+            continue;
+        const raw = marker.slice(prefix.length + 1);
+        const coerced = coerceFromRemote(attributeType, raw, { values: attributes[attribute]?.values });
+        if (coerced.ok) {
+            recovered[attribute] = coerced.value;
+        }
+        else {
+            problems.push({ attribute, direction: 'pull', reason: coerced.reason, options: coerced.options });
+        }
+    }
+    if (Object.keys(recovered).length > 0)
+        patch.attributes = recovered;
+    return result;
+}
+export const jsonfileTranslator = {
+    describeRequest,
+    fieldsFromRecord,
+};
+//# sourceMappingURL=translator.js.map

package/dist/remote/providers/jsonfile/translator.js.map

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

package/dist/remote/providers/linear/config.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The Linear provider's own slice of a remote declaration.
+ *
+ * Core validates the frame — that a remote has a `provider`, a scope, a
+ * direction and two policies. This schema validates the contents of the
+ * `connection` and `mapping` blocks for Linear specifically, and is called
+ * when the remote is opened (LP-259), exactly as `storage/views.ts` owns the
+ * contents of a view file.
+ *
+ * Linear has native workflow states, native relations, native cycles and a
+ * native assignee — but **no issue types** and **no custom fields** (LP-267).
+ * So the mapping is a split: types ride labels (rung 3, exactly as GitHub),
+ * statuses name Linear workflow states, and every board attribute beyond the
+ * fixed fields rides labels or the managed block (rung 3/4). The fixed fields
+ * themselves — `estimate` (the effort attribute) and `priority` (0–4) — are
+ * LP-333's work; `effort` below names the effort attribute, and `priority`
+ * remains fixed to Linear's 0–4 scale (note 4 of the capability matrix).
+ *
+ *   - `types`      board type → `{ labels: [...] }` (Linear has no native type)
+ *   - `statuses`   board status id → the Linear workflow state name(s) plus
+ *                  which one a push writes and whether it is terminal
+ *   - `effort`     `{ attribute: <name> }` — which board attribute maps to
+ *                  Linear's native `estimate` (LP-333). The value is checked
+ *                  against the team's estimation scale at preflight, never
+ *                  silently rounded.
+ *   - `attributes` board attribute name → the label prefix carrying its value
+ *   - `accounts`   `{ via: <attribute> }` — which resource attribute carries
+ *                  the Linear account (an email, a Linear user id or a name)
+ *   - `periods`    which period level maps to a Linear cycle — the carrier is
+ *                  fixed to `sprint`, the cycle's counterpart (LP-334)
+ *
+ * Everything in Linear is team-scoped, so the connection block names the team:
+ * `team` is the team key (or id), and every query carries it.
+ */
+import { z } from 'zod';
+export declare const linearConfigSchema: z.ZodObject<{
+    connection: z.ZodObject<{
+        team: z.ZodString;
+        api_key: z.ZodOptional<z.ZodString>;
+        base_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    mapping: z.ZodObject<{
+        types: z.ZodPipe<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+            remote: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+            type: z.ZodOptional<z.ZodString>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>>>, z.ZodTransform<import("../../mapping.js").TypeMappings, Record<string, string | string[] | {
+            remote?: string | string[] | undefined;
+            type?: string | undefined;
+            labels?: string[] | undefined;
+        }>>>;
+        statuses: z.ZodPipe<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+            remote: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+            push: z.ZodOptional<z.ZodString>;
+            closed: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>>, z.ZodTransform<import("../../mapping.js").StatusMappings, Record<string, string | string[] | {
+            remote: string | string[];
+            push?: string | undefined;
+            closed?: boolean | undefined;
+        }>>>;
+        effort: z.ZodOptional<z.ZodObject<{
+            attribute: z.ZodString;
+        }, z.core.$strip>>;
+        attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        accounts: z.ZodOptional<z.ZodObject<{
+            via: z.ZodString;
+        }, z.core.$strip>>;
+        periods: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+            container: z.ZodString;
+        }, z.core.$strip>, z.ZodTransform<{
+            container: string;
+            carrier: "sprint";
+        }, {
+            container: string;
+        }>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** The validated shape of a Linear remote declaration. */
+export type LinearConfig = z.infer<typeof linearConfigSchema>;
+/** The `mapping` block, after validation. */
+export type LinearMapping = LinearConfig['mapping'];
+/** The `connection` block, after validation. */
+export type LinearConnection = LinearConfig['connection'];