@knpkv/jira-cli 0.1.1 → 1.0.0

package/dist/internal/sync/schemas.js

@@ -0,0 +1,82 @@
+/**
+ * Runtime schemas for Jira Markdown Sync local workspace files.
+ *
+ * @internal
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { FIELD_SHAPES } from "./types.js";
+const SiteUrl = Schema.String.pipe(Schema.check(Schema.isPattern(/^https:\/\/[a-z0-9][a-z0-9-]*\.atlassian\.net$/)));
+const NonEmptyString = Schema.String.pipe(Schema.check(Schema.isMinLength(1)));
+export const FieldShapeSchema = Schema.Literals(FIELD_SHAPES);
+export const RequestedCustomFieldSchema = Schema.Struct({
+    displayName: NonEmptyString,
+    fieldId: Schema.optional(NonEmptyString),
+    shape: FieldShapeSchema,
+    ordered: Schema.optional(Schema.Boolean)
+});
+export const WorkspaceConfigSchema = Schema.Struct({
+    version: Schema.Literal(1).pipe(Schema.withDecodingDefaultTypeKey(Effect.succeed(1))),
+    siteUrl: SiteUrl,
+    documentsDir: NonEmptyString.pipe(Schema.withDecodingDefaultTypeKey(Effect.succeed("issues"))),
+    customFields: Schema.Array(RequestedCustomFieldSchema).pipe(Schema.withDecodingDefaultTypeKey(Effect.succeed([])))
+});
+export const ManifestIssueSchema = Schema.Struct({
+    issueId: NonEmptyString,
+    issueKey: NonEmptyString,
+    documentPath: NonEmptyString,
+    filenameMode: Schema.Literals(["convention", "custom"])
+});
+export const SyncManifestSchema = Schema.Struct({
+    version: Schema.Literal(1),
+    siteUrl: SiteUrl,
+    issues: Schema.Array(ManifestIssueSchema)
+});
+const UserFieldValueSchema = Schema.Struct({
+    accountId: NonEmptyString,
+    displayName: NonEmptyString
+});
+const OptionFieldValueSchema = Schema.Struct({
+    id: Schema.optional(NonEmptyString),
+    value: NonEmptyString
+});
+const CascadingFieldValueSchema = Schema.Struct({
+    parent: OptionFieldValueSchema,
+    child: Schema.optional(OptionFieldValueSchema)
+});
+const SyncFieldValueItemSchema = Schema.Union([
+    Schema.String,
+    Schema.Number,
+    Schema.Boolean,
+    UserFieldValueSchema,
+    OptionFieldValueSchema
+]);
+export const SyncFieldValueSchema = Schema.Union([
+    Schema.String,
+    Schema.Number,
+    Schema.Boolean,
+    Schema.Null,
+    UserFieldValueSchema,
+    OptionFieldValueSchema,
+    CascadingFieldValueSchema,
+    Schema.Array(SyncFieldValueItemSchema)
+]);
+export const BaselineCustomFieldSchema = Schema.Struct({
+    fieldId: NonEmptyString,
+    displayName: NonEmptyString,
+    shape: FieldShapeSchema,
+    value: SyncFieldValueSchema
+});
+export const SyncBaselineSchema = Schema.Struct({
+    version: Schema.Literal(1),
+    issueId: NonEmptyString,
+    issueKey: NonEmptyString,
+    fields: Schema.Struct({
+        summary: Schema.String,
+        description: Schema.String,
+        labels: Schema.Array(Schema.String),
+        customFields: Schema.Record(Schema.String, BaselineCustomFieldSchema)
+    }),
+    comments: Schema.Array(Schema.Struct({ id: NonEmptyString }))
+});
+//# sourceMappingURL=schemas.js.map

package/dist/internal/sync/schemas.js.map

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

package/dist/internal/sync/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Core domain types for Jira Markdown Sync local workspace state.
+ *
+ * @internal
+ */
+export declare const FIELD_SHAPES: readonly ["text", "multilineText", "number", "boolean", "date", "singleSelect", "multiSelect", "user", "cascadingSelect"];
+export type FieldShape = typeof FIELD_SHAPES[number];
+export interface RequestedCustomField {
+    readonly displayName: string;
+    readonly fieldId?: string | undefined;
+    readonly shape: FieldShape;
+    readonly ordered?: boolean | undefined;
+}
+export interface WorkspaceConfig {
+    readonly version: 1;
+    readonly siteUrl: string;
+    readonly documentsDir: string;
+    readonly customFields: ReadonlyArray<RequestedCustomField>;
+}
+export type FilenameMode = "convention" | "custom";
+export interface ManifestIssue {
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly documentPath: string;
+    readonly filenameMode: FilenameMode;
+}
+export interface SyncManifest {
+    readonly version: 1;
+    readonly siteUrl: string;
+    readonly issues: ReadonlyArray<ManifestIssue>;
+}
+export interface UserFieldValue {
+    readonly accountId: string;
+    readonly displayName: string;
+}
+export interface OptionFieldValue {
+    readonly id?: string | undefined;
+    readonly value: string;
+}
+export interface CascadingFieldValue {
+    readonly parent: OptionFieldValue;
+    readonly child?: OptionFieldValue | undefined;
+}
+export type SyncFieldScalar = string | number | boolean | null;
+export type SyncFieldValue = SyncFieldScalar | UserFieldValue | OptionFieldValue | CascadingFieldValue | ReadonlyArray<string | number | boolean | UserFieldValue | OptionFieldValue>;
+export interface BaselineCustomField {
+    readonly fieldId: string;
+    readonly displayName: string;
+    readonly shape: FieldShape;
+    readonly value: SyncFieldValue;
+}
+export interface SyncBaselineFields {
+    readonly summary: string;
+    readonly description: string;
+    readonly labels: ReadonlyArray<string>;
+    readonly customFields: Readonly<Record<string, BaselineCustomField>>;
+}
+export interface SyncBaselineComment {
+    readonly id: string;
+}
+export interface SyncBaseline {
+    readonly version: 1;
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly fields: SyncBaselineFields;
+    readonly comments: ReadonlyArray<SyncBaselineComment>;
+}
+export interface IssueDocumentFrontMatter {
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly summary: string;
+    readonly status: string;
+    readonly issueType: string;
+    readonly priority: string | null;
+    readonly assignee: UserFieldValue | null;
+    readonly reporter: UserFieldValue | null;
+    readonly labels: ReadonlyArray<string>;
+    readonly customFields: Readonly<Record<string, SyncFieldValue>>;
+}
+export interface CommentDraft {
+    readonly draftId: string;
+    readonly body: string;
+}
+export interface AcceptedComment {
+    readonly id: string;
+    readonly author: string;
+    readonly created: string;
+    readonly body: string;
+}
+export interface AttachmentReference {
+    readonly filename: string;
+    readonly url: string;
+}
+export interface IssueDocument {
+    readonly frontMatter: IssueDocumentFrontMatter;
+    readonly description: string;
+    readonly multilineCustomFields: Readonly<Record<string, string>>;
+    readonly commentDrafts: ReadonlyArray<CommentDraft>;
+    readonly acceptedComments: ReadonlyArray<AcceptedComment>;
+    readonly attachments: ReadonlyArray<AttachmentReference>;
+    readonly localNotes: string;
+}
+export type SyncFieldPath = "summary" | "description" | "labels" | `customFields.${string}` | `readOnly.${string}`;
+export interface SyncValidationFailure {
+    readonly _tag: "ValidationFailure";
+    readonly message: string;
+    readonly issueKey?: string;
+    readonly field?: SyncFieldPath;
+    readonly path?: string;
+}
+export interface SyncConflict {
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly field: SyncFieldPath;
+    readonly baselineValue: SyncFieldValue;
+    readonly jiraValue: SyncFieldValue;
+    readonly documentValue: SyncFieldValue;
+}
+export type PlannedFieldChange = {
+    readonly _tag: "RemoteOnly";
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly field: SyncFieldPath;
+    readonly jiraValue: SyncFieldValue;
+} | {
+    readonly _tag: "LocalOnly";
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly field: SyncFieldPath;
+    readonly documentValue: SyncFieldValue;
+} | {
+    readonly _tag: "Conflict";
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly field: SyncFieldPath;
+    readonly baselineValue: SyncFieldValue;
+    readonly jiraValue: SyncFieldValue;
+    readonly documentValue: SyncFieldValue;
+};
+export interface SyncPlan {
+    readonly changes: ReadonlyArray<PlannedFieldChange>;
+    readonly validationFailures: ReadonlyArray<SyncValidationFailure>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/sync/types.d.ts.map

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

package/dist/internal/sync/types.js

@@ -0,0 +1,17 @@
+/**
+ * Core domain types for Jira Markdown Sync local workspace state.
+ *
+ * @internal
+ */
+export const FIELD_SHAPES = [
+    "text",
+    "multilineText",
+    "number",
+    "boolean",
+    "date",
+    "singleSelect",
+    "multiSelect",
+    "user",
+    "cascadingSelect"
+];
+//# sourceMappingURL=types.js.map

package/dist/internal/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/sync/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM;IACN,eAAe;IACf,QAAQ;IACR,SAAS;IACT,MAAM;IACN,cAAc;IACd,aAAa;IACb,MAAM;IACN,iBAAiB;CACT,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knpkv/jira-cli",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "CLI tool to fetch Jira tickets and export to markdown",
   "license": "MIT",
   "author": "knpkv",
@@ -46,23 +46,23 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@effect/platform": ">=0.93.0 <0.96.0",
-    "effect": ">=3.19.3"
+    "effect": "4.0.0-beta.87"
   },
   "dependencies": {
-    "@effect/cli": "latest",
-    "@effect/platform-node": "latest",
+    "@effect/platform-node": "4.0.0-beta.87",
     "gray-matter": "^4.0.3",
-    "@knpkv/atlassian-common": "0.2.0",
-    "@knpkv/jira-api-client": "0.2.0"
+    "js-yaml": "^4.1.0",
+    "@knpkv/agent-skills": "^0.2.1",
+    "@knpkv/atlassian-common": "0.3.0",
+    "@knpkv/jira-api-client": "0.3.0"
   },
   "devDependencies": {
-    "@effect/platform": "latest",
-    "@effect/vitest": "latest",
+    "@effect/vitest": "4.0.0-beta.87",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "latest",
-    "effect": "latest",
-    "typescript": "~5.9.0",
-    "vitest": "^4.0.13"
+    "effect": "4.0.0-beta.87",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.9"
   },
   "keywords": [
     "effect",
@@ -78,6 +78,7 @@
     "build": "tsc",
     "clean": "rimraf dist dist-test .tsbuildinfo",
     "test": "vitest run",
+    "test:integration": "vitest run --config vitest.config.integration.ts",
     "test:watch": "vitest",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",

package/skills/jira/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: jira
+description: Use the @knpkv/jira-cli command line tool to authenticate with Jira Cloud, fetch Jira issues, export issues to markdown, search by JQL or fixVersion, and inspect or update Jira project versions and related work links. Trigger when the user asks an agent to query Jira, collect tickets for release notes, write ticket markdown, inspect release metadata, or attach Confluence release-report links to a Jira version.
+---
+
+# Jira
+
+Use the `jira` binary for Jira Cloud issue export and release-version workflows.
+
+## Preconditions
+
+- Authenticate first with `jira auth status`, `jira auth create`, `jira auth configure`, and `jira auth login`.
+- Use `--json` on version commands when the agent needs structured data.
+- Use numeric version ids for `jira version get`, `jira version update`, and `jira version related-work`.
+- Confirm before remote write commands: `jira version update` and `jira version related-work add`.
+
+## Authentication
+
+```bash
+jira auth status
+jira auth create
+jira auth configure --client-id <id> --client-secret <secret>
+jira auth login
+jira auth login --site https://example.atlassian.net
+```
+
+OAuth scopes used by release workflows include `read:jira-work`, `write:jira-work`, `manage:jira-project`, `read:jira-user`, `read:me`, and `offline_access`.
+
+## Issue Export
+
+Fetch one issue as markdown:
+
+```bash
+jira issue get PROJ-123 --output-dir ./jira-tickets
+```
+
+Search with JQL:
+
+```bash
+jira issue search 'project = PROJ AND status = Done' --output-dir ./jira-tickets
+jira issue search 'fixVersion = "1.0.0"' --format single --max-results 200
+```
+
+Search by fix version:
+
+```bash
+jira issue search --by-version "1.0.0" --project PROJ
+jira issue search --by-version "1.0.0" --project PROJ --format single
+```
+
+Output formats:
+
+- `--format multi` writes one markdown file per issue.
+- `--format single` writes `jira-export.md`.
+
+## Version Workflows
+
+List versions:
+
+```bash
+jira version list --project PROJ --json
+jira version list --project PROJ --unreleased --max 10 --json
+jira version list --project PROJ --custom-field "Security & Compliance Impact" --json
+```
+
+View a version:
+
+```bash
+jira version get 10042 --json
+```
+
+Update a version description:
+
+```bash
+jira version update 10042 --description "Q3 release"
+```
+
+Manage related work links:
+
+```bash
+jira version related-work list 10042 --json
+jira version related-work add 10042 --title "Release notes" --url "https://example.atlassian.net/wiki/spaces/PROJ/pages/123" --category Communication
+```
+
+## Agent Workflow
+
+1. Use read-only commands first to find issue keys, version ids, and current release metadata.
+2. Prefer `--json` for release metadata and parse the resulting JSON instead of scraping tables.
+3. Avoid printing tokens or OAuth secrets. Let interactive commands prompt for secrets when needed.
+4. Confirm exact version id, title, URL, category, or description before mutating Jira.

package/skills/jira/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Jira CLI"
+  short_description: "Search Jira and manage releases"
+  default_prompt: "Use $jira to search Jira issues, export markdown, or update release metadata."

package/src/IssueService.ts

@@ -29,7 +29,7 @@ import { JiraApiError } from "./JiraCliError.js"
  *
  * @category Config
  */
-export class SiteUrl extends Context.Tag("@knpkv/jira-cli/SiteUrl")<SiteUrl, string>() {}
+export class SiteUrl extends Context.Service<SiteUrl, string>()("@knpkv/jira-cli/SiteUrl") {}
 
 /**
  * Attachment metadata.
@@ -104,6 +104,12 @@ export interface SearchResult {
   readonly maxResults: number
 }
 
+interface SearchJqlResponse {
+  readonly issues?: ReadonlyArray<unknown>
+  readonly isLast?: boolean
+  readonly nextPageToken?: string
+}
+
 /**
  * IssueService interface.
  *
@@ -138,10 +144,10 @@ export interface IssueServiceShape {
  *
  * @category Services
  */
-export class IssueService extends Context.Tag("@knpkv/jira-cli/IssueService")<
+export class IssueService extends Context.Service<
   IssueService,
   IssueServiceShape
->() {}
+>()("@knpkv/jira-cli/IssueService") {}
 
 const FIELDS = [
   "summary",
@@ -299,7 +305,7 @@ const make = Effect.gen(function*() {
     jql: string,
     maxResults: number,
     nextPageToken?: string
-  ) =>
+  ): Effect.Effect<SearchJqlResponse, JiraApiError> =>
     toEffect(client.v3.client.GET("/rest/api/3/search/jql", {
       params: {
         query: {
@@ -311,6 +317,7 @@ const make = Effect.gen(function*() {
         }
       }
     })).pipe(
+      Effect.map((result) => result as SearchJqlResponse),
       Effect.mapError((cause) => new JiraApiError({ message: "Failed to search issues", cause }))
     )
 
@@ -336,36 +343,35 @@ const make = Effect.gen(function*() {
   const searchAll = (
     jql: string,
     options?: { readonly maxResults?: number }
-  ): Effect.Effect<ReadonlyArray<Issue>, JiraApiError> =>
-    Effect.gen(function*() {
-      const allIssues: Array<Issue> = []
-      const maxResults = options?.maxResults ?? 100
-      let nextPageToken: string | undefined = undefined
-      let pageCount = 0
-
-      // Fetch first page
-      let result = yield* searchJql(jql, maxResults, nextPageToken)
-      let issues = result.issues ?? []
+  ): Effect.Effect<ReadonlyArray<Issue>, JiraApiError> => (Effect.gen(function*() {
+    const allIssues: Array<Issue> = []
+    const maxResults = options?.maxResults ?? 100
+    let nextPageToken: string | undefined = undefined
+    let pageCount = 0
+
+    // Fetch first page
+    let result = yield* searchJql(jql, maxResults, nextPageToken)
+    let issues = result.issues ?? []
+    pageCount++
+
+    for (const bean of issues) {
+      allIssues.push(mapIssue(bean as unknown as Record<string, unknown>, siteUrl))
+    }
+
+    // Fetch remaining pages with iteration guard
+    while (!result.isLast && result.nextPageToken && pageCount < MAX_PAGES) {
+      nextPageToken = result.nextPageToken
+      result = yield* searchJql(jql, maxResults, nextPageToken)
+      issues = result.issues ?? []
       pageCount++
 
       for (const bean of issues) {
         allIssues.push(mapIssue(bean as unknown as Record<string, unknown>, siteUrl))
       }
+    }
 
-      // Fetch remaining pages with iteration guard
-      while (!result.isLast && result.nextPageToken && pageCount < MAX_PAGES) {
-        nextPageToken = result.nextPageToken
-        result = yield* searchJql(jql, maxResults, nextPageToken)
-        issues = result.issues ?? []
-        pageCount++
-
-        for (const bean of issues) {
-          allIssues.push(mapIssue(bean as unknown as Record<string, unknown>, siteUrl))
-        }
-      }
-
-      return allIssues
-    })
+    return allIssues
+  }) as Effect.Effect<ReadonlyArray<Issue>, JiraApiError>)
 
   return IssueService.of({ getByKey, search, searchAll })
 })