@git.zone/cli 2.13.15 → 2.14.1

package/dist_ts/mod_standard/index.d.ts

@@ -1 +1,3 @@
-export declare let run: () => Promise<void>;
+import type { ICliMode } from "../helpers.climode.js";
+export declare let run: (argvArg?: any) => Promise<void>;
+export declare function showHelp(mode: ICliMode, commandName?: string): Promise<void>;

package/dist_ts/mod_standard/index.js

@@ -1,86 +1,186 @@
 /* -----------------------------------------------
  * executes as standard  task
  * ----------------------------------------------- */
-import * as plugins from './mod.plugins.js';
-import * as paths from '../paths.js';
-import { logger } from '../gitzone.logging.js';
-export let run = async () => {
-    console.log('');
-    console.log('╭─────────────────────────────────────────────────────────────╮');
-    console.log('│  gitzone - Development Workflow CLI                         │');
-    console.log('╰─────────────────────────────────────────────────────────────╯');
-    console.log('');
+import * as plugins from "./mod.plugins.js";
+import * as paths from "../paths.js";
+import { getCliMode, printJson } from "../helpers.climode.js";
+import { logger } from "../gitzone.logging.js";
+const commandSummaries = [
+    {
+        name: "commit",
+        description: "Create semantic commits or generate read-only commit recommendations",
+    },
+    { name: "format", description: "Plan or apply project formatting changes" },
+    { name: "config", description: "Read and change .smartconfig.json settings" },
+    { name: "services", description: "Manage or configure development services" },
+    { name: "template", description: "Create a project from a template" },
+    { name: "open", description: "Open project assets and CI pages" },
+    { name: "docker", description: "Run Docker-related maintenance tasks" },
+    {
+        name: "deprecate",
+        description: "Deprecate npm packages across registries",
+    },
+    { name: "meta", description: "Run meta-repository commands" },
+    { name: "start", description: "Prepare a project for local work" },
+    { name: "helpers", description: "Run helper utilities" },
+];
+export let run = async (argvArg = {}) => {
+    const mode = await getCliMode(argvArg);
+    const requestedCommandHelp = argvArg._?.[0] === "help" ? argvArg._?.[1] : undefined;
+    if (mode.help || requestedCommandHelp) {
+        await showHelp(mode, requestedCommandHelp);
+        return;
+    }
+    if (!mode.interactive) {
+        await showHelp(mode);
+        return;
+    }
+    console.log("");
+    console.log("╭─────────────────────────────────────────────────────────────╮");
+    console.log("│  gitzone - Development Workflow CLI                         │");
+    console.log("╰─────────────────────────────────────────────────────────────╯");
+    console.log("");
     const interactInstance = new plugins.smartinteract.SmartInteract();
     const response = await interactInstance.askQuestion({
-        type: 'list',
-        name: 'action',
-        message: 'What would you like to do?',
-        default: 'commit',
+        type: "list",
+        name: "action",
+        message: "What would you like to do?",
+        default: "commit",
         choices: [
-            { name: 'Commit changes (semantic versioning)', value: 'commit' },
-            { name: 'Format project files', value: 'format' },
-            { name: 'Configure release settings', value: 'config' },
-            { name: 'Create from template', value: 'template' },
-            { name: 'Manage dev services (MongoDB, S3)', value: 'services' },
-            { name: 'Open project assets', value: 'open' },
-            { name: 'Show help', value: 'help' },
+            { name: "Commit changes (semantic versioning)", value: "commit" },
+            { name: "Format project files", value: "format" },
+            { name: "Configure release settings", value: "config" },
+            { name: "Create from template", value: "template" },
+            { name: "Manage dev services (MongoDB, S3)", value: "services" },
+            { name: "Open project assets", value: "open" },
+            { name: "Show help", value: "help" },
         ],
     });
     const action = response.value;
     switch (action) {
-        case 'commit': {
-            const modCommit = await import('../mod_commit/index.js');
-            await modCommit.run({ _: ['commit'] });
+        case "commit": {
+            const modCommit = await import("../mod_commit/index.js");
+            await modCommit.run({ _: ["commit"] });
             break;
         }
-        case 'format': {
-            const modFormat = await import('../mod_format/index.js');
+        case "format": {
+            const modFormat = await import("../mod_format/index.js");
             await modFormat.run({ interactive: true });
             break;
         }
-        case 'config': {
-            const modConfig = await import('../mod_config/index.js');
-            await modConfig.run({ _: ['config'] });
+        case "config": {
+            const modConfig = await import("../mod_config/index.js");
+            await modConfig.run({ _: ["config"] });
             break;
         }
-        case 'template': {
-            const modTemplate = await import('../mod_template/index.js');
-            await modTemplate.run({ _: ['template'] });
+        case "template": {
+            const modTemplate = await import("../mod_template/index.js");
+            await modTemplate.run({ _: ["template"] });
             break;
         }
-        case 'services': {
-            const modServices = await import('../mod_services/index.js');
-            await modServices.run({ _: ['services'] });
+        case "services": {
+            const modServices = await import("../mod_services/index.js");
+            await modServices.run({ _: ["services"] });
             break;
         }
-        case 'open': {
-            const modOpen = await import('../mod_open/index.js');
-            await modOpen.run({ _: ['open'] });
+        case "open": {
+            const modOpen = await import("../mod_open/index.js");
+            await modOpen.run({ _: ["open"] });
             break;
         }
-        case 'help':
-            showHelp();
+        case "help":
+            await showHelp(mode);
             break;
     }
 };
-function showHelp() {
-    console.log('');
-    console.log('Usage: gitzone <command> [options]');
-    console.log('');
-    console.log('Commands:');
-    console.log('  commit      Create a semantic commit with versioning');
-    console.log('  format      Format and standardize project files');
-    console.log('  config      Manage release registry configuration');
-    console.log('  template    Create a new project from template');
-    console.log('  services    Manage dev services (MongoDB, S3/MinIO)');
-    console.log('  open        Open project assets (GitLab, npm, etc.)');
-    console.log('  docker      Docker-related operations');
-    console.log('  deprecate   Deprecate a package on npm');
-    console.log('  meta        Run meta commands');
-    console.log('  start       Start working on a project');
-    console.log('  helpers     Run helper utilities');
-    console.log('');
-    console.log('Run gitzone <command> --help for more information on a command.');
-    console.log('');
+export async function showHelp(mode, commandName) {
+    if (commandName) {
+        const handled = await showCommandHelp(commandName, mode);
+        if (handled) {
+            return;
+        }
+    }
+    if (mode.json) {
+        printJson({
+            name: "gitzone",
+            usage: "gitzone <command> [options]",
+            commands: commandSummaries,
+            globalFlags: [
+                { flag: "--help, -h", description: "Show help output" },
+                {
+                    flag: "--json",
+                    description: "Emit machine-readable JSON when supported",
+                },
+                {
+                    flag: "--plain",
+                    description: "Use plain text output when supported",
+                },
+                {
+                    flag: "--agent",
+                    description: "Prefer non-interactive machine-friendly output",
+                },
+                {
+                    flag: "--no-interactive",
+                    description: "Disable prompts and interactive menus",
+                },
+                {
+                    flag: "--no-check-updates",
+                    description: "Skip the update check banner",
+                },
+            ],
+        });
+        return;
+    }
+    console.log("");
+    console.log("Usage: gitzone <command> [options]");
+    console.log("");
+    console.log("Commands:");
+    for (const commandSummary of commandSummaries) {
+        console.log(`  ${commandSummary.name.padEnd(11)} ${commandSummary.description}`);
+    }
+    console.log("");
+    console.log("Global flags:");
+    console.log("  --help, -h            Show help output");
+    console.log("  --json                Emit machine-readable JSON when supported");
+    console.log("  --plain               Use plain text output when supported");
+    console.log("  --agent               Prefer non-interactive machine-friendly output");
+    console.log("  --no-interactive      Disable prompts and interactive menus");
+    console.log("  --no-check-updates    Skip the update check banner");
+    console.log("");
+    console.log("Examples:");
+    console.log("  gitzone help commit");
+    console.log("  gitzone config show --json");
+    console.log("  gitzone commit recommend --json");
+    console.log("  gitzone format plan --json");
+    console.log("  gitzone services set mongodb,minio");
+    console.log("");
+    console.log("Run gitzone <command> --help for command-specific usage.");
+    console.log("");
+}
+async function showCommandHelp(commandName, mode) {
+    switch (commandName) {
+        case "commit": {
+            const modCommit = await import("../mod_commit/index.js");
+            modCommit.showHelp(mode);
+            return true;
+        }
+        case "config": {
+            const modConfig = await import("../mod_config/index.js");
+            modConfig.showHelp(mode);
+            return true;
+        }
+        case "format": {
+            const modFormat = await import("../mod_format/index.js");
+            modFormat.showHelp(mode);
+            return true;
+        }
+        case "services": {
+            const modServices = await import("../mod_services/index.js");
+            modServices.showHelp(mode);
+            return true;
+        }
+        default:
+            return false;
+    }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9tb2Rfc3RhbmRhcmQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O3FEQUVxRDtBQUNyRCxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sS0FBSyxLQUFLLE1BQU0sYUFBYSxDQUFDO0FBRXJDLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUUvQyxNQUFNLENBQUMsSUFBSSxHQUFHLEdBQUcsS0FBSyxJQUFJLEVBQUU7SUFDMUIsT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNoQixPQUFPLENBQUMsR0FBRyxDQUFDLGlFQUFpRSxDQUFDLENBQUM7SUFDL0UsT0FBTyxDQUFDLEdBQUcsQ0FBQyxpRUFBaUUsQ0FBQyxDQUFDO0lBQy9FLE9BQU8sQ0FBQyxHQUFHLENBQUMsaUVBQWlFLENBQUMsQ0FBQztJQUMvRSxPQUFPLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBRWhCLE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxPQUFPLENBQUMsYUFBYSxDQUFDLGFBQWEsRUFBRSxDQUFDO0lBQ25FLE1BQU0sUUFBUSxHQUFHLE1BQU0sZ0JBQWdCLENBQUMsV0FBVyxDQUFDO1FBQ2xELElBQUksRUFBRSxNQUFNO1FBQ1osSUFBSSxFQUFFLFFBQVE7UUFDZCxPQUFPLEVBQUUsNEJBQTRCO1FBQ3JDLE9BQU8sRUFBRSxRQUFRO1FBQ2pCLE9BQU8sRUFBRTtZQUNQLEVBQUUsSUFBSSxFQUFFLHNDQUFzQyxFQUFFLEtBQUssRUFBRSxRQUFRLEVBQUU7WUFDakUsRUFBRSxJQUFJLEVBQUUsc0JBQXNCLEVBQUUsS0FBSyxFQUFFLFFBQVEsRUFBRTtZQUNqRCxFQUFFLElBQUksRUFBRSw0QkFBNEIsRUFBRSxLQUFLLEVBQUUsUUFBUSxFQUFFO1lBQ3ZELEVBQUUsSUFBSSxFQUFFLHNCQUFzQixF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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9tb2Rfc3RhbmRhcmQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O3FEQUVxRDtBQUNyRCxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sS0FBSyxLQUFLLE1BQU0sYUFBYSxDQUFDO0FBRXJDLE9BQU8sRUFBRSxVQUFVLEVBQUUsU0FBUyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFOUQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBTy9DLE1BQU0sZ0JBQWdCLEdBQTBCO0lBQzlDO1FBQ0UsSUFBSSxFQUFFLFFBQVE7UUFDZCxXQUFXLEVBQ1Qsc0VBQXNFO0tBQ3pFO0lBQ0QsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSwwQ0FBMEMsRUFBRTtJQUMzRSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsV0FBVyxFQUFFLDRDQUE0QyxFQUFFO0lBQzdFLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxXQUFXLEVBQUUsMENBQTBDLEVBQUU7SUFDN0UsRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxrQ0FBa0MsRUFBRTtJQUNyRSxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsV0FBVyxFQUFFLGtDQUFrQyxFQUFFO0lBQ2pFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxXQUFXLEVBQUUsc0NBQXNDLEVBQUU7SUFDdkU7UUFDRSxJQUFJLEVBQUUsV0FBVztRQUNqQixXQUFXLEVBQUUsMENBQTBDO0tBQ3hEO0lBQ0QsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLFdBQVcsRUFBRSw4QkFBOEIsRUFBRTtJQUM3RCxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsV0FBVyxFQUFFLGtDQUFrQyxFQUFFO0lBQ2xFLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxXQUFXLEVBQUUsc0JBQXNC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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@git.zone/cli",
   "private": false,
-  "version": "2.13.15",
+  "version": "2.14.1",
   "description": "A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.",
   "main": "dist_ts/index.ts",
   "typings": "dist_ts/index.d.ts",

package/readme.hints.md

@@ -23,10 +23,10 @@ Gitzone CLI (`@git.zone/cli`) is a comprehensive toolbelt for streamlining local
 
 ### Configuration Management
 
-- Uses `npmextra.json` for all tool configuration
-- Configuration stored under `gitzone` key in npmextra
-- No separate `.gitzonerc` file - everything in npmextra.json
-- Project type and module metadata also stored in npmextra
+- Uses `.smartconfig.json` for tool configuration
+- CLI settings live under the `@git.zone/cli` namespace
+- Agent and non-interactive defaults now belong under `@git.zone/cli.cli`
+- Project type, module metadata, release settings, commit defaults, and format settings live in the same file
 
 ### Format Module (`mod_format`) - SIGNIFICANTLY ENHANCED
 
@@ -84,7 +84,7 @@ The format module is responsible for project standardization:
 
 1. **Plan → Action Workflow**: Shows changes before applying them
 2. **Rollback Mechanism**: Full backup and restore on failures
-3. **Enhanced Configuration**: Granular control via npmextra.json
+3. **Enhanced Configuration**: Granular control via `.smartconfig.json`
 4. **Better Error Handling**: Detailed errors with recovery options
 5. **Performance Optimizations**: Parallel execution and caching
 6. **Reporting**: Diff views, statistics, verbose logging
@@ -132,7 +132,7 @@ The commit module now supports `-y/--yes` flag for non-interactive commits:
 ## Development Tips
 
 - Always check readme.plan.md for ongoing improvement plans
-- Use npmextra.json for any new configuration options
+- Use `.smartconfig.json` for any new configuration options
 - Keep modules focused and single-purpose
 - Maintain the existing plugin pattern for dependencies
 - Test format operations on sample projects before deploying
@@ -144,30 +144,18 @@ The commit module now supports `-y/--yes` flag for non-interactive commits:
 
 ```json
 {
-  "gitzone": {
+  "@git.zone/cli": {
+    "cli": {
+      "interactive": true,
+      "output": "human",
+      "checkUpdates": true
+    },
     "format": {
       "interactive": true,
-      "parallel": true,
       "showStats": true,
-      "cache": {
-        "enabled": true,
-        "clean": true
-      },
-      "rollback": {
-        "enabled": true,
-        "autoRollbackOnError": true,
-        "backupRetentionDays": 7
-      },
       "modules": {
         "skip": ["prettier"],
-        "only": [],
-        "order": []
-      },
-      "licenses": {
-        "allowed": ["MIT", "Apache-2.0"],
-        "exceptions": {
-          "some-package": "GPL-3.0"
-        }
+        "only": []
       }
     }
   }
@@ -182,6 +170,9 @@ The commit module now supports `-y/--yes` flag for non-interactive commits:
 # Interactive commit (default)
 gitzone commit
 
+# Read-only recommendation
+gitzone commit recommend --json
+
 # Auto-accept AI recommendations (no prompts)
 gitzone commit -y
 gitzone commit --yes
@@ -201,11 +192,14 @@ gitzone commit --format
 # Basic format
 gitzone format
 
+# Read-only JSON plan
+gitzone format plan --json
+
 # Dry run to preview changes
 gitzone format --dry-run
 
-# Non-interactive mode
-gitzone format --yes
+# Non-interactive apply
+gitzone format --write --yes
 
 # Plan only (no execution)
 gitzone format --plan-only
@@ -222,11 +216,10 @@ gitzone format --verbose
 # Detailed diff views
 gitzone format --detailed
 
-# Rollback operations
-gitzone format --rollback
-gitzone format --rollback <operation-id>
-gitzone format --list-backups
-gitzone format --clean-backups
+# Inspect config for agents and scripts
+gitzone config show --json
+gitzone config set cli.output json
+gitzone config get release.accessLevel
 ```
 
 ## Common Issues (Now Resolved)

package/readme.md

@@ -56,6 +56,9 @@ Create standardized commits with AI-powered suggestions that automatically handl
 # Interactive commit with AI recommendations
 gitzone commit
 
+# Read-only recommendation for agents and scripts
+gitzone commit recommend --json
+
 # Auto-accept AI recommendations (skipped for BREAKING CHANGEs)
 gitzone commit -y
 
@@ -65,14 +68,15 @@ gitzone commit -ypbr
 
 **Flags:**
 
-| Flag | Long Form | Description |
-|------|-----------|-------------|
-| `-y` | `--yes` | Auto-accept AI recommendations |
-| `-p` | `--push` | Push to remote after commit |
-| `-t` | `--test` | Run tests before committing |
-| `-b` | `--build` | Build after commit, verify clean tree |
-| `-r` | `--release` | Publish to configured npm registries |
-| | `--format` | Run format before committing |
+| Flag | Long Form   | Description                              |
+| ---- | ----------- | ---------------------------------------- |
+| `-y` | `--yes`     | Auto-accept AI recommendations           |
+| `-p` | `--push`    | Push to remote after commit              |
+| `-t` | `--test`    | Run tests before committing              |
+| `-b` | `--build`   | Build after commit, verify clean tree    |
+| `-r` | `--release` | Publish to configured npm registries     |
+|      | `--format`  | Run format before committing             |
+|      | `--json`    | Emit JSON for `gitzone commit recommend` |
 
 **Workflow steps:**
 
@@ -94,6 +98,9 @@ Automatically format and standardize your entire codebase. **Dry-run by default*
 # Preview what would change (default behavior)
 gitzone format
 
+# Emit a machine-readable plan
+gitzone format plan --json
+
 # Apply changes
 gitzone format --write
 
@@ -109,22 +116,22 @@ gitzone format --verbose
 
 **Flags:**
 
-| Flag | Description |
-|------|-------------|
-| `--write` / `-w` | Apply changes (default is dry-run) |
-| `--yes` | Auto-approve without interactive confirmation |
-| `--plan-only` | Only show what would be done |
-| `--save-plan <file>` | Save the format plan to a file |
-| `--from-plan <file>` | Load and execute a saved plan |
-| `--detailed` | Show detailed stats and save report |
-| `--parallel` / `--no-parallel` | Toggle parallel execution |
-| `--verbose` | Enable verbose logging |
-| `--diff` | Show file diffs |
+| Flag                 | Description                                   |
+| -------------------- | --------------------------------------------- |
+| `--write` / `-w`     | Apply changes (default is dry-run)            |
+| `--yes`              | Auto-approve without interactive confirmation |
+| `--plan-only`        | Only show what would be done                  |
+| `--save-plan <file>` | Save the format plan to a file                |
+| `--from-plan <file>` | Load and execute a saved plan                 |
+| `--detailed`         | Show detailed stats and save report           |
+| `--verbose`          | Enable verbose logging                        |
+| `--diff`             | Show file diffs                               |
+| `--json`             | Emit a read-only format plan as JSON          |
 
 **Formatters (executed in order):**
 
 1. 🧹 **Cleanup** — removes obsolete files (yarn.lock, package-lock.json, tslint.json, etc.)
-2. ⚙️ **Npmextra** — formats and standardizes `npmextra.json`
+2. ⚙️ **Smartconfig** — formats and standardizes `.smartconfig.json`
 3. 📜 **License** — ensures proper licensing and checks dependency licenses
 4. 📦 **Package.json** — standardizes package configuration
 5. 📋 **Templates** — applies project template updates
@@ -144,18 +151,21 @@ gitzone services [command]
 
 **Commands:**
 
-| Command | Description |
-|---------|-------------|
-| `start [service]` | Start services (`mongo`\|`s3`\|`elasticsearch`\|`all`) |
-| `stop [service]` | Stop services |
-| `restart [service]` | Restart services |
-| `status` | Show current service status |
-| `config` | Display configuration details |
-| `compass` | Get MongoDB Compass connection string with network IP |
-| `logs [service] [lines]` | View service logs (default: 20 lines) |
-| `reconfigure` | Reassign ports and restart all services |
-| `remove` | Remove containers (preserves data) |
-| `clean` | Remove containers AND data (⚠️ destructive) |
+| Command                  | Description                                            |
+| ------------------------ | ------------------------------------------------------ |
+| `start [service]`        | Start services (`mongo`\|`s3`\|`elasticsearch`\|`all`) |
+| `stop [service]`         | Stop services                                          |
+| `restart [service]`      | Restart services                                       |
+| `status`                 | Show current service status                            |
+| `config`                 | Display configuration details                          |
+| `set <csv>`              | Set enabled services without prompts                   |
+| `enable <service...>`    | Enable one or more services                            |
+| `disable <service...>`   | Disable one or more services                           |
+| `compass`                | Get MongoDB Compass connection string with network IP  |
+| `logs [service] [lines]` | View service logs (default: 20 lines)                  |
+| `reconfigure`            | Reassign ports and restart all services                |
+| `remove`                 | Remove containers (preserves data)                     |
+| `clean`                  | Remove containers AND data (⚠️ destructive)            |
 
 **Service aliases:**
 
@@ -195,6 +205,9 @@ gitzone services cleanup -g
 # Start all services for your project
 gitzone services start
 
+# Configure enabled services without prompts
+gitzone services set mongodb,minio
+
 # Check what's running
 gitzone services status
 
@@ -217,18 +230,21 @@ Manage release registries and commit settings:
 gitzone config [subcommand]
 ```
 
-| Command | Description |
-|---------|-------------|
-| `show` | Display current release config (registries, access level) |
-| `add [url]` | Add a registry URL (default: `https://registry.npmjs.org`) |
-| `remove [url]` | Remove a registry URL (interactive selection if no URL) |
-| `clear` | Clear all registries (with confirmation) |
-| `access [public\|private]` | Set npm access level for publishing |
-| `commit alwaysTest [true\|false]` | Always run tests before commit |
-| `commit alwaysBuild [true\|false]` | Always build after commit |
-| `services` | Configure which services are enabled |
-
-Configuration is stored in `npmextra.json` under the `@git.zone/cli` key.
+| Command                            | Description                                                |
+| ---------------------------------- | ---------------------------------------------------------- |
+| `show`                             | Display current release config (registries, access level)  |
+| `get <path>`                       | Read a single value from `@git.zone/cli`                   |
+| `set <path> <value>`               | Write a single value to `@git.zone/cli`                    |
+| `unset <path>`                     | Remove a single value from `@git.zone/cli`                 |
+| `add [url]`                        | Add a registry URL (default: `https://registry.npmjs.org`) |
+| `remove [url]`                     | Remove a registry URL (interactive selection if no URL)    |
+| `clear`                            | Clear all registries (with confirmation)                   |
+| `access [public\|private]`         | Set npm access level for publishing                        |
+| `commit alwaysTest [true\|false]`  | Always run tests before commit                             |
+| `commit alwaysBuild [true\|false]` | Always build after commit                                  |
+| `services`                         | Configure which services are enabled                       |
+
+Configuration is stored in `.smartconfig.json` under the `@git.zone/cli` key.
 
 ### 📦 Project Templates
 
@@ -323,44 +339,33 @@ gitzone helpers shortid
 
 ## 📋 Configuration
 
-### npmextra.json
+### .smartconfig.json
 
-Customize gitzone behavior through `npmextra.json`:
+Customize gitzone behavior through `.smartconfig.json`:
 
 ```json
 {
   "@git.zone/cli": {
     "projectType": "npm",
+    "cli": {
+      "interactive": true,
+      "output": "human",
+      "checkUpdates": true
+    },
     "release": {
-      "registries": [
-        "https://registry.npmjs.org"
-      ],
+      "registries": ["https://registry.npmjs.org"],
       "accessLevel": "public"
     },
     "commit": {
       "alwaysTest": false,
       "alwaysBuild": false
-    }
-  },
-  "gitzone": {
+    },
     "format": {
       "interactive": true,
-      "parallel": true,
       "showStats": true,
-      "cache": {
-        "enabled": true,
-        "clean": true
-      },
       "modules": {
         "skip": ["prettier"],
-        "only": [],
-        "order": []
-      },
-      "licenses": {
-        "allowed": ["MIT", "Apache-2.0"],
-        "exceptions": {
-          "some-package": "GPL-3.0"
-        }
+        "only": []
       }
     }
   }
@@ -408,6 +413,23 @@ gitzone services stop
 gitzone commit -ytbpr
 ```
 
+### Agent-Friendly Inspection
+
+```bash
+# Top-level machine-readable help
+gitzone help config --json
+
+# Read-only commit recommendation
+gitzone commit recommend --json
+
+# Read-only format plan
+gitzone format plan --json
+
+# Read or change config without prompts
+gitzone config get release.accessLevel
+gitzone config set cli.interactive false
+```
+
 ### Multi-Repository Management
 
 ```bash

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/cli',
-  version: '2.13.15',
+  version: '2.14.1',
   description: 'A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.'
 }