@nan0web/release 3.2.0 → 3.4.0

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/templates/release.html.template.d.ts

@@ -0,0 +1,2 @@
+declare const _default: "<!DOCTYPE html>\n<html lang=\"uk\" data-bs-theme=\"dark\">\n<head>\n  <meta charset=\"utf-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n  <title>Releases Catalog \u2014 NaN\u2022Web</title>\n  <style>\n    :root {\n      --bg: #0f172a;\n      --surface: #1e293b;\n      --accent: #38bdf8;\n      --text: #f8fafc;\n      --text-dim: #94a3b8;\n      --border: #334155;\n    }\n    body { font-family: system-ui, -apple-system, sans-serif; background: var(--bg); color: var(--text); margin: 0; padding: 2.5rem 1.5rem; display: flex; justify-content: center; line-height: 1.6; }\n    .container { max-width: 880px; width: 100%; }\n    h1, h2, h3 { color: #fff; font-weight: 700; margin-top: 1.5rem; }\n    h1 { font-size: 2rem; border-bottom: 1px solid var(--border); padding-bottom: 0.8rem; }\n    a { color: var(--accent); text-decoration: none; }\n    a:hover { text-decoration: underline; }\n    table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; background: var(--surface); border-radius: 8px; overflow: hidden; }\n    th, td { padding: 0.85rem 1rem; text-align: left; border-bottom: 1px solid var(--border); }\n    th { background: rgba(0,0,0,0.2); font-weight: 600; color: var(--accent); }\n    pre { background: var(--surface); padding: 1rem; border-radius: 8px; border: 1px solid var(--border); overflow-x: auto; color: #a5b4fc; font-family: monospace; }\n    blockquote { border-left: 4px solid var(--accent); margin: 1rem 0; padding: 0.5rem 1rem; background: var(--surface); border-radius: 0 8px 8px 0; }\n  </style>\n</head>\n<body>\n  <div class=\"container\">\n    {{CONTENT}}\n  </div>\n</body>\n</html>";
+export default _default;

package/types/index.d.ts

@@ -6,6 +6,11 @@ export { default as DepsCommand } from "./domain/DepsCommand.js";
 export { default as PublishCommand } from "./domain/PublishCommand.js";
 export { default as SpecCommand } from "./domain/SpecCommand.js";
 export { default as StatusCommand } from "./domain/StatusCommand.js";
+export { default as WebCommand } from "./domain/WebCommand.js";
+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";
 import Release from './Release.js';
 import ReleaseDocument from './Release/Document.js';
 import Person from './Release/Person.js';

package/types/inspectors/inspect-js.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/types/utils/nodejs/GitTelemetry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Reset internal Git caches (useful for testing or cache invalidation)
+ */
+export function resetGitCache(): void;
+/**
+ * Retrieve git branch and workspace status (clean / dirty)
+ * @param {string} [projectDir]
+ * @returns {{ branch: string, gitStatus: 'clean' | 'dirty' }}
+ */
+export function getGitInfo(projectDir?: string): {
+    branch: string;
+    gitStatus: "clean" | "dirty";
+};
+/**
+ * Retrieve development hours and iterations from git commit log
+ * @param {string} [projectDir]
+ * @param {string} [releasePath]
+ * @returns {{ hours: number, iterations: number }}
+ */
+export function getGitCommitTelemetry(projectDir?: string, releasePath?: string): {
+    hours: number;
+    iterations: number;
+};