@reqord/cli 0.1.0

package/dist/services/issue-fetch-service.d.ts

@@ -0,0 +1,24 @@
+export interface FetchOptions {
+    specId?: string;
+    dryRun?: boolean;
+}
+export interface SpecFetchResult {
+    specId: string;
+    issueCount: number;
+    totalEstimatedHours: number;
+    previousIssueCount: number;
+    updated: boolean;
+}
+export interface OrphanIssue {
+    number: number;
+    title: string;
+    specId: string;
+}
+export interface FetchResult {
+    specsUpdated: SpecFetchResult[];
+    issuesWithoutSpec: OrphanIssue[];
+    totalIssuesFetched: number;
+    totalIssuesWithTag: number;
+}
+export declare function fetchIssues(cwd: string, options?: FetchOptions): Promise<FetchResult>;
+//# sourceMappingURL=issue-fetch-service.d.ts.map

package/dist/services/issue-fetch-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-fetch-service.d.ts","sourceRoot":"","sources":["../../src/services/issue-fetch-service.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AA4BD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CA2GtB"}

package/dist/services/issue-fetch-service.js

@@ -0,0 +1,109 @@
+import * as specRepo from "../repositories/specification.js";
+import * as githubClient from "./github-client.js";
+import * as fs from "../repositories/file-system.js";
+import { parseSpecTag } from "../utils/spec-tag-parser.js";
+import { TasksIndexSchema, REQORD_DIR, ISSUES_DIR } from "@reqord/shared";
+async function loadTasksYaml(cwd) {
+    const tasksPath = fs.joinPath(cwd, REQORD_DIR, ISSUES_DIR, "tasks.yaml");
+    const raw = await fs.readYAML(tasksPath).catch(() => null);
+    if (!raw)
+        return { title: "Tasks", tasks: [] };
+    const parsed = TasksIndexSchema.safeParse(raw);
+    if (!parsed.success)
+        return { title: "Tasks", tasks: [] };
+    return parsed.data;
+}
+async function saveTasksYaml(cwd, data) {
+    const tasksPath = fs.joinPath(cwd, REQORD_DIR, ISSUES_DIR, "tasks.yaml");
+    await fs.writeYAML(tasksPath, data);
+}
+export async function fetchIssues(cwd, options) {
+    const allIssues = await githubClient.listAllIssues("all", 500);
+    const repoUrl = await githubClient.getRepoUrl();
+    const parsedIssues = [];
+    for (const issue of allIssues) {
+        if (!issue.body)
+            continue;
+        const metadata = parseSpecTag(issue.body);
+        if (metadata) {
+            parsedIssues.push({
+                number: issue.number,
+                title: issue.title,
+                state: issue.state,
+                metadata,
+            });
+        }
+    }
+    const groupedBySpec = new Map();
+    for (const parsed of parsedIssues) {
+        const specId = parsed.metadata.specificationId;
+        if (!groupedBySpec.has(specId)) {
+            groupedBySpec.set(specId, []);
+        }
+        groupedBySpec.get(specId).push(parsed);
+    }
+    if (options?.specId) {
+        const filtered = new Map();
+        if (groupedBySpec.has(options.specId)) {
+            filtered.set(options.specId, groupedBySpec.get(options.specId));
+        }
+        groupedBySpec.clear();
+        for (const [k, v] of filtered) {
+            groupedBySpec.set(k, v);
+        }
+    }
+    const specsUpdated = [];
+    const issuesWithoutSpec = [];
+    const tasksIndex = await loadTasksYaml(cwd);
+    for (const [specId, issues] of groupedBySpec) {
+        const spec = await specRepo.findById(cwd, specId);
+        if (!spec) {
+            for (const issue of issues) {
+                issuesWithoutSpec.push({
+                    number: issue.number,
+                    title: issue.title,
+                    specId,
+                });
+            }
+            continue;
+        }
+        const previousIssueCount = tasksIndex.tasks.filter((t) => t.linkedTo.specifications.includes(specId)).length;
+        const totalEstimatedHours = issues.reduce((sum, issue) => sum + (issue.metadata.estimatedHours ?? 0), 0);
+        for (const issue of issues) {
+            const existingIdx = tasksIndex.tasks.findIndex((t) => t.number === issue.number);
+            const taskEntry = {
+                number: issue.number,
+                title: issue.title,
+                url: `${repoUrl}/issues/${issue.number}`,
+                linkedTo: { specifications: [specId] },
+                priority: issue.metadata.priority ?? "P2",
+                status: issue.state,
+                estimatedHours: issue.metadata.estimatedHours,
+                syncedAt: new Date().toISOString(),
+            };
+            if (existingIdx >= 0) {
+                tasksIndex.tasks[existingIdx] = taskEntry;
+            }
+            else {
+                tasksIndex.tasks.push(taskEntry);
+            }
+        }
+        specsUpdated.push({
+            specId,
+            issueCount: issues.length,
+            totalEstimatedHours,
+            previousIssueCount,
+            updated: !options?.dryRun,
+        });
+    }
+    if (!options?.dryRun && specsUpdated.length > 0) {
+        await saveTasksYaml(cwd, tasksIndex);
+    }
+    return {
+        specsUpdated,
+        issuesWithoutSpec,
+        totalIssuesFetched: allIssues.length,
+        totalIssuesWithTag: parsedIssues.length,
+    };
+}
+//# sourceMappingURL=issue-fetch-service.js.map

package/dist/services/issue-fetch-service.js.map

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

package/dist/services/issue-fetch-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=issue-fetch-service.test.d.ts.map

package/dist/services/issue-fetch-service.test.d.ts.map

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

package/dist/services/issue-fetch-service.test.js

@@ -0,0 +1,243 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+vi.mock("../repositories/specification.js", () => ({
+    findById: vi.fn(),
+    findAll: vi.fn(),
+    save: vi.fn(),
+}));
+vi.mock("./github-client.js", () => ({
+    listAllIssues: vi.fn(),
+    getRepoUrl: vi.fn(),
+}));
+vi.mock("../repositories/file-system.js", () => ({
+    joinPath: vi.fn((...args) => args.join("/")),
+    readYAML: vi.fn(),
+    writeYAML: vi.fn(),
+    getReqordDir: vi.fn(),
+}));
+import { fetchIssues } from "./issue-fetch-service.js";
+import * as specRepo from "../repositories/specification.js";
+import * as githubClient from "./github-client.js";
+import * as fs from "../repositories/file-system.js";
+const SPEC_TAG_22_P1 = '<!-- reqord:specification {"specificationId":"spec-000022","priority":"P1","estimatedHours":8} -->\n\n## Task 1';
+const SPEC_TAG_22_P2 = '<!-- reqord:specification {"specificationId":"spec-000022","priority":"P2","estimatedHours":4} -->\n\n## Task 2';
+const SPEC_TAG_22_SIMPLE = '<!-- reqord:specification {"specificationId":"spec-000022"} -->';
+const SPEC_TAG_25_SIMPLE = '<!-- reqord:specification {"specificationId":"spec-000025"} -->';
+const SPEC_TAG_999 = '<!-- reqord:specification {"specificationId":"spec-999999"} -->';
+function makeSpec(id, overrides) {
+    return {
+        id,
+        requirementId: "req-000001",
+        version: "1.0.0",
+        status: "approved",
+        createdAt: "2026-01-01T00:00:00Z",
+        updatedAt: "2026-01-01T00:00:00Z",
+        versionHistory: [],
+        files: { design: `specifications/${id}/design.md`, supplementary: [] },
+        ...overrides,
+    };
+}
+describe("fetchIssues", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(githubClient.getRepoUrl).mockResolvedValue("https://github.com/owner/repo");
+        vi.mocked(fs.readYAML).mockResolvedValue({ title: "Tasks", tasks: [] });
+        vi.mocked(fs.writeYAML).mockResolvedValue(undefined);
+    });
+    it("fetches issues and writes to tasks.yaml", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 101,
+                title: "Task 1",
+                state: "open",
+                labels: ["reqord-generated"],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_P1,
+            },
+            {
+                number: 102,
+                title: "Task 2",
+                state: "closed",
+                labels: ["reqord-generated"],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_P2,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(makeSpec("spec-000022"));
+        const result = await fetchIssues("/cwd");
+        expect(result.totalIssuesFetched).toBe(2);
+        expect(result.totalIssuesWithTag).toBe(2);
+        expect(result.specsUpdated).toHaveLength(1);
+        expect(result.specsUpdated[0].specId).toBe("spec-000022");
+        expect(result.specsUpdated[0].issueCount).toBe(2);
+        expect(result.specsUpdated[0].totalEstimatedHours).toBe(12);
+        expect(result.specsUpdated[0].updated).toBe(true);
+        expect(fs.writeYAML).toHaveBeenCalledTimes(1);
+        const savedData = vi.mocked(fs.writeYAML).mock.calls[0][1];
+        expect(savedData.tasks).toHaveLength(2);
+        expect(savedData.tasks[0]).toMatchObject({
+            number: 101,
+            title: "Task 1",
+            url: "https://github.com/owner/repo/issues/101",
+            priority: "P1",
+            status: "open",
+        });
+        expect(savedData.tasks[1]).toMatchObject({
+            number: 102,
+            priority: "P2",
+            status: "closed",
+        });
+    });
+    it("does not write when dryRun is true", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 101,
+                title: "Task 1",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_SIMPLE,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(makeSpec("spec-000022"));
+        const result = await fetchIssues("/cwd", { dryRun: true });
+        expect(fs.writeYAML).not.toHaveBeenCalled();
+        expect(result.specsUpdated[0].updated).toBe(false);
+    });
+    it("filters by specId when provided", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 101,
+                title: "Task for 22",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_SIMPLE,
+            },
+            {
+                number: 102,
+                title: "Task for 25",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_25_SIMPLE,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(makeSpec("spec-000022"));
+        const result = await fetchIssues("/cwd", { specId: "spec-000022" });
+        expect(result.specsUpdated).toHaveLength(1);
+        expect(result.specsUpdated[0].specId).toBe("spec-000022");
+        expect(specRepo.findById).toHaveBeenCalledTimes(1);
+        expect(specRepo.findById).toHaveBeenCalledWith("/cwd", "spec-000022");
+    });
+    it("reports orphan issues when spec does not exist locally", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 200,
+                title: "Orphan task",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_999,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(null);
+        const result = await fetchIssues("/cwd");
+        expect(result.issuesWithoutSpec).toHaveLength(1);
+        expect(result.issuesWithoutSpec[0]).toEqual({
+            number: 200,
+            title: "Orphan task",
+            specId: "spec-999999",
+        });
+        expect(result.specsUpdated).toHaveLength(0);
+        expect(fs.writeYAML).not.toHaveBeenCalled();
+    });
+    it("skips issues without body or without spec tag", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 1,
+                title: "No body",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+            },
+            {
+                number: 2,
+                title: "No tag",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: "## Just a normal issue",
+            },
+            {
+                number: 3,
+                title: "With tag",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_SIMPLE,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(makeSpec("spec-000022"));
+        const result = await fetchIssues("/cwd");
+        expect(result.totalIssuesFetched).toBe(3);
+        expect(result.totalIssuesWithTag).toBe(1);
+        expect(result.specsUpdated).toHaveLength(1);
+        expect(result.specsUpdated[0].issueCount).toBe(1);
+    });
+    it("defaults priority to P2 when tag has no priority", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 101,
+                title: "Task 1",
+                state: "open",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_SIMPLE,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(makeSpec("spec-000022"));
+        await fetchIssues("/cwd");
+        const savedData = vi.mocked(fs.writeYAML).mock.calls[0][1];
+        expect(savedData.tasks[0].priority).toBe("P2");
+    });
+    it("handles empty result when no issues exist", async () => {
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([]);
+        const result = await fetchIssues("/cwd");
+        expect(result.totalIssuesFetched).toBe(0);
+        expect(result.totalIssuesWithTag).toBe(0);
+        expect(result.specsUpdated).toHaveLength(0);
+        expect(result.issuesWithoutSpec).toHaveLength(0);
+        expect(fs.writeYAML).not.toHaveBeenCalled();
+    });
+    it("upserts existing tasks by issue number", async () => {
+        vi.mocked(fs.readYAML).mockResolvedValue({
+            title: "Tasks",
+            tasks: [{
+                    number: 101,
+                    title: "Old Title",
+                    url: "https://github.com/owner/repo/issues/101",
+                    linkedTo: { specifications: ["spec-000022"] },
+                    priority: "P1",
+                    status: "open",
+                    syncedAt: "2026-01-01T00:00:00Z",
+                }],
+        });
+        vi.mocked(githubClient.listAllIssues).mockResolvedValue([
+            {
+                number: 101,
+                title: "New Title",
+                state: "closed",
+                labels: [],
+                createdAt: "2026-01-01T00:00:00Z",
+                body: SPEC_TAG_22_SIMPLE,
+            },
+        ]);
+        vi.mocked(specRepo.findById).mockResolvedValue(makeSpec("spec-000022"));
+        await fetchIssues("/cwd");
+        const savedData = vi.mocked(fs.writeYAML).mock.calls[0][1];
+        expect(savedData.tasks).toHaveLength(1);
+        expect(savedData.tasks[0].title).toBe("New Title");
+        expect(savedData.tasks[0].status).toBe("closed");
+    });
+});
+//# sourceMappingURL=issue-fetch-service.test.js.map

package/dist/services/issue-fetch-service.test.js.map

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

package/dist/services/issue-service.d.ts

@@ -0,0 +1,25 @@
+import type { TaskDefinitionFile, TaskDefinition } from "@reqord/shared";
+export interface CreateIssuesOptions {
+    specId: string;
+    tasksFile: string;
+    dryRun?: boolean;
+    maxIssues?: number;
+}
+export interface CreateIssuesResult {
+    specId: string;
+    issues: CreatedIssueInfo[];
+    totalEstimatedHours: number;
+}
+export interface CreatedIssueInfo {
+    title: string;
+    number?: number;
+    url?: string;
+    priority: "P0" | "P1" | "P2" | "P3";
+    estimatedHours: number;
+    labels: string[];
+}
+export declare function loadTasksFile(cwd: string, filePath: string): Promise<TaskDefinitionFile>;
+export declare function buildLabels(task: TaskDefinition): string[];
+export declare function buildIssueBody(specId: string, task: TaskDefinition): string;
+export declare function createIssuesFromSpec(cwd: string, options: CreateIssuesOptions): Promise<CreateIssuesResult>;
+//# sourceMappingURL=issue-service.d.ts.map

package/dist/services/issue-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-service.d.ts","sourceRoot":"","sources":["../../src/services/issue-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EAGf,MAAM,gBAAgB,CAAC;AAQxB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAE1D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAa3E;AAiDD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAkE7B"}

package/dist/services/issue-service.js

@@ -0,0 +1,114 @@
+import { TaskDefinitionFileSchema, TasksIndexSchema, ISSUES_DIR } from "@reqord/shared";
+import * as specRepo from "../repositories/specification.js";
+import * as githubClient from "./github-client.js";
+import * as fs from "../repositories/file-system.js";
+const TASKS_FILENAME = "tasks.yaml";
+export async function loadTasksFile(cwd, filePath) {
+    const fullPath = fs.joinPath(cwd, filePath);
+    if (!(await fs.exists(fullPath))) {
+        throw new Error(`Tasks file not found: ${filePath}`);
+    }
+    const raw = await fs.readYAML(fullPath);
+    return TaskDefinitionFileSchema.parse(raw);
+}
+export function buildLabels(task) {
+    return ["reqord-generated", task.priority];
+}
+export function buildIssueBody(specId, task) {
+    const metadataTag = `<!-- reqord:specification {"specificationId":"${specId}","priority":"${task.priority}","estimatedHours":${task.estimatedHours}} -->`;
+    let body = metadataTag + "\n\n";
+    body += `## ${task.title}\n\n`;
+    body += `${task.description}\n\n`;
+    body += `**Estimated Hours:** ${task.estimatedHours}\n\n`;
+    if (task.dependencies && task.dependencies.length > 0) {
+        body += `**Dependencies:** ${task.dependencies.join(", ")}\n\n`;
+    }
+    return body;
+}
+function getTasksYamlPath(cwd) {
+    return fs.getReqordDir(cwd, ISSUES_DIR, TASKS_FILENAME);
+}
+async function loadTasksIndex(tasksYamlPath) {
+    if (!(await fs.exists(tasksYamlPath))) {
+        return { title: "Tasks", tasks: [] };
+    }
+    const raw = await fs.readYAML(tasksYamlPath);
+    const result = TasksIndexSchema.safeParse(raw);
+    if (!result.success) {
+        throw new Error(`Invalid tasks.yaml: ${result.error.message}`);
+    }
+    return result.data;
+}
+async function appendToTasksFile(cwd, specId, issues) {
+    const tasksYamlPath = getTasksYamlPath(cwd);
+    const issuesDir = fs.getReqordDir(cwd, ISSUES_DIR);
+    await fs.mkdirp(issuesDir);
+    const index = await loadTasksIndex(tasksYamlPath);
+    const syncedAt = new Date().toISOString();
+    const validIssues = issues.filter((issue) => issue.number !== undefined && issue.url !== undefined);
+    const newEntries = validIssues.map((issue) => ({
+        number: issue.number,
+        title: issue.title,
+        url: issue.url,
+        linkedTo: { specifications: [specId] },
+        priority: issue.priority,
+        status: "open",
+        estimatedHours: issue.estimatedHours,
+        syncedAt,
+    }));
+    index.tasks.push(...newEntries);
+    await fs.writeYAML(tasksYamlPath, index);
+}
+export async function createIssuesFromSpec(cwd, options) {
+    const spec = await specRepo.findByIdOrThrow(cwd, options.specId);
+    if (spec.status !== "approved") {
+        throw new Error(`Specification ${options.specId} must be approved before creating issues`);
+    }
+    const tasksData = await loadTasksFile(cwd, options.tasksFile);
+    const maxIssues = options.maxIssues ?? 20;
+    if (!Number.isFinite(maxIssues) || maxIssues <= 0) {
+        throw new Error(`Invalid maxIssues value: ${maxIssues}. Must be a positive integer.`);
+    }
+    if (tasksData.tasks.length > maxIssues) {
+        throw new Error(`Task count (${tasksData.tasks.length}) exceeds maximum allowed (${maxIssues})`);
+    }
+    const issues = [];
+    let totalEstimatedHours = 0;
+    for (const task of tasksData.tasks) {
+        const labels = buildLabels(task);
+        const body = buildIssueBody(options.specId, task);
+        if (!options.dryRun) {
+            const created = await githubClient.createIssue({
+                title: task.title,
+                body,
+                labels,
+            });
+            issues.push({
+                title: task.title,
+                number: created.number,
+                url: created.url,
+                priority: task.priority,
+                estimatedHours: task.estimatedHours,
+                labels,
+            });
+        }
+        else {
+            issues.push({
+                title: task.title,
+                priority: task.priority,
+                estimatedHours: task.estimatedHours,
+                labels,
+            });
+        }
+        totalEstimatedHours += task.estimatedHours;
+    }
+    if (!options.dryRun) {
+        await appendToTasksFile(cwd, options.specId, issues);
+    }
+    return {
+        specId: options.specId,
+        issues,
+        totalEstimatedHours,
+    };
+}
+//# sourceMappingURL=issue-service.js.map

package/dist/services/issue-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-service.js","sourceRoot":"","sources":["../../src/services/issue-service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,KAAK,QAAQ,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAErD,MAAM,cAAc,GAAG,YAAY,CAAC;AAwBpC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,QAAgB;IAEhB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAU,QAAQ,CAAC,CAAC;IACjD,OAAO,wBAAwB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAoB;IAC9C,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAoB;IACjE,MAAM,WAAW,GAAG,iDAAiD,MAAM,iBAAiB,IAAI,CAAC,QAAQ,sBAAsB,IAAI,CAAC,cAAc,OAAO,CAAC;IAE1J,IAAI,IAAI,GAAG,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,IAAI,MAAM,IAAI,CAAC,KAAK,MAAM,CAAC;IAC/B,IAAI,IAAI,GAAG,IAAI,CAAC,WAAW,MAAM,CAAC;IAClC,IAAI,IAAI,wBAAwB,IAAI,CAAC,cAAc,MAAM,CAAC;IAE1D,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,IAAI,qBAAqB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,aAAqB;IACjD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAU,aAAa,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,GAAW,EACX,MAAc,EACd,MAA0B;IAE1B,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE3B,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE1C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAC/B,CAAC,KAAK,EAA2D,EAAE,CACjE,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,CACxD,CAAC;IACF,MAAM,UAAU,GAAgB,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE;QACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,MAAe;QACvB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,QAAQ;KACT,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAW,EACX,OAA4B;IAE5B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,iBAAiB,OAAO,CAAC,MAAM,0CAA0C,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAE1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,4BAA4B,SAAS,+BAA+B,CACrE,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,eAAe,SAAS,CAAC,KAAK,CAAC,MAAM,8BAA8B,SAAS,GAAG,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAElD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBAC7C,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI;gBACJ,MAAM;aACP,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,MAAM;aACP,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAED,mBAAmB,IAAI,IAAI,CAAC,cAAc,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM;QACN,mBAAmB;KACpB,CAAC;AACJ,CAAC"}

package/dist/services/issue-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=issue-service.test.d.ts.map

package/dist/services/issue-service.test.d.ts.map

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