@nan0web/release 1.0.0 → 1.0.2

package/types/Release.d.ts

@@ -1,38 +1,8 @@
-export default Release;
-export type ReleaseConfig = {
-    /**
-     * - Release version
-     */
-    version?: string | undefined;
-    /**
-     * -
-     */
-    createdAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    startAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    planAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    completeAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    document?: string | ReleaseDocument | undefined;
-    /**
-     * - Task map with test functions
-     */
-    tasks?: Map<string, Function> | undefined;
-};
 /**
  * @typedef {Object} ReleaseConfig
  * @property {string} [version] - Release version
  * @property {string | number | Date | undefined} [createdAt] -
+ * @property {string | number | Date | undefined} [date] - Alias for createdAt
  * @property {string | number | Date | undefined} [startAt] -
  * @property {string | number | Date | undefined} [planAt] -
  * @property {string | number | Date | undefined} [completeAt] -
@@ -42,7 +12,7 @@ export type ReleaseConfig = {
 /**
  * Release management class that coordinates task validation and release execution
  */
-declare class Release {
+export default class Release {
     /**
      * Creates a Release instance
      * @param {ReleaseConfig} config - Release configuration
@@ -85,5 +55,39 @@ declare class Release {
      */
     getProgress(): Promise<any>;
 }
-import ReleaseDocument from "./Release/Document.js";
+export type ReleaseConfig = {
+    /**
+     * - Release version
+     */
+    version?: string | undefined;
+    /**
+     * -
+     */
+    createdAt?: string | number | Date | undefined;
+    /**
+     * - Alias for createdAt
+     */
+    date?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    startAt?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    planAt?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    completeAt?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    document?: string | ReleaseDocument | undefined;
+    /**
+     * - Task map with test functions
+     */
+    tasks?: Map<string, Function> | undefined;
+};
+import ReleaseDocument from './Release/Document.js';
 import Logger from '@nan0web/log';

package/types/ReleaseCLI.d.ts

@@ -2,32 +2,33 @@
 /**
  * CLI application for release management
  */
-export default class ReleaseCLI extends Command {
-    static Message: typeof AppCommandMessage;
-    constructor();
-    /** @type {DB?} */
-    db: DB | null;
-    /** @type {FS} */
-    fs: FS;
-    /** @type {Record<string, Release>} */
-    releases: Record<string, Release>;
-    /** @type {Release?} */
-    current: Release | null;
-    /**
-     * @param {string[] | string} argv
-     * @returns {AppCommandMessage}
-     */
-    parse(argv?: string[] | string): AppCommandMessage;
-    /**
-     * Run CLI application
-     * @param {string[]} argv - Command line arguments
-     * @returns {Promise<void>}
-     */
-    run(argv: string[]): Promise<void>;
-    loadReleaseFiles(): Promise<void>;
+export default class ReleaseCLI {
+	static Message: typeof AppCommandMessage
+	/** @type {Logger} */
+	logger: Logger
+	/** @type {DB?} */
+	db: DB | null
+	/** @type {FS} */
+	fs: FS
+	/** @type {Record<string, Release>} */
+	releases: Record<string, Release>
+	/** @type {Release?} */
+	current: Release | null
+	/**
+	 * @param {string[] | string} argv
+	 * @returns {AppCommandMessage}
+	 */
+	parse(argv?: string[] | string): AppCommandMessage
+	/**
+	 * Run CLI application
+	 * @param {string[]} argv - Command line arguments
+	 * @returns {Promise<void>}
+	 */
+	run(argv: string[]): Promise<void>
+	loadReleaseFiles(): Promise<void>
 }
-import { Command } from '@nan0web/co';
-import DB from "./db/ReleaseDB.js";
-import FS from "@nan0web/db-fs";
-import Release from './Release.js';
-import AppCommandMessage from './co/AppCommandMessage.js';
+import Logger from '@nan0web/log'
+import DB from './db/ReleaseDB.js'
+import FS from '@nan0web/db-fs'
+import Release from './Release.js'
+import AppCommandMessage from './co/AppCommandMessage.js'

package/types/Team.d.ts

@@ -22,6 +22,6 @@ declare class Person {
     /** @type {HumanContact[]} */
     contacts: HumanContact[];
 }
-import { HumanName } from "@nan0web/verse";
-import { HumanGender } from "@nan0web/verse";
-import { HumanContact } from "@nan0web/verse";
+import { HumanName } from '@nan0web/verse';
+import { HumanGender } from '@nan0web/verse';
+import { HumanContact } from '@nan0web/verse';

package/types/cli/index.d.ts

@@ -0,0 +1,2 @@
+export default createReleaseCLI;
+import createReleaseCLI from '../ui/cli/ReleaseCLi.js';

package/types/co/AppCommandMessage.d.ts

@@ -1,12 +1,11 @@
-export default class AppCommandMessage extends CommandMessage {
-    /**
-     * @param {*} input
-     * @returns {AppCommandMessage}
-     */
-    static from(input: any): AppCommandMessage;
-    set opts(value: AppCommandOptions);
-    /** @returns {AppCommandOptions} */
-    get opts(): AppCommandOptions;
+export default class AppCommandMessage {
+	/**
+	 * @param {*} input
+	 * @returns {AppCommandMessage}
+	 */
+	static from(input: any): AppCommandMessage
+	set opts(arg: AppCommandOptions)
+	/** @returns {AppCommandOptions} */
+	get opts(): AppCommandOptions
 }
-import { CommandMessage } from "@nan0web/co";
-import AppCommandOptions from "./AppCommandOptions.js";
+import AppCommandOptions from './AppCommandOptions.js'

package/types/co/AppCommandOptions.d.ts

@@ -1,5 +1,4 @@
-export default AppCommandOptions;
-declare class AppCommandOptions {
+export default class AppCommandOptions {
     /**
      * @param {Object} input
      */

package/types/commands/BaseCommand.d.ts

@@ -0,0 +1,23 @@
+/** @typedef {import("@nan0web/test/types/exec/runSpawn").SpawnResult} SpawnResult */
+/**
+ * @extends {Command}
+ */
+export default class BaseCommand {
+	/**
+	 * @param {string} cmd
+	 * @param {string[]} args
+	 * @param {string} errorMsg
+	 * @param {FS} fs
+	 * @param {number[]} [okCodes=[0]]
+	 * @returns {Promise<SpawnResult>}
+	 */
+	_run(
+		cmd: string,
+		args: string[],
+		errorMsg: string,
+		fs: FS,
+		okCodes?: number[] | undefined,
+	): Promise<SpawnResult>
+}
+export type SpawnResult = import('@nan0web/test/types/exec/runSpawn').SpawnResult
+import FS from '@nan0web/db-fs'

package/types/commands/ChatCommand.d.ts

@@ -1,4 +1,4 @@
-export default ChatCommand;
+export default ChatCommand
 /**
  * ChatCommand – writes a message to the release‑wide chat (chat/…/timestamp.username.md)
  *
@@ -9,12 +9,12 @@ export default ChatCommand;
  *   --user <string> – username to embed in the filename (defaults to "anonymous")
  */
 declare class ChatCommand extends SubCommand {
-    /**
-     * Run the chat command.
-     *
-     * @param {AppCommandMessage} ctx – command context (contains args and opts)
-     */
-    run(ctx: AppCommandMessage): Promise<void>;
+	/**
+	 * Run the chat command.
+	 *
+	 * @param {AppCommandMessage} ctx – command context (contains args and opts)
+	 */
+	run(ctx: AppCommandMessage): Promise<void>
 }
-import SubCommand from "./SubCommand.js";
-import AppCommandMessage from "../co/AppCommandMessage.js";
+import SubCommand from './SubCommand.js'
+import AppCommandMessage from '../co/AppCommandMessage.js'

package/types/commands/ChatMessage.d.ts

@@ -0,0 +1,36 @@
+export class ChatBody {
+	static write: {
+		help: string
+		defaultValue: boolean
+		type: string
+	}
+	static user: {
+		help: string
+		defaultValue: string
+		type: string
+	}
+	constructor({
+		write,
+		user,
+		args,
+	}?: {
+		write?: boolean | undefined
+		user?: string | undefined
+		args?: any[] | undefined
+	})
+	/** @type {boolean} */
+	write: boolean
+	/** @type {string} */
+	user: string
+	/** @type {string[]} */
+	args: string[]
+}
+export default class ChatMessage extends Message {
+	constructor(input?: {})
+	/** @type {ChatBody} */
+	body: ChatBody
+	/** @returns {AsyncGenerator<OutputMessage>} */
+	run(): AsyncGenerator<OutputMessage>
+}
+import { Message } from '@nan0web/co'
+import { OutputMessage } from '@nan0web/co'

package/types/commands/CloseCommand.d.ts

@@ -0,0 +1,25 @@
+export default class CloseCommand extends Command {
+    static name: string;
+    static help: string;
+    static Body: typeof CloseBody;
+    /** @param {Partial<Command> & { body?: Partial<CloseBody> }} [input={}] */
+    constructor(input?: Partial<Command> & {
+        body?: Partial<CloseBody>;
+    });
+    body: CloseBody;
+    run(): AsyncGenerator<OutputMessage, void, unknown>;
+}
+import Command from './Command.js';
+declare class CloseBody {
+    static version: {
+        help: string;
+        defaultValue: string;
+    };
+    constructor({ version }?: {
+        version?: string | undefined;
+    });
+    /** @type {string} */
+    version: string;
+}
+import { OutputMessage } from '@nan0web/co';
+export {};

package/types/commands/Command.d.ts

@@ -0,0 +1,28 @@
+/** @typedef {import("@nan0web/test/types/exec/runSpawn").SpawnResult} SpawnResult */
+export default class Command extends UiMessage {
+    /**
+     * @param {Partial<UiMessage> & {  }} [input={}]
+     */
+    constructor(input?: Partial<UiMessage> & {});
+    /** @type {DBFS} */
+    fs: DBFS;
+    /** @type {Logger} */
+    logger: Logger;
+    get Body(): new () => {};
+    /**
+     * Run the command.
+     * @param {string} cmd
+     * @param {string[]} [args=[]]
+     * @param {string} [fail=""]
+     * @returns {Promise<SpawnResult>}
+     * @throws {Error}
+     */
+    _run(cmd: string, args?: string[], fail?: string): Promise<SpawnResult>;
+    /** @returns {AsyncGenerator<OutputMessage>} */
+    run(): AsyncGenerator<OutputMessage>;
+}
+export type SpawnResult = import("@nan0web/test/types/exec/runSpawn").SpawnResult;
+import { UiMessage } from '@nan0web/ui';
+import DBFS from '@nan0web/db-fs';
+import Logger from '@nan0web/log';
+import { OutputMessage } from '@nan0web/co';

package/types/commands/DepsCommand.d.ts

@@ -0,0 +1,32 @@
+export default class DepsCommand extends Command {
+    static name: string;
+    static help: string;
+    static Body: typeof DepsBody;
+    /** @param {Partial<DepsBody>} [input={}] */
+    constructor(input?: Partial<DepsBody>);
+    /** @type {DepsBody} */
+    body: DepsBody;
+    /**
+     * @param {DepsCommand} [msg]
+     * @returns {AsyncGenerator<OutputMessage>}
+     */
+    run(msg?: DepsCommand): AsyncGenerator<OutputMessage>;
+}
+import Command from './Command.js';
+declare class DepsBody {
+    static fix: {
+        help: string;
+        defaultValue: boolean;
+    };
+    static latest: {
+        help: string;
+        defaultValue: boolean;
+    };
+    constructor(input?: {});
+    /** @type {boolean} */
+    fix: boolean;
+    /** @type {boolean} */
+    latest: boolean;
+}
+import { OutputMessage } from '@nan0web/co';
+export {};

package/types/commands/DepsMessage.d.ts

@@ -0,0 +1,28 @@
+/** @typedef {import("@nan0web/co").MessageInput} MessageInput */
+export class DepsBody {
+	static fix: {
+		help: string
+		defaultValue: boolean
+	}
+	constructor(input?: {})
+	/** @type {boolean} */
+	fix: boolean
+}
+export default class DepsMessage extends Message {
+	static Body: typeof DepsBody
+	/** @param {MessageInput & { body?: Partial<DepsBody> }} [input={}] */
+	constructor(
+		input?:
+			| (import('@nan0web/co/types/Message').MessageInput & {
+					body?: Partial<DepsBody> | undefined
+			  })
+			| undefined,
+	)
+	/** @type {DepsBody} */
+	body: DepsBody
+	/** @returns {AsyncGenerator<OutputMessage>} */
+	run(): AsyncGenerator<OutputMessage>
+}
+export type MessageInput = import('@nan0web/co').MessageInput
+import { Message } from '@nan0web/co'
+import { OutputMessage } from '@nan0web/co'

package/types/commands/HostCommand.d.ts

@@ -6,11 +6,11 @@
  *   release host [--port <number>] [--webui]
  */
 export default class HostCommand extends SubCommand {
-    /**
-     * Run the host server.
-     *
-     * @param {Object} ctx – command context
-     */
-    run(ctx: any): Promise<void>;
+	/**
+	 * Run the host server.
+	 *
+	 * @param {Object} ctx – command context
+	 */
+	run(ctx: any): Promise<void>
 }
-import SubCommand from "./SubCommand.js";
+import SubCommand from './SubCommand.js'

package/types/commands/HostMessage.d.ts

@@ -0,0 +1,44 @@
+export default class HostMessage extends Message {
+	static Body: {
+		new ({ port, webui }?: { port?: number | undefined; webui?: boolean | undefined }): {
+			/** @type {number} */
+			port: number
+			/** @type {boolean} */
+			webui: boolean
+		}
+		port: {
+			help: string
+			defaultValue: number
+			type: string
+		}
+		webui: {
+			help: string
+			defaultValue: boolean
+			type: string
+		}
+	}
+	constructor(input?: {})
+	/** @type {HostMessage.Body} */
+	body: {
+		new ({ port, webui }?: { port?: number | undefined; webui?: boolean | undefined }): {
+			/** @type {number} */
+			port: number
+			/** @type {boolean} */
+			webui: boolean
+		}
+		port: {
+			help: string
+			defaultValue: number
+			type: string
+		}
+		webui: {
+			help: string
+			defaultValue: boolean
+			type: string
+		}
+	}
+	/** @returns {AsyncGenerator<OutputMessage>} */
+	run(): AsyncGenerator<OutputMessage>
+}
+import { Message } from '@nan0web/co'
+import { OutputMessage } from '@nan0web/co'

package/types/commands/InitCommand.d.ts

@@ -1,20 +1,25 @@
-export default InitCommand;
-/**
- * InitCommand – scaffolds a new release directory with the minimal set of
- * files required for a functional release (release.js, release.md and a
- * placeholder task folder).  The command is deliberately tiny – it only
- * creates the filesystem layout and writes a tiny starter release object.
- *
- * Usage:
- *   release init v1.0.0
- */
-declare class InitCommand extends SubCommand {
-    /**
-     * Run the init process.
-     *
-     * @param {AppCommandMessage} msg – command context (contains parsed options)
-     */
-    run(msg: AppCommandMessage): Promise<void>;
+export default class InitCommand extends Command {
+    static name: string;
+    static help: string;
+    static Body: typeof InitBody;
+    /** @param {Partial<Command> & { body?: Partial<InitBody> }} [input={}] */
+    constructor(input?: Partial<Command> & {
+        body?: Partial<InitBody>;
+    });
+    body: InitBody;
+    run(): AsyncGenerator<OutputMessage, void, unknown>;
 }
-import SubCommand from "./SubCommand.js";
-import AppCommandMessage from "../co/AppCommandMessage.js";
+import Command from './Command.js';
+declare class InitBody {
+    static version: {
+        help: string;
+        defaultValue: string;
+    };
+    constructor({ version }?: {
+        version?: string | undefined;
+    });
+    /** @type {string} */
+    version: string;
+}
+import { OutputMessage } from '@nan0web/co';
+export {};

package/types/commands/InitMessage.d.ts

@@ -0,0 +1,24 @@
+export class InitBody {
+	static version: {
+		help: string
+		required: boolean
+		placeholder: string
+	}
+	constructor({ version }?: { version?: string | undefined })
+	/** @type {string} */
+	version: string
+}
+export default class InitMessage extends Message {
+	static Body: typeof InitBody
+	constructor(input?: {})
+	/** @type {InitBody} */
+	body: InitBody
+	/**
+	 * Core implementation – mirrors the legacy `InitCommand`.
+	 *
+	 * @returns {AsyncGenerator<OutputMessage>}
+	 */
+	run(): AsyncGenerator<OutputMessage>
+}
+import { Message } from '@nan0web/co'
+import { OutputMessage } from '@nan0web/co'

package/types/commands/ListCommand.d.ts

@@ -10,12 +10,12 @@
  *   --json – output JSON instead of a human‑readable list
  */
 export default class ListCommand extends SubCommand {
-    /**
-     * Execute the command.
-     *
-     * @param {Object} ctx – command context (contains parsed args)
-     * @returns {Promise<void>}
-     */
-    run(ctx: any): Promise<void>;
+	/**
+	 * Execute the command.
+	 *
+	 * @param {Object} ctx – command context (contains parsed args)
+	 * @returns {Promise<void>}
+	 */
+	run(ctx: any): Promise<void>
 }
-import SubCommand from "./SubCommand.js";
+import SubCommand from './SubCommand.js'

package/types/commands/ListMessage.d.ts

@@ -0,0 +1,30 @@
+export default class ListMessage extends Message {
+	static Body: {
+		new ({ json }?: { json?: boolean | undefined }): {
+			/** @type {boolean} */
+			json: boolean
+		}
+		json: {
+			help: string
+			defaultValue: boolean
+			type: string
+		}
+	}
+	constructor(input?: {})
+	/** @type {ListMessage.Body} */
+	body: {
+		new ({ json }?: { json?: boolean | undefined }): {
+			/** @type {boolean} */
+			json: boolean
+		}
+		json: {
+			help: string
+			defaultValue: boolean
+			type: string
+		}
+	}
+	/** @returns {AsyncGenerator<OutputMessage>} */
+	run(): AsyncGenerator<OutputMessage>
+}
+import { Message } from '@nan0web/co'
+import { OutputMessage } from '@nan0web/co'