@dahrk/linear 0.1.0 → 0.2.0

package/README.md

@@ -1,19 +1,31 @@
 # @dahrk/linear
 
-**Confidentiality:** Internal
-**Status:** DRAFT - UNREVIEWED
+The Linear-native control surface used by [Dahrk](https://dahrk.ai), a Linear-native agent-workflow
+harness. Linear is the substrate and the only source; this package is how Dahrk speaks to it.
 
-The Linear-native control surface and webhook verification. Linear is the substrate and the only
-source; this package is how Dahrk speaks to it.
+- **Intake-side:** verify webhook signatures and normalise them to an internal `LinearEvent`.
+- **Session-side:** the Agent Session API - activities, the agent-plan checklist, `elicitation` gates,
+  the `prompted` drive, the `stop` signal, and `externalUrls`.
 
-- **Intake-side:** verify webhook signatures; normalise to the internal `LinearEvent`.
-- **Session-side:** the Agent Session API - activities, the agent-plan checklist, `elicitation`
-  gates, the `prompted` drive, the `stop` signal, `externalUrls`.
+Used by both the hub (intake plus session) and the edge node (session, while a stage runs). Implemented
+against the Linear API directly, on top of the Linear TypeScript SDK.
 
-Used by both `hub` (intake + session) and `edge` (session, while a stage runs). Re-implemented
-against the API directly; cyrus is a reference. Intended runtime dependency: the Linear TypeScript
-SDK. See `../../docs/01-build-spec.md` section 14.
+## Stability
 
-## Sources
+This package is pre-1.0, so **a minor bump can break**. Note that a caret range on a `0.x` version does
+not cross the minor: `^0.1.0` will not resolve `0.2.0`. Pin deliberately.
 
-- `../../docs/01-build-spec.md`, the design's doc 05 (Linear feature coverage).
+## Notes for the curious
+
+**There is deliberately no `repository` field**, which is why npm shows no repository row. This package
+is published from a private repo, so the accurate link would 404 for everyone who can read the package,
+and pointing it at the public `dahrk-node` would send readers to a repo the source is not in. The links
+below are the real front doors.
+
+## Links
+
+- Documentation: [dahrk.ai/docs](https://dahrk.ai/docs)
+- Issues: [github.com/dahrkai/dahrk-node/issues](https://github.com/dahrkai/dahrk-node/issues)
+- Edge client: [github.com/dahrkai/dahrk-node](https://github.com/dahrkai/dahrk-node)
+
+Apache-2.0, © Skakel Labs.

package/dist/batch-source.d.ts

@@ -0,0 +1,63 @@
+import type { BatchMember, BatchBlockEdge } from "@dahrk/contracts";
+/** An issue that `blocks` a child, as read from the child's `inverseRelations`. `stateType` decides
+ *  whether it has settled (terminal); `stateName` is carried for the decline note only, never matched. */
+export interface RawBlocker {
+    id?: string;
+    identifier?: string;
+    stateType?: string;
+    stateName?: string;
+}
+/** A child issue as returned by Linear before normalisation, with its state and blockers resolved. */
+export interface RawChild {
+    id?: string;
+    identifier?: string;
+    /** The child's workflow-state category (`state.type`); terminal children are dropped. */
+    stateType?: string;
+    /** Linear priority (`0` = none, `1` = urgent … `4` = low). */
+    priority?: number;
+    /** The child's rank within the parent (`subIssueSortOrder`, falling back to `sortOrder`). */
+    containerRank?: number;
+    /** The issues that `blocks` this child (its `inverseRelations` of type `blocks`). */
+    blockers: RawBlocker[];
+}
+/** The read seam the assembly depends on; the live impl wraps the SDK, tests inject a fake. */
+export interface ParentBatchSource {
+    /** The parent's direct children, each with its state and its `blocks` blockers, in any order. */
+    children(parentIssueId: string): Promise<RawChild[]>;
+}
+/** One unsettled blocker outside the selected source that prevents Batch creation. Shaped like the
+ *  hub's `OpenBlocker` so the decline note names it (`identifier` is the key; `stateName` is display). */
+export interface ExternalBlocker {
+    identifier: string;
+    stateName: string;
+}
+/** The normalised parent-Batch snapshot: the ordered members, the internal `blocks` edges between them,
+ *  and any external blocker that must block creation. */
+export interface ParentBatchSnapshot {
+    members: BatchMember[];
+    blocks: BatchBlockEdge[];
+    externalBlockers: ExternalBlocker[];
+}
+/** How many children ride one snapshot. A parent with more direct children than this is unusual; the
+ *  cap keeps the intake read bounded, mirroring the neighbours read in `issue-graph.ts`. */
+export declare const MAX_BATCH_CHILDREN = 200;
+/**
+ * Collect the parent's direct nonterminal children as a {@link ParentBatchSnapshot} from a source: drop
+ * children with no id/identifier; drop terminal (`completed`/`canceled`) children; classify each
+ * member's `blocks` blockers into internal edges (blocker is another member) or external blockers
+ * (blocker is outside the set and unsettled); order members by priority, then container rank, then
+ * identifier. Pure of any network.
+ */
+export declare function collectParentBatchSource(source: ParentBatchSource, parentIssueId: string): Promise<ParentBatchSnapshot>;
+/** The live `ParentBatchSource`, backed by a Linear bearer token. Uses the typed SDK: the parent's
+ *  `children`, each child's `state`/`priority`/`subIssueSortOrder`/`sortOrder`, and each child's
+ *  `inverseRelations` of type `blocks` resolved to `{id, identifier, state}`. Capped like the
+ *  neighbours read. */
+export declare function linearParentBatchSource(token: string): ParentBatchSource;
+/**
+ * Take the parent-Batch snapshot for `parentIssueId` as a {@link ParentBatchSnapshot}, ready for the
+ * hub to persist. The single entry point the hub calls (mirrors `fetchRelatedIssues`). A hard failure
+ * (auth, network) propagates so the caller can log and proceed.
+ */
+export declare function fetchParentBatchSource(token: string, parentIssueId: string): Promise<ParentBatchSnapshot>;
+//# sourceMappingURL=batch-source.d.ts.map

package/dist/batch-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-source.d.ts","sourceRoot":"","sources":["../src/batch-source.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGpE;0GAC0G;AAC1G,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sGAAsG;AACtG,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtD;AAED;0GAC0G;AAC1G,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;yDACyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAED;4FAC4F;AAC5F,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAQtC;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAyD9B;AAED;;;uBAGuB;AACvB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CA2CxE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/dist/batch-source.js

@@ -0,0 +1,149 @@
+/**
+ * Snapshot a parent control issue as a deterministic child-sourced Batch (DHK-1154; ADRs 0016-0017).
+ *
+ * Assigning or @mentioning Dahrk on a PARENT issue launches its direct child work as one immutable
+ * Batch. This module takes ONE credential-resolved read of the parent's direct, nonterminal children
+ * (the control issue itself is never included - children only) and normalises it into a
+ * {@link ParentBatchSnapshot}: an ordered list of {@link BatchMember}s keyed by stable issue UUID, the
+ * explicit `blocks` edges BETWEEN members ({@link BatchBlockEdge}), and any unsettled blocker OUTSIDE
+ * the member set that must block creation (`externalBlockers`).
+ *
+ * Two rules pin the dependency model:
+ *  - Containment is not a dependency. A parent/child relation NEVER produces an edge; only an explicit
+ *    Linear `blocks` relation does. Children carry only their own `blocks` blockers, so containment is
+ *    structurally incapable of creating one here.
+ *  - "External" is relative to the SELECTED source. A blocker that is itself another selected child is
+ *    an internal edge, not an external blocker, even when unsettled - that is a dependency to sequence,
+ *    not a refusal. The membership test runs before the external-blocker test.
+ *
+ * The `ParentBatchSource` seam keeps the assembly pure and unit-testable (the `collectRelatedIssues`
+ * pattern from `issue-graph.ts`): the live impl wraps the SDK, tests inject a fake.
+ */
+import { LinearClient } from "@linear/sdk";
+import { isBlockerSettled } from "./labels.js";
+/** How many children ride one snapshot. A parent with more direct children than this is unusual; the
+ *  cap keeps the intake read bounded, mirroring the neighbours read in `issue-graph.ts`. */
+export const MAX_BATCH_CHILDREN = 200;
+/** Sort key for priority: urgent (1) first, none (0) last. Linear priority is `0=none,1=urgent..4=low`,
+ *  so "order by priority" must map `0` to the end rather than the front. Pure, pinned by a test. */
+function priorityRank(priority) {
+    return priority === 0 ? Number.POSITIVE_INFINITY : priority;
+}
+/**
+ * Collect the parent's direct nonterminal children as a {@link ParentBatchSnapshot} from a source: drop
+ * children with no id/identifier; drop terminal (`completed`/`canceled`) children; classify each
+ * member's `blocks` blockers into internal edges (blocker is another member) or external blockers
+ * (blocker is outside the set and unsettled); order members by priority, then container rank, then
+ * identifier. Pure of any network.
+ */
+export async function collectParentBatchSource(source, parentIssueId) {
+    const raw = await source.children(parentIssueId);
+    // Keep only real, nonterminal children. A child needs a stable id AND a human identifier; a terminal
+    // child (settled state) is finished work, not something to launch.
+    const kept = [];
+    for (const c of raw) {
+        const id = c.id?.trim();
+        const identifier = c.identifier?.trim();
+        if (!id || !identifier)
+            continue;
+        if (isBlockerSettled(c.stateType))
+            continue;
+        kept.push(c);
+    }
+    const memberIds = new Set(kept.map((c) => c.id.trim()));
+    const members = kept.map((c) => ({
+        issueId: c.id.trim(),
+        issueIdentifier: c.identifier.trim(),
+        stateType: (c.stateType ?? "").trim() || "unknown",
+        priority: c.priority ?? 0,
+        containerRank: c.containerRank ?? 0,
+    }));
+    // Deterministic order: urgent priority first (none last), then container rank ascending, then the
+    // human identifier. Every downstream reader sees the same sequence, so admission is replayable.
+    members.sort((a, b) => priorityRank(a.priority) - priorityRank(b.priority) ||
+        a.containerRank - b.containerRank ||
+        a.issueIdentifier.localeCompare(b.issueIdentifier));
+    // Classify blockers in member order so edges and external blockers are deterministic. A blocker that
+    // is itself a selected member is an internal edge (a dependency to sequence); one outside the set that
+    // has not settled is an external blocker (a refusal); a settled external blocker is simply done.
+    const byId = new Map(kept.map((c) => [c.id.trim(), c]));
+    const blocks = [];
+    const externalBlockers = [];
+    const seenExternal = new Set();
+    for (const m of members) {
+        const c = byId.get(m.issueId);
+        for (const b of c.blockers) {
+            const blockerId = b.id?.trim();
+            if (blockerId && memberIds.has(blockerId)) {
+                blocks.push({ blockerIssueId: blockerId, blockedIssueId: m.issueId });
+                continue;
+            }
+            if (isBlockerSettled(b.stateType))
+                continue;
+            const identifier = (b.identifier ?? "").trim() || "unknown";
+            if (seenExternal.has(identifier))
+                continue;
+            seenExternal.add(identifier);
+            externalBlockers.push({ identifier, stateName: (b.stateName ?? "").trim() || "unknown" });
+        }
+    }
+    return { members, blocks, externalBlockers };
+}
+/** The live `ParentBatchSource`, backed by a Linear bearer token. Uses the typed SDK: the parent's
+ *  `children`, each child's `state`/`priority`/`subIssueSortOrder`/`sortOrder`, and each child's
+ *  `inverseRelations` of type `blocks` resolved to `{id, identifier, state}`. Capped like the
+ *  neighbours read. */
+export function linearParentBatchSource(token) {
+    const client = new LinearClient({ accessToken: token });
+    return {
+        async children(parentIssueId) {
+            const parent = await client.issue(parentIssueId);
+            const conn = await parent.children({ first: MAX_BATCH_CHILDREN });
+            const children = [];
+            for (const c of conn.nodes) {
+                const [state, inverse] = await Promise.all([
+                    c.state,
+                    // A `blocks` relation pointing AT the child means that issue is the child's blocker (the same
+                    // direction `fetchOpenBlockers` reads). `relations` would return what the child blocks - the
+                    // opposite question.
+                    c.inverseRelations({ first: 25 }),
+                ]);
+                const blockers = [];
+                for (const rel of inverse.nodes) {
+                    if (rel.type !== "blocks")
+                        continue;
+                    const other = await rel.issue;
+                    if (!other)
+                        continue;
+                    const bState = await other.state;
+                    blockers.push({
+                        ...(other.id ? { id: other.id } : {}),
+                        ...(other.identifier ? { identifier: other.identifier } : {}),
+                        ...(bState?.type ? { stateType: bState.type } : {}),
+                        ...(bState?.name ? { stateName: bState.name } : {}),
+                    });
+                }
+                // `subIssueSortOrder` is the rank within the parent; fall back to `sortOrder` when absent.
+                const containerRank = c.subIssueSortOrder ?? c.sortOrder ?? 0;
+                children.push({
+                    ...(c.id ? { id: c.id } : {}),
+                    ...(c.identifier ? { identifier: c.identifier } : {}),
+                    ...(state?.type ? { stateType: state.type } : {}),
+                    ...(typeof c.priority === "number" ? { priority: c.priority } : {}),
+                    containerRank,
+                    blockers,
+                });
+            }
+            return children;
+        },
+    };
+}
+/**
+ * Take the parent-Batch snapshot for `parentIssueId` as a {@link ParentBatchSnapshot}, ready for the
+ * hub to persist. The single entry point the hub calls (mirrors `fetchRelatedIssues`). A hard failure
+ * (auth, network) propagates so the caller can log and proceed.
+ */
+export async function fetchParentBatchSource(token, parentIssueId) {
+    return collectParentBatchSource(linearParentBatchSource(token), parentIssueId);
+}
+//# sourceMappingURL=batch-source.js.map

package/dist/batch-source.js.map

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

package/dist/comments.d.ts

@@ -0,0 +1,36 @@
+import type { IssueComment } from "@dahrk/contracts";
+/** A comment as returned by Linear before normalisation. */
+export interface RawComment {
+    id: string;
+    body?: string;
+    createdAt?: Date | string;
+    /** Author user id, compared against the app user id to drop the harness's own posts. */
+    authorId?: string;
+    /** Author display name, surfaced to the agent. */
+    authorName?: string;
+}
+/** The read seam the assembly depends on; the live impl wraps GraphQL, tests inject a fake. */
+export interface CommentSource {
+    /** The issue's comments, in whatever order Linear returns them. */
+    issueComments(issueId: string): Promise<RawComment[]>;
+    /** The id of the app user this token authenticates as, or null when it cannot be resolved. */
+    appUserId(): Promise<string | null>;
+}
+/**
+ * Collect an issue's comments from a source: drop the app user's own posts, drop empty bodies, and
+ * order oldest first so the thread reads as a conversation. Pure of any network - the source does the
+ * I/O.
+ *
+ * Comments with no resolvable timestamp sort last rather than being dropped: an unorderable comment is
+ * still content worth showing, and losing it silently would be worse than showing it out of order.
+ */
+export declare function collectIssueComments(source: CommentSource, issueId: string): Promise<IssueComment[]>;
+/** The live `CommentSource`, backed by a Linear bearer token. Uses the typed SDK. */
+export declare function linearCommentSource(token: string): CommentSource;
+/**
+ * Fetch an issue's comment thread as contract `IssueComment`s, ready to snapshot into a run. The
+ * single entry point the hub calls. A hard failure (auth, network) propagates so the caller can log
+ * and proceed with none.
+ */
+export declare function fetchIssueComments(token: string, issueId: string): Promise<IssueComment[]>;
+//# sourceMappingURL=comments.d.ts.map

package/dist/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACtD,8FAA8F;IAC9F,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrC;AAYD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBzB;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAqChE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAEhG"}

package/dist/comments.js

@@ -0,0 +1,104 @@
+/**
+ * Fetch the comment thread on a Linear issue, so the hub can snapshot it into a run and surface it to
+ * the agent. Until now nothing in the harness read comment bodies at all: an agent saw only whatever
+ * Linear happened to inline in the webhook's `promptContext`, so the conversation that actually
+ * decided the shape of a ticket was invisible to the stage doing the work.
+ *
+ * The one piece of logic that is not a plain read: the app user's OWN comments are dropped. The
+ * harness posts its stage summaries back through `commentOnIssue`, so without this filter every stage
+ * would read the previous stage's summary as though a human had written it - the run talking to itself,
+ * with the noise compounding on each continuation.
+ *
+ * The `CommentSource` seam keeps the assembly pure and unit-testable: the live source
+ * (`linearCommentSource`) speaks GraphQL, while tests inject a fake.
+ */
+import { LinearClient } from "@linear/sdk";
+/** Normalise a timestamp Linear may hand back as a Date or a string into ISO 8601. */
+function isoOf(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "string" && value.trim()) {
+        const parsed = new Date(value);
+        return Number.isNaN(parsed.getTime()) ? "" : parsed.toISOString();
+    }
+    return "";
+}
+/**
+ * Collect an issue's comments from a source: drop the app user's own posts, drop empty bodies, and
+ * order oldest first so the thread reads as a conversation. Pure of any network - the source does the
+ * I/O.
+ *
+ * Comments with no resolvable timestamp sort last rather than being dropped: an unorderable comment is
+ * still content worth showing, and losing it silently would be worse than showing it out of order.
+ */
+export async function collectIssueComments(source, issueId) {
+    const [raw, appUserId] = await Promise.all([source.issueComments(issueId), source.appUserId()]);
+    const out = [];
+    for (const comment of raw) {
+        if (appUserId && comment.authorId === appUserId)
+            continue;
+        const body = (comment.body ?? "").trim();
+        if (!body)
+            continue;
+        out.push({
+            id: comment.id,
+            author: (comment.authorName ?? "").trim(),
+            createdAt: isoOf(comment.createdAt),
+            body,
+        });
+    }
+    return out.sort((a, b) => {
+        if (!a.createdAt)
+            return 1;
+        if (!b.createdAt)
+            return -1;
+        return a.createdAt.localeCompare(b.createdAt);
+    });
+}
+/** The live `CommentSource`, backed by a Linear bearer token. Uses the typed SDK. */
+export function linearCommentSource(token) {
+    const client = new LinearClient({ accessToken: token });
+    return {
+        async issueComments(issueId) {
+            // Bounded, unpaginated cap, matching `linearDocumentSource.issueDocuments`: a thread longer than
+            // 100 comments silently drops the overflow. Deliberate, not a bug - the prompt inlines only the
+            // most recent few thousand characters anyway. Revisit with cursor pagination if it bites.
+            const issue = await client.issue(issueId);
+            const conn = await issue.comments({ first: 100 });
+            const nodes = await Promise.all(conn.nodes.map(async (c) => {
+                // `user` is a lazy reference on the SDK's Comment; resolving it per comment is what lets us
+                // both filter the app user's posts and name the human author. A comment whose author does not
+                // resolve (a deleted user, an integration post) still rides through, unattributed.
+                const user = await c.user;
+                return {
+                    id: c.id,
+                    body: c.body,
+                    createdAt: c.createdAt,
+                    ...(user?.id ? { authorId: user.id } : {}),
+                    ...(user?.displayName || user?.name ? { authorName: user.displayName ?? user.name } : {}),
+                };
+            }));
+            return nodes;
+        },
+        async appUserId() {
+            try {
+                const viewer = await client.viewer;
+                return viewer?.id ?? null;
+            }
+            catch {
+                // Failing to resolve the app user must not lose the thread. We return null and accept that the
+                // harness's own comments ride through this once, rather than dropping every comment.
+                return null;
+            }
+        },
+    };
+}
+/**
+ * Fetch an issue's comment thread as contract `IssueComment`s, ready to snapshot into a run. The
+ * single entry point the hub calls. A hard failure (auth, network) propagates so the caller can log
+ * and proceed with none.
+ */
+export async function fetchIssueComments(token, issueId) {
+    return collectIssueComments(linearCommentSource(token), issueId);
+}
+//# sourceMappingURL=comments.js.map

package/dist/comments.js.map

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

package/dist/documents.d.ts

@@ -1,17 +1,3 @@
-/**
- * Fetch the Linear Documents attached to an issue, so the hub can snapshot their content into a run
- * and surface it to the agent (the harness was webhook-payload-only before, so a document reached the
- * agent only as a URL, never as content). This is a read against the same per-connection Linear token
- * the hub already uses to post back; fetching content is data assembly, not control flow.
- *
- * Two sources, de-duped by document id:
- *  1. Documents directly associated with the issue (`issue.documents`).
- *  2. Documents linked via the issue's attachments whose `url` is a Linear document URL
- *     (`https://linear.app/<ws>/document/<...>-<slug>`), resolved through `document(id:)`.
- *
- * The `DocumentSource` seam keeps the assembly pure and unit-testable: the live source
- * (`linearDocumentSource`) speaks GraphQL, while tests inject a fake.
- */
 import type { AttachedDocument } from "@dahrk/contracts";
 /** A document as returned by Linear before slug normalisation (slugId is Linear's URL-safe slug). */
 export interface RawDocument {
@@ -44,7 +30,7 @@ export declare function documentSlug(doc: RawDocument): string;
  * attachment whose document does not resolve is skipped, never fatal.
  */
 export declare function collectAttachedDocuments(source: DocumentSource, issueId: string): Promise<AttachedDocument[]>;
-/** The live `DocumentSource`, backed by a Linear bearer token. Plain fetch, no SDK. */
+/** The live `DocumentSource`, backed by a Linear bearer token. Uses the typed SDK. */
 export declare function linearDocumentSource(token: string): DocumentSource;
 /**
  * Fetch the documents attached to a Linear issue as contract `AttachedDocument`s, ready to snapshot

package/dist/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,4FAA4F;IAC5F,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,+FAA+F;IAC/F,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC3D;AAED;;;+FAG+F;AAC/F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9D;AAED;0FAC0F;AAC1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAQrD;AAeD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuB7B;AAqBD,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAgClE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,4FAA4F;IAC5F,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,+FAA+F;IAC/F,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC3D;AAED;;;+FAG+F;AAC/F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9D;AAED;0FAC0F;AAC1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAQrD;AAeD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuB7B;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAiClE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}

package/dist/documents.js

@@ -1,4 +1,18 @@
-const GRAPHQL_URL = "https://api.linear.app/graphql";
+/**
+ * Fetch the Linear Documents attached to an issue, so the hub can snapshot their content into a run
+ * and surface it to the agent (the harness was webhook-payload-only before, so a document reached the
+ * agent only as a URL, never as content). This is a read against the same per-connection Linear token
+ * the hub already uses to post back; fetching content is data assembly, not control flow.
+ *
+ * Two sources, de-duped by document id:
+ *  1. Documents directly associated with the issue (`issue.documents`).
+ *  2. Documents linked via the issue's attachments whose `url` is a Linear document URL
+ *     (`https://linear.app/<ws>/document/<...>-<slug>`), resolved through `document(id:)`.
+ *
+ * The `DocumentSource` seam keeps the assembly pure and unit-testable: the live source
+ * (`linearDocumentSource`) speaks GraphQL, while tests inject a fake.
+ */
+import { LinearClient } from "@linear/sdk";
 /** The Linear-document slug from an attachment URL, or null when the URL is not a Linear document
  *  link. Linear document URLs look like `https://linear.app/<ws>/document/<title-slug>-<slugId>`;
  *  the canonical slug Linear's `document(id:)` accepts is the trailing token (the slugId), which is
@@ -76,42 +90,38 @@ export async function collectAttachedDocuments(source, issueId) {
     }
     return out;
 }
-/** Run one GraphQL query against Linear with a bearer token; throws on transport or GraphQL errors. */
-async function gql(token, query, variables) {
-    const res = await fetch(GRAPHQL_URL, {
-        method: "POST",
-        headers: { "content-type": "application/json", authorization: token },
-        body: JSON.stringify({ query, variables }),
-    });
-    if (!res.ok)
-        throw new Error(`linear graphql ${res.status}`);
-    const json = (await res.json().catch(() => ({})));
-    if (json.errors?.length)
-        throw new Error(json.errors.map((e) => e.message).join("; "));
-    if (!json.data)
-        throw new Error("linear graphql: empty response");
-    return json.data;
-}
-const DOC_FIELDS = "id slugId title url content";
-/** The live `DocumentSource`, backed by a Linear bearer token. Plain fetch, no SDK. */
+/** The live `DocumentSource`, backed by a Linear bearer token. Uses the typed SDK. */
 export function linearDocumentSource(token) {
+    const client = new LinearClient({ accessToken: token });
     return {
         async issueDocuments(issueId) {
             // Bounded, unpaginated cap: an issue with more than 50 attached documents (or 100 attachments
             // below) silently drops the overflow. That is a deliberate limit, not a bug; revisit with cursor
             // pagination if real issues approach it.
-            const data = await gql(token, `query($id: String!){ issue(id:$id){ documents(first:50){ nodes{ ${DOC_FIELDS} } } } }`, { id: issueId });
-            return data.issue?.documents?.nodes ?? [];
+            const issue = await client.issue(issueId);
+            const conn = await issue.documents({ first: 50 });
+            return conn.nodes.map((d) => ({
+                id: d.id,
+                slugId: d.slugId,
+                title: d.title,
+                url: d.url,
+                content: d.content ?? undefined,
+            }));
         },
         async issueAttachmentUrls(issueId) {
-            const data = await gql(token, `query($id: String!){ issue(id:$id){ attachments(first:100){ nodes{ url } } } }`, { id: issueId });
-            return (data.issue?.attachments?.nodes ?? [])
-                .map((a) => a.url)
-                .filter((u) => typeof u === "string" && u.length > 0);
+            const issue = await client.issue(issueId);
+            const conn = await issue.attachments({ first: 100 });
+            return conn.nodes.map((a) => a.url).filter((u) => u.length > 0);
         },
         async documentBySlug(slug) {
-            const data = await gql(token, `query($id: String!){ document(id:$id){ ${DOC_FIELDS} } }`, { id: slug });
-            return data.document ?? null;
+            const doc = await client.document(slug);
+            return {
+                id: doc.id,
+                slugId: doc.slugId,
+                title: doc.title,
+                url: doc.url,
+                content: doc.content ?? undefined,
+            };
         },
     };
 }

package/dist/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsB3C;;;+FAG+F;AAC/F,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,6FAA6F;IAC7F,kGAAkG;IAClG,+EAA+E;IAC/E,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpF,CAAC;AAED;0FAC0F;AAC1F,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;SAChC,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,SAAS,IAAI,GAAG,CAAC,EAAE,CAAC;AAC7B,CAAC;AAED,6FAA6F;AAC7F,SAAS,UAAU,CAAC,GAAgB;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC;QACvB,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,mBAAmB;QACtD,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;QAClB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAsB,EACtB,OAAe;IAEf,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,GAAuB,EAAQ,EAAE;QAC5C,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAEjE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IACjG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO;QACL,KAAK,CAAC,cAAc,CAAC,OAAO;YAC1B,8FAA8F;YAC9F,iGAAiG;YACjG,yCAAyC;YACzC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS;aAChC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,OAAO;YAC/B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,IAAI;YACvB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO;gBACL,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;aAClC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAa,EACb,OAAe;IAEf,OAAO,wBAAwB,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}

package/dist/format-action.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Format a tool call into Linear's action-activity vocabulary (DHK-382): a human verb in
+ * `action` and a clean, humanised input in `parameter`. Linear renders these as
+ * "<action> · <parameter>" (e.g. "Ran · grep -rn ..."), so the agent session reads as a
+ * sequence of verbs instead of a wall of `ToolName {raw JSON args}`.
+ *
+ * `inputText` is the edge's bounded preview of the tool input: normally a JSON object string
+ * (`clip(JSON.stringify(input))`), but it may be TRUNCATED (over the edge's ~500-char cap) or
+ * otherwise malformed. Parsing is defensive: a preview that will not parse never throws and
+ * never falls through to raw JSON. Known single-field tools still salvage their primary field
+ * from a truncated preview; anything unrecoverable degrades to the bare verb.
+ */
+/** A tool call rendered as Linear's `{ action, parameter }` pair. */
+export interface ToolAction {
+    action: string;
+    parameter: string;
+}
+/**
+ * Map a `(toolName, inputPreview)` pair to a verb plus a clean parameter. Total and defensive:
+ * every branch returns a `{ action, parameter }`, and the parameter is only ever a humanised
+ * field value (never the raw JSON), so a malformed or oversized preview degrades to the bare verb.
+ */
+export declare function formatToolAction(tool: string | undefined, inputText: string | undefined): ToolAction;
+export declare function formatToolResult(tool: string | undefined, output: string | undefined): string;
+//# sourceMappingURL=format-action.d.ts.map

package/dist/format-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-action.d.ts","sourceRoot":"","sources":["../src/format-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AA2FD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAgDpG;AAkGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAmB7F"}