@gh-symphony/cli 0.0.14 → 0.0.16

package/dist/github/client.d.ts

@@ -1,71 +0,0 @@
-export type GitHubClient = {
-    token: string;
-    apiUrl: string;
-    fetchImpl: typeof fetch;
-};
-export type ViewerInfo = {
-    login: string;
-    name: string | null;
-    scopes: string[];
-};
-export type ProjectSummary = {
-    id: string;
-    title: string;
-    shortDescription: string;
-    url: string;
-    openItemCount: number;
-    owner: {
-        login: string;
-        type: "User" | "Organization";
-    };
-};
-export type StatusFieldOption = {
-    id: string;
-    name: string;
-    description: string | null;
-    color: string | null;
-};
-export type ProjectStatusField = {
-    id: string;
-    name: string;
-    options: StatusFieldOption[];
-};
-export type LinkedRepository = {
-    owner: string;
-    name: string;
-    url: string;
-    cloneUrl: string;
-};
-export type ProjectTextField = {
-    id: string;
-    name: string;
-    dataType: string;
-};
-export type ProjectDetail = {
-    id: string;
-    title: string;
-    url: string;
-    statusFields: ProjectStatusField[];
-    textFields: ProjectTextField[];
-    linkedRepositories: LinkedRepository[];
-};
-export declare class GitHubApiError extends Error {
-    readonly status?: number | undefined;
-    constructor(message: string, status?: number | undefined);
-}
-export declare class GitHubScopeError extends GitHubApiError {
-    readonly requiredScopes: string[];
-    readonly currentScopes: string[];
-    constructor(message: string, requiredScopes: string[], currentScopes: string[]);
-}
-export declare function createClient(token: string, options?: {
-    apiUrl?: string;
-    fetchImpl?: typeof fetch;
-}): GitHubClient;
-export declare function validateToken(client: GitHubClient): Promise<ViewerInfo>;
-export declare function checkRequiredScopes(scopes: string[]): {
-    valid: boolean;
-    missing: string[];
-};
-export declare function listUserProjects(client: GitHubClient): Promise<ProjectSummary[]>;
-export declare function getProjectDetail(client: GitHubClient, projectId: string): Promise<ProjectDetail>;

package/dist/github/client.js

@@ -1,348 +0,0 @@
-const DEFAULT_API_URL = "https://api.github.com/graphql";
-const REST_API_URL = "https://api.github.com";
-export class GitHubApiError extends Error {
-    status;
-    constructor(message, status) {
-        super(message);
-        this.status = status;
-        this.name = "GitHubApiError";
-    }
-}
-export class GitHubScopeError extends GitHubApiError {
-    requiredScopes;
-    currentScopes;
-    constructor(message, requiredScopes, currentScopes) {
-        super(message);
-        this.requiredScopes = requiredScopes;
-        this.currentScopes = currentScopes;
-        this.name = "GitHubScopeError";
-    }
-}
-export function createClient(token, options) {
-    return {
-        token,
-        apiUrl: options?.apiUrl ?? DEFAULT_API_URL,
-        fetchImpl: options?.fetchImpl ?? fetch,
-    };
-}
-// ── 2.1: Token validation & scope check ──────────────────────────────────────
-export async function validateToken(client) {
-    // Use REST to get X-OAuth-Scopes header (GraphQL doesn't expose scopes)
-    const restUrl = client.apiUrl.replace("/graphql", "");
-    const baseUrl = restUrl === client.apiUrl ? REST_API_URL : restUrl;
-    const response = await client.fetchImpl(`${baseUrl}/user`, {
-        headers: {
-            authorization: `Bearer ${client.token}`,
-            accept: "application/vnd.github+json",
-        },
-    });
-    if (!response.ok) {
-        if (response.status === 401) {
-            throw new GitHubApiError("Invalid token: authentication failed.", 401);
-        }
-        throw new GitHubApiError(`GitHub API error: ${response.status} ${response.statusText}`, response.status);
-    }
-    const scopes = response.headers
-        .get("x-oauth-scopes")
-        ?.split(",")
-        .map((s) => s.trim())
-        .filter(Boolean) ?? [];
-    const user = (await response.json());
-    return {
-        login: user.login,
-        name: user.name,
-        scopes,
-    };
-}
-export function checkRequiredScopes(scopes) {
-    const required = ["repo", "read:org", "project"];
-    const normalizedScopes = scopes.map((s) => s.toLowerCase());
-    const missing = required.filter((r) => !normalizedScopes.includes(r));
-    return { valid: missing.length === 0, missing };
-}
-// ── 2.2: Projects v2 list ────────────────────────────────────────────────────
-export async function listUserProjects(client) {
-    const data = await graphql(client, VIEWER_PROJECTS_QUERY);
-    const projects = [];
-    for (const node of data.viewer.projectsV2?.nodes ?? []) {
-        if (!node)
-            continue;
-        projects.push(normalizeProjectSummary(node, {
-            login: data.viewer.login,
-            type: "User",
-        }));
-    }
-    for (const orgNode of data.viewer.organizations?.nodes ?? []) {
-        if (!orgNode)
-            continue;
-        for (const projNode of orgNode.projectsV2?.nodes ?? []) {
-            if (!projNode)
-                continue;
-            projects.push(normalizeProjectSummary(projNode, {
-                login: orgNode.login,
-                type: "Organization",
-            }));
-        }
-    }
-    return projects;
-}
-function normalizeProjectSummary(node, owner) {
-    return {
-        id: node.id,
-        title: node.title,
-        shortDescription: node.shortDescription ?? "",
-        url: node.url,
-        openItemCount: node.items?.totalCount ?? 0,
-        owner,
-    };
-}
-// ── 2.3: Project detail (status fields + linked repos) ───────────────────────
-export async function getProjectDetail(client, projectId) {
-    const data = await graphql(client, PROJECT_DETAIL_QUERY, { projectId });
-    const project = data.node;
-    if (!project || project.__typename !== "ProjectV2") {
-        throw new GitHubApiError(`Project not found: ${projectId}`);
-    }
-    const statusFields = [];
-    const textFields = [];
-    for (const field of project.fields?.nodes ?? []) {
-        if (!field)
-            continue;
-        if (field.__typename === "ProjectV2SingleSelectField") {
-            statusFields.push({
-                id: field.id,
-                name: field.name,
-                options: (field.options ?? []).map((opt) => ({
-                    id: opt.id,
-                    name: opt.name,
-                    description: opt.description ?? null,
-                    color: opt.color ?? null,
-                })),
-            });
-        }
-        else if (field.__typename === "ProjectV2Field" && field.dataType) {
-            textFields.push({
-                id: field.id,
-                name: field.name,
-                dataType: field.dataType,
-            });
-        }
-    }
-    const repoMap = new Map();
-    let cursor = null;
-    let hasMore = true;
-    // Use initial page from the detail query
-    for (const item of project.items?.nodes ?? []) {
-        const repo = item?.content?.repository;
-        if (!repo)
-            continue;
-        const key = `${repo.owner.login}/${repo.name}`;
-        if (!repoMap.has(key)) {
-            repoMap.set(key, {
-                owner: repo.owner.login,
-                name: repo.name,
-                url: repo.url,
-                cloneUrl: repo.url.endsWith(".git") ? repo.url : `${repo.url}.git`,
-            });
-        }
-    }
-    hasMore = project.items?.pageInfo?.hasNextPage ?? false;
-    cursor = project.items?.pageInfo?.endCursor ?? null;
-    // Paginate remaining items for linked repos
-    while (hasMore && cursor) {
-        const pageData = await graphql(client, PROJECT_ITEMS_PAGE_QUERY, { projectId, cursor });
-        const items = pageData.node?.items;
-        if (!items)
-            break;
-        for (const item of items.nodes ?? []) {
-            const repo = item?.content?.repository;
-            if (!repo)
-                continue;
-            const key = `${repo.owner.login}/${repo.name}`;
-            if (!repoMap.has(key)) {
-                repoMap.set(key, {
-                    owner: repo.owner.login,
-                    name: repo.name,
-                    url: repo.url,
-                    cloneUrl: repo.url.endsWith(".git") ? repo.url : `${repo.url}.git`,
-                });
-            }
-        }
-        hasMore = items.pageInfo?.hasNextPage ?? false;
-        cursor = items.pageInfo?.endCursor ?? null;
-    }
-    return {
-        id: project.id,
-        title: project.title,
-        url: project.url,
-        statusFields,
-        textFields,
-        linkedRepositories: [...repoMap.values()],
-    };
-}
-// ── GraphQL helpers ──────────────────────────────────────────────────────────
-async function graphql(client, query, variables) {
-    const response = await client.fetchImpl(client.apiUrl, {
-        method: "POST",
-        headers: {
-            "content-type": "application/json",
-            authorization: `Bearer ${client.token}`,
-        },
-        body: JSON.stringify({ query, variables }),
-    });
-    if (!response.ok) {
-        const text = await response.text().catch(() => "");
-        throw new GitHubApiError(`GitHub GraphQL request failed: ${response.status} ${response.statusText}. ${text}`, response.status);
-    }
-    const payload = (await response.json());
-    if (payload.errors?.length) {
-        const scopeMessages = payload.errors
-            .map((e) => e.message)
-            .filter((m) => m.includes("has not been granted the required scopes"));
-        if (scopeMessages.length > 0) {
-            const requiredScopes = new Set();
-            let currentScopes = [];
-            for (const msg of scopeMessages) {
-                for (const match of msg.matchAll(/requires one of the following scopes: \['([^']+)'\]/g)) {
-                    requiredScopes.add(match[1]);
-                }
-                if (currentScopes.length === 0) {
-                    const currMatch = /has only been granted the: \[([^\]]+)\]/.exec(msg);
-                    if (currMatch) {
-                        currentScopes = currMatch[1]
-                            .split(",")
-                            .map((s) => s.trim().replace(/'/g, ""))
-                            .filter(Boolean);
-                    }
-                }
-            }
-            throw new GitHubScopeError("Token is missing required GitHub scopes.", [...requiredScopes], currentScopes);
-        }
-        throw new GitHubApiError(`GraphQL errors: ${payload.errors.map((e) => e.message).join("; ")}`);
-    }
-    if (!payload.data) {
-        throw new GitHubApiError("GraphQL response missing data.");
-    }
-    return payload.data;
-}
-// ── GraphQL queries ──────────────────────────────────────────────────────────
-const VIEWER_PROJECTS_QUERY = `
-  query ViewerProjects {
-    viewer {
-      login
-      projectsV2(first: 50) {
-        nodes {
-          id
-          title
-          shortDescription
-          url
-          items { totalCount }
-        }
-      }
-      organizations(first: 20) {
-        nodes {
-          login
-          projectsV2(first: 50) {
-            nodes {
-              id
-              title
-              shortDescription
-              url
-              items { totalCount }
-            }
-          }
-        }
-      }
-    }
-  }
-`;
-const PROJECT_DETAIL_QUERY = `
-  query ProjectDetail($projectId: ID!) {
-    node(id: $projectId) {
-      __typename
-      ... on ProjectV2 {
-        id
-        title
-        url
-        fields(first: 50) {
-          nodes {
-            __typename
-            ... on ProjectV2SingleSelectField {
-              id
-              name
-              options {
-                id
-                name
-                description
-                color
-              }
-            }
-            ... on ProjectV2Field {
-              id
-              name
-              dataType
-            }
-          }
-        }
-        items(first: 100) {
-          nodes {
-            content {
-              __typename
-              ... on Issue {
-                repository {
-                  name
-                  url
-                  owner { login }
-                }
-              }
-              ... on PullRequest {
-                repository {
-                  name
-                  url
-                  owner { login }
-                }
-              }
-            }
-          }
-          pageInfo {
-            endCursor
-            hasNextPage
-          }
-        }
-      }
-    }
-  }
-`;
-const PROJECT_ITEMS_PAGE_QUERY = `
-  query ProjectItemsPage($projectId: ID!, $cursor: String) {
-    node(id: $projectId) {
-      ... on ProjectV2 {
-        items(first: 100, after: $cursor) {
-          nodes {
-            content {
-              __typename
-              ... on Issue {
-                repository {
-                  name
-                  url
-                  owner { login }
-                }
-              }
-              ... on PullRequest {
-                repository {
-                  name
-                  url
-                  owner { login }
-                }
-              }
-            }
-          }
-          pageInfo {
-            endCursor
-            hasNextPage
-          }
-        }
-      }
-    }
-  }
-`;

package/dist/github/gh-auth.d.ts

@@ -1,34 +0,0 @@
-import { execFileSync, spawnSync } from "node:child_process";
-type ExecImpl = typeof execFileSync;
-type SpawnImpl = typeof spawnSync;
-export declare class GhAuthError extends Error {
-    readonly code: "not_installed" | "not_authenticated" | "missing_scopes" | "token_failed";
-    constructor(code: "not_installed" | "not_authenticated" | "missing_scopes" | "token_failed", message: string);
-}
-export declare function checkGhInstalled(opts?: {
-    execImpl?: ExecImpl;
-}): boolean;
-export declare function checkGhAuthenticated(opts?: {
-    spawnImpl?: SpawnImpl;
-}): {
-    authenticated: boolean;
-    login?: string;
-};
-export declare function checkGhScopes(opts?: {
-    spawnImpl?: SpawnImpl;
-}): {
-    valid: boolean;
-    missing: string[];
-    scopes: string[];
-};
-export declare function getGhToken(opts?: {
-    execImpl?: ExecImpl;
-}): string;
-export declare function ensureGhAuth(opts?: {
-    execImpl?: ExecImpl;
-    spawnImpl?: SpawnImpl;
-}): {
-    login: string;
-    token: string;
-};
-export {};

package/dist/github/gh-auth.js

@@ -1,110 +0,0 @@
-import { execFileSync, spawnSync } from "node:child_process";
-const REQUIRED_SCOPES = ["repo", "read:org", "project"];
-export class GhAuthError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-        this.name = "GhAuthError";
-    }
-}
-export function checkGhInstalled(opts) {
-    const execImpl = opts?.execImpl ?? execFileSync;
-    try {
-        execImpl("gh", ["--version"], { stdio: "pipe" });
-        return true;
-    }
-    catch (error) {
-        const execError = error;
-        if (execError.code === "ENOENT") {
-            return false;
-        }
-        throw error;
-    }
-}
-export function checkGhAuthenticated(opts) {
-    const spawnImpl = opts?.spawnImpl ?? spawnSync;
-    const result = spawnImpl("gh", ["auth", "status"], {
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "pipe"],
-    });
-    if ((result.status ?? 1) !== 0) {
-        return { authenticated: false };
-    }
-    const login = parseLogin((result.stdout ?? "").toString());
-    return { authenticated: true, login };
-}
-export function checkGhScopes(opts) {
-    const spawnImpl = opts?.spawnImpl ?? spawnSync;
-    const result = spawnImpl("gh", ["auth", "status"], {
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "pipe"],
-    });
-    const output = (result.stdout ?? "").toString();
-    const scopes = parseScopes(output);
-    if (scopes.length === 0) {
-        return { valid: true, missing: [], scopes: [] };
-    }
-    const normalized = scopes.map((scope) => scope.toLowerCase());
-    const missing = REQUIRED_SCOPES.filter((scope) => !normalized.includes(scope));
-    return {
-        valid: missing.length === 0,
-        missing: [...missing],
-        scopes,
-    };
-}
-export function getGhToken(opts) {
-    if (process.env.GITHUB_GRAPHQL_TOKEN) {
-        return process.env.GITHUB_GRAPHQL_TOKEN;
-    }
-    const execImpl = opts?.execImpl ?? execFileSync;
-    try {
-        const token = execImpl("gh", ["auth", "token"], {
-            encoding: "utf8",
-            stdio: ["pipe", "pipe", "pipe"],
-        })
-            .toString()
-            .trim();
-        if (!token) {
-            throw new GhAuthError("token_failed", "gh auth token 실패. gh auth status 를 확인하세요.");
-        }
-        return token;
-    }
-    catch (error) {
-        if (error instanceof GhAuthError) {
-            throw error;
-        }
-        throw new GhAuthError("token_failed", "gh auth token 실패. gh auth status 를 확인하세요.");
-    }
-}
-export function ensureGhAuth(opts) {
-    const execImpl = opts?.execImpl ?? execFileSync;
-    const spawnImpl = opts?.spawnImpl ?? spawnSync;
-    if (!checkGhInstalled({ execImpl })) {
-        throw new GhAuthError("not_installed", "gh CLI가 설치되어 있지 않습니다. https://cli.github.com 에서 설치하세요.");
-    }
-    const auth = checkGhAuthenticated({ spawnImpl });
-    if (!auth.authenticated) {
-        throw new GhAuthError("not_authenticated", "gh auth login --scopes repo,read:org,project 를 실행하세요.");
-    }
-    const scopeCheck = checkGhScopes({ spawnImpl });
-    if (!scopeCheck.valid) {
-        throw new GhAuthError("missing_scopes", `gh auth refresh --scopes repo,read:org,project 를 실행하세요. (missing: ${scopeCheck.missing.join(", ")})`);
-    }
-    const token = getGhToken({ execImpl });
-    return { login: auth.login ?? "unknown", token };
-}
-function parseLogin(output) {
-    const matched = output.match(/Logged in to github\.com account\s+\*?\*?([A-Za-z0-9_-]+)\*?\*?/i);
-    return matched?.[1];
-}
-function parseScopes(output) {
-    const matched = output.match(/Token scopes:\s*(.+)/i);
-    if (!matched) {
-        return [];
-    }
-    return matched[1]
-        .split(",")
-        .map((scope) => scope.trim().replace(/^'+|'+$/g, ""))
-        .filter((scope) => scope.length > 0);
-}

package/dist/mapping/smart-defaults.d.ts

@@ -1,17 +0,0 @@
-import type { WorkflowLifecycleConfig } from "@gh-symphony/core";
-import type { StateRole, StateMapping } from "../config.js";
-export type StateRoleMapping = {
-    columnName: string;
-    role: StateRole | null;
-    confidence: "high" | "low";
-};
-export declare function inferStateRole(columnName: string): StateRoleMapping;
-export declare function inferAllStateRoles(columnNames: string[]): StateRoleMapping[];
-export declare function toWorkflowLifecycleConfig(stateFieldName: string, mappings: Record<string, StateMapping>): WorkflowLifecycleConfig;
-export type MappingValidationResult = {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-};
-export declare function validateStateMapping(mappings: Record<string, StateMapping>): MappingValidationResult;
-export declare function generateStatusMap(mappings: Record<string, StateMapping>): string;

package/dist/mapping/smart-defaults.js

@@ -1,86 +0,0 @@
-// ── 3.1: Smart defaults pattern matching ─────────────────────────────────────
-const ROLE_PATTERNS = [
-    {
-        role: "active",
-        pattern: /^(todo|to.do|to-do|ready|queued|open|new|triage|in.progress|working|active|doing|in.development|developing|wip)$/i,
-    },
-    {
-        role: "wait",
-        pattern: /^(review|in.review|pr.review|needs.review|plan.review|awaiting.review|code.review|icebox|someday|later|blocked|on.hold|paused|deferred|draft|backlog)$/i,
-    },
-    {
-        role: "terminal",
-        pattern: /^(done|completed?|closed|merged|shipped|resolved|finished|won.?t.do|cancelled)$/i,
-    },
-];
-export function inferStateRole(columnName) {
-    const normalized = columnName.trim();
-    for (const { role, pattern } of ROLE_PATTERNS) {
-        if (pattern.test(normalized)) {
-            return { columnName: normalized, role, confidence: "high" };
-        }
-    }
-    return { columnName: normalized, role: null, confidence: "low" };
-}
-export function inferAllStateRoles(columnNames) {
-    return columnNames.map(inferStateRole);
-}
-// ── 3.2: Mapping → WorkflowLifecycleConfig conversion ───────────────────────
-export function toWorkflowLifecycleConfig(stateFieldName, mappings) {
-    const activeStates = [];
-    const terminalStates = [];
-    const blockerCheckStates = [];
-    for (const [columnName, mapping] of Object.entries(mappings)) {
-        switch (mapping.role) {
-            case "active":
-                activeStates.push(columnName);
-                break;
-            case "terminal":
-                terminalStates.push(columnName);
-                break;
-            case "wait":
-                // Wait states are neither active nor terminal
-                break;
-        }
-    }
-    // Default blocker check: first active state (typically "Todo"-like)
-    if (activeStates.length > 0) {
-        blockerCheckStates.push(activeStates[0]);
-    }
-    return {
-        stateFieldName,
-        activeStates,
-        terminalStates,
-        blockerCheckStates,
-    };
-}
-export function validateStateMapping(mappings) {
-    const errors = [];
-    const warnings = [];
-    const entries = Object.entries(mappings);
-    const activeEntries = entries.filter(([, m]) => m.role === "active");
-    const terminalEntries = entries.filter(([, m]) => m.role === "terminal");
-    // Required: at least one active and one terminal
-    if (activeEntries.length === 0) {
-        errors.push("Missing required role: 'active' — at least one state must be active.");
-    }
-    if (terminalEntries.length === 0) {
-        errors.push("Missing required role: 'terminal' — at least one state must be terminal.");
-    }
-    // Warnings
-    if (terminalEntries.length > 1) {
-        warnings.push(`Multiple terminal states: ${terminalEntries.map(([n]) => n).join(", ")}. ` +
-            "All will be treated as terminal states.");
-    }
-    return { valid: errors.length === 0, errors, warnings };
-}
-// ── 3.5: Status Map generation ──────────────────────────────────────────────
-export function generateStatusMap(mappings) {
-    const lines = ["## Status Map", ""];
-    for (const [columnName, mapping] of Object.entries(mappings)) {
-        const rolePart = `[${mapping.role}]`;
-        const goalPart = mapping.goal ? ` — ${mapping.goal}` : "";
-        lines.push(`- **${columnName}** ${rolePart}${goalPart}`);
-    }
-    return lines.join("\n");
-}

package/dist/orchestrator-runtime.d.ts

@@ -1 +0,0 @@
-export declare function resolveRuntimeRoot(configDir: string): string;

package/dist/orchestrator-runtime.js

@@ -1,4 +0,0 @@
-import { resolve } from "node:path";
-export function resolveRuntimeRoot(configDir) {
-    return resolve(configDir);
-}

package/dist/orchestrator-status-endpoint.d.ts

@@ -1,5 +0,0 @@
-export declare function resolveProjectOrchestratorStatusBaseUrl(input: {
-    configDir: string;
-    projectId: string;
-    env?: NodeJS.ProcessEnv;
-}): Promise<string | null>;