crewly 1.20.152 → 1.20.154

package/dist/backend/backend/src/services/project-tickets/ticket-folder-lock.js

@@ -0,0 +1,194 @@
+/**
+ * Locking and id allocation for a project's tickets folder
+ * (specs/2026-09-28-project-tickets.md §2 "Concurrency").
+ *
+ * Two layers, because writers live in more than one process (the backend,
+ * a `crewly tickets migrate` run, a second backend on the same machine):
+ * - an in-process operation lock keyed on the folder, so concurrent async
+ *   callers in one process queue up instead of polling the lockfile;
+ * - a lockfile created with `O_EXCL` (`wx`), so other processes wait too. A
+ *   lockfile older than {@link PROJECT_TICKET_CONSTANTS.LOCK_STALE_MS} was left
+ *   by a crashed writer and is taken over.
+ *
+ * @module services/project-tickets/ticket-folder-lock
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { PROJECT_TICKET_CONSTANTS } from '../../constants.js';
+import { atomicWriteJson, ensureDir, withOperationLock } from '../../utils/file-io.utils.js';
+/**
+ * Sleep helper.
+ *
+ * @param ms - Milliseconds
+ * @returns Resolves after `ms`
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Take the cross-process lockfile, waiting for another holder.
+ *
+ * @param lockPath - Lockfile path
+ * @throws When the lock cannot be taken within the timeout
+ */
+async function acquireLockfile(lockPath) {
+    const { LOCK_STALE_MS, LOCK_RETRY_MS, LOCK_TIMEOUT_MS } = PROJECT_TICKET_CONSTANTS;
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    for (;;) {
+        try {
+            const handle = await fs.open(lockPath, 'wx');
+            await handle.writeFile(`${process.pid} ${new Date().toISOString()}\n`);
+            await handle.close();
+            return;
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+        }
+        try {
+            const stat = await fs.stat(lockPath);
+            if (Date.now() - stat.mtimeMs > LOCK_STALE_MS) {
+                await fs.unlink(lockPath).catch(() => undefined);
+                continue;
+            }
+        }
+        catch {
+            // Released between our open and stat — try again right away.
+            continue;
+        }
+        if (Date.now() > deadline)
+            throw new Error(`Timed out waiting for the tickets lock (${lockPath})`);
+        await sleep(LOCK_RETRY_MS);
+    }
+}
+/**
+ * Run `fn` while holding the folder's in-process and cross-process locks.
+ * Creates the folder (and its own `.gitignore` for the lock and temp files)
+ * when missing.
+ *
+ * @param dir - Absolute tickets folder
+ * @param fn - Critical section
+ * @returns Whatever `fn` returns
+ * @throws When the lock cannot be taken, or whatever `fn` throws
+ *
+ * @example
+ * ```typescript
+ * await withTicketFolderLock(dir, async () => writeTicket(...));
+ * ```
+ */
+export async function withTicketFolderLock(dir, fn) {
+    return withOperationLock(`project-tickets:${path.resolve(dir)}`, async () => {
+        await ensureDir(dir);
+        await ensureFolderGitignore(dir);
+        const lockPath = path.join(dir, PROJECT_TICKET_CONSTANTS.LOCK_FILENAME);
+        await acquireLockfile(lockPath);
+        try {
+            return await fn();
+        }
+        finally {
+            await fs.unlink(lockPath).catch(() => undefined);
+        }
+    });
+}
+/**
+ * Write the folder's own `.gitignore` (lockfile + temp files) once.
+ *
+ * @param dir - Tickets folder
+ */
+async function ensureFolderGitignore(dir) {
+    const p = path.join(dir, '.gitignore');
+    try {
+        await fs.access(p);
+    }
+    catch {
+        await fs.writeFile(p, PROJECT_TICKET_CONSTANTS.FOLDER_GITIGNORE_CONTENT, 'utf8');
+    }
+}
+/**
+ * Derive a ticket id prefix from a project name: up to four letters/digits,
+ * preferring word initials for multi-word names.
+ *
+ * @param projectName - Project display name
+ * @returns Uppercase prefix (never empty)
+ *
+ * @example
+ * ```typescript
+ * derivePrefix('crewly');           // 'CREW'
+ * derivePrefix('Steam Fun Portal'); // 'SFP'
+ * ```
+ */
+export function derivePrefix(projectName) {
+    const { MAX_PREFIX_LENGTH, FALLBACK_PREFIX } = PROJECT_TICKET_CONSTANTS;
+    const words = projectName
+        .normalize('NFKD')
+        .toUpperCase()
+        .split(/[^A-Z0-9]+/)
+        .filter((w) => w.length > 0);
+    if (words.length === 0)
+        return FALLBACK_PREFIX;
+    const raw = words.length > 1 ? words.map((w) => w[0]).join('') : words[0];
+    return raw.slice(0, MAX_PREFIX_LENGTH);
+}
+/**
+ * Read the counter file (missing or corrupt → null).
+ *
+ * @param dir - Tickets folder
+ * @returns Counter, or null
+ */
+export async function readCounter(dir) {
+    try {
+        const raw = JSON.parse(await fs.readFile(path.join(dir, PROJECT_TICKET_CONSTANTS.COUNTER_FILENAME), 'utf8'));
+        if (typeof raw.prefix !== 'string' || !/^[A-Za-z0-9]+$/.test(raw.prefix))
+            return null;
+        const next = typeof raw.next === 'number' && Number.isInteger(raw.next) && raw.next > 0 ? raw.next : 1;
+        return { prefix: raw.prefix, next };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Highest ticket number already used in the folder for a prefix, read from
+ * the file names (`CRW-12-foo.md` → 12).
+ *
+ * @param dir - Tickets folder
+ * @param prefix - Id prefix
+ * @returns Highest number, or 0
+ */
+async function highestUsedNumber(dir, prefix) {
+    let names = [];
+    try {
+        names = await fs.readdir(dir);
+    }
+    catch {
+        return 0;
+    }
+    const re = new RegExp(`^${prefix}-(\\d+)(?:-|\\.md$)`, 'i');
+    let max = 0;
+    for (const n of names) {
+        const m = re.exec(n);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return max;
+}
+/**
+ * Allocate the next ticket id. MUST be called while holding
+ * {@link withTicketFolderLock} for the same folder.
+ *
+ * Takes `max(counter.next, highest used + 1)` so ids that arrive through a
+ * git merge are never reused, then advances the counter.
+ *
+ * @param dir - Tickets folder
+ * @param projectName - Used to derive the prefix the first time
+ * @returns The new id, e.g. `CREW-13`
+ */
+export async function allocateTicketId(dir, projectName) {
+    const counter = await readCounter(dir);
+    const prefix = counter?.prefix ?? derivePrefix(projectName);
+    const used = await highestUsedNumber(dir, prefix);
+    const n = Math.max(counter?.next ?? 1, used + 1);
+    await atomicWriteJson(path.join(dir, PROJECT_TICKET_CONSTANTS.COUNTER_FILENAME), { prefix, next: n + 1 });
+    return `${prefix}-${n}`;
+}
+//# sourceMappingURL=ticket-folder-lock.js.map

package/dist/backend/backend/src/services/project-tickets/ticket-folder-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-folder-lock.js","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/ticket-folder-lock.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/project-tickets/ticket-tracking.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Keep `<project>/.crewly/tickets/` visible to git
+ * (specs/2026-09-28-project-tickets.md §2 "Git tracking").
+ *
+ * Most projects ignore `.crewly/` as a whole. A bare `!.crewly/tickets/`
+ * cannot undo that — git never descends into an excluded directory, so
+ * nothing inside it can be re-included. When (and only when) git reports the
+ * tickets folder as ignored, this appends a small block to the project's
+ * `.gitignore` that re-includes `.crewly/`, re-ignores everything in it, then
+ * re-includes `tickets/`. Existing lines are never touched.
+ *
+ * @module services/project-tickets/ticket-tracking
+ */
+import { type GitResult } from '../worktree/worktree-git.js';
+/** What {@link ensureTicketsTracked} found / did. */
+export type TicketTrackingOutcome = 
+/** Project is not inside a git work tree */
+'not-a-repo'
+/** The tickets folder lives outside the project (package-tree fallback) */
+ | 'outside-project'
+/** Git already sees the folder */
+ | 'tracked'
+/** The block was appended and git now sees the folder */
+ | 'unignored'
+/** Still ignored (global excludes, or a rule the block cannot override) */
+ | 'still-ignored';
+/** Git runner (injectable for tests). */
+export type GitRunner = (cwd: string, args: string[]) => Promise<GitResult>;
+/**
+ * Make sure git tracks the project's tickets folder, appending the
+ * re-include block to `<project>/.gitignore` when it is ignored.
+ *
+ * Idempotent: the block is appended at most once (its re-include line is the
+ * marker).
+ *
+ * @param projectPath - Absolute project root
+ * @param git - Git runner (defaults to the worktree helper's `runGit`)
+ * @returns What was found / done
+ *
+ * @example
+ * ```typescript
+ * const outcome = await ensureTicketsTracked('/repo');
+ * if (outcome === 'still-ignored') logger.warn('tickets are not tracked');
+ * ```
+ */
+export declare function ensureTicketsTracked(projectPath: string, git?: GitRunner): Promise<TicketTrackingOutcome>;
+//# sourceMappingURL=ticket-tracking.d.ts.map

package/dist/backend/backend/src/services/project-tickets/ticket-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-tracking.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/ticket-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAGrE,qDAAqD;AACrD,MAAM,MAAM,qBAAqB;AAC/B,4CAA4C;AAC1C,YAAY;AACd,2EAA2E;GACzE,iBAAiB;AACnB,kCAAkC;GAChC,SAAS;AACX,yDAAyD;GACvD,WAAW;AACb,2EAA2E;GACzE,eAAe,CAAC;AAEpB,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAoB5E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,SAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyBvH"}

package/dist/backend/backend/src/services/project-tickets/ticket-tracking.js

@@ -0,0 +1,83 @@
+/**
+ * Keep `<project>/.crewly/tickets/` visible to git
+ * (specs/2026-09-28-project-tickets.md §2 "Git tracking").
+ *
+ * Most projects ignore `.crewly/` as a whole. A bare `!.crewly/tickets/`
+ * cannot undo that — git never descends into an excluded directory, so
+ * nothing inside it can be re-included. When (and only when) git reports the
+ * tickets folder as ignored, this appends a small block to the project's
+ * `.gitignore` that re-includes `.crewly/`, re-ignores everything in it, then
+ * re-includes `tickets/`. Existing lines are never touched.
+ *
+ * @module services/project-tickets/ticket-tracking
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { PROJECT_TICKET_CONSTANTS } from '../../constants.js';
+import { runGit } from '../worktree/worktree-git.js';
+import { resolveProjectDataDir } from '../core/crewly-home.utils.js';
+/** A path inside the tickets folder used to ask git about it. */
+const PROBE_FILE = 'probe.md';
+/**
+ * Whether git would ignore a new file in the tickets folder.
+ *
+ * @param projectPath - Project root
+ * @param git - Git runner
+ * @returns True / false, or null when git could not answer
+ */
+async function isTicketsFolderIgnored(projectPath, git) {
+    const probe = `${PROJECT_TICKET_CONSTANTS.REPO_RELATIVE_DIR}/${PROBE_FILE}`;
+    const r = await git(projectPath, ['check-ignore', '-q', '--no-index', probe]);
+    if (r.code === 0)
+        return true;
+    if (r.code === 1)
+        return false;
+    return null;
+}
+/**
+ * Make sure git tracks the project's tickets folder, appending the
+ * re-include block to `<project>/.gitignore` when it is ignored.
+ *
+ * Idempotent: the block is appended at most once (its re-include line is the
+ * marker).
+ *
+ * @param projectPath - Absolute project root
+ * @param git - Git runner (defaults to the worktree helper's `runGit`)
+ * @returns What was found / done
+ *
+ * @example
+ * ```typescript
+ * const outcome = await ensureTicketsTracked('/repo');
+ * if (outcome === 'still-ignored') logger.warn('tickets are not tracked');
+ * ```
+ */
+export async function ensureTicketsTracked(projectPath, git = runGit) {
+    const root = path.resolve(projectPath);
+    if (resolveProjectDataDir(root) !== path.join(root, '.crewly'))
+        return 'outside-project';
+    const inside = await git(root, ['rev-parse', '--is-inside-work-tree']);
+    if (!inside.ok || inside.stdout.trim() !== 'true')
+        return 'not-a-repo';
+    const ignored = await isTicketsFolderIgnored(root, git);
+    if (ignored === false)
+        return 'tracked';
+    if (ignored === null)
+        return 'still-ignored';
+    const gitignorePath = path.join(root, '.gitignore');
+    let current = '';
+    try {
+        current = await fs.readFile(gitignorePath, 'utf8');
+    }
+    catch {
+        current = '';
+    }
+    const block = PROJECT_TICKET_CONSTANTS.GITIGNORE_BLOCK;
+    const marker = block[block.length - 2];
+    const alreadyThere = current.split(/\r?\n/).some((l) => l.trim() === marker);
+    if (!alreadyThere) {
+        const lead = current.length === 0 ? '' : current.endsWith('\n') ? '\n' : '\n\n';
+        await fs.appendFile(gitignorePath, `${lead}${block.join('\n')}\n`, 'utf8');
+    }
+    return (await isTicketsFolderIgnored(root, git)) === false ? 'unignored' : 'still-ignored';
+}
+//# sourceMappingURL=ticket-tracking.js.map

package/dist/backend/backend/src/services/project-tickets/ticket-tracking.js.map

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

package/dist/backend/backend/src/services/project-tickets/v1-task-migration.d.ts

@@ -0,0 +1,97 @@
+/**
+ * One-off, explicit migration of the retired v1 task files
+ * (`.crewly/tasks/<milestone>/{open,in_progress}/*.md`) into project tickets
+ * (specs/2026-09-28-project-tickets.md §8).
+ *
+ * - Only unfinished files are imported (open / in_progress); done/ and
+ *   blocked/ are left alone.
+ * - Every import becomes a `backlog` ticket — nobody is working on it now, and
+ *   a person decides what is still wanted.
+ * - The original file is never modified, moved or deleted; its repo-relative
+ *   path is recorded as `migratedFrom`, which also makes re-runs no-ops.
+ * - Dry-run unless `apply: true`.
+ *
+ * @module services/project-tickets/v1-task-migration
+ */
+import { type ProjectTicketCriterion, type ProjectTicketPriority } from '../../types/project-ticket.types.js';
+import type { ProjectTicketService } from './project-ticket.service.js';
+/** Options for {@link migrateV1Tasks}. */
+export interface V1MigrationOptions {
+    /** Write the tickets (default false = dry-run) */
+    apply?: boolean;
+    /** Only these milestone folders (default: all) */
+    milestones?: string[];
+}
+/** What happens to one v1 file. */
+export interface V1MigrationItem {
+    /** Repo-relative path of the v1 file */
+    source: string;
+    milestone: string;
+    /** The v1 status folder it sits in */
+    v1Status: string;
+    title: string;
+    priority: ProjectTicketPriority;
+    action: 'create' | 'skip-existing' | 'skip-invalid' | 'skip-milestone';
+    /** Id of the created ticket (apply) or the existing one */
+    ticketId?: string;
+    reason?: string;
+}
+/** Report of a run. */
+export interface V1MigrationReport {
+    projectPath: string;
+    apply: boolean;
+    /** v1 files found in open/in_progress folders */
+    scanned: number;
+    /** Tickets created (apply) or that would be created (dry-run) */
+    toCreate: number;
+    created: number;
+    skipped: number;
+    byMilestone: Record<string, {
+        create: number;
+        skip: number;
+    }>;
+    items: V1MigrationItem[];
+}
+/** A v1 file read into ticket content. */
+interface V1Parsed {
+    title: string;
+    priority: ProjectTicketPriority;
+    labels: string[];
+    description: string;
+    acceptance: ProjectTicketCriterion[];
+}
+/**
+ * Push markdown headings two levels down (outside code fences) so an imported
+ * body cannot open sections of its own inside the ticket.
+ *
+ * @param text - Markdown
+ * @returns Markdown with `#` → `###`, `##` → `####`, …
+ */
+export declare function demoteHeadings(text: string): string;
+/**
+ * Read a v1 task file.
+ *
+ * @param content - File content
+ * @param fileBase - File name without `.md`
+ * @param milestone - Milestone folder
+ * @returns Ticket content
+ */
+export declare function parseV1Task(content: string, fileBase: string, milestone: string): V1Parsed;
+/**
+ * Import unfinished v1 task files as backlog tickets.
+ *
+ * @param tickets - Ticket store
+ * @param projectPath - Project root
+ * @param projectName - Project name (id prefix on first allocation)
+ * @param options - `apply` (default false), `milestones`
+ * @returns What was / would be done
+ *
+ * @example
+ * ```typescript
+ * const dry = await migrateV1Tasks(svc, '/repo', 'repo');          // report only
+ * const run = await migrateV1Tasks(svc, '/repo', 'repo', { apply: true });
+ * ```
+ */
+export declare function migrateV1Tasks(tickets: ProjectTicketService, projectPath: string, projectName: string, options?: V1MigrationOptions): Promise<V1MigrationReport>;
+export {};
+//# sourceMappingURL=v1-task-migration.d.ts.map

package/dist/backend/backend/src/services/project-tickets/v1-task-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-task-migration.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/v1-task-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EAAkC,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC9I,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,QAAQ,GAAG,eAAe,GAAG,cAAc,GAAG,gBAAgB,CAAC;IACvE,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uBAAuB;AACvB,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,0CAA0C;AAC1C,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAuCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAanD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAgC1F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAgE5B"}

package/dist/backend/backend/src/services/project-tickets/v1-task-migration.js

@@ -0,0 +1,201 @@
+/**
+ * One-off, explicit migration of the retired v1 task files
+ * (`.crewly/tasks/<milestone>/{open,in_progress}/*.md`) into project tickets
+ * (specs/2026-09-28-project-tickets.md §8).
+ *
+ * - Only unfinished files are imported (open / in_progress); done/ and
+ *   blocked/ are left alone.
+ * - Every import becomes a `backlog` ticket — nobody is working on it now, and
+ *   a person decides what is still wanted.
+ * - The original file is never modified, moved or deleted; its repo-relative
+ *   path is recorded as `migratedFrom`, which also makes re-runs no-ops.
+ * - Dry-run unless `apply: true`.
+ *
+ * @module services/project-tickets/v1-task-migration
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { parse as parseYAML } from 'yaml';
+import { PROJECT_TICKET_CONSTANTS } from '../../constants.js';
+import { resolveProjectDataDir } from '../core/crewly-home.utils.js';
+import { normalizeProjectTicketPriority } from '../../types/project-ticket.types.js';
+/** Max folder depth walked under `.crewly/tasks`. */
+const MAX_WALK_DEPTH = 6;
+/** v1 frontmatter at the start of a file. */
+const V1_FRONTMATTER_RE = /^\uFEFF?---[ \t]*\r?\n(?:([\s\S]*?)\r?\n)?---[ \t]*(?:\r?\n|$)/;
+/**
+ * Find v1 files in open / in_progress status folders.
+ *
+ * @param v1Root - `<data dir>/tasks`
+ * @returns Absolute file paths with milestone and status
+ */
+async function findV1Files(v1Root) {
+    const found = [];
+    const statuses = PROJECT_TICKET_CONSTANTS.MIGRATION_STATUS_FOLDERS;
+    const walk = async (dir, depth) => {
+        if (depth > MAX_WALK_DEPTH)
+            return;
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                await walk(full, depth + 1);
+            }
+            else if (e.isFile() && e.name.endsWith('.md') && statuses.includes(path.basename(dir))) {
+                const milestoneDir = path.relative(v1Root, path.dirname(dir));
+                found.push({ file: full, milestone: milestoneDir === '' ? '(none)' : milestoneDir.split(path.sep).join('/'), status: path.basename(dir) });
+            }
+        }
+    };
+    await walk(v1Root, 0);
+    return found.sort((a, b) => a.file.localeCompare(b.file));
+}
+/**
+ * Push markdown headings two levels down (outside code fences) so an imported
+ * body cannot open sections of its own inside the ticket.
+ *
+ * @param text - Markdown
+ * @returns Markdown with `#` → `###`, `##` → `####`, …
+ */
+export function demoteHeadings(text) {
+    let inFence = false;
+    return text
+        .split('\n')
+        .map((line) => {
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            return line;
+        }
+        if (inFence)
+            return line;
+        return /^#{1,4}\s/.test(line) ? `##${line}` : line;
+    })
+        .join('\n');
+}
+/**
+ * Read a v1 task file.
+ *
+ * @param content - File content
+ * @param fileBase - File name without `.md`
+ * @param milestone - Milestone folder
+ * @returns Ticket content
+ */
+export function parseV1Task(content, fileBase, milestone) {
+    let fm = {};
+    let body = content;
+    const m = V1_FRONTMATTER_RE.exec(content);
+    if (m) {
+        try {
+            const parsed = parseYAML(m[1] ?? '');
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+                fm = parsed;
+        }
+        catch {
+            fm = {};
+        }
+        body = content.slice(m[0].length);
+    }
+    const heading = /^#\s+(.+?)\s*$/m.exec(body)?.[1];
+    const title = (typeof fm.title === 'string' && fm.title.trim()) || heading || fileBase.replace(/[_-]+/g, ' ');
+    const inlinePriority = /^\s*\*\*Priority:\*\*\s*(.+?)\s*$/m.exec(body)?.[1];
+    const priority = normalizeProjectTicketPriority(fm.priority) ??
+        normalizeProjectTicketPriority(inlinePriority) ??
+        PROJECT_TICKET_CONSTANTS.DEFAULT_PRIORITY;
+    const fmLabels = Array.isArray(fm.labels) ? fm.labels.map(String) : typeof fm.labels === 'string' ? fm.labels.split(',') : [];
+    const labels = [...fmLabels.map((l) => l.trim()).filter(Boolean), `milestone:${milestone}`];
+    const acceptance = [];
+    const acc = /^#{2,3}\s+Acceptance Criteria\s*$([\s\S]*?)(?=^#{1,3}\s|(?![\s\S]))/im.exec(body);
+    if (acc) {
+        for (const line of acc[1].split(/\r?\n/)) {
+            const item = /^\s*[-*]\s+(?:\[( |x|X)\]\s+)?(.+)$/.exec(line);
+            if (item)
+                acceptance.push({ text: item[2].trim(), done: (item[1] ?? ' ').toLowerCase() === 'x' });
+        }
+    }
+    return { title: String(title).replace(/\s+/g, ' ').trim(), priority, labels, description: demoteHeadings(body.trim()), acceptance };
+}
+/**
+ * Import unfinished v1 task files as backlog tickets.
+ *
+ * @param tickets - Ticket store
+ * @param projectPath - Project root
+ * @param projectName - Project name (id prefix on first allocation)
+ * @param options - `apply` (default false), `milestones`
+ * @returns What was / would be done
+ *
+ * @example
+ * ```typescript
+ * const dry = await migrateV1Tasks(svc, '/repo', 'repo');          // report only
+ * const run = await migrateV1Tasks(svc, '/repo', 'repo', { apply: true });
+ * ```
+ */
+export async function migrateV1Tasks(tickets, projectPath, projectName, options = {}) {
+    const root = path.resolve(projectPath);
+    const apply = options.apply === true;
+    const v1Root = path.join(resolveProjectDataDir(root), PROJECT_TICKET_CONSTANTS.MIGRATION_V1_DIR);
+    const files = await findV1Files(v1Root);
+    const existing = new Map();
+    for (const t of (await tickets.list(root)).tickets)
+        if (t.migratedFrom)
+            existing.set(t.migratedFrom, t.id);
+    const report = { projectPath: root, apply, scanned: files.length, toCreate: 0, created: 0, skipped: 0, byMilestone: {}, items: [] };
+    for (const f of files) {
+        const source = path.relative(root, f.file).split(path.sep).join('/');
+        const bucket = (report.byMilestone[f.milestone] ??= { create: 0, skip: 0 });
+        const base = { source, milestone: f.milestone, v1Status: f.status };
+        let parsed;
+        let createdAt;
+        try {
+            const [content, stat] = await Promise.all([fs.readFile(f.file, 'utf8'), fs.stat(f.file)]);
+            parsed = parseV1Task(content, path.basename(f.file, '.md'), f.milestone);
+            createdAt = new Date(stat.birthtimeMs || stat.mtimeMs).toISOString();
+        }
+        catch (err) {
+            report.items.push({ ...base, title: path.basename(f.file), priority: 'P2', action: 'skip-invalid', reason: err instanceof Error ? err.message : String(err) });
+            report.skipped += 1;
+            bucket.skip += 1;
+            continue;
+        }
+        const item = { ...base, title: parsed.title, priority: parsed.priority, action: 'create' };
+        if (options.milestones && options.milestones.length > 0 && !options.milestones.includes(f.milestone)) {
+            item.action = 'skip-milestone';
+        }
+        else if (existing.has(source)) {
+            item.action = 'skip-existing';
+            item.ticketId = existing.get(source);
+        }
+        if (item.action !== 'create') {
+            report.skipped += 1;
+            bucket.skip += 1;
+            report.items.push(item);
+            continue;
+        }
+        report.toCreate += 1;
+        bucket.create += 1;
+        if (apply) {
+            const t = await tickets.create(root, projectName, {
+                title: parsed.title,
+                description: parsed.description,
+                acceptance: parsed.acceptance,
+                priority: parsed.priority,
+                labels: parsed.labels,
+                status: 'backlog',
+                source: PROJECT_TICKET_CONSTANTS.MIGRATION_SOURCE,
+                migratedFrom: source,
+                createdAt,
+            }, 'crewly-migration');
+            item.ticketId = t.id;
+            existing.set(source, t.id);
+            report.created += 1;
+        }
+        report.items.push(item);
+    }
+    return report;
+}
+//# sourceMappingURL=v1-task-migration.js.map

package/dist/backend/backend/src/services/project-tickets/v1-task-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-task-migration.js","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/v1-task-migration.ts"],"names":[],"mappings":"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"}