diff --git a/commands/config.sh b/commands/config.sh index 1dd35f4..2761c5b 100644 --- a/commands/config.sh +++ b/commands/config.sh @@ -23,20 +23,11 @@ show_help() { Dev-Control Configuration Manager USAGE: - dc config Show current configuration - dc config get Get a specific value - dc config set Set a value (project scope) - dc config set --global Set globally - dc config edit Open config in editor - dc config init Initialise project config +dc config Show current configuration dc config get Get a specific value dc config set Set a value (project scope) dc config set --global Set globally dc config edit Open config in editor dc config init Initialise project config KEYS: - default-licence Default licence (MIT, GPL-3.0, etc.) - default-branch Default branch name - auto-sign-commits Sign commits with GPG (true/false) - auto-push-after-fix Push after history fix (true/false) - github-org Default GitHub organisation - template-set Template set (default/minimal/full) +default-licence Default licence (MIT, GPL-3.0, etc.) default-branch Default branch name +auto-sign-commits Sign commits with GPG (true/false) auto-push-after-fix Push after history fix (true/false) github-org Default GitHub organisation template-set Template set (default/minimal/full) EXAMPLES: dc config diff --git a/commands/version.sh b/commands/version.sh index 2d052c4..c304be0 100755 --- a/commands/version.sh +++ b/commands/version.sh @@ -81,8 +81,7 @@ USAGE: dc version [COMMAND] [OPTIONS] COMMANDS: - show Show version information (default) - check Check for updates +show Show version information (default) check Check for updates update Update to latest version changelog Show recent changes @@ -96,8 +95,7 @@ EXAMPLES: dc version --json # JSON output dc version check # Check for updates dc version update # Perform update - dc version changelog # Show recent changes - dc version changelog 1.0.0 # Show specific version +dc version changelog # Show recent changes dc version changelog 1.0.0 # Show specific version EOF } diff --git a/scripts/containerise.sh b/scripts/containerise.sh index a5d17b3..f42da9a 100755 --- a/scripts/containerise.sh +++ b/scripts/containerise.sh @@ -66,9 +66,7 @@ show_help() { Dev-Control Containerisation - Build base images or generate devcontainers USAGE: - containerise.sh --base --CATEGORY # Build a base image - containerise.sh --img --CATEGORY # Generate devcontainer using base image - containerise.sh [PROJECT_PATH] # Interactive mode (legacy) +containerise.sh --base --CATEGORY # Build a base image containerise.sh --img --CATEGORY # Generate devcontainer using base image containerise.sh [PROJECT_PATH] # Interactive mode (legacy) MODES: --base Build a category base image (e.g., devcontrol/game-dev:latest) @@ -95,19 +93,16 @@ CATEGORIES: EXAMPLES: # Build base images - cd ~/.dev-control/.devcontainer && containerise.sh --base --game-dev - cd ~/projects/streaming && containerise.sh --base --streaming + cd ~/.dev-control/.devcontainer && containerise.sh --base --game-dev cd ~/projects/streaming && containerise.sh --base --streaming # Generate devcontainers - cd ~/projects/my-game && containerise.sh --img --game-dev - cd ~/projects/web-app && containerise.sh --img --web-dev + cd ~/projects/my-game && containerise.sh --img --game-dev cd ~/projects/web-app && containerise.sh --img --web-dev # Rebuild all containers in a project tree cd ~/PRO && containerise.sh --nest # Rebuild only dev-tools containers (base + img) in a project tree - cd ~/PRO && containerise.sh --nest --dev-tools - cd ~/PRO && containerise.sh --nest --regen --dev-tools + cd ~/PRO && containerise.sh --nest --dev-tools cd ~/PRO && containerise.sh --nest --regen --dev-tools # Rebuild multiple categories at once cd ~/PRO && containerise.sh --nest --web-dev --streaming diff --git a/scripts/create-repo.sh b/scripts/create-repo.sh index 5964ec6..418dfc3 100755 --- a/scripts/create-repo.sh +++ b/scripts/create-repo.sh @@ -94,9 +94,7 @@ OPTIONS: -h, --help Show this help EXAMPLES: - create-repo.sh # Create repo for current directory - create-repo.sh --edit topics # Edit topics only - create-repo.sh --batch dir1 dir2 # Create repos for multiple dirs +create-repo.sh # Create repo for current directory create-repo.sh --edit topics # Edit topics only create-repo.sh --batch dir1 dir2 # Create repos for multiple dirs ALIASES: dc-repo, dc-create diff --git a/scripts/dev-control.sh b/scripts/dev-control.sh index 7aa246c..c3ee43f 100755 --- a/scripts/dev-control.sh +++ b/scripts/dev-control.sh @@ -171,20 +171,8 @@ USAGE: dev-control.sh [COMMAND] [OPTIONS] COMMANDS: - alias, aliases Install bash aliases (dc-aliases) - git Git services menu (dc-git) - unified git workflows - init, template Initialise repo with templates (dc-init) - repo, create Create GitHub repository (dc-repo) - pr Create pull request (dc-pr) - modules, nest Manage submodules (dc-modules) - fix, history Fix commit history (dc-fix) - full-fix, ff Dedup + GPG-sign recent commits, then optionally refresh templates (dc-full-fix) - licences, lic Audit licences (dc-licences) - package, pkg Build multi-platform packages (dc-package) - mcp Setup MCP servers (dc-mcp) - cluster Setup fully fledged cluster (init + container + mcp) - container Setup devcontainer (dc-container) - help Show this help message +alias, aliases Install bash aliases (dc-aliases) git Git services menu (dc-git) - unified git workflows init, template Initialise repo with templates (dc-init) repo, create Create GitHub repository (dc-repo) pr Create pull request (dc-pr) modules, nest Manage submodules (dc-modules) fix, history Fix commit history (dc-fix) full-fix, ff Dedup + GPG-sign recent commits, then optionally refresh templates (dc-full-fix) licences, lic Audit licences (dc-licences) package, pkg Build multi-platform packages (dc-package) mcp Setup MCP servers (dc-mcp) +cluster Setup fully fledged cluster (init + container + mcp) container Setup devcontainer (dc-container) help Show this help message INTERACTIVE MODE: Run without arguments to use the interactive menu. diff --git a/scripts/git-control.sh b/scripts/git-control.sh index 76380e0..4b1ce5a 100755 --- a/scripts/git-control.sh +++ b/scripts/git-control.sh @@ -98,16 +98,7 @@ WORKFLOW EXAMPLE: 4. Create pull request: git-control pr EXAMPLES: - git-control.sh # Interactive menu - git-control.sh init # Initialise templates - git-control.sh init --batch -y # Batch init multiple repos - git-control.sh repo # Create repository - git-control.sh pr # Create pull request - git-control.sh fix --range HEAD=5 # Fix last 5 commits - git-control.sh fix --sign --dry-run # Preview signing commits - git-control.sh licences --deep # Deep licence scan - git-control.sh licences --apply MIT # Apply MIT licence - git-control.sh gpg-setup # Setup GPG bot for Actions +git-control.sh # Interactive menu git-control.sh init # Initialise templates git-control.sh init --batch -y # Batch init multiple repos git-control.sh repo # Create repository git-control.sh pr # Create pull request git-control.sh fix --range HEAD=5 # Fix last 5 commits git-control.sh fix --sign --dry-run # Preview signing commits git-control.sh licences --deep # Deep licence scan git-control.sh licences --apply MIT # Apply MIT licence git-control.sh gpg-setup # Setup GPG bot for Actions ALIASES (after running dc-aliases): dc-git - This unified wrapper diff --git a/scripts/lib/git/rename.sh b/scripts/lib/git/rename.sh index 6079dfe..e253ff4 100755 --- a/scripts/lib/git/rename.sh +++ b/scripts/lib/git/rename.sh @@ -42,9 +42,7 @@ main() { Branch Renaming Tool - Rename branches or repositories USAGE: - rename.sh [OPTIONS] [OWNER] [BRANCH_SPEC] [PATHS...] - rename.sh --branch [SPEC] # Rename a branch - rename.sh --repo NEW_NAME # Rename the GitHub repository +rename.sh [OPTIONS] [OWNER] [BRANCH_SPEC] [PATHS...] rename.sh --branch [SPEC] # Rename a branch rename.sh --repo NEW_NAME # Rename the GitHub repository ARGUMENTS: OWNER GitHub user/org (default: current gh user) @@ -61,11 +59,7 @@ OPTIONS: -h, --help Show this help EXAMPLES: - dc fix rename --branch main # Rename default branch to main - dc fix rename --repo modern-dating # Rename repo on GitHub + update remote - dc fix rename Main:main ~/repos/* # Local repos, explicit spec - rename.sh -n xaoscience Main:main # Dry run - rename.sh "" Main:main ~/proj1 ~/proj2 # Multiple local repos +dc fix rename --branch main # Rename default branch to main dc fix rename --repo modern-dating # Rename repo on GitHub + update remote dc fix rename Main:main ~/repos/* # Local repos, explicit spec rename.sh -n xaoscience Main:main # Dry run rename.sh "" Main:main ~/proj1 ~/proj2 # Multiple local repos NOTES: - --repo renames on GitHub and updates the local remote.origin URL diff --git a/scripts/lib/keygen.sh b/scripts/lib/keygen.sh index ff7adc1..44476e5 100755 --- a/scripts/lib/keygen.sh +++ b/scripts/lib/keygen.sh @@ -363,13 +363,7 @@ dc-key — unified GPG identity & repo-secret manager USAGE: dc-key Interactive menu - dc-key --user Personal signing key: generate, enrol, cache - dc-key --bot Refresh machine/bot repo secrets (GPG private key + passphrase) - dc-key --token Set / rotate the user token (PAT) repo secret - dc-key --status Show key/secret status (read-only; values are never shown) - dc-key --dry-run Report actions without making changes - dc-key --force Override idempotency guards (rotate even if current) - dc-key --help This help +dc-key --user Personal signing key: generate, enrol, cache dc-key --bot Refresh machine/bot repo secrets (GPG private key + passphrase) dc-key --token Set / rotate the user token (PAT) repo secret dc-key --status Show key/secret status (read-only; values are never shown) dc-key --dry-run Report actions without making changes dc-key --force Override idempotency guards (rotate even if current) dc-key --help This help All secret names are resolved from config/profiles/repoVars.env; nothing is hardcoded. EOF diff --git a/scripts/licences.sh b/scripts/licences.sh index b98cafb..dc4d438 100755 --- a/scripts/licences.sh +++ b/scripts/licences.sh @@ -58,12 +58,7 @@ OPTIONS: -h, --help Show this help message EXAMPLES: - licences.sh # Show licence for current repo - licences.sh --deep # Include all submodules - licences.sh --json --deep # JSON output with submodules - licences.sh --check GPL-3.0 # Check if deps are compatible with GPL-3.0 - licences.sh --apply MIT # Apply MIT licence template - licences.sh /path/to/repo --deep # Scan specific directory +licences.sh # Show licence for current repo licences.sh --deep # Include all submodules licences.sh --json --deep # JSON output with submodules licences.sh --check GPL-3.0 # Check if deps are compatible with GPL-3.0 licences.sh --apply MIT # Apply MIT licence template licences.sh /path/to/repo --deep # Scan specific directory OUTPUT: Default output shows a table with: diff --git a/scripts/mcp-setup.sh b/scripts/mcp-setup.sh index 66de39d..2498cff 100755 --- a/scripts/mcp-setup.sh +++ b/scripts/mcp-setup.sh @@ -136,8 +136,7 @@ TOKEN MANAGEMENT: 2. Optionally copied to clipboard (for easy pasting in VS Code) 3. Displayed once (save it if you skip keyring/clipboard) - VS Code will prompt for the token on first MCP use and store it in - its secure credential vault automatically. + VS Code will prompt for the token on first MCP use and store it in its secure credential vault automatically. Storage options: 1. VS Code Secure Vault (automatic after first prompt) - Most secure @@ -146,11 +145,7 @@ TOKEN MANAGEMENT: 4. GitHub CLI (gh auth token) - For testing/development EXAMPLES: - mcp-setup.sh # Full setup with VS Code secure input - mcp-setup.sh --create-pat # Create PAT + store in keyring (recommended) - mcp-setup.sh --test # Test existing configuration - mcp-setup.sh --show-token # Retrieve token from keyring/gh - mcp-setup.sh --config-only # Just create config file +mcp-setup.sh # Full setup with VS Code secure input mcp-setup.sh --create-pat # Create PAT + store in keyring (recommended) mcp-setup.sh --test # Test existing configuration mcp-setup.sh --show-token # Retrieve token from keyring/gh mcp-setup.sh --config-only # Just create config file ALIASES: dc-mcp diff --git a/scripts/module-nesting.sh b/scripts/module-nesting.sh index 0bd6cb4..92dcbde 100755 --- a/scripts/module-nesting.sh +++ b/scripts/module-nesting.sh @@ -1384,11 +1384,7 @@ Options: -h, --help Show this help Examples: - module-nesting.sh # Interactive: scan and update .gitmodules - module-nesting.sh /path/to/monorepo # Scan a specific root directory - module-nesting.sh --copy-temp --dry-run # Preview temp-dir consolidation - module-nesting.sh --aggressive --delete # Consolidate + delete originals - module-nesting.sh --prune # Clean up stale consolidation records +module-nesting.sh # Interactive: scan and update .gitmodules module-nesting.sh /path/to/monorepo # Scan a specific root directory module-nesting.sh --copy-temp --dry-run # Preview temp-dir consolidation module-nesting.sh --aggressive --delete # Consolidate + delete originals module-nesting.sh --prune # Clean up stale consolidation records Aliases: dc-modules, dc-nest HELP diff --git a/scripts/packaging.sh b/scripts/packaging.sh index 78c023d..01016b2 100755 --- a/scripts/packaging.sh +++ b/scripts/packaging.sh @@ -111,17 +111,10 @@ OPTIONS: -h, --help Show this help message THEMES: - matrix Green fluorescent terminal aesthetic - hacker Orange/amber retro hacker style - cyber Blue cyberpunk neon look +matrix Green fluorescent terminal aesthetic hacker Orange/amber retro hacker style cyber Blue cyberpunk neon look EXAMPLES: - packaging.sh --init # Create config file - packaging.sh --tarball --homebrew # Build tarball + Homebrew - packaging.sh --all # Build everything - packaging.sh --snap --verbose # Build snap with details - packaging.sh --docker # Build Docker image - packaging.sh --theme cyber --all # Build all with cyber theme +packaging.sh --init # Create config file packaging.sh --tarball --homebrew # Build tarball + Homebrew packaging.sh --all # Build everything packaging.sh --snap --verbose # Build snap with details packaging.sh --docker # Build Docker image packaging.sh --theme cyber --all # Build all with cyber theme CONFIG FILE (.dc-package.yaml): name: my-tool diff --git a/scripts/template-loading.sh b/scripts/template-loading.sh index 8d145c2..3807e5c 100755 --- a/scripts/template-loading.sh +++ b/scripts/template-loading.sh @@ -1428,8 +1428,7 @@ run_batch_update() { done if [[ ${#git_dirs[@]} -eq 0 ]]; then - # If the user passed explicit paths that all lacked .git (likely a glob expansion like *), - # offer to fall back to the current directory before giving up. + # If the user passed explicit paths that all lacked .git (likely a glob expansion like *), offer to fall back to the current directory before giving up. local _had_explicit=false [[ ${#POSITIONAL_ARGS[@]} -gt 1 || ( ${#POSITIONAL_ARGS[@]} -eq 1 && "${POSITIONAL_ARGS[0]}" != "." ) ]] \ && _had_explicit=true