docs: add Texan roster (real names + LUP employee ids), login person picker, optional profile identity fields; update plan + protocol order

This commit is contained in:
Satyam Rastogi
2026-05-29 02:53:51 +05:30
parent eb0f600ee0
commit 670b33c69b
3 changed files with 140 additions and 24 deletions
@@ -47,6 +47,7 @@ Execution order is the task number. Each task's editable surface:
|---|------|---------------|--------------------|
| 1 | DEMO_TODAY anchor | `mockStore.jsx` (top-of-file constant) + `KanbanCard.jsx:~14` | — |
| 2 | `resolvePerson` selector | `mockStore.jsx` (provider body: people index + context `value` object) | — |
| **R** | **Canonical roster rename** (real Texan names + LUP empIds) | `mockStore.jsx` people source records (`MOCK_USERS`/personnel/owners/subcontractors) **+ repo-wide replacement of the old name strings** | ⚠ cross-cutting (touches many regions/files) — runs **after Task 2, before Task 3**, alone, then commits |
| 3 | Remap `orgMembers` | `mockStore.jsx` → the `orgMembers` useState array only | — |
| 4 | Remap sub-task actor ids | `mockStore.jsx``MOCK_SUBCONTRACTOR_TASKS` + `MOCK_NOTIFICATIONS` (actor/sender id + denormalized name fields only) | ⚠ shares `MOCK_SUBCONTRACTOR_TASKS` with Task 8 — must run before Task 8 |
| 5 | Financial reconciliation + breakdowns | `mockStore.jsx` → the `projects` array only | — |
@@ -54,10 +55,13 @@ Execution order is the task number. Each task's editable surface:
| 7 | Sub logins | `mockStore.jsx``MOCK_USERS` only | — |
| 8 | Task↔project + On Hold | `mockStore.jsx``MOCK_SUBCONTRACTOR_TASKS` (`projectId`/`location` only) + `SubcontractorTasksPage.jsx` + `TaskViewModal.jsx` | ⚠ shares array with Task 4 — runs after Task 4 |
| 9 | Kanban values + Complete fixes | `mockStore.jsx``KANBAN_LEADS_INITIAL` + `KANBAN_PROJECT_DATA` only | — |
| **L** | **Login per-role person picker** | `src/pages/Login.jsx` + `src/context/AuthContext.jsx` only | runs **last** |
**Canonical execution order:** 1 → 2 → **R** → 3 → 4 → 5 → 6 → 7 → 8 → 9 → **L**. (Task R establishes names before the id-remaps; Task L wires the picker after all people exist.)
**Lane rule:** if an implementer believes it must touch a surface outside its lane, it STOPS and reports `NEEDS_CONTEXT` to the controller — it does not edit out of lane.
**Invariant every task must preserve:** the canonical ID scheme from the plan (`own_001/own_002`, `e1e5`, `a1a3`, `con_001`, `sub_001005`). No task may reintroduce `owner_001`/`FA0*`/`ADM0*` ids or the names "Maria Garcia"/"Admin One/Two/Three".
**Invariant every task must preserve:** the canonical ID scheme (`own_001/own_002`, `e1e5`, `a1a3`, `con_001`, `sub_001005`) **and the canonical roster names/empIds** (see the plan's roster table — Wade Hollis, Cody Tatum, Carlos Mendoza, etc., with `LUP-####` empIds). After Task R, no task may reintroduce old ids (`owner_001`/`FA0*`/`ADM0*`) **or** old placeholder names ("Frank Agent", "Adam Admin", "Admin One/Two/Three", "Maria Garcia", "Sarah Sales", "Carlos Subcontractor", "Mike Contractor", etc.).
---
@@ -72,7 +76,7 @@ Execution order is the task number. Each task's editable surface:
7. **Code-quality review** (fresh read-only subagent) — only after spec ✅: review the diff for correctness/quality. Issues → implementer fixes → re-review until ✅.
8. **Mark task complete** in TodoWrite. Go to next task.
**Continuous execution:** the controller runs tasks 1→9 back-to-back without pausing to ask the human "should I continue?". Stop only on an unresolvable BLOCKED, genuine ambiguity, or all-tasks-complete.
**Continuous execution:** the controller runs the canonical order (1 → 2 → R → 3 → 4 → 5 → 6 → 7 → 8 → 9 → L) back-to-back without pausing to ask the human "should I continue?". Stop only on an unresolvable BLOCKED, genuine ambiguity, or all-tasks-complete.
---
@@ -100,9 +104,9 @@ Final gate after Task 9: run the plan's **self-review checklist**, then a whole-
- [ ] Only one implementer in flight at any time.
- [ ] Tree clean before each dispatch.
- [ ] Each task committed before the next starts.
- [ ] Task 4 ran before Task 8 (shared array).
- [ ] Task 4 ran before Task 8 (shared array); Task R ran after Task 2 and before Task 3.
- [ ] No agent edited outside its §3 lane.
- [ ] Canonical-ID invariant intact after every task.
- [ ] Canonical-ID **and roster-name** invariant intact after every task (no old ids/names reintroduced).
- [ ] Build green after every task.
---