@knpkv/jira-cli 0.1.1

package/dist/internal/frontmatter.js

@@ -0,0 +1,130 @@
+/**
+ * YAML frontmatter serialization for Jira issues using `gray-matter`.
+ *
+ * **Mental model**
+ *
+ * - {@link serializeIssue} produces `---\nyaml\n---\nmarkdown` for a single issue.
+ * - {@link buildCombinedMarkdown} concatenates all issues with a JQL header for single-file export.
+ *
+ * @internal
+ */
+import matter from "gray-matter";
+/**
+ * Extract front-matter data from an issue.
+ *
+ * @param issue - The issue to extract from
+ * @returns Front-matter object
+ *
+ * @category Utilities
+ */
+export const extractFrontMatter = (issue) => ({
+    key: issue.key,
+    id: issue.id,
+    summary: issue.summary,
+    status: issue.status,
+    type: issue.type,
+    priority: issue.priority,
+    assignee: issue.assignee,
+    reporter: issue.reporter,
+    created: issue.created.toISOString(),
+    updated: issue.updated.toISOString(),
+    fixVersions: issue.fixVersions,
+    labels: issue.labels,
+    components: issue.components,
+    url: issue.url
+});
+/**
+ * Serialize an issue to markdown with front-matter.
+ *
+ * @param issue - The issue to serialize
+ * @returns Markdown string with YAML front-matter
+ *
+ * @category Serialization
+ */
+export const serializeIssue = (issue) => {
+    const frontMatter = extractFrontMatter(issue);
+    const content = buildMarkdownContent(issue);
+    return matter.stringify(content, frontMatter);
+};
+/**
+ * Build markdown content for an issue (without front-matter).
+ *
+ * @param issue - The issue to build content for
+ * @returns Markdown content string
+ *
+ * @category Serialization
+ */
+export const buildMarkdownContent = (issue) => {
+    const parts = [];
+    // Title
+    parts.push(`# ${issue.key}: ${issue.summary}`);
+    parts.push("");
+    // Description
+    if (issue.description) {
+        parts.push("## Description");
+        parts.push("");
+        parts.push(issue.description);
+        parts.push("");
+    }
+    // Attachments
+    if (issue.attachments.length > 0) {
+        parts.push("## Attachments");
+        parts.push("");
+        for (const attachment of issue.attachments) {
+            parts.push(`- [${attachment.filename}](${attachment.url})`);
+        }
+        parts.push("");
+    }
+    // Comments
+    if (issue.comments.length > 0) {
+        parts.push("## Comments");
+        parts.push("");
+        for (const comment of issue.comments) {
+            const date = comment.created.toISOString().split("T")[0];
+            parts.push(`### ${comment.author} (${date})`);
+            parts.push("");
+            parts.push(comment.body);
+            parts.push("");
+        }
+    }
+    return parts.join("\n");
+};
+/**
+ * Build a combined markdown file for multiple issues.
+ *
+ * @param issues - The issues to include
+ * @param jql - The JQL query used (for header)
+ * @returns Combined markdown string
+ *
+ * @category Serialization
+ */
+export const buildCombinedMarkdown = (issues, jql) => {
+    const parts = [];
+    // Header
+    parts.push("# Jira Export");
+    parts.push("");
+    parts.push(`Query: \`${jql}\``);
+    parts.push(`Exported: ${new Date().toISOString()}`);
+    parts.push(`Total: ${issues.length} tickets`);
+    parts.push("");
+    parts.push("---");
+    parts.push("");
+    // Issues
+    for (const issue of issues) {
+        parts.push(`## ${issue.key}: ${issue.summary}`);
+        parts.push("");
+        parts.push(`**Status:** ${issue.status} | **Type:** ${issue.type}${issue.priority ? ` | **Priority:** ${issue.priority}` : ""}`);
+        if (issue.assignee) {
+            parts.push(`**Assignee:** ${issue.assignee}`);
+        }
+        parts.push("");
+        if (issue.description) {
+            parts.push(issue.description);
+            parts.push("");
+        }
+        parts.push("---");
+        parts.push("");
+    }
+    return parts.join("\n");
+};
+//# sourceMappingURL=frontmatter.js.map

package/dist/internal/frontmatter.js.map

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

package/dist/internal/jqlBuilder.d.ts

@@ -0,0 +1,39 @@
+/**
+ * JQL query construction with proper value escaping.
+ *
+ * **Mental model**
+ *
+ * - {@link buildByVersionJql} generates `fixVersion = "X"` queries with optional project filter.
+ * - {@link escapeJqlValue} handles backslashes, quotes, newlines, carriage returns.
+ *
+ * @internal
+ */
+/**
+ * Build JQL query to find issues by fix version.
+ *
+ * @param version - The fix version to search for
+ * @param project - Optional project key to filter by
+ * @returns JQL query string
+ *
+ * @example
+ * ```typescript
+ * buildByVersionJql("1.0.0")
+ * // => 'fixVersion = "1.0.0" ORDER BY key ASC'
+ *
+ * buildByVersionJql("1.0.0", "PROJ")
+ * // => 'project = "PROJ" AND fixVersion = "1.0.0" ORDER BY key ASC'
+ * ```
+ *
+ * @category JQL Builders
+ */
+export declare const buildByVersionJql: (version: string, project?: string) => string;
+/**
+ * Escape a value for use in JQL queries.
+ *
+ * @param value - The value to escape
+ * @returns Escaped value safe for JQL
+ *
+ * @category Utilities
+ */
+export declare const escapeJqlValue: (value: string) => string;
+//# sourceMappingURL=jqlBuilder.d.ts.map

package/dist/internal/jqlBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jqlBuilder.d.ts","sourceRoot":"","sources":["../../src/internal/jqlBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,MAIrE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAKrB,CAAA"}

package/dist/internal/jqlBuilder.js

@@ -0,0 +1,47 @@
+/**
+ * JQL query construction with proper value escaping.
+ *
+ * **Mental model**
+ *
+ * - {@link buildByVersionJql} generates `fixVersion = "X"` queries with optional project filter.
+ * - {@link escapeJqlValue} handles backslashes, quotes, newlines, carriage returns.
+ *
+ * @internal
+ */
+/**
+ * Build JQL query to find issues by fix version.
+ *
+ * @param version - The fix version to search for
+ * @param project - Optional project key to filter by
+ * @returns JQL query string
+ *
+ * @example
+ * ```typescript
+ * buildByVersionJql("1.0.0")
+ * // => 'fixVersion = "1.0.0" ORDER BY key ASC'
+ *
+ * buildByVersionJql("1.0.0", "PROJ")
+ * // => 'project = "PROJ" AND fixVersion = "1.0.0" ORDER BY key ASC'
+ * ```
+ *
+ * @category JQL Builders
+ */
+export const buildByVersionJql = (version, project) => {
+    const escapedVersion = escapeJqlValue(version);
+    const projectClause = project !== undefined ? `project = "${escapeJqlValue(project)}" AND ` : "";
+    return `${projectClause}fixVersion = "${escapedVersion}" ORDER BY key ASC`;
+};
+/**
+ * Escape a value for use in JQL queries.
+ *
+ * @param value - The value to escape
+ * @returns Escaped value safe for JQL
+ *
+ * @category Utilities
+ */
+export const escapeJqlValue = (value) => value
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, "\\\"")
+    .replace(/\n/g, "\\n")
+    .replace(/\r/g, "\\r");
+//# sourceMappingURL=jqlBuilder.js.map

package/dist/internal/jqlBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jqlBuilder.js","sourceRoot":"","sources":["../../src/internal/jqlBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,OAAgB,EAAU,EAAE;IAC7E,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAC9C,MAAM,aAAa,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;IAChG,OAAO,GAAG,aAAa,iBAAiB,cAAc,oBAAoB,CAAA;AAC5E,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CACtD,KAAK;KACF,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;KACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;KACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;KACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA"}

package/dist/internal/oauthServer.d.ts

@@ -0,0 +1,55 @@
+import * as HttpServer from "@effect/platform/HttpServer";
+import type { ServeError } from "@effect/platform/HttpServerError";
+import { OAuthError } from "@knpkv/atlassian-common/auth";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+/**
+ * Factory service for creating HTTP servers.
+ * This allows mocking the server creation in tests.
+ *
+ * @category Services
+ */
+export interface HttpServerFactory {
+    readonly createServerLayer: (port: number) => Layer.Layer<HttpServer.HttpServer, ServeError, never>;
+}
+declare const HttpServerFactoryTag_base: Context.TagClass<HttpServerFactoryTag, "@knpkv/jira-cli/HttpServerFactory", HttpServerFactory>;
+/**
+ * Tag for the HttpServerFactory service.
+ *
+ * @category Services
+ */
+export declare class HttpServerFactoryTag extends HttpServerFactoryTag_base {
+}
+/**
+ * Create a HttpServerFactory layer from a layer factory function.
+ * This allows injecting platform-specific implementations.
+ *
+ * @param createLayerFn - Function that creates HttpServer layer for a given port
+ * @returns Layer providing HttpServerFactory
+ *
+ * @category Layers
+ */
+export declare const makeHttpServerFactory: (createLayerFn: (port: number) => Layer.Layer<HttpServer.HttpServer, ServeError, never>) => Layer.Layer<HttpServerFactoryTag>;
+/**
+ * Result from the OAuth callback server.
+ */
+export interface CallbackServerResult {
+    /** Promise that resolves with the authorization code */
+    readonly codePromise: Effect.Effect<string, OAuthError>;
+    /** Shutdown the callback server */
+    readonly shutdown: Effect.Effect<void, never>;
+    /** The port the server is listening on */
+    readonly port: number;
+}
+/**
+ * Start a local HTTP server to receive OAuth callback.
+ *
+ * @param expectedState - The state parameter to verify against CSRF
+ * @returns Server control interface with code promise, shutdown, and port
+ *
+ * @category OAuth
+ */
+export declare const startCallbackServer: (expectedState: string) => Effect.Effect<CallbackServerResult, OAuthError, HttpServerFactoryTag>;
+export {};
+//# sourceMappingURL=oauthServer.d.ts.map

package/dist/internal/oauthServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthServer.d.ts","sourceRoot":"","sources":["../../src/internal/oauthServer.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAKrC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,KAAK,CACvD,UAAU,CAAC,UAAU,EACrB,UAAU,EACV,KAAK,CACN,CAAA;CACF;;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,yBAGvC;CAAG;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,KACrF,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAG/B,CAAA;AAwCJ;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACvD,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,eAAe,MAAM,KACpB,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,CA2EnE,CAAA"}

package/dist/internal/oauthServer.js

@@ -0,0 +1,113 @@
+/**
+ * Local HTTP callback server for OAuth2 authorization code capture.
+ *
+ * **Mental model**
+ *
+ * - **Deferred-coordinated lifecycle**: {@link startCallbackServer} returns a `codePromise`
+ *   (Deferred) and a `shutdown` effect. The server validates the CSRF `state` parameter
+ *   and resolves the Deferred with the authorization code.
+ * - **Port auto-discovery**: Tries default port 8585, increments on conflict.
+ *
+ * @internal
+ */
+import * as HttpRouter from "@effect/platform/HttpRouter";
+import * as HttpServer from "@effect/platform/HttpServer";
+import * as HttpServerRequest from "@effect/platform/HttpServerRequest";
+import * as HttpServerResponse from "@effect/platform/HttpServerResponse";
+import { OAuthError } from "@knpkv/atlassian-common/auth";
+import * as Context from "effect/Context";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+const DEFAULT_PORT = 8585;
+const MAX_PORT_ATTEMPTS = 10;
+/**
+ * Tag for the HttpServerFactory service.
+ *
+ * @category Services
+ */
+export class HttpServerFactoryTag extends Context.Tag("@knpkv/jira-cli/HttpServerFactory")() {
+}
+/**
+ * Create a HttpServerFactory layer from a layer factory function.
+ * This allows injecting platform-specific implementations.
+ *
+ * @param createLayerFn - Function that creates HttpServer layer for a given port
+ * @returns Layer providing HttpServerFactory
+ *
+ * @category Layers
+ */
+export const makeHttpServerFactory = (createLayerFn) => Layer.succeed(HttpServerFactoryTag, {
+    createServerLayer: createLayerFn
+});
+/**
+ * Check if a port is available by attempting to start a server.
+ */
+const isPortAvailable = (port) => Effect.gen(function* () {
+    const factory = yield* HttpServerFactoryTag;
+    const serverLayer = factory.createServerLayer(port);
+    const result = yield* Layer.build(serverLayer).pipe(Effect.scoped, Effect.as(true), Effect.catchAll(() => Effect.succeed(false)));
+    return result;
+});
+/**
+ * Find an available port starting from the default.
+ */
+const findAvailablePort = () => Effect.gen(function* () {
+    for (let attempt = 0; attempt < MAX_PORT_ATTEMPTS; attempt++) {
+        const port = DEFAULT_PORT + attempt;
+        const available = yield* isPortAvailable(port);
+        if (available) {
+            return port;
+        }
+    }
+    return yield* Effect.fail(new OAuthError({
+        step: "authorize",
+        cause: `Could not find available port (tried ${DEFAULT_PORT}-${DEFAULT_PORT + MAX_PORT_ATTEMPTS - 1}). Close other applications using these ports.`
+    }));
+});
+/**
+ * Start a local HTTP server to receive OAuth callback.
+ *
+ * @param expectedState - The state parameter to verify against CSRF
+ * @returns Server control interface with code promise, shutdown, and port
+ *
+ * @category OAuth
+ */
+export const startCallbackServer = (expectedState) => Effect.gen(function* () {
+    const factory = yield* HttpServerFactoryTag;
+    const port = yield* findAvailablePort();
+    const deferred = yield* Deferred.make();
+    const readyDeferred = yield* Deferred.make();
+    const app = HttpRouter.empty.pipe(HttpRouter.get("/callback", Effect.gen(function* () {
+        const req = yield* HttpServerRequest.HttpServerRequest;
+        const url = new URL(req.url, `http://localhost:${port}`);
+        const code = url.searchParams.get("code");
+        const state = url.searchParams.get("state");
+        const error = url.searchParams.get("error");
+        const errorDescription = url.searchParams.get("error_description");
+        if (error) {
+            yield* Deferred.fail(deferred, new OAuthError({ step: "authorize", cause: errorDescription ?? error }));
+            return HttpServerResponse.html("<html><body><h1>Authorization Failed</h1><p>You can close this window.</p></body></html>");
+        }
+        if (state !== expectedState) {
+            yield* Deferred.fail(deferred, new OAuthError({ step: "authorize", cause: "State mismatch - possible CSRF attack" }));
+            return HttpServerResponse.html("<html><body><h1>Security Error</h1><p>State verification failed.</p></body></html>");
+        }
+        if (!code) {
+            yield* Deferred.fail(deferred, new OAuthError({ step: "authorize", cause: "No authorization code received" }));
+            return HttpServerResponse.html("<html><body><h1>Error</h1><p>No authorization code received.</p></body></html>");
+        }
+        yield* Deferred.succeed(deferred, code);
+        return HttpServerResponse.html("<html><body><h1>Success!</h1><p>You can close this window and return to the terminal.</p></body></html>");
+    })));
+    const serverLayer = factory.createServerLayer(port);
+    const serverFiber = yield* HttpServer.serve(app).pipe(Layer.provide(serverLayer), Layer.build, Effect.tap(() => Deferred.succeed(readyDeferred, undefined)), Effect.tapError((err) => Deferred.fail(readyDeferred, new OAuthError({ step: "authorize", cause: err }))), Effect.flatMap(() => Effect.never), Effect.scoped, Effect.fork);
+    yield* Deferred.await(readyDeferred);
+    return {
+        codePromise: Deferred.await(deferred),
+        shutdown: Fiber.interrupt(serverFiber).pipe(Effect.asVoid),
+        port
+    };
+});
+//# sourceMappingURL=oauthServer.js.map

package/dist/internal/oauthServer.js.map

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

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@knpkv/jira-cli",
+  "version": "0.1.1",
+  "description": "CLI tool to fetch Jira tickets and export to markdown",
+  "license": "MIT",
+  "author": "knpkv",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/knpkv/npm.git",
+    "directory": "packages/jira-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/knpkv/npm/issues"
+  },
+  "homepage": "https://github.com/knpkv/npm/tree/main/packages/jira-cli#readme",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "jira": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./JiraAuth": {
+      "import": "./dist/JiraAuth.js",
+      "types": "./dist/JiraAuth.d.ts"
+    },
+    "./IssueService": {
+      "import": "./dist/IssueService.js",
+      "types": "./dist/IssueService.d.ts"
+    },
+    "./MarkdownWriter": {
+      "import": "./dist/MarkdownWriter.js",
+      "types": "./dist/MarkdownWriter.d.ts"
+    },
+    "./JiraCliError": {
+      "import": "./dist/JiraCliError.js",
+      "types": "./dist/JiraCliError.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@effect/platform": ">=0.93.0 <0.96.0",
+    "effect": ">=3.19.3"
+  },
+  "dependencies": {
+    "@effect/cli": "latest",
+    "@effect/platform-node": "latest",
+    "gray-matter": "^4.0.3",
+    "@knpkv/atlassian-common": "0.2.0",
+    "@knpkv/jira-api-client": "0.2.0"
+  },
+  "devDependencies": {
+    "@effect/platform": "latest",
+    "@effect/vitest": "latest",
+    "@types/node": "latest",
+    "effect": "latest",
+    "typescript": "~5.9.0",
+    "vitest": "^4.0.13"
+  },
+  "keywords": [
+    "effect",
+    "effect-ts",
+    "jira",
+    "markdown",
+    "cli",
+    "atlassian",
+    "tickets",
+    "export"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist dist-test .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "check": "tsc --noEmit"
+  }
+}