[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASN7R5CB4C7YVGA0Z5F1MX":3,"skill-same:01M7ASN7R5CB4C7YVGA0Z5F1MX":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ASN7R5CB4C7YVGA0Z5F1MX","vibey-bootstrap-primitives",null,"Use for vibey-bootstrap v2 Tier 1 always-on stdlib primitives and the v2.1\u002Fv3.0 logging transports (ten sinks). Covers configure_logging \u002F JsonLogFormatter, correlation_scope and CorrelationFilter (contextvars), masking helpers (mask_api_key\u002Fmask_bearer_token\u002Fmask_email_address\u002Fmask_secrets_in_dict), @traced tracing + bump_counter\u002Flatency_snapshot, bootstrap helpers (ensure_bootstrap, load_local_settings, refresh_setting), the error vocabulary (PipelineError\u002FUnrecoverableError\u002FTransientError, is_unrecoverable), soft_fail\u002Frun_phases, validate_message, sanitize_path_segment\u002Fconfine_to_root, compare_secrets and failclose, identity build_credential, audit, and configure_transports for console\u002Fapp_insights\u002Fsumo_logic\u002Fpanther\u002Ffile\u002Fblob\u002Fsql\u002Fnosql\u002Fadx\u002Fevent_hubs. Triggers on vibey_bootstrap structured logging, correlation IDs, DEBUG_LOGGING_ENABLED, Sumo Logic or Panther transport, FILE_LOG_PATH, or @traced.","the-vibey-project\u002Fvibey","the-vibey-project","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F329298758?v=4","01M7AJHGZ9722CTJ4JNQZVRH0Q","the vibey project","01M7AJHGZVMG2K7TGXQ6XFHVG3",5,"MIT","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fvibey-bootstrap\u002Fskills\u002Fvibey-bootstrap-primitives\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: vibey-bootstrap-primitives\ndescription: \"Use for vibey-bootstrap v2 Tier 1 always-on stdlib primitives and the v2.1\u002Fv3.0 logging transports (ten sinks). Covers configure_logging \u002F JsonLogFormatter, correlation_scope and CorrelationFilter (contextvars), masking helpers (mask_api_key\u002Fmask_bearer_token\u002Fmask_email_address\u002Fmask_secrets_in_dict), @traced tracing + bump_counter\u002Flatency_snapshot, bootstrap helpers (ensure_bootstrap, load_local_settings, refresh_setting), the error vocabulary (PipelineError\u002FUnrecoverableError\u002FTransientError, is_unrecoverable), soft_fail\u002Frun_phases, validate_message, sanitize_path_segment\u002Fconfine_to_root, compare_secrets and failclose, identity build_credential, audit, and configure_transports for console\u002Fapp_insights\u002Fsumo_logic\u002Fpanther\u002Ffile\u002Fblob\u002Fsql\u002Fnosql\u002Fadx\u002Fevent_hubs. Triggers on vibey_bootstrap structured logging, correlation IDs, DEBUG_LOGGING_ENABLED, Sumo Logic or Panther transport, FILE_LOG_PATH, or @traced.\"\n---\n\n> **vibey-bootstrap** is the library formerly published as `azure-bootstrap` (renamed in 4.0.0: package `vibey-bootstrap`, import `vibey_bootstrap`, CLI `vibey-bootstrap`; `azbootstrap` remains as a deprecated alias). Feature-tier labels below (v2 primitives, v3 modules) are historical and unchanged.\n\n# Azure Bootstrap — v2 Tier 1 Primitives & Logging Transports (v2.1 + v3.0)\n\n## 3. Python: v2 Tier 1 primitives (always-on, stdlib-only)\n\nEverything here is importable from the top-level `vibey_bootstrap` namespace (or its\nsubpackage) with **no extra installed**.\n\n### Structured logging\n\n```python\nfrom vibey_bootstrap import configure_logging, JsonLogFormatter\nfrom vibey_bootstrap.logging import (\n    ExtraFieldsFormatter, effective_log_level, env_flag, debug_logging_enabled,\n)\n\nconfigure_logging(\n    format_string=\"%(asctime)s %(levelname)s %(name)s %(message)s\",  # default\n    silence_defaults=True,        # silence noisy third-party loggers (urllib3, azure.*, …)\n    extra_noisy_loggers=(),       # add your own to silence\n)\n```\n\n`configure_logging()` is **idempotent** (it `force`-replaces handlers), installs the\n`ExtraFieldsFormatter` + a `CorrelationFilter`, and sets the root level via\n`effective_log_level()`. The level honors `LOG_LEVEL`, but **`DEBUG` requires a second\ngate**: `DEBUG_LOGGING_ENABLED` must also be truthy, else it clamps to `INFO` (defends\nagainst a stray manifest leaking DEBUG into prod). In DEBUG, an `extra={}` key that\ncollides with a reserved `LogRecord` attribute raises `LoggingExtraConflictError`.\n\n- **`JsonLogFormatter(*, ensure_ascii=False, mask_extras=True)`** — one JSON object\n  per line. Fields: `timestamp` (ISO-8601 UTC), `level`, `logger`, `message`,\n  `exception` (only with `exc_info`), plus every non-reserved `extra={}` field\n  (correlation IDs included). Secret-keyed extras are redacted via\n  `mask_secrets_in_dict`. **Never raises** — falls back to a minimal document. Use it\n  for remote ingestion (this is what the Sumo Logic transport uses).\n\n### Correlation context\n\n```python\nfrom vibey_bootstrap import correlation_scope, get_correlation_id, set_correlation_id\nfrom vibey_bootstrap.logging import CorrelationFilter\n\nwith correlation_scope(\"req-123\", user_id=\"u-456\", email_id=\"e-789\") as cid:\n    logger.info(\"processing\")   # log line auto-includes correlation_id, user_id, email_id\n```\n\n`correlation_scope(correlation_id=None, **fields)` pushes context for the `with` block\n(generates a 12-char hex id when `None`), and `CorrelationFilter` attaches every set\ncontext var as a record attribute. Built on `contextvars`, so it is **async- and\ntask-safe**. `get_correlation_id()` \u002F `set_correlation_id(value)` read\u002Fwrite outside a\nscope.\n\n### Masking & sanitization\n\n```python\nfrom vibey_bootstrap import (\n    mask_api_key, mask_bearer_token, mask_email_address,\n    mask_secrets_in_dict, safe_json_dumps, sanitize_for_log,\n)\nfrom vibey_bootstrap.logging import register_secret_keys, content_preview\n```\n\n| Function | Behavior |\n|---|---|\n| `mask_api_key(s)` | `***` if `None`\u002F\u003C4 chars, else `***{last4}` |\n| `mask_bearer_token(t)` | `Bearer ***` if it starts with `Bearer`, else `***` |\n| `mask_email_address(e)` | `***{last2-local}@{domain}` |\n| `mask_secrets_in_dict(d)` | shallow copy; redacts **truthy** values at ~20 secret-keyed names (`authorization`, `x-api-key`, `api_key`, `password`, `token`, `client_secret`, `connection_string`, …) |\n| `register_secret_keys(*names)` | extend the secret-key allowlist at runtime |\n| `sanitize_for_log(v, max_len=256)` | strip control chars → `?`, truncate |\n| `safe_json_dumps(obj)` | JSON with `default=repr`; never raises |\n| `content_preview(text, max_len=500)` | truncate a body for preview |\n\n### Tracing & counters\n\n```python\nfrom vibey_bootstrap import traced, latency_snapshot, bump_counter, counter_snapshot\n\n@traced(operation=\"reports.process\", alert_on_error=\"error\",\n        sensitive_args=(\"api_key\",), slow_threshold_seconds=2.0)\ndef process(report_id: str, api_key: str) -> dict: ...\n```\n\n`@traced` works on **sync or async** functions (auto-detected). It records latency on\nevery call (success and exception), logs entry\u002Fexit **only at DEBUG** (the hot path\nskips `inspect.signature` when DEBUG is off), masks `sensitive_args` (and anything that\n\"looks\" sensitive) in logs, and — if the `alerts` subpackage is importable — fires a\nslow-budget `WARN` and\u002For an `alert_on_error` alert. With no alerts extra it silently\ndegrades to log-only. `latency_snapshot()` returns\n`{operation: {count, errors, slow, p50, p95, p99, max, last_seen}}`. `bump_counter(name, n=1)`\nis thread-safe and never raises; `counter_snapshot()` returns a copy.\n\n### Bootstrap helpers\n\n```python\nfrom vibey_bootstrap import (\n    ensure_bootstrap, bootstrap_initialized, load_local_settings, refresh_setting,\n)\n```\n\n| Function | Behavior |\n|---|---|\n| `ensure_bootstrap()` | lazy, idempotent wrapper over `initialize_application()`; short-circuits when `USE_MOCK_BOOTSTRAP` is truthy; re-raises on failure after logging |\n| `bootstrap_initialized() -> bool` | process-local flag — wire into `\u002Fhealth\u002Fready` |\n| `load_local_settings(path=\"local.settings.json\") -> int` | load Azure-Functions-style settings; skips `_`-prefixed keys; never overwrites existing env; returns count |\n| `refresh_setting(*names)` | re-read named keys from the cached App Config repo into `os.environ`; best-effort, no-op before `initialize_application()` |\n\n### Error vocabulary\n\n```python\nfrom vibey_bootstrap import (\n    PipelineError, UnrecoverableError, TransientError,\n    InvalidMessageError, RateLimitError, NetworkError, is_unrecoverable,\n)\n```\n\n`PipelineError` is the base. `UnrecoverableError` (→ `InvalidMessageError`,\n`OversizedAttachmentError`, `MalformedAttachmentError`, `ZipBombError`,\n`UpstreamResourceMissing`) means \"dead-letter it.\" `TransientError` (→ `RateLimitError`,\n`NetworkError`, `AuthenticationError`) means \"retry\u002Fback off.\" `is_unrecoverable(exc)`\nis a single classifier the retry\u002Fsoft-fail\u002Fconsumer helpers all consult.\n\n### Resilience — soft-fail & phases\n\n```python\nfrom vibey_bootstrap import (\n    soft_fail, soft_fail_with, SoftFailResult, run_phase, run_phases, PhaseResult,\n)\n\n# Degrade gracefully with a fallback value:\nres = soft_fail_with(fetch_thumbnail, blob_id, fallback=None,\n                     operation=\"thumbnail.fetch\", counter_name=\"thumbnail.failed\")\nif res.degraded:\n    logger.warning(\"thumbnail unavailable\", extra={\"reason\": res.reason})\n\n# Context-manager form:\nwith soft_fail(operation=\"enrich\") as state:\n    record[\"extra\"] = enrich(record)\nif state[\"degraded\"]:\n    ...\n\n# Sequential pipeline that never aborts mid-way:\nresults = run_phases([(\"download\", download), (\"parse\", parse), (\"index\", index)])\n```\n\n`soft_fail_with(...)` re-raises `UnrecoverableError` by default\n(`re_raise_unrecoverable=True`) — set `False` to swallow everything in `catch`.\n`run_phase`\u002F`run_phases` **never re-raise**; each bumps `{namespace}.{name}.ok` \u002F\n`.failed` counters and returns `PhaseResult(name, ok, value, exception, elapsed_seconds)`.\n\n### Validation\n\n```python\nfrom vibey_bootstrap import validate_message, queue_message_schema, MessageSchema\n\nschema = queue_message_schema(\n    required_fields=(\"correlation_id\",),\n    path_field=\"blob_path\", path_required_prefix=\"reports\u002F\",\n)\ndata = validate_message(payload, schema)   # raises InvalidMessageError on violation\n```\n\nBuilding a schema with a `path_field` automatically adds path-traversal defense\n(forbidden substrings `..` and `:\u002F\u002F`). On failure `validate_message` bumps a counter\nand raises `InvalidMessageError` (an `UnrecoverableError` — so consumers dead-letter).\n\n### Path safety\n\n```python\nfrom vibey_bootstrap import sanitize_path_segment, confine_to_root\n\nsafe = sanitize_path_segment(user_filename)            # strips bidi\u002Fzero-width, caps 64 chars\npath = confine_to_root(raw, allowed_root=\"\u002Fdata\u002Fwork\") # raises ValueError on escape\n```\n\n`confine_to_root` canonicalizes both sides (`expanduser().resolve()`) before\ncomparison, defeating `..` traversal **and** symlink escape.\n\n### Security & fail-close\n\n```python\nfrom vibey_bootstrap import compare_secrets\nfrom vibey_bootstrap.failclose import require_env, optional_env, fail_open_env\n```\n\n- `compare_secrets(a, b) -> bool` — constant-time (`hmac.compare_digest`); `False` on\n  any `None`\u002Fempty input.\n- `require_env(name, message=None)` — return value or raise `ConfigurationError`\n  (auth-critical settings → **fail closed**).\n- `optional_env(name, default=\"\")` — stripped value or default (URLs with sane defaults).\n- `fail_open_env(name)` — value when truthy, else `None` (\"feature disabled\" semantics).\n\n### Identity & audit\n\n```python\nfrom vibey_bootstrap.identity import build_credential, credential_kind, CredentialKind\nfrom vibey_bootstrap.audit import build_audit_extra\n\ncred = build_credential()   # ClientSecret (if secret set) → WorkloadIdentity → DefaultAzureCredential\nlogger.info(\"EMAIL_AUDIT\", extra=build_audit_extra(\"send\", sender=addr, subject=subj))\n```\n\n`build_credential(*, tenant_id=None, client_id=None, client_secret=None, prefer=None,\ntoken_file_path=...)` codifies the credential preference (Workload Identity first in a\ncluster — no client secrets in pod env). `credential_kind()` previews the choice\nwithout constructing anything (handy for health probes). `build_audit_extra(operation,\n**fields)` always injects `operation` + a UTC ISO-8601 `timestamp`, masks email\u002Fsecret\nfields, and truncates long fields (`subject`, `error`, `traceback`, …).\n\n### Tier 1 environment variables\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `LOG_LEVEL` | `INFO` | base log level |\n| `DEBUG_LOGGING_ENABLED` | off | **second gate** required for DEBUG output |\n| `USE_MOCK_BOOTSTRAP` | off | short-circuit `ensure_bootstrap()` (local\u002Fdev\u002Ftests) |\n\n## 4. Python: logging transports (v2.1 + v3.0 — ten sinks)\n\nA **transport** is a named factory `Callable[[], logging.Handler | None]`. Enabling\nattaches its handler to the root logger; disabling detaches and closes it. This\ndecouples *where logs go* from *how they're formatted*.\n\n```python\nfrom vibey_bootstrap import (\n    configure_transports, register_transport,\n    enable_transport, disable_transport, list_transports,\n)\n\n# One call to wire built-ins (explicit bool wins; else env flag):\nconfigure_transports(console=True, app_insights=False, sumo_logic=True)\n\n# v3.0 — enable additional sinks in one call:\nconfigure_transports(console=True, panther=True, file=True, blob=True, sql=True,\n                     nosql=True, adx=True, event_hubs=True)\n\nlist_transports()   # {'console': {'registered': True, 'enabled': True}, ...}\n```\n\n`configure_transports()` also sets the root logger to `effective_log_level()` so\nenabled transports actually receive records. It is idempotent and re-runnable.\n\n### Built-in transports (ten total)\n\n| Name | Handler | Extra | Env flag | Default |\n|---|---|---|---|---|\n| `console` | `StreamHandler` + `ExtraFieldsFormatter` + `CorrelationFilter` | stdlib | `CONSOLE_LOGGING_ENABLED` | **on** |\n| `app_insights` | OpenTelemetry handler (delegates to v1 `TelemetryManager`) | stdlib | `APP_INSIGHTS_LOGGING_ENABLED` | off |\n| `sumo_logic` | `SumoLogicHandler` (buffered async POST) | `[sumologic]` | `SUMO_LOGIC_LOGGING_ENABLED` | off |\n| `panther` | Panther SIEM HTTP Source | `[panther]` | `PANTHER_LOGGING_ENABLED` | off |\n| `file` | Rotating local log file (`JsonLogFormatter`) | stdlib | `FILE_LOGGING_ENABLED` | off |\n| `blob` | Azure Blob Storage NDJSON | `[bloblog]` | `BLOB_LOGGING_ENABLED` | off |\n| `sql` | SQL table append | `[sqllog]` | `SQL_LOGGING_ENABLED` | off |\n| `nosql` | Mongo\u002FCosmos collection append | `[nosqllog]` | `NOSQL_LOGGING_ENABLED` | off |\n| `adx` | Azure Data Explorer ingest | `[adxlog]` | `ADX_LOGGING_ENABLED` | off |\n| `event_hubs` | Azure Event Hubs producer | `[eventhubslog]` | `EVENTHUBS_LOGGING_ENABLED` | off |\n\nTwo caveats: (1) the `console` transport installs **the same** `StreamHandler` stack\nas `configure_logging()` — enabling both produces duplicate console lines, so pick one;\n(2) if you also call `configure_logging()` (which does `basicConfig(force=True)` and\nreplaces root handlers), call it **before** `configure_transports()`, which reconciles\nagainst the live root handlers on each run. Disabling `app_insights` only detaches the\nOTel handler (the exporter is not torn down). A custom sink is one call away:\n\n```python\nregister_transport(\"my_syslog\", lambda: logging.handlers.SysLogHandler())\nenable_transport(\"my_syslog\")\n```\n\n### `SumoLogicHandler` deep-dive\n\nRequires the `[sumologic]` extra (`requests`). `make_sumo_logic_handler()` returns\n`None` (a **soft no-op**) when `SUMO_LOGIC_COLLECTOR_URL` is unset *or* when `requests`\nisn't installed — so enabling the transport without the extra never errors.\n\nBehavior: `emit()` only appends to an in-memory bounded `deque` (a daemon thread does\nthe network I\u002FO — **never blocks, never raises**). It ships **NDJSON** (via\n`JsonLogFormatter`), gzips bodies at\u002Fabove the threshold, batches by count **and**\nbyte size (Sumo's 100 KB–1 MB sweet spot), and uses a `urllib3` `Retry` adapter that\nretries `408\u002F429\u002F5xx` with backoff+jitter, **honors `Retry-After`**, and never retries\n`401`\u002Fother 4xx. Flushes on interval, on `batch_size`, and at `atexit`. Counters:\n`sumologic.transport.{posts,ok,error,throttled,dropped,records}`.\n\n```python\nimport os\nos.environ[\"SUMO_LOGIC_COLLECTOR_URL\"] = \"https:\u002F\u002Fcollectors.sumologic.com\u002Freceiver\u002Fv1\u002Fhttp\u002FXXXX\"\nos.environ[\"SUMO_LOGIC_LOGGING_ENABLED\"] = \"true\"\nconfigure_transports(sumo_logic=True)   # or rely on the env flag alone\n```\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `SUMO_LOGIC_COLLECTOR_URL` | — (required) | HTTP Source endpoint (unset → transport stays off) |\n| `SUMO_LOGIC_COLLECTOR_TOKEN` | — | `x-sumo-token` auth header |\n| `SUMO_LOGIC_SOURCE_CATEGORY` | — | `X-Sumo-Category` |\n| `SUMO_LOGIC_SOURCE_HOST` | — | `X-Sumo-Host` |\n| `SUMO_LOGIC_FIELDS` | — | `X-Sumo-Fields` (`k=v,k2=v2`) |\n| `SUMO_LOGIC_BATCH_SIZE` | `100` | records per POST |\n| `SUMO_LOGIC_MAX_BATCH_BYTES` | `1000000` | byte cap per POST |\n| `SUMO_LOGIC_GZIP_THRESHOLD` | `1024` | gzip bodies ≥ this |\n| `SUMO_LOGIC_FLUSH_INTERVAL` | `5.0` | timer flush (s) |\n| `SUMO_LOGIC_MAX_BUFFER` | `10000` | buffer cap (oldest dropped on overflow) |\n| `SUMO_LOGIC_TIMEOUT` | `5.0` | POST timeout (s) |\n\n### v4.0.0 transports — shared `_BufferedShipper` contract\n\nAll v3 network\u002Fstorage transports subclass `_BufferedShipper` — the same guarantees as\nSumo Logic: **never block the caller, never raise, bounded buffer with drop counting**,\nbackground flush thread, batch by count and bytes, flush at `atexit`. Factories return\n`None` (soft no-op) when required env vars are unset or the pip extra is missing.\n\n| Name | Key env vars (factory soft no-op if unset) |\n|---|---|\n| `panther` | `PANTHER_API_HOST`, `PANTHER_LOG_SOURCE_ID` \u002F `PANTHER_LOG_SOURCE_TOKEN` (or `PANTHER_API_KEY`) |\n| `file` | `FILE_LOG_PATH` (+ optional `FILE_LOG_ROOT`, `FILE_LOG_ROTATION`, `FILE_LOG_MAX_BYTES`, …) |\n| `blob` | `BLOB_*` connection\u002Fcontainer settings |\n| `sql` | `SQL_LOG_DSN`, `SQL_LOG_TABLE` |\n| `nosql` | `NOSQL_LOG_URI`, `NOSQL_LOG_DATABASE`, `NOSQL_LOG_COLLECTION` |\n| `adx` | `ADX_CLUSTER_URI`, `ADX_DATABASE` |\n| `event_hubs` | `EVENTHUB_FQNS`, `EVENTHUB_NAME` |\n\nInstall all transport deps with `pip install 'vibey[bootstrap-all]'`. See\n`examples\u002F39_v3_transports.py`.\n","> **vibey-bootstrap** is the library formerly published as `azure-bootstrap` (renamed in 4.0.0: package `vibey-bootstrap`, import `vibey_bootstrap`, CLI `vibey-bootstrap`; `azbootstrap` remains as a deprecated alias). Feature-tier labels below (v2 primitives, v3 modules) are historical and unchanged.\n\n# Azure Bootstrap — v2 Tier 1 Primitives & Logging Transports (v2.1 + v3.0)\n\n## 3. Python: v2 Tier 1 primitives (always-on, stdlib-only)\n\nEverything here is importable from the top-level `vibey_bootstrap` namespace (or its\nsubpackage) with **no extra installed**.\n\n### Structured logging\n\n```python\nfrom vibey_bootstrap import configure_logging, JsonLogFormatter\nfrom vibey_bootstrap.logging import (\n    ExtraFieldsFormatter, effective_log_level, env_flag, debug_logging_enabled,\n)\n\nconfigure_logging(\n    format_string=\"%(asctime)s %(levelname)s %(name)s %(message)s\",  # default\n    silence_defaults=True,        # silence noisy third-party loggers (urllib3, azure.*, …)\n    extra_noisy_loggers=(),       # add your own to silence\n)\n```\n\n`configure_logging()` is **idempotent** (it `force`-replaces handlers), installs the\n`ExtraFieldsFormatter` + a `CorrelationFilter`, and sets the root level via\n`effective_log_level()`. The level honors `LOG_LEVEL`, but **`DEBUG` requires a second\ngate**: `DEBUG_LOGGING_ENABLED` must also be truthy, else it clamps to `INFO` (defends\nagainst a stray manifest leaking DEBUG into prod). In DEBUG, an `extra={}` key that\ncollides with a reserved `LogRecord` attribute raises `LoggingExtraConflictError`.\n\n- **`JsonLogFormatter(*, ensure_ascii=False, mask_extras=True)`** — one JSON object\n  per line. Fields: `timestamp` (ISO-8601 UTC), `level`, `logger`, `message`,\n  `exception` (only with `exc_info`), plus every non-reserved `extra={}` field\n  (correlation IDs included). Secret-keyed extras are redacted via\n  `mask_secrets_in_dict`. **Never raises** — falls back to a minimal document. Use it\n  for remote ingestion (this is what the Sumo Logic transport uses).\n\n### Correlation context\n\n```python\nfrom vibey_bootstrap import correlation_scope, get_correlation_id, set_correlation_id\nfrom vibey_bootstrap.logging import CorrelationFilter\n\nwith correlation_scope(\"req-123\", user_id=\"u-456\", email_id=\"e-789\") as cid:\n    logger.info(\"processing\")   # log line auto-includes correlation_id, user_id, email_id\n```\n\n`correlation_scope(correlation_id=None, **fields)` pushes context for the `with` block\n(generates a 12-char hex id when `None`), and `CorrelationFilter` attaches every set\ncontext var as a record attribute. Built on `contextvars`, so it is **async- and\ntask-safe**. `get_correlation_id()` \u002F `set_correlation_id(value)` read\u002Fwrite outside a\nscope.\n\n### Masking & sanitization\n\n```python\nfrom vibey_bootstrap import (\n    mask_api_key, mask_bearer_token, mask_email_address,\n    mask_secrets_in_dict, safe_json_dumps, sanitize_for_log,\n)\nfrom vibey_bootstrap.logging import register_secret_keys, content_preview\n```\n\n| Function | Behavior |\n|---|---|\n| `mask_api_key(s)` | `***` if `None`\u002F\u003C4 chars, else `***{last4}` |\n| `mask_bearer_token(t)` | `Bearer ***` if it starts with `Bearer`, else `***` |\n| `mask_email_address(e)` | `***{last2-local}@{domain}` |\n| `mask_secrets_in_dict(d)` | shallow copy; redacts **truthy** values at ~20 secret-keyed names (`authorization`, `x-api-key`, `api_key`, `password`, `token`, `client_secret`, `connection_string`, …) |\n| `register_secret_keys(*names)` | extend the secret-key allowlist at runtime |\n| `sanitize_for_log(v, max_len=256)` | strip control chars → `?`, truncate |\n| `safe_json_dumps(obj)` | JSON with `default=repr`; never raises |\n| `content_preview(text, max_len=500)` | truncate a body for preview |\n\n### Tracing & counters\n\n```python\nfrom vibey_bootstrap import traced, latency_snapshot, bump_counter, counter_snapshot\n\n@traced(operation=\"reports.process\", alert_on_error=\"error\",\n        sensitive_args=(\"api_key\",), slow_threshold_seconds=2.0)\ndef process(report_id: str, api_key: str) -> dict: ...\n```\n\n`@traced` works on **sync or async** functions (auto-detected). It records latency on\nevery call (success and exception), logs entry\u002Fexit **only at DEBUG** (the hot path\nskips `inspect.signature` when DEBUG is off), masks `sensitive_args` (and anything that\n\"looks\" sensitive) in logs, and — if the `alerts` subpackage is importable — fires a\nslow-budget `WARN` and\u002For an `alert_on_error` alert. With no alerts extra it silently\ndegrades to log-only. `latency_snapshot()` returns\n`{operation: {count, errors, slow, p50, p95, p99, max, last_seen}}`. `bump_counter(name, n=1)`\nis thread-safe and never raises; `counter_snapshot()` returns a copy.\n\n### Bootstrap helpers\n\n```python\nfrom vibey_bootstrap import (\n    ensure_bootstrap, bootstrap_initialized, load_local_settings, refresh_setting,\n)\n```\n\n| Function | Behavior |\n|---|---|\n| `ensure_bootstrap()` | lazy, idempotent wrapper over `initialize_application()`; short-circuits when `USE_MOCK_BOOTSTRAP` is truthy; re-raises on failure after logging |\n| `bootstrap_initialized() -> bool` | process-local flag — wire into `\u002Fhealth\u002Fready` |\n| `load_local_settings(path=\"local.settings.json\") -> int` | load Azure-Functions-style settings; skips `_`-prefixed keys; never overwrites existing env; returns count |\n| `refresh_setting(*names)` | re-read named keys from the cached App Config repo into `os.environ`; best-effort, no-op before `initialize_application()` |\n\n### Error vocabulary\n\n```python\nfrom vibey_bootstrap import (\n    PipelineError, UnrecoverableError, TransientError,\n    InvalidMessageError, RateLimitError, NetworkError, is_unrecoverable,\n)\n```\n\n`PipelineError` is the base. `UnrecoverableError` (→ `InvalidMessageError`,\n`OversizedAttachmentError`, `MalformedAttachmentError`, `ZipBombError`,\n`UpstreamResourceMissing`) means \"dead-letter it.\" `TransientError` (→ `RateLimitError`,\n`NetworkError`, `AuthenticationError`) means \"retry\u002Fback off.\" `is_unrecoverable(exc)`\nis a single classifier the retry\u002Fsoft-fail\u002Fconsumer helpers all consult.\n\n### Resilience — soft-fail & phases\n\n```python\nfrom vibey_bootstrap import (\n    soft_fail, soft_fail_with, SoftFailResult, run_phase, run_phases, PhaseResult,\n)\n\n# Degrade gracefully with a fallback value:\nres = soft_fail_with(fetch_thumbnail, blob_id, fallback=None,\n                     operation=\"thumbnail.fetch\", counter_name=\"thumbnail.failed\")\nif res.degraded:\n    logger.warning(\"thumbnail unavailable\", extra={\"reason\": res.reason})\n\n# Context-manager form:\nwith soft_fail(operation=\"enrich\") as state:\n    record[\"extra\"] = enrich(record)\nif state[\"degraded\"]:\n    ...\n\n# Sequential pipeline that never aborts mid-way:\nresults = run_phases([(\"download\", download), (\"parse\", parse), (\"index\", index)])\n```\n\n`soft_fail_with(...)` re-raises `UnrecoverableError` by default\n(`re_raise_unrecoverable=True`) — set `False` to swallow everything in `catch`.\n`run_phase`\u002F`run_phases` **never re-raise**; each bumps `{namespace}.{name}.ok` \u002F\n`.failed` counters and returns `PhaseResult(name, ok, value, exception, elapsed_seconds)`.\n\n### Validation\n\n```python\nfrom vibey_bootstrap import validate_message, queue_message_schema, MessageSchema\n\nschema = queue_message_schema(\n    required_fields=(\"correlation_id\",),\n    path_field=\"blob_path\", path_required_prefix=\"reports\u002F\",\n)\ndata = validate_message(payload, schema)   # raises InvalidMessageError on violation\n```\n\nBuilding a schema with a `path_field` automatically adds path-traversal defense\n(forbidden substrings `..` and `:\u002F\u002F`). On failure `validate_message` bumps a counter\nand raises `InvalidMessageError` (an `UnrecoverableError` — so consumers dead-letter).\n\n### Path safety\n\n```python\nfrom vibey_bootstrap import sanitize_path_segment, confine_to_root\n\nsafe = sanitize_path_segment(user_filename)            # strips bidi\u002Fzero-width, caps 64 chars\npath = confine_to_root(raw, allowed_root=\"\u002Fdata\u002Fwork\") # raises ValueError on escape\n```\n\n`confine_to_root` canonicalizes both sides (`expanduser().resolve()`) before\ncomparison, defeating `..` traversal **and** symlink escape.\n\n### Security & fail-close\n\n```python\nfrom vibey_bootstrap import compare_secrets\nfrom vibey_bootstrap.failclose import require_env, optional_env, fail_open_env\n```\n\n- `compare_secrets(a, b) -> bool` — constant-time (`hmac.compare_digest`); `False` on\n  any `None`\u002Fempty input.\n- `require_env(name, message=None)` — return value or raise `ConfigurationError`\n  (auth-critical settings → **fail closed**).\n- `optional_env(name, default=\"\")` — stripped value or default (URLs with sane defaults).\n- `fail_open_env(name)` — value when truthy, else `None` (\"feature disabled\" semantics).\n\n### Identity & audit\n\n```python\nfrom vibey_bootstrap.identity import build_credential, credential_kind, CredentialKind\nfrom vibey_bootstrap.audit import build_audit_extra\n\ncred = build_credential()   # ClientSecret (if secret set) → WorkloadIdentity → DefaultAzureCredential\nlogger.info(\"EMAIL_AUDIT\", extra=build_audit_extra(\"send\", sender=addr, subject=subj))\n```\n\n`build_credential(*, tenant_id=None, client_id=None, client_secret=None, prefer=None,\ntoken_file_path=...)` codifies the credential preference (Workload Identity first in a\ncluster — no client secrets in pod env). `credential_kind()` previews the choice\nwithout constructing anything (handy for health probes). `build_audit_extra(operation,\n**fields)` always injects `operation` + a UTC ISO-8601 `timestamp`, masks email\u002Fsecret\nfields, and truncates long fields (`subject`, `error`, `traceback`, …).\n\n### Tier 1 environment variables\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `LOG_LEVEL` | `INFO` | base log level |\n| `DEBUG_LOGGING_ENABLED` | off | **second gate** required for DEBUG output |\n| `USE_MOCK_BOOTSTRAP` | off | short-circuit `ensure_bootstrap()` (local\u002Fdev\u002Ftests) |\n\n## 4. Python: logging transports (v2.1 + v3.0 — ten sinks)\n\nA **transport** is a named factory `Callable[[], logging.Handler | None]`. Enabling\nattaches its handler to the root logger; disabling detaches and closes it. This\ndecouples *where logs go* from *how they're formatted*.\n\n```python\nfrom vibey_bootstrap import (\n    configure_transports, register_transport,\n    enable_transport, disable_transport, list_transports,\n)\n\n# One call to wire built-ins (explicit bool wins; else env flag):\nconfigure_transports(console=True, app_insights=False, sumo_logic=True)\n\n# v3.0 — enable additional sinks in one call:\nconfigure_transports(console=True, panther=True, file=True, blob=True, sql=True,\n                     nosql=True, adx=True, event_hubs=True)\n\nlist_transports()   # {'console': {'registered': True, 'enabled': True}, ...}\n```\n\n`configure_transports()` also sets the root logger to `effective_log_level()` so\nenabled transports actually receive records. It is idempotent and re-runnable.\n\n### Built-in transports (ten total)\n\n| Name | Handler | Extra | Env flag | Default |\n|---|---|---|---|---|\n| `console` | `StreamHandler` + `ExtraFieldsFormatter` + `CorrelationFilter` | stdlib | `CONSOLE_LOGGING_ENABLED` | **on** |\n| `app_insights` | OpenTelemetry handler (delegates to v1 `TelemetryManager`) | stdlib | `APP_INSIGHTS_LOGGING_ENABLED` | off |\n| `sumo_logic` | `SumoLogicHandler` (buffered async POST) | `[sumologic]` | `SUMO_LOGIC_LOGGING_ENABLED` | off |\n| `panther` | Panther SIEM HTTP Source | `[panther]` | `PANTHER_LOGGING_ENABLED` | off |\n| `file` | Rotating local log file (`JsonLogFormatter`) | stdlib | `FILE_LOGGING_ENABLED` | off |\n| `blob` | Azure Blob Storage NDJSON | `[bloblog]` | `BLOB_LOGGING_ENABLED` | off |\n| `sql` | SQL table append | `[sqllog]` | `SQL_LOGGING_ENABLED` | off |\n| `nosql` | Mongo\u002FCosmos collection append | `[nosqllog]` | `NOSQL_LOGGING_ENABLED` | off |\n| `adx` | Azure Data Explorer ingest | `[adxlog]` | `ADX_LOGGING_ENABLED` | off |\n| `event_hubs` | Azure Event Hubs producer | `[eventhubslog]` | `EVENTHUBS_LOGGING_ENABLED` | off |\n\nTwo caveats: (1) the `console` transport installs **the same** `StreamHandler` stack\nas `configure_logging()` — enabling both produces duplicate console lines, so pick one;\n(2) if you also call `configure_logging()` (which does `basicConfig(force=True)` and\nreplaces root handlers), call it **before** `configure_transports()`, which reconciles\nagainst the live root handlers on each run. Disabling `app_insights` only detaches the\nOTel handler (the exporter is not torn down). A custom sink is one call away:\n\n```python\nregister_transport(\"my_syslog\", lambda: logging.handlers.SysLogHandler())\nenable_transport(\"my_syslog\")\n```\n\n### `SumoLogicHandler` deep-dive\n\nRequires the `[sumologic]` extra (`requests`). `make_sumo_logic_handler()` returns\n`None` (a **soft no-op**) when `SUMO_LOGIC_COLLECTOR_URL` is unset *or* when `requests`\nisn't installed — so enabling the transport without the extra never errors.\n\nBehavior: `emit()` only appends to an in-memory bounded `deque` (a daemon thread does\nthe network I\u002FO — **never blocks, never raises**). It ships **NDJSON** (via\n`JsonLogFormatter`), gzips bodies at\u002Fabove the threshold, batches by count **and**\nbyte size (Sumo's 100 KB–1 MB sweet spot), and uses a `urllib3` `Retry` adapter that\nretries `408\u002F429\u002F5xx` with backoff+jitter, **honors `Retry-After`**, and never retries\n`401`\u002Fother 4xx. Flushes on interval, on `batch_size`, and at `atexit`. Counters:\n`sumologic.transport.{posts,ok,error,throttled,dropped,records}`.\n\n```python\nimport os\nos.environ[\"SUMO_LOGIC_COLLECTOR_URL\"] = \"https:\u002F\u002Fcollectors.sumologic.com\u002Freceiver\u002Fv1\u002Fhttp\u002FXXXX\"\nos.environ[\"SUMO_LOGIC_LOGGING_ENABLED\"] = \"true\"\nconfigure_transports(sumo_logic=True)   # or rely on the env flag alone\n```\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `SUMO_LOGIC_COLLECTOR_URL` | — (required) | HTTP Source endpoint (unset → transport stays off) |\n| `SUMO_LOGIC_COLLECTOR_TOKEN` | — | `x-sumo-token` auth header |\n| `SUMO_LOGIC_SOURCE_CATEGORY` | — | `X-Sumo-Category` |\n| `SUMO_LOGIC_SOURCE_HOST` | — | `X-Sumo-Host` |\n| `SUMO_LOGIC_FIELDS` | — | `X-Sumo-Fields` (`k=v,k2=v2`) |\n| `SUMO_LOGIC_BATCH_SIZE` | `100` | records per POST |\n| `SUMO_LOGIC_MAX_BATCH_BYTES` | `1000000` | byte cap per POST |\n| `SUMO_LOGIC_GZIP_THRESHOLD` | `1024` | gzip bodies ≥ this |\n| `SUMO_LOGIC_FLUSH_INTERVAL` | `5.0` | timer flush (s) |\n| `SUMO_LOGIC_MAX_BUFFER` | `10000` | buffer cap (oldest dropped on overflow) |\n| `SUMO_LOGIC_TIMEOUT` | `5.0` | POST timeout (s) |\n\n### v4.0.0 transports — shared `_BufferedShipper` contract\n\nAll v3 network\u002Fstorage transports subclass `_BufferedShipper` — the same guarantees as\nSumo Logic: **never block the caller, never raise, bounded buffer with drop counting**,\nbackground flush thread, batch by count and bytes, flush at `atexit`. Factories return\n`None` (soft no-op) when required env vars are unset or the pip extra is missing.\n\n| Name | Key env vars (factory soft no-op if unset) |\n|---|---|\n| `panther` | `PANTHER_API_HOST`, `PANTHER_LOG_SOURCE_ID` \u002F `PANTHER_LOG_SOURCE_TOKEN` (or `PANTHER_API_KEY`) |\n| `file` | `FILE_LOG_PATH` (+ optional `FILE_LOG_ROOT`, `FILE_LOG_ROTATION`, `FILE_LOG_MAX_BYTES`, …) |\n| `blob` | `BLOB_*` connection\u002Fcontainer settings |\n| `sql` | `SQL_LOG_DSN`, `SQL_LOG_TABLE` |\n| `nosql` | `NOSQL_LOG_URI`, `NOSQL_LOG_DATABASE`, `NOSQL_LOG_COLLECTION` |\n| `adx` | `ADX_CLUSTER_URI`, `ADX_DATABASE` |\n| `event_hubs` | `EVENTHUB_FQNS`, `EVENTHUB_NAME` |\n\nInstall all transport deps with `pip install 'vibey[bootstrap-all]'`. See\n`examples\u002F39_v3_transports.py`.\n",{"name":5,"description":7},"develop","ae32736a1aabddabca5d2c96d665aa0ebc7d8700","src\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fvibey-bootstrap\u002Fskills\u002Fvibey-bootstrap-primitives",3,"https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey","https:\u002F\u002Fthe-vibey-project.github.io\u002Fvibey\u002F","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project","https:\u002F\u002Fvibewithadam.matthewsteinberger.com","freedom for software engineers","2026-11-15 05:47:42",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add the-vibey-project\u002Fvibey --skill vibey-bootstrap-primitives",{"tool":40,"command":41},"bunx","bunx skills add the-vibey-project\u002Fvibey --skill vibey-bootstrap-primitives",{"tool":43,"command":44},"pnpm","pnpm dlx skills add the-vibey-project\u002Fvibey --skill vibey-bootstrap-primitives","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fvibey-bootstrap\u002Fskills\u002Fvibey-bootstrap-primitives\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7AT1FQJAE1FQYAMDTF490Y4","white-paper-writing","Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks \"how should I structure this\" for a long-form document.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fwhite-paper-writing\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AT16BJRJJKK2MASXRZS76G","prose-technical-mechanics","Use when editing or writing prose at a technical\u002Fmechanical level: choosing between Anglo-Saxon and Latinate diction, placing information in topic vs stress positions, writing periodic vs cumulative sentences, handling sentence rhythm, punctuation as logic, transitions, paragraph structure, or phonesthetics. Use when someone wants to understand WHY prose works or doesn't, not just surface-level style advice. Triggers on word choice, sentence structure, emphasis, rhythm, diction, or any deep writing mechanics question.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-technical-mechanics\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AT0W9HT0ZZ9Y287NW99MR3","prose-mechanics","Use when writing, editing, or analyzing prose style; when trying to avoid generic AI-sounding writing; when applying specific prose styles such as journalistic, academic, narrative, KJV biblical, Hemingway plain, Latinate\u002FJamesian, Orwellian, Augustan, Victorian, Early Modern (Bacon, Browne, Milton), or free indirect discourse; or when coaching someone on writing voice and mechanics. Triggers on any request to improve, analyze, or write in a specific prose style, to fix \"AI-sounding\" writing, to make prose more vivid or concrete, to vary sentence rhythm, or to understand how a particular writer achieves their effects.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-mechanics\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AT0KR635JX66X2X6F3E2CP","narrative-structure","Use when structuring stories, pitches, presentations, white papers, or any persuasive narrative; analyzing the hero's journey in fiction or non-fiction; applying StoryBrand for business communication; designing narrative arcs for thought leadership; or understanding Vogler, Snyder, Propp, or Campbell frameworks. Triggers on any narrative structure, storytelling, pitch structure, StoryBrand, hero's journey, three-act structure, Freytag, Save the Cat, narrative arc, or \"how should I structure this story\u002Fpitch\u002Fpresentation\" request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fnarrative-structure\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AT0AKGW09NKKZDYBT8VRDE","legal-brief-writing","Use when writing legal briefs, motions, or any court filing; when analyzing judicial cognition and persuasion; when applying elite brief-writing techniques from Roberts, Clement, Kagan, Garner; or when structuring legal arguments for maximum persuasion. Also use for autistic\u002Fneurodivergent advocates who need to understand how their natural communication style maps to elite legal advocacy. Triggers on any legal writing, brief drafting, motion preparation, or legal argument structuring request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Flegal-brief-writing\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7AT00VWPS4Q8B5VEMXX9NQT","journal-publishability-criteria","Use whenever a research paper, article or preprint is being written, revised, reviewed or published, and specifically before every publication of docs\u002Fpaper.md. Covers what legitimate journals actually gate on, in order of gating — the editor's desk screen (scope, novelty, package problems), what reviewers judge (methodological soundness, claims the evidence can carry, statistical and qualitative reporting), EQUATOR reporting guidelines, the ICMJE authorship criteria, COPE's view of text recycling, the near-universal generative-AI policy (no AI author, disclosure, author responsibility), TOP 2025 transparency standards, how to verify a journal is legitimate, submitting without an institution, and a pre-submission checklist. Triggers on requests to evaluate, review, prepare or submit a paper, to judge publishability, to write a declarations or data-availability section, to disclose AI use, or to check a journal.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fjournal-publishability-criteria\u002FSKILL.md",[],[]]