@mrtdown/core 2.0.0-alpha.1

package/dist/schema/issue/serviceScope.d.ts

@@ -0,0 +1,38 @@
+import z from 'zod';
+/**
+ * Service Whole (service)
+ */
+export declare const ServiceScopeWholeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"service.whole">;
+}, z.z.core.$strip>;
+export type ServiceScopeWhole = z.infer<typeof ServiceScopeWholeSchema>;
+/**
+ * Service segment (service-level)
+ *
+ * This should also be used when representing an entire service.
+ */
+export declare const ServiceScopeSegmentSchema: z.ZodObject<{
+    type: z.ZodLiteral<"service.segment">;
+    fromStationId: z.ZodString;
+    toStationId: z.ZodString;
+}, z.z.core.$strip>;
+export type ServiceScopeSegment = z.infer<typeof ServiceScopeSegmentSchema>;
+/**
+ * Service point (station-level)
+ */
+export declare const ServiceScopePointSchema: z.ZodObject<{
+    type: z.ZodLiteral<"service.point">;
+    stationId: z.ZodString;
+}, z.z.core.$strip>;
+export type ServiceScopePoint = z.infer<typeof ServiceScopePointSchema>;
+export declare const ServiceScopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"service.whole">;
+}, z.z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"service.segment">;
+    fromStationId: z.ZodString;
+    toStationId: z.ZodString;
+}, z.z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"service.point">;
+    stationId: z.ZodString;
+}, z.z.core.$strip>]>;
+export type ServiceScope = z.infer<typeof ServiceScopeSchema>;

package/dist/schema/issue/serviceScope.js

@@ -0,0 +1,30 @@
+import z from 'zod';
+/**
+ * Service Whole (service)
+ */
+export const ServiceScopeWholeSchema = z.object({
+    type: z.literal('service.whole'),
+});
+/**
+ * Service segment (service-level)
+ *
+ * This should also be used when representing an entire service.
+ */
+export const ServiceScopeSegmentSchema = z.object({
+    type: z.literal('service.segment'),
+    fromStationId: z.string(),
+    toStationId: z.string(),
+});
+/**
+ * Service point (station-level)
+ */
+export const ServiceScopePointSchema = z.object({
+    type: z.literal('service.point'),
+    stationId: z.string(),
+});
+export const ServiceScopeSchema = z.discriminatedUnion('type', [
+    ServiceScopeWholeSchema,
+    ServiceScopeSegmentSchema,
+    ServiceScopePointSchema,
+]);
+//# sourceMappingURL=serviceScope.js.map

package/dist/schema/issue/serviceScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceScope.js","sourceRoot":"/","sources":["schema/issue/serviceScope.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;CACjC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC7D,uBAAuB;IACvB,yBAAyB;IACzB,uBAAuB;CACxB,CAAC,CAAC","sourcesContent":["import z from 'zod';\n\n/**\n * Service Whole (service)\n */\nexport const ServiceScopeWholeSchema = z.object({\n  type: z.literal('service.whole'),\n});\nexport type ServiceScopeWhole = z.infer<typeof ServiceScopeWholeSchema>;\n\n/**\n * Service segment (service-level)\n *\n * This should also be used when representing an entire service.\n */\nexport const ServiceScopeSegmentSchema = z.object({\n  type: z.literal('service.segment'),\n  fromStationId: z.string(),\n  toStationId: z.string(),\n});\nexport type ServiceScopeSegment = z.infer<typeof ServiceScopeSegmentSchema>;\n\n/**\n * Service point (station-level)\n */\nexport const ServiceScopePointSchema = z.object({\n  type: z.literal('service.point'),\n  stationId: z.string(),\n});\nexport type ServiceScopePoint = z.infer<typeof ServiceScopePointSchema>;\n\nexport const ServiceScopeSchema = z.discriminatedUnion('type', [\n  ServiceScopeWholeSchema,\n  ServiceScopeSegmentSchema,\n  ServiceScopePointSchema,\n]);\nexport type ServiceScope = z.infer<typeof ServiceScopeSchema>;\n"]}

package/dist/util/assert.d.ts

@@ -0,0 +1 @@
+export declare function assert(condition: boolean, message?: string): asserts condition;

package/dist/util/assert.js

@@ -0,0 +1,6 @@
+export function assert(condition, message = 'Assertion failed') {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/util/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"/","sources":["util/assert.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CACpB,SAAkB,EAClB,OAAO,GAAG,kBAAkB;IAE5B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC","sourcesContent":["export function assert(\n  condition: boolean,\n  message = 'Assertion failed',\n): asserts condition {\n  if (!condition) {\n    throw new Error(message);\n  }\n}\n"]}

package/dist/util/ingestContent/helpers/getSlugDateTimeFromClaims.d.ts

@@ -0,0 +1,7 @@
+import type { Claim } from '#schema/issue/claim.js';
+/**
+ * Get the slug date time from the claims.
+ * @param claims - The claims.
+ * @returns The slug date time or null if no time hints are found.
+ */
+export declare function getSlugDateTimeFromClaims(claims: Claim[]): string | null;

package/dist/util/ingestContent/helpers/getSlugDateTimeFromClaims.js

@@ -0,0 +1,24 @@
+import { assert } from '#util/assert.js';
+/**
+ * Get the slug date time from the claims.
+ * @param claims - The claims.
+ * @returns The slug date time or null if no time hints are found.
+ */
+export function getSlugDateTimeFromClaims(claims) {
+    const timeHints = claims
+        .filter((claim) => claim.timeHints != null)
+        .map((claim) => claim.timeHints);
+    if (timeHints.length > 0) {
+        assert(timeHints[0] != null, 'Expected time hints');
+        switch (timeHints[0].kind) {
+            case 'fixed': {
+                return timeHints[0].startAt;
+            }
+            case 'recurring': {
+                return timeHints[0].startAt;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=getSlugDateTimeFromClaims.js.map

package/dist/util/ingestContent/helpers/getSlugDateTimeFromClaims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSlugDateTimeFromClaims.js","sourceRoot":"/","sources":["util/ingestContent/helpers/getSlugDateTimeFromClaims.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAe;IACvD,MAAM,SAAS,GAAG,MAAM;SACrB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;SAC1C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,qBAAqB,CAAC,CAAC;QACpD,QAAQ,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1B,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9B,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { Claim } from '#schema/issue/claim.js';\nimport { assert } from '#util/assert.js';\n\n/**\n * Get the slug date time from the claims.\n * @param claims - The claims.\n * @returns The slug date time or null if no time hints are found.\n */\nexport function getSlugDateTimeFromClaims(claims: Claim[]): string | null {\n  const timeHints = claims\n    .filter((claim) => claim.timeHints != null)\n    .map((claim) => claim.timeHints);\n\n  if (timeHints.length > 0) {\n    assert(timeHints[0] != null, 'Expected time hints');\n    switch (timeHints[0].kind) {\n      case 'fixed': {\n        return timeHints[0].startAt;\n      }\n      case 'recurring': {\n        return timeHints[0].startAt;\n      }\n    }\n  }\n\n  return null;\n}\n"]}

package/dist/util/ingestContent/index.d.ts

@@ -0,0 +1,12 @@
+import type { IngestContent } from './types.js';
+/**
+ * Ingests content from social media, news, or other sources into the MRTDown issue system.
+ *
+ * Triages the content to determine if it belongs to an existing issue or a new one, extracts
+ * claims, computes impact (affected lines, stations, periods), and persists evidence and impact
+ * events. Irrelevant content is ignored.
+ *
+ * @param content - The content to ingest (Reddit post, news article, or Twitter/Mastodon post).
+ * @returns `null` when content is irrelevant or after successful ingestion.
+ */
+export declare function ingestContent(content: IngestContent): Promise<null>;

package/dist/util/ingestContent/index.js

@@ -0,0 +1,171 @@
+import { resolve } from 'node:path';
+import { DateTime } from 'luxon';
+import { ulid } from 'ulid';
+import { computeImpactFromEvidenceClaims } from '#helpers/computeImpactFromEvidenceClaims.js';
+import { extractClaimsFromNewEvidence } from '#llm/functions/extractClaimsFromNewEvidence/index.js';
+import { generateIssueTitleAndSlug } from '#llm/functions/generateIssueTitleAndSlug/index.js';
+import { translate } from '#llm/functions/translate/index.js';
+import { triageNewEvidence } from '#llm/functions/triageNewEvidence/index.js';
+import { FileStore } from '#repo/common/FileStore.js';
+import { MRTDownRepository } from '#repo/MRTDownRepository.js';
+import { FileWriteStore } from '#write/common/FileWriteStore.js';
+import { MRTDownWriter } from '#write/MRTDownWriter.js';
+import { assert } from '../assert.js';
+import { getSlugDateTimeFromClaims } from './helpers/getSlugDateTimeFromClaims.js';
+const DATA_DIR = resolve(import.meta.dirname, '../../../data');
+const store = new FileStore(DATA_DIR);
+const writeStore = new FileWriteStore(DATA_DIR);
+const repo = new MRTDownRepository({ store });
+const writer = new MRTDownWriter({ store: writeStore });
+/**
+ * Ingests content from social media, news, or other sources into the MRTDown issue system.
+ *
+ * Triages the content to determine if it belongs to an existing issue or a new one, extracts
+ * claims, computes impact (affected lines, stations, periods), and persists evidence and impact
+ * events. Irrelevant content is ignored.
+ *
+ * @param content - The content to ingest (Reddit post, news article, or Twitter/Mastodon post).
+ * @returns `null` when content is irrelevant or after successful ingestion.
+ */
+export async function ingestContent(content) {
+    // --- Normalise input ---
+    // HACK: Force `createdAt` to be Asia/Singapore timezone
+    const createdAt = DateTime.fromISO(content.createdAt)
+        .setZone('Asia/Singapore')
+        .toISO();
+    assert(createdAt != null, 'Expected valid createdAt');
+    content.createdAt = createdAt;
+    console.log('[ingestContent]', content);
+    // --- Triage: existing issue, new issue, or irrelevant ---
+    const triageResult = await triageNewEvidence({
+        newEvidence: {
+            ts: content.createdAt,
+            text: getText(content),
+        },
+        repo,
+    });
+    console.log('[ingestContent.triageNewEvidence]', triageResult);
+    if (triageResult.result.kind === 'irrelevant-content') {
+        console.log('[ingestContent] Nothing to do.');
+        return null;
+    }
+    // --- Extract structured claims (lines, stations, periods, effects) ---
+    const { claims } = await extractClaimsFromNewEvidence({
+        newEvidence: {
+            ts: content.createdAt,
+            text: getText(content),
+        },
+        repo,
+    });
+    console.log('[ingestContent.extractClaimsFromNewEvidence]', claims);
+    // --- Resolve issue bundle: fetch existing or create new ---
+    let issueBundle;
+    switch (triageResult.result.kind) {
+        case 'part-of-existing-issue': {
+            // Load full bundle (issue + evidence + impact) for impact computation
+            const { issueId } = triageResult.result;
+            const existingBundle = repo.issues.get(issueId);
+            assert(existingBundle != null, `Expected issue for id=${issueId}`);
+            issueBundle = existingBundle;
+            break;
+        }
+        case 'part-of-new-issue': {
+            // Create issue: derive date from claims, generate title/slug, translate, persist
+            const slugDateTime = DateTime.fromISO(getSlugDateTimeFromClaims(claims) ?? content.createdAt);
+            assert(slugDateTime.isValid, `Invalid date: ${content.createdAt}`);
+            const { title, slug } = await generateIssueTitleAndSlug({
+                text: getText(content),
+            });
+            console.log('[ingestContent.generateSlug]', slug);
+            const translatedTitles = await translate(title);
+            const issueId = `${slugDateTime.toFormat('yyyy-MM-dd')}-${slug}`;
+            const issue = {
+                id: issueId,
+                type: triageResult.result.issueType,
+                title: translatedTitles,
+                titleMeta: {
+                    source: '@openai/gpt-5-nano',
+                },
+            };
+            writer.issues.create(issue);
+            issueBundle = {
+                issue,
+                evidence: [],
+                impactEvents: [],
+                path: DATA_DIR,
+            };
+            break;
+        }
+    }
+    // --- Build evidence record ---
+    const contentDateTime = DateTime.fromISO(content.createdAt);
+    assert(contentDateTime.isValid, `Invalid date: ${content.createdAt}`);
+    const evidence = {
+        id: `ev_${ulid(contentDateTime.toMillis())}`,
+        ts: contentDateTime.toISO({ includeOffset: true }),
+        type: getEvidenceType(content),
+        text: getText(content),
+        sourceUrl: content.url,
+        render: {
+            text: await translate(getText(content)),
+            source: '@openai/gpt-5-nano',
+        },
+    };
+    // --- Compute impact events from claims (effects, scopes, periods) ---
+    const { newImpactEvents } = computeImpactFromEvidenceClaims({
+        issueBundle: {
+            ...issueBundle,
+            evidence: [...issueBundle.evidence, evidence],
+        },
+        evidenceId: evidence.id,
+        evidenceTs: evidence.ts,
+        claims,
+    });
+    // --- Persist to disk ---
+    writer.issues.appendEvidence(issueBundle.issue.id, evidence);
+    for (const impact of newImpactEvents) {
+        writer.issues.appendImpact(issueBundle.issue.id, impact);
+    }
+    return null;
+}
+/**
+ * Extracts the primary text content from an IngestContent item based on its source type.
+ *
+ * @param content - The content to extract text from.
+ * @returns The text body (selftext for Reddit, summary for news, text for social).
+ */
+function getText(content) {
+    switch (content.source) {
+        case 'reddit': {
+            return content.selftext;
+        }
+        case 'news-website': {
+            return content.summary;
+        }
+        case 'twitter':
+        case 'mastodon': {
+            return content.text;
+        }
+    }
+}
+/**
+ * Maps IngestContent source type to the corresponding Evidence type for provenance tracking.
+ *
+ * @param content - The content to classify.
+ * @returns The evidence type: official-statement (Reddit), media.report (news), or public.report (social).
+ */
+function getEvidenceType(content) {
+    switch (content.source) {
+        case 'reddit': {
+            return 'official-statement';
+        }
+        case 'news-website': {
+            return 'media.report';
+        }
+        case 'twitter':
+        case 'mastodon': {
+            return 'public.report';
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/util/ingestContent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["util/ingestContent/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from 'node:path';\nimport { DateTime } from 'luxon';\nimport { ulid } from 'ulid';\nimport { computeImpactFromEvidenceClaims } from '#helpers/computeImpactFromEvidenceClaims.js';\nimport { extractClaimsFromNewEvidence } from '#llm/functions/extractClaimsFromNewEvidence/index.js';\nimport { generateIssueTitleAndSlug } from '#llm/functions/generateIssueTitleAndSlug/index.js';\nimport { translate } from '#llm/functions/translate/index.js';\nimport { triageNewEvidence } from '#llm/functions/triageNewEvidence/index.js';\nimport { FileStore } from '#repo/common/FileStore.js';\nimport { MRTDownRepository } from '#repo/MRTDownRepository.js';\nimport type { IssueBundle } from '#schema/issue/bundle.js';\nimport type { Evidence } from '#schema/issue/evidence.js';\nimport type { Issue } from '#schema/issue/issue.js';\nimport { FileWriteStore } from '#write/common/FileWriteStore.js';\nimport { MRTDownWriter } from '#write/MRTDownWriter.js';\nimport { assert } from '../assert.js';\nimport { getSlugDateTimeFromClaims } from './helpers/getSlugDateTimeFromClaims.js';\nimport type { IngestContent } from './types.js';\n\nconst DATA_DIR = resolve(import.meta.dirname, '../../../data');\n\nconst store = new FileStore(DATA_DIR);\nconst writeStore = new FileWriteStore(DATA_DIR);\nconst repo = new MRTDownRepository({ store });\nconst writer = new MRTDownWriter({ store: writeStore });\n\n/**\n * Ingests content from social media, news, or other sources into the MRTDown issue system.\n *\n * Triages the content to determine if it belongs to an existing issue or a new one, extracts\n * claims, computes impact (affected lines, stations, periods), and persists evidence and impact\n * events. Irrelevant content is ignored.\n *\n * @param content - The content to ingest (Reddit post, news article, or Twitter/Mastodon post).\n * @returns `null` when content is irrelevant or after successful ingestion.\n */\nexport async function ingestContent(content: IngestContent) {\n  // --- Normalise input ---\n  // HACK: Force `createdAt` to be Asia/Singapore timezone\n  const createdAt = DateTime.fromISO(content.createdAt)\n    .setZone('Asia/Singapore')\n    .toISO();\n  assert(createdAt != null, 'Expected valid createdAt');\n\n  content.createdAt = createdAt;\n  console.log('[ingestContent]', content);\n\n  // --- Triage: existing issue, new issue, or irrelevant ---\n  const triageResult = await triageNewEvidence({\n    newEvidence: {\n      ts: content.createdAt,\n      text: getText(content),\n    },\n    repo,\n  });\n  console.log('[ingestContent.triageNewEvidence]', triageResult);\n\n  if (triageResult.result.kind === 'irrelevant-content') {\n    console.log('[ingestContent] Nothing to do.');\n    return null;\n  }\n\n  // --- Extract structured claims (lines, stations, periods, effects) ---\n  const { claims } = await extractClaimsFromNewEvidence({\n    newEvidence: {\n      ts: content.createdAt,\n      text: getText(content),\n    },\n    repo,\n  });\n  console.log('[ingestContent.extractClaimsFromNewEvidence]', claims);\n\n  // --- Resolve issue bundle: fetch existing or create new ---\n  let issueBundle: IssueBundle;\n\n  switch (triageResult.result.kind) {\n    case 'part-of-existing-issue': {\n      // Load full bundle (issue + evidence + impact) for impact computation\n      const { issueId } = triageResult.result;\n      const existingBundle = repo.issues.get(issueId);\n      assert(existingBundle != null, `Expected issue for id=${issueId}`);\n      issueBundle = existingBundle;\n      break;\n    }\n    case 'part-of-new-issue': {\n      // Create issue: derive date from claims, generate title/slug, translate, persist\n      const slugDateTime = DateTime.fromISO(\n        getSlugDateTimeFromClaims(claims) ?? content.createdAt,\n      );\n      assert(slugDateTime.isValid, `Invalid date: ${content.createdAt}`);\n\n      const { title, slug } = await generateIssueTitleAndSlug({\n        text: getText(content),\n      });\n      console.log('[ingestContent.generateSlug]', slug);\n\n      const translatedTitles = await translate(title);\n\n      const issueId = `${slugDateTime.toFormat('yyyy-MM-dd')}-${slug}`;\n\n      const issue: Issue = {\n        id: issueId,\n        type: triageResult.result.issueType,\n        title: translatedTitles,\n        titleMeta: {\n          source: '@openai/gpt-5-nano',\n        },\n      };\n      writer.issues.create(issue);\n\n      issueBundle = {\n        issue,\n        evidence: [],\n        impactEvents: [],\n        path: DATA_DIR,\n      };\n      break;\n    }\n  }\n\n  // --- Build evidence record ---\n  const contentDateTime = DateTime.fromISO(content.createdAt);\n  assert(contentDateTime.isValid, `Invalid date: ${content.createdAt}`);\n\n  const evidence: Evidence = {\n    id: `ev_${ulid(contentDateTime.toMillis())}`,\n    ts: contentDateTime.toISO({ includeOffset: true }),\n    type: getEvidenceType(content),\n    text: getText(content),\n    sourceUrl: content.url,\n    render: {\n      text: await translate(getText(content)),\n      source: '@openai/gpt-5-nano',\n    },\n  };\n\n  // --- Compute impact events from claims (effects, scopes, periods) ---\n  const { newImpactEvents } = computeImpactFromEvidenceClaims({\n    issueBundle: {\n      ...issueBundle,\n      evidence: [...issueBundle.evidence, evidence],\n    },\n    evidenceId: evidence.id,\n    evidenceTs: evidence.ts,\n    claims,\n  });\n\n  // --- Persist to disk ---\n  writer.issues.appendEvidence(issueBundle.issue.id, evidence);\n  for (const impact of newImpactEvents) {\n    writer.issues.appendImpact(issueBundle.issue.id, impact);\n  }\n\n  return null;\n}\n\n/**\n * Extracts the primary text content from an IngestContent item based on its source type.\n *\n * @param content - The content to extract text from.\n * @returns The text body (selftext for Reddit, summary for news, text for social).\n */\nfunction getText(content: IngestContent) {\n  switch (content.source) {\n    case 'reddit': {\n      return content.selftext;\n    }\n    case 'news-website': {\n      return content.summary;\n    }\n    case 'twitter':\n    case 'mastodon': {\n      return content.text;\n    }\n  }\n}\n\n/**\n * Maps IngestContent source type to the corresponding Evidence type for provenance tracking.\n *\n * @param content - The content to classify.\n * @returns The evidence type: official-statement (Reddit), media.report (news), or public.report (social).\n */\nfunction getEvidenceType(content: IngestContent) {\n  switch (content.source) {\n    case 'reddit': {\n      return 'official-statement';\n    }\n    case 'news-website': {\n      return 'media.report';\n    }\n    case 'twitter':\n    case 'mastodon': {\n      return 'public.report';\n    }\n  }\n}\n"]}

package/dist/util/ingestContent/types.d.ts

@@ -0,0 +1,32 @@
+import type { z } from 'zod';
+export type IngestContentTwitter = {
+    source: 'twitter' | 'mastodon';
+    accountName: string;
+    text: string;
+    url: string;
+    createdAt: string;
+};
+export type IngestContentReddit = {
+    source: 'reddit';
+    subreddit: string;
+    title: string;
+    selftext: string;
+    url: string;
+    createdAt: string;
+    thumbnailUrl: string | null;
+};
+export type IngestContentNewsArticle = {
+    source: 'news-website';
+    title: string;
+    summary: string;
+    url: string;
+    createdAt: string;
+};
+export type IngestContent = IngestContentTwitter | IngestContentReddit | IngestContentNewsArticle;
+export type Tool<TParams = any> = {
+    name: string;
+    description: string;
+    paramSchema: z.ZodType<TParams>;
+    runner: (param: TParams) => Promise<string>;
+};
+export type ToolRegistry = Record<string, Tool>;

package/dist/util/ingestContent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/util/ingestContent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"/","sources":["util/ingestContent/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { z } from 'zod';\n\nexport type IngestContentTwitter = {\n  source: 'twitter' | 'mastodon';\n  accountName: string;\n  text: string;\n  url: string;\n  createdAt: string;\n};\n\nexport type IngestContentReddit = {\n  source: 'reddit';\n  subreddit: string;\n  title: string;\n  selftext: string;\n  url: string;\n  createdAt: string;\n  thumbnailUrl: string | null;\n};\n\nexport type IngestContentNewsArticle = {\n  source: 'news-website';\n  title: string;\n  summary: string;\n  url: string;\n  createdAt: string;\n};\n\nexport type IngestContent =\n  | IngestContentTwitter\n  | IngestContentReddit\n  | IngestContentNewsArticle;\n\nexport type Tool<TParams = any> = {\n  name: string;\n  description: string;\n  paramSchema: z.ZodType<TParams>;\n  runner: (param: TParams) => Promise<string>;\n};\n\nexport type ToolRegistry = Record<string, Tool>;\n"]}

package/dist/write/MRTDownWriter.d.ts

@@ -0,0 +1,27 @@
+import type { Landmark } from '../schema/Landmark.js';
+import type { Line } from '../schema/Line.js';
+import type { Operator } from '../schema/Operator.js';
+import type { Service } from '../schema/Service.js';
+import type { Station } from '../schema/Station.js';
+import type { Town } from '../schema/Town.js';
+import { StandardWriter } from './common/StandardWriter.js';
+import type { IWriteStore } from './common/store.js';
+import { IssueWriter } from './issue/IssueWriter.js';
+type MRTDownWriterParams = {
+    store: IWriteStore;
+};
+/**
+ * A writer for the MRTDown data.
+ */
+export declare class MRTDownWriter {
+    private readonly store;
+    readonly issues: IssueWriter;
+    readonly stations: StandardWriter<Station>;
+    readonly lines: StandardWriter<Line>;
+    readonly operators: StandardWriter<Operator>;
+    readonly services: StandardWriter<Service>;
+    readonly landmarks: StandardWriter<Landmark>;
+    readonly towns: StandardWriter<Town>;
+    constructor(params: MRTDownWriterParams);
+}
+export {};

package/dist/write/MRTDownWriter.js

@@ -0,0 +1,27 @@
+import { DIR_LANDMARK, DIR_LINE, DIR_OPERATOR, DIR_SERVICE, DIR_STATION, DIR_TOWN, } from '../constants.js';
+import { StandardWriter } from './common/StandardWriter.js';
+import { IssueWriter } from './issue/IssueWriter.js';
+/**
+ * A writer for the MRTDown data.
+ */
+export class MRTDownWriter {
+    store;
+    issues;
+    stations;
+    lines;
+    operators;
+    services;
+    landmarks;
+    towns;
+    constructor(params) {
+        this.store = params.store;
+        this.issues = new IssueWriter(this.store);
+        this.stations = new StandardWriter(this.store, DIR_STATION);
+        this.lines = new StandardWriter(this.store, DIR_LINE);
+        this.operators = new StandardWriter(this.store, DIR_OPERATOR);
+        this.services = new StandardWriter(this.store, DIR_SERVICE);
+        this.landmarks = new StandardWriter(this.store, DIR_LANDMARK);
+        this.towns = new StandardWriter(this.store, DIR_TOWN);
+    }
+}
+//# sourceMappingURL=MRTDownWriter.js.map

package/dist/write/MRTDownWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MRTDownWriter.js","sourceRoot":"/","sources":["write/MRTDownWriter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW,EACX,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMrD;;GAEG;AACH,MAAM,OAAO,aAAa;IACP,KAAK,CAAc;IAC3B,MAAM,CAAc;IACpB,QAAQ,CAA0B;IAClC,KAAK,CAAuB;IAC5B,SAAS,CAA2B;IACpC,QAAQ,CAA0B;IAClC,SAAS,CAA2B;IACpC,KAAK,CAAuB;IAErC,YAAY,MAA2B;QACrC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;CACF","sourcesContent":["import {\n  DIR_LANDMARK,\n  DIR_LINE,\n  DIR_OPERATOR,\n  DIR_SERVICE,\n  DIR_STATION,\n  DIR_TOWN,\n} from '../constants.js';\nimport type { Landmark } from '../schema/Landmark.js';\nimport type { Line } from '../schema/Line.js';\nimport type { Operator } from '../schema/Operator.js';\nimport type { Service } from '../schema/Service.js';\nimport type { Station } from '../schema/Station.js';\nimport type { Town } from '../schema/Town.js';\nimport { StandardWriter } from './common/StandardWriter.js';\nimport type { IWriteStore } from './common/store.js';\nimport { IssueWriter } from './issue/IssueWriter.js';\n\ntype MRTDownWriterParams = {\n  store: IWriteStore;\n};\n\n/**\n * A writer for the MRTDown data.\n */\nexport class MRTDownWriter {\n  private readonly store: IWriteStore;\n  readonly issues: IssueWriter;\n  readonly stations: StandardWriter<Station>;\n  readonly lines: StandardWriter<Line>;\n  readonly operators: StandardWriter<Operator>;\n  readonly services: StandardWriter<Service>;\n  readonly landmarks: StandardWriter<Landmark>;\n  readonly towns: StandardWriter<Town>;\n\n  constructor(params: MRTDownWriterParams) {\n    this.store = params.store;\n    this.issues = new IssueWriter(this.store);\n    this.stations = new StandardWriter(this.store, DIR_STATION);\n    this.lines = new StandardWriter(this.store, DIR_LINE);\n    this.operators = new StandardWriter(this.store, DIR_OPERATOR);\n    this.services = new StandardWriter(this.store, DIR_SERVICE);\n    this.landmarks = new StandardWriter(this.store, DIR_LANDMARK);\n    this.towns = new StandardWriter(this.store, DIR_TOWN);\n  }\n}\n"]}

package/dist/write/common/FileWriteStore.d.ts

@@ -0,0 +1,13 @@
+import type { IWriteStore } from './store.js';
+/**
+ * A write store that writes to the file system.
+ */
+export declare class FileWriteStore implements IWriteStore {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    writeText(path: string, text: string): void;
+    writeJson(path: string, json: unknown): void;
+    appendText(path: string, text: string): void;
+    ensureDir(path: string): void;
+    delete(path: string): void;
+}

package/dist/write/common/FileWriteStore.js

@@ -0,0 +1,31 @@
+import { appendFileSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * A write store that writes to the file system.
+ */
+export class FileWriteStore {
+    rootDir;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    writeText(path, text) {
+        const fullPath = join(this.rootDir, path);
+        writeFileSync(fullPath, text);
+    }
+    writeJson(path, json) {
+        this.writeText(path, JSON.stringify(json, null, 2));
+    }
+    appendText(path, text) {
+        const fullPath = join(this.rootDir, path);
+        appendFileSync(fullPath, text);
+    }
+    ensureDir(path) {
+        const fullPath = join(this.rootDir, path);
+        mkdirSync(fullPath, { recursive: true });
+    }
+    delete(path) {
+        const fullPath = join(this.rootDir, path);
+        rmSync(fullPath);
+    }
+}
+//# sourceMappingURL=FileWriteStore.js.map

package/dist/write/common/FileWriteStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileWriteStore.js","sourceRoot":"/","sources":["write/common/FileWriteStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;GAEG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,SAAS,CAAC,IAAY,EAAE,IAAY;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,IAAa;QACnC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,IAAY;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC;CACF","sourcesContent":["import { appendFileSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { IWriteStore } from './store.js';\n\n/**\n * A write store that writes to the file system.\n */\nexport class FileWriteStore implements IWriteStore {\n  constructor(private readonly rootDir: string) {}\n\n  writeText(path: string, text: string): void {\n    const fullPath = join(this.rootDir, path);\n    writeFileSync(fullPath, text);\n  }\n\n  writeJson(path: string, json: unknown): void {\n    this.writeText(path, JSON.stringify(json, null, 2));\n  }\n\n  appendText(path: string, text: string): void {\n    const fullPath = join(this.rootDir, path);\n    appendFileSync(fullPath, text);\n  }\n\n  ensureDir(path: string): void {\n    const fullPath = join(this.rootDir, path);\n    mkdirSync(fullPath, { recursive: true });\n  }\n\n  delete(path: string): void {\n    const fullPath = join(this.rootDir, path);\n    rmSync(fullPath);\n  }\n}\n"]}

package/dist/write/common/StandardWriter.d.ts

@@ -0,0 +1,14 @@
+import type { IWriteStore } from './store.js';
+type Item = {
+    id: string;
+};
+/**
+ * A standard writer for items represented by single JSON files that are stored in a directory.
+ */
+export declare class StandardWriter<T extends Item> {
+    private readonly store;
+    private readonly dirPath;
+    constructor(store: IWriteStore, dirPath: string);
+    create(item: T): void;
+}
+export {};

package/dist/write/common/StandardWriter.js

@@ -0,0 +1,17 @@
+import { join } from 'node:path';
+/**
+ * A standard writer for items represented by single JSON files that are stored in a directory.
+ */
+export class StandardWriter {
+    store;
+    dirPath;
+    constructor(store, dirPath) {
+        this.store = store;
+        this.dirPath = dirPath;
+    }
+    create(item) {
+        this.store.ensureDir(this.dirPath);
+        this.store.writeJson(join(this.dirPath, `${item.id}.json`), item);
+    }
+}
+//# sourceMappingURL=StandardWriter.js.map

package/dist/write/common/StandardWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StandardWriter.js","sourceRoot":"/","sources":["write/common/StandardWriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC;;GAEG;AACH,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,KAAkB,EAClB,OAAe;QADf,UAAK,GAAL,KAAK,CAAa;QAClB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,MAAM,CAAC,IAAO;QACZ,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;CACF","sourcesContent":["import { join } from 'node:path';\nimport type { IWriteStore } from './store.js';\n\ntype Item = {\n  id: string;\n};\n\n/**\n * A standard writer for items represented by single JSON files that are stored in a directory.\n */\nexport class StandardWriter<T extends Item> {\n  constructor(\n    private readonly store: IWriteStore,\n    private readonly dirPath: string,\n  ) {}\n\n  create(item: T): void {\n    this.store.ensureDir(this.dirPath);\n    this.store.writeJson(join(this.dirPath, `${item.id}.json`), item);\n  }\n}\n"]}

package/dist/write/common/store.d.ts

@@ -0,0 +1,32 @@
+export interface IWriteStore {
+    /**
+     * Write a text file.
+     * @param path
+     * @param text
+     */
+    writeText(path: string, text: string): void;
+    /**
+     * Write a JSON file.
+     * @param path
+     * @param json
+     */
+    writeJson(path: string, json: unknown): void;
+    /**
+     * Append text to a file.
+     * @param path
+     * @param text
+     */
+    appendText(path: string, text: string): void;
+    /**
+     * Ensure a directory exists.
+     * @param path
+     * @returns
+     */
+    ensureDir(path: string): void;
+    /**
+     * Delete a file or directory.
+     * @param path
+     * @returns
+     */
+    delete?(path: string): void;
+}

package/dist/write/common/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/write/common/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"/","sources":["write/common/store.ts"],"names":[],"mappings":"","sourcesContent":["export interface IWriteStore {\n  /**\n   * Write a text file.\n   * @param path\n   * @param text\n   */\n  writeText(path: string, text: string): void;\n  /**\n   * Write a JSON file.\n   * @param path\n   * @param json\n   */\n  writeJson(path: string, json: unknown): void;\n  /**\n   * Append text to a file.\n   * @param path\n   * @param text\n   */\n  appendText(path: string, text: string): void;\n  /**\n   * Ensure a directory exists.\n   * @param path\n   * @returns\n   */\n  ensureDir(path: string): void;\n  /**\n   * Delete a file or directory.\n   * @param path\n   * @returns\n   */\n  delete?(path: string): void;\n}\n"]}

package/dist/write/id/IdGenerator.d.ts

@@ -0,0 +1,18 @@
+import type { DateTime } from 'luxon';
+/**
+ * A utility for generating unique IDs.
+ */
+export declare const IdGenerator: {
+    /**
+     * Generate a unique ID for an evidence.
+     * @param ts - The timestamp of the evidence.
+     * @returns
+     */
+    evidenceId(ts?: DateTime): string;
+    /**
+     * Generate a unique ID for an impact event.
+     * @param ts - The timestamp of the impact event.
+     * @returns
+     */
+    impactEventId(ts?: DateTime): string;
+};

package/dist/write/id/IdGenerator.js

@@ -0,0 +1,23 @@
+import { ulid } from 'ulid';
+/**
+ * A utility for generating unique IDs.
+ */
+export const IdGenerator = {
+    /**
+     * Generate a unique ID for an evidence.
+     * @param ts - The timestamp of the evidence.
+     * @returns
+     */
+    evidenceId(ts) {
+        return `ev_${ulid(ts?.toMillis?.() ?? undefined)}`;
+    },
+    /**
+     * Generate a unique ID for an impact event.
+     * @param ts - The timestamp of the impact event.
+     * @returns
+     */
+    impactEventId(ts) {
+        return `ie_${ulid(ts?.toMillis?.() ?? undefined)}`;
+    },
+};
+//# sourceMappingURL=IdGenerator.js.map

package/dist/write/id/IdGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdGenerator.js","sourceRoot":"/","sources":["write/id/IdGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAa;QACtB,OAAO,MAAM,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,SAAS,CAAC,EAAE,CAAC;IACrD,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,EAAa;QACzB,OAAO,MAAM,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,SAAS,CAAC,EAAE,CAAC;IACrD,CAAC;CACF,CAAC","sourcesContent":["import type { DateTime } from 'luxon';\nimport { ulid } from 'ulid';\n\n/**\n * A utility for generating unique IDs.\n */\nexport const IdGenerator = {\n  /**\n   * Generate a unique ID for an evidence.\n   * @param ts - The timestamp of the evidence.\n   * @returns\n   */\n  evidenceId(ts?: DateTime) {\n    return `ev_${ulid(ts?.toMillis?.() ?? undefined)}`;\n  },\n\n  /**\n   * Generate a unique ID for an impact event.\n   * @param ts - The timestamp of the impact event.\n   * @returns\n   */\n  impactEventId(ts?: DateTime) {\n    return `ie_${ulid(ts?.toMillis?.() ?? undefined)}`;\n  },\n};\n"]}

package/dist/write/issue/IssueWriter.d.ts

@@ -0,0 +1,12 @@
+import type { Evidence } from '#schema/issue/evidence.js';
+import type { ImpactEvent } from '#schema/issue/impactEvent.js';
+import type { Issue } from '#schema/issue/issue.js';
+import type { IWriteStore } from '../common/store.js';
+export declare class IssueWriter {
+    private readonly store;
+    constructor(store: IWriteStore);
+    create(issue: Issue): void;
+    appendEvidence(issueId: string, evidence: Evidence): void;
+    appendImpact(issueId: string, impact: ImpactEvent): void;
+    private getIssueDir;
+}