@nan0web/release 3.4.0 → 3.5.0

package/src/domain/models/ReleaseMemberModel.js

@@ -0,0 +1,21 @@
+import { Model } from '@nan0web/types'
+
+export class ReleaseMemberModel extends Model {
+	static role = { type: 'string', required: true }
+	static name = { type: 'string', required: true }
+	static handle = { type: 'string' }
+
+	/**
+	 * @param {Partial<ReleaseMemberModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Role / Position (Посада) */
+		this.role
+		/** @type {string} Full Name (Ім'я) */
+		this.name
+		/** @type {string} Login / Handle (Логін без @) */
+		this.handle
+	}
+}

package/src/domain/models/ReleaseModel.js

@@ -0,0 +1,191 @@
+import { Model } from '@nan0web/types'
+import { ReleaseMemberModel } from './ReleaseMemberModel.js'
+import { ReleaseTaskModel } from './ReleaseTaskModel.js'
+import { ReleaseParityModel } from './ReleaseParityModel.js'
+import { ReleaseIssueModel } from './ReleaseIssueModel.js'
+
+export class ReleaseModel extends Model {
+	static version = { type: 'string', required: true }
+	static title = { type: 'string', required: true }
+	static status = { type: 'string', default: 'todo' } // 'todo' | 'work' | 'done' | 'fail'
+	static type = { type: 'string', default: 'minor' } // 'major' | 'minor' | 'patch' | 'hotfix' | 'chore'
+	static summary = { type: 'string' }
+	static epic = { type: 'string' }
+	static sprint = { type: 'string' }
+	static tracker = { type: 'string' }
+
+	// Sub-collections
+	static team = { type: 'array', itemType: ReleaseMemberModel, default: [] }
+	static tasks = { type: 'array', itemType: ReleaseTaskModel, default: [] }
+	static criteria = { type: 'array', itemType: ReleaseTaskModel, default: [] }
+	static parity = { type: 'array', itemType: ReleaseParityModel, default: [] }
+	static issues = { type: 'array', itemType: ReleaseIssueModel, default: [] }
+	static files = { type: 'array', default: [] }
+	static meta = { type: 'object', default: {} }
+
+	/**
+	 * @param {Partial<ReleaseModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Release version */
+		this.version
+		/** @type {string} Release title */
+		this.title
+		/** @type {'todo' | 'work' | 'done' | 'fail'} Release status */
+		this.status
+		/** @type {'major' | 'minor' | 'patch' | 'hotfix' | 'chore'} Release type */
+		this.type
+		/** @type {string} Release summary / description */
+		this.summary
+		/** @type {string} Epic identifier */
+		this.epic
+		/** @type {string} Sprint name */
+		this.sprint
+		/** @type {string} External tracker URL template */
+		this.tracker
+		/** @type {ReleaseMemberModel[]} Team members (ролі, імена, логіни) */
+		this.team
+		/** @type {ReleaseTaskModel[]} Tasks in scope */
+		this.tasks
+		/** @type {ReleaseTaskModel[]} Acceptance criteria (DoD) */
+		this.criteria
+		/** @type {ReleaseParityModel[]} Data parity verification items */
+		this.parity
+		/** @type {ReleaseIssueModel[]} Issues and risks */
+		this.issues
+		/** @type {Array<{file: string, size?: string, hash?: string, type?: string}>} Artifact files */
+		this.files
+		/** @type {Record<string, any>} Frontmatter / metadata */
+		this.meta
+	}
+
+	static SECTIONS = {
+		summary: [
+			// EN (English)
+			'summary', 'objective', 'description', 'overview',
+			// UK (Українська)
+			'опис', 'мета', 'ціль', 'огляд',
+			// ES (Español)
+			'resumen', 'objetivo', 'descripcion',
+			// FR (Français)
+			'resume', 'objectif',
+			// DE (Deutsch)
+			'zusammenfassung', 'ziel', 'beschreibung',
+			// ZH (中文 - Chinese)
+			'摘要', '目标', '描述',
+			// RU (Російська - для сумісності з двомовними українцями)
+			'описание', 'цель', 'обзор',
+		],
+		team: [
+			// EN (English)
+			'team', 'members', 'contributors', 'roles',
+			// UK (Українська)
+			'команда', 'учасники', 'ролі',
+			// ES (Español)
+			'equipo', 'miembros',
+			// FR (Français)
+			'equipe', 'membres',
+			// DE (Deutsch)
+			'mitglieder',
+			// ZH (中文 - Chinese)
+			'团队', '成员',
+			// RU (Російська)
+			'участники', 'роли',
+		],
+		tasks: [
+			// EN (English)
+			'tasks', 'scope', 'work plan', 'wbs', 'backlog', 'plan',
+			// UK (Українська)
+			'план', 'задачі', 'робочий план', 'обсяг',
+			// ES (Español)
+			'tareas', 'plan de trabajo',
+			// FR (Français)
+			'taches', 'plan de travail',
+			// DE (Deutsch)
+			'aufgaben', 'arbeitsplan',
+			// ZH (中文 - Chinese)
+			'任务', '工作计划',
+			// RU (Російська)
+			'задачи', 'рабочий план',
+		],
+		criteria: [
+			// EN (English)
+			'acceptance', 'acceptance criteria', 'dod', 'definition of done', 'requirements',
+			// UK (Українська)
+			'критерії', 'критерії прийнятності', 'вимоги',
+			// ES (Español)
+			'criterios', 'criterios de aceptacion', 'requisitos',
+			// FR (Français)
+			'criteres', 'criteres d acceptation', 'exigences',
+			// DE (Deutsch)
+			'akzeptanzkriterien', 'anforderungen',
+			// ZH (中文 - Chinese)
+			'验收标准', '准入条件', '要求',
+			// RU (Російська)
+			'критерии', 'критерии приемки', 'требования',
+		],
+		parity: [
+			// EN (English)
+			'parity', 'data parity', 'audit', 'verification',
+			// UK (Українська)
+			'паритет', 'аудит', 'паритет даних', 'верифікація',
+			// ES (Español)
+			'paridad', 'auditoria',
+			// FR (Français)
+			'parite',
+			// DE (Deutsch)
+			'datenparitaet',
+			// ZH (中文 - Chinese)
+			'数据对齐', '数据一致性', '审计',
+			// RU (Російська)
+			'паритет данных', 'верификация',
+		],
+		issues: [
+			// EN (English)
+			'issues', 'risks', 'blockers', 'problems', 'notes',
+			// UK (Українська)
+			'ризики', 'зауваження', 'блокери', 'проблеми',
+			// ES (Español)
+			'riesgos', 'problemas',
+			// FR (Français)
+			'risques',
+			// DE (Deutsch)
+			'risiken', 'hinweise',
+			// ZH (中文 - Chinese)
+			'风险', '问题', '注意事项',
+			// RU (Російська)
+			'риски', 'замечания', 'блокеры',
+		],
+		artifacts: [
+			// EN (English)
+			'artifacts', 'files', 'provenance', 'deliverables',
+			// UK (Українська)
+			'артефакти', 'файли',
+			// ES (Español)
+			'artefactos', 'archivos',
+			// FR (Français)
+			'artefacts', 'fichiers',
+			// DE (Deutsch)
+			'artefakte', 'dateien',
+			// ZH (中文 - Chinese)
+			'产物', '文件',
+			// RU (Російська)
+			'артефакты',
+		],
+	}
+
+	/**
+	 * Extend section synonyms dictionary with custom locale mappings.
+	 * @param {Record<string, string[]>} localeMap
+	 */
+	static addLocaleSections(localeMap) {
+		for (const [section, words] of Object.entries(localeMap)) {
+			if (this.SECTIONS[section]) {
+				this.SECTIONS[section].push(...words)
+			}
+		}
+	}
+}
+

package/src/domain/models/ReleaseParityModel.js

@@ -0,0 +1,27 @@
+import { Model } from '@nan0web/types'
+
+export class ReleaseParityModel extends Model {
+	static collection = { type: 'string', required: true }
+	static expected = { type: 'number', required: true }
+	static actual = { type: 'number', required: true }
+	static synced = { type: 'boolean', default: true }
+	static comment = { type: 'string' }
+
+	/**
+	 * @param {Partial<ReleaseParityModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Collection name */
+		this.collection
+		/** @type {number} Expected count */
+		this.expected
+		/** @type {number} Actual count */
+		this.actual
+		/** @type {boolean} Synced flag */
+		this.synced
+		/** @type {string} Audit comment */
+		this.comment
+	}
+}

package/src/domain/models/ReleaseTaskModel.js

@@ -0,0 +1,33 @@
+import { Model } from '@nan0web/types'
+
+export class ReleaseTaskModel extends Model {
+	static id = { type: 'string', required: true }
+	static title = { type: 'string', required: true }
+	static status = { type: 'string', default: 'todo' } // 'todo' | 'work' | 'done' | 'fail'
+	static assignee = { type: 'string' }
+	static estimateHours = { type: 'number' }
+	static spentHours = { type: 'number' }
+	static notes = { type: 'string' }
+
+	/**
+	 * @param {Partial<ReleaseTaskModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Task ID */
+		this.id
+		/** @type {string} Task Title */
+		this.title
+		/** @type {'todo' | 'work' | 'done' | 'fail'} Task Status */
+		this.status
+		/** @type {string} Assignee */
+		this.assignee
+		/** @type {number} Estimated Hours */
+		this.estimateHours
+		/** @type {number} Spent Hours */
+		this.spentHours
+		/** @type {string} Notes */
+		this.notes
+	}
+}

package/src/domain/models/index.js

@@ -0,0 +1,6 @@
+export { ReleaseMemberModel } from './ReleaseMemberModel.js'
+export { ReleaseTaskModel } from './ReleaseTaskModel.js'
+export { ReleaseParityModel } from './ReleaseParityModel.js'
+export { ReleaseIssueModel } from './ReleaseIssueModel.js'
+export { ReleaseModel } from './ReleaseModel.js'
+

package/src/index.js

@@ -35,4 +35,13 @@ export { default as PreviewCommand } from './domain/PreviewCommand.js'
 export { RegistryModel } from './domain/Registry/RegistryModel.js'
 export { DashboardModel } from './domain/Dashboard/DashboardModel.js'
 export { ReleaseAuditor } from './domain/inspect/ReleaseAuditor.js'
+export {
+	ReleaseModel,
+	ReleaseMemberModel,
+	ReleaseTaskModel,
+	ReleaseParityModel,
+	ReleaseIssueModel,
+} from './domain/models/index.js'
+export { PMaCParser, resolveTrackerUrl } from './domain/PMaCParser.js'
+export { ValidateCommand } from './domain/ValidateCommand.js'
 

package/types/domain/App.d.ts

@@ -5,7 +5,7 @@ export class ReleaseApp extends ModelAsApp {
     };
     static command: {
         help: string;
-        options: (typeof CheckCommand | typeof CloseCommand | typeof DepsCommand | typeof PublishCommand | typeof StatusCommand | typeof WebCommand | typeof ListCommand | typeof ServeCommand)[];
+        options: (typeof CheckCommand | typeof CloseCommand | typeof DepsCommand | typeof PublishCommand | typeof StatusCommand | typeof WebCommand | typeof ListCommand | typeof ServeCommand | typeof ValidateCommand)[];
         positional: boolean;
         default: typeof ViewCommand;
     };
@@ -30,4 +30,5 @@ import StatusCommand from './StatusCommand.js';
 import WebCommand from './WebCommand.js';
 import ListCommand from './ListCommand.js';
 import ServeCommand from './ServeCommand.js';
+import ValidateCommand from './ValidateCommand.js';
 import ViewCommand from './ViewCommand.js';

package/types/domain/PMaCParser.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Clean text from emoji, symbols, markdown formatting and trim.
+ * @param {string} text
+ * @returns {string}
+ */
+export function cleanSectionTitle(text: string): string;
+/**
+ * Match section title against known synonyms in ReleaseModel.SECTIONS.
+ * @param {string} headingText
+ * @param {typeof ReleaseModel} ModelClass
+ * @returns {string | null} Recognized section key or null
+ */
+export function identifySection(headingText: string, ModelClass?: typeof ReleaseModel): string | null;
+/**
+ * Resolve external tracker URL for a task or issue ID using template URL.
+ * Example: trackerUrl = "https://github.com/org/repo/issues/{id}", rawId = "[#142]" -> "https://github.com/org/repo/issues/142"
+ * @param {string} id
+ * @param {string} trackerTemplate
+ * @returns {string}
+ */
+export function resolveTrackerUrl(id: string, trackerTemplate: string): string;
+/**
+ * PMaCParser - Parses PMaC Release/Task specification documents into ReleaseModel instances.
+ */
+export class PMaCParser {
+    /**
+     * Static shortcut to parse specification
+     * @param {string} markdownContent
+     * @returns {ReleaseModel}
+     */
+    static parse(markdownContent: string): ReleaseModel;
+    /**
+     * @param {typeof ReleaseModel} [modelClass]
+     */
+    constructor(modelClass?: typeof ReleaseModel);
+    ModelClass: typeof ReleaseModel;
+    /**
+     * Parse markdown content into a ReleaseModel instance.
+     * @param {string} markdownContent
+     * @returns {ReleaseModel}
+     */
+    parse(markdownContent: string): ReleaseModel;
+    /**
+     * @private
+     */
+    private _parseTeamSection;
+    /**
+     * @private
+     */
+    private _parseTasksSection;
+    /**
+     * @private
+     */
+    private _parseParitySection;
+    /**
+     * @private
+     */
+    private _parseIssuesSection;
+    /**
+     * @private
+     */
+    private _parseArtifactsSection;
+}
+import { ReleaseModel } from './models/index.js';

package/types/domain/PMaCParser.story.d.ts

@@ -0,0 +1 @@
+export {};

package/types/domain/ValidateCommand.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ValidateCommand - CLI Release Inspector & Multi-Format Validator.
+ * Validates PMaC compliance, tasks, criteria, parity and outputs in text, json, nan0, or csv.
+ */
+export class ValidateCommand extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        title: string;
+        header: string;
+        scanningCount: string;
+        projectHeader: string;
+        noReleases: string;
+        savedReport: string;
+        summary: string;
+    };
+    static target: {
+        help: string;
+        default: string;
+        type: string;
+        positional: boolean;
+    };
+    static format: {
+        help: string;
+        default: string;
+        options: string[];
+        type: string;
+        alias: string;
+    };
+    static output: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static registryFile: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static all: {
+        help: string;
+        default: boolean;
+        type: string;
+        alias: string;
+    };
+    /**
+     * @param {Partial<ValidateCommand>} [data]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+     */
+    constructor(data?: Partial<ValidateCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {string} */ target: string;
+    /** @type {'text' | 'json' | 'nan0' | 'csv'} */ format: "text" | "json" | "nan0" | "csv";
+    /** @type {string} */ output: string;
+    /** @type {string} */ registryFile: string;
+    /** @type {boolean} */ all: boolean;
+    /**
+     * Execute release validation and format rendering
+     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, { success: boolean, releases: any[], output: string }, any>}
+     */
+    run(): AsyncGenerator<import("@nan0web/ui").Intent, {
+        success: boolean;
+        releases: any[];
+        output: string;
+    }, any>;
+    #private;
+}
+export default ValidateCommand;
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/ValidateCommand.story.d.ts

@@ -0,0 +1 @@
+export {};

package/types/domain/models/ReleaseIssueModel.d.ts

@@ -0,0 +1,35 @@
+export class ReleaseIssueModel extends Model {
+    static level: {
+        type: string;
+        default: string;
+    };
+    static code: {
+        type: string;
+    };
+    static message: {
+        type: string;
+        required: boolean;
+    };
+    static source: {
+        type: string;
+    };
+    static file: {
+        type: string;
+    };
+    /**
+     * @param {Partial<ReleaseIssueModel>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<ReleaseIssueModel>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type { 'error' | 'warning' | 'info' } Level of issue */
+    level: "error" | "warning" | "info";
+    /** @type {string} Issue code */
+    code: string;
+    /** @type {string} Issue message */
+    message: string;
+    /** @type {string} Issue source */
+    source: string;
+    /** @type {string} Issue file */
+    file: string;
+}
+import { Model } from '@nan0web/types';

package/types/domain/models/ReleaseMemberModel.d.ts

@@ -0,0 +1,25 @@
+export class ReleaseMemberModel extends Model {
+    static role: {
+        type: string;
+        required: boolean;
+    };
+    static name: {
+        type: string;
+        required: boolean;
+    };
+    static handle: {
+        type: string;
+    };
+    /**
+     * @param {Partial<ReleaseMemberModel>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<ReleaseMemberModel>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {string} Role / Position (Посада) */
+    role: string;
+    /** @type {string} Full Name (Ім'я) */
+    name: string;
+    /** @type {string} Login / Handle (Логін без @) */
+    handle: string;
+}
+import { Model } from '@nan0web/types';

package/types/domain/models/ReleaseModel.d.ts

@@ -0,0 +1,122 @@
+export class ReleaseModel extends Model {
+    static version: {
+        type: string;
+        required: boolean;
+    };
+    static title: {
+        type: string;
+        required: boolean;
+    };
+    static status: {
+        type: string;
+        default: string;
+    };
+    static type: {
+        type: string;
+        default: string;
+    };
+    static summary: {
+        type: string;
+    };
+    static epic: {
+        type: string;
+    };
+    static sprint: {
+        type: string;
+    };
+    static tracker: {
+        type: string;
+    };
+    static team: {
+        type: string;
+        itemType: typeof ReleaseMemberModel;
+        default: never[];
+    };
+    static tasks: {
+        type: string;
+        itemType: typeof ReleaseTaskModel;
+        default: never[];
+    };
+    static criteria: {
+        type: string;
+        itemType: typeof ReleaseTaskModel;
+        default: never[];
+    };
+    static parity: {
+        type: string;
+        itemType: typeof ReleaseParityModel;
+        default: never[];
+    };
+    static issues: {
+        type: string;
+        itemType: typeof ReleaseIssueModel;
+        default: never[];
+    };
+    static files: {
+        type: string;
+        default: never[];
+    };
+    static meta: {
+        type: string;
+        default: {};
+    };
+    static SECTIONS: {
+        summary: string[];
+        team: string[];
+        tasks: string[];
+        criteria: string[];
+        parity: string[];
+        issues: string[];
+        artifacts: string[];
+    };
+    /**
+     * Extend section synonyms dictionary with custom locale mappings.
+     * @param {Record<string, string[]>} localeMap
+     */
+    static addLocaleSections(localeMap: Record<string, string[]>): void;
+    /**
+     * @param {Partial<ReleaseModel>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<ReleaseModel>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {string} Release version */
+    version: string;
+    /** @type {string} Release title */
+    title: string;
+    /** @type {'todo' | 'work' | 'done' | 'fail'} Release status */
+    status: "todo" | "work" | "done" | "fail";
+    /** @type {'major' | 'minor' | 'patch' | 'hotfix' | 'chore'} Release type */
+    type: "major" | "minor" | "patch" | "hotfix" | "chore";
+    /** @type {string} Release summary / description */
+    summary: string;
+    /** @type {string} Epic identifier */
+    epic: string;
+    /** @type {string} Sprint name */
+    sprint: string;
+    /** @type {string} External tracker URL template */
+    tracker: string;
+    /** @type {ReleaseMemberModel[]} Team members (ролі, імена, логіни) */
+    team: ReleaseMemberModel[];
+    /** @type {ReleaseTaskModel[]} Tasks in scope */
+    tasks: ReleaseTaskModel[];
+    /** @type {ReleaseTaskModel[]} Acceptance criteria (DoD) */
+    criteria: ReleaseTaskModel[];
+    /** @type {ReleaseParityModel[]} Data parity verification items */
+    parity: ReleaseParityModel[];
+    /** @type {ReleaseIssueModel[]} Issues and risks */
+    issues: ReleaseIssueModel[];
+    /** @type {Array<{file: string, size?: string, hash?: string, type?: string}>} Artifact files */
+    files: Array<{
+        file: string;
+        size?: string;
+        hash?: string;
+        type?: string;
+    }>;
+    /** @type {Record<string, any>} Frontmatter / metadata */
+    meta: Record<string, any>;
+}
+import { Model } from '@nan0web/types';
+import { ReleaseMemberModel } from './ReleaseMemberModel.js';
+import { ReleaseTaskModel } from './ReleaseTaskModel.js';
+import { ReleaseParityModel } from './ReleaseParityModel.js';
+import { ReleaseIssueModel } from './ReleaseIssueModel.js';

package/types/domain/models/ReleaseParityModel.d.ts

@@ -0,0 +1,37 @@
+export class ReleaseParityModel extends Model {
+    static collection: {
+        type: string;
+        required: boolean;
+    };
+    static expected: {
+        type: string;
+        required: boolean;
+    };
+    static actual: {
+        type: string;
+        required: boolean;
+    };
+    static synced: {
+        type: string;
+        default: boolean;
+    };
+    static comment: {
+        type: string;
+    };
+    /**
+     * @param {Partial<ReleaseParityModel>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<ReleaseParityModel>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {string} Collection name */
+    collection: string;
+    /** @type {number} Expected count */
+    expected: number;
+    /** @type {number} Actual count */
+    actual: number;
+    /** @type {boolean} Synced flag */
+    synced: boolean;
+    /** @type {string} Audit comment */
+    comment: string;
+}
+import { Model } from '@nan0web/types';