icore 1.0.13 → 1.0.14

package/CHANGELOG.md

@@ -1,12 +1,15 @@
 # Changelog
 
-All notable user-facing changes to this package are documented here.
+All notable changes to this project will be documented in this file.
 
-This file was reconstructed from npm publish metadata and local git history.
-Older releases did not have a maintained changelog, so early entries are
-intentionally conservative.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## 1.0.13 - Unreleased
+Historical entries before this file was introduced were reconstructed from npm
+publish metadata and local git history. Older entries are intentionally
+conservative.
+
+## [Unreleased]
 
 ### Added
 
@@ -14,22 +17,33 @@ intentionally conservative.
 - Added opt-in `strict: true` command resolution for rejecting options before command paths.
 - Added `strict: true` support to direct `runCommand` execution.
 - Added typed prepared command `payload` returned from `prepare` and passed to `handle`.
+- Added public `CommandPayload`, `CommandContext`, and `CommandResult` helper types.
 - Added this changelog.
 
 ### Changed
 
-- Boolean options reject explicit values such as `--flag=true` and `--flag=false`; use `--flag` and `--no-flag`.
+- Changed `PreparedCommand` typing to preserve payload correlation when narrowing registry unions by command name.
+
+### Removed
+
+- Removed explicit boolean values such as `--flag=true` and `--flag=false`; use `--flag` and `--no-flag`.
+
+## [1.0.12] - 2026-07-02
 
-## 1.0.12 - 2026-07-02
+### Changed
 
 - Replaced the preliminary flag-only boolean option naming with `syntax: 'flag'`.
 - Documented flag-only boolean option behavior.
 
-## 1.0.11 - 2026-07-02
+## [1.0.11] - 2026-07-02
+
+### Added
 
 - Added preliminary flag-only boolean option support.
 
-## 1.0.10 - 2026-07-02
+## [1.0.10] - 2026-07-02
+
+### Added
 
 - Added two-phase command execution.
 - Added `PreparedCommandInput`.
@@ -38,26 +52,37 @@ intentionally conservative.
 - Added `runPreparedCommand`.
 - Added command `metadata`.
 - Added command `prepare` hook.
-- Changed `runCommand` and `runCommandFromRegistry` to use the prepare-and-run flow internally.
 - Added focused tests for prepare-time validation and handler safety.
 
-## 1.0.9 - 2026-07-02
+### Changed
+
+- Changed `runCommand` and `runCommandFromRegistry` to use the prepare-and-run flow internally.
+
+## [1.0.9] - 2026-07-02
+
+### Changed
 
 - Refined npm package metadata.
 - Updated repository metadata for npm.
 - Simplified published package contents.
 
-## 1.0.8 - 2026-07-02
+## [1.0.8] - 2026-07-02
+
+### Changed
 
 - Updated package author metadata.
 - Normalized README heading structure.
 
-## 1.0.7 - 2026-07-02
+## [1.0.7] - 2026-07-02
+
+### Changed
 
 - Renamed README examples from `upper` to `uppercase`.
 - Cleaned duplicated command test coverage without changing public behavior.
 
-## 1.0.6 - 2026-07-02
+## [1.0.6] - 2026-07-02
+
+### Added
 
 - Added explicit long boolean values such as `--flag=true` and `--flag=false`.
 - Added schema-known boolean negation such as `--no-flag`.
@@ -65,32 +90,53 @@ intentionally conservative.
 - Added alias validation and duplicate detection between short and long option forms.
 - Documented supported option syntax.
 
-## 1.0.5 - 2026-07-01
+## [1.0.5] - 2026-07-01
+
+### Changed
 
 - Rebuilt README as the main public documentation entry point.
+
+### Removed
+
 - Removed separate generated reference docs from the published documentation flow.
 
-## 1.0.4 - 2026-07-01
+## [1.0.4] - 2026-07-01
+
+### Changed
 
 - Reorganized README and documentation references.
 
-## 1.0.3 - 2026-07-01
+## [1.0.3] - 2026-07-01
+
+### Added
 
 - Added README table of contents.
+
+### Changed
+
 - Polished README formatting and emphasis.
 
-## 1.0.2 - 2026-06-30
+## [1.0.2] - 2026-06-30
+
+### Added
 
-- Clarified CLI scope and supported syntax in README.
 - Added module boundary comments to production source files.
+
+### Changed
+
+- Clarified CLI scope and supported syntax in README.
 - Updated package description and keywords.
 
-## 1.0.1 - 2026-06-30
+## [1.0.1] - 2026-06-30
+
+### Changed
 
 - Published documentation updates after the first stable release.
 - No dedicated version commit is present in local git history for this patch.
 
-## 1.0.0 - 2026-06-30
+## [1.0.0] - 2026-06-30
+
+### Added
 
 - First stable release of the new `icore` CLI mechanics package.
 - Added declarative option parsing and validation.
@@ -100,22 +146,58 @@ intentionally conservative.
 - Added command registry routing.
 - Added typed command handler input.
 - Added CommonJS package entry points and TypeScript declarations.
+
+### Changed
+
 - Lowered the runtime Node.js engine to `>=16.9.0`.
 
-## 1.0.0-alpha - 2026-06-28
+## [1.0.0-alpha] - 2026-06-28
+
+### Added
 
 - Started the new CLI mechanics codebase after pruning the legacy package code.
 - Added the initial TypeScript build, test, and lint setup for the new package.
 
-## 0.1.38 - 2019-06-12
+## [0.1.38] - 2019-06-12
+
+### Added
 
-- Final legacy web-framework line release.
 - Added legacy tests and documentation.
+
+### Changed
+
+- Final legacy web-framework line release.
 - Updated the legacy package description.
+
+### Removed
+
 - Trimmed legacy runtime dependencies.
 
-## 0.0.37 and earlier
+## [0.0.37 and earlier]
+
+### Added
 
 - Original legacy npm package line published between 2017 and 2019.
 - Legacy history is preserved for package provenance.
+
+### Changed
+
 - Detailed changelog entries were not maintained for these releases.
+
+[Unreleased]: https://github.com/woodger/icore/commits/develop
+[1.0.12]: https://www.npmjs.com/package/icore/v/1.0.12
+[1.0.11]: https://www.npmjs.com/package/icore/v/1.0.11
+[1.0.10]: https://www.npmjs.com/package/icore/v/1.0.10
+[1.0.9]: https://www.npmjs.com/package/icore/v/1.0.9
+[1.0.8]: https://www.npmjs.com/package/icore/v/1.0.8
+[1.0.7]: https://www.npmjs.com/package/icore/v/1.0.7
+[1.0.6]: https://www.npmjs.com/package/icore/v/1.0.6
+[1.0.5]: https://www.npmjs.com/package/icore/v/1.0.5
+[1.0.4]: https://www.npmjs.com/package/icore/v/1.0.4
+[1.0.3]: https://www.npmjs.com/package/icore/v/1.0.3
+[1.0.2]: https://www.npmjs.com/package/icore/v/1.0.2
+[1.0.1]: https://www.npmjs.com/package/icore/v/1.0.1
+[1.0.0]: https://www.npmjs.com/package/icore/v/1.0.0
+[1.0.0-alpha]: https://www.npmjs.com/package/icore/v/1.0.0-alpha
+[0.1.38]: https://www.npmjs.com/package/icore/v/0.1.38
+[0.0.37 and earlier]: https://www.npmjs.com/package/icore?activeTab=versions

package/dist/cli.d.ts

@@ -9,6 +9,6 @@
  * This file must not contain parser, validator, or command runtime logic.
  */
 export { parseArgv, type ParsedArgv } from './argv';
-export { defineCommand, defineCommandRegistry, isCommandName, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type CommandDefinition, type CommandInput, type CommandName, type CommandRegistry, type CommandResolutionOptions, type PreparedCommand, type PreparedCommandInput, type ResolvedCommand } from './commands';
+export { defineCommand, defineCommandRegistry, isCommandName, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type CommandDefinition, type CommandContext, type CommandInput, type CommandName, type CommandPayload, type CommandRegistry, type CommandResolutionOptions, type CommandResult, type PreparedCommand, type PreparedCommandInput, type ResolvedCommand } from './commands';
 export { IcoreError, type IcoreErrorCode, type IcoreErrorDetails } from './errors';
 export { mergeOptionsSchema, parseOptions, parseOptionsDetailed, type BooleanOption, type InferOptions, type InferProvidedOptions, type MergeOptionsSchemas, type NumberOption, type OptionDefinition, type OptionsSchema, type ParseOptionsResult, type RawOptionValue, type StringOption } from './options';

package/dist/commands.d.ts

@@ -78,10 +78,10 @@ type CommandDefinitionParts<TCommand extends AnyCommandDefinition> = TCommand ex
     metadata: TCommand['metadata'];
     payload: unknown;
 };
-type CommandContext<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['context'];
-type CommandResult<TCommand extends AnyCommandDefinition> = Awaited<CommandDefinitionParts<TCommand>['result']>;
+export type CommandContext<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['context'];
+export type CommandResult<TCommand extends AnyCommandDefinition> = Awaited<CommandDefinitionParts<TCommand>['result']>;
 type CommandSchema<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['schema'];
-type CommandPayload<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['payload'];
+export type CommandPayload<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['payload'];
 /**
  * Infers the public command name from a command path.
  */
@@ -116,7 +116,7 @@ export type ResolvedCommand<TCommand extends AnyCommandDefinition> = {
 /**
  * Command resolved and validated without runtime context.
  */
-export type PreparedCommand<TCommand extends AnyCommandDefinition> = {
+export type PreparedCommand<TCommand extends AnyCommandDefinition> = TCommand extends AnyCommandDefinition ? {
     name: CommandName<TCommand>;
     path: TCommand['path'];
     command: TCommand;
@@ -124,7 +124,7 @@ export type PreparedCommand<TCommand extends AnyCommandDefinition> = {
     provided: InferProvidedOptions<CommandSchema<TCommand>>;
     positionals: string[];
     payload: CommandPayload<TCommand>;
-};
+} : never;
 /**
  * Defines a command while preserving literal option schema types.
  */

package/dist/index.d.ts

@@ -1 +1 @@
-export { defineCommand, defineCommandRegistry, IcoreError, isCommandName, mergeOptionsSchema, parseArgv, parseOptions, parseOptionsDetailed, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type BooleanOption, type CommandDefinition, type CommandInput, type CommandName, type CommandRegistry, type CommandResolutionOptions, type InferOptions, type InferProvidedOptions, type IcoreErrorCode, type IcoreErrorDetails, type MergeOptionsSchemas, type NumberOption, type OptionDefinition, type OptionsSchema, type ParseOptionsResult, type ParsedArgv, type PreparedCommand, type PreparedCommandInput, type RawOptionValue, type ResolvedCommand, type StringOption } from './cli';
+export { defineCommand, defineCommandRegistry, IcoreError, isCommandName, mergeOptionsSchema, parseArgv, parseOptions, parseOptionsDetailed, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type BooleanOption, type CommandDefinition, type CommandContext, type CommandInput, type CommandName, type CommandPayload, type CommandRegistry, type CommandResolutionOptions, type CommandResult, type InferOptions, type InferProvidedOptions, type IcoreErrorCode, type IcoreErrorDetails, type MergeOptionsSchemas, type NumberOption, type OptionDefinition, type OptionsSchema, type ParseOptionsResult, type ParsedArgv, type PreparedCommand, type PreparedCommandInput, type RawOptionValue, type ResolvedCommand, type StringOption } from './cli';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icore",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Declarative command line interface mechanics for Node.js",
   "keywords": [
     "command-line",