@zhuan-ai/zhuanspec 1.3.0

package/dist/core/validation/validator.js

@@ -0,0 +1,409 @@
+import { readFileSync, promises as fs } from 'fs';
+import path from 'path';
+import { SpecSchema, ChangeSchema } from '../schemas/index.js';
+import { MarkdownParser } from '../parsers/markdown-parser.js';
+import { ChangeParser } from '../parsers/change-parser.js';
+import { MIN_PURPOSE_LENGTH, MAX_REQUIREMENT_TEXT_LENGTH, VALIDATION_MESSAGES } from './constants.js';
+import { parseDeltaSpec, normalizeRequirementName } from '../parsers/requirement-blocks.js';
+import { FileSystemUtils } from '../../utils/file-system.js';
+export class Validator {
+    strictMode;
+    constructor(strictMode = false) {
+        this.strictMode = strictMode;
+    }
+    async validateSpec(filePath) {
+        const issues = [];
+        const specName = this.extractNameFromPath(filePath);
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const parser = new MarkdownParser(content);
+            const spec = parser.parseSpec(specName);
+            const result = SpecSchema.safeParse(spec);
+            if (!result.success) {
+                issues.push(...this.convertZodErrors(result.error));
+            }
+            issues.push(...this.applySpecRules(spec, content));
+        }
+        catch (error) {
+            const baseMessage = error instanceof Error ? error.message : 'Unknown error';
+            const enriched = this.enrichTopLevelError(specName, baseMessage);
+            issues.push({
+                level: 'ERROR',
+                path: 'file',
+                message: enriched,
+            });
+        }
+        return this.createReport(issues);
+    }
+    /**
+     * Validate spec content from a string (used for pre-write validation of rebuilt specs)
+     */
+    async validateSpecContent(specName, content) {
+        const issues = [];
+        try {
+            const parser = new MarkdownParser(content);
+            const spec = parser.parseSpec(specName);
+            const result = SpecSchema.safeParse(spec);
+            if (!result.success) {
+                issues.push(...this.convertZodErrors(result.error));
+            }
+            issues.push(...this.applySpecRules(spec, content));
+        }
+        catch (error) {
+            const baseMessage = error instanceof Error ? error.message : 'Unknown error';
+            const enriched = this.enrichTopLevelError(specName, baseMessage);
+            issues.push({ level: 'ERROR', path: 'file', message: enriched });
+        }
+        return this.createReport(issues);
+    }
+    async validateChange(filePath) {
+        const issues = [];
+        const changeName = this.extractNameFromPath(filePath);
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const changeDir = path.dirname(filePath);
+            const parser = new ChangeParser(content, changeDir);
+            const change = await parser.parseChangeWithDeltas(changeName);
+            const result = ChangeSchema.safeParse(change);
+            if (!result.success) {
+                issues.push(...this.convertZodErrors(result.error));
+            }
+            issues.push(...this.applyChangeRules(change, content));
+        }
+        catch (error) {
+            const baseMessage = error instanceof Error ? error.message : 'Unknown error';
+            const enriched = this.enrichTopLevelError(changeName, baseMessage);
+            issues.push({
+                level: 'ERROR',
+                path: 'file',
+                message: enriched,
+            });
+        }
+        return this.createReport(issues);
+    }
+    /**
+     * Validate delta-formatted spec files under a change directory.
+     * Enforces:
+     * - At least one delta across all files
+     * - ADDED/MODIFIED: each requirement has SHALL/MUST and at least one scenario
+     * - REMOVED: names only; no scenario/description required
+     * - RENAMED: pairs well-formed
+     * - No duplicates within sections; no cross-section conflicts per spec
+     */
+    async validateChangeDeltaSpecs(changeDir) {
+        const issues = [];
+        const specsDir = path.join(changeDir, 'specs');
+        let totalDeltas = 0;
+        const missingHeaderSpecs = [];
+        const emptySectionSpecs = [];
+        try {
+            const entries = await fs.readdir(specsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const specName = entry.name;
+                const specFile = path.join(specsDir, specName, 'spec.md');
+                let content;
+                try {
+                    content = await fs.readFile(specFile, 'utf-8');
+                }
+                catch {
+                    continue;
+                }
+                const plan = parseDeltaSpec(content);
+                const entryPath = `${specName}/spec.md`;
+                const sectionNames = [];
+                if (plan.sectionPresence.added)
+                    sectionNames.push('## ADDED Requirements');
+                if (plan.sectionPresence.modified)
+                    sectionNames.push('## MODIFIED Requirements');
+                if (plan.sectionPresence.removed)
+                    sectionNames.push('## REMOVED Requirements');
+                if (plan.sectionPresence.renamed)
+                    sectionNames.push('## RENAMED Requirements');
+                const hasSections = sectionNames.length > 0;
+                const hasEntries = plan.added.length + plan.modified.length + plan.removed.length + plan.renamed.length > 0;
+                if (!hasEntries) {
+                    if (hasSections)
+                        emptySectionSpecs.push({ path: entryPath, sections: sectionNames });
+                    else
+                        missingHeaderSpecs.push(entryPath);
+                }
+                const addedNames = new Set();
+                const modifiedNames = new Set();
+                const removedNames = new Set();
+                const renamedFrom = new Set();
+                const renamedTo = new Set();
+                // Validate ADDED
+                for (const block of plan.added) {
+                    const key = normalizeRequirementName(block.name);
+                    totalDeltas++;
+                    if (addedNames.has(key)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `ADDED 中存在重复的要求: "${block.name}"` });
+                    }
+                    else {
+                        addedNames.add(key);
+                    }
+                    const requirementText = this.extractRequirementText(block.raw);
+                    if (!requirementText) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `ADDED "${block.name}" 缺少要求文本` });
+                    }
+                    else if (!this.containsShallOrMust(requirementText)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `ADDED "${block.name}" 必须包含 SHALL 或 MUST` });
+                    }
+                    const scenarioCount = this.countScenarios(block.raw);
+                    if (scenarioCount < 1) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `ADDED "${block.name}" 必须包含至少一个场景` });
+                    }
+                }
+                // Validate MODIFIED
+                for (const block of plan.modified) {
+                    const key = normalizeRequirementName(block.name);
+                    totalDeltas++;
+                    if (modifiedNames.has(key)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `MODIFIED 中存在重复的要求: "${block.name}"` });
+                    }
+                    else {
+                        modifiedNames.add(key);
+                    }
+                    const requirementText = this.extractRequirementText(block.raw);
+                    if (!requirementText) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `MODIFIED "${block.name}" 缺少要求文本` });
+                    }
+                    else if (!this.containsShallOrMust(requirementText)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `MODIFIED "${block.name}" 必须包含 SHALL 或 MUST` });
+                    }
+                    const scenarioCount = this.countScenarios(block.raw);
+                    if (scenarioCount < 1) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `MODIFIED "${block.name}" 必须包含至少一个场景` });
+                    }
+                }
+                // Validate REMOVED (names only)
+                for (const name of plan.removed) {
+                    const key = normalizeRequirementName(name);
+                    totalDeltas++;
+                    if (removedNames.has(key)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `REMOVED 中存在重复的要求: "${name}"` });
+                    }
+                    else {
+                        removedNames.add(key);
+                    }
+                }
+                // Validate RENAMED pairs
+                for (const { from, to } of plan.renamed) {
+                    const fromKey = normalizeRequirementName(from);
+                    const toKey = normalizeRequirementName(to);
+                    totalDeltas++;
+                    if (renamedFrom.has(fromKey)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `RENAMED 中存在重复的 FROM: "${from}"` });
+                    }
+                    else {
+                        renamedFrom.add(fromKey);
+                    }
+                    if (renamedTo.has(toKey)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `RENAMED 中存在重复的 TO: "${to}"` });
+                    }
+                    else {
+                        renamedTo.add(toKey);
+                    }
+                }
+                // Cross-section conflicts (within the same spec file)
+                for (const n of modifiedNames) {
+                    if (removedNames.has(n)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `要求同时出现在 MODIFIED 和 REMOVED 中: "${n}"` });
+                    }
+                    if (addedNames.has(n)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `要求同时出现在 MODIFIED 和 ADDED 中: "${n}"` });
+                    }
+                }
+                for (const n of addedNames) {
+                    if (removedNames.has(n)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `要求同时出现在 ADDED 和 REMOVED 中: "${n}"` });
+                    }
+                }
+                for (const { from, to } of plan.renamed) {
+                    const fromKey = normalizeRequirementName(from);
+                    const toKey = normalizeRequirementName(to);
+                    if (modifiedNames.has(fromKey)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `MODIFIED 引用了 RENAMED 中的旧名称。请使用新标题 "${to}"` });
+                    }
+                    if (addedNames.has(toKey)) {
+                        issues.push({ level: 'ERROR', path: entryPath, message: `RENAMED TO 与 ADDED 中的 "${to}" 冲突` });
+                    }
+                }
+            }
+        }
+        catch {
+            // If no specs dir, treat as no deltas
+        }
+        for (const { path: specPath, sections } of emptySectionSpecs) {
+            issues.push({
+                level: 'ERROR',
+                path: specPath,
+                message: `Delta sections ${this.formatSectionList(sections)} were found, but no requirement entries parsed. Ensure each section includes at least one "### Requirement:" block (REMOVED may use bullet list syntax).`,
+            });
+        }
+        for (const path of missingHeaderSpecs) {
+            issues.push({
+                level: 'ERROR',
+                path,
+                message: 'No delta sections found. Add headers such as "## ADDED Requirements" or move non-delta notes outside specs/.',
+            });
+        }
+        if (totalDeltas === 0) {
+            issues.push({ level: 'ERROR', path: 'file', message: this.enrichTopLevelError('change', VALIDATION_MESSAGES.CHANGE_NO_DELTAS) });
+        }
+        return this.createReport(issues);
+    }
+    convertZodErrors(error) {
+        return error.issues.map(err => {
+            let message = err.message;
+            if (message === VALIDATION_MESSAGES.CHANGE_NO_DELTAS) {
+                message = `${message}. ${VALIDATION_MESSAGES.GUIDE_NO_DELTAS}`;
+            }
+            return {
+                level: 'ERROR',
+                path: err.path.join('.'),
+                message,
+            };
+        });
+    }
+    applySpecRules(spec, content) {
+        const issues = [];
+        if (spec.overview.length < MIN_PURPOSE_LENGTH) {
+            issues.push({
+                level: 'WARNING',
+                path: 'overview',
+                message: VALIDATION_MESSAGES.PURPOSE_TOO_BRIEF,
+            });
+        }
+        spec.requirements.forEach((req, index) => {
+            if (req.text.length > MAX_REQUIREMENT_TEXT_LENGTH) {
+                issues.push({
+                    level: 'INFO',
+                    path: `requirements[${index}]`,
+                    message: VALIDATION_MESSAGES.REQUIREMENT_TOO_LONG,
+                });
+            }
+            if (req.scenarios.length === 0) {
+                issues.push({
+                    level: 'WARNING',
+                    path: `requirements[${index}].scenarios`,
+                    message: `${VALIDATION_MESSAGES.REQUIREMENT_NO_SCENARIOS}. ${VALIDATION_MESSAGES.GUIDE_SCENARIO_FORMAT}`,
+                });
+            }
+        });
+        return issues;
+    }
+    applyChangeRules(change, content) {
+        const issues = [];
+        const MIN_DELTA_DESCRIPTION_LENGTH = 10;
+        change.deltas.forEach((delta, index) => {
+            if (!delta.description || delta.description.length < MIN_DELTA_DESCRIPTION_LENGTH) {
+                issues.push({
+                    level: 'WARNING',
+                    path: `deltas[${index}].description`,
+                    message: VALIDATION_MESSAGES.DELTA_DESCRIPTION_TOO_BRIEF,
+                });
+            }
+            if ((delta.operation === 'ADDED' || delta.operation === 'MODIFIED') &&
+                (!delta.requirements || delta.requirements.length === 0)) {
+                issues.push({
+                    level: 'WARNING',
+                    path: `deltas[${index}].requirements`,
+                    message: `${delta.operation} ${VALIDATION_MESSAGES.DELTA_MISSING_REQUIREMENTS}`,
+                });
+            }
+        });
+        return issues;
+    }
+    enrichTopLevelError(itemId, baseMessage) {
+        const msg = baseMessage.trim();
+        if (msg === VALIDATION_MESSAGES.CHANGE_NO_DELTAS) {
+            return `${msg}. ${VALIDATION_MESSAGES.GUIDE_NO_DELTAS}`;
+        }
+        if (msg.includes('Spec must have a Purpose section') || msg.includes('Spec must have a Requirements section')) {
+            return `${msg}. ${VALIDATION_MESSAGES.GUIDE_MISSING_SPEC_SECTIONS}`;
+        }
+        if (msg.includes('Change must have a Why section') || msg.includes('Change must have a What Changes section')) {
+            return `${msg}. ${VALIDATION_MESSAGES.GUIDE_MISSING_CHANGE_SECTIONS}`;
+        }
+        return msg;
+    }
+    extractNameFromPath(filePath) {
+        const normalizedPath = FileSystemUtils.toPosixPath(filePath);
+        const parts = normalizedPath.split('/');
+        // Look for the directory name after 'specs' or 'changes'
+        for (let i = parts.length - 1; i >= 0; i--) {
+            if (parts[i] === 'specs' || parts[i] === 'changes') {
+                if (i < parts.length - 1) {
+                    return parts[i + 1];
+                }
+            }
+        }
+        // Fallback to filename without extension if not in expected structure
+        const fileName = parts[parts.length - 1] ?? '';
+        const dotIndex = fileName.lastIndexOf('.');
+        return dotIndex > 0 ? fileName.slice(0, dotIndex) : fileName;
+    }
+    createReport(issues) {
+        const errors = issues.filter(i => i.level === 'ERROR').length;
+        const warnings = issues.filter(i => i.level === 'WARNING').length;
+        const info = issues.filter(i => i.level === 'INFO').length;
+        const valid = this.strictMode
+            ? errors === 0 && warnings === 0
+            : errors === 0;
+        return {
+            valid,
+            issues,
+            summary: {
+                errors,
+                warnings,
+                info,
+            },
+        };
+    }
+    isValid(report) {
+        return report.valid;
+    }
+    extractRequirementText(blockRaw) {
+        const lines = blockRaw.split('\n');
+        // Skip header line (index 0)
+        let i = 1;
+        // Find the first substantial text line, skipping metadata and blank lines
+        for (; i < lines.length; i++) {
+            const line = lines[i];
+            // Stop at scenario headers
+            if (/^####\s+/.test(line))
+                break;
+            const trimmed = line.trim();
+            // Skip blank lines
+            if (trimmed.length === 0)
+                continue;
+            // Skip metadata lines (lines starting with ** like **ID**, **Priority**, etc.)
+            if (/^\*\*[^*]+\*\*:/.test(trimmed))
+                continue;
+            // Found first non-metadata, non-blank line - this is the requirement text
+            return trimmed;
+        }
+        // No requirement text found
+        return undefined;
+    }
+    containsShallOrMust(text) {
+        return /\b(SHALL|MUST)\b/.test(text);
+    }
+    countScenarios(blockRaw) {
+        const matches = blockRaw.match(/^####\s+/gm);
+        return matches ? matches.length : 0;
+    }
+    formatSectionList(sections) {
+        if (sections.length === 0)
+            return '';
+        if (sections.length === 1)
+            return sections[0];
+        const head = sections.slice(0, -1);
+        const last = sections[sections.length - 1];
+        return `${head.join(', ')} and ${last}`;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/view.d.ts

@@ -0,0 +1,8 @@
+export declare class ViewCommand {
+    execute(targetPath?: string): Promise<void>;
+    private getChangesData;
+    private getSpecsData;
+    private displaySummary;
+    private createProgressBar;
+}
+//# sourceMappingURL=view.d.ts.map

package/dist/core/view.js

@@ -0,0 +1,168 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import { getTaskProgressForChange } from '../utils/task-progress.js';
+import { MarkdownParser } from './parsers/markdown-parser.js';
+export class ViewCommand {
+    async execute(targetPath = '.') {
+        const zhuanspecDir = path.join(targetPath, 'zhuanspec');
+        if (!fs.existsSync(zhuanspecDir)) {
+            console.error(chalk.red('No zhuanspec directory found'));
+            process.exit(1);
+        }
+        console.log(chalk.bold('\nZhuanSpec Dashboard\n'));
+        console.log('═'.repeat(60));
+        // Get changes and specs data
+        const changesData = await this.getChangesData(zhuanspecDir);
+        const specsData = await this.getSpecsData(zhuanspecDir);
+        // Display summary metrics
+        this.displaySummary(changesData, specsData);
+        // Display draft changes
+        if (changesData.draft.length > 0) {
+            console.log(chalk.bold.gray('\nDraft Changes'));
+            console.log('─'.repeat(60));
+            changesData.draft.forEach((change) => {
+                console.log(`  ${chalk.gray('○')} ${change.name}`);
+            });
+        }
+        // Display active changes
+        if (changesData.active.length > 0) {
+            console.log(chalk.bold.cyan('\nActive Changes'));
+            console.log('─'.repeat(60));
+            changesData.active.forEach((change) => {
+                const progressBar = this.createProgressBar(change.progress.completed, change.progress.total);
+                const percentage = change.progress.total > 0
+                    ? Math.round((change.progress.completed / change.progress.total) * 100)
+                    : 0;
+                console.log(`  ${chalk.yellow('◉')} ${chalk.bold(change.name.padEnd(30))} ${progressBar} ${chalk.dim(`${percentage}%`)}`);
+            });
+        }
+        // Display completed changes
+        if (changesData.completed.length > 0) {
+            console.log(chalk.bold.green('\nCompleted Changes'));
+            console.log('─'.repeat(60));
+            changesData.completed.forEach((change) => {
+                console.log(`  ${chalk.green('✓')} ${change.name}`);
+            });
+        }
+        // Display specifications
+        if (specsData.length > 0) {
+            console.log(chalk.bold.blue('\nSpecifications'));
+            console.log('─'.repeat(60));
+            // Sort specs by requirement count (descending)
+            specsData.sort((a, b) => b.requirementCount - a.requirementCount);
+            specsData.forEach(spec => {
+                const reqLabel = spec.requirementCount === 1 ? 'requirement' : 'requirements';
+                console.log(`  ${chalk.blue('▪')} ${chalk.bold(spec.name.padEnd(30))} ${chalk.dim(`${spec.requirementCount} ${reqLabel}`)}`);
+            });
+        }
+        console.log('\n' + '═'.repeat(60));
+        console.log(chalk.dim(`\nUse ${chalk.white('zhuanspec list --changes')} or ${chalk.white('zhuanspec list --specs')} for detailed views`));
+    }
+    async getChangesData(zhuanspecDir) {
+        const changesDir = path.join(zhuanspecDir, 'changes');
+        if (!fs.existsSync(changesDir)) {
+            return { draft: [], active: [], completed: [] };
+        }
+        const draft = [];
+        const active = [];
+        const completed = [];
+        const entries = fs.readdirSync(changesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && entry.name !== 'archive') {
+                const progress = await getTaskProgressForChange(changesDir, entry.name);
+                if (progress.total === 0) {
+                    // No tasks defined yet - still in planning/draft phase
+                    draft.push({ name: entry.name });
+                }
+                else if (progress.completed === progress.total) {
+                    // All tasks complete
+                    completed.push({ name: entry.name });
+                }
+                else {
+                    // Has tasks but not all complete
+                    active.push({ name: entry.name, progress });
+                }
+            }
+        }
+        // Sort all categories by name for deterministic ordering
+        draft.sort((a, b) => a.name.localeCompare(b.name));
+        // Sort active changes by completion percentage (ascending) and then by name
+        active.sort((a, b) => {
+            const percentageA = a.progress.total > 0 ? a.progress.completed / a.progress.total : 0;
+            const percentageB = b.progress.total > 0 ? b.progress.completed / b.progress.total : 0;
+            if (percentageA < percentageB)
+                return -1;
+            if (percentageA > percentageB)
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        completed.sort((a, b) => a.name.localeCompare(b.name));
+        return { draft, active, completed };
+    }
+    async getSpecsData(zhuanspecDir) {
+        const specsDir = path.join(zhuanspecDir, 'specs');
+        if (!fs.existsSync(specsDir)) {
+            return [];
+        }
+        const specs = [];
+        const entries = fs.readdirSync(specsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const specFile = path.join(specsDir, entry.name, 'spec.md');
+                if (fs.existsSync(specFile)) {
+                    try {
+                        const content = fs.readFileSync(specFile, 'utf-8');
+                        const parser = new MarkdownParser(content);
+                        const spec = parser.parseSpec(entry.name);
+                        const requirementCount = spec.requirements.length;
+                        specs.push({ name: entry.name, requirementCount });
+                    }
+                    catch (error) {
+                        // If spec cannot be parsed, include with 0 count
+                        specs.push({ name: entry.name, requirementCount: 0 });
+                    }
+                }
+            }
+        }
+        return specs;
+    }
+    displaySummary(changesData, specsData) {
+        const totalChanges = changesData.draft.length + changesData.active.length + changesData.completed.length;
+        const totalSpecs = specsData.length;
+        const totalRequirements = specsData.reduce((sum, spec) => sum + spec.requirementCount, 0);
+        // Calculate total task progress
+        let totalTasks = 0;
+        let completedTasks = 0;
+        changesData.active.forEach((change) => {
+            totalTasks += change.progress.total;
+            completedTasks += change.progress.completed;
+        });
+        changesData.completed.forEach(() => {
+            // Completed changes count as 100% done (we don't know exact task count)
+            // This is a simplification
+        });
+        console.log(chalk.bold('Summary:'));
+        console.log(`  ${chalk.cyan('●')} Specifications: ${chalk.bold(totalSpecs)} specs, ${chalk.bold(totalRequirements)} requirements`);
+        if (changesData.draft.length > 0) {
+            console.log(`  ${chalk.gray('●')} Draft Changes: ${chalk.bold(changesData.draft.length)}`);
+        }
+        console.log(`  ${chalk.yellow('●')} Active Changes: ${chalk.bold(changesData.active.length)} in progress`);
+        console.log(`  ${chalk.green('●')} Completed Changes: ${chalk.bold(changesData.completed.length)}`);
+        if (totalTasks > 0) {
+            const overallProgress = Math.round((completedTasks / totalTasks) * 100);
+            console.log(`  ${chalk.magenta('●')} Task Progress: ${chalk.bold(`${completedTasks}/${totalTasks}`)} (${overallProgress}% complete)`);
+        }
+    }
+    createProgressBar(completed, total, width = 20) {
+        if (total === 0)
+            return chalk.dim('─'.repeat(width));
+        const percentage = completed / total;
+        const filled = Math.round(percentage * width);
+        const empty = width - filled;
+        const filledBar = chalk.green('█'.repeat(filled));
+        const emptyBar = chalk.dim('░'.repeat(empty));
+        return `[${filledBar}${emptyBar}]`;
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cli/index.js';
+export * from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './cli/index.js';
+export * from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/change-metadata.d.ts

@@ -0,0 +1,47 @@
+import { type ChangeMetadata } from '../core/artifact-graph/types.js';
+/**
+ * Error thrown when change metadata validation fails.
+ */
+export declare class ChangeMetadataError extends Error {
+    readonly metadataPath: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, metadataPath: string, cause?: Error | undefined);
+}
+/**
+ * Validates that a schema name is valid (exists in available schemas).
+ *
+ * @param schemaName - The schema name to validate
+ * @returns The validated schema name
+ * @throws Error if schema is not found
+ */
+export declare function validateSchemaName(schemaName: string): string;
+/**
+ * Writes change metadata to .zhuanspec.yaml in the change directory.
+ *
+ * @param changeDir - The path to the change directory
+ * @param metadata - The metadata to write
+ * @throws ChangeMetadataError if validation fails or write fails
+ */
+export declare function writeChangeMetadata(changeDir: string, metadata: ChangeMetadata): void;
+/**
+ * Reads change metadata from .zhuanspec.yaml in the change directory.
+ *
+ * @param changeDir - The path to the change directory
+ * @returns The validated metadata, or null if no metadata file exists
+ * @throws ChangeMetadataError if the file exists but is invalid
+ */
+export declare function readChangeMetadata(changeDir: string): ChangeMetadata | null;
+/**
+ * Resolves the schema for a change, with explicit override taking precedence.
+ *
+ * Resolution order:
+ * 1. Explicit schema (if provided)
+ * 2. Schema from .zhuanspec.yaml metadata (if exists)
+ * 3. Default 'spec-driven'
+ *
+ * @param changeDir - The path to the change directory
+ * @param explicitSchema - Optional explicit schema override
+ * @returns The resolved schema name
+ */
+export declare function resolveSchemaForChange(changeDir: string, explicitSchema?: string): string;
+//# sourceMappingURL=change-metadata.d.ts.map