@cyanheads/secedgar-mcp-server 0.13.0 → 0.14.0

package/dist/services/edgar/eight-k-items.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Form 8-K item-code decode tables for both numbering regimes.
+ * SEC replaced the original single-integer item numbering with the current
+ * `x.xx` scheme in Release 33-8400, effective 2004-08-23, so EDGAR carries two
+ * disjoint vocabularies in the same `items` field. Decoding is driven by the
+ * code's SHAPE, not the filing date: a dotted code is always current-regime, a
+ * bare integer is always legacy. That makes a mis-decode impossible for filings
+ * straddling the changeover, where filers reported pre-changeover events under
+ * the old numbers for months after the effective date.
+ * @module services/edgar/eight-k-items
+ */
+/** Which Form 8-K item-numbering regime a code belongs to. */
+export type EightKItemRegime = 'current' | 'legacy';
+/**
+ * Effective date of SEC Release 33-8400, which introduced the current `x.xx`
+ * item numbering. Reported as context on legacy-coded filings; never used to
+ * pick a decode table (see the module header).
+ */
+export declare const EIGHT_K_RENUMBERING_DATE = "2004-08-23";
+/** Current-regime section headings, keyed by the code's leading digit. */
+export declare const EIGHT_K_SECTIONS: Record<string, string>;
+/**
+ * Current Form 8-K items (filings numbered under the post-2004-08-23 scheme),
+ * transcribed from the item headings of SEC's Form 8-K.
+ */
+export declare const CURRENT_EIGHT_K_ITEMS: Record<string, string>;
+/**
+ * Legacy Form 8-K items — the single-integer numbering used before
+ * 2004-08-23. Items 10-12 were added in 2002-2003 and retired along with the
+ * rest at the changeover; item 12 (results of operations) is the direct
+ * ancestor of today's 2.02, and item 9 of today's 7.01.
+ */
+export declare const LEGACY_EIGHT_K_ITEMS: Record<string, string>;
+/**
+ * Every filterable item code across both regimes. Backs the `items` input enum,
+ * so a caller reads the whole vocabulary off the JSON Schema and an unknown code
+ * is rejected before any fetch. Declared current-first, but the schema serves the
+ * bare integers first regardless: Zod keys its enum by value, and a JS object
+ * orders integer-like keys ahead of the rest. The `items` describe text carries
+ * which shape belongs to which regime, since the order cannot.
+ */
+export declare const EIGHT_K_ITEM_CODES: [string, ...string[]];
+/** One decoded item code. `label` is absent for a code neither table defines. */
+export interface DecodedEightKItem {
+    code: string;
+    label?: string | undefined;
+    regime?: EightKItemRegime | undefined;
+}
+/**
+ * Decode one item code by shape — dotted (`2.02`) is current-regime, a bare
+ * integer (`12`) is legacy. A code matching neither shape, or matching a shape
+ * but absent from that regime's table, comes back with the code alone so the
+ * caller sees exactly what EDGAR reported instead of a guessed label.
+ */
+export declare function decodeEightKItem(code: string): DecodedEightKItem;
+/**
+ * Split the submissions API's `items` field (a comma-separated code list, e.g.
+ * `"2.02,9.01"`) into codes. An absent or empty field yields no codes — most
+ * 8-K filings carry items, but EDGAR leaves the field blank on some older ones.
+ */
+export declare function parseEightKItems(raw: string | undefined): string[];
+//# sourceMappingURL=eight-k-items.d.ts.map

package/dist/services/edgar/eight-k-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eight-k-items.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/eight-k-items.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwCxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAavD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAG1B,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAE3B,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAUhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMlE"}

package/dist/services/edgar/eight-k-items.js

@@ -0,0 +1,131 @@
+/**
+ * @fileoverview Form 8-K item-code decode tables for both numbering regimes.
+ * SEC replaced the original single-integer item numbering with the current
+ * `x.xx` scheme in Release 33-8400, effective 2004-08-23, so EDGAR carries two
+ * disjoint vocabularies in the same `items` field. Decoding is driven by the
+ * code's SHAPE, not the filing date: a dotted code is always current-regime, a
+ * bare integer is always legacy. That makes a mis-decode impossible for filings
+ * straddling the changeover, where filers reported pre-changeover events under
+ * the old numbers for months after the effective date.
+ * @module services/edgar/eight-k-items
+ */
+/**
+ * Effective date of SEC Release 33-8400, which introduced the current `x.xx`
+ * item numbering. Reported as context on legacy-coded filings; never used to
+ * pick a decode table (see the module header).
+ */
+export const EIGHT_K_RENUMBERING_DATE = '2004-08-23';
+/** Current-regime section headings, keyed by the code's leading digit. */
+export const EIGHT_K_SECTIONS = {
+    '1': "Registrant's Business and Operations",
+    '2': 'Financial Information',
+    '3': 'Securities and Trading Markets',
+    '4': 'Matters Related to Accountants and Financial Statements',
+    '5': 'Corporate Governance and Management',
+    '6': 'Asset-Backed Securities',
+    '7': 'Regulation FD',
+    '8': 'Other Events',
+    '9': 'Financial Statements and Exhibits',
+};
+/**
+ * Current Form 8-K items (filings numbered under the post-2004-08-23 scheme),
+ * transcribed from the item headings of SEC's Form 8-K.
+ */
+export const CURRENT_EIGHT_K_ITEMS = {
+    '1.01': 'Entry into a Material Definitive Agreement',
+    '1.02': 'Termination of a Material Definitive Agreement',
+    '1.03': 'Bankruptcy or Receivership',
+    '1.04': 'Mine Safety — Reporting of Shutdowns and Patterns of Violations',
+    '1.05': 'Material Cybersecurity Incidents',
+    '2.01': 'Completion of Acquisition or Disposition of Assets',
+    '2.02': 'Results of Operations and Financial Condition',
+    '2.03': 'Creation of a Direct Financial Obligation or an Obligation under an Off-Balance Sheet Arrangement of a Registrant',
+    '2.04': 'Triggering Events That Accelerate or Increase a Direct Financial Obligation or an Obligation under an Off-Balance Sheet Arrangement',
+    '2.05': 'Costs Associated with Exit or Disposal Activities',
+    '2.06': 'Material Impairments',
+    '3.01': 'Notice of Delisting or Failure to Satisfy a Continued Listing Rule or Standard; Transfer of Listing',
+    '3.02': 'Unregistered Sales of Equity Securities',
+    '3.03': 'Material Modification to Rights of Security Holders',
+    '4.01': "Changes in Registrant's Certifying Accountant",
+    '4.02': 'Non-Reliance on Previously Issued Financial Statements or a Related Audit Report or Completed Interim Review',
+    '5.01': 'Changes in Control of Registrant',
+    '5.02': 'Departure of Directors or Certain Officers; Election of Directors; Appointment of Certain Officers; Compensatory Arrangements of Certain Officers',
+    '5.03': 'Amendments to Articles of Incorporation or Bylaws; Change in Fiscal Year',
+    '5.04': "Temporary Suspension of Trading Under Registrant's Employee Benefit Plans",
+    '5.05': "Amendments to the Registrant's Code of Ethics, or Waiver of a Provision of the Code of Ethics",
+    '5.06': 'Change in Shell Company Status',
+    '5.07': 'Submission of Matters to a Vote of Security Holders',
+    '5.08': 'Shareholder Director Nominations',
+    '6.01': 'ABS Informational and Computational Material',
+    '6.02': 'Change of Servicer or Trustee',
+    '6.03': 'Change in Credit Enhancement or Other External Support',
+    '6.04': 'Failure to Make a Required Distribution',
+    '6.05': 'Securities Act Updating Disclosure',
+    '6.06': 'Static Pool',
+    '7.01': 'Regulation FD Disclosure',
+    '8.01': 'Other Events',
+    '9.01': 'Financial Statements and Exhibits',
+};
+/**
+ * Legacy Form 8-K items — the single-integer numbering used before
+ * 2004-08-23. Items 10-12 were added in 2002-2003 and retired along with the
+ * rest at the changeover; item 12 (results of operations) is the direct
+ * ancestor of today's 2.02, and item 9 of today's 7.01.
+ */
+export const LEGACY_EIGHT_K_ITEMS = {
+    '1': 'Changes in Control of Registrant',
+    '2': 'Acquisition or Disposition of Assets',
+    '3': 'Bankruptcy or Receivership',
+    '4': "Changes in Registrant's Certifying Accountant",
+    '5': 'Other Events',
+    '6': "Resignations of Registrant's Directors",
+    '7': 'Financial Statements, Pro Forma Financial Information and Exhibits',
+    '8': 'Change in Fiscal Year',
+    '9': 'Regulation FD Disclosure',
+    '10': "Amendments to the Registrant's Code of Ethics, or Waiver of a Provision of the Code of Ethics",
+    '11': "Temporary Suspension of Trading Under Registrant's Employee Benefit Plans",
+    '12': 'Results of Operations and Financial Condition',
+};
+/**
+ * Every filterable item code across both regimes. Backs the `items` input enum,
+ * so a caller reads the whole vocabulary off the JSON Schema and an unknown code
+ * is rejected before any fetch. Declared current-first, but the schema serves the
+ * bare integers first regardless: Zod keys its enum by value, and a JS object
+ * orders integer-like keys ahead of the rest. The `items` describe text carries
+ * which shape belongs to which regime, since the order cannot.
+ */
+export const EIGHT_K_ITEM_CODES = [
+    ...Object.keys(CURRENT_EIGHT_K_ITEMS),
+    ...Object.keys(LEGACY_EIGHT_K_ITEMS),
+];
+/**
+ * Decode one item code by shape — dotted (`2.02`) is current-regime, a bare
+ * integer (`12`) is legacy. A code matching neither shape, or matching a shape
+ * but absent from that regime's table, comes back with the code alone so the
+ * caller sees exactly what EDGAR reported instead of a guessed label.
+ */
+export function decodeEightKItem(code) {
+    if (/^\d\.\d{2}$/.test(code)) {
+        const label = CURRENT_EIGHT_K_ITEMS[code];
+        return label ? { code, label, regime: 'current' } : { code, regime: 'current' };
+    }
+    if (/^\d{1,2}$/.test(code)) {
+        const label = LEGACY_EIGHT_K_ITEMS[code];
+        return label ? { code, label, regime: 'legacy' } : { code, regime: 'legacy' };
+    }
+    return { code };
+}
+/**
+ * Split the submissions API's `items` field (a comma-separated code list, e.g.
+ * `"2.02,9.01"`) into codes. An absent or empty field yields no codes — most
+ * 8-K filings carry items, but EDGAR leaves the field blank on some older ones.
+ */
+export function parseEightKItems(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(',')
+        .map((code) => code.trim())
+        .filter((code) => code.length > 0);
+}
+//# sourceMappingURL=eight-k-items.js.map

package/dist/services/edgar/eight-k-items.js.map

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

package/dist/services/edgar/fiscal-periods.d.ts

@@ -19,7 +19,7 @@
  */
 export declare function fiscalQ4Caveats(period: string): string[];
 /**
- * Caveat for one filer's frame-tagged quarterly series: name the calendar
+ * Caveat for one filer's frame-tagged quarterly series: name every calendar
  * quarter that never appears, so a caller can tell "the company did not report"
  * apart from "the frame tagging does not expose it".
  *
@@ -28,10 +28,15 @@ export declare function fiscalQ4Caveats(period: string): string[];
  * inside it a year counts only when it reports at least
  * {@link MIN_QUARTERS_PER_YEAR} of the four calendar quarters (partial first/last
  * years carry no signal), and a caveat is emitted only when at least
- * {@link MIN_YEARS} of the counting years all omit the same single quarter. A
- * year inside the window that reports all four quarters, two that disagree about
- * which quarter is missing, or a window too sparse to reach the quorum all
- * suppress the caveat.
+ * {@link MIN_YEARS} of the counting years agree on a non-empty set of absent
+ * quarters. A year inside the window that reports all four quarters, years that
+ * disagree so no quarter is absent from all of them, or a window too sparse to
+ * reach the quorum all suppress the caveat.
+ *
+ * One or two quarters can be absent — the per-year quorum bounds it there. A
+ * single absent quarter is the fiscal-Q4 residual; a second one means the
+ * filer's fiscal quarters do not line up with calendar quarters at all, so
+ * further durations match no `CY####Q#` frame.
  */
 export declare function missingQuarterCaveats(frames: Iterable<string>): string[];
 //# sourceMappingURL=fiscal-periods.d.ts.map

package/dist/services/edgar/fiscal-periods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fiscal-periods.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/fiscal-periods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqCH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CA8BxE"}
+{"version":3,"file":"fiscal-periods.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/fiscal-periods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8CH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CA2CxE"}

package/dist/services/edgar/fiscal-periods.js

@@ -23,8 +23,17 @@ const FISCAL_Q4_EXAMPLES = {
 };
 /** Duration quarterly frame (`CY2024Q2`). Instant frames (`CY2024Q2I`) are excluded. */
 const DURATION_QUARTER_FRAME = /^CY(\d{4})Q([1-4])$/;
-/** A year needs at least this many reported quarters before its gaps carry signal. */
-const MIN_QUARTERS_PER_YEAR = 3;
+/**
+ * A year needs at least this many reported quarters before its gaps carry
+ * signal. Two, not three: a filer can lose more than one calendar quarter to
+ * frame tagging — Costco's fiscal Q2 and fiscal Q4 durations both fall outside
+ * the quarters SEC frames, leaving a steady two per year — and a three-of-four
+ * quorum reads that as a sparse year and suppresses the caveat entirely. Two is
+ * also the floor at which a year still carries signal: it bounds the absent set
+ * at two quarters, so a year reporting a single quarter (a stub, a first year of
+ * filings) cannot drag three quarters into the caveat.
+ */
+const MIN_QUARTERS_PER_YEAR = 2;
 /** At least this many qualifying years must agree before a gap is called systematic. */
 const MIN_YEARS = 2;
 /**
@@ -57,7 +66,7 @@ export function fiscalQ4Caveats(period) {
     ];
 }
 /**
- * Caveat for one filer's frame-tagged quarterly series: name the calendar
+ * Caveat for one filer's frame-tagged quarterly series: name every calendar
  * quarter that never appears, so a caller can tell "the company did not report"
  * apart from "the frame tagging does not expose it".
  *
@@ -66,10 +75,15 @@ export function fiscalQ4Caveats(period) {
  * inside it a year counts only when it reports at least
  * {@link MIN_QUARTERS_PER_YEAR} of the four calendar quarters (partial first/last
  * years carry no signal), and a caveat is emitted only when at least
- * {@link MIN_YEARS} of the counting years all omit the same single quarter. A
- * year inside the window that reports all four quarters, two that disagree about
- * which quarter is missing, or a window too sparse to reach the quorum all
- * suppress the caveat.
+ * {@link MIN_YEARS} of the counting years agree on a non-empty set of absent
+ * quarters. A year inside the window that reports all four quarters, years that
+ * disagree so no quarter is absent from all of them, or a window too sparse to
+ * reach the quorum all suppress the caveat.
+ *
+ * One or two quarters can be absent — the per-year quorum bounds it there. A
+ * single absent quarter is the fiscal-Q4 residual; a second one means the
+ * filer's fiscal quarters do not line up with calendar quarters at all, so
+ * further durations match no `CY####Q#` frame.
  */
 export function missingQuarterCaveats(frames) {
     const quartersByYear = new Map();
@@ -96,11 +110,20 @@ export function missingQuarterCaveats(frames) {
         for (const quarter of quarters)
             absent.delete(quarter);
     }
-    const [missing] = absent;
-    if (absent.size !== 1 || !missing)
+    if (absent.size === 0)
         return [];
+    const missing = [...absent].sort();
+    const subject = missing.length === 1
+        ? `Calendar Q${missing[0]} carries`
+        : `Calendar ${missing.map((q) => `Q${q}`).join(' and ')} carry`;
+    const cause = missing.length === 1
+        ? 'SEC XBRL reports fiscal Q4 as the 10-K residual rather than a discrete quarterly fact, so the calendar quarter that fiscal Q4 spans drops out of the quarterly series — the period was reported, the frame tagging does not expose it.'
+        : "SEC XBRL reports fiscal Q4 as the 10-K residual rather than a discrete quarterly fact, and this filer's remaining fiscal quarters span durations that no standard calendar quarter matches, so both drop out of the quarterly series — the periods were reported, the frame tagging does not expose them.";
+    const recovery = missing.length === 1
+        ? "Use period_type='annual' for the full-year figure, or derive the missing quarter as the annual total minus the three reported quarters."
+        : "Use period_type='annual' for the full-year figure; the absent quarters can only be derived together, as the annual total minus the reported quarters, never one at a time.";
     return [
-        `Calendar Q${missing} carries no frame-tagged value in any of this filer's recent fully-reported years. SEC XBRL reports fiscal Q4 as the 10-K residual rather than a discrete quarterly fact, so the calendar quarter that fiscal Q4 spans drops out of the quarterly series — the period was reported, the frame tagging does not expose it. Use period_type='annual' for the full-year figure, or derive the missing quarter as the annual total minus the three reported quarters.`,
+        `${subject} no frame-tagged value in any of this filer's recent qualifying years. ${cause} ${recovery}`,
     ];
 }
 //# sourceMappingURL=fiscal-periods.js.map

package/dist/services/edgar/fiscal-periods.js.map

@@ -1 +1 @@
-{"version":3,"file":"fiscal-periods.js","sourceRoot":"","sources":["../../../src/services/edgar/fiscal-periods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,kBAAkB,GAA2B;IACjD,GAAG,EAAE,6CAA6C;IAClD,GAAG,EAAE,yCAAyC;IAC9C,GAAG,EAAE,sCAAsC;IAC3C,GAAG,EAAE,6DAA6D;CACnE,CAAC;AAEF,wFAAwF;AACxF,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAErD,sFAAsF;AACtF,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC,wFAAwF;AACxF,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAoC,CAAC;IACtD,OAAO;QACL,0CAA0C,CAAC,mIAAmI,kBAAkB,CAAC,CAAC,CAAC,4EAA4E;KAChR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,SAAS;QACvC,IAAI,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;YACrB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;SAChD,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,qBAAqB,CAAC;SAChE,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,aAAa,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,EAAE,CAAC;IAEhD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;IACzB,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE7C,OAAO;QACL,aAAa,OAAO,mcAAmc;KACxd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"fiscal-periods.js","sourceRoot":"","sources":["../../../src/services/edgar/fiscal-periods.ts"],"names":[],"mappings":"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"}

package/dist/services/edgar/types.d.ts

@@ -247,9 +247,48 @@ export interface RelatedTag {
     /** XBRL tag a meaningful share of filers report this metric under instead. */
     tag: string;
 }
+/**
+ * How a concept's tag array is walked when a filer reports more than one of its
+ * tags.
+ *
+ * `priority` — the declared order is semantic: index 0 is the preferred
+ * definition and wins every frame it reports, lower tags only filling frames it
+ * does not cover. Correct whenever the tags mean different things and one of
+ * them is the answer to the concept (revenue's gross/net variants, the
+ * trade-only vs trade-and-other receivable captions).
+ *
+ * `coverage` — the tags are interchangeable alternates that filers choose
+ * between rather than a ladder, so the one this filer actually maintains wins:
+ * whichever covers the most standard calendar periods, with the declared order
+ * breaking a tie. The losers then drop out rather than filling the winner's
+ * gaps: alternates are not interchangeable value by value, and the filers
+ * reporting both disagree on the years they overlap. Only correct when no fixed
+ * order can be right, because filers split in both directions (#101).
+ *
+ * `priority` stays the default and coverage is opt-in per concept, because
+ * coverage is wrong as a general rule and SEC's own data says so. Molson Coors
+ * (TAP) tags eleven calendar years under `SalesRevenueGoodsNet`, which SEC
+ * retired in 2018, and ten under the assessed-tax-inclusive element against five
+ * under `Revenues` — so ranking `revenue` by coverage hands that filer either an
+ * eight-year-dead tag or its gross-of-excise line, replacing the continuous net
+ * series (CY2016-CY2019 at 6,597 / 13,472 / 13,338 / 13,009 million) with values
+ * roughly a fifth lower. Smucker (SJM) and Spotify (SPOT) survive it only on a
+ * coincidental tie in period count. Coverage answers "which element does this
+ * filer maintain", which is the question only when the elements mean the same
+ * thing; where they mean different things, the array order is the answer and
+ * period count is noise.
+ */
+export type TagSelection = 'coverage' | 'priority';
 /** Friendly concept name mapping. */
 export interface ConceptMapping {
     group: ConceptGroup;
+    /**
+     * How to pick among `ifrsTags` for a filer reporting several of them. Defaults
+     * to `priority`. Scoped to the IFRS array on purpose — the us-gaap `tags` of
+     * the same concept can be a genuine priority ladder even when its IFRS
+     * counterparts are alternates.
+     */
+    ifrsTagSelection?: TagSelection;
     /**
      * IFRS tag variants for this concept (used when taxonomy === 'ifrs-full').
      * When present, these replace `tags` for IFRS lookups so friendly names resolve

package/dist/services/edgar/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/secedgar-mcp-server",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Query SEC EDGAR filings, XBRL financials, and company data through MCP. STDIO & Streamable HTTP.",
   "mcpName": "io.github.cyanheads/secedgar-mcp-server",
   "type": "module",

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/cyanheads/secedgar-mcp-server",
     "source": "github"
   },
-  "version": "0.13.0",
+  "version": "0.14.0",
   "remotes": [
     {
       "type": "streamable-http",
@@ -19,7 +19,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/secedgar-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.13.0",
+      "version": "0.14.0",
       "environmentVariables": [
         {
           "name": "EDGAR_USER_AGENT",
@@ -44,7 +44,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/secedgar-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.13.0",
+      "version": "0.14.0",
       "environmentVariables": [
         {
           "name": "EDGAR_USER_AGENT",