@elnora-ai/linear 1.0.0 → 1.1.0

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,qBAAa,QAAS,SAAQ,KAAK;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAQjH;AAED,qBAAa,SAAU,SAAQ,QAAQ;gBAC1B,OAAO,CAAC,EAAE,MAAM;CAQ5B;AAeD,qBAAa,aAAc,SAAQ,QAAQ;gBAC9B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAQ9C;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAChC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIhF;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;gBAC5C,IAAI,EAAE;QACjB,KAAK,EAAE,gBAAgB,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACrE,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QAChE,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,cAAc,EAAE,MAAM,CAAC;KACvB;CAcD"}

package/dist/utils/errors.js

@@ -0,0 +1,94 @@
+// Error hierarchy for elnora-linear CLI.
+//
+// Every error class carries a userMessage + suggestion + structured exit code
+// so the CLI dispatcher can map them to predictable shell exit codes and emit
+// machine-readable JSON envelopes that agents can parse + self-correct from.
+/**
+ * Dedicated exit codes per error type.
+ * 0 = success, 1 = general/unknown, 2 = validation, 3 = auth, 4 = not found.
+ */
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    GENERAL: 1,
+    VALIDATION: 2,
+    AUTH: 3,
+    NOT_FOUND: 4,
+};
+export class CliError extends Error {
+    userMessage;
+    suggestion;
+    exitCode;
+    /**
+     * Optional structured payload merged into the JSON error envelope. Used by
+     * validation errors that need to expose machine-readable detail (e.g. which
+     * labels are missing, what the team's accepted set is) so an agent can
+     * self-correct without re-reading reference files.
+     */
+    data;
+    constructor(message, options) {
+        super(message);
+        this.name = "CliError";
+        this.userMessage = message;
+        this.suggestion = options?.suggestion;
+        this.exitCode = options?.exitCode ?? EXIT_CODES.GENERAL;
+        this.data = options?.data;
+    }
+}
+export class AuthError extends CliError {
+    constructor(message) {
+        super(message ?? "No Linear API key found. Set LINEAR_API_KEY in your environment.", {
+            suggestion: "Add LINEAR_API_KEY=lin_api_... to your environment, or place it in ~/.config/elnora-linear/.env (mode 0600).",
+            exitCode: EXIT_CODES.AUTH,
+        });
+        this.name = "AuthError";
+    }
+}
+/** Maps entity names to the correct CLI command for listing them. */
+const ENTITY_LIST_COMMANDS = {
+    team: "elnora-linear teams list",
+    project: "elnora-linear projects list",
+    user: "elnora-linear users list",
+    label: "elnora-linear labels list",
+    state: "elnora-linear states list --team <team>",
+    issue: "elnora-linear issues list",
+    initiative: "elnora-linear initiatives list",
+    milestone: "elnora-linear milestones list --project <project>",
+    "workflow state": "elnora-linear states list --team <team>",
+};
+export class NotFoundError extends CliError {
+    constructor(entity, identifier) {
+        const command = ENTITY_LIST_COMMANDS[entity.toLowerCase()] ?? `elnora-linear ${entity.toLowerCase()}s list`;
+        super(`${entity} not found: ${identifier}`, {
+            suggestion: `Check the identifier and try again. Use '${command}' to see available ${entity.toLowerCase()}s.`,
+            exitCode: EXIT_CODES.NOT_FOUND,
+        });
+        this.name = "NotFoundError";
+    }
+}
+export class ValidationError extends CliError {
+    constructor(message, suggestion, data) {
+        super(message, { suggestion, exitCode: EXIT_CODES.VALIDATION, data });
+        this.name = "ValidationError";
+    }
+}
+/**
+ * Specialized validation error for label-policy violations on `issues create`.
+ * The structured `data` field is the load-bearing part — agents read it to
+ * self-correct in one retry instead of re-reading workspace-labels.md.
+ */
+export class LabelValidationError extends ValidationError {
+    constructor(data) {
+        const summary = [];
+        for (const m of data.missing) {
+            summary.push(`missing ≥${m.min} from ${m.prefixes.join(" or ")}`);
+        }
+        for (const e of data.excess) {
+            summary.push(`too many ${e.prefixes.join(" or ")} (max ${e.max})`);
+        }
+        const message = `Label policy violation for team "${data.team}": ${summary.join("; ")}.`;
+        const suggestion = "Pass labels matching the prefixes shown in availableForPrefix, or run the suggestedRetry command verbatim.";
+        super(message, suggestion, { ...data });
+        this.name = "LabelValidationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./errors.js";
+export * from "./label-policy.js";
+export * from "./parse.js";
+export * from "./project-status.js";
+export * from "./rate-limit.js";
+export * from "./resolve.js";
+export * from "./sleep.js";
+export * from "./webhook-verify.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+export * from "./errors.js";
+export * from "./label-policy.js";
+export * from "./parse.js";
+export * from "./project-status.js";
+export * from "./rate-limit.js";
+export * from "./resolve.js";
+export * from "./sleep.js";
+export * from "./webhook-verify.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/utils/label-policy.d.ts

@@ -0,0 +1,53 @@
+export interface RequirementGroup {
+    prefixes: string[];
+    min: number;
+    max?: number | null;
+    description?: string;
+}
+export interface TeamLabelPolicy {
+    name: string;
+    required: RequirementGroup[];
+    allowedPrefixes: string[];
+    requiresProject?: boolean;
+}
+export interface LabelPolicyConfig {
+    $schema?: string;
+    _placeholder?: boolean;
+    _example?: boolean;
+    _populated_by?: string;
+    policies: Record<string, TeamLabelPolicy>;
+}
+export interface LoadLabelPolicyOptions {
+    referencesDir?: string;
+    /** Force reload (default false — module-level cache used for repeat calls in the same process). */
+    noCache?: boolean;
+}
+/** Load the label-policy config from references/label-policy.json. */
+export declare function loadLabelPolicies(opts?: LoadLabelPolicyOptions): LabelPolicyConfig;
+/** Reset the module-level cache (used in tests). */
+export declare function resetLabelPolicyCache(): void;
+export declare function getTeamLabelPolicy(teamKey: string, opts?: LoadLabelPolicyOptions): TeamLabelPolicy | null;
+/**
+ * Group labels by their first matching prefix. Labels not matching any known
+ * prefix go to "_unprefixed". Order of knownPrefixes matters: the first match
+ * wins, so put more specific prefixes earlier if any overlap.
+ */
+export declare function groupLabelsByPrefix(labelNames: string[], knownPrefixes: string[]): Record<string, string[]>;
+export interface LabelValidationFailure {
+    group: RequirementGroup;
+    count: number;
+    reason: "missing" | "excess";
+}
+export interface LabelValidationResult {
+    valid: boolean;
+    failures: LabelValidationFailure[];
+    passed: string[];
+    availableForPrefix: Record<string, string[]>;
+}
+/**
+ * Validate that the proposed labels satisfy the team's required prefix groups.
+ * Unknown teams pass through (no enforcement) so workspaces without a config
+ * entry don't break.
+ */
+export declare function validateLabelsAgainstTeam(teamKey: string, passedLabels: string[], teamLabelCatalog: string[], opts?: LoadLabelPolicyOptions): LabelValidationResult;
+//# sourceMappingURL=label-policy.d.ts.map

package/dist/utils/label-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-policy.d.ts","sourceRoot":"","sources":["../../src/utils/label-policy.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mGAAmG;IACnG,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAKD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,sBAA2B,GAAG,iBAAiB,CAOtF;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,eAAe,GAAG,IAAI,CAE7G;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAY3G;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EAAE,EACtB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,IAAI,GAAE,sBAA2B,GAC/B,qBAAqB,CAqCvB"}

package/dist/utils/label-policy.js

@@ -0,0 +1,93 @@
+// Team-specific label requirements.
+//
+// Source of truth for which labels each team requires on every issue. Read by
+// `projects get`, `teams get`, `context`, and the `issues create` validator.
+// Agents never read the underlying JSON directly — they consume policies
+// through the CLI responses, which is the point: keep the policy in one place
+// and let the CLI expose it instead of having every agent re-encode it.
+//
+// Loaded via the existing config layer (LinearConfig) so it honors the same
+// placeholder + sync + sanitization-gate machinery as the other references.
+import { loadConfig } from "../config/index.js";
+let cached = null;
+let cachedKey;
+/** Load the label-policy config from references/label-policy.json. */
+export function loadLabelPolicies(opts = {}) {
+    const key = opts.referencesDir ?? "(default)";
+    if (!opts.noCache && cached && cachedKey === key)
+        return cached;
+    const cfg = loadConfig({ referencesDir: opts.referencesDir, strict: false });
+    cached = cfg.labelPolicy;
+    cachedKey = key;
+    return cached;
+}
+/** Reset the module-level cache (used in tests). */
+export function resetLabelPolicyCache() {
+    cached = null;
+    cachedKey = undefined;
+}
+export function getTeamLabelPolicy(teamKey, opts = {}) {
+    return loadLabelPolicies(opts).policies[teamKey] ?? null;
+}
+/**
+ * Group labels by their first matching prefix. Labels not matching any known
+ * prefix go to "_unprefixed". Order of knownPrefixes matters: the first match
+ * wins, so put more specific prefixes earlier if any overlap.
+ */
+export function groupLabelsByPrefix(labelNames, knownPrefixes) {
+    const result = { _unprefixed: [] };
+    for (const prefix of knownPrefixes)
+        result[prefix] = [];
+    for (const name of labelNames) {
+        const prefix = knownPrefixes.find((p) => name.startsWith(p));
+        if (prefix) {
+            result[prefix].push(name);
+        }
+        else {
+            result._unprefixed.push(name);
+        }
+    }
+    return result;
+}
+/**
+ * Validate that the proposed labels satisfy the team's required prefix groups.
+ * Unknown teams pass through (no enforcement) so workspaces without a config
+ * entry don't break.
+ */
+export function validateLabelsAgainstTeam(teamKey, passedLabels, teamLabelCatalog, opts = {}) {
+    const policy = getTeamLabelPolicy(teamKey, opts);
+    if (!policy) {
+        return { valid: true, failures: [], passed: passedLabels, availableForPrefix: {} };
+    }
+    const passedByPrefix = groupLabelsByPrefix(passedLabels, policy.allowedPrefixes);
+    const catalogByPrefix = groupLabelsByPrefix(teamLabelCatalog, policy.allowedPrefixes);
+    const failures = [];
+    const failedPrefixes = new Set();
+    for (const group of policy.required) {
+        let count = 0;
+        for (const prefix of group.prefixes) {
+            count += (passedByPrefix[prefix] ?? []).length;
+        }
+        if (count < group.min) {
+            failures.push({ group, count, reason: "missing" });
+            for (const p of group.prefixes)
+                failedPrefixes.add(p);
+        }
+        else if (group.max != null && count > group.max) {
+            failures.push({ group, count, reason: "excess" });
+            for (const p of group.prefixes)
+                failedPrefixes.add(p);
+        }
+    }
+    const availableForPrefix = {};
+    for (const prefix of failedPrefixes) {
+        availableForPrefix[prefix] = catalogByPrefix[prefix] ?? [];
+    }
+    return {
+        valid: failures.length === 0,
+        failures,
+        passed: passedLabels,
+        availableForPrefix,
+    };
+}
+//# sourceMappingURL=label-policy.js.map

package/dist/utils/label-policy.js.map

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

package/dist/utils/parse.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Parse and validate a --limit option (or any positive-integer flag capped at
+ * Linear's 250-per-page API max). Returns the parsed number. Throws
+ * ValidationError for invalid values. Pass `flagName` to customize the label
+ * that appears in the error and warning text — defaults to "--limit".
+ */
+export declare function parseLimit(value: string | undefined, defaultValue?: number, flagName?: string): number;
+/**
+ * Parse a positive integer with no upper cap. Use for flags like --max where
+ * the value can legitimately exceed the API page limit (we just paginate).
+ * Returns `defaultValue` (default Infinity) when unset.
+ */
+export declare function parsePositiveInt(value: string | undefined, flagName: string, defaultValue?: number): number;
+/**
+ * Parse and validate a --priority option. Returns the parsed number. Throws
+ * ValidationError for invalid values (must be 0-4).
+ */
+export declare function parsePriority(value: string | undefined): number | undefined;
+/**
+ * Parse and validate a date option (YYYY-MM-DD). Returns the validated string
+ * or undefined if not provided.
+ */
+export declare function parseDate(value: string | undefined): string | undefined;
+/**
+ * Parse and validate a hex color option. Accepts formats: #RGB, #RRGGBB
+ * (with or without #).
+ */
+export declare function parseColor(value: string | undefined): string | undefined;
+export declare function parseHealth(value: string | undefined): string | undefined;
+export declare function parseProjectState(value: string | undefined): string | undefined;
+/**
+ * Parse and validate a --timeout value (seconds). Returns milliseconds for
+ * direct use with setTimeout. Accepts fractional values; rejects 0, negatives,
+ * NaN, and Infinity.
+ */
+export declare function parseTimeoutSeconds(value: string): number;
+/**
+ * Guard: throws if an update object has no fields set. Use in update commands
+ * to catch empty updates before sending to the API.
+ */
+export declare function requireNonEmptyUpdate(update: Record<string, unknown>): void;
+/**
+ * Guard: throws if `--yes` flag isn't set on a destructive command. Forces an
+ * explicit confirmation step that prompt-injected agents can't skip by talking
+ * themselves out of it.
+ */
+export declare function requireYes(opts: Record<string, unknown>, action: string): void;
+//# sourceMappingURL=parse.d.ts.map

package/dist/utils/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/utils/parse.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,SAAK,EAAE,QAAQ,SAAY,GAAG,MAAM,CAWrG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAE,MAAiB,GAAG,MAAM,CAOrH;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAcvE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOxE;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMzE;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK3E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO9E"}

package/dist/utils/parse.js

@@ -0,0 +1,133 @@
+// Input parsing and validation utilities.
+// Pure functions — no side effects, no API calls.
+import { ValidationError } from "./errors.js";
+/**
+ * Parse and validate a --limit option (or any positive-integer flag capped at
+ * Linear's 250-per-page API max). Returns the parsed number. Throws
+ * ValidationError for invalid values. Pass `flagName` to customize the label
+ * that appears in the error and warning text — defaults to "--limit".
+ */
+export function parseLimit(value, defaultValue = 50, flagName = "--limit") {
+    if (!value)
+        return defaultValue;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new ValidationError(`Invalid ${flagName} value: "${value}". Must be a positive integer.`);
+    }
+    if (n > 250) {
+        process.stderr.write(`Warning: ${flagName} ${n} capped to 250 (Linear API max).\n`);
+        return 250;
+    }
+    return n;
+}
+/**
+ * Parse a positive integer with no upper cap. Use for flags like --max where
+ * the value can legitimately exceed the API page limit (we just paginate).
+ * Returns `defaultValue` (default Infinity) when unset.
+ */
+export function parsePositiveInt(value, flagName, defaultValue = Infinity) {
+    if (!value)
+        return defaultValue;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new ValidationError(`Invalid ${flagName} value: "${value}". Must be a positive integer.`);
+    }
+    return n;
+}
+/**
+ * Parse and validate a --priority option. Returns the parsed number. Throws
+ * ValidationError for invalid values (must be 0-4).
+ */
+export function parsePriority(value) {
+    if (!value)
+        return undefined;
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) || n < 0 || n > 4) {
+        throw new ValidationError(`Invalid --priority value: "${value}". Must be 0 (None), 1 (Urgent), 2 (High), 3 (Normal), or 4 (Low).`);
+    }
+    return n;
+}
+/**
+ * Parse and validate a date option (YYYY-MM-DD). Returns the validated string
+ * or undefined if not provided.
+ */
+export function parseDate(value) {
+    if (!value)
+        return undefined;
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        throw new ValidationError(`Invalid date: "${value}". Must be in YYYY-MM-DD format.`);
+    }
+    const d = new Date(`${value}T00:00:00Z`);
+    if (Number.isNaN(d.getTime())) {
+        throw new ValidationError(`Invalid date: "${value}". Not a valid calendar date.`);
+    }
+    // Reject silent rollover (e.g., 2026-02-30 → 2026-03-02).
+    if (d.toISOString().slice(0, 10) !== value) {
+        throw new ValidationError(`Invalid date: "${value}". Not a real calendar date.`);
+    }
+    return value;
+}
+/**
+ * Parse and validate a hex color option. Accepts formats: #RGB, #RRGGBB
+ * (with or without #).
+ */
+export function parseColor(value) {
+    if (!value)
+        return undefined;
+    const hex = value.startsWith("#") ? value : `#${value}`;
+    if (!/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(hex)) {
+        throw new ValidationError(`Invalid color: "${value}". Must be a hex color (e.g., #FF0000 or #F00).`);
+    }
+    return hex;
+}
+const VALID_HEALTH_VALUES = ["onTrack", "atRisk", "offTrack"];
+export function parseHealth(value) {
+    if (!value)
+        return undefined;
+    if (!VALID_HEALTH_VALUES.includes(value)) {
+        throw new ValidationError(`Invalid --health value: "${value}". Must be one of: ${VALID_HEALTH_VALUES.join(", ")}.`);
+    }
+    return value;
+}
+const VALID_PROJECT_STATES = ["backlog", "planned", "started", "paused", "completed", "canceled"];
+export function parseProjectState(value) {
+    if (!value)
+        return undefined;
+    if (!VALID_PROJECT_STATES.includes(value)) {
+        throw new ValidationError(`Invalid --state value: "${value}". Must be one of: ${VALID_PROJECT_STATES.join(", ")}.`);
+    }
+    return value;
+}
+/**
+ * Parse and validate a --timeout value (seconds). Returns milliseconds for
+ * direct use with setTimeout. Accepts fractional values; rejects 0, negatives,
+ * NaN, and Infinity.
+ */
+export function parseTimeoutSeconds(value) {
+    const n = Number(value);
+    if (value === "" || !Number.isFinite(n) || n <= 0) {
+        throw new ValidationError(`Invalid --timeout value: "${value}". Must be a positive number of seconds.`);
+    }
+    return Math.round(n * 1000);
+}
+/**
+ * Guard: throws if an update object has no fields set. Use in update commands
+ * to catch empty updates before sending to the API.
+ */
+export function requireNonEmptyUpdate(update) {
+    const keys = Object.keys(update).filter((k) => update[k] !== undefined);
+    if (keys.length === 0) {
+        throw new ValidationError("No update options provided. Use --help to see available options.");
+    }
+}
+/**
+ * Guard: throws if `--yes` flag isn't set on a destructive command. Forces an
+ * explicit confirmation step that prompt-injected agents can't skip by talking
+ * themselves out of it.
+ */
+export function requireYes(opts, action) {
+    if (!opts.yes) {
+        throw new ValidationError(`Refusing to ${action} without --yes. This operation is irreversible.`, "Re-run with --yes to confirm.");
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/utils/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/utils/parse.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,kDAAkD;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB,EAAE,YAAY,GAAG,EAAE,EAAE,QAAQ,GAAG,SAAS;IAC5F,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CAAC,WAAW,QAAQ,YAAY,KAAK,gCAAgC,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACpF,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB,EAAE,QAAgB,EAAE,eAAuB,QAAQ;IAC5G,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CAAC,WAAW,QAAQ,YAAY,KAAK,gCAAgC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,eAAe,CACxB,8BAA8B,KAAK,oEAAoE,CACvG,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CAAC,kBAAkB,KAAK,kCAAkC,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,eAAe,CAAC,kBAAkB,KAAK,+BAA+B,CAAC,CAAC;IACnF,CAAC;IACD,0DAA0D;IAC1D,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CAAC,kBAAkB,KAAK,8BAA8B,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;IACxD,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,eAAe,CAAC,mBAAmB,KAAK,iDAAiD,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAEvE,MAAM,UAAU,WAAW,CAAC,KAAyB;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAE,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,eAAe,CAAC,4BAA4B,KAAK,sBAAsB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAE3G,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAE,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,eAAe,CAAC,2BAA2B,KAAK,sBAAsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,eAAe,CAAC,6BAA6B,KAAK,0CAA0C,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA+B;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CAAC,kEAAkE,CAAC,CAAC;IAC/F,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAA6B,EAAE,MAAc;IACvE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CACxB,eAAe,MAAM,iDAAiD,EACtE,+BAA+B,CAC/B,CAAC;IACH,CAAC;AACF,CAAC"}

package/dist/utils/project-status.d.ts

@@ -0,0 +1,6 @@
+export interface RecommendedState {
+    state: string | null;
+    warning?: string;
+}
+export declare function recommendedStateForStatus(type: string | null | undefined): RecommendedState;
+//# sourceMappingURL=project-status.d.ts.map

package/dist/utils/project-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-status.d.ts","sourceRoot":"","sources":["../../src/utils/project-status.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CAyB3F"}

package/dist/utils/project-status.js

@@ -0,0 +1,33 @@
+// Mapping from Linear's project status `type` to a sensible default issue
+// state for new issues filed in that project. Used by `projects get` and
+// `context` so agents don't have to encode this mapping themselves.
+//
+// Conservative: paused/completed/canceled return null with a warning so the
+// agent flags it instead of silently dropping the issue into a closed project.
+export function recommendedStateForStatus(type) {
+    switch (type) {
+        case "backlog":
+            return { state: "Backlog" };
+        case "planned":
+        case "started":
+            return { state: "Todo" };
+        case "paused":
+            return {
+                state: null,
+                warning: "project is paused; confirm with the project lead before filing",
+            };
+        case "completed":
+            return {
+                state: null,
+                warning: "project is completed; pick a different project for new work",
+            };
+        case "canceled":
+            return {
+                state: null,
+                warning: "project is canceled; pick a different project for new work",
+            };
+        default:
+            return { state: null };
+    }
+}
+//# sourceMappingURL=project-status.js.map

package/dist/utils/project-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-status.js","sourceRoot":"","sources":["../../src/utils/project-status.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAO/E,MAAM,UAAU,yBAAyB,CAAC,IAA+B;IACxE,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,SAAS;YACb,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACb,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACZ,OAAO;gBACN,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,gEAAgE;aACzE,CAAC;QACH,KAAK,WAAW;YACf,OAAO;gBACN,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,6DAA6D;aACtE,CAAC;QACH,KAAK,UAAU;YACd,OAAO;gBACN,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,4DAA4D;aACrE,CAAC;QACH;YACC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;AACF,CAAC"}

package/dist/utils/rate-limit.d.ts

@@ -0,0 +1,24 @@
+declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Pull the retry delay (ms) out of a Linear SDK error.
+ *
+ * RatelimitedLinearError exposes `retryAfter` (seconds) directly — the SDK
+ * already parsed the retry-after header into a number. Earlier code tried to
+ * read `error.response.headers["retry-after"]`, but `headers` is a Fetch
+ * Headers object whose values are only readable via `.get()` — bracket access
+ * always returned undefined, so the wrapper silently fell back to the 60s
+ * default on every retry instead of honouring Linear's hint.
+ */
+declare function parseRetryAfter(error: unknown): number;
+/**
+ * Run fn, retry on 429 with Retry-After. Max 3 retries — after that the
+ * original error propagates.
+ */
+export declare function withRateLimit<T>(fn: () => Promise<T>): Promise<T>;
+export declare const _internal: {
+    isRateLimitError: typeof isRateLimitError;
+    parseRetryAfter: typeof parseRetryAfter;
+    MAX_RETRY_AFTER_MS: number;
+};
+export {};
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/utils/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limit.ts"],"names":[],"mappings":"AAmBA,iBAAS,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAejD;AAED;;;;;;;;;GASG;AACH,iBAAS,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C;AA2BD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBvE;AAGD,eAAO,MAAM,SAAS;;;;CAA4D,CAAC"}