@matteeh/osq 0.1.0

package/dist/core/linter.js

@@ -0,0 +1,100 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parseSpecMd, parseTaskMd } from './parser.js';
+async function checkDependencyExists(projectRoot, depId, specsDirName) {
+    const specsDir = path.join(projectRoot, specsDirName);
+    const archiveDir = path.join(specsDir, 'archive');
+    const dirsToCheck = [specsDir, archiveDir];
+    const paddedDep = depId.padStart(3, '0');
+    for (const dir of dirsToCheck) {
+        try {
+            const entries = await fs.readdir(dir);
+            for (const entry of entries) {
+                if (entry.startsWith(`${paddedDep}-`) || entry === paddedDep) {
+                    return true;
+                }
+            }
+        }
+        catch {
+            // Directory may not exist yet
+        }
+    }
+    return false;
+}
+export async function lintChangeFolder(projectRoot, folderPath, config) {
+    const errors = [];
+    const warnings = [];
+    const specMdPath = path.join(folderPath, 'spec.md');
+    let specContent = '';
+    try {
+        specContent = await fs.readFile(specMdPath, 'utf8');
+    }
+    catch {
+        errors.push('spec.md not found in change folder');
+        return { valid: false, errors, warnings };
+    }
+    const spec = parseSpecMd(specContent);
+    // Check: features.writes max entries
+    if (spec.features.writes.length > config.limits.maxFeatureWrites) {
+        errors.push(`features.writes has ${spec.features.writes.length} entries (max allowed is ${config.limits.maxFeatureWrites})`);
+    }
+    // Check: contract tables count
+    if (spec.contractTablesCount > config.limits.maxContractTables) {
+        errors.push(`Contract has ${spec.contractTablesCount} tables (max allowed is ${config.limits.maxContractTables})`);
+    }
+    // Check: Delta empty while features.writes is not
+    if (spec.features.writes.length > 0 && !spec.delta.trim()) {
+        errors.push('Delta is empty while features.writes contains entries');
+    }
+    // Check: depends_on exists
+    for (const dep of spec.dependsOn) {
+        const exists = await checkDependencyExists(projectRoot, dep, config.paths.specs);
+        if (!exists) {
+            errors.push(`depends_on names missing change: ${dep}`);
+        }
+    }
+    // Tasks checks
+    const tasksDir = path.join(folderPath, 'tasks');
+    let taskEntries = [];
+    try {
+        taskEntries = (await fs.readdir(tasksDir)).filter((e) => e.endsWith('.md'));
+    }
+    catch {
+        errors.push('tasks directory not found in change folder');
+    }
+    if (taskEntries.length === 0) {
+        errors.push('No task files found under tasks/');
+    }
+    for (const taskFile of taskEntries) {
+        const taskPath = path.join(tasksDir, taskFile);
+        const taskContent = await fs.readFile(taskPath, 'utf8');
+        const task = parseTaskMd(taskContent);
+        // Warning: task title contains " and "
+        if (task.title.toLowerCase().includes(' and ')) {
+            warnings.push(`Task in ${taskFile} title contains " and ": "${task.title}"`);
+        }
+        // Check: verify command empty or chains commands
+        if (!task.verify) {
+            errors.push(`Task in ${taskFile} verify command is empty`);
+        }
+        else if (task.verify.includes('&&') ||
+            task.verify.includes(';') ||
+            task.verify.includes('|')) {
+            errors.push(`Task in ${taskFile} verify chains commands ("${task.verify}")`);
+        }
+        // Check: acceptance checklist length
+        if (task.acceptance.length > config.limits.maxAcceptanceLines) {
+            errors.push(`Task in ${taskFile} acceptance lines (${task.acceptance.length}) exceeds limit ${config.limits.maxAcceptanceLines}`);
+        }
+        // Check: scope expands to more than maxScopeFiles
+        if (task.scope.length > config.limits.maxScopeFiles) {
+            errors.push(`Task in ${taskFile} scope specifies ${task.scope.length} patterns, exceeding limit ${config.limits.maxScopeFiles}`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=linter.js.map

package/dist/core/linter.js.map

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

package/dist/core/lock.d.ts

@@ -0,0 +1,17 @@
+export interface LockResult {
+    acquired: boolean;
+    pid: number;
+    startedAt: number;
+    lockPath: string;
+}
+export declare function acquireLock(runDir: string, taskNumber: string | number): Promise<LockResult>;
+export declare function releaseLock(runDir: string, taskNumber: string | number): Promise<void>;
+export declare function isPidRunning(pid: number): boolean;
+export interface ReapedLock {
+    taskNumber: string;
+    reason: 'crashed' | 'timeout';
+    pid: number;
+    startedAt: number;
+}
+export declare function reapStaleLocks(specFolderPath: string, staleLockSeconds: number): Promise<ReapedLock[]>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/core/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,OAAO,CAAC,UAAU,CAAC,CAkBrB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC,CAiEvB"}

package/dist/core/lock.js

@@ -0,0 +1,104 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function acquireLock(runDir, taskNumber) {
+    const runningDir = path.join(runDir, 'running');
+    await fs.mkdir(runningDir, { recursive: true });
+    const lockPath = path.join(runningDir, `${taskNumber}.pid`);
+    const pid = process.pid;
+    const startedAt = Date.now();
+    const payload = JSON.stringify({ pid, startedAt });
+    try {
+        await fs.writeFile(lockPath, payload, { flag: 'wx', encoding: 'utf8' });
+        return { acquired: true, pid, startedAt, lockPath };
+    }
+    catch (err) {
+        if (err.code === 'EEXIST') {
+            return { acquired: false, pid: 0, startedAt: 0, lockPath };
+        }
+        throw err;
+    }
+}
+export async function releaseLock(runDir, taskNumber) {
+    const lockPath = path.join(runDir, 'running', `${taskNumber}.pid`);
+    try {
+        await fs.unlink(lockPath);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+}
+export function isPidRunning(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        return code === 'EPERM';
+    }
+}
+export async function reapStaleLocks(specFolderPath, staleLockSeconds) {
+    const runDir = path.join(specFolderPath, '.run');
+    const runningDir = path.join(runDir, 'running');
+    const deadDir = path.join(runDir, 'dead');
+    let entries = [];
+    try {
+        entries = await fs.readdir(runningDir);
+    }
+    catch {
+        return [];
+    }
+    const reaped = [];
+    const now = Date.now();
+    for (const entry of entries) {
+        if (!entry.endsWith('.pid'))
+            continue;
+        const taskNumber = entry.replace(/\.pid$/, '');
+        const lockPath = path.join(runningDir, entry);
+        let lockData;
+        try {
+            const content = await fs.readFile(lockPath, 'utf8');
+            lockData = JSON.parse(content);
+        }
+        catch {
+            lockData = { pid: 0, startedAt: now };
+        }
+        let reapReason = null;
+        if (now - lockData.startedAt > staleLockSeconds * 1000) {
+            reapReason = 'timeout';
+        }
+        else if (!isPidRunning(lockData.pid)) {
+            reapReason = 'crashed';
+        }
+        if (reapReason) {
+            try {
+                await fs.unlink(lockPath);
+            }
+            catch { }
+            await fs.mkdir(deadDir, { recursive: true });
+            const deadPath = path.join(deadDir, `${taskNumber}.md`);
+            const deadContent = [
+                '---',
+                `reason: ${reapReason}`,
+                `pid: ${lockData.pid}`,
+                `started_at: ${new Date(lockData.startedAt).toISOString()}`,
+                `reaped_at: ${new Date(now).toISOString()}`,
+                '---',
+                `Task execution terminated by watcher reaper (${reapReason}).`,
+            ].join('\n');
+            await fs.writeFile(deadPath, `${deadContent}\n`, 'utf8');
+            reaped.push({
+                taskNumber,
+                reason: reapReason,
+                pid: lockData.pid,
+                startedAt: lockData.startedAt,
+            });
+        }
+    }
+    return reaped;
+}
+//# sourceMappingURL=lock.js.map

package/dist/core/lock.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,32 @@
+export type LogLevel = 'quiet' | 'normal' | 'verbose';
+export interface Logger {
+    info(msg: string): void;
+    verbose(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    status(text: string): void;
+    clearStatus(): void;
+    /** True when the sink is an interactive TTY with animation enabled. */
+    readonly interactive?: boolean;
+    /** True when unicode status symbols may be used (TTY, no `CI`, no `NO_COLOR`). */
+    readonly symbols?: boolean;
+}
+/**
+ * Environment-level check for unicode status symbols. Mirrors the logger's own
+ * detection: an interactive stderr, no `CI`, and no `NO_COLOR`.
+ */
+export declare function symbolsEnabled(): boolean;
+/**
+ * Choose between a unicode symbol and its plain-word fallback. Callers that
+ * own a logger should pass `logger.symbols` as `enabled` so the choice matches
+ * the logger's sink; the default consults the process environment.
+ */
+export declare function resolveSymbol(symbol: string, word: string, enabled?: boolean): string;
+export interface LoggerOptions {
+    stream?: NodeJS.WritableStream & {
+        isTTY?: boolean;
+    };
+    isTTY?: boolean;
+}
+export declare function createLogger(level: LogLevel, prefix?: string, options?: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,IAAI,IAAI,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAmB,GAAG,MAAM,CAE9F;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAqBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CA6E9F"}

package/dist/core/logger.js

@@ -0,0 +1,106 @@
+/**
+ * Environment-level check for unicode status symbols. Mirrors the logger's own
+ * detection: an interactive stderr, no `CI`, and no `NO_COLOR`.
+ */
+export function symbolsEnabled() {
+    return process.stderr.isTTY === true && !process.env.CI && process.env.NO_COLOR === undefined;
+}
+/**
+ * Choose between a unicode symbol and its plain-word fallback. Callers that
+ * own a logger should pass `logger.symbols` as `enabled` so the choice matches
+ * the logger's sink; the default consults the process environment.
+ */
+export function resolveSymbol(symbol, word, enabled = symbolsEnabled()) {
+    return enabled ? symbol : word;
+}
+const LEVEL_RANK = {
+    quiet: 0,
+    normal: 1,
+    verbose: 2,
+};
+const MESSAGE_RANK = {
+    verbose: 2,
+    info: 1,
+    warn: 0,
+    error: 0,
+};
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const SPINNER_INTERVAL_MS = 80;
+const CLEAR_LINE = '\r\x1b[2K';
+export function createLogger(level, prefix, options) {
+    const maxRank = LEVEL_RANK[level];
+    const stream = options?.stream ?? process.stderr;
+    const interactive = (options?.isTTY ?? stream.isTTY) === true;
+    const animate = interactive && level !== 'quiet' && !process.env.CI;
+    const symbols = animate && process.env.NO_COLOR === undefined;
+    let statusText = null;
+    let frameIndex = 0;
+    let timer = null;
+    const render = (msg) => {
+        const lines = msg.split('\n');
+        return lines.map((line) => (prefix ? `[${prefix}] ${line}` : line)).join('\n');
+    };
+    const writeRaw = (chunk) => {
+        stream.write(chunk);
+    };
+    const redraw = () => {
+        if (statusText === null)
+            return;
+        writeRaw(`${CLEAR_LINE}${SPINNER_FRAMES[frameIndex]} ${statusText}`);
+    };
+    const startTimer = () => {
+        if (timer !== null)
+            return;
+        timer = setInterval(() => {
+            frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+            redraw();
+        }, SPINNER_INTERVAL_MS);
+        timer.unref();
+    };
+    const stopTimer = () => {
+        if (timer === null)
+            return;
+        clearInterval(timer);
+        timer = null;
+    };
+    const write = (messageLevel, msg) => {
+        if (MESSAGE_RANK[messageLevel] > maxRank)
+            return;
+        const rendered = render(msg);
+        const line = rendered.endsWith('\n') ? rendered : `${rendered}\n`;
+        if (animate && statusText !== null) {
+            writeRaw(CLEAR_LINE);
+            writeRaw(line);
+            redraw();
+        }
+        else {
+            writeRaw(line);
+        }
+    };
+    return {
+        interactive: animate,
+        symbols,
+        info: (msg) => write('info', msg),
+        verbose: (msg) => write('verbose', msg),
+        warn: (msg) => write('warn', msg),
+        error: (msg) => write('error', msg),
+        status: (text) => {
+            if (!animate)
+                return;
+            statusText = render(text);
+            startTimer();
+            redraw();
+        },
+        clearStatus: () => {
+            if (!animate)
+                return;
+            if (statusText === null && timer === null)
+                return;
+            writeRaw(CLEAR_LINE);
+            stopTimer();
+            statusText = null;
+            frameIndex = 0;
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/new.d.ts

@@ -0,0 +1,11 @@
+export declare function slugify(text: string): string;
+export declare function getNextSpecNumber(specsDir: string): Promise<string>;
+export interface NewSpecResult {
+    specId: string;
+    folderName: string;
+    folderPath: string;
+}
+export declare function createNewSpec(projectDir: string, title: string, options?: {
+    specsDirName?: string;
+}): Promise<NewSpecResult>;
+//# sourceMappingURL=new.d.ts.map

package/dist/core/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/core/new.ts"],"names":[],"mappings":"AAGA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBzE;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,OAAO,CAAC,aAAa,CAAC,CAoDxB"}

package/dist/core/new.js

@@ -0,0 +1,79 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+export async function getNextSpecNumber(specsDir) {
+    const dirsToScan = [specsDir, path.join(specsDir, 'archive')];
+    let maxNum = 0;
+    for (const dir of dirsToScan) {
+        let entries = [];
+        try {
+            entries = await fs.readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const match = entry.match(/^(\d+)/);
+            if (match) {
+                const num = Number.parseInt(match[1], 10);
+                if (!Number.isNaN(num) && num > maxNum) {
+                    maxNum = num;
+                }
+            }
+        }
+    }
+    return String(maxNum + 1).padStart(3, '0');
+}
+export async function createNewSpec(projectDir, title, options = {}) {
+    const trimmedTitle = title.trim();
+    if (!trimmedTitle) {
+        throw new Error('Spec name cannot be empty');
+    }
+    const slug = slugify(trimmedTitle);
+    if (!slug) {
+        throw new Error('Spec name cannot be empty');
+    }
+    const specsDir = path.join(projectDir, options.specsDirName || 'specs');
+    const templateDir = path.join(specsDir, '_template');
+    const templateExists = await fs
+        .stat(templateDir)
+        .then(() => true)
+        .catch(() => false);
+    if (!templateExists) {
+        throw new Error(`Template directory not found at ${templateDir}. Run osq init first.`);
+    }
+    const specId = await getNextSpecNumber(specsDir);
+    const folderName = `${specId}-${slug}`;
+    const targetDir = path.join(specsDir, folderName);
+    const targetExists = await fs
+        .stat(targetDir)
+        .then(() => true)
+        .catch(() => false);
+    if (targetExists) {
+        throw new Error(`Spec folder already exists at ${targetDir}`);
+    }
+    // Copy template folder recursively
+    await fs.cp(templateDir, targetDir, { recursive: true });
+    // Update spec.md title
+    const specMdPath = path.join(targetDir, 'spec.md');
+    try {
+        const specContent = await fs.readFile(specMdPath, 'utf8');
+        const updatedContent = specContent.replace(/^title:\s*.*$/m, `title: ${trimmedTitle}`);
+        await fs.writeFile(specMdPath, updatedContent, 'utf8');
+    }
+    catch {
+        // If spec.md doesn't exist, proceed
+    }
+    return {
+        specId,
+        folderName,
+        folderPath: targetDir,
+    };
+}
+//# sourceMappingURL=new.js.map

package/dist/core/new.js.map

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

package/dist/core/parser.d.ts

@@ -0,0 +1,32 @@
+export interface FrontmatterResult {
+    data: Record<string, unknown>;
+    body: string;
+}
+export declare function parseFrontmatter(content: string): FrontmatterResult;
+export interface SpecFeatures {
+    readonly reads: string[];
+    readonly writes: string[];
+}
+export interface SpecData {
+    readonly title: string;
+    readonly dependsOn: string[];
+    readonly features: SpecFeatures;
+    readonly goal: string;
+    readonly contract: string;
+    readonly contractTablesCount: number;
+    readonly nonGoals: string;
+    readonly delta: string;
+    readonly raw: string;
+}
+export declare function parseSpecMd(content: string): SpecData;
+export interface TaskData {
+    readonly title: string;
+    readonly verify: string;
+    readonly scope: string[];
+    readonly entry: string[];
+    readonly skills: string[];
+    readonly acceptance: string[];
+    readonly raw: string;
+}
+export declare function parseTaskMd(content: string): TaskData;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAenE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAcD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAoCrD;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CA8BrD"}

package/dist/core/parser.js

@@ -0,0 +1,87 @@
+import YAML from 'yaml';
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { data: {}, body: content };
+    }
+    try {
+        const data = YAML.parse(match[1]) || {};
+        return {
+            data: typeof data === 'object' && data !== null ? data : {},
+            body: match[2] || '',
+        };
+    }
+    catch {
+        return { data: {}, body: content };
+    }
+}
+function extractSection(body, heading) {
+    const regex = new RegExp(`##\\s+${heading}\\s*\\n([\\s\\S]*?)(?=(?:\\n##\\s+|$))`, 'i');
+    const match = body.match(regex);
+    return match ? match[1].trim() : '';
+}
+function countMarkdownTables(text) {
+    const tableRegex = /\|[^\n]+\|\r?\n\|[-:\s|]+\|\r?\n(?:\|[^\n]+\|\r?\n?)+/g;
+    const matches = text.match(tableRegex);
+    return matches ? matches.length : 0;
+}
+export function parseSpecMd(content) {
+    const { data, body } = parseFrontmatter(content);
+    const title = typeof data.title === 'string' ? data.title.trim() : '';
+    const dependsOn = Array.isArray(data.depends_on)
+        ? data.depends_on.map((d) => {
+            const str = String(d).trim();
+            const num = Number.parseInt(str, 10);
+            return !Number.isNaN(num) ? String(num).padStart(3, '0') : str;
+        })
+        : [];
+    const rawFeatures = data.features || {};
+    const reads = Array.isArray(rawFeatures.reads)
+        ? rawFeatures.reads.map((r) => String(r).trim())
+        : [];
+    const writes = Array.isArray(rawFeatures.writes)
+        ? rawFeatures.writes.map((w) => String(w).trim())
+        : [];
+    const goal = extractSection(body, 'Goal');
+    const contract = extractSection(body, 'Contract');
+    const nonGoals = extractSection(body, 'Non-goals');
+    const delta = extractSection(body, 'Delta');
+    return {
+        title,
+        dependsOn,
+        features: { reads, writes },
+        goal,
+        contract,
+        contractTablesCount: countMarkdownTables(contract),
+        nonGoals,
+        delta,
+        raw: content,
+    };
+}
+export function parseTaskMd(content) {
+    const { data, body } = parseFrontmatter(content);
+    const title = typeof data.title === 'string' ? data.title.trim() : '';
+    const verify = typeof data.verify === 'string' ? data.verify.trim() : '';
+    const scope = Array.isArray(data.scope) ? data.scope.map((s) => String(s).trim()) : [];
+    const entry = Array.isArray(data.entry) ? data.entry.map((e) => String(e).trim()) : [];
+    const skills = Array.isArray(data.skills)
+        ? data.skills.map((s) => String(s).trim())
+        : [];
+    const acceptanceSection = extractSection(body, 'Acceptance') || body;
+    const itemRegex = /^[*-]\s+\[[ xX]\]\s+(.+)$/gm;
+    const matches = acceptanceSection.matchAll(itemRegex);
+    const acceptance = [];
+    for (const match of matches) {
+        acceptance.push(match[1].trim());
+    }
+    return {
+        title,
+        verify,
+        scope,
+        entry,
+        skills,
+        acceptance,
+        raw: content,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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