v1.1.1

Author: fidpa

.gitignore

@@ -29,3 +29,4 @@ Thumbs.db
 REDDIT_POST.md
 LINKEDIN_POST.md
 LINKEDIN_COMMENT_V*.md
+ssc-list-screenshot.png

CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to server-scripts-cli will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-01-17
+
+### Fixed
+- **HIGH**: Generator now supports `examples/demo-scripts/` directory as fallback when `scripts/` doesn't exist ([#codex-high](https://github.com/fidpa/server-scripts-cli/issues))
+  - Enables testing generator in standalone demo repository without manual setup
+  - Priority-based directory search: `scripts/` first, then `examples/demo-scripts/`
+- **MEDIUM**: Fixed type taxonomy inconsistency - removed `cli-tool` default type, changed to `admin` ([#codex-medium](https://github.com/fidpa/server-scripts-cli/issues))
+  - Default type changed from `cli-tool` to `admin` (Tier 1 type)
+  - Updated CLI help text to show valid type examples
+- **MEDIUM**: Added auto-migration for deprecated `cli-tool` type → `admin` with warnings ([#codex-medium](https://github.com/fidpa/server-scripts-cli/issues))
+  - Non-breaking change: existing scripts with `type: cli-tool` auto-migrate
+  - Warning messages guide users to update YAML frontmatter
+- **LOW**: Synchronized version strings across all files to v1.1.1 ([#codex-low](https://github.com/fidpa/server-scripts-cli/issues))
+
+### Changed
+- Generator now scans directories in priority order: `scripts/` first, then `examples/demo-scripts/`
+- Default type for scripts without frontmatter changed from `cli-tool` to `admin`
+- Updated CLI help text (`ssc list --help`) to remove `cli-tool` references
+
+### Deprecated
+- Type `cli-tool` is now deprecated - use `deployment: cli-tool` field instead
+- See [MANIFEST_SCHEMA.md](docs/MANIFEST_SCHEMA.md#deprecated-types) for migration guide
+
+### Documentation
+- Added "Deprecated Types" section to [MANIFEST_SCHEMA.md](docs/MANIFEST_SCHEMA.md)
+- Added migration examples and behavior documentation
+
 ## [1.1.0] - 2026-01-16
 
 ### Added
@@ -45,5 +72,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Complete documentation suite
 - MIT License
 
+[1.1.1]: https://github.com/fidpa/server-scripts-cli/compare/v1.1.0...v1.1.1
 [1.1.0]: https://github.com/fidpa/server-scripts-cli/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/fidpa/server-scripts-cli/releases/tag/v1.0.0

CLAUDE.md.rclonelink

@@ -0,0 +1 @@
+../CLAUDE.md

docs/MANIFEST_SCHEMA.md

@@ -140,6 +140,33 @@ Scripts are organized into a **4-Tier Hierarchy**:
 | `library` | Sourced by scripts |
 | `helper` | Called by scripts |
 
+### Deprecated Types
+
+The following types are **deprecated** and will be auto-migrated by `generate-manifest.sh`:
+
+| Deprecated Value | Migration Target | Note |
+|-----------------|------------------|------|
+| `cli-tool` | `admin` | Use `deployment: cli-tool` field instead (see Deployment section) |
+
+**Migration Behavior**: If `generate-manifest.sh` encounters `type: cli-tool` in a script's YAML frontmatter, it will:
+1. Auto-migrate to `type: admin`
+2. Print a warning with migration instructions
+3. Continue processing (non-breaking)
+
+**Example**:
+```yaml
+# ❌ Old (deprecated)
+# ---
+# type: cli-tool
+# ---
+
+# ✅ New (recommended)
+# ---
+# type: admin
+# deployment: cli-tool  # If script is interactive CLI tool
+# ---
+```
+
 ### status
 
 | Value | Description |

generate-manifest.sh

@@ -12,7 +12,7 @@
 #   ./generate-manifest.sh --verbose    # Show progress
 #
 # Documentation: docs/MANIFEST_SCHEMA.md
-# Version: 1.0.0
+# Version: 1.1.1
 # Created: 2026-01-02
 
 set -uo pipefail
@@ -27,7 +27,7 @@ else
     readonly REPO_ROOT="$SCRIPT_DIR"
 fi
 readonly MANIFEST_FILE="${REPO_ROOT}/manifest.yaml"
-readonly VERSION="1.0.0"
+readonly VERSION="1.1.1"
 
 # ===== Options =====
 DRY_RUN=false
@@ -201,18 +201,27 @@ generate_script_entry() {
     if [[ -n "$frontmatter" ]]; then
         deployment=$(parse_yaml_field "$frontmatter" "deployment" "manual")
         status=$(parse_yaml_field "$frontmatter" "status" "active")
-        type=$(parse_yaml_field "$frontmatter" "type" "cli-tool")
+        type=$(parse_yaml_field "$frontmatter" "type" "admin")
         requires_root=$(parse_yaml_field "$frontmatter" "requires_root" "false")
         service=$(parse_yaml_field "$frontmatter" "service" "none")
     else
         # Defaults for scripts without front-matter
         deployment="manual"
         status="active"
-        type="cli-tool"
+        type="admin"
         requires_root="false"
         service="none"
     fi
 
+    # Auto-migrate deprecated cli-tool type
+    if [[ "$type" == "cli-tool" ]]; then
+        local script_file="${script_path##*/}"
+        print_warning "Script ${script_file}: type 'cli-tool' is deprecated, auto-migrating to 'admin'"
+        print_info "  → Update YAML frontmatter: type: admin"
+        print_info "  → Or use deployment field: deployment: cli-tool"
+        type="admin"
+    fi
+
     # Generate YAML entry
     cat << EOF
   ${short_name}:
@@ -240,7 +249,23 @@ generate_manifest() {
     local frontmatter_count=0
     local script_list=()
 
-    print_info "Scanning scripts directory..."
+    # Detect script directory (priority: scripts/ → examples/demo-scripts/)
+    readonly SCRIPT_DIRECTORIES=("scripts" "examples/demo-scripts")
+    local SCAN_DIR=""
+
+    for dir in "${SCRIPT_DIRECTORIES[@]}"; do
+        if [[ -d "${REPO_ROOT}/${dir}" ]]; then
+            SCAN_DIR="${REPO_ROOT}/${dir}"
+            print_info "Scanning ${dir}/ directory..."
+            break
+        fi
+    done
+
+    if [[ -z "$SCAN_DIR" ]]; then
+        print_error "No script directories found"
+        print_info "Expected: scripts/ or examples/demo-scripts/"
+        return 1
+    fi
 
     # Find all scripts (excluding hidden, .venv, node_modules, etc.)
     while IFS= read -r script_path; do
@@ -253,7 +278,7 @@ generate_manifest() {
         fi
 
         print_verbose "Found: ${script_path#${REPO_ROOT}/}"
-    done < <(find "${REPO_ROOT}/scripts" -type f \( -name "*.sh" -o -name "*.py" \) \
+    done < <(find "$SCAN_DIR" -type f \( -name "*.sh" -o -name "*.py" \) \
         ! -name "__init__.py" \
         ! -path "*/.venv/*" \
         ! -path "*/venv/*" \
@@ -262,8 +287,8 @@ generate_manifest() {
         2>/dev/null | sort)
 
     if [[ $script_count -eq 0 ]]; then
-        print_warning "No scripts found in ${REPO_ROOT}/scripts/"
-        print_info "Create scripts/ directory and add some .sh or .py files"
+        print_warning "No scripts found in ${SCAN_DIR}"
+        print_info "Add some .sh or .py files to the scripts directory"
         return 1
     fi
 

manifest.yaml

@@ -1,60 +1,63 @@
-# Server Scripts Manifest - Example
-# This demonstrates the YAML schema used by ssc.sh
+# Server Scripts Manifest - Auto-generated from YAML Front-Matter
+# DO NOT EDIT MANUALLY - Regenerate with: ./generate-manifest.sh
 #
-# Schema Documentation: docs/MANIFEST_SCHEMA.md
-# Version: 1.0.0
+# Documentation: docs/MANIFEST_SCHEMA.md
+# Version: 1.1.1
 
 metadata:
-  version: "1.1.0"
-  generated: "2026-01-16T12:00:00+01:00"
-  generator: "manual"
+  version: "1.1.1"
+  generated: "2026-01-17T20:14:50+01:00"
+  generator: "generate-manifest.sh"
   total_scripts: 4
   with_frontmatter: 4
 
-# Categories organize scripts by purpose
+# Categories derived from directory structure
 categories:
   operations:
-    description: "Maintenance, Validation & Backup Scripts"
+    description: "Maintenance, Validation & Backup"
     path: "scripts/operations/"
   monitoring:
     description: "Health Check & Monitoring Scripts"
     path: "scripts/monitoring/"
+  setup:
+    description: "Installation & Setup Scripts"
+    path: "scripts/setup/"
 
 # Script Registry
-# Each script entry contains metadata extracted from YAML front-matter
 scripts:
   backup-example:
     path: "examples/demo-scripts/backup-example.sh"
-    category: "operations"
+    category: ""
     deployment: scheduled
     service: none
     status: active
     type: admin
     requires_root: true
 
-  monitoring-example:
-    path: "examples/demo-scripts/monitoring-example.sh"
-    category: "monitoring"
+  deploy-example:
+    path: "examples/demo-scripts/deploy-example.sh"
+    category: ""
     deployment: manual
     service: none
     status: active
-    type: check
-    requires_root: false
+    type: deploy
+    requires_root: true
 
   health-check:
     path: "examples/demo-scripts/health-check.sh"
-    category: "monitoring"
+    category: ""
     deployment: automated
     service: health-check.service
     status: active
     type: check
     requires_root: false
 
-  deploy-example:
-    path: "examples/demo-scripts/deploy-example.sh"
-    category: "operations"
+  monitoring-example:
+    path: "examples/demo-scripts/monitoring-example.sh"
+    category: ""
     deployment: manual
     service: none
     status: active
-    type: deploy
-    requires_root: true
+    type: check
+    requires_root: false
+

ssc.sh

@@ -715,7 +715,7 @@ ${BOLD}COMMANDS:${NC}
 ${BOLD}LIST OPTIONS:${NC}
     -c, --category <name>   Filter by category (production, operations, etc.)
     -s, --status <status>   Filter by status (active, deprecated, unknown)
-    -t, --type <type>       Filter by type (cli-tool, library, helper, daemon)
+    -t, --type <type>       Filter by type (admin, report, diagnostic, library, helper, daemon)
     -p, --paths             Show full paths
     -n, --limit <num>       Limit output
     --search <term>         Search by name