squick 1.0.1__py3-none-win_amd64.whl

squick/__init__.py

@@ -0,0 +1,79 @@
+# Copyright 2026 Horizon LLC
+# SPDX-License-Identifier: Apache-2.0
+"""Squick CLI wrapper.
+
+Bundles a platform-specific ``squick`` binary inside the wheel and exposes
+it both as a ``squick`` console script and a thin Python API. The wheel
+is platform-specific: ``pip`` picks the right one for the host.
+"""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+from typing import Iterable
+
+__all__ = ["main", "scan", "binary_path", "BinaryNotFoundError"]
+
+_BINARY_NAME = "squick.exe" if sys.platform == "win32" else "squick"
+
+
+class BinaryNotFoundError(RuntimeError):
+    """Raised when the bundled squick binary cannot be located."""
+
+
+def binary_path() -> str:
+    """Return the absolute path to the bundled squick binary."""
+
+    pkg_dir = Path(__file__).resolve().parent
+    candidate = pkg_dir / "_binary" / _BINARY_NAME
+    if candidate.is_file():
+        return str(candidate)
+    override = os.environ.get("SQUICK_BINARY")
+    if override and Path(override).is_file():
+        return override
+    raise BinaryNotFoundError(
+        f"squick binary not found at {candidate}. "
+        "This usually indicates a broken installation; reinstall the package "
+        "or set SQUICK_BINARY to point at a valid squick executable."
+    )
+
+
+def main() -> None:
+    """Console-script entrypoint. Execs the binary with the caller's argv."""
+
+    try:
+        binary = binary_path()
+    except BinaryNotFoundError as exc:
+        print(f"squick: {exc}", file=sys.stderr)
+        sys.exit(1)
+    completed = subprocess.run([binary, *sys.argv[1:]], check=False)
+    sys.exit(completed.returncode)
+
+
+def scan(
+    root: str | os.PathLike[str] = ".",
+    *,
+    extra_args: Iterable[str] | None = None,
+    capture: bool = False,
+) -> str:
+    """Run ``squick scan`` against ``root`` and return the context markdown.
+
+    By default the binary is invoked in pass-through mode so it writes
+    ``.squick/context.md`` next to the project; the returned string is
+    the contents of that file. Pass ``capture=True`` to return what the
+    binary prints to stdout instead (useful when overriding ``--out -``).
+    """
+
+    binary = binary_path()
+    args: list[str] = [binary, "scan", str(root)]
+    if extra_args:
+        args.extend(extra_args)
+    if capture:
+        result = subprocess.run(args, check=True, capture_output=True, text=True)
+        return result.stdout
+    subprocess.run(args, check=True)
+    context_md = Path(root) / ".squick" / "context.md"
+    return context_md.read_text(encoding="utf-8") if context_md.is_file() else ""

squick/__main__.py

@@ -0,0 +1,7 @@
+# Copyright 2026 Horizon LLC
+# SPDX-License-Identifier: Apache-2.0
+
+from . import main
+
+if __name__ == "__main__":
+    main()

squick/_binary/dictionaries/components/html-semantic.yaml

@@ -0,0 +1,12 @@
+name: components/html-semantic
+description: HTML5 semantic tags whose presence implies a UI region.
+entries:
+  - { pattern: "nav",     match: component, tag: navigation, confidence: high }
+  - { pattern: "header",  match: component, tag: page-header, confidence: high }
+  - { pattern: "footer",  match: component, tag: page-footer, confidence: high }
+  - { pattern: "main",    match: component, tag: main-content, confidence: high }
+  - { pattern: "aside",   match: component, tag: sidebar, confidence: high }
+  - { pattern: "article", match: component, tag: article-region, confidence: high }
+  - { pattern: "section", match: component, tag: section-region, confidence: medium }
+  - { pattern: "form",    match: component, tag: form-region, confidence: high }
+  - { pattern: "dialog",  match: component, tag: dialog-region, confidence: high }

squick/_binary/dictionaries/components/ui-patterns.yaml

@@ -0,0 +1,25 @@
+name: components/ui-patterns
+description: Conventional UI component names. Match against component or filename.
+entries:
+  - { pattern: "navbar",        kind: glob, match: component, tag: navigation,    confidence: high }
+  - { pattern: "*navbar*",      kind: glob, match: component, tag: navigation,    confidence: high }
+  - { pattern: "*sidebar*",     kind: glob, match: component, tag: sidebar,       confidence: high }
+  - { pattern: "*header*",      kind: glob, match: component, tag: page-header,   confidence: medium }
+  - { pattern: "*footer*",      kind: glob, match: component, tag: page-footer,   confidence: medium }
+  - { pattern: "*hero*",        kind: glob, match: component, tag: hero-section,  confidence: high }
+  - { pattern: "*modal*",       kind: glob, match: component, tag: modal,         confidence: high }
+  - { pattern: "*dialog*",      kind: glob, match: component, tag: dialog,        confidence: high }
+  - { pattern: "*dropdown*",    kind: glob, match: component, tag: dropdown,      confidence: high }
+  - { pattern: "*accordion*",   kind: glob, match: component, tag: accordion,     confidence: high }
+  - { pattern: "*breadcrumb*",  kind: glob, match: component, tag: breadcrumb,    confidence: high }
+  - { pattern: "*pagination*",  kind: glob, match: component, tag: pagination,    confidence: high }
+  - { pattern: "*tabs*",        kind: glob, match: component, tag: tabs,          confidence: medium }
+  - { pattern: "*toast*",       kind: glob, match: component, tag: toast,         confidence: high }
+  - { pattern: "*tooltip*",     kind: glob, match: component, tag: tooltip,       confidence: high }
+  - { pattern: "*card*",        kind: glob, match: component, tag: card,          confidence: medium }
+  - { pattern: "*button*",      kind: glob, match: component, tag: button,        confidence: medium }
+  - { pattern: "*spinner*",     kind: glob, match: component, tag: spinner,       confidence: high }
+  - { pattern: "*loader*",      kind: glob, match: component, tag: spinner,       confidence: medium }
+  - { pattern: "*contactform*", kind: glob, match: component, tag: contact-form,  confidence: high }
+  - { pattern: "*loginform*",   kind: glob, match: component, tag: login-form,    confidence: high }
+  - { pattern: "*signupform*",  kind: glob, match: component, tag: signup-form,   confidence: high }

squick/_binary/dictionaries/files/node.yaml

@@ -0,0 +1,21 @@
+name: files/node
+description: Node.js / TypeScript file roles signalled by canonical filenames.
+entries:
+  - { pattern: "index.js",     match: filename, tag: entrypoint,    confidence: high }
+  - { pattern: "index.ts",     match: filename, tag: entrypoint,    confidence: high }
+  - { pattern: "index.tsx",    match: filename, tag: entrypoint,    confidence: medium }
+  - { pattern: "main.js",      match: filename, tag: entrypoint,    confidence: high }
+  - { pattern: "main.ts",      match: filename, tag: entrypoint,    confidence: high }
+  - { pattern: "server.js",    match: filename, tag: server-entrypoint, confidence: high }
+  - { pattern: "server.ts",    match: filename, tag: server-entrypoint, confidence: high }
+  - { pattern: "app.js",       match: filename, tag: app-entrypoint, confidence: high }
+  - { pattern: "app.ts",       match: filename, tag: app-entrypoint, confidence: high }
+  - { pattern: "package.json", match: filename, tag: package-manifest, confidence: high }
+  - { pattern: "tsconfig.json", match: filename, tag: build-config,  confidence: high }
+  - { pattern: "*.config.js",  kind: glob, match: filename, tag: build-config, confidence: high }
+  - { pattern: "*.config.ts",  kind: glob, match: filename, tag: build-config, confidence: high }
+  - { pattern: "*.test.ts",    kind: glob, match: filename, tag: unit-test, confidence: high }
+  - { pattern: "*.test.js",    kind: glob, match: filename, tag: unit-test, confidence: high }
+  - { pattern: "*.spec.ts",    kind: glob, match: filename, tag: unit-test, confidence: high }
+  - { pattern: "*.spec.js",    kind: glob, match: filename, tag: unit-test, confidence: high }
+  - { pattern: "*.d.ts",       kind: glob, match: filename, tag: type-declaration, confidence: high }

squick/_binary/dictionaries/files/python.yaml

@@ -0,0 +1,19 @@
+name: files/python
+description: Python file roles signalled by canonical filenames.
+entries:
+  - { pattern: "main.py",      match: filename, tag: entrypoint,    confidence: high, note: "Conventional script entry point." }
+  - { pattern: "__main__.py",  match: filename, tag: entrypoint,    confidence: high }
+  - { pattern: "__init__.py",  match: filename, tag: package-init,  confidence: high }
+  - { pattern: "setup.py",     match: filename, tag: build-config,  confidence: high }
+  - { pattern: "pyproject.toml", match: filename, tag: build-config, confidence: high }
+  - { pattern: "conftest.py",  match: filename, tag: test-config,   confidence: high }
+  - { pattern: "manage.py",    match: filename, tag: django-cli,    confidence: high }
+  - { pattern: "asgi.py",      match: filename, tag: asgi-entrypoint, confidence: high }
+  - { pattern: "wsgi.py",      match: filename, tag: wsgi-entrypoint, confidence: high }
+  - { pattern: "models.py",    match: filename, tag: data-models,   confidence: high }
+  - { pattern: "views.py",     match: filename, tag: views-handlers, confidence: high }
+  - { pattern: "urls.py",      match: filename, tag: url-routing,   confidence: high }
+  - { pattern: "admin.py",     match: filename, tag: admin-config,  confidence: high }
+  - { pattern: "serializers.py", match: filename, tag: data-serializers, confidence: high }
+  - { pattern: "schemas.py",   match: filename, tag: data-schemas,  confidence: high }
+  - { pattern: "tasks.py",     match: filename, tag: background-tasks, confidence: medium }

squick/_binary/dictionaries/frameworks/django.yaml

@@ -0,0 +1,10 @@
+name: frameworks/django
+description: Django markers — imports and conventional layout.
+entries:
+  - { pattern: "django",        kind: glob, match: import, tag: framework-django, confidence: high }
+  - { pattern: "django.*",      kind: glob, match: import, tag: framework-django, confidence: high }
+  - { pattern: "rest_framework", kind: glob, match: import, tag: framework-drf,    confidence: high }
+  - { pattern: "rest_framework.*", kind: glob, match: import, tag: framework-drf,  confidence: high }
+  - { pattern: "migrations",    match: path-segment, tag: db-migrations, confidence: high }
+  - { pattern: "templates",     match: path-segment, tag: html-templates, confidence: high }
+  - { pattern: "static",        match: path-segment, tag: static-assets, confidence: medium }

squick/_binary/dictionaries/frameworks/express.yaml

@@ -0,0 +1,22 @@
+name: frameworks/express
+description: Express.js and Koa conventions.
+entries:
+  - { pattern: "express",         match: import, tag: framework-express, confidence: high }
+  - { pattern: "@express/*",      kind: glob, match: import, tag: framework-express, confidence: high }
+  - { pattern: "koa",             match: import, tag: framework-koa, confidence: high }
+  - { pattern: "@koa/*",          kind: glob, match: import, tag: framework-koa, confidence: high }
+  - { pattern: "fastify",         match: import, tag: framework-fastify, confidence: high }
+  - { pattern: "@fastify/*",      kind: glob, match: import, tag: framework-fastify, confidence: high }
+  - { pattern: "hapi",            match: import, tag: framework-hapi, confidence: high }
+  - { pattern: "@hapi/*",         kind: glob, match: import, tag: framework-hapi, confidence: high }
+  - { pattern: "@nestjs/*",       kind: glob, match: import, tag: framework-nestjs, confidence: high }
+
+  - { pattern: "routes",          match: path-segment, tag: api-routes, confidence: medium }
+  - { pattern: "middleware",      match: path-segment, tag: middleware-layer, confidence: high }
+  - { pattern: "middlewares",     match: path-segment, tag: middleware-layer, confidence: high }
+  - { pattern: "controllers",     match: path-segment, tag: controllers, confidence: high }
+
+  - { pattern: "server.js",       match: filename, tag: server-entrypoint, confidence: high }
+  - { pattern: "server.ts",       match: filename, tag: server-entrypoint, confidence: high }
+  - { pattern: "app.module.ts",   match: filename, tag: nestjs-root-module, confidence: high }
+  - { pattern: "main.ts",         match: filename, tag: nestjs-bootstrap, confidence: medium, note: "NestJS bootstrap file." }

squick/_binary/dictionaries/frameworks/fastapi.yaml

@@ -0,0 +1,15 @@
+name: frameworks/fastapi
+description: FastAPI conventions and entry points.
+entries:
+  - { pattern: "fastapi",        match: import, tag: framework-fastapi, confidence: high }
+  - { pattern: "fastapi.*",      kind: glob, match: import, tag: framework-fastapi, confidence: high }
+  - { pattern: "starlette",      match: import, tag: framework-starlette, confidence: high }
+  - { pattern: "starlette.*",    kind: glob, match: import, tag: framework-starlette, confidence: high }
+
+  - { pattern: "routers",        match: path-segment, tag: fastapi-routers, confidence: high }
+  - { pattern: "dependencies",   match: path-segment, tag: fastapi-dependencies, confidence: medium }
+
+  - { pattern: "main.py",        match: filename, tag: fastapi-entrypoint, confidence: medium, note: "Conventional FastAPI app entrypoint." }
+  - { pattern: "app.py",         match: filename, tag: fastapi-entrypoint, confidence: medium }
+  - { pattern: "deps.py",        match: filename, tag: fastapi-dependencies, confidence: medium }
+  - { pattern: "schemas.py",     match: filename, tag: fastapi-pydantic-schemas, confidence: medium }

squick/_binary/dictionaries/frameworks/flask.yaml

@@ -0,0 +1,13 @@
+name: frameworks/flask
+description: Flask conventions and blueprint layout.
+entries:
+  - { pattern: "flask",           match: import, tag: framework-flask, confidence: high }
+  - { pattern: "flask.*",         kind: glob, match: import, tag: framework-flask, confidence: high }
+  - { pattern: "flask_*",         kind: glob, match: import, tag: framework-flask-extension, confidence: high }
+
+  - { pattern: "blueprints",      match: path-segment, tag: flask-blueprints, confidence: high }
+
+  - { pattern: "app.py",          match: filename, tag: flask-app, confidence: medium }
+  - { pattern: "wsgi.py",         match: filename, tag: wsgi-entrypoint, confidence: high }
+  - { pattern: "routes.py",       match: filename, tag: flask-routes, confidence: medium }
+  - { pattern: "extensions.py",   match: filename, tag: flask-extensions, confidence: medium }

squick/_binary/dictionaries/frameworks/nextjs.yaml

@@ -0,0 +1,42 @@
+name: frameworks/nextjs
+description: Next.js App Router and Pages Router conventions.
+entries:
+  - { pattern: "next",            match: import, tag: framework-nextjs, confidence: high }
+  - { pattern: "next/*",          kind: glob, match: import, tag: framework-nextjs, confidence: high }
+  - { pattern: "next-intl",       match: import, tag: nextjs-i18n, confidence: high }
+  - { pattern: "next-intl/*",     kind: glob, match: import, tag: nextjs-i18n, confidence: high }
+
+  - { pattern: "app",             match: path-segment, tag: nextjs-app-router, confidence: high }
+  - { pattern: "pages",           match: path-segment, tag: nextjs-pages-router, confidence: medium }
+
+  - { pattern: "page.tsx",        match: filename, tag: nextjs-route-page,    confidence: high, note: "App Router page component." }
+  - { pattern: "page.jsx",        match: filename, tag: nextjs-route-page,    confidence: high }
+  - { pattern: "page.ts",         match: filename, tag: nextjs-route-page,    confidence: high }
+  - { pattern: "page.js",         match: filename, tag: nextjs-route-page,    confidence: high }
+  - { pattern: "layout.tsx",      match: filename, tag: nextjs-layout,        confidence: high }
+  - { pattern: "layout.jsx",      match: filename, tag: nextjs-layout,        confidence: high }
+  - { pattern: "layout.ts",       match: filename, tag: nextjs-layout,        confidence: high }
+  - { pattern: "layout.js",       match: filename, tag: nextjs-layout,        confidence: high }
+  - { pattern: "loading.tsx",     match: filename, tag: nextjs-loading-ui,    confidence: high }
+  - { pattern: "loading.jsx",     match: filename, tag: nextjs-loading-ui,    confidence: high }
+  - { pattern: "error.tsx",       match: filename, tag: nextjs-error-boundary, confidence: high }
+  - { pattern: "error.jsx",       match: filename, tag: nextjs-error-boundary, confidence: high }
+  - { pattern: "not-found.tsx",   match: filename, tag: nextjs-not-found,     confidence: high }
+  - { pattern: "not-found.jsx",   match: filename, tag: nextjs-not-found,     confidence: high }
+  - { pattern: "route.ts",        match: filename, tag: nextjs-route-handler, confidence: high, note: "App Router API route handler." }
+  - { pattern: "route.js",        match: filename, tag: nextjs-route-handler, confidence: high }
+  - { pattern: "middleware.ts",   match: filename, tag: nextjs-middleware,    confidence: high }
+  - { pattern: "middleware.js",   match: filename, tag: nextjs-middleware,    confidence: high }
+  - { pattern: "next.config.ts",  match: filename, tag: nextjs-config,        confidence: high }
+  - { pattern: "next.config.js",  match: filename, tag: nextjs-config,        confidence: high }
+  - { pattern: "next.config.mjs", match: filename, tag: nextjs-config,        confidence: high }
+
+  - { pattern: "^GET$",           kind: regex, match: symbol-name, tag: http-handler-get,    confidence: high }
+  - { pattern: "^POST$",          kind: regex, match: symbol-name, tag: http-handler-post,   confidence: high }
+  - { pattern: "^PUT$",           kind: regex, match: symbol-name, tag: http-handler-put,    confidence: high }
+  - { pattern: "^DELETE$",        kind: regex, match: symbol-name, tag: http-handler-delete, confidence: high }
+  - { pattern: "^PATCH$",         kind: regex, match: symbol-name, tag: http-handler-patch,  confidence: high }
+  - { pattern: "^HEAD$",          kind: regex, match: symbol-name, tag: http-handler-head,   confidence: high }
+  - { pattern: "^OPTIONS$",       kind: regex, match: symbol-name, tag: http-handler-options, confidence: high }
+  - { pattern: "^generateMetadata$", kind: regex, match: symbol-name, tag: nextjs-metadata, confidence: high }
+  - { pattern: "^generateStaticParams$", kind: regex, match: symbol-name, tag: nextjs-static-params, confidence: high }

squick/_binary/dictionaries/frameworks/payload.yaml

@@ -0,0 +1,14 @@
+name: frameworks/payload
+description: Payload CMS conventions.
+entries:
+  - { pattern: "payload",              match: import, tag: framework-payload, confidence: high }
+  - { pattern: "@payloadcms/*",        kind: glob, match: import, tag: framework-payload, confidence: high }
+
+  - { pattern: "payload.config.ts",    match: filename, tag: payload-config, confidence: high }
+  - { pattern: "payload.config.js",    match: filename, tag: payload-config, confidence: high }
+  - { pattern: "payload-types.ts",     match: filename, tag: payload-generated-types, confidence: high }
+
+  - { pattern: "collections",          match: path-segment, tag: payload-collections, confidence: high }
+  - { pattern: "globals",              match: path-segment, tag: payload-globals, confidence: medium }
+  - { pattern: "access",               match: path-segment, tag: payload-access-control, confidence: medium }
+  - { pattern: "fields",               match: path-segment, tag: payload-fields, confidence: medium }

squick/_binary/dictionaries/frameworks/react.yaml

@@ -0,0 +1,11 @@
+name: frameworks/react
+description: React markers — hooks, HOCs, JSX-based identifiers.
+entries:
+  - { pattern: "react",        match: import,      tag: framework-react,  confidence: high }
+  - { pattern: "react-dom",    match: import,      tag: framework-react,  confidence: high }
+  - { pattern: "^use[A-Z][A-Za-z0-9]*$", kind: regex, match: symbol-name, tag: react-hook, confidence: high, note: "Custom hook naming convention." }
+  - { pattern: "^with[A-Z][A-Za-z0-9]*$", kind: regex, match: symbol-name, tag: react-hoc,  confidence: high, note: "Higher-order component convention." }
+  - { pattern: "components",   match: path-segment, tag: ui-components,   confidence: high }
+  - { pattern: "hooks",        match: path-segment, tag: react-hooks,     confidence: high }
+  - { pattern: "pages",        match: path-segment, tag: route-pages,     confidence: high }
+  - { pattern: "app",          match: path-segment, tag: nextjs-app-router, confidence: medium }

squick/_binary/dictionaries/frameworks/sanity.yaml

@@ -0,0 +1,16 @@
+name: frameworks/sanity
+description: Sanity headless CMS conventions.
+entries:
+  - { pattern: "@sanity/client",       match: import, tag: framework-sanity, confidence: high }
+  - { pattern: "@sanity/*",            kind: glob, match: import, tag: framework-sanity, confidence: high }
+  - { pattern: "sanity",               match: import, tag: framework-sanity, confidence: high }
+  - { pattern: "next-sanity",          match: import, tag: framework-sanity, confidence: high }
+
+  - { pattern: "sanity.config.ts",     match: filename, tag: sanity-config, confidence: high }
+  - { pattern: "sanity.config.js",     match: filename, tag: sanity-config, confidence: high }
+  - { pattern: "sanity.cli.ts",        match: filename, tag: sanity-cli-config, confidence: high }
+  - { pattern: "sanity.cli.js",        match: filename, tag: sanity-cli-config, confidence: high }
+
+  - { pattern: "schemas",              match: path-segment, tag: sanity-schemas, confidence: medium }
+  - { pattern: "schemaTypes",          match: path-segment, tag: sanity-schemas, confidence: high }
+  - { pattern: "studio",               match: path-segment, tag: sanity-studio, confidence: medium }

squick/_binary/dictionaries/frameworks/strapi.yaml

@@ -0,0 +1,29 @@
+name: frameworks/strapi
+description: Strapi headless CMS conventions.
+entries:
+  - { pattern: "@strapi/strapi",     match: import, tag: framework-strapi, confidence: high }
+  - { pattern: "@strapi/*",          kind: glob, match: import, tag: framework-strapi, confidence: high }
+  - { pattern: "strapi",             match: import, tag: framework-strapi, confidence: high }
+
+  - { pattern: "controllers",        match: path-segment, tag: strapi-controllers, confidence: high }
+  - { pattern: "routes",             match: path-segment, tag: strapi-routes, confidence: high }
+  - { pattern: "services",           match: path-segment, tag: strapi-services, confidence: high }
+  - { pattern: "content-types",      match: path-segment, tag: strapi-content-types, confidence: high }
+  - { pattern: "policies",           match: path-segment, tag: strapi-policies, confidence: high }
+  - { pattern: "middlewares",        match: path-segment, tag: strapi-middlewares, confidence: high }
+
+  - { pattern: "lifecycles.js",      match: filename, tag: strapi-lifecycle-hooks, confidence: high, note: "Strapi entity lifecycle callbacks." }
+  - { pattern: "lifecycles.ts",      match: filename, tag: strapi-lifecycle-hooks, confidence: high }
+  - { pattern: "schema.json",        match: filename, tag: strapi-content-schema, confidence: high, note: "Strapi content-type schema." }
+  - { pattern: "bootstrap.js",       match: filename, tag: strapi-bootstrap, confidence: medium }
+  - { pattern: "register.js",        match: filename, tag: strapi-register-hook, confidence: medium }
+  - { pattern: "destroy.js",         match: filename, tag: strapi-destroy-hook, confidence: medium }
+
+  - { pattern: "^beforeCreate$",     kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^beforeUpdate$",     kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^beforeDelete$",     kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^afterCreate$",      kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^afterUpdate$",      kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^afterDelete$",      kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^beforeFind.*$",     kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }
+  - { pattern: "^afterFind.*$",      kind: regex, match: symbol-name, tag: lifecycle-hook, confidence: high }

squick/_binary/dictionaries/frameworks/wordpress.yaml

@@ -0,0 +1,20 @@
+name: frameworks/wordpress
+description: WordPress theme and plugin file roles.
+entries:
+  - { pattern: "wp-config.php",       match: filename, tag: wordpress-config, confidence: high }
+  - { pattern: "functions.php",       match: filename, tag: wordpress-theme-bootstrap, confidence: high }
+  - { pattern: "style.css",           match: filename, tag: wordpress-theme-manifest, confidence: medium, note: "Header comment declares theme metadata." }
+  - { pattern: "index.php",           match: filename, tag: wordpress-template, confidence: medium }
+  - { pattern: "header.php",          match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "footer.php",          match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "sidebar.php",         match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "single.php",          match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "archive.php",         match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "page.php",            match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "comments.php",        match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "search.php",          match: filename, tag: wordpress-template, confidence: high }
+  - { pattern: "404.php",             match: filename, tag: wordpress-template, confidence: high }
+
+  - { pattern: "wp-content",          match: path-segment, tag: wordpress-content-root, confidence: high }
+  - { pattern: "plugins",             match: path-segment, tag: wordpress-plugins, confidence: medium }
+  - { pattern: "themes",              match: path-segment, tag: wordpress-themes, confidence: medium }

squick/_binary/dictionaries/naming/python.yaml

@@ -0,0 +1,51 @@
+name: naming/python
+description: Python snake_case naming conventions and dunder methods.
+entries:
+  - { pattern: "^get_.*",       kind: regex, match: symbol-name, tag: getter,        confidence: high }
+  - { pattern: "^set_.*",       kind: regex, match: symbol-name, tag: setter,        confidence: high }
+  - { pattern: "^fetch_.*",     kind: regex, match: symbol-name, tag: fetcher,       confidence: high }
+  - { pattern: "^load_.*",      kind: regex, match: symbol-name, tag: loader,        confidence: high }
+  - { pattern: "^save_.*",      kind: regex, match: symbol-name, tag: saver,         confidence: high }
+  - { pattern: "^delete_.*",    kind: regex, match: symbol-name, tag: deleter,       confidence: high }
+  - { pattern: "^remove_.*",    kind: regex, match: symbol-name, tag: deleter,       confidence: high }
+  - { pattern: "^create_.*",    kind: regex, match: symbol-name, tag: creator,       confidence: high }
+  - { pattern: "^update_.*",    kind: regex, match: symbol-name, tag: updater,       confidence: high }
+  - { pattern: "^validate_.*",  kind: regex, match: symbol-name, tag: validator,     confidence: high }
+  - { pattern: "^parse_.*",     kind: regex, match: symbol-name, tag: parser,        confidence: high }
+  - { pattern: "^format_.*",    kind: regex, match: symbol-name, tag: formatter,     confidence: high }
+  - { pattern: "^render_.*",    kind: regex, match: symbol-name, tag: renderer,      confidence: high }
+  - { pattern: "^handle_.*",    kind: regex, match: symbol-name, tag: handler,       confidence: high }
+  - { pattern: "^process_.*",   kind: regex, match: symbol-name, tag: processor,     confidence: high }
+  - { pattern: "^on_.*",        kind: regex, match: symbol-name, tag: event-handler, confidence: medium }
+  - { pattern: "^is_.*",        kind: regex, match: symbol-name, tag: predicate,     confidence: high }
+  - { pattern: "^has_.*",       kind: regex, match: symbol-name, tag: predicate,     confidence: high }
+  - { pattern: "^can_.*",       kind: regex, match: symbol-name, tag: predicate,     confidence: high }
+  - { pattern: "^should_.*",    kind: regex, match: symbol-name, tag: predicate,     confidence: high }
+
+  - { pattern: ".*_view$",       kind: regex, match: symbol-name, tag: view-handler, confidence: high, note: "Django/Flask view function." }
+  - { pattern: ".*_handler$",    kind: regex, match: symbol-name, tag: handler,      confidence: high }
+  - { pattern: ".*_service$",    kind: regex, match: symbol-name, tag: service,      confidence: high }
+  - { pattern: ".*_repository$", kind: regex, match: symbol-name, tag: repository,   confidence: high }
+  - { pattern: ".*_factory$",    kind: regex, match: symbol-name, tag: factory,      confidence: high }
+  - { pattern: ".*_validator$",  kind: regex, match: symbol-name, tag: validator,    confidence: high }
+  - { pattern: ".*_serializer$", kind: regex, match: symbol-name, tag: serializer,   confidence: high }
+  - { pattern: ".*_form$",       kind: regex, match: symbol-name, tag: form,         confidence: high }
+  - { pattern: ".*_filter$",     kind: regex, match: symbol-name, tag: filter,       confidence: high }
+  - { pattern: ".*_middleware$", kind: regex, match: symbol-name, tag: middleware,   confidence: high }
+  - { pattern: ".*_task$",       kind: regex, match: symbol-name, tag: task,         confidence: high, note: "Celery or background task." }
+  - { pattern: ".*_command$",    kind: regex, match: symbol-name, tag: command,      confidence: medium }
+
+  - { pattern: "__init__",   match: symbol-name, tag: constructor,     confidence: high }
+  - { pattern: "__new__",    match: symbol-name, tag: constructor,     confidence: high }
+  - { pattern: "__str__",    match: symbol-name, tag: repr-method,     confidence: high }
+  - { pattern: "__repr__",   match: symbol-name, tag: repr-method,     confidence: high }
+  - { pattern: "__eq__",     match: symbol-name, tag: equality-method, confidence: high }
+  - { pattern: "__hash__",   match: symbol-name, tag: hash-method,     confidence: high }
+  - { pattern: "__call__",   match: symbol-name, tag: callable-method, confidence: high }
+  - { pattern: "__enter__",  match: symbol-name, tag: context-manager, confidence: high }
+  - { pattern: "__exit__",   match: symbol-name, tag: context-manager, confidence: high }
+  - { pattern: "__iter__",   match: symbol-name, tag: iterable,        confidence: high }
+  - { pattern: "__next__",   match: symbol-name, tag: iterable,        confidence: high }
+  - { pattern: "__len__",    match: symbol-name, tag: sized,           confidence: high }
+  - { pattern: "__getitem__", match: symbol-name, tag: indexable,      confidence: high }
+  - { pattern: "__setitem__", match: symbol-name, tag: indexable,      confidence: high }

squick/_binary/dictionaries/naming/suffixes.yaml

@@ -0,0 +1,17 @@
+name: naming/suffixes
+description: Class/identifier suffixes that signal architectural role.
+entries:
+  - { pattern: ".*Handler$",    kind: regex, match: symbol-name, tag: handler,    confidence: high }
+  - { pattern: ".*Controller$", kind: regex, match: symbol-name, tag: controller, confidence: high }
+  - { pattern: ".*Service$",    kind: regex, match: symbol-name, tag: service,    confidence: high }
+  - { pattern: ".*Repository$", kind: regex, match: symbol-name, tag: repository, confidence: high }
+  - { pattern: ".*Factory$",    kind: regex, match: symbol-name, tag: factory,    confidence: high }
+  - { pattern: ".*Provider$",   kind: regex, match: symbol-name, tag: provider,   confidence: high }
+  - { pattern: ".*Manager$",    kind: regex, match: symbol-name, tag: manager,    confidence: high }
+  - { pattern: ".*Builder$",    kind: regex, match: symbol-name, tag: builder,    confidence: high }
+  - { pattern: ".*Adapter$",    kind: regex, match: symbol-name, tag: adapter,    confidence: high }
+  - { pattern: ".*Validator$",  kind: regex, match: symbol-name, tag: validator,  confidence: high }
+  - { pattern: ".*Serializer$", kind: regex, match: symbol-name, tag: serializer, confidence: high }
+  - { pattern: ".*Mapper$",     kind: regex, match: symbol-name, tag: mapper,     confidence: high }
+  - { pattern: ".*DTO$",        kind: regex, match: symbol-name, tag: dto,        confidence: high }
+  - { pattern: ".*Model$",      kind: regex, match: symbol-name, tag: model,      confidence: medium }

squick/_binary/dictionaries/naming/verbs.yaml

@@ -0,0 +1,20 @@
+name: naming/verbs
+description: Common function-name verbs that signal intent.
+entries:
+  - { pattern: "^get[A-Z].*",      kind: regex, match: symbol-name, tag: getter,    confidence: high }
+  - { pattern: "^set[A-Z].*",      kind: regex, match: symbol-name, tag: setter,    confidence: high }
+  - { pattern: "^fetch[A-Z].*",    kind: regex, match: symbol-name, tag: fetcher,   confidence: high }
+  - { pattern: "^load[A-Z].*",     kind: regex, match: symbol-name, tag: loader,    confidence: high }
+  - { pattern: "^save[A-Z].*",     kind: regex, match: symbol-name, tag: saver,     confidence: high }
+  - { pattern: "^delete[A-Z].*",   kind: regex, match: symbol-name, tag: deleter,   confidence: high }
+  - { pattern: "^create[A-Z].*",   kind: regex, match: symbol-name, tag: creator,   confidence: high }
+  - { pattern: "^update[A-Z].*",   kind: regex, match: symbol-name, tag: updater,   confidence: high }
+  - { pattern: "^validate[A-Z].*", kind: regex, match: symbol-name, tag: validator, confidence: high }
+  - { pattern: "^parse[A-Z].*",    kind: regex, match: symbol-name, tag: parser,    confidence: high }
+  - { pattern: "^format[A-Z].*",   kind: regex, match: symbol-name, tag: formatter, confidence: high }
+  - { pattern: "^render[A-Z].*",   kind: regex, match: symbol-name, tag: renderer,  confidence: high }
+  - { pattern: "^handle[A-Z].*",   kind: regex, match: symbol-name, tag: handler,   confidence: high }
+  - { pattern: "^on[A-Z].*",       kind: regex, match: symbol-name, tag: event-handler, confidence: medium }
+  - { pattern: "^is[A-Z].*",       kind: regex, match: symbol-name, tag: predicate, confidence: high }
+  - { pattern: "^has[A-Z].*",      kind: regex, match: symbol-name, tag: predicate, confidence: high }
+  - { pattern: "^can[A-Z].*",      kind: regex, match: symbol-name, tag: predicate, confidence: high }

squick/_binary/dictionaries/routes/web-common.yaml

@@ -0,0 +1,28 @@
+name: routes/web-common
+description: Common public-facing web routes whose meaning is conventional.
+entries:
+  - { pattern: "/",            match: route, tag: home-page,       confidence: high }
+  - { pattern: "/about",       match: route, tag: about-page,      confidence: high }
+  - { pattern: "/about-us",    match: route, tag: about-page,      confidence: high }
+  - { pattern: "/aboutus",     match: route, tag: about-page,      confidence: high }
+  - { pattern: "/contact",     match: route, tag: contact-page,    confidence: high }
+  - { pattern: "/contact-us",  match: route, tag: contact-page,    confidence: high }
+  - { pattern: "/pricing",     match: route, tag: pricing-page,    confidence: high }
+  - { pattern: "/privacy",     match: route, tag: privacy-page,    confidence: high }
+  - { pattern: "/terms",       match: route, tag: terms-page,      confidence: high }
+  - { pattern: "/login",       match: route, tag: auth-login,      confidence: high }
+  - { pattern: "/signin",      match: route, tag: auth-login,      confidence: high }
+  - { pattern: "/signup",      match: route, tag: auth-signup,     confidence: high }
+  - { pattern: "/register",    match: route, tag: auth-signup,     confidence: high }
+  - { pattern: "/logout",      match: route, tag: auth-logout,     confidence: high }
+  - { pattern: "/dashboard",   match: route, tag: dashboard-page,  confidence: high }
+  - { pattern: "/settings",    match: route, tag: settings-page,   confidence: high }
+  - { pattern: "/profile",     match: route, tag: profile-page,    confidence: high }
+  - { pattern: "/admin",       match: route, tag: admin-area,      confidence: high }
+  - { pattern: "/api",         match: route, tag: api-root,        confidence: high }
+  - { pattern: "/health",      match: route, tag: health-check,    confidence: high }
+  - { pattern: "/status",      match: route, tag: health-check,    confidence: medium }
+  - { pattern: "/cart",        match: route, tag: ecommerce-cart,  confidence: high }
+  - { pattern: "/checkout",    match: route, tag: ecommerce-checkout, confidence: high }
+  - { pattern: "/orders",      match: route, tag: ecommerce-orders, confidence: high }
+  - { pattern: "/products",    match: route, tag: ecommerce-products, confidence: high }

squick-1.0.1.dist-info/METADATA

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: squick
+Version: 1.0.1
+Summary: Pre-computed LLM context for AI coding agents.
+Author: Horizon LLC
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/pwnaxe/squick
+Project-URL: Repository, https://github.com/pwnaxe/squick
+Project-URL: Issues, https://github.com/pwnaxe/squick/issues
+Keywords: mcp,ai,llm,context,scanner,ast,tree-sitter
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Pre-processors
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# squick (Python)
+
+Pre-computed, LLM-targeted code context for AI coding agents.
+
+This PyPI package ships the right platform-specific binary inside the
+wheel and exposes it both as a `squick` console script and a small
+Python API. Installation is platform-aware: `pip` picks the wheel for
+your OS and architecture automatically.
+
+## Install
+
+```bash
+pip install squick
+```
+
+## Use from the shell
+
+```bash
+squick scan ./your-project       # one-shot scan
+squick watch ./your-project      # re-scan on file save
+squick mcp                       # start an MCP server on stdio
+python -m squick scan .          # equivalent to the above
+```
+
+## Use from Python
+
+```python
+import squick
+
+# Run a scan and return the generated context.md as a string.
+context = squick.scan("./your-project")
+print(context)
+
+# Locate the bundled binary, e.g. to spawn the MCP server manually.
+print(squick.binary_path())
+```
+
+## Supported platforms
+
+| OS      | Architecture | Wheel tag                  |
+| ------- | ------------ | -------------------------- |
+| Linux   | x86_64       | `manylinux2014_x86_64`     |
+| Linux   | aarch64      | `manylinux2014_aarch64`    |
+| macOS   | x86_64       | `macosx_10_12_x86_64`      |
+| macOS   | arm64        | `macosx_11_0_arm64`        |
+| Windows | x86_64       | `win_amd64`                |
+
+See the [main project README](https://github.com/pwnaxe/squick) for
+full documentation, dictionary format, and MCP client configuration.
+
+## License
+
+Apache-2.0. Copyright 2026 Horizon LLC.
+"Squick" is a trademark of Horizon LLC.

squick-1.0.1.dist-info/RECORD

@@ -0,0 +1,26 @@
+squick/__init__.py,sha256=2NwfozOqyEtxeNphWAHWcjekO7LCG432FIPScvkq9Wc,2583
+squick/__main__.py,sha256=MlY2KONOPYQ8gC5qhN2DCTIghInTrQWP3VAtDPE7xG4,126
+squick/_binary/squick.exe,sha256=vkvti2o3eSQDu4RGyMWBLGVwC99272m05NOp8G0SZcg,9637376
+squick/_binary/dictionaries/components/html-semantic.yaml,sha256=6jpfLu92ShZKDbjqvNSULLZIr23Qq1_kHQ5pNo-ElV0,856
+squick/_binary/dictionaries/components/ui-patterns.yaml,sha256=85c0aC_nf43aThy1wbT04zZdWXgfm_9teVe7qjjfmYk,2380
+squick/_binary/dictionaries/files/node.yaml,sha256=dnSCxmB9JOpRKEASrpw5Wf28aLh2DM3CBXMndZW-HOY,1777
+squick/_binary/dictionaries/files/python.yaml,sha256=Dps21X-0KsUasGz9878JzjrrZUMkG_lj-DNA0q63fdY,1562
+squick/_binary/dictionaries/frameworks/django.yaml,sha256=svGsqeZ1LQbkCK9YOxjIYb-ME9f4GLKJPv-TouweigM,793
+squick/_binary/dictionaries/frameworks/express.yaml,sha256=ADySZ-3qXNHgZPmelwMfagoQT1yxx5ald8ZIw24l7wk,1765
+squick/_binary/dictionaries/frameworks/fastapi.yaml,sha256=n2D7nfcGYqJ8jTm8DeWDpLNDOcMihX-QFepvgNnGAPM,1129
+squick/_binary/dictionaries/frameworks/flask.yaml,sha256=uBi90IwgIfBm_e_AXqzFtv3AMWLVeuE2tum7uQVtkCM,867
+squick/_binary/dictionaries/frameworks/nextjs.yaml,sha256=liXKe2LwG07V-6sef_-bN0bEbb8TTiCeW6EsIwWtG9E,3848
+squick/_binary/dictionaries/frameworks/payload.yaml,sha256=gYHcoNesygad7B3sIoyewSEieoP9hq0lO3f2tvDn6jE,1011
+squick/_binary/dictionaries/frameworks/react.yaml,sha256=1RibmTXYAyNCBoBlsGCb2m3O7hnz0U2F7sMmFsWKqfU,977
+squick/_binary/dictionaries/frameworks/sanity.yaml,sha256=6InO9t4ZPYcUVT5q6ZMc40aJGKRkVxUDnLr8I6MspIc,1184
+squick/_binary/dictionaries/frameworks/strapi.yaml,sha256=oUa4OOpfRyxzVRanDsJtZrasi3A0RVuypAQT-_r7ge0,2575
+squick/_binary/dictionaries/frameworks/wordpress.yaml,sha256=eGLUpc3V10cc0MPnLMuZXmeLkV0F7p16yw8DYMy3sTQ,1774
+squick/_binary/dictionaries/naming/python.yaml,sha256=-lT2ebwMCIivHN6PSaCSyn5PrrbudcDo7_IMZBFEXd8,4817
+squick/_binary/dictionaries/naming/suffixes.yaml,sha256=FF0Zup_AogAAIi3hKTb9Vy_trO2TktEFKLSlqt0VB4k,1535
+squick/_binary/dictionaries/naming/verbs.yaml,sha256=N8bTeCBWDiqUV2r0-15jPpG8iENwvVQr2sXtZ2dDwPc,1865
+squick/_binary/dictionaries/routes/web-common.yaml,sha256=TxcOZak2aVXhBVwTOjgS6VxmX5BiITgasuHx0q4q-9g,2296
+squick-1.0.1.dist-info/METADATA,sha256=WMy7ka54U_WZZHp5B9CPytqmk7QQsYgsIS9BmKTa9qs,2798
+squick-1.0.1.dist-info/WHEEL,sha256=QR8DNjG6Lr6bNErJWJgF4dP2dJ2N7NpY-BWly1OvcTM,97
+squick-1.0.1.dist-info/entry_points.txt,sha256=CfBR4ZYgixzhad5h2N8mLCDkntpcqO8Wy2Vo2wlGxZM,39
+squick-1.0.1.dist-info/top_level.txt,sha256=Ax_HMSliBbTtH7YelPlK6iQnEZhZOyOkH41pZ1QbF2c,7
+squick-1.0.1.dist-info/RECORD,,

squick-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-win_amd64
+

squick-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+squick = squick:main

squick-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+squick