diffimpactscout 0.1.0__tar.gz → 0.2.0__tar.gz

{diffimpactscout-0.1.0/src/diffimpactscout.egg-info → diffimpactscout-0.2.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: diffimpactscout
-Version: 0.1.0
+Version: 0.2.0
 Summary: Incremental pre-push guard and AST blast-radius impact analyzer for git repositories.
 Author: DiffImpactScout contributors
 License: MIT
-Requires-Python: >=3.6
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: author
@@ -30,7 +30,7 @@ An incremental pre-push guard and AST blast-radius impact analyzer for git repos
 - Python AST symbol map: detects changed classes, functions, methods, module fields, and class fields, including deletions and renames.
 - Cross-layer impact linking: Python symbols to Django `{% url %}` template tags and frontend `http.get()/post()`-style calls.
 - Symbol cache (`.impact_analysis_cache.json`) so repeated runs skip unchanged files.
-- Profiles for `plain`, `django`, and `fastapi` projects.
+- Profiles for `generic`, `django`, `fastapi`, `python`, and `frontend` projects.
 - Configurable pre-push hook installation that never silently clobbers an existing hook.
 
 ## Core idea
@@ -50,7 +50,7 @@ The change-set also handles the full breadth of realistic push shapes: direct pu
 pip install diffimpactscout
 ```
 
-The package is pure Python (standard library only at runtime) and requires Python 3.6 or newer and the `git` CLI on `PATH`.
+The package is pure Python (standard library only at runtime) and requires Python 3.8 or newer and the `git` CLI on `PATH`.
 
 Optional tools are only needed for the checks that use them: `ruff`, `eslint` (via `npx`), and `prettier` (via `npx`). If one is missing, the affected check emits a warning and the guard continues; it never blocks a push because a tool is absent.
 
@@ -70,7 +70,21 @@ diffimpactscout impact
 diffimpactscout install-hooks
 ```
 
-`init` accepts `--profile plain|django|fastapi` to seed profile-appropriate settings.
+`init` accepts `--profile generic|django|fastapi|python|frontend` to seed profile-appropriate settings. `install-hooks` detects the stack automatically (see [Supported setups](#supported-setups)).
+
+## Supported setups
+
+`install-hooks` detects the project stack on first run and writes a `.diffimpactscout.json` that fits it:
+
+| Detection signal | Profile | Guard checks | Impact globs |
+| --- | --- | --- | --- |
+| `manage.py` + `settings.py`/`wsgi.py` | django | default + `ruff`, `ruff-format` | urls, templates, frontend |
+| `fastapi` in deps or `main.py` | fastapi | default + `ruff`, `ruff-format` | `**/*.py` routes + frontend globs |
+| `package.json` + `src`/`app` `*.ts`/`*.js` | frontend | default + `eslint`, `prettier` | templates + frontend globs |
+| `*.py` present | python | default + `ruff`, `ruff-format` | Python module references |
+| anything else (or no signal) | generic | default from `init` | none |
+
+Other ecosystems (Go, Rust, Java, Ruby, ...) are detected and reported as "planned for future releases" in the preview; the generic profile still installs the universal guard checks. Add a language linter with an [external check](#configuration).
 
 ## Commands
 
@@ -82,7 +96,7 @@ Writes a `.diffimpactscout.json` into the current directory. If the file already
 
 | Flag | Description |
 | --- | --- |
-| `--profile {plain,django,fastapi}` | Seed defaults from the named profile (default: `plain`). |
+| `--profile {generic,django,fastapi,python,frontend}` | Seed defaults from the named profile (default: `generic`). |
 
 ### `diffimpactscout guard`
 
@@ -114,8 +128,14 @@ Runs a single check by id (see [Checks reference](#checks-reference)). With no f
 
 Installs a `pre-push` git hook that runs `diffimpactscout guard` on push.
 
+On first run the command detects the stack, prints a preview of the `.diffimpactscout.json` it would write, and (when stdin is a terminal) asks for confirmation. Answer `n` to override profile, blocking mode, extra checks, and impact. Use `--yes` in CI to skip prompts, `--profile` and `--blocking` to pre-select settings, and `--reconfigure` to rewrite an existing config. Without `--reconfigure` an existing config is left untouched.
+
 | Flag | Description |
 | --- | --- |
+| `--profile {generic,django,fastapi,python,frontend}` | Pre-select the setup profile; skips the stack question. |
+| `--blocking {warn,strict}` | Blocking mode for guard checks (default: `warn`). |
+| `--yes`, `-y` | Accept defaults and skip prompts (non-interactive). |
+| `--reconfigure` | Rewrite an existing `.diffimpactscout.json`. |
 | `--force` | Overwrite an existing `pre-push` hook that DiffImpactScout did not install. |
 | `--uninstall` | Remove the DiffImpactScout `pre-push` hook. |
 
@@ -156,7 +176,7 @@ DiffImpactScout is configured by a `.diffimpactscout.json` file in the repositor
     "blocking": "warn"
   },
   "impact": {
-    "profile": "plain",
+    "profile": "generic",
     "urls_globs": [],
     "template_globs": [],
     "frontend_globs": [],
@@ -173,7 +193,7 @@ DiffImpactScout is configured by a `.diffimpactscout.json` file in the repositor
 | top-level | `use_gitignore` | When `true`, also excludes paths ignored by `git check-ignore`. |
 | `guard` | `checks` | Ordered list of check entries; each `{"id": ...}` may add `args`, `blocking`, and `always_block` overrides. |
 | `guard` | `blocking` | `"warn"` (default) or `"strict"`. In strict mode every check marked blocking can fail the run. |
-| `impact` | `profile` | `plain`, `django`, or `fastapi`; selects route extraction plus default globs. |
+| `impact` | `profile` | `generic`, `django`, or `fastapi`; selects route extraction plus default globs. |
 | `impact` | `urls_globs` / `template_globs` / `frontend_globs` | Glob patterns for route files, Django templates, and frontend sources. |
 | `impact` | `cache_file` | Path of the symbol cache (relative to the repo root). |
 | `impact` | `fast_mode`, `threads` | Reserved defaults from `init`; fast mode is currently selected with the `impact --fast` flag. |
@@ -188,9 +208,11 @@ External checks run `command` (each `{file}` placeholder is replaced with the fi
 
 ### Profiles
 
-- `plain`: no route or cross-layer globs; impact analysis reports only Python references.
+- `generic`: no route or cross-layer globs; impact analysis reports only Python references.
+- `python`: same impact globs as `generic`; guard checks append `ruff` and `ruff-format`.
 - `django`: route files `**/urls.py`, templates `**/templates/**/*.html`, frontend `**/src/**/*.ts` and `**/app/**/*.js`; guard checks append `ruff` and `ruff-format`.
 - `fastapi`: routes extracted from `**/*.py`, same frontend globs; guard checks append `ruff` and `ruff-format`.
+- `frontend`: template globs `**/*.html` and frontend globs `**/src/**/*.ts` and `**/app/**/*.js`; guard checks append `eslint` and `prettier`.
 
 ### Blocking behavior
 
@@ -284,7 +306,7 @@ All checks are incremental: file-scoped checks run on files in the change-set, a
 
 ## Requirements
 
-- Python 3.6 or newer.
+- Python 3.8 or newer.
 - Standard library only at runtime; no third-party dependencies.
 - The `git` CLI on `PATH`.
 - Optional: `ruff`, `eslint`, and `prettier` for their respective checks (missing tools degrade to warnings).

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/README.md

@@ -13,7 +13,7 @@ An incremental pre-push guard and AST blast-radius impact analyzer for git repos
 - Python AST symbol map: detects changed classes, functions, methods, module fields, and class fields, including deletions and renames.
 - Cross-layer impact linking: Python symbols to Django `{% url %}` template tags and frontend `http.get()/post()`-style calls.
 - Symbol cache (`.impact_analysis_cache.json`) so repeated runs skip unchanged files.
-- Profiles for `plain`, `django`, and `fastapi` projects.
+- Profiles for `generic`, `django`, `fastapi`, `python`, and `frontend` projects.
 - Configurable pre-push hook installation that never silently clobbers an existing hook.
 
 ## Core idea
@@ -33,7 +33,7 @@ The change-set also handles the full breadth of realistic push shapes: direct pu
 pip install diffimpactscout
 ```
 
-The package is pure Python (standard library only at runtime) and requires Python 3.6 or newer and the `git` CLI on `PATH`.
+The package is pure Python (standard library only at runtime) and requires Python 3.8 or newer and the `git` CLI on `PATH`.
 
 Optional tools are only needed for the checks that use them: `ruff`, `eslint` (via `npx`), and `prettier` (via `npx`). If one is missing, the affected check emits a warning and the guard continues; it never blocks a push because a tool is absent.
 
@@ -53,7 +53,21 @@ diffimpactscout impact
 diffimpactscout install-hooks
 ```
 
-`init` accepts `--profile plain|django|fastapi` to seed profile-appropriate settings.
+`init` accepts `--profile generic|django|fastapi|python|frontend` to seed profile-appropriate settings. `install-hooks` detects the stack automatically (see [Supported setups](#supported-setups)).
+
+## Supported setups
+
+`install-hooks` detects the project stack on first run and writes a `.diffimpactscout.json` that fits it:
+
+| Detection signal | Profile | Guard checks | Impact globs |
+| --- | --- | --- | --- |
+| `manage.py` + `settings.py`/`wsgi.py` | django | default + `ruff`, `ruff-format` | urls, templates, frontend |
+| `fastapi` in deps or `main.py` | fastapi | default + `ruff`, `ruff-format` | `**/*.py` routes + frontend globs |
+| `package.json` + `src`/`app` `*.ts`/`*.js` | frontend | default + `eslint`, `prettier` | templates + frontend globs |
+| `*.py` present | python | default + `ruff`, `ruff-format` | Python module references |
+| anything else (or no signal) | generic | default from `init` | none |
+
+Other ecosystems (Go, Rust, Java, Ruby, ...) are detected and reported as "planned for future releases" in the preview; the generic profile still installs the universal guard checks. Add a language linter with an [external check](#configuration).
 
 ## Commands
 
@@ -65,7 +79,7 @@ Writes a `.diffimpactscout.json` into the current directory. If the file already
 
 | Flag | Description |
 | --- | --- |
-| `--profile {plain,django,fastapi}` | Seed defaults from the named profile (default: `plain`). |
+| `--profile {generic,django,fastapi,python,frontend}` | Seed defaults from the named profile (default: `generic`). |
 
 ### `diffimpactscout guard`
 
@@ -97,8 +111,14 @@ Runs a single check by id (see [Checks reference](#checks-reference)). With no f
 
 Installs a `pre-push` git hook that runs `diffimpactscout guard` on push.
 
+On first run the command detects the stack, prints a preview of the `.diffimpactscout.json` it would write, and (when stdin is a terminal) asks for confirmation. Answer `n` to override profile, blocking mode, extra checks, and impact. Use `--yes` in CI to skip prompts, `--profile` and `--blocking` to pre-select settings, and `--reconfigure` to rewrite an existing config. Without `--reconfigure` an existing config is left untouched.
+
 | Flag | Description |
 | --- | --- |
+| `--profile {generic,django,fastapi,python,frontend}` | Pre-select the setup profile; skips the stack question. |
+| `--blocking {warn,strict}` | Blocking mode for guard checks (default: `warn`). |
+| `--yes`, `-y` | Accept defaults and skip prompts (non-interactive). |
+| `--reconfigure` | Rewrite an existing `.diffimpactscout.json`. |
 | `--force` | Overwrite an existing `pre-push` hook that DiffImpactScout did not install. |
 | `--uninstall` | Remove the DiffImpactScout `pre-push` hook. |
 
@@ -139,7 +159,7 @@ DiffImpactScout is configured by a `.diffimpactscout.json` file in the repositor
     "blocking": "warn"
   },
   "impact": {
-    "profile": "plain",
+    "profile": "generic",
     "urls_globs": [],
     "template_globs": [],
     "frontend_globs": [],
@@ -156,7 +176,7 @@ DiffImpactScout is configured by a `.diffimpactscout.json` file in the repositor
 | top-level | `use_gitignore` | When `true`, also excludes paths ignored by `git check-ignore`. |
 | `guard` | `checks` | Ordered list of check entries; each `{"id": ...}` may add `args`, `blocking`, and `always_block` overrides. |
 | `guard` | `blocking` | `"warn"` (default) or `"strict"`. In strict mode every check marked blocking can fail the run. |
-| `impact` | `profile` | `plain`, `django`, or `fastapi`; selects route extraction plus default globs. |
+| `impact` | `profile` | `generic`, `django`, or `fastapi`; selects route extraction plus default globs. |
 | `impact` | `urls_globs` / `template_globs` / `frontend_globs` | Glob patterns for route files, Django templates, and frontend sources. |
 | `impact` | `cache_file` | Path of the symbol cache (relative to the repo root). |
 | `impact` | `fast_mode`, `threads` | Reserved defaults from `init`; fast mode is currently selected with the `impact --fast` flag. |
@@ -171,9 +191,11 @@ External checks run `command` (each `{file}` placeholder is replaced with the fi
 
 ### Profiles
 
-- `plain`: no route or cross-layer globs; impact analysis reports only Python references.
+- `generic`: no route or cross-layer globs; impact analysis reports only Python references.
+- `python`: same impact globs as `generic`; guard checks append `ruff` and `ruff-format`.
 - `django`: route files `**/urls.py`, templates `**/templates/**/*.html`, frontend `**/src/**/*.ts` and `**/app/**/*.js`; guard checks append `ruff` and `ruff-format`.
 - `fastapi`: routes extracted from `**/*.py`, same frontend globs; guard checks append `ruff` and `ruff-format`.
+- `frontend`: template globs `**/*.html` and frontend globs `**/src/**/*.ts` and `**/app/**/*.js`; guard checks append `eslint` and `prettier`.
 
 ### Blocking behavior
 
@@ -267,7 +289,7 @@ All checks are incremental: file-scoped checks run on files in the change-set, a
 
 ## Requirements
 
-- Python 3.6 or newer.
+- Python 3.8 or newer.
 - Standard library only at runtime; no third-party dependencies.
 - The `git` CLI on `PATH`.
 - Optional: `ruff`, `eslint`, and `prettier` for their respective checks (missing tools degrade to warnings).

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/setup.py

@@ -7,13 +7,13 @@ with io.open("README.md", encoding="utf-8") as fh:
 
 setup(
     name="diffimpactscout",
-    version="0.1.0",
+    version="0.2.0",
     description="Incremental pre-push guard and AST blast-radius impact analyzer for git repositories.",
     long_description=long_description,
     long_description_content_type="text/markdown",
     license="MIT",
     author="DiffImpactScout contributors",
-    python_requires=">=3.6",
+    python_requires=">=3.8",
     packages=find_packages("src"),
     package_dir={"": "src"},
     package_data={"diffimpactscout": ["profiles/*.json"]},

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/src/diffimpactscout/__init__.py

@@ -1,3 +1,3 @@
 """diffimpactscout: incremental pre-push guard and AST blast-radius impact analyzer."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/src/diffimpactscout/checks/ruff.py

@@ -18,6 +18,21 @@ from diffimpactscout.checks.base import (
 _HUNK_RE = re.compile(r"^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@")
 
 
+def _split_hunks(text):
+    hunks = []
+    current = []
+    for line in text.split("\n"):
+        if line.startswith("@@"):
+            if current:
+                hunks.append("\n".join(current))
+            current = [line]
+        else:
+            current.append(line)
+    if current:
+        hunks.append("\n".join(current))
+    return hunks
+
+
 def _truncate(text, limit=30):
     lines = text.split("\n")
     if len(lines) <= limit:
@@ -55,7 +70,7 @@ def _filter_diff_by_lines(diff, changed):
         i += 1
     out = list(header)
     body = "\n".join(lines[i:])
-    for hunk in re.split(r"(?=^@@)", body, flags=re.MULTILINE):
+    for hunk in _split_hunks(body):
         if not hunk.startswith("@@"):
             continue
         m = _HUNK_RE.match(hunk)

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/src/diffimpactscout/cli.py

@@ -6,6 +6,7 @@ import os
 import sys
 
 import diffimpactscout.config as config
+import diffimpactscout.detect as detect
 import diffimpactscout.env as env
 import diffimpactscout.gitrun as gitrun
 import diffimpactscout.guard as guard
@@ -28,7 +29,7 @@ def _parser():
     p_init = sub.add_parser("init", help="write a .diffimpactscout.json config")
     p_init.add_argument(
         "--profile",
-        choices=("plain", "django", "fastapi"),
+        choices=config.PROFILE_CHOICES,
         default=config.DEFAULT_PROFILE,
     )
     p_init.set_defaults(func=_cmd_init)
@@ -67,6 +68,24 @@ def _parser():
         action="store_true",
         help="remove the diffimpactscout pre-push hook",
     )
+    p_hooks.add_argument(
+        "--profile",
+        choices=config.PROFILE_CHOICES,
+        help="pre-select the setup profile (skips the stack question)",
+    )
+    p_hooks.add_argument(
+        "--blocking",
+        choices=("warn", "strict"),
+        help="blocking mode for guard checks",
+    )
+    p_hooks.add_argument(
+        "--yes", "-y", action="store_true", help="accept defaults without prompts"
+    )
+    p_hooks.add_argument(
+        "--reconfigure",
+        action="store_true",
+        help="rewrite an existing .diffimpactscout.json",
+    )
     p_hooks.set_defaults(func=_cmd_install_hooks)
 
     return parser
@@ -190,6 +209,153 @@ def _cmd_check(args):
     return 1 if result.has_issues() else 0
 
 
+def _is_tty():
+    try:
+        return sys.stdin.isatty()
+    except (OSError, ValueError):
+        return False
+
+
+def _read_answer():
+    try:
+        return (sys.stdin.readline() or "").strip().lower()
+    except (OSError, ValueError):
+        return ""
+
+
+def _prompt_yes_default(text, default):
+    sys.stdout.write(text + " ")
+    sys.stdout.flush()
+    answer = _read_answer()
+    if answer in ("y", "yes"):
+        return True
+    if answer in ("n", "no"):
+        return False
+    return default
+
+
+def _prompt_choice(text, choices, default):
+    sys.stdout.write("%s [%s] (default: %s): " % (text, "/".join(choices), default))
+    sys.stdout.flush()
+    answer = _read_answer()
+    if answer in choices:
+        return answer
+    return default
+
+
+def _check_id(entry):
+    if isinstance(entry, dict):
+        return entry.get("id", "?")
+    return str(entry)
+
+
+def _resolve_profile(args, detected):
+    if args.profile:
+        return args.profile
+    if detected in config.PROFILE_CHOICES:
+        return detected
+    return config.DEFAULT_PROFILE
+
+
+def _render_preview(detected, cfg):
+    profile = cfg["impact"].get("profile") or config.DEFAULT_PROFILE
+    if profile not in config.PROFILE_CHOICES:
+        profile = config.DEFAULT_PROFILE
+    checks = cfg["guard"]["checks"]
+    impact_on = profile != config.DEFAULT_PROFILE
+    blocking = cfg["guard"].get("blocking", "warn")
+    lines = []
+    if detected == profile:
+        lines.append("detected framework: %s" % detected)
+    lines.append("")
+    lines.append("diffimpactscout will write .diffimpactscout.json")
+    lines.append("  profile   : %s" % profile)
+    lines.append("  blocking  : %s" % blocking)
+    lines.append("  impact    : %s" % ("on" if impact_on else "off"))
+    lines.append("  checks    : %d" % len(checks))
+    for entry in checks:
+        lines.append("    - %s" % _check_id(entry))
+    lines.append("")
+    lines.append(
+        "  then installs the pre-push hook -> runs `diffimpactscout guard` on each push."
+    )
+    lines.append("")
+    return "\n".join(lines)
+
+
+def _other_stack_note(root, profile):
+    if profile != config.DEFAULT_PROFILE:
+        return None
+    other = detect.describe_other_stack(root)
+    if not other:
+        return None
+    return (
+        "detected %s. Language-specific lint and impact for %s is planned "
+        "for future releases; the generic profile installs the universal "
+        "guard checks instead." % (other, other)
+    )
+
+
+def _build_config_data(profile, args):
+    data = config._defaults()
+    data = config._deep_merge(data, config.load_profile(profile))
+    if args.blocking:
+        data["guard"]["blocking"] = args.blocking
+    return data
+
+
+def _write_config(path, data):
+    try:
+        with open(path, "w") as fh:
+            json.dump(data, fh, indent=2)
+            fh.write("\n")
+    except OSError as exc:
+        sys.stderr.write("diffimpactscout: cannot write %s: %s\n" % (path, exc))
+        return 1
+    return 0
+
+
+_LINT_HINT = {
+    "django": "ruff + ruff-format",
+    "fastapi": "ruff + ruff-format",
+    "python": "ruff + ruff-format",
+    "frontend": "eslint + prettier",
+}
+
+
+def _ask_overrides(data, args):
+    profile = data["impact"].get("profile") or config.DEFAULT_PROFILE
+    if profile not in config.PROFILE_CHOICES:
+        profile = config.DEFAULT_PROFILE
+    profile = _prompt_choice("Profile", list(config.PROFILE_CHOICES), profile)
+    merged = config._deep_merge(config._defaults(), config.load_profile(profile))
+    if args.blocking:
+        merged["guard"]["blocking"] = args.blocking
+    data["guard"] = merged["guard"]
+    data["impact"] = merged["impact"]
+    if not args.blocking:
+        strict = _prompt_yes_default(
+            "Block the push when checks report issues? (strict mode) [y/N]", False
+        )
+        data["guard"]["blocking"] = "strict" if strict else "warn"
+    hint = _LINT_HINT.get(profile)
+    if hint:
+        keep = _prompt_yes_default(
+            "Keep the extra lint checks? (%s) [Y/n]" % hint, True
+        )
+        if not keep:
+            data["guard"]["checks"] = [dict(c) for c in config.DEFAULT_GUARD_CHECKS]
+    impact_on = _prompt_yes_default(
+        "Enable impact analysis? [Y/n]",
+        merged["impact"].get("profile") != config.DEFAULT_PROFILE,
+    )
+    if not impact_on:
+        generic = config._deep_merge(
+            config._defaults(), config.load_profile("generic")
+        )
+        data["impact"] = generic["impact"]
+
+
 def _cmd_install_hooks(args):
     root = _require_repo()
     if root is None:
@@ -207,6 +373,36 @@ def _cmd_install_hooks(args):
         else:
             print("nothing to remove")
         return 0
+    cfg_path = os.path.join(root, config.CFG_NAME)
+    has_config = os.path.exists(cfg_path)
+    proceed = True
+    if has_config and not args.reconfigure:
+        print(
+            "diffimpactscout: %s already exists; leaving it unchanged "
+            "(pass --reconfigure to rewrite)" % config.CFG_NAME
+        )
+    else:
+        detected = detect.detect_stack(root)
+        profile = _resolve_profile(args, detected)
+        data = _build_config_data(profile, args)
+        sys.stdout.write(_render_preview(detected, data))
+        note = _other_stack_note(root, profile)
+        if note:
+            sys.stderr.write("diffimpactscout: %s\n" % note)
+        interactive = not args.yes and _is_tty()
+        if interactive:
+            proceed = _prompt_yes_default("Proceed? [Y/n]", True)
+            if not proceed:
+                _ask_overrides(data, args)
+                sys.stdout.write(_render_preview(detected, data))
+                proceed = _prompt_yes_default("Proceed? [Y/n]", True)
+        if proceed:
+            rc = _write_config(cfg_path, data)
+            if rc != 0:
+                return rc
+    if not proceed:
+        print("diffimpactscout: setup skipped; no changes made")
+        return 0
     try:
         installed = launcher.install_hook(root, force=args.force)
     except OSError as exc:

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/src/diffimpactscout/config.py

@@ -8,7 +8,8 @@ import sys
 import diffimpactscout.gitrun as gitrun
 
 CFG_NAME = ".diffimpactscout.json"
-DEFAULT_PROFILE = "plain"
+DEFAULT_PROFILE = "generic"
+PROFILE_CHOICES = ("generic", "django", "fastapi", "python", "frontend")
 MODE_PRE_PUSH = "pre-push"
 
 DEFAULT_IGNORE_PATHS = [

diffimpactscout-0.2.0/src/diffimpactscout/detect.py

@@ -0,0 +1,91 @@
+"""Detect the project stack for first-run setup.
+
+Example: a repo with manage.py plus settings.py resolves to 'django'; a
+repo containing only go.mod falls back to the generic profile.
+"""
+
+import os
+
+_IGNORED_DIRS = {".git", "node_modules", "venv", ".venv", "env", "dist", "build"}
+
+_OTHER_STACKS = (
+    ("Go", "go.mod"),
+    ("Rust", "Cargo.toml"),
+    ("Java", "pom.xml"),
+    ("Ruby", "Gemfile"),
+)
+
+
+def _walk(root):
+    for base, dirs, files in os.walk(root):
+        dirs[:] = [d for d in dirs if d not in _IGNORED_DIRS]
+        for name in files:
+            yield os.path.join(base, name)
+
+
+def _has(root, rel):
+    return os.path.exists(os.path.join(root, rel))
+
+
+def _mentions(root, name, token):
+    path = os.path.join(root, name)
+    if not os.path.exists(path):
+        return False
+    with open(path) as fh:
+        return token in fh.read()
+
+
+def _has_django(root):
+    if not _has(root, "manage.py"):
+        return False
+    for path in _walk(root):
+        if path.endswith("settings.py") or path.endswith("wsgi.py"):
+            return True
+    return False
+
+
+def _has_fastapi(root):
+    for name in ("requirements.txt", "requirements-dev.txt", "pyproject.toml"):
+        if _mentions(root, name, "fastapi"):
+            return True
+    main = os.path.join(root, "main.py")
+    if os.path.exists(main):
+        with open(main) as fh:
+            return "fastapi" in fh.read()
+    return False
+
+
+def _has_frontend(root):
+    if not _has(root, "package.json"):
+        return False
+    for path in _walk(root):
+        parts = path.split(os.sep)
+        if ("src" in parts or "app" in parts) and path.endswith((".ts", ".js")):
+            return True
+    return False
+
+
+def _has_python(root):
+    for path in _walk(root):
+        if path.endswith(".py"):
+            return True
+    return False
+
+
+def detect_stack(root):
+    if _has_django(root):
+        return "django"
+    if _has_fastapi(root):
+        return "fastapi"
+    if _has_frontend(root):
+        return "frontend"
+    if _has_python(root):
+        return "python"
+    return "generic"
+
+
+def describe_other_stack(root):
+    for label, marker in _OTHER_STACKS:
+        if _has(root, marker):
+            return label
+    return None

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/src/diffimpactscout/impact/impact.py

@@ -34,7 +34,7 @@ def run_impact(root, cfg, staged=False, fast=False, json_out=False):
     if _skip_requested():
         return 0
     impact_cfg = cfg.get("impact") or {}
-    profile = impact_cfg.get("profile") or "plain"
+    profile = impact_cfg.get("profile") or "generic"
     from_ref, to_ref = env.pre_commit_refs()
     anchor = None
     if not staged:

diffimpactscout-0.2.0/src/diffimpactscout/profiles/frontend.json

@@ -0,0 +1,14 @@
+{
+  "impact": {
+    "profile": "frontend",
+    "urls_globs": [],
+    "template_globs": ["**/*.html"],
+    "frontend_globs": ["**/src/**/*.ts", "**/app/**/*.js"]
+  },
+  "guard": {
+    "checks": [
+      {"id": "eslint"},
+      {"id": "prettier"}
+    ]
+  }
+}

diffimpactscout-0.1.0/src/diffimpactscout/profiles/plain.json → diffimpactscout-0.2.0/src/diffimpactscout/profiles/generic.json

@@ -1,6 +1,6 @@
 {
   "impact": {
-    "profile": "plain",
+    "profile": "generic",
     "urls_globs": [],
     "template_globs": [],
     "frontend_globs": []

diffimpactscout-0.2.0/src/diffimpactscout/profiles/python.json

@@ -0,0 +1,14 @@
+{
+  "impact": {
+    "profile": "python",
+    "urls_globs": [],
+    "template_globs": [],
+    "frontend_globs": []
+  },
+  "guard": {
+    "checks": [
+      {"id": "ruff"},
+      {"id": "ruff-format"}
+    ]
+  }
+}

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0/src/diffimpactscout.egg-info}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: diffimpactscout
-Version: 0.1.0
+Version: 0.2.0
 Summary: Incremental pre-push guard and AST blast-radius impact analyzer for git repositories.
 Author: DiffImpactScout contributors
 License: MIT
-Requires-Python: >=3.6
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: author
@@ -30,7 +30,7 @@ An incremental pre-push guard and AST blast-radius impact analyzer for git repos
 - Python AST symbol map: detects changed classes, functions, methods, module fields, and class fields, including deletions and renames.
 - Cross-layer impact linking: Python symbols to Django `{% url %}` template tags and frontend `http.get()/post()`-style calls.
 - Symbol cache (`.impact_analysis_cache.json`) so repeated runs skip unchanged files.
-- Profiles for `plain`, `django`, and `fastapi` projects.
+- Profiles for `generic`, `django`, `fastapi`, `python`, and `frontend` projects.
 - Configurable pre-push hook installation that never silently clobbers an existing hook.
 
 ## Core idea
@@ -50,7 +50,7 @@ The change-set also handles the full breadth of realistic push shapes: direct pu
 pip install diffimpactscout
 ```
 
-The package is pure Python (standard library only at runtime) and requires Python 3.6 or newer and the `git` CLI on `PATH`.
+The package is pure Python (standard library only at runtime) and requires Python 3.8 or newer and the `git` CLI on `PATH`.
 
 Optional tools are only needed for the checks that use them: `ruff`, `eslint` (via `npx`), and `prettier` (via `npx`). If one is missing, the affected check emits a warning and the guard continues; it never blocks a push because a tool is absent.
 
@@ -70,7 +70,21 @@ diffimpactscout impact
 diffimpactscout install-hooks
 ```
 
-`init` accepts `--profile plain|django|fastapi` to seed profile-appropriate settings.
+`init` accepts `--profile generic|django|fastapi|python|frontend` to seed profile-appropriate settings. `install-hooks` detects the stack automatically (see [Supported setups](#supported-setups)).
+
+## Supported setups
+
+`install-hooks` detects the project stack on first run and writes a `.diffimpactscout.json` that fits it:
+
+| Detection signal | Profile | Guard checks | Impact globs |
+| --- | --- | --- | --- |
+| `manage.py` + `settings.py`/`wsgi.py` | django | default + `ruff`, `ruff-format` | urls, templates, frontend |
+| `fastapi` in deps or `main.py` | fastapi | default + `ruff`, `ruff-format` | `**/*.py` routes + frontend globs |
+| `package.json` + `src`/`app` `*.ts`/`*.js` | frontend | default + `eslint`, `prettier` | templates + frontend globs |
+| `*.py` present | python | default + `ruff`, `ruff-format` | Python module references |
+| anything else (or no signal) | generic | default from `init` | none |
+
+Other ecosystems (Go, Rust, Java, Ruby, ...) are detected and reported as "planned for future releases" in the preview; the generic profile still installs the universal guard checks. Add a language linter with an [external check](#configuration).
 
 ## Commands
 
@@ -82,7 +96,7 @@ Writes a `.diffimpactscout.json` into the current directory. If the file already
 
 | Flag | Description |
 | --- | --- |
-| `--profile {plain,django,fastapi}` | Seed defaults from the named profile (default: `plain`). |
+| `--profile {generic,django,fastapi,python,frontend}` | Seed defaults from the named profile (default: `generic`). |
 
 ### `diffimpactscout guard`
 
@@ -114,8 +128,14 @@ Runs a single check by id (see [Checks reference](#checks-reference)). With no f
 
 Installs a `pre-push` git hook that runs `diffimpactscout guard` on push.
 
+On first run the command detects the stack, prints a preview of the `.diffimpactscout.json` it would write, and (when stdin is a terminal) asks for confirmation. Answer `n` to override profile, blocking mode, extra checks, and impact. Use `--yes` in CI to skip prompts, `--profile` and `--blocking` to pre-select settings, and `--reconfigure` to rewrite an existing config. Without `--reconfigure` an existing config is left untouched.
+
 | Flag | Description |
 | --- | --- |
+| `--profile {generic,django,fastapi,python,frontend}` | Pre-select the setup profile; skips the stack question. |
+| `--blocking {warn,strict}` | Blocking mode for guard checks (default: `warn`). |
+| `--yes`, `-y` | Accept defaults and skip prompts (non-interactive). |
+| `--reconfigure` | Rewrite an existing `.diffimpactscout.json`. |
 | `--force` | Overwrite an existing `pre-push` hook that DiffImpactScout did not install. |
 | `--uninstall` | Remove the DiffImpactScout `pre-push` hook. |
 
@@ -156,7 +176,7 @@ DiffImpactScout is configured by a `.diffimpactscout.json` file in the repositor
     "blocking": "warn"
   },
   "impact": {
-    "profile": "plain",
+    "profile": "generic",
     "urls_globs": [],
     "template_globs": [],
     "frontend_globs": [],
@@ -173,7 +193,7 @@ DiffImpactScout is configured by a `.diffimpactscout.json` file in the repositor
 | top-level | `use_gitignore` | When `true`, also excludes paths ignored by `git check-ignore`. |
 | `guard` | `checks` | Ordered list of check entries; each `{"id": ...}` may add `args`, `blocking`, and `always_block` overrides. |
 | `guard` | `blocking` | `"warn"` (default) or `"strict"`. In strict mode every check marked blocking can fail the run. |
-| `impact` | `profile` | `plain`, `django`, or `fastapi`; selects route extraction plus default globs. |
+| `impact` | `profile` | `generic`, `django`, or `fastapi`; selects route extraction plus default globs. |
 | `impact` | `urls_globs` / `template_globs` / `frontend_globs` | Glob patterns for route files, Django templates, and frontend sources. |
 | `impact` | `cache_file` | Path of the symbol cache (relative to the repo root). |
 | `impact` | `fast_mode`, `threads` | Reserved defaults from `init`; fast mode is currently selected with the `impact --fast` flag. |
@@ -188,9 +208,11 @@ External checks run `command` (each `{file}` placeholder is replaced with the fi
 
 ### Profiles
 
-- `plain`: no route or cross-layer globs; impact analysis reports only Python references.
+- `generic`: no route or cross-layer globs; impact analysis reports only Python references.
+- `python`: same impact globs as `generic`; guard checks append `ruff` and `ruff-format`.
 - `django`: route files `**/urls.py`, templates `**/templates/**/*.html`, frontend `**/src/**/*.ts` and `**/app/**/*.js`; guard checks append `ruff` and `ruff-format`.
 - `fastapi`: routes extracted from `**/*.py`, same frontend globs; guard checks append `ruff` and `ruff-format`.
+- `frontend`: template globs `**/*.html` and frontend globs `**/src/**/*.ts` and `**/app/**/*.js`; guard checks append `eslint` and `prettier`.
 
 ### Blocking behavior
 
@@ -284,7 +306,7 @@ All checks are incremental: file-scoped checks run on files in the change-set, a
 
 ## Requirements
 
-- Python 3.6 or newer.
+- Python 3.8 or newer.
 - Standard library only at runtime; no third-party dependencies.
 - The `git` CLI on `PATH`.
 - Optional: `ruff`, `eslint`, and `prettier` for their respective checks (missing tools degrade to warnings).

{diffimpactscout-0.1.0 → diffimpactscout-0.2.0}/src/diffimpactscout.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ src/diffimpactscout/__main__.py
 src/diffimpactscout/base.py
 src/diffimpactscout/cli.py
 src/diffimpactscout/config.py
+src/diffimpactscout/detect.py
 src/diffimpactscout/env.py
 src/diffimpactscout/gitrun.py
 src/diffimpactscout/guard.py
@@ -34,5 +35,7 @@ src/diffimpactscout/impact/reporter.py
 src/diffimpactscout/impact/route_linker.py
 src/diffimpactscout/profiles/django.json
 src/diffimpactscout/profiles/fastapi.json
-src/diffimpactscout/profiles/plain.json
+src/diffimpactscout/profiles/frontend.json
+src/diffimpactscout/profiles/generic.json
+src/diffimpactscout/profiles/python.json
 tests/test_fixture_smoke.py