@nan0web/release 3.3.0 → 3.5.0

package/types/domain/ServeCommand.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ServeCommand - Universal ModelAsApp for data or release catalogs.
+ *
+ * Generates HTML content from README.md and release templates using $db and Markdown.
+ * Pure OLMUI model: does not start HTTP server, does not call node:fs or child_process.
+ *
+ * Usage:
+ *   pnpm exec serve releases/  # Runs via CLI bootstrap
+ */
+export default class ServeCommand extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        title: string;
+        help: string;
+        serving: string;
+        dirNotFound: string;
+    };
+    static dir: {
+        help: string;
+        positional: boolean;
+        type: string;
+        default: string;
+    };
+    static port: {
+        help: string;
+        default: number;
+        type: string;
+        alias: string;
+    };
+    static open: {
+        help: string;
+        default: boolean;
+        type: string;
+    };
+    /**
+     * @param {Partial<ServeCommand>} [data]
+     * @param {import('@nan0web/types').ModelOptions} [options]
+     */
+    constructor(data?: Partial<ServeCommand>, options?: import("@nan0web/types").ModelOptions);
+    /** @type {string} */
+    dir: string;
+    /** @type {number} */
+    port: number;
+    /** @type {boolean} */
+    open: boolean;
+    /**
+     * Convert markdown string to HTML using @nan0web/markdown
+     * @param {string} mdRaw
+     * @returns {string}
+     */
+    renderMarkdownToHtml(mdRaw: string): string;
+    /**
+     * Render HTML content for the target directory
+     * @returns {Promise<string>}
+     */
+    renderHtml(): Promise<string>;
+    run(): AsyncGenerator<import("@nan0web/ui/src/core/Intent.js").ShowIntent, import("@nan0web/ui/src/core/Intent.js").ResultIntent, unknown>;
+}
+import { ModelAsApp } from '@nan0web/ui';

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

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

package/types/domain/SpecCommand.d.ts

@@ -1,4 +1,3 @@
-import { ModelAsApp } from '@nan0web/ui';
 export default class SpecCommand extends ModelAsApp {
     static version: {
         help: string;
@@ -12,9 +11,8 @@ export default class SpecCommand extends ModelAsApp {
      * @param {Partial<SpecCommand>} [data]
      * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
      */
-    constructor(data?: Partial<SpecCommand>, options?: Partial<import('@nan0web/ui').ModelAsAppOptions>);
-    /**
-     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
-     */
-    run(): AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>;
+    constructor(data?: Partial<SpecCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {string} Release version filter */
+    version: string;
 }
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/StatusCommand.d.ts

@@ -1,11 +1,46 @@
-import { ModelAsApp } from '@nan0web/ui';
+/**
+ * StatusCommand - ModelAsApp Subcommand to display PM-as-Code dashboard and project inspector.
+ */
 export default class StatusCommand extends ModelAsApp {
+    static alias: string;
     static UI: {
         title: string;
         help: string;
+        header: string;
+        summaryHeader: string;
+        summaryRow1: string;
+        summaryRow2: string;
+        noProjects: string;
+    };
+    static registryFile: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static target: {
+        help: string;
+        default: string;
+        positional: boolean;
+        type: string;
+    };
+    static sort: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
     };
     /**
-     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+     * @param {Partial<StatusCommand>} [data]
+     * @param {import('@nan0web/types').ModelOptions} [options]
      */
-    run(): AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>;
+    constructor(data?: Partial<StatusCommand>, options?: import("@nan0web/types").ModelOptions);
+    /** @type {string} */ registryFile: string;
+    /** @type {string} */ target: string;
+    /** @type {string} */ sort: string;
+    /**
+     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
+     */
+    run(): AsyncGenerator<import("@nan0web/ui").Intent, any, any>;
 }
+import { ModelAsApp } from '@nan0web/ui';

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/ViewCommand.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ViewCommand - ModelAsApp Subcommand to inspect and view release details across multimodal interfaces.
+ */
+export default class ViewCommand extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        title: string;
+        help: string;
+        noReleases: string;
+        selectPrompt: string;
+    };
+    static version: {
+        help: string;
+        positional: boolean;
+        type: string;
+        default: string;
+    };
+    /**
+     * @param {Partial<ViewCommand>} [data]
+     * @param {import('@nan0web/types').ModelOptions} [options]
+     */
+    constructor(data?: Partial<ViewCommand>, options?: import("@nan0web/types").ModelOptions);
+    /** @type {string} */
+    version: string;
+    run(): AsyncGenerator<import("@nan0web/ui/src/core/Intent.js").ShowIntent, import("@nan0web/ui/src/core/Intent.js").ResultIntent, unknown>;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/WebCommand.d.ts

@@ -0,0 +1,47 @@
+/**
+ * WebCommand - ModelAsApp Subcommand to generate and launch PM-as-Code Web Dashboard.
+ */
+export default class WebCommand extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        title: string;
+        help: string;
+        loading: string;
+        generated: string;
+        serving: string;
+    };
+    static registryFile: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static out: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static port: {
+        help: string;
+        default: number;
+        type: string;
+        alias: string;
+    };
+    static open: {
+        help: string;
+        default: boolean;
+        type: string;
+    };
+    /**
+     * @param {Partial<WebCommand>} [data]
+     * @param {import('@nan0web/types').ModelOptions} [options]
+     */
+    constructor(data?: Partial<WebCommand>, options?: import("@nan0web/types").ModelOptions);
+    /** @type {string} */ registryFile: string;
+    /** @type {string} */ out: string;
+    /** @type {number} */ port: number;
+    /** @type {boolean} */ open: boolean;
+    run(): AsyncGenerator<import("@nan0web/ui/src/core/Intent.js").ProgressIntent | import("@nan0web/ui/src/core/Intent.js").ShowIntent, import("@nan0web/ui/src/core/Intent.js").ResultIntent, unknown>;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/inspect/ReleaseAuditor.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @typedef {Object} ReleaseDiagnostic
+ * @property {'error' | 'warning' | 'info'} level
+ * @property {string} code
+ * @property {string} [check]
+ * @property {string} [file]
+ * @property {string} error
+ * @property {string} [suggestion]
+ * @property {string} [fix]
+ */
+/**
+ * ReleaseAuditor — Architecture auditor and validator for PM-as-Code release structures.
+ */
+export class ReleaseAuditor extends AuditorModel {
+    static changed: {
+        help: string;
+        default: boolean;
+        type: string;
+        alias: string;
+    };
+    static all: {
+        help: string;
+        default: boolean;
+        type: string;
+        alias: string;
+    };
+    static registryFile: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static UI: {
+        title: string;
+        header: string;
+        skipped: string;
+        missingPackageJson: string;
+        noReleasesDir: string;
+        releasesFound: string;
+        releaseHeader: string;
+        releaseDocCompleted: string;
+        missingReleaseDoc: string;
+        missingUserDoc: string;
+        incompleteUserMetrics: string;
+        userMetricsValid: string;
+        ambiguousContracts: string;
+        missingContract: string;
+        activeContractWip: string;
+        sealedRegressionClosed: string;
+        orphanFile: string;
+        summary: string;
+        Diagnostics: {
+            MISSING_PACKAGE_JSON: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_RELEASES_DIR: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_RELEASE_MD: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_USER_MD: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            INCOMPLETE_USER_METRICS: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            AMBIGUOUS_CONTRACTS: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_CONTRACT: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            ORPHAN_RELEASE_FILE: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            PROCEDURAL_RELEASE_ARTIFACT: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+        };
+    };
+    /**
+     * @param {Partial<ReleaseAuditor> | Record<string, any>} [data={}]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options={}]
+     */
+    constructor(data?: Partial<ReleaseAuditor> | Record<string, any>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {boolean} */ changed: boolean;
+    /** @type {boolean} */ all: boolean;
+    /** @type {string} */ registryFile: string;
+    /**
+     * Runs the PM-as-Code release audit.
+     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
+     */
+    run(): AsyncGenerator<import("@nan0web/ui").Intent, any, any>;
+    #private;
+}
+export default ReleaseAuditor;
+export type ReleaseDiagnostic = {
+    level: "error" | "warning" | "info";
+    code: string;
+    check?: string | undefined;
+    file?: string | undefined;
+    error: string;
+    suggestion?: string | undefined;
+    fix?: string | undefined;
+};
+import { AuditorModel } from '@nan0web/inspect/domain/AuditorModel';

package/types/domain/inspect/ReleaseAuditor.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';

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

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