@10et/cli 1.0.0

package/dist/lib/linear-client.js

@@ -0,0 +1,112 @@
+/**
+ * Linear Client Wrapper
+ *
+ * Typed helpers around the @linear/sdk LinearClient.
+ * Keeps API calls centralized and testable.
+ *
+ * @purpose Wrapper for Linear API — auth, teams, projects, issues
+ */
+import { LinearClient } from "@linear/sdk";
+export function getLinearClient(apiKey) {
+    return new LinearClient({ apiKey });
+}
+export async function getLinearTeams(client) {
+    const result = await client.teams();
+    return result.nodes.map(t => ({
+        id: t.id,
+        name: t.name,
+        key: t.key,
+    }));
+}
+export async function getLinearProjects(client, teamId) {
+    const team = await client.team(teamId);
+    const projects = await team.projects();
+    return projects.nodes.map(p => ({
+        id: p.id,
+        name: p.name,
+        description: p.description ?? undefined,
+    }));
+}
+export async function getTeamStates(client, teamId) {
+    const result = await client.workflowStates({
+        filter: { team: { id: { eq: teamId } } },
+    });
+    return result.nodes.map(s => ({
+        id: s.id,
+        name: s.name,
+        type: s.type,
+        color: s.color,
+        position: s.position,
+    }));
+}
+export async function getLinearIssue(client, issueId) {
+    try {
+        const issue = await client.issue(issueId);
+        return normalizeIssue(issue);
+    }
+    catch {
+        return null;
+    }
+}
+export async function getProjectIssues(client, projectId) {
+    const result = await client.issues({
+        filter: { project: { id: { eq: projectId } } },
+    });
+    const issues = await Promise.all(result.nodes.map(normalizeIssue));
+    return issues.filter((i) => i !== null);
+}
+export async function createLinearIssue(client, opts) {
+    const result = await client.createIssue({
+        title: opts.title,
+        description: opts.description,
+        teamId: opts.teamId,
+        projectId: opts.projectId,
+        stateId: opts.stateId,
+        priority: opts.priority,
+        labelIds: opts.labelIds,
+        assigneeId: opts.assigneeId,
+    });
+    if (!result.success)
+        return null;
+    const issue = await result.issue;
+    if (!issue)
+        return null;
+    return normalizeIssue(issue);
+}
+export async function updateLinearIssue(client, issueId, opts) {
+    const result = await client.updateIssue(issueId, opts);
+    return result.success;
+}
+async function normalizeIssue(issue) {
+    const state = await issue.state;
+    const assignee = await issue.assignee;
+    const labels = await issue.labels();
+    return {
+        id: issue.id,
+        identifier: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? undefined,
+        priority: issue.priority ?? 0,
+        state: {
+            id: state?.id ?? "",
+            name: state?.name ?? "Backlog",
+            type: state?.type ?? "backlog",
+            color: state?.color ?? "#888888",
+            position: state?.position ?? 0,
+        },
+        assignee: assignee ? {
+            id: assignee.id,
+            name: assignee.name,
+            email: assignee.email,
+        } : undefined,
+        labels: labels?.nodes?.map((l) => ({
+            id: l.id,
+            name: l.name,
+            color: l.color,
+        })) ?? [],
+        url: issue.url,
+        createdAt: issue.createdAt?.toISOString() ?? new Date().toISOString(),
+        updatedAt: issue.updatedAt?.toISOString() ?? new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=linear-client.js.map

package/dist/lib/linear-client.js.map

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

package/dist/lib/linear-id-map.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Linear ID Map — Bidirectional Mapping Store
+ *
+ * Persists GitHub issue number ↔ Linear issue ID mappings
+ * in .jfl/linear-map.json. No database required for Phase 1.
+ *
+ * @purpose Bidirectional ID mapping between GitHub Issues and Linear Issues
+ */
+export interface LinearMap {
+    projectId: string;
+    teamId: string;
+    mappings: Record<number, string>;
+}
+export declare function readMap(projectRoot: string): LinearMap;
+export declare function writeMap(projectRoot: string, map: LinearMap): void;
+export declare function getLinearId(projectRoot: string, githubNumber: number): string | undefined;
+export declare function getGithubNumber(projectRoot: string, linearId: string): number | undefined;
+export declare function addMapping(projectRoot: string, githubNumber: number, linearId: string): void;
+export declare function removeMapping(projectRoot: string, githubNumber: number): void;
+//# sourceMappingURL=linear-id-map.d.ts.map

package/dist/lib/linear-id-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-id-map.d.ts","sourceRoot":"","sources":["../../src/lib/linear-id-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAYD,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAWtD;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAKlE;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzF;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIzF;AAED,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,IAAI,CAIN;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAI7E"}

package/dist/lib/linear-id-map.js

@@ -0,0 +1,59 @@
+/**
+ * Linear ID Map — Bidirectional Mapping Store
+ *
+ * Persists GitHub issue number ↔ Linear issue ID mappings
+ * in .jfl/linear-map.json. No database required for Phase 1.
+ *
+ * @purpose Bidirectional ID mapping between GitHub Issues and Linear Issues
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+function mapPath(projectRoot, dataDir = ".jfl") {
+    return join(projectRoot, dataDir, "linear-map.json");
+}
+function detectDataDir(projectRoot) {
+    if (existsSync(join(projectRoot, ".jfl", "config.json")))
+        return ".jfl";
+    if (existsSync(join(projectRoot, ".tenet", "config.json")))
+        return ".tenet";
+    return ".jfl";
+}
+export function readMap(projectRoot) {
+    const dataDir = detectDataDir(projectRoot);
+    const path = mapPath(projectRoot, dataDir);
+    if (!existsSync(path)) {
+        return { projectId: "", teamId: "", mappings: {} };
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return { projectId: "", teamId: "", mappings: {} };
+    }
+}
+export function writeMap(projectRoot, map) {
+    const dataDir = detectDataDir(projectRoot);
+    const dir = join(projectRoot, dataDir);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(mapPath(projectRoot, dataDir), JSON.stringify(map, null, 2) + "\n");
+}
+export function getLinearId(projectRoot, githubNumber) {
+    return readMap(projectRoot).mappings[githubNumber];
+}
+export function getGithubNumber(projectRoot, linearId) {
+    const map = readMap(projectRoot);
+    const entry = Object.entries(map.mappings).find(([, lid]) => lid === linearId);
+    return entry ? parseInt(entry[0]) : undefined;
+}
+export function addMapping(projectRoot, githubNumber, linearId) {
+    const map = readMap(projectRoot);
+    map.mappings[githubNumber] = linearId;
+    writeMap(projectRoot, map);
+}
+export function removeMapping(projectRoot, githubNumber) {
+    const map = readMap(projectRoot);
+    delete map.mappings[githubNumber];
+    writeMap(projectRoot, map);
+}
+//# sourceMappingURL=linear-id-map.js.map

package/dist/lib/linear-id-map.js.map

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

package/dist/lib/linear-kanban.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Linear ↔ Kanban Normalizers
+ *
+ * Converts between Linear issues, TenetCards, and GitHub issue inputs.
+ * TenetCard is the common intermediate representation.
+ *
+ * State mapping:
+ *   Linear backlog/unstarted → jfl/backlog
+ *   Linear started           → jfl/in-progress (or jfl/eval if "review" in name)
+ *   Linear completed         → jfl/done
+ *
+ * @purpose Normalize Linear issues ↔ TenetCard ↔ GitHub Issues
+ */
+import type { LinearIssue, LinearState, CreateIssueInput } from "./linear-client.js";
+import type { KanbanCard, Column } from "./kanban-github.js";
+export type { Column };
+export interface TenetCard {
+    id: string;
+    linearId?: string;
+    githubNumber?: number;
+    title: string;
+    description: string;
+    status: Column;
+    priority: number;
+    assignee?: string;
+    labels: string[];
+    source: "human" | "agent" | "ci" | "flow" | "linear";
+    links: {
+        pr?: number;
+        pr_url?: string;
+        eval?: string;
+        journal?: string;
+        linear_url?: string;
+    };
+}
+export declare function linearStateToColumn(state: LinearState): Column;
+export declare function linearPriorityToJfl(priority: number): number;
+export declare function jflPriorityToLinear(priority: number): number;
+/**
+ * Find the best matching Linear state ID for a given jfl column.
+ * Searches the team's workflow states.
+ */
+export declare function findLinearStateId(states: LinearState[], column: Column): string | undefined;
+/**
+ * Convert a Linear issue to a TenetCard
+ */
+export declare function linearToTenet(issue: LinearIssue): TenetCard;
+/**
+ * Convert a KanbanCard (from kanban-github.ts) to a TenetCard
+ */
+export declare function kanbanToTenet(card: KanbanCard): TenetCard;
+/**
+ * Convert a TenetCard to Linear issue creation input.
+ * Requires states from the team to map column → stateId.
+ */
+export declare function tenetToLinearCreate(card: TenetCard, teamId: string, projectId: string, states: LinearState[]): CreateIssueInput;
+/**
+ * Build GitHub issue body for a TenetCard synced from Linear
+ */
+export declare function tenetToGitHubBody(card: TenetCard): string;
+/**
+ * Get GitHub labels for a TenetCard.
+ * Pass scope to add scope:service-name label (for centralized kanban layout).
+ */
+export declare function tenetToGitHubLabels(card: TenetCard, scope?: string): string[];
+//# sourceMappingURL=linear-kanban.d.ts.map

package/dist/lib/linear-kanban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-kanban.d.ts","sourceRoot":"","sources":["../../src/lib/linear-kanban.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE5D,YAAY,EAAE,MAAM,EAAE,CAAA;AAGtB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAA;IACpD,KAAK,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAsBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAI9D;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM5D;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAoBpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAgB3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAmBzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,GACpB,gBAAgB,CAUlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB7E"}

package/dist/lib/linear-kanban.js

@@ -0,0 +1,175 @@
+/**
+ * Linear ↔ Kanban Normalizers
+ *
+ * Converts between Linear issues, TenetCards, and GitHub issue inputs.
+ * TenetCard is the common intermediate representation.
+ *
+ * State mapping:
+ *   Linear backlog/unstarted → jfl/backlog
+ *   Linear started           → jfl/in-progress (or jfl/eval if "review" in name)
+ *   Linear completed         → jfl/done
+ *
+ * @purpose Normalize Linear issues ↔ TenetCard ↔ GitHub Issues
+ */
+// State type → jfl column
+const STATE_TYPE_MAP = {
+    triage: "backlog",
+    backlog: "backlog",
+    unstarted: "backlog",
+    started: "in_progress",
+    completed: "done",
+    cancelled: "done",
+};
+const EVAL_KEYWORDS = ["review", "testing", "qa", "eval", "in review"];
+// jfl column → Linear state type to search for
+const COLUMN_TO_STATE_TYPE = {
+    backlog: ["backlog", "unstarted"],
+    in_progress: ["started"],
+    eval: ["started"],
+    done: ["completed"],
+};
+export function linearStateToColumn(state) {
+    const nameLower = state.name.toLowerCase();
+    if (EVAL_KEYWORDS.some(kw => nameLower.includes(kw)))
+        return "eval";
+    return STATE_TYPE_MAP[state.type] ?? "backlog";
+}
+// Linear priority (1=urgent, 4=low) → jfl priority (higher=more urgent)
+export function linearPriorityToJfl(priority) {
+    if (priority === 1)
+        return 9;
+    if (priority === 2)
+        return 6;
+    if (priority === 3)
+        return 3;
+    if (priority === 4)
+        return 2;
+    return 0;
+}
+// jfl priority → Linear priority
+export function jflPriorityToLinear(priority) {
+    if (priority >= 9)
+        return 1;
+    if (priority >= 6)
+        return 2;
+    if (priority >= 3)
+        return 3;
+    if (priority >= 1)
+        return 4;
+    return 0;
+}
+/**
+ * Find the best matching Linear state ID for a given jfl column.
+ * Searches the team's workflow states.
+ */
+export function findLinearStateId(states, column) {
+    const targetTypes = COLUMN_TO_STATE_TYPE[column];
+    const nameLower = (name) => name.toLowerCase();
+    if (column === "eval") {
+        // Look for a state with "review" in the name first
+        const evalState = states.find(s => s.type === "started" && EVAL_KEYWORDS.some(kw => nameLower(s.name).includes(kw)));
+        if (evalState)
+            return evalState.id;
+        // Fall back to any started state
+        return states.find(s => s.type === "started")?.id;
+    }
+    // Find state matching target types, sorted by position
+    const candidates = states
+        .filter(s => targetTypes.includes(s.type))
+        .sort((a, b) => a.position - b.position);
+    return candidates[0]?.id;
+}
+/**
+ * Convert a Linear issue to a TenetCard
+ */
+export function linearToTenet(issue) {
+    return {
+        id: issue.id,
+        linearId: issue.id,
+        githubNumber: undefined,
+        title: issue.title,
+        description: issue.description ?? "",
+        status: linearStateToColumn(issue.state),
+        priority: linearPriorityToJfl(issue.priority),
+        assignee: issue.assignee?.name,
+        labels: issue.labels.map(l => l.name),
+        source: "linear",
+        links: {
+            linear_url: issue.url,
+        },
+    };
+}
+/**
+ * Convert a KanbanCard (from kanban-github.ts) to a TenetCard
+ */
+export function kanbanToTenet(card) {
+    return {
+        id: card.id,
+        linearId: undefined,
+        githubNumber: card.number,
+        title: card.title,
+        description: card.description,
+        status: card.column,
+        priority: card.priority,
+        assignee: card.agent || undefined,
+        labels: card.labels,
+        source: card.source,
+        links: {
+            pr: card.links.pr,
+            pr_url: card.links.pr_url,
+            eval: card.links.eval,
+            journal: card.links.journal,
+        },
+    };
+}
+/**
+ * Convert a TenetCard to Linear issue creation input.
+ * Requires states from the team to map column → stateId.
+ */
+export function tenetToLinearCreate(card, teamId, projectId, states) {
+    const stateId = findLinearStateId(states, card.status);
+    return {
+        title: card.title,
+        description: card.description || undefined,
+        teamId,
+        projectId,
+        stateId,
+        priority: jflPriorityToLinear(card.priority),
+    };
+}
+/**
+ * Build GitHub issue body for a TenetCard synced from Linear
+ */
+export function tenetToGitHubBody(card) {
+    let body = card.description || "";
+    const meta = [`linear_id: ${card.linearId}`];
+    if (card.links.linear_url)
+        meta.push(`linear_url: ${card.links.linear_url}`);
+    if (meta.length > 0) {
+        body += `\n\n<!-- jfl:\n${meta.join("\n")}\n-->`;
+    }
+    return body;
+}
+/**
+ * Get GitHub labels for a TenetCard.
+ * Pass scope to add scope:service-name label (for centralized kanban layout).
+ */
+export function tenetToGitHubLabels(card, scope) {
+    const COLUMN_LABELS = {
+        backlog: "jfl/backlog",
+        in_progress: "jfl/in-progress",
+        eval: "jfl/eval",
+        done: "jfl/done",
+    };
+    const labels = [COLUMN_LABELS[card.status], "source:linear"];
+    if (scope)
+        labels.push(`scope:${scope}`);
+    if (card.priority >= 9)
+        labels.push("priority:critical");
+    else if (card.priority >= 6)
+        labels.push("priority:high");
+    else if (card.priority >= 1)
+        labels.push("priority:low");
+    return labels;
+}
+//# sourceMappingURL=linear-kanban.js.map

package/dist/lib/linear-kanban.js.map

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

package/dist/lib/linear-webhook.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Linear Webhook Handler
+ *
+ * Processes incoming Linear webhook events and syncs relevant data
+ * into the JFL journal layer. Currently handles Document events
+ * (create/update) to enable Linear-native users to get JFL memory
+ * from their Linear docs.
+ *
+ * @purpose Handle Linear webhook events and sync Document content as journal entries
+ */
+/** Raw Linear webhook payload (top-level envelope) */
+export interface LinearWebhookPayload {
+    action: "create" | "update" | "remove";
+    type: string;
+    data: Record<string, unknown>;
+    organizationId?: string;
+    webhookId?: string;
+    webhookTimestamp?: number;
+    url?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** Document-specific data from Linear webhook */
+export interface LinearDocumentData {
+    id: string;
+    title: string;
+    content?: string | null;
+    description?: string | null;
+    slugId?: string;
+    projectId?: string | null;
+    initiativeId?: string | null;
+    creatorId?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+    archivedAt?: string | null;
+    trashed?: boolean;
+}
+/** Result of handling a webhook event */
+export interface WebhookHandlerResult {
+    handled: boolean;
+    journalFile?: string;
+    entryType?: string;
+    message: string;
+}
+/**
+ * Handle a Linear webhook event.
+ * Currently supports Document create/update → journal entry.
+ */
+export declare function handleLinearWebhook(payload: LinearWebhookPayload, projectRoot: string): WebhookHandlerResult;
+//# sourceMappingURL=linear-webhook.d.ts.map

package/dist/lib/linear-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-webhook.d.ts","sourceRoot":"","sources":["../../src/lib/linear-webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAStB"}

package/dist/lib/linear-webhook.js

@@ -0,0 +1,92 @@
+/**
+ * Linear Webhook Handler
+ *
+ * Processes incoming Linear webhook events and syncs relevant data
+ * into the JFL journal layer. Currently handles Document events
+ * (create/update) to enable Linear-native users to get JFL memory
+ * from their Linear docs.
+ *
+ * @purpose Handle Linear webhook events and sync Document content as journal entries
+ */
+import * as fs from "fs";
+import * as path from "path";
+// ── Handler ────────────────────────────────────────────────────
+/**
+ * Handle a Linear webhook event.
+ * Currently supports Document create/update → journal entry.
+ */
+export function handleLinearWebhook(payload, projectRoot) {
+    if (payload.type === "Document") {
+        return handleDocumentEvent(payload, projectRoot);
+    }
+    return {
+        handled: false,
+        message: `Unhandled event type: ${payload.type}`,
+    };
+}
+/**
+ * Handle Document create/update events.
+ * Writes (or overwrites) a journal entry capturing the document content.
+ */
+function handleDocumentEvent(payload, projectRoot) {
+    const { action, data } = payload;
+    // Only handle create and update — not remove
+    if (action !== "create" && action !== "update") {
+        return {
+            handled: false,
+            message: `Document action "${action}" not handled (only create/update)`,
+        };
+    }
+    const doc = data;
+    if (!doc.id || !doc.title) {
+        return {
+            handled: false,
+            message: "Document event missing required fields (id, title)",
+        };
+    }
+    // Skip trashed/archived documents
+    if (doc.trashed || doc.archivedAt) {
+        return {
+            handled: false,
+            message: `Document "${doc.title}" is trashed/archived — skipping`,
+        };
+    }
+    const journalDir = path.join(projectRoot, ".jfl", "journal");
+    if (!fs.existsSync(journalDir)) {
+        fs.mkdirSync(journalDir, { recursive: true });
+    }
+    const entry = buildJournalEntry(doc, action, payload.organizationId);
+    const journalFile = path.join(journalDir, "linear-documents.jsonl");
+    fs.appendFileSync(journalFile, JSON.stringify(entry) + "\n");
+    return {
+        handled: true,
+        journalFile,
+        entryType: entry.type,
+        message: `Document "${doc.title}" synced as journal entry (${action})`,
+    };
+}
+/**
+ * Build a journal entry from a Linear Document event.
+ */
+function buildJournalEntry(doc, action, organizationId) {
+    // Truncate content for the summary, keep full in detail
+    const contentPreview = doc.content
+        ? doc.content.slice(0, 200) + (doc.content.length > 200 ? "…" : "")
+        : doc.description ?? "";
+    return {
+        v: 1,
+        ts: new Date().toISOString(),
+        session: "linear-webhook",
+        type: action === "create" ? "discovery" : "feature",
+        status: "complete",
+        title: `[Linear Doc] ${doc.title}`,
+        summary: `Linear document ${action === "create" ? "created" : "updated"}: ${doc.title}. ${contentPreview}`,
+        detail: doc.content ?? doc.description ?? "",
+        source: "linear",
+        linear_doc_id: doc.id,
+        linear_slug: doc.slugId,
+        linear_project_id: doc.projectId ?? undefined,
+        linear_org_id: organizationId ?? undefined,
+    };
+}
+//# sourceMappingURL=linear-webhook.js.map

package/dist/lib/linear-webhook.js.map

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