@sascha384/tic 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fa-krug
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# tic
+
+A terminal UI for issue tracking, built for developers who live in the terminal. Track work items as markdown files stored right in your repository.
+
+Built with TypeScript and [Ink](https://github.com/vadimdemedes/ink).
+
+## Features
+
+- **Keyboard-driven TUI** — browse, create, edit, and manage work items without leaving the terminal
+- **Local markdown storage** — work items stored as markdown files with YAML frontmatter in a `.tic/` directory
+- **Work item types** — organize by epic, issue, and task (configurable)
+- **Iterations** — group work into sprints or milestones
+- **Parent-child relationships** — build hierarchies with tree-indented views
+- **Dependencies** — track which items block others, with warnings on premature completion
+- **Priority & assignee** — track who owns what and what's most important
+- **Comments** — add timestamped comments to any work item
+
+## Installation
+
+```bash
+npm install -g tic
+```
+
+## Quick Start
+
+```bash
+cd your-project
+tic
+```
+
+This launches the TUI. On first run, tic automatically creates a `.tic/` directory to store your work items. No setup or init command needed.
+
+## Usage
+
+### List View
+
+The main screen shows work items filtered by type and iteration, displayed as a tree that reflects parent-child relationships.
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Navigate between items |
+| `Enter` | Edit selected item |
+| `c` | Create new work item |
+| `d` | Delete selected item (with confirmation) |
+| `s` | Cycle status forward |
+| `p` | Set parent for selected item |
+| `Tab` | Switch work item type (epic / issue / task) |
+| `i` | Switch iteration |
+| `q` | Quit |
+
+The list displays ID, title (tree-indented), status, priority, and assignee. Items with dependencies show a `⧗` indicator.
+
+### Editing a Work Item
+
+Press `Enter` on an item or `c` to create one. The form has these fields:
+
+- **Title** — name of the work item
+- **Type** — epic, issue, or task
+- **Status** — backlog, todo, in-progress, review, done
+- **Iteration** — which sprint/milestone this belongs to
+- **Priority** — low, medium, high, critical
+- **Assignee** — who owns this
+- **Labels** — comma-separated tags
+- **Parent** — ID of the parent item
+- **Depends On** — comma-separated IDs of items this depends on
+- **Description** — full details (multi-line)
+- **Comments** — add new comments; existing comments shown as read-only
+
+Navigate fields with `↑` `↓`, press `Enter` to edit a field, and `Esc` to save and return to the list.
+
+### Iterations
+
+Press `i` in the list view to open the iteration picker. The current iteration filters which items you see. New iterations are created automatically when you assign an item to one that doesn't exist yet.
+
+### Relationships
+
+**Parent-child:** Set a parent ID on an item to nest it under another. Children appear indented in the tree view. Circular parent chains are prevented.
+
+**Dependencies:** Add dependency IDs to indicate that an item is blocked by others. When you try to complete an item that has open children or unresolved dependencies, tic shows a warning so you can decide whether to proceed.
+
+Deleting an item automatically cleans up references — children have their parent cleared, and the item is removed from other items' dependency lists.
+
+## Storage
+
+Work items live in `.tic/` at the root of your project:
+
+```
+.tic/
+├── config.yml          # Types, statuses, iterations, settings
+└── items/
+    ├── 1.md            # Work item #1
+    ├── 2.md            # Work item #2
+    └── ...
+```
+
+Each item is a markdown file with YAML frontmatter:
+
+```markdown
+---
+id: 1
+title: Implement user login
+type: task
+status: in-progress
+iteration: sprint-1
+priority: high
+assignee: alice
+labels: auth, backend
+parent: 3
+depends_on:
+  - 2
+created: 2026-01-15T10:00:00.000Z
+updated: 2026-01-20T14:30:00.000Z
+---
+
+Full description of the work item goes here.
+
+## Comments
+
+---
+author: alice
+date: 2026-01-18T09:00:00.000Z
+
+Decided to use JWT tokens for this.
+```
+
+Configuration in `.tic/config.yml`:
+
+```yaml
+types:
+  - epic
+  - issue
+  - task
+statuses:
+  - backlog
+  - todo
+  - in-progress
+  - review
+  - done
+iterations:
+  - default
+current_iteration: default
+next_id: 1
+```
+
+You can edit these files directly — they're plain text. Customize types, statuses, and iterations by editing `config.yml`.
+
+## MCP Server
+
+tic includes a built-in [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that exposes your work items to AI assistants like Claude. This lets AI tools read, create, update, and manage your issues without leaving the conversation.
+
+### Starting the Server
+
+```bash
+tic mcp serve
+```
+
+The server communicates over stdio using the MCP protocol.
+
+### Connecting to Claude Code
+
+Add tic as an MCP server in your project:
+
+```bash
+claude mcp add --scope project --transport stdio tic -- npx tic mcp serve
+```
+
+Or create a `.mcp.json` file in your project root:
+
+```json
+{
+  "mcpServers": {
+    "tic": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["tic", "mcp", "serve"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+The MCP server exposes 14 tools:
+
+| Tool | Description |
+|------|-------------|
+| `init_project` | Initialize a new tic project (creates `.tic/` directory) |
+| `get_config` | Get project configuration (statuses, types, iterations) |
+| `list_items` | List work items with optional filters by type, status, or iteration |
+| `show_item` | Show full details of a single work item |
+| `create_item` | Create a new work item with title, type, status, priority, and more |
+| `update_item` | Update any field on an existing work item |
+| `delete_item` | Preview deleting a work item (shows affected children and dependents) |
+| `confirm_delete` | Confirm and execute a previously previewed deletion |
+| `add_comment` | Add a timestamped comment to a work item |
+| `set_iteration` | Set the current active iteration |
+| `search_items` | Search work items by text query across titles and descriptions |
+| `get_children` | Get child items of a specific work item |
+| `get_dependents` | Get items that depend on a specific work item |
+| `get_item_tree` | Get work items as a hierarchical tree structure |
+
+### Safety
+
+Deletion is a two-step process: `delete_item` returns a preview of what will be affected (children that will be unparented, dependents that will lose a dependency), and `confirm_delete` must be called separately to actually remove the item. This prevents accidental data loss when AI tools are managing your issues.
+
+If the server is started in a directory without a `.tic/` project, all tools except `init_project` will return an error asking you to initialize first.
+
+## Roadmap
+
+Planned but not yet implemented:
+
+- **Multi-backend support** — GitHub (via `gh`), GitLab (via `glab`), Azure DevOps (via `az`)
+- **Automatic backend detection** — select backend based on git remote
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, architecture, and conventions.
+
+## License
+
+[MIT](LICENSE)

package/dist/app.d.ts

@@ -0,0 +1,17 @@
+import type { Backend } from './backends/types.js';
+type Screen = 'list' | 'form' | 'iteration-picker' | 'settings';
+interface AppState {
+    screen: Screen;
+    selectedWorkItemId: string | null;
+    activeType: string | null;
+    backend: Backend;
+    navigate: (screen: Screen) => void;
+    selectWorkItem: (id: string | null) => void;
+    setActiveType: (type: string | null) => void;
+}
+export declare const AppContext: import("react").Context<AppState>;
+export declare function useAppState(): AppState;
+export declare function App({ backend }: {
+    backend: Backend;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/app.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, createContext, useContext } from 'react';
+import { Box } from 'ink';
+import { WorkItemList } from './components/WorkItemList.js';
+import { WorkItemForm } from './components/WorkItemForm.js';
+import { IterationPicker } from './components/IterationPicker.js';
+import { Settings } from './components/Settings.js';
+export const AppContext = createContext(null);
+export function useAppState() {
+    return useContext(AppContext);
+}
+export function App({ backend }) {
+    const [screen, setScreen] = useState('list');
+    const [selectedWorkItemId, setSelectedWorkItemId] = useState(null);
+    const [activeType, setActiveType] = useState(null);
+    const state = {
+        screen,
+        selectedWorkItemId,
+        activeType,
+        backend,
+        navigate: setScreen,
+        selectWorkItem: setSelectedWorkItemId,
+        setActiveType,
+    };
+    return (_jsx(AppContext.Provider, { value: state, children: _jsxs(Box, { flexDirection: "column", children: [screen === 'list' && _jsx(WorkItemList, {}), screen === 'form' && _jsx(WorkItemForm, {}), screen === 'iteration-picker' && _jsx(IterationPicker, {}), screen === 'settings' && _jsx(Settings, {})] }) }));
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAepD,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAW,IAAK,CAAC,CAAC;AAEzD,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,EAAE,OAAO,EAAwB;IACnD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAS,MAAM,CAAC,CAAC;IACrD,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAC1D,IAAI,CACL,CAAC;IACF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAElE,MAAM,KAAK,GAAa;QACtB,MAAM;QACN,kBAAkB;QAClB,UAAU;QACV,OAAO;QACP,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,qBAAqB;QACrC,aAAa;KACd,CAAC;IAEF,OAAO,CACL,KAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC/B,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACxB,MAAM,KAAK,MAAM,IAAI,KAAC,YAAY,KAAG,EACrC,MAAM,KAAK,MAAM,IAAI,KAAC,YAAY,KAAG,EACrC,MAAM,KAAK,kBAAkB,IAAI,KAAC,eAAe,KAAG,EACpD,MAAM,KAAK,UAAU,IAAI,KAAC,QAAQ,KAAG,IAClC,GACc,CACvB,CAAC;AACJ,CAAC"}

package/dist/backends/factory.d.ts

@@ -0,0 +1,5 @@
+import type { Backend } from './types.js';
+export declare const VALID_BACKENDS: readonly ["local", "github", "gitlab", "azure"];
+export type BackendType = (typeof VALID_BACKENDS)[number];
+export declare function detectBackend(root: string): BackendType;
+export declare function createBackend(root: string): Backend;

package/dist/backends/factory.js

@@ -0,0 +1,42 @@
+import { execSync } from 'node:child_process';
+import { LocalBackend } from './local/index.js';
+import { GitHubBackend } from './github/index.js';
+import { GitLabBackend } from './gitlab/index.js';
+import { readConfig } from './local/config.js';
+export const VALID_BACKENDS = ['local', 'github', 'gitlab', 'azure'];
+export function detectBackend(root) {
+    try {
+        const output = execSync('git remote -v', {
+            cwd: root,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (output.includes('github.com'))
+            return 'github';
+        if (output.includes('gitlab.com'))
+            return 'gitlab';
+        if (output.includes('dev.azure.com'))
+            return 'azure';
+    }
+    catch {
+        // Not a git repo or git not available
+    }
+    return 'local';
+}
+export function createBackend(root) {
+    const config = readConfig(root);
+    const backend = config.backend ?? 'local';
+    switch (backend) {
+        case 'local':
+            return new LocalBackend(root);
+        case 'github':
+            return new GitHubBackend(root);
+        case 'gitlab':
+            return new GitLabBackend(root);
+        case 'azure':
+            throw new Error(`Backend "${backend}" is not yet implemented. Use "local" for now.`);
+        default:
+            throw new Error(`Unknown backend "${backend}". Valid backends: ${VALID_BACKENDS.join(', ')}`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/backends/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backends/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAG9E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,EAAE;YACvC,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,QAAQ,CAAC;QACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,QAAQ,CAAC;QACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC;YAAE,OAAO,OAAO,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC;IAE1C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,gDAAgD,CACpE,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,sBAAsB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7E,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/backends/github/gh.d.ts

@@ -0,0 +1,2 @@
+export declare function gh<T>(args: string[], cwd: string): T;
+export declare function ghExec(args: string[], cwd: string): string;

package/dist/backends/github/gh.js

@@ -0,0 +1,17 @@
+import { execFileSync } from 'node:child_process';
+export function gh(args, cwd) {
+    const result = execFileSync('gh', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    return JSON.parse(result);
+}
+export function ghExec(args, cwd) {
+    return execFileSync('gh', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+}
+//# sourceMappingURL=gh.js.map

package/dist/backends/github/gh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.js","sourceRoot":"","sources":["../../../src/backends/github/gh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,EAAE,CAAI,IAAc,EAAE,GAAW;IAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE;QACtC,GAAG;QACH,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAc,EAAE,GAAW;IAChD,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE;QAC9B,GAAG;QACH,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/backends/github/index.d.ts

@@ -0,0 +1,26 @@
+import { BaseBackend } from '../types.js';
+import type { BackendCapabilities } from '../types.js';
+import type { WorkItem, NewWorkItem, NewComment, Comment } from '../../types.js';
+export declare class GitHubBackend extends BaseBackend {
+    private cwd;
+    constructor(cwd: string);
+    getCapabilities(): BackendCapabilities;
+    getStatuses(): string[];
+    getWorkItemTypes(): string[];
+    getIterations(): string[];
+    getCurrentIteration(): string;
+    setCurrentIteration(_name: string): void;
+    listWorkItems(iteration?: string): WorkItem[];
+    getWorkItem(id: string): WorkItem;
+    createWorkItem(data: NewWorkItem): WorkItem;
+    updateWorkItem(id: string, data: Partial<WorkItem>): WorkItem;
+    deleteWorkItem(id: string): void;
+    addComment(workItemId: string, comment: NewComment): Comment;
+    getChildren(id: string): WorkItem[];
+    getDependents(id: string): WorkItem[];
+    getItemUrl(id: string): string;
+    openItem(id: string): void;
+    private fetchMilestones;
+    private fetchOpenMilestones;
+    private getRepoNwo;
+}

package/dist/backends/github/index.js

@@ -0,0 +1,188 @@
+import { BaseBackend } from '../types.js';
+import { gh, ghExec } from './gh.js';
+import { mapIssueToWorkItem } from './mappers.js';
+const ISSUE_FIELDS = 'number,title,body,state,assignees,labels,milestone,createdAt,updatedAt,comments';
+export class GitHubBackend extends BaseBackend {
+    cwd;
+    constructor(cwd) {
+        super();
+        this.cwd = cwd;
+        ghExec(['auth', 'status'], cwd);
+    }
+    getCapabilities() {
+        return {
+            relationships: false,
+            customTypes: false,
+            customStatuses: false,
+            iterations: true,
+            comments: true,
+            fields: {
+                priority: false,
+                assignee: true,
+                labels: true,
+                parent: false,
+                dependsOn: false,
+            },
+        };
+    }
+    getStatuses() {
+        return ['open', 'closed'];
+    }
+    getWorkItemTypes() {
+        return ['issue'];
+    }
+    getIterations() {
+        const milestones = this.fetchMilestones();
+        return milestones.map((m) => m.title);
+    }
+    getCurrentIteration() {
+        const milestones = this.fetchOpenMilestones();
+        if (milestones.length === 0)
+            return '';
+        return milestones[0].title;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    setCurrentIteration(_name) {
+        // No-op — current iteration is always first open milestone
+    }
+    listWorkItems(iteration) {
+        const args = [
+            'issue',
+            'list',
+            '--state',
+            'all',
+            '--json',
+            ISSUE_FIELDS,
+            '--limit',
+            '500',
+        ];
+        if (iteration) {
+            args.push('--milestone', iteration);
+        }
+        const issues = gh(args, this.cwd);
+        return issues.map(mapIssueToWorkItem);
+    }
+    getWorkItem(id) {
+        const issue = gh(['issue', 'view', id, '--json', ISSUE_FIELDS], this.cwd);
+        return mapIssueToWorkItem(issue);
+    }
+    createWorkItem(data) {
+        this.validateFields(data);
+        const args = ['issue', 'create', '--title', data.title];
+        if (data.description) {
+            args.push('--body', data.description);
+        }
+        if (data.assignee) {
+            args.push('--assignee', data.assignee);
+        }
+        if (data.iteration) {
+            args.push('--milestone', data.iteration);
+        }
+        for (const label of data.labels) {
+            args.push('--label', label);
+        }
+        const output = ghExec(args, this.cwd);
+        // gh issue create prints the URL: https://github.com/owner/repo/issues/123
+        const match = output.match(/\/issues\/(\d+)/);
+        if (!match) {
+            throw new Error('Failed to parse issue number from gh output');
+        }
+        const id = match[1];
+        return this.getWorkItem(id);
+    }
+    updateWorkItem(id, data) {
+        this.validateFields(data);
+        // Handle status changes via close/reopen
+        if (data.status === 'closed') {
+            ghExec(['issue', 'close', id], this.cwd);
+        }
+        else if (data.status === 'open') {
+            ghExec(['issue', 'reopen', id], this.cwd);
+        }
+        // Handle field edits
+        const editArgs = ['issue', 'edit', id];
+        let hasEdits = false;
+        if (data.title !== undefined) {
+            editArgs.push('--title', data.title);
+            hasEdits = true;
+        }
+        if (data.description !== undefined) {
+            editArgs.push('--body', data.description);
+            hasEdits = true;
+        }
+        if (data.iteration !== undefined) {
+            if (data.iteration) {
+                editArgs.push('--milestone', data.iteration);
+            }
+            else {
+                editArgs.push('--remove-milestone');
+            }
+            hasEdits = true;
+        }
+        if (data.assignee !== undefined) {
+            if (data.assignee) {
+                editArgs.push('--add-assignee', data.assignee);
+            }
+            hasEdits = true;
+        }
+        if (data.labels !== undefined) {
+            for (const label of data.labels) {
+                editArgs.push('--add-label', label);
+            }
+            hasEdits = true;
+        }
+        if (hasEdits) {
+            ghExec(editArgs, this.cwd);
+        }
+        return this.getWorkItem(id);
+    }
+    deleteWorkItem(id) {
+        ghExec(['issue', 'delete', id, '--yes'], this.cwd);
+    }
+    addComment(workItemId, comment) {
+        ghExec(['issue', 'comment', workItemId, '--body', comment.body], this.cwd);
+        return {
+            author: comment.author,
+            date: new Date().toISOString(),
+            body: comment.body,
+        };
+    }
+    getChildren(id) {
+        this.assertSupported(this.getCapabilities().relationships, 'relationships');
+        return this.listWorkItems().filter((item) => item.parent === id);
+    }
+    getDependents(id) {
+        this.assertSupported(this.getCapabilities().relationships, 'relationships');
+        return this.listWorkItems().filter((item) => item.dependsOn.includes(id));
+    }
+    getItemUrl(id) {
+        const result = gh(['issue', 'view', id, '--json', 'url'], this.cwd);
+        return result.url;
+    }
+    openItem(id) {
+        ghExec(['issue', 'view', id, '--web'], this.cwd);
+    }
+    fetchMilestones() {
+        const owner = this.getRepoNwo();
+        return gh(['api', `repos/${owner}/milestones`, '--jq', '.'], this.cwd);
+    }
+    fetchOpenMilestones() {
+        const milestones = this.fetchMilestones();
+        return milestones
+            .filter((m) => m.state === 'open')
+            .sort((a, b) => {
+            if (!a.due_on && !b.due_on)
+                return 0;
+            if (!a.due_on)
+                return 1;
+            if (!b.due_on)
+                return -1;
+            return a.due_on.localeCompare(b.due_on);
+        });
+    }
+    getRepoNwo() {
+        const result = gh(['repo', 'view', '--json', 'nameWithOwner'], this.cwd);
+        return result.nameWithOwner;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/backends/github/index.js.map

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

package/dist/backends/github/mappers.d.ts

@@ -0,0 +1,33 @@
+import type { WorkItem, Comment } from '../../types.js';
+export interface GhIssue {
+    number: number;
+    title: string;
+    body: string | null;
+    state: string;
+    assignees: {
+        login: string;
+    }[];
+    labels: {
+        name: string;
+    }[];
+    milestone: {
+        title: string;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+    comments?: GhComment[];
+}
+export interface GhComment {
+    author: {
+        login: string;
+    };
+    createdAt: string;
+    body: string;
+}
+export interface GhMilestone {
+    title: string;
+    state: string;
+    due_on: string | null;
+}
+export declare function mapCommentToComment(ghComment: GhComment): Comment;
+export declare function mapIssueToWorkItem(ghIssue: GhIssue): WorkItem;

package/dist/backends/github/mappers.js

@@ -0,0 +1,26 @@
+export function mapCommentToComment(ghComment) {
+    return {
+        author: ghComment.author.login,
+        date: ghComment.createdAt,
+        body: ghComment.body,
+    };
+}
+export function mapIssueToWorkItem(ghIssue) {
+    return {
+        id: String(ghIssue.number),
+        title: ghIssue.title,
+        description: ghIssue.body ?? '',
+        status: ghIssue.state === 'OPEN' ? 'open' : 'closed',
+        type: 'issue',
+        assignee: ghIssue.assignees[0]?.login ?? '',
+        labels: ghIssue.labels.map((l) => l.name),
+        iteration: ghIssue.milestone?.title ?? '',
+        priority: 'medium',
+        created: ghIssue.createdAt,
+        updated: ghIssue.updatedAt,
+        parent: null,
+        dependsOn: [],
+        comments: (ghIssue.comments ?? []).map(mapCommentToComment),
+    };
+}
+//# sourceMappingURL=mappers.js.map

package/dist/backends/github/mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../src/backends/github/mappers.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK;QAC9B,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,IAAI,EAAE,SAAS,CAAC,IAAI;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QAC/B,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACpD,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QACzC,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,OAAO,CAAC,SAAS;QAC1B,OAAO,EAAE,OAAO,CAAC,SAAS;QAC1B,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/backends/gitlab/glab.d.ts

@@ -0,0 +1,2 @@
+export declare function glab<T>(args: string[], cwd: string): T;
+export declare function glabExec(args: string[], cwd: string): string;