Organizational Domain

Organizational structure and change impact analysis for ZQK.

Purpose

• Impact analysis: Given an organizational change (e.g. division restructure), find ZQK kernel objects that reference the affected organizational entities (divisions, teams).
• Propagation: Record that propagation was applied to those kernel objects (e.g. set last_propagated_change_ref).

Integration with ZQK Kernel Objects

Organizational change impact and propagation are integrated with the following kernel object kinds:

• Finding affected objects: reference_traversal.findAffectedKernelObjects lists objects of each kind that reference any of the organizational IDs from the change’s affected_objects (or that reference divisions/teams implied by the change). Matching is done by inspecting division_ref and team_ref (single string or list).
• Propagation: The propagate command updates each affected object with last_propagated_change_ref set to the organizational change ID, so downstream tools can see which change was last applied.

Components

• ImpactAnalyzer (impact_analyzer.go): Reads an organizational_change, finds affected kernel objects, creates an impact_analysis object.
• reference_traversal.go: Finds workstreams, goals, backlog_items, and milestones that reference given organizational object IDs.

CLI

• zqk organizational analyze-impact --change <id>: Create impact_analysis for a change.
• zqk organizational propagate --change <id> [--confirm] [--dry-run]: Apply propagation to affected kernel objects.