@knpkv/atlassian-common 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @knpkv/atlassian-common
 
+## 0.4.0
+
+### Minor Changes
+
+- [#103](https://github.com/knpkv/npm/pull/103) [`477e4c6`](https://github.com/knpkv/npm/commit/477e4c60fa5c501883be6c03629da5a3cc91444c) Thanks [@konopkov](https://github.com/konopkov)! - Add shared Atlassian auth profile storage for multi-account and multi-site OAuth use.
+
+  Jira and Confluence now expose `auth profiles`, `auth use <profile>`, and `auth remove <profile>` commands backed by shared profile management in `@knpkv/atlassian-common`. Confluence also migrates existing legacy auth/config files on first use. Agent skills and docs now describe the profile commands and active-profile checks.
+
+- [#105](https://github.com/knpkv/npm/pull/105) [`a3a4d3a`](https://github.com/knpkv/npm/commit/a3a4d3a14fafe235bc901ed5015bb9bd82c59281) Thanks [@konopkov](https://github.com/konopkov)! - Add a unified Atlassian profile manager CLI with cross-tool profile listing, selection, diagnostics, token refresh, and scope validation helpers.
+
+  Update bundled Jira, Confluence, and Jira Clockify agent skills to recommend the unified profile diagnostics workflow.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,6 @@
 # @knpkv/atlassian-common
 
-Shared utilities for Atlassian tools: OAuth2 + PKCE auth, token storage, config paths, AST types, and markdown serialization.
+Shared utilities for Atlassian tools: OAuth2 + PKCE auth, shared auth profiles, token storage, config paths, AST types, and markdown serialization.
 
 ## Installation
 
@@ -15,7 +15,7 @@ pnpm add @knpkv/atlassian-common
 | `@knpkv/atlassian-common`             | Everything (AST, auth, config, serializers)  |
 | `@knpkv/atlassian-common/ast`         | Inline, block, macro, and document AST nodes |
 | `@knpkv/atlassian-common/auth`        | OAuth2 endpoints, PKCE, token exchange       |
-| `@knpkv/atlassian-common/config`      | Config paths, schemas, token storage         |
+| `@knpkv/atlassian-common/config`      | Config paths, schemas, token/profile storage |
 | `@knpkv/atlassian-common/serializers` | Markdown serializer for AST nodes            |
 
 ## OAuth2 + PKCE
@@ -59,15 +59,17 @@ const program = Effect.gen(function* () {
 })
 ```
 
-## Token Storage
+## Token And Profile Storage
 
-Stores OAuth config and tokens in `~/.config/atlassian/` with 0600 permissions.
+Stores OAuth config, auth profiles, and the active token mirror in `~/.config/atlassian/<tool>/` with 0600 permissions.
 
 ```typescript
 import { Effect } from "effect"
 import {
-  saveToken,
-  loadToken,
+  saveProfileToken,
+  loadActiveProfileToken,
+  loadProfiles,
+  setActiveProfileBySelector,
   isTokenExpired,
   saveOAuthConfig,
   loadOAuthConfig,
@@ -75,15 +77,28 @@ import {
 } from "@knpkv/atlassian-common/config"
 
 const program = Effect.gen(function* () {
-  yield* saveOAuthConfig({ clientId: "...", clientSecret: "..." }, "jira")
+  yield* saveOAuthConfig("jira", { clientId: "...", clientSecret: "..." })
   const config = yield* loadOAuthConfig("jira")
 
-  yield* saveToken({ access_token: "...", refresh_token: "...", expires_in: 3600 }, "jira")
-  const token = yield* loadToken("jira")
-  const expired = isTokenExpired(token)
+  yield* saveProfileToken("jira", {
+    access_token: "...",
+    refresh_token: "...",
+    expires_at: Date.now() + 3600_000,
+    scope: "read:jira-work offline_access",
+    cloud_id: "...",
+    site_url: "https://example.atlassian.net"
+  })
+
+  const profiles = yield* loadProfiles("jira")
+  yield* setActiveProfileBySelector("jira", "https://example.atlassian.net")
+
+  const token = yield* loadActiveProfileToken("jira")
+  const expired = token ? isTokenExpired(token) : true
 }).pipe(Effect.provide(HomeDirectoryLive))
 ```
 
+`profiles.json` is the multi-account/site source of truth. `auth.json` is still mirrored to the active profile so older single-profile consumers keep working.
+
 ## AST Types
 
 Typed Atlassian Document Format nodes — used by `@knpkv/jira-cli` and `@knpkv/confluence-to-markdown`.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { NodeFileSystem, NodeHttpClient, NodePath, NodeRuntime, NodeServices, NodeStdio } from "@effect/platform-node";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stdio from "effect/Stdio";
+import { Argument as Args, Command } from "effect/unstable/cli";
+import pkg from "../package.json" with { type: "json" };
+import { HomeDirectoryLive, inspectAllToolProfiles, migrateLegacyProfiles, refreshActiveProfiles, useProfileForAllTools } from "./config/index.js";
+const profileArg = Args.string("profile").pipe(Args.withDescription("Profile ID, name, site URL, cloud ID, or account ID"));
+const printStatuses = (statuses) => Effect.gen(function* () {
+    for (const status of statuses) {
+        const active = status.activeProfile;
+        yield* Console.log(`${status.tool.label} (${status.tool.toolName})`);
+        if (status.authStoreName !== status.tool.toolName) {
+            yield* Console.log(`  Auth store: ${status.authStoreName}`);
+        }
+        yield* Console.log(`  Active: ${active ? active.name : "none"}`);
+        if (active) {
+            yield* Console.log(`  Profile ID: ${active.id}`);
+            yield* Console.log(`  Site: ${active.token.site_url}`);
+            yield* Console.log(`  Token: ${status.tokenStatus}`);
+            yield* Console.log(`  Scopes: ${status.missingScopes.length === 0 ? "ok" : `missing ${status.missingScopes.join(", ")}`}`);
+        }
+    }
+});
+const profilesList = Command.make("list", {}, () => inspectAllToolProfiles().pipe(Effect.flatMap(printStatuses)))
+    .pipe(Command.withDescription("List active Atlassian profiles for all tools"));
+const profilesUse = Command.make("use", { profile: profileArg }, ({ profile }) => useProfileForAllTools(profile).pipe(Effect.flatMap(printStatuses))).pipe(Command.withDescription("Use a profile across Atlassian tools"));
+const profilesDoctor = Command.make("doctor", {}, () => inspectAllToolProfiles().pipe(Effect.flatMap((statuses) => Effect.gen(function* () {
+    yield* printStatuses(statuses);
+    for (const status of statuses) {
+        if (!status.activeProfile) {
+            yield* Console.log(`Suggestion: run '${status.tool.loginHint}' for ${status.tool.label}.`);
+        }
+        if (status.tokenStatus === "expired") {
+            yield* Console.log(`Suggestion: run 'atlassian auth refresh' or '${status.tool.loginHint}' for ${status.tool.label}.`);
+        }
+        if (status.missingScopes.length > 0) {
+            yield* Console.log(`Suggestion: re-login with ${status.tool.label}; missing scopes: ${status.missingScopes.join(", ")}.`);
+        }
+    }
+})))).pipe(Command.withDescription("Diagnose tokens, scopes, and active profile usage"));
+const profilesMigrate = Command.make("migrate", {}, () => migrateLegacyProfiles().pipe(Effect.flatMap(printStatuses)))
+    .pipe(Command.withDescription("Migrate legacy auth.json files into shared profiles.json storage"));
+const profiles = Command.make("profiles").pipe(Command.withDescription("Manage shared Atlassian auth profiles"), Command.withSubcommands([profilesList, profilesUse, profilesDoctor, profilesMigrate]));
+const authRefresh = Command.make("refresh", {}, () => refreshActiveProfiles().pipe(Effect.flatMap(printStatuses)))
+    .pipe(Command.withDescription("Refresh expired active OAuth tokens"));
+const auth = Command.make("auth").pipe(Command.withDescription("Manage Atlassian authentication"), Command.withSubcommands([authRefresh]));
+const atlassian = Command.make("atlassian", {}, () => Console.log("Usage: atlassian profiles|auth")).pipe(Command.withDescription("Unified Atlassian profile manager"), Command.withSubcommands([profiles, auth]));
+const cli = Command.runWith(atlassian, { version: pkg.version });
+const program = Effect.gen(function* () {
+    const stdio = yield* Stdio.Stdio;
+    const args = yield* stdio.args;
+    return yield* cli(args);
+}).pipe(Effect.provide(NodeStdio.layer), Effect.provide(Layer.mergeAll(NodeServices.layer, NodeFileSystem.layer, NodePath.layer, NodeHttpClient.layerFetch, HomeDirectoryLive)), Effect.catch((error) => Console.error(String(error)).pipe(Effect.andThen(Effect.fail(error)))));
+NodeRuntime.runMain(program);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/config/AuthProfiles.d.ts

@@ -0,0 +1,342 @@
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { type HomeDirectoryError, type HomeDirectoryTag } from "./ConfigPaths.js";
+import { type OAuthToken } from "./OAuthSchemas.js";
+import { FileSystemError } from "./TokenStorage.js";
+/**
+ * A persisted Atlassian auth profile.
+ *
+ * @category Schema
+ */
+export declare const AuthProfileSchema: Schema.Struct<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}>;
+/**
+ * Type for a persisted Atlassian auth profile.
+ *
+ * @category Types
+ */
+export type AuthProfile = Schema.Schema.Type<typeof AuthProfileSchema>;
+/**
+ * Schema for the profile registry file.
+ *
+ * @category Schema
+ */
+export declare const AuthProfilesFileSchema: Schema.Struct<{
+    /** Active profile ID. Omitted when no profile is active. */
+    readonly activeProfileId: Schema.optional<Schema.String>;
+    /** Known auth profiles for this CLI. */
+    readonly profiles: Schema.$Array<Schema.Struct<{
+        /** Stable identifier derived from account and cloud IDs. */
+        readonly id: Schema.String;
+        /** Human-readable profile label. */
+        readonly name: Schema.String;
+        /** OAuth token and selected site metadata. */
+        readonly token: Schema.Struct<{
+            readonly access_token: Schema.String;
+            readonly refresh_token: Schema.String;
+            readonly expires_at: Schema.Number;
+            readonly scope: Schema.String;
+            readonly cloud_id: Schema.String;
+            readonly site_url: Schema.String;
+            readonly user: Schema.optional<Schema.Struct<{
+                readonly account_id: Schema.String;
+                readonly name: Schema.String;
+                readonly email: Schema.String;
+            }>>;
+        }>;
+        /** ISO timestamp when the profile was first created. */
+        readonly created_at: Schema.String;
+        /** ISO timestamp when the profile was last updated. */
+        readonly updated_at: Schema.String;
+    }>>;
+}>;
+/**
+ * Type for the profile registry file.
+ *
+ * @category Types
+ */
+export type AuthProfilesFile = Schema.Schema.Type<typeof AuthProfilesFileSchema>;
+/**
+ * Build a stable profile ID from token site and user identity.
+ *
+ * @category Utilities
+ */
+export declare const profileIdFromToken: (token: OAuthToken) => string;
+/**
+ * Build a readable profile label from token site and user identity.
+ *
+ * @category Utilities
+ */
+export declare const profileNameFromToken: (token: OAuthToken) => string;
+/**
+ * Create a profile record from an OAuth token.
+ *
+ * @category Utilities
+ */
+export declare const profileFromToken: (token: OAuthToken, now: Date) => AuthProfile;
+/**
+ * Load all auth profiles for a tool.
+ *
+ * Falls back to the legacy single-token file when `profiles.json` does not exist.
+ *
+ * @category Profile Storage
+ */
+export declare const loadProfiles: (toolName: string) => Effect.Effect<AuthProfilesFile, FileSystemError | HomeDirectoryError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Save auth profiles and mirror the active profile to `auth.json`.
+ *
+ * @category Profile Storage
+ */
+export declare const saveProfiles: (toolName: string, store: AuthProfilesFile) => Effect.Effect<void, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Insert or update a profile from a token and make it active.
+ *
+ * @category Profile Storage
+ */
+export declare const saveProfileToken: (toolName: string, token: OAuthToken) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type">, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Load the active auth profile.
+ *
+ * @category Profile Storage
+ */
+export declare const loadActiveProfile: (toolName: string) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type"> | null, HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Load the active OAuth token.
+ *
+ * @category Profile Storage
+ */
+export declare const loadActiveProfileToken: (toolName: string) => Effect.Effect<{
+    readonly access_token: string;
+    readonly refresh_token: string;
+    readonly expires_at: number;
+    readonly scope: string;
+    readonly cloud_id: string;
+    readonly site_url: string;
+    readonly user?: Schema.Struct.ReadonlySide<{
+        readonly account_id: Schema.String;
+        readonly name: Schema.String;
+        readonly email: Schema.String;
+    }, "Type"> | undefined;
+} | null, HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Set the active profile by ID.
+ *
+ * @category Profile Storage
+ */
+export declare const setActiveProfile: (toolName: string, profileId: string) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type"> | null, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Resolve a profile by ID, name, site URL, cloud ID, or account ID.
+ *
+ * @category Utilities
+ */
+export declare const findProfile: (profiles: ReadonlyArray<AuthProfile>, selector: string) => AuthProfile | null;
+/**
+ * Set the active profile using a flexible selector.
+ *
+ * @category Profile Storage
+ */
+export declare const setActiveProfileBySelector: (toolName: string, selector: string) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type"> | null, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Remove a profile by ID.
+ *
+ * @category Profile Storage
+ */
+export declare const deleteProfile: (toolName: string, profileId: string) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type"> | null, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Remove a profile using a flexible selector.
+ *
+ * @category Profile Storage
+ */
+export declare const deleteProfileBySelector: (toolName: string, selector: string) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type"> | null, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+/**
+ * Remove the active profile.
+ *
+ * @category Profile Storage
+ */
+export declare const deleteActiveProfile: (toolName: string) => Effect.Effect<Schema.Struct.ReadonlySide<{
+    /** Stable identifier derived from account and cloud IDs. */
+    readonly id: Schema.String;
+    /** Human-readable profile label. */
+    readonly name: Schema.String;
+    /** OAuth token and selected site metadata. */
+    readonly token: Schema.Struct<{
+        readonly access_token: Schema.String;
+        readonly refresh_token: Schema.String;
+        readonly expires_at: Schema.Number;
+        readonly scope: Schema.String;
+        readonly cloud_id: Schema.String;
+        readonly site_url: Schema.String;
+        readonly user: Schema.optional<Schema.Struct<{
+            readonly account_id: Schema.String;
+            readonly name: Schema.String;
+            readonly email: Schema.String;
+        }>>;
+    }>;
+    /** ISO timestamp when the profile was first created. */
+    readonly created_at: Schema.String;
+    /** ISO timestamp when the profile was last updated. */
+    readonly updated_at: Schema.String;
+}, "Type"> | null, import("effect/PlatformError").PlatformError | HomeDirectoryError | FileSystemError, HomeDirectoryTag | Path.Path | FileSystem.FileSystem>;
+//# sourceMappingURL=AuthProfiles.d.ts.map

package/dist/config/AuthProfiles.d.ts.map

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