Add Case Notifications page; document the two navigation templates
New page covering the per-case updates bell: what counts as an update, the
durable per-(user, case) read watermark, the 14-day lookback on first sight
of a case, the panel, the three endpoints and the upgrade path.
- Home: Pages table entry and a Notifications section under what's new
- API Reference: Notifications endpoints under Cases
- Development Guide: new gotcha — the header exists twice
(navigation.html for dashboard/manage, navigation_ext.html for case
pages) and both are live, so shared header UI belongs in a partial
included from both
- Changelog: entry for the bell
- Scripts Reference: fix a broken anchor to the post-migration login
failure section (GitHub strips the em-dash, leaving two hyphens
from the two spaces, not four)
Add MISP Cluster Publishing page; document module config drift fix
New page: MISP Cluster Publishing — the IrisMISPCluster module. Covers
why the trigger is an explicit button rather than a hook, the mapping of
each content type to the MISP structure that models it (narrative to
Event Report, linked notes to analyst Notes on their indicator,
ioc_description to the attribute comment, tags, campaign galaxy), and
why the full typed pair list is used rather than the 20-value display
cap.
Documents the redaction model in full: terms derived on every push from
every client name in the instance plus the cluster's case names, the
stoplist that preserves incident and sector vocabulary (sector language
is the shareable context the narrative prompt deliberately produces),
IOC values never being redacted because a lookalike domain is the
intelligence, and the honest limit — term matching is not named-entity
recognition, so possible_unredacted_names exists to surface what the
heuristics cannot derive.
Development Guide: two new gotchas.
- Module config schemas are frozen at first registration. Adding a
parameter never reached an existing install, and an incomplete stored
entry raised KeyError in is_mod_configured(), surfacing as a 500 on
/manage/modules/list and an opaque DataTables Ajax error with no clue
to the cause. Documents the boot-time reconciliation that now fixes
it, and the complete-entry rule for anyone hand-editing module_config.
- MISP analyst-data returns a misleading 403 for two undocumented shape
requirements: the body must be wrapped as {"Note": {...}}, and
distribution must be 0-3 because analyst data rejects "inherit event".
Home, MISP Integration, IOC Correlation, API Reference and Changelog
updated with the new page, the Push to MISP button and the misp-push
endpoint.
Document manual override of AI summary and cluster narrative
AI Features: new "Manual override" section covering the shared mechanics
- the three case_ai_artifact columns, display_content/is_edited, the
serializer's content vs ai_content split, the HTTP 409 regeneration guard
and why it lives in the endpoint rather than the browser, provenance and
revert, a per-surface comparison table, and a four-step recipe for
extending it to another cached AI surface without a migration.
IOC Correlation: "Correcting a narrative by hand" under the cluster
narrative section, plus a note in the STIX section that edits are
exported - a corrected title becomes campaign.name and corrected prose
becomes campaign.description, with the caveat that the v2 prompt's
entity-name prohibition constrains model output, not text an analyst
types. Corrected the CaseAiArtifact field-name note to mention
display_content.
Development Guide: new gotcha for response_api_error() - its second
positional is `data`, not a status code, and it always emits 400, so
several existing calls that pass 503 are really 400s carrying data:503.
Documents building the body via response() when another status is needed.
API Reference, endpoint tables and Home updated with the four new routes
and the discard_edit parameter.
Brand wiki as Community Edition; fix release table accuracy
Home: new "Community Edition" and "Contributing and support" sections
(LGPL-3.0, no feature gates, no license key or activation, no telemetry,
self-hosted); title and intro updated.
Getting Started: state up front that no registration, activation or
license key is required anywhere in the install.
Development Guide: new "Contributing" section — branch table (`main` is
the PR target; `develop` is retired with unrelated history), pre-PR
checklist covering the roadmap, CODESTYLE, the three-layer rule, ORM
CHECK constraints and deploy verification, plus security-issue routing.
Changelog: version scheme corrected to `+iris-ng.<build>` with a note
explaining the `iris-next` -> `iris-ng` rename and the skipped `.5`.
Added the `v2.5.0-beta.1+iris-ng.6` release. Rows for `iris-next.5`,
`.1` and `.0` relabelled as milestones — only four releases are actually
published, and listing unpublished builds as tagged releases was
misleading.
Add Knowledge Map page; document setuptools/pkg_resources + rolldown window gotchas
- New Knowledge-Map page: the case Graph tab was undocumented. Covers the
four layers and their source tables, event vs direct edge kinds, the
three link tables feeding direct edges, API response shape, and the
three non-obvious behaviours (linked-only nodes, suppressed redundant
direct edges, IOC-centric Notes layer).
- Home: nav row + case-relationships bullet.
- Development Guide: window-exposure escape hatch for ui/src/pages files
that cannot move to ui/public (treeshake:false does not save uncalled
declarations under rolldown); new section on setuptools >= 83 --
pkg_resources removal only surfaces at app boot, so a green docker
build is not validation. Includes the 3-step acceptance bar.
- Scripts Reference: add seed_wayne_demo.py; expand
backfill_ioc_note_links.py with the PYTHONPATH and MSYS_NO_PATHCONV
requirements and the truncated-hash matching limit.
- Changelog: knowledge map, dependency sweep, setuptools shim.
[ADD] wiki: STIX export + cluster narrative v2 + marshmallow empty-string gotcha + timeline dedup section
- IOC-Correlation.md: add STIX 2.1 export section (GET /clusters/<id>/stix), AI
narrative enrichment in STIX bundles, CaseAiArtifact field name gotcha
(art.content not art.artifact_content; generated_at not created_at), cluster
narrative prompt v2 entity-name prohibition; add STIX endpoint to the table
- AI-Features.md: update AI cluster narrative entry with prompt v2 constraint and
STIX safety note
- Development-Guide.md: add marshmallow Integer empty-string gotcha (convert "" to
null before JSON.stringify for nullable numeric fields in settings forms)
- Dual-Timeline.md: add Deduplication section (exact + near-dup, endpoints, FK
cleanup load-bearing rule, no-migration deploy)
Update wiki: sortable inventory, timeline sort, analytics page, User.user gotcha
[ADD] wiki: Evidence-Inventory page + reasoning model, Vite 8, retention policy updates
New page: Evidence-Inventory.md — drive lifecycle, status donut chart, data retention
policy, barcode lookup, auto-link in evidence modal, wipe/rotate workflow, API endpoint
table, 6-touch pattern for new drive fields.
Updated pages:
- AI-Features.md: reasoning model support section (Gemma-4 channel format, DeepSeek/Qwen
<think> tags, _last_json_object fallback, max_tokens guidance for reasoning models)
- Development-Guide.md: Vite 8/rolldown 1.1.4 gotcha (import-free JS → ui/public/,
vite-plugin-static-copy >=3.3.0 for Vite 8)
- Changelog.md: iris-next.5 entry (status donut chart + data retention policy)
- Home.md: Evidence Inventory page link in table, Dashboard + Settings bullet updates
Add initial wiki (11 pages)