code-foundry 0.3.0 → 0.5.0

package/.githooks/pre-commit

@@ -1,67 +1,5 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-git diff --cached --check
-changed=$(git diff --cached --name-only)
-
-has_script() {
-  [ -f package.json ] && node -e 'const p=require("./package.json"); process.exit(p.scripts?.[process.argv[1]] ? 0 : 1)' "$1"
-}
-
-package_manager() {
-  if [ -f bun.lock ] || [ -f bun.lockb ]; then echo bun
-  elif [ -f pnpm-lock.yaml ]; then echo pnpm
-  elif [ -f yarn.lock ]; then echo yarn
-  else echo npm
-  fi
-}
-
-run_lint_staged() {
-  if ! has_script lint-staged; then return 1; fi
-  case "$(package_manager)" in
-    bun) bun run lint-staged ;;
-    pnpm) corepack pnpm run lint-staged ;;
-    yarn) corepack yarn run lint-staged ;;
-    npm) npm run lint-staged ;;
-  esac
-}
-
-if printf '%s\n' "$changed" | grep -Eq '\.(js|jsx|ts|tsx|json|md|mdx|yml|yaml)$'; then
-  if ! run_lint_staged; then
-    bash .github/scripts/ci.sh format
-    bash .github/scripts/ci.sh lint
-  fi
-fi
-
-if printf '%s\n' "$changed" | grep -Eq '\.rs$|(^|/)Cargo\.toml$'; then
-  cargo fmt --check
-  cargo clippy --all-targets -- -D warnings
-fi
-
-python_files=()
-python_config=false
-while IFS= read -r file; do
-  case "$file" in
-    *.py)
-      [ -f "$file" ] && python_files+=("$file")
-      ;;
-    pyproject.toml|requirements.txt|requirements-dev.txt)
-      python_config=true
-      ;;
-  esac
-done <<< "$changed"
-
-if [ "$python_config" = true ] || [ "${#python_files[@]}" -gt 0 ]; then
-  ruff_targets=(.)
-  [ "$python_config" = true ] || ruff_targets=("${python_files[@]}")
-  if [ -x .venv/bin/ruff ]; then
-    .venv/bin/ruff format --check "${ruff_targets[@]}"
-    .venv/bin/ruff check "${ruff_targets[@]}"
-  elif command -v ruff >/dev/null 2>&1; then
-    ruff format --check "${ruff_targets[@]}"
-    ruff check "${ruff_targets[@]}"
-  else
-    echo "Python files changed but Ruff is not installed; run the template setup first." >&2
-    exit 1
-  fi
-fi
+repo_root="$(git rev-parse --show-toplevel)"
+exec bash "$repo_root/.github/scripts/pre-commit.sh" "$@"

package/.github/scripts/init-repo.sh

@@ -7,6 +7,7 @@ profile="${REPO_FOUNDRY_PROFILE:-auto}"
 protection=false
 dry_run=false
 prune=false
+force=false
 languages="${REPO_FOUNDRY_LANGUAGES:-auto}"
 features="${REPO_FOUNDRY_FEATURES:-all}"
 package_manager="${REPO_FOUNDRY_PACKAGE_MANAGER:-auto}"
@@ -41,6 +42,7 @@ Options:
   --license-file PATH        Use an exact custom license file
   --npm-publish              Enable npm publication in the release workflow
   --dry-run                  Preview changes without writing files
+  --force                    Replace protected standard docs/templates
   --prune                    Remove disabled standard workflows (never custom workflows)
   --protection               Synchronize main branch required checks
   --no-bootstrap             Skip mise/hooks/doctor bootstrap after init
@@ -66,6 +68,7 @@ while [ "$#" -gt 0 ]; do
     --license-file) license_file="${2:?missing license file}"; shift 2 ;;
     --npm-publish) npm_publish=true; shift ;;
     --dry-run) dry_run=true; shift ;;
+    --force) force=true; shift ;;
     --prune) prune=true; shift ;;
     --protection) protection=true; shift ;;
     --no-bootstrap) bootstrap=false; shift ;;
@@ -110,6 +113,7 @@ sync_args=(
 if [ -n "$license_file" ]; then sync_args+=(--license-file "$license_file"); fi
 if [ "$dry_run" = true ]; then sync_args+=(--check); else sync_args+=(--apply); fi
 if [ "$prune" = true ]; then sync_args+=(--prune); fi
+if [ "$force" = true ]; then sync_args+=(--force); fi
 bash "$sync_script" "${sync_args[@]}"
 
 if [ "$dry_run" = true ]; then

package/.github/scripts/pre-commit.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+git diff --cached --check
+changed=$(git diff --cached --name-only)
+
+has_script() {
+  [ -f package.json ] && node -e 'const p=require("./package.json"); process.exit(p.scripts?.[process.argv[1]] ? 0 : 1)' "$1"
+}
+
+package_manager() {
+  if [ -f bun.lock ] || [ -f bun.lockb ]; then echo bun
+  elif [ -f pnpm-lock.yaml ]; then echo pnpm
+  elif [ -f yarn.lock ]; then echo yarn
+  else echo npm
+  fi
+}
+
+run_lint_staged() {
+  if ! has_script lint-staged; then return 1; fi
+  case "$(package_manager)" in
+    bun) bun run lint-staged ;;
+    pnpm) corepack pnpm run lint-staged ;;
+    yarn) corepack yarn run lint-staged ;;
+    npm) npm run lint-staged ;;
+  esac
+}
+
+if printf '%s\n' "$changed" | grep -Eq '\.(js|jsx|ts|tsx|json|md|mdx|yml|yaml)$'; then
+  if ! run_lint_staged; then
+    bash .github/scripts/ci.sh format
+    bash .github/scripts/ci.sh lint
+  fi
+fi
+
+if printf '%s\n' "$changed" | grep -Eq '\.rs$|(^|/)Cargo\.toml$'; then
+  cargo fmt --check
+  cargo clippy --all-targets -- -D warnings
+fi
+
+python_files=()
+python_config=false
+while IFS= read -r file; do
+  case "$file" in
+    *.py)
+      [ -f "$file" ] && python_files+=("$file")
+      ;;
+    pyproject.toml|requirements.txt|requirements-dev.txt)
+      python_config=true
+      ;;
+  esac
+done <<< "$changed"
+
+if [ "$python_config" = true ] || [ "${#python_files[@]}" -gt 0 ]; then
+  ruff_targets=(.)
+  [ "$python_config" = true ] || ruff_targets=("${python_files[@]}")
+  if [ -x .venv/bin/ruff ]; then
+    .venv/bin/ruff format --check "${ruff_targets[@]}"
+    .venv/bin/ruff check "${ruff_targets[@]}"
+  elif command -v ruff >/dev/null 2>&1; then
+    ruff format --check "${ruff_targets[@]}"
+    ruff check "${ruff_targets[@]}"
+  else
+    echo "Python files changed but Ruff is not installed; run the template setup first." >&2
+    exit 1
+  fi
+fi

package/.github/scripts/sync-template.sh

@@ -18,6 +18,7 @@ Options:
   --check           Preview changes (default)
   --apply           Apply changes
   --prune           Remove disabled standard workflows
+  --force           Replace protected standard docs/templates
 EOF
 }
 
@@ -29,6 +30,7 @@ profile="${REPO_FOUNDRY_PROFILE:-auto}"
 languages="${REPO_FOUNDRY_LANGUAGES:-auto}"
 features="${REPO_FOUNDRY_FEATURES:-all}"
 prune=false
+force=false
 languages_set=false
 profile_set=false
 features_set=false
@@ -107,6 +109,7 @@ while [ "$#" -gt 0 ]; do
     --check) mode="check"; shift ;;
     --apply) mode="apply"; shift ;;
     --prune) prune=true; shift ;;
+    --force) force=true; shift ;;
     -h|--help) usage; exit 0 ;;
     *) usage >&2; exit 2 ;;
   esac
@@ -159,9 +162,10 @@ contains_word "$valid_release_types" "$release_type" || {
   exit 2
 }
 case "$license" in
-  preserve|agpl-3.0-or-later|mit|none) ;;
+  preserve|agpl-3.0-or-later|mit|custom|none) ;;
   *) printf 'Unsupported license: %s\n' "$license" >&2; exit 2 ;;
 esac
+[ -z "$license_file" ] || license=custom
 
 if [ -d "$source" ] && [ -f "$source/.github/scripts/sync-template.sh" ]; then
   template_root="$source"
@@ -229,6 +233,7 @@ files=(
   .github/scripts/doctor.sh
   .github/scripts/security.sh
   .github/scripts/sitecustomize.py
+  .github/scripts/pre-commit.sh
   .github/scripts/sync-template.sh
   .github/scripts/init-repo.sh
   .github/scripts/sync-codeowners.sh
@@ -268,6 +273,14 @@ standard_workflow() {
   esac
 }
 
+protected_standard_file() {
+  case "$1" in
+    AGENTS.md|.github/CODE_OF_CONDUCT.md|.github/CONTRIBUTING.md|.github/PULL_REQUEST_TEMPLATE.md|.github/SECURITY.md|.github/ISSUE_TEMPLATE/*)
+      return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
 custom_workflows=()
 if [ -d .github/workflows ]; then
   while IFS= read -r workflow; do
@@ -292,6 +305,10 @@ for file in "${files[@]}"; do
     echo "Template file missing: $file" >&2
     exit 1
   fi
+  if [ "$force" != true ] && [ -f "$file" ] && protected_standard_file "$file"; then
+    printf 'Preserving existing authored file %s (use --force to refresh).\n' "$file"
+    continue
+  fi
   if { [ "$file" = LICENSE ] || [ "$file" = NOTICE ]; } && [ "$license" = preserve ] && [ -f "$file" ]; then
     continue
   fi

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.5.0](https://github.com/0xPlayerOne/code-foundry/compare/v0.4.0...v0.5.0) (2026-07-28)
+
+
+### Features
+
+* **init:** preserve authored repository docs ([9fab688](https://github.com/0xPlayerOne/code-foundry/commit/9fab6880ad82762cf4e2eb7d813355ab22cdb905))
+
+## [0.4.0](https://github.com/0xPlayerOne/code-foundry/compare/v0.3.0...v0.4.0) (2026-07-28)
+
+
+### Features
+
+* **hooks:** centralize generated pre-commit runtime ([8e8111c](https://github.com/0xPlayerOne/code-foundry/commit/8e8111c1b1b95fcb356fe1b1366e369393cbf946))
+
 ## [0.3.0](https://github.com/0xPlayerOne/code-foundry/compare/v0.2.0...v0.3.0) (2026-07-28)
 
 

package/README.md

@@ -40,6 +40,10 @@ Initialization defaults to AGPL for new repositories. Synchronization defaults
 to `--license preserve`, so an existing repository's license is never replaced
 unless you explicitly select a license or provide `--license-file`.
 
+The generated Git hook is intentionally a small launcher. It points at the
+package-managed `.github/scripts/pre-commit.sh`, so repositories do not need to
+maintain a second copy of the language-aware hook logic.
+
 ## Setup
 
 1. Install [mise](https://mise.jdx.dev/).
@@ -61,6 +65,10 @@ Use `bash .github/scripts/sync-template.sh --source ... --check` to preview diff
 
 The initializer is intentionally flag-driven so the same baseline can be used as a small repository package. Language selection controls CodeQL and records the repository profile; feature selection controls which standard workflows are installed. `auto` detects supported languages, while `all` enables every standard workflow. The resolver profiles the repository for language, package manager, project shape, release type, runners, and cache policy.
 
+Existing authored documentation and issue/PR templates are preserved by
+default. Pass `--force` when intentionally refreshing those files from the
+baseline; repository-specific workflows and application files remain protected.
+
 ```bash
 # Preview a TypeScript + Python repository without changing files
 bash .github/scripts/init-repo.sh \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-foundry",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "A fast, language-aware repository factory for agent-ready workflows, testing, security, and release automation.",
   "type": "module",
   "license": "AGPL-3.0-or-later",

package/src/cli.mjs

@@ -27,6 +27,7 @@ Init/sync options:
   --license-file PATH        Use an exact custom license file
   --npm-publish              Enable npm publication in the release workflow
   --dry-run                 Preview changes without writing files
+  --force                   Replace protected standard docs/templates
   --prune                   Remove disabled standard workflows
   --protection              Synchronize main branch protections (init only)
   --no-bootstrap            Skip mise/hooks/doctor bootstrap after init
@@ -56,6 +57,7 @@ function parseArgs(argv) {
     featuresSet: false,
     dryRun: false,
     prune: false,
+    force: false,
     protection: false,
     bootstrap: true,
   }
@@ -87,6 +89,7 @@ function parseArgs(argv) {
       continue
     }
     if (arg === '--dry-run') options.dryRun = true
+    else if (arg === '--force') options.force = true
     else if (arg === '--prune') options.prune = true
     else if (arg === '--protection') options.protection = true
     else if (arg === '--no-bootstrap') options.bootstrap = false
@@ -118,6 +121,7 @@ function main() {
   if (options.languagesSet) common.push('--languages', options.languages)
   if (options.featuresSet) common.push('--features', options.features)
   if (options.prune) common.push('--prune')
+  if (options.force) common.push('--force')
   if (options.dryRun) common.push('--check')
   else common.push('--apply')
 
@@ -136,6 +140,7 @@ function main() {
     if (options.protection) initArgs.push('--protection')
     if (options.dryRun) initArgs.push('--dry-run')
     if (options.prune) initArgs.push('--prune')
+    if (options.force) initArgs.push('--force')
     if (options.npmPublish) initArgs.push('--npm-publish')
     if (!options.bootstrap) initArgs.push('--no-bootstrap')
     run('init-repo.sh', initArgs, target)