|
| 1 | +# Fork Customizations |
| 2 | + |
| 3 | +> Upstream: [NVIDIA/OpenShell](https://github.com/NVIDIA/OpenShell) |
| 4 | +> Fork maintained by: @ashsolei |
| 5 | +> Last reviewed: 2026-04-08 |
| 6 | +> Fork type: **light-customization** |
| 7 | +> Sync cadence: **quarterly** |
| 8 | +
|
| 9 | +## Purpose of Fork |
| 10 | + |
| 11 | +NVIDIA OpenShell fork; iAiFy evaluation-only scope with enterprise CI overlay. |
| 12 | + |
| 13 | +## Upstream Source |
| 14 | + |
| 15 | +| Property | Value | |
| 16 | +|---|---| |
| 17 | +| Upstream | [NVIDIA/OpenShell](https://github.com/NVIDIA/OpenShell) | |
| 18 | +| Fork org | AiFeatures | |
| 19 | +| Fork type | light-customization | |
| 20 | +| Sync cadence | quarterly | |
| 21 | +| Owner | @ashsolei | |
| 22 | + |
| 23 | +## Carried Patches |
| 24 | + |
| 25 | +Local commits ahead of `upstream/main` at last review: |
| 26 | + |
| 27 | +- `908ffd7d docs: add iAiFy Fork Notes block to README (#2)` |
| 28 | +- `a95991f0 chore: remove obsolete .agents/skills definitions` |
| 29 | +- `a60ce82d ci: add dependabot.yml for iAiFy governance` |
| 30 | +- `88d4049c docs: add copilot-instructions.md for iAiFy governance` |
| 31 | + |
| 32 | +## Supported Components |
| 33 | + |
| 34 | +- Root governance files (`.github/`, `CLAUDE.md`, `AGENTS.md`, `FORK-CUSTOMIZATIONS.md`) |
| 35 | +- Enterprise CI/CD workflows imported from `Ai-road-4-You/enterprise-ci-cd` |
| 36 | + |
| 37 | +## Out of Support |
| 38 | + |
| 39 | +- All upstream source directories are tracked as upstream-of-record; local edits to core source are discouraged. |
| 40 | + |
| 41 | +## Breaking-Change Policy |
| 42 | + |
| 43 | +1. On upstream sync, classify per `governance/docs/fork-governance.md`. |
| 44 | +2. Breaking API/license/security changes auto-classify as `manual-review-required`. |
| 45 | +3. Owner triages within 5 business days; conflicts are logged to the `fork-sync-failure` issue label. |
| 46 | +4. Revert local customizations only after stakeholder sign-off. |
| 47 | + |
| 48 | +## Sync Strategy |
| 49 | + |
| 50 | +This fork follows the [Fork Governance Policy](https://github.com/Ai-road-4-You/governance/blob/main/docs/fork-governance.md) |
| 51 | +and the [Fork Upstream Merge Runbook](https://github.com/Ai-road-4-You/governance/blob/main/docs/runbooks/fork-upstream-merge.md). |
| 52 | + |
| 53 | +- **Sync frequency**: quarterly |
| 54 | +- **Conflict resolution**: Prefer upstream; reapply iAiFy customizations on a sync branch |
| 55 | +- **Automation**: [`Ai-road-4-You/fork-sync`](https://github.com/Ai-road-4-You/fork-sync) workflows |
| 56 | +- **Failure handling**: Sync failures create issues tagged `fork-sync-failure` |
| 57 | + |
| 58 | +## Decision: Continue, Rebase, Refresh, or Replace |
| 59 | + |
| 60 | +| Option | Current Assessment | |
| 61 | +|---|---| |
| 62 | +| Continue maintaining fork | yes - governance overlay only | |
| 63 | +| Full rebase onto upstream | feasible on request | |
| 64 | +| Fresh fork (discard local changes) | acceptable | |
| 65 | +| Replace with upstream directly | possible | |
| 66 | + |
| 67 | +## Maintenance |
| 68 | + |
| 69 | +- **Owner**: @ashsolei |
| 70 | +- **Last reviewed**: 2026-04-08 |
| 71 | +- **Reference runbook**: `ai-road-4-you/governance/docs/runbooks/fork-upstream-merge.md` |
0 commit comments